Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar. 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. # Codebeispiele für AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface with verwenden AWS. Bei *Grundlagen* handelt es sich um Codebeispiele, die Ihnen zeigen, wie Sie die wesentlichen Vorgänge innerhalb eines Services ausführen. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. *Szenarien* sind Codebeispiele, die Ihnen zeigen, wie Sie bestimmte Aufgaben ausführen, indem Sie mehrere Funktionen innerhalb eines Services aufrufen oder mit anderen AWS-Services kombinieren. Einige Services enthalten zusätzliche Beispielkategorien, die zeigen, wie Bibliotheken oder Funktionen genutzt werden können, die spezifisch für den Service sind. **Weitere -Quellen** + **[AWS CLI Entwicklerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)** — Weitere Informationen zur Verwendung von CLI mit AWS. + **[AWS -Entwicklerzentrum](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-programming-language=programming-language%23)**: Codebeispiele, die Sie nach Kategorie oder Volltextsuche filtern können. + **[AWS SDK-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples)** — GitHub Repo mit vollständigem Code in bevorzugten Sprachen. Enthält Anleitungen zum Einrichten und Ausführen des Codes. **Topics** + [ACM](cli_2_acm_code_examples.md) + [API Gateway](cli_2_api-gateway_code_examples.md) + [API Gateway HTTP und WebSocket API](cli_2_apigatewayv2_code_examples.md) + [Management-API von API Gateway](cli_2_apigatewaymanagementapi_code_examples.md) + [App Mesh](cli_2_app-mesh_code_examples.md) + [App Runner](cli_2_apprunner_code_examples.md) + [AWS AppConfig](cli_2_appconfig_code_examples.md) + [Application Auto Scaling](cli_2_application-auto-scaling_code_examples.md) + [Application Discovery Service](cli_2_application-discovery-service_code_examples.md) + [Anwendungssignale](cli_2_application-signals_code_examples.md) + [AppRegistry](cli_2_service-catalog-appregistry_code_examples.md) + [Athena](cli_2_athena_code_examples.md) + [Auto Scaling](cli_2_auto-scaling_code_examples.md) + [Auto Scaling Plans](cli_2_auto-scaling-plans_code_examples.md) + [AWS Backup](cli_2_backup_code_examples.md) + [AWS Batch](cli_2_batch_code_examples.md) + [AWS Budgets](cli_2_budgets_code_examples.md) + [Amazon Chime](cli_2_chime_code_examples.md) + [Cloud Control API](cli_2_cloudcontrol_code_examples.md) + [AWS Cloud Map](cli_2_servicediscovery_code_examples.md) + [AWS Cloud9](cli_2_cloud9_code_examples.md) + [CloudFormation](cli_2_cloudformation_code_examples.md) + [CloudFront](cli_2_cloudfront_code_examples.md) + [Amazon CloudSearch](cli_2_cloudsearch-domain_code_examples.md) + [CloudTrail](cli_2_cloudtrail_code_examples.md) + [CloudWatch](cli_2_cloudwatch_code_examples.md) + [CloudWatch Logs](cli_2_cloudwatch-logs_code_examples.md) + [CloudWatch Netzwerküberwachung](cli_2_networkmonitor_code_examples.md) + [CloudWatch Observability Access Monitor](cli_2_oam_code_examples.md) + [CloudWatch Observability Admin](cli_2_observabilityadmin_code_examples.md) + [CloudWatch Synthetics](cli_2_synthetics_code_examples.md) + [CodeArtifact](cli_2_codeartifact_code_examples.md) + [CodeBuild](cli_2_codebuild_code_examples.md) + [CodeCommit](cli_2_codecommit_code_examples.md) + [CodeDeploy](cli_2_codedeploy_code_examples.md) + [CodeGuru Prüfer](cli_2_codeguru-reviewer_code_examples.md) + [CodePipeline](cli_2_codepipeline_code_examples.md) + [AWS CodeStar Benachrichtigungen](cli_2_codestar-notifications_code_examples.md) + [CodeConnections](cli_2_codestar-connections_code_examples.md) + [Amazon Cognito Identity](cli_2_cognito-identity_code_examples.md) + [Amazon Cognito Identity Provider](cli_2_cognito-identity-provider_code_examples.md) + [Amazon Comprehend](cli_2_comprehend_code_examples.md) + [Amazon Comprehend Medical](cli_2_comprehendmedical_code_examples.md) + [AWS Config](cli_2_config-service_code_examples.md) + [Amazon Connect](cli_2_connect_code_examples.md) + [AWS Cost and Usage Report](cli_2_cost-and-usage-report-service_code_examples.md) + [Cost Explorer Service](cli_2_cost-explorer_code_examples.md) + [Firehose](cli_2_firehose_code_examples.md) + [Amazon Data Lifecycle Manager](cli_2_dlm_code_examples.md) + [AWS Data Pipeline](cli_2_data-pipeline_code_examples.md) + [DataSync](cli_2_datasync_code_examples.md) + [DAX](cli_2_dax_code_examples.md) + [Detektivisch](cli_2_detective_code_examples.md) + [Device Farm](cli_2_device-farm_code_examples.md) + [Direct Connect](cli_2_direct-connect_code_examples.md) + [Directory Service](cli_2_directory-service_code_examples.md) + [Directory Service Daten](cli_2_directory-service-data_code_examples.md) + [AWS DMS](cli_2_database-migration-service_code_examples.md) + [Amazon DocumentDB](cli_2_docdb_code_examples.md) + [DynamoDB](cli_2_dynamodb_code_examples.md) + [DynamoDB Streams](cli_2_dynamodb-streams_code_examples.md) + [Amazon EC2](cli_2_ec2_code_examples.md) + [Amazon EC2 Instance Connect](cli_2_ec2-instance-connect_code_examples.md) + [Amazon ECR](cli_2_ecr_code_examples.md) + [Amazon ECR Public](cli_2_ecr-public_code_examples.md) + [Amazon ECS](cli_2_ecs_code_examples.md) + [Amazon EFS](cli_2_efs_code_examples.md) + [Amazon EKS](cli_2_eks_code_examples.md) + [Elastic Beanstalk](cli_2_elastic-beanstalk_code_examples.md) + [Elastic Load Balancing – Version 1](cli_2_elastic-load-balancing_code_examples.md) + [Elastic Load Balancing – Version 2](cli_2_elastic-load-balancing-v2_code_examples.md) + [ElastiCache](cli_2_elasticache_code_examples.md) + [MediaStore](cli_2_mediastore_code_examples.md) + [Amazon EMR](cli_2_emr_code_examples.md) + [Amazon EMR auf EKS](cli_2_emr-containers_code_examples.md) + [EventBridge](cli_2_eventbridge_code_examples.md) + [EventBridge Rohre](cli_2_pipes_code_examples.md) + [Firewall Manager](cli_2_fms_code_examples.md) + [AWS FIS](cli_2_fis_code_examples.md) + [GameLift Amazon-Server](cli_2_gamelift_code_examples.md) + [Amazon Glacier](cli_2_glacier_code_examples.md) + [Global Accelerator](cli_2_global-accelerator_code_examples.md) + [AWS Glue](cli_2_glue_code_examples.md) + [GuardDuty](cli_2_guardduty_code_examples.md) + [AWS Health](cli_2_health_code_examples.md) + [HealthImaging](cli_2_medical-imaging_code_examples.md) + [HealthLake](cli_2_healthlake_code_examples.md) + [HealthOmics](cli_2_omics_code_examples.md) + [IAM](cli_2_iam_code_examples.md) + [IAM Access Analyzer](cli_2_accessanalyzer_code_examples.md) + [Image Builder](cli_2_imagebuilder_code_examples.md) + [Incident Manager](cli_2_ssm-incidents_code_examples.md) + [Incident-Manager-Kontakte](cli_2_ssm-contacts_code_examples.md) + [Amazon Inspector](cli_2_inspector2_code_examples.md) + [AWS IoT](cli_2_iot_code_examples.md) + [Device Advisor](cli_2_iotdeviceadvisor_code_examples.md) + [AWS IoT data](cli_2_iot-data-plane_code_examples.md) + [AWS IoT Events](cli_2_iot-events_code_examples.md) + [AWS IoT Events-Data](cli_2_iot-events-data_code_examples.md) + [AWS IoT Greengrass](cli_2_greengrass_code_examples.md) + [AWS IoT Greengrass V2](cli_2_greengrassv2_code_examples.md) + [Version von AWS IoT Jobs SDK](cli_2_iot-jobs-data-plane_code_examples.md) + [AWS IoT SiteWise](cli_2_iotsitewise_code_examples.md) + [AWS IoT Things Graph](cli_2_iotthingsgraph_code_examples.md) + [AWS IoT Wireless](cli_2_iot-wireless_code_examples.md) + [Amazon IVS](cli_2_ivs_code_examples.md) + [Amazon IVS Chat](cli_2_ivschat_code_examples.md) + [Amazon-IVS-Streaming in Echtzeit](cli_2_ivs-realtime_code_examples.md) + [Amazon Kendra](cli_2_kendra_code_examples.md) + [Kinesis](cli_2_kinesis_code_examples.md) + [AWS KMS](cli_2_kms_code_examples.md) + [Lake Formation](cli_2_lakeformation_code_examples.md) + [Lambda](cli_2_lambda_code_examples.md) + [License Manager](cli_2_license-manager_code_examples.md) + [Lightsail](cli_2_lightsail_code_examples.md) + [Macie](cli_2_macie2_code_examples.md) + [Amazon Managed Grafana](cli_2_grafana_code_examples.md) + [MediaConnect](cli_2_mediaconnect_code_examples.md) + [MediaConvert](cli_2_mediaconvert_code_examples.md) + [MediaLive](cli_2_medialive_code_examples.md) + [MediaPackage](cli_2_mediapackage_code_examples.md) + [MediaPackage VOD](cli_2_mediapackage-vod_code_examples.md) + [MediaStore Datenebene](cli_2_mediastore-data_code_examples.md) + [MediaTailor](cli_2_mediatailor_code_examples.md) + [MemoryDB](cli_2_memorydb_code_examples.md) + [Amazon MSK](cli_2_kafka_code_examples.md) + [Netzwerkablauf-Überwachung](cli_2_networkflowmonitor_code_examples.md) + [Network Manager](cli_2_networkmanager_code_examples.md) + [OpenSearch Service](cli_2_elasticsearch-service_code_examples.md) + [Organizations](cli_2_organizations_code_examples.md) + [AWS Outposts](cli_2_outposts_code_examples.md) + [AWS Payment Cryptography](cli_2_payment-cryptography_code_examples.md) + [AWS Payment Cryptography Datenebene](cli_2_payment-cryptography-data_code_examples.md) + [Amazon Pinpoint](cli_2_pinpoint_code_examples.md) + [Amazon Polly](cli_2_polly_code_examples.md) + [AWS-Preisliste](cli_2_pricing_code_examples.md) + [AWS Private CA](cli_2_acm-pca_code_examples.md) + [AWS Proton](cli_2_proton_code_examples.md) + [Amazon RDS](cli_2_rds_code_examples.md) + [Amazon RDS Data Service](cli_2_rds-data_code_examples.md) + [Erkenntnisse zur Amazon-RDS-Leistung](cli_2_pi_code_examples.md) + [Amazon Redshift](cli_2_redshift_code_examples.md) + [Amazon Rekognition](cli_2_rekognition_code_examples.md) + [AWS RAM](cli_2_ram_code_examples.md) + [Resource Explorer](cli_2_resource-explorer-2_code_examples.md) + [Resource Groups](cli_2_resource-groups_code_examples.md) + [Resource Groups Tagging API](cli_2_resource-groups-tagging-api_code_examples.md) + [Route 53](cli_2_route-53_code_examples.md) + [Route-53-Domainregistrierung](cli_2_route-53-domains_code_examples.md) + [Route 53 Profiles](cli_2_route53profiles_code_examples.md) + [Route 53 Resolver](cli_2_route53resolver_code_examples.md) + [Amazon S3](cli_2_s3_code_examples.md) + [Amazon S3 Control](cli_2_s3-control_code_examples.md) + [Secrets Manager](cli_2_secrets-manager_code_examples.md) + [Security Hub CSPM](cli_2_securityhub_code_examples.md) + [Security Lake](cli_2_securitylake_code_examples.md) + [AWS Serverless Application Repository](cli_2_serverlessapplicationrepository_code_examples.md) + [Servicekatalog](cli_2_service-catalog_code_examples.md) + [Service Quotas](cli_2_service-quotas_code_examples.md) + [Amazon SES](cli_2_ses_code_examples.md) + [Shield](cli_2_shield_code_examples.md) + [Signer](cli_2_signer_code_examples.md) + [Snowball Edge](cli_2_snowball_code_examples.md) + [Amazon SNS](cli_2_sns_code_examples.md) + [Amazon SQS](cli_2_sqs_code_examples.md) + [Storage Gateway](cli_2_storage-gateway_code_examples.md) + [AWS STS](cli_2_sts_code_examples.md) + [Support](cli_2_support_code_examples.md) + [Amazon SWF](cli_2_swf_code_examples.md) + [Systems Manager](cli_2_ssm_code_examples.md) + [Amazon Textract](cli_2_textract_code_examples.md) + [Amazon Transcribe](cli_2_transcribe_code_examples.md) + [Amazon Translate](cli_2_translate_code_examples.md) + [Trusted Advisor](cli_2_trustedadvisor_code_examples.md) + [Verifizierte Berechtigungen](cli_2_verifiedpermissions_code_examples.md) + [VPC-Gitter](cli_2_vpc-lattice_code_examples.md) + [AWS WAF Classic](cli_2_waf_code_examples.md) + [AWS WAF Classic Regional](cli_2_waf-regional_code_examples.md) + [AWS WAFV2](cli_2_wafv2_code_examples.md) + [WorkDocs](cli_2_workdocs_code_examples.md) + [Amazon WorkMail](cli_2_workmail_code_examples.md) + [WorkMail Amazon-Nachrichtenfluss](cli_2_workmailmessageflow_code_examples.md) + [WorkSpaces](cli_2_workspaces_code_examples.md) + [X-Ray](cli_2_xray_code_examples.md) # ACM-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit ACM Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-tags-to-certificate` Das folgende Codebeispiel zeigt, wie Sie`add-tags-to-certificate`. **AWS CLI** **So fügen Sie einem vorhandenen ACM-Zertifikat Tags hinzu** Der folgende `add-tags-to-certificate`-Befehl fügt dem angegebenen Zertifikat zwei Tags hinzu. Verwenden Sie ein Leerzeichen, um mehrere Tags voneinander zu trennen: ``` aws acm add-tags-to-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website ``` + Einzelheiten zur API finden Sie [AddTagsToCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/add-tags-to-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `delete-certificate` Das folgende Codebeispiel zeigt die Verwendung`delete-certificate`. **AWS CLI** **So löschen Sie ein ACM-Zertifikat aus Ihrem Konto** Der folgende `delete-certificate`-Befehl löscht das Zertifikat mit dem angegebenen ARN: ``` aws acm delete-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 ``` + Einzelheiten zur API finden Sie [DeleteCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/delete-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `describe-certificate` Das folgende Codebeispiel zeigt die Verwendung`describe-certificate`. **AWS CLI** **So rufen Sie die in einem ACM-Zertifikat enthaltenen Felder ab** Der folgende `describe-certificate`-Befehl ruft alle Felder für das Zertifikat mit dem angegebenen ARN ab: ``` aws acm describe-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 ``` Die Ausgabe sieht in etwa wie folgt aus: ``` { "Certificate": { "CertificateArn": "arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012", "CreatedAt": 1446835267.0, "DomainName": "www.example.com", "DomainValidationOptions": [ { "DomainName": "www.example.com", "ValidationDomain": "www.example.com", "ValidationEmails": [ "hostmaster@example.com", "admin@example.com", "owner@example.com.whoisprivacyservice.org", "tech@example.com.whoisprivacyservice.org", "admin@example.com.whoisprivacyservice.org", "postmaster@example.com", "webmaster@example.com", "administrator@example.com" ] }, { "DomainName": "www.example.net", "ValidationDomain": "www.example.net", "ValidationEmails": [ "postmaster@example.net", "admin@example.net", "owner@example.net.whoisprivacyservice.org", "tech@example.net.whoisprivacyservice.org", "admin@example.net.whoisprivacyservice.org", "hostmaster@example.net", "administrator@example.net", "webmaster@example.net" ] } ], "InUseBy": [], "IssuedAt": 1446835815.0, "Issuer": "Amazon", "KeyAlgorithm": "RSA-2048", "NotAfter": 1478433600.0, "NotBefore": 1446768000.0, "Serial": "0f:ac:b0:a3:8d:ea:65:52:2d:7d:01:3a:39:36:db:d6", "SignatureAlgorithm": "SHA256WITHRSA", "Status": "ISSUED", "Subject": "CN=www.example.com", "SubjectAlternativeNames": [ "www.example.com", "www.example.net" ] } } ``` + Einzelheiten zur API finden Sie [DescribeCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/describe-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `export-certificate` Das folgende Codebeispiel zeigt die Verwendung`export-certificate`. **AWS CLI** **So exportieren Sie ein privates Zertifikat, das von einer privaten Zertifizierungsstelle ausgegeben wurde.** Mit dem folgenden `export-certificate`-Befehl werden ein privates Zertifikat, eine Zertifikatskette und ein privater Schlüssel auf Ihr Display exportiert: ``` aws acm export-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --passphrase file://path-to-passphrase-file ``` Verwenden Sie den folgenden Befehl, um das Zertifikat, die Kette und den privaten Schlüssel in eine lokale Datei zu exportieren: ``` aws acm export-certificate --certificate-arn arn:aws:acm:region:sccount:certificate/12345678-1234-1234-1234-123456789012 --passphrase file://path-to-passphrase-file > c:\temp\export.txt ``` + Einzelheiten zur API finden Sie [ExportCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/export-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `get-certificate` Das folgende Codebeispiel zeigt die Verwendung`get-certificate`. **AWS CLI** **So rufen Sie ein ACM-Zertifikat ab** Der folgende `get-certificate`-Befehl ruft das Zertifikat für den angegebenen ARN und die Zertifikatskette ab: ``` aws acm get-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 ``` Die Ausgabe sieht in etwa wie folgt aus: ``` { "Certificate": "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----", "CertificateChain": "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----", "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----", "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----" } ``` + Einzelheiten zur API finden Sie [GetCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/get-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `import-certificate` Das folgende Codebeispiel zeigt die Verwendung`import-certificate`. **AWS CLI** **So importieren Sie ein Zertifikat in ACM.** Der folgende `import-certificate`-Befehl importiert ein Zertifikat in ACM. Ersetzen Sie die Dateinamen durch Ihre eigenen: ``` aws acm import-certificate --certificate file://Certificate.pem --certificate-chain file://CertificateChain.pem --private-key file://PrivateKey.pem ``` + Einzelheiten zur API finden Sie [ImportCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/import-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `list-certificates` Das folgende Codebeispiel zeigt die Verwendung`list-certificates`. **AWS CLI** **Um die ACM-Zertifikate für ein AWS Konto aufzulisten** Der folgende `list-certificates` Befehl listet ARNs die Zertifikate in Ihrem Konto auf: ``` aws acm list-certificates ``` Der vorhergehende Befehl erzeugt eine Ausgabe, die der folgenden ähnelt: ``` { "CertificateSummaryList": [ { "CertificateArn": "arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012", "DomainName": "www.example.com" }, { "CertificateArn": "arn:aws:acm:region:account:certificate/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "DomainName": "www.example.net" } ] } ``` Sie können festlegen, wie viele Zertifikate bei jedem Aufruf von `list-certificates` angezeigt werden sollen. Wenn Sie beispielsweise vier Zertifikate haben und jeweils höchstens zwei gleichzeitig anzeigen möchten, setzen Sie das Argument `max-items` auf 2, wie im folgenden Beispiel gezeigt: ``` aws acm list-certificates --max-items 2 ``` Es werden zwei Zertifikate ARNs und ein `NextToken` Wert angezeigt: ``` "CertificateSummaryList": [ { "CertificateArn": "arn:aws:acm:region:account: \ certificate/12345678-1234-1234-1234-123456789012", "DomainName": "www.example.com" }, { "CertificateArn": "arn:aws:acm:region:account: \ certificate/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "DomainName": "www.example.net" } ], "NextToken": "9f4d9f69-275a-41fe-b58e-2b837bd9ba48" ``` Um die nächsten beiden Zertifikate in Ihrem Konto anzuzeigen, legen Sie den `NextToken`-Wert in Ihrem nächsten Aufruf fest: ``` aws acm list-certificates --max-items 2 --next-token 9f4d9f69-275a-41fe-b58e-2b837bd9ba48 ``` Sie können Ihre Ausgabe mithilfe des Arguments `certificate-statuses` filtern. Mit dem folgenden Befehl werden Zertifikate angezeigt, die den Status PENDING\$1VALIDATION haben: ``` aws acm list-certificates --certificate-statuses PENDING_VALIDATION ``` Sie können Ihre Ausgabe auch mithilfe des Arguments `includes` filtern. Der folgende Befehl zeigt Zertifikate an, die nach den folgenden Eigenschaften gefiltert werden. Die anzuzeigenden Zertifikate: ``` - Specify that the RSA algorithm and a 2048 bit key are used to generate key pairs. - Contain a Key Usage extension that specifies that the certificates can be used to create digital signatures. - Contain an Extended Key Usage extension that specifies that the certificates can be used for code signing. aws acm list-certificates --max-items 10 --includes extendedKeyUsage=CODE_SIGNING,keyUsage=DIGITAL_SIGNATURE,keyTypes=RSA_2048 ``` + Einzelheiten zur API finden Sie [ListCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/list-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-certificate` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-certificate`. **AWS CLI** **So listen Sie die Tags auf, die auf ein ACM-Zertifikat angewendet werden** Mit dem folgenden `list-tags-for-certificate`-Befehl werden die Tags aufgelistet, die auf ein Zertifikat in Ihrem Konto angewendet werden: ``` aws acm list-tags-for-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 ``` Der vorhergehende Befehl erzeugt eine Ausgabe, die der folgenden ähnelt: ``` { "Tags": [ { "Value": "Website", "Key": "Purpose" }, { "Value": "Alice", "Key": "Admin" } ] } ``` + Einzelheiten zur API finden Sie [ListTagsForCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/list-tags-for-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `remove-tags-from-certificate` Das folgende Codebeispiel zeigt die Verwendung`remove-tags-from-certificate`. **AWS CLI** **So entfernen Sie ein Tag aus einem ACM-Zertifikat** Der folgende `remove-tags-from-certificate`-Befehl entfernt zwei Tags aus dem angegebenen Zertifikat. Verwenden Sie ein Leerzeichen, um mehrere Tags voneinander zu trennen: ``` aws acm remove-tags-from-certificate --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice Key=Purpose,Value=Website ``` + Einzelheiten zur API finden Sie [RemoveTagsFromCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/remove-tags-from-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `request-certificate` Das folgende Codebeispiel zeigt die Verwendung`request-certificate`. **AWS CLI** **So fordern Sie ein neues ACM-Zertifikat an** Mit dem folgenden `request-certificate`-Befehl wird mithilfe der DNS-Validierung ein neues Zertifikat für die Domain www.example.com angefordert: ``` aws acm request-certificate --domain-name www.example.com --validation-method DNS ``` Sie können ein Idempotenz-Token eingeben, um zwischen mehreren Aufrufen von `request-certificate` zu unterscheiden: ``` aws acm request-certificate --domain-name www.example.com --validation-method DNS --idempotency-token 91adc45q ``` Sie können einen oder mehrere Subject Alternative Names angeben, um ein Zertifikat anzufordern, das mehr als eine Apex-Domain schützt. ``` aws acm request-certificate --domain-name example.com --validation-method DNS --idempotency-token 91adc45q --subject-alternative-names www.example.net ``` Sie können einen alternativen Namen eingeben, der auch für den Zugriff auf Ihre Website verwendet werden kann: ``` aws acm request-certificate --domain-name example.com --validation-method DNS --idempotency-token 91adc45q --subject-alternative-names www.example.com ``` Sie können ein Sternchen (\$1) als Platzhalter verwenden, um ein Zertifikat für mehrere Subdomains in derselben Domain zu erstellen: ``` aws acm request-certificate --domain-name example.com --validation-method DNS --idempotency-token 91adc45q --subject-alternative-names *.example.com ``` Sie können auch mehrere alternative Namen eingeben: ``` aws acm request-certificate --domain-name example.com --validation-method DNS --subject-alternative-names b.example.com c.example.com d.example.com ``` Wenn Sie E-Mail für die Validierung verwenden, können Sie Optionen für die Domainvalidierung eingeben, um die Domain anzugeben, an die die Validierungs-E-Mail gesendet werden soll: ``` aws acm request-certificate --domain-name example.com --validation-method EMAIL --subject-alternative-names www.example.com --domain-validation-options DomainName=example.com,ValidationDomain=example.com ``` Mit dem folgenden Befehl wird die Protokollierung der Zertifikatstransparenz deaktiviert, wenn Sie ein neues Zertifikat anfordern: ``` aws acm request-certificate --domain-name www.example.com --validation-method DNS --options CertificateTransparencyLoggingPreference=DISABLED --idempotency-token 184627 ``` + Einzelheiten zur API finden Sie [RequestCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/request-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `resend-validation-email` Das folgende Codebeispiel zeigt die Verwendung`resend-validation-email`. **AWS CLI** **So senden Sie die Validierungs-E-Mail für Ihre ACM-Zertifikatsanfrage erneut** Der folgende `resend-validation-email`-Befehl weist die Amazon-Zertifizierungsstelle an, eine Validierungs-E-Mail an die entsprechenden Adressen zu senden: ``` aws acm resend-validation-email --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --domain www.example.com --validation-domain example.com ``` + Einzelheiten zur API finden Sie [ResendValidationEmail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/resend-validation-email.html)in der *AWS CLI Befehlsreferenz*. ### `update-certificate-options` Das folgende Codebeispiel zeigt die Verwendung`update-certificate-options`. **AWS CLI** **So aktualisieren Sie die Zertifikatsoptionen** Mit dem folgenden `update-certificate-options`-Befehl wird die Protokollierung für Zertifikatstransparenz deaktiviert: ``` aws acm update-certificate-options --certificate-arn arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012 --options CertificateTransparencyLoggingPreference=DISABLED ``` + Einzelheiten zur API finden Sie [UpdateCertificateOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm/update-certificate-options.html)in der *AWS CLI Befehlsreferenz*. # API Gateway Gateway-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with API Gateway Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-api-key` Das folgende Codebeispiel zeigt, wie Sie`create-api-key`. **AWS CLI** **So erstellen Sie einen API-Schlüssel, der für eine bestehende API und Stage aktiviert ist** Befehl: ``` aws apigateway create-api-key --name 'Dev API Key' --description 'Used for development' --enabled --stage-keys restApiId='a1b2c3d4e5',stageName='dev' ``` + Einzelheiten zur API finden Sie [CreateApiKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-api-key.html)in der *AWS CLI Befehlsreferenz*. ### `create-authorizer` Das folgende Codebeispiel zeigt die Verwendung`create-authorizer`. **AWS CLI** **Beispiel 1: So erstellen Sie einen tokenbasierten benutzerdefinierten Genehmiger in API Gateway für die API** Im folgenden Beispiel für `create-authorizer` wird ein tokenbasierter Genehmiger erstellt. ``` aws apigateway create-authorizer \ --rest-api-id 1234123412 \ --name 'First_Token_Custom_Authorizer' \ --type TOKEN \ --authorizer-uri 'arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:customAuthFunction/invocations' \ --identity-source 'method.request.header.Authorization' \ --authorizer-result-ttl-in-seconds 300 ``` Ausgabe: ``` { "authType": "custom", "name": "First_Token_Custom_Authorizer", "authorizerUri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:customAuthFunction/invocations", "authorizerResultTtlInSeconds": 300, "identitySource": "method.request.header.Authorization", "type": "TOKEN", "id": "z40xj0" } ``` **Beispiel 2: So erstellen Sie einen auf Cognito-Benutzerpools basierenden benutzerdefinierten Genehmiger in API Gateway für die API** Im folgenden Beispiel für `create-authorizer` wird ein auf Cognito-Benutzerpools basierender benutzerdefinierter Genehmiger in API Gateway erstellt. ``` aws apigateway create-authorizer \ --rest-api-id 1234123412 \ --name 'First_Cognito_Custom_Authorizer' \ --type COGNITO_USER_POOLS \ --provider-arns 'arn:aws:cognito-idp:us-east-1:123412341234:userpool/us-east-1_aWcZeQbuD' \ --identity-source 'method.request.header.Authorization' ``` Ausgabe: ``` { "authType": "cognito_user_pools", "identitySource": "method.request.header.Authorization", "name": "First_Cognito_Custom_Authorizer", "providerARNs": [ "arn:aws:cognito-idp:us-east-1:342398297714:userpool/us-east-1_qWbZzQhzE" ], "type": "COGNITO_USER_POOLS", "id": "5yid1t" } ``` **Beispiel 3: So erstellen Sie einen anforderungsbasierten benutzerdefinierten Genehmiger in API Gateway für die API** Im folgenden Beispiel für `create-authorizer` wird ein anforderungsbasierter Genehmiger erstellt. ``` aws apigateway create-authorizer \ --rest-api-id 1234123412 \ --name 'First_Request_Custom_Authorizer' \ --type REQUEST \ --authorizer-uri 'arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:customAuthFunction/invocations' \ --identity-source 'method.request.header.Authorization,context.accountId' \ --authorizer-result-ttl-in-seconds 300 ``` Ausgabe: ``` { "id": "z40xj0", "name": "First_Request_Custom_Authorizer", "type": "REQUEST", "authType": "custom", "authorizerUri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:customAuthFunction/invocations", "identitySource": "method.request.header.Authorization,context.accountId", "authorizerResultTtlInSeconds": 300 } ``` + Einzelheiten zur API finden Sie [CreateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-authorizer.html)in der *AWS CLI Befehlsreferenz*. ### `create-base-path-mapping` Das folgende Codebeispiel zeigt die Verwendung`create-base-path-mapping`. **AWS CLI** **So erstellen Sie die Basispfadzuordnung für einen benutzerdefinierten Domainnamen** Befehl: ``` aws apigateway create-base-path-mapping --domain-name subdomain.domain.tld --rest-api-id 1234123412 --stage prod --base-path v1 ``` + Einzelheiten zur API finden Sie [CreateBasePathMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-base-path-mapping.html)in der *AWS CLI Befehlsreferenz*. ### `create-deployment` Das folgende Codebeispiel zeigt die Verwendung`create-deployment`. **AWS CLI** **So stellen Sie die konfigurierten Ressourcen für eine API in einer neuen Stufe bereit** Befehl: ``` aws apigateway create-deployment --rest-api-id 1234123412 --stage-name dev --stage-description 'Development Stage' --description 'First deployment to the dev stage' ``` **So stellen Sie die konfigurierten Ressourcen für eine API in einer bestehenden Stufe bereit** Befehl: ``` aws apigateway create-deployment --rest-api-id 1234123412 --stage-name dev --description 'Second deployment to the dev stage' ``` **So stellen Sie die konfigurierten Ressourcen für eine API in einer bestehenden Stufe mit Stufenvariablen bereit** aws apigateway create-deployment -- rest-api-id 1234123412 --stage-name dev --description 'Drittes Deployment in der Entwicklungsphase' --variables key='value', otherKey='otherValue' + Einzelheiten zur API [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-deployment.html)finden Sie *AWS CLI in der* Befehlsreferenz. ### `create-domain-name-access-association` Das folgende Codebeispiel zeigt die Verwendung`create-domain-name-access-association`. **AWS CLI** **Um eine Zuordnung für den Zugriff auf Domainnamen zu erstellen** Im folgenden Beispiel für `create-domain-name-access-association` wird eine Domainnamenzugriffszuweisung zwischen einem privaten benutzerdefinierten Domainnamen und einem VPC-Endpunkt erstellt. ``` aws apigateway create-domain-name-access-association \ --domain-name-arn arn:aws:apigateway:us-west-2:111122223333:/domainnames/my.private.domain.tld+abcd1234 \ --access-association-source vpce-abcd1234efg \ --access-association-source-type VPCE ``` Ausgabe: ``` { "domainNameAccessAssociationArn": "arn:aws:apigateway:us-west-2:012345678910:/domainnameaccessassociations/domainname/my.private.domain.tld/vpcesource/vpce-abcd1234efg "accessAssociationSource": "vpce-abcd1234efg", "accessAssociationSourceType": "VPCE", "domainNameArn" : "arn:aws:apigateway:us-west-2:111122223333:/domainnames/private.example.com+abcd1234" } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Domainnamen für private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [CreateDomainNameAccessAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-domain-name-access-association.html)in der *AWS CLI Befehlsreferenz*. ### `create-domain-name` Das folgende Codebeispiel zeigt die Verwendung`create-domain-name`. **AWS CLI** **Beispiel 1: So erstellen Sie einen öffentlichen benutzerdefinierten Domainnamen** Im folgenden Beispiel für `create-domain-name` wird ein öffentlicher benutzerdefinierter Domainnamen erstellt. ``` aws apigateway create-domain-name \ --domain-name 'my.domain.tld' \ --certificate-name 'my.domain.tld cert'\ --certificate-arn 'arn:aws:acm:us-east-1:012345678910:certificate/fb1b9770-a305-495d-aefb-27e5e101ff3' ``` Ausgabe: ``` { "domainName": "my.domain.tld", "certificateName": "my.domain.tld cert", "certificateArn": "arn:aws:acm:us-east-1:012345678910:certificate/fb1b9770-a305-495d-aefb-27e5e101ff3", "certificateUploadDate": "2024-10-08T11:29:49-07:00", "distributionDomainName": "abcd1234.cloudfront.net", "distributionHostedZoneId": "Z2FDTNDATAQYW2", "endpointConfiguration": { "types": [ "EDGE" ] }, "domainNameStatus": "AVAILABLE", "securityPolicy": "TLS_1_2" } ``` Weitere Informationen finden Sie unter [Benutzerdefinierter Domainname für öffentliches REST APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html) im *Amazon API Gateway Developer Guide*. **Beispiel 2: So erstellen Sie einen privaten benutzerdefinierten Domainnamen** Im folgenden Beispiel für `create-domain-name` wird ein privater benutzerdefinierter Domainnamen erstellt. ``` aws apigateway create-domain-name \ --domain-name 'my.private.domain.tld' \ --certificate-name 'my.domain.tld cert' \ --certificate-arn 'arn:aws:acm:us-east-1:012345678910:certificate/fb1b9770-a305-495d-aefb-27e5e101ff3' \ --endpoint-configuration '{"types": ["PRIVATE"]}' \ --security-policy 'TLS_1_2' \ --policy file://policy.json ``` Inhalt von `policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": "*", "Action": "execute-api:Invoke", "Resource": [ "execute-api:/*" ] }, { "Effect": "Deny", "Principal": "*", "Action": "execute-api:Invoke", "Resource": [ "execute-api:/*" ], "Condition" : { "StringNotEquals": { "aws:SourceVpce": "vpce-abcd1234efg" } } } ] } ``` Ausgabe: ``` { "domainName": "my.private.domain.tld", "domainNameId": "abcd1234", "domainNameArn": "arn:aws:apigateway:us-east-1:012345678910:/domainnames/my.private.domain.tld+abcd1234", "certificateArn": "arn:aws:acm:us-east-1:012345678910:certificate/fb1b9770-a305-495d-aefb-27e5e101ff3", "certificateUploadDate": "2024-09-10T10:31:20-07:00", "endpointConfiguration": { "types": [ "PRIVATE" ] }, "domainNameStatus": "AVAILABLE", "securityPolicy": "TLS_1_2", "policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":\"execute-api:Invoke\",\"Resource\":\"arn:aws:execute-api:us-east-1:012345678910:/domainnames/my.private.domain.tld+abcd1234\"},{\"Effect\":\"Deny\",\"Principal\":\"*\",\"Action\":\"execute-api:Invoke\",\"Resource\":\"arn:aws:execute-api:us-east-1:012345678910:/domainnames/my.private.domain.tld+abcd1234\",\"Condition\":{\"StringNotEquals\":{\"aws:SourceVpc\":\"vpc-1a2b3c4d\"}}}]}" } ``` Weitere Informationen finden Sie unter [Benutzerdefinierter Domainname für öffentliches REST APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [CreateDomainName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-domain-name.html)in der *AWS CLI Befehlsreferenz*. ### `create-model` Das folgende Codebeispiel zeigt die Verwendung`create-model`. **AWS CLI** **So erstellen Sie ein Modell für eine API** Befehl: ``` aws apigateway create-model --rest-api-id 1234123412 --name 'firstModel' --description 'The First Model' --content-type 'application/json' --schema '{ "$schema": "http://json-schema.org/draft-04/schema#", "title": "firstModel", "type": "object", "properties": { "firstProperty" : { "type": "object", "properties": { "key": { "type": "string" } } } } }' ``` Ausgabe: ``` { "contentType": "application/json", "description": "The First Model", "name": "firstModel", "id": "2rzg0l", "schema": "{ \"$schema\": \"http://json-schema.org/draft-04/schema#\", \"title\": \"firstModel\", \"type\": \"object\", \"properties\": { \"firstProperty\" : { \"type\": \"object\", \"properties\": { \"key\": { \"type\": \"string\" } } } } }" } ``` + Einzelheiten zur API finden Sie [CreateModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-model.html)in der *AWS CLI Befehlsreferenz*. ### `create-resource` Das folgende Codebeispiel zeigt die Verwendung`create-resource`. **AWS CLI** **So erstellen Sie eine Ressource in einer API** Befehl: ``` aws apigateway create-resource --rest-api-id 1234123412 --parent-id a1b2c3 --path-part 'new-resource' ``` + Einzelheiten zur API finden Sie [CreateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-resource.html)in der *AWS CLI Befehlsreferenz*. ### `create-rest-api` Das folgende Codebeispiel zeigt die Verwendung`create-rest-api`. **AWS CLI** **So erstellen Sie eine API** Befehl: ``` aws apigateway create-rest-api --name 'My First API' --description 'This is my first API' ``` **So erstellen Sie eine doppelte API aus einer vorhandenen API** Befehl: ``` aws apigateway create-rest-api --name 'Copy of My First API' --description 'This is a copy of my first API' --clone-from 1234123412 ``` + Einzelheiten zur API finden Sie [CreateRestApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-rest-api.html)in der *AWS CLI Befehlsreferenz*. ### `create-stage` Das folgende Codebeispiel zeigt die Verwendung`create-stage`. **AWS CLI** **So erstellen Sie eine Stufe in einer API, die eine bestehende Bereitstellung enthält** Befehl: ``` aws apigateway create-stage --rest-api-id 1234123412 --stage-name 'dev' --description 'Development stage' --deployment-id a1b2c3 ``` **So erstellen Sie eine Stufe in einer API, die eine bestehende Bereitstellung und benutzerdefinierte Stufenvariablen enthält** Befehl: ``` aws apigateway create-stage --rest-api-id 1234123412 --stage-name 'dev' --description 'Development stage' --deployment-id a1b2c3 --variables key='value',otherKey='otherValue' ``` + Einzelheiten zur API finden Sie [CreateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-stage.html)in der *AWS CLI Befehlsreferenz*. ### `create-usage-plan-key` Das folgende Codebeispiel zeigt die Verwendung`create-usage-plan-key`. **AWS CLI** **Verknüpfen eines vorhandenen API-Schlüssels mit einem Nutzungsplan** Befehl: ``` aws apigateway create-usage-plan-key --usage-plan-id a1b2c3 --key-type "API_KEY" --key-id 4vq3yryqm5 ``` + Einzelheiten zur API finden Sie [CreateUsagePlanKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-usage-plan-key.html)in der *AWS CLI Befehlsreferenz*. ### `create-usage-plan` Das folgende Codebeispiel zeigt die Verwendung`create-usage-plan`. **AWS CLI** **So erstellen Sie einen Nutzungsplan mit Drosselungs- und Kontingentlimits, der zu Beginn des Monats zurückgesetzt wird** Befehl: ``` aws apigateway create-usage-plan --name "New Usage Plan" --description "A new usage plan" --throttle burstLimit=10,rateLimit=5 --quota limit=500,offset=0,period=MONTH ``` + Einzelheiten zur API finden Sie [CreateUsagePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/create-usage-plan.html)in der *AWS CLI Befehlsreferenz*. ### `delete-api-key` Das folgende Codebeispiel zeigt die Verwendung`delete-api-key`. **AWS CLI** **So löschen Sie einen API-Schlüssel** Befehl: ``` aws apigateway delete-api-key --api-key 8bklk8bl1k3sB38D9B3l0enyWT8c09B30lkq0blk ``` + Einzelheiten zur API finden Sie [DeleteApiKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-api-key.html)in der *AWS CLI Befehlsreferenz*. ### `delete-authorizer` Das folgende Codebeispiel zeigt die Verwendung`delete-authorizer`. **AWS CLI** **So löschen Sie einen benutzerdefinierten Genehmiger in einer API** Befehl: ``` aws apigateway delete-authorizer --rest-api-id 1234123412 --authorizer-id 7gkfbo ``` + Einzelheiten zur API finden Sie [DeleteAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-authorizer.html)in der *AWS CLI Befehlsreferenz*. ### `delete-base-path-mapping` Das folgende Codebeispiel zeigt die Verwendung`delete-base-path-mapping`. **AWS CLI** **So löschen Sie eine Basispfadzuordnung für einen benutzerdefinierten Domainnamen** Befehl: ``` aws apigateway delete-base-path-mapping --domain-name 'api.domain.tld' --base-path 'dev' ``` + Einzelheiten zur API finden Sie [DeleteBasePathMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-base-path-mapping.html)in der *AWS CLI Befehlsreferenz*. ### `delete-client-certificate` Das folgende Codebeispiel zeigt die Verwendung`delete-client-certificate`. **AWS CLI** **So löschen Sie ein Clientzertifikat** Befehl: ``` aws apigateway delete-client-certificate --client-certificate-id a1b2c3 ``` + Einzelheiten zur API finden Sie [DeleteClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-client-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `delete-deployment` Das folgende Codebeispiel zeigt die Verwendung`delete-deployment`. **AWS CLI** **So löschen Sie eine Bereitstellung in einer API** Befehl: ``` aws apigateway delete-deployment --rest-api-id 1234123412 --deployment-id a1b2c3 ``` + Einzelheiten zur API finden Sie [DeleteDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `delete-domain-name-access-association` Das folgende Codebeispiel zeigt die Verwendung`delete-domain-name-access-association`. **AWS CLI** **So löschen Sie eine Domainnamenzugriffszuweisung** Im folgenden Beispiel für `delete-domain-name-access-association` wird eine Domainnamenzugriffszuweisung zwischen einem privaten benutzerdefinierten Domainnamen und einem VPC-Endpunkt gelöscht. ``` aws apigateway delete-domain-name-access-association \ --domain-name-access-association-arn arn:aws:apigateway:us-west-2:012345678910:/domainnameaccessassociations/domainname/my.private.domain.tld/vpcesource/vpce-abcd1234efg ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Benutzerdefinierte Domainnamen für private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [DeleteDomainNameAccessAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-domain-name-access-association.html)in der *AWS CLI Befehlsreferenz*. ### `delete-domain-name` Das folgende Codebeispiel zeigt die Verwendung`delete-domain-name`. **AWS CLI** **So löschen Sie einen benutzerdefinierten Domainnamen** Befehl: ``` aws apigateway delete-domain-name --domain-name 'api.domain.tld' ``` + Einzelheiten zur API finden Sie [DeleteDomainName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-domain-name.html)in der *AWS CLI Befehlsreferenz*. ### `delete-integration-response` Das folgende Codebeispiel zeigt die Verwendung`delete-integration-response`. **AWS CLI** **So löschen Sie eine Integrationsantwort für eine bestimmte Ressource und Methode sowie einen bestimmten Statuscode in einer API** Befehl: ``` aws apigateway delete-integration-response --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --status-code 200 ``` + Einzelheiten zur API finden Sie [DeleteIntegrationResponse](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-integration-response.html)in der *AWS CLI Befehlsreferenz*. ### `delete-integration` Das folgende Codebeispiel zeigt die Verwendung`delete-integration`. **AWS CLI** **So löschen Sie eine Integration für eine bestimmte Ressource und Methode in einer API** Befehl: ``` aws apigateway delete-integration --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET ``` + Einzelheiten zur API finden Sie [DeleteIntegration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-integration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-method-response` Das folgende Codebeispiel zeigt die Verwendung`delete-method-response`. **AWS CLI** **So löschen Sie eine Methodenantwort für eine bestimmte Ressource und Methode sowie einen bestimmten Statuscode in einer API** Befehl: ``` aws apigateway delete-method-response --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --status-code 200 ``` + Einzelheiten zur API finden Sie [DeleteMethodResponse](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-method-response.html)in der *AWS CLI Befehlsreferenz*. ### `delete-method` Das folgende Codebeispiel zeigt die Verwendung`delete-method`. **AWS CLI** **So löschen Sie eine Methode für eine bestimmte Ressource in einer API** Befehl: ``` aws apigateway delete-method --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET ``` + Einzelheiten zur API finden Sie [DeleteMethod](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-method.html)in der *AWS CLI Befehlsreferenz*. ### `delete-model` Das folgende Codebeispiel zeigt die Verwendung`delete-model`. **AWS CLI** **So löschen Sie ein Modell in der angegebenen API** Befehl: ``` aws apigateway delete-model --rest-api-id 1234123412 --model-name 'customModel' ``` + Einzelheiten zur API finden Sie [DeleteModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-model.html)in der *AWS CLI Befehlsreferenz*. ### `delete-resource` Das folgende Codebeispiel zeigt die Verwendung`delete-resource`. **AWS CLI** **So löschen Sie eine Ressource in einer API** Befehl: ``` aws apigateway delete-resource --rest-api-id 1234123412 --resource-id a1b2c3 ``` + Einzelheiten zur API finden Sie [DeleteResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-resource.html)in der *AWS CLI Befehlsreferenz*. ### `delete-rest-api` Das folgende Codebeispiel zeigt die Verwendung`delete-rest-api`. **AWS CLI** **So löschen Sie eine API** Befehl: ``` aws apigateway delete-rest-api --rest-api-id 1234123412 ``` + Einzelheiten zur API finden Sie [DeleteRestApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-rest-api.html)in der *AWS CLI Befehlsreferenz*. ### `delete-stage` Das folgende Codebeispiel zeigt die Verwendung`delete-stage`. **AWS CLI** **So löschen Sie eine Stufe in einer API** Befehl: ``` aws apigateway delete-stage --rest-api-id 1234123412 --stage-name 'dev' ``` + Einzelheiten zur API finden Sie [DeleteStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-stage.html)in der *AWS CLI Befehlsreferenz*. ### `delete-usage-plan-key` Das folgende Codebeispiel zeigt die Verwendung`delete-usage-plan-key`. **AWS CLI** **So entfernen Sie einen API-Schlüssel aus einem Nutzungsplan** Befehl: ``` aws apigateway delete-usage-plan-key --usage-plan-id a1b2c3 --key-id 1NbjQzMReAkeEQPNAW8r3dXsU2rDD7fc7f2Sipnu ``` + Einzelheiten zur API finden Sie [DeleteUsagePlanKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-usage-plan-key.html)in der *AWS CLI Befehlsreferenz*. ### `delete-usage-plan` Das folgende Codebeispiel zeigt die Verwendung`delete-usage-plan`. **AWS CLI** **So löschen Sie einen Nutzungsplan** Befehl: ``` aws apigateway delete-usage-plan --usage-plan-id a1b2c3 ``` + Einzelheiten zur API finden Sie [DeleteUsagePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/delete-usage-plan.html)in der *AWS CLI Befehlsreferenz*. ### `flush-stage-authorizers-cache` Das folgende Codebeispiel zeigt die Verwendung`flush-stage-authorizers-cache`. **AWS CLI** **So löschen Sie alle Genehmiger-Cache-Einträge auf einer Stufe** Befehl: ``` aws apigateway flush-stage-authorizers-cache --rest-api-id 1234123412 --stage-name dev ``` + Einzelheiten zur API finden Sie [FlushStageAuthorizersCache](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/flush-stage-authorizers-cache.html)in der *AWS CLI Befehlsreferenz*. ### `flush-stage-cache` Das folgende Codebeispiel zeigt die Verwendung`flush-stage-cache`. **AWS CLI** **So löschen Sie den Cache für die Stufe einer API** Im folgenden Beispiel für `flush-stage-cache` wird der Cache einer Stufe gelöscht. ``` aws apigateway flush-stage-cache \ --rest-api-id 1234123412 \ --stage-name dev ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen des API-Stufen-Cache in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-caching.html#flush-api-caching) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [FlushStageCache](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/flush-stage-cache.html)in der *AWS CLI Befehlsreferenz*. ### `generate-client-certificate` Das folgende Codebeispiel zeigt die Verwendung`generate-client-certificate`. **AWS CLI** **So erstellen Sie ein clientseitiges SSL-Zertifikat** Befehl: ``` aws apigateway generate-client-certificate --description 'My First Client Certificate' ``` + Einzelheiten zur API finden Sie [GenerateClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/generate-client-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `get-account` Das folgende Codebeispiel zeigt die Verwendung`get-account`. **AWS CLI** **So rufen Sie die Kontoeinstellungen für API Gateway ab** Befehl: ``` aws apigateway get-account ``` Ausgabe: ``` { "cloudwatchRoleArn": "arn:aws:iam::123412341234:role/APIGatewayToCloudWatchLogsRole", "throttleSettings": { "rateLimit": 500.0, "burstLimit": 1000 } } ``` + Einzelheiten zur API finden Sie [GetAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-account.html)in der *AWS CLI Befehlsreferenz*. ### `get-api-key` Das folgende Codebeispiel zeigt die Verwendung`get-api-key`. **AWS CLI** **So rufen Sie Informationen zu einem bestimmten API-Schlüssel ab** Befehl: ``` aws apigateway get-api-key --api-key 8bklk8bl1k3sB38D9B3l0enyWT8c09B30lkq0blk ``` Ausgabe: ``` { "description": "My first key", "enabled": true, "stageKeys": [ "a1b2c3d4e5/dev", "e5d4c3b2a1/dev" ], "lastUpdatedDate": 1456184515, "createdDate": 1456184452, "id": "8bklk8bl1k3sB38D9B3l0enyWT8c09B30lkq0blk", "name": "My key" } ``` + Einzelheiten zur API finden Sie [GetApiKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-api-key.html)in der *AWS CLI Befehlsreferenz*. ### `get-api-keys` Das folgende Codebeispiel zeigt die Verwendung`get-api-keys`. **AWS CLI** **So rufen Sie die Liste der API-Schlüssel ab** Befehl: ``` aws apigateway get-api-keys ``` Ausgabe: ``` { "items": [ { "description": "My first key", "enabled": true, "stageKeys": [ "a1b2c3d4e5/dev", "e5d4c3b2a1/dev" ], "lastUpdatedDate": 1456184515, "createdDate": 1456184452, "id": "8bklk8bl1k3sB38D9B3l0enyWT8c09B30lkq0blk", "name": "My key" } ] } ``` + Einzelheiten zur API finden Sie [GetApiKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-api-keys.html)in der *AWS CLI Befehlsreferenz*. ### `get-authorizer` Das folgende Codebeispiel zeigt die Verwendung`get-authorizer`. **AWS CLI** **So rufen Sie die Einstellungen pro API-Genehmiger in API Gateway ab** Befehl: ``` aws apigateway get-authorizer --rest-api-id 1234123412 --authorizer-id gfi4n3 ``` Ausgabe: ``` { "authorizerResultTtlInSeconds": 300, "name": "MyAuthorizer", "type": "TOKEN", "identitySource": "method.request.header.Authorization", "authorizerUri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:authorizer_function/invocations", "id": "gfi4n3" } ``` + Einzelheiten zur API finden Sie [GetAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-authorizer.html)in der *AWS CLI Befehlsreferenz*. ### `get-authorizers` Das folgende Codebeispiel zeigt die Verwendung`get-authorizers`. **AWS CLI** **So rufen Sie die Liste der Genehmiger für eine REST-API ab** Befehl: ``` aws apigateway get-authorizers --rest-api-id 1234123412 ``` Ausgabe: ``` { "items": [ { "name": "MyAuthorizer", "authorizerUri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:My_Authorizer_Function/invocations", "authorizerResultTtlInSeconds": 300, "identitySource": "method.request.header.Authorization", "type": "TOKEN", "id": "gfi4n3" } ] } ``` + Einzelheiten zur API finden Sie [GetAuthorizers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-authorizers.html)in der *AWS CLI Befehlsreferenz*. ### `get-base-path-mapping` Das folgende Codebeispiel zeigt die Verwendung`get-base-path-mapping`. **AWS CLI** **So rufen Sie die Basispfadzuordnung für einen benutzerdefinierten Domainnamen ab** Befehl: ``` aws apigateway get-base-path-mapping --domain-name subdomain.domain.tld --base-path v1 ``` Ausgabe: ``` { "basePath": "v1", "restApiId": "1234w4321e", "stage": "api" } ``` + Einzelheiten zur API finden Sie [GetBasePathMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-base-path-mapping.html)in der *AWS CLI Befehlsreferenz*. ### `get-base-path-mappings` Das folgende Codebeispiel zeigt die Verwendung`get-base-path-mappings`. **AWS CLI** **So rufen Sie die Basispfadzuordnung für einen benutzerdefinierten Domainnamen ab** Befehl: ``` aws apigateway get-base-path-mappings --domain-name subdomain.domain.tld ``` Ausgabe: ``` { "items": [ { "basePath": "(none)", "restApiId": "1234w4321e", "stage": "dev" }, { "basePath": "v1", "restApiId": "1234w4321e", "stage": "api" } ] } ``` + Einzelheiten zur API finden Sie [GetBasePathMappings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-base-path-mappings.html)in der *AWS CLI Befehlsreferenz*. ### `get-client-certificate` Das folgende Codebeispiel zeigt die Verwendung`get-client-certificate`. **AWS CLI** **So rufen Sie ein Clientzertifikat ab** Befehl: ``` aws apigateway get-client-certificate --client-certificate-id a1b2c3 ``` + Einzelheiten zur API finden Sie [GetClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-client-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `get-client-certificates` Das folgende Codebeispiel zeigt die Verwendung`get-client-certificates`. **AWS CLI** **So rufen Sie eine Liste der Clientzertifikate ab** Befehl: ``` aws apigateway get-client-certificates ``` Ausgabe: ``` { "items": [ { "pemEncodedCertificate": "-----BEGIN CERTIFICATE----- -----END CERTIFICATE-----", "clientCertificateId": "a1b2c3", "expirationDate": 1483556561, "description": "My Client Certificate", "createdDate": 1452020561 } ] } ``` + Einzelheiten zur API finden Sie [GetClientCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-client-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `get-deployment` Das folgende Codebeispiel zeigt die Verwendung`get-deployment`. **AWS CLI** **So rufen Sie Informationen zu einer Bereitstellung ab** Befehl: ``` aws apigateway get-deployment --rest-api-id 1234123412 --deployment-id ztt4m2 ``` Ausgabe: ``` { "description": "myDeployment", "id": "ztt4m2", "createdDate": 1455218022 } ``` + Einzelheiten zur API finden Sie [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `get-deployments` Das folgende Codebeispiel zeigt die Verwendung`get-deployments`. **AWS CLI** **So rufen Sie eine Liste der Bereitstellungen für eine REST-API ab** Befehl: ``` aws apigateway get-deployments --rest-api-id 1234123412 ``` Ausgabe: ``` { "items": [ { "createdDate": 1453797217, "id": "0a2b4c", "description": "Deployed my API for the first time" } ] } ``` + Einzelheiten zur API finden Sie [GetDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-deployments.html)in der *AWS CLI Befehlsreferenz*. ### `get-domain-name-access-associations` Das folgende Codebeispiel zeigt die Verwendung`get-domain-name-access-associations`. **AWS CLI** **Beispiel 1: So listen Sie alle Domainnamenzugriffszuweisungen auf** Im folgenden Beispiel für `get-domain-name-access-associations` werden alle Domainnamenzugriffszuweisung aufgelistet. ``` aws apigateway get-domain-name-access-associations ``` Ausgabe: ``` { "items": [ { "domainNameAccessAssociationArn": "arn:aws:apigateway:us-west-2:012345678910:/domainnameaccessassociations/domainname/my.private.domain.tld/vpcesource/vpce-abcd1234efg "accessAssociationSource": "vpce-abcd1234efg", "accessAssociationSourceType": "VPCE", "domainNameArn" : "arn:aws:apigateway:us-west-2:111122223333:/domainnames/private.example.com+abcd1234" } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Domainnamen für private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html) im *Amazon API Gateway Developer Guide*. **Beispiel 2: Um alle Zugriffs-Zuordnungen für Domainnamen aufzulisten, die diesem AWS Konto gehören** Im folgenden `get-domain-name-access-associations` Beispiel werden alle Zugriffs-Zuordnungen für Domainnamen aufgeführt, die dem aktuellen AWS Konto gehören. ``` aws apigateway get-domain-name-access-associations \ --resource-owner SELF ``` Ausgabe: ``` { "items": [ { "domainNameAccessAssociationArn": "arn:aws:apigateway:us-west-2:012345678910:/domainnameaccessassociations/domainname/my.private.domain.tld/vpcesource/vpce-abcd1234efg "accessAssociationSource": "vpce-abcd1234efg", "accessAssociationSourceType": "VPCE", "domainNameArn" : "arn:aws:apigateway:us-west-2:111122223333:/domainnames/private.example.com+abcd1234" } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Domainnamen für private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [GetDomainNameAccessAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-domain-name-access-associations.html)in der *AWS CLI Befehlsreferenz*. ### `get-domain-name` Das folgende Codebeispiel zeigt die Verwendung`get-domain-name`. **AWS CLI** **Beispiel 1: So rufen Sie Informationen über einen öffentlichen benutzerdefinierten Domainnamen ab** Im folgenden Beispiel für `get-domain-name` werden Informationen über einen öffentlichen benutzerdefinierten Domainnamen abgerufen. ``` aws apigateway get-domain-name \ --domain-name api.domain.tld ``` Ausgabe: ``` { "domainName": "api.domain.tld", "distributionDomainName": "d1a2f3a4c5o6d.cloudfront.net", "certificateName": "uploadedCertificate", "certificateUploadDate": 1462565487 } ``` Weitere Informationen finden Sie unter [Benutzerdefinierter Domainname für öffentliches REST APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html) im *Amazon API Gateway Developer Guide*. **Beispiel 2: So rufen Sie Informationen über einen privaten benutzerdefinierten Domainnamen ab** Im folgenden Beispiel für `get-domain-name` werden Informationen über einen privaten benutzerdefinierten Domainnamen abgerufen. ``` aws apigateway get-domain-name \ --domain-name api.private.domain.tld \ --domain-name-id abcd1234 ``` Ausgabe: ``` { "domainName": "my.private.domain.tld", "domainNameId": "abcd1234", "domainNameArn": "arn:aws:apigateway:us-east-1:012345678910:/domainnames/my.private.domain.tld+abcd1234", "certificateArn": "arn:aws:acm:us-east-1:012345678910:certificate/fb1b9770-a305-495d-aefb-27e5e101ff3", "certificateUploadDate": "2024-09-10T10:31:20-07:00", "endpointConfiguration": { "types": [ "PRIVATE" ] }, "domainNameStatus": "AVAILABLE", "securityPolicy": "TLS_1_2", "policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":\"execute-api:Invoke\",\"Resource\":\"arn:aws:execute-api:us-east-1:012345678910:/domainnames/my.private.domain.tld+abcd1234\"},{\"Effect\":\"Deny\",\"Principal\":\"*\",\"Action\":\"execute-api:Invoke\",\"Resource\":\"arn:aws:execute-api:us-east-1:012345678910:/domainnames/my.private.domain.tld+abcd1234\",\"Condition\":{\"StringNotEquals\":{\"aws:SourceVpc\":\"vpc-1a2b3c4d\"}}}]}" } ``` Weitere Informationen finden Sie unter [Benutzerdefinierter Domainname für öffentliches REST APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [GetDomainName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-domain-name.html)in der *AWS CLI Befehlsreferenz*. ### `get-domain-names` Das folgende Codebeispiel zeigt die Verwendung`get-domain-names`. **AWS CLI** **Beispiel 1: So rufen Sie eine Liste der benutzerdefinierten Domainnamen ab** Mit dem folgenden `get-domain-names`-Befehl wird eine Liste der Domainnamen abgerufen. ``` aws apigateway get-domain-names ``` Ausgabe: ``` { "items": [ { "distributionDomainName": "d9511k3l09bkd.cloudfront.net", "certificateUploadDate": 1452812505, "certificateName": "my_custom_domain-certificate", "domainName": "subdomain.domain.tld" } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Domainnamen für private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html) im *Amazon API Gateway Developer Guide*. **Beispiel 2: Um eine Liste der benutzerdefinierten Domainnamen zu erhalten, die diesem AWS Konto gehören** Mit dem folgenden `get-domain-names` Befehl wird eine Liste der Domainnamen abgerufen, die diesem AWS Konto gehören. ``` aws apigateway get-domain-names \ --resource-owner SELF ``` Ausgabe: ``` { "items": [ { "domainName": "my.domain.tld", "domainNameArn": "arn:aws:apigateway:us-east-1::/domainnames/my.private.domain.tld", "certificateUploadDate": "2024-08-15T17:02:55-07:00", "regionalDomainName": "d-abcd1234.execute-api.us-east-1.amazonaws.com", "regionalHostedZoneId": "Z1UJRXOUMOOFQ8", "regionalCertificateArn": "arn:aws:acm:us-east-1:012345678910:certificate/fb1b9770-a305-495d-aefb-27e5e101ff3", "endpointConfiguration": { "types": [ "REGIONAL" ] }, "domainNameStatus": "AVAILABLE", "securityPolicy": "TLS_1_2" }, { "domainName": "my.private.domain.tld", "domainNameId": "abcd1234", "domainNameArn": "arn:aws:apigateway:us-east-1:012345678910:/domainnames/my.private.domain.tld+abcd1234", "certificateArn": "arn:aws:acm:us-east-1:012345678910:certificate/fb1b9770-a305-495d-aefb-27e5e101ff3", "certificateUploadDate": "2024-11-26T11:44:40-08:00", "endpointConfiguration": { "types": [ "PRIVATE" ] }, "domainNameStatus": "AVAILABLE", "securityPolicy": "TLS_1_2" } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Domainnamen für private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html) im *Amazon API Gateway Developer Guide*. **Beispiel 3: Um eine Liste mit benutzerdefinierten Domainnamen zu erhalten, die anderen AWS Konten gehören und mit denen Sie eine Zuordnung für den Domainnamen-Zugriff erstellen können.** Mit dem folgenden `get-domain-names` Befehl wird eine Liste von Domainnamen abgerufen, die anderen AWS Konten gehören, auf die Sie Zugriff haben, um eine Zuordnung für den Domainnamen-Zugriff zu erstellen. ``` aws apigateway get-domain-names \ --resource-owner OTHER_ACCOUNTS ``` Ausgabe: ``` { "items": [ { "domainName": "my.private.domain.tld", "domainNameId": "abcd1234", "domainNameArn": "arn:aws:apigateway:us-east-1:012345678910:/domainnames/my.private.domain.tld+abcd1234" } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Domainnamen für private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [GetDomainNames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-domain-names.html)in der *AWS CLI Befehlsreferenz*. ### `get-export` Das folgende Codebeispiel zeigt die Verwendung`get-export`. **AWS CLI** **So rufen Sie JSON-Swagger-Vorlage für eine Stufe ab** Befehl: ``` aws apigateway get-export --rest-api-id a1b2c3d4e5 --stage-name dev --export-type swagger /path/to/filename.json ``` **So rufen Sie die JSON-Swagger-Vorlage \$1 API-Gateway-Erweiterungen für eine Phase ab** Befehl: ``` aws apigateway get-export --parameters extensions='integrations' --rest-api-id a1b2c3d4e5 --stage-name dev --export-type swagger /path/to/filename.json ``` **So rufen Sie JSON-Swagger-Vorlage und Postman-Erweiterungen für eine Stufe ab** Befehl: ``` aws apigateway get-export --parameters extensions='postman' --rest-api-id a1b2c3d4e5 --stage-name dev --export-type swagger /path/to/filename.json ``` + Einzelheiten zur API finden Sie [GetExport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-export.html)in der *AWS CLI Befehlsreferenz*. ### `get-integration-response` Das folgende Codebeispiel zeigt die Verwendung`get-integration-response`. **AWS CLI** **So rufen Sie die Konfiguration der Integrationsantwort für eine HTTP-Methode ab, die unter einer REST-API-Ressource definiert ist** Befehl: ``` aws apigateway get-integration-response --rest-api-id 1234123412 --resource-id y9h6rt --http-method GET --status-code 200 ``` Ausgabe: ``` { "statusCode": "200", "responseTemplates": { "application/json": null } } ``` + Einzelheiten zur API finden Sie [GetIntegrationResponse](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-integration-response.html)in der *AWS CLI Befehlsreferenz*. ### `get-integration` Das folgende Codebeispiel zeigt die Verwendung`get-integration`. **AWS CLI** **So rufen Sie die Konfiguration der Integration für eine HTTP-Methode ab, die unter einer REST-API-Ressource definiert ist** Befehl: ``` aws apigateway get-integration --rest-api-id 1234123412 --resource-id y9h6rt --http-method GET ``` Ausgabe: ``` { "httpMethod": "POST", "integrationResponses": { "200": { "responseTemplates": { "application/json": null }, "statusCode": "200" } }, "cacheKeyParameters": [], "type": "AWS", "uri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:My_Function/invocations", "cacheNamespace": "y9h6rt" } ``` + Einzelheiten zur API finden Sie [GetIntegration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-integration.html)in der *AWS CLI Befehlsreferenz*. ### `get-method-response` Das folgende Codebeispiel zeigt die Verwendung`get-method-response`. **AWS CLI** **So rufen Sie die Ressourcenkonfiguration der Methodenantwort für eine HTTP-Methode ab, die unter einer REST-API-Ressource definiert ist** Befehl: ``` aws apigateway get-method-response --rest-api-id 1234123412 --resource-id y9h6rt --http-method GET --status-code 200 ``` Ausgabe: ``` { "responseModels": { "application/json": "Empty" }, "statusCode": "200" } ``` + Einzelheiten zur API finden Sie [GetMethodResponse](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-method-response.html)in der *AWS CLI Befehlsreferenz*. ### `get-method` Das folgende Codebeispiel zeigt die Verwendung`get-method`. **AWS CLI** **So rufen Sie die Ressourcenkonfiguration der Methode für eine HTTP-Methode ab, die unter einer REST-API-Ressource definiert ist** Befehl: ``` aws apigateway get-method --rest-api-id 1234123412 --resource-id y9h6rt --http-method GET ``` Ausgabe: ``` { "apiKeyRequired": false, "httpMethod": "GET", "methodIntegration": { "integrationResponses": { "200": { "responseTemplates": { "application/json": null }, "statusCode": "200" } }, "cacheKeyParameters": [], "uri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:My_Function/invocations", "httpMethod": "POST", "cacheNamespace": "y9h6rt", "type": "AWS" }, "requestParameters": {}, "methodResponses": { "200": { "responseModels": { "application/json": "Empty" }, "statusCode": "200" } }, "authorizationType": "NONE" } ``` + Einzelheiten zur API finden Sie [GetMethod](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-method.html)in der *AWS CLI Befehlsreferenz*. ### `get-model-template` Das folgende Codebeispiel zeigt die Verwendung`get-model-template`. **AWS CLI** **So rufen die Zuordnungsvorlage für ein Modell ab, das unter einer REST-API definiert ist** Befehl: ``` aws apigateway get-model-template --rest-api-id 1234123412 --model-name Empty ``` Ausgabe: ``` { "value": "#set($inputRoot = $input.path('$'))\n{ }" } ``` + Einzelheiten zur API finden Sie [GetModelTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-model-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-model` Das folgende Codebeispiel zeigt die Verwendung`get-model`. **AWS CLI** **So rufen Sie die Konfiguration für ein Modell ab, das unter einer REST-API definiert ist** Befehl: ``` aws apigateway get-model --rest-api-id 1234123412 --model-name Empty ``` Ausgabe: ``` { "contentType": "application/json", "description": "This is a default empty schema model", "name": "Empty", "id": "etd5w5", "schema": "{\n \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n \"title\" : \"Empty Schema\",\n \"type\" : \"object\"\n}" } ``` + Einzelheiten zur API finden Sie [GetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-model.html)in der *AWS CLI Befehlsreferenz*. ### `get-models` Das folgende Codebeispiel zeigt die Verwendung`get-models`. **AWS CLI** **So rufen Sie eine Liste der Modelle für eine REST-API ab** Befehl: ``` aws apigateway get-models --rest-api-id 1234123412 ``` Ausgabe: ``` { "items": [ { "description": "This is a default error schema model", "schema": "{\n \"$schema\" : \"http://json-schema.org/draft-04/schema#\",\n \"title\" : \"Error Schema\",\n \"type\" : \"object\",\n \"properties\" : {\n \"message\" : { \"type\" : \"string\" }\n }\n}", "contentType": "application/json", "id": "7tpbze", "name": "Error" }, { "description": "This is a default empty schema model", "schema": "{\n \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n \"title\" : \"Empty Schema\",\n \"type\" : \"object\"\n}", "contentType": "application/json", "id": "etd5w5", "name": "Empty" } ] } ``` + Einzelheiten zur API finden Sie [GetModels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-models.html)in der *AWS CLI Befehlsreferenz*. ### `get-resource` Das folgende Codebeispiel zeigt die Verwendung`get-resource`. **AWS CLI** **So rufen Sie Informationen über eine Ressource ab** Befehl: ``` aws apigateway get-resource --rest-api-id 1234123412 --resource-id zwo0y3 ``` Ausgabe: ``` { "path": "/path", "pathPart": "path", "id": "zwo0y3", "parentId": "uyokt6ij2g" } ``` + Einzelheiten zur API finden Sie [GetResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-resource.html)in der *AWS CLI Befehlsreferenz*. ### `get-resources` Das folgende Codebeispiel zeigt die Verwendung`get-resources`. **AWS CLI** **So rufen Sie eine Liste der Ressourcen für eine REST-API ab** Befehl: ``` aws apigateway get-resources --rest-api-id 1234123412 ``` Ausgabe: ``` { "items": [ { "path": "/resource/subresource", "resourceMethods": { "POST": {} }, "id": "024ace", "pathPart": "subresource", "parentId": "ai5b02" } ] } ``` + Einzelheiten zur API finden Sie [GetResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-resources.html)in der *AWS CLI Befehlsreferenz*. ### `get-rest-api` Das folgende Codebeispiel zeigt die Verwendung`get-rest-api`. **AWS CLI** **So rufen Sie Informationen über eine API ab** Befehl: ``` aws apigateway get-rest-api --rest-api-id 1234123412 ``` Ausgabe: ``` { "name": "myAPI", "id": "o1y243m4f5", "createdDate": 1453416433 } ``` + Einzelheiten zur API finden Sie [GetRestApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-rest-api.html)in der *AWS CLI Befehlsreferenz*. ### `get-rest-apis` Das folgende Codebeispiel zeigt die Verwendung`get-rest-apis`. **AWS CLI** **Um eine REST-Liste zu erhalten APIs** Befehl: ``` aws apigateway get-rest-apis ``` Ausgabe: ``` { "items": [ { "createdDate": 1438884790, "id": "12s44z21rb", "name": "My First API" } ] } ``` + Einzelheiten zur API finden Sie [GetRestApis](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-rest-apis.html)in der *AWS CLI Befehlsreferenz*. ### `get-sdk` Das folgende Codebeispiel zeigt die Verwendung`get-sdk`. **AWS CLI** **So rufen Sie das Android-SDK für eine REST-API-Stufe ab** Befehl: ``` aws apigateway get-sdk --rest-api-id 1234123412 --stage-name dev --sdk-type android --parameters groupId='com.mycompany',invokerPackage='com.mycompany.clientsdk',artifactId='Mycompany-client',artifactVersion='1.0.0' /path/to/android_sdk.zip ``` Ausgabe: ``` { "contentType": "application/octet-stream", "contentDisposition": "attachment; filename=\"android_2016-02-22_23-52Z.zip\"" } ``` **So rufen Sie das IOS-SDK für eine REST-API-Stufe ab** Befehl: ``` aws apigateway get-sdk --rest-api-id 1234123412 --stage-name dev --sdk-type objectivec --parameters classPrefix='myprefix' /path/to/iOS_sdk.zip ``` Ausgabe: ``` { "contentType": "application/octet-stream", "contentDisposition": "attachment; filename=\"objectivec_2016-02-22_23-52Z.zip\"" } ``` **So rufen Sie das Javascript-SDK für eine REST-API-Stufe ab** Befehl: ``` aws apigateway get-sdk --rest-api-id 1234123412 --stage-name dev --sdk-type javascript /path/to/javascript_sdk.zip ``` Ausgabe: ``` { "contentType": "application/octet-stream", "contentDisposition": "attachment; filename=\"javascript_2016-02-22_23-52Z.zip\"" } ``` + Einzelheiten zur API finden Sie [GetSdk](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-sdk.html)in der *AWS CLI Befehlsreferenz*. ### `get-stage` Das folgende Codebeispiel zeigt die Verwendung`get-stage`. **AWS CLI** **So rufen Sie Informationen über die Stufe einer API ab** Befehl: ``` aws apigateway get-stage --rest-api-id 1234123412 --stage-name dev ``` Ausgabe: ``` { "stageName": "dev", "cacheClusterSize": "0.5", "cacheClusterEnabled": false, "cacheClusterStatus": "NOT_AVAILABLE", "deploymentId": "rbh1fj", "lastUpdatedDate": 1466802961, "createdDate": 1460682074, "methodSettings": { "*/*": { "cacheTtlInSeconds": 300, "loggingLevel": "INFO", "dataTraceEnabled": false, "metricsEnabled": true, "unauthorizedCacheControlHeaderStrategy": "SUCCEED_WITH_RESPONSE_HEADER", "throttlingRateLimit": 500.0, "cacheDataEncrypted": false, "cachingEnabled": false, "throttlingBurstLimit": 1000, "requireAuthorizationForCacheControl": true }, "~1resource/GET": { "cacheTtlInSeconds": 300, "loggingLevel": "INFO", "dataTraceEnabled": false, "metricsEnabled": true, "unauthorizedCacheControlHeaderStrategy": "SUCCEED_WITH_RESPONSE_HEADER", "throttlingRateLimit": 500.0, "cacheDataEncrypted": false, "cachingEnabled": false, "throttlingBurstLimit": 1000, "requireAuthorizationForCacheControl": true } } } ``` + Einzelheiten zur API finden Sie [GetStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-stage.html)in der *AWS CLI Befehlsreferenz*. ### `get-stages` Das folgende Codebeispiel zeigt die Verwendung`get-stages`. **AWS CLI** **So rufen Sie die Liste der Stufen für eine REST-API ab** Befehl: ``` aws apigateway get-stages --rest-api-id 1234123412 ``` Ausgabe: ``` { "item": [ { "stageName": "dev", "cacheClusterSize": "0.5", "cacheClusterEnabled": true, "cacheClusterStatus": "AVAILABLE", "deploymentId": "123h64", "lastUpdatedDate": 1456185138, "createdDate": 1453589092, "methodSettings": { "~1resource~1subresource/POST": { "cacheTtlInSeconds": 300, "loggingLevel": "INFO", "dataTraceEnabled": true, "metricsEnabled": true, "throttlingRateLimit": 500.0, "cacheDataEncrypted": false, "cachingEnabled": false, "throttlingBurstLimit": 1000 } } } ] } ``` + Einzelheiten zur API finden Sie [GetStages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-stages.html)in der *AWS CLI Befehlsreferenz*. ### `get-usage-plan-key` Das folgende Codebeispiel zeigt die Verwendung`get-usage-plan-key`. **AWS CLI** **So rufen Sie die Details eines API-Schlüssels ab, der einem Nutzungsplan zugeordnet ist** Befehl: ``` aws apigateway get-usage-plan-key --usage-plan-id a1b2c3 --key-id 1NbjQzMReAkeEQPNAW8r3dXsU2rDD7fc7f2Sipnu ``` + Einzelheiten zur API finden Sie [GetUsagePlanKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-usage-plan-key.html)in der *AWS CLI Befehlsreferenz*. ### `get-usage-plan-keys` Das folgende Codebeispiel zeigt die Verwendung`get-usage-plan-keys`. **AWS CLI** **So rufen Sie die Liste der API-Schlüssel ab, der einem Nutzungsplan zugeordnet sind** Befehl: ``` aws apigateway get-usage-plan-keys --usage-plan-id a1b2c3 ``` + Einzelheiten zur API finden Sie [GetUsagePlanKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-usage-plan-keys.html)in der *AWS CLI Befehlsreferenz*. ### `get-usage-plan` Das folgende Codebeispiel zeigt die Verwendung`get-usage-plan`. **AWS CLI** **So rufen Sie die Details eines Nutzungsplans ab** Befehl: ``` aws apigateway get-usage-plan --usage-plan-id a1b2c3 ``` + Einzelheiten zur API finden Sie [GetUsagePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-usage-plan.html)in der *AWS CLI Befehlsreferenz*. ### `get-usage-plans` Das folgende Codebeispiel zeigt die Verwendung`get-usage-plans`. **AWS CLI** **So rufen Sie die Details aller Nutzungspläne ab** Befehl: ``` aws apigateway get-usage-plans ``` + Einzelheiten zur API finden Sie [GetUsagePlans](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-usage-plans.html)in der *AWS CLI Befehlsreferenz*. ### `get-usage` Das folgende Codebeispiel zeigt die Verwendung`get-usage`. **AWS CLI** **So rufen Sie die Nutzungsdetails für einen Nutzungsplan ab** Befehl: ``` aws apigateway get-usage --usage-plan-id a1b2c3 --start-date "2016-08-16" --end-date "2016-08-17" ``` + Einzelheiten zur API finden Sie [GetUsage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/get-usage.html)in der *AWS CLI Befehlsreferenz*. ### `import-rest-api` Das folgende Codebeispiel zeigt die Verwendung`import-rest-api`. **AWS CLI** **So importieren Sie eine Swagger-Vorlage und erstellen eine API** Befehl: ``` aws apigateway import-rest-api --body 'file:///path/to/API_Swagger_template.json' ``` + Einzelheiten zur API finden Sie [ImportRestApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/import-rest-api.html)in der *AWS CLI Befehlsreferenz*. ### `put-integration-response` Das folgende Codebeispiel zeigt die Verwendung`put-integration-response`. **AWS CLI** **So erstellen Sie eine Integrationsantwort als Standardantwort mit einer definierten Zuweisungsvorlage** Befehl: ``` aws apigateway put-integration-response --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --status-code 200 --selection-pattern "" --response-templates '{"application/json": "{\"json\": \"template\"}"}' ``` **So erstellen Sie eine Integrationsantwort mit einer Regex von 400 und einem statisch definierten Header-Wert** Befehl: ``` aws apigateway put-integration-response --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --status-code 400 --selection-pattern 400 --response-parameters '{"method.response.header.custom-header": "'"'"'custom-value'"'"'"}' ``` + Einzelheiten zur API finden Sie [PutIntegrationResponse](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/put-integration-response.html)in der *AWS CLI Befehlsreferenz*. ### `put-integration` Das folgende Codebeispiel zeigt die Verwendung`put-integration`. **AWS CLI** **So erstellen Sie eine Mock-Integrationsanforderung** Befehl: ``` aws apigateway put-integration --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --type MOCK --request-templates '{ "application/json": "{\"statusCode\": 200}" }' ``` **So erstellen Sie eine HTTP-Integrationsanforderung** Befehl: ``` aws apigateway put-integration --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --type HTTP --integration-http-method GET --uri 'https://domain.tld/path' ``` **So erstellen Sie eine AWS Integrationsanfrage mit einem Lambda-Funktionsendpunkt** Befehl: ``` aws apigateway put-integration --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --type AWS --integration-http-method POST --uri 'arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:function_name/invocations' ``` + Einzelheiten zur API finden Sie [PutIntegration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/put-integration.html)in der *AWS CLI Befehlsreferenz.* ### `put-method-response` Das folgende Codebeispiel zeigt die Verwendung`put-method-response`. **AWS CLI** **So erstellen Sie eine Methodenantwort unter dem angegebenen Statuscode mit einem benutzerdefinierten Methodenantwortheader** Befehl: ``` aws apigateway put-method-response --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --status-code 400 --response-parameters "method.response.header.custom-header=false" ``` + Einzelheiten zur API finden Sie [PutMethodResponse](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/put-method-response.html)in der *AWS CLI Befehlsreferenz*. ### `put-method` Das folgende Codebeispiel zeigt die Verwendung`put-method`. **AWS CLI** **So erstellen Sie eine Methode für eine Ressource in einer API ohne Autorisierung, ohne API-Schlüssel und mit einem benutzerdefinierten Methodenanforderungsheader** Befehl: ``` aws apigateway put-method --rest-api-id 1234123412 --resource-id a1b2c3 --http-method PUT --authorization-type "NONE" --no-api-key-required --request-parameters "method.request.header.custom-header=false" ``` + Einzelheiten zur API finden Sie [PutMethod](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/put-method.html)in der *AWS CLI Befehlsreferenz*. ### `put-rest-api` Das folgende Codebeispiel zeigt die Verwendung`put-rest-api`. **AWS CLI** **So überschreiben Sie eine bestehende API mit einer Swagger-Vorlage** Befehl: ``` aws apigateway put-rest-api --rest-api-id 1234123412 --mode overwrite --body 'fileb:///path/to/API_Swagger_template.json' ``` **So führen Sie eine Swagger-Vorlage mit einer bestehenden API zusammen** Befehl: ``` aws apigateway put-rest-api --rest-api-id 1234123412 --mode merge --body 'fileb:///path/to/API_Swagger_template.json' ``` + Einzelheiten zur API finden Sie [PutRestApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/put-rest-api.html)in der *AWS CLI Befehlsreferenz*. ### `reject-domain-name-access-association` Das folgende Codebeispiel zeigt die Verwendung`reject-domain-name-access-association`. **AWS CLI** **So weisen Sie eine Domainnamenzugriffszuweisung ab** Im folgenden Beispiel für `reject-domain-name-access-association` wird eine Domainnamenzugriffszuweisung zwischen einem privaten benutzerdefinierten Domainnamen und einem VPC-Endpunkt abgewiesen. ``` aws apigateway reject-domain-name-access-association \ --domain-name-access-association-arn arn:aws:apigateway:us-west-2:012345678910:/domainnameaccessassociations/domainname/my.private.domain.tld/vpcesource/vpce-abcd1234efg \ --domain-name-arn arn:aws:apigateway:us-east-1:012345678910:/domainnames/my.private.domain.tld+abcd1234 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Benutzerdefinierte Domainnamen für private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [RejectDomainNameAccessAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/reject-domain-name-access-association.html)in der *AWS CLI Befehlsreferenz*. ### `test-invoke-authorizer` Das folgende Codebeispiel zeigt die Verwendung`test-invoke-authorizer`. **AWS CLI** **So testen Sie das Aufrufen einer Anforderung an einen benutzerdefinierten Genehmiger, die den erforderlichen Header und Wert enthält** Befehl: ``` aws apigateway test-invoke-authorizer --rest-api-id 1234123412 --authorizer-id 5yid1t --headers Authorization='Value' ``` + Einzelheiten zur API finden Sie [TestInvokeAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/test-invoke-authorizer.html)in der *AWS CLI Befehlsreferenz*. ### `test-invoke-method` Das folgende Codebeispiel zeigt die Verwendung`test-invoke-method`. **AWS CLI** **So testen Sie das Aufrufen der Root-Ressource in einer API, indem Sie eine GET-Anforderung stellen** Befehl: ``` aws apigateway test-invoke-method --rest-api-id 1234123412 --resource-id avl5sg8fw8 --http-method GET --path-with-query-string '/' ``` **So testen Sie das Aufrufen einer Subressource in einer API, indem Sie eine GET-Anforderung mit einem angegebenen Pfadparameterwert stellen** Befehl: ``` aws apigateway test-invoke-method --rest-api-id 1234123412 --resource-id 3gapai --http-method GET --path-with-query-string '/pets/1' ``` + Einzelheiten zur API finden Sie [TestInvokeMethod](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/test-invoke-method.html)in der *AWS CLI Befehlsreferenz*. ### `update-account` Das folgende Codebeispiel zeigt die Verwendung`update-account`. **AWS CLI** **So ändern Sie den ARN der IAM-Rolle für die Protokollierung in Logs CloudWatch ** Befehl: ``` aws apigateway update-account --patch-operations op='replace',path='/cloudwatchRoleArn',value='arn:aws:iam::123412341234:role/APIGatewayToCloudWatchLogs' ``` Ausgabe: ``` { "cloudwatchRoleArn": "arn:aws:iam::123412341234:role/APIGatewayToCloudWatchLogs", "throttleSettings": { "rateLimit": 1000.0, "burstLimit": 2000 } } ``` + Einzelheiten zur API finden Sie [UpdateAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-account.html)in der *AWS CLI Befehlsreferenz.* ### `update-api-key` Das folgende Codebeispiel zeigt die Verwendung`update-api-key`. **AWS CLI** **So ändern Sie den Namen für einen API-Schlüssel** Befehl: ``` aws apigateway update-api-key --api-key sNvjQDMReA1eEQPNAW8r37XsU2rDD7fc7m2SiMnu --patch-operations op='replace',path='/name',value='newName' ``` Ausgabe: ``` { "description": "currentDescription", "enabled": true, "stageKeys": [ "41t2j324r5/dev" ], "lastUpdatedDate": 1470086052, "createdDate": 1445460347, "id": "sNvjQDMReA1vEQPNzW8r3dXsU2rrD7fcjm2SiMnu", "name": "newName" } ``` **So deaktivieren Sie den API-Schlüssel** Befehl: ``` aws apigateway update-api-key --api-key sNvjQDMReA1eEQPNAW8r37XsU2rDD7fc7m2SiMnu --patch-operations op='replace',path='/enabled',value='false' ``` Ausgabe: ``` { "description": "currentDescription", "enabled": false, "stageKeys": [ "41t2j324r5/dev" ], "lastUpdatedDate": 1470086052, "createdDate": 1445460347, "id": "sNvjQDMReA1vEQPNzW8r3dXsU2rrD7fcjm2SiMnu", "name": "newName" } ``` + Einzelheiten zur API finden Sie [UpdateApiKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-api-key.html)in der *AWS CLI Befehlsreferenz*. ### `update-authorizer` Das folgende Codebeispiel zeigt die Verwendung`update-authorizer`. **AWS CLI** **So ändern Sie den Namen des benutzerdefinierten Genehmigers** Befehl: ``` aws apigateway update-authorizer --rest-api-id 1234123412 --authorizer-id gfi4n3 --patch-operations op='replace',path='/name',value='testAuthorizer' ``` Ausgabe: ``` { "authType": "custom", "name": "testAuthorizer", "authorizerUri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:customAuthorizer/invocations", "authorizerResultTtlInSeconds": 300, "identitySource": "method.request.header.Authorization", "type": "TOKEN", "id": "gfi4n3" } ``` **So ändern Sie die Lambda-Funktion, die vom benutzerdefinierten Genehmiger aufgerufen wird** Befehl: ``` aws apigateway update-authorizer --rest-api-id 1234123412 --authorizer-id gfi4n3 --patch-operations op='replace',path='/authorizerUri',value='arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:newAuthorizer/invocations' ``` Ausgabe: ``` { "authType": "custom", "name": "testAuthorizer", "authorizerUri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:newAuthorizer/invocations", "authorizerResultTtlInSeconds": 300, "identitySource": "method.request.header.Authorization", "type": "TOKEN", "id": "gfi4n3" } ``` + Einzelheiten zur API finden Sie [UpdateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-authorizer.html)in der *AWS CLI Befehlsreferenz*. ### `update-base-path-mapping` Das folgende Codebeispiel zeigt die Verwendung`update-base-path-mapping`. **AWS CLI** **So ändern Sie den Basispfad für einen benutzerdefinierten Domainnamen** Befehl: ``` aws apigateway update-base-path-mapping --domain-name api.domain.tld --base-path prod --patch-operations op='replace',path='/basePath',value='v1' ``` Ausgabe: ``` { "basePath": "v1", "restApiId": "1234123412", "stage": "api" } ``` + Einzelheiten zur API finden Sie [UpdateBasePathMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-base-path-mapping.html)in der *AWS CLI Befehlsreferenz*. ### `update-client-certificate` Das folgende Codebeispiel zeigt die Verwendung`update-client-certificate`. **AWS CLI** **So aktualisieren Sie die Beschreibung eines Clientzertifikats** Befehl: ``` aws apigateway update-client-certificate --client-certificate-id a1b2c3 --patch-operations op='replace',path='/description',value='My new description' ``` + Einzelheiten zur API finden Sie [UpdateClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-client-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `update-deployment` Das folgende Codebeispiel zeigt die Verwendung`update-deployment`. **AWS CLI** **So ändern Sie die Beschreibung einer Bereitstellung** Befehl: ``` aws apigateway update-deployment --rest-api-id 1234123412 --deployment-id ztt4m2 --patch-operations op='replace',path='/description',value='newDescription' ``` Ausgabe: ``` { "description": "newDescription", "id": "ztt4m2", "createdDate": 1455218022 } ``` + Einzelheiten zur API finden Sie [UpdateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `update-domain-name` Das folgende Codebeispiel zeigt die Verwendung`update-domain-name`. **AWS CLI** **So ändern Sie den Zertifikatnamen für einen benutzerdefinierten Domainnamen** Im folgenden Beispiel für `update-domain-name` wird der Zertifikatname für einen benutzerdefinierten Domainnamen geändert. ``` aws apigateway update-domain-name \ --domain-name api.domain.tld \ --patch-operations op='replace',path='/certificateArn',value='arn:aws:acm:us-west-2:111122223333:certificate/CERTEXAMPLE123EXAMPLE' ``` Ausgabe: ``` { "domainName": "api.domain.tld", "distributionDomainName": "d123456789012.cloudfront.net", "certificateArn": "arn:aws:acm:us-west-2:111122223333:certificate/CERTEXAMPLE123EXAMPLE", "certificateUploadDate": 1462565487 } ``` Weitere Informationen finden Sie unter [Einrichten eines benutzerdefinierten Domainnamens für eine API in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [UpdateDomainName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-domain-name.html)in der *AWS CLI Befehlsreferenz*. ### `update-integration-response` Das folgende Codebeispiel zeigt die Verwendung`update-integration-response`. **AWS CLI** **So ändern Sie den Header einer Integrationsantwort so, dass er eine statische Zuordnung von '\$1' hat '\$1'** Befehl: ``` aws apigateway update-integration-response --rest-api-id 1234123412 --resource-id 3gapai --http-method GET --status-code 200 --patch-operations op='replace',path='/responseParameters/method.response.header.Access-Control-Allow-Origin',value='"'"'*'"'"' ``` Ausgabe: ``` { "statusCode": "200", "responseParameters": { "method.response.header.Access-Control-Allow-Origin": "'*'" } } ``` **So entfernen Sie den Header einer Integrationsantwort** Befehl: ``` aws apigateway update-integration-response --rest-api-id 1234123412 --resource-id 3gapai --http-method GET --status-code 200 --patch-operations op='remove',path='/responseParameters/method.response.header.Access-Control-Allow-Origin' ``` + Einzelheiten zur API finden Sie [UpdateIntegrationResponse](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-integration-response.html)in der *AWS CLI Befehlsreferenz*. ### `update-integration` Das folgende Codebeispiel zeigt die Verwendung`update-integration`. **AWS CLI** **So fügen Sie mit Input Passthrough konfigurierte Zuordnungsvorlage „Content-Type: application/json“ hinzu** Befehl: ``` aws apigateway update-integration \ --rest-api-id a1b2c3d4e5 \ --resource-id a1b2c3 \ --http-method POST \ --patch-operations "op='add',path='/requestTemplates/application~1json'" ``` **So aktualisieren (ersetzen) Sie die mit einer benutzerdefinierten Vorlage konfigurierte Zuordnungsvorlage „Content-Type: application/json** Befehl: ``` aws apigateway update-integration \ --rest-api-id a1b2c3d4e5 \ --resource-id a1b2c3 \ --http-method POST \ --patch-operations "op='replace',path='/requestTemplates/application~1json',value='{"example": "json"}'" ``` **So aktualisieren (ersetzen) Sie eine benutzerdefinierte Vorlage, die „Content-Type: application/json“ zugewiesen ist, mit Input Passthrough** Befehl: ``` aws apigateway update-integration \ --rest-api-id a1b2c3d4e5 \ --resource-id a1b2c3 \ --http-method POST \ --patch-operations "op='replace',path='requestTemplates/application~1json'" ``` **So entfernen Sie die Zuordnungsvorlage „Content-Type: application/json** Befehl: ``` aws apigateway update-integration \ --rest-api-id a1b2c3d4e5 \ --resource-id a1b2c3 \ --http-method POST \ --patch-operations "op='remove',path='/requestTemplates/application~1json'" ``` + Einzelheiten zur API finden Sie [UpdateIntegration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-integration.html)in der *AWS CLI Befehlsreferenz*. ### `update-method-response` Das folgende Codebeispiel zeigt die Verwendung`update-method-response`. **AWS CLI** **So erstellen Sie einen neuen Header für eine Methodenantwort für die 200-Antwort in einer Methode und definieren ihn als nicht erforderlich (Standard)** Befehl: ``` aws apigateway update-method-response --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --status-code 200 --patch-operations op="add",path="/responseParameters/method.response.header.custom-header",value="false" ``` **So löschen Sie ein Antwortmodell für die 200-Antwort in einer Methode** Befehl: ``` aws apigateway update-method-response --rest-api-id 1234123412 --resource-id a1b2c3 --http-method GET --status-code 200 --patch-operations op="remove",path="/responseModels/application~1json" ``` + Einzelheiten zur API finden Sie [UpdateMethodResponse](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-method-response.html)in der *AWS CLI Befehlsreferenz*. ### `update-method` Das folgende Codebeispiel zeigt die Verwendung`update-method`. **AWS CLI** **Beispiel 1: So ändern Sie Methode so, dass ein API-Schlüssel erforderlich ist** Im folgenden Beispiel für `update-method` wird die Methode so geändert, dass ein API-Schlüssel erforderlich ist. ``` aws apigateway update-method \ --rest-api-id 1234123412 \ --resource-id a1b2c3 \ --http-method GET \ --patch-operations op="replace",path="/apiKeyRequired",value="true" ``` Ausgabe: ``` { "httpMethod": "GET", "authorizationType": "NONE", "apiKeyRequired": true, "methodResponses": { "200": { "statusCode": "200", "responseModels": {} } }, "methodIntegration": { "type": "AWS", "httpMethod": "POST", "uri": "arn:aws:apigateway:us-east-1:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-1:123456789111:function:hello-world/invocations", "passthroughBehavior": "WHEN_NO_MATCH", "contentHandling": "CONVERT_TO_TEXT", "timeoutInMillis": 29000, "cacheNamespace": "h7i8j9", "cacheKeyParameters": [], "integrationResponses": { "200": { "statusCode": "200", "responseTemplates": {} } } } } ``` **Beispiel 2: So ändern Sie eine Methode so, dass eine IAM-Autorisierung erforderlich ist** Im folgenden Beispiel für `update-method` wird die Methode so geändert, dass eine IAM-Autorisierung erforderlich ist. ``` aws apigateway update-method \ --rest-api-id 1234123412 \ --resource-id a1b2c3 \ --http-method GET \ --patch-operations op="replace",path="/authorizationType",value="AWS_IAM" ``` Ausgabe: ``` { "httpMethod": "GET", "authorizationType": "AWS_IAM", "apiKeyRequired": false, "methodResponses": { "200": { "statusCode": "200", "responseModels": {} } }, "methodIntegration": { "type": "AWS", "httpMethod": "POST", "uri": "arn:aws:apigateway:us-east-1:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-1:123456789111:function:hello-world/invocations", "passthroughBehavior": "WHEN_NO_MATCH", "contentHandling": "CONVERT_TO_TEXT", "timeoutInMillis": 29000, "cacheNamespace": "h7i8j9", "cacheKeyParameters": [], "integrationResponses": { "200": { "statusCode": "200", "responseTemplates": {} } } } } ``` **Beispiel 3: So ändern Sie eine Methode so, dass eine Lambda-Autorisierung erforderlich ist** Im folgenden Beispiel für `update-method` wird die Methode so geändert, dass eine Lambda-Autorisierung erforderlich ist. ``` aws apigateway update-method --rest-api-id 1234123412 \ --resource-id a1b2c3 \ --http-method GET \ --patch-operations op="replace",path="/authorizationType",value="CUSTOM" op="replace",path="/authorizerId",value="e4f5g6" ``` Ausgabe: ``` { "httpMethod": "GET", "authorizationType": "CUSTOM", "authorizerId" : "e4f5g6", "apiKeyRequired": false, "methodResponses": { "200": { "statusCode": "200", "responseModels": {} } }, "methodIntegration": { "type": "AWS", "httpMethod": "POST", "uri": "arn:aws:apigateway:us-east-1:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-1:123456789111:function:hello-world/invocations", "passthroughBehavior": "WHEN_NO_MATCH", "contentHandling": "CONVERT_TO_TEXT", "timeoutInMillis": 29000, "cacheNamespace": "h7i8j9", "cacheKeyParameters": [], "integrationResponses": { "200": { "statusCode": "200", "responseTemplates": {} } } } } ``` Weitere Informationen finden Sie unter [Erstellen, Konfigurieren und Testen von Nutzungsplänen mit der API Gateway CLI und der REST-API](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-usage-plans-with-rest-api.html) und unter [Steuern und Verwalten des Zugriffs auf eine REST-API in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-control-access-to-api.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [UpdateMethod](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-method.html)in der *AWS CLI Befehlsreferenz*. ### `update-model` Das folgende Codebeispiel zeigt die Verwendung`update-model`. **AWS CLI** **So ändern Sie die Beschreibung eines Modells in einer API** Befehl: ``` aws apigateway update-model --rest-api-id 1234123412 --model-name 'Empty' --patch-operations op=replace,path=/description,value='New Description' ``` **So ändern Sie das Schema eines Modells in einer API** Befehl: ``` aws apigateway update-model --rest-api-id 1234123412 --model-name 'Empty' --patch-operations op=replace,path=/schema,value='"{ \"$schema\": \"http://json-schema.org/draft-04/schema#\", \"title\" : \"Empty Schema\", \"type\" : \"object\" }"' ``` + Einzelheiten zur API finden Sie [UpdateModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-model.html)in der *AWS CLI Befehlsreferenz*. ### `update-resource` Das folgende Codebeispiel zeigt die Verwendung`update-resource`. **AWS CLI** **So verschieben Sie eine Ressource und platzieren sie unter eine andere übergeordnete Ressource in einer API** Befehl: ``` aws apigateway update-resource --rest-api-id 1234123412 --resource-id 1a2b3c --patch-operations op=replace,path=/parentId,value='3c2b1a' ``` Ausgabe: ``` { "path": "/resource", "pathPart": "resource", "id": "1a2b3c", "parentId": "3c2b1a" } ``` **So benennen Sie eine Ressource (pathPart) in einer API um** Befehl: ``` aws apigateway update-resource --rest-api-id 1234123412 --resource-id 1a2b3c --patch-operations op=replace,path=/pathPart,value=newresourcename ``` Ausgabe: ``` { "path": "/newresourcename", "pathPart": "newresourcename", "id": "1a2b3c", "parentId": "3c2b1a" } ``` + Einzelheiten zur API finden Sie [UpdateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-rest-api` Das folgende Codebeispiel zeigt die Verwendung`update-rest-api`. **AWS CLI** **So ändern Sie den Namen einer API** Befehl: ``` aws apigateway update-rest-api --rest-api-id 1234123412 --patch-operations op=replace,path=/name,value='New Name' ``` **So ändern Sie die Beschreibung einer API** Befehl: ``` aws apigateway update-rest-api --rest-api-id 1234123412 --patch-operations op=replace,path=/description,value='New Description' ``` + Einzelheiten zur API finden Sie [UpdateRestApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-rest-api.html)in der *AWS CLI Befehlsreferenz*. ### `update-stage` Das folgende Codebeispiel zeigt die Verwendung`update-stage`. **AWS CLI** **Beispiel 1: So überschreiben Sie die Stufeneinstellungen für eine Ressource und Methode** Das folgende `update-stage` Beispiel überschreibt die Stufeneinstellungen und deaktiviert die vollständige request/response Protokollierung für eine bestimmte Ressource und Methode. ``` aws apigateway update-stage \ --rest-api-id 1234123412 \ --stage-name 'dev' \ --patch-operations op=replace,path=/~1resourceName/GET/logging/dataTrace,value=false ``` Ausgabe: ``` { "deploymentId": "5ubd17", "stageName": "dev", "cacheClusterEnabled": false, "cacheClusterStatus": "NOT_AVAILABLE", "methodSettings": { "~1resourceName/GET": { "metricsEnabled": false, "dataTraceEnabled": false, "throttlingBurstLimit": 5000, "throttlingRateLimit": 10000.0, "cachingEnabled": false, "cacheTtlInSeconds": 300, "cacheDataEncrypted": false, "requireAuthorizationForCacheControl": true, "unauthorizedCacheControlHeaderStrategy": "SUCCEED_WITH_RESPONSE_HEADER" } }, "tracingEnabled": false, "createdDate": "2022-07-18T10:11:18-07:00", "lastUpdatedDate": "2022-07-18T10:19:04-07:00" } ``` Weitere Informationen finden Sie unter [Einrichten einer Stufe für eine REST-API](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-stages.html) im *Entwicklerhandbuch für Amazon API Gateway*. **Beispiel 2: So aktualisieren Sie die Stufeneinstellungen für alle Ressourcen und Methoden einer API-Stufe** Im folgenden `update-stage` Beispiel wird die vollständige request/response Protokollierung für alle Ressourcen und Methoden einer API-Phase aktiviert. ``` aws apigateway update-stage \ --rest-api-id 1234123412 \ --stage-name 'dev' \ --patch-operations 'op=replace,path=/*/*/logging/dataTrace,value=true' ``` Ausgabe: ``` { "deploymentId": "5ubd17", "stageName": "dev", "cacheClusterEnabled": false, "cacheClusterStatus": "NOT_AVAILABLE", "methodSettings": { "*/*": { "metricsEnabled": false, "dataTraceEnabled": true, "throttlingBurstLimit": 5000, "throttlingRateLimit": 10000.0, "cachingEnabled": false, "cacheTtlInSeconds": 300, "cacheDataEncrypted": false, "requireAuthorizationForCacheControl": true, "unauthorizedCacheControlHeaderStrategy": "SUCCEED_WITH_RESPONSE_HEADER" } }, "tracingEnabled": false, "createdDate": "2022-07-18T10:11:18-07:00", "lastUpdatedDate": "2022-07-18T10:31:04-07:00" } ``` Weitere Informationen finden Sie unter [Einrichten einer Stufe für eine REST-API](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-stages.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [UpdateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-stage.html)unter *AWS CLI Befehlsreferenz*. ### `update-usage-plan` Das folgende Codebeispiel zeigt die Verwendung`update-usage-plan`. **AWS CLI** **So ändern Sie den in einem Nutzungsplan definierten Zeitraum** Befehl: ``` aws apigateway update-usage-plan --usage-plan-id a1b2c3 --patch-operations op="replace",path="/quota/period",value="MONTH" ``` **So ändern Sie das in einem Nutzungsplan definierte Kontingentlimit** Befehl: ``` aws apigateway update-usage-plan --usage-plan-id a1b2c3 --patch-operations op="replace",path="/quota/limit",value="500" ``` **So ändern Sie das in einem Nutzungsplan definierte Drosselungsratenlimit** Befehl: ``` aws apigateway update-usage-plan --usage-plan-id a1b2c3 --patch-operations op="replace",path="/throttle/rateLimit",value="10" ``` **So ändern Sie das in einem Nutzungsplan definierte Drosselungs-Burst-Limit** Befehl: ``` aws apigateway update-usage-plan --usage-plan-id a1b2c3 --patch-operations op="replace",path="/throttle/burstLimit",value="20" ``` + Einzelheiten zur API finden Sie [UpdateUsagePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-usage-plan.html)in der *AWS CLI Befehlsreferenz*. ### `update-usage` Das folgende Codebeispiel zeigt die Verwendung`update-usage`. **AWS CLI** **So ändern Sie vorübergehend das Kontingent für einen API-Schlüssel für den aktuellen, im Nutzungsplan definierten Zeitraum** Befehl: ``` aws apigateway update-usage --usage-plan-id a1b2c3 --key-id 1NbjQzMReAkeEQPNAW8r3dXsU2rDD7fc7f2Sipnu --patch-operations op="replace",path="/remaining",value="50" ``` + Einzelheiten zur API finden Sie [UpdateUsage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-usage.html)in der *AWS CLI Befehlsreferenz*. ### `update-vpc-link` Das folgende Codebeispiel zeigt die Verwendung`update-vpc-link`. **AWS CLI** **Beispiel 1: So aktualisieren Sie einen vorhandenen VPC-Linknamen** Im folgenden `update-vpc-link` Beispiel wird der Name des angegebenen VPC-Links aktualisiert. ``` aws apigateway update-vpc-link \ --vpc-link-id ab3de6 \ --patch-operations op=replace,path=/name,value=my-vpc-link ``` Ausgabe: ``` { "id": "ab3de6", "name": "my-vpc-link", "targetArns": [ "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/my-lb/12a456s89aaa12345" ], "status": "AVAILABLE", "statusMessage": "Your vpc link is ready for use", "tags": {} } ``` Weitere Informationen finden Sie unter [Aktualisieren eines vorhandenen VPC-Links](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-vpc-link.html) in der *AWS CLI-Befehlsreferenz.* **Beispiel 2: So aktualisieren Sie den Namen und die Beschreibung eines vorhandenen VPC-Links** Im folgenden `update-vpc-link` Beispiel wird der Name des angegebenen VPC-Links aktualisiert. ``` aws apigateway update-vpc-link \ --vpc-link-id ab3de6 \ --patch-operations op=replace,path=/name,value=my-vpc-link op=replace,path=/description,value="My custom description" ``` Ausgabe: ``` { "id": "ab3de6", "name": "my-vpc-link", "description": "My custom description", "targetArns": [ "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/my-lb/12a456s89aaa12345" ], "status": "AVAILABLE", "statusMessage": "Your vpc link is ready for use", "tags": {} } ``` Weitere Informationen finden Sie unter [Aktualisieren eines vorhandenen VPC-Links](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-vpc-link.html) in der *AWS CLI-Befehlsreferenz.* + Einzelheiten zur API finden Sie unter [UpdateVpcLink AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigateway/update-vpc-link.html)*Befehlsreferenz.* # API Gateway HTTP- und WebSocket API-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS Command Line Interface mit API Gateway HTTP und WebSocket API arbeiten. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-api-mapping` Das folgende Codebeispiel zeigt die Verwendung`create-api-mapping`. **AWS CLI** **So erstellen Sie eine API-Zuweisung für eine API** Im folgenden Beispiel für `create-api-mapping` wird die `test`-Stufe einer API dem `/myApi`-Pfad des benutzerdefinierten `regional.example.com`-Domainnamens zugeordnet. ``` aws apigatewayv2 create-api-mapping \ --domain-name regional.example.com \ --api-mapping-key myApi \ --api-id a1b2c3d4 \ --stage test ``` Ausgabe: ``` { "ApiId": "a1b2c3d4", "ApiMappingId": "0qzs2sy7bh", "ApiMappingKey": "myApi" "Stage": "test" } ``` Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [CreateApiMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-api-mapping.html)in der *AWS CLI Befehlsreferenz*. ### `create-api` Das folgende Codebeispiel zeigt die Verwendung`create-api`. **AWS CLI** **Um eine HTTP-API zu erstellen** Im folgenden Beispiel für `create-api` wird eine HTTP-API mithilfe von Quick Create erstellt. Sie können Quick Create verwenden, um eine API mit einer AWS Lambda- oder HTTP-Integration, einer Standard-Catch-All-Route und einer Standardphase zu erstellen, die für die automatische Bereitstellung von Änderungen konfiguriert ist. Der folgende Befehl verwendet Quick Create, um eine HTTP-API zu erstellen, die in eine Lambda-Funktion integriert ist. ``` aws apigatewayv2 create-api \ --name my-http-api \ --protocol-type HTTP \ --target arn:aws:lambda:us-west-2:123456789012:function:my-lambda-function ``` Ausgabe: ``` { "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com", "ApiId": "a1b2c3d4", "ApiKeySelectionExpression": "$request.header.x-api-key", "CreatedDate": "2020-04-08T19:05:45+00:00", "Name": "my-http-api", "ProtocolType": "HTTP", "RouteSelectionExpression": "$request.method $request.path" } ``` Weitere Informationen finden Sie unter [Entwickeln einer HTTP-API in Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop.html) im *Entwicklerhandbuch für Amazon API Gateway*. **Um eine API zu erstellen WebSocket ** Das folgende `create-api` Beispiel erstellt eine WebSocket API mit dem angegebenen Namen. ``` aws apigatewayv2 create-api \ --name "myWebSocketApi" \ --protocol-type WEBSOCKET \ --route-selection-expression '$request.body.action' ``` Ausgabe: ``` { "ApiKeySelectionExpression": "$request.header.x-api-key", "Name": "myWebSocketApi", "CreatedDate": "2018-11-15T06:23:51Z", "ProtocolType": "WEBSOCKET", "RouteSelectionExpression": "'$request.body.action'", "ApiId": "aabbccddee" } ``` Weitere Informationen finden Sie unter [Create a WebSocket API in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-create-empty-api.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [CreateApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-api.html)unter *AWS CLI Befehlsreferenz*. ### `create-authorizer` Das folgende Codebeispiel zeigt die Verwendung`create-authorizer`. **AWS CLI** **So erstellen Sie einen JWT-Genehmiger für eine HTTP-API** Mit dem folgenden Beispiel für `create-authorizer` wird ein JWT-Genehmiger erstellt, der Amazon Cognito als Identitätsanbieter verwendet. ``` aws apigatewayv2 create-authorizer \ --name my-jwt-authorizer \ --api-id a1b2c3d4 \ --authorizer-type JWT \ --identity-source '$request.header.Authorization' \ --jwt-configuration Audience=123456abc,Issuer=https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123 ``` Ausgabe: ``` { "AuthorizerId": "a1b2c3", "AuthorizerType": "JWT", "IdentitySource": [ "$request.header.Authorization" ], "JwtConfiguration": { "Audience": [ "123456abc" ], "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123" }, "Name": "my-jwt-authorizer" } ``` Weitere Informationen finden Sie unter [Steuern des Zugriffs auf HTTP APIs mit JWT-Autorisierern](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-jwt-authorizer.html) im *Amazon API Gateway* Developer Guide. + *Einzelheiten zur API finden Sie [CreateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-authorizer.html)in AWS CLI der Befehlsreferenz.* ### `create-deployment` Das folgende Codebeispiel zeigt die Verwendung`create-deployment`. **AWS CLI** **So erstellen Sie eine Bereitstellung für eine API** Im folgenden Beispiel für `create-deployment` wird eine Bereitstellung für eine API erstellt und dann der `dev`-Stufe der API zugeordnet. ``` aws apigatewayv2 create-deployment \ --api-id a1b2c3d4 \ --stage-name dev ``` Ausgabe: ``` { "AutoDeployed": false, "CreatedDate": "2020-04-06T23:38:08Z", "DeploymentId": "53lz9l", "DeploymentStatus": "DEPLOYED" } ``` Weitere Informationen finden Sie unter [API-Bereitstellung](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-basic-concept.html#apigateway-definition-api-deployment) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `create-domain-name` Das folgende Codebeispiel zeigt die Verwendung`create-domain-name`. **AWS CLI** **So erstellen Sie einen benutzerdefinierten Domainnamen** Im folgenden Beispiel für `create-domain-name` wird ein benutzerdefinierter Domainnamen für eine API erstellt. ``` aws apigatewayv2 create-domain-name \ --domain-name regional.example.com \ --domain-name-configurations CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678 ``` Ausgabe: ``` { "ApiMappingSelectionExpression": "$request.basepath", "DomainName": "regional.example.com", "DomainNameConfigurations": [ { "ApiGatewayDomainName": "d-id.execute-api.us-west-2.amazonaws.com", "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678", "EndpointType": "REGIONAL", "HostedZoneId": "123456789111", "SecurityPolicy": "TLS_1_2", "DomainNameStatus": "AVAILABLE" } ] } ``` Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [CreateDomainName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-domain-name.html)in der *AWS CLI Befehlsreferenz*. ### `create-integration` Das folgende Codebeispiel zeigt die Verwendung`create-integration`. **AWS CLI** **Um eine WebSocket API-Integration zu erstellen** Das folgende `create-integration` Beispiel erstellt eine Scheinintegration für eine WebSocket API. ``` aws apigatewayv2 create-integration \ --api-id aabbccddee \ --passthrough-behavior WHEN_NO_MATCH \ --timeout-in-millis 29000 \ --connection-type INTERNET \ --integration-type MOCK ``` Ausgabe: ``` { "ConnectionType": "INTERNET", "IntegrationId": "0abcdef", "IntegrationResponseSelectionExpression": "${integration.response.statuscode}", "IntegrationType": "MOCK", "PassthroughBehavior": "WHEN_NO_MATCH", "PayloadFormatVersion": "1.0", "TimeoutInMillis": 29000 } ``` Weitere Informationen finden Sie unter [Einrichten einer WebSocket API-Integrationsanfrage in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-integration-requests.html) im *Amazon API Gateway Developer Guide*. **So erstellen Sie eine HTTP-API-Integration** Das folgende `create-integration` Beispiel erstellt eine AWS Lambda-Integration für eine HTTP-API. ``` aws apigatewayv2 create-integration \ --api-id a1b2c3d4 \ --integration-type AWS_PROXY \ --integration-uri arn:aws:lambda:us-west-2:123456789012:function:my-function \ --payload-format-version 2.0 ``` Ausgabe: ``` { "ConnectionType": "INTERNET", "IntegrationId": "0abcdef", "IntegrationMethod": "POST", "IntegrationType": "AWS_PROXY", "IntegrationUri": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "PayloadFormatVersion": "2.0", "TimeoutInMillis": 30000 } ``` Weitere Informationen finden Sie unter [Konfiguration von Integrationen für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateIntegration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-integration.html)*Befehlsreferenz.* ### `create-route` Das folgende Codebeispiel zeigt die Verwendung`create-route`. **AWS CLI** **Um eine \$1default Route für eine WebSocket oder HTTP-API zu erstellen** Das folgende `create-route` Beispiel erstellt eine `$default` Route für eine WebSocket oder HTTP-API. ``` aws apigatewayv2 create-route \ --api-id aabbccddee \ --route-key '$default' ``` Ausgabe: ``` { "ApiKeyRequired": false, "AuthorizationType": "NONE", "RouteKey": "$default", "RouteId": "1122334" } ``` Weitere Informationen finden Sie unter [Arbeiten mit Routen für WebSocket APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-add-route.html) im *Amazon API Gateway Developer Guide* **So erstellen Sie eine Route für eine HTTP-API** Im folgenden Beispiel für `create-route` wird eine Route mit dem Namen `signup` erstellt, die POST-Anforderungen akzeptiert. ``` aws apigatewayv2 create-route \ --api-id aabbccddee \ --route-key 'POST /signup' ``` Ausgabe: ``` { "ApiKeyRequired": false, "AuthorizationType": "NONE", "RouteKey": "POST /signup", "RouteId": "1122334" } ``` Weitere Informationen finden Sie unter [Working with routes for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-routes.html) im *Amazon API Gateway Developer Guide* + Einzelheiten zur API finden Sie [CreateRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-route.html)unter *AWS CLI Befehlsreferenz*. ### `create-routing-rule` Das folgende Codebeispiel zeigt die Verwendung`create-routing-rule`. **AWS CLI** **So erstellen Sie eine Routing-Regel** Im folgenden Beispiel für `create-routing-rule` wird eine Routing-Regel mit einer Priorität von `50` erstellt. ``` aws apigatewayv2 create-routing-rule \ --domain-name 'regional.example.com' \ --priority 50 \ --conditions '[ \ { \ "MatchBasePaths": { \ "AnyOf": [ \ "PetStoreShopper" \ ] \ } \ } \ ]' \ --actions '[ \ { \ "InvokeApi": { \ "ApiId": "abcd1234", \ "Stage": "prod" \ } \ } \ ]' ``` Ausgabe: ``` { "Actions": [ { "InvokeApi": { "ApiId": "abcd1234", "Stage": "prod", "StripBasePath": false } } ], "Conditions": [ { "MatchBasePaths": { "AnyOf": [ "PetStoreShopper" ] } } ], "Priority": 50, "RoutingRuleArn": "arn:aws:apigateway:us-east-2:123456789012:/domainnames/regional.example.com/routingrules/aaa111", "RoutingRuleId": "aaa111" } ``` Weitere Informationen finden Sie unter [Routing-Regeln zur Verbindung von API-Stufen mit einem benutzerdefinierten Domainnamen für REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-routing-rules.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [CreateRoutingRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-routing-rule.html)in der *AWS CLI Befehlsreferenz*. ### `create-stage` Das folgende Codebeispiel zeigt die Verwendung`create-stage`. **AWS CLI** **So erstellen Sie eine Stufe** Im folgenden Beispiel für `create-stage` wird eine Stufe mit dem Namen dev für eine API erstellt. ``` aws apigatewayv2 create-stage \ --api-id a1b2c3d4 \ --stage-name dev ``` Ausgabe: ``` { "CreatedDate": "2020-04-06T23:23:46Z", "DefaultRouteSettings": { "DetailedMetricsEnabled": false }, "LastUpdatedDate": "2020-04-06T23:23:46Z", "RouteSettings": {}, "StageName": "dev", "StageVariables": {}, "Tags": {} } ``` Weitere Informationen finden Sie unter [Working with Stages for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-stages.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [CreateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-stage.html)unter *AWS CLI Befehlsreferenz*. ### `create-vpc-link` Das folgende Codebeispiel zeigt die Verwendung`create-vpc-link`. **AWS CLI** **So erstellen Sie einen VPC-Link für eine HTTP-API** Im folgenden `create-vpc-link` Beispiel wird ein VPC-Link für HTTP APIs erstellt. ``` aws apigatewayv2 create-vpc-link \ --name MyVpcLink \ --subnet-ids subnet-aaaa subnet-bbbb \ --security-group-ids sg1234 sg5678 ``` Ausgabe: ``` { "CreatedDate": "2020-04-07T00:11:46Z", "Name": "MyVpcLink", "SecurityGroupIds": [ "sg1234", "sg5678" ], "SubnetIds": [ "subnet-aaaa", "subnet-bbbb" ], "Tags": {}, "VpcLinkId": "abcd123", "VpcLinkStatus": "PENDING", "VpcLinkStatusMessage": "VPC link is provisioning ENIs", "VpcLinkVersion": "V2" } ``` Weitere Informationen finden Sie unter [Arbeiten mit VPC-Links für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vpc-links.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateVpcLink AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/create-vpc-link.html)*Befehlsreferenz.* ### `delete-access-log-settings` Das folgende Codebeispiel zeigt die Verwendung`delete-access-log-settings`. **AWS CLI** **So deaktivieren Sie Zugriffsprotokollierung für eine API** Im folgenden Beispiel für `delete-access-log-settings` werden die Zugriffsprotokolleinstellungen für die `$default`-Stufe einer API gelöscht. Um die Zugriffsprotokollierung für eine Stufe zu deaktivieren, löschen Sie deren Zugriffsprotokolleinstellungen. ``` aws apigatewayv2 delete-access-log-settings \ --api-id a1b2c3d4 \ --stage-name '$default' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurieren der Protokollierung für eine HTTP-API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-logging.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [DeleteAccessLogSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-access-log-settings.html)in der *AWS CLI Befehlsreferenz*. ### `delete-api-mapping` Das folgende Codebeispiel zeigt die Verwendung`delete-api-mapping`. **AWS CLI** **So löschen Sie eine API-Zuordnung** Im folgenden Beispiel für `delete-api-mapping` wird eine API-Zuordnung für den benutzerdefinierten `api.example.com`-Domainnamen gelöscht. ``` aws apigatewayv2 delete-api-mapping \ --api-mapping-id a1b2c3 \ --domain-name api.example.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [DeleteApiMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-api-mapping.html)in der *AWS CLI Befehlsreferenz*. ### `delete-api` Das folgende Codebeispiel zeigt die Verwendung`delete-api`. **AWS CLI** **So löschen Sie eine API** Im folgenden Beispiel für `delete-api` wird eine API gelöscht. ``` aws apigatewayv2 delete-api \ --api-id a1b2c3d4 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html) und [Arbeiten mit WebSocket APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [DeleteApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-api.html)unter *AWS CLI Befehlsreferenz*. ### `delete-authorizer` Das folgende Codebeispiel zeigt die Verwendung`delete-authorizer`. **AWS CLI** **So löschen Sie einen Genehmiger** Im folgenden Beispiel für `delete-authorizer` wird ein Genehmiger gelöscht. ``` aws apigatewayv2 delete-authorizer \ --api-id a1b2c3d4 \ --authorizer-id a1b2c3 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Steuern des Zugriffs auf HTTP APIs mit JWT-Autorisierern](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-jwt-authorizer.html) im *Amazon API Gateway* Developer Guide. + *Einzelheiten zur API finden Sie [DeleteAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-authorizer.html)in AWS CLI der Befehlsreferenz.* ### `delete-cors-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-cors-configuration`. **AWS CLI** **So löschen Sie die CORS-Konfiguration für eine HTTP-API** Im folgenden Beispiel für `delete-cors-configuration` wird CORS für eine HTTP-API deaktiviert, indem die zugehörige CORS-Konfiguration gelöscht wird. ``` aws apigatewayv2 delete-cors-configuration \ --api-id a1b2c3d4 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurieren von CORS für eine HTTP-API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-cors.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [DeleteCorsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-cors-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-deployment` Das folgende Codebeispiel zeigt die Verwendung`delete-deployment`. **AWS CLI** **So löschen Sie eine Bereitstellung** Im folgenden Beispiel für `delete-deployment` wird die Bereitstellung einer API gelöscht. ``` aws apigatewayv2 delete-deployment \ --api-id a1b2c3d4 \ --deployment-id a1b2c3 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [API-Bereitstellung](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-basic-concept.html#apigateway-definition-api-deployment) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [DeleteDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `delete-domain-name` Das folgende Codebeispiel zeigt die Verwendung`delete-domain-name`. **AWS CLI** **So löschen Sie einen benutzerdefinierten Domainnamen** Im folgenden Beispiel für `delete-domain-name` wird ein benutzerdefinierter Domainname gelöscht. ``` aws apigatewayv2 delete-domain-name \ --domain-name api.example.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [DeleteDomainName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-domain-name.html)in der *AWS CLI Befehlsreferenz*. ### `delete-integration` Das folgende Codebeispiel zeigt die Verwendung`delete-integration`. **AWS CLI** **So löschen Sie eine Integration** Im folgenden Beispiel für `delete-integration` wird eine API-Integration gelöscht. ``` aws apigatewayv2 delete-integration \ --api-id a1b2c3d4 \ --integration-id a1b2c3 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfiguration von Integrationen für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations.html) und [Einrichten von WebSocket API-Integrationen](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-integrations.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [DeleteIntegration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-integration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-route-settings` Das folgende Codebeispiel zeigt die Verwendung`delete-route-settings`. **AWS CLI** **So löschen Sie Routeneinstellungen** Im folgenden Beispiel für `delete-route-settings` werden die Routeneinstellungen für die angegebene Route gelöscht. ``` aws apigatewayv2 delete-route-settings \ --api-id a1b2c3d4 \ --stage-name dev \ --route-key 'GET /pets' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Working with routes for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-routes.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [DeleteRouteSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-route-settings.html)unter *AWS CLI Befehlsreferenz*. ### `delete-route` Das folgende Codebeispiel zeigt die Verwendung`delete-route`. **AWS CLI** **So löschen Sie eine Route** Im folgenden Beispiel für `delete-route` wird eine API-Route gelöscht. ``` aws apigatewayv2 delete-route \ --api-id a1b2c3d4 \ --route-id a1b2c3 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Working with routes for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-routes.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [DeleteRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-route.html)unter *AWS CLI Befehlsreferenz*. ### `delete-routing-rule` Das folgende Codebeispiel zeigt die Verwendung`delete-routing-rule`. **AWS CLI** **So löschen Sie eine Routing-Regel** Im folgenden Beispiel für `delete-routing-rule` wird eine Routing-Regel für einen benutzerdefinierten Domainnamen gelöscht. ``` aws apigatewayv2 delete-routing-rule \ --domain-name 'regional.example.com' \ --routing-rule-id aaa111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Routing-Regeln zur Verbindung von API-Stufen mit einem benutzerdefinierten Domainnamen für REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-routing-rules.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [DeleteRoutingRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-routing-rule.html)in der *AWS CLI Befehlsreferenz*. ### `delete-stage` Das folgende Codebeispiel zeigt die Verwendung`delete-stage`. **AWS CLI** **So löschen Sie eine Stufe** Im folgenden Beispiel für `delete-stage` wird die `test`-Stufe einer API gelöscht. ``` aws apigatewayv2 delete-stage \ --api-id a1b2c3d4 \ --stage-name test ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Working with Stages for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-stages.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [DeleteStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-stage.html)unter *AWS CLI Befehlsreferenz*. ### `delete-vpc-link` Das folgende Codebeispiel zeigt die Verwendung`delete-vpc-link`. **AWS CLI** **So löschen Sie einen VPC-Link für eine HTTP-API** Im folgenden Beispiel für `delete-vpc-link` wird ein VPC-Link gelöscht. ``` aws apigatewayv2 delete-vpc-link \ --vpc-link-id abcd123 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit VPC-Links für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vpc-links.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie unter [DeleteVpcLink AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/delete-vpc-link.html)*Befehlsreferenz.* ### `export-api` Das folgende Codebeispiel zeigt die Verwendung`export-api`. **AWS CLI** **So exportieren Sie eine OpenAPI-Definition einer HTTP-API** Im folgenden Beispiel für `export-api` wird eine OpenAPI 3.0-Definition einer API-Stufe namens `prod` in eine YAML-Datei namens `stage-definition.yaml` exportiert. Die exportierte Definitionsdatei enthält standardmäßig API-Gateway-Erweiterungen. ``` aws apigatewayv2 export-api \ --api-id a1b2c3d4 \ --output-type YAML \ --specification OAS30 \ --stage-name prod \ stage-definition.yaml ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Exportieren einer HTTP-API aus API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-export.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [ExportApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/export-api.html)in der *AWS CLI Befehlsreferenz*. ### `get-api-mapping` Das folgende Codebeispiel zeigt die Verwendung`get-api-mapping`. **AWS CLI** **So rufen Sie Informationen über eine API-Zuordnung für einen benutzerdefinierten Domainnamen ab** Im folgenden `get-api-mapping` Beispiel werden Informationen zu einer API-Zuordnung für den `api.example.com` benutzerdefinierten Domainnamen angezeigt. ``` aws apigatewayv2 get-api-mapping \ --api-mapping-id a1b2c3 \ --domain-name api.example.com ``` Ausgabe: ``` { "ApiId": "a1b2c3d4", "ApiMappingId": "a1b2c3d5", "ApiMappingKey": "myTestApi" "Stage": "test" } ``` Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [GetApiMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-api-mapping.html)unter *AWS CLI Befehlsreferenz*. ### `get-api-mappings` Das folgende Codebeispiel zeigt die Verwendung`get-api-mappings`. **AWS CLI** **So rufen Sie die API-Zuordnungen für einen benutzerdefinierten Domainnamen ab** Im folgenden Beispiel für `get-api-mappings` wird eine Liste aller API-Zuordnungen für den benutzerdefinierten `api.example.com`-Domainnamen angezeigt. ``` aws apigatewayv2 get-api-mappings \ --domain-name api.example.com ``` Ausgabe: ``` { "Items": [ { "ApiId": "a1b2c3d4", "ApiMappingId": "a1b2c3d5", "ApiMappingKey": "myTestApi" "Stage": "test" }, { "ApiId": "a5b6c7d8", "ApiMappingId": "a1b2c3d6", "ApiMappingKey": "myDevApi" "Stage": "dev" }, ] } ``` Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [GetApiMappings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-api-mappings.html)in der *AWS CLI Befehlsreferenz*. ### `get-api` Das folgende Codebeispiel zeigt die Verwendung`get-api`. **AWS CLI** **So rufen Sie Informationen über eine API ab** Im folgenden Beispiel für `get-api` werden Informationen über eine API angezeigt. ``` aws apigatewayv2 get-api \ --api-id a1b2c3d4 ``` Ausgabe: ``` { "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com", "ApiId": "a1b2c3d4", "ApiKeySelectionExpression": "$request.header.x-api-key", "CreatedDate": "2020-03-28T00:32:37Z", "Name": "my-api", "ProtocolType": "HTTP", "RouteSelectionExpression": "$request.method $request.path", "Tags": { "department": "finance" } } ``` + Einzelheiten zur API finden Sie [GetApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-api.html)in der *AWS CLI Befehlsreferenz*. ### `get-apis` Das folgende Codebeispiel zeigt die Verwendung`get-apis`. **AWS CLI** **Um eine Liste von abzurufen APIs** Das folgende `get-apis` Beispiel listet alle APIs für den aktuellen Benutzer auf. ``` aws apigatewayv2 get-apis ``` Ausgabe: ``` { "Items": [ { "ApiEndpoint": "wss://a1b2c3d4.execute-api.us-west-2.amazonaws.com", "ApiId": "a1b2c3d4", "ApiKeySelectionExpression": "$request.header.x-api-key", "CreatedDate": "2020-04-07T20:21:59Z", "Name": "my-websocket-api", "ProtocolType": "WEBSOCKET", "RouteSelectionExpression": "$request.body.message", "Tags": {} }, { "ApiEndpoint": "https://a1b2c3d5.execute-api.us-west-2.amazonaws.com", "ApiId": "a1b2c3d5", "ApiKeySelectionExpression": "$request.header.x-api-key", "CreatedDate": "2020-04-07T20:23:50Z", "Name": "my-http-api", "ProtocolType": "HTTP", "RouteSelectionExpression": "$request.method $request.path", "Tags": {} } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html) und [Arbeiten mit WebSocket APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [GetApis](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-apis.html)unter *AWS CLI Befehlsreferenz*. ### `get-authorizer` Das folgende Codebeispiel zeigt die Verwendung`get-authorizer`. **AWS CLI** **So rufen Sie Informationen über einen Genehmiger ab** Im folgenden Beispiel für `get-authorizer` werden Informationen über einen Genehmiger angezeigt. ``` aws apigatewayv2 get-authorizer \ --api-id a1b2c3d4 \ --authorizer-id a1b2c3 ``` Ausgabe: ``` { "AuthorizerId": "a1b2c3", "AuthorizerType": "JWT", "IdentitySource": [ "$request.header.Authorization" ], "JwtConfiguration": { "Audience": [ "123456abc" ], "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123" }, "Name": "my-jwt-authorizer" } ``` Weitere Informationen finden Sie unter [Steuern des Zugriffs auf HTTP APIs mit JWT-Autorisierern](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-jwt-authorizer.html) im *Amazon API Gateway* Developer Guide. + *Einzelheiten zur API finden Sie [GetAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-authorizer.html)in AWS CLI der Befehlsreferenz.* ### `get-authorizers` Das folgende Codebeispiel zeigt die Verwendung`get-authorizers`. **AWS CLI** **So rufen Sie eine Liste von Genehmigern für eine API ab** Im folgenden Beispiel für `get-authorizers` wird eine Liste aller Genehmiger für eine API angezeigt. ``` aws apigatewayv2 get-authorizers \ --api-id a1b2c3d4 ``` Ausgabe: ``` { "Items": [ { "AuthorizerId": "a1b2c3", "AuthorizerType": "JWT", "IdentitySource": [ "$request.header.Authorization" ], "JwtConfiguration": { "Audience": [ "123456abc" ], "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123" }, "Name": "my-jwt-authorizer" }, { "AuthorizerId": "a1b2c4", "AuthorizerType": "JWT", "IdentitySource": [ "$request.header.Authorization" ], "JwtConfiguration": { "Audience": [ "6789abcde" ], "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc234" }, "Name": "new-jwt-authorizer" } ] } ``` Weitere Informationen finden Sie unter [Steuern des Zugriffs auf HTTP APIs mit JWT-Autorisierern](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-jwt-authorizer.html) im *Amazon API Gateway* Developer Guide. + *Einzelheiten zur API finden Sie [GetAuthorizers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-authorizers.html)in AWS CLI der Befehlsreferenz.* ### `get-deployment` Das folgende Codebeispiel zeigt die Verwendung`get-deployment`. **AWS CLI** **So rufen Sie Informationen über eine Bereitstellung ab** Im folgenden Beispiel für `get-deployment` werden Informationen über eine Bereitstellung angezeigt. ``` aws apigatewayv2 get-deployment \ --api-id a1b2c3d4 \ --deployment-id abcdef ``` Ausgabe: ``` { "AutoDeployed": true, "CreatedDate": "2020-04-07T23:58:40Z", "DeploymentId": "abcdef", "DeploymentStatus": "DEPLOYED", "Description": "Automatic deployment triggered by changes to the Api configuration" } ``` Weitere Informationen finden Sie unter [API-Bereitstellung](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-basic-concept.html#apigateway-definition-api-deployment) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `get-deployments` Das folgende Codebeispiel zeigt die Verwendung`get-deployments`. **AWS CLI** **So rufen Sie eine Liste der Bereitstellungen ab** Im folgenden Beispiel für `get-deployments` wird eine Liste aller Bereitstellungen einer API angezeigt. ``` aws apigatewayv2 get-deployments \ --api-id a1b2c3d4 ``` Ausgabe: ``` { "Items": [ { "AutoDeployed": true, "CreatedDate": "2020-04-07T23:58:40Z", "DeploymentId": "abcdef", "DeploymentStatus": "DEPLOYED", "Description": "Automatic deployment triggered by changes to the Api configuration" }, { "AutoDeployed": true, "CreatedDate": "2020-04-06T00:33:00Z", "DeploymentId": "bcdefg", "DeploymentStatus": "DEPLOYED", "Description": "Automatic deployment triggered by changes to the Api configuration" } ] } ``` Weitere Informationen finden Sie unter [API-Bereitstellung](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-basic-concept.html#apigateway-definition-api-deployment) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [GetDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-deployments.html)in der *AWS CLI Befehlsreferenz*. ### `get-domain-name` Das folgende Codebeispiel zeigt die Verwendung`get-domain-name`. **AWS CLI** **So rufen Sie Informationen über einen benutzerdefinierten Domainnamen ab** Im folgenden Beispiel für `get-domain-name` werden Informationen über einen benutzerdefinierten Domainnamen angezeigt. ``` aws apigatewayv2 get-domain-name \ --domain-name api.example.com ``` Ausgabe: ``` { "ApiMappingSelectionExpression": "$request.basepath", "DomainName": "api.example.com", "DomainNameConfigurations": [ { "ApiGatewayDomainName": "d-1234.execute-api.us-west-2.amazonaws.com", "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678", "EndpointType": "REGIONAL", "HostedZoneId": "123456789111", "SecurityPolicy": "TLS_1_2", "DomainNameStatus": "AVAILABLE" } ], "Tags": {} } ``` Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [GetDomainName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-domain-name.html)in der *AWS CLI Befehlsreferenz*. ### `get-domain-names` Das folgende Codebeispiel zeigt die Verwendung`get-domain-names`. **AWS CLI** **So rufen Sie eine Liste der benutzerdefinierten Domainnamen ab** Im folgenden Beispiel für `get-domain-names` wird eine Liste aller benutzerdefinierten Domainnamen für den aktuellen Benutzer angezeigt. ``` aws apigatewayv2 get-domain-names ``` Ausgabe: ``` { "Items": [ { "ApiMappingSelectionExpression": "$request.basepath", "DomainName": "api.example.com", "DomainNameConfigurations": [ { "ApiGatewayDomainName": "d-1234.execute-api.us-west-2.amazonaws.com", "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678", "EndpointType": "REGIONAL", "HostedZoneId": "123456789111", "SecurityPolicy": "TLS_1_2", "DomainNameStatus": "AVAILABLE" } ] }, { "ApiMappingSelectionExpression": "$request.basepath", "DomainName": "newApi.example.com", "DomainNameConfigurations": [ { "ApiGatewayDomainName": "d-5678.execute-api.us-west-2.amazonaws.com", "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678", "EndpointType": "REGIONAL", "HostedZoneId": "123456789222", "SecurityPolicy": "TLS_1_2", "DomainNameStatus": "AVAILABLE" } ] } ] } ``` Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [GetDomainNames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-domain-names.html)in der *AWS CLI Befehlsreferenz*. ### `get-integration` Das folgende Codebeispiel zeigt die Verwendung`get-integration`. **AWS CLI** **So rufen Sie Informationen über eine Integration ab** Im folgenden Beispiel für `get-integration` werden Informationen über eine Integration angezeigt. ``` aws apigatewayv2 get-integration \ --api-id a1b2c3d4 \ --integration-id a1b2c3 ``` Ausgabe: ``` { "ApiGatewayManaged": true, "ConnectionType": "INTERNET", "IntegrationId": "a1b2c3", "IntegrationMethod": "POST", "IntegrationType": "AWS_PROXY", "IntegrationUri": "arn:aws:lambda:us-west-2:12356789012:function:hello12", "PayloadFormatVersion": "2.0", "TimeoutInMillis": 30000 } ``` Weitere Informationen finden Sie unter [Konfiguration von Integrationen für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations.html) und [Einrichten von WebSocket API-Integrationen](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-integrations.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [GetIntegration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-integration.html)in der *AWS CLI Befehlsreferenz*. ### `get-integrations` Das folgende Codebeispiel zeigt die Verwendung`get-integrations`. **AWS CLI** **So rufen Sie eine Liste der Integrationen ab** Im folgenden Beispiel für `get-integrations` wird eine Liste aller Integrationen einer API angezeigt. ``` aws apigatewayv2 get-integrations \ --api-id a1b2c3d4 ``` Ausgabe: ``` { "Items": [ { "ApiGatewayManaged": true, "ConnectionType": "INTERNET", "IntegrationId": "a1b2c3", "IntegrationMethod": "POST", "IntegrationType": "AWS_PROXY", "IntegrationUri": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "PayloadFormatVersion": "2.0", "TimeoutInMillis": 30000 }, { "ConnectionType": "INTERNET", "IntegrationId": "a1b2c4", "IntegrationMethod": "ANY", "IntegrationType": "HTTP_PROXY", "IntegrationUri": "https://www.example.com", "PayloadFormatVersion": "1.0", "TimeoutInMillis": 30000 } ] } ``` Weitere Informationen finden Sie unter [Konfiguration von Integrationen für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations.html) und [Einrichten von WebSocket API-Integrationen](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-integrations.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [GetIntegrations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-integrations.html)in der *AWS CLI Befehlsreferenz*. ### `get-route` Das folgende Codebeispiel zeigt die Verwendung`get-route`. **AWS CLI** **So rufen Sie Informationen über eine Route ab** Im folgenden Beispiel für `get-route` werden Informationen über eine Route angezeigt. ``` aws apigatewayv2 get-route \ --api-id a1b2c3d4 \ --route-id 72jz1wk ``` Ausgabe: ``` { "ApiKeyRequired": false, "AuthorizationType": "NONE", "RouteId": "72jz1wk", "RouteKey": "ANY /pets", "Target": "integrations/a1b2c3" } ``` Weitere Informationen finden Sie unter [Working with routes for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-routes.html) im *Amazon API Gateway Developer Guide* + Einzelheiten zur API finden Sie [GetRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-route.html)unter *AWS CLI Befehlsreferenz*. ### `get-routes` Das folgende Codebeispiel zeigt die Verwendung`get-routes`. **AWS CLI** **So rufen Sie eine Liste der Routen ab** Im folgenden Beispiel für `get-routes` wird eine Liste aller Routen einer API angezeigt. ``` aws apigatewayv2 get-routes \ --api-id a1b2c3d4 ``` Ausgabe: ``` { "Items": [ { "ApiKeyRequired": false, "AuthorizationType": "NONE", "RouteId": "72jz1wk", "RouteKey": "ANY /admin", "Target": "integrations/a1b2c3" }, { "ApiGatewayManaged": true, "ApiKeyRequired": false, "AuthorizationType": "NONE", "RouteId": "go65gqi", "RouteKey": "$default", "Target": "integrations/a1b2c4" } ] } ``` Weitere Informationen finden Sie unter [Working with routes for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-routes.html) im *Amazon API Gateway Developer Guide* + Einzelheiten zur API finden Sie [GetRoutes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-routes.html)unter *AWS CLI Befehlsreferenz*. ### `get-routing-rule` Das folgende Codebeispiel zeigt die Verwendung`get-routing-rule`. **AWS CLI** **So rufen Sie eine Routing-Regel ab** Im folgenden Beispiel für `get-routing-rule` wird eine Routing-Regel für einen Domainnamen abgerufen. ``` aws apigatewayv2 get-routing-rule \ --domain-name 'regional.example.com' \ --routing-rule-id aaa111 ``` Ausgabe: ``` { "Actions": [ { "InvokeApi": { "ApiId": "abcd1234", "Stage": "prod", "StripBasePath": false } } ], "Conditions": [ { "MatchBasePaths": { "AnyOf": [ "PetStoreShopper" ] } } ], "Priority": 50, "RoutingRuleArn": "arn:aws:apigateway:us-east-2:123456789012:/domainnames/regional.example.com/routingrules/aaa111", "RoutingRuleId": "aaa111" } ``` Weitere Informationen finden Sie unter [Routing-Regeln zur Verbindung von API-Stufen mit einem benutzerdefinierten Domainnamen für REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-routing-rules.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [GetRoutingRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-routing-rule.html)in der *AWS CLI Befehlsreferenz*. ### `get-stage` Das folgende Codebeispiel zeigt die Verwendung`get-stage`. **AWS CLI** **So rufen Sie Informationen zu einer Stufe ab** Im folgenden Beispiel für `get-stage` werden Informationen über die `prod`-Stufe einer API angezeigt. ``` aws apigatewayv2 get-stage \ --api-id a1b2c3d4 \ --stage-name prod ``` Ausgabe: ``` { "CreatedDate": "2020-04-08T00:36:05Z", "DefaultRouteSettings": { "DetailedMetricsEnabled": false }, "DeploymentId": "x1zwyv", "LastUpdatedDate": "2020-04-08T00:36:13Z", "RouteSettings": {}, "StageName": "prod", "StageVariables": { "function": "my-prod-function" }, "Tags": {} } ``` Weitere Informationen finden Sie unter [Working with Stages for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-stages.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [GetStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-stage.html)unter *AWS CLI Befehlsreferenz*. ### `get-stages` Das folgende Codebeispiel zeigt die Verwendung`get-stages`. **AWS CLI** **So rufen Sie eine Liste von Stufen ab** Im folgenden Beispiel für `get-stages` werden alle Stufen einer API aufgelistet. ``` aws apigatewayv2 get-stages \ --api-id a1b2c3d4 ``` Ausgabe: ``` { "Items": [ { "ApiGatewayManaged": true, "AutoDeploy": true, "CreatedDate": "2020-04-08T00:08:44Z", "DefaultRouteSettings": { "DetailedMetricsEnabled": false }, "DeploymentId": "dty748", "LastDeploymentStatusMessage": "Successfully deployed stage with deployment ID 'dty748'", "LastUpdatedDate": "2020-04-08T00:09:49Z", "RouteSettings": {}, "StageName": "$default", "StageVariables": {}, "Tags": {} }, { "AutoDeploy": true, "CreatedDate": "2020-04-08T00:35:06Z", "DefaultRouteSettings": { "DetailedMetricsEnabled": false }, "LastUpdatedDate": "2020-04-08T00:35:48Z", "RouteSettings": {}, "StageName": "dev", "StageVariables": { "function": "my-dev-function" }, "Tags": {} }, { "CreatedDate": "2020-04-08T00:36:05Z", "DefaultRouteSettings": { "DetailedMetricsEnabled": false }, "DeploymentId": "x1zwyv", "LastUpdatedDate": "2020-04-08T00:36:13Z", "RouteSettings": {}, "StageName": "prod", "StageVariables": { "function": "my-prod-function" }, "Tags": {} } ] } ``` Weitere Informationen finden Sie unter [Working with Stages for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-stages.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [GetStages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-stages.html)unter *AWS CLI Befehlsreferenz*. ### `get-tags` Das folgende Codebeispiel zeigt die Verwendung`get-tags`. **AWS CLI** **So rufen Sie eine Liste der Tags für eine Ressource ab** Im folgenden Beispiel für `get-tags` werden alle Tags einer API aufgelistet. ``` aws apigatewayv2 get-tags \ --resource-arn arn:aws:apigateway:us-west-2::/apis/a1b2c3d4 ``` Ausgabe: ``` { "Tags": { "owner": "dev-team", "environment": "prod" } } ``` Weitere Informationen finden Sie unter [Taggen Ihrer API-Gateway-Ressourcen](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-tagging.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [GetTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-tags.html)in der *AWS CLI Befehlsreferenz*. ### `get-vpc-link` Das folgende Codebeispiel zeigt die Verwendung`get-vpc-link`. **AWS CLI** **So rufen Sie Informationen über einen VPC-Link ab** Im folgenden Beispiel für `get-vpc-link` werden Informationen über einen VPC-Link angezeigt. ``` aws apigatewayv2 get-vpc-link \ --vpc-link-id abcd123 ``` Ausgabe: ``` { "CreatedDate": "2020-04-07T00:27:47Z", "Name": "MyVpcLink", "SecurityGroupIds": [ "sg1234", "sg5678" ], "SubnetIds": [ "subnet-aaaa", "subnet-bbbb" ], "Tags": {}, "VpcLinkId": "abcd123", "VpcLinkStatus": "AVAILABLE", "VpcLinkStatusMessage": "VPC link is ready to route traffic", "VpcLinkVersion": "V2" } ``` Weitere Informationen finden Sie unter [Arbeiten mit VPC-Links für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vpc-links.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie unter [GetVpcLink AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-vpc-link.html)*Befehlsreferenz.* ### `get-vpc-links` Das folgende Codebeispiel zeigt die Verwendung`get-vpc-links`. **AWS CLI** **So rufen Sie eine Liste der VPC-Links ab** Im folgenden Beispiel für `get-vpc-links` wird eine Liste aller VPC-Links für den aktuellen Benutzer angezeigt. ``` aws apigatewayv2 get-vpc-links ``` Ausgabe: ``` { "Items": [ { "CreatedDate": "2020-04-07T00:27:47Z", "Name": "MyVpcLink", "SecurityGroupIds": [ "sg1234", "sg5678" ], "SubnetIds": [ "subnet-aaaa", "subnet-bbbb" ], "Tags": {}, "VpcLinkId": "abcd123", "VpcLinkStatus": "AVAILABLE", "VpcLinkStatusMessage": "VPC link is ready to route traffic", "VpcLinkVersion": "V2" } { "CreatedDate": "2020-04-07T00:27:47Z", "Name": "MyOtherVpcLink", "SecurityGroupIds": [ "sg1234", "sg5678" ], "SubnetIds": [ "subnet-aaaa", "subnet-bbbb" ], "Tags": {}, "VpcLinkId": "abcd456", "VpcLinkStatus": "AVAILABLE", "VpcLinkStatusMessage": "VPC link is ready to route traffic", "VpcLinkVersion": "V2" } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit VPC-Links für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vpc-links.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie unter [GetVpcLinks AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/get-vpc-links.html)*Befehlsreferenz.* ### `import-api` Das folgende Codebeispiel zeigt die Verwendung`import-api`. **AWS CLI** **So importieren Sie eine HTTP-API** Im folgenden Beispiel für `import-api` wird eine HTTP-API aus einer OpenAPI 3.0-Definitionsdatei namens `api-definition.yaml` erstellt. ``` aws apigatewayv2 import-api \ --body file://api-definition.yaml ``` Inhalt von `api-definition.yaml`: ``` openapi: 3.0.1 info: title: My Lambda API version: v1.0 paths: /hello: x-amazon-apigateway-any-method: x-amazon-apigateway-integration: payloadFormatVersion: 2.0 type: aws_proxy httpMethod: POST uri: arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:hello/invocations connectionType: INTERNET ``` Ausgabe: ``` { "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com", "ApiId": "a1b2c3d4", "ApiKeySelectionExpression": "$request.header.x-api-key", "CreatedDate": "2020-04-08T17:19:38+00:00", "Name": "My Lambda API", "ProtocolType": "HTTP", "RouteSelectionExpression": "$request.method $request.path", "Tags": {}, "Version": "v1.0" } ``` Weitere Informationen finden Sie unter [Arbeiten mit OpenAPI-Definitionen für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-open-api.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie unter [ImportApi AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/import-api.html)*Befehlsreferenz.* ### `list-routing-rules` Das folgende Codebeispiel zeigt die Verwendung`list-routing-rules`. **AWS CLI** **So listen Sie Routing-Regeln auf** Im folgenden Beispiel für `list-routing-rules` werden die Routing-Regel für einen Domainnamen aufgelistet. ``` aws apigatewayv2 list-routing-rules \ --domain-name 'regional.example.com' ``` Ausgabe: ``` { "RoutingRules": [ { "Actions": [ { "InvokeApi": { "ApiId": "abcd1234", "Stage": "prod", "StripBasePath": false } } ], "Conditions": [ { "MatchBasePaths": { "AnyOf": [ "PetStoreShopper" ] } } ], "Priority": 150, "RoutingRuleArn": "arn:aws:apigateway:us-east-1:123456789012:/domainnames/regional.example.com/routingrules/aaa111", "RoutingRuleId": "aaa111" } ] } ``` Weitere Informationen finden Sie unter [Routing-Regeln zur Verbindung von API-Stufen mit einem benutzerdefinierten Domainnamen für REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-routing-rules.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [ListRoutingRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/list-routing-rules.html)in der *AWS CLI Befehlsreferenz*. ### `put-routing-rule` Das folgende Codebeispiel zeigt die Verwendung`put-routing-rule`. **AWS CLI** **So aktualisieren Sie eine Routing-Regel** Im folgenden Beispiel für `put-routing-rule` wird die Priorität einer Routing-Regel aktualisiert. ``` aws apigatewayv2 put-routing-rule \ --domain-name 'regional.example.com' \ --priority 150 \ --conditions '[ \ { \ "MatchBasePaths": { \ "AnyOf": [ \ "PetStoreShopper" \ ] \ } \ } \ ]' \ --actions '[ \ { \ "InvokeApi": { \ "ApiId": "abcd1234", \ "Stage": "prod" \ } \ } \ ]' ``` Ausgabe: ``` { "Actions": [ { "InvokeApi": { "ApiId": "abcd1234", "Stage": "prod", "StripBasePath": false } } ], "Conditions": [ { "MatchBasePaths": { "AnyOf": [ "PetStoreShopper" ] } } ], "Priority": 150, "RoutingRuleArn": "arn:aws:apigateway:us-east-2:123456789012:/domainnames/regional.example.com/routingrules/aaa111", "RoutingRuleId": "aaa111" } ``` Weitere Informationen finden Sie unter [Routing-Regeln zur Verbindung von API-Stufen mit einem benutzerdefinierten Domainnamen für REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-routing-rules.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [PutRoutingRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/put-routing-rule.html)in der *AWS CLI Befehlsreferenz*. ### `reimport-api` Das folgende Codebeispiel zeigt die Verwendung`reimport-api`. **AWS CLI** **So importieren Sie eine HTTP-API erneut** Im folgenden Beispiel für `reimport-api` wird eine bestehende HTTP-API so aktualisiert, dass sie die in `api-definition.yaml` angegebene OpenAPI 3.0-Definition verwendet. ``` aws apigatewayv2 reimport-api \ --body file://api-definition.yaml \ --api-id a1b2c3d4 ``` Inhalt von `api-definition.yaml`: ``` openapi: 3.0.1 info: title: My Lambda API version: v1.0 paths: /hello: x-amazon-apigateway-any-method: x-amazon-apigateway-integration: payloadFormatVersion: 2.0 type: aws_proxy httpMethod: POST uri: arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:12356789012:function:hello/invocations connectionType: INTERNET ``` Ausgabe: ``` { "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com", "ApiId": "a1b2c3d4", "ApiKeySelectionExpression": "$request.header.x-api-key", "CreatedDate": "2020-04-08T17:19:38+00:00", "Name": "My Lambda API", "ProtocolType": "HTTP", "RouteSelectionExpression": "$request.method $request.path", "Tags": {}, "Version": "v1.0" } ``` Weitere Informationen finden Sie unter [Arbeiten mit OpenAPI-Definitionen für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-open-api.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie unter [ReimportApi AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/reimport-api.html)*Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird ein Tag mit dem Schlüsselnamen `Department` und einem Wert von `Accounting` zur angegebenen API hinzugefügt. ``` aws apigatewayv2 tag-resource \ --resource-arn arn:aws:apigateway:us-west-2::/apis/a1b2c3d4 \ --tags Department=Accounting ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer API-Gateway-Ressourcen](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-tagging.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einer Ressource** Im folgenden Beispiel für `untag-resource` werden Tags mit den Schlüsselnamen `Project` und `Owner` aus der angegebenen API entfernt. ``` aws apigatewayv2 untag-resource \ --resource-arn arn:aws:apigateway:us-west-2::/apis/a1b2c3d4 \ --tag-keys Project Owner ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer API-Gateway-Ressourcen](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-tagging.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-api-mapping` Das folgende Codebeispiel zeigt die Verwendung`update-api-mapping`. **AWS CLI** **So aktualisieren Sie eine API-Zuordnung** Im folgenden Beispiel für `update-api-mapping` wird eine API-Zuordnung für einen benutzerdefinierten Domainnamen geändert. Dies hat zur Folge, dass die Basis-URL bei Verwendung des benutzerdefinierten Domainnamens für die angegebene API und Stufe zu `https://api.example.com/dev` wird. ``` aws apigatewayv2 update-api-mapping \ --api-id a1b2c3d4 \ --stage dev \ --domain-name api.example.com \ --api-mapping-id 0qzs2sy7bh \ --api-mapping-key dev ``` Ausgabe: ``` { "ApiId": "a1b2c3d4", "ApiMappingId": "0qzs2sy7bh", "ApiMappingKey": "dev" "Stage": "dev" } ``` Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [UpdateApiMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/update-api-mapping.html)in der *AWS CLI Befehlsreferenz*. ### `update-api` Das folgende Codebeispiel zeigt die Verwendung`update-api`. **AWS CLI** **So aktivieren Sie CORS für eine HTTP-API** Im folgenden Beispiel für `update-api` wird die CORS-Konfiguration der angegebenen API aktualisiert, sodass Anforderungen von `https://www.example.com` zugelassen sind. ``` aws apigatewayv2 update-api \ --api-id a1b2c3d4 \ --cors-configuration AllowOrigins=https://www.example.com ``` Ausgabe: ``` { "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com", "ApiId": "a1b2c3d4", "ApiKeySelectionExpression": "$request.header.x-api-key", "CorsConfiguration": { "AllowCredentials": false, "AllowHeaders": [ "header1", "header2" ], "AllowMethods": [ "GET", "OPTIONS" ], "AllowOrigins": [ "https://www.example.com" ] }, "CreatedDate": "2020-04-08T18:39:37+00:00", "Name": "my-http-api", "ProtocolType": "HTTP", "RouteSelectionExpression": "$request.method $request.path", "Tags": {}, "Version": "v1.0" } ``` Weitere Informationen finden Sie unter [Konfigurieren von CORS für eine HTTP-API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-cors.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [UpdateApi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/update-api.html)in der *AWS CLI Befehlsreferenz*. ### `update-authorizer` Das folgende Codebeispiel zeigt die Verwendung`update-authorizer`. **AWS CLI** **So aktualisieren Sie einen Genehmiger** Im folgenden Beispiel für `update-authorizer` wird die Identitätsquelle eines JWT-Genehmigers in einen Header mit dem Namen `Authorization` geändert. ``` aws apigatewayv2 update-authorizer \ --api-id a1b2c3d4 \ --authorizer-id a1b2c3 \ --identity-source '$request.header.Authorization' ``` Ausgabe: ``` { "AuthorizerId": "a1b2c3", "AuthorizerType": "JWT", "IdentitySource": [ "$request.header.Authorization" ], "JwtConfiguration": { "Audience": [ "123456abc" ], "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123" }, "Name": "my-jwt-authorizer" } ``` Weitere Informationen finden Sie unter [Steuern des Zugriffs auf HTTP APIs mit JWT-Autorisierern](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-jwt-authorizer.html) im *Amazon API Gateway* Developer Guide. + *Einzelheiten zur API finden Sie [UpdateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/update-authorizer.html)in AWS CLI der Befehlsreferenz.* ### `update-deployment` Das folgende Codebeispiel zeigt die Verwendung`update-deployment`. **AWS CLI** **So ändern Sie die Beschreibung einer Bereitstellung** Im folgenden Beispiel für `update-deployment` wird die Beschreibung einer Bereitstellung aktualisiert. ``` aws apigatewayv2 update-deployment \ --api-id a1b2c3d4 \ --deployment-id abcdef \ --description 'Manual deployment to fix integration test failures.' ``` Ausgabe: ``` { "AutoDeployed": false, "CreatedDate": "2020-02-05T16:21:48+00:00", "DeploymentId": "abcdef", "DeploymentStatus": "DEPLOYED", "Description": "Manual deployment to fix integration test failures." } ``` Weitere Informationen finden Sie unter [Entwickeln einer HTTP-API in Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [UpdateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/update-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `update-domain-name` Das folgende Codebeispiel zeigt die Verwendung`update-domain-name`. **AWS CLI** **So aktualisieren den Namen einer benutzerdefinierte Domain** Im folgenden Beispiel für `update-domain-name` wird ein neues ACM-Zertifikat für den benutzerdefinierten `api.example.com`-Domainnamen angegeben. ``` aws apigatewayv2 update-domain-name \ --domain-name api.example.com \ --domain-name-configurations CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678 ``` Ausgabe: ``` { "ApiMappingSelectionExpression": "$request.basepath", "DomainName": "regional.example.com", "DomainNameConfigurations": [ { "ApiGatewayDomainName": "d-id.execute-api.us-west-2.amazonaws.com", "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678", "EndpointType": "REGIONAL", "HostedZoneId": "123456789111", "SecurityPolicy": "TLS_1_2", "DomainNameStatus": "AVAILABLE" } ] } ``` Weitere Informationen finden Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [UpdateDomainName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/update-domain-name.html)in der *AWS CLI Befehlsreferenz*. ### `update-integration` Das folgende Codebeispiel zeigt die Verwendung`update-integration`. **AWS CLI** **So aktualisieren Sie eine Lambda-Integration** Im folgenden `update-integration` Beispiel wird eine bestehende AWS Lambda-Integration aktualisiert, sodass sie die angegebene Lambda-Funktion verwendet. ``` aws apigatewayv2 update-integration \ --api-id a1b2c3d4 \ --integration-id a1b2c3 \ --integration-uri arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:my-new-function/invocations ``` Ausgabe: ``` { "ConnectionType": "INTERNET", "IntegrationId": "a1b2c3", "IntegrationMethod": "POST", "IntegrationType": "AWS_PROXY", "IntegrationUri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:my-new-function/invocations", "PayloadFormatVersion": "2.0", "TimeoutInMillis": 5000 } ``` Weitere Informationen finden Sie unter [Konfiguration von Integrationen für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations.html) und [Einrichten von WebSocket API-Integrationen](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-integrations.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie [UpdateIntegration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/update-integration.html)in der *AWS CLI Befehlsreferenz*. ### `update-route` Das folgende Codebeispiel zeigt die Verwendung`update-route`. **AWS CLI** **Beispiel 1: So aktualisieren Sie die Integration einer Route** Im folgenden Beispiel für `update-route` wird die Integration einer angegebenen Route aktualisiert. ``` aws apigatewayv2 update-route \ --api-id a1b2c3d4 \ --route-id a1b2c3 \ --target integrations/a1b2c6 ``` Ausgabe: ``` { "ApiKeyRequired": false, "AuthorizationType": "NONE", "RouteId": "a1b2c3", "RouteKey": "ANY /pets", "Target": "integrations/a1b2c6" } ``` **Beispiel 2: So fügen Sie einer Route einen Genehmiger hinzu** Im folgenden Beispiel für `update-route` wird die angegebene Route so aktualisiert, dass sie einen JWT-Genehmiger verwendet. ``` aws apigatewayv2 update-route \ --api-id a1b2c3d4 \ --route-id a1b2c3 \ --authorization-type JWT \ --authorizer-id a1b2c5 \ --authorization-scopes user.id user.email ``` Ausgabe: ``` { "ApiKeyRequired": false, "AuthorizationScopes": [ "user.id", "user.email" ], "AuthorizationType": "JWT", "AuthorizerId": "a1b2c5", "OperationName": "GET HTTP", "RequestParameters": {}, "RouteId": "a1b2c3", "RouteKey": "GET /pets", "Target": "integrations/a1b2c6" } ``` Weitere Informationen finden Sie unter [Steuern des Zugriffs auf HTTP APIs mit JWT-Autorisierern](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-jwt-authorizer.html) im *Amazon API Gateway* Developer Guide. + *Einzelheiten zur API finden Sie [UpdateRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/update-route.html)in AWS CLI der Befehlsreferenz.* ### `update-stage` Das folgende Codebeispiel zeigt die Verwendung`update-stage`. **AWS CLI** **So konfigurieren Sie eine benutzerdefinierte Drosselung** Im folgenden Beispiel für `update-stage` wird die benutzerdefinierte Drosselung für die angegebene Stufe und Route einer API konfiguriert. ``` aws apigatewayv2 update-stage \ --api-id a1b2c3d4 \ --stage-name dev \ --route-settings '{"GET /pets":{"ThrottlingBurstLimit":100,"ThrottlingRateLimit":2000}}' ``` Ausgabe: ``` { "CreatedDate": "2020-04-05T16:21:16+00:00", "DefaultRouteSettings": { "DetailedMetricsEnabled": false }, "DeploymentId": "shktxb", "LastUpdatedDate": "2020-04-08T22:23:17+00:00", "RouteSettings": { "GET /pets": { "ThrottlingBurstLimit": 100, "ThrottlingRateLimit": 2000.0 } }, "StageName": "dev", "StageVariables": {}, "Tags": {} } ``` Weitere Informationen finden Sie unter [Schützen Ihrer HTTP-API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-protect.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [UpdateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/update-stage.html)in der *AWS CLI Befehlsreferenz*. ### `update-vpc-link` Das folgende Codebeispiel zeigt die Verwendung`update-vpc-link`. **AWS CLI** **So aktualisieren Sie einen VPC-Link** Im folgenden Beispiel für `update-vpc-link` wird der Name eines VPC-Links aktualisiert. Nachdem Sie einen VPC-Link erstellt haben, können Sie seine Sicherheitsgruppen oder Subnetze nicht ändern. ``` aws apigatewayv2 update-vpc-link \ --vpc-link-id abcd123 \ --name MyUpdatedVpcLink ``` Ausgabe: ``` { "CreatedDate": "2020-04-07T00:27:47Z", "Name": "MyUpdatedVpcLink", "SecurityGroupIds": [ "sg1234", "sg5678" ], "SubnetIds": [ "subnet-aaaa", "subnet-bbbb" ], "Tags": {}, "VpcLinkId": "abcd123", "VpcLinkStatus": "AVAILABLE", "VpcLinkStatusMessage": "VPC link is ready to route traffic", "VpcLinkVersion": "V2" } ``` Weitere Informationen finden Sie unter [Arbeiten mit VPC-Links für HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vpc-links.html) im *Amazon API Gateway Developer Guide*. + Einzelheiten zur API finden Sie unter [UpdateVpcLink AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewayv2/update-vpc-link.html)*Befehlsreferenz.* # API Gateway Management API-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mithilfe der API Gateway Management API Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-connection` Das folgende Codebeispiel zeigt, wie Sie`delete-connection`. **AWS CLI** **Um eine WebSocket Verbindung zu löschen** Das folgende `delete-connection` Beispiel trennt einen Client von der angegebenen WebSocket API. ``` aws apigatewaymanagementapi delete-connection \ --connection-id L0SM9cOFvHcCIhw= \ --endpoint-url https://aabbccddee.execute-api.us-west-2.amazonaws.com/prod ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden von @connections-Befehlen in Ihrem Backend-Service](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-how-to-call-websocket-api-connections.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie unter [DeleteConnection AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewaymanagementapi/delete-connection.html)*Befehlsreferenz.* ### `get-connection` Das folgende Codebeispiel zeigt die Verwendung`get-connection`. **AWS CLI** **Um Informationen über eine WebSocket Verbindung zu erhalten** Das folgende `get-connection` Beispiel beschreibt eine Verbindung zur angegebenen WebSocket API. ``` aws apigatewaymanagementapi get-connection \ --connection-id L0SM9cOFvHcCIhw= \ --endpoint-url https://aabbccddee.execute-api.us-west-2.amazonaws.com/prod ``` Ausgabe: ``` { "ConnectedAt": "2020-04-30T20:10:33.236Z", "Identity": { "SourceIp": "192.0.2.1" }, "LastActiveAt": "2020-04-30T20:10:42.997Z" } ``` Weitere Informationen finden Sie unter [Verwenden von @connections-Befehlen in Ihrem Backend-Service](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-how-to-call-websocket-api-connections.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [GetConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewaymanagementapi/get-connection.html)in der *AWS CLI Befehlsreferenz*. ### `post-to-connection` Das folgende Codebeispiel zeigt die Verwendung`post-to-connection`. **AWS CLI** **Um Daten an eine WebSocket Verbindung zu senden** Das folgende `post-to-connection` Beispiel sendet eine Nachricht an einen Client, der mit der angegebenen WebSocket API verbunden ist. ``` aws apigatewaymanagementapi post-to-connection \ --connection-id L0SM9cOFvHcCIhw= \ --data "Hello from API Gateway!" \ --endpoint-url https://aabbccddee.execute-api.us-west-2.amazonaws.com/prod ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden von @connections-Befehlen in Ihrem Backend-Service](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-how-to-call-websocket-api-connections.html) im *Entwicklerhandbuch für Amazon API Gateway*. + Einzelheiten zur API finden Sie [PostToConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewaymanagementapi/post-to-connection.html)unter *AWS CLI Befehlsreferenz*. # App Mesh Mesh-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with App Mesh Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-mesh` Das folgende Codebeispiel zeigt die Verwendung`create-mesh`. **AWS CLI** **Beispiel 1: So erstellen Sie ein neues Service Mesh** Im folgenden Beispiel für `create-mesh` wird ein Service Mesh erstellt. ``` aws appmesh create-mesh \ --mesh-name app1 ``` Ausgabe: ``` { "mesh":{ "meshName":"app1", "metadata":{ "arn":"arn:aws:appmesh:us-east-1:123456789012:mesh/app1", "createdAt":1563809909.282, "lastUpdatedAt":1563809909.282, "uid":"a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version":1 }, "spec":{}, "status":{ "status":"ACTIVE" } } } ``` **Beispiel 2: So erstellen Sie ein neues Service Mesh mit mehreren Tags** Im folgenden Beispiel für `create-mesh` wird ein Service Mesh mit mehreren Tags erstellt. ``` aws appmesh create-mesh \ --mesh-name app2 \ --tags key=key1,value=value1 key=key2,value=value2 key=key3,value=value3 ``` Ausgabe: ``` { "mesh":{ "meshName":"app2", "metadata":{ "arn":"arn:aws:appmesh:us-east-1:123456789012:mesh/app2", "createdAt":1563822121.877, "lastUpdatedAt":1563822121.877, "uid":"a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version":1 }, "spec":{}, "status":{ "status":"ACTIVE" } } } ``` Weitere Informationen finden Sie unter [Service Meshes](https://docs.aws.amazon.com/app-mesh/latest/userguide/meshes.html) im *Benutzerhandbuch für AWS -App-Mesh*. + Einzelheiten zur API finden Sie [CreateMesh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/create-mesh.html)in der *AWS CLI Befehlsreferenz*. ### `create-route` Das folgende Codebeispiel zeigt die Verwendung`create-route`. **AWS CLI** **So erstellen Sie eine neue gRPC-Route** Im folgenden Beispiel für `create-route` wird eine JSON-Eingabedatei für die Erstellung einer gRPC-Route verwendet. GRPC-Datenverkehr mit Metadaten, die mit 123 beginnen, wird an einen virtuellen Knoten namens serviceBgrpc weitergeleitet. Wenn beim Versuch, mit dem Ziel der Route zu kommunizieren, bestimmte gRPC-, HTTP- oder TCP-Fehler auftreten, wird die Route dreimal wiederholt. Zwischen jedem Wiederholungsversuch liegt eine Verzögerung von 15 Sekunden. ``` aws appmesh create-route \ --cli-input-json file://create-route-grpc.json ``` Inhalt von `create-route-grpc.json`: ``` { "meshName" : "apps", "routeName" : "grpcRoute", "spec" : { "grpcRoute" : { "action" : { "weightedTargets" : [ { "virtualNode" : "serviceBgrpc", "weight" : 100 } ] }, "match" : { "metadata" : [ { "invert" : false, "match" : { "prefix" : "123" }, "name" : "myMetadata" } ], "methodName" : "GetColor", "serviceName" : "com.amazonaws.services.ColorService" }, "retryPolicy" : { "grpcRetryEvents" : [ "deadline-exceeded" ], "httpRetryEvents" : [ "server-error", "gateway-error" ], "maxRetries" : 3, "perRetryTimeout" : { "unit" : "s", "value" : 15 }, "tcpRetryEvents" : [ "connection-error" ] } }, "priority" : 100 }, "virtualRouterName" : "serviceBgrpc" } ``` Ausgabe: ``` { "route": { "meshName": "apps", "metadata": { "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/apps/virtualRouter/serviceBgrpc/route/grpcRoute", "createdAt": 1572010806.008, "lastUpdatedAt": 1572010806.008, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "routeName": "grpcRoute", "spec": { "grpcRoute": { "action": { "weightedTargets": [ { "virtualNode": "serviceBgrpc", "weight": 100 } ] }, "match": { "metadata": [ { "invert": false, "match": { "prefix": "123" }, "name": "mymetadata" } ], "methodName": "GetColor", "serviceName": "com.amazonaws.services.ColorService" }, "retryPolicy": { "grpcRetryEvents": [ "deadline-exceeded" ], "httpRetryEvents": [ "server-error", "gateway-error" ], "maxRetries": 3, "perRetryTimeout": { "unit": "s", "value": 15 }, "tcpRetryEvents": [ "connection-error" ] } }, "priority": 100 }, "status": { "status": "ACTIVE" }, "virtualRouterName": "serviceBgrpc" } } ``` **So erstellen Sie eine neue HTTP- oder HTTP/2-Route** Im folgenden Beispiel für `create-route` wird eine JSON-Eingabedatei für die Erstellung einer HTTP/2-Route verwendet. Um eine HTTP-Route zu erstellen, ersetzen Sie http2Route unter „spec“ durch httpRoute. Der gesamte HTTP/2-Datenverkehr, der an ein URL-Präfix adressiert ist, dessen Header-Wert mit 123 beginnt, wird an einen virtuellen Knoten namens serviceBhttp2 weitergeleitet. Wenn beim Versuch, mit dem Ziel der Route zu kommunizieren, bestimmte HTTP- oder TCP-Fehler auftreten, wird die Route dreimal wiederholt. Zwischen jedem Wiederholungsversuch liegt eine Verzögerung von 15 Sekunden. ``` aws appmesh create-route \ --cli-input-json file://create-route-http2.json ``` Inhalt von `create-route-http2.json`: ``` { "meshName": "apps", "routeName": "http2Route", "spec": { "http2Route": { "action": { "weightedTargets": [ { "virtualNode": "serviceBhttp2", "weight": 100 } ] }, "match": { "headers": [ { "invert": false, "match": { "prefix": "123" }, "name": "clientRequestId" } ], "method": "POST", "prefix": "/", "scheme": "http" }, "retryPolicy": { "httpRetryEvents": [ "server-error", "gateway-error" ], "maxRetries": 3, "perRetryTimeout": { "unit": "s", "value": 15 }, "tcpRetryEvents": [ "connection-error" ] } }, "priority": 200 }, "virtualRouterName": "serviceBhttp2" } ``` Ausgabe: ``` { "route": { "meshName": "apps", "metadata": { "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/apps/virtualRouter/serviceBhttp2/route/http2Route", "createdAt": 1572011008.352, "lastUpdatedAt": 1572011008.352, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "routeName": "http2Route", "spec": { "http2Route": { "action": { "weightedTargets": [ { "virtualNode": "serviceBhttp2", "weight": 100 } ] }, "match": { "headers": [ { "invert": false, "match": { "prefix": "123" }, "name": "clientRequestId" } ], "method": "POST", "prefix": "/", "scheme": "http" }, "retryPolicy": { "httpRetryEvents": [ "server-error", "gateway-error" ], "maxRetries": 3, "perRetryTimeout": { "unit": "s", "value": 15 }, "tcpRetryEvents": [ "connection-error" ] } }, "priority": 200 }, "status": { "status": "ACTIVE" }, "virtualRouterName": "serviceBhttp2" } } ``` **So erstellen Sie eine neue TCP-Route** Im folgenden Beispiel für `create-route` wird eine JSON-Eingabedatei verwendet, um eine TCP-Route zu erstellen. 75 Prozent des Datenverkehrs werden an einen virtuellen Knoten namens serviceBtcp weitergeleitet, und 25 Prozent des Datenverkehrs werden an einen virtuellen Knoten namens serviceBv2tcp weitergeleitet. Die Angabe unterschiedlicher Gewichtungen für verschiedene Ziele ist eine effektive Methode zur Bereitstellung einer neuen Version einer Anwendung. Sie können die Gewichtungen so anpassen, dass letztendlich 100 Prozent des gesamten Datenverkehrs an ein Ziel weitergeleitet werden, auf dem die neue Version einer Anwendung vorhanden ist. ``` aws appmesh create-route \ --cli-input-json file://create-route-tcp.json ``` Inhalt create-route-tcp von.json: ``` { "meshName": "apps", "routeName": "tcpRoute", "spec": { "priority": 300, "tcpRoute": { "action": { "weightedTargets": [ { "virtualNode": "serviceBtcp", "weight": 75 }, { "virtualNode": "serviceBv2tcp", "weight": 25 } ] } } }, "virtualRouterName": "serviceBtcp" } ``` Ausgabe: ``` { "route": { "meshName": "apps", "metadata": { "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/apps/virtualRouter/serviceBtcp/route/tcpRoute", "createdAt": 1572011436.26, "lastUpdatedAt": 1572011436.26, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "routeName": "tcpRoute", "spec": { "priority": 300, "tcpRoute": { "action": { "weightedTargets": [ { "virtualNode": "serviceBtcp", "weight": 75 }, { "virtualNode": "serviceBv2tcp", "weight": 25 } ] } } }, "status": { "status": "ACTIVE" }, "virtualRouterName": "serviceBtcp" } } ``` Weitere Informationen finden Sie unter [Routen](https://docs.aws.amazon.com/app-mesh/latest/userguide/routes.html) im *Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [CreateRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/create-route.html)in der *AWS CLI Befehlsreferenz.* ### `create-virtual-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-virtual-gateway`. **AWS CLI** **So erstellen Sie ein neues virtuelles Gateway** Im folgenden Beispiel für `create-virtual-gateway` wird eine JSON-Eingabedatei verwendet, um ein virtuelles Gateway mit einem Listener für HTTP über Port 9080 zu erstellen. ``` aws appmesh create-virtual-gateway \ --mesh-name meshName \ --virtual-gateway-name virtualGatewayName \ --cli-input-json file://create-virtual-gateway.json ``` Inhalt von `create-virtual-gateway.json`: ``` { "spec": { "listeners": [ { "portMapping": { "port": 9080, "protocol": "http" } } ] } } ``` Ausgabe: ``` { "virtualGateway": { "meshName": "meshName", "metadata": { "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/meshName/virtualGateway/virtualGatewayName", "createdAt": "2022-04-06T10:42:42.015000-05:00", "lastUpdatedAt": "2022-04-06T10:42:42.015000-05:00", "meshOwner": "123456789012", "resourceOwner": "123456789012", "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "spec": { "listeners": [ { "portMapping": { "port": 9080, "protocol": "http" } } ] }, "status": { "status": "ACTIVE" }, "virtualGatewayName": "virtualGatewayName" } } ``` Weitere Informationen finden Sie unter [Virtuelle Gateways](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_gateways.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [CreateVirtualGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/create-virtual-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `create-virtual-node` Das folgende Codebeispiel zeigt die Verwendung`create-virtual-node`. **AWS CLI** **Beispiel 1: So erstellen Sie einen neuen virtuellen Knoten, der DNS für die Erkennung verwendet** Im folgenden Beispiel für `create-virtual-node` wird eine JSON-Eingabedatei verwendet, um einen virtuellen Knoten zu erstellen, der DNS für die Serviceerkennung verwendet. ``` aws appmesh create-virtual-node \ --cli-input-json file://create-virtual-node-dns.json ``` Inhalt von `create-virtual-node-dns.json`: ``` { "meshName": "app1", "spec": { "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ], "serviceDiscovery": { "dns": { "hostname": "serviceBv1.svc.cluster.local" } } }, "virtualNodeName": "vnServiceBv1" } ``` Ausgabe: ``` { "virtualNode": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualNode/vnServiceBv1", "createdAt": 1563810019.874, "lastUpdatedAt": 1563810019.874, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "spec": { "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ], "serviceDiscovery": { "dns": { "hostname": "serviceBv1.svc.cluster.local" } } }, "status": { "status": "ACTIVE" }, "virtualNodeName": "vnServiceBv1" } } ``` **Beispiel 2: So erstellen Sie einen neuen virtuellen Knoten, der AWS Cloud Map für die Erkennung verwendet** Das folgende `create-virtual-node` Beispiel verwendet eine JSON-Eingabedatei, um einen virtuellen Knoten zu erstellen, der AWS Cloud Map für die Serviceerkennung verwendet. ``` aws appmesh create-virtual-node \ --cli-input-json file://create-virtual-node-cloud-map.json ``` Inhalt von `create-virtual-node-cloud-map.json`: ``` { "meshName": "app1", "spec": { "backends": [ { "virtualService": { "virtualServiceName": "serviceA.svc.cluster.local" } } ], "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ], "serviceDiscovery": { "awsCloudMap": { "attributes": [ { "key": "Environment", "value": "Testing" } ], "namespaceName": "namespace1", "serviceName": "serviceA" } } }, "virtualNodeName": "vnServiceA" } ``` Ausgabe: ``` { "virtualNode": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualNode/vnServiceA", "createdAt": 1563810859.465, "lastUpdatedAt": 1563810859.465, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "spec": { "backends": [ { "virtualService": { "virtualServiceName": "serviceA.svc.cluster.local" } } ], "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ], "serviceDiscovery": { "awsCloudMap": { "attributes": [ { "key": "Environment", "value": "Testing" } ], "namespaceName": "namespace1", "serviceName": "serviceA" } } }, "status": { "status": "ACTIVE" }, "virtualNodeName": "vnServiceA" } } ``` Weitere Informationen finden Sie unter [Virtuelle Knoten](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_nodes.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [CreateVirtualNode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/create-virtual-node.html)unter *AWS CLI Befehlsreferenz*. ### `create-virtual-router` Das folgende Codebeispiel zeigt die Verwendung`create-virtual-router`. **AWS CLI** **So erstellen Sie einen neuen virtuellen Router** Im folgenden Beispiel für `create-virtual-router` wird eine JSON-Eingabedatei verwendet, um einen virtuellen Router mit einem Listener für HTTP über Port 80 zu erstellen. ``` aws appmesh create-virtual-router \ --cli-input-json file://create-virtual-router.json ``` Inhalt von `create-virtual-router.json`: ``` { "meshName": "app1", "spec": { "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ] }, "virtualRouterName": "vrServiceB" } ``` Ausgabe: ``` { "virtualRouter": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualRouter/vrServiceB", "createdAt": 1563810546.59, "lastUpdatedAt": 1563810546.59, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "spec": { "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ] }, "status": { "status": "ACTIVE" }, "virtualRouterName": "vrServiceB" } } ``` Weitere Informationen finden Sie unter [Virtuelle Router](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_routers.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [CreateVirtualRouter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/create-virtual-router.html)in der *AWS CLI Befehlsreferenz*. ### `create-virtual-service` Das folgende Codebeispiel zeigt die Verwendung`create-virtual-service`. **AWS CLI** **Beispiel 1: So erstellen Sie einen neuen virtuellen Service mit einem Anbieter für virtuelle Knoten** Im folgenden Beispiel für `create-virtual-service` wird eine JSON-Eingabedatei verwendet, um einen virtuellen Service mit einem Anbieter für virtuelle Knoten zu erstellen. ``` aws appmesh create-virtual-service \ --cli-input-json file://create-virtual-service-virtual-node.json ``` Inhalt von `create-virtual-service-virtual-node.json`: ``` { "meshName": "app1", "spec": { "provider": { "virtualNode": { "virtualNodeName": "vnServiceA" } } }, "virtualServiceName": "serviceA.svc.cluster.local" } ``` Ausgabe: ``` { "virtualService": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualService/serviceA.svc.cluster.local", "createdAt": 1563810859.474, "lastUpdatedAt": 1563810967.179, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 2 }, "spec": { "provider": { "virtualNode": { "virtualNodeName": "vnServiceA" } } }, "status": { "status": "ACTIVE" }, "virtualServiceName": "serviceA.svc.cluster.local" } } ``` Weitere Informationen finden Sie unter [Virtueller Knoten](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_nodes.html) im * Benutzerhandbuch für AWS App Mesh*. **Beispiel 2: So erstellen Sie einen neuen virtuellen Service mit einem Anbieter für virtuelle Router** Im folgenden Beispiel für `create-virtual-service` wird eine JSON-Eingabedatei verwendet, um einen virtuellen Service mit einem Anbieter für virtuelle Router zu erstellen. ``` aws appmesh create-virtual-service \ --cli-input-json file://create-virtual-service-virtual-router.json ``` Inhalt von `create-virtual-service-virtual-router.json`: ``` { "meshName": "app1", "spec": { "provider": { "virtualRouter": { "virtualRouterName": "vrServiceB" } } }, "virtualServiceName": "serviceB.svc.cluster.local" } ``` Ausgabe: ``` { "virtualService": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualService/serviceB.svc.cluster.local", "createdAt": 1563908363.999, "lastUpdatedAt": 1563908363.999, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "spec": { "provider": { "virtualRouter": { "virtualRouterName": "vrServiceB" } } }, "status": { "status": "ACTIVE" }, "virtualServiceName": "serviceB.svc.cluster.local" } } ``` *Weitere Informationen finden Sie unter Virtual Services< https://docs.aws.amazon.com/app-mesh/ latest/userguide/virtual \$1services.html> im App Mesh Mesh-Benutzerhandbuch AWS * + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [CreateVirtualService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/create-virtual-service.html)AWS CLI * ### `delete-mesh` Das folgende Codebeispiel zeigt die Verwendung`delete-mesh`. **AWS CLI** **So löschen Sie ein Service Mesh** Im folgenden Beispiel für `delete-mesh` wird das angegebene Service Mesh gelöscht. ``` aws appmesh delete-mesh \ --mesh-name app1 ``` Ausgabe: ``` { "mesh": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1", "createdAt": 1563809909.282, "lastUpdatedAt": 1563824981.248, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 2 }, "spec": { "egressFilter": { "type": "ALLOW_ALL" } }, "status": { "status": "DELETED" } } } ``` Weitere Informationen finden Sie unter [Service Meshes](https://docs.aws.amazon.com/app-mesh/latest/userguide/meshes.html) im *Benutzerhandbuch für AWS -App-Mesh*. + Einzelheiten zur API finden Sie [DeleteMesh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/delete-mesh.html)in der *AWS CLI Befehlsreferenz*. ### `delete-route` Das folgende Codebeispiel zeigt die Verwendung`delete-route`. **AWS CLI** **So löschen Sie eine Route** Im folgenden Beispiel für `delete-route` wird die angegebene Route gelöscht. ``` aws appmesh delete-route \ --mesh-name app1 \ --virtual-router-name vrServiceB \ --route-name toVnServiceB-weighted ``` Ausgabe: ``` { "route": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualRouter/vrServiceB/route/toVnServiceB-weighted", "createdAt": 1563811384.015, "lastUpdatedAt": 1563823915.936, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 3 }, "routeName": "toVnServiceB-weighted", "spec": { "httpRoute": { "action": { "weightedTargets": [ { "virtualNode": "vnServiceBv1", "weight": 80 }, { "virtualNode": "vnServiceBv2", "weight": 20 } ] }, "match": { "prefix": "/" } } }, "status": { "status": "DELETED" }, "virtualRouterName": "vrServiceB" } } ``` Weitere Informationen finden Sie unter [Routen](https://docs.aws.amazon.com/app-mesh/latest/userguide/routes.html) im *Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [DeleteRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/delete-route.html)in der *AWS CLI Befehlsreferenz*. ### `delete-virtual-node` Das folgende Codebeispiel zeigt die Verwendung`delete-virtual-node`. **AWS CLI** **So löschen Sie einen virtuellen Knoten** Im folgenden Beispiel für `delete-virtual-node` wird der angegebene virtuelle Knoten gelöscht. ``` aws appmesh delete-virtual-node \ --mesh-name app1 \ --virtual-node-name vnServiceBv2 ``` Ausgabe: ``` { "virtualNode": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualNode/vnServiceBv2", "createdAt": 1563810117.297, "lastUpdatedAt": 1563824700.678, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 2 }, "spec": { "backends": [], "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ], "serviceDiscovery": { "dns": { "hostname": "serviceBv2.svc.cluster.local" } } }, "status": { "status": "DELETED" }, "virtualNodeName": "vnServiceBv2" } } ``` Weitere Informationen finden Sie unter [Virtuelle Knoten](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_nodes.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [DeleteVirtualNode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/delete-virtual-node.html)in der *AWS CLI Befehlsreferenz*. ### `delete-virtual-router` Das folgende Codebeispiel zeigt die Verwendung`delete-virtual-router`. **AWS CLI** **So löschen Sie einen virtuellen Router** Im folgenden Beispiel für `delete-virtual-router` wird der angegebene virtuelle Router gelöscht. ``` aws appmesh delete-virtual-router \ --mesh-name app1 \ --virtual-router-name vrServiceB ``` Ausgabe: ``` { "virtualRouter": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualRouter/vrServiceB", "createdAt": 1563810546.59, "lastUpdatedAt": 1563824253.467, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 3 }, "spec": { "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ] }, "status": { "status": "DELETED" }, "virtualRouterName": "vrServiceB" } } ``` Weitere Informationen finden Sie unter [Virtuelle Router](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_routers.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [DeleteVirtualRouter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/delete-virtual-router.html)in der *AWS CLI Befehlsreferenz*. ### `delete-virtual-service` Das folgende Codebeispiel zeigt die Verwendung`delete-virtual-service`. **AWS CLI** **So löschen Sie einen virtuellen Service** Im folgenden Beispiel für `delete-virtual-service` wird der angegebene virtuelle Service gelöscht. ``` aws appmesh delete-virtual-service \ --mesh-name app1 \ --virtual-service-name serviceB.svc.cluster.local ``` Ausgabe: ``` { "virtualService": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualService/serviceB.svc.cluster.local", "createdAt": 1563908363.999, "lastUpdatedAt": 1563913940.866, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 3 }, "spec": {}, "status": { "status": "DELETED" }, "virtualServiceName": "serviceB.svc.cluster.local" } } ``` Weitere Informationen finden Sie unter [Virtueller Service](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_services.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [DeleteVirtualService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/delete-virtual-service.html)in der *AWS CLI Befehlsreferenz*. ### `describe-mesh` Das folgende Codebeispiel zeigt die Verwendung`describe-mesh`. **AWS CLI** **So beschreiben Sie ein Service Mesh** Im folgenden Beispiel für `describe-mesh` werden Details zum angegebenen Service Mesh zurückgegeben. ``` aws appmesh describe-mesh \ --mesh-name app1 ``` Ausgabe: ``` { "mesh": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1", "createdAt": 1563809909.282, "lastUpdatedAt": 1563809909.282, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "spec": {}, "status": { "status": "ACTIVE" } } } ``` Weitere Informationen finden Sie unter [Service Meshes](https://docs.aws.amazon.com/app-mesh/latest/userguide/meshes.html) im *Benutzerhandbuch für AWS -App-Mesh*. + Einzelheiten zur API finden Sie [DescribeMesh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/describe-mesh.html)in der *AWS CLI Befehlsreferenz*. ### `describe-route` Das folgende Codebeispiel zeigt die Verwendung`describe-route`. **AWS CLI** **So beschreiben Sie eine Route** Im folgenden Beispiel für `describe-route` werden Details zur angegebenen Route zurückgegeben. ``` aws appmesh describe-route \ --mesh-name app1 \ --virtual-router-name vrServiceB \ --route-name toVnServiceB-weighted ``` Ausgabe: ``` { "route": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualRouter/vrServiceB/route/toVnServiceB-weighted", "createdAt": 1563811384.015, "lastUpdatedAt": 1563811384.015, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "routeName": "toVnServiceB-weighted", "spec": { "httpRoute": { "action": { "weightedTargets": [ { "virtualNode": "vnServiceBv1", "weight": 90 }, { "virtualNode": "vnServiceBv2", "weight": 10 } ] }, "match": { "prefix": "/" } } }, "status": { "status": "ACTIVE" }, "virtualRouterName": "vrServiceB" } } ``` Weitere Informationen finden Sie unter [Routen](https://docs.aws.amazon.com/app-mesh/latest/userguide/routes.html) im *Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [DescribeRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/describe-route.html)in der *AWS CLI Befehlsreferenz*. ### `describe-virtual-node` Das folgende Codebeispiel zeigt die Verwendung`describe-virtual-node`. **AWS CLI** **So beschreiben Sie einen virtuellen Knoten** Im folgenden Beispiel für `describe-virtual-node` werden Details zum angegebenen virtuellen Knoten zurückgegeben. ``` aws appmesh describe-virtual-node \ --mesh-name app1 \ --virtual-node-name vnServiceBv1 ``` Ausgabe: ``` { "virtualNode": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualNode/vnServiceBv1", "createdAt": 1563810019.874, "lastUpdatedAt": 1563810019.874, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "spec": { "backends": [], "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ], "serviceDiscovery": { "dns": { "hostname": "serviceBv1.svc.cluster.local" } } }, "status": { "status": "ACTIVE" }, "virtualNodeName": "vnServiceBv1" } } ``` Weitere Informationen finden Sie unter [Virtuelle Knoten](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_nodes.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [DescribeVirtualNode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/describe-virtual-node.html)in der *AWS CLI Befehlsreferenz*. ### `describe-virtual-router` Das folgende Codebeispiel zeigt die Verwendung`describe-virtual-router`. **AWS CLI** **So beschreiben Sie einen virtuellen Router** Im folgenden Beispiel für `describe-virtual-router` werden Details zum angegebenen virtuellen Router zurückgegeben. ``` aws appmesh describe-virtual-router \ --mesh-name app1 \ --virtual-router-name vrServiceB ``` Ausgabe: ``` { "virtualRouter": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualRouter/vrServiceB", "createdAt": 1563810546.59, "lastUpdatedAt": 1563810546.59, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "spec": { "listeners": [ { "portMapping": { "port": 80, "protocol": "http" } } ] }, "status": { "status": "ACTIVE" }, "virtualRouterName": "vrServiceB" } } ``` Weitere Informationen finden Sie unter [Virtuelle Router](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_routers.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [DescribeVirtualRouter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/describe-virtual-router.html)in der *AWS CLI Befehlsreferenz*. ### `describe-virtual-service` Das folgende Codebeispiel zeigt die Verwendung`describe-virtual-service`. **AWS CLI** **So beschreiben Sie einen virtuellen Service** Im folgenden Beispiel für `describe-virtual-service` werden Details zum angegebenen virtuellen Service zurückgegeben. ``` aws appmesh describe-virtual-service \ --mesh-name app1 \ --virtual-service-name serviceB.svc.cluster.local ``` Ausgabe: ``` { "virtualService": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualService/serviceB.svc.cluster.local", "createdAt": 1563908363.999, "lastUpdatedAt": 1563908363.999, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 1 }, "spec": { "provider": { "virtualRouter": { "virtualRouterName": "vrServiceB" } } }, "status": { "status": "ACTIVE" }, "virtualServiceName": "serviceB.svc.cluster.local" } } ``` Weitere Informationen finden Sie unter [Virtuelle Services](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_services.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [DescribeVirtualService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/describe-virtual-service.html)in der *AWS CLI Befehlsreferenz*. ### `list-meshes` Das folgende Codebeispiel zeigt die Verwendung`list-meshes`. **AWS CLI** **So listen Sie Service Meshes auf** Das folgende `list-meshes` Beispiel listet alle Service Meshes in der aktuellen AWS Region auf. ``` aws appmesh list-meshes ``` Ausgabe: ``` { "meshes": [ { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1", "meshName": "app1" } ] } ``` Weitere Informationen finden Sie unter [Service Meshes](https://docs.aws.amazon.com/app-mesh/latest/userguide/meshes.html) im *Benutzerhandbuch für AWS -App-Mesh*. + Einzelheiten zur API finden Sie [ListMeshes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/list-meshes.html)in der *AWS CLI Befehlsreferenz.* ### `list-routes` Das folgende Codebeispiel zeigt die Verwendung`list-routes`. **AWS CLI** **So listen Sie Routen auf** Im folgenden Beispiel für `list-routes` werden alle Routen für den angegebenen virtuellen Router aufgelistet. ``` aws appmesh list-routes \ --mesh-name app1 \ --virtual-router-name vrServiceB ``` Ausgabe: ``` { "routes": [ { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualRouter/vrServiceB/route/toVnServiceB", "meshName": "app1", "routeName": "toVnServiceB-weighted", "virtualRouterName": "vrServiceB" } ] } ``` Weitere Informationen finden Sie unter [Routen](https://docs.aws.amazon.com/app-mesh/latest/userguide/routes.html) im *Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [ListRoutes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/list-routes.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags aufgelistet, die der angegebenen Ressource zugewiesen sind. ``` aws appmesh list-tags-for-resource \ --resource-arn arn:aws:appmesh:us-east-1:123456789012:mesh/app1 ``` Ausgabe: ``` { "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" }, { "key": "key3", "value": "value3" } ] } ``` + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-virtual-nodes` Das folgende Codebeispiel zeigt die Verwendung`list-virtual-nodes`. **AWS CLI** **So listen Sie virtuelle Knoten auf** Im folgenden Beispiel für `list-virtual-nodes` werden alle virtuellen Knoten im angegebenen Service Mesh aufgelistet. ``` aws appmesh list-virtual-nodes \ --mesh-name app1 ``` Ausgabe: ``` { "virtualNodes": [ { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualNode/vnServiceBv1", "meshName": "app1", "virtualNodeName": "vnServiceBv1" }, { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualNode/vnServiceBv2", "meshName": "app1", "virtualNodeName": "vnServiceBv2" } ] } ``` Weitere Informationen finden Sie unter [Virtuelle Knoten](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_nodes.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [ListVirtualNodes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/list-virtual-nodes.html)in der *AWS CLI Befehlsreferenz*. ### `list-virtual-routers` Das folgende Codebeispiel zeigt die Verwendung`list-virtual-routers`. **AWS CLI** **So listen Sie virtuelle Router auf** Im folgenden Beispiel für `list-virtual-routers` werden alle virtuellen Router im angegebenen Service Mesh aufgelistet. ``` aws appmesh list-virtual-routers \ --mesh-name app1 ``` Ausgabe: ``` { "virtualRouters": [ { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualRouter/vrServiceB", "meshName": "app1", "virtualRouterName": "vrServiceB" } ] } ``` Weitere Informationen finden Sie unter [Virtuelle Router](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_routers.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [ListVirtualRouters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/list-virtual-routers.html)in der *AWS CLI Befehlsreferenz*. ### `list-virtual-services` Das folgende Codebeispiel zeigt die Verwendung`list-virtual-services`. **AWS CLI** **So listen Sie virtuelle Services auf** Im folgenden Beispiel für `list-virtual-services` werden alle virtuellen Services im angegebenen Service Mesh aufgelistet. ``` aws appmesh list-virtual-services \ --mesh-name app1 ``` Ausgabe: ``` { "virtualServices": [ { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualService/serviceA.svc.cluster.local", "meshName": "app1", "virtualServiceName": "serviceA.svc.cluster.local" }, { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualService/serviceB.svc.cluster.local", "meshName": "app1", "virtualServiceName": "serviceB.svc.cluster.local" } ] } ``` Weitere Informationen finden Sie unter [Virtuelle Services](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_services.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [ListVirtualServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/list-virtual-services.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird der angegebenen Ressource das Tag `key1` mit dem Wert `value1` hinzugefügt. ``` aws appmesh tag-resource \ --resource-arn arn:aws:appmesh:us-east-1:123456789012:mesh/app1 \ --tags key=key1,value=value1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags von einer Ressource** Im folgenden Beispiel für `untag-resource` wird ein Tag mit dem Schlüssel `key1` aus der angegebenen Ressource entfernt. ``` aws appmesh untag-resource \ --resource-arn arn:aws:appmesh:us-east-1:123456789012:mesh/app1 \ --tag-keys key1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-mesh` Das folgende Codebeispiel zeigt die Verwendung`update-mesh`. **AWS CLI** **So aktualisieren Sie ein Service Mesh** Im folgenden Beispiel für `update-mesh` wird eine JSON-Eingabedatei verwendet, um ein Service Mesh zu aktualisieren, sodass der gesamte externe Ausgangsdatenverkehr unverändert über den Envoy-Proxy weitergeleitet werden kann. ``` aws appmesh update-mesh \ --cli-input-json file://update-mesh.json ``` Inhalt von `update-mesh.json`: ``` { "meshName": "app1", "spec": { "egressFilter": { "type": "ALLOW_ALL" } } } ``` Ausgabe: ``` { "mesh": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1", "createdAt": 1563809909.282, "lastUpdatedAt": 1563812829.687, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 2 }, "spec": { "egressFilter": { "type": "ALLOW_ALL" } }, "status": { "status": "ACTIVE" } } } ``` Weitere Informationen finden Sie unter [Service Meshes](https://docs.aws.amazon.com/app-mesh/latest/userguide/meshes.html) im *Benutzerhandbuch für AWS -App-Mesh*. + Einzelheiten zur API finden Sie [UpdateMesh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/update-mesh.html)in der *AWS CLI Befehlsreferenz*. ### `update-route` Das folgende Codebeispiel zeigt die Verwendung`update-route`. **AWS CLI** **So aktualisieren Sie eine Route** Im folgenden Beispiel für `update-route` wird eine JSON-Eingabedatei verwendet, um die Gewichtungen für eine Route zu aktualisieren. ``` aws appmesh update-route \ --cli-input-json file://update-route-weighted.json ``` Inhalt von `update-route-weighted.json`: ``` { "meshName": "app1", "routeName": "toVnServiceB-weighted", "spec": { "httpRoute": { "action": { "weightedTargets": [ { "virtualNode": "vnServiceBv1", "weight": 80 }, { "virtualNode": "vnServiceBv2", "weight": 20 } ] }, "match": { "prefix": "/" } } }, "virtualRouterName": "vrServiceB" } ``` Ausgabe: ``` { "route": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualRouter/vrServiceB/route/toVnServiceB-weighted", "createdAt": 1563811384.015, "lastUpdatedAt": 1563819600.022, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 2 }, "routeName": "toVnServiceB-weighted", "spec": { "httpRoute": { "action": { "weightedTargets": [ { "virtualNode": "vnServiceBv1", "weight": 80 }, { "virtualNode": "vnServiceBv2", "weight": 20 } ] }, "match": { "prefix": "/" } } }, "status": { "status": "ACTIVE" }, "virtualRouterName": "vrServiceB" } } ``` Weitere Informationen finden Sie unter [Routen](https://docs.aws.amazon.com/app-mesh/latest/userguide/routes.html) im *Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [UpdateRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/update-route.html)in der *AWS CLI Befehlsreferenz*. ### `update-virtual-node` Das folgende Codebeispiel zeigt die Verwendung`update-virtual-node`. **AWS CLI** **So aktualisieren Sie einen virtuellen Knoten** Im folgenden Beispiel für `update-virtual-node` wird eine JSON-Eingabedatei verwendet, um einem virtuellen Knoten eine Zustandsprüfung hinzuzufügen. ``` aws appmesh update-virtual-node \ --cli-input-json file://update-virtual-node.json ``` Inhalt von `update-virtual-node.json`: ``` { "clientToken": "500", "meshName": "app1", "spec": { "listeners": [ { "healthCheck": { "healthyThreshold": 5, "intervalMillis": 10000, "path": "/", "port": 80, "protocol": "http", "timeoutMillis": 3000, "unhealthyThreshold": 3 }, "portMapping": { "port": 80, "protocol": "http" } } ], "serviceDiscovery": { "dns": { "hostname": "serviceBv1.svc.cluster.local" } } }, "virtualNodeName": "vnServiceBv1" } ``` Ausgabe: ``` { "virtualNode": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualNode/vnServiceBv1", "createdAt": 1563810019.874, "lastUpdatedAt": 1563819234.825, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 2 }, "spec": { "listeners": [ { "healthCheck": { "healthyThreshold": 5, "intervalMillis": 10000, "path": "/", "port": 80, "protocol": "http", "timeoutMillis": 3000, "unhealthyThreshold": 3 }, "portMapping": { "port": 80, "protocol": "http" } } ], "serviceDiscovery": { "dns": { "hostname": "serviceBv1.svc.cluster.local" } } }, "status": { "status": "ACTIVE" }, "virtualNodeName": "vnServiceBv1" } } ``` Weitere Informationen finden Sie unter [Virtuelle Knoten](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_nodes.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [UpdateVirtualNode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/update-virtual-node.html)in der *AWS CLI Befehlsreferenz*. ### `update-virtual-router` Das folgende Codebeispiel zeigt die Verwendung`update-virtual-router`. **AWS CLI** **So aktualisieren Sie einen virtuellen Router** Im folgenden Beispiel für `update-virtual-router` wird eine JSON-Eingabedatei verwendet, um den Listener-Port eines virtuellen Routers zu aktualisieren. ``` aws appmesh update-virtual-router \ --cli-input-json file://update-virtual-router.json ``` Inhalt von `update-virtual-router.json`: ``` { "meshName": "app1", "spec": { "listeners": [ { "portMapping": { "port": 8080, "protocol": "http" } } ] }, "virtualRouterName": "vrServiceB" } ``` Ausgabe: ``` { "virtualRouter": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualRouter/vrServiceB", "createdAt": 1563810546.59, "lastUpdatedAt": 1563819431.352, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 2 }, "spec": { "listeners": [ { "portMapping": { "port": 8080, "protocol": "http" } } ] }, "status": { "status": "ACTIVE" }, "virtualRouterName": "vrServiceB" } } ``` Weitere Informationen finden Sie unter [Virtuelle Router](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_routers.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [UpdateVirtualRouter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/update-virtual-router.html)in der *AWS CLI Befehlsreferenz*. ### `update-virtual-service` Das folgende Codebeispiel zeigt die Verwendung`update-virtual-service`. **AWS CLI** **So aktualisieren Sie einen virtuellen Service** Im folgenden Beispiel für `update-virtual-service` wird eine JSON-Eingabedatei verwendet, um einen virtuellen Service so zu aktualisieren, dass er einen Anbieter für virtuelle Router verwendet. ``` aws appmesh update-virtual-service \ --cli-input-json file://update-virtual-service.json ``` Inhalt von `update-virtual-service.json`: ``` { "meshName": "app1", "spec": { "provider": { "virtualRouter": { "virtualRouterName": "vrServiceA" } } }, "virtualServiceName": "serviceA.svc.cluster.local" } ``` Ausgabe: ``` { "virtualService": { "meshName": "app1", "metadata": { "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualService/serviceA.svc.cluster.local", "createdAt": 1563810859.474, "lastUpdatedAt": 1563820257.411, "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "version": 3 }, "spec": { "provider": { "virtualRouter": { "virtualRouterName": "vrServiceA" } } }, "status": { "status": "ACTIVE" }, "virtualServiceName": "serviceA.svc.cluster.local" } } ``` Weitere Informationen finden Sie unter [Virtuelle Services](https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_services.html) im * Benutzerhandbuch für AWS App Mesh*. + Einzelheiten zur API finden Sie [UpdateVirtualService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appmesh/update-virtual-service.html)in der *AWS CLI Befehlsreferenz*. # App Runner-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit App Runner Aktionen ausführen und gängige Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-custom-domain` Das folgende Codebeispiel zeigt, wie Sie`associate-custom-domain`. **AWS CLI** **So weisen Sie einem Service einen Domainnamen und die www-Subdomain zu** Im folgenden Beispiel für `associate-custom-domain` wird ein benutzerdefinierter Domainname, den Sie steuern, einem App-Runner-Service zugeordnet. Der Domainname ist die Stammdomain `example.com`, einschließlich der Subdomain für Sonderfälle `www.example.com`. ``` aws apprunner associate-custom-domain \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "DomainName": "example.com", "EnableWWWSubdomain": true } ``` Ausgabe: ``` { "CustomDomain": { "CertificateValidationRecords": [ { "Name": "_70d3f50a94f7c72dc28784cf55db2f6b.example.com", "Status": "PENDING_VALIDATION", "Type": "CNAME", "Value": "_1270c137383c6307b6832db02504c4b0.bsgbmzkfwj.acm-validations.aws." }, { "Name": "_287870d3f50a94f7c72dc4cf55db2f6b.www.example.com", "Status": "PENDING_VALIDATION", "Type": "CNAME", "Value": "_832db01270c137383c6307b62504c4b0.mzkbsgbfwj.acm-validations.aws." } ], "DomainName": "example.com", "EnableWWWSubdomain": true, "Status": "CREATING" }, "DNSTarget": "psbqam834h.us-east-1.awsapprunner.com", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` + Einzelheiten zur API finden Sie [AssociateCustomDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/associate-custom-domain.html)in der *AWS CLI Befehlsreferenz*. ### `create-auto-scaling-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-auto-scaling-configuration`. **AWS CLI** **So erstellen Sie eine Auto-Scaling-Konfiguration mit hoher Verfügbarkeit** Im folgenden Beispiel für `create-auto-scaling-configuration` wird eine für hohe Verfügbarkeit optimierte Auto-Scaling-Konfiguration erstellt, indem der Wert `MinSize` auf 5 gesetzt wird. Mit dieser Konfiguration versucht App Runner, Ihre Serviceinstanzen auf möglichst viele Availability Zones zu verteilen, je nach AWS Region bis zu fünf. Der Aufruf gibt ein `AutoScalingConfiguration`-Objekt zurück, bei dem die anderen Einstellungen auf die Standardwerte festgelegt sind. In diesem Beispiel ist dies der erste Aufruf zur Erstellung einer Konfiguration mit dem Namen `high-availability`. Die Revision ist auf 1 gesetzt und es ist die neueste Revision. ``` aws apprunner create-auto-scaling-configuration \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "AutoScalingConfigurationName": "high-availability", "MinSize": 5 } ``` Ausgabe: ``` { "AutoScalingConfiguration": { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1/2f50e7656d7819fead0f59672e68042e", "AutoScalingConfigurationName": "high-availability", "AutoScalingConfigurationRevision": 1, "CreatedAt": "2020-11-03T00:29:17Z", "Latest": true, "Status": "ACTIVE", "MaxConcurrency": 100, "MaxSize": 50, "MinSize": 5 } } ``` + Einzelheiten zur API finden Sie [CreateAutoScalingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/create-auto-scaling-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `create-connection` Das folgende Codebeispiel zeigt die Verwendung`create-connection`. **AWS CLI** **Um eine GitHub Verbindung herzustellen** Das folgende `create-connection` Beispiel stellt eine Verbindung zu einem privaten GitHub Code-Repository her. Der Verbindungsstatus nach einem erfolgreichen Anruf lautet `PENDING_HANDSHAKE`. Dies liegt daran, dass ein Authentifizierungs-Handshake mit dem Anbieter immer noch nicht stattgefunden hat. Schließen Sie den Handshake mit der App-Runner-Konsole ab. ``` aws apprunner create-connection \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ConnectionName": "my-github-connection", "ProviderType": "GITHUB" } ``` Ausgabe: ``` { "Connection": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection", "ConnectionName": "my-github-connection", "Status": "PENDING_HANDSHAKE", "CreatedAt": "2020-11-03T00:32:51Z", "ProviderType": "GITHUB" } } ``` Weitere Informationen finden Sie unter [Verwalten von App-Runner-Verbindungen](https://docs.aws.amazon.com/apprunner/latest/dg/manage-connections.html) im *Entwicklerhandbuch für AWS App Runner*. + Einzelheiten zur API finden Sie [CreateConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/create-connection.html)in der *AWS CLI Befehlsreferenz*. ### `create-service` Das folgende Codebeispiel zeigt die Verwendung`create-service`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Quellcode-Repository-Service** Im folgenden Beispiel für `create-service` wird ein App-Runner-Service auf der Grundlage eines Python-Quellcode-Repositorys erstellt. ``` aws apprunner create-service \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceName": "python-app", "SourceConfiguration": { "AuthenticationConfiguration": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e" }, "AutoDeploymentsEnabled": true, "CodeRepository": { "RepositoryUrl": "https://github.com/my-account/python-hello", "SourceCodeVersion": { "Type": "BRANCH", "Value": "main" }, "CodeConfiguration": { "ConfigurationSource": "API", "CodeConfigurationValues": { "Runtime": "PYTHON_3", "BuildCommand": "pip install -r requirements.txt", "StartCommand": "python server.py", "Port": "8080", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ] } } } }, "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } ``` Ausgabe: ``` { "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf", "Service": { "CreatedAt": "2020-11-20T19:05:25Z", "UpdatedAt": "2020-11-20T19:05:25Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa", "ServiceName": "python-app", "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com", "SourceConfiguration": { "AuthenticationConfiguration": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e" }, "AutoDeploymentsEnabled": true, "CodeRepository": { "CodeConfiguration": { "CodeConfigurationValues": { "BuildCommand": "pip install -r requirements.txt", "Port": "8080", "Runtime": "PYTHON_3", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ], "StartCommand": "python server.py" }, "ConfigurationSource": "Api" }, "RepositoryUrl": "https://github.com/my-account/python-hello", "SourceCodeVersion": { "Type": "BRANCH", "Value": "main" } } }, "Status": "OPERATION_IN_PROGRESS", "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } } ``` **Beispiel 2: So erstellen Sie einen Quellcode-Repository-Service** Im folgenden Beispiel für `create-service` wird ein App-Runner-Service auf der Grundlage eines Python-Quellcode-Repositorys erstellt. ``` aws apprunner create-service \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceName": "python-app", "SourceConfiguration": { "AuthenticationConfiguration": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e" }, "AutoDeploymentsEnabled": true, "CodeRepository": { "RepositoryUrl": "https://github.com/my-account/python-hello", "SourceCodeVersion": { "Type": "BRANCH", "Value": "main" }, "CodeConfiguration": { "ConfigurationSource": "API", "CodeConfigurationValues": { "Runtime": "PYTHON_3", "BuildCommand": "pip install -r requirements.txt", "StartCommand": "python server.py", "Port": "8080", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ] } } } }, "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } ``` Ausgabe: ``` { "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf", "Service": { "CreatedAt": "2020-11-20T19:05:25Z", "UpdatedAt": "2020-11-20T19:05:25Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa", "ServiceName": "python-app", "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com", "SourceConfiguration": { "AuthenticationConfiguration": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e" }, "AutoDeploymentsEnabled": true, "CodeRepository": { "CodeConfiguration": { "CodeConfigurationValues": { "BuildCommand": "pip install -r requirements.txt", "Port": "8080", "Runtime": "PYTHON_3", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ], "StartCommand": "python server.py" }, "ConfigurationSource": "Api" }, "RepositoryUrl": "https://github.com/my-account/python-hello", "SourceCodeVersion": { "Type": "BRANCH", "Value": "main" } } }, "Status": "OPERATION_IN_PROGRESS", "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } } ``` **Beispiel 3: So erstellen Sie einen Quell-Image-Repository-Service** Im folgenden Beispiel für `create-service` wird ein App-Runner-Service auf der Grundlage eines in Elastic Container Registry (ECR) gespeicherten Images erstellt. ``` aws apprunner create-service \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceName": "golang-container-app", "SourceConfiguration": { "AuthenticationConfiguration": { "AccessRoleArn": "arn:aws:iam::123456789012:role/my-ecr-role" }, "AutoDeploymentsEnabled": true, "ImageRepository": { "ImageIdentifier": "123456789012.dkr.ecr.us-east-1.amazonaws.com/golang-app:latest", "ImageConfiguration": { "Port": "8080", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ] }, "ImageRepositoryType": "ECR" } }, "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } ``` Ausgabe: ``` { "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf", "Service": { "CreatedAt": "2020-11-06T23:15:30Z", "UpdatedAt": "2020-11-06T23:15:30Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/golang-container-app/51728f8a20ce46d39b25398a6c8e9d1a", "ServiceId": "51728f8a20ce46d39b25398a6c8e9d1a", "ServiceName": "golang-container-app", "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com", "SourceConfiguration": { "AuthenticationConfiguration": { "AccessRoleArn": "arn:aws:iam::123456789012:role/my-ecr-role" }, "AutoDeploymentsEnabled": true, "ImageRepository": { "ImageIdentifier": "123456789012.dkr.ecr.us-east-1.amazonaws.com/golang-app:latest", "ImageConfiguration": { "Port": "8080", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ] }, "ImageRepositoryType": "ECR" } }, "Status": "OPERATION_IN_PROGRESS", "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } } ``` + Einzelheiten zur API finden Sie [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/create-service.html)in der *AWS CLI Befehlsreferenz*. ### `delete-auto-scaling-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-auto-scaling-configuration`. **AWS CLI** **Beispiel 1: So löschen Sie die letzte aktive Revision einer Auto-Scaling-Konfiguration** Im folgenden Beispiel für `delete-auto-scaling-configuration` wird die letzte aktive Revision einer Auto-Scaling-Konfiguration für App Runner gelöscht. Um die letzte aktive Revision zu löschen, geben Sie einen Amazon-Ressourcennamen (ARN) an, der mit dem Konfigurationsnamen endet, ohne die Revisionskomponente. In diesem Beispiel sind vor dieser Aktion zwei Revisionen vorhanden. Daher wird Revision 2 (die neueste) gelöscht. Jetzt wird jedoch `"Latest": false` angezeigt, da es sich nach dem Löschen nicht mehr um die letzte aktive Revision handelt. ``` aws apprunner delete-auto-scaling-configuration \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability" } ``` Ausgabe: ``` { "AutoScalingConfiguration": { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/2/e76562f50d78042e819fead0f59672e6", "AutoScalingConfigurationName": "high-availability", "AutoScalingConfigurationRevision": 2, "CreatedAt": "2021-02-25T17:42:59Z", "DeletedAt": "2021-03-02T08:07:06Z", "Latest": false, "Status": "INACTIVE", "MaxConcurrency": 30, "MaxSize": 90, "MinSize": 5 } } ``` **Beispiel 2: So löschen Sie eine bestimmte Revision einer Auto-Scaling-Konfiguration** Im folgenden Beispiel für `delete-auto-scaling-configuration` wird eine bestimmte Revision einer Auto-Scaling-Konfiguration für App Runner gelöscht. Um eine bestimmte Revision zu löschen, geben Sie einen ARN an, der die Revisionsnummer enthält. In diesem Beispiel sind vor dieser Aktion zwei Revisionen vorhanden. Die Aktion löscht die Revision `1`. ``` aws apprunner delete-auto-scaling-configuration \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1" } ``` Ausgabe: ``` { "AutoScalingConfiguration": { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1/2f50e7656d7819fead0f59672e68042e", "AutoScalingConfigurationName": "high-availability", "AutoScalingConfigurationRevision": 1, "CreatedAt": "2020-11-03T00:29:17Z", "DeletedAt": "2021-03-02T08:07:06Z", "Latest": false, "Status": "INACTIVE", "MaxConcurrency": 100, "MaxSize": 50, "MinSize": 5 } } ``` + Einzelheiten zur API finden Sie [DeleteAutoScalingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/delete-auto-scaling-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-connection` Das folgende Codebeispiel zeigt die Verwendung`delete-connection`. **AWS CLI** **So löschen Sie eine Verbindung** Im folgenden Beispiel für `delete-connection` wird eine App-Runner-Verbindung gelöscht. Der Verbindungsstatus nach einem erfolgreichen Anruf lautet `DELETED`. Das liegt daran, dass die Verbindung nicht mehr verfügbar ist. ``` aws apprunner delete-connection \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection" } ``` Ausgabe: ``` { "Connection": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection", "ConnectionName": "my-github-connection", "Status": "DELETED", "CreatedAt": "2020-11-03T00:32:51Z", "ProviderType": "GITHUB" } } ``` + Einzelheiten zur API finden Sie [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/delete-connection.html)in der *AWS CLI Befehlsreferenz*. ### `delete-service` Das folgende Codebeispiel zeigt die Verwendung`delete-service`. **AWS CLI** **So löschen Sie einen Service** Im folgenden Beispiel für `delete-service` wird ein App-Runner-Service gelöscht. ``` aws apprunner delete-service \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` Ausgabe: ``` { "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf", "Service": { "CreatedAt": "2020-11-20T19:05:25Z", "UpdatedAt": "2020-11-20T19:05:25Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa", "ServiceName": "python-app", "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com", "SourceConfiguration": { "AuthenticationConfiguration": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e" }, "AutoDeploymentsEnabled": true, "CodeRepository": { "CodeConfiguration": { "CodeConfigurationValues": { "BuildCommand": "pip install -r requirements.txt", "Port": "8080", "Runtime": "PYTHON_3", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ], "StartCommand": "python server.py" }, "ConfigurationSource": "Api" }, "RepositoryUrl": "https://github.com/my-account/python-hello", "SourceCodeVersion": { "Type": "BRANCH", "Value": "main" } } }, "Status": "OPERATION_IN_PROGRESS", "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } } ``` + Einzelheiten zur API finden Sie [DeleteService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/delete-service.html)in der *AWS CLI Befehlsreferenz*. ### `describe-auto-scaling-configuration` Das folgende Codebeispiel zeigt die Verwendung`describe-auto-scaling-configuration`. **AWS CLI** **Beispiel 1: So beschreiben Sie die letzte aktive Revision einer Auto-Scaling-Konfiguration** Im folgenden Beispiel für `describe-auto-scaling-configuration` wird eine Beschreibung der letzten aktiven Revision einer Auto-Scaling-Konfiguration für App Runner abgerufen. Um die letzte aktive Revision zu beschreiben, geben Sie einen ARN an, der mit dem Konfigurationsnamen endet, ohne die Revisionskomponente. In dem Beispiel sind zwei Revisionen vorhanden. Daher wird Revision `2` (die neueste) beschrieben. Das resultierende Objekt zeigt `"Latest": true` an. ``` aws apprunner describe-auto-scaling-configuration \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability" } ``` Ausgabe: ``` { "AutoScalingConfiguration": { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/2/e76562f50d78042e819fead0f59672e6", "AutoScalingConfigurationName": "high-availability", "AutoScalingConfigurationRevision": 2, "CreatedAt": "2021-02-25T17:42:59Z", "Latest": true, "Status": "ACTIVE", "MaxConcurrency": 30, "MaxSize": 90, "MinSize": 5 } } ``` **Beispiel 2: So beschreiben Sie eine bestimmte Revision einer Auto-Scaling-Konfiguration** Im folgenden Beispiel für `describe-auto-scaling-configuration` wird eine Beschreibung einer bestimmten Revision einer Auto-Scaling-Konfiguration für App Runner abgerufen. Um eine bestimmte Revision zu beschreiben, geben Sie einen ARN an, der die Revisionsnummer enthält. In dem Beispiel existieren mehrere Revisionen und die Revision `1` wird abgefragt. Das resultierende Objekt zeigt `"Latest": false` an. ``` aws apprunner describe-auto-scaling-configuration \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1" } ``` Ausgabe: ``` { "AutoScalingConfiguration": { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1/2f50e7656d7819fead0f59672e68042e", "AutoScalingConfigurationName": "high-availability", "AutoScalingConfigurationRevision": 1, "CreatedAt": "2020-11-03T00:29:17Z", "Latest": false, "Status": "ACTIVE", "MaxConcurrency": 100, "MaxSize": 50, "MinSize": 5 } } ``` + Einzelheiten zur API finden Sie [DescribeAutoScalingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/describe-auto-scaling-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `describe-custom-domains` Das folgende Codebeispiel zeigt die Verwendung`describe-custom-domains`. **AWS CLI** **So rufen Sie Beschreibungen von benutzerdefinierten Domainnamen ab, die einem Service zugeordnet sind** Im folgenden Beispiel für `describe-custom-domains` werden Beschreibungen und der Status der benutzerdefinierten Domainnamen abgerufen, die einem App-Runner-Service zugeordnet sind. ``` aws apprunner describe-custom-domains \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "DomainName": "example.com", "EnableWWWSubdomain": true } ``` Ausgabe: ``` { "CustomDomains": [ { "CertificateValidationRecords": [ { "Name": "_70d3f50a94f7c72dc28784cf55db2f6b.example.com", "Status": "PENDING_VALIDATION", "Type": "CNAME", "Value": "_1270c137383c6307b6832db02504c4b0.bsgbmzkfwj.acm-validations.aws." }, { "Name": "_287870d3f50a94f7c72dc4cf55db2f6b.www.example.com", "Status": "PENDING_VALIDATION", "Type": "CNAME", "Value": "_832db01270c137383c6307b62504c4b0.mzkbsgbfwj.acm-validations.aws." } ], "DomainName": "example.com", "EnableWWWSubdomain": true, "Status": "PENDING_CERTIFICATE_DNS_VALIDATION" }, { "CertificateValidationRecords": [ { "Name": "_a94f784c70d3f507c72dc28f55db2f6b.deals.example.com", "Status": "SUCCESS", "Type": "CNAME", "Value": "_2db02504c1270c137383c6307b6834b0.bsgbmzkfwj.acm-validations.aws." } ], "DomainName": "deals.example.com", "EnableWWWSubdomain": false, "Status": "ACTIVE" } ], "DNSTarget": "psbqam834h.us-east-1.awsapprunner.com", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` + Einzelheiten zur API finden Sie [DescribeCustomDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/describe-custom-domains.html)in der *AWS CLI Befehlsreferenz*. ### `describe-service` Das folgende Codebeispiel zeigt die Verwendung`describe-service`. **AWS CLI** **So beschreiben Sie einen Service** Im folgenden Beispiel für `describe-service` wird eine Beschreibung eines App-Runner-Service abgerufen. ``` aws apprunner describe-service \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` Ausgabe: ``` { "Service": { "CreatedAt": "2020-11-20T19:05:25Z", "UpdatedAt": "2020-11-20T19:05:25Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa", "ServiceName": "python-app", "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com", "SourceConfiguration": { "AuthenticationConfiguration": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e" }, "AutoDeploymentsEnabled": true, "CodeRepository": { "CodeConfiguration": { "CodeConfigurationValues": { "BuildCommand": "pip install -r requirements.txt", "Port": "8080", "Runtime": "PYTHON_3", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ], "StartCommand": "python server.py" }, "ConfigurationSource": "Api" }, "RepositoryUrl": "https://github.com/my-account/python-hello", "SourceCodeVersion": { "Type": "BRANCH", "Value": "main" } } }, "Status": "RUNNING", "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } } ``` + Einzelheiten zur API finden Sie [DescribeService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/describe-service.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-custom-domain` Das folgende Codebeispiel zeigt die Verwendung`disassociate-custom-domain`. **AWS CLI** **So heben Sie die Zuordnung eines Domainnamens zu einem Service auf** Im folgenden Beispiel für `disassociate-custom-domain` wird die Zuordnung der Domain `example.com` zu einem App-Runner-Service aufgehoben. Durch den Aufruf wird auch die Zuordnung der Subdomain `www.example.com` aufgehoben, die zusammen mit der Stammdomain zugeordnet war. ``` aws apprunner disassociate-custom-domain \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "DomainName": "example.com" } ``` Ausgabe: ``` { "CustomDomain": { "CertificateValidationRecords": [ { "Name": "_70d3f50a94f7c72dc28784cf55db2f6b.example.com", "Status": "PENDING_VALIDATION", "Type": "CNAME", "Value": "_1270c137383c6307b6832db02504c4b0.bsgbmzkfwj.acm-validations.aws." }, { "Name": "_287870d3f50a94f7c72dc4cf55db2f6b.www.example.com", "Status": "PENDING_VALIDATION", "Type": "CNAME", "Value": "_832db01270c137383c6307b62504c4b0.mzkbsgbfwj.acm-validations.aws." } ], "DomainName": "example.com", "EnableWWWSubdomain": true, "Status": "DELETING" }, "DNSTarget": "psbqam834h.us-east-1.awsapprunner.com", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` + Einzelheiten zur API finden Sie [DisassociateCustomDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/disassociate-custom-domain.html)in der *AWS CLI Befehlsreferenz*. ### `list-auto-scaling-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-auto-scaling-configurations`. **AWS CLI** **So rufen Sie eine paginierte Liste der Auto-Scaling-Konfigurationen von App Runner ab** Das folgende `list-auto-scaling-configurations` Beispiel listet alle App Runner Auto Scaling-Konfigurationen in Ihrem AWS Konto auf. In jeder Antwort sind bis zu fünf Auto-Scaling-Konfigurationen aufgelistet. `AutoScalingConfigurationName` und `LatestOnly` sind nicht angegeben. Ihre Standardeinstellungen führen dazu, dass die neueste Version aller aktiven Konfigurationen aufgelistet wird. In diesem Beispiel enthält die Antwort zwei Ergebnisse und es gibt keine weiteren, sodass kein `NextToken` zurückgegeben wird. ``` aws apprunner list-auto-scaling-configurations \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "MaxResults": 5 } ``` Ausgabe: ``` { "AutoScalingConfigurationSummaryList": [ { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/2/e76562f50d78042e819fead0f59672e6", "AutoScalingConfigurationName": "high-availability", "AutoScalingConfigurationRevision": 2 }, { "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/low-cost/1/50d7804e7656fead0f59672e62f2e819", "AutoScalingConfigurationName": "low-cost", "AutoScalingConfigurationRevision": 1 } ] } ``` + Einzelheiten zur API finden Sie [ListAutoScalingConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-auto-scaling-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `list-connections` Das folgende Codebeispiel zeigt die Verwendung`list-connections`. **AWS CLI** **Beispiel 1: So listen Sie alle Verbindungen auf** Das folgende `list-connections` Beispiel listet alle App Runner-Verbindungen im AWS Konto auf. ``` aws apprunner list-connections ``` Ausgabe: ``` { "ConnectionSummaryList": [ { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection", "ConnectionName": "my-github-connection", "Status": "AVAILABLE", "CreatedAt": "2020-11-03T00:32:51Z", "ProviderType": "GITHUB" }, { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-org-connection", "ConnectionName": "my-github-org-connection", "Status": "AVAILABLE", "CreatedAt": "2020-11-03T02:54:17Z", "ProviderType": "GITHUB" } ] } ``` **Beispiel 2: So listen Sie eine Verbindung nach Namen auf** Im folgenden Beispiel für `list-connections` wird eine Verbindung nach ihrem Namen aufgelistet. ``` aws apprunner list-connections \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ConnectionName": "my-github-org-connection" } ``` Ausgabe: ``` { "ConnectionSummaryList": [ { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-org-connection", "ConnectionName": "my-github-org-connection", "Status": "AVAILABLE", "CreatedAt": "2020-11-03T02:54:17Z", "ProviderType": "GITHUB" } ] } ``` + Einzelheiten zur API finden Sie [ListConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-connections.html)in der *AWS CLI Befehlsreferenz*. ### `list-operations` Das folgende Codebeispiel zeigt die Verwendung`list-operations`. **AWS CLI** **So listen Sie Operationen auf, die in einem Service ausgeführt wurden** Im folgenden Beispiel für `list-operations` werden alle Operationen aufgelistet, die bisher in einem App-Runner-Service ausgeführt wurden. In diesem Beispiel ist der Service neu und es wurde nur eine einzige Operation des Typs `CREATE_SERVICE` ausgeführt. ``` aws apprunner list-operations \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` Ausgabe: ``` { "OperationSummaryList": [ { "EndedAt": 1606156217, "Id": "17fe9f55-7e91-4097-b243-fcabbb69a4cf", "StartedAt": 1606156014, "Status": "SUCCEEDED", "TargetArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "Type": "CREATE_SERVICE", "UpdatedAt": 1606156217 } ] } ``` + Einzelheiten zur API finden Sie [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-operations.html)in der *AWS CLI Befehlsreferenz*. ### `list-services` Das folgende Codebeispiel zeigt die Verwendung`list-services`. **AWS CLI** **So rufen Sie eine paginierte Liste der App-Runner-Services ab** Das folgende `list-services` Beispiel listet alle App Runner-Dienste im AWS Konto auf. In jeder Antwort sind bis zu zwei Services aufgeführt. Dieses Beispiel zeigt die erste Anforderung. Die Antwort enthält zwei Ergebnisse und ein Token, das in der nächsten Anforderung verwendet werden kann. Wenn eine nachfolgende Antwort kein Token enthält, wurden alle Services aufgelistet. ``` aws apprunner list-services \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "MaxResults": 2 } ``` Ausgabe: ``` { "NextToken": "eyJDdXN0b21lckFjY291bnRJZCI6IjI3MDIwNTQwMjg0NSIsIlNlcnZpY2VTdGF0dXNDb2RlIjoiUFJPVklTSU9OSU5HIiwiSGFzaEtleSI6IjI3MDIwNTQwMjg0NSNhYjhmOTRjZmUyOWE0NjBmYjg3NjBhZmQyZWU4NzU1NSJ9", "ServiceSummaryList": [ { "CreatedAt": "2020-11-20T19:05:25Z", "UpdatedAt": "2020-11-23T12:41:37Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa", "ServiceName": "python-app", "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com", "Status": "RUNNING" }, { "CreatedAt": "2020-11-06T23:15:30Z", "UpdatedAt": "2020-11-23T13:21:22Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/golang-container-app/ab8f94cfe29a460fb8760afd2ee87555", "ServiceId": "ab8f94cfe29a460fb8760afd2ee87555", "ServiceName": "golang-container-app", "ServiceUrl": "e2m8rrrx33.us-east-1.awsapprunner.com", "Status": "RUNNING" } ] } ``` + Einzelheiten zur API finden Sie [ListServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-services.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags auf, die einem App-Runner-Service zugeordnet sind** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags aufgelistet, die einem App-Runner-Service zugeordnet sind. ``` aws apprunner list-tags-for-resource \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ResourceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` Ausgabe: ``` { "Tags": [ { "Key": "Department", "Value": "Retail" }, { "Key": "CustomerId", "Value": "56439872357912" } ] } ``` + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `pause-service` Das folgende Codebeispiel zeigt die Verwendung`pause-service`. **AWS CLI** **So halten Sie einen Service an** Im folgenden Beispiel für `pause-service` wird ein App-Runner-Service angehalten. ``` aws apprunner pause-service \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` Ausgabe: ``` { "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf", "Service": { "CreatedAt": "2020-11-20T19:05:25Z", "UpdatedAt": "2020-11-23T12:41:37Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa", "ServiceName": "python-app", "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com", "SourceConfiguration": { "AuthenticationConfiguration": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e" }, "AutoDeploymentsEnabled": true, "CodeRepository": { "CodeConfiguration": { "CodeConfigurationValues": { "BuildCommand": "pip install -r requirements.txt", "Port": "8080", "Runtime": "PYTHON_3", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ], "StartCommand": "python server.py" }, "ConfigurationSource": "Api" }, "RepositoryUrl": "https://github.com/my-account/python-hello", "SourceCodeVersion": { "Type": "BRANCH", "Value": "main" } } }, "Status": "OPERATION_IN_PROGRESS", "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } } ``` + Einzelheiten zur API finden Sie [PauseService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/pause-service.html)in der *AWS CLI Befehlsreferenz*. ### `resume-service` Das folgende Codebeispiel zeigt die Verwendung`resume-service`. **AWS CLI** **So nehmen Sie einen Service wieder auf** Im folgenden Beispiel für `resume-service` wird ein App-Runner-Service wieder aufgenommen. ``` aws apprunner resume-service \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` Ausgabe: ``` { "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf", "Service": { "CreatedAt": "2020-11-20T19:05:25Z", "UpdatedAt": "2020-11-23T12:41:37Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa", "ServiceName": "python-app", "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com", "SourceConfiguration": { "AuthenticationConfiguration": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e" }, "AutoDeploymentsEnabled": true, "CodeRepository": { "CodeConfiguration": { "CodeConfigurationValues": { "BuildCommand": "pip install -r requirements.txt", "Port": "8080", "Runtime": "PYTHON_3", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ], "StartCommand": "python server.py" }, "ConfigurationSource": "Api" }, "RepositoryUrl": "https://github.com/my-account/python-hello", "SourceCodeVersion": { "Type": "BRANCH", "Value": "main" } } }, "Status": "OPERATION_IN_PROGRESS", "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "3 GB" } } } ``` + Einzelheiten zur API finden Sie [ResumeService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/resume-service.html)in der *AWS CLI Befehlsreferenz*. ### `start-deployment` Das folgende Codebeispiel zeigt die Verwendung`start-deployment`. **AWS CLI** **So initiieren Sie eine manuelle Bereitstellung** Im folgenden Beispiel für `start-deployment` wird eine manuelle Bereitstellung für einen App-Runner-Service durchgeführt. ``` aws apprunner start-deployment \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa" } ``` Ausgabe: ``` { "OperationId": "853a7d5b-fc9f-4730-831b-fd8037ab832a" } ``` + Einzelheiten zur API finden Sie [StartDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/start-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einem App-Runner-Service Tags hinzu** Im folgenden Beispiel für `tag-resource` werden einem App-Runner-Service zwei Tag hinzugefügt. ``` aws apprunner tag-resource \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ResourceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "Tags": [ { "Key": "Department", "Value": "Retail" }, { "Key": "CustomerId", "Value": "56439872357912" } ] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einem App-Runner-Service** Im folgenden Beispiel für `untag-resource` werden zwei Tags aus einem App-Runner-Service entfernt. ``` aws apprunner untag-resource \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ResourceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "TagKeys": [ "Department", "CustomerId" ] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-service` Das folgende Codebeispiel zeigt die Verwendung`update-service`. **AWS CLI** **So aktualisieren Sie die Speichergröße** Im folgenden Beispiel für `update-service` wird die Speichergröße von Instances (Skalierungseinheiten) eines App-Runner-Service auf 2 048 MiB aktualisiert. Wenn der Aufruf erfolgreich ist, startet App Runner einen asynchronen Aktualisierungsprozess. Die `Service`-Struktur, die durch den Aufruf zurückgegeben wird, spiegelt den neuen Speicherwert wider, der durch diesen Aufruf angewendet wird. ``` aws apprunner update-service \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "InstanceConfiguration": { "Memory": "4 GB" } } ``` Ausgabe: ``` { "OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf", "Service": { "CreatedAt": "2020-11-20T19:05:25Z", "UpdatedAt": "2020-11-23T12:41:37Z", "ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa", "ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa", "ServiceName": "python-app", "ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com", "SourceConfiguration": { "AuthenticationConfiguration": { "ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e" }, "AutoDeploymentsEnabled": true, "CodeRepository": { "CodeConfiguration": { "CodeConfigurationValues": { "BuildCommand": "pip install -r requirements.txt", "Port": "8080", "Runtime": "PYTHON_3", "RuntimeEnvironmentVariables": [ { "NAME": "Jane" } ], "StartCommand": "python server.py" }, "ConfigurationSource": "Api" }, "RepositoryUrl": "https://github.com/my-account/python-hello", "SourceCodeVersion": { "Type": "BRANCH", "Value": "main" } } }, "Status": "OPERATION_IN_PROGRESS", "InstanceConfiguration": { "CPU": "1 vCPU", "Memory": "4 GB" } } } ``` + Einzelheiten zur API finden Sie [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/update-service.html)in der *AWS CLI Befehlsreferenz*. # AWS AppConfig Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS AppConfig. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-application` Das folgende Codebeispiel zeigt, wie Sie`create-application`. **AWS CLI** **So erstellen Sie eine Anwendung** Das folgende `create-application` Beispiel erstellt eine Anwendung in AWS AppConfig. ``` aws appconfig create-application \ --name "example-application" \ --description "An application used for creating an example." ``` Ausgabe: ``` { "Description": "An application used for creating an example.", "Id": "339ohji", "Name": "example-application" } ``` Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer AWS AppConfig Anwendung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-application.html)unter *AWS CLI Befehlsreferenz*. ### `create-configuration-profile` Das folgende Codebeispiel zeigt die Verwendung`create-configuration-profile`. **AWS CLI** **Um ein Konfigurationsprofil zu erstellen** Im folgenden Beispiel für `create-configuration-profile` wird ein Konfigurationsprofil mithilfe einer Konfiguration erstellt, die in Parameter Store, einer Funktion von Systems Manager, gespeichert ist. ``` aws appconfig create-configuration-profile \ --application-id "339ohji" \ --name "Example-Configuration-Profile" \ --location-uri "ssm-parameter://Example-Parameter" \ --retrieval-role-arn "arn:aws:iam::111122223333:role/Example-App-Config-Role" ``` Ausgabe: ``` { "ApplicationId": "339ohji", "Description": null, "Id": "ur8hx2f", "LocationUri": "ssm-parameter://Example-Parameter", "Name": "Example-Configuration-Profile", "RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role", "Type": null, "Validators": null } ``` Weitere Informationen finden Sie unter [Schritt 3: Konfiguration und Konfigurationsprofil erstellen](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateConfigurationProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-configuration-profile.html)unter *AWS CLI Befehlsreferenz*. ### `create-environment` Das folgende Codebeispiel zeigt die Verwendung`create-environment`. **AWS CLI** **So erstellen Sie eine Umgebung** Im folgenden `create-environment` Beispiel wird mithilfe der Anwendung, die Sie mit create-application erstellt haben, eine AWS AppConfig Umgebung mit dem Namen Example-Environment erstellt. ``` aws appconfig create-environment \ --application-id "339ohji" \ --name "Example-Environment" ``` Ausgabe: ``` { "ApplicationId": "339ohji", "Description": null, "Id": "54j1r29", "Monitors": null, "Name": "Example-Environment", "State": "ReadyForDeployment" } ``` *Weitere Informationen finden Sie unter [Schritt 2: Erstellen einer Umgebung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) im Benutzerhandbuch.AWS AppConfig * + Einzelheiten zur API finden Sie [CreateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-environment.html)unter *AWS CLI Befehlsreferenz*. ### `create-extension-association` Das folgende Codebeispiel zeigt die Verwendung`create-extension-association`. **AWS CLI** **So erstellen Sie eine Erweiterungszuordnung** Im folgenden `create-extension-association` Beispiel wird eine neue Erweiterungszuordnung in erstellt AWS AppConfig. ``` aws appconfig create-extension-association \ --region us-west-2 \ --extension-identifier S3-backup-extension \ --resource-identifier "arn:aws:appconfig:us-west-2:123456789012:application/Finance" \ --parameters S3bucket=FinanceConfigurationBackup ``` Ausgabe: ``` { "Id": "a1b2c3d4", "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1", "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance", "Parameters": { "S3bucket": "FinanceConfigurationBackup" }, "ExtensionVersionNumber": 1 } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [CreateExtensionAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-extension-association.html)unter *AWS CLI Befehlsreferenz*. ### `create-extension` Das folgende Codebeispiel zeigt die Verwendung`create-extension`. **AWS CLI** **So erstellen Sie eine Erweiterung** Das folgende `create-extension` Beispiel erstellt eine neue Erweiterung in AWS AppConfig. ``` aws appconfig create-extension \ --region us-west-2 \ --name S3-backup-extension \ --actions PRE_CREATE_HOSTED_CONFIGURATION_VERSION=[{Name=S3backup,Uri=arn:aws:lambda:us-west-2:123456789012:function:s3backupfunction,RoleArn=arn:aws:iam::123456789012:role/appconfigextensionrole}] \ --parameters S3bucket={Required=true} ``` Ausgabe: ``` { "Id": "1A2B3C4D", "Name": "S3-backup-extension", "VersionNumber": 1, "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/1A2B3C4D/1", "Actions": { "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [ { "Name": "S3backup", "Uri": "arn:aws:lambda:us-west-2:123456789012:function:s3backupfunction", "RoleArn": "arn:aws:iam::123456789012:role/appconfigextensionrole" } ] }, "Parameters": { "S3bucket": { "Required": true } } } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [CreateExtension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-extension.html)unter *AWS CLI Befehlsreferenz*. ### `create-hosted-configuration-version` Das folgende Codebeispiel zeigt die Verwendung`create-hosted-configuration-version`. **AWS CLI** **So erstellen Sie eine gehostete Konfigurationsversion** Im folgenden `create-hosted-configuration-version` Beispiel wird eine neue Konfiguration im AWS AppConfig gehosteten Konfigurationsspeicher erstellt. Der Konfigurationsinhalt muss zuerst in base64 konvertiert werden. ``` aws appconfig create-hosted-configuration-version \ --application-id "339ohji" \ --configuration-profile-id "ur8hx2f" \ --content eyAiTmFtZSI6ICJFeGFtcGxlQXBwbGljYXRpb24iLCAiSWQiOiBFeGFtcGxlSUQsICJSYW5rIjogNyB9 \ --content-type "application/json" \ configuration_version_output_file ``` Inhalt von `configuration_version_output_file`: ``` { "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 } ``` Ausgabe: ``` { "ApplicationId": "339ohji", "ConfigurationProfileId": "ur8hx2f", "VersionNumber": "1", "ContentType": "application/json" } ``` Weitere Informationen finden Sie unter [Über den AWS AppConfig gehosteten Konfigurationsspeicher](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-about-hosted-store) im *AWS Appconfig-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateHostedConfigurationVersion AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-hosted-configuration-version.html)*Befehlsreferenz.* ### `delete-application` Das folgende Codebeispiel zeigt die Verwendung`delete-application`. **AWS CLI** **So löschen Sie eine Anwendung** Im folgenden Beispiel für `delete-application` wird die angegebene Anwendung gelöscht. ``` aws appconfig delete-application \ --application-id 339ohji ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer AWS AppConfig Anwendung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-application.html)unter *AWS CLI Befehlsreferenz*. ### `delete-configuration-profile` Das folgende Codebeispiel zeigt die Verwendung`delete-configuration-profile`. **AWS CLI** **So löschen Sie ein Konfigurationsprofil** Im folgenden Beispiel für `delete-configuration-profile` wird das angegebene Konfigurationsprofil gelöscht. ``` aws appconfig delete-configuration-profile \ --application-id 339ohji \ --configuration-profile-id ur8hx2f ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schritt 3: Konfiguration und Konfigurationsprofil erstellen](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteConfigurationProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-configuration-profile.html)unter *AWS CLI Befehlsreferenz*. ### `delete-deployment-strategy` Das folgende Codebeispiel zeigt die Verwendung`delete-deployment-strategy`. **AWS CLI** **So löschen Sie eine Bereitstellungsstrategie** Im folgenden Beispiel für `delete-deployment-strategy` wird die angegebene Bereitstellungsstrategie gelöscht. ``` aws appconfig delete-deployment-strategy \ --deployment-strategy-id 1225qzk ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schritt 4: Erstellen einer Bereitstellungsstrategie](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteDeploymentStrategy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-deployment-strategy.html)unter *AWS CLI Befehlsreferenz*. ### `delete-environment` Das folgende Codebeispiel zeigt die Verwendung`delete-environment`. **AWS CLI** **So löschen Sie eine Umgebung** Im folgenden Beispiel für `delete-environment` wird die angegebene Anwendungsumgebung gelöscht. ``` aws appconfig delete-environment \ --application-id 339ohji \ --environment-id 54j1r29 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schritt 2: Erstellen einer Umgebung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-environment.html)unter *AWS CLI Befehlsreferenz*. ### `delete-extension-association` Das folgende Codebeispiel zeigt die Verwendung`delete-extension-association`. **AWS CLI** **So löschen Sie eine Erweiterungszuordnung** Im folgenden `delete-extension-association` Beispiel wird eine Erweiterungsassoziation von AWS AppConfig gelöscht. ``` aws appconfig delete-extension-association \ --region us-west-2 \ --extension-association-id a1b2c3d4 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [DeleteExtensionAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-extension-association.html)unter *AWS CLI Befehlsreferenz*. ### `delete-extension` Das folgende Codebeispiel zeigt die Verwendung`delete-extension`. **AWS CLI** **So löschen Sie eine Erweiterung** Das folgende `delete-extension` Beispiel löscht eine Erweiterung von AWS AppConfig. ``` aws appconfig delete-extension \ --region us-west-2 \ --extension-identifier S3-backup-extension ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [DeleteExtension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-extension.html)unter *AWS CLI Befehlsreferenz*. ### `delete-hosted-configuration-version` Das folgende Codebeispiel zeigt die Verwendung`delete-hosted-configuration-version`. **AWS CLI** **So löschen Sie eine gehostete Konfigurationsversion** Im folgenden `delete-hosted-configuration-version` Beispiel wird eine Konfigurationsversion gelöscht, die im gehosteten Konfigurationsspeicher AWS AppConfig gehostet wird. ``` aws appconfig delete-hosted-configuration-version \ --application-id 339ohji \ --configuration-profile-id ur8hx2f \ --version-number 1 ``` Ausgabe: Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schritt 3: Konfiguration und Konfigurationsprofil erstellen](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteHostedConfigurationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-hosted-configuration-version.html)unter *AWS CLI Befehlsreferenz*. ### `get-application` Das folgende Codebeispiel zeigt die Verwendung`get-application`. **AWS CLI** **So listen Sie die Details einer Anwendung auf** Im folgenden Beispiel für `get-application` werden die Details der angegebenen Anwendung aufgelistet. ``` aws appconfig get-application \ --application-id 339ohji ``` Ausgabe: ``` { "Description": "An application used for creating an example.", "Id": "339ohji", "Name": "example-application" } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [So AWS AppConfig funktioniert](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html#learn-more-appconfig-how-it-works) es. + Einzelheiten zur API finden Sie [GetApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-application.html)in der *AWS CLI Befehlsreferenz*. ### `get-configuration-profile` Das folgende Codebeispiel zeigt die Verwendung`get-configuration-profile`. **AWS CLI** **So rufen Sie Details zum Konfigurationsprofil ab** Im folgenden Beispiel für `get-configuration-profile` werden die Details zum angegebenen Konfigurationsprofil zurückgegeben. ``` aws appconfig get-configuration-profile \ --application-id 339ohji \ --configuration-profile-id ur8hx2f ``` Ausgabe: ``` { "ApplicationId": "339ohji", "Id": "ur8hx2f", "Name": "Example-Configuration-Profile", "LocationUri": "ssm-parameter://Example-Parameter", "RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role" } ``` Weitere Informationen finden Sie unter [Schritt 3: Konfiguration und Konfigurationsprofil erstellen](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetConfigurationProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-configuration-profile.html)unter *AWS CLI Befehlsreferenz*. ### `get-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-configuration`. **AWS CLI** **So rufen Sie Konfigurationsdetails ab** Im folgenden Beispiel für `get-configuration` werden die Konfigurationsdetails der Beispielanwendung zurückgegeben. Verwenden Sie bei nachfolgenden Aufrufen von get-configuration den `client-configuration-version`-Parameter, um die Konfiguration Ihrer Anwendung nur zu aktualisieren, wenn sich die Version geändert hat. Wenn Sie die Konfiguration nur aktualisieren, wenn sich die Version geändert hat, werden zusätzliche Kosten vermieden, die durch den Aufruf von get-configuration entstehen. ``` aws appconfig get-configuration \ --application "example-application" \ --environment "Example-Environment" \ --configuration "Example-Configuration-Profile" \ --client-id "test-id" \ configuration-output-file ``` Inhalt von `configuration-output-file`: ``` { "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 } ``` Ausgabe: ``` { "ConfigurationVersion": "1", "ContentType": "application/json" } ``` Weitere Informationen finden Sie unter [Schritt 6: Empfangen der Konfiguration](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-retrieving-the-configuration.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-configuration.html)unter *AWS CLI Befehlsreferenz*. ### `get-deployment-strategy` Das folgende Codebeispiel zeigt die Verwendung`get-deployment-strategy`. **AWS CLI** **So rufen Sie Details einer Bereitstellungsstrategie ab** Im folgenden Beispiel für `get-deployment-strategy` werden die Details der angegebenen Bereitstellungsstrategie aufgelistet. ``` aws appconfig get-deployment-strategy \ --deployment-strategy-id 1225qzk ``` Ausgabe: ``` { "Id": "1225qzk", "Name": "Example-Deployment", "DeploymentDurationInMinutes": 15, "GrowthType": "LINEAR", "GrowthFactor": 25.0, "FinalBakeTimeInMinutes": 0, "ReplicateTo": "SSM_DOCUMENT" } ``` Weitere Informationen finden Sie unter [Schritt 4: Erstellen einer Bereitstellungsstrategie](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetDeploymentStrategy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-deployment-strategy.html)unter *AWS CLI Befehlsreferenz*. ### `get-deployment` Das folgende Codebeispiel zeigt die Verwendung`get-deployment`. **AWS CLI** **So rufen Sie Bereitstellungsdetails ab** Im folgenden Beispiel für `get-deployment` werden Details zur Bereitstellung für die Anwendung in der angegebenen Umgebung und Bereitstellung aufgelistet. ``` aws appconfig get-deployment \ --application-id 339ohji \ --environment-id 54j1r29 \ --deployment-number 1 ``` Ausgabe: ``` { "ApplicationId": "339ohji", "EnvironmentId": "54j1r29", "DeploymentStrategyId": "1225qzk", "ConfigurationProfileId": "ur8hx2f", "DeploymentNumber": 1, "ConfigurationName": "Example-Configuration-Profile", "ConfigurationLocationUri": "ssm-parameter://Example-Parameter", "ConfigurationVersion": "1", "DeploymentDurationInMinutes": 15, "GrowthType": "LINEAR", "GrowthFactor": 25.0, "FinalBakeTimeInMinutes": 0, "State": "COMPLETE", "EventLog": [ { "EventType": "DEPLOYMENT_COMPLETED", "TriggeredBy": "APPCONFIG", "Description": "Deployment completed", "OccurredAt": "2021-09-17T21:59:03.888000+00:00" }, { "EventType": "BAKE_TIME_STARTED", "TriggeredBy": "APPCONFIG", "Description": "Deployment bake time started", "OccurredAt": "2021-09-17T21:58:57.722000+00:00" }, { "EventType": "PERCENTAGE_UPDATED", "TriggeredBy": "APPCONFIG", "Description": "Configuration available to 100.00% of clients", "OccurredAt": "2021-09-17T21:55:56.816000+00:00" }, { "EventType": "PERCENTAGE_UPDATED", "TriggeredBy": "APPCONFIG", "Description": "Configuration available to 75.00% of clients", "OccurredAt": "2021-09-17T21:52:56.567000+00:00" }, { "EventType": "PERCENTAGE_UPDATED", "TriggeredBy": "APPCONFIG", "Description": "Configuration available to 50.00% of clients", "OccurredAt": "2021-09-17T21:49:55.737000+00:00" }, { "EventType": "PERCENTAGE_UPDATED", "TriggeredBy": "APPCONFIG", "Description": "Configuration available to 25.00% of clients", "OccurredAt": "2021-09-17T21:46:55.187000+00:00" }, { "EventType": "DEPLOYMENT_STARTED", "TriggeredBy": "USER", "Description": "Deployment started", "OccurredAt": "2021-09-17T21:43:54.205000+00:00" } ], "PercentageComplete": 100.0, "StartedAt": "2021-09-17T21:43:54.205000+00:00", "CompletedAt": "2021-09-17T21:59:03.888000+00:00" } ``` Weitere Informationen finden Sie unter [Schritt 5: Bereitstellen einer Konfiguration](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-deployment.html)unter *AWS CLI Befehlsreferenz*. ### `get-environment` Das folgende Codebeispiel zeigt die Verwendung`get-environment`. **AWS CLI** **So rufen Sie Umgebungsdetails ab** Im folgenden Beispiel für `get-environment` werden die Details und der Status der angegebenen Umgebung abgerufen. ``` aws appconfig get-environment \ --application-id 339ohji \ --environment-id 54j1r29 ``` Ausgabe: ``` { "ApplicationId": "339ohji", "Id": "54j1r29", "Name": "Example-Environment", "State": "ReadyForDeployment" } ``` Weitere Informationen finden Sie unter [Schritt 2: Erstellen einer Umgebung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-environment.html)unter *AWS CLI Befehlsreferenz*. ### `get-extension-association` Das folgende Codebeispiel zeigt die Verwendung`get-extension-association`. **AWS CLI** **So rufen Sie Details zur Erweiterungszuordnung ab** Im folgenden Beispiel für `get-extension-association` werden Informationen über eine Erweiterungszuordnung angezeigt. ``` aws appconfig get-extension-association \ --region us-west-2 \ --extension-association-id a1b2c3d4 ``` Ausgabe: ``` { "Id": "a1b2c3d4", "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1", "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance", "Parameters": { "S3bucket": "FinanceConfigurationBackup" }, "ExtensionVersionNumber": 1 } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [GetExtensionAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-extension-association.html)unter *AWS CLI Befehlsreferenz*. ### `get-extension` Das folgende Codebeispiel zeigt die Verwendung`get-extension`. **AWS CLI** **So rufen Sie Details zu einer Erweiterung ab** Im folgenden Beispiel für `get-extension` werden Informationen über eine Erweiterung angezeigt. ``` aws appconfig get-extension \ --region us-west-2 \ --extension-identifier S3-backup-extension ``` Ausgabe: ``` { "Id": "1A2B3C4D", "Name": "S3-backup-extension", "VersionNumber": 1, "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1", "Actions": { "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [ { "Name": "S3backup", "Uri": "arn:aws:lambda:us-west-2:123456789012:function:S3backupfunction", "RoleArn": "arn:aws:iam::123456789012:role/appconfigextensionrole" } ] }, "Parameters": { "S3bucket": { "Required": true } } } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [GetExtension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-extension.html)unter *AWS CLI Befehlsreferenz*. ### `get-hosted-configuration-version` Das folgende Codebeispiel zeigt die Verwendung`get-hosted-configuration-version`. **AWS CLI** **Um gehostete Konfigurationsdetails abzurufen** Im folgenden `get-hosted-configuration-version` Beispiel werden die Konfigurationsdetails der AWS AppConfig gehosteten Konfiguration abgerufen. ``` aws appconfig get-hosted-configuration-version \ --application-id 339ohji \ --configuration-profile-id ur8hx2f \ --version-number 1 \ hosted-configuration-version-output ``` Inhalt von `hosted-configuration-version-output`: ``` { "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 } ``` Ausgabe: ``` { "ApplicationId": "339ohji", "ConfigurationProfileId": "ur8hx2f", "VersionNumber": "1", "ContentType": "application/json" } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Über den AWS AppConfig gehosteten Konfigurationsspeicher](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-about-hosted-store). + Einzelheiten zur API finden Sie [GetHostedConfigurationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-hosted-configuration-version.html)unter *AWS CLI Befehlsreferenz*. ### `list-applications` Das folgende Codebeispiel zeigt die Verwendung`list-applications`. **AWS CLI** **So listen Sie die verfügbaren Anwendungen auf** Das folgende `list-applications` Beispiel listet die verfügbaren Anwendungen in Ihrem AWS Konto auf. ``` aws appconfig list-applications ``` Ausgabe: ``` { "Items": [ { "Id": "339ohji", "Name": "test-application", "Description": "An application used for creating an example." }, { "Id": "rwalwu7", "Name": "Test-Application" } ] } ``` Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer AWS AppConfig Anwendung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-applications.html)unter *AWS CLI Befehlsreferenz*. ### `list-configuration-profiles` Das folgende Codebeispiel zeigt die Verwendung`list-configuration-profiles`. **AWS CLI** **So listen Sie die verfügbaren Konfigurationsprofile auf** Im folgenden Beispiel für `list-configuration-profiles` werden die verfügbaren Konfigurationsprofile für die angegebene Anwendung aufgelistet. ``` aws appconfig list-configuration-profiles \ --application-id 339ohji ``` Ausgabe: ``` { "Items": [ { "ApplicationId": "339ohji", "Id": "ur8hx2f", "Name": "Example-Configuration-Profile", "LocationUri": "ssm-parameter://Example-Parameter" } ] } ``` Weitere Informationen finden Sie unter [Schritt 3: Konfiguration und Konfigurationsprofil erstellen](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListConfigurationProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-configuration-profiles.html)unter *AWS CLI Befehlsreferenz*. ### `list-deployment-strategies` Das folgende Codebeispiel zeigt die Verwendung`list-deployment-strategies`. **AWS CLI** **So listen Sie die verfügbaren Bereitstellungsstrategien auf** Das folgende `list-deployment-strategies` Beispiel listet die verfügbaren Bereitstellungsstrategien in Ihrem AWS Konto auf. ``` aws appconfig list-deployment-strategies ``` Ausgabe: ``` { "Items": [ { "Id": "1225qzk", "Name": "Example-Deployment", "DeploymentDurationInMinutes": 15, "GrowthType": "LINEAR", "GrowthFactor": 25.0, "FinalBakeTimeInMinutes": 0, "ReplicateTo": "SSM_DOCUMENT" }, { "Id": "AppConfig.AllAtOnce", "Name": "AppConfig.AllAtOnce", "Description": "Quick", "DeploymentDurationInMinutes": 0, "GrowthType": "LINEAR", "GrowthFactor": 100.0, "FinalBakeTimeInMinutes": 10, "ReplicateTo": "NONE" }, { "Id": "AppConfig.Linear50PercentEvery30Seconds", "Name": "AppConfig.Linear50PercentEvery30Seconds", "Description": "Test/Demo", "DeploymentDurationInMinutes": 1, "GrowthType": "LINEAR", "GrowthFactor": 50.0, "FinalBakeTimeInMinutes": 1, "ReplicateTo": "NONE" }, { "Id": "AppConfig.Canary10Percent20Minutes", "Name": "AppConfig.Canary10Percent20Minutes", "Description": "AWS Recommended", "DeploymentDurationInMinutes": 20, "GrowthType": "EXPONENTIAL", "GrowthFactor": 10.0, "FinalBakeTimeInMinutes": 10, "ReplicateTo": "NONE" } ] } ``` Weitere Informationen finden Sie unter [Schritt 4: Erstellen einer Bereitstellungsstrategie](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListDeploymentStrategies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-deployment-strategies.html)unter *AWS CLI Befehlsreferenz*. ### `list-deployments` Das folgende Codebeispiel zeigt die Verwendung`list-deployments`. **AWS CLI** **So listen Sie die verfügbaren Bereitstellungen auf** Das folgende `list-deployments` Beispiel listet die verfügbaren Bereitstellungen in Ihrem AWS Konto für die angegebene Anwendung und Umgebung auf. ``` aws appconfig list-deployments \ --application-id 339ohji \ --environment-id 54j1r29 ``` Ausgabe: ``` { "Items": [ { "DeploymentNumber": 1, "ConfigurationName": "Example-Configuration-Profile", "ConfigurationVersion": "1", "DeploymentDurationInMinutes": 15, "GrowthType": "LINEAR", "GrowthFactor": 25.0, "FinalBakeTimeInMinutes": 0, "State": "COMPLETE", "PercentageComplete": 100.0, "StartedAt": "2021-09-17T21:43:54.205000+00:00", "CompletedAt": "2021-09-17T21:59:03.888000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Schritt 5: Bereitstellen einer Konfiguration](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-deployments.html)unter *AWS CLI Befehlsreferenz*. ### `list-environments` Das folgende Codebeispiel zeigt die Verwendung`list-environments`. **AWS CLI** **So listen Sie die verfügbaren Umgebungen auf** Das folgende `list-environments` Beispiel listet die verfügbaren Umgebungen in Ihrem AWS Konto für die angegebene Anwendung auf. ``` aws appconfig list-environments \ --application-id 339ohji ``` Ausgabe: ``` { "Items": [ { "ApplicationId": "339ohji", "Id": "54j1r29", "Name": "Example-Environment", "State": "ReadyForDeployment" } ] } ``` Weitere Informationen finden Sie unter [Schritt 2: Erstellen einer Umgebung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListEnvironments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-environments.html)in der *AWS CLI Befehlsreferenz*. ### `list-extension-associations` Das folgende Codebeispiel zeigt die Verwendung`list-extension-associations`. **AWS CLI** **Um alle AWS AppConfig Erweiterungszuordnungen in Ihrem AWS Konto für eine AWS Region aufzulisten** Im folgenden `list-extension-associations` Beispiel werden alle AWS AppConfig Erweiterungszuordnungen für das aktuelle AWS Konto in einer bestimmten AWS Region aufgeführt. ``` aws appconfig list-extension-associations \ --region us-west-2 ``` Ausgabe: ``` { "Items": [ { "Id": "a1b2c3d4", "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1", "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance" } ] } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [ListExtensionAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-extension-associations.html)in der *AWS CLI Befehlsreferenz*. ### `list-extensions` Das folgende Codebeispiel zeigt die Verwendung`list-extensions`. **AWS CLI** **Um alle AWS AppConfig Erweiterungen in Ihrem AWS Konto für eine AWS Region aufzulisten** Das folgende `list-extensions` Beispiel listet alle AWS AppConfig Erweiterungen für das AWS Girokonto in einer bestimmten AWS Region auf. Der Befehl gibt benutzerdefinierte und AWS erstellte Erweiterungen zurück. ``` aws appconfig list-extensions \ --region us-west-2 ``` Ausgabe: ``` { "Items": [ { "Id": "1A2B3C4D", "Name": "S3-backup-extension", "VersionNumber": 1, "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/1A2B3C4D/1" }, { "Id": "AWS.AppConfig.FeatureFlags", "Name": "AppConfig Feature Flags Helper", "VersionNumber": 1, "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.FeatureFlags/1", "Description": "Validates AppConfig feature flag data automatically against a JSON schema that includes structure and constraints. Also transforms feature flag data prior to sending to the client. This extension is automatically associated to configuration profiles with type \"AWS.AppConfig.FeatureFlags\"." }, { "Id": "AWS.AppConfig.JiraIntegration", "Name": "AppConfig integration with Atlassian Jira", "VersionNumber": 1, "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.JiraIntegration/1", "Description": "Exports feature flag data from AWS AppConfig into Jira. The lifecycle of each feature flag in AppConfig is tracked in Jira as an individual issue. Customers can see in Jira when flags are updated, turned on or off. Works in conjunction with the AppConfig app in the Atlassian Marketplace and is automatically associated to configuration profiles configured within that app." }, { "Id": "AWS.AppConfig.DeploymentNotificationsToEventBridge", "Name": "AppConfig deployment events to Amazon EventBridge", "VersionNumber": 1, "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.DeploymentNotificationsToEventBridge/1", "Description": "Sends events to Amazon EventBridge when a deployment of configuration data in AppConfig is started, completed, or rolled back. Can be associated to the following resources in AppConfig: Application, Environment, Configuration Profile." }, { "Id": "AWS.AppConfig.DeploymentNotificationsToSqs", "Name": "AppConfig deployment events to Amazon SQS", "VersionNumber": 1, "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.DeploymentNotificationsToSqs/1", "Description": "Sends messages to the configured Amazon SQS queue when a deployment of configuration data in AppConfig is started, completed, or rolled back. Can be associated to the following resources in AppConfig: Application, Environment, Configuration Profile." }, { "Id": "AWS.AppConfig.DeploymentNotificationsToSns", "Name": "AppConfig deployment events to Amazon SNS", "VersionNumber": 1, "Description": "Sends events to the configured Amazon SNS topic when a deployment of configuration data in AppConfig is started, completed, or rolled back. Can be associated to the following resources in AppConfig: Application, Environment, Configuration Profile." } ] } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [ListExtensions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-extensions.html)in der *AWS CLI Befehlsreferenz*. ### `list-hosted-configuration-versions` Das folgende Codebeispiel zeigt die Verwendung`list-hosted-configuration-versions`. **AWS CLI** **So listen Sie die verfügbaren gehosteten Konfigurationsversionen auf** Im folgenden `list-hosted-configuration-versions` Beispiel werden die Konfigurationsversionen aufgeführt, die im AWS AppConfig gehosteten Konfigurationsspeicher für die angegebene Anwendung und das angegebene Konfigurationsprofil gehostet werden. ``` aws appconfig list-hosted-configuration-versions \ --application-id 339ohji \ --configuration-profile-id ur8hx2f ``` Ausgabe: ``` { "Items": [ { "ApplicationId": "339ohji", "ConfigurationProfileId": "ur8hx2f", "VersionNumber": 1, "ContentType": "application/json" } ] } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Über den AWS AppConfig gehosteten Konfigurationsspeicher](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-about-hosted-store). + Einzelheiten zur API finden Sie [ListHostedConfigurationVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-hosted-configuration-versions.html)unter *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags einer Anwendung auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags einer angegebenen Anwendung aufgelistet. ``` aws appconfig list-tags-for-resource \ --resource-arn arn:aws:appconfig:us-east-1:682428703967:application/339ohji ``` Ausgabe: ``` { "Tags": { "group1": "1" } } ``` Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer AWS AppConfig Anwendung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-tags-for-resource.html)unter *AWS CLI Befehlsreferenz*. ### `start-deployment` Das folgende Codebeispiel zeigt die Verwendung`start-deployment`. **AWS CLI** **So starten Sie eine Konfigurationsbereitstellung** Im folgenden Beispiel für `start-deployment` wird eine Bereitstellung für die Anwendung unter Verwendung der angegebenen Umgebung und Bereitstellungsstrategie sowie des angegebenen Konfigurationsprofils gestartet. ``` aws appconfig start-deployment \ --application-id 339ohji \ --environment-id 54j1r29 \ --deployment-strategy-id 1225qzk \ --configuration-profile-id ur8hx2f \ --configuration-version 1 ``` Ausgabe: ``` { "ApplicationId": "339ohji", "EnvironmentId": "54j1r29", "DeploymentStrategyId": "1225qzk", "ConfigurationProfileId": "ur8hx2f", "DeploymentNumber": 1, "ConfigurationName": "Example-Configuration-Profile", "ConfigurationLocationUri": "ssm-parameter://Example-Parameter", "ConfigurationVersion": "1", "DeploymentDurationInMinutes": 15, "GrowthType": "LINEAR", "GrowthFactor": 25.0, "FinalBakeTimeInMinutes": 0, "State": "DEPLOYING", "EventLog": [ { "EventType": "DEPLOYMENT_STARTED", "TriggeredBy": "USER", "Description": "Deployment started", "OccurredAt": "2021-09-17T21:43:54.205000+00:00" } ], "PercentageComplete": 0.0, "StartedAt": "2021-09-17T21:43:54.205000+00:00" } ``` Weitere Informationen finden Sie unter [Schritt 5: Bereitstellen einer Konfiguration](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/start-deployment.html)unter *AWS CLI Befehlsreferenz*. ### `stop-deployment` Das folgende Codebeispiel zeigt die Verwendung`stop-deployment`. **AWS CLI** **So beenden Sie eine Konfigurationsbereitstellung** Im folgenden Beispiel für `stop-deployment` wird die Bereitstellung einer Anwendungskonfiguration in der angegebenen Umgebung beendet. ``` aws appconfig stop-deployment \ --application-id 339ohji \ --environment-id 54j1r29 \ --deployment-number 2 ``` Ausgabe: ``` { "DeploymentNumber": 0, "DeploymentDurationInMinutes": 0, "GrowthFactor": 0.0, "FinalBakeTimeInMinutes": 0, "PercentageComplete": 0.0 } ``` Weitere Informationen finden Sie unter [Schritt 5: Bereitstellen einer Konfiguration](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/stop-deployment.html)unter *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Anwendung** Im folgenden Beispiel für `tag-resource` wird eine Anwendungsressource getaggt. ``` aws appconfig tag-resource \ --resource-arn arn:aws:appconfig:us-east-1:682428703967:application/339ohji \ --tags '{"group1" : "1"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer AWS AppConfig Anwendung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/tag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag aus einer Anwendung** Im folgenden Beispiel für `untag-resource` wird das group1-Tag von der angegebenen Anwendung entfernt. ``` aws appconfig untag-resource \ --resource-arn arn:aws:appconfig:us-east-1:111122223333:application/339ohji \ --tag-keys '["group1"]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer AWS AppConfig Anwendung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/untag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `update-application` Das folgende Codebeispiel zeigt die Verwendung`update-application`. **AWS CLI** **So aktualisieren Sie eine Anwendung** Im folgenden Beispiel für `update-application` wird der Name der angegebenen Anwendung aktualisiert. ``` aws appconfig update-application \ --application-id 339ohji \ --name "Example-Application" ``` Ausgabe: ``` { "Id": "339ohji", "Name": "Example-Application", "Description": "An application used for creating an example." } ``` Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer AWS AppConfig Anwendung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-application.html)unter *AWS CLI Befehlsreferenz*. ### `update-configuration-profile` Das folgende Codebeispiel zeigt die Verwendung`update-configuration-profile`. **AWS CLI** **So aktualisieren Sie ein Konfigurationsprofil** Im folgenden Beispiel für `update-configuration-profile` wird die Beschreibung des angegebenen Konfigurationsprofils aktualisiert. ``` aws appconfig update-configuration-profile \ --application-id 339ohji \ --configuration-profile-id ur8hx2f \ --description "Configuration profile used for examples." ``` Ausgabe: ``` { "ApplicationId": "339ohji", "Id": "ur8hx2f", "Name": "Example-Configuration-Profile", "Description": "Configuration profile used for examples.", "LocationUri": "ssm-parameter://Example-Parameter", "RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role" } ``` Weitere Informationen finden Sie unter [Schritt 3: Konfiguration und Konfigurationsprofil erstellen](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateConfigurationProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-configuration-profile.html)unter *AWS CLI Befehlsreferenz*. ### `update-deployment-strategy` Das folgende Codebeispiel zeigt die Verwendung`update-deployment-strategy`. **AWS CLI** **So aktualisieren Sie eine Bereitstellungsstrategie** Im folgenden Beispiel für `update-deployment-strategy` wird die endgültige Bake-Zeit in der angegebenen Bereitstellungsstrategie auf 20 Minuten aktualisiert. ``` aws appconfig update-deployment-strategy \ --deployment-strategy-id 1225qzk \ --final-bake-time-in-minutes 20 ``` Ausgabe: ``` { "Id": "1225qzk", "Name": "Example-Deployment", "DeploymentDurationInMinutes": 15, "GrowthType": "LINEAR", "GrowthFactor": 25.0, "FinalBakeTimeInMinutes": 20, "ReplicateTo": "SSM_DOCUMENT" } ``` Weitere Informationen finden Sie unter [Schritt 4: Erstellen einer Bereitstellungsstrategie](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateDeploymentStrategy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-deployment-strategy.html)unter *AWS CLI Befehlsreferenz*. ### `update-environment` Das folgende Codebeispiel zeigt die Verwendung`update-environment`. **AWS CLI** **So aktualisieren Sie eine Umgebung** Im folgenden Beispiel für `update-environment` wird die Beschreibung einer Umgebung aktualisiert. ``` aws appconfig update-environment \ --application-id 339ohji \ --environment-id 54j1r29 \ --description "An environment for examples." ``` Ausgabe: ``` { "ApplicationId": "339ohji", "Id": "54j1r29", "Name": "Example-Environment", "Description": "An environment for examples.", "State": "RolledBack" } ``` Weitere Informationen finden Sie unter [Schritt 2: Erstellen einer Umgebung](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-environment.html)in der *AWS CLI Befehlsreferenz*. ### `update-extension-association` Das folgende Codebeispiel zeigt die Verwendung`update-extension-association`. **AWS CLI** **Um eine AWS AppConfig Erweiterungsverknüpfung zu aktualisieren** Im folgenden `update-extension-association` Beispiel wird einer Erweiterungsassoziation in ein neuer Parameterwert hinzugefügt AWS AppConfig. ``` aws appconfig update-extension-association \ --region us-west-2 \ --extension-association-id a1b2c3d4 \ --parameters S3bucket=FinanceMobileApp ``` Ausgabe: ``` { "Id": "a1b2c3d4", "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1", "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance", "Parameters": { "S3bucket": "FinanceMobileApp" }, "ExtensionVersionNumber": 1 } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [UpdateExtensionAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-extension-association.html)in der *AWS CLI Befehlsreferenz*. ### `update-extension` Das folgende Codebeispiel zeigt die Verwendung`update-extension`. **AWS CLI** **Um eine AWS AppConfig Erweiterung zu aktualisieren** Das folgende `update-extension` Beispiel fügt einer Erweiterung in einen zusätzlichen Parameter Key hinzu AWS AppConfig. ``` aws appconfig update-extension \ --region us-west-2 \ --extension-identifier S3-backup-extension \ --parameters S3bucket={Required=true},CampaignID={Required=false} ``` Ausgabe: ``` { "Id": "1A2B3C4D", "Name": "S3-backup-extension", "VersionNumber": 1, "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/1A2B3C4D/1", "Actions": { "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [ { "Name": "S3backup", "Uri": "arn:aws:lambda:us-west-2:123456789012:function:S3backupfunction", "RoleArn": "arn:aws:iam::123456789012:role/appconfigextensionrole" } ] }, "Parameters": { "CampaignID": { "Required": false }, "S3bucket": { "Required": true } } } ``` Weitere Informationen finden Sie im *AWS AppConfig Benutzerhandbuch* unter [Arbeiten mit AWS AppConfig Erweiterungen](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html). + Einzelheiten zur API finden Sie [UpdateExtension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-extension.html)in der *AWS CLI Befehlsreferenz*. ### `validate-configuration` Das folgende Codebeispiel zeigt die Verwendung`validate-configuration`. **AWS CLI** **So validieren Sie eine Konfiguration** Im folgenden Beispiel für `validate-configuration` werden die Validatoren in einem Konfigurationsprofil verwendet, um eine Konfiguration zu validieren. ``` aws appconfig validate-configuration \ --application-id abc1234 \ --configuration-profile-id ur8hx2f \ --configuration-version 1 ``` Mit dem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schritt 3: Konfiguration und Konfigurationsprofil erstellen](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) im *AWS AppConfig Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ValidateConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/validate-configuration.html)unter *AWS CLI Befehlsreferenz*. # Beispiele für Application Auto Scaling mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Application Auto Scaling Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-scaling-policy` Das folgende Codebeispiel zeigt, wie Sie`delete-scaling-policy`. **AWS CLI** **So löschen Sie eine Skalierungsrichtlinie** In diesem Beispiel wird eine Skalierungsrichtlinie für die Web-App des Amazon-ECS-Service gelöscht, die im Standard-Cluster ausgeführt wird. Befehl: ``` aws application-autoscaling delete-scaling-policy --policy-name web-app-cpu-lt-25 --scalable-dimension ecs:service:DesiredCount --resource-id service/default/web-app --service-namespace ecs ``` + Einzelheiten zur API finden Sie [DeleteScalingPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/delete-scaling-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-scheduled-action` Das folgende Codebeispiel zeigt die Verwendung`delete-scheduled-action`. **AWS CLI** **Löschen einer geplanten Aktion** Das folgende `delete-scheduled-action` Beispiel löscht die angegebene geplante Aktion aus der angegebenen Amazon AppStream 2.0-Flotte: ``` aws application-autoscaling delete-scheduled-action \ --service-namespace appstream \ --scalable-dimension appstream:fleet:DesiredCapacity \ --resource-id fleet/sample-fleet \ --scheduled-action-name my-recurring-action ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch zu Application Auto Scaling*. + Einzelheiten zur API finden Sie [DeleteScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/delete-scheduled-action.html)in der *AWS CLI Befehlsreferenz.* ### `deregister-scalable-target` Das folgende Codebeispiel zeigt die Verwendung`deregister-scalable-target`. **AWS CLI** **So registrieren Sie ein skalierbares Ziel** In diesem Beispiel wird die Registrierung eines skalierbaren Ziels für einen Amazon ECS-Service mit dem Namen Web-App aufgehoben, der im Standard-Cluster ausgeführt wird. Befehl: ``` aws application-autoscaling deregister-scalable-target --service-namespace ecs --scalable-dimension ecs:service:DesiredCount --resource-id service/default/web-app ``` In diesem Beispiel wird die Registrierung eines skalierbaren Ziels für eine benutzerdefinierte Ressource aufgehoben. Die custom-resource-id .txt-Datei enthält eine Zeichenfolge, die die Ressourcen-ID identifiziert. Bei einer benutzerdefinierten Ressource ist dies der Pfad zu der benutzerdefinierten Ressource über Ihren Amazon API Gateway Gateway-Endpunkt. Befehl: ``` aws application-autoscaling deregister-scalable-target --service-namespace custom-resource --scalable-dimension custom-resource:ResourceType:Property --resource-id file://~/custom-resource-id.txt ``` Inhalt der custom-resource-id TXT-Datei: ``` https://example.execute-api.us-west-2.amazonaws.com/prod/scalableTargetDimensions/1-23456789 ``` + Einzelheiten zur API finden Sie [DeregisterScalableTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/deregister-scalable-target.html)in der *AWS CLI Befehlsreferenz.* ### `describe-scalable-targets` Das folgende Codebeispiel zeigt die Verwendung`describe-scalable-targets`. **AWS CLI** **So beschreiben Sie skalierbare Ziele** Das folgende Beispiel für `describe-scalable-targets` beschreibt die skalierbaren Ziele für den `ecs`-Service-Namespace. ``` aws application-autoscaling describe-scalable-targets \ --service-namespace ecs ``` Ausgabe: ``` { "ScalableTargets": [ { "ServiceNamespace": "ecs", "ScalableDimension": "ecs:service:DesiredCount", "ResourceId": "service/default/web-app", "MinCapacity": 1, "MaxCapacity": 10, "RoleARN": "arn:aws:iam::123456789012:role/aws-service-role/ecs.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_ECSService", "CreationTime": 1462558906.199, "SuspendedState": { "DynamicScalingOutSuspended": false, "ScheduledScalingSuspended": false, "DynamicScalingInSuspended": false }, "ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123" } ] } ``` Weitere Informationen finden Sie unter [AWS -Services, die Sie mit Application Auto Scaling nutzen können](https://docs.aws.amazon.com/autoscaling/application/userguide/integrated-services-list.html) im *Benutzerhandbuch für Application Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeScalableTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/describe-scalable-targets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scaling-activities` Das folgende Codebeispiel zeigt die Verwendung`describe-scaling-activities`. **AWS CLI** **Beispiel 1: So beschreiben Sie Skalierungsaktivitäten für den angegebenen Amazon-ECS-Service** Das folgende Beispiel für `describe-scaling-activities` beschreibt die Skalierungsaktivitäten für einen Amazon-ECS-Service mit dem Namen `web-app`, der im `default`-Cluster ausgeführt wird. Die Ausgabe zeigt eine Skalierungsaktivität, die durch eine Skalierungsrichtlinie initiiert wurde. ``` aws application-autoscaling describe-scaling-activities \ --service-namespace ecs \ --resource-id service/default/web-app ``` Ausgabe: ``` { "ScalingActivities": [ { "ScalableDimension": "ecs:service:DesiredCount", "Description": "Setting desired count to 1.", "ResourceId": "service/default/web-app", "ActivityId": "e6c5f7d1-dbbb-4a3f-89b2-51f33e766399", "StartTime": 1462575838.171, "ServiceNamespace": "ecs", "EndTime": 1462575872.111, "Cause": "monitor alarm web-app-cpu-lt-25 in state ALARM triggered policy web-app-cpu-lt-25", "StatusMessage": "Successfully set desired count to 1. Change successfully fulfilled by ecs.", "StatusCode": "Successful" } ] } ``` Weitere Informationen finden Sie unter [Skalierungsaktivitäten für Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scaling-activities.html) im *Benutzerhandbuch für Application Auto Scaling*. **Beispiel 2: So beschreiben Sie Skalierungsaktivitäten für die angegebene DynamoDB-Tabelle** Das folgende Beispiel für `describe-scaling-activities` beschreibt die Skalierungsaktivitäten für eine DynamoDB-Tabelle mit dem Namen `TestTable`. Die Ausgabe zeigt Skalierungsaktivitäten, die durch zwei verschiedene geplante Aktionen ausgelöst wurden. ``` aws application-autoscaling describe-scaling-activities \ --service-namespace dynamodb \ --resource-id table/TestTable ``` Ausgabe: ``` { "ScalingActivities": [ { "ScalableDimension": "dynamodb:table:WriteCapacityUnits", "Description": "Setting write capacity units to 10.", "ResourceId": "table/my-table", "ActivityId": "4d1308c0-bbcf-4514-a673-b0220ae38547", "StartTime": 1561574415.086, "ServiceNamespace": "dynamodb", "EndTime": 1561574449.51, "Cause": "maximum capacity was set to 10", "StatusMessage": "Successfully set write capacity units to 10. Change successfully fulfilled by dynamodb.", "StatusCode": "Successful" }, { "ScalableDimension": "dynamodb:table:WriteCapacityUnits", "Description": "Setting min capacity to 5 and max capacity to 10", "ResourceId": "table/my-table", "ActivityId": "f2b7847b-721d-4e01-8ef0-0c8d3bacc1c7", "StartTime": 1561574414.644, "ServiceNamespace": "dynamodb", "Cause": "scheduled action name my-second-scheduled-action was triggered", "StatusMessage": "Successfully set min capacity to 5 and max capacity to 10", "StatusCode": "Successful" }, { "ScalableDimension": "dynamodb:table:WriteCapacityUnits", "Description": "Setting write capacity units to 15.", "ResourceId": "table/my-table", "ActivityId": "d8ea4de6-9eaa-499f-b466-2cc5e681ba8b", "StartTime": 1561574108.904, "ServiceNamespace": "dynamodb", "EndTime": 1561574140.255, "Cause": "minimum capacity was set to 15", "StatusMessage": "Successfully set write capacity units to 15. Change successfully fulfilled by dynamodb.", "StatusCode": "Successful" }, { "ScalableDimension": "dynamodb:table:WriteCapacityUnits", "Description": "Setting min capacity to 15 and max capacity to 20", "ResourceId": "table/my-table", "ActivityId": "3250fd06-6940-4e8e-bb1f-d494db7554d2", "StartTime": 1561574108.512, "ServiceNamespace": "dynamodb", "Cause": "scheduled action name my-first-scheduled-action was triggered", "StatusMessage": "Successfully set min capacity to 15 and max capacity to 20", "StatusCode": "Successful" } ] } ``` Weitere Informationen finden Sie unter [Skalierungsaktivitäten für Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scaling-activities.html) im *Benutzerhandbuch für Application Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeScalingActivities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/describe-scaling-activities.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scaling-policies` Das folgende Codebeispiel zeigt die Verwendung`describe-scaling-policies`. **AWS CLI** **So beschreiben Sie Skalierungsrichtlinien** Dieser Beispielbefehl beschreibt die Skalierungsrichtlinien für den ECS-Service-Namespace. Befehl: ``` aws application-autoscaling describe-scaling-policies --service-namespace ecs ``` Ausgabe: ``` { "ScalingPolicies": [ { "PolicyName": "web-app-cpu-gt-75", "ScalableDimension": "ecs:service:DesiredCount", "ResourceId": "service/default/web-app", "CreationTime": 1462561899.23, "StepScalingPolicyConfiguration": { "Cooldown": 60, "StepAdjustments": [ { "ScalingAdjustment": 200, "MetricIntervalLowerBound": 0.0 } ], "AdjustmentType": "PercentChangeInCapacity" }, "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-gt-75", "PolicyType": "StepScaling", "Alarms": [ { "AlarmName": "web-app-cpu-gt-75", "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:web-app-cpu-gt-75" } ], "ServiceNamespace": "ecs" }, { "PolicyName": "web-app-cpu-lt-25", "ScalableDimension": "ecs:service:DesiredCount", "ResourceId": "service/default/web-app", "CreationTime": 1462562575.099, "StepScalingPolicyConfiguration": { "Cooldown": 1, "StepAdjustments": [ { "ScalingAdjustment": -50, "MetricIntervalUpperBound": 0.0 } ], "AdjustmentType": "PercentChangeInCapacity" }, "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-lt-25", "PolicyType": "StepScaling", "Alarms": [ { "AlarmName": "web-app-cpu-lt-25", "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:web-app-cpu-lt-25" } ], "ServiceNamespace": "ecs" } ] } ``` + Einzelheiten zur API finden Sie [DescribeScalingPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/describe-scaling-policies.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scheduled-actions` Das folgende Codebeispiel zeigt die Verwendung`describe-scheduled-actions`. **AWS CLI** **So beschreiben Sie geplante Aktionen** Das folgende Beispiel für `describe-scheduled-actions` zeigt Details zu den geplanten Aktionen für den angegebenen Service-Namespace: ``` aws application-autoscaling describe-scheduled-actions \ --service-namespace dynamodb ``` Ausgabe: ``` { "ScheduledActions": [ { "ScalableDimension": "dynamodb:table:WriteCapacityUnits", "Schedule": "at(2019-05-20T18:35:00)", "ResourceId": "table/my-table", "CreationTime": 1561571888.361, "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-first-scheduled-action", "ScalableTargetAction": { "MinCapacity": 15, "MaxCapacity": 20 }, "ScheduledActionName": "my-first-scheduled-action", "ServiceNamespace": "dynamodb" }, { "ScalableDimension": "dynamodb:table:WriteCapacityUnits", "Schedule": "at(2019-05-20T18:40:00)", "ResourceId": "table/my-table", "CreationTime": 1561571946.021, "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-second-scheduled-action", "ScalableTargetAction": { "MinCapacity": 5, "MaxCapacity": 10 }, "ScheduledActionName": "my-second-scheduled-action", "ServiceNamespace": "dynamodb" } ] } ``` Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch zu Application Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeScheduledActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/describe-scheduled-actions.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags für ein skalierbares Ziel auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Namen und Werte der Tag-Schlüssel aufgelistet, die an das durch seinen ARN angegebene skalierbare Ziel angehängt sind. ``` aws application-autoscaling list-tags-for-resource \ --resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123 ``` Ausgabe: ``` { "Tags": { "environment": "production" } } ``` Weitere Informationen finden Sie unter [Tagging-Unterstützung für Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/resource-tagging-support.html) im *Benutzerhandbuch für Application Auto Scaling*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-scaling-policy` Das folgende Codebeispiel zeigt die Verwendung`put-scaling-policy`. **AWS CLI** **Beispiel 1: So wenden Sie eine Skalierungsrichtlinie für die Ziel-Nachverfolgung mit einer vordefinierten Metrikspezifikation an** Das folgende Beispiel für `put-scaling-policy` wendet eine Skalierungsrichtlinie zur Zielverfolgung mit einer vordefinierten Metrikspezifikation auf einen Amazon-ECS-Service mit dem Namen Web-App im Standard-Cluster an. Die Richtlinie hält die durchschnittliche CPU-Auslastung des Service bei 75 Prozent, mit Aufskalierungs- und Abskalierungs-Ruhephasen von 60 Sekunden. Die Ausgabe enthält die Namen ARNs und der beiden CloudWatch Alarme, die in Ihrem Namen erstellt wurden. ``` aws application-autoscaling put-scaling-policy --service-namespace ecs \ --scalable-dimension ecs:service:DesiredCount \ --resource-id service/default/web-app \ --policy-name cpu75-target-tracking-scaling-policy --policy-type TargetTrackingScaling \ --target-tracking-scaling-policy-configuration file://config.json ``` In diesem Beispiel wird davon ausgegangen, dass Sie im aktuellen Verzeichnis über eine config.json-Datei mit dem folgenden Inhalt verfügen: ``` { "TargetValue": 75.0, "PredefinedMetricSpecification": { "PredefinedMetricType": "ECSServiceAverageCPUUtilization" }, "ScaleOutCooldown": 60, "ScaleInCooldown": 60 } ``` Ausgabe: ``` { "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/cpu75-target-tracking-scaling-policy", "Alarms": [ { "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca", "AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca" }, { "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmLow-1b437334-d19b-4a63-a812-6c67aaf2910d", "AlarmName": "TargetTracking-service/default/web-app-AlarmLow-1b437334-d19b-4a63-a812-6c67aaf2910d" } ] } ``` **Beispiel 2: So wenden Sie eine Skalierungsrichtlinie für die Ziel-Nachverfolgung mit einer benutzerdefinierten Metrikspezifikation an** Das folgende Beispiel für `put-scaling-policy` wendet eine Skalierungsrichtlinie für die Ziel-Nachverfolgung mit einer benutzerdefinierten Metrikspezifikation auf einen Amazon-ECS-Service mit dem Namen Web-App im Standard-Cluster an. Die Richtlinie hält die durchschnittliche Auslastung des Service bei 75 Prozent, mit Aufskalierungs- und Abskalierungs-Ruhephasen von 60 Sekunden. Die Ausgabe enthält die Namen ARNs und der beiden CloudWatch Alarme, die in Ihrem Namen erstellt wurden. ``` aws application-autoscaling put-scaling-policy --service-namespace ecs \ --scalable-dimension ecs:service:DesiredCount \ --resource-id service/default/web-app \ --policy-name cms75-target-tracking-scaling-policy --policy-type TargetTrackingScaling \ --target-tracking-scaling-policy-configuration file://config.json ``` In diesem Beispiel wird davon ausgegangen, dass Sie im aktuellen Verzeichnis über eine config.json-Datei mit dem folgenden Inhalt verfügen: ``` { "TargetValue":75.0, "CustomizedMetricSpecification":{ "MetricName":"MyUtilizationMetric", "Namespace":"MyNamespace", "Dimensions": [ { "Name":"MyOptionalMetricDimensionName", "Value":"MyOptionalMetricDimensionValue" } ], "Statistic":"Average", "Unit":"Percent" }, "ScaleOutCooldown": 60, "ScaleInCooldown": 60 } ``` Ausgabe: ``` { "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy: 8784a896-b2ba-47a1-b08c-27301cc499a1:resource/ecs/service/default/web-app:policyName/cms75-target-tracking-scaling-policy", "Alarms": [ { "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmHigh-9bc77b56-0571-4276-ba0f-d4178882e0a0", "AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-9bc77b56-0571-4276-ba0f-d4178882e0a0" }, { "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmLow-9b6ad934-6d37-438e-9e05-02836ddcbdc4", "AlarmName": "TargetTracking-service/default/web-app-AlarmLow-9b6ad934-6d37-438e-9e05-02836ddcbdc4" } ] } ``` **Beispiel 3: So wenden Sie eine Skalierungsrichtlinie für die Ziel-Nachverfolgung nur für die horizontale Skalierung nach oben an** Das folgende Beispiel für `put-scaling-policy` wendet eine Skalierungsrichtlinie für die Ziel-Nachverfolgung auf einen Amazon-ECS-Service mit dem Namen `web-app` im Standard-Cluster an. Die Richtlinie wird verwendet, um den ECS-Service aufzuskalieren, wenn die `RequestCountPerTarget`-Metrik aus dem Application Load Balancer den Schwellenwert überschreitet. Die Ausgabe enthält den ARN und den Namen des CloudWatch Alarms, der in Ihrem Namen erstellt wurde. ``` aws application-autoscaling put-scaling-policy \ --service-namespace ecs \ --scalable-dimension ecs:service:DesiredCount \ --resource-id service/default/web-app \ --policy-name alb-scale-out-target-tracking-scaling-policy \ --policy-type TargetTrackingScaling \ --target-tracking-scaling-policy-configuration file://config.json ``` Inhalt von `config.json`: ``` { "TargetValue": 1000.0, "PredefinedMetricSpecification": { "PredefinedMetricType": "ALBRequestCountPerTarget", "ResourceLabel": "app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d" }, "ScaleOutCooldown": 60, "ScaleInCooldown": 60, "DisableScaleIn": true } ``` Ausgabe: ``` { "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/alb-scale-out-target-tracking-scaling-policy", "Alarms": [ { "AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca", "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca" } ] } ``` Weitere Informationen finden Sie in den [Skalierungsrichtlinien für die Ziel-Nachverfolgung für Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) im *AWS Benutzerhandbuch für Application Auto Scaling*. + Einzelheiten zur API finden Sie [PutScalingPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/put-scaling-policy.html)in der *AWS CLI Befehlsreferenz*. ### `put-scheduled-action` Das folgende Codebeispiel zeigt die Verwendung`put-scheduled-action`. **AWS CLI** **So fügen Sie eine geplante Aktion zu einer DynamoDB-Tabelle hinzu** In diesem Beispiel wird eine geplante Aktion zu einer DynamoDB-Tabelle hinzugefügt, die aufgerufen wird TestTable , um nach einem wiederkehrenden Zeitplan zu skalieren. Gemäß dem angegebenen Zeitplan (täglich um 12:15 Uhr UTC) wird Application Auto Scaling auf den von angegebenen Wert skaliert MinCapacity, wenn die aktuelle Kapazität unter dem für angegebenen Wert liegt. MinCapacity Befehl: ``` aws application-autoscaling put-scheduled-action --service-namespace dynamodb --scheduled-action-name my-recurring-action --schedule "cron(15 12 * * ? *)" --resource-id table/TestTable --scalable-dimension dynamodb:table:WriteCapacityUnits --scalable-target-action MinCapacity=6 ``` Weitere Informationen finden Sie unter „Geplante Skalierung“ im *Benutzerhandbuch für Application Auto Scaling*. + Einzelheiten zur API finden Sie [PutScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/put-scheduled-action.html)in der *AWS CLI Befehlsreferenz.* ### `register-scalable-target` Das folgende Codebeispiel zeigt die Verwendung`register-scalable-target`. **AWS CLI** **Beispiel 1: So registrieren Sie einen ECS-Service als skalierbares Ziel** Im folgenden Beispiel für `register-scalable-target` wird ein Amazon-ECS-Service bei Application Auto Scaling registriert. Außerdem wird dem skalierbaren Ziel ein Tag mit dem Schlüsselnamen `environment` und dem Wert `production` hinzugefügt. ``` aws application-autoscaling register-scalable-target \ --service-namespace ecs \ --scalable-dimension ecs:service:DesiredCount \ --resource-id service/default/web-app \ --min-capacity 1 --max-capacity 10 \ --tags environment=production ``` Ausgabe: ``` { "ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123" } ``` Beispiele für andere AWS Dienste und benutzerdefinierte Ressourcen finden Sie in den Themen unter [AWS Dienste, die Sie mit Application Auto Scaling verwenden können im Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/integrated-services-list.html) *Scaling-Benutzerhandbuch*. **Beispiel 2: So setzen Sie die Skalierungsaktivitäten für ein skalierbares Ziel aus** Im folgenden Beispiel für `register-scalable-target` werden die Skalierungsaktivitäten für ein vorhandenes skalierbares Ziel ausgesetzt. ``` aws application-autoscaling register-scalable-target \ --service-namespace dynamodb \ --scalable-dimension dynamodb:table:ReadCapacityUnits \ --resource-id table/my-table \ --suspended-state DynamicScalingInSuspended=true,DynamicScalingOutSuspended=true,ScheduledScalingSuspended=true ``` Ausgabe: ``` { "ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123" } ``` Weitere Informationen finden Sie unter [Unterbrechung und Wiederaufnahme der Skalierung von Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-suspend-resume-scaling.html) im *Benutzerhandbuch für Application Auto Scaling*. **Beispiel 3: So nehmen Sie die Skalierungsaktivitäten für ein skalierbares Ziel wieder auf** Mit dem folgenden Beispiel für `register-scalable-target` werden alle Skalierungsaktivitäten für ein vorhandenes skalierbares Ziel fortgesetzt. ``` aws application-autoscaling register-scalable-target \ --service-namespace dynamodb \ --scalable-dimension dynamodb:table:ReadCapacityUnits \ --resource-id table/my-table \ --suspended-state DynamicScalingInSuspended=false,DynamicScalingOutSuspended=false,ScheduledScalingSuspended=false ``` Ausgabe: ``` { "ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123" } ``` Weitere Informationen finden Sie unter [Unterbrechung und Wiederaufnahme der Skalierung von Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-suspend-resume-scaling.html) im *Benutzerhandbuch für Application Auto Scaling*. + Einzelheiten zur API finden Sie [RegisterScalableTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/register-scalable-target.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einem skalierbaren Ziel ein Tag hinzu** Im folgenden Beispiel für `tag-resource` wird ein Tag mit dem Schlüsselnamen `environment` und dem Wert `production` an das durch seinen ARN angegebene skalierbare Ziel angehängt. ``` aws application-autoscaling tag-resource \ --resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123 \ --tags environment=production ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging-Unterstützung für Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/resource-tagging-support.html) im *Benutzerhandbuch für Application Auto Scaling*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag aus einem skalierbaren Ziel** Im folgenden Beispiel für `untag-resource` wird das Tag-Paar mit dem Schlüsselnamen `environment` aus dem durch seinen ARN angegebenen skalierbaren Ziel entfernt. ``` aws application-autoscaling untag-resource \ --resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123 \ --tag-keys "environment" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging-Unterstützung für Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/resource-tagging-support.html) im *Benutzerhandbuch für Application Auto Scaling*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für den Application Discovery Service mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie den AWS Command Line Interface with Application Discovery Service verwenden. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `describe-agents` Das folgende Codebeispiel zeigt, wie Sie`describe-agents`. **AWS CLI** **Beschreiben von Agenten mit den angegebenen collectionStatus-Status** Dieser Beispielbefehl beschreibt Sammelagenten mit dem Sammlungsstatus „STARTED“ oder „STOPPED“. Befehl: ``` aws discovery describe-agents --filters name="collectionStatus",values="STARTED","STOPPED",condition="EQUALS" --max-results 3 ``` Ausgabe: ``` { "Snapshots": [ { "version": "1.0.40.0", "agentType": "EC2", "hostName": "ip-172-31-40-234", "collectionStatus": "STOPPED", "agentNetworkInfoList": [ { "macAddress": "06:b5:97:14:fc:0d", "ipAddress": "172.31.40.234" } ], "health": "UNKNOWN", "agentId": "i-003305c02a776e883", "registeredTime": "2016-12-09T19:05:06Z", "lastHealthPingTime": "2016-12-09T19:05:10Z" }, { "version": "1.0.40.0", "agentType": "EC2", "hostName": "ip-172-31-39-64", "collectionStatus": "STARTED", "agentNetworkInfoList": [ { "macAddress": "06:a1:0e:c7:b2:73", "ipAddress": "172.31.39.64" } ], "health": "SHUTDOWN", "agentId": "i-003a5e5e2b36cf8bd", "registeredTime": "2016-11-16T16:36:25Z", "lastHealthPingTime": "2016-11-16T16:47:37Z" } ] } ``` + Einzelheiten zur API finden Sie [DescribeAgents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/discovery/describe-agents.html)in der *AWS CLI Befehlsreferenz*. ### `describe-configurations` Das folgende Codebeispiel zeigt die Verwendung`describe-configurations`. **AWS CLI** **Beschreiben ausgewählter Komponentenkonfigurationen** Dieser Beispielbefehl beschreibt die Konfigurationen von zwei angegebenen Servern. Die Aktion erkennt den Komponententyp anhand der Konfigurations-ID. Pro Befehl ist nur ein Komponententyp zulässig. Befehl: ``` aws discovery describe-configurations --configuration-ids "d-server-099385097ef9fbcfb" "d-server-0c4f2dd1fee22c6c1" ``` Ausgabe: ``` { "configurations": [ { "server.performance.maxCpuUsagePct": "0.0", "server.performance.maxDiskReadIOPS": "0.0", "server.performance.avgCpuUsagePct": "0.0", "server.type": "EC2", "server.performance.maxNetworkReadsPerSecondInKB": "0.19140625", "server.hostName": "ip-172-31-35-152", "server.configurationId": "d-server-0c4f2dd1fee22c6c1", "server.tags.hasMoreValues": "false", "server.performance.minFreeRAMInKB": "1543496.0", "server.osVersion": "3.14.48-33.39.amzn1.x86_64", "server.performance.maxDiskReadsPerSecondInKB": "0.0", "server.applications": "[]", "server.performance.numDisks": "1", "server.performance.numCpus": "1", "server.performance.numCores": "1", "server.performance.maxDiskWriteIOPS": "0.0", "server.performance.maxNetworkWritesPerSecondInKB": "0.82421875", "server.performance.avgDiskWritesPerSecondInKB": "0.0", "server.networkInterfaceInfo": "[{\"name\":\"eth0\",\"macAddress\":\"06:A7:7D:3F:54:57\",\"ipAddress\":\"172.31.35.152\",\"netMask\":\"255.255.240.0\"},{\"name\":\"lo\",\"macAddress\":\"00:00:00:00:00:00\",\"ipAddress\":\"127.0.0.1\",\"netMask\":\"255.0.0.0\"},{\"name\":\"eth0\",\"macAddress\":\"06:A7:7D:3F:54:57\",\"ipAddress\":\"fe80::4a7:7dff:fe3f:5457\"},{\"name\":\"lo\",\"macAddress\":\"00:00:00:00:00:00\",\"ipAddress\":\"::1\"}]", "server.performance.avgNetworkReadsPerSecondInKB": "0.04915364583333333", "server.tags": "[]", "server.applications.hasMoreValues": "false", "server.timeOfCreation": "2016-10-28 23:44:00.0", "server.agentId": "i-4447bc1b", "server.performance.maxDiskWritesPerSecondInKB": "0.0", "server.performance.avgDiskReadIOPS": "0.0", "server.performance.avgFreeRAMInKB": "1547210.1333333333", "server.performance.avgDiskReadsPerSecondInKB": "0.0", "server.performance.avgDiskWriteIOPS": "0.0", "server.performance.numNetworkCards": "2", "server.hypervisor": "xen", "server.networkInterfaceInfo.hasMoreValues": "false", "server.performance.avgNetworkWritesPerSecondInKB": "0.1380859375", "server.osName": "Linux - Amazon Linux AMI release 2015.03", "server.performance.totalRAMInKB": "1694732.0", "server.cpuType": "x64" }, { "server.performance.maxCpuUsagePct": "100.0", "server.performance.maxDiskReadIOPS": "0.0", "server.performance.avgCpuUsagePct": "14.733333333333338", "server.type": "EC2", "server.performance.maxNetworkReadsPerSecondInKB": "13.400390625", "server.hostName": "ip-172-31-42-208", "server.configurationId": "d-server-099385097ef9fbcfb", "server.tags.hasMoreValues": "false", "server.performance.minFreeRAMInKB": "1531104.0", "server.osVersion": "3.14.48-33.39.amzn1.x86_64", "server.performance.maxDiskReadsPerSecondInKB": "0.0", "server.applications": "[]", "server.performance.numDisks": "1", "server.performance.numCpus": "1", "server.performance.numCores": "1", "server.performance.maxDiskWriteIOPS": "1.0", "server.performance.maxNetworkWritesPerSecondInKB": "12.271484375", "server.performance.avgDiskWritesPerSecondInKB": "0.5333333333333334", "server.networkInterfaceInfo": "[{\"name\":\"eth0\",\"macAddress\":\"06:4A:79:60:75:61\",\"ipAddress\":\"172.31.42.208\",\"netMask\":\"255.255.240.0\"},{\"name\":\"eth0\",\"macAddress\":\"06:4A:79:60:75:61\",\"ipAddress\":\"fe80::44a:79ff:fe60:7561\"},{\"name\":\"lo\",\"macAddress\":\"00:00:00:00:00:00\",\"ipAddress\":\"::1\"},{\"name\":\"lo\",\"macAddress\":\"00:00:00:00:00:00\",\"ipAddress\":\"127.0.0.1\",\"netMask\":\"255.0.0.0\"}]", "server.performance.avgNetworkReadsPerSecondInKB": "2.8720052083333334", "server.tags": "[]", "server.applications.hasMoreValues": "false", "server.timeOfCreation": "2016-10-28 23:44:30.0", "server.agentId": "i-c142b99e", "server.performance.maxDiskWritesPerSecondInKB": "4.0", "server.performance.avgDiskReadIOPS": "0.0", "server.performance.avgFreeRAMInKB": "1534946.4", "server.performance.avgDiskReadsPerSecondInKB": "0.0", "server.performance.avgDiskWriteIOPS": "0.13333333333333336", "server.performance.numNetworkCards": "2", "server.hypervisor": "xen", "server.networkInterfaceInfo.hasMoreValues": "false", "server.performance.avgNetworkWritesPerSecondInKB": "1.7977864583333332", "server.osName": "Linux - Amazon Linux AMI release 2015.03", "server.performance.totalRAMInKB": "1694732.0", "server.cpuType": "x64" } ] } ``` **Beschreiben ausgewählter Komponentenkonfigurationen** Dieser Beispielbefehl beschreibt die Konfigurationen von zwei angegebenen Anwendungen. Die Aktion erkennt den Komponententyp anhand der Konfigurations-ID. Pro Befehl ist nur ein Komponententyp zulässig. Befehl: ``` aws discovery describe-configurations --configuration-ids "d-application-0ac39bc0e4fad0e42" "d-application-02444a45288013764q" ``` Ausgabe: ``` { "configurations": [ { "application.serverCount": "0", "application.name": "Application-12345", "application.lastModifiedTime": "2016-12-13 23:53:27.0", "application.description": "", "application.timeOfCreation": "2016-12-13 23:53:27.0", "application.configurationId": "d-application-0ac39bc0e4fad0e42" }, { "application.serverCount": "0", "application.name": "Application-67890", "application.lastModifiedTime": "2016-12-13 23:53:33.0", "application.description": "", "application.timeOfCreation": "2016-12-13 23:53:33.0", "application.configurationId": "d-application-02444a45288013764" } ] } ``` + Einzelheiten zur API finden Sie [DescribeConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/discovery/describe-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `list-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-configurations`. **AWS CLI** **So listen Sie alle erkannten Server auf, die eine Reihe von Filterbedingungen erfüllen** Dieser Beispielbefehl listet die erkannten Server auf, die einem von zwei Hostnamenmustern entsprechen und auf denen nicht Ubuntu ausgeführt wird. Befehl: ``` aws discovery list-configurations --configuration-type SERVER --filters name="server.hostName",values="172-31-35","172-31-42",condition="CONTAINS" name="server.osName",values="Ubuntu",condition="NOT_CONTAINS" ``` Ausgabe: ``` { "configurations": [ { "server.osVersion": "3.14.48-33.39.amzn1.x86_64", "server.type": "EC2", "server.hostName": "ip-172-31-42-208", "server.timeOfCreation": "2016-10-28 23:44:30.0", "server.configurationId": "d-server-099385097ef9fbcfb", "server.osName": "Linux - Amazon Linux AMI release 2015.03", "server.agentId": "i-c142b99e" }, { "server.osVersion": "3.14.48-33.39.amzn1.x86_64", "server.type": "EC2", "server.hostName": "ip-172-31-35-152", "server.timeOfCreation": "2016-10-28 23:44:00.0", "server.configurationId": "d-server-0c4f2dd1fee22c6c1", "server.osName": "Linux - Amazon Linux AMI release 2015.03", "server.agentId": "i-4447bc1b" } ] } ``` + Einzelheiten zur API finden Sie [ListConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/discovery/list-configurations.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Anwendungssignale mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Application Signals Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-get-service-level-objective-budget-report` Das folgende Codebeispiel zeigt die Verwendung von`batch-get-service-level-objective-budget-report`. **AWS CLI** **So rufen Sie einen oder mehrere SLO-Budgetberichte (Service Level Objective) ab.** Im folgenden Beispiel für `batch-get-service-level-objective-budget-report` werden einzelne oder mehrere SLO-Budgetberichte (Service Level Objective) abgerufen. ``` aws application-signals batch-get-service-level-objective-budget-report \ --timestamp 1735059869 \ --slo-ids "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName1" "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName2" ``` Ausgabe: ``` { "Timestamp": "2024-12-24T22:34:29+05:30", "Reports": [{ "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName1", "Name": "Your SLO Name", "EvaluationType": "PeriodBased", "BudgetStatus": "OK", "Attainment": 100.0, "TotalBudgetSeconds": 6048, "BudgetSecondsRemaining": 6048, "Sli": { "SliMetric": { "MetricDataQueries": [{ "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{ "Name": "InstanceId", "Value": "i-0e098765432522" }] }, "Period": 60, "Stat": "Average" }, "ReturnData": true }] }, "MetricThreshold": 200.0, "ComparisonOperator": "LessThanOrEqualTo" }, "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 99.0, "WarningThreshold": 50.0 } }, { "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName2", "Name": "test", "EvaluationType": "PeriodBased", "BudgetStatus": "BREACHED", "Attainment": 97.39583275, "TotalBudgetSeconds": 86, "BudgetSecondsRemaining": -2154, "Sli": { "SliMetric": { "MetricDataQueries": [{ "Id": "cwMetric", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{ "Name": "InstanceId", "Value": "i-0e12345678922" }] }, "Period": 300, "Stat": "Average" }, "ReturnData": true }] }, "MetricThreshold": 5.0, "ComparisonOperator": "GreaterThan" }, "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 1 } }, "AttainmentGoal": 99.9, "WarningThreshold": 30.0 } } ], "Errors": [] } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [BatchGetServiceLevelObjectiveBudgetReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/batch-get-service-level-objective-budget-report.html)in der *AWS CLI Befehlsreferenz*. ### `create-service-level-objective` Das folgende Codebeispiel zeigt die Verwendung`create-service-level-objective`. **AWS CLI** **So erstellen Sie ein Service Level Objective (SLO)** Im folgenden Beispiel für `create-service-level-objective` wird ein Service Level Objective (SLO) erstellt, mit dem Sie sicherstellen können, dass Ihre kritischen Geschäftsabläufe den Kundenerwartungen entsprechen. ``` aws application-signals create-service-level-objective \ --name "SLOName" \ --description "Description of your SLO" \ --sli-config file://sli-config.json ``` Inhalt von `sli-config.json`: ``` { "SliMetricConfig": { "MetricDataQueries": [ { "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0e5a1234561522" } ] }, "Period": 60, "Stat": "Average" }, "ReturnData": true } ] }, "MetricThreshold": 200, "ComparisonOperator": "LessThanOrEqualTo" } ``` Ausgabe: ``` { "Slo": { "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName", "Name": "SLOName", "Description": "Description of your SLO", "CreatedTime": "2024-12-27T08:16:09.032000+05:30", "LastUpdatedTime": "2024-12-27T08:16:09.032000+05:30", "Sli": { "SliMetric": { "MetricDataQueries": [ { "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0e59876543234522" } ] }, "Period": 60, "Stat": "Average" }, "ReturnData": true } ] }, "MetricThreshold": 200.0, "ComparisonOperator": "LessThanOrEqualTo" }, "EvaluationType": "PeriodBased", "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 99.0, "WarningThreshold": 50.0 } } } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateServiceLevelObjective](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/create-service-level-objective.html)in der *AWS CLI Befehlsreferenz*. ### `delete-service-level-objective` Das folgende Codebeispiel zeigt die Verwendung`delete-service-level-objective`. **AWS CLI** **So löschen Sie das angegebene Service Level Objective.** Im folgenden Beispiel für `delete-service-level-objective` wird das angegebene Service Level Objective gelöscht. ``` aws application-signals delete-service-level-objective \ --id "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteServiceLevelObjective](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/delete-service-level-objective.html)in der *AWS CLI Befehlsreferenz*. ### `get-service-level-objective` Das folgende Codebeispiel zeigt die Verwendung`get-service-level-objective`. **AWS CLI** **So geben Sie Informationen über ein im Konto erstelltes SLO zurück** Im folgenden Beispiel für `get-service-level-objective` werden Informationen über ein im Konto erstelltes SLO zurückgegeben. ``` aws application-signals get-service-level-objective \ --id "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName" ``` Ausgabe: ``` { "Slo": { "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName", "Name": "SLOName", "Description": "Description of your SLO", "CreatedTime": "2024-12-24T22:19:18.624000+05:30", "LastUpdatedTime": "2024-12-24T22:19:55.280000+05:30", "Sli": { "SliMetric": { "MetricDataQueries": [{ "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{ "Name": "InstanceId", "Value": "i-0e0987654321522" }] }, "Period": 60, "Stat": "Average" }, "ReturnData": true }] }, "MetricThreshold": 200.0, "ComparisonOperator": "LessThanOrEqualTo" }, "EvaluationType": "PeriodBased", "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 99.0, "WarningThreshold": 50.0 } } } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetServiceLevelObjective](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/get-service-level-objective.html)in der *AWS CLI Befehlsreferenz*. ### `get-service` Das folgende Codebeispiel zeigt die Verwendung`get-service`. **AWS CLI** **So geben Sie Informationen über einen von Application Signals erkannten Service zurück** Im folgenden Beispiel für `get-service` werden Informationen über einen von Application Signals erkannten Service zurückgegeben. ``` aws application-signals get-service \ --start-time 1732704000 \ --end-time 1732714500 \ --key-attributes Environment=lambda:default,Name=hello-world-python,Type=Service ``` Ausgabe: ``` { "Service": { "KeyAttributes": { "Environment": "lambda:default", "Name": "hello-world-python", "Type": "Service" }, "AttributeMaps": [{ "Lambda.Function.Name": "hello-world-python", "PlatformType": "AWS::Lambda" }], "MetricReferences": [{ "Namespace": "ApplicationSignals", "MetricType": "LATENCY", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Latency" }, { "Namespace": "ApplicationSignals", "MetricType": "FAULT", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Fault" }, { "Namespace": "ApplicationSignals", "MetricType": "ERROR", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Error" }], "LogGroupReferences": [{ "Identifier": "/aws/lambda/hello-world-python", "ResourceType": "AWS::Logs::LogGroup", "Type": "AWS::Resource" }] }, "StartTime": "2024-11-27T10:00:00+00:00", "EndTime": "2024-11-27T14:00:01+00:00", "LogGroupReferences": [{ "Identifier": "/aws/lambda/hello-world-python", "ResourceType": "AWS::Logs::LogGroup", "Type": "AWS::Resource" }] } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/get-service.html)in der *AWS CLI Befehlsreferenz*. ### `list-service-dependencies` Das folgende Codebeispiel zeigt die Verwendung`list-service-dependencies`. **AWS CLI** **So geben Sie eine Liste der Serviceabhängigkeiten des von Ihnen angegebenen Service zurück** Im folgenden Beispiel für `list-service-dependencies` wird eine Liste der Serviceabhängigkeiten des von Ihnen angegebenen Service zurückgegeben. ``` aws application-signals list-service-dependencies \ --start-time 1732021200 \ --end-time 1732107600 \ --key-attributes Environment=api-gateway:prod, Name=PetAdoptionStatusUpdater,Type=Service ``` Ausgabe: ``` { "ServiceDependencies": [{ "OperationName": "PUT /prod", "DependencyKeyAttributes": { "Environment": "lambda:default", "Name": "Services-name", "Type": "Service" }, "DependencyOperationName": "Invoke", "MetricReferences": [{ "Namespace": "ApplicationSignals", "MetricType": "LATENCY", "Dimensions": [{ "Name": "Environment", "Value": "api-gateway:prod" }, { "Name": "Operation", "Value": "PUT /prod" }, { "Name": "RemoteEnvironment", "Value": "lambda:default" }, { "Name": "RemoteOperation", "Value": "Invoke" }, { "Name": "RemoteService", "Value": "Services-name" }, { "Name": "Service", "Value": "PetAdoptionStatusUpdater" }], "MetricName": "Latency" }, { "Namespace": "ApplicationSignals", "MetricType": "FAULT", "Dimensions": [{ "Name": "Environment", "Value": "api-gateway:prod" }, { "Name": "Operation", "Value": "PUT /prod" }, { "Name": "RemoteEnvironment", "Value": "lambda:default" }, { "Name": "RemoteOperation", "Value": "Invoke" }, { "Name": "RemoteService", "Value": "Services-name" }, { "Name": "Service", "Value": "PetAdoptionStatusUpdater" }], "MetricName": "Fault" }, { "Namespace": "ApplicationSignals", "MetricType": "ERROR", "Dimensions": [{ "Name": "Environment", "Value": "api-gateway:prod" }, { "Name": "Operation", "Value": "PUT /prod" }, { "Name": "RemoteEnvironment", "Value": "lambda:default" }, { "Name": "RemoteOperation", "Value": "Invoke" }, { "Name": "RemoteService", "Value": "Services-name" }, { "Name": "Service", "Value": "PetAdoptionStatusUpdater" }], "MetricName": "Error" }] }], "StartTime": "2024-11-19T13:00:00+00:00", "EndTime": "2024-11-20T13:00:01+00:00" } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListServiceDependencies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/list-service-dependencies.html)in der *AWS CLI Befehlsreferenz*. ### `list-service-dependents` Das folgende Codebeispiel zeigt die Verwendung`list-service-dependents`. **AWS CLI** **So geben Sie die Liste der abhängigen Objekte zurück, die den angegebenen Service während des angegebenen Zeitraums aufgerufen haben** Im folgenden Beispiel für `list-service-dependents` wird die Liste der abhängigen Objekte zurückgegeben, die den angegebenen Service während des angegebenen Zeitraums aufgerufen haben. ``` aws application-signals list-service-dependents \ --start-time 1732021200 \ --end-time 1732107600 \ --key-attributes Environment=generic:default,Name=PetSite,Type=Service ``` Ausgabe: ``` { "ServiceDependents": [{ "OperationName": "", "DependentKeyAttributes": { "Identifier": "pet-api-canary-hao", "ResourceType": "AWS::Synthetics::Canary", "Type": "AWS::Resource" }, "DependentOperationName": "", "MetricReferences": [] }, { "OperationName": "", "DependentKeyAttributes": { "Identifier": "PetSite", "ResourceType": "AWS::Synthetics::Canary", "Type": "AWS::Resource" }, "DependentOperationName": "", "MetricReferences": [] }], "StartTime": "2024-12-24T05:00:00+00:00", "EndTime": "2024-12-25T06:00:01+00:00" } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListServiceDependents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/list-service-dependents.html)in der *AWS CLI Befehlsreferenz*. ### `list-service-level-objectives` Das folgende Codebeispiel zeigt die Verwendung`list-service-level-objectives`. **AWS CLI** **Um eine Liste der in diesem Konto SLOs erstellten Dateien zurückzugeben.** Das folgende `list-service-level-objectives` Beispiel gibt eine Liste der in diesem Konto SLOs erstellten Dateien zurück. ``` aws application-signals list-service-level-objectives ``` Ausgabe: ``` { "SloSummaries": [{ "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/test", "Name": "test", "CreatedTime": "2024-12-24T22:01:21.116000+05:30" }] } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListServiceLevelObjectives](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/list-service-level-objectives.html)in der *AWS CLI Befehlsreferenz*. ### `list-service-operations` Das folgende Codebeispiel zeigt die Verwendung`list-service-operations`. **AWS CLI** **So geben Sie eine Liste der Operationen dieses Service zurück, die von Application Signals erkannt wurden** Im folgenden Beispiel für `list-service-operations` wird eine Liste der Operationen dieses Service zurückgegeben, die von Application Signals erkannt wurden. ``` aws application-signals list-service-operations \ --start-time 1735017423 \ --end-time 1735103823 \ --key-attributes Environment=generic:default,Name=payforadoption,Type=Service ``` Ausgabe: ``` { "ServiceOperations": [{ "Name": "POST /api", "MetricReferences": [{ "Namespace": "ApplicationSignals", "MetricType": "LATENCY", "Dimensions": [{ "Name": "Environment", "Value": "generic:default" }, { "Name": "Operation", "Value": "POST /api" }, { "Name": "Service", "Value": "payforadoption" }], "MetricName": "Latency" }, { "Namespace": "ApplicationSignals", "MetricType": "FAULT", "Dimensions": [{ "Name": "Environment", "Value": "generic:default" }, { "Name": "Operation", "Value": "POST /api" }, { "Name": "Service", "Value": "payforadoption" }], "MetricName": "Fault" }, { "Namespace": "ApplicationSignals", "MetricType": "ERROR", "Dimensions": [{ "Name": "Environment", "Value": "generic:default" }, { "Name": "Operation", "Value": "POST /api" }, { "Name": "Service", "Value": "payforadoption" }], "MetricName": "Error" }] }], "StartTime": "2024-12-24T05:00:00+00:00", "EndTime": "2024-12-25T06:00:01+00:00" } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListServiceOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/list-service-operations.html)in der *AWS CLI Befehlsreferenz*. ### `list-services` Das folgende Codebeispiel zeigt die Verwendung`list-services`. **AWS CLI** **So geben Sie eine Liste der Services zurück, die von Application Signals erkannt wurden** Im folgenden Beispiel für `list-services` wird eine Liste der Services zurückgegeben, die von Application Signals erkannt wurden. ``` aws application-signals list-services \ --start-time 1734918791 \ --end-time 1734965591 ``` Ausgabe: ``` { "ServiceSummaries": [{ "KeyAttributes": { "Environment": "lambda:default", "Name": "hello-world-python", "Type": "Service" }, "AttributeMaps": [{ "Lambda.Function.Name": "hello-world-python", "PlatformType": "AWS::Lambda" }], "MetricReferences": [{ "Namespace": "ApplicationSignals", "MetricType": "LATENCY", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Latency" }, { "Namespace": "ApplicationSignals", "MetricType": "FAULT", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Fault" }, { "Namespace": "ApplicationSignals", "MetricType": "ERROR", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Error" }] }], "StartTime": "2024-11-27T10:00:00+00:00", "EndTime": "2024-11-27T14:00:01+00:00" } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/list-services.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Um die mit einer CloudWatch Ressource verknüpften Tags anzuzeigen** Im folgenden `list-tags-for-resource` Beispiel werden die mit einer CloudWatch Ressource verknüpften Tags angezeigt. ``` aws application-signals list-tags-for-resource \ --resource-arn "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName" ``` Ausgabe: ``` { "Tags": [{ "Key": "test", "Value": "value" }] } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `start-discovery` Das folgende Codebeispiel zeigt die Verwendung`start-discovery`. **AWS CLI** **Um dieses Amazon Web Services Services-Konto für die Nutzung von CloudWatch Application Signals zu aktivieren** Das folgende `start-discovery` Beispiel ermöglicht es diesem Amazon Web Services Services-Konto, CloudWatch Application Signals zu verwenden, indem die *AWS ServiceRoleForCloudWatchApplicationSignals*serviceverknüpfte Rolle erstellt wird. ``` aws application-signals start-discovery ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartDiscovery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/start-discovery.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Um der angegebenen CloudWatch Ressource ein oder mehrere Tags (Schlüssel-Wert-Paare) zuzuweisen, z. B. ein Service Level Objective** Im folgenden `tag-resource` Beispiel werden der angegebenen CloudWatch Ressource ein oder mehrere Tags (Schlüssel-Wert-Paare) zugewiesen, z. B. einem Service Level Objective. ``` aws application-signals tag-resource \ --resource-arn "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName" \ --tags '{"Key":"test","Value":"value"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie einzelne oder mehrere Tags aus der angegebenen Ressource** Im folgenden Beispiel für `untag-resource` werden einzelne oder mehrere Tags von der angegebenen Ressource entfernt. ``` aws application-signals untag-resource \ --resource-arn "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName" \ --tag-keys "test" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-service-level-objective` Das folgende Codebeispiel zeigt die Verwendung`update-service-level-objective`. **AWS CLI** **So aktualisieren Sie ein vorhandenes Service Level Objective (SLO)** Im folgenden Beispiel für `update-service-level-objective` wird ein vorhandenes Service Level Objective (SLO) aktualisiert. ``` aws application-signals update-service-level-objective \ --cli-input-json file://update-slo.json ``` Inhalt von `update-slo.json`: ``` { "id": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName", "goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 90.0, "WarningThreshold": 50.0 } } ``` Ausgabe: ``` { "Slo": { "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName", "Name": "SLOName", "Description": "Description of your SLO", "CreatedTime": "2024-12-24T22:19:18.624000+05:30", "LastUpdatedTime": "2024-12-27T08:51:38.278000+05:30", "Sli": { "SliMetric": { "MetricDataQueries": [{ "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{ "Name": "InstanceId", "Value": "i-00987654345222" }] }, "Period": 60, "Stat": "Average" }, "ReturnData": true }] }, "MetricThreshold": 200.0, "ComparisonOperator": "LessThanOrEqualTo" }, "EvaluationType": "PeriodBased", "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 90.0, "WarningThreshold": 50.0 } } } ``` Weitere Informationen finden Sie unter [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateServiceLevelObjective](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-signals/update-service-level-objective.html)in der *AWS CLI Befehlsreferenz*. # AppRegistry Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AppRegistry. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-attribute-group` Das folgende Codebeispiel zeigt, wie Sie`associate-attribute-group`. **AWS CLI** **So ordnen Sie eine Attributgruppe zu** Das folgende `associate-attribute-group` Beispiel ordnet eine bestimmte Attributgruppe in Ihrem AWS Konto einer bestimmten Anwendung in Ihrem AWS Konto zu. ``` aws servicecatalog-appregistry associate-attribute-group \ --application "ExampleApplication" \ --attribute-group "ExampleAttributeGroup" ``` Ausgabe: ``` { "applicationArn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l", "attributeGroupArn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl" } ``` Weitere Informationen finden Sie unter [Attributgruppen zuordnen und deren Zuordnung aufheben](https://docs.aws.amazon.com/servicecatalog/latest/arguide/associate-attr-groups.html) im *AWS Service AppRegistry Catalog-Administratorhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [AssociateAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/associate-attribute-group.html).AWS CLI * ### `create-application` Das folgende Codebeispiel zeigt die Verwendung`create-application`. **AWS CLI** **So erstellen Sie eine Anwendung** Das folgende `create-application` Beispiel erstellt eine neue Anwendung in Ihrem AWS Konto. ``` aws servicecatalog-appregistry create-application \ --name "ExampleApplication" ``` Ausgabe: ``` { "application": { "id": "0ars38r6btoohvpvd9gqrptt9l", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l", "name": "ExampleApplication", "creationTime": "2023-02-28T21:10:10.820000+00:00", "lastUpdateTime": "2023-02-28T21:10:10.820000+00:00", "tags": {} } } ``` Weitere Informationen finden Sie unter [Erstellen von Anwendungen](https://docs.aws.amazon.com/servicecatalog/latest/arguide/create-apps.html) im *AWS Service AppRegistry Catalog-Administratorhandbuch*. + Einzelheiten zur API finden Sie [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/create-application.html)unter *AWS CLI Befehlsreferenz*. ### `create-attribute-group` Das folgende Codebeispiel zeigt die Verwendung`create-attribute-group`. **AWS CLI** **So erstellen Sie eine Attributgruppe** Das folgende `create-attribute-group` Beispiel erstellt eine neue Attributgruppe in Ihrem AWS Konto. ``` aws servicecatalog-appregistry create-attribute-group \ --name "ExampleAttributeGroup" \ --attributes '{"SomeKey1":"SomeValue1","SomeKey2":"SomeValue2"}' ``` Ausgabe: ``` { "attributeGroup": { "id": "01sj5xdwhbw54kejwnt09fnpcl", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl", "name": "ExampleAttributeGroup", "creationTime": "2023-02-28T20:38:01.389000+00:00", "lastUpdateTime": "2023-02-28T20:38:01.389000+00:00", "tags": {} } } ``` Weitere Informationen finden Sie unter [Erstellen von Attributgruppen](https://docs.aws.amazon.com/servicecatalog/latest/arguide/create-attr-groups.html) im *AWS Service AppRegistry Catalog-Administratorhandbuch*. + Einzelheiten zur API finden Sie [CreateAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/create-attribute-group.html)unter *AWS CLI Befehlsreferenz*. ### `delete-application` Das folgende Codebeispiel zeigt die Verwendung`delete-application`. **AWS CLI** **So löschen Sie eine Anwendung** Im folgenden `delete-application` Beispiel wird eine bestimmte Anwendung in Ihrem AWS Konto gelöscht. ``` aws servicecatalog-appregistry delete-application \ --application "ExampleApplication3" ``` Ausgabe: ``` { "application": { "id": "055gw7aynr1i5mbv7kjwzx5945", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/055gw7aynr1i5mbv7kjwzx5945", "name": "ExampleApplication3", "creationTime": "2023-02-28T22:06:28.228000+00:00", "lastUpdateTime": "2023-02-28T22:06:28.228000+00:00" } } ``` Weitere Informationen finden Sie unter [Löschen von Anwendungen](https://docs.aws.amazon.com/servicecatalog/latest/arguide/delete-app-details.html) im *AWS Service AppRegistry Catalog-Administratorhandbuch*. + Einzelheiten zur API finden Sie [DeleteApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/delete-application.html)unter *AWS CLI Befehlsreferenz*. ### `delete-attribute-group` Das folgende Codebeispiel zeigt die Verwendung`delete-attribute-group`. **AWS CLI** **Beispiel 8: So löschen Sie eine Attributgruppe** Das folgende `delete-attribute-group` Beispiel löscht eine bestimmte Attributgruppe in Ihrem AWS Konto. ``` aws servicecatalog-appregistry delete-attribute-group \ --attribute-group "ExampleAttributeGroup3" ``` Ausgabe: ``` { "attributeGroup": { "id": "011ge6y3emyjijt8dw8jn6r0hv", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/011ge6y3emyjijt8dw8jn6r0hv", "name": "ExampleAttributeGroup3", "creationTime": "2023-02-28T22:05:35.224000+00:00", "lastUpdateTime": "2023-02-28T22:05:35.224000+00:00" } } ``` Weitere Informationen finden Sie unter [Löschen von Attributgruppen](https://docs.aws.amazon.com/servicecatalog/latest/arguide/delete-attr-group.html) im *AWS Service Catalog AppRegistry Administrator Guide*. + Einzelheiten zur API finden Sie [DeleteAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/delete-attribute-group.html)unter *AWS CLI Befehlsreferenz*. ### `get-application` Das folgende Codebeispiel zeigt die Verwendung`get-application`. **AWS CLI** **So rufen Sie eine Anwendung ab** Im folgenden `get-application` Beispiel werden Metadateninformationen zu einer bestimmten Anwendung in Ihrem AWS Konto abgerufen. ``` aws servicecatalog-appregistry get-application \ --application "ExampleApplication" ``` Ausgabe: ``` { "id": "0ars38r6btoohvpvd9gqrptt9l", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l", "name": "ExampleApplication", "creationTime": "2023-02-28T21:10:10.820000+00:00", "lastUpdateTime": "2023-02-28T21:10:10.820000+00:00", "associatedResourceCount": 0, "tags": { "aws:servicecatalog:applicationName": "ExampleApplication" }, "integrations": { "resourceGroup": { "state": "CREATE_COMPLETE", "arn": "arn:aws:resource-groups:us-west-2:813737243517:group/AWS_AppRegistry_Application-ExampleApplication" } } } ``` Weitere Informationen finden Sie unter [Verwenden von Anwendungsdetails](https://docs.aws.amazon.com/servicecatalog/latest/arguide/access-app-details.html) im *AWS Service AppRegistry Catalog-Administratorhandbuch*. + Einzelheiten zur API finden Sie [GetApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/get-application.html)unter *AWS CLI Befehlsreferenz*. ### `get-attribute-group` Das folgende Codebeispiel zeigt die Verwendung`get-attribute-group`. **AWS CLI** **So rufen Sie eine Attributgruppe ab** Im folgenden `get-attribute-group` Beispiel wird eine bestimmte Attributgruppe in Ihrem AWS Konto abgerufen. ``` aws servicecatalog-appregistry get-attribute-group \ --attribute-group "ExampleAttributeGroup" ``` Ausgabe: ``` { "id": "01sj5xdwhbw54kejwnt09fnpcl", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl", "name": "ExampleAttributeGroup", "attributes": "{\"SomeKey1\":\"SomeValue1\",\"SomeKey2\":\"SomeValue2\"}", "creationTime": "2023-02-28T20:38:01.389000+00:00", "lastUpdateTime": "2023-02-28T20:38:01.389000+00:00", "tags": { "aws:servicecatalog:attributeGroupName": "ExampleAttributeGroup" } } ``` Weitere Informationen finden Sie unter [Verwalten von Metadaten für Attributgruppen](https://docs.aws.amazon.com/servicecatalog/latest/arguide/manage-metatdata.html) im *AWS Service AppRegistry Catalog-Administratorhandbuch*. + Einzelheiten zur API finden Sie [GetAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/get-attribute-group.html)unter *AWS CLI Befehlsreferenz*. ### `list-applications` Das folgende Codebeispiel zeigt die Verwendung`list-applications`. **AWS CLI** **So listen Sie Anwendungen auf** Im folgenden `list-applications` Beispiel wird eine Liste aller Anwendungen in Ihrem AWS Konto abgerufen. ``` aws servicecatalog-appregistry list-applications ``` Ausgabe: ``` { "applications": [ { "id": "03axw94pjfj3uan00tcgbrxnkw", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/03axw94pjfj3uan00tcgbrxnkw", "name": "ExampleApplication2", "creationTime": "2023-02-28T21:59:34.094000+00:00", "lastUpdateTime": "2023-02-28T21:59:34.094000+00:00" }, { "id": "055gw7aynr1i5mbv7kjwzx5945", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/055gw7aynr1i5mbv7kjwzx5945", "name": "ExampleApplication3", "creationTime": "2023-02-28T22:06:28.228000+00:00", "lastUpdateTime": "2023-02-28T22:06:28.228000+00:00" }, { "id": "0ars38r6btoohvpvd9gqrptt9l", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l", "name": "ExampleApplication", "description": "This is an example application", "creationTime": "2023-02-28T21:10:10.820000+00:00", "lastUpdateTime": "2023-02-28T21:24:19.729000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen von Anwendungsdetails](https://docs.aws.amazon.com/servicecatalog/latest/arguide/view-app-details.html) im *AWS Service AppRegistry Catalog-Administratorhandbuch*. + Einzelheiten zur API finden Sie [ListApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-applications.html)unter *AWS CLI Befehlsreferenz*. ### `list-associated-attribute-groups` Das folgende Codebeispiel zeigt die Verwendung`list-associated-attribute-groups`. **AWS CLI** **So listen Sie die zugehörigen Attributgruppen auf** Im folgenden `list-associated-attribute-groups` Beispiel wird eine Liste aller Attributgruppen in Ihrem AWS Konto abgerufen, die einer bestimmten Anwendung in Ihrem AWS Konto zugeordnet sind. ``` aws servicecatalog-appregistry list-associated-attribute-groups \ --application "ExampleApplication" ``` Ausgabe: ``` { "attributeGroups": [ "01sj5xdwhbw54kejwnt09fnpcl" ] } ``` Weitere Informationen finden Sie unter [Attributgruppen zuordnen und deren Zuordnung aufheben](https://https://docs.aws.amazon.com/servicecatalog/latest/arguide/associate-attr-groups.html) im *AWS Service AppRegistry Catalog-Administratorhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [ListAssociatedAttributeGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-associated-attribute-groups.html).AWS CLI * ### `list-attribute-groups-for-application` Das folgende Codebeispiel zeigt die Verwendung`list-attribute-groups-for-application`. **AWS CLI** **So listen Sie Attributgruppen für eine Anwendung auf** Im folgenden `list-attribute-groups-for-application` Beispiel werden die Details aller Attributgruppen in Ihrem AWS Konto aufgeführt, die einer bestimmten Anwendung in Ihrem AWS Konto zugeordnet sind. ``` aws servicecatalog-appregistry list-attribute-groups-for-application \ --application "ExampleApplication" ``` Ausgabe: ``` { "attributeGroupsDetails": [ { "id": "01sj5xdwhbw54kejwnt09fnpcl", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl", "name": "ExampleAttributeGroup" } ] } ``` Weitere Informationen finden Sie unter [Attributgruppendetails anzeigen](https://servicecatalog/latest/arguide/view-attr-group.html) im *AWS Service Catalog AppRegistry Administrator Guide*. + Einzelheiten zur API finden Sie [ListAttributeGroupsForApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-attribute-groups-for-application.html)unter *AWS CLI Befehlsreferenz*. ### `list-attribute-groups` Das folgende Codebeispiel zeigt die Verwendung`list-attribute-groups`. **AWS CLI** **So listen Sie Attributgruppen auf** Im folgenden `list-attribute-groups` Beispiel wird eine Liste aller Attributgruppen in Ihrem AWS Konto abgerufen. ``` aws servicecatalog-appregistry list-attribute-groups ``` Ausgabe: ``` { "attributeGroups": [ { "id": "011ge6y3emyjijt8dw8jn6r0hv", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/011ge6y3emyjijt8dw8jn6r0hv", "name": "ExampleAttributeGroup3", "creationTime": "2023-02-28T22:05:35.224000+00:00", "lastUpdateTime": "2023-02-28T22:05:35.224000+00:00" }, { "id": "01sj5xdwhbw54kejwnt09fnpcl", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl", "name": "ExampleAttributeGroup", "description": "This is an example attribute group", "creationTime": "2023-02-28T20:38:01.389000+00:00", "lastUpdateTime": "2023-02-28T21:02:04.559000+00:00" }, { "id": "03n1yffgq6d18vwrzxf0c70nm3", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/03n1yffgq6d18vwrzxf0c70nm3", "name": "ExampleAttributeGroup2", "creationTime": "2023-02-28T21:57:30.687000+00:00", "lastUpdateTime": "2023-02-28T21:57:30.687000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Attributgruppendetails anzeigen](https://docs.aws.amazon.com/servicecatalog/latest/arguide/view-attr-group.html) im *AWS Service Catalog AppRegistry Administrator Guide*. + Einzelheiten zur API finden Sie [ListAttributeGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-attribute-groups.html)unter *AWS CLI Befehlsreferenz*. ### `update-application` Das folgende Codebeispiel zeigt die Verwendung`update-application`. **AWS CLI** **So aktualisieren Sie eine Anwendung** Im folgenden `update-application` Beispiel wird eine bestimmte Anwendung in Ihrem AWS Konto aktualisiert, sodass sie eine Beschreibung enthält. ``` aws servicecatalog-appregistry update-application \ --application "ExampleApplication" \ --description "This is an example application" ``` Ausgabe: ``` { "application": { "id": "0ars38r6btoohvpvd9gqrptt9l", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l", "name": "ExampleApplication", "description": "This is an example application", "creationTime": "2023-02-28T21:10:10.820000+00:00", "lastUpdateTime": "2023-02-28T21:24:19.729000+00:00", "tags": { "aws:servicecatalog:applicationName": "ExampleApplication" } } } ``` Weitere Informationen finden Sie unter [Bearbeiten von Anwendungen](https://docs.aws.amazon.com/servicecatalog/latest/arguide/edit-apps.html) im *AWS Service AppRegistry Catalog-Administratorhandbuch*. + Einzelheiten zur API finden Sie [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/update-application.html)in der *AWS CLI Befehlsreferenz*. ### `update-attribute-group` Das folgende Codebeispiel zeigt die Verwendung`update-attribute-group`. **AWS CLI** **So aktualisieren Sie eine Attributgruppe** Im folgenden `update-attribute-group` Beispiel wird eine bestimmte Attributgruppe in Ihrem AWS Konto aktualisiert, sodass sie eine Beschreibung enthält. ``` aws servicecatalog-appregistry update-attribute-group \ --attribute-group "ExampleAttributeGroup" \ --description "This is an example attribute group" ``` Ausgabe: ``` { "attributeGroup": { "id": "01sj5xdwhbw54kejwnt09fnpcl", "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl", "name": "ExampleAttributeGroup", "description": "This is an example attribute group", "creationTime": "2023-02-28T20:38:01.389000+00:00", "lastUpdateTime": "2023-02-28T21:02:04.559000+00:00", "tags": { "aws:servicecatalog:attributeGroupName": "ExampleAttributeGroup" } } } ``` Weitere Informationen finden Sie unter [Bearbeiten von Attributgruppen](https://docs.aws.amazon.com/servicecatalog/latest/arguide/edit-attr-group.html) im *AWS Service Catalog AppRegistry Administrator Guide*. + Einzelheiten zur API finden Sie [UpdateAttributeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/update-attribute-group.html)unter *AWS CLI Befehlsreferenz*. # Athena-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Athena Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-get-named-query` Das folgende Codebeispiel zeigt, wie Sie`batch-get-named-query`. **AWS CLI** **So geben Sie Informationen zu mehr als einer Abfrage zurück** Das folgende `batch-get-named-query` Beispiel gibt Informationen zu den benannten Abfragen zurück, die den angegebenen Wert haben IDs. ``` aws athena batch-get-named-query \ --named-query-ids a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 a1b2c3d4-5678-90ab-cdef-EXAMPLE33333 ``` Ausgabe: ``` { "NamedQueries": [ { "Name": "Flights Select Query", "Description": "Sample query to get the top 10 airports with the most number of departures since 2000", "Database": "sampledb", "QueryString": "SELECT origin, count(*) AS total_departures\nFROM\nflights_parquet\nWHERE year >= '2000'\nGROUP BY origin\nORDER BY total_departures DESC\nLIMIT 10;", "NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "WorkGroup": "primary" }, { "Name": "Load flights table partitions", "Description": "Sample query to load flights table partitions using MSCK REPAIR TABLE statement", "Database": "sampledb", "QueryString": "MSCK REPAIR TABLE flights_parquet;", "NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "WorkGroup": "primary" }, { "Name": "CloudFront Select Query", "Description": "Sample query to view requests per operating system during a particular time frame", "Database": "sampledb", "QueryString": "SELECT os, COUNT(*) count FROM cloudfront_logs WHERE date BETWEEN date '2014-07-05' AND date '2014-08-05' GROUP BY os;", "NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "WorkGroup": "primary" } ], "UnprocessedNamedQueryIds": [] } ``` Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [BatchGetNamedQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/batch-get-named-query.html)unter *AWS CLI Befehlsreferenz*. ### `batch-get-query-execution` Das folgende Codebeispiel zeigt die Verwendung`batch-get-query-execution`. **AWS CLI** **So geben Sie Informationen zu einer oder mehreren Abfrageausführungen zurück** Im folgenden `batch-get-query-execution` Beispiel werden Informationen zur Abfrageausführung für die Abfragen zurückgegeben, die die angegebene Abfrage haben IDs. ``` aws athena batch-get-query-execution \ --query-execution-ids a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 ``` Ausgabe: ``` { "QueryExecutions": [ { "QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Query": "create database if not exists webdata", "StatementType": "DDL", "ResultConfiguration": { "OutputLocation": "s3://amzn-s3-demo-bucket/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.txt" }, "QueryExecutionContext": {}, "Status": { "State": "SUCCEEDED", "SubmissionDateTime": 1593470720.592, "CompletionDateTime": 1593470720.902 }, "Statistics": { "EngineExecutionTimeInMillis": 232, "DataScannedInBytes": 0, "TotalExecutionTimeInMillis": 310, "ResultConfiguration": { "QueryQueueTimeInMillis": 50, "ServiceProcessingTimeInMillis": 28 }, "WorkGroup": "AthenaAdmin" }, { "QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "Query": "select date, location, browser, uri, status from cloudfront_logs where method = 'GET' and status = 200 and location like 'SFO%' limit 10", "StatementType": "DML", "ResultConfiguration": { "OutputLocation": "s3://amzn-s3-demo-bucket/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222.csv" }, "QueryExecutionContext": { "Database": "mydatabase", "Catalog": "awsdatacatalog" }, "Status": { "State": "SUCCEEDED", "SubmissionDateTime": 1593469842.665, "CompletionDateTime": 1593469846.486 }, "Statistics": { "EngineExecutionTimeInMillis": 3600, "DataScannedInBytes": 203089, "TotalExecutionTimeInMillis": 3821, "QueryQueueTimeInMillis": 267, "QueryPlanningTimeInMillis": 1175 }, "WorkGroup": "AthenaAdmin" } ], "UnprocessedQueryExecutionIds": [] } ``` Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [BatchGetQueryExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/batch-get-query-execution.html)unter *AWS CLI Befehlsreferenz*. ### `create-data-catalog` Das folgende Codebeispiel zeigt die Verwendung`create-data-catalog`. **AWS CLI** **So erstellen Sie einen Datenkatalog** Im folgenden Beispiel für `create-data-catalog` wird der `dynamo_db_catalog`-Datenkatalog erstellt. ``` aws athena create-data-catalog \ --name dynamo_db_catalog \ --type LAMBDA \ --description "DynamoDB Catalog" \ --parameters function=arn:aws:lambda:us-west-2:111122223333:function:dynamo_db_lambda ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um das Ergebnis zu sehen, verwenden Sie `aws athena get-data-catalog --name dynamo_db_catalog`. Weitere Informationen finden Sie unter [Registrierung eines Katalogs: create-data-catalog](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-registering-a-catalog) im *Amazon Athena Athena-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateDataCatalog AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/create-data-catalog.html)*Befehlsreferenz.* ### `create-named-query` Das folgende Codebeispiel zeigt die Verwendung`create-named-query`. **AWS CLI** **So erstellen Sie eine benannte Abfrage** Im folgenden Beispiel für `create-named-query` wird eine gespeicherte Abfrage in der `AthenaAdmin`-Arbeitsgruppe erstellt, mit der die Tabelle `flights_parquet` nach Flügen von Seattle nach New York im Januar 2016 abgefragt wird, deren Abflug und Ankunft jeweils um mehr als zehn Minuten verspätet waren. Da es sich bei den Flughafencodewerten in der Tabelle um Zeichenfolgen handelt, die doppelte Anführungszeichen enthalten (z. B. „SEA“), werden sie durch umgekehrte Schrägstriche als Escape-Zeichen geschützt und von einfachen Anführungszeichen umgeben. ``` aws athena create-named-query \ --name "SEA to JFK delayed flights Jan 2016" \ --description "Both arrival and departure delayed more than 10 minutes." \ --database sampledb \ --query-string "SELECT flightdate, carrier, flightnum, origin, dest, depdelayminutes, arrdelayminutes FROM sampledb.flights_parquet WHERE yr = 2016 AND month = 1 AND origin = '\"SEA\"' AND dest = '\"JFK\"' AND depdelayminutes > 10 AND arrdelayminutes > 10" \ --work-group AthenaAdmin ``` Ausgabe: ``` { "NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [CreateNamedQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/create-named-query.html)in der *AWS CLI Befehlsreferenz*. ### `create-work-group` Das folgende Codebeispiel zeigt die Verwendung`create-work-group`. **AWS CLI** **So erstellen Sie eine Arbeitsgruppe** Im folgenden Beispiel für `create-work-group` wird eine Arbeitsgruppe namens `Data_Analyst_Group` erstellt, die den Speicherort `s3://amzn-s3-demo-bucket` für die Ausgabe der Abfrageergebnisse nutzt. Mit dem Befehl wird eine Arbeitsgruppe erstellt, die die Clientkonfigurationseinstellungen außer Kraft setzt. Dazu gehört auch der Speicherort für die Ausgabe der Abfrageergebnisse. Der Befehl aktiviert außerdem CloudWatch Metriken und fügt der Arbeitsgruppe drei Schlüssel-Wert-Tag-Paare hinzu, um sie von anderen Arbeitsgruppen zu unterscheiden. Beachten Sie, dass das Argument `--configuration` keine Leerzeichen vor den Kommas enthält, die seine Optionen trennen. ``` aws athena create-work-group \ --name Data_Analyst_Group \ --configuration ResultConfiguration={OutputLocation="s3://amzn-s3-demo-bucket"},EnforceWorkGroupConfiguration="true",PublishCloudWatchMetricsEnabled="true" \ --description "Workgroup for data analysts" \ --tags Key=Division,Value=West Key=Location,Value=Seattle Key=Team,Value="Big Data" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um die Ergebnisse zu sehen, verwenden Sie `aws athena get-work-group --work-group Data_Analyst_Group`. Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateWorkGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/create-work-group.html).AWS CLI * ### `delete-data-catalog` Das folgende Codebeispiel zeigt die Verwendung`delete-data-catalog`. **AWS CLI** **So löschen Sie einen Datenkatalog** Im folgenden Beispiel für `delete-data-catalog` wird der `UnusedDataCatalog`-Datenkatalog gelöscht. ``` aws athena delete-data-catalog \ --name UnusedDataCatalog ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Katalogs: delete-data-catalog](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-deleting-a-catalog) im *Amazon Athena Athena-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteDataCatalog AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/delete-data-catalog.html)*Befehlsreferenz.* ### `delete-named-query` Das folgende Codebeispiel zeigt die Verwendung`delete-named-query`. **AWS CLI** **So löschen Sie eine benannte Abfrage** Im folgenden Beispiel für `delete-named-query` wird die benannte Abfrage mit der angegebenen ID gelöscht. ``` aws athena delete-named-query \ --named-query-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [DeleteNamedQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/delete-named-query.html)in der *AWS CLI Befehlsreferenz*. ### `delete-work-group` Das folgende Codebeispiel zeigt die Verwendung`delete-work-group`. **AWS CLI** **So löschen Sie eine Arbeitsgruppe** Im folgenden Beispiel für `delete-work-group` wird die Arbeitsgruppe `TeamB` gelöscht. ``` aws athena delete-work-group \ --work-group TeamB ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um den Löschvorgang zu bestätigen, verwenden Sie `aws athena list-work-groups`. Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [DeleteWorkGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/delete-work-group.html)in der *AWS CLI Befehlsreferenz*. ### `get-data-catalog` Das folgende Codebeispiel zeigt die Verwendung`get-data-catalog`. **AWS CLI** **So rufen Sie Informationen über einen Datenkatalog ab** Mit dem folgenden Beispiel für `get-data-catalog` werden Informationen über den `dynamo_db_catalog`-Datenkatalog zurückgegeben. ``` aws athena get-data-catalog \ --name dynamo_db_catalog ``` Ausgabe: ``` { "DataCatalog": { "Name": "dynamo_db_catalog", "Description": "DynamoDB Catalog", "Type": "LAMBDA", "Parameters": { "catalog": "dynamo_db_catalog", "metadata-function": "arn:aws:lambda:us-west-2:111122223333:function:dynamo_db_lambda", "record-function": "arn:aws:lambda:us-west-2:111122223333:function:dynamo_db_lambda" } } } ``` Weitere Informationen finden Sie unter [Katalogdetails anzeigen: get-data-catalog](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-showing-details-of-a-catalog) im *Amazon Athena Athena-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetDataCatalog AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-data-catalog.html)*Befehlsreferenz.* ### `get-database` Das folgende Codebeispiel zeigt die Verwendung`get-database`. **AWS CLI** **So rufen Sie Informationen über eine Datenbank in einem Datenkatalog ab** Im folgenden Beispiel für `get-database` werden Informationen über die `sampledb`-Datenbank im `AwsDataCatalog`-Datenkatalog zurückgegeben. ``` aws athena get-database \ --catalog-name AwsDataCatalog \ --database-name sampledb ``` Ausgabe: ``` { "Database": { "Name": "sampledb", "Description": "Sample database", "Parameters": { "CreatedBy": "Athena", "EXTERNAL": "TRUE" } } } ``` Weitere Informationen finden Sie unter [Anzeigen von Datenbankdetails: get-database](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-showing-details-of-a-database) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [GetDatabase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-database.html)in der *AWS CLI Befehlsreferenz*. ### `get-named-query` Das folgende Codebeispiel zeigt die Verwendung`get-named-query`. **AWS CLI** **So geben Sie eine benannte Abfrage zurück** Im folgenden Beispiel für `get-named-query` werden Informationen über die Abfrage mit der angegebenen ID zurückgegeben. ``` aws athena get-named-query \ --named-query-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "NamedQuery": { "Name": "CloudFront Logs - SFO", "Description": "Shows successful GET request data for SFO", "Database": "default", "QueryString": "select date, location, browser, uri, status from cloudfront_logs where method = 'GET' and status = 200 and location like 'SFO%' limit 10", "NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "WorkGroup": "AthenaAdmin" } } ``` Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [GetNamedQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-named-query.html)in der *AWS CLI Befehlsreferenz*. ### `get-query-execution` Das folgende Codebeispiel zeigt die Verwendung`get-query-execution`. **AWS CLI** **So geben Sie Informationen über eine Abfrageausführung zurück** Im folgenden Beispiel für `get-query-execution` werden Informationen über die Abfrage mit der angegebenen Abfrage-ID zurückgegeben. ``` aws athena get-query-execution \ --query-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "QueryExecution": { "QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Query": "select date, location, browser, uri, status from cloudfront_logs where method = 'GET ' and status = 200 and location like 'SFO%' limit 10", "StatementType": "DML", "ResultConfiguration": { "OutputLocation": "s3://amzn-s3-demo-bucket/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.csv" }, "QueryExecutionContext": { "Database": "mydatabase", "Catalog": "awsdatacatalog" }, "Status": { "State": "SUCCEEDED", "SubmissionDateTime": 1593469842.665, "CompletionDateTime": 1593469846.486 }, "Statistics": { "EngineExecutionTimeInMillis": 3600, "DataScannedInBytes": 203089, "TotalExecutionTimeInMillis": 3821, "QueryQueueTimeInMillis": 267, "QueryPlanningTimeInMillis": 1175 }, "WorkGroup": "AthenaAdmin" } } ``` Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [GetQueryExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-query-execution.html)in der *AWS CLI Befehlsreferenz*. ### `get-query-results` Das folgende Codebeispiel zeigt die Verwendung`get-query-results`. **AWS CLI** **So geben Sie die Ergebnisse einer Abfrage zurück** Im folgenden Beispiel für `get-query-results` werden die Ergebnisse der Abfrage mit der angegebenen Abfrage-ID zurückgegeben. ``` aws athena get-query-results \ --query-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "ResultSet": { "Rows": [ { "Data": [ { "VarCharValue": "date" }, { "VarCharValue": "location" }, { "VarCharValue": "browser" }, { "VarCharValue": "uri" }, { "VarCharValue": "status" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "Safari" }, { "VarCharValue": "/test-image-2.jpeg" }, { "VarCharValue": "200" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "Opera" }, { "VarCharValue": "/test-image-2.jpeg" }, { "VarCharValue": "200" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "Firefox" }, { "VarCharValue": "/test-image-3.jpeg" }, { "VarCharValue": "200" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "Lynx" }, { "VarCharValue": "/test-image-3.jpeg" }, { "VarCharValue": "200" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "IE" }, { "VarCharValue": "/test-image-2.jpeg" }, { "VarCharValue": "200" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "Opera" }, { "VarCharValue": "/test-image-1.jpeg" }, { "VarCharValue": "200" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "Chrome" }, { "VarCharValue": "/test-image-3.jpeg" }, { "VarCharValue": "200" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "Firefox" }, { "VarCharValue": "/test-image-2.jpeg" }, { "VarCharValue": "200" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "Chrome" }, { "VarCharValue": "/test-image-3.jpeg" }, { "VarCharValue": "200" } ] }, { "Data": [ { "VarCharValue": "2014-07-05" }, { "VarCharValue": "SFO4" }, { "VarCharValue": "IE" }, { "VarCharValue": "/test-image-2.jpeg" }, { "VarCharValue": "200" } ] } ], "ResultSetMetadata": { "ColumnInfo": [ { "CatalogName": "hive", "SchemaName": "", "TableName": "", "Name": "date", "Label": "date", "Type": "date", "Precision": 0, "Scale": 0, "Nullable": "UNKNOWN", "CaseSensitive": false }, { "CatalogName": "hive", "SchemaName": "", "TableName": "", "Name": "location", "Label": "location", "Type": "varchar", "Precision": 2147483647, "Data": [ "Scale": 0, "Nullable": "UNKNOWN", "CaseSensitive": true }, { "CatalogName": "hive", "SchemaName": "", "TableName": "", "Name": "browser", "Label": "browser", "Type": "varchar", "Precision": 2147483647, "Scale": 0, "Nullable": "UNKNOWN", "CaseSensitive": true }, { "CatalogName": "hive", "SchemaName": "", "TableName": "", "Name": "uri", "Label": "uri", "Type": "varchar", "Precision": 2147483647, "Scale": 0, "Nullable": "UNKNOWN", "CaseSensitive": true }, { "CatalogName": "hive", "SchemaName": "", "TableName": "", "Name": "status", "Label": "status", "Type": "integer", "Precision": 10, "Scale": 0, "Nullable": "UNKNOWN", "CaseSensitive": false } ] } }, "UpdateCount": 0 } ``` Weitere Informationen finden Sie unter [Arbeiten mit Abfrageergebnissen, Ausgabedateien und dem Abfrageverlauf](https://docs.aws.amazon.com/athena/latest/ug/querying.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [GetQueryResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-query-results.html)in der *AWS CLI Befehlsreferenz*. ### `get-table-metadata` Das folgende Codebeispiel zeigt die Verwendung`get-table-metadata`. **AWS CLI** **So geben Sie Metadateninformationen über eine Tabelle zurück** Im folgenden Beispiel für `get-table-metadata` werden Metadateninformationen über die Tabelle `counties`, einschließlich Spaltennamen und deren Datentypen, aus der `sampledb`-Datenbank des `AwsDataCatalog`-Datenkatalogs zurückgegeben. ``` aws athena get-table-metadata \ --catalog-name AwsDataCatalog \ --database-name sampledb \ --table-name counties ``` Ausgabe: ``` { "TableMetadata": { "Name": "counties", "CreateTime": 1593559968.0, "LastAccessTime": 0.0, "TableType": "EXTERNAL_TABLE", "Columns": [ { "Name": "name", "Type": "string", "Comment": "from deserializer" }, { "Name": "boundaryshape", "Type": "binary", "Comment": "from deserializer" }, { "Name": "motto", "Type": "string", "Comment": "from deserializer" }, { "Name": "population", "Type": "int", "Comment": "from deserializer" } ], "PartitionKeys": [], "Parameters": { "EXTERNAL": "TRUE", "inputformat": "com.esri.json.hadoop.EnclosedJsonInputFormat", "location": "s3://amzn-s3-demo-bucket/json", "outputformat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat", "serde.param.serialization.format": "1", "serde.serialization.lib": "com.esri.hadoop.hive.serde.JsonSerde", "transient_lastDdlTime": "1593559968" } } } ``` Weitere Informationen finden Sie unter [Tabellendetails anzeigen: get-table-metadata](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-showing-details-of-a-table) im *Amazon Athena Athena-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetTableMetadata AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-table-metadata.html)*Befehlsreferenz.* ### `get-work-group` Das folgende Codebeispiel zeigt die Verwendung`get-work-group`. **AWS CLI** **So geben Sie Informationen über eine Arbeitsgruppe zurück** Im folgenden Beispiel für `get-work-group` werden Informationen über die `AthenaAdmin`-Arbeitsgruppe zurückgegeben. ``` aws athena get-work-group \ --work-group AthenaAdmin ``` Ausgabe: ``` { "WorkGroup": { "Name": "AthenaAdmin", "State": "ENABLED", "Configuration": { "ResultConfiguration": { "OutputLocation": "s3://amzn-s3-demo-bucket/" }, "EnforceWorkGroupConfiguration": false, "PublishCloudWatchMetricsEnabled": true, "RequesterPaysEnabled": false }, "Description": "Workgroup for Athena administrators", "CreationTime": 1573677174.105 } } ``` Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [GetWorkGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-work-group.html)in der *AWS CLI Befehlsreferenz*. ### `list-data-catalogs` Das folgende Codebeispiel zeigt die Verwendung`list-data-catalogs`. **AWS CLI** **So listen Sie die bei Athena registrierten Datenkataloge auf** Im folgenden Beispiel für `list-data-catalogs` werden die bei Athena registrierten Datenkataloge aufgelistet. ``` aws athena list-data-catalogs ``` Ausgabe: ``` { "DataCatalogsSummary": [ { "CatalogName": "AwsDataCatalog", "Type": "GLUE" }, { "CatalogName": "cw_logs_catalog", "Type": "LAMBDA" }, { "CatalogName": "cw_metrics_catalog", "Type": "LAMBDA" } ] } ``` Weitere Informationen finden Sie unter [Auflisten registrierter Kataloge: list-data-catalogs](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-listing-registered-catalogs) im *Amazon Athena Athena-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListDataCatalogs AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-data-catalogs.html)*Befehlsreferenz*. ### `list-databases` Das folgende Codebeispiel zeigt die Verwendung`list-databases`. **AWS CLI** **So listen Sie die Datenbanken in einem Datenkatalog auf** Im folgenden Beispiel für `list-databases` werden die Datenbanken im `AwsDataCatalog`-Datenkatalog aufgelistet. ``` aws athena list-databases \ --catalog-name AwsDataCatalog ``` Ausgabe: ``` { "DatabaseList": [ { "Name": "default" }, { "Name": "mydatabase" }, { "Name": "newdb" }, { "Name": "sampledb", "Description": "Sample database", "Parameters": { "CreatedBy": "Athena", "EXTERNAL": "TRUE" } }, { "Name": "webdata" } ] } ``` Weitere Informationen finden Sie unter [Auflisten von Datenbanken in einem Katalog: list-databases](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-listing-databases) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [ListDatabases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-databases.html)in der *AWS CLI Befehlsreferenz*. ### `list-named-queries` Das folgende Codebeispiel zeigt die Verwendung`list-named-queries`. **AWS CLI** **So listen Sie die benannten Abfragen für eine Arbeitsgruppe auf** Im folgenden Beispiel für `list-named-queries` werden die benannten Abfragen für die `AthenaAdmin`-Arbeitsgruppe aufgelistet. ``` aws athena list-named-queries \ --work-group AthenaAdmin ``` Ausgabe: ``` { "NamedQueryIds": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333" ] } ``` Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [ListNamedQueries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-named-queries.html)in der *AWS CLI Befehlsreferenz*. ### `list-query-executions` Das folgende Codebeispiel zeigt die Verwendung`list-query-executions`. **AWS CLI** **Um die Abfrage IDs der Abfragen in einer bestimmten Arbeitsgruppe aufzulisten** Im folgenden `list-query-executions` Beispiel werden maximal zehn der Abfragen IDs in der `AthenaAdmin` Arbeitsgruppe aufgeführt. ``` aws athena list-query-executions \ --work-group AthenaAdmin \ --max-items 10 ``` Ausgabe: ``` { "QueryExecutionIds": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE11110", "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "a1b2c3d4-5678-90ab-cdef-EXAMPLE11114", "a1b2c3d4-5678-90ab-cdef-EXAMPLE11115", "a1b2c3d4-5678-90ab-cdef-EXAMPLE11116", "a1b2c3d4-5678-90ab-cdef-EXAMPLE11117", "a1b2c3d4-5678-90ab-cdef-EXAMPLE11118", "a1b2c3d4-5678-90ab-cdef-EXAMPLE11119" ], "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=" } ``` Weitere Informationen finden Sie unter [Arbeiten mit Abfrageergebnissen, Ausgabedateien und dem Abfrageverlauf](https://docs.aws.amazon.com/athena/latest/ug/querying.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [ListQueryExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-query-executions.html)in der *AWS CLI Befehlsreferenz.* ### `list-table-metadata` Das folgende Codebeispiel zeigt die Verwendung`list-table-metadata`. **AWS CLI** **So listen Sie die Metadaten für Tabellen in der angegebenen Datenbank eines Datenkatalogs auf** Im folgenden Beispiel für `list-table-metadata` werden Metadateninformationen für maximal zwei Tabellen in der `geography`-Datenbank des `AwsDataCatalog`-Datenkatalogs zurückgegeben. ``` aws athena list-table-metadata \ --catalog-name AwsDataCatalog \ --database-name geography \ --max-items 2 ``` Ausgabe: ``` { "TableMetadataList": [ { "Name": "country_codes", "CreateTime": 1586553454.0, "TableType": "EXTERNAL_TABLE", "Columns": [ { "Name": "country", "Type": "string", "Comment": "geo id" }, { "Name": "alpha-2 code", "Type": "string", "Comment": "geo id2" }, { "Name": "alpha-3 code", "Type": "string", "Comment": "state name" }, { "Name": "numeric code", "Type": "bigint", "Comment": "" }, { "Name": "latitude", "Type": "bigint", "Comment": "location (latitude)" }, { "Name": "longitude", "Type": "bigint", "Comment": "location (longitude)" } ], "Parameters": { "areColumnsQuoted": "false", "classification": "csv", "columnsOrdered": "true", "delimiter": ",", "has_encrypted_data": "false", "inputformat": "org.apache.hadoop.mapred.TextInputFormat", "location": "s3://amzn-s3-demo-bucket/csv/countrycode", "outputformat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat", "serde.param.field.delim": ",", "serde.serialization.lib": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe", "skip.header.line.count": "1", "typeOfData": "file" } }, { "Name": "county_populations", "CreateTime": 1586553446.0, "TableType": "EXTERNAL_TABLE", "Columns": [ { "Name": "id", "Type": "string", "Comment": "geo id" }, { "Name": "country", "Name": "id2", "Type": "string", "Comment": "geo id2" }, { "Name": "county", "Type": "string", "Comment": "county name" }, { "Name": "state", "Type": "string", "Comment": "state name" }, { "Name": "population estimate 2018", "Type": "string", "Comment": "" } ], "Parameters": { "areColumnsQuoted": "false", "classification": "csv", "columnsOrdered": "true", "delimiter": ",", "has_encrypted_data": "false", "inputformat": "org.apache.hadoop.mapred.TextInputFormat", "location": "s3://amzn-s3-demo-bucket/csv/CountyPopulation", "outputformat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat", "serde.param.field.delim": ",", "serde.serialization.lib": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe", "skip.header.line.count": "1", "typeOfData": "file" } } ], "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==" } ``` Weitere Informationen finden Sie unter [Metadaten für alle Tabellen in einer Datenbank anzeigen: list-table-metadata](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-showing-all-table-metadata) im *Amazon Athena Athena-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTableMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-table-metadata.html)in der *AWS CLI Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Beispiel 1: So listen Sie die Tags für eine Arbeitsgruppe auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für die Arbeitsgruppe `Data_Analyst_Group` aufgelistet: ``` aws athena list-tags-for-resource \ --resource-arn arn:aws:athena:us-west-2:111122223333:workgroup/Data_Analyst_Group ``` Ausgabe: ``` { "Tags": [ { "Key": "Division", "Value": "West" }, { "Key": "Team", "Value": "Big Data" }, { "Key": "Location", "Value": "Seattle" } ] } ``` **Beispiel 2: So listen Sie die Tags für einen Datenkatalog auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für den `dynamo_db_catalog`-Datenkatalog aufgelistet. ``` aws athena list-tags-for-resource \ --resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog ``` Ausgabe: ``` { "Tags": [ { "Key": "Division", "Value": "Mountain" }, { "Key": "Organization", "Value": "Retail" }, { "Key": "Product_Line", "Value": "Shoes" }, { "Key": "Location", "Value": "Denver" } ] } ``` Weitere Informationen finden Sie unter [Auflisten der Tags für eine Ressource: list-tags-for-resource](https://docs.aws.amazon.com/athena/latest/ug/tags-operations.html#tags-operations-examples-cli-list-tags-for-resource) im *Amazon Athena Athena-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-tags-for-resource.html)*Befehlsreferenz.* ### `list-work-groups` Das folgende Codebeispiel zeigt die Verwendung`list-work-groups`. **AWS CLI** **So listen Sie Arbeitsgruppen auf** Im folgenden Beispiel für `list-work-groups` werden die Arbeitsgruppen im aktuellen Konto aufgelistet. ``` aws athena list-work-groups ``` Ausgabe: ``` { "WorkGroups": [ { "Name": "Data_Analyst_Group", "State": "ENABLED", "Description": "", "CreationTime": 1578006683.016 }, { "Name": "AthenaAdmin", "State": "ENABLED", "Description": "", "CreationTime": 1573677174.105 }, { "Name": "primary", "State": "ENABLED", "Description": "", "CreationTime": 1567465222.723 } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [ListWorkGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-work-groups.html)in der *AWS CLI Befehlsreferenz*. ### `start-query-execution` Das folgende Codebeispiel zeigt die Verwendung`start-query-execution`. **AWS CLI** **Beispiel 1: So führen Sie eine Abfrage in einer Arbeitsgruppe für die angegebene Tabelle in der angegebenen Datenbank und dem angegebenen Datenkatalog aus** Im folgenden Beispiel für `start-query-execution` wird die `AthenaAdmin`-Arbeitsgruppe verwendet, um eine Abfrage für die `cloudfront_logs`-Tabelle in der `cflogsdatabase` im `AwsDataCatalog`-Datenkatalog auszuführen. ``` aws athena start-query-execution \ --query-string "select date, location, browser, uri, status from cloudfront_logs where method = 'GET' and status = 200 and location like 'SFO%' limit 10" \ --work-group "AthenaAdmin" \ --query-execution-context Database=cflogsdatabase,Catalog=AwsDataCatalog ``` Ausgabe: ``` { "QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. **Beispiel 2: So führen Sie eine Abfrage aus, die eine angegebene Arbeitsgruppe verwendet, um eine Datenbank im angegebenen Datenkatalog zu erstellen** Im folgenden Beispiel für `start-query-execution` wird die `AthenaAdmin`-Arbeitsgruppe verwendet, um die Datenbank `newdb` im Standarddatenkatalog `AwsDataCatalog` zu erstellen. ``` aws athena start-query-execution \ --query-string "create database if not exists newdb" \ --work-group "AthenaAdmin" ``` Ausgabe: ``` { "QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11112" } ``` Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. **Beispiel 3: So führen Sie eine Abfrage aus, mit der eine Ansicht für eine Tabelle in der angegebenen Datenbank und dem angegebenen Datenkatalog erstellt wird** Im folgenden Beispiel für `start-query-execution` wird eine `SELECT`-Anweisung für die `cloudfront_logs`-Tabelle in der `cflogsdatabase` verwendet, um die Ansicht `cf10` zu erstellen. ``` aws athena start-query-execution \ --query-string "CREATE OR REPLACE VIEW cf10 AS SELECT * FROM cloudfront_logs limit 10" \ --query-execution-context Database=cflogsdatabase ``` Ausgabe: ``` { "QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11113" } ``` Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [StartQueryExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/start-query-execution.html)in der *AWS CLI Befehlsreferenz*. ### `stop-query-execution` Das folgende Codebeispiel zeigt die Verwendung`stop-query-execution`. **AWS CLI** **So beenden Sie eine laufende Abfrage** Im folgenden Beispiel für `stop-query-execution` wird die Abfrage mit der angegebenen Abfrage-ID beendet. ``` aws athena stop-query-execution \ --query-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [StopQueryExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/stop-query-execution.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer Ressource ein Tag hinzu** Im folgenden Beispiel für `tag-resource` werden dem `dynamo_db_catalog`-Datenkatalog drei Tags hinzugefügt. ``` aws athena tag-resource \ --resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog \ --tags Key=Organization,Value=Retail Key=Division,Value=Mountain Key=Product_Line,Value=Shoes Key=Location,Value=Denver ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um das Ergebnis zu sehen, verwenden Sie `aws athena list-tags-for-resource --resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog`. Weitere Informationen finden Sie unter [Auflisten der Tags für eine Ressource: tag-resource](https://docs.aws.amazon.com/athena/latest/ug/tags-operations.html#tags-operations-examples-cli-tag-resource) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einer Ressource** Im folgenden Beispiel für `untag-resource` werden die Schlüssel `Specialization` und `Focus` sowie deren zugeordneten Werte aus der `dynamo_db_catalog`-Datenkatalogressource entfernt. ``` aws athena untag-resource \ --resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog \ --tag-keys Specialization Focus ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um die Ergebnisse anzuzeigen, verwenden Sie den `list-tags-for-resource`-Befehl. Weitere Informationen finden Sie unter [Entfernen der Tags von einer Ressource: untag-resource](https://docs.aws.amazon.com/athena/latest/ug/tags-operations.html#tags-operations-examples-cli-untag-resource) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-data-catalog` Das folgende Codebeispiel zeigt die Verwendung`update-data-catalog`. **AWS CLI** **So aktualisieren Sie einen Datenkatalog** Im folgenden Beispiel für `update-data-catalog` werden die Lambda-Funktion und die Beschreibung des `cw_logs_catalog`-Datenkatalogs aktualisiert. ``` aws athena update-data-catalog \ --name cw_logs_catalog \ --type LAMBDA \ --description "New CloudWatch Logs Catalog" \ --function=arn:aws:lambda:us-west-2:111122223333:function:new_cw_logs_lambda ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um das Ergebnis zu sehen, verwenden Sie `aws athena get-data-catalog --name cw_logs_catalog`. Weitere Informationen finden Sie unter [Aktualisieren eines Katalogs: update-data-catalog](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-updating-a-catalog) im *Amazon Athena Athena-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [UpdateDataCatalog AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/update-data-catalog.html)*Befehlsreferenz.* ### `update-work-group` Das folgende Codebeispiel zeigt die Verwendung`update-work-group`. **AWS CLI** **So aktualisieren Sie eine Arbeitsgruppe** Im folgenden Beispiel für `update-work-group` wird die Arbeitsgruppe `Data_Analyst_Group` deaktiviert. Benutzer können in der deaktivierten Arbeitsgruppe keine Abfragen ausführen oder erstellen, können aber dennoch Metriken, Limits zur Kontrolle der Datennutzung, Arbeitsgruppeneinstellungen, den Abfrageverlauf und gespeicherte Abfragen anzeigen. ``` aws athena update-work-group \ --work-group Data_Analyst_Group \ --state DISABLED ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um die Statusänderung zu überprüfen, verwenden Sie `aws athena get-work-group --work-group Data_Analyst_Group` und überprüfen Sie die Eigenschaft `State` in der Ausgabe. Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*. + Einzelheiten zur API finden Sie [UpdateWorkGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/update-work-group.html)in der *AWS CLI Befehlsreferenz*. # Auto Scaling Scaling-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Auto Scaling Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `attach-instances` Das folgende Codebeispiel zeigt, wie Sie`attach-instances`. **AWS CLI** **So fügen Sie einer Auto-Scaling-Gruppe eine Instance hinzu** In diesem Beispiel wird die angegebene Instance an die spezifizierte Auto-Scaling-Gruppe angehängt. ``` aws autoscaling attach-instances \ --instance-ids i-061c63c5eb45f0416 \ --auto-scaling-group-name my-asg ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [AttachInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/attach-instances.html)in der *AWS CLI Befehlsreferenz*. ### `attach-load-balancer-target-groups` Das folgende Codebeispiel zeigt die Verwendung`attach-load-balancer-target-groups`. **AWS CLI** **So fügen Sie einer Auto-Scaling-Gruppe eine Zielgruppe hinzu** In diesem Beispiel wird die angegebene Zielgruppe zur spezifizierten Auto-Scaling-Gruppe hinzugefügt. ``` aws autoscaling attach-load-balancer-target-groups \ --auto-scaling-group-name my-asg \ --target-group-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Elastic Load Balancing und Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [AttachLoadBalancerTargetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/attach-load-balancer-target-groups.html)in der *AWS CLI Befehlsreferenz*. ### `attach-load-balancers` Das folgende Codebeispiel zeigt die Verwendung`attach-load-balancers`. **AWS CLI** **So fügen Sie einer Auto-Scaling-Gruppe einen Classic Load Balancer hinzu** In diesem Beispiel wird der angegebene Classic Load Balancer der spezifizierten Auto-Scaling-Gruppe hinzugefügt. ``` aws autoscaling attach-load-balancers \ --load-balancer-names my-load-balancer \ --auto-scaling-group-name my-asg ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Elastic Load Balancing und Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [AttachLoadBalancers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/attach-load-balancers.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-instance-refresh` Das folgende Codebeispiel zeigt die Verwendung`cancel-instance-refresh`. **AWS CLI** **Um eine Instanzaktualisierung abzubrechen** Im folgenden Beispiel für `cancel-instance-refresh` wird eine laufende Instance-Aktualisierung für die angegebene Auto-Scaling-Gruppe abgebrochen. ``` aws autoscaling cancel-instance-refresh \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b" } ``` Weitere Informationen finden Sie unter [Abbrechen einer Instance-Aktualisierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/cancel-instance-refresh.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [CancelInstanceRefresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/cancel-instance-refresh.html)in der *AWS CLI Befehlsreferenz*. ### `complete-lifecycle-action` Das folgende Codebeispiel zeigt die Verwendung`complete-lifecycle-action`. **AWS CLI** **So schließen Sie eine Lebenszyklusaktion ab** In diesem Beispiel wird Amazon EC2 Auto Scaling darüber informiert, dass die angegebene Lebenszyklusaktion abgeschlossen ist, sodass das Starten oder Beenden der Instance abgeschlossen werden kann. ``` aws autoscaling complete-lifecycle-action \ --lifecycle-hook-name my-launch-hook \ --auto-scaling-group-name my-asg \ --lifecycle-action-result CONTINUE \ --lifecycle-action-token bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lebenszyklus-Hooks für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [CompleteLifecycleAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/complete-lifecycle-action.html)in der *AWS CLI Befehlsreferenz*. ### `create-auto-scaling-group` Das folgende Codebeispiel zeigt die Verwendung`create-auto-scaling-group`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Auto-Scaling-Gruppe** Im folgenden Beispiel für `create-auto-scaling-group` wird eine Auto-Scaling-Gruppe in Subnetzen in mehreren Availability Zones innerhalb einer Region erstellt. Die Instances werden mit der Standardversion der angegebenen Startvorlage gestartet. Bitte beachten Sie, dass für die meisten anderen Einstellungen, wie z. B. die Beendigungsrichtlinien und die Konfiguration der Zustandsprüfung, die Standardeinstellungen verwendet werden. ``` aws autoscaling create-auto-scaling-group \ --auto-scaling-group-name my-asg \ --launch-template LaunchTemplateId=lt-1234567890abcde12 \ --min-size 1 \ --max-size 5 \ --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Auto-Scaling-Gruppen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroup.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. **Beispiel 2: So fügen Sie einen Application Load Balancer, einen Network Load Balancer oder einen Gateway Load Balancer hinzu** Dieses Beispiel gibt den ARN einer Zielgruppe für einen Load Balancer an, der den erwarteten Datenverkehr unterstützt. Der Typ der Zustandsprüfung gibt `ELB` an, sodass die Auto-Scaling-Gruppe eine Instance ersetzt, wenn Elastic Load Balancing diese als fehlerhaft meldet. Der Befehl definiert außerdem eine Wartefrist für die Zustandsprüfung von `600` Sekunden. Die Wartefrist trägt dazu bei, ein vorzeitiges Beenden neu gestarteter Instances zu verhindern. ``` aws autoscaling create-auto-scaling-group \ --auto-scaling-group-name my-asg \ --launch-template LaunchTemplateId=lt-1234567890abcde12 \ --target-group-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/943f017f100becff \ --health-check-type ELB \ --health-check-grace-period 600 \ --min-size 1 \ --max-size 5 \ --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Elastic Load Balancing und Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 3: So geben Sie eine Platzierungsgruppe an und verwenden die neueste Version der Startvorlage** Dieses Beispiel startet Instances in einer Platzierungsgruppe innerhalb einer einzelnen Availability Zone. Dies kann für Gruppen mit niedriger Latenz und HPC-Workloads nützlich sein. Außerdem werden in diesem Beispiel die minimale Größe, die maximale Größe und die gewünschte Kapazität der Gruppe angegeben. ``` aws autoscaling create-auto-scaling-group \ --auto-scaling-group-name my-asg \ --launch-template LaunchTemplateId=lt-1234567890abcde12,Version='$Latest' \ --min-size 1 \ --max-size 5 \ --desired-capacity 3 \ --placement-group my-placement-group \ --vpc-zone-identifier "subnet-6194ea3b" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Platzierungsgruppen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html) im *Benutzerhandbuch für Amazon EC2 für Linux-Instances*. **Beispiel 4: So geben Sie eine Auto-Scaling-Gruppe mit einer einzelnen Instance an und verwenden eine bestimmte Version der Startvorlage** Dieses Beispiel erstellt eine Auto-Scaling-Gruppe mit einer minimalen und maximalen Kapazität von `1`, um sicherzustellen, dass eine Instance ausgeführt wird. Der Befehl gibt außerdem Version 1 einer Startvorlage an, in der die ID einer vorhandenen ENI angegeben ist. Wenn Sie eine Startvorlage verwenden, die eine vorhandene ENI für eth0 angibt, müssen Sie für die Auto-Scaling-Gruppe eine Availability Zone angeben, die mit der Netzwerkschnittstelle übereinstimmt, ohne in der Anforderung zusätzlich eine Subnetz-ID anzugeben. ``` aws autoscaling create-auto-scaling-group \ --auto-scaling-group-name my-asg-single-instance \ --launch-template LaunchTemplateName=my-template-for-auto-scaling,Version='1' \ --min-size 1 \ --max-size 1 \ --availability-zones us-west-2a ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Auto-Scaling-Gruppen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroup.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. **Beispiel 5: So geben Sie eine andere Beendigungsrichtlinie an** In diesem Beispiel wird eine Auto-Scaling-Gruppe mithilfe einer Startkonfiguration erstellt und die Beendigungsrichtlinie so festgelegt, dass die ältesten Instances zuerst beendet werden. Der Befehl weist außerdem der Gruppe und ihren Instances ein Tag mit dem Schlüssel `Role` und dem Wert `WebServer` zu. ``` aws autoscaling create-auto-scaling-group \ --auto-scaling-group-name my-asg \ --launch-configuration-name my-lc \ --min-size 1 \ --max-size 5 \ --termination-policies "OldestInstance" \ --tags "ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Role,Value=WebServer,PropagateAtLaunch=true" \ --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit Beendigungsrichtlinien für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 6: So geben Sie einen Start-Lebenszyklus-Hook an** Das folgende Beispiel erstellt eine Auto-Scaling-Gruppe mit einem Lebenszyklus-Hook, der eine benutzerdefinierte Aktion beim Starten einer Instance unterstützt. ``` aws autoscaling create-auto-scaling-group \ --cli-input-json file://~/config.json ``` Inhalt der `config.json`-Datei: ``` { "AutoScalingGroupName": "my-asg", "LaunchTemplate": { "LaunchTemplateId": "lt-1234567890abcde12" }, "LifecycleHookSpecificationList": [{ "LifecycleHookName": "my-launch-hook", "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING", "NotificationTargetARN": "arn:aws:sqs:us-west-2:123456789012:my-sqs-queue", "RoleARN": "arn:aws:iam::123456789012:role/my-notification-role", "NotificationMetadata": "SQS message metadata", "HeartbeatTimeout": 4800, "DefaultResult": "ABANDON" }], "MinSize": 1, "MaxSize": 5, "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782", "Tags": [{ "ResourceType": "auto-scaling-group", "ResourceId": "my-asg", "PropagateAtLaunch": true, "Value": "test", "Key": "environment" }] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lebenszyklus-Hooks für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 7: So geben Sie einen Beendigungs-Lebenszyklus-Hook an** Das folgende Beispiel erstellt eine Auto-Scaling-Gruppe mit einem Lebenszyklus-Hook, der eine benutzerdefinierte Aktion beim Beenden einer Instance unterstützt. ``` aws autoscaling create-auto-scaling-group \ --cli-input-json file://~/config.json ``` Inhalt von `config.json`: ``` { "AutoScalingGroupName": "my-asg", "LaunchTemplate": { "LaunchTemplateId": "lt-1234567890abcde12" }, "LifecycleHookSpecificationList": [{ "LifecycleHookName": "my-termination-hook", "LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING", "HeartbeatTimeout": 120, "DefaultResult": "CONTINUE" }], "MinSize": 1, "MaxSize": 5, "TargetGroupARNs": [ "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" ], "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lebenszyklus-Hooks für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 8: So geben Sie eine benutzerdefinierte Beendigungsrichtlinie an** In diesem Beispiel wird eine Auto-Scaling-Gruppe erstellt, die eine benutzerdefinierte Lambda-Funktionsrichtlinie für Beendigungen angibt, die Amazon EC2 Auto Scaling mitteilt, welche Instances sicher beim Abskalieren beendet werden können. ``` aws autoscaling create-auto-scaling-group \ --auto-scaling-group-name my-asg-single-instance \ --launch-template LaunchTemplateName=my-template-for-auto-scaling \ --min-size 1 \ --max-size 5 \ --termination-policies "arn:aws:lambda:us-west-2:123456789012:function:HelloFunction:prod" \ --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen einer benutzerdefinierten Beendigungsrichtlinie mit Lambda](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lambda-custom-termination-policy.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [CreateAutoScalingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-auto-scaling-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-launch-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-launch-configuration`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Startkonfiguration** In diesem Beispiel wird eine einfache Startkonfiguration erstellt. ``` aws autoscaling create-launch-configuration \ --launch-configuration-name my-lc \ --image-id ami-04d5cc9b88example \ --instance-type m5.large ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen einer Startkonfiguration](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 2: So erstellen Sie eine Startkonfiguration mit einer Sicherheitsgruppe, einem key pair und einem Bootstrapping-Skript** In diesem Beispiel wird eine Startkonfiguration mit einer Sicherheitsgruppe, einem key pair und einem Bootstrapping-Skript erstellt, die in den Benutzerdaten enthalten sind. ``` aws autoscaling create-launch-configuration \ --launch-configuration-name my-lc \ --image-id ami-04d5cc9b88example \ --instance-type m5.large \ --security-groups sg-eb2af88example \ --key-name my-key-pair \ --user-data file://myuserdata.txt ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen einer Startkonfiguration](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-config.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 3: So erstellen Sie eine Startkonfiguration mit einer IAM-Rolle** In diesem Beispiel wird eine Startkonfiguration mit dem Instance-Profilnamen einer IAM-Rolle erstellt. ``` aws autoscaling create-launch-configuration \ --launch-configuration-name my-lc \ --image-id ami-04d5cc9b88example \ --instance-type m5.large \ --iam-instance-profile my-autoscaling-role ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [IAM-Rolle für Anwendungen, die auf Amazon EC2-Instances ausgeführt werden](https://docs.aws.amazon.com/autoscaling/ec2/userguide/us-iam-role.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 4: So erstellen Sie eine Startkonfiguration mit aktivierter detaillierter Überwachung** In diesem Beispiel wird eine Startkonfiguration mit aktivierter detaillierter EC2-Überwachung erstellt, an die EC2-Metriken innerhalb von 1 Minute gesendet werden CloudWatch . ``` aws autoscaling create-launch-configuration \ --launch-configuration-name my-lc \ --image-id ami-04d5cc9b88example \ --instance-type m5.large \ --instance-monitoring Enabled=true ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurieren der Überwachung für Auto-Scaling-Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/enable-as-instance-metrics.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 5: So erstellen Sie eine Startkonfiguration, die Spot Instances startet** In diesem Beispiel wird eine Startkonfiguration erstellt, die Spot Instances als einzige Kaufoption verwendet. ``` aws autoscaling create-launch-configuration \ --launch-configuration-name my-lc \ --image-id ami-04d5cc9b88example \ --instance-type m5.large \ --spot-price "0.50" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Anfordern von Spot Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 6: So erstellen Sie eine Startkonfiguration unter Verwendung einer EC2-Instance** In diesem Beispiel wird eine Startkonfiguration erstellt, die auf den Attributen einer vorhandenen Instance basiert. Es überschreibt die Tenancy für die Platzierung und ob eine öffentliche IP-Adresse festgelegt wird, indem die Optionen `--placement-tenancy` und `--no-associate-public-ip-address` einbezogen werden. ``` aws autoscaling create-launch-configuration \ --launch-configuration-name my-lc-from-instance \ --instance-id i-0123a456700123456 \ --instance-type m5.large \ --no-associate-public-ip-address \ --placement-tenancy dedicated ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen einer Startkonfiguration mithilfe einer EC2-Instance](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-lc-with-instanceID.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 7: So erstellen Sie eine Startkonfiguration mit einer Blockgerät-Zuweisung für ein Amazon EBS-Volume** In diesem Beispiel wird eine Startkonfiguration mit einer Blockgerät-Zuweisung für ein Amazon-EBS`gp3`-Volume mit dem Gerätenamen `/dev/sdh` und einer Volume-Größe von 20 erstellt. ``` aws autoscaling create-launch-configuration \ --launch-configuration-name my-lc \ --image-id ami-04d5cc9b88example \ --instance-type m5.large \ --block-device-mappings '[{"DeviceName":"/dev/sdh","Ebs":{"VolumeSize":20,"VolumeType":"gp3"}}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [EBS](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_Ebs.html) in der *API-Referenz für Amazon EC2 Auto Scaling*. Informationen zur Syntax für das Angeben von Parameterwerten im JSON-Format finden Sie unter [Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS CLI im Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) für die *AWS Befehlszeilenschnittstelle*. **Beispiel 8: So erstellen Sie eine Startkonfiguration mit einer Blockgerät-Zuweisung für ein Instance-Speicher-Volume** In diesem Beispiel wird eine Startkonfiguration mit `ephemeral1` als Instance-Speicher-Volume mit dem Gerätenamen `/dev/sdc` erstellt. ``` aws autoscaling create-launch-configuration \ --launch-configuration-name my-lc \ --image-id ami-04d5cc9b88example \ --instance-type m5.large \ --block-device-mappings '[{"DeviceName":"/dev/sdc","VirtualName":"ephemeral1"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [BlockDeviceMapping](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_BlockDeviceMapping.html)in der *Amazon EC2 Auto Scaling API-Referenz.* Informationen zur Syntax für das Angeben von Parameterwerten im JSON-Format finden Sie unter [Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS CLI im Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) für die *AWS Befehlszeilenschnittstelle*. **Beispiel 9: So erstellen Sie eine Startkonfiguration und verhindern, dass ein Blockgerät beim Start eine Verbindung herstellt** In diesem Beispiel wird eine Startkonfiguration erstellt, die das Blockgerät unterdrückt, das in der Blockgerät-Zuweisung des AMI angegeben ist (z. B. `/dev/sdf`). ``` aws autoscaling create-launch-configuration \ --launch-configuration-name my-lc \ --image-id ami-04d5cc9b88example \ --instance-type m5.large \ --block-device-mappings '[{"DeviceName":"/dev/sdf","NoDevice":""}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [BlockDeviceMapping](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_BlockDeviceMapping.html)in der *Amazon EC2 Auto Scaling API-Referenz.* Informationen zur Syntax für das Angeben von Parameterwerten im JSON-Format finden Sie unter [Verwenden von Anführungszeichen mit Zeichenfolgen in der AWS CLI im Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) für die *AWS Befehlszeilenschnittstelle*. + *Einzelheiten zur API finden Sie unter [CreateLaunchConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-launch-configuration.html)Befehlsreferenz.AWS CLI * ### `create-or-update-tags` Das folgende Codebeispiel zeigt die Verwendung`create-or-update-tags`. **AWS CLI** **So erstellen oder ändern Sie Tags für eine vorhandene Auto-Scaling-Gruppe** In diesem Beispiel werden der angegebenen Auto-Scaling-Gruppe zwei Tags hinzugefügt. ``` aws autoscaling create-or-update-tags \ --tags ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Role,Value=WebServer,PropagateAtLaunch=true ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Dept,Value=Research,PropagateAtLaunch=true ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Markieren von Auto Scaling-Gruppen und Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [CreateOrUpdateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-or-update-tags.html)in der *AWS CLI Befehlsreferenz*. ### `delete-auto-scaling-group` Das folgende Codebeispiel zeigt die Verwendung`delete-auto-scaling-group`. **AWS CLI** **Beispiel 1: So löschen Sie die angegebene Auto-Scaling-Gruppe** In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe gelöscht. ``` aws autoscaling delete-auto-scaling-group \ --auto-scaling-group-name my-asg ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen der Auto-Scaling-Infrastruktur](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-process-shutdown.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 2: So erzwingen Sie das Löschen der angegebenen Auto-Scaling-Gruppe** Löschen Sie die Auto-Scaling-Gruppe, ohne darauf zu warten, dass die Instances in der Gruppe beendet werden, indem Sie die `--force-delete`-Option verwenden. ``` aws autoscaling delete-auto-scaling-group \ --auto-scaling-group-name my-asg \ --force-delete ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen der Auto-Scaling-Infrastruktur](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-process-shutdown.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DeleteAutoScalingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-auto-scaling-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-launch-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-launch-configuration`. **AWS CLI** **So löschen Sie eine Startkonfiguration** In diesem Beispiel wird die angegebene Startkonfiguration gelöscht. ``` aws autoscaling delete-launch-configuration \ --launch-configuration-name my-launch-config ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen der Auto-Scaling-Infrastruktur](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-process-shutdown.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DeleteLaunchConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-launch-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-lifecycle-hook` Das folgende Codebeispiel zeigt die Verwendung`delete-lifecycle-hook`. **AWS CLI** **So löschen Sie einen Lebenszyklus-Hook** In diesem Beispiel wird der angegebene Lebenszyklus-Hook gelöscht. ``` aws autoscaling delete-lifecycle-hook \ --lifecycle-hook-name my-lifecycle-hook \ --auto-scaling-group-name my-asg ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteLifecycleHook](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-lifecycle-hook.html)in der *AWS CLI Befehlsreferenz*. ### `delete-notification-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-notification-configuration`. **AWS CLI** **So löschen Sie eine Auto-Scaling-Benachrichtigung** In diesem Beispiel wird die angegebene Benachrichtigung aus der spezifizierten Auto-Scaling-Gruppe gelöscht. ``` aws autoscaling delete-notification-configuration \ --auto-scaling-group-name my-asg \ --topic-arn arn:aws:sns:us-west-2:123456789012:my-sns-topic ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen der Benachrichtigungskonfiguration](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ASGettingNotifications.html#delete-settingupnotifications) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DeleteNotificationConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-notification-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-policy`. **AWS CLI** **So löschen Sie eine Skalierungsrichtlinie** In diesem Beispiel wird die angegebene Scaling-Richtlinie gelöscht. ``` aws autoscaling delete-policy \ --auto-scaling-group-name my-asg \ --policy-name alb1000-target-tracking-scaling-policy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeletePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-scheduled-action` Das folgende Codebeispiel zeigt die Verwendung`delete-scheduled-action`. **AWS CLI** **So löschen Sie eine geplante Aktion aus einer Auto-Scaling-Gruppe** In diesem Beispiel wird die angegebene geplante Aktion aus der spezifizierten Auto-Scaling-Gruppe gelöscht. ``` aws autoscaling delete-scheduled-action \ --auto-scaling-group-name my-asg \ --scheduled-action-name my-scheduled-action ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-scheduled-action.html)in der *AWS CLI Befehlsreferenz*. ### `delete-tags` Das folgende Codebeispiel zeigt die Verwendung`delete-tags`. **AWS CLI** **So löschen Sie ein Tag aus einer Auto-Scaling-Gruppe** In diesem Beispiel wird das angegebene Tag aus der angegebenen Auto-Scaling-Gruppe gelöscht. ``` aws autoscaling delete-tags \ --tags ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Dept,Value=Research ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Markieren von Auto Scaling-Gruppen und Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-tags.html)in der *AWS CLI Befehlsreferenz*. ### `delete-warm-pool` Das folgende Codebeispiel zeigt die Verwendung`delete-warm-pool`. **AWS CLI** **Beispiel 1: So löschen Sie einen Warm-Pool** Im folgenden Beispiel wird ein Warm-Pool für die angegebene Auto-Scaling-Gruppe gelöscht. ``` aws autoscaling delete-warm-pool \ --auto-scaling-group-name my-asg ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Warm-Pools für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-warm-pools.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 2: So erzwingen Sie das Löschen eines Warm-Pools** Verwenden Sie die Option `--force-delete`, um den Warm-Pool zu löschen, ohne darauf zu warten, dass seine Instances beendet werden. ``` aws autoscaling delete-warm-pool \ --auto-scaling-group-name my-asg \ --force-delete ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Warm-Pools für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-warm-pools.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DeleteWarmPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-warm-pool.html)in der *AWS CLI Befehlsreferenz*. ### `describe-account-limits` Das folgende Codebeispiel zeigt die Verwendung`describe-account-limits`. **AWS CLI** **So beschreiben Sie die Limits Ihres Kontos bei Amazon EC2 Auto Scaling** In diesem Beispiel werden die Amazon EC2 Auto Scaling Scaling-Limits für Ihr AWS Konto beschrieben. ``` aws autoscaling describe-account-limits ``` Ausgabe: ``` { "NumberOfLaunchConfigurations": 5, "MaxNumberOfLaunchConfigurations": 100, "NumberOfAutoScalingGroups": 3, "MaxNumberOfAutoScalingGroups": 20 } ``` Weitere Informationen finden Sie unter [Servicekontingente für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeAccountLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-account-limits.html)in der *AWS CLI Befehlsreferenz.* ### `describe-adjustment-types` Das folgende Codebeispiel zeigt die Verwendung`describe-adjustment-types`. **AWS CLI** **So beschreiben Sie die verfügbaren Typen der Skalierungsanpassung** In diesem Beispiel werden die verfügbaren Anpassungstypen beschrieben. ``` aws autoscaling describe-adjustment-types ``` Ausgabe: ``` { "AdjustmentTypes": [ { "AdjustmentType": "ChangeInCapacity" }, { "AdjustmentType": "ExactCapacity" }, { "AdjustmentType": "PercentChangeInCapacity" } ] } ``` Weitere Informationen finden Sie unter [Skalierungsanpassungstypen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html#as-scaling-adjustment) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeAdjustmentTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-adjustment-types.html)in der *AWS CLI Befehlsreferenz*. ### `describe-auto-scaling-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-auto-scaling-groups`. **AWS CLI** **Beispiel 1: So beschreiben Sie die angegebene Auto-Scaling-Gruppe** In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe beschrieben. ``` aws autoscaling describe-auto-scaling-groups \ --auto-scaling-group-names my-asg ``` Ausgabe: ``` { "AutoScalingGroups": [ { "AutoScalingGroupName": "my-asg", "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480f03:autoScalingGroupName/my-asg", "LaunchTemplate": { "LaunchTemplateName": "my-launch-template", "Version": "1", "LaunchTemplateId": "lt-1234567890abcde12" }, "MinSize": 0, "MaxSize": 1, "DesiredCapacity": 1, "DefaultCooldown": 300, "AvailabilityZones": [ "us-west-2a", "us-west-2b", "us-west-2c" ], "LoadBalancerNames": [], "TargetGroupARNs": [], "HealthCheckType": "EC2", "HealthCheckGracePeriod": 0, "Instances": [ { "InstanceId": "i-06905f55584de02da", "InstanceType": "t2.micro", "AvailabilityZone": "us-west-2a", "HealthStatus": "Healthy", "LifecycleState": "InService", "ProtectedFromScaleIn": false, "LaunchTemplate": { "LaunchTemplateName": "my-launch-template", "Version": "1", "LaunchTemplateId": "lt-1234567890abcde12" } } ], "CreatedTime": "2023-10-28T02:39:22.152Z", "SuspendedProcesses": [], "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782", "EnabledMetrics": [], "Tags": [], "TerminationPolicies": [ "Default" ], "NewInstancesProtectedFromScaleIn": false, "ServiceLinkedRoleARN":"arn", "TrafficSources": [] } ] } ``` **Beispiel 2: So beschreiben Sie die ersten 100 angegebenen Auto-Scaling-Gruppen** In diesem Beispiel werden die angegebenen Auto-Scaling-Gruppen beschrieben. Sie können bis zu 100 Gruppennamen angeben. ``` aws autoscaling describe-auto-scaling-groups \ --max-items 100 \ --auto-scaling-group-names "group1" "group2" "group3" "group4" ``` Eine Beispielausgabe finden Sie in Beispiel 1. **Beispiel 3: So beschreiben Sie eine Auto-Scaling-Gruppe in der angegebenen Region** In diesem Beispiel werden die Auto-Scaling-Gruppen in der angegebenen Region beschrieben, wobei maximal 75 Gruppen berücksichtigt werden. ``` aws autoscaling describe-auto-scaling-groups \ --max-items 75 \ --region us-east-1 ``` Eine Beispielausgabe finden Sie in Beispiel 1. **Beispiel 4: So beschreiben Sie die angegebene Anzahl von Auto-Scaling-Gruppen** Um eine bestimmte Anzahl von Auto-Scaling-Gruppen zurückzugeben, verwenden Sie die `--max-items`-Option. ``` aws autoscaling describe-auto-scaling-groups \ --max-items 1 ``` Eine Beispielausgabe finden Sie in Beispiel 1. Wenn die Ausgabe ein `NextToken`-Feld enthält, gibt es weitere Gruppen. Um die zusätzlichen Gruppen abzurufen, verwenden Sie den Wert dieses Felds mit der `--starting-token`-Option in einem nachfolgenden Aufruf wie folgt. ``` aws autoscaling describe-auto-scaling-groups \ --starting-token Z3M3LMPEXAMPLE ``` Eine Beispielausgabe finden Sie in Beispiel 1. **Beispiel 5: So beschreiben Sie Auto-Scaling-Gruppen, die Startkonfigurationen verwenden** Dieses Beispiel verwendet die `--query`-Option, um Auto-Scaling-Gruppen zu beschreiben, die Startkonfigurationen verwenden. ``` aws autoscaling describe-auto-scaling-groups \ --query 'AutoScalingGroups[?LaunchConfigurationName!=`null`]' ``` Ausgabe: ``` [ { "AutoScalingGroupName": "my-asg", "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480f03:autoScalingGroupName/my-asg", "LaunchConfigurationName": "my-lc", "MinSize": 0, "MaxSize": 1, "DesiredCapacity": 1, "DefaultCooldown": 300, "AvailabilityZones": [ "us-west-2a", "us-west-2b", "us-west-2c" ], "LoadBalancerNames": [], "TargetGroupARNs": [], "HealthCheckType": "EC2", "HealthCheckGracePeriod": 0, "Instances": [ { "InstanceId": "i-088c57934a6449037", "InstanceType": "t2.micro", "AvailabilityZone": "us-west-2c", "HealthStatus": "Healthy", "LifecycleState": "InService", "LaunchConfigurationName": "my-lc", "ProtectedFromScaleIn": false } ], "CreatedTime": "2023-10-28T02:39:22.152Z", "SuspendedProcesses": [], "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782", "EnabledMetrics": [], "Tags": [], "TerminationPolicies": [ "Default" ], "NewInstancesProtectedFromScaleIn": false, "ServiceLinkedRoleARN":"arn", "TrafficSources": [] } ] ``` Weitere Informationen finden Sie unter [AWS CLI-Ausgabe filtern](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-filter.html) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [DescribeAutoScalingGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html)unter *AWS CLI Befehlsreferenz*. ### `describe-auto-scaling-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-auto-scaling-instances`. **AWS CLI** **Beispiel 1: So beschreiben Sie eine oder mehrere Instances** In diesem Beispiel wird die angegebene Instance beschrieben. ``` aws autoscaling describe-auto-scaling-instances \ --instance-ids i-06905f55584de02da ``` Ausgabe: ``` { "AutoScalingInstances": [ { "InstanceId": "i-06905f55584de02da", "InstanceType": "t2.micro", "AutoScalingGroupName": "my-asg", "AvailabilityZone": "us-west-2b", "LifecycleState": "InService", "HealthStatus": "HEALTHY", "ProtectedFromScaleIn": false, "LaunchTemplate": { "LaunchTemplateId": "lt-1234567890abcde12", "LaunchTemplateName": "my-launch-template", "Version": "1" } } ] } ``` **Beispiel 2: So beschreiben Sie eine oder mehrere Instances** Dieses Beispiel verwendet die `--max-items`-Option, um anzugeben, wie viele Instances mit diesem Aufruf zurückgegeben werden sollen. ``` aws autoscaling describe-auto-scaling-instances \ --max-items 1 ``` Wenn die Ausgabe ein `NextToken`-Feld enthält, gibt es weitere Instances. Um die zusätzlichen Instances abzurufen, verwenden Sie den Wert dieses Felds mit der `--starting-token`-Option in einem nachfolgenden Aufruf wie folgt. ``` aws autoscaling describe-auto-scaling-instances \ --starting-token Z3M3LMPEXAMPLE ``` Eine Beispielausgabe finden Sie in Beispiel 1. **Beispiel 3: So beschreiben Sie Instances, die Startkonfigurationen verwenden** In diesem Beispiel wird die `--query`-Option verwendet, um Instances zu beschreiben, die Startkonfigurationen verwenden. ``` aws autoscaling describe-auto-scaling-instances \ --query 'AutoScalingInstances[?LaunchConfigurationName!=`null`]' ``` Ausgabe: ``` [ { "InstanceId": "i-088c57934a6449037", "InstanceType": "t2.micro", "AutoScalingGroupName": "my-asg", "AvailabilityZone": "us-west-2c", "LifecycleState": "InService", "HealthStatus": "HEALTHY", "LaunchConfigurationName": "my-lc", "ProtectedFromScaleIn": false } ] ``` Weitere Informationen finden Sie unter [AWS CLI-Ausgabe filtern](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-filter.html) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [DescribeAutoScalingInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-instances.html)unter *AWS CLI Befehlsreferenz*. ### `describe-auto-scaling-notification-types` Das folgende Codebeispiel zeigt die Verwendung`describe-auto-scaling-notification-types`. **AWS CLI** **So beschreiben Sie die verfügbaren Benachrichtigungstypen** In diesem Beispiel werden die verfügbaren Benachrichtigungstypen beschrieben. ``` aws autoscaling describe-auto-scaling-notification-types ``` Ausgabe: ``` { "AutoScalingNotificationTypes": [ "autoscaling:EC2_INSTANCE_LAUNCH", "autoscaling:EC2_INSTANCE_LAUNCH_ERROR", "autoscaling:EC2_INSTANCE_TERMINATE", "autoscaling:EC2_INSTANCE_TERMINATE_ERROR", "autoscaling:TEST_NOTIFICATION" ] } ``` Weitere Informationen finden Sie unter [Abrufen von Amazon-SNS-Benachrichtigungen über Skalierungen einer Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ASGettingNotifications.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeAutoScalingNotificationTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-notification-types.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instance-refreshes` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-refreshes`. **AWS CLI** **So beschreiben Sie Instance-Aktualisierungen** Im folgenden Beispiel für `describe-instance-refreshes` wird eine Beschreibung aller Instance-Aktualisierungsanforderungen für die angegebene Auto-Scaling-Gruppe zurückgegeben, einschließlich der Statusmeldung und (falls verfügbar) des Statusgrundes. ``` aws autoscaling describe-instance-refreshes \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "InstanceRefreshes": [ { "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b", "AutoScalingGroupName": "my-asg", "Status": "InProgress", "StatusReason": "Waiting for instances to warm up before continuing. For example: 0e69cc3f05f825f4f is warming up.", "EndTime": "2023-03-23T16:42:55Z", "PercentageComplete": 0, "InstancesToUpdate": 0, "Preferences": { "MinHealthyPercentage": 100, "InstanceWarmup": 300, "CheckpointPercentages": [ 50 ], "CheckpointDelay": 3600, "SkipMatching": false, "AutoRollback": true, "ScaleInProtectedInstances": "Ignore", "StandbyInstances": "Ignore" } }, { "InstanceRefreshId": "dd7728d0-5bc4-4575-96a3-1b2c52bf8bb1", "AutoScalingGroupName": "my-asg", "Status": "Successful", "EndTime": "2022-06-02T16:53:37Z", "PercentageComplete": 100, "InstancesToUpdate": 0, "Preferences": { "MinHealthyPercentage": 90, "InstanceWarmup": 300, "SkipMatching": true, "AutoRollback": true, "ScaleInProtectedInstances": "Ignore", "StandbyInstances": "Ignore" } } ] } ``` Weitere Informationen finden Sie unter [Überprüfen des Status einer Instance-Aktualisierung](https://docs.aws.amazon.com/en_us/autoscaling/ec2/userguide/check-status-instance-refresh.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeInstanceRefreshes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-instance-refreshes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-launch-configurations` Das folgende Codebeispiel zeigt die Verwendung`describe-launch-configurations`. **AWS CLI** **Beispiel 1: So beschreiben Sie die angegebene Startkonfiguration** In diesem Beispiel wird die angegebene Startkonfiguration beschrieben. ``` aws autoscaling describe-launch-configurations \ --launch-configuration-names my-launch-config ``` Ausgabe: ``` { "LaunchConfigurations": [ { "LaunchConfigurationName": "my-launch-config", "LaunchConfigurationARN": "arn:aws:autoscaling:us-west-2:123456789012:launchConfiguration:98d3b196-4cf9-4e88-8ca1-8547c24ced8b:launchConfigurationName/my-launch-config", "ImageId": "ami-0528a5175983e7f28", "KeyName": "my-key-pair-uswest2", "SecurityGroups": [ "sg-05eaec502fcdadc2e" ], "ClassicLinkVPCSecurityGroups": [], "UserData": "", "InstanceType": "t2.micro", "KernelId": "", "RamdiskId": "", "BlockDeviceMappings": [ { "DeviceName": "/dev/xvda", "Ebs": { "SnapshotId": "snap-06c1606ba5ca274b1", "VolumeSize": 8, "VolumeType": "gp2", "DeleteOnTermination": true, "Encrypted": false } } ], "InstanceMonitoring": { "Enabled": true }, "CreatedTime": "2020-10-28T02:39:22.321Z", "EbsOptimized": false, "AssociatePublicIpAddress": true, "MetadataOptions": { "HttpTokens": "required", "HttpPutResponseHopLimit": 1, "HttpEndpoint": "disabled" } } ] } ``` **Beispiel 2: So beschreiben Sie eine bestimmte Anzahl von Startkonfigurationen** Verwenden Sie die `--max-items`-Option, um eine bestimmte Anzahl von Startkonfigurationen zurückzugeben. ``` aws autoscaling describe-launch-configurations \ --max-items 1 ``` Wenn die Ausgabe ein `NextToken`-Feld enthält, stehen weitere Startkonfigurationen zur Verfügung. Um die zusätzlichen Startkonfigurationen abzurufen, verwenden Sie den Wert dieses Feldes mit der `--starting-token`-Option in einem nachfolgenden Aufruf wie folgt. ``` aws autoscaling describe-launch-configurations \ --starting-token Z3M3LMPEXAMPLE ``` + Einzelheiten zur API finden Sie [DescribeLaunchConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-launch-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-lifecycle-hook-types` Das folgende Codebeispiel zeigt die Verwendung`describe-lifecycle-hook-types`. **AWS CLI** **So beschreiben Sie die verfügbaren Typen von Lebenszyklus-Hooks** In diesem Beispiel werden die verfügbaren Typen von Lebenszyklus-Hooks beschrieben. ``` aws autoscaling describe-lifecycle-hook-types ``` Ausgabe: ``` { "LifecycleHookTypes": [ "autoscaling:EC2_INSTANCE_LAUNCHING", "autoscaling:EC2_INSTANCE_TERMINATING" ] } ``` + Einzelheiten zur API finden Sie [DescribeLifecycleHookTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-lifecycle-hook-types.html)in der *AWS CLI Befehlsreferenz*. ### `describe-lifecycle-hooks` Das folgende Codebeispiel zeigt die Verwendung`describe-lifecycle-hooks`. **AWS CLI** **So beschreiben Sie Ihre Lebenszyklus-Hooks** In diesem Beispiel werden die Lebenszyklus-Hooks für die angegebene Auto-Scaling-Gruppe beschrieben. ``` aws autoscaling describe-lifecycle-hooks \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "LifecycleHooks": [ { "GlobalTimeout": 3000, "HeartbeatTimeout": 30, "AutoScalingGroupName": "my-asg", "LifecycleHookName": "my-launch-hook", "DefaultResult": "ABANDON", "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING" }, { "GlobalTimeout": 6000, "HeartbeatTimeout": 60, "AutoScalingGroupName": "my-asg", "LifecycleHookName": "my-termination-hook", "DefaultResult": "CONTINUE", "LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLifecycleHooks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-lifecycle-hooks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-load-balancer-target-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-load-balancer-target-groups`. **AWS CLI** **So beschreiben Sie die Load-Balancer-Zielgruppen für eine Auto-Scaling-Gruppe** In diesem Beispiel werden die Load-Balancer-Zielgruppen beschrieben, die der angegebenen Auto-Scaling-Gruppe angehängt sind. ``` aws autoscaling describe-load-balancer-target-groups \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "LoadBalancerTargetGroups": [ { "LoadBalancerTargetGroupARN": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", "State": "Added" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLoadBalancerTargetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-load-balancer-target-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-load-balancers` Das folgende Codebeispiel zeigt die Verwendung`describe-load-balancers`. **AWS CLI** **So beschreiben Sie die Classic Load Balancers für eine Auto-Scaling-Gruppe** In diesem Beispiel werden die Classic Load Balancers für die angegebene Auto-Scaling-Gruppe beschrieben. ``` aws autoscaling describe-load-balancers \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "LoadBalancers": [ { "State": "Added", "LoadBalancerName": "my-load-balancer" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLoadBalancers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-load-balancers.html)in der *AWS CLI Befehlsreferenz*. ### `describe-metric-collection-types` Das folgende Codebeispiel zeigt die Verwendung`describe-metric-collection-types`. **AWS CLI** **So beschreiben Sie die verfügbaren Arten der Metrikerfassung** In diesem Beispiel werden die verfügbaren Arten der Metrikerfassung beschrieben. ``` aws autoscaling describe-metric-collection-types ``` Ausgabe: ``` { "Metrics": [ { "Metric": "GroupMinSize" }, { "Metric": "GroupMaxSize" }, { "Metric": "GroupDesiredCapacity" }, { "Metric": "GroupInServiceInstances" }, { "Metric": "GroupInServiceCapacity" }, { "Metric": "GroupPendingInstances" }, { "Metric": "GroupPendingCapacity" }, { "Metric": "GroupTerminatingInstances" }, { "Metric": "GroupTerminatingCapacity" }, { "Metric": "GroupStandbyInstances" }, { "Metric": "GroupStandbyCapacity" }, { "Metric": "GroupTotalInstances" }, { "Metric": "GroupTotalCapacity" } ], "Granularities": [ { "Granularity": "1Minute" } ] } ``` Weitere Informationen finden Sie unter [Auto-Scaling-Gruppen-Metriken](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html#as-group-metrics) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeMetricCollectionTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-metric-collection-types.html)in der *AWS CLI Befehlsreferenz*. ### `describe-notification-configurations` Das folgende Codebeispiel zeigt die Verwendung`describe-notification-configurations`. **AWS CLI** **Beispiel 1: So beschreiben Sie die Benachrichtigungskonfigurationen einer angegebenen Gruppe** In diesem Beispiel werden die Benachrichtigungskonfigurationen für die angegebene Auto-Scaling-Gruppe beschrieben. ``` aws autoscaling describe-notification-configurations \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "NotificationConfigurations": [ { "AutoScalingGroupName": "my-asg", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic-2" }, { "AutoScalingGroupName": "my-asg", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" } ] } ``` Weitere Informationen finden Sie unter [Abrufen von Amazon-SNS-Benachrichtigungen über Skalierungen einer Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ASGettingNotifications.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. **Beispiel 1: So beschreiben Sie eine bestimmte Anzahl von Benachrichtigungskonfigurationen** Verwenden Sie den `max-items`-Parameter, um eine bestimmte Anzahl von Benachrichtigungskonfigurationen zurückzugeben. ``` aws autoscaling describe-notification-configurations \ --auto-scaling-group-name my-auto-scaling-group \ --max-items 1 ``` Ausgabe: ``` { "NotificationConfigurations": [ { "AutoScalingGroupName": "my-asg", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic-2" }, { "AutoScalingGroupName": "my-asg", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" } ] } ``` Wenn die Ausgabe ein `NextToken`-Feld enthält, gibt es weitere Benachrichtigungskonfigurationen. Verwenden Sie den Wert dieses Feldes mit dem `starting-token`-Parameter in einem nachfolgenden Aufruf wie folgt, um die zusätzlichen Benachrichtigungskonfigurationen zu erhalten. ``` aws autoscaling describe-notification-configurations \ --auto-scaling-group-name my-asg \ --starting-token Z3M3LMPEXAMPLE ``` Weitere Informationen finden Sie unter [Abrufen von Amazon-SNS-Benachrichtigungen über Skalierungen einer Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ASGettingNotifications.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeNotificationConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-notification-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-policies` Das folgende Codebeispiel zeigt die Verwendung`describe-policies`. **AWS CLI** **Beispiel 1: So beschreiben Sie die Skalierungsrichtlinien einer angegebenen Gruppe** In diesem Beispiel wird die Richtlinien für die angegebene Auto-Scaling-Gruppe beschrieben. ``` aws autoscaling describe-policies \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "ScalingPolicies": [ { "AutoScalingGroupName": "my-asg", "PolicyName": "alb1000-target-tracking-scaling-policy", "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:3065d9c8-9969-4bec-bb6a-3fbe5550fde6:autoScalingGroupName/my-asg:policyName/alb1000-target-tracking-scaling-policy", "PolicyType": "TargetTrackingScaling", "StepAdjustments": [], "Alarms": [ { "AlarmName": "TargetTracking-my-asg-AlarmHigh-924887a9-12d7-4e01-8686-6f844d13a196", "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmHigh-924887a9-12d7-4e01-8686-6f844d13a196" }, { "AlarmName": "TargetTracking-my-asg-AlarmLow-f96f899d-b8e7-4d09-a010-c1aaa35da296", "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmLow-f96f899d-b8e7-4d09-a010-c1aaa35da296" } ], "TargetTrackingConfiguration": { "PredefinedMetricSpecification": { "PredefinedMetricType": "ALBRequestCountPerTarget", "ResourceLabel": "app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff" }, "TargetValue": 1000.0, "DisableScaleIn": false }, "Enabled": true }, { "AutoScalingGroupName": "my-asg", "PolicyName": "cpu40-target-tracking-scaling-policy", "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:5fd26f71-39d4-4690-82a9-b8515c45cdde:autoScalingGroupName/my-asg:policyName/cpu40-target-tracking-scaling-policy", "PolicyType": "TargetTrackingScaling", "StepAdjustments": [], "Alarms": [ { "AlarmName": "TargetTracking-my-asg-AlarmHigh-139f9789-37b9-42ad-bea5-b5b147d7f473", "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmHigh-139f9789-37b9-42ad-bea5-b5b147d7f473" }, { "AlarmName": "TargetTracking-my-asg-AlarmLow-bd681c67-fc18-4c56-8468-fb8e413009c9", "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-my-asg-AlarmLow-bd681c67-fc18-4c56-8468-fb8e413009c9" } ], "TargetTrackingConfiguration": { "PredefinedMetricSpecification": { "PredefinedMetricType": "ASGAverageCPUUtilization" }, "TargetValue": 40.0, "DisableScaleIn": false }, "Enabled": true } ] } ``` Weitere Informationen finden Sie unter [Dynamische Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scale-based-on-demand.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 2: So beschreiben Sie die Skalierungsrichtlinien eines bestimmten Namens** Verwenden Sie die `--policy-names`-Option, um bestimmte Skalierungsrichtlinien zurückzugeben. ``` aws autoscaling describe-policies \ --auto-scaling-group-name my-asg \ --policy-names cpu40-target-tracking-scaling-policy ``` Eine Beispielausgabe finden Sie in Beispiel 1. Weitere Informationen finden Sie unter [Dynamische Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scale-based-on-demand.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 3: So beschreiben Sie eine Reihe von Skalierungsrichtlinien** Verwenden Sie die `--max-items`-Option, um eine bestimmte Anzahl von Richtlinien zurückzugeben. ``` aws autoscaling describe-policies \ --auto-scaling-group-name my-asg \ --max-items 1 ``` Eine Beispielausgabe finden Sie in Beispiel 1. Wenn die Ausgabe ein `NextToken`-Feld enthält, verwenden Sie den Wert dieses Feldes mit der `--starting-token`-Option in einem nachfolgenden Aufruf, um die zusätzlichen Richtlinien abzurufen. ``` aws autoscaling describe-policies --auto-scaling-group-name my-asg --starting-token Z3M3LMPEXAMPLE ``` Weitere Informationen finden Sie unter [Dynamische Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scale-based-on-demand.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-policies.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scaling-activities` Das folgende Codebeispiel zeigt die Verwendung`describe-scaling-activities`. **AWS CLI** **Beispiel 1: So beschreiben Sie Skalierungsaktivitäten für die angegebene Gruppe** In diesem Beispiel werden die Skalierungsaktivitäten für die angegebene Auto-Scaling-Gruppe beschrieben. ``` aws autoscaling describe-scaling-activities \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "Activities": [ { "ActivityId": "f9f2d65b-f1f2-43e7-b46d-d86756459699", "Description": "Launching a new EC2 instance: i-0d44425630326060f", "AutoScalingGroupName": "my-asg", "Cause": "At 2020-10-30T19:35:51Z a user request update of AutoScalingGroup constraints to min: 0, max: 16, desired: 16 changing the desired capacity from 0 to 16. At 2020-10-30T19:36:07Z an instance was started in response to a difference between desired and actual capacity, increasing the capacity from 0 to 16.", "StartTime": "2020-10-30T19:36:09.766Z", "EndTime": "2020-10-30T19:36:41Z", "StatusCode": "Successful", "Progress": 100, "Details": "{\"Subnet ID\":\"subnet-5ea0c127\",\"Availability Zone\":\"us-west-2b\"}" } ] } ``` Weitere Informationen finden Sie unter [Verifizieren einer Skalierungsaktivität für eine Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-verify-scaling-activity.html) im *Benutzerhandbuch fzu ür Amazon EC2 Auto Scaling*. **Beispiel 2: So beschreiben Sie die Skalierungsaktivitäten für eine gelöschte Gruppe** Fügen Sie die `--include-deleted-groups`-Option hinzu, um Skalierungsaktivitäten nach dem Löschen der Auto-Scaling-Gruppe zu beschreiben. ``` aws autoscaling describe-scaling-activities \ --auto-scaling-group-name my-asg \ --include-deleted-groups ``` Ausgabe: ``` { "Activities": [ { "ActivityId": "e1f5de0e-f93e-1417-34ac-092a76fba220", "Description": "Launching a new EC2 instance. Status Reason: Your Spot request price of 0.001 is lower than the minimum required Spot request fulfillment price of 0.0031. Launching EC2 instance failed.", "AutoScalingGroupName": "my-asg", "Cause": "At 2021-01-13T20:47:24Z a user request update of AutoScalingGroup constraints to min: 1, max: 5, desired: 3 changing the desired capacity from 0 to 3. At 2021-01-13T20:47:27Z an instance was started in response to a difference between desired and actual capacity, increasing the capacity from 0 to 3.", "StartTime": "2021-01-13T20:47:30.094Z", "EndTime": "2021-01-13T20:47:30Z", "StatusCode": "Failed", "StatusMessage": "Your Spot request price of 0.001 is lower than the minimum required Spot request fulfillment price of 0.0031. Launching EC2 instance failed.", "Progress": 100, "Details": "{\"Subnet ID\":\"subnet-5ea0c127\",\"Availability Zone\":\"us-west-2b\"}", "AutoScalingGroupState": "Deleted", "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:283179a2-f3ce-423d-93f6-66bb518232f7:autoScalingGroupName/my-asg" } ] } ``` Weitere Informationen finden Sie unter [Fehlerbehebung bei Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/CHAP_Troubleshooting.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 3: So beschreiben Sie eine bestimmte Anzahl von Skalierungsaktivitäten** Verwenden Sie die `--max-items`-Option, um eine bestimmte Anzahl von Aktivitäten zurückzugeben. ``` aws autoscaling describe-scaling-activities \ --max-items 1 ``` Ausgabe: ``` { "Activities": [ { "ActivityId": "f9f2d65b-f1f2-43e7-b46d-d86756459699", "Description": "Launching a new EC2 instance: i-0d44425630326060f", "AutoScalingGroupName": "my-asg", "Cause": "At 2020-10-30T19:35:51Z a user request update of AutoScalingGroup constraints to min: 0, max: 16, desired: 16 changing the desired capacity from 0 to 16. At 2020-10-30T19:36:07Z an instance was started in response to a difference between desired and actual capacity, increasing the capacity from 0 to 16.", "StartTime": "2020-10-30T19:36:09.766Z", "EndTime": "2020-10-30T19:36:41Z", "StatusCode": "Successful", "Progress": 100, "Details": "{\"Subnet ID\":\"subnet-5ea0c127\",\"Availability Zone\":\"us-west-2b\"}" } ] } ``` Wenn die Ausgabe ein `NextToken`-Feld enthält, gibt es weitere Aktivitäten. Verwenden Sie den Wert dieses Feldes mit der `--starting-token`-Option in einem nachfolgenden Aufruf wie folgt, um die zusätzlichen Aktivitäten abzurufen. ``` aws autoscaling describe-scaling-activities \ --starting-token Z3M3LMPEXAMPLE ``` Weitere Informationen finden Sie unter [Verifizieren einer Skalierungsaktivität für eine Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-verify-scaling-activity.html) im *Benutzerhandbuch fzu ür Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeScalingActivities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-scaling-activities.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scaling-process-types` Das folgende Codebeispiel zeigt die Verwendung`describe-scaling-process-types`. **AWS CLI** **So beschreiben Sie die verfügbaren Prozesstypen** In diesem Beispiel werden die verfügbaren Prozesstypen beschrieben. ``` aws autoscaling describe-scaling-process-types ``` Ausgabe: ``` { "Processes": [ { "ProcessName": "AZRebalance" }, { "ProcessName": "AddToLoadBalancer" }, { "ProcessName": "AlarmNotification" }, { "ProcessName": "HealthCheck" }, { "ProcessName": "InstanceRefresh" }, { "ProcessName": "Launch" }, { "ProcessName": "ReplaceUnhealthy" }, { "ProcessName": "ScheduledActions" }, { "ProcessName": "Terminate" } ] } ``` Weitere Informationen erhalten Sie unter [Aus- und Fortsetzen von Skalierungsprozessen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-suspend-resume-processes.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeScalingProcessTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-scaling-process-types.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scheduled-actions` Das folgende Codebeispiel zeigt die Verwendung`describe-scheduled-actions`. **AWS CLI** **Beispiel 1: So beschreiben Sie alle geplanten Aktionen** In diesem Beispiel werden alle Ihre geplanten Aktionen beschrieben. ``` aws autoscaling describe-scheduled-actions ``` Ausgabe: ``` { "ScheduledUpdateGroupActions": [ { "AutoScalingGroupName": "my-asg", "ScheduledActionName": "my-recurring-action", "Recurrence": "30 0 1 1,6,12 *", "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action", "StartTime": "2023-12-01T04:00:00Z", "Time": "2023-12-01T04:00:00Z", "MinSize": 1, "MaxSize": 6, "DesiredCapacity": 4, "TimeZone": "America/New_York" } ] } ``` Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 2: So beschreiben Sie geplante Aktionen für die angegebene Gruppe** Verwenden Sie die `--auto-scaling-group-name`-Option, um die geplanten Aktionen für eine bestimmte Auto-Scaling-Gruppe zu beschreiben. ``` aws autoscaling describe-scheduled-actions \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "ScheduledUpdateGroupActions": [ { "AutoScalingGroupName": "my-asg", "ScheduledActionName": "my-recurring-action", "Recurrence": "30 0 1 1,6,12 *", "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action", "StartTime": "2023-12-01T04:00:00Z", "Time": "2023-12-01T04:00:00Z", "MinSize": 1, "MaxSize": 6, "DesiredCapacity": 4, "TimeZone": "America/New_York" } ] } ``` Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 3: So beschreiben Sie die angegebene geplante Aktion** Verwenden Sie die `--scheduled-action-names`-Option, um eine bestimmte geplante Aktion zu beschreiben. ``` aws autoscaling describe-scheduled-actions \ --scheduled-action-names my-recurring-action ``` Ausgabe: ``` { "ScheduledUpdateGroupActions": [ { "AutoScalingGroupName": "my-asg", "ScheduledActionName": "my-recurring-action", "Recurrence": "30 0 1 1,6,12 *", "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action", "StartTime": "2023-12-01T04:00:00Z", "Time": "2023-12-01T04:00:00Z", "MinSize": 1, "MaxSize": 6, "DesiredCapacity": 4, "TimeZone": "America/New_York" } ] } ``` Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 4: So beschreiben Sie geplante Aktionen mit einer bestimmten Startzeit** Verwenden Sie die `--start-time`-Option, um die geplanten Aktionen zu beschreiben, die zu einer bestimmten Zeit beginnen. ``` aws autoscaling describe-scheduled-actions \ --start-time "2023-12-01T04:00:00Z" ``` Ausgabe: ``` { "ScheduledUpdateGroupActions": [ { "AutoScalingGroupName": "my-asg", "ScheduledActionName": "my-recurring-action", "Recurrence": "30 0 1 1,6,12 *", "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action", "StartTime": "2023-12-01T04:00:00Z", "Time": "2023-12-01T04:00:00Z", "MinSize": 1, "MaxSize": 6, "DesiredCapacity": 4, "TimeZone": "America/New_York" } ] } ``` Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 5: So beschreiben Sie geplante Aktionen, die zu einem bestimmten Zeitpunkt enden** Verwenden Sie die `--end-time`-Option, um die geplanten Aktionen zu beschreiben, die zu einem bestimmten Zeitpunkt enden. ``` aws autoscaling describe-scheduled-actions \ --end-time "2023-12-01T04:00:00Z" ``` Ausgabe: ``` { "ScheduledUpdateGroupActions": [ { "AutoScalingGroupName": "my-asg", "ScheduledActionName": "my-recurring-action", "Recurrence": "30 0 1 1,6,12 *", "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action", "StartTime": "2023-12-01T04:00:00Z", "Time": "2023-12-01T04:00:00Z", "MinSize": 1, "MaxSize": 6, "DesiredCapacity": 4, "TimeZone": "America/New_York" } ] } ``` Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 6: So beschreiben Sie eine bestimmte Anzahl von geplanten Aktionen** Verwenden Sie die `--max-items`-Option, um eine bestimmte Anzahl von geplanten Aktionen zurückzugeben. ``` aws autoscaling describe-scheduled-actions \ --auto-scaling-group-name my-asg \ --max-items 1 ``` Ausgabe: ``` { "ScheduledUpdateGroupActions": [ { "AutoScalingGroupName": "my-asg", "ScheduledActionName": "my-recurring-action", "Recurrence": "30 0 1 1,6,12 *", "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-asg:scheduledActionName/my-recurring-action", "StartTime": "2023-12-01T04:00:00Z", "Time": "2023-12-01T04:00:00Z", "MinSize": 1, "MaxSize": 6, "DesiredCapacity": 4, "TimeZone": "America/New_York" } ] } ``` Wenn die Ausgabe ein `NextToken`-Feld enthält, gibt es weitere geplante Aktionen. Verwenden Sie den Wert dieses Feldes mit der `--starting-token`-Option in einem nachfolgenden Aufruf wie folgt, um die zusätzlichen Aktivitäten abzurufen. ``` aws autoscaling describe-scheduled-actions \ --auto-scaling-group-name my-asg \ --starting-token Z3M3LMPEXAMPLE ``` Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeScheduledActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-scheduled-actions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-tags` Das folgende Codebeispiel zeigt die Verwendung`describe-tags`. **AWS CLI** **So beschreiben Sie alle Tags** In diesem Beispiel werden alle Ihre Tags beschrieben. ``` aws autoscaling describe-tags ``` Ausgabe: ``` { "Tags": [ { "ResourceType": "auto-scaling-group", "ResourceId": "my-asg", "PropagateAtLaunch": true, "Value": "Research", "Key": "Dept" }, { "ResourceType": "auto-scaling-group", "ResourceId": "my-asg", "PropagateAtLaunch": true, "Value": "WebServer", "Key": "Role" } ] } ``` Weitere Informationen finden Sie unter [Markieren von Auto Scaling-Gruppen und Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. **Beispiel 2: So beschreiben Sie Tags für eine bestimmte Gruppe** Verwenden Sie die `--filters`-Option, um Tags für eine bestimmte Auto-Scaling-Gruppe zu beschreiben. ``` aws autoscaling describe-tags --filters Name=auto-scaling-group,Values=my-asg ``` Weitere Informationen finden Sie unter [Markieren von Auto Scaling-Gruppen und Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. **Beispiel 3: So beschreiben Sie die angegebene Anzahl von Tags** Verwenden Sie die `--max-items`-Option, um eine bestimmte Anzahl von Tags zurückzugeben. ``` aws autoscaling describe-tags \ --max-items 1 ``` Wenn die Ausgabe ein `NextToken`-Feld enthält, gibt es weitere Tags. Verwenden Sie den Wert dieses Feldes mit der `--starting-token`-Option in einem nachfolgenden Aufruf wie folgt, um die zusätzlichen Tags zu erhalten. ``` aws autoscaling describe-tags \ --filters Name=auto-scaling-group,Values=my-asg \ --starting-token Z3M3LMPEXAMPLE ``` Weitere Informationen finden Sie unter [Markieren von Auto Scaling-Gruppen und Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-tags.html)in der *AWS CLI Befehlsreferenz*. ### `describe-termination-policy-types` Das folgende Codebeispiel zeigt die Verwendung`describe-termination-policy-types`. **AWS CLI** **So beschreiben Sie die verfügbaren Typen von Beendigungsrichtlinien** In diesem Beispiel werden die verfügbaren Arten von Beendigungsrichtlinien beschrieben. ``` aws autoscaling describe-termination-policy-types ``` Ausgabe: ``` { "TerminationPolicyTypes": [ "AllocationStrategy", "ClosestToNextInstanceHour", "Default", "NewestInstance", "OldestInstance", "OldestLaunchConfiguration", "OldestLaunchTemplate" ] } ``` Weitere Informationen finden Sie unter [Steuern, welche Auto Scaling-Instances bei der horizontalen Skalierung nach unten beendet werden](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeTerminationPolicyTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-termination-policy-types.html)in der *AWS CLI Befehlsreferenz*. ### `describe-warm-pool` Das folgende Codebeispiel zeigt die Verwendung`describe-warm-pool`. **AWS CLI** **So beschreiben Sie einen Warm-Pool** In diesem Beispiel wird der Warm-Pool für die angegebene Auto-Scaling-Gruppe beschrieben. ``` aws autoscaling describe-warm-pool \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "WarmPoolConfiguration": { "MinSize": 2, "PoolState": "Stopped" }, "Instances": [ { "InstanceId": "i-070a5bbc7e7f40dc5", "InstanceType": "t2.micro", "AvailabilityZone": "us-west-2c", "LifecycleState": "Warmed:Pending", "HealthStatus": "Healthy", "LaunchTemplate": { "LaunchTemplateId": "lt-00a731f6e9fa48610", "LaunchTemplateName": "my-template-for-auto-scaling", "Version": "6" } }, { "InstanceId": "i-0b52f061814d3bd2d", "InstanceType": "t2.micro", "AvailabilityZone": "us-west-2b", "LifecycleState": "Warmed:Pending", "HealthStatus": "Healthy", "LaunchTemplate": { "LaunchTemplateId": "lt-00a731f6e9fa48610", "LaunchTemplateName": "my-template-for-auto-scaling", "Version": "6" } } ] } ``` Weitere Informationen finden Sie unter [Warm-Pools für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-warm-pools.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DescribeWarmPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-warm-pool.html)in der *AWS CLI Befehlsreferenz*. ### `detach-instances` Das folgende Codebeispiel zeigt die Verwendung`detach-instances`. **AWS CLI** **So trennen Sie eine Instance von einer Auto-Scaling-Gruppe** In diesem Beispiel wird die angegebene Instance von der angegebenen Auto-Scaling-Gruppe getrennt. ``` aws autoscaling detach-instances \ --instance-ids i-030017cfa84b20135 \ --auto-scaling-group-name my-asg \ --should-decrement-desired-capacity ``` Ausgabe: ``` { "Activities": [ { "ActivityId": "5091cb52-547a-47ce-a236-c9ccbc2cb2c9", "AutoScalingGroupName": "my-asg", "Description": "Detaching EC2 instance: i-030017cfa84b20135", "Cause": "At 2020-10-31T17:35:04Z instance i-030017cfa84b20135 was detached in response to a user request, shrinking the capacity from 2 to 1.", "StartTime": "2020-04-12T15:02:16.179Z", "StatusCode": "InProgress", "Progress": 50, "Details": "{\"Subnet ID\":\"subnet-6194ea3b\",\"Availability Zone\":\"us-west-2c\"}" } ] } ``` + Einzelheiten zur API finden Sie [DetachInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/detach-instances.html)in der *AWS CLI Befehlsreferenz*. ### `detach-load-balancer-target-groups` Das folgende Codebeispiel zeigt die Verwendung`detach-load-balancer-target-groups`. **AWS CLI** **So trennen Sie eine Load-Balancer-Zielgruppe von einer Auto-Scaling-Gruppe** In diesem Beispiel wird die angegebene Load-Balancer-Zielgruppe von der spezifizierten Auto-Scaling-Gruppe getrennt. ``` aws autoscaling detach-load-balancer-target-groups \ --auto-scaling-group-name my-asg \ --target-group-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Anhängen eines Load Balancers an Ihre Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DetachLoadBalancerTargetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/detach-load-balancer-target-groups.html)in der *AWS CLI Befehlsreferenz*. ### `detach-load-balancers` Das folgende Codebeispiel zeigt die Verwendung`detach-load-balancers`. **AWS CLI** **So trennen Sie einen Classic Load Balancer von einer Auto-Scaling-Gruppe** In diesem Beispiel wird der angegebene Classic Load Balancer von der spezifizierten Auto-Scaling-Gruppe getrennt. ``` aws autoscaling detach-load-balancers \ --load-balancer-names my-load-balancer \ --auto-scaling-group-name my-asg ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Anhängen eines Load Balancers an Ihre Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [DetachLoadBalancers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/detach-load-balancers.html)in der *AWS CLI Befehlsreferenz*. ### `disable-metrics-collection` Das folgende Codebeispiel zeigt die Verwendung`disable-metrics-collection`. **AWS CLI** **So deaktivieren Sie die Erfassung von Metriken für Auto-Scaling-Gruppen** In diesem Beispiel wird die Erfassung der `GroupDesiredCapacity`-Metrik für die angegebene Auto-Scaling-Gruppe deaktiviert. ``` aws autoscaling disable-metrics-collection \ --auto-scaling-group-name my-asg \ --metrics GroupDesiredCapacity ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [ CloudWatch Monitoring-Metriken für Ihre Auto Scaling Scaling-Gruppen und -Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html) im *Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DisableMetricsCollection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/disable-metrics-collection.html)in der *AWS CLI Befehlsreferenz.* ### `enable-metrics-collection` Das folgende Codebeispiel zeigt die Verwendung`enable-metrics-collection`. **AWS CLI** **Beispiel 1: So aktivieren Sie die Erfassung von Auto-Scaling-Gruppen** In diesem Beispiel wird die Datenerfassung für die angegebene Auto-Scaling-Gruppe aktiviert. ``` aws autoscaling enable-metrics-collection \ --auto-scaling-group-name my-asg \ --granularity "1Minute" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [ CloudWatch Monitoring-Metriken für Ihre Auto Scaling Scaling-Gruppen und -Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html) im *Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch*. **Beispiel 2: So sammeln Sie Daten für die angegebene Metrik einer Auto-Scaling-Gruppe** Verwenden Sie die `--metrics`-Option, um Daten für eine bestimmte Metrik zu sammeln. ``` aws autoscaling enable-metrics-collection \ --auto-scaling-group-name my-asg \ --metrics GroupDesiredCapacity --granularity "1Minute" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [ CloudWatch Monitoring-Metriken für Ihre Auto Scaling Scaling-Gruppen und -Instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html) im *Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [EnableMetricsCollection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/enable-metrics-collection.html)in der *AWS CLI Befehlsreferenz.* ### `enter-standby` Das folgende Codebeispiel zeigt die Verwendung`enter-standby`. **AWS CLI** **So verschieben Sie Instances in den Standby-Modus** In diesem Beispiel wird die angegebene Instance in den Standby-Modus versetzt. Das ist nützlich, um eine Instance zu aktualisieren oder Fehler zu beheben, die sich derzeit im Service befindet. ``` aws autoscaling enter-standby \ --instance-ids i-061c63c5eb45f0416 \ --auto-scaling-group-name my-asg \ --should-decrement-desired-capacity ``` Ausgabe: ``` { "Activities": [ { "ActivityId": "ffa056b4-6ed3-41ba-ae7c-249dfae6eba1", "AutoScalingGroupName": "my-asg", "Description": "Moving EC2 instance to Standby: i-061c63c5eb45f0416", "Cause": "At 2020-10-31T20:31:00Z instance i-061c63c5eb45f0416 was moved to standby in response to a user request, shrinking the capacity from 1 to 0.", "StartTime": "2020-10-31T20:31:00.949Z", "StatusCode": "InProgress", "Progress": 50, "Details": "{\"Subnet ID\":\"subnet-6194ea3b\",\"Availability Zone\":\"us-west-2c\"}" } ] } ``` Weitere Informationen finden Sie unter [Instance-Lebenszyklus in Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/detach-instance-asg.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [EnterStandby](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/enter-standby.html)in der *AWS CLI Befehlsreferenz*. ### `execute-policy` Das folgende Codebeispiel zeigt die Verwendung`execute-policy`. **AWS CLI** **So führen Sie eine Skalierungsrichtlinie aus** In diesem Beispiel wird die Skalierungsrichtlinie mit dem Namen `my-step-scale-out-policy` für die angegebene Auto-Scaling-Gruppe ausgeführt. ``` aws autoscaling execute-policy \ --auto-scaling-group-name my-asg \ --policy-name my-step-scale-out-policy \ --metric-value 95 \ --breach-threshold 80 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schrittweise und einfache Skalierungsrichtlinien](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [ExecutePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/execute-policy.html)in der *AWS CLI Befehlsreferenz*. ### `exit-standby` Das folgende Codebeispiel zeigt die Verwendung`exit-standby`. **AWS CLI** **So verschieben Sie Instances aus dem Standby-Modus** In diesem Beispiel wird die angegebenen Instance aus dem Standby-Modus verschoben. ``` aws autoscaling exit-standby \ --instance-ids i-061c63c5eb45f0416 \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "Activities": [ { "ActivityId": "142928e1-a2dc-453a-9b24-b85ad6735928", "AutoScalingGroupName": "my-asg", "Description": "Moving EC2 instance out of Standby: i-061c63c5eb45f0416", "Cause": "At 2020-10-31T20:32:50Z instance i-061c63c5eb45f0416 was moved out of standby in response to a user request, increasing the capacity from 0 to 1.", "StartTime": "2020-10-31T20:32:50.222Z", "StatusCode": "PreInService", "Progress": 30, "Details": "{\"Subnet ID\":\"subnet-6194ea3b\",\"Availability Zone\":\"us-west-2c\"}" } ] } ``` Weitere Informationen finden Sie unter [Vorübergehendes Entfernen von Instances aus einer Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-enter-exit-standby.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [ExitStandby](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/exit-standby.html)in der *AWS CLI Befehlsreferenz*. ### `put-lifecycle-hook` Das folgende Codebeispiel zeigt die Verwendung`put-lifecycle-hook`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Lebenszyklus-Hook** In diesem Beispiel wird ein Lebenszyklus-Hook erstellt, der bei allen neu gestarteten Instances mit einem Timeout von 4 800 Sekunden aufgerufen wird. Dies ist nützlich, um die Instanzen im Wartezustand zu halten, bis die Benutzerdatenskripts abgeschlossen sind, oder um eine AWS Lambda-Funktion mit aufzurufen. EventBridge ``` aws autoscaling put-lifecycle-hook \ --auto-scaling-group-name my-asg \ --lifecycle-hook-name my-launch-hook \ --lifecycle-transition autoscaling:EC2_INSTANCE_LAUNCHING \ --heartbeat-timeout 4800 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Wenn ein Lebenszyklus-Hook mit demselben Namen bereits vorhanden ist, wird er durch den neuen Lebenszyklus-Hook überschrieben. Weitere Informationen finden Sie unter [Lebenszyklus-Hooks für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 2: So senden Sie eine E-Mail-Nachricht in Amazon SNS, die Sie über den Statuswechsel einer Instance informiert** In diesem Beispiel wird ein Lebenszyklus-Hook mit dem Amazon-SNS-Thema und der IAM-Rolle erstellt, die zum Empfangen von Benachrichtigungen beim Instance-Start verwendet werden sollen. ``` aws autoscaling put-lifecycle-hook \ --auto-scaling-group-name my-asg \ --lifecycle-hook-name my-launch-hook \ --lifecycle-transition autoscaling:EC2_INSTANCE_LAUNCHING \ --notification-target-arn arn:aws:sns:us-west-2:123456789012:my-sns-topic \ --role-arn arn:aws:iam::123456789012:role/my-auto-scaling-role ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lebenszyklus-Hooks für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 3: So veröffentlichen Sie eine Nachricht in einer Amazon-SQS-Warteschlange** In diesem Beispiel wird ein Lebenszyklus-Hook erstellt, der eine Nachricht mit Metadaten in der angegebenen Amazon-SQS-Warteschlange veröffentlicht. ``` aws autoscaling put-lifecycle-hook \ --auto-scaling-group-name my-asg \ --lifecycle-hook-name my-launch-hook \ --lifecycle-transition autoscaling:EC2_INSTANCE_LAUNCHING \ --notification-target-arn arn:aws:sqs:us-west-2:123456789012:my-sqs-queue \ --role-arn arn:aws:iam::123456789012:role/my-notification-role \ --notification-metadata "SQS message metadata" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lebenszyklus-Hooks für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [PutLifecycleHook](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-lifecycle-hook.html)in der *AWS CLI Befehlsreferenz*. ### `put-notification-configuration` Das folgende Codebeispiel zeigt die Verwendung`put-notification-configuration`. **AWS CLI** **So fügen Sie eine neue Benachrichtigung hinzu** In diesem Beispiel wird die angegebene Benachrichtigung der spezifizierten Auto-Scaling-Gruppe hinzugefügt. ``` aws autoscaling put-notification-configuration \ --auto-scaling-group-name my-asg \ --topic-arn arn:aws:sns:us-west-2:123456789012:my-sns-topic \ --notification-type autoscaling:TEST_NOTIFICATION ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Abrufen von Amazon-SNS-Benachrichtigungen über Skalierungen einer Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ASGettingNotifications.html#as-configure-asg-for-sns) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [PutNotificationConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-notification-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `put-scaling-policy` Das folgende Codebeispiel zeigt die Verwendung`put-scaling-policy`. **AWS CLI** **So fügen Sie einer Auto-Scaling-Gruppe eine Richtlinie zur Zielverfolgung hinzu** Im folgenden Beispiel für `put-scaling-policy` wird eine Skalierungsrichtlinie zur Zielverfolgung auf die angegebene Auto-Scaling-Gruppe angewendet. Die Ausgabe enthält die Namen ARNs und der beiden CloudWatch Alarme, die in Ihrem Namen erstellt wurden. Wenn bereits eine Skalierungsrichtlinie mit demselben Namen vorhanden ist, wird diese durch die neue Skalierungsrichtlinie überschrieben. ``` aws autoscaling put-scaling-policy --auto-scaling-group-name my-asg \ --policy-name alb1000-target-tracking-scaling-policy \ --policy-type TargetTrackingScaling \ --target-tracking-configuration file://config.json ``` Inhalt von `config.json`: ``` { "TargetValue": 1000.0, "PredefinedMetricSpecification": { "PredefinedMetricType": "ALBRequestCountPerTarget", "ResourceLabel": "app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff" } } ``` Ausgabe: ``` { "PolicyARN": "arn:aws:autoscaling:region:account-id:scalingPolicy:228f02c2-c665-4bfd-aaac-8b04080bea3c:autoScalingGroupName/my-asg:policyName/alb1000-target-tracking-scaling-policy", "Alarms": [ { "AlarmARN": "arn:aws:cloudwatch:region:account-id:alarm:TargetTracking-my-asg-AlarmHigh-fc0e4183-23ac-497e-9992-691c9980c38e", "AlarmName": "TargetTracking-my-asg-AlarmHigh-fc0e4183-23ac-497e-9992-691c9980c38e" }, { "AlarmARN": "arn:aws:cloudwatch:region:account-id:alarm:TargetTracking-my-asg-AlarmLow-61a39305-ed0c-47af-bd9e-471a352ee1a2", "AlarmName": "TargetTracking-my-asg-AlarmLow-61a39305-ed0c-47af-bd9e-471a352ee1a2" } ] } ``` Weitere Beispiele finden Sie unter [Beispiel für Skalierungsrichtlinien für die AWS Befehlszeilenschnittstelle (AWS CLI)](https://docs.aws.amazon.com/autoscaling/ec2/userguide/examples-scaling-policies.html) im *Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutScalingPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-scaling-policy.html)in der *AWS CLI Befehlsreferenz.* ### `put-scheduled-update-group-action` Das folgende Codebeispiel zeigt die Verwendung`put-scheduled-update-group-action`. **AWS CLI** **Beispiel 1: So fügen Sie einer Auto-Scaling-Gruppe eine geplante Aktion hinzu** In diesem Beispiel wird die angegebene geplante Aktion der angegebenen Auto-Scaling-Gruppe hinzugefügt. ``` aws autoscaling put-scheduled-update-group-action \ --auto-scaling-group-name my-asg \ --scheduled-action-name my-scheduled-action \ --start-time "2023-05-12T08:00:00Z" \ --min-size 2 \ --max-size 6 \ --desired-capacity 4 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Wenn eine geplante Aktion mit demselben Namen bereits vorhanden ist, wird sie durch die neue geplante Aktion überschrieben. Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 2: So geben Sie einen wiederkehrenden Zeitplan an** In diesem Beispiel wird eine geplante Aktion erstellt, die nach einem wiederkehrenden Zeitplan skaliert wird und jedes Jahr am 1. Januar, Juni und Dezember um 00:30 Uhr ausgeführt wird. ``` aws autoscaling put-scheduled-update-group-action \ --auto-scaling-group-name my-asg \ --scheduled-action-name my-recurring-action \ --recurrence "30 0 1 1,6,12 *" \ --min-size 2 \ --max-size 6 \ --desired-capacity 4 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Wenn eine geplante Aktion mit demselben Namen bereits vorhanden ist, wird sie durch die neue geplante Aktion überschrieben. Weitere Informationen finden Sie unter [Geplante Skalierung](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-scheduled-scaling.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [PutScheduledUpdateGroupAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-scheduled-update-group-action.html)in der *AWS CLI Befehlsreferenz*. ### `put-warm-pool` Das folgende Codebeispiel zeigt die Verwendung`put-warm-pool`. **AWS CLI** **So erstellen Sie einen Warm-Pool** Im folgenden Beispiel wird ein Warm-Pool für die angegebene Auto-Scaling-Gruppe erstellt. ``` aws autoscaling put-warm-pool \ --auto-scaling-group-name my-asg \ --min-size 2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Wenn bereits ein Warm-Pool vorhanden ist, wird dieser aktualisiert. Weitere Informationen finden Sie unter [Warm-Pools für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-warm-pools.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [PutWarmPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)in der *AWS CLI Befehlsreferenz*. ### `record-lifecycle-action-heartbeat` Das folgende Codebeispiel zeigt die Verwendung`record-lifecycle-action-heartbeat`. **AWS CLI** **So zeichnen Sie den Heartbeat einer Lebenszyklusaktion auf** Dieses Beispiel zeichnet den Heartbeat für eine Lebenszyklusaktion auf, um die Instance im Status „Ausstehend“ zu halten. ``` aws autoscaling record-lifecycle-action-heartbeat \ --lifecycle-hook-name my-launch-hook \ --auto-scaling-group-name my-asg \ --lifecycle-action-token bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lebenszyklus-Hooks für Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [RecordLifecycleActionHeartbeat](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/record-lifecycle-action-heartbeat.html)in der *AWS CLI Befehlsreferenz*. ### `resume-processes` Das folgende Codebeispiel zeigt die Verwendung`resume-processes`. **AWS CLI** **So setzen Sie einen ausgesetzten Prozess fort** In diesem Beispiel wird der angegebene ausgesetzte Skalierungsprozess für die spezifizierte Auto-Scaling-Gruppe fortgesetzt. ``` aws autoscaling resume-processes \ --auto-scaling-group-name my-asg \ --scaling-processes AlarmNotification ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen erhalten Sie unter [Aus- und Fortsetzen von Skalierungsprozessen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-suspend-resume-processes.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [ResumeProcesses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/resume-processes.html)in der *AWS CLI Befehlsreferenz*. ### `rollback-instance-refresh` Das folgende Codebeispiel zeigt die Verwendung`rollback-instance-refresh`. **AWS CLI** **So machen Sie eine Instance-Aktualisierung rückgängig** Im folgenden Beispiel für `rollback-instance-refresh` wird eine laufende Instance-Aktualisierung für die angegebene Auto-Scaling-Gruppe rückgängig gemacht. ``` aws autoscaling rollback-instance-refresh \ --auto-scaling-group-name my-asg ``` Ausgabe: ``` { "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b" } ``` Weitere Informationen finden Sie unter [Änderungen mit einem Rollback rückgängig machen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/instance-refresh-rollback.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [RollbackInstanceRefresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/rollback-instance-refresh.html)in der *AWS CLI Befehlsreferenz*. ### `set-desired-capacity` Das folgende Codebeispiel zeigt die Verwendung`set-desired-capacity`. **AWS CLI** **So geben Sie die gewünschte Kapazität für die Auto-Scaling-Gruppe an** In diesem Beispiel wird die gewünschte Kapazität für die angegebene Auto-Scaling-Gruppe angegeben. ``` aws autoscaling set-desired-capacity \ --auto-scaling-group-name my-asg \ --desired-capacity 2 \ --honor-cooldown ``` Wenn dieser Befehl erfolgreich war, kehrt er zum Prompt zurück. + Einzelheiten zur API finden Sie [SetDesiredCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/set-desired-capacity.html)in der *AWS CLI Befehlsreferenz*. ### `set-instance-health` Das folgende Codebeispiel zeigt die Verwendung`set-instance-health`. **AWS CLI** **So geben Sie den Zustand einer Instance an** In diesem Beispiel wird der Zustand der angegebenen Instance auf `Unhealthy` gesetzt. ``` aws autoscaling set-instance-health \ --instance-id i-061c63c5eb45f0416 \ --health-status Unhealthy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [SetInstanceHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/set-instance-health.html)in der *AWS CLI Befehlsreferenz*. ### `set-instance-protection` Das folgende Codebeispiel zeigt die Verwendung`set-instance-protection`. **AWS CLI** **Beispiel 1: So ändern Sie die Instance-Schutzeinstellung für eine Instance** In diesem Beispiel wird der Instance-Schutz für die angegebene Instance aktiviert. ``` aws autoscaling set-instance-protection \ --instance-ids i-061c63c5eb45f0416 \ --auto-scaling-group-name my-asg --protected-from-scale-in ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So ändern Sie die Instance-Schutzeinstellung für eine Instance** In diesem Beispiel wird der Instance-Schutz für die angegebene Instance deaktiviert. ``` aws autoscaling set-instance-protection \ --instance-ids i-061c63c5eb45f0416 \ --auto-scaling-group-name my-asg \ --no-protected-from-scale-in ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [SetInstanceProtection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/set-instance-protection.html)in der *AWS CLI Befehlsreferenz*. ### `start-instance-refresh` Das folgende Codebeispiel zeigt die Verwendung`start-instance-refresh`. **AWS CLI** **Beispiel 1: So starten Sie eine Instance-Aktualisierung mithilfe von Befehlszeilenparametern** Im folgenden Beispiel für `start-instance-refresh` wird eine Instance-Aktualisierung mithilfe von Befehlszeilenargumenten gestartet. Der optionale Parameter `preferences` gibt ein `InstanceWarmup` von `60` Sekunden und einen `MinHealthyPercentage` von `50` Prozent an. ``` aws autoscaling start-instance-refresh \ --auto-scaling-group-name my-asg \ --preferences '{"InstanceWarmup": 60, "MinHealthyPercentage": 50}' ``` Ausgabe: ``` { "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b" } ``` Weitere Informationen finden Sie unter [Starten einer Instance-Aktualisierung](https://docs.aws.amazon.com/en_us/autoscaling/ec2/userguide/start-instance-refresh.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 2: So starten Sie eine Instance-Aktualisierung mithilfe einer JSON-Datei** Im folgenden Beispiel für `start-instance-refresh` wird eine Instance-Aktualisierung mithilfe einer JSON-Datei gestartet. Sie können die Auto-Scaling-Gruppe angeben und Ihre gewünschte Konfiguration und bevorzugten Einstellungen in einer JSON-Datei definieren, wie im folgenden Beispiel gezeigt. ``` aws autoscaling start-instance-refresh \ --cli-input-json file://config.json ``` Inhalt von `config.json`: ``` { "AutoScalingGroupName": "my-asg", "DesiredConfiguration": { "LaunchTemplate": { "LaunchTemplateId": "lt-068f72b729example", "Version": "$Default" } }, "Preferences": { "InstanceWarmup": 60, "MinHealthyPercentage": 50, "AutoRollback": true, "ScaleInProtectedInstances": Ignore, "StandbyInstances": Terminate } } ``` Ausgabe: ``` { "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b" } ``` Weitere Informationen finden Sie unter [Starten einer Instance-Aktualisierung](https://docs.aws.amazon.com/en_us/autoscaling/ec2/userguide/start-instance-refresh.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [StartInstanceRefresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)in der *AWS CLI Befehlsreferenz*. ### `suspend-processes` Das folgende Codebeispiel zeigt die Verwendung`suspend-processes`. **AWS CLI** **So setzen Sie Auto-Scaling-Prozesse aus** In diesem Beispiel wird der angegebene Skalierungsprozess für die spezifizierte Auto-Scaling-Gruppe ausgesetzt. ``` aws autoscaling suspend-processes \ --auto-scaling-group-name my-asg \ --scaling-processes AlarmNotification ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen erhalten Sie unter [Aus- und Fortsetzen von Skalierungsprozessen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-suspend-resume-processes.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie [SuspendProcesses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/suspend-processes.html)in der *AWS CLI Befehlsreferenz*. ### `terminate-instance-in-auto-scaling-group` Das folgende Codebeispiel zeigt die Verwendung`terminate-instance-in-auto-scaling-group`. **AWS CLI** **So beenden Sie eine Instance in einer Auto-Scaling-Gruppe** In diesem Beispiel wird die angegebene Instance in der angegebenen Auto-Scaling-Gruppe beendet, ohne dass die Größe der Gruppe aktualisiert wird. Amazon EC2 Auto Scaling startet eine Ersatz-Instance, nachdem die angegebene Instance beendet wurde. ``` aws autoscaling terminate-instance-in-auto-scaling-group \ --instance-id i-061c63c5eb45f0416 \ --no-should-decrement-desired-capacity ``` Ausgabe: ``` { "Activities": [ { "ActivityId": "8c35d601-793c-400c-fcd0-f64a27530df7", "AutoScalingGroupName": "my-asg", "Description": "Terminating EC2 instance: i-061c63c5eb45f0416", "Cause": "", "StartTime": "2020-10-31T20:34:25.680Z", "StatusCode": "InProgress", "Progress": 0, "Details": "{\"Subnet ID\":\"subnet-6194ea3b\",\"Availability Zone\":\"us-west-2c\"}" } ] } ``` + Einzelheiten zur API finden Sie [TerminateInstanceInAutoScalingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/terminate-instance-in-auto-scaling-group.html)in der *AWS CLI Befehlsreferenz*. ### `update-auto-scaling-group` Das folgende Codebeispiel zeigt die Verwendung`update-auto-scaling-group`. **AWS CLI** **Beispiel 1: So aktualisieren Sie die Größenbeschränkungen einer Auto-Scaling-Gruppe** In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe mit einer Mindestgröße von 2 und einer Höchstgröße von 10 aktualisiert. ``` aws autoscaling update-auto-scaling-group \ --auto-scaling-group-name my-asg \ --min-size 2 \ --max-size 10 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Festlegen der Größenbeschränkungen für Ihre Auto-Scaling-Gruppe](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-capacity-limits.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 2: So fügen Sie Zustandsprüfungen für Elastic Load Balancing hinzu und legen fest, welche Availability Zones und Subnetze verwendet werden sollen** In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe aktualisiert, um Zustandsprüfungen für Elastic Load Balancing-hinzuzufügen. Dieser Befehl aktualisiert den Wert von auch `--vpc-zone-identifier` mit einer Liste von Subnetzen IDs in mehreren Availability Zones. ``` aws autoscaling update-auto-scaling-group \ --auto-scaling-group-name my-asg \ --health-check-type ELB \ --health-check-grace-period 600 \ --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Elastic Load Balancing und Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. **Beispiel 3: So aktualisieren Sie die Platzierungsgruppe und die Beendigungsrichtlinie** In diesem Beispiel werden die zu verwendende Platzierungsgruppe und die Beendigungsrichtlinie aktualisiert. ``` aws autoscaling update-auto-scaling-group \ --auto-scaling-group-name my-asg \ --placement-group my-placement-group \ --termination-policies "OldestInstance" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Auto-Scaling-Gruppen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroup.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. **Beispiel 4: So verwenden Sie die neueste Version der Startvorlage** In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe aktualisiert, um die neueste Version der angegebenen Startvorlage zu verwenden. ``` aws autoscaling update-auto-scaling-group \ --auto-scaling-group-name my-asg \ --launch-template LaunchTemplateId=lt-1234567890abcde12,Version='$Latest' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Startvorlagen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchTemplates.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. **Beispiel 5: So verwenden Sie eine bestimmte Version der Startvorlage** In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe aktualisiert, um eine bestimmte Version einer Startvorlage anstelle der neuesten oder der Standardversion zu verwenden. ``` aws autoscaling update-auto-scaling-group \ --auto-scaling-group-name my-asg \ --launch-template LaunchTemplateName=my-template-for-auto-scaling,Version='2' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Startvorlagen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchTemplates.html) im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. **Beispiel 6: So definieren Sie eine Richtlinie für gemischte Instances und aktivieren den Kapazitätsausgleich** In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe aktualisiert, um eine Richtlinie für gemischte Instances zu verwenden, gleichzeitig wird die Kapazitätsanpassung aktiviert. Mit dieser Struktur können Sie Gruppen mit Spot- und On-Demand-Kapazitäten angeben und verschiedene Startvorlagen für unterschiedliche Architekturen verwenden. ``` aws autoscaling update-auto-scaling-group \ --cli-input-json file://~/config.json ``` Inhalt von `config.json`: ``` { "AutoScalingGroupName": "my-asg", "CapacityRebalance": true, "MixedInstancesPolicy": { "LaunchTemplate": { "LaunchTemplateSpecification": { "LaunchTemplateName": "my-launch-template-for-x86", "Version": "$Latest" }, "Overrides": [ { "InstanceType": "c6g.large", "LaunchTemplateSpecification": { "LaunchTemplateName": "my-launch-template-for-arm", "Version": "$Latest" } }, { "InstanceType": "c5.large" }, { "InstanceType": "c5a.large" } ] }, "InstancesDistribution": { "OnDemandPercentageAboveBaseCapacity": 50, "SpotAllocationStrategy": "capacity-optimized" } } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Auto-Scaling-Gruppen mit mehreren Instance-Typen und Kaufoptionen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html) im *Benutzerhandbuch für Amazon EC2 Auto Scaling*. + Einzelheiten zur API finden Sie unter [UpdateAutoScalingGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/update-auto-scaling-group.html)*Befehlsreferenz.* # Beispiele für Auto Scaling-Pläne mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Auto Scaling-Plänen Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-scaling-plan` Das folgende Codebeispiel zeigt die Verwendung von`create-scaling-plan`. **AWS CLI** **So erstellen Sie einen Skalierungsplan** Im folgenden Beispiel für `create-scaling-plan` wird ein Skalierungsplan namens `my-scaling-plan` mithilfe einer bereits erstellten JSON-Datei (mit dem Namen config.json) erstellt. Die Struktur des Skalierungsplans umfasst eine Skalierungsanleitung für eine Auto-Scaling-Gruppe mit dem Namen `my-asg`. Er gibt die `TagFilters`-Eigenschaft als Anwendungsquelle an und ermöglicht prädiktive Skalierung und dynamische Skalierung. ``` aws autoscaling-plans create-scaling-plan \ --scaling-plan-name my-scaling-plan \ --cli-input-json file://~/config.json ``` Inhalt der `config.json`-Datei: ``` { "ApplicationSource": { "TagFilters": [ { "Key": "purpose", "Values": [ "my-application" ] } ] }, "ScalingInstructions": [ { "ServiceNamespace": "autoscaling", "ResourceId": "autoScalingGroup/my-asg", "ScalableDimension": "autoscaling:autoScalingGroup:DesiredCapacity", "ScheduledActionBufferTime": 300, "PredictiveScalingMaxCapacityBehavior": "SetForecastCapacityToMaxCapacity", "PredictiveScalingMode": "ForecastAndScale", "PredefinedLoadMetricSpecification": { "PredefinedLoadMetricType": "ASGTotalCPUUtilization" }, "ScalingPolicyUpdateBehavior": "ReplaceExternalPolicies", "MinCapacity": 1, "MaxCapacity": 4, "TargetTrackingConfigurations": [ { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "ASGAverageCPUUtilization" }, "TargetValue": 50 } ] } ] } ``` Ausgabe: ``` { "ScalingPlanVersion": 1 } ``` Weitere Informationen finden Sie im [Benutzerhandbuch für AWS Auto Scaling](https://docs.aws.amazon.com/autoscaling/plans/userguide/what-is-aws-auto-scaling.html). + Einzelheiten zur API finden Sie [CreateScalingPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling-plans/create-scaling-plan.html)in der *AWS CLI Befehlsreferenz*. ### `delete-scaling-plan` Das folgende Codebeispiel zeigt die Verwendung`delete-scaling-plan`. **AWS CLI** **So löschen Sie einen Skalierungsplan** Im folgenden Beispiel für `delete-scaling-plan` wird der angegebene Skalierungsplan gelöscht. ``` aws autoscaling-plans delete-scaling-plan \ --scaling-plan-name my-scaling-plan \ --scaling-plan-version 1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im [Benutzerhandbuch für AWS Auto Scaling](https://docs.aws.amazon.com/autoscaling/plans/userguide/what-is-aws-auto-scaling.html). + Einzelheiten zur API finden Sie [DeleteScalingPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling-plans/delete-scaling-plan.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scaling-plan-resources` Das folgende Codebeispiel zeigt die Verwendung`describe-scaling-plan-resources`. **AWS CLI** **So beschreiben Sie die skalierbaren Ressourcen für einen Skalierungsplan** Im folgenden Beispiel für `describe-scaling-plan-resources` werden Details zu der einzelnen skalierbaren Ressource (einer Auto-Scaling-Gruppe) angezeigt, die dem angegebenen Skalierungsplan zugeordnet ist. ``` aws autoscaling-plans describe-scaling-plan-resources \ --scaling-plan-name my-scaling-plan \ --scaling-plan-version 1 ``` Ausgabe: ``` { "ScalingPlanResources": [ { "ScalableDimension": "autoscaling:autoScalingGroup:DesiredCapacity", "ScalingPlanVersion": 1, "ResourceId": "autoScalingGroup/my-asg", "ScalingStatusCode": "Active", "ScalingStatusMessage": "Target tracking scaling policies have been applied to the resource.", "ScalingPolicies": [ { "PolicyName": "AutoScaling-my-asg-b1ab65ae-4be3-4634-bd64-c7471662b251", "PolicyType": "TargetTrackingScaling", "TargetTrackingConfiguration": { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "ALBRequestCountPerTarget", "ResourceLabel": "app/my-alb/f37c06a68c1748aa/targetgroup/my-target-group/6d4ea56ca2d6a18d" }, "TargetValue": 40.0 } } ], "ServiceNamespace": "autoscaling", "ScalingPlanName": "my-scaling-plan" } ] } ``` Weitere Informationen finden Sie unter [Was ist AWS Auto Scaling?](https://docs.aws.amazon.com/autoscaling/plans/userguide/what-is-aws-auto-scaling.html) im *AWS Auto Scaling Scaling-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeScalingPlanResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling-plans/describe-scaling-plan-resources.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scaling-plans` Das folgende Codebeispiel zeigt die Verwendung`describe-scaling-plans`. **AWS CLI** **So beschreiben Sie einen Skalierungsplan** Im folgenden Beispiel für `describe-scaling-plans` werden die Details des angegebenen Skalierungsplans angezeigt. ``` aws autoscaling-plans describe-scaling-plans \ --scaling-plan-names scaling-plan-with-asg-and-ddb ``` Ausgabe: ``` { "ScalingPlans": [ { "LastMutatingRequestTime": 1565388443.963, "ScalingPlanVersion": 1, "CreationTime": 1565388443.963, "ScalingInstructions": [ { "ScalingPolicyUpdateBehavior": "ReplaceExternalPolicies", "ScalableDimension": "autoscaling:autoScalingGroup:DesiredCapacity", "TargetTrackingConfigurations": [ { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "ASGAverageCPUUtilization" }, "TargetValue": 50.0, "EstimatedInstanceWarmup": 300, "DisableScaleIn": false } ], "ResourceId": "autoScalingGroup/my-asg", "DisableDynamicScaling": false, "MinCapacity": 1, "ServiceNamespace": "autoscaling", "MaxCapacity": 10 }, { "ScalingPolicyUpdateBehavior": "ReplaceExternalPolicies", "ScalableDimension": "dynamodb:table:ReadCapacityUnits", "TargetTrackingConfigurations": [ { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "DynamoDBReadCapacityUtilization" }, "TargetValue": 50.0, "ScaleInCooldown": 60, "DisableScaleIn": false, "ScaleOutCooldown": 60 } ], "ResourceId": "table/my-table", "DisableDynamicScaling": false, "MinCapacity": 5, "ServiceNamespace": "dynamodb", "MaxCapacity": 10000 }, { "ScalingPolicyUpdateBehavior": "ReplaceExternalPolicies", "ScalableDimension": "dynamodb:table:WriteCapacityUnits", "TargetTrackingConfigurations": [ { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "DynamoDBWriteCapacityUtilization" }, "TargetValue": 50.0, "ScaleInCooldown": 60, "DisableScaleIn": false, "ScaleOutCooldown": 60 } ], "ResourceId": "table/my-table", "DisableDynamicScaling": false, "MinCapacity": 5, "ServiceNamespace": "dynamodb", "MaxCapacity": 10000 } ], "ApplicationSource": { "TagFilters": [ { "Values": [ "my-application-id" ], "Key": "application" } ] }, "StatusStartTime": 1565388455.836, "ScalingPlanName": "scaling-plan-with-asg-and-ddb", "StatusMessage": "Scaling plan has been created and applied to all resources.", "StatusCode": "Active" } ] } ``` Weitere Informationen finden Sie unter [Was ist AWS Auto Scaling?](https://docs.aws.amazon.com/autoscaling/plans/userguide/what-is-aws-auto-scaling.html) im *AWS Auto Scaling Scaling-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeScalingPlans](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling-plans/describe-scaling-plans.html)in der *AWS CLI Befehlsreferenz*. ### `get-scaling-plan-resource-forecast-data` Das folgende Codebeispiel zeigt die Verwendung`get-scaling-plan-resource-forecast-data`. **AWS CLI** **So rufen Sie Lastprognosedaten ab** In diesem Beispiel werden Lastprognosedaten für eine skalierbare Ressource (eine Auto-Scaling-Gruppe) abgerufen, die dem angegebenen Skalierungsplan zugeordnet ist. ``` aws autoscaling-plans get-scaling-plan-resource-forecast-data \ --scaling-plan-name my-scaling-plan \ --scaling-plan-version 1 \ --service-namespace "autoscaling" \ --resource-id autoScalingGroup/my-asg \ --scalable-dimension "autoscaling:autoScalingGroup:DesiredCapacity" \ --forecast-data-type "LoadForecast" \ --start-time "2019-08-30T00:00:00Z" \ --end-time "2019-09-06T00:00:00Z" ``` Ausgabe: ``` { "Datapoints": [...] } ``` Weitere Informationen finden Sie unter [Was ist AWS Auto Scaling](https://docs.aws.amazon.com/autoscaling/plans/userguide/what-is-aws-auto-scaling.html) im *AWS Auto Scaling Scaling-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetScalingPlanResourceForecastData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling-plans/get-scaling-plan-resource-forecast-data.html)in der *AWS CLI Befehlsreferenz*. ### `update-scaling-plan` Das folgende Codebeispiel zeigt die Verwendung`update-scaling-plan`. **AWS CLI** **So aktualisieren Sie einen Skalierungsplan** Im folgenden Beispiel für `update-scaling-plan` wird die Skalierungsmetrik für eine Auto-Scaling-Gruppe im angegebenen Skalierungsplan geändert. ``` aws autoscaling-plans update-scaling-plan \ --scaling-plan-name my-scaling-plan \ --scaling-plan-version 1 \ --scaling-instructions '{"ScalableDimension":"autoscaling:autoScalingGroup:DesiredCapacity","ResourceId":"autoScalingGroup/my-asg","ServiceNamespace":"autoscaling","TargetTrackingConfigurations":[{"PredefinedScalingMetricSpecification": {"PredefinedScalingMetricType":"ALBRequestCountPerTarget","ResourceLabel":"app/my-alb/f37c06a68c1748aa/targetgroup/my-target-group/6d4ea56ca2d6a18d"},"TargetValue":40.0}],"MinCapacity": 1,"MaxCapacity": 10}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Was ist AWS Auto Scaling?](https://docs.aws.amazon.com/autoscaling/plans/userguide/what-is-aws-auto-scaling.html) im *AWS Auto Scaling Scaling-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateScalingPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling-plans/update-scaling-plan.html)in der *AWS CLI Befehlsreferenz*. # AWS Backup Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Backup. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-backup-plan` Das folgende Codebeispiel zeigt, wie Sie`create-backup-plan`. **AWS CLI** **So erstellen Sie einen Backup-Plan** Im folgenden Beispiel für `create-backup-plan` wird der angegebene Backup-Plan mit einer Aufbewahrung von 35 Tagen erstellt. ``` aws backup create-backup-plan \ --backup-plan "{\"BackupPlanName\":\"Example-Backup-Plan\",\"Rules\":[{\"RuleName\":\"DailyBackups\",\"ScheduleExpression\":\"cron(0 5 ? * * *)\",\"StartWindowMinutes\":480,\"TargetBackupVaultName\":\"Default\",\"Lifecycle\":{\"DeleteAfterDays\":35}}]}" ``` Ausgabe: ``` { "BackupPlanId": "1fa3895c-a7f5-484a-a371-2dd6a1a9f729", "BackupPlanArn": "arn:aws:backup:us-west-2:123456789012:backup-plan:1fa3895c-a7f5-484a-a371-2dd6a1a9f729", "CreationDate": 1568928754.747, "VersionId": "ZjQ2ZTI5YWQtZDg5Yi00MzYzLWJmZTAtMDI1MzhlMDhjYjEz" } ``` Weitere Informationen finden Sie unter [Erstellen eines Backup-Plans](https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup-plan.html) im *Entwicklerhandbuch für AWS Backup*. + Einzelheiten zur API finden Sie [CreateBackupPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/create-backup-plan.html)in der *AWS CLI Befehlsreferenz*. ### `create-backup-vault` Das folgende Codebeispiel zeigt die Verwendung`create-backup-vault`. **AWS CLI** **So erstellen Sie einen Backup-Tresor** Im folgenden Beispiel für `create-backup-vault` wird ein Backup-Tresor mit dem angegebenen Namen erstellt. ``` aws backup create-backup-vault --backup-vault-name sample-vault ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { "BackupVaultName": "sample-vault", "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:sample-vault", "CreationDate": 1568928338.385 } ``` Weitere Informationen finden Sie unter [Erstellen eines Backup-Tresors](https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-vault.html) im *Entwicklerhandbuch für AWS Backup*. + Einzelheiten zur API finden Sie [CreateBackupVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/create-backup-vault.html)in der *AWS CLI Befehlsreferenz*. ### `get-backup-plan-from-template` Das folgende Codebeispiel zeigt die Verwendung`get-backup-plan-from-template`. **AWS CLI** **So rufen Sie einen vorhandenen Backup-Plan aus einer Vorlage ab** Im folgenden Beispiel für `get-backup-plan-from-template` wird ein vorhandener Backup-Plan aus einer Vorlage abgerufen, in der ein tägliches Backup mit einer Aufbewahrung von 35 Tagen angegeben ist. ``` aws backup get-backup-plan-from-template \ --backup-plan-template-id "87c0c1ef-254d-4180-8fef-2e76a2c38aaa" ``` Ausgabe: ``` { "BackupPlanDocument": { "Rules": [ { "RuleName": "DailyBackups", "ScheduleExpression": "cron(0 5 ? * * *)", "StartWindowMinutes": 480, "Lifecycle": { "DeleteAfterDays": 35 } } ] } } ``` Weitere Informationen finden Sie unter [Erstellen eines Backup-Plans](https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup-plan.html) im *Entwicklerhandbuch für AWS Backup*. + Einzelheiten zur API finden Sie [GetBackupPlanFromTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/get-backup-plan-from-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-backup-plan` Das folgende Codebeispiel zeigt die Verwendung`get-backup-plan`. **AWS CLI** **So rufen Sie die Details eines Backup-Plans ab** Im folgenden Beispiel für `get-backup-plan` werden die Details des angegebenen Backup-Plans angezeigt. ``` aws backup get-backup-plan \ --backup-plan-id "fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5" ``` Ausgabe: ``` { "BackupPlan": { "BackupPlanName": "Example-Backup-Plan", "Rules": [ { "RuleName": "DailyBackups", "TargetBackupVaultName": "Default", "ScheduleExpression": "cron(0 5 ? * * *)", "StartWindowMinutes": 480, "CompletionWindowMinutes": 10080, "Lifecycle": { "DeleteAfterDays": 35 }, "RuleId": "70e0ccdc-e9df-4e83-82ad-c1e5a9471cc3" } ] }, "BackupPlanId": "fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5", "BackupPlanArn": "arn:aws:backup:us-west-2:123456789012:backup-plan:fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5", "VersionId": "NjQ2ZTZkODktMGVhNy00MmQ0LWE4YjktZTkwNTQ3OTkyYTcw", "CreationDate": 1568926091.57 } ``` Weitere Informationen finden Sie unter [Erstellen eines Backup-Plans](https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup-plan.html) im *Entwicklerhandbuch für AWS Backup*. + Einzelheiten zur API finden Sie [GetBackupPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/get-backup-plan.html)in der *AWS CLI Befehlsreferenz*. ### `list-backup-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-backup-jobs`. **AWS CLI** **Beispiel 1: So listen Sie alle Backup-Aufträge auf** Im folgenden `list-backup-jobs` Beispiel werden Metadaten zu Ihren Backup-Jobs in Ihrem AWS Konto zurückgegeben. ``` aws backup list-backup-jobs ``` Ausgabe: ``` { "BackupJobs": [ { "BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "BackupVaultName": "Default", "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default", "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-12345678901234567", "CreationDate": 1600721892.929, "State": "CREATED", "PercentDone": "0.0", "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole", "StartBy": 1600725492.929, "ResourceType": "EC2" }, { "BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "BackupVaultName": "Default", "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default", "RecoveryPointArn": "arn:aws:backup:us-west-2:123456789012:recovery-point:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ResourceArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-12345678", "CreationDate": 1600721724.77, "CompletionDate": 1600721744.488, "State": "COMPLETED", "PercentDone": "100.0", "BackupSizeInBytes": 71, "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole", "StartBy": 1600725324.77, "ResourceType": "EFS" } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Backups](https://https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup.html) im *Entwicklerhandbuch für AWS Backup*. **Beispiel 2: So listen Sie abgeschlossene Backup-Aufträge auf** Im folgenden `list-backup-jobs` Beispiel werden Metadaten zu Ihren abgeschlossenen Backup-Jobs in Ihrem AWS Konto zurückgegeben. ``` aws backup list-backup-jobs \ --by-state COMPLETED ``` Ausgabe: ``` { "BackupJobs": [ { "BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "BackupVaultName": "Default", "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default", "RecoveryPointArn": "arn:aws:backup:us-west-2:123456789012:recovery-point:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ResourceArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-12345678", "CreationDate": 1600721724.77, "CompletionDate": 1600721744.488, "State": "COMPLETED", "PercentDone": "100.0", "BackupSizeInBytes": 71, "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole", "StartBy": 1600725324.77, "ResourceType": "EFS" } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Backups](https://https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup.html) im *Entwicklerhandbuch für AWS Backup*. + Einzelheiten zur API finden Sie [ListBackupJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/list-backup-jobs.html)in der *AWS CLI Befehlsreferenz*. # AWS Batch Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Batch. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `cancel-job` Das folgende Codebeispiel zeigt, wie Sie`cancel-job`. **AWS CLI** **So brechen Sie einen Auftrag ab** In diesem Beispiel wird ein Auftrag mit der angegebenen Auftrags-ID abgebrochen. Befehl: ``` aws batch cancel-job --job-id bcf0b186-a532-4122-842e-2ccab8d54efb --reason "Cancelling job." ``` + Einzelheiten zur API finden Sie [CancelJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/cancel-job.html)in der *AWS CLI Befehlsreferenz*. ### `create-compute-environment` Das folgende Codebeispiel zeigt die Verwendung`create-compute-environment`. **AWS CLI** **So erstellen Sie eine verwaltete Datenverarbeitungsumgebung mit On-Demand-Instances** In diesem Beispiel wird eine verwaltete Datenverarbeitungsumgebung mit bestimmten C4-Instance-Typen erstellt, die bei Bedarf gestartet werden. Die Rechenumgebung heißt C4OnDemand. Befehl: ``` aws batch create-compute-environment --cli-input-json file:///C4OnDemand.json ``` JSON-Dateiformat: ``` { "computeEnvironmentName": "C4OnDemand", "type": "MANAGED", "state": "ENABLED", "computeResources": { "type": "EC2", "minvCpus": 0, "maxvCpus": 128, "desiredvCpus": 48, "instanceTypes": [ "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge" ], "subnets": [ "subnet-220c0e0a", "subnet-1a95556d", "subnet-978f6dce" ], "securityGroupIds": [ "sg-cf5093b2" ], "ec2KeyPair": "id_rsa", "instanceRole": "ecsInstanceRole", "tags": { "Name": "Batch Instance - C4OnDemand" } }, "serviceRole": "arn:aws:iam::012345678910:role/AWSBatchServiceRole" } ``` Ausgabe: ``` { "computeEnvironmentName": "C4OnDemand", "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/C4OnDemand" } ``` **So erstellen Sie eine verwaltete Datenverarbeitungsumgebung mit Spot Instances** In diesem Beispiel wird eine verwaltete Datenverarbeitungsumgebung mit dem Instance-Typ M4 erstellt. Diese wird gestartet, wenn der Spot-Gebotspreis bei oder unter 20 % des On-Demand-Preises für den Instance-Typ liegt. Die Datenverarbeitungsumgebung wird als M4Spot bezeichnet. Befehl: ``` aws batch create-compute-environment --cli-input-json file:///M4Spot.json ``` JSON-Dateiformat: ``` { "computeEnvironmentName": "M4Spot", "type": "MANAGED", "state": "ENABLED", "computeResources": { "type": "SPOT", "spotIamFleetRole": "arn:aws:iam::012345678910:role/aws-ec2-spot-fleet-role", "minvCpus": 0, "maxvCpus": 128, "desiredvCpus": 4, "instanceTypes": [ "m4" ], "bidPercentage": 20, "subnets": [ "subnet-220c0e0a", "subnet-1a95556d", "subnet-978f6dce" ], "securityGroupIds": [ "sg-cf5093b2" ], "ec2KeyPair": "id_rsa", "instanceRole": "ecsInstanceRole", "tags": { "Name": "Batch Instance - M4Spot" } }, "serviceRole": "arn:aws:iam::012345678910:role/AWSBatchServiceRole" } ``` Ausgabe: ``` { "computeEnvironmentName": "M4Spot", "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/M4Spot" } ``` + Einzelheiten zur API finden Sie [CreateComputeEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/create-compute-environment.html)in der *AWS CLI Befehlsreferenz.* ### `create-job-queue` Das folgende Codebeispiel zeigt die Verwendung`create-job-queue`. **AWS CLI** **So erstellen Sie eine Auftragswarteschlange mit niedriger Priorität und einer einzigen Datenverarbeitungsumgebung** In diesem Beispiel wird eine Jobwarteschlange mit dem Namen erstellt LowPriority , die die M4Spot-Rechenumgebung verwendet. Befehl: ``` aws batch create-job-queue --cli-input-json file:///LowPriority.json ``` JSON-Dateiformat: ``` { "jobQueueName": "LowPriority", "state": "ENABLED", "priority": 10, "computeEnvironmentOrder": [ { "order": 1, "computeEnvironment": "M4Spot" } ] } ``` Ausgabe: ``` { "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/LowPriority", "jobQueueName": "LowPriority" } ``` **So erstellen Sie eine Auftragswarteschlange mit hoher Priorität mit zwei Datenverarbeitungsumgebungen** In diesem Beispiel wird eine Jobwarteschlange mit dem Namen erstellt HighPriority , die die OnDemand C4-Rechenumgebung mit der Reihenfolge 1 und die M4Spot-Rechenumgebung mit der Reihenfolge 2 verwendet. Der Scheduler versucht zuerst, Jobs in der OnDemand C4-Computerumgebung zu platzieren. Befehl: ``` aws batch create-job-queue --cli-input-json file:///HighPriority.json ``` JSON-Dateiformat: ``` { "jobQueueName": "HighPriority", "state": "ENABLED", "priority": 1, "computeEnvironmentOrder": [ { "order": 1, "computeEnvironment": "C4OnDemand" }, { "order": 2, "computeEnvironment": "M4Spot" } ] } ``` Ausgabe: ``` { "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/HighPriority", "jobQueueName": "HighPriority" } ``` + Einzelheiten zur API finden Sie [CreateJobQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/create-job-queue.html)in der *AWS CLI Befehlsreferenz*. ### `delete-compute-environment` Das folgende Codebeispiel zeigt die Verwendung`delete-compute-environment`. **AWS CLI** **So löschen Sie eine Datenverarbeitungsumgebung** In diesem Beispiel wird die OnDemand P2-Rechenumgebung gelöscht. Befehl: ``` aws batch delete-compute-environment --compute-environment P2OnDemand ``` + Einzelheiten zur API finden Sie [DeleteComputeEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/delete-compute-environment.html)in der *AWS CLI Befehlsreferenz.* ### `delete-job-queue` Das folgende Codebeispiel zeigt die Verwendung`delete-job-queue`. **AWS CLI** **So löschen Sie eine Auftragswarteschlange** In diesem Beispiel wird die GPGPU-Auftragswarteschlange gelöscht. Befehl: ``` aws batch delete-job-queue --job-queue GPGPU ``` + Einzelheiten zur API finden Sie [DeleteJobQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/delete-job-queue.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-job-definition` Das folgende Codebeispiel zeigt die Verwendung`deregister-job-definition`. **AWS CLI** **So heben Sie die Registrierung einer Auftragsdefinition auf** In diesem Beispiel wird die Registrierung einer Auftragsdefinition namens „sleep10“ aufgehoben. Befehl: ``` aws batch deregister-job-definition --job-definition sleep10 ``` + Einzelheiten zur API finden Sie [DeregisterJobDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/deregister-job-definition.html)in der *AWS CLI Befehlsreferenz*. ### `describe-compute-environments` Das folgende Codebeispiel zeigt die Verwendung`describe-compute-environments`. **AWS CLI** **So beschreiben Sie eine Datenverarbeitungsumgebung** Dieses Beispiel beschreibt die OnDemand P2-Rechenumgebung. Befehl: ``` aws batch describe-compute-environments --compute-environments P2OnDemand ``` Ausgabe: ``` { "computeEnvironments": [ { "status": "VALID", "serviceRole": "arn:aws:iam::012345678910:role/AWSBatchServiceRole", "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/P2OnDemand", "computeResources": { "subnets": [ "subnet-220c0e0a", "subnet-1a95556d", "subnet-978f6dce" ], "tags": { "Name": "Batch Instance - P2OnDemand" }, "desiredvCpus": 48, "minvCpus": 0, "instanceTypes": [ "p2" ], "securityGroupIds": [ "sg-cf5093b2" ], "instanceRole": "ecsInstanceRole", "maxvCpus": 128, "type": "EC2", "ec2KeyPair": "id_rsa" }, "statusReason": "ComputeEnvironment Healthy", "ecsClusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/P2OnDemand_Batch_2c06f29d-d1fe-3a49-879d-42394c86effc", "state": "ENABLED", "computeEnvironmentName": "P2OnDemand", "type": "MANAGED" } ] } ``` + Einzelheiten zur API finden Sie [DescribeComputeEnvironments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/describe-compute-environments.html)in der *AWS CLI Befehlsreferenz*. ### `describe-job-definitions` Das folgende Codebeispiel zeigt die Verwendung`describe-job-definitions`. **AWS CLI** **So beschreiben Sie aktive Auftragsdefinitionen** In diesem Beispiel werden alle Ihre aktiven Auftragsdefinitionen beschrieben. Befehl: ``` aws batch describe-job-definitions --status ACTIVE ``` Ausgabe: ``` { "jobDefinitions": [ { "status": "ACTIVE", "jobDefinitionArn": "arn:aws:batch:us-east-1:012345678910:job-definition/sleep60:1", "containerProperties": { "mountPoints": [], "parameters": {}, "image": "busybox", "environment": {}, "vcpus": 1, "command": [ "sleep", "60" ], "volumes": [], "memory": 128, "ulimits": [] }, "type": "container", "jobDefinitionName": "sleep60", "revision": 1 } ] } ``` + Einzelheiten zur API finden Sie [DescribeJobDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/describe-job-definitions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-job-queues` Das folgende Codebeispiel zeigt die Verwendung`describe-job-queues`. **AWS CLI** **So beschreiben Sie eine Auftragswarteschlange** Dieses Beispiel beschreibt die HighPriority Job-Warteschlange. Befehl: ``` aws batch describe-job-queues --job-queues HighPriority ``` Ausgabe: ``` { "jobQueues": [ { "status": "VALID", "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/HighPriority", "computeEnvironmentOrder": [ { "computeEnvironment": "arn:aws:batch:us-east-1:012345678910:compute-environment/C4OnDemand", "order": 1 } ], "statusReason": "JobQueue Healthy", "priority": 1, "state": "ENABLED", "jobQueueName": "HighPriority" } ] } ``` + Einzelheiten zur API finden Sie [DescribeJobQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/describe-job-queues.html)in der *AWS CLI Befehlsreferenz*. ### `describe-jobs` Das folgende Codebeispiel zeigt die Verwendung`describe-jobs`. **AWS CLI** **So beschreiben Sie einen Auftrag** Im folgenden Beispiel für `describe-jobs` wird ein Auftrag mit der angegebenen Auftrags-ID beschrieben. ``` aws batch describe-jobs \ --jobs bcf0b186-a532-4122-842e-2ccab8d54efb ``` Ausgabe: ``` { "jobs": [ { "status": "SUBMITTED", "container": { "mountPoints": [], "image": "busybox", "environment": [], "vcpus": 1, "command": [ "sleep", "60" ], "volumes": [], "memory": 128, "ulimits": [] }, "parameters": {}, "jobDefinition": "arn:aws:batch:us-east-1:012345678910:job-definition/sleep60:1", "jobQueue": "arn:aws:batch:us-east-1:012345678910:job-queue/HighPriority", "jobId": "bcf0b186-a532-4122-842e-2ccab8d54efb", "dependsOn": [], "jobName": "example", "createdAt": 1480483387803 } ] } ``` + Einzelheiten zur API finden Sie [DescribeJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/describe-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-jobs`. **AWS CLI** **So listen Sie laufende Aufträge auf** Dieses Beispiel listet die laufenden Jobs in der HighPriority Job-Warteschlange auf. Befehl: ``` aws batch list-jobs --job-queue HighPriority ``` Ausgabe: ``` { "jobSummaryList": [ { "jobName": "example", "jobId": "e66ff5fd-a1ff-4640-b1a2-0b0a142f49bb" } ] } ``` **So listen Sie übermittelte Aufträge auf** In diesem Beispiel werden Jobs in der HighPriority Auftragswarteschlange aufgeführt, die den Jobstatus SUBMITTED haben. Befehl: ``` aws batch list-jobs --job-queue HighPriority --job-status SUBMITTED ``` Ausgabe: ``` { "jobSummaryList": [ { "jobName": "example", "jobId": "68f0c163-fbd4-44e6-9fd1-25b14a434786" } ] } ``` + Einzelheiten zur API finden Sie [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/list-jobs.html)unter *AWS CLI Befehlsreferenz*. ### `register-job-definition` Das folgende Codebeispiel zeigt die Verwendung`register-job-definition`. **AWS CLI** **So registrieren Sie eine Auftragsdefinition** In diesem Beispiel wird eine Auftragsdefinition für einen einfachen Container-Auftrag registriert. Befehl: ``` aws batch register-job-definition --job-definition-name sleep30 --type container --container-properties '{ "image": "busybox", "vcpus": 1, "memory": 128, "command": [ "sleep", "30"]}' ``` Ausgabe: ``` { "jobDefinitionArn": "arn:aws:batch:us-east-1:012345678910:job-definition/sleep30:1", "jobDefinitionName": "sleep30", "revision": 1 } ``` + Einzelheiten zur API finden Sie [RegisterJobDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/register-job-definition.html)in der *AWS CLI Befehlsreferenz*. ### `submit-job` Das folgende Codebeispiel zeigt die Verwendung`submit-job`. **AWS CLI** **So senden Sie einen Auftrag** In diesem Beispiel wird ein einfacher Container-Job namens example an die HighPriority Auftragswarteschlange gesendet. Befehl: ``` aws batch submit-job --job-name example --job-queue HighPriority --job-definition sleep60 ``` Ausgabe: ``` { "jobName": "example", "jobId": "876da822-4198-45f2-a252-6cea32512ea8" } ``` + Einzelheiten zur API finden Sie [SubmitJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/submit-job.html)in der *AWS CLI Befehlsreferenz.* ### `terminate-job` Das folgende Codebeispiel zeigt die Verwendung`terminate-job`. **AWS CLI** **So beenden Sie einen Auftrag** In diesem Beispiel wird ein Auftrag mit der angegebenen Auftrags-ID beendet. Befehl: ``` aws batch terminate-job --job-id 61e743ed-35e4-48da-b2de-5c8333821c84 --reason "Terminating job." ``` + Einzelheiten zur API finden Sie [TerminateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/terminate-job.html)in der *AWS CLI Befehlsreferenz*. ### `update-compute-environment` Das folgende Codebeispiel zeigt die Verwendung`update-compute-environment`. **AWS CLI** **So aktualisieren Sie eine Datenverarbeitungsumgebung** In diesem Beispiel wird die OnDemand P2-Rechenumgebung deaktiviert, sodass sie gelöscht werden kann. Befehl: ``` aws batch update-compute-environment --compute-environment P2OnDemand --state DISABLED ``` Ausgabe: ``` { "computeEnvironmentName": "P2OnDemand", "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/P2OnDemand" } ``` + Einzelheiten zur API finden Sie [UpdateComputeEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/update-compute-environment.html)in der *AWS CLI Befehlsreferenz.* ### `update-job-queue` Das folgende Codebeispiel zeigt die Verwendung`update-job-queue`. **AWS CLI** **So aktualisieren Sie eine Auftragswarteschlange** In diesem Beispiel wird eine Auftragswarteschlange deaktiviert, sodass sie gelöscht werden kann. Befehl: ``` aws batch update-job-queue --job-queue GPGPU --state DISABLED ``` Ausgabe: ``` { "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/GPGPU", "jobQueueName": "GPGPU" } ``` + Einzelheiten zur API finden Sie [UpdateJobQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/batch/update-job-queue.html)in der *AWS CLI Befehlsreferenz*. # AWS Budgets Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Budgets. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-budget` Das folgende Codebeispiel zeigt, wie Sie`create-budget`. **AWS CLI** **So erstellen Sie ein Kosten- und Nutzungsbudget** Mit dem folgenden `create-budget`-Befehl wird ein Kosten- und Nutzungsbudget erstellt. ``` aws budgets create-budget \ --account-id 111122223333 \ --budget file://budget.json \ --notifications-with-subscribers file://notifications-with-subscribers.json ``` Inhalt von `budget.json`: ``` { "BudgetLimit": { "Amount": "100", "Unit": "USD" }, "BudgetName": "Example Tag Budget", "BudgetType": "COST", "CostFilters": { "TagKeyValue": [ "user:Key$value1", "user:Key$value2" ] }, "CostTypes": { "IncludeCredit": true, "IncludeDiscount": true, "IncludeOtherSubscription": true, "IncludeRecurring": true, "IncludeRefund": true, "IncludeSubscription": true, "IncludeSupport": true, "IncludeTax": true, "IncludeUpfront": true, "UseBlended": false }, "TimePeriod": { "Start": 1477958399, "End": 3706473600 }, "TimeUnit": "MONTHLY" } ``` Inhalt von `notifications-with-subscribers.json`: ``` [ { "Notification": { "ComparisonOperator": "GREATER_THAN", "NotificationType": "ACTUAL", "Threshold": 80, "ThresholdType": "PERCENTAGE" }, "Subscribers": [ { "Address": "example@example.com", "SubscriptionType": "EMAIL" } ] } ] ``` + Einzelheiten zur API finden Sie [CreateBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-budget.html)in der *AWS CLI Befehlsreferenz*. ### `create-notification` Das folgende Codebeispiel zeigt die Verwendung`create-notification`. **AWS CLI** **So erstellen Sie eine Benachrichtigung für das angegebene Kosten- und Nutzungsbudget** In diesem Beispiel wird eine Benachrichtigung für das angegebene Kosten- und Nutzungsbudget erstellt. Befehl: ``` aws budgets create-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com ``` + Einzelheiten zur API finden Sie [CreateNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-notification.html)in der *AWS CLI Befehlsreferenz*. ### `create-subscriber` Das folgende Codebeispiel zeigt die Verwendung`create-subscriber`. **AWS CLI** **So erstellen einen Abonnenten für eine Benachrichtigung, die einem Kosten- und Nutzungsbudget zugeordnet ist** In diesem Beispiel wird ein Abonnent für die angegebene Benachrichtigung erstellt. Befehl: ``` aws budgets create-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com ``` + Einzelheiten zur API finden Sie [CreateSubscriber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-subscriber.html)in der *AWS CLI Befehlsreferenz*. ### `delete-budget` Das folgende Codebeispiel zeigt die Verwendung`delete-budget`. **AWS CLI** **So löschen Sie ein Kosten- und Nutzungsbudget** In diesem Beispiel wird das angegebene Kosten- und Nutzungsbudget gelöscht. Befehl: ``` aws budgets delete-budget --account-id 111122223333 --budget-name "Example Budget" ``` + Einzelheiten zur API finden Sie [DeleteBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-budget.html)in der *AWS CLI Befehlsreferenz*. ### `delete-notification` Das folgende Codebeispiel zeigt die Verwendung`delete-notification`. **AWS CLI** **So löschen Sie eine Benachrichtigung aus einem Budget** In diesem Beispiel wird die angegebene Benachrichtigung aus dem spezifizierten Budget gelöscht. Befehl: ``` aws budgets delete-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE ``` + Einzelheiten zur API finden Sie [DeleteNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-notification.html)in der *AWS CLI Befehlsreferenz*. ### `delete-subscriber` Das folgende Codebeispiel zeigt die Verwendung`delete-subscriber`. **AWS CLI** **So löschen Sie einen Abonnenten aus einer Benachrichtigung** In diesem Beispiel wird der angegebene Abonnent aus der spezifizierten Benachrichtigung gelöscht. Befehl: ``` aws budgets delete-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com ``` + Einzelheiten zur API finden Sie [DeleteSubscriber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-subscriber.html)in der *AWS CLI Befehlsreferenz*. ### `describe-budget` Das folgende Codebeispiel zeigt die Verwendung`describe-budget`. **AWS CLI** **So rufen Sie ein einem Konto zugeordnetes Budget ab** In diesem Beispiel wird das angegebene Kosten- und Nutzungsbudget abgerufen. Befehl: ``` aws budgets describe-budget --account-id 111122223333 --budget-name "Example Budget" ``` Ausgabe: ``` { "Budget": { "CalculatedSpend": { "ForecastedSpend": { "Amount": "2641.54800000000022919266484677791595458984375", "Unit": "USD" }, "ActualSpend": { "Amount": "604.4560000000000172803993336856365203857421875", "Unit": "USD" } }, "BudgetType": "COST", "BudgetLimit": { "Amount": "100", "Unit": "USD" }, "BudgetName": "Example Budget", "CostTypes": { "IncludeOtherSubscription": true, "IncludeUpfront": true, "IncludeRefund": true, "UseBlended": false, "IncludeDiscount": true, "UseAmortized": false, "IncludeTax": true, "IncludeCredit": true, "IncludeSupport": true, "IncludeRecurring": true, "IncludeSubscription": true }, "TimeUnit": "MONTHLY", "TimePeriod": { "Start": 1477958399.0, "End": 3706473600.0 }, "CostFilters": { "AZ": [ "us-east-1" ] } } } ``` + Einzelheiten zur API finden Sie [DescribeBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budget.html)in der *AWS CLI Befehlsreferenz*. ### `describe-budgets` Das folgende Codebeispiel zeigt die Verwendung`describe-budgets`. **AWS CLI** **So rufen Sie die einem Konto zugeordneten Budgets ab** In diesem Beispiel werden die Kosten- und Nutzungsbudgets für ein Konto abgerufen. Befehl: ``` aws budgets describe-budgets --account-id 111122223333 --max-results 20 ``` Ausgabe: ``` { "Budgets": [ { "CalculatedSpend": { "ForecastedSpend": { "Amount": "2641.54800000000022919266484677791595458984375", "Unit": "USD" }, "ActualSpend": { "Amount": "604.4560000000000172803993336856365203857421875", "Unit": "USD" } }, "BudgetType": "COST", "BudgetLimit": { "Amount": "100", "Unit": "USD" }, "BudgetName": "Example Budget", "CostTypes": { "IncludeOtherSubscription": true, "IncludeUpfront": true, "IncludeRefund": true, "UseBlended": false, "IncludeDiscount": true, "UseAmortized": false, "IncludeTax": true, "IncludeCredit": true, "IncludeSupport": true, "IncludeRecurring": true, "IncludeSubscription": true }, "TimeUnit": "MONTHLY", "TimePeriod": { "Start": 1477958399.0, "End": 3706473600.0 }, "CostFilters": { "AZ": [ "us-east-1" ] } } ] } ``` + Einzelheiten zur API finden Sie [DescribeBudgets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budgets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-notifications-for-budget` Das folgende Codebeispiel zeigt die Verwendung`describe-notifications-for-budget`. **AWS CLI** **So rufen Sie die Benachrichtigungen für ein Budget ab** In diesem Beispiel werden die Benachrichtigungen für ein Kosten- und Nutzungsbudget abgerufen. Befehl: ``` aws budgets describe-notifications-for-budget --account-id 111122223333 --budget-name "Example Budget" --max-results 5 ``` Ausgabe: ``` { "Notifications": [ { "Threshold": 80.0, "ComparisonOperator": "GREATER_THAN", "NotificationType": "ACTUAL" } ] } ``` + Einzelheiten zur API finden Sie [DescribeNotificationsForBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-notifications-for-budget.html)in der *AWS CLI Befehlsreferenz*. ### `describe-subscribers-for-notification` Das folgende Codebeispiel zeigt die Verwendung`describe-subscribers-for-notification`. **AWS CLI** **So rufen Sie die Abonnenten für eine Budgetbenachrichtigung ab** In diesem Beispiel werden die Abonnenten für eine Kosten- und Nutzungsbudgetbenachrichtigung abgerufen. Befehl: ``` aws budgets describe-subscribers-for-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --max-results 5 ``` Ausgabe: ``` { "Subscribers": [ { "SubscriptionType": "EMAIL", "Address": "example2@example.com" }, { "SubscriptionType": "EMAIL", "Address": "example@example.com" } ] } ``` + Einzelheiten zur API finden Sie [DescribeSubscribersForNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-subscribers-for-notification.html)in der *AWS CLI Befehlsreferenz*. ### `update-budget` Das folgende Codebeispiel zeigt die Verwendung`update-budget`. **AWS CLI** **So ersetzen Sie ein Budget für ein Kosten- und Nutzungsbudget** In diesem Beispiel wird ein Kosten- und Nutzungsbudget durch ein neues Budget ersetzt. Befehl: ``` aws budgets update-budget --account-id 111122223333 --new-budget file://new-budget.json ``` new-budget.json: ``` { "BudgetLimit": { "Amount": "100", "Unit": "USD" }, "BudgetName": "Example Budget", "BudgetType": "COST", "CostFilters": { "AZ" : [ "us-east-1" ] }, "CostTypes": { "IncludeCredit": false, "IncludeDiscount": true, "IncludeOtherSubscription": true, "IncludeRecurring": true, "IncludeRefund": true, "IncludeSubscription": true, "IncludeSupport": true, "IncludeTax": true, "IncludeUpfront": true, "UseBlended": false, "UseAmortized": true }, "TimePeriod": { "Start": 1477958399, "End": 3706473600 }, "TimeUnit": "MONTHLY" } ``` + Einzelheiten zur API finden Sie [UpdateBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-budget.html)in der *AWS CLI Befehlsreferenz*. ### `update-notification` Das folgende Codebeispiel zeigt die Verwendung`update-notification`. **AWS CLI** **So ersetzen Sie eine Benachrichtigung für ein Kosten- und Nutzungsbudget** In diesem Beispiel wird eine 80-%-Benachrichtigung für ein Kosten- und Nutzungsbudget durch eine 90-%-Benachrichtigung ersetzt. Befehl: ``` aws budgets update-notification --account-id 111122223333 --budget-name "Example Budget" --old-notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --new-notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=90,ThresholdType=PERCENTAGE ``` + Einzelheiten zur API finden Sie [UpdateNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-notification.html)in der *AWS CLI Befehlsreferenz*. ### `update-subscriber` Das folgende Codebeispiel zeigt die Verwendung`update-subscriber`. **AWS CLI** **So ersetzen Sie einen Subscriber für ein Kosten- und Nutzungsbudget** In diesem Beispiel wird ein Subscriber für ein Kosten- und Nutzungsbudget ersetzt. Befehl: ``` aws budgets update-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --old-subscriber SubscriptionType=EMAIL,Address=example@example.com --new-subscriber SubscriptionType=EMAIL,Address=example2@example.com ``` + Einzelheiten zur API finden Sie [UpdateSubscriber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-subscriber.html)in der *AWS CLI Befehlsreferenz*. # Amazon Chime Chime-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie Amazon Chime verwenden. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-phone-number-with-user` Das folgende Codebeispiel zeigt, wie Sie`associate-phone-number-with-user`. **AWS CLI** **So ordnen Sie einem Benutzer eine Telefonnummer zu** Im folgenden Beispiel für `associate-phone-number-with-user` wird einem Benutzer die angegebene Telefonnummer zugeordnet. ``` aws chime associate-phone-number-with-user \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --user-id 1ab2345c-67de-8901-f23g-45h678901j2k \ --e164-phone-number "+12065550100" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwaltung von Benutzertelefonnummern](https://docs.aws.amazon.com/chime/latest/ag/user-phone.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [AssociatePhoneNumberWithUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/associate-phone-number-with-user.html)in der *AWS CLI Befehlsreferenz*. ### `associate-signin-delegate-groups-with-account` Das folgende Codebeispiel zeigt die Verwendung`associate-signin-delegate-groups-with-account`. **AWS CLI** **So ordnen Sie die Anmeldung für delegierte Gruppen zu** Im folgenden Beispiel für `associate-signin-delegate-groups-with-account` wird die angegebene Anmeldung für delegierte Gruppen dem spezifizierten Amazon-Chime-Konto zugeordnet. ``` aws chime associate-signin-delegate-groups-with-account \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --signin-delegate-groups GroupName=my_users ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwaltung von Benutzerzugriff und -berechtigungen](https://docs.aws.amazon.com/chime/latest/ag/manage-access.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [AssociateSigninDelegateGroupsWithAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/associate-signin-delegate-groups-with-account.html)in der *AWS CLI Befehlsreferenz*. ### `batch-create-room-membership` Das folgende Codebeispiel zeigt die Verwendung`batch-create-room-membership`. **AWS CLI** **So erstellen Sie Mitgliedschaften in mehreren Räumen** Im folgenden Beispiel für `batch-create-room-membership` werden einem Chatroom mehrere Benutzer als Chatroom-Mitglieder hinzugefügt. Außerdem werden den Benutzern Administrator- und Mitgliederrollen zugewiesen. ``` aws chime batch-create-room-membership \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \ --membership-item-list "MemberId=1ab2345c-67de-8901-f23g-45h678901j2k,Role=Administrator" "MemberId=2ab2345c-67de-8901-f23g-45h678901j2k,Role=Member" ``` Ausgabe: ``` { "ResponseMetadata": { "RequestId": "169ba401-d886-475f-8b3f-e01eac6fadfb", "HTTPStatusCode": 201, "HTTPHeaders": { "x-amzn-requestid": "169ba401-d886-475f-8b3f-e01eac6fadfb", "content-type": "application/json", "content-length": "13", "date": "Mon, 02 Dec 2019 22:46:58 GMT", "connection": "keep-alive" }, "RetryAttempts": 0 }, "Errors": [] } ``` Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [BatchCreateRoomMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/batch-create-room-membership.html)in der *AWS CLI Befehlsreferenz*. ### `batch-delete-phone-number` Das folgende Codebeispiel zeigt die Verwendung`batch-delete-phone-number`. **AWS CLI** **So löschen Sie mehrere Telefonnummern** Im folgenden Beispiel für `batch-delete-phone-number` werden alle angegebenen Telefonnummern gelöscht. ``` aws chime batch-delete-phone-number \ --phone-number-ids "%2B12065550100" "%2B12065550101" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { "PhoneNumberErrors": [] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [BatchDeletePhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/batch-delete-phone-number.html)in der *AWS CLI Befehlsreferenz*. ### `batch-suspend-user` Das folgende Codebeispiel zeigt die Verwendung`batch-suspend-user`. **AWS CLI** **So sperren Sie mehrere Benutzer** Im folgenden Beispiel für `batch-suspend-user` werden die aufgelisteten Benutzer für das angegebene Amazon-Chime-Konto gesperrt. ``` aws chime batch-suspend-user \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --user-id-list "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE" "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE" ``` Ausgabe: ``` { "UserErrors": [] } ``` + Einzelheiten zur API finden Sie [BatchSuspendUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/batch-suspend-user.html)in der *AWS CLI Befehlsreferenz*. ### `batch-unsuspend-user` Das folgende Codebeispiel zeigt die Verwendung`batch-unsuspend-user`. **AWS CLI** **So heben Sie die Sperre für mehrere Benutzer auf** Im folgenden Beispiel für `batch-unsuspend-user` werden alle Sperren für die aufgelisteten Benutzer für das angegebene Amazon-Chime-Konto aufgehoben. ``` aws chime batch-unsuspend-user \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --user-id-list "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE" "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE" ``` Ausgabe: ``` { "UserErrors": [] } ``` + Einzelheiten zur API finden Sie [BatchUnsuspendUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/batch-unsuspend-user.html)in der *AWS CLI Befehlsreferenz*. ### `batch-update-phone-number` Das folgende Codebeispiel zeigt die Verwendung`batch-update-phone-number`. **AWS CLI** **So aktualisieren Sie die Produkttypen für mehrere Telefonnummern gleichzeitig** Im folgenden Beispiel für `batch-update-phone-number` werden die Produkttypen für alle angegebenen Telefonnummern aktualisiert. ``` aws chime batch-update-phone-number \ --update-phone-number-request-items PhoneNumberId=%2B12065550100,ProductType=BusinessCalling PhoneNumberId=%2B12065550101,ProductType=BusinessCalling ``` Ausgabe: ``` { "PhoneNumberErrors": [] } ``` **So aktualisieren Sie die Anrufnamen für mehrere Telefonnummern gleichzeitig** Im folgenden Beispiel für `batch-update-phone-number` werden die Anrufnamen für alle angegebenen Telefonnummern aktualisiert. ``` aws chime batch-update-phone-number \ --update-phone-number-request-items PhoneNumberId=%2B14013143874,CallingName=phonenumber1 PhoneNumberId=%2B14013144061,CallingName=phonenumber2 ``` Ausgabe: ``` { "PhoneNumberErrors": [] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [BatchUpdatePhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/batch-update-phone-number.html)in der *AWS CLI Befehlsreferenz*. ### `batch-update-user` Das folgende Codebeispiel zeigt die Verwendung`batch-update-user`. **AWS CLI** **So aktualisieren Sie mehrere Benutzer mit einem einzigen Befehl** Im folgenden Beispiel für `batch-update-user` wird der `LicenseType` für jeden der aufgelisteten Benutzer im angegebenen Amazon-Chime-Konto aktualisiert. ``` aws chime batch-update-user \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE --update-user-request-items "UserId=a1b2c3d4-5678-90ab-cdef-22222EXAMPLE,LicenseType=Basic" "UserId=a1b2c3d4-5678-90ab-cdef-33333EXAMPLE,LicenseType=Basic" ``` Ausgabe: ``` { "UserErrors": [] } ``` + Einzelheiten zur API finden Sie [BatchUpdateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/batch-update-user.html)in der *AWS CLI Befehlsreferenz*. ### `create-account` Das folgende Codebeispiel zeigt die Verwendung`create-account`. **AWS CLI** **So erstellen Sie ein Konto** Im folgenden `create-account` Beispiel wird ein Amazon Chime Chime-Konto unter dem AWS Administratorkonto erstellt. ``` aws chime create-account \ --name MyChimeAccount ``` Ausgabe: ``` { "Account": { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "Name": "MyChimeAccount", "AccountType": "Team", "CreatedTimestamp": "2019-01-04T17:11:22.003Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] } } ``` Weitere Informationen finden Sie unter [Erste Schritte](https://docs.aws.amazon.com/chime/latest/ag/getting-started.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [CreateAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/create-account.html)in der *AWS CLI Befehlsreferenz.* ### `create-bot` Das folgende Codebeispiel zeigt die Verwendung`create-bot`. **AWS CLI** **So erstellen Sie einen Bot für Amazon Chime** Im folgenden Beispiel für `create-bot` wird ein Bot für das angegebene Amazon-Chime-Unternehmenskonto erstellt. ``` aws chime create-bot \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --display-name "myBot" \ --domain "example.com" ``` Ausgabe: ``` { "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": false, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" } } ``` Weitere Informationen finden Sie unter [Integrieren eines Chatbots in Amazon Chime](https://docs.aws.amazon.com/chime/latest/dg/integrate-bots.html) im *Entwicklerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [CreateBot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/create-bot.html)in der *AWS CLI Befehlsreferenz*. ### `create-phone-number-order` Das folgende Codebeispiel zeigt die Verwendung`create-phone-number-order`. **AWS CLI** **So erstellen Sie eine Telefonnummernreihenfolge** Im folgenden Beispiel für `create-phone-number-order` wird eine Telefonnummernreihenfolge für die angegebenen Telefonnummern erstellt. ``` aws chime create-phone-number-order \ --product-type VoiceConnector \ --e164-phone-numbers "+12065550100" "+12065550101" "+12065550102" ``` Ausgabe: ``` { "PhoneNumberOrder": { "PhoneNumberOrderId": "abc12345-de67-89f0-123g-h45i678j9012", "ProductType": "VoiceConnector", "Status": "Processing", "OrderedPhoneNumbers": [ { "E164PhoneNumber": "+12065550100", "Status": "Processing" }, { "E164PhoneNumber": "+12065550101", "Status": "Processing" }, { "E164PhoneNumber": "+12065550102", "Status": "Processing" } ], "CreatedTimestamp": "2019-08-09T21:35:21.427Z", "UpdatedTimestamp": "2019-08-09T21:35:22.408Z" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [CreatePhoneNumberOrder](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/create-phone-number-order.html)in der *AWS CLI Befehlsreferenz*. ### `create-room-membership` Das folgende Codebeispiel zeigt die Verwendung`create-room-membership`. **AWS CLI** **So erstellen Sie eine Raummitgliedschaft** Im folgenden Beispiel für `create-room-membership` wird der angegebene Benutzer dem Chatroom als Chatroom-Mitglied hinzugefügt. ``` aws chime create-room-membership \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \ --member-id 1ab2345c-67de-8901-f23g-45h678901j2k ``` Ausgabe: ``` { "RoomMembership": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Member": { "MemberId": "1ab2345c-67de-8901-f23g-45h678901j2k", "MemberType": "User", "Email": "janed@example.com", "FullName": "Jane Doe", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45" }, "Role": "Member", "InvitedBy": "arn:aws:iam::111122223333:user/alejandro", "UpdatedTimestamp": "2019-12-02T22:36:41.969Z" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [CreateRoomMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/create-room-membership.html)in der *AWS CLI Befehlsreferenz*. ### `create-room` Das folgende Codebeispiel zeigt die Verwendung`create-room`. **AWS CLI** **Um einen Chatraum zu erstellen** Im folgenden Beispiel für `create-room` wird ein Chatroom für das angegebene Amazon-Chime-Konto erstellt. ``` aws chime create-room \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --name chatRoom ``` Ausgabe: ``` { "Room": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Name": "chatRoom", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "CreatedBy": "arn:aws:iam::111122223333:user/alejandro", "CreatedTimestamp": "2019-12-02T22:29:31.549Z", "UpdatedTimestamp": "2019-12-02T22:29:31.549Z" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [CreateRoom](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/create-room.html)in der *AWS CLI Befehlsreferenz*. ### `create-user` Das folgende Codebeispiel zeigt die Verwendung`create-user`. **AWS CLI** **So erstellen Sie ein Benutzerprofil für ein gemeinsam genutztes Gerät** Im folgenden Beispiel für `create-user` wird ein Profil für ein gemeinsam genutztes Gerät für die angegebene E-Mail-Adresse erstellt. ``` aws chime create-user \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --email roomdevice@example.com \ --user-type SharedDevice ``` Ausgabe: ``` { "User": { "UserId": "1ab2345c-67de-8901-f23g-45h678901j2k", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "PrimaryEmail": "roomdevice@example.com", "DisplayName": "Room Device", "LicenseType": "Pro", "UserType": "SharedDevice", "UserRegistrationStatus": "Registered", "RegisteredOn": "2020-01-15T22:38:09.806Z", "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } } } ``` Weitere Informationen finden Sie unter [Vorbereitung auf die Einrichtung](https://docs.aws.amazon.com/chime/latest/ag/prepare-setup.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [CreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/create-user.html)in der *AWS CLI Befehlsreferenz*. ### `delete-account` Das folgende Codebeispiel zeigt die Verwendung`delete-account`. **AWS CLI** **So löschen Sie ein Konto** Im folgenden Beispiel für `delete-account` wird das angegebene Konto gelöscht. ``` aws chime delete-account --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen Ihres Kontos](https://docs.aws.amazon.com/chime/latest/ag/enterprise-account.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [DeleteAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/delete-account.html)in der *AWS CLI Befehlsreferenz*. ### `delete-phone-number` Das folgende Codebeispiel zeigt die Verwendung`delete-phone-number`. **AWS CLI** **So löschen Sie eine Telefonnummer** Im folgenden Beispiel für `delete-phone-number` wird die angegebene Telefonnummer in die Löschwarteschlange verschoben. ``` aws chime delete-phone-number \ --phone-number-id "+12065550100" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [DeletePhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/delete-phone-number.html)in der *AWS CLI Befehlsreferenz*. ### `delete-room-membership` Das folgende Codebeispiel zeigt die Verwendung`delete-room-membership`. **AWS CLI** **So entfernen Sie einen Benutzer als Mitglied eines Chatrooms** Im folgenden Beispiel für `delete-room-membership` wird das angegebene Mitglied aus dem spezifizierten Chatroom entfernt. ``` aws chime delete-room-membership \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \ --member-id 1ab2345c-67de-8901-f23g-45h678901j2k ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [DeleteRoomMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/delete-room-membership.html)in der *AWS CLI Befehlsreferenz*. ### `delete-room` Das folgende Codebeispiel zeigt die Verwendung`delete-room`. **AWS CLI** **So löschen Sie einen Chatroom** Im folgenden Beispiel für `delete-room` wird der angegebene Chatroom gelöscht und die Chatroom-Mitgliedschaften werden entfernt. ``` aws chime delete-room \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [DeleteRoom](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/delete-room.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-phone-number-from-user` Das folgende Codebeispiel zeigt die Verwendung`disassociate-phone-number-from-user`. **AWS CLI** **So heben Sie die Zuordnung einer Telefonnummer zu einem Benutzer auf** Im folgenden Beispiel für `disassociate-phone-number-from-user` wird die Zuordnung einer Telefonnummer zum angegebenen Benutzer aufgehoben. ``` aws chime disassociate-phone-number-from-user \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --user-id 1ab2345c-67de-8901-f23g-45h678901j2k ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwaltung von Benutzertelefonnummern](https://docs.aws.amazon.com/chime/latest/ag/user-phone.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [DisassociatePhoneNumberFromUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/disassociate-phone-number-from-user.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-signin-delegate-groups-from-account` Das folgende Codebeispiel zeigt die Verwendung`disassociate-signin-delegate-groups-from-account`. **AWS CLI** **So heben Sie Zuordnung der Anmeldung für delegierte Gruppen auf** Im folgenden Beispiel für `disassociate-signin-delegate-groups-from-account` wird die Zuordnung der angegebenen Anmeldung für delegierte Gruppen zum spezifizierten Amazon-Chime-Konto aufgehoben. ``` aws chime disassociate-signin-delegate-groups-from-account \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --group-names "my_users" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwaltung von Benutzerzugriff und -berechtigungen](https://docs.aws.amazon.com/chime/latest/ag/manage-access.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [DisassociateSigninDelegateGroupsFromAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/disassociate-signin-delegate-groups-from-account.html)in der *AWS CLI Befehlsreferenz*. ### `get-account-settings` Das folgende Codebeispiel zeigt die Verwendung`get-account-settings`. **AWS CLI** **So rufen Sie Einstellungen für ein Konto ab** Im folgenden Beispiel für `get-account-settings` werden die Kontoeinstellungen für das angegebene Konto abgerufen. ``` aws chime get-account-settings --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE ``` Ausgabe: ``` { "AccountSettings": { "DisableRemoteControl": false, "EnableDialOut": false } } ``` Weitere Informationen finden Sie unter [Verwalten Ihrer Amazon-Chime-Konten](https://docs.aws.amazon.com/chime/latest/ag/manage-chime-account.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [GetAccountSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-account-settings.html)in der *AWS CLI Befehlsreferenz*. ### `get-account` Das folgende Codebeispiel zeigt die Verwendung`get-account`. **AWS CLI** **So rufen Sie die Details für ein Konto ab** Im folgenden Beispiel für `get-account` werden die Details für das angegebene Amazon-Chime-Konto abgerufen. ``` aws chime get-account \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE ``` Ausgabe: ``` { "Account": { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "Name": "EnterpriseDirectory", "AccountType": "EnterpriseDirectory", "CreatedTimestamp": "2018-12-20T18:38:02.181Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] } } ``` Weitere Informationen finden Sie unter [Verwalten Ihrer Amazon-Chime-Konten](https://docs.aws.amazon.com/chime/latest/ag/manage-chime-account.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [GetAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-account.html)in der *AWS CLI Befehlsreferenz*. ### `get-bot` Das folgende Codebeispiel zeigt die Verwendung`get-bot`. **AWS CLI** **So rufen Sie Details zu einem Bot ab** Im folgenden Beispiel für `get-bot` werden die Details für den angegebenen Bot angezeigt. ``` aws chime get-bot \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --bot-id 123abcd4-5ef6-789g-0h12-34j56789012k ``` Ausgabe: ``` { "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": false, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" } } ``` Weitere Informationen finden Sie unter [Aktualisieren von Chatbots](https://docs.aws.amazon.com/chime/latest/dg/update-bots.html) im *Entwicklerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [GetBot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-bot.html)in der *AWS CLI Befehlsreferenz*. ### `get-global-settings` Das folgende Codebeispiel zeigt die Verwendung`get-global-settings`. **AWS CLI** **So rufen Sie globale Einstellungen ab** Im folgenden `get-global-settings` Beispiel werden die S3-Bucket-Namen abgerufen, die zum Speichern von Anrufdetaildatensätzen für Amazon Chime Business Calling und Amazon Chime Voice Connectors verwendet werden, die dem Administratorkonto zugeordnet sind. AWS ``` aws chime get-global-settings ``` Ausgabe: ``` { "BusinessCalling": { "CdrBucket": "s3bucket" }, "VoiceConnector": { "CdrBucket": "s3bucket" } } ``` Weitere Informationen finden Sie unter [Verwaltung von globalen Einstellungen](https://docs.aws.amazon.com/chime/latest/ag/manage-global.html) im *Administratorhandbuch für Amazon Chime*. + *Einzelheiten zur API finden Sie [GetGlobalSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-global-settings.html)in AWS CLI der Befehlsreferenz.* ### `get-phone-number-order` Das folgende Codebeispiel zeigt die Verwendung`get-phone-number-order`. **AWS CLI** **So rufen Sie Details für eine Telefonnummernreihenfolge ab** Im folgenden Beispiel für `get-phone-number-order` werden die Details der angegebenen Telefonnummernreihenfolge angezeigt. ``` aws chime get-phone-number-order \ --phone-number-order-id abc12345-de67-89f0-123g-h45i678j9012 ``` Ausgabe: ``` { "PhoneNumberOrder": { "PhoneNumberOrderId": "abc12345-de67-89f0-123g-h45i678j9012", "ProductType": "VoiceConnector", "Status": "Partial", "OrderedPhoneNumbers": [ { "E164PhoneNumber": "+12065550100", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550101", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550102", "Status": "Failed" } ], "CreatedTimestamp": "2019-08-09T21:35:21.427Z", "UpdatedTimestamp": "2019-08-09T21:35:31.926Z" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [GetPhoneNumberOrder](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-phone-number-order.html)in der *AWS CLI Befehlsreferenz*. ### `get-phone-number-settings` Das folgende Codebeispiel zeigt die Verwendung`get-phone-number-settings`. **AWS CLI** **So rufen Sie den Namen eines ausgehenden Anrufs ab** Im folgenden `get-phone-number-settings` Beispiel wird der Standardname für ausgehende Anrufe für das Konto des anrufenden Benutzers AWS abgerufen. ``` aws chime get-phone-number-settings ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { "CallingName": "myName", "CallingNameUpdatedTimestamp": "2019-10-28T18:56:42.911Z" } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie unter [GetPhoneNumberSettings AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-phone-number-settings.html)*Befehlsreferenz*. ### `get-phone-number` Das folgende Codebeispiel zeigt die Verwendung`get-phone-number`. **AWS CLI** **So rufen Sie Details zu Telefonnummern ab** Im folgenden Beispiel für `get-phone-number` werden die Details zur angegebenen Telefonnummer angezeigt. ``` aws chime get-phone-number \ --phone-number-id +12065550100 ``` Ausgabe: ``` { "PhoneNumber": { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "VoiceConnector", "Status": "Unassigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [ { "Value": "abcdef1ghij2klmno3pqr4", "Name": "VoiceConnectorId", "AssociatedTimestamp": "2019-10-28T18:40:37.453Z" } ], "CallingNameStatus": "UpdateInProgress", "CreatedTimestamp": "2019-08-09T21:35:21.445Z", "UpdatedTimestamp": "2019-08-09T21:35:31.745Z" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [GetPhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-phone-number.html)in der *AWS CLI Befehlsreferenz*. ### `get-room` Das folgende Codebeispiel zeigt die Verwendung`get-room`. **AWS CLI** **So rufen Sie die Details zu einem Chatroom ab** Im folgenden Beispiel für `get-room` werden die Details zum angegebenen Chatroom angezeigt. ``` aws chime get-room \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j ``` Ausgabe: ``` { "Room": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Name": "chatRoom", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "CreatedBy": "arn:aws:iam::111122223333:user/alejandro", "CreatedTimestamp": "2019-12-02T22:29:31.549Z", "UpdatedTimestamp": "2019-12-02T22:29:31.549Z" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [GetRoom](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-room.html)in der *AWS CLI Befehlsreferenz*. ### `get-user-settings` Das folgende Codebeispiel zeigt die Verwendung`get-user-settings`. **AWS CLI** **So rufen Sie Benutzereinstellungen ab** Im folgenden Beispiel für `get-user-settings` werden die Einstellungen des angegebenen Benutzers angezeigt. ``` aws chime get-user-settings \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --user-id 1ab2345c-67de-8901-f23g-45h678901j2k ``` Ausgabe: ``` { "UserSettings": { "Telephony": { "InboundCalling": true, "OutboundCalling": true, "SMS": true } } } ``` Weitere Informationen finden Sie unter [Verwaltung von Benutzertelefonnummern](https://docs.aws.amazon.com/chime/latest/ag/user-phone.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [GetUserSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-user-settings.html)in der *AWS CLI Befehlsreferenz*. ### `get-user` Das folgende Codebeispiel zeigt die Verwendung`get-user`. **AWS CLI** **So rufen Sie Details zu einem Benutzer ab** Im folgenden Beispiel für `get-user` werden die Details für den angegebenen Benutzer abgerufen. ``` aws chime get-user \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE ``` Ausgabe: ``` { "User": { "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "marthar@example.com", "DisplayName": "Martha Rivera", "LicenseType": "Pro", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:45:25.231Z", "InvitedOn": "2018-12-20T18:45:25.231Z", "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": False, "AlexaForBusinessRoomArn": "null" }, "PersonalPIN": "XXXXXXXXXX" } } ``` Weitere Informationen finden Sie unter [Verwaltung von Benutzern](https://docs.aws.amazon.com/chime/latest/ag/manage-users.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [GetUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/get-user.html)in der *AWS CLI Befehlsreferenz*. ### `invite-users` Das folgende Codebeispiel zeigt die Verwendung`invite-users`. **AWS CLI** **So laden Sie Benutzer zu Amazon Chime ein** Im folgenden Beispiel für `invite-users` wird eine E-Mail gesendet, um einen Benutzer zum angegebenen Amazon-Chime-Konto einzuladen. ``` aws chime invite-users \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --user-email-list "alejandror@example.com" "janed@example.com" ``` Ausgabe: ``` { "Invites": [ { "InviteId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "Status": "Pending", "EmailAddress": "alejandror@example.com", "EmailStatus": "Sent" } { "InviteId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "Status": "Pending", "EmailAddress": "janed@example.com", "EmailStatus": "Sent" } ] } ``` Weitere Informationen finden Sie unter [Einladen und Sperren von Benutzern](https://docs.aws.amazon.com/chime/latest/ag/manage-access.html#invite-users-team) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [InviteUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/invite-users.html)in der *AWS CLI Befehlsreferenz*. ### `list-accounts` Das folgende Codebeispiel zeigt die Verwendung`list-accounts`. **AWS CLI** **So rufen Sie eine Liste der Konten ab** Im folgenden `list-accounts` Beispiel wird eine Liste der Amazon Chime Chime-Konten im Administratorkonto abgerufen. AWS ``` aws chime list-accounts ``` Ausgabe: ``` { "Accounts": [ { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "Name": "First Chime Account", "AccountType": "EnterpriseDirectory", "CreatedTimestamp": "2018-12-20T18:38:02.181Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] }, { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "Name": "Second Chime Account", "AccountType": "Team", "CreatedTimestamp": "2018-09-04T21:44:22.292Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] } ] } ``` Weitere Informationen finden Sie unter [Verwalten Ihrer Amazon-Chime-Konten](https://docs.aws.amazon.com/chime/latest/ag/manage-chime-account.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie unter [ListAccounts AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/list-accounts.html)*Befehlsreferenz*. ### `list-bots` Das folgende Codebeispiel zeigt die Verwendung`list-bots`. **AWS CLI** **So rufen Sie eine Liste der Bots ab** Im folgenden Beispiel für `list-bots` wird die Liste der Bots abgerufen, die dem angegebenen Amazon-Chime-Unternehmenskonto zugeordnet sind. ``` aws chime list-bots \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 ``` Ausgabe: ``` { "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": false, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" } } ``` Weitere Informationen finden Sie unter [Verwenden von Chatbots mit Amazon Chime](https://docs.aws.amazon.com/chime/latest/dg/use-bots.html) im *Entwicklerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [ListBots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/list-bots.html)in der *AWS CLI Befehlsreferenz*. ### `list-phone-number-orders` Das folgende Codebeispiel zeigt die Verwendung`list-phone-number-orders`. **AWS CLI** **So listen Sie Telefonnummernreihenfolgen auf** Im folgenden Beispiel für `list-phone-number-orders` werden die Telefonnummernreihenfolgen auflistet, die dem Konto des Amazon-Chime-Administrators zugeordnet sind. ``` aws chime list-phone-number-orders ``` Ausgabe: ``` { "PhoneNumberOrders": [ { "PhoneNumberOrderId": "abc12345-de67-89f0-123g-h45i678j9012", "ProductType": "VoiceConnector", "Status": "Partial", "OrderedPhoneNumbers": [ { "E164PhoneNumber": "+12065550100", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550101", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550102", "Status": "Failed" } ], "CreatedTimestamp": "2019-08-09T21:35:21.427Z", "UpdatedTimestamp": "2019-08-09T21:35:31.926Z" } { "PhoneNumberOrderId": "cba54321-ed76-09f5-321g-h54i876j2109", "ProductType": "BusinessCalling", "Status": "Partial", "OrderedPhoneNumbers": [ { "E164PhoneNumber": "+12065550103", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550104", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550105", "Status": "Failed" } ], "CreatedTimestamp": "2019-08-09T21:35:21.427Z", "UpdatedTimestamp": "2019-08-09T21:35:31.926Z" } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [ListPhoneNumberOrders](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/list-phone-number-orders.html)in der *AWS CLI Befehlsreferenz*. ### `list-phone-numbers` Das folgende Codebeispiel zeigt die Verwendung`list-phone-numbers`. **AWS CLI** **So listen Sie Telefonnummern für ein Amazon-Chime-Konto auf** Im folgenden Beispiel für `list-phone-numbers` werden die Telefonnummern auflistet, die dem Amazon-Chime-Konto des Administrators zugeordnet sind. ``` aws chime list-phone-numbers ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { "PhoneNumbers": [ { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "VoiceConnector", "Status": "Assigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [ { "Value": "abcdef1ghij2klmno3pqr4", "Name": "VoiceConnectorId", "AssociatedTimestamp": "2019-10-28T18:40:37.453Z" } ], "CallingNameStatus": "UpdateInProgress", "CreatedTimestamp": "2019-08-12T22:10:20.521Z", "UpdatedTimestamp": "2019-10-28T18:42:07.964Z" }, { "PhoneNumberId": "%2B12065550101", "E164PhoneNumber": "+12065550101", "Type": "Local", "ProductType": "VoiceConnector", "Status": "Assigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [ { "Value": "abcdef1ghij2klmno3pqr4", "Name": "VoiceConnectorId", "AssociatedTimestamp": "2019-10-28T18:40:37.511Z" } ], "CallingNameStatus": "UpdateInProgress", "CreatedTimestamp": "2019-08-12T22:10:20.521Z", "UpdatedTimestamp": "2019-10-28T18:42:07.960Z" } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [ListPhoneNumbers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/list-phone-numbers.html)in der *AWS CLI Befehlsreferenz*. ### `list-room-memberships` Das folgende Codebeispiel zeigt die Verwendung`list-room-memberships`. **AWS CLI** **So listen Sie Raummitgliedschaften auf** Im folgenden Beispiel für `list-room-memberships` wird eine Liste mit den Details zu Mitgliedschaften für den angegebenen Chatroom angezeigt. ``` aws chime list-room-memberships \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j ``` Ausgabe: ``` { "RoomMemberships": [ { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Member": { "MemberId": "2ab2345c-67de-8901-f23g-45h678901j2k", "MemberType": "User", "Email": "zhangw@example.com", "FullName": "Zhang Wei", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45" }, "Role": "Member", "InvitedBy": "arn:aws:iam::111122223333:user/alejandro", "UpdatedTimestamp": "2019-12-02T22:46:58.532Z" }, { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Member": { "MemberId": "1ab2345c-67de-8901-f23g-45h678901j2k", "MemberType": "User", "Email": "janed@example.com", "FullName": "Jane Doe", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45" }, "Role": "Administrator", "InvitedBy": "arn:aws:iam::111122223333:user/alejandro", "UpdatedTimestamp": "2019-12-02T22:46:58.532Z" } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [ListRoomMemberships](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/list-room-memberships.html)in der *AWS CLI Befehlsreferenz*. ### `list-rooms` Das folgende Codebeispiel zeigt die Verwendung`list-rooms`. **AWS CLI** **So listen Sie Chatrooms auf** Im folgenden Beispiel für `list-rooms` wird eine Liste der Chatrooms im angegebenen Konto angezeigt. Die Liste wird nur nach den Chatrooms gefiltert, denen das angegebene Mitglied angehört. ``` aws chime list-rooms \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --member-id 1ab2345c-67de-8901-f23g-45h678901j2k ``` Ausgabe: ``` { "Room": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Name": "teamRoom", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "CreatedBy": "arn:aws:iam::111122223333:user/alejandro", "CreatedTimestamp": "2019-12-02T22:29:31.549Z", "UpdatedTimestamp": "2019-12-02T22:33:19.310Z" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [ListRooms](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/list-rooms.html)in der *AWS CLI Befehlsreferenz*. ### `list-users` Das folgende Codebeispiel zeigt die Verwendung`list-users`. **AWS CLI** **So listen Sie die Benutzer in einem Konto auf** Im folgenden Beispiel für `list-users` werden die Benutzer für das angegebene Amazon-Chime-Konto aufgelistet. ``` aws chime list-users --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE ``` Ausgabe: ``` { "Users": [ { "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "mariag@example.com", "DisplayName": "Maria Garcia", "LicenseType": "Pro", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:45:25.231Z" "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } }, { "UserId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "richardr@example.com", "DisplayName": "Richard Roe", "LicenseType": "Pro", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:45:45.415Z" "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } }, { "UserId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "saanvis@example.com", "DisplayName": "Saanvi Sarkar", "LicenseType": "Basic", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:46:57.747Z" "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } }, { "UserId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "wxiulan@example.com", "DisplayName": "Wang Xiulan", "LicenseType": "Basic", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:47:15.390Z" "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } } ] } ``` Weitere Informationen finden Sie unter [Verwaltung von Benutzern](https://docs.aws.amazon.com/chime/latest/ag/manage-users.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [ListUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/list-users.html)in der *AWS CLI Befehlsreferenz*. ### `logout-user` Das folgende Codebeispiel zeigt die Verwendung`logout-user`. **AWS CLI** **So melden Sie einen Benutzer ab** Im folgenden Beispiel für `logout-user` wird der angegebene Benutzer abgemeldet. ``` aws chime logout-user \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [LogoutUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/logout-user.html)in der *AWS CLI Befehlsreferenz*. ### `regenerate-security-token` Das folgende Codebeispiel zeigt die Verwendung`regenerate-security-token`. **AWS CLI** **So generieren Sie ein Sicherheitstoken neu** Im folgenden Beispiel für `regenerate-security-token` wird das Sicherheitstoken für den angegebenen Bot neu generiert. ``` aws chime regenerate-security-token \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --bot-id 123abcd4-5ef6-789g-0h12-34j56789012k ``` Ausgabe: ``` { "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": false, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY" } } ``` Weitere Informationen finden Sie unter [Authentifizieren von Chatbot-Anforderungen](https://docs.aws.amazon.com/chime/latest/dg/auth-bots.html) im *Entwicklerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [RegenerateSecurityToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/regenerate-security-token.html)in der *AWS CLI Befehlsreferenz*. ### `reset-personal-pin` Das folgende Codebeispiel zeigt die Verwendung`reset-personal-pin`. **AWS CLI** **So setzen Sie die persönliche Meeting-PIN eines Benutzers zurück** Im folgenden Beispiel für `reset-personal-pin` wird die persönliche Meeting-PIN des angegebenen Benutzers zurückgesetzt. ``` aws chime reset-personal-pin \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE ``` Ausgabe: ``` { "User": { "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "mateo@example.com", "DisplayName": "Mateo Jackson", "LicenseType": "Pro", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:45:25.231Z", "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": False, "AlexaForBusinessRoomArn": "null" }, "PersonalPIN": "XXXXXXXXXX" } } ``` Weitere Informationen finden Sie unter [Persönliche Besprechung ändern PINs](https://docs.aws.amazon.com/chime/latest/ag/change-PINs.html) im *Amazon Chime Chime-Administratorhandbuch*. + Einzelheiten zur API finden Sie [ResetPersonalPin](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/reset-personal-pin.html)in der *AWS CLI Befehlsreferenz.* ### `restore-phone-number` Das folgende Codebeispiel zeigt die Verwendung`restore-phone-number`. **AWS CLI** **So stellen Sie eine Telefonnummer wieder her** Im folgenden Beispiel für `restore-phone-number` wird die angegebene Telefonnummer aus der Löschwarteschlange wiederhergestellt. ``` aws chime restore-phone-number \ --phone-number-id "+12065550100" ``` Ausgabe: ``` { "PhoneNumber": { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "BusinessCalling", "Status": "Unassigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [], "CreatedTimestamp": "2019-08-09T21:35:21.445Z", "UpdatedTimestamp": "2019-08-12T22:06:36.355Z" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [RestorePhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/restore-phone-number.html)in der *AWS CLI Befehlsreferenz*. ### `search-available-phone-numbers` Das folgende Codebeispiel zeigt die Verwendung`search-available-phone-numbers`. **AWS CLI** **So suchen Sie nach verfügbaren Telefonnummern** Im folgenden Beispiel für `search-available-phone-numbers` wird nach verfügbaren Telefonnummern anhand der Vorwahl gesucht. ``` aws chime search-available-phone-numbers \ --area-code "206" ``` Ausgabe: ``` { "E164PhoneNumbers": [ "+12065550100", "+12065550101", "+12065550102", "+12065550103", "+12065550104", "+12065550105", "+12065550106", "+12065550107", "+12065550108", "+12065550109", ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [SearchAvailablePhoneNumbers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/search-available-phone-numbers.html)in der *AWS CLI Befehlsreferenz*. ### `update-account-settings` Das folgende Codebeispiel zeigt die Verwendung`update-account-settings`. **AWS CLI** **So aktualisieren Sie die Einstellungen für Ihr Konto** Im folgenden Beispiel für `update-account-settings` wird die Remote-Steuerung von geteilten Bildschirmen für das angegebene Amazon-Chime-Konto deaktiviert. ``` aws chime update-account-settings \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --account-settings DisableRemoteControl=true ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UpdateAccountSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-account-settings.html)in der *AWS CLI Befehlsreferenz*. ### `update-account` Das folgende Codebeispiel zeigt die Verwendung`update-account`. **AWS CLI** **So aktualisieren Sie ein Konto** Im folgenden Beispiel für `update-account` wird der angegebene Kontoname aktualisiert. ``` aws chime update-account \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --name MyAccountName ``` Ausgabe: ``` { "Account": { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "Name": "MyAccountName", "AccountType": "Team", "CreatedTimestamp": "2018-09-04T21:44:22.292Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] } } ``` Weitere Informationen finden Sie unter [Umbenennen Ihres Kontos](https://docs.aws.amazon.com/chime/latest/ag/rename-account.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [UpdateAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-account.html)in der *AWS CLI Befehlsreferenz*. ### `update-bot` Das folgende Codebeispiel zeigt die Verwendung`update-bot`. **AWS CLI** **So aktualisieren Sie einen Bot** Im folgenden Beispiel für `update-bot` wird der Status des angegebenen Bots aktualisiert, sodass er nicht mehr ausgeführt wird. ``` aws chime update-bot \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --bot-id 123abcd4-5ef6-789g-0h12-34j56789012k \ --disabled ``` Ausgabe: ``` { "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": true, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY" } } ``` Weitere Informationen finden Sie unter [Aktualisieren von Chatbots](https://docs.aws.amazon.com/chime/latest/dg/update-bots.html) im *Entwicklerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [UpdateBot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-bot.html)in der *AWS CLI Befehlsreferenz*. ### `update-global-settings` Das folgende Codebeispiel zeigt die Verwendung`update-global-settings`. **AWS CLI** **So aktualisieren Sie globale Einstellungen** Das folgende `update-global-settings` Beispiel aktualisiert den S3-Bucket, der zum Speichern von Anrufdetailaufzeichnungen für Amazon Chime Business Calling und Amazon Chime Voice Connectors verwendet wird, die dem Administratorkonto zugeordnet sind. AWS ``` aws chime update-global-settings \ --business-calling CdrBucket="s3bucket" \ --voice-connector CdrBucket="s3bucket" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwaltung von globalen Einstellungen](https://docs.aws.amazon.com/chime/latest/ag/manage-global.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [UpdateGlobalSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-global-settings.html)in der *AWS CLI Befehlsreferenz*. ### `update-phone-number-settings` Das folgende Codebeispiel zeigt die Verwendung`update-phone-number-settings`. **AWS CLI** **So aktualisieren Sie den Namen eines ausgehenden Anrufs** Im folgenden `update-phone-number-settings` Beispiel wird der Standardname für ausgehende Anrufe für das AWS Administratorkonto aktualisiert. ``` aws chime update-phone-number-settings \ --calling-name "myName" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie unter [UpdatePhoneNumberSettings AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-phone-number-settings.html)*Befehlsreferenz.* ### `update-phone-number` Das folgende Codebeispiel zeigt die Verwendung`update-phone-number`. **AWS CLI** **Beispiel 1: So aktualisieren Sie den Produkttyp für eine Telefonnummer** Im folgenden Beispiel für `update-phone-number` wird der Produkttyp für die angegebene Telefonnummer aktualisiert. ``` aws chime update-phone-number \ --phone-number-id "+12065550100" \ --product-type "BusinessCalling" ``` Ausgabe: ``` { "PhoneNumber": { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "BusinessCalling", "Status": "Unassigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [], "CallingName": "phonenumber1", "CreatedTimestamp": "2019-08-09T21:35:21.445Z", "UpdatedTimestamp": "2019-08-12T21:44:07.591Z" } } ``` **Beispiel 2: So aktualisieren Sie den Namen eines ausgehenden Anrufs für eine Telefonnummer** Im folgenden Beispiel für `update-phone-number` wird der Name für ausgehende Anrufe für die angegebene Telefonnummer aktualisiert. aws-Glockenspiel update-phone-number -- phone-number-id „\$11206550100" -- Anruf-Name „Telefonnummer2" Ausgabe: ``` { "PhoneNumber": { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "BusinessCalling", "Status": "Unassigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [], "CallingName": "phonenumber2", "CreatedTimestamp": "2019-08-09T21:35:21.445Z", "UpdatedTimestamp": "2019-08-12T21:44:07.591Z" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Telefonnummern](https://docs.aws.amazon.com/chime/latest/ag/phone-numbers.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API [UpdatePhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-phone-number.html)finden Sie in der *AWS CLI Befehlsreferenz*. ### `update-room-membership` Das folgende Codebeispiel zeigt die Verwendung`update-room-membership`. **AWS CLI** **So aktualisieren Sie eine Raummitgliedschaft** Im folgenden Beispiel für `update-room-membership` wird die Rolle des angegebenen Chatroom-Mitglieds in `Administrator` geändert. ``` aws chime update-room-membership \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \ --member-id 1ab2345c-67de-8901-f23g-45h678901j2k \ --role Administrator ``` Ausgabe: ``` { "RoomMembership": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Member": { "MemberId": "1ab2345c-67de-8901-f23g-45h678901j2k", "MemberType": "User", "Email": "sofiamartinez@example.com", "FullName": "Sofia Martinez", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45" }, "Role": "Administrator", "InvitedBy": "arn:aws:iam::111122223333:user/admin", "UpdatedTimestamp": "2019-12-02T22:40:22.931Z" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [UpdateRoomMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-room-membership.html)in der *AWS CLI Befehlsreferenz*. ### `update-room` Das folgende Codebeispiel zeigt die Verwendung`update-room`. **AWS CLI** **So aktualisieren Sie einen Chatroom** Im folgenden Beispiel für `update-room` wird der Name des angegebenen Chatrooms geändert. ``` aws chime update-room \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \ --name teamRoom ``` Ausgabe: ``` { "Room": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Name": "teamRoom", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "CreatedBy": "arn:aws:iam::111122223333:user/alejandro", "CreatedTimestamp": "2019-12-02T22:29:31.549Z", "UpdatedTimestamp": "2019-12-02T22:33:19.310Z" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Chatrooms](https://docs.aws.amazon.com/chime/latest/ug/chime-chat-room.html) im *Benutzerhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [UpdateRoom](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-room.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-settings` Das folgende Codebeispiel zeigt die Verwendung`update-user-settings`. **AWS CLI** **So aktualisieren Sie Benutzereinstellungen** Im folgenden Beispiel für `update-user-settings` wird es dem angegeben Benutzer ermöglicht, eingehende und ausgehende Anrufe zu tätigen sowie SMS-Nachrichten zu senden und zu empfangen. ``` aws chime update-user-settings \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --user-id 1ab2345c-67de-8901-f23g-45h678901j2k \ --user-settings "Telephony={InboundCalling=true,OutboundCalling=true,SMS=true}" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwaltung von Benutzertelefonnummern](https://docs.aws.amazon.com/chime/latest/ag/user-phone.html) im *Administratorhandbuch für Amazon Chime*. + Einzelheiten zur API finden Sie [UpdateUserSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-user-settings.html)in der *AWS CLI Befehlsreferenz*. ### `update-user` Das folgende Codebeispiel zeigt die Verwendung`update-user`. **AWS CLI** **So aktualisieren Sie Benutzerdetails** In diesem Beispiel werden die angegebenen Details für den spezifizierten Benutzer aktualisiert. Befehl: ``` aws chime update-user \ --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE \ --license-type "Basic" ``` Ausgabe: ``` { "User": { "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" } } ``` + Einzelheiten zur API finden Sie [UpdateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/chime/update-user.html)in der *AWS CLI Befehlsreferenz*. # Cloud Control-API-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe der AWS Command Line Interface with Cloud Control API Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-resource` Das folgende Codebeispiel zeigt, wie Sie`create-resource`. **AWS CLI** **So erstellen Sie eine Ressource** Im folgenden `create-resource` Beispiel wird eine benannte AWS ResourceExample: :Kinesis: :Stream-Ressource mit einer Aufbewahrungsdauer von 168 Stunden und einer Shard-Anzahl von drei erstellt. ``` aws cloudcontrol create-resource \ --type-name AWS::Kinesis::Stream \ --desired-state "{\"Name\": \"ResourceExample\",\"RetentionPeriodHours\":168, \"ShardCount\":3}" ``` Ausgabe: ``` { "ProgressEvent": { "EventTime": 1632506656.706, "TypeName": "AWS::Kinesis::Stream", "OperationStatus": "IN_PROGRESS", "Operation": "CREATE", "Identifier": "ResourceExample", "RequestToken": "20999d87-e304-4725-ad84-832dcbfd7fc5" } } ``` Weitere Informationen finden Sie unter [Erstellen einer Ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html) im *Benutzerhandbuch für Cloud Control API*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/create-resource.html).AWS CLI * ### `delete-resource` Das folgende Codebeispiel zeigt die Verwendung`delete-resource`. **AWS CLI** **So löschen Sie eine Ressource** Im folgenden `delete-resource` Beispiel wird eine AWS: :Kinesis: :Stream-Ressource mit der ID ResourceExample aus Ihrem Konto gelöscht. AWS ``` aws cloudcontrol delete-resource \ --type-name AWS::Kinesis::Stream \ --identifier ResourceExample ``` Ausgabe: ``` { "ProgressEvent": { "TypeName": "AWS::Kinesis::Stream", "Identifier": "ResourceExample", "RequestToken": "e48f26ff-d0f9-4ab8-a878-120db1edf111", "Operation": "DELETE", "OperationStatus": "IN_PROGRESS", "EventTime": 1632950300.14 } } ``` Weitere Informationen finden Sie unter [Löschen einer Ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-delete.html) im *Benutzerhandbuch für Cloud Control API*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/delete-resource.html).AWS CLI * ### `get-resource-request-status` Das folgende Codebeispiel zeigt die Verwendung`get-resource-request-status`. **AWS CLI** **So rufen Sie die Statusinformationen einer Ressourcenanforderung ab** Im folgenden Beispiel für `get-resource-request-status` werden Statusinformationen zur angegebenen Ressourcenanforderung abgerufen. ``` aws cloudcontrol get-resource-request-status \ --request-token "e1a6b86e-46bd-41ac-bfba-001234567890" ``` Ausgabe: ``` { "ProgressEvent": { "TypeName": "AWS::Kinesis::Stream", "Identifier": "Demo", "RequestToken": "e1a6b86e-46bd-41ac-bfba-001234567890", "Operation": "CREATE", "OperationStatus": "FAILED", "EventTime": 1632950268.481, "StatusMessage": "Resource of type 'AWS::Kinesis::Stream' with identifier 'Demo' already exists.", "ErrorCode": "AlreadyExists" } } ``` Weitere Informationen finden Sie unter [Verwalten von Ressourcenoperationsanforderungen](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html) im *Benutzerhandbuch für Cloud Control API*. + Einzelheiten zur API finden Sie [GetResourceRequestStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/get-resource-request-status.html)in der *AWS CLI Befehlsreferenz*. ### `get-resource` Das folgende Codebeispiel zeigt die Verwendung`get-resource`. **AWS CLI** **So rufen Sie den aktuellen Status einer Ressource ab** Das folgende `get-resource` Beispiel gibt den aktuellen Status der benannten AWS: :Kinesis: :Stream-Ressource zurück. ResourceExample ``` aws cloudcontrol get-resource \ --type-name AWS::Kinesis::Stream \ --identifier ResourceExample ``` Ausgabe: ``` { "TypeName": "AWS::Kinesis::Stream", "ResourceDescription": { "Identifier": "ResourceExample", "Properties": "{\"Arn\":\"arn:aws:kinesis:us-west-2:099908667365:stream/ResourceExample\",\"RetentionPeriodHours\":168,\"Name\":\"ResourceExample\",\"ShardCount\":3}" } } ``` Weitere Informationen finden Sie unter [Lesen des aktuellen Status einer Ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-read.html) im *Benutzerhandbuch für Cloud Control API*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [GetResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/get-resource.html).AWS CLI * ### `list-resource-requests` Das folgende Codebeispiel zeigt die Verwendung`list-resource-requests`. **AWS CLI** **So listen Sie die aktiven Ressourcenoperationsanforderungen auf** Das folgende `list-resource-requests` Beispiel listet die Ressourcenanforderungen für CREATE- und UPDATE-Operationen auf, die in Ihrem AWS Konto fehlgeschlagen sind. ``` aws cloudcontrol list-resource-requests \ --resource-request-status-filter Operations=CREATE,OperationStatuses=FAILED ``` Ausgabe: ``` { "ResourceRequestStatusSummaries": [ { "TypeName": "AWS::Kinesis::Stream", "Identifier": "Demo", "RequestToken": "e1a6b86e-46bd-41ac-bfba-633abcdfdbd7", "Operation": "CREATE", "OperationStatus": "FAILED", "EventTime": 1632950268.481, "StatusMessage": "Resource of type 'AWS::Kinesis::Stream' with identifier 'Demo' already exists.", "ErrorCode": "AlreadyExists" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Ressourcenoperationsanforderungen](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html) im *Benutzerhandbuch für Cloud Control API*. + Einzelheiten zur API finden Sie [ListResourceRequests](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/list-resource-requests.html)unter *AWS CLI Befehlsreferenz*. ### `list-resources` Das folgende Codebeispiel zeigt die Verwendung`list-resources`. **AWS CLI** **So listen Sie die Ressourcen eines bestimmten Typs auf** Das folgende `list-resources` Beispiel listet die AWS: :Kinesis: :Stream-Ressourcen auf, die in Ihrem Konto bereitgestellt werden. AWS ``` aws cloudcontrol list-resources \ --type-name AWS::Kinesis::Stream ``` Ausgabe: ``` { "TypeName": "AWS::Kinesis::Stream", "ResourceDescriptions": [ { "Identifier": "MyKinesisStream", "Properties": "{\"Name\":\"MyKinesisStream\"}" }, { "Identifier": "AnotherStream", "Properties": "{\"Name\":\"AnotherStream\"}" } ] } ``` Weitere Informationen finden Sie unter [Ermitteln von Ressourcen](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-list.html) im *Benutzerhandbuch für Cloud Control API*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/list-resources.html).AWS CLI * ### `update-resource` Das folgende Codebeispiel zeigt die Verwendung`update-resource`. **AWS CLI** **So aktualisieren Sie die Eigenschaften einer vorhandenen Ressource** Im folgenden `update-resource` Beispiel wird die Aufbewahrungsrichtlinie einer AWS: :Logs:: LogGroup -Ressource mit dem Namen ExampleLogGroup auf 90 Tage aktualisiert. ``` aws cloudcontrol update-resource \ --type-name AWS::Logs::LogGroup \ --identifier ExampleLogGroup \ --patch-document "[{\"op\":\"replace\",\"path\":\"/RetentionInDays\",\"value\":90}]" ``` Ausgabe: ``` { "ProgressEvent": { "EventTime": "2021-08-09T18:17:15.219Z", "TypeName": "AWS::Logs::LogGroup", "OperationStatus": "IN_PROGRESS", "Operation": "UPDATE", "Identifier": "ExampleLogGroup", "RequestToken": "5f40c577-3534-4b20-9599-0b0123456789" } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-update.html) im *Benutzerhandbuch für Cloud Control API*. + Einzelheiten zur API finden Sie [UpdateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/update-resource.html)in der *AWS CLI Befehlsreferenz.* # AWS Cloud Map Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Cloud Map. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-http-namespace` Das folgende Codebeispiel zeigt, wie Sie`create-http-namespace`. **AWS CLI** **So erstellen Sie einen HTTP-Namespace** Im folgenden `create-http-namespace`-Beispiel wird ein HTTP-Namespace `example.com` erstellt. ``` aws servicediscovery create-http-namespace \ --name example.com \ --creator-request-id example-request-id ``` Ausgabe: ``` { "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html). Weitere Informationen zum Erstellen eines Namespaces finden Sie unter [Creating an AWS Cloud Map Namespace to group application services](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) im *AWS Cloud Map Developer Guide*. + Einzelheiten zur API finden Sie [CreateHttpNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-http-namespace.html)in der *AWS CLI Befehlsreferenz*. ### `create-private-dns-namespace` Das folgende Codebeispiel zeigt die Verwendung`create-private-dns-namespace`. **AWS CLI** **So erstellen Sie einen privaten DNS-Namespace** Im folgenden `create-private-dns-namespace`-Beispiel wird ein privater DNS-Namespace erstellt. ``` aws servicediscovery create-private-dns-namespace \ --name example.com \ --vpc vpc-1c56417b ``` Ausgabe: ``` { "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html). Weitere Informationen finden Sie unter [Erstellen von Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) im *AWS -Cloud Map-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [CreatePrivateDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-private-dns-namespace.html)in der *AWS CLI Befehlsreferenz*. ### `create-public-dns-namespace` Das folgende Codebeispiel zeigt die Verwendung`create-public-dns-namespace`. **AWS CLI** **So erstellen Sie einen öffentlichen DNS-Namespace** Im folgenden `create-public-dns-namespace`-Beispiel wird ein öffentlicher DNS-Namespace `example.com` erstellt. ``` aws servicediscovery create-public-dns-namespace \ --name example-public-dns.com \ --creator-request-id example-public-request-id \ --properties DnsProperties={SOA={TTL=60}} ``` Ausgabe: ``` { "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen zum Erstellen eines Namespaces finden Sie unter [Creating an AWS Cloud Map Namespace to group application services](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) im *AWS Cloud Map Developer Guide*. + Einzelheiten zur API finden Sie [CreatePublicDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-public-dns-namespace.html)in der *AWS CLI Befehlsreferenz*. ### `create-service` Das folgende Codebeispiel zeigt die Verwendung`create-service`. **AWS CLI** **Beispiel 1: Um einen Dienst mithilfe der Namespace-ID zu erstellen** Im folgenden `create-service`-Beispiel wird ein Service erstellt. ``` aws servicediscovery create-service \ --name myservice \ --namespace-id ns-ylexjili4cdxy3xm \ --dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]" ``` Ausgabe: ``` { "Service": { "Id": "srv-abcd1234xmpl5678", "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678", "ResourceOwner": "123456789012", "Name": "myservice", "NamespaceId": "ns-abcd1234xmpl5678", "DnsConfig": { "NamespaceId": "ns-abcd1234xmpl5678", "RoutingPolicy": "MULTIVALUE", "DnsRecords": [ { "Type": "A", "TTL": 60 } ] }, "Type": "DNS_HTTP", "CreateDate": "2025-08-18T13:45:31.023000-05:00", "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678", "CreatedByAccount": "123456789012" } } ``` Weitere Informationen finden Sie im [AWS Cloud Map *Developer Guide unter Creating a AWS Cloud Map* Service für eine Anwendungskomponente](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html). **Beispiel 2: So erstellen Sie einen Dienst mit dem Namespace ARN** Im folgenden `create-service` Beispiel wird ein Dienst erstellt, der einen Namespace-ARN anstelle einer Namespace-ID verwendet. Die Angabe eines Namespace-ARN ist erforderlich, wenn Sie einen Dienst in einem gemeinsam genutzten Namespace erstellen. ``` aws servicediscovery create-service \ --name myservice-arn \ --namespace-id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \ --dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]" ``` Ausgabe: ``` { "Service": { "Id": "srv-abcd1234xmpl5678", "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678", "ResourceOwner": "123456789012", "Name": "myservice-arn", "NamespaceId": "ns-abcd1234xmpl5678", "DnsConfig": { "NamespaceId": "ns-abcd1234xmpl5678", "RoutingPolicy": "MULTIVALUE", "DnsRecords": [ { "Type": "A", "TTL": 60 } ] }, "Type": "DNS_HTTP", "CreateDate": "2025-08-18T13:45:31.023000-05:00", "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678", "CreatedByAccount": "123456789012" } } ``` Weitere Informationen finden Sie unter [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-service.html)in AWS CLI der Befehlsreferenz.* ### `delete-namespace` Das folgende Codebeispiel zeigt die Verwendung`delete-namespace`. **AWS CLI** **Beispiel 1: Um einen Namespace zu löschen** Im folgenden `delete-namespace`-Beispiel wird ein Namespace gelöscht. ``` aws servicediscovery delete-namespace \ --id ns-abcd1234xmpl5678 ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html). Weitere Informationen finden Sie unter [Löschen eines AWS Cloud Map-Namespace](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html) im *AWS Cloud Map Developer Guide*. **Beispiel 2: Um einen Namespace mithilfe des Namespace-ARN zu löschen** Im folgenden `delete-namespace` Beispiel wird ein Namespace mit seinem ARN gelöscht. ``` aws servicediscovery delete-namespace \ --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Weitere Informationen finden Sie unter [Löschen eines AWS Cloud Map-Namespace](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html) im *AWS Cloud Map Developer Guide*. + Einzelheiten zur API finden Sie [DeleteNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-namespace.html)in der *AWS CLI Befehlsreferenz.* ### `delete-service-attributes` Das folgende Codebeispiel zeigt die Verwendung`delete-service-attributes`. **AWS CLI** **Beispiel 1: Um ein Dienstattribut zu löschen** Im folgenden `delete-service-attributes`-Beispiel wird ein Serviceattribut mit dem Schlüssel `Port` gelöscht, das dem angegebenen Service zugeordnet ist. ``` aws servicediscovery delete-service-attributes \ --service-id srv-abcd1234xmpl5678 \ --attributes Port ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Services von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um ein Dienstattribut mit ARN zu löschen** Im folgenden `delete-service-attributes` Beispiel wird ein Dienstattribut mithilfe des Dienst-ARN gelöscht. Die Angabe des ARN ist erforderlich, um Attribute zu löschen, die mit Diensten verknüpft sind, die in Namespaces erstellt wurden, die mit Ihrem Konto gemeinsam genutzt werden. ``` aws servicediscovery delete-service-attributes \ --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \ --attributes Port ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [AWS Cloud Map-Dienste](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [DeleteServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service-attributes.html)in AWS CLI der Befehlsreferenz.* ### `delete-service` Das folgende Codebeispiel zeigt die Verwendung`delete-service`. **AWS CLI** **Beispiel 1: Um einen Dienst zu löschen** Im folgenden Beispiel für `delete-service` wird ein Service gelöscht. ``` aws servicediscovery delete-service \ --id srv-abcd1234xmpl5678 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines AWS Cloud Map-Dienstes](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html) im *AWS Cloud Map Developer Guide*. **Beispiel 2: Um einen Dienst mit ARN zu löschen** Im folgenden `delete-service` Beispiel wird ein Dienst mithilfe seines ARN gelöscht. ``` aws servicediscovery delete-service \ --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines AWS Cloud Map-Dienstes](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html) im *AWS Cloud Map Developer Guide*. + Einzelheiten zur API finden Sie [DeleteService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-instance` Das folgende Codebeispiel zeigt die Verwendung`deregister-instance`. **AWS CLI** **Beispiel 1: Um die Registrierung einer Dienstinstanz aufzuheben** Im folgenden `deregister-instance`-Beispiel wird die Registrierung einer Service-Instance aufgehoben. ``` aws servicediscovery deregister-instance \ --service-id srv-p5zdwlg5uvvzjita \ --instance-id myservice-53 ``` Ausgabe: ``` { "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. [Weitere Informationen finden Sie unter get-operation.](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html) Weitere Informationen finden Sie unter [Registrierung einer Service Instance aufheben](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: So deregistrieren Sie eine Dienstinstanz mithilfe des Dienst-ARN für gemeinsam genutzte Namespaces** Im folgenden `deregister-instance` Beispiel wird die Registrierung einer Dienstinstanz mithilfe eines Dienst-ARN anstelle einer Dienst-ID aufgehoben. Die Angabe eines ARN ist erforderlich, wenn Sie Instances von Diensten abmelden, die in Namespaces erstellt wurden, die mit Ihrem Konto gemeinsam genutzt werden. ``` aws servicediscovery deregister-instance \ --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \ --instance-id web-server-01 ``` Ausgabe: ``` { "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl" } ``` *Weitere Informationen finden Sie unter [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [Abmelden einer AWS Cloud Map-Dienstinstanz im Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html) Developer Guide.AWS * + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DeregisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/deregister-instance.html)AWS CLI * ### `discover-instances-revision` Das folgende Codebeispiel zeigt die Verwendung`discover-instances-revision`. **AWS CLI** **Beispiel 1: Um die Revision einer Instanz zu ermitteln** Im folgenden `discover-instances-revision`-Beispiel wird die zunehmende Revision einer Instance gefunden. ``` aws servicediscovery discover-instances-revision \ --namespace-name example.com \ --service-name myservice ``` Ausgabe: ``` { "InstancesRevision": 123456 } ``` Weitere Informationen finden Sie unter [Service-Instances von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um die Version von Instanzen aus einem bestimmten Besitzerkonto zu ermitteln** Im folgenden `discover-instances-revision` Beispiel wird die Version von Instanzen eines bestimmten Besitzerkontos ermittelt. Der Parameter owner-account ist für Instanzen in Namespaces erforderlich, die mit Ihrem Konto gemeinsam genutzt werden. ``` aws servicediscovery discover-instances-revision \ --namespace-name shared-namespace \ --service-name shared-service \ --owner-account 123456789111 ``` Ausgabe: ``` { "InstancesRevision": 1234567890 } ``` Weitere Informationen finden Sie unter [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [AWS Cloud Map-Dienstinstanzen im *AWS Cloud Map*](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) Developer Guide. + *Einzelheiten zur API finden Sie [DiscoverInstancesRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances-revision.html)in AWS CLI der Befehlsreferenz.* ### `discover-instances` Das folgende Codebeispiel zeigt die Verwendung`discover-instances`. **AWS CLI** **Beispiel 1: Um registrierte Instanzen zu entdecken** Im folgenden `discover-instances`-Beispiel werden registrierte Instances gefunden. ``` aws servicediscovery discover-instances \ --namespace-name example.com \ --service-name myservice \ --max-results 10 \ --health-status ALL ``` Ausgabe: ``` { "Instances": [ { "InstanceId": "myservice-53", "NamespaceName": "example.com", "ServiceName": "myservice", "HealthStatus": "UNKNOWN", "Attributes": { "AWS_INSTANCE_IPV4": "172.2.1.3", "AWS_INSTANCE_PORT": "808" } } ], "InstancesRevision": 85648075627387284 } ``` Weitere Informationen finden Sie unter [Service-Instances von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um Instances von einem bestimmten Besitzerkonto aus zu entdecken** Im folgenden `discover-instances` Beispiel werden registrierte Instances von einem bestimmten Besitzerkonto erkannt. Dieser Parameter ist erforderlich, um Instanzen in Namespaces zu ermitteln, die mit Ihrem Konto gemeinsam genutzt werden. ``` aws servicediscovery discover-instances \ --namespace-name shared-namespace \ --service-name shared-service \ --owner-account 123456789111 ``` Ausgabe: ``` { "Instances": [ { "InstanceId": "shared-instance-1234", "NamespaceName": "shared-namespace", "ServiceName": "shared-service", "HealthStatus": "HEALTHY", "Attributes": { "AWS_INSTANCE_IPV4": "203.0.113.75", "AWS_INSTANCE_PORT": "80" } } ], "InstancesRevision": 1234567890 } ``` Weitere Informationen finden Sie unter [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [AWS Cloud Map-Dienstinstanzen im *AWS Cloud Map*](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) Developer Guide. + *Einzelheiten zur API finden Sie [DiscoverInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances.html)in AWS CLI der Befehlsreferenz.* ### `get-instance` Das folgende Codebeispiel zeigt die Verwendung`get-instance`. **AWS CLI** **Beispiel 1: Um die Details einer Instanz abzurufen** Im folgenden `get-instance`-Beispiel werden die Attribute eines Services abgerufen. ``` aws servicediscovery get-instance \ --service-id srv-e4anhexample0004 --instance-id i-abcd1234 ``` Ausgabe: ``` { "ResourceOwner": "123456789012", "Instance": { "Id": "arn:aws:servicediscovery:us-west-2:111122223333;:service/srv-e4anhexample0004", "Attributes": { "AWS_INSTANCE_IPV4": "192.0.2.44", "AWS_INSTANCE_PORT": "80", "color": "green", "region": "us-west-2", "stage": "beta" }, "CreatedByAccount": "123456789012" } } ``` Weitere Informationen finden Sie unter [Service-Instances von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um die Details einer Instanz abzurufen, die den Dienst-ARN für gemeinsam genutzte Namespaces verwendet** Im folgenden `get-instance` Beispiel werden die Attribute einer Instanz abgerufen, die einen Dienst-ARN anstelle einer Dienst-ID verwendet. Die Angabe eines ARN ist erforderlich, um Details zu Instanzen abzurufen, die mit Namespaces verknüpft sind, die mit Ihrem Konto geteilt werden. Die in diesem Beispiel zurückgegebene Instanz wurde von einem Konto `123456789111` in einem Namespace registriert, der dem Konto gehört. `123456789012` ``` aws servicediscovery get-instance \ --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \ --instance-id web-server-01 ``` Ausgabe: ``` { "ResourceOwner": "123456789012", "Instance": { "Id": "web-server-01", "Attributes": { "AWS_INSTANCE_IPV4": "203.0.113.15", "AWS_INSTANCE_PORT": "80" }, "CreatedByAccount": "123456789111" } } ``` *Weitere Informationen zur kontoübergreifenden Nutzung von Namespaces finden Sie unter [Shared AWS Cloud Map-Namespaces im Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) Developer Guide.AWS * + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instance.html)AWS CLI * ### `get-instances-health-status` Das folgende Codebeispiel zeigt die Verwendung`get-instances-health-status`. **AWS CLI** **Beispiel 1: Um den Integritätsstatus von Instanzen abzurufen, die einem Dienst zugeordnet sind** Im folgenden `get-instances-health-status`-Beispiel wird der Integritätsstatus von Instances abgerufen, die dem angegebenen Service zugeordnet sind. ``` aws servicediscovery get-instances-health-status \ --service-id srv-e4anhexample0004 ``` Ausgabe: ``` { "Status": { "i-abcd1234": "HEALTHY", "i-abcd1235": "UNHEALTHY" } } ``` Weitere Informationen finden Sie unter [Service-Instances von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: So rufen Sie den Integritätsstatus von Instanzen ab, die den Dienst-ARN für gemeinsam genutzte Namespaces verwenden** Im folgenden `get-instances-health-status` Beispiel wird der Integritätsstatus von Instanzen abgerufen, die einen Dienst-ARN anstelle einer Dienst-ID verwenden. Die Angabe eines ARN ist erforderlich, um den Integritätsstatus für Instances abzurufen, die mit Namespaces verknüpft sind, die mit dem Konto des Anforderers gemeinsam genutzt werden. ``` aws servicediscovery get-instances-health-status \ --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita ``` Ausgabe: ``` { "Status": { "web-server-01": "HEALTHY", "web-server-02": "UNHEALTHY" } } ``` Weitere Informationen finden Sie unter [AWS Cloud Map-Dienstinstanzen](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [GetInstancesHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instances-health-status.html)in AWS CLI der Befehlsreferenz.* ### `get-namespace` Das folgende Codebeispiel zeigt die Verwendung`get-namespace`. **AWS CLI** **Beispiel 1: Um die Details eines Namespaces abzurufen** Im folgenden `get-namespace`-Beispiel werden Informationen zu den angegebenen Namespace abgerufen. ``` aws servicediscovery get-namespace \ --id ns-abcd1234xmpl5678 ``` Ausgabe: ``` { "Namespace": { "Id": "ns-abcd1234xmpl5678", "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678", "ResourceOwner": "123456789012", "Name": "example-http.com", "Type": "HTTP", "Description": "Example.com AWS Cloud Map HTTP Namespace", "Properties": { "DnsProperties": {}, "HttpProperties": { "HttpName": "example-http.com" } }, "CreateDate": "2024-02-23T13:35:21.874000-06:00", "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678" } } ``` Weitere Informationen finden Sie unter [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um die Details eines Namespaces mit ARN abzurufen** Im folgenden `get-namespace` Beispiel werden Informationen über den angegebenen Namespace mithilfe seines ARN abgerufen. Die Angabe des ARN ist erforderlich, um Details eines mit Ihrem Konto geteilten Namespaces abzurufen. ``` aws servicediscovery get-namespace \ --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 ``` Ausgabe: ``` { "Namespace": { "Id": "ns-abcd1234xmpl5678", "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678", "ResourceOwner": "123456789012", "Name": "example-http.com", "Type": "HTTP", "Description": "Example.com AWS Cloud Map HTTP Namespace", "Properties": { "DnsProperties": {}, "HttpProperties": { "HttpName": "example-http.com" } }, "CreateDate": "2024-02-23T13:35:21.874000-06:00", "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678" } } ``` Weitere Informationen finden Sie unter [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [GetNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-namespace.html)in AWS CLI der Befehlsreferenz.* ### `get-operation` Das folgende Codebeispiel zeigt die Verwendung`get-operation`. **AWS CLI** **Beispiel 1: Um das Ergebnis einer Operation zu erhalten** Im folgenden `get-operation`-Beispiel wird das Ergebnis einer Operation zur Erstellung eines Namespaces abgerufen. ``` aws servicediscovery get-operation \ --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234 ``` Ausgabe: ``` { "Operation": { "Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234", "Type": "CREATE_NAMESPACE", "Status": "SUCCESS", "CreateDate": "2025-01-13T13:35:21.874000-06:00", "UpdateDate": "2025-01-13T13:36:02.469000-06:00", "Targets": { "NAMESPACE": "ns-abcd1234xmpl5678" } } } ``` Weitere Informationen finden Sie im [AWS Cloud Map *Developer Guide unter Creating a AWS Cloud Map* Namespace to Group Application Services](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html). **Beispiel 2: Um einen Vorgang von einem bestimmten Besitzerkonto aus abzurufen** Im folgenden `get-operation` Beispiel wird das Ergebnis einer Operation abgerufen, die einem bestimmten Namespace-Eigentümerkonto zugeordnet ist. Dieser Parameter ist erforderlich, um das Ergebnis von Vorgängen abzurufen, die mit Namespaces verknüpft sind, die mit Ihrem Konto gemeinsam genutzt werden. ``` aws servicediscovery get-operation \ --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234 \ --owner-account 123456789111 ``` Ausgabe: ``` { "Operation": { "Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234", "OwnerAccount": "123456789111", "Type": "CREATE_NAMESPACE", "Status": "SUCCESS", "CreateDate": "2025-01-13T13:35:21.874000-06:00", "UpdateDate": "2025-01-13T13:36:02.469000-06:00", "Targets": { "NAMESPACE": "ns-abcd1234xmpl5678" } } } ``` Weitere Informationen finden Sie unter [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [GetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-operation.html)in AWS CLI der Befehlsreferenz.* ### `get-service-attributes` Das folgende Codebeispiel zeigt die Verwendung`get-service-attributes`. **AWS CLI** **Beispiel 1: Um die Attribute eines Dienstes abzurufen** Im folgenden `get-service-attributes`-Beispiel werden die Attribute eines Services abgerufen. ``` aws servicediscovery get-service-attributes \ --service-id srv-abcd1234xmpl5678 ``` Ausgabe: ``` { "ServiceAttributes": { "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678", "ResourceOwner": "123456789012", "Attributes": { "Port": "80" } } } ``` Weitere Informationen finden Sie unter [Services von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um die Attribute eines Dienstes mithilfe von ARN abzurufen** Im folgenden `get-service-attributes` Beispiel werden die Attribute eines Dienstes mithilfe seines ARN abgerufen. Die Angabe eines ARN ist erforderlich, um Attribute eines Dienstes abzurufen, der in einem mit Ihrem Konto gemeinsam genutzten Namespace erstellt wurde. ``` aws servicediscovery get-service-attributes \ --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 ``` Ausgabe: ``` { "ServiceAttributes": { "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678", "ResourceOwner": "123456789012", "Attributes": { "Port": "80" } } } ``` Weitere Informationen finden Sie unter [AWS Cloud Map-Dienste](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [GetServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service-attributes.html)in AWS CLI der Befehlsreferenz.* ### `get-service` Das folgende Codebeispiel zeigt die Verwendung`get-service`. **AWS CLI** **Beispiel 1: Um die Einstellungen eines Dienstes abzurufen** Im folgenden `get-service`-Beispiel werden die Einstellungen des angegebenen Services abgerufen. ``` aws servicediscovery get-service \ --id srv-abcd1234xmpl5678 ``` Ausgabe: ``` { "Service": { "Id": "srv-abcd1234xmpl5678", "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678", "ResourceOwner": "123456789012", "Name": "test-service", "NamespaceId": "ns-abcd1234xmpl5678", "DnsConfig": {}, "Type": "HTTP", "CreateDate": "2025-08-18T13:53:02.775000-05:00", "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678", "CreatedByAccount": "123456789012" } } ``` Weitere Informationen finden Sie unter [Services von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um die Einstellungen eines Dienstes mit ARN abzurufen** Im folgenden `get-service` Beispiel werden die Einstellungen eines angegebenen Dienstes mithilfe seines ARN abgerufen. Die Angabe des ARN ist erforderlich, wenn Sie Informationen über einen Dienst abrufen, der in einem Namespace erstellt wurde, der mit Ihrem Konto gemeinsam genutzt wird. Das Anruferkonto `123456789111` hat den Dienst in einem Namespace erstellt, der vom Konto gemeinsam genutzt wird. `123456789012` ``` aws servicediscovery get-service \ --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 ``` Ausgabe: ``` { "Service": { "Id": "srv-abcd1234xmpl5678", "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678", "ResourceOwner": "123456789012", "Name": "test-service", "NamespaceId": "ns-abcd1234xmpl5678", "DnsConfig": {}, "Type": "HTTP", "CreateDate": "2025-08-18T13:53:02.775000-05:00", "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678", "CreatedByAccount": "123456789111" } } ``` Weitere Informationen finden Sie unter [Creating a AWS Cloud Map Service für eine Anwendungskomponente](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html) und [Shared AWS Cloud Map Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [GetService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service.html)in AWS CLI der Befehlsreferenz.* ### `list-instances` Das folgende Codebeispiel zeigt die Verwendung`list-instances`. **AWS CLI** **Beispiel 1: Um Dienstinstanzen aufzulisten** Im folgenden `list-instances`-Beispiel werden die Service-Instances aufgelistet. ``` aws servicediscovery list-instances \ --service-id srv-qzpwvt2tfqcegapy ``` Ausgabe: ``` { "Instances": [ { "Id": "i-06bdabbae60f65a4e", "Attributes": { "AWS_INSTANCE_IPV4": "172.2.1.3", "AWS_INSTANCE_PORT": "808" }, "CreatedByAccount": "123456789012" } ], "ResourceOwner": "123456789012" } ``` Weitere Informationen finden Sie unter [AWS Cloud Map-Dienstinstanzen auflisten](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) im *AWS Cloud Map Developer Guide*. **Beispiel 2: So listen Sie Dienstinstanzen mithilfe des Dienst-ARN auf** Das folgende `list-instances` Beispiel listet Dienstinstanzen auf, die einen Dienst-ARN anstelle einer Dienst-ID verwenden. Die Angabe eines ARN ist erforderlich, wenn Sie Instances auflisten, die mit Namespaces verknüpft sind, die mit Ihrem Konto geteilt werden. ``` aws servicediscovery list-instances \ --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita ``` Ausgabe: ``` { "ResourceOwner": "123456789012", "Instances": [ { "Id": "web-server-01", "Attributes": { "AWS_INSTANCE_IPV4": "203.0.113.15", "AWS_INSTANCE_PORT": "80" }, "CreatedByAccount": "123456789012" }, { "Id": "web-server-02", "Attributes": { "AWS_INSTANCE_IPV4": "203.0.113.16", "AWS_INSTANCE_PORT": "80" }, "CreatedByAccount": "123456789012" } ] } ``` *Weitere Informationen zur kontoübergreifenden Nutzung von Namespaces finden Sie unter [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [Auflisten von Cloud Map-Dienstinstanzen im AWSAWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) Developer Guide.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [ListInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-instances.html)AWS CLI * ### `list-namespaces` Das folgende Codebeispiel zeigt die Verwendung`list-namespaces`. **AWS CLI** **Beispiel 1: Um Namespaces aufzulisten** Im folgenden `list-namespaces`-Beispiel werden Namespaces aufgelistet. ``` aws servicediscovery list-namespaces ``` Ausgabe: ``` { "Namespaces": [ { "Id": "ns-abcd1234xmpl5678", "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678", "ResourceOwner": "123456789012", "Name": "local", "Type": "DNS_PRIVATE", "Properties": { "DnsProperties": { "HostedZoneId": "Z06752353VBUDTC32S84S", "SOA": {} }, "HttpProperties": { "HttpName": "local" } }, "CreateDate": "2023-07-17T13:37:27.872000-05:00" }, { "Id": "ns-abcd1234xmpl9012", "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl9012", "ResourceOwner": "123456789012", "Name": "My-second-namespace", "Type": "HTTP", "Description": "My second namespace", "Properties": { "DnsProperties": { "SOA": {} }, "HttpProperties": { "HttpName": "My-second-namespace" } }, "CreateDate": "2023-11-14T10:35:47.840000-06:00" } ] } ``` Weitere Informationen finden Sie unter [AWS Cloud Map-Namespaces auflisten](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-namespaces.html) im *AWS Cloud Map* Developer Guide. **Beispiel 2: Um Namespaces aufzulisten, die von anderen Konten gemeinsam genutzt werden** Im folgenden `list-namespaces` Beispiel werden Namespaces aufgeführt, die von anderen Konten, die den Filter verwenden, mit dem Anruferkonto gemeinsam genutzt werden. AWS `RESOURCE_OWNER` ``` aws servicediscovery list-namespaces \ --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ ``` Ausgabe: ``` { "Namespaces": [ { "Id": "ns-abcd1234xmpl5678", "Arn": "arn:aws:servicediscovery:us-west-2:123456789111:namespace/ns-abcd1234xmpl5678", "ResourceOwner": "123456789111", "Name": "shared-namespace", "Type": "HTTP", "Description": "Namespace shared from another account", "Properties": { "DnsProperties": { "SOA": {} }, "HttpProperties": { "HttpName": "shared-namespace" } }, "CreateDate": "2025-01-13T13:35:21.874000-06:00" } ] } ``` Weitere Informationen finden Sie unter [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [ListNamespaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-namespaces.html)in AWS CLI der Befehlsreferenz.* ### `list-operations` Das folgende Codebeispiel zeigt die Verwendung`list-operations`. **AWS CLI** **So listen Sie Vorgänge auf, die den angegebenen Kriterien entsprechen** Im folgenden `list-operations`-Beispiel werden Vorgänge aufgelistet, die den Status `PENDING` oder `SUCCESS` haben. ``` aws servicediscovery list-operations \ --service-id srv-e4anhexample0004 \ --filters Name=STATUS,Condition=IN,Values=PENDING,SUCCESS ``` Ausgabe: ``` { "Operations": [ { "Id": "76yy8ovhpdz0plmjzbsnqgnrqvpv2qdt-kexample", "Status": "SUCCESS" }, { "Id": "prysnyzpji3u2ciy45nke83x2zanl7yk-dexample", "Status": "SUCCESS" }, { "Id": "ko4ekftir7kzlbechsh7xvcdgcpk66gh-7example", "Status": "PENDING" } ] } ``` Weitere Informationen finden Sie unter [Was ist AWS Cloud Map?](https://docs.aws.amazon.com/cloud-map/latest/dg/what-is-cloud-map.html) im *AWS Cloud Map Developer Guide*. + Einzelheiten zur API finden Sie [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-operations.html)in der *AWS CLI Befehlsreferenz*. ### `list-services` Das folgende Codebeispiel zeigt die Verwendung`list-services`. **AWS CLI** **Beispiel 1: Um Dienste aufzulisten** Im folgenden `list-services`-Beispiel werden Services aufgelistet. ``` aws servicediscovery list-services ``` Ausgabe: ``` { "Services": [ { "Id": "srv-p5zdwlg5uvvzjita", "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita", "Name": "myservice", "DnsConfig": { "RoutingPolicy": "MULTIVALUE", "DnsRecords": [ { "Type": "A", "TTL": 60 } ] }, "CreateDate": 1587081768.334 } ] } ``` Weitere Informationen finden Sie unter [AWS Cloud Map-Dienste in einem Namespace auflisten](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html) im *AWS Cloud Map Developer Guide*. **Beispiel 2: Um Dienste aufzulisten, die in gemeinsamen Namespaces erstellt wurden** Das folgende `list-services` Beispiel listet Dienste auf, die in Namespaces erstellt wurden, die von anderen Konten, die den Filter verwenden, mit dem Anruferkonto `123456789012` gemeinsam genutzt werden. AWS `RESOURCE_OWNER` ``` aws servicediscovery list-services \ --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ ``` Ausgabe: ``` { "Services": [ { "Id": "srv-abcd1234xmpl5678", "Arn": "arn:aws:servicediscovery:us-west-2:123456789111:service/srv-abcd1234xmpl5678", "ResourceOwner": "123456789111", "Name": "shared-service", "NamespaceId": "ns-abcd1234xmpl5678", "Type": "HTTP", "Description": "Service in shared namespace", "DnsConfig": {}, "CreateDate": "2025-01-13T13:35:21.874000-06:00", "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678", "CreatedByAccount": "123456789012" } ] } ``` Weitere Informationen finden Sie unter [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [AWS Cloud Map-Dienste in einem Namespace auflisten im *AWS Cloud* Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html) Developer Guide. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [ListServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-services.html).AWS CLI * ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags auf, die der angegebenen Ressourcengruppe zugeordnet sind** Im folgenden `list-tags-for-resource`-Beispiel werden die Tags für die angegebene Ressource aufgelistet. ``` aws servicediscovery list-tags-for-resource \ --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 ``` Ausgabe: ``` { "Tags": [ { "Key": "Project", "Value": "Zeta" }, { "Key": "Department", "Value": "Engineering" } ] } ``` Weitere Informationen finden Sie unter [Tagging your AWS Cloud Map Resources](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) im *AWS Cloud Map Developer Guide*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `register-instance` Das folgende Codebeispiel zeigt die Verwendung`register-instance`. **AWS CLI** **Beispiel 1: Um eine Dienstinstanz mithilfe der Service-ID zu registrieren** Im folgenden `register-instance`-Beispiel wird eine Service-Instance registriert. ``` aws servicediscovery register-instance \ --service-id srv-p5zdwlg5uvvzjita \ --instance-id myservice-53 \ --attributes=AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808 ``` Ausgabe: ``` { "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html). Weitere Informationen zur Registrierung einer Instanz finden Sie unter [Registrierung einer Ressource als AWS Cloud Map-Dienstinstanz](https://docs.aws.amazon.com/cloud-map/latest/dg/registering-instances.html) im *AWS Cloud Map Developer Guide*. **Beispiel 2: So registrieren Sie eine Dienstinstanz mithilfe des Dienst-ARN** Im folgenden `register-instance` Beispiel wird eine Dienstinstanz mithilfe eines Dienst-ARN registriert. Die Angabe des ARN ist erforderlich, wenn Sie Instanzen in Diensten registrieren, die mit Ihrem Konto gemeinsam genutzt werden. ``` aws servicediscovery register-instance \ --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \ --instance-id web-server-01 \ --attributes=AWS_INSTANCE_IPV4=203.0.113.15,AWS_INSTANCE_PORT=80 ``` Ausgabe: ``` { "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl" } ``` *Weitere Informationen zur kontoübergreifenden Nutzung von Namespaces finden Sie unter [Shared AWS Cloud Map-Namespaces im Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) Developer Guide.AWS * + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [RegisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/register-instance.html)AWS CLI * ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So ordnen Sie Tags der angegebenen Ressource zu** Im folgenden `tag-resource`-Beispiel wird ein `Department`-Tag mit dem Wert `Engineering` dem angegebenen Namespace zugeordnet. ``` aws servicediscovery tag-resource \ --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \ --tags Key=Department, Value=Engineering ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging your AWS Cloud Map Resources](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) im *AWS Cloud Map Developer Guide*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus der angegebenen Ressource** Im folgenden `untag-resource`-Beispiel wird ein `Department`-Tag aus dem angegebenen Namespace entfernt. ``` aws servicediscovery untag-resource \ --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \ --tags Key=Department, Value=Engineering ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging your AWS Cloud Map Resources](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) im *AWS Cloud Map Developer Guide*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-http-namespace` Das folgende Codebeispiel zeigt die Verwendung`update-http-namespace`. **AWS CLI** **Beispiel 1: Um einen HTTP-Namespace zu aktualisieren** Im folgenden `update-http-namespace`-Beispiel wird die Beschreibung des angegebenen HTTP-Namespace aktualisiert. ``` aws servicediscovery update-http-namespace \ --id ns-abcd1234xmpl5678 \ --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \ --namespace Description="The updated namespace description." ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html). Weitere Informationen finden Sie unter [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um einen HTTP-Namespace mit ARN zu aktualisieren** Im folgenden `update-http-namespace` Beispiel wird der angegebene HTTP-Namespace mithilfe seines ARN aktualisiert. ``` aws servicediscovery update-http-namespace \ --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \ --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \ --namespace Description="The updated namespace description." ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Weitere Informationen finden Sie unter [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*. + Einzelheiten zur API finden Sie unter [UpdateHttpNamespace AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-http-namespace.html)*Befehlsreferenz.* ### `update-instance-custom-health-status` Das folgende Codebeispiel zeigt die Verwendung`update-instance-custom-health-status`. **AWS CLI** **Beispiel 1: Um eine benutzerdefinierte Integritätsprüfung zu aktualisieren** Im folgenden `update-instance-custom-health-status`-Beispiel wird der Status der benutzerdefinierten Zustandsprüfung für den angegebenen Service und die angegebene Beispiel-Service-Instance auf `HEALTHY` aktualisiert. ``` aws servicediscovery update-instance-custom-health-status \ --service-id srv-e4anhexample0004 \ --instance-id example \ --status HEALTHY ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Zustandsprüfung des Services AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: So aktualisieren Sie eine benutzerdefinierte Zustandsprüfung mithilfe des Dienst-ARN** Im folgenden `update-instance-custom-health-status` Beispiel wird der Status der benutzerdefinierten Integritätsprüfung mithilfe eines Dienst-ARN aktualisiert. Der ARN ist erforderlich, wenn der Integritätsstatus für Instances aktualisiert wird, die mit Namespaces verknüpft sind, die mit Ihrem Konto geteilt werden. ``` aws servicediscovery update-instance-custom-health-status \ --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \ --instance-id web-server-01 \ --status HEALTHY ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfiguration der Integritätsprüfung des AWS Cloud Map-Dienstes](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html) und [kontoübergreifende Nutzung von AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map Developer Guide*. + Einzelheiten zur API finden Sie [UpdateInstanceCustomHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-instance-custom-health-status.html)in der *AWS CLI Befehlsreferenz*. ### `update-private-dns-namespace` Das folgende Codebeispiel zeigt die Verwendung`update-private-dns-namespace`. **AWS CLI** **Beispiel 1: Um einen privaten DNS-Namespace mithilfe von ID zu aktualisieren** Im folgenden `update-private-dns-namespace` Beispiel wird die Beschreibung eines privaten DNS-Namespaces mithilfe der Namespace-ID aktualisiert. ``` aws servicediscovery update-private-dns-namespace \ --id ns-abcd1234xmpl5678 \ --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \ --namespace Description="The updated namespace description." ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um einen privaten DNS-Namespace mit ARN zu aktualisieren** Im folgenden `update-private-dns-namespace` Beispiel wird ein privater DNS-Namespace mithilfe seines ARN aktualisiert. ``` aws servicediscovery update-private-dns-namespace \ --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \ --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \ --namespace Description="The updated namespace description." ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Weitere Informationen finden Sie unter [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*. + Einzelheiten zur API finden Sie unter [UpdatePrivateDnsNamespace AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-private-dns-namespace.html)*Befehlsreferenz.* ### `update-public-dns-namespace` Das folgende Codebeispiel zeigt die Verwendung`update-public-dns-namespace`. **AWS CLI** **Beispiel 1: Um einen öffentlichen DNS-Namespace mithilfe von ID zu aktualisieren** Im folgenden `update-public-dns-namespace` Beispiel wird die Beschreibung eines öffentlichen DNS-Namespaces anhand seiner ID aktualisiert. ``` aws servicediscovery update-public-dns-namespace \ --id ns-abcd1234xmpl5678 \ --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \ --namespace Description="The updated namespace description." ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: Um einen öffentlichen DNS-Namespace mit ARN zu aktualisieren** Im folgenden `update-public-dns-namespace` Beispiel wird ein öffentlicher DNS-Namespace mithilfe seines ARN aktualisiert. ``` aws servicediscovery update-public-dns-namespace \ --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \ --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \ --namespace Description="The updated namespace description." ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Weitere Informationen finden Sie unter [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*. + Einzelheiten zur API finden Sie unter [UpdatePublicDnsNamespace AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-public-dns-namespace.html)*Befehlsreferenz.* ### `update-service-attributes` Das folgende Codebeispiel zeigt die Verwendung`update-service-attributes`. **AWS CLI** **Beispiel 1: Um einen Dienst zu aktualisieren, um ein Attribut hinzuzufügen** Im folgenden `update-service-attributes`-Beispiel wird der angegebene Service aktualisiert, um ein Serviceattribut mit einem Schlüssel `Port` und einem Wert von `80` hinzuzufügen. ``` aws servicediscovery update-service-attributes \ --service-id srv-abcd1234xmpl5678 \ --attributes Port=80 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Services von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) im *Entwicklerhandbuch für AWS Cloud Map*. **Beispiel 2: So aktualisieren Sie Dienstattribute mithilfe von ARN** Im folgenden `update-service-attributes` Beispiel wird ein Dienst mithilfe seines ARN aktualisiert, um ein Dienstattribut hinzuzufügen. Die Angabe des ARN ist erforderlich, um Attribute zu Diensten hinzuzufügen, die in Namespaces erstellt wurden, die mit Ihrem Konto gemeinsam genutzt werden. ``` aws servicediscovery update-service-attributes \ --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \ --attributes Port=80 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [AWS Cloud Map-Dienste](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [UpdateServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service-attributes.html)in AWS CLI der Befehlsreferenz.* ### `update-service` Das folgende Codebeispiel zeigt die Verwendung`update-service`. **AWS CLI** **Beispiel 1: Um einen Dienst zu aktualisieren** Im folgenden `update-service`-Beispiel wird ein Service aktualisiert, um die Einstellungen `DnsConfig` und `HealthCheckConfig` zu aktualisieren. ``` aws servicediscovery update-service \ --id srv-abcd1234xmpl5678 \ --service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}" ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Sie können `get-operation` ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen zum Aktualisieren eines Dienstes finden Sie unter [Aktualisieren eines AWS Cloud Map-Dienstes](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html) im *AWS Cloud Map Developer Guide*. **Beispiel 2: Um einen Dienst mit ARN zu aktualisieren** Im folgenden `update-service` Beispiel wird ein Dienst mithilfe seines ARN aktualisiert. Die Angabe eines ARN ist für Dienste erforderlich, die in Namespaces erstellt werden, die mit Ihrem Konto geteilt werden. ``` aws servicediscovery update-service \ --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \ --service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}" ``` Ausgabe: ``` { "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678" } ``` Weitere Informationen zum Aktualisieren eines Dienstes finden Sie unter [Aktualisieren eines AWS Cloud Map-Dienstes](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide. + *Einzelheiten zur API finden Sie [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service.html)in AWS CLI der Befehlsreferenz.* # AWS Cloud9 Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Cloud9. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-environment-ec2` Das folgende Codebeispiel zeigt, wie Sie`create-environment-ec2`. **AWS CLI** **So erstellen Sie eine AWS Cloud9 EC2-Entwicklungsumgebung** Das folgende `create-environment-ec2` Beispiel erstellt eine AWS Cloud9-Entwicklungsumgebung mit den angegebenen Einstellungen, startet eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance und stellt dann eine Verbindung von der Instance zur Umgebung her. ``` aws cloud9 create-environment-ec2 \ --name my-demo-env \ --description "My demonstration development environment." \ --instance-type t2.micro --image-id amazonlinux-2023-x86_64 \ --subnet-id subnet-1fab8aEX \ --automatic-stop-time-minutes 60 \ --owner-arn arn:aws:iam::123456789012:user/MyDemoUser ``` Ausgabe: ``` { "environmentId": "8a34f51ce1e04a08882f1e811bd706EX" } ``` Weitere Informationen finden Sie unter [Erstellen einer EC2-Umgebung](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment-main.html) im *Benutzerhandbuch für AWS Cloud9*. + Einzelheiten zur API finden Sie unter [CreateEnvironmentEc2](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/create-environment-ec2.html) in der *AWS CLI Befehlsreferenz*. ### `create-environment-membership` Das folgende Codebeispiel zeigt die Verwendung`create-environment-membership`. **AWS CLI** **Um ein Umgebungsmitglied zu einer AWS Cloud9-Entwicklungsumgebung hinzuzufügen** In diesem Beispiel wird das angegebene Umgebungsmitglied zur angegebenen AWS Cloud9-Entwicklungsumgebung hinzugefügt. Befehl: ``` aws cloud9 create-environment-membership --environment-id 8a34f51ce1e04a08882f1e811bd706EX --user-arn arn:aws:iam::123456789012:user/AnotherDemoUser --permissions read-write ``` Ausgabe: ``` { "membership": { "environmentId": "8a34f51ce1e04a08882f1e811bd706EX", "userId": "AIDAJ3LOROMOUXTBSU6EX", "userArn": "arn:aws:iam::123456789012:user/AnotherDemoUser", "permissions": "read-write" } } ``` + Einzelheiten zur API finden Sie [CreateEnvironmentMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/create-environment-membership.html)in der *AWS CLI Befehlsreferenz.* ### `delete-environment-membership` Das folgende Codebeispiel zeigt die Verwendung`delete-environment-membership`. **AWS CLI** **Um ein Umgebungsmitglied aus einer AWS Cloud9-Entwicklungsumgebung zu löschen** In diesem Beispiel wird das angegebene Umgebungsmitglied aus der angegebenen AWS Cloud9-Entwicklungsumgebung gelöscht. Befehl: ``` aws cloud9 delete-environment-membership --environment-id 8a34f51ce1e04a08882f1e811bd706EX --user-arn arn:aws:iam::123456789012:user/AnotherDemoUser ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [DeleteEnvironmentMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/delete-environment-membership.html)in der *AWS CLI Befehlsreferenz*. ### `delete-environment` Das folgende Codebeispiel zeigt die Verwendung`delete-environment`. **AWS CLI** **Um eine AWS Cloud9-Entwicklungsumgebung zu löschen** In diesem Beispiel wird die angegebene AWS Cloud9-Entwicklungsumgebung gelöscht. Wenn die Umgebung mit einer Amazon-EC2-Instance verbunden ist, wird auch die Instance beendet. Befehl: ``` aws cloud9 delete-environment --environment-id 8a34f51ce1e04a08882f1e811bd706EX ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [DeleteEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/delete-environment.html)in der *AWS CLI Befehlsreferenz*. ### `describe-environment-memberships` Das folgende Codebeispiel zeigt die Verwendung`describe-environment-memberships`. **AWS CLI** **Um Informationen über Umgebungsmitglieder für eine AWS Cloud9-Entwicklungsumgebung abzurufen** In diesem Beispiel werden Informationen über Umgebungsmitglieder für die angegebene AWS Cloud9-Entwicklungsumgebung abgerufen. Befehl: ``` aws cloud9 describe-environment-memberships --environment-id 8a34f51ce1e04a08882f1e811bd706EX ``` Ausgabe: ``` { "memberships": [ { "environmentId": "8a34f51ce1e04a08882f1e811bd706EX", "userId": "AIDAJ3LOROMOUXTBSU6EX", "userArn": "arn:aws:iam::123456789012:user/AnotherDemoUser", "permissions": "read-write" }, { "environmentId": "8a34f51ce1e04a08882f1e811bd706EX", "userId": "AIDAJNUEDQAQWFELJDLEX", "userArn": "arn:aws:iam::123456789012:user/MyDemoUser", "permissions": "owner" } ] } ``` **Um Informationen über den Besitzer einer AWS Cloud9-Entwicklungsumgebung zu erhalten** In diesem Beispiel werden Informationen über den Besitzer der angegebenen AWS Cloud9-Entwicklungsumgebung abgerufen. Befehl: ``` aws cloud9 describe-environment-memberships --environment-id 8a34f51ce1e04a08882f1e811bd706EX --permissions owner ``` Ausgabe: ``` { "memberships": [ { "environmentId": "8a34f51ce1e04a08882f1e811bd706EX", "userId": "AIDAJNUEDQAQWFELJDLEX", "userArn": "arn:aws:iam::123456789012:user/MyDemoUser", "permissions": "owner" } ] } ``` **Um Informationen über ein Umgebungsmitglied für mehrere AWS Cloud9-Entwicklungsumgebungen zu erhalten** In diesem Beispiel werden Informationen über das angegebene Umgebungsmitglied für mehrere AWS Cloud9-Entwicklungsumgebungen abgerufen. Befehl: ``` aws cloud9 describe-environment-memberships --user-arn arn:aws:iam::123456789012:user/MyDemoUser ``` Ausgabe: ``` { "memberships": [ { "environmentId": "10a75714bd494714929e7f5ec4125aEX", "lastAccess": 1516213427.0, "userId": "AIDAJNUEDQAQWFELJDLEX", "userArn": "arn:aws:iam::123456789012:user/MyDemoUser", "permissions": "owner" }, { "environmentId": "1980b80e5f584920801c09086667f0EX", "lastAccess": 1516144884.0, "userId": "AIDAJNUEDQAQWFELJDLEX", "userArn": "arn:aws:iam::123456789012:user/MyDemoUser", "permissions": "owner" } ] } ``` + Einzelheiten zur API finden Sie [DescribeEnvironmentMemberships](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/describe-environment-memberships.html)in der *AWS CLI Befehlsreferenz.* ### `describe-environment-status` Das folgende Codebeispiel zeigt die Verwendung`describe-environment-status`. **AWS CLI** **Um Statusinformationen für eine AWS Cloud9-Entwicklungsumgebung abzurufen** In diesem Beispiel werden Statusinformationen für die angegebene AWS Cloud9-Entwicklungsumgebung abgerufen. Befehl: ``` aws cloud9 describe-environment-status --environment-id 685f892f431b45c2b28cb69eadcdb0EX ``` Ausgabe: ``` { "status": "ready", "message": "Environment is ready to use" } ``` + Einzelheiten zur API finden Sie [DescribeEnvironmentStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/describe-environment-status.html)in der *AWS CLI Befehlsreferenz.* ### `describe-environments` Das folgende Codebeispiel zeigt die Verwendung`describe-environments`. **AWS CLI** **Um Informationen über AWS Cloud9-Entwicklungsumgebungen zu erhalten** In diesem Beispiel werden Informationen zu den angegebenen AWS Cloud9-Entwicklungsumgebungen abgerufen. Befehl: ``` aws cloud9 describe-environments --environment-ids 685f892f431b45c2b28cb69eadcdb0EX 349c86d4579e4e7298d500ff57a6b2EX ``` Ausgabe: ``` { "environments": [ { "id": "685f892f431b45c2b28cb69eadcdb0EX", "name": "my-demo-ec2-env", "description": "Created from CodeStar.", "type": "ec2", "arn": "arn:aws:cloud9:us-east-1:123456789012:environment:685f892f431b45c2b28cb69eadcdb0EX", "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser", "lifecycle": { "status": "CREATED" } }, { "id": "349c86d4579e4e7298d500ff57a6b2EX", "name": my-demo-ssh-env", "description": "", "type": "ssh", "arn": "arn:aws:cloud9:us-east-1:123456789012:environment:349c86d4579e4e7298d500ff57a6b2EX", "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser", "lifecycle": { "status": "CREATED" } } ] } ``` + Einzelheiten zur API finden Sie [DescribeEnvironments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/describe-environments.html)in der *AWS CLI Befehlsreferenz.* ### `list-environments` Das folgende Codebeispiel zeigt die Verwendung`list-environments`. **AWS CLI** **Um eine Liste der verfügbaren AWS Cloud9-Entwicklungsumgebungskennungen zu erhalten** In diesem Beispiel wird eine Liste verfügbarer AWS Cloud9-Entwicklungsumgebungskennungen abgerufen. Befehl: ``` aws cloud9 list-environments ``` Ausgabe: ``` { "environmentIds": [ "685f892f431b45c2b28cb69eadcdb0EX", "1980b80e5f584920801c09086667f0EX" ] } ``` + Einzelheiten zur API finden Sie [ListEnvironments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/list-environments.html)in der *AWS CLI Befehlsreferenz*. ### `update-environment-membership` Das folgende Codebeispiel zeigt die Verwendung`update-environment-membership`. **AWS CLI** **Um die Einstellungen eines vorhandenen Umgebungsmitglieds für eine AWS Cloud9-Entwicklungsumgebung zu ändern** In diesem Beispiel werden die Einstellungen des angegebenen vorhandenen Umgebungsmitglieds für die angegebene AWS Cloud9-Entwicklungsumgebung geändert. Befehl: ``` aws cloud9 update-environment-membership --environment-id 8a34f51ce1e04a08882f1e811bd706EX --user-arn arn:aws:iam::123456789012:user/AnotherDemoUser --permissions read-only ``` Ausgabe: ``` { "membership": { "environmentId": "8a34f51ce1e04a08882f1e811bd706EX", "userId": "AIDAJ3LOROMOUXTBSU6EX", "userArn": "arn:aws:iam::123456789012:user/AnotherDemoUser", "permissions": "read-only" } } ``` + Einzelheiten zur API finden Sie unter [UpdateEnvironmentMembership AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/update-environment-membership.html)*Befehlsreferenz.* ### `update-environment` Das folgende Codebeispiel zeigt die Verwendung`update-environment`. **AWS CLI** **Um die Einstellungen einer vorhandenen AWS Cloud9-Entwicklungsumgebung zu ändern** In diesem Beispiel werden die angegebenen Einstellungen der angegebenen vorhandenen AWS Cloud9-Entwicklungsumgebung geändert. Befehl: ``` aws cloud9 update-environment --environment-id 8a34f51ce1e04a08882f1e811bd706EX --name my-changed-demo-env --description "My changed demonstration development environment." ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [UpdateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/update-environment.html)in der *AWS CLI Befehlsreferenz.* # CloudFormation Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CloudFormation. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `activate-type` Das folgende Codebeispiel zeigt, wie Sie`activate-type`. **AWS CLI** **So aktivieren Sie einen Typ** Im folgenden Beispiel für `activate-type` wird eine öffentliche Erweiterung eines Drittanbieters aktiviert und für die Verwendung in Stack-Vorlagen zur Verfügung gestellt. ``` aws cloudformation activate-type \ --region us-west-2 \ --type RESOURCE \ --type-name Example::Test::1234567890abcdef0 \ --type-name-alias Example::Test::Alias ``` Ausgabe: ``` { "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Alias" } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der AWS CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [ActivateType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/activate-type.html)unter *AWS CLI Befehlsreferenz*. ### `batch-describe-type-configurations` Das folgende Codebeispiel zeigt die Verwendung`batch-describe-type-configurations`. **AWS CLI** **So beschreiben Sie eine Typkonfiguration stapelweise** Im folgenden Beispiel für `batch-describe-type-configurations` werden die Daten für den Typ konfiguriert. ``` aws cloudformation batch-describe-type-configurations \ --region us-west-2 \ --type-configuration-identifiers TypeArn="arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Type,TypeConfigurationAlias=MyConfiguration" ``` Ausgabe: ``` { "Errors": [], "UnprocessedTypeConfigurations": [], "TypeConfigurations": [ { "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Type", "Alias": "MyConfiguration", "Configuration": "{\n \"Example\": {\n \"ApiKey\": \"examplekey\",\n \"ApplicationKey\": \"examplekey1\",\n \"ApiURL\": \"exampleurl\"\n }\n}", "LastUpdated": "2021-10-01T15:25:46.210000+00:00", "TypeArn": "arn:aws:cloudformation:us-east-1:123456789012:type/resource/Example-Test-Type" } ] } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der AWS CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [BatchDescribeTypeConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/batch-describe-type-configurations.html)unter *AWS CLI Befehlsreferenz*. ### `cancel-update-stack` Das folgende Codebeispiel zeigt die Verwendung`cancel-update-stack`. **AWS CLI** **So brechen Sie eine Stack-Aktualisierung ab, die gerade ausgeführt wird** Der folgende `cancel-update-stack`-Befehl bricht eine Stackaktualisierung auf dem `myteststack`-Stack ab: ``` aws cloudformation cancel-update-stack --stack-name myteststack ``` + Einzelheiten zur API finden Sie [CancelUpdateStack](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/cancel-update-stack.html)in der *AWS CLI Befehlsreferenz*. ### `continue-update-rollback` Das folgende Codebeispiel zeigt die Verwendung`continue-update-rollback`. **AWS CLI** **So wiederholen Sie einen Update-Rollback** Das folgende `continue-update-rollback`-Beispiel setzt einen Rollback-Vorgang nach einer zuvor fehlgeschlagenen Stack-Aktualisierung fort. ``` aws cloudformation continue-update-rollback \ --stack-name my-stack ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [ContinueUpdateRollback](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/continue-update-rollback.html)in der *AWS CLI Befehlsreferenz*. ### `create-change-set` Das folgende Codebeispiel zeigt die Verwendung`create-change-set`. **AWS CLI** **Um einen Änderungssatz zu erstellen** Im folgenden Beispiel für `create-change-set` wird ein Änderungssatz mit der `CAPABILITY_IAM`-Fähigkeit erstellt. Die Datei `template.yaml` ist eine AWS CloudFormation Vorlage im aktuellen Ordner, die einen Stapel definiert, der IAM-Ressourcen enthält. ``` aws cloudformation create-change-set \ --stack-name my-application \ --change-set-name my-change-set \ --template-body file://template.yaml \ --capabilities CAPABILITY_IAM ``` Ausgabe: ``` { "Id": "arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-application/d0a825a0-e4cd-xmpl-b9fb-061c69e99204" } ``` + Einzelheiten zur API finden Sie unter [CreateChangeSet AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-change-set.html)*Befehlsreferenz.* ### `create-generated-template` Das folgende Codebeispiel zeigt die Verwendung`create-generated-template`. **AWS CLI** **Um eine generierte Vorlage aus gescannten Ressourcen zu erstellen** Im folgenden `create-generated-template` Beispiel wird eine generierte Vorlage erstellt, die `MyTemplate` aus gescannten Ressourcen benannt wurde. ``` aws cloudformation create-generated-template \ --generated-template-name MyTemplate \ --resources file://resources.json ``` Inhalt von `resources.json`: ``` [ { "ResourceType": "AWS::EKS::Cluster", "LogicalResourceId":"MyCluster", "ResourceIdentifier": { "ClusterName": "MyAppClusterName" } }, { "ResourceType": "AWS::AutoScaling::AutoScalingGroup", "LogicalResourceId":"MyASG", "ResourceIdentifier": { "AutoScalingGroupName": "MyAppASGName" } }, { "ResourceType": "AWS::EKS::Nodegroup", "LogicalResourceId":"MyNodegroup", "ResourceIdentifier": { "NodegroupName": "MyAppNodegroupName" } }, { "ResourceType": "AWS::IAM::Role", "LogicalResourceId":"MyRole", "ResourceIdentifier": { "RoleId": "arn:aws::iam::123456789012:role/MyAppIAMRole" } } ] ``` Ausgabe: ``` { "Arn": "arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/7fc8512c-d8cb-4e02-b266-d39c48344e48", "Name": "MyTemplate" } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [Erstellen einer CloudFormation Vorlage aus Ressourcen, die mit dem IaC-Generator gescannt](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/iac-generator-create-template-from-scanned-resources.html) wurden. + Einzelheiten zur API finden Sie unter [CreateGeneratedTemplate AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-generated-template.html)*Befehlsreferenz.* ### `create-stack-instances` Das folgende Codebeispiel zeigt die Verwendung`create-stack-instances`. **AWS CLI** **So erstellen Sie Stack-Instances** Im folgenden Beispiel für `create-stack-instances` werden Instances eines Stack-Sets in zwei Konten und vier Regionen erstellt. Die Einstellung für die Fehlertoleranz stellt sicher, dass die Aktualisierung in allen Konten und Regionen versucht wird, auch wenn einige Stacks nicht erstellt werden können. ``` aws cloudformation create-stack-instances \ --stack-set-name my-stack-set \ --accounts 123456789012 223456789012 \ --regions us-east-1 us-east-2 us-west-1 us-west-2 \ --operation-preferences FailureToleranceCount=7 ``` Ausgabe: ``` { "OperationId": "d7995c31-83c2-xmpl-a3d4-e9ca2811563f" } ``` Verwenden Sie den Befehl `create-stack-set`, um einen Stack zu erstellen. + Einzelheiten zur API finden Sie [CreateStackInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-stack-instances.html)in der *AWS CLI Befehlsreferenz*. ### `create-stack-refactor` Das folgende Codebeispiel zeigt die Verwendung`create-stack-refactor`. **AWS CLI** **Um die Stack-Definition für eine Stack-Refactor-Operation zu erstellen** Im folgenden `create-stack-refactor` Beispiel wird die Stack-Definition für das Stack-Refactoring erstellt. ``` aws cloudformation create-stack-refactor \ --stack-definitions \ StackName=Stack1,TemplateBody@=file://template1-updated.yaml \ StackName=Stack2,TemplateBody@=file://template2-updated.yaml ``` Ausgabe: ``` { "StackRefactorId": "9c384f70-4e07-4ed7-a65d-fee5eb430841" } ``` *Weitere Informationen finden Sie unter [Stack-Refactoring im Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-refactoring.html).AWS CloudFormation * + Einzelheiten zur API finden Sie [CreateStackRefactor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-stack-refactor.html)in der *AWS CLI Befehlsreferenz*. ### `create-stack-set` Das folgende Codebeispiel zeigt die Verwendung`create-stack-set`. **AWS CLI** **So erstellen Sie ein Stack-Set** Das folgende `create-stack-set` Beispiel erstellt ein Stack-Set unter Verwendung der angegebenen YAML-Dateivorlage. `template.yaml`ist eine AWS CloudFormation Vorlage im aktuellen Ordner, die einen Stapel definiert. ``` aws cloudformation create-stack-set \ --stack-set-name my-stack-set \ --template-body file://template.yaml \ --description "SNS topic" ``` Ausgabe: ``` { "StackSetId": "my-stack-set:8d0f160b-d157-xmpl-a8e6-c0ce8e5d8cc1" } ``` Führen Sie den `create-stack-instances`-Befehl aus, um Stack-Instances zum Stack-Set hinzuzufügen. + Einzelheiten zur API finden Sie [CreateStackSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-stack-set.html)in der *AWS CLI Befehlsreferenz*. ### `create-stack` Das folgende Codebeispiel zeigt die Verwendung`create-stack`. **AWS CLI** **Um einen AWS CloudFormation Stapel zu erstellen** Der folgende Befehl `create-stacks` erstellt einen Stapel mit dem Namen `myteststack` unter Verwendung der Vorlage `sampletemplate.json` : ``` aws cloudformation create-stack --stack-name myteststack --template-body file://sampletemplate.json --parameters ParameterKey=KeyPairName,ParameterValue=TestKey ParameterKey=SubnetIDs,ParameterValue=SubnetID1\\,SubnetID2 ``` Ausgabe: ``` { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896" } ``` Weitere Informationen finden Sie unter Stacks im *AWS CloudFormation Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateStack](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-stack.html)in der *AWS CLI Befehlsreferenz.* ### `deactivate-type` Das folgende Codebeispiel zeigt die Verwendung`deactivate-type`. **AWS CLI** **So deaktivieren Sie einen Typ** Im folgenden Beispiel für `deactivate-type` wird eine öffentliche Erweiterung deaktiviert, die zuvor in diesem Konto und in dieser Region aktiviert war. ``` aws cloudformation deactivate-type \ --region us-west-2 \ --type MODULE \ --type-name Example::Test::Type::MODULE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der AWS CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [DeactivateType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/deactivate-type.html)unter *AWS CLI Befehlsreferenz*. ### `delete-change-set` Das folgende Codebeispiel zeigt die Verwendung`delete-change-set`. **AWS CLI** **Um einen Änderungssatz zu löschen** Im folgenden Beispiel für `delete-change-set` wird ein Änderungssatz gelöscht, indem der Name des Änderungssatzes und der Name des Stacks angegeben werden. ``` aws cloudformation delete-change-set \ --stack-name my-stack \ --change-set-name my-change-set ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Im folgenden Beispiel für `delete-change-set` wird ein Änderungssatz gelöscht, indem der vollständige ARN des Änderungssatzes angegeben wird. ``` aws cloudformation delete-change-set \ --change-set-name arn:aws:cloudformation:us-east-2:123456789012:changeSet/my-change-set/4eca1a01-e285-xmpl-8026-9a1967bfb4b0 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteChangeSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-change-set.html)in der *AWS CLI Befehlsreferenz*. ### `delete-generated-template` Das folgende Codebeispiel zeigt die Verwendung`delete-generated-template`. **AWS CLI** **Um eine generierte Vorlage zu löschen** Im folgenden `delete-generated-template` Beispiel wird die angegebene Vorlage gelöscht. ``` aws cloudformation delete-generated-template \ --generated-template-name MyTemplate ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [Generieren von Vorlagen aus vorhandenen Ressourcen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC.html). + Einzelheiten zur API finden Sie [DeleteGeneratedTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-generated-template.html)in der *AWS CLI Befehlsreferenz*. ### `delete-stack-instances` Das folgende Codebeispiel zeigt die Verwendung`delete-stack-instances`. **AWS CLI** **So löschen Sie Stack-Instances** Im folgenden Beispiel für `delete-stack-instances` werden Instances eines Stack-Satzes in zwei Konten und vier Regionen gelöscht und die Stack beendet. ``` aws cloudformation delete-stack-instances \ --stack-set-name my-stack-set \ --accounts 123456789012 567890123456 \ --regions us-east-1 us-west-1 \ --no-retain-stacks ``` Ausgabe: ``` { "OperationId": "ad49f10c-fd1d-413f-a20a-8de6e2fa8f27" } ``` Verwenden Sie den Befehl `delete-stack-set`, um einen leeren Stack-Satz zu löschen. + Einzelheiten zur API finden Sie [DeleteStackInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-stack-instances.html)in der *AWS CLI Befehlsreferenz*. ### `delete-stack-set` Das folgende Codebeispiel zeigt die Verwendung`delete-stack-set`. **AWS CLI** **So löschen Sie einen Stack-Satz** Mit dem folgenden Befehl wird der angegebene leere Stack-Satz gelöscht. Das Stack-Set muss leer sein. ``` aws cloudformation delete-stack-set \ --stack-set-name my-stack-set ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Führen Sie den `delete-stack-instances`-Befehl aus, um Instances auf dem Stack-Satz zu löschen. + Einzelheiten zur API finden Sie [DeleteStackSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-stack-set.html)in der *AWS CLI Befehlsreferenz*. ### `delete-stack` Das folgende Codebeispiel zeigt die Verwendung`delete-stack`. **AWS CLI** **So löschen Sie einen Stack** Das folgende Beispiel `delete-stack` löscht den angegebenen Stapel. ``` aws cloudformation delete-stack \ --stack-name my-stack ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteStack](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-stack.html)in der *AWS CLI Befehlsreferenz*. ### `deploy` Das folgende Codebeispiel zeigt die Verwendung`deploy`. **AWS CLI** Mit dem folgenden Befehl wird eine Vorlage namens `template.json` für einen Stack mit dem Namen `my-new-stack` bereitgestellt: ``` aws cloudformation deploy --template-file /path_to_template/template.json --stack-name my-new-stack --parameter-overrides Key1=Value1 Key2=Value2 --tags Key1=Value1 Key2=Value2 ``` + Weitere API-Informationen finden Sie unter [Deploy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/deploy.html) in der *AWS CLI -Befehlsreferenz*. ### `deregister-type` Das folgende Codebeispiel zeigt die Verwendung`deregister-type`. **AWS CLI** **So heben Sie die Registrierung einer Typversion auf** Das folgende `deregister-type` Beispiel entfernt die angegebene Typversion aus der aktiven Verwendung in der CloudFormation Registrierung, sodass sie nicht mehr in CloudFormation Vorgängen verwendet werden kann. ``` aws cloudformation deregister-type \ --type RESOURCE \ --type-name My::Logs::LogGroup \ --version-id 00000002 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [DeregisterType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/deregister-type.html)unter *AWS CLI Befehlsreferenz*. ### `describe-account-limits` Das folgende Codebeispiel zeigt die Verwendung`describe-account-limits`. **AWS CLI** **So rufen Sie Informationen über Ihre Kontolimits ab** Mit dem folgenden Befehl wird eine Liste der regionalen Limits für das aktuelle Konto abgerufen. ``` aws cloudformation describe-account-limits ``` Ausgabe: ``` { "AccountLimits": [ { "Name": "StackLimit", "Value": 200 }, { "Name": "StackOutputsLimit", "Value": 60 }, { "Name": "ConcurrentResourcesLimit", "Value": 2500 } ] } ``` + Einzelheiten zur API finden Sie [DescribeAccountLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-account-limits.html)in der *AWS CLI Befehlsreferenz*. ### `describe-change-set` Das folgende Codebeispiel zeigt die Verwendung`describe-change-set`. **AWS CLI** **So rufen Sie Informationen über einen Änderungssatz ab** Im folgenden Beispiel für `describe-change-set` werden die Details des Änderungssatzes angezeigt, der mit dem Namen des Änderungssatzes und dem Namen des Stacks angegeben wird. ``` aws cloudformation describe-change-set \ --change-set-name my-change-set \ --stack-name my-stack ``` Im folgenden Beispiel für `describe-change-set` werden die Details des Änderungssatzes angezeigt, der mit dem vollständigen ARN des Änderungssatzes angegeben wird: ``` aws cloudformation describe-change-set \ --change-set-name arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784 ``` Ausgabe: ``` { "Changes": [ { "Type": "Resource", "ResourceChange": { "Action": "Modify", "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "Replacement": "False", "Scope": [ "Properties" ], "Details": [ { "Target": { "Attribute": "Properties", "Name": "Timeout", "RequiresRecreation": "Never" }, "Evaluation": "Static", "ChangeSource": "DirectModification" } ] } } ], "ChangeSetName": "my-change-set", "ChangeSetId": "arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/4eca1a01-e285-xmpl-8026-9a1967bfb4b0", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "StackName": "my-stack", "Description": null, "Parameters": null, "CreationTime": "2019-10-02T05:20:56.651Z", "ExecutionStatus": "AVAILABLE", "Status": "CREATE_COMPLETE", "StatusReason": null, "NotificationARNs": [], "RollbackConfiguration": {}, "Capabilities": [ "CAPABILITY_IAM" ], "Tags": null } ``` + Einzelheiten zur API finden Sie [DescribeChangeSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-change-set.html)in der *AWS CLI Befehlsreferenz*. ### `describe-generated-template` Das folgende Codebeispiel zeigt die Verwendung`describe-generated-template`. **AWS CLI** **Um eine generierte Vorlage zu beschreiben** Das folgende `describe-generated-template` Beispiel beschreibt die angegebene Vorlage. ``` aws cloudformation describe-generated-template \ --generated-template-name MyTemplate ``` Ausgabe: ``` { "GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedTemplate/7d881acf-f307-4ded-910e-f8fb49b96894", "GeneratedTemplateName": "MyTemplate", "Resources": [ { "ResourceType": "AWS::EC2::SecurityGroup", "LogicalResourceId": "EC2SecurityGroup", "ResourceIdentifier": { "Id": "sg-1234567890abcdef0" }, "ResourceStatus": "COMPLETE", "ResourceStatusReason": "Resource Template complete", "Warnings": [] }, { "ResourceType": "AWS::EC2::Instance", "LogicalResourceId": "EC2Instance", "ResourceIdentifier": { "InstanceId": "i-1234567890abcdef0" }, "ResourceStatus": "COMPLETE", "ResourceStatusReason": "Resource Template complete", "Warnings": [] }, { "ResourceType": "AWS::EC2::KeyPair", "LogicalResourceId": "EC2KeyPairSshkeypair", "ResourceIdentifier": { "KeyName": "sshkeypair" }, "ResourceStatus": "COMPLETE", "ResourceStatusReason": "Resource Template complete", "Warnings": [] } ], "Status": "COMPLETE", "StatusReason": "All resources complete", "CreationTime": "2025-09-23T19:38:06.435000+00:00", "LastUpdatedTime": "2025-09-23T19:38:10.798000+00:00", "Progress": { "ResourcesSucceeded": 3, "ResourcesFailed": 0, "ResourcesProcessing": 0, "ResourcesPending": 0 }, "TemplateConfiguration": { "DeletionPolicy": "RETAIN", "UpdateReplacePolicy": "RETAIN" }, "TotalWarnings": 0 } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [Generieren von Vorlagen aus vorhandenen Ressourcen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC.html). + Einzelheiten zur API finden Sie [DescribeGeneratedTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-generated-template.html)in der *AWS CLI Befehlsreferenz*. ### `describe-publisher` Das folgende Codebeispiel zeigt die Verwendung`describe-publisher`. **AWS CLI** **So beschreiben Sie einen Publisher** Im folgenden Beispiel für `describe-publisher` werden die Informationen für einen Publisher konfiguriert. ``` aws cloudformation describe-publisher \ --region us-west-2 \ --publisher-id 000q6TfUovXsEMmgKowxDZLlwqr2QUsh ``` Ausgabe: ``` { "PublisherId": "000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c", "PublisherStatus": "VERIFIED", "IdentityProvider": "AWS_Marketplace", "PublisherProfile": "https://aws.amazon.com/marketplace/seller-profile?id=2c5dc1f0-17cd-4259-8e46-822a83gdtegd" } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der AWS CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [DescribePublisher](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-publisher.html)unter *AWS CLI Befehlsreferenz*. ### `describe-resource-scan` Das folgende Codebeispiel zeigt die Verwendung`describe-resource-scan`. **AWS CLI** **Um einen Ressourcenscan zu beschreiben** Das folgende `describe-resource-scan` Beispiel beschreibt den Ressourcenscan mit der angegebenen Scan-ID. ``` aws cloudformation describe-resource-scan --region \ --resource-scan-id arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60 ``` Ausgabe: ``` { "ResourceScanId": "arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60", "Status": "COMPLETE", "StartTime": "2025-08-21T03:10:38.485000+00:00", "EndTime": "2025-08-21T03:20:28.485000+00:00", "PercentageCompleted": 100.0, "ResourceTypes": [ "AWS::CloudFront::CachePolicy", "AWS::CloudFront::OriginRequestPolicy", "AWS::EC2::DHCPOptions", "AWS::EC2::InternetGateway", "AWS::EC2::KeyPair", "AWS::EC2::NetworkAcl", "AWS::EC2::NetworkInsightsPath", "AWS::EC2::NetworkInterface", "AWS::EC2::PlacementGroup", "AWS::EC2::Route", "AWS::EC2::RouteTable", "AWS::EC2::SecurityGroup", "AWS::EC2::Subnet", "AWS::EC2::SubnetCidrBlock", "AWS::EC2::SubnetNetworkAclAssociation", "AWS::EC2::SubnetRouteTableAssociation", ... ], "ResourcesRead": 676 } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [Generieren von Vorlagen aus vorhandenen Ressourcen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC.html). + Einzelheiten zur API finden Sie [DescribeResourceScan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-resource-scan.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stack-drift-detection-status` Das folgende Codebeispiel zeigt die Verwendung`describe-stack-drift-detection-status`. **AWS CLI** **So überprüfen Sie den Status einer Operation zur Abweichungserkennung** Im folgenden Beispiel für `describe-stack-drift-detection-status` wird der Status einer Operation zur Abweichungserkennung angezeigt. Führen Sie den Befehl `detect-stack-drift` aus, um die ID abzurufen. ``` aws cloudformation describe-stack-drift-detection-status \ --stack-drift-detection-id 1a229160-e4d9-xmpl-ab67-0a4f93df83d4 ``` Ausgabe: ``` { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "StackDriftDetectionId": "1a229160-e4d9-xmpl-ab67-0a4f93df83d4", "StackDriftStatus": "DRIFTED", "DetectionStatus": "DETECTION_COMPLETE", "DriftedStackResourceCount": 1, "Timestamp": "2019-10-02T05:54:30.902Z" } ``` + Einzelheiten zur API finden Sie [DescribeStackDriftDetectionStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-drift-detection-status.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stack-events` Das folgende Codebeispiel zeigt die Verwendung`describe-stack-events`. **AWS CLI** **So beschreiben Sie Stack-Ereignisse** Das folgende Beispiel `describe-stack-events` zeigt die 2 jüngsten Ereignisse für den angegebenen Stapel an. ``` aws cloudformation describe-stack-events \ --stack-name my-stack \ --max-items 2 { "StackEvents": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "EventId": "4e1516d0-e4d6-xmpl-b94f-0a51958a168c", "StackName": "my-stack", "LogicalResourceId": "my-stack", "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2019-10-02T05:34:29.556Z", "ResourceStatus": "UPDATE_COMPLETE" }, { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "EventId": "4dd3c810-e4d6-xmpl-bade-0aaf8b31ab7a", "StackName": "my-stack", "LogicalResourceId": "my-stack", "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2019-10-02T05:34:29.127Z", "ResourceStatus": "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS" } ], "NextToken": "eyJOZXh0VG9XMPLiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==" } ``` + Einzelheiten zur API finden Sie [DescribeStackEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-events.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stack-instance` Das folgende Codebeispiel zeigt die Verwendung`describe-stack-instance`. **AWS CLI** **So beschreiben Sie eine Stack-Instance** Der folgende Befehl beschreibt eine Instance des angegebenen Stack-Satzes im spezifizierten Konto und der angegebenen Region. Der Stack-Satz befindet sich in der aktuellen Region und dem aktuellen Konto, während sich die Instance in der `us-west-2`-Region im Konto `123456789012` befindet. ``` aws cloudformation describe-stack-instance \ --stack-set-name my-stack-set \ --stack-instance-account 123456789012 \ --stack-instance-region us-west-2 ``` Ausgabe: ``` { "StackInstance": { "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Region": "us-west-2", "Account": "123456789012", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/StackSet-enable-config-e6cac20f-xmpl-46e9-8314-53e0d4591532/4287f9a0-e615-xmpl-894a-12b31d3117be", "ParameterOverrides": [], "Status": "OUTDATED", "StatusReason": "ResourceLogicalId:ConfigBucket, ResourceType:AWS::S3::Bucket, ResourceStatusReason:You have attempted to create more buckets than allowed (Service: Amazon S3; Status Code: 400; Error Code: TooManyBuckets; Request ID: F7F21CXMPL580224; S3 Extended Request ID: egd/Fdt89BXMPLyiqbMNljVk55Yqqvi3NYW2nKLUVWhUGEhNfCmZdyj967lhriaG/dWMobSO40o=)." } } ``` + Einzelheiten zur API finden Sie [DescribeStackInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-instance.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stack-refactor` Das folgende Codebeispiel zeigt die Verwendung`describe-stack-refactor`. **AWS CLI** **Um einen Stack-Refactoring-Vorgang zu beschreiben** Das folgende `describe-stack-refactor` Beispiel beschreibt den Stack-Refactoring-Vorgang mit der angegebenen Stack-Refactor-ID. ``` aws cloudformation describe-stack-refactor \ --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841 ``` Ausgabe: ``` { "StackRefactorId": "9c384f70-4e07-4ed7-a65d-fee5eb430841", "StackIds": [ "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf", "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b" ], "ExecutionStatus": "AVAILABLE", "Status": "CREATE_COMPLETE" } ``` *Weitere Informationen finden Sie unter [Stack-Refactoring im Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-refactoring.html).AWS CloudFormation * + Einzelheiten zur API finden Sie [DescribeStackRefactor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-refactor.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stack-resource-drifts` Das folgende Codebeispiel zeigt die Verwendung`describe-stack-resource-drifts`. **AWS CLI** **So rufen Sie Informationen über Ressourcen ab, die von der Stack-Definition abweichen** Der folgende Befehl zeigt Informationen zu den angegebenen Stack an. Verwenden Sie den `detect-stack-drift`-Befehl, um die Abweichungserkennung zu initiieren. ``` aws cloudformation describe-stack-resource-drifts \ --stack-name my-stack ``` Die Ausgabe zeigt eine AWS Lambda-Funktion, die geändert wurde: out-of-band ``` { "StackResourceDrifts": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "ExpectedProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":128,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":900,\"TracingConfig\":{\"Mode\":\"Active\"}}", "ActualProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":256,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":22,\"TracingConfig\":{\"Mode\":\"Active\"}}", "PropertyDifferences": [ { "PropertyPath": "/MemorySize", "ExpectedValue": "128", "ActualValue": "256", "DifferenceType": "NOT_EQUAL" }, { "PropertyPath": "/Timeout", "ExpectedValue": "900", "ActualValue": "22", "DifferenceType": "NOT_EQUAL" } ], "StackResourceDriftStatus": "MODIFIED", "Timestamp": "2019-10-02T05:54:44.064Z" } ] } ``` + Einzelheiten zur API finden Sie [DescribeStackResourceDrifts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-resource-drifts.html)in der *AWS CLI Befehlsreferenz.* ### `describe-stack-resource` Das folgende Codebeispiel zeigt die Verwendung`describe-stack-resource`. **AWS CLI** **So erhalten Sie Informationen zu einer Stack-Ressource** Das folgende Beispiel `describe-stack-resource` zeigt Details für die Ressource mit dem Namen `MyFunction` im angegebenen Stapel an. ``` aws cloudformation describe-stack-resource \ --stack-name MyStack \ --logical-resource-id MyFunction ``` Ausgabe: ``` { "StackResourceDetail": { "StackName": "MyStack", "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/MyStack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "MyFunction", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "LastUpdatedTimestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "Metadata": "{}", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } } ``` + Einzelheiten zur API finden Sie [DescribeStackResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-resource.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stack-resources` Das folgende Codebeispiel zeigt die Verwendung`describe-stack-resources`. **AWS CLI** **So erhalten Sie Informationen zu einer Stack-Ressource** Das folgende Beispiel `describe-stack-resources` zeigt Details zu den Ressourcen im angegebenen Stapel an. ``` aws cloudformation describe-stack-resources \ --stack-name my-stack ``` Ausgabe: ``` { "StackResources": [ { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "bucket", "PhysicalResourceId": "my-stack-bucket-1vc62xmplgguf", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2019-10-02T04:34:11.345Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "Timestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "functionRole", "PhysicalResourceId": "my-functionRole-HIZXMPLEOM9E", "ResourceType": "AWS::IAM::Role", "Timestamp": "2019-10-02T04:34:06.350Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } ] } ``` + Einzelheiten zur API finden Sie [DescribeStackResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-resources.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stack-set-operation` Das folgende Codebeispiel zeigt die Verwendung`describe-stack-set-operation`. **AWS CLI** **So rufen Sie Informationen über eine Stack-Satz-Operation ab** Das folgende describe-stack-set-operation `-Beispiel zeigt Details für einen Aktualisierungsvorgang auf dem angegebenen Stack-Set an. ``` aws cloudformation describe-stack-set-operation \ --stack-set-name enable-config \ --operation-id 35d45ebc-ed88-xmpl-ab59-0197a1fc83a0 ``` Ausgabe: ``` { "StackSetOperation": { "OperationId": "35d45ebc-ed88-xmpl-ab59-0197a1fc83a0", "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Action": "UPDATE", "Status": "SUCCEEDED", "OperationPreferences": { "RegionOrder": [ "us-east-1", "us-west-2", "eu-west-1", "us-west-1" ], "FailureToleranceCount": 7, "MaxConcurrentCount": 2 }, "AdministrationRoleARN": "arn:aws:iam::123456789012:role/AWSCloudFormationStackSetAdministrationRole", "ExecutionRoleName": "AWSCloudFormationStackSetExecutionRole", "CreationTimestamp": "2019-10-03T16:28:44.377Z", "EndTimestamp": "2019-10-03T16:42:08.607Z" } } ``` + Einzelheiten zur API finden Sie [DescribeStackSetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-set-operation.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stack-set` Das folgende Codebeispiel zeigt die Verwendung`describe-stack-set`. **AWS CLI** **So rufen Sie Informationen über einen Stack-Satz ab** Das folgende describe-stack-set `-Beispiel zeigt Details zum angegebenen Stack-Set an. ``` aws cloudformation describe-stack-set \ --stack-set-name my-stack-set ``` Ausgabe: ``` { "StackSet": { "StackSetName": "my-stack-set", "StackSetId": "my-stack-set:296a3360-xmpl-40af-be78-9341e95bf743", "Description": "Create an Amazon SNS topic", "Status": "ACTIVE", "TemplateBody": "AWSTemplateFormatVersion: '2010-09-09'\nDescription: An AWS SNS topic\nResources:\n topic:\n Type: AWS::SNS::Topic", "Parameters": [], "Capabilities": [], "Tags": [], "StackSetARN": "arn:aws:cloudformation:us-west-2:123456789012:stackset/enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "AdministrationRoleARN": "arn:aws:iam::123456789012:role/AWSCloudFormationStackSetAdministrationRole", "ExecutionRoleName": "AWSCloudFormationStackSetExecutionRole" } } ``` + Einzelheiten zur API finden Sie [DescribeStackSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-set.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stacks` Das folgende Codebeispiel zeigt die Verwendung`describe-stacks`. **AWS CLI** **Um AWS CloudFormation Stapel zu beschreiben** Der folgende `describe-stacks`-Befehl zeigt eine Zusammenfassung der Informationen für den `myteststack`-Stack: ``` aws cloudformation describe-stacks --stack-name myteststack ``` Ausgabe: ``` { "Stacks": [ { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Tags": [], "Outputs": [ { "Description": "Name of S3 bucket to hold website content", "OutputKey": "BucketName", "OutputValue": "myteststack-s3bucket-jssofi1zie2w" } ], "StackStatusReason": null, "CreationTime": "2013-08-23T01:02:15.422Z", "Capabilities": [], "StackName": "myteststack", "StackStatus": "CREATE_COMPLETE", "DisableRollback": false } ] } ``` Weitere Informationen finden Sie unter Stacks im *AWS CloudFormation Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeStacks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stacks.html)in der *AWS CLI Befehlsreferenz.* ### `describe-type-registration` Das folgende Codebeispiel zeigt die Verwendung`describe-type-registration`. **AWS CLI** **So zeigen Sie Informationen zur Typregistrierung an** Im folgenden Beispiel für `describe-type-registration` werden Informationen zur angegebenen Typregistrierung angezeigt, einschließlich des aktuellen Status, des Typs und der Version des Typs. ``` aws cloudformation describe-type-registration \ --registration-token a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "ProgressStatus": "COMPLETE", "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup", "Description": "Deployment is currently in DEPLOY_STAGE of status COMPLETED; ", "TypeVersionArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup/00000001" } ``` Weitere Informationen finden Sie unter [Using the CloudFormation Registry](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) im *AWS CloudFormation Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeTypeRegistration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-type-registration.html)unter *AWS CLI Befehlsreferenz*. ### `describe-type` Das folgende Codebeispiel zeigt die Verwendung`describe-type`. **AWS CLI** **So zeigen Sie Typinformationen an** Im folgenden Beispiel für `describe-type` werden Informationen für den angegebenen Typ angezeigt. ``` aws cloudformation describe-type \ --type-name My::Logs::LogGroup \ --type RESOURCE ``` Ausgabe: ``` { "SourceUrl": "https://github.com/aws-cloudformation/aws-cloudformation-resource-providers-logs.git", "Description": "Customized resource derived from AWS::Logs::LogGroup", "TimeCreated": "2019-12-03T23:29:33.321Z", "Visibility": "PRIVATE", "TypeName": "My::Logs::LogGroup", "LastUpdated": "2019-12-03T23:29:33.321Z", "DeprecatedStatus": "LIVE", "ProvisioningType": "FULLY_MUTABLE", "Type": "RESOURCE", "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup/00000001", "Schema": "[details omitted]" } ``` Weitere Informationen finden Sie unter [Using the CloudFormation Registry](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) im *AWS CloudFormation Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-type.html)unter *AWS CLI Befehlsreferenz*. ### `detect-stack-drift` Das folgende Codebeispiel zeigt die Verwendung`detect-stack-drift`. **AWS CLI** **So erkennen Sie abweichende Ressourcen** Im folgenden Beispiel für `detect-stack-drift` wird die Abweichungserkennung für den angegebenen Stack initiiert. ``` aws cloudformation detect-stack-drift \ --stack-name my-stack ``` Ausgabe: ``` { "StackDriftDetectionId": "1a229160-e4d9-xmpl-ab67-0a4f93df83d4" } ``` Sie können diese ID dann zusammen mit dem Befehl `describe-stack-resource-drifts` verwenden, um abweichende Ressourcen zu beschreiben. + Einzelheiten zur API finden Sie [DetectStackDrift](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/detect-stack-drift.html)in der *AWS CLI Befehlsreferenz*. ### `detect-stack-resource-drift` Das folgende Codebeispiel zeigt die Verwendung`detect-stack-resource-drift`. **AWS CLI** **So erkennen Sie eine Abweichung für eine Ressource** Im folgenden Beispiel für `detect-stack-resource-drift` wird eine Ressource mit dem Namen `MyFunction` in einem Stack mit dem Namen `MyStack` auf Abweichungen überprüft: ``` aws cloudformation detect-stack-resource-drift \ --stack-name MyStack \ --logical-resource-id MyFunction ``` Die Ausgabe zeigt eine AWS Lambda-Funktion, die geändert wurde: out-of-band ``` { "StackResourceDrift": { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/MyStack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "MyFunction", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "ExpectedProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":128,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":900,\"TracingConfig\":{\"Mode\":\"Active\"}}", "ActualProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":256,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":22,\"TracingConfig\":{\"Mode\":\"Active\"}}", "PropertyDifferences": [ { "PropertyPath": "/MemorySize", "ExpectedValue": "128", "ActualValue": "256", "DifferenceType": "NOT_EQUAL" }, { "PropertyPath": "/Timeout", "ExpectedValue": "900", "ActualValue": "22", "DifferenceType": "NOT_EQUAL" } ], "StackResourceDriftStatus": "MODIFIED", "Timestamp": "2019-10-02T05:58:47.433Z" } } ``` + Einzelheiten zur API finden Sie [DetectStackResourceDrift](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/detect-stack-resource-drift.html)in der *AWS CLI Befehlsreferenz.* ### `detect-stack-set-drift` Das folgende Codebeispiel zeigt die Verwendung`detect-stack-set-drift`. **AWS CLI** **So erkennen Sie eine Abweichung in einem Stack-Satz und allen zugehörigen Stack-Instances** Im folgenden Beispiel für `detect-stack-set-drift` werden Operationen zur Abweichungserkennung für den angegebenen Stack-Satz initiiert, einschließlich aller diesem Stack-Satz zugeordneter Stack-Instances. Außerdem wird eine Operations-ID zurückgegeben, mit der der Status der Abweichungsoperation verfolgt werden kann. ``` aws cloudformation detect-stack-set-drift \ --stack-set-name stack-set-drift-example ``` Ausgabe: ``` { "OperationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` Weitere Informationen finden Sie unter [Erkennen nicht verwalteter Konfigurationsänderungen in Stacksets](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-drift.html) im *AWS CloudFormation Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DetectStackSetDrift](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/detect-stack-set-drift.html)in der *AWS CLI Befehlsreferenz.* ### `estimate-template-cost` Das folgende Codebeispiel zeigt die Verwendung`estimate-template-cost`. **AWS CLI** **So schätzen Sie die Kosten für eine Vorlage ein** Im folgenden Beispiel für `estimate-template-cost` wird eine Kostenschätzung für eine Vorlage mit dem Namen `template.yaml` im aktuellen Ordner erstellt. ``` aws cloudformation estimate-template-cost \ --template-body file://template.yaml ``` Ausgabe: ``` { "Url": "http://calculator.s3.amazonaws.com/calc5.html?key=cloudformation/7870825a-xmpl-4def-92e7-c4f8dd360cca" } ``` + Einzelheiten zur API finden Sie [EstimateTemplateCost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/estimate-template-cost.html)in der *AWS CLI Befehlsreferenz*. ### `execute-change-set` Das folgende Codebeispiel zeigt die Verwendung`execute-change-set`. **AWS CLI** **Um einen Änderungssatz auszuführen** Im folgenden Beispiel für `execute-change-set` wird ein Änderungssatz ausgeführt, der durch den Namen des Änderungssatzes und den Namen des Stacks angegeben wird. ``` aws cloudformation execute-change-set \ --change-set-name my-change-set \ --stack-name my-stack ``` Im folgenden Beispiel für `execute-change-set` wird ein Änderungssatz ausgeführt, der durch den vollständigen ARN des Änderungssatzes angegeben wird. ``` aws cloudformation execute-change-set \ --change-set-name arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784 ``` + Einzelheiten zur API finden Sie [ExecuteChangeSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/execute-change-set.html)in der *AWS CLI Befehlsreferenz*. ### `execute-stack-refactor` Das folgende Codebeispiel zeigt die Verwendung`execute-stack-refactor`. **AWS CLI** **Um einen Stack-Refactoring-Vorgang abzuschließen** Im folgenden `execute-stack-refactor` Beispiel wird der Stack-Refactor-Vorgang mit der angegebenen Stack-Refactor-ID abgeschlossen. ``` aws cloudformation execute-stack-refactor \ --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. *Weitere Informationen finden Sie unter [Stack-Refactoring im Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-refactoring.html).AWS CloudFormation * + Einzelheiten zur API finden Sie [ExecuteStackRefactor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/execute-stack-refactor.html)in der *AWS CLI Befehlsreferenz*. ### `get-stack-policy` Das folgende Codebeispiel zeigt die Verwendung`get-stack-policy`. **AWS CLI** **So zeigen Sie eine Stack-Richtlinie an** Im folgenden Beispiel für `get-stack-policy` wird die Stack-Richtlinie für den angegebenen Stack angezeigt. Verwenden Sie den `set-stack-policy`-Befehl, um eine Richtlinie einem Stack anzufügen. ``` aws cloudformation get-stack-policy \ --stack-name my-stack ``` Ausgabe: ``` { "StackPolicyBody": "{\n \"Statement\" : [\n {\n \"Effect\" : \"Allow\",\n \"Action\" : \"Update:*\",\n \"Principal\": \"*\",\n \"Resource\" : \"*\"\n },\n {\n \"Effect\" : \"Deny\",\n \"Action\" : \"Update:*\",\n \"Principal\": \"*\",\n \"Resource\" : \"LogicalResourceId/bucket\"\n }\n ]\n}\n" } ``` + Einzelheiten zur API finden Sie [GetStackPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/get-stack-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-template-summary` Das folgende Codebeispiel zeigt die Verwendung`get-template-summary`. **AWS CLI** **So zeigen Sie eine Vorlagenzusammenfassung an** Mit dem folgenden Befehl werden zusammenfassende Informationen über die Ressourcen und Metadaten für die angegebene Vorlagendatei angezeigt. ``` aws cloudformation get-template-summary \ --template-body file://template.yaml ``` Ausgabe: ``` { "Parameters": [], "Description": "A VPC and subnets.", "ResourceTypes": [ "AWS::EC2::VPC", "AWS::EC2::Subnet", "AWS::EC2::Subnet", "AWS::EC2::RouteTable", "AWS::EC2::VPCEndpoint", "AWS::EC2::SubnetRouteTableAssociation", "AWS::EC2::SubnetRouteTableAssociation", "AWS::EC2::VPCEndpoint" ], "Version": "2010-09-09" } ``` + Einzelheiten zur API finden Sie [GetTemplateSummary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/get-template-summary.html)in der *AWS CLI Befehlsreferenz*. ### `get-template` Das folgende Codebeispiel zeigt die Verwendung`get-template`. **AWS CLI** **Um den Vorlagentext für einen AWS CloudFormation Stapel anzuzeigen** Der folgende Befehl `get-template` zeigt die Vorlage für den Stapel `myteststack` : ``` aws cloudformation get-template --stack-name myteststack ``` Ausgabe: ``` { "TemplateBody": { "AWSTemplateFormatVersion": "2010-09-09", "Outputs": { "BucketName": { "Description": "Name of S3 bucket to hold website content", "Value": { "Ref": "S3Bucket" } } }, "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Resources": { "S3Bucket": { "Type": "AWS::S3::Bucket", "Properties": { "AccessControl": "PublicRead" } } } } } ``` + Einzelheiten zur API finden Sie [GetTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/get-template.html)in der *AWS CLI Befehlsreferenz*. ### `list-change-sets` Das folgende Codebeispiel zeigt die Verwendung`list-change-sets`. **AWS CLI** **So listen Sie Änderungssätze auf** Im folgenden Beispiel für `list-change-sets` wird eine Liste der ausstehenden Änderungssätze für den angegebenen Stack angezeigt. ``` aws cloudformation list-change-sets \ --stack-name my-stack ``` Ausgabe: ``` { "Summaries": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "StackName": "my-stack", "ChangeSetId": "arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/70160340-7914-xmpl-bcbf-128a1fa78b5d", "ChangeSetName": "my-change-set", "ExecutionStatus": "AVAILABLE", "Status": "CREATE_COMPLETE", "CreationTime": "2019-10-02T05:38:54.297Z" } ] } ``` + Einzelheiten zur API finden Sie [ListChangeSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-change-sets.html)in der *AWS CLI Befehlsreferenz*. ### `list-exports` Das folgende Codebeispiel zeigt die Verwendung`list-exports`. **AWS CLI** **So listen Sie Exporte auf** Im folgenden Beispiel für `list-exports` wird eine Liste der Exporte aus Stacks in der aktuellen Region angezeigt. ``` aws cloudformation list-exports ``` Ausgabe: ``` { "Exports": [ { "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800", "Name": "private-vpc-subnet-a", "Value": "subnet-07b410xmplddcfa03" }, { "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800", "Name": "private-vpc-subnet-b", "Value": "subnet-075ed3xmplebd2fb1" }, { "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800", "Name": "private-vpc-vpcid", "Value": "vpc-011d7xmpl100e9841" } ] } ``` + Einzelheiten zur API finden Sie [ListExports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-exports.html)in der *AWS CLI Befehlsreferenz*. ### `list-generated-templates` Das folgende Codebeispiel zeigt die Verwendung`list-generated-templates`. **AWS CLI** **Um generierte Vorlagen aufzulisten** Das folgende `list-generated-templates` Beispiel listet alle generierten Vorlagen auf. ``` aws cloudformation list-generated-templates ``` Ausgabe: ``` { "Summaries": [ { "GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/7fc8512c-d8cb-4e02-b266-d39c48344e48", "GeneratedTemplateName": "MyTemplate", "Status": "COMPLETE", "StatusReason": "All resources complete", "CreationTime": "2025-09-23T20:13:24.283000+00:00", "LastUpdatedTime": "2025-09-23T20:13:28.610000+00:00", "NumberOfResources": 4 }, { "GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedTemplate/f10dd1c4-edc6-4823-8153-ab6112b8d051", "GeneratedTemplateName": "MyEC2InstanceTemplate", "Status": "COMPLETE", "StatusReason": "All resources complete", "CreationTime": "2024-08-08T19:35:49.790000+00:00", "LastUpdatedTime": "2024-08-08T19:35:52.207000+00:00", "NumberOfResources": 3 }, { "GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedTemplate/e5a1c89f-7ce2-41bd-9bdf-75b7c852e3ca", "GeneratedTemplateName": "MyEKSNodeGroupTemplate", "Status": "COMPLETE", "StatusReason": "All resources complete", "CreationTime": "2024-07-16T20:39:27.883000+00:00", "LastUpdatedTime": "2024-07-16T20:39:35.766000+00:00", "NumberOfResources": 4 } ] } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [Generieren von Vorlagen aus vorhandenen Ressourcen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC.html). + Einzelheiten zur API finden Sie [ListGeneratedTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-generated-templates.html)in der *AWS CLI Befehlsreferenz*. ### `list-imports` Das folgende Codebeispiel zeigt die Verwendung`list-imports`. **AWS CLI** **So listen Sie Importe auf** Im folgenden Beispiel für `list-imports` werden die Stacks aufgelistet, die den angegebenen Export importieren. Verwenden Sie den Befehl `list-exports`, um die Liste der verfügbaren Exporte abzurufen. ``` aws cloudformation list-imports \ --export-name private-vpc-vpcid ``` Ausgabe: ``` { "Imports": [ "my-database-stack" ] } ``` + Einzelheiten zur API finden Sie [ListImports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-imports.html)in der *AWS CLI Befehlsreferenz*. ### `list-resource-scan-related-resources` Das folgende Codebeispiel zeigt die Verwendung`list-resource-scan-related-resources`. **AWS CLI** **Um verwandte Ressourcen aus einem Ressourcenscan aufzulisten** Im folgenden `list-resource-scan-related-resources` Beispiel werden Ressourcen aus dem angegebenen Ressourcenscan aufgeführt, die sich auf Ressourcen in beziehen`resources.json`. ``` aws cloudformation list-resource-scan-related-resources \ --resource-scan-id arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60 \ --resources file://resources.json ``` Inhalt von `resources.json`: ``` [ { "ResourceType": "AWS::EKS::Cluster", "ResourceIdentifier": { "ClusterName": "MyAppClusterName" } }, { "ResourceType": "AWS::AutoScaling::AutoScalingGroup", "ResourceIdentifier": { "AutoScalingGroupName": "MyAppASGName" } } ] ``` Ausgabe: ``` { "RelatedResources": [ { "ResourceType": "AWS::EKS::Nodegroup", "ResourceIdentifier": { "NodegroupName": "MyAppNodegroupName" }, "ManagedByStack": false }, { "ResourceType": "AWS::IAM::Role", "ResourceIdentifier": { "RoleId": "arn:aws::iam::123456789012:role/MyAppIAMRole" }, "ManagedByStack": false } ] } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [Erstellen einer CloudFormation Vorlage aus Ressourcen, die mit dem IaC-Generator gescannt](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/iac-generator-create-template-from-scanned-resources.html) wurden. + Einzelheiten zur API finden Sie unter [ListResourceScanRelatedResources AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-resource-scan-related-resources.html)*Befehlsreferenz.* ### `list-resource-scan-resources` Das folgende Codebeispiel zeigt die Verwendung`list-resource-scan-resources`. **AWS CLI** **Um Ressourcen aus einem Ressourcenscan aufzulisten** Das folgende `list-resource-scan-resources` Beispiel listet Ressourcen aus dem angegebenen Ressourcenscan auf, gefiltert nach der Ressourcen-ID. ``` aws cloudformation list-resource-scan-resources \ --resource-scan-id arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60 \ --resource-identifier MyApp ``` Ausgabe: ``` { "Resources": [ { "ResourceType": "AWS::EKS::Cluster", "ResourceIdentifier": { "ClusterName": "MyAppClusterName" }, "ManagedByStack": false }, { "ResourceType": "AWS::AutoScaling::AutoScalingGroup", "ResourceIdentifier": { "AutoScalingGroupName": "MyAppASGName" }, "ManagedByStack": false } ] } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [Erstellen einer CloudFormation Vorlage aus Ressourcen, die mit dem IaC-Generator gescannt](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/iac-generator-create-template-from-scanned-resources.html) wurden. + Einzelheiten zur API finden Sie unter [ListResourceScanResources AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-resource-scan-resources.html)*Befehlsreferenz.* ### `list-stack-instances` Das folgende Codebeispiel zeigt die Verwendung`list-stack-instances`. **AWS CLI** **So listen Sie Instances für einen Stack auf** Im folgenden Beispiel für `list-stack-instances` werden die Instances aufgelistet, die aus dem angegebenen Stack-Satz erstellt wurden. ``` aws cloudformation list-stack-instances \ --stack-set-name enable-config ``` Die Beispielausgabe enthält Details zu einem Stack, der aufgrund eines Fehlers nicht aktualisiert werden konnte: ``` { "Summaries": [ { "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Region": "us-west-2", "Account": "123456789012", "StackId": "arn:aws:cloudformation:ap-northeast-1:123456789012:stack/StackSet-enable-config-35a6ac50-d9f8-4084-86e4-7da34d5de4c4/a1631cd0-e5fb-xmpl-b474-0aa20f14f06e", "Status": "CURRENT" }, { "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Region": "us-west-2", "Account": "123456789012", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/StackSet-enable-config-e6cac20f-xmpl-46e9-8314-53e0d4591532/eab53680-e5fa-xmpl-ba14-0a522351f81e", "Status": "OUTDATED", "StatusReason": "ResourceLogicalId:ConfigDeliveryChannel, ResourceType:AWS::Config::DeliveryChannel, ResourceStatusReason:Failed to put delivery channel 'StackSet-enable-config-e6cac20f-xmpl-46e9-8314-53e0d4591532-ConfigDeliveryChannel-1OJWJ7XD59WR0' because the maximum number of delivery channels: 1 is reached. (Service: AmazonConfig; Status Code: 400; Error Code: MaxNumberOfDeliveryChannelsExceededException; Request ID: d14b34a0-ef7c-xmpl-acf8-8a864370ae56)." } ] } ``` + Einzelheiten zur API finden Sie [ListStackInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-instances.html)in der *AWS CLI Befehlsreferenz*. ### `list-stack-refactor-actions` Das folgende Codebeispiel zeigt die Verwendung`list-stack-refactor-actions`. **AWS CLI** **Um Aktionen für einen Stack-Refactoring-Vorgang aufzulisten** Das folgende `list-stack-refactor-actions` Beispiel listet Aktionen für den Stack-Refactoring-Vorgang mit der angegebenen Stack-Refactor-ID auf. ``` aws cloudformation list-stack-refactor-actions \ --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841 ``` Ausgabe: ``` { "StackRefactorActions": [ { "Action": "MOVE", "Entity": "RESOURCE", "PhysicalResourceId": "MyTestLambdaRole", "Description": "No configuration changes detected.", "Detection": "AUTO", "TagResources": [], "UntagResources": [], "ResourceMapping": { "Source": { "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf", "LogicalResourceId": "MyLambdaRole" }, "Destination": { "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b", "LogicalResourceId": "MyLambdaRole" } } }, { "Action": "MOVE", "Entity": "RESOURCE", "PhysicalResourceId": "MyTestFunction", "Description": "Resource configuration changes will be validated during refactor execution.", "Detection": "AUTO", "TagResources": [ { "Key": "aws:cloudformation:stack-name", "Value": "Stack2" }, { "Key": "aws:cloudformation:logical-id", "Value": "MyFunction" }, { "Key": "aws:cloudformation:stack-id", "Value": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b" } ], "UntagResources": [ "aws:cloudformation:stack-name", "aws:cloudformation:logical-id", "aws:cloudformation:stack-id" ], "ResourceMapping": { "Source": { "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf", "LogicalResourceId": "MyFunction" }, "Destination": { "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b", "LogicalResourceId": "MyFunction" } } } ] } ``` *Weitere Informationen finden Sie unter [Stack-Refactoring im Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-refactoring.html).AWS CloudFormation * + Einzelheiten zur API finden Sie [ListStackRefactorActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-refactor-actions.html)in der *AWS CLI Befehlsreferenz*. ### `list-stack-resources` Das folgende Codebeispiel zeigt die Verwendung`list-stack-resources`. **AWS CLI** **So listen Sie Ressourcen in einem Stack auf** Der folgende Befehl zeigt die Liste der Ressourcen im angegebenen Stapel an. ``` aws cloudformation list-stack-resources \ --stack-name my-stack ``` Ausgabe: ``` { "StackResourceSummaries": [ { "LogicalResourceId": "bucket", "PhysicalResourceId": "my-stack-bucket-1vc62xmplgguf", "ResourceType": "AWS::S3::Bucket", "LastUpdatedTimestamp": "2019-10-02T04:34:11.345Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "LastUpdatedTimestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "LogicalResourceId": "functionRole", "PhysicalResourceId": "my-functionRole-HIZXMPLEOM9E", "ResourceType": "AWS::IAM::Role", "LastUpdatedTimestamp": "2019-10-02T04:34:06.350Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } ] } ``` + Einzelheiten zur API finden Sie [ListStackResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-resources.html)in der *AWS CLI Befehlsreferenz*. ### `list-stack-set-operation-results` Das folgende Codebeispiel zeigt die Verwendung`list-stack-set-operation-results`. **AWS CLI** **So listen Sie die Ergebnisse von Stack-Satz-Operationen auf** Mit dem folgenden Befehl werden die Ergebnisse einer Aktualisierungsoperation für Instances im angegebenen Stack-Satz angezeigt. ``` aws cloudformation list-stack-set-operation-results \ --stack-set-name enable-config \ --operation-id 35d45ebc-ed88-xmpl-ab59-0197a1fc83a0 ``` Ausgabe: ``` { "Summaries": [ { "Account": "223456789012", "Region": "us-west-2", "Status": "SUCCEEDED", "AccountGateResult": { "Status": "SKIPPED", "StatusReason": "Function not found: arn:aws:lambda:eu-west-1:223456789012:function:AWSCloudFormationStackSetAccountGate" } }, { "Account": "223456789012", "Region": "ap-south-1", "Status": "CANCELLED", "StatusReason": "Cancelled since failure tolerance has exceeded" } ] } ``` **Hinweis:** Der Status `SKIPPED` für `AccountGateResult` wird für erfolgreiche Operationen erwartet, sofern Sie keine Konto-Gate-Funktion erstellen. + Einzelheiten zur API finden Sie [ListStackSetOperationResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-set-operation-results.html)in der *AWS CLI Befehlsreferenz*. ### `list-stack-set-operations` Das folgende Codebeispiel zeigt die Verwendung`list-stack-set-operations`. **AWS CLI** **So listen Sie Stack-Satz-Operationen auf** Im folgenden Beispiel für `list-stack-set-operations` wird die Liste der letzten Operationen im angegebenen Stack-Satz angezeigt. ``` aws cloudformation list-stack-set-operations \ --stack-set-name my-stack-set ``` Ausgabe: ``` { "Summaries": [ { "OperationId": "35d45ebc-ed88-xmpl-ab59-0197a1fc83a0", "Action": "UPDATE", "Status": "SUCCEEDED", "CreationTimestamp": "2019-10-03T16:28:44.377Z", "EndTimestamp": "2019-10-03T16:42:08.607Z" }, { "OperationId": "891aa98f-7118-xmpl-00b2-00954d1dd0d6", "Action": "UPDATE", "Status": "FAILED", "CreationTimestamp": "2019-10-03T15:43:53.916Z", "EndTimestamp": "2019-10-03T15:45:58.925Z" } ] } ``` + Einzelheiten zur API finden Sie [ListStackSetOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-set-operations.html)in der *AWS CLI Befehlsreferenz*. ### `list-stack-sets` Das folgende Codebeispiel zeigt die Verwendung`list-stack-sets`. **AWS CLI** **So listen Sie Stack-Sätze auf** Im folgenden Beispiel für `list-stack-sets` wird die Liste der Stack-Sätze in der aktuellen Region und im aktuellen Konto angezeigt. ``` aws cloudformation list-stack-sets ``` Ausgabe: ``` { "Summaries": [ { "StackSetName": "enable-config", "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Description": "Enable AWS Config", "Status": "ACTIVE" } ] } ``` + Einzelheiten zur API finden Sie [ListStackSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-sets.html)in der *AWS CLI Befehlsreferenz*. ### `list-stacks` Das folgende Codebeispiel zeigt die Verwendung`list-stacks`. **AWS CLI** **Um AWS CloudFormation Stapel aufzulisten** Der folgende `list-stacks`-Befehl zeigt eine Zusammenfassung aller Stack an, die den Status `CREATE_COMPLETE`haben: ``` aws cloudformation list-stacks --stack-status-filter CREATE_COMPLETE ``` Ausgabe: ``` [ { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "TemplateDescription": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "StackStatusReason": null, "CreationTime": "2013-08-26T03:27:10.190Z", "StackName": "myteststack", "StackStatus": "CREATE_COMPLETE" } ] ``` + Einzelheiten zur API finden Sie [ListStacks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stacks.html)in der *AWS CLI Befehlsreferenz.* ### `list-type-registrations` Das folgende Codebeispiel zeigt die Verwendung`list-type-registrations`. **AWS CLI** **So listen Sie die abgeschlossenen Registrierungen eines Typs auf** Im folgenden Beispiel für `list-type-registrations` wird eine Liste der abgeschlossenen Typregistrierungen für den angegebenen Typ angezeigt. ``` aws cloudformation list-type-registrations \ --type RESOURCE \ --type-name My::Logs::LogGroup \ --registration-status-filter COMPLETE ``` Ausgabe: ``` { "RegistrationTokenList": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333" ] } ``` Weitere Informationen finden Sie unter [Using the CloudFormation Registry](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) im *AWS CloudFormation Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTypeRegistrations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-type-registrations.html)unter *AWS CLI Befehlsreferenz*. ### `list-type-versions` Das folgende Codebeispiel zeigt die Verwendung`list-type-versions`. **AWS CLI** **So listen Sie die Version einer Erweiterung auf** Im folgenden Beispiel für `list-type-versions` werden zusammenfassende Informationen zu den Versionen einer Erweiterung zurückgegeben. ``` aws cloudformation list-type-versions \ --endpoint https://example.com \ --region us-west-2 \ --type RESOURCE \ --type-name My::Resource::Example \ --publisher-id 123456789012 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der AWS CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [ListTypeVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-type-versions.html)unter *AWS CLI Befehlsreferenz*. ### `list-types` Das folgende Codebeispiel zeigt die Verwendung`list-types`. **AWS CLI** **So listen Sie die privaten Ressourcentypen in einem Konto auf** Im folgenden `list-types` Beispiel wird eine Liste der privaten Ressourcentypen angezeigt, die derzeit im aktuellen AWS Konto registriert sind. ``` aws cloudformation list-types ``` Ausgabe: ``` { "TypeSummaries": [ { "Description": "WordPress blog resource for internal use", "LastUpdated": "2019-12-04T18:28:15.059Z", "TypeName": "My::WordPress::BlogExample", "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-WordPress-BlogExample", "DefaultVersionId": "00000005", "Type": "RESOURCE" }, { "Description": "Customized resource derived from AWS::Logs::LogGroup", "LastUpdated": "2019-12-04T18:28:15.059Z", "TypeName": "My::Logs::LogGroup", "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup", "DefaultVersionId": "00000003", "Type": "RESOURCE" } ] } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [ListTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-types.html)unter *AWS CLI Befehlsreferenz*. ### `package` Das folgende Codebeispiel zeigt die Verwendung`package`. **AWS CLI** Mit dem folgenden Befehl wird eine Vorlage namens `template.json` exportiert, indem lokale Artefakte in den S3-Bucket `bucket-name` hochgeladen werden und die exportierte Vorlage in `packaged-template.json` geschrieben wird: ``` aws cloudformation package --template-file /path_to_template/template.json --s3-bucket bucket-name --output-template-file packaged-template.json --use-json ``` + Weitere API-Informationen finden Sie unter [Package](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/package.html) in der *AWS CLI -Befehlsreferenz*. ### `publish-type` Das folgende Codebeispiel zeigt die Verwendung`publish-type`. **AWS CLI** **So veröffentlichen Sie eine Erweiterung** Im folgenden `publish-type` Beispiel wird die angegebene Erweiterung in der CloudFormation Registrierung als öffentliche Erweiterung in dieser Region veröffentlicht. ``` aws cloudformation publish-type \ --region us-west-2 \ --type RESOURCE \ --type-name Example::Test::1234567890abcdef0 ``` Ausgabe: ``` { "PublicTypeArn":"arn:aws:cloudformation:us-west-2::type/resource/000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c/Example-Test-1234567890abcdef0/1.0.0" } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der AWS CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [PublishType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/publish-type.html)unter *AWS CLI Befehlsreferenz*. ### `register-publisher` Das folgende Codebeispiel zeigt die Verwendung`register-publisher`. **AWS CLI** **So registrieren Sie einen Publisher** Im folgenden Beispiel für `register-publisher` wird ein Publisher registriert und der Parameter „terms and condition“ akzeptiert. ``` aws cloudformation register-publisher \ --region us-west-2 \ --accept-terms-and-conditions ``` Ausgabe: ``` { "PublisherId": "000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c" } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der AWS CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [RegisterPublisher](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/register-publisher.html)unter *AWS CLI Befehlsreferenz*. ### `register-type` Das folgende Codebeispiel zeigt die Verwendung`register-type`. **AWS CLI** **Um einen Ressourcentyp zu registrieren** Im folgenden Beispiel für `register-type` wird der angegebene Ressourcentyp als privater Ressourcentyp im Benutzerkonto registriert. ``` aws cloudformation register-type \ --type-name My::Organization::ResourceName \ --schema-handler-package s3://bucket_name/my-organization-resource_name.zip \ --type RESOURCE ``` Ausgabe: ``` { "RegistrationToken": "f5525280-104e-4d35-bef5-8f1f1example" } ``` Weitere Informationen finden Sie unter [Registrierung von Ressourcenanbietern](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-register.html) im *Benutzerhandbuch für die CloudFormation Befehlszeilenschnittstelle für die Typentwicklung*. + Einzelheiten zur API finden Sie [RegisterType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/register-type.html)unter *AWS CLI Befehlsreferenz*. ### `set-stack-policy` Das folgende Codebeispiel zeigt die Verwendung`set-stack-policy`. **AWS CLI** **So wenden Sie eine Stack-Richtlinie an** Im folgenden Beispiel für `set-stack-policy` werden Aktualisierungen für die angegebene Ressource im spezifizierten Stack aktualisiert. `stack-policy.json` ist ein JSON-Dokument, in dem die Operationen definiert werden, die für Ressourcen im Stack zulässig sind. ``` aws cloudformation set-stack-policy \ --stack-name my-stack \ --stack-policy-body file://stack-policy.json ``` Ausgabe: ``` { "Statement" : [ { "Effect" : "Allow", "Action" : "Update:*", "Principal": "*", "Resource" : "*" }, { "Effect" : "Deny", "Action" : "Update:*", "Principal": "*", "Resource" : "LogicalResourceId/bucket" } ] } ``` + Einzelheiten zur API finden Sie [SetStackPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/set-stack-policy.html)in der *AWS CLI Befehlsreferenz*. ### `set-type-configuration` Das folgende Codebeispiel zeigt die Verwendung`set-type-configuration`. **AWS CLI** **So konfigurieren Sie Daten** Im folgenden `set-type-configuration` Beispiel werden die Konfigurationsdaten für eine registrierte CloudFormation Erweiterung im angegebenen Konto und in der angegebenen Region angegeben. ``` aws cloudformation set-type-configuration \ --region us-west-2 \ --type RESOURCE \ --type-name Example::Test::Type \ --configuration-alias default \ --configuration "{\"CredentialKey\": \"testUserCredential\"}" ``` Ausgabe: ``` { "ConfigurationArn": "arn:aws:cloudformation:us-west-2:123456789012:type-configuration/resource/Example-Test-Type/default" } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der AWS CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [SetTypeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/set-type-configuration.html)unter *AWS CLI Befehlsreferenz*. ### `set-type-default-version` Das folgende Codebeispiel zeigt die Verwendung`set-type-default-version`. **AWS CLI** **So legen Sie die Standardversion eines Typs fest** Im folgenden Beispiel für `set-type-default-version` wird die angegebene Typversion festgelegt, die als Standard für diesen Typ verwendet werden soll. ``` aws cloudformation set-type-default-version \ --type RESOURCE \ --type-name My::Logs::LogGroup \ --version-id 00000003 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Using the CloudFormation Registry](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) im *AWS CloudFormation Benutzerhandbuch*. + Einzelheiten zur API finden Sie [SetTypeDefaultVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/set-type-default-version.html)unter *AWS CLI Befehlsreferenz*. ### `signal-resource` Das folgende Codebeispiel zeigt die Verwendung`signal-resource`. **AWS CLI** **So signalisieren Sie eine Ressource** Im folgenden Beispiel für `signal-resource` wird `success` signalisiert, die Wartebedingung mit dem Namen `MyWaitCondition` im Stack mit dem Namen `my-stack` zu erfüllen. ``` aws cloudformation signal-resource \ --stack-name my-stack \ --logical-resource-id MyWaitCondition \ --unique-id 1234 \ --status SUCCESS ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [SignalResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/signal-resource.html)in der *AWS CLI Befehlsreferenz*. ### `start-resource-scan` Das folgende Codebeispiel zeigt die Verwendung`start-resource-scan`. **AWS CLI** **Um einen Ressourcenscan zu starten** Im folgenden `start-resource-scan` Beispiel wird ein Ressourcenscan gestartet, bei dem alle vorhandenen Ressourcen im aktuellen Konto und in der Region gescannt werden. ``` aws cloudformation start-resource-scan ``` Ausgabe: ``` { "ResourceScanId": "arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60" } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [Starten eines Ressourcenscans mit dem CloudFormation IaC-Generator](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/iac-generator-start-resource-scan.html). + Einzelheiten zur API finden Sie unter [StartResourceScan AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/start-resource-scan.html)*Befehlsreferenz.* ### `stop-stack-set-operation` Das folgende Codebeispiel zeigt die Verwendung`stop-stack-set-operation`. **AWS CLI** **So beenden Sie eine Stack-Satz-Operation** Im folgenden Beispiel für `stop-stack-set-operation` wird eine laufende Aktualisierungsoperation für den angegebene Stack-Satz beendet. ``` aws cloudformation stop-stack-set-operation \ --stack-set-name my-stack-set \ --operation-id 1261cd27-490b-xmpl-ab42-793a896c69e6 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [StopStackSetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/stop-stack-set-operation.html)in der *AWS CLI Befehlsreferenz*. ### `test-type` Das folgende Codebeispiel zeigt die Verwendung`test-type`. **AWS CLI** **So testen Sie eine Erweiterung** Im folgenden `test-type` Beispiel wird eine registrierte Erweiterung getestet, um sicherzustellen, dass sie alle erforderlichen Anforderungen für die Veröffentlichung in der CloudFormation Registrierung erfüllt. ``` aws cloudformation test-type \ --arn arn:aws:cloudformation:us-west-2:123456789012:type/resource/Sample-Test-Resource123/00000001 ``` Ausgabe: ``` { "TypeVersionArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Sample-Test-Resource123/00000001" } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* [unter Verwenden der AWS CloudFormation Registrierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html). + Einzelheiten zur API finden Sie [TestType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/test-type.html)unter *AWS CLI Befehlsreferenz*. ### `update-stack-instances` Das folgende Codebeispiel zeigt die Verwendung`update-stack-instances`. **AWS CLI** **So erstellen Sie Stack-Instances** Im folgenden Beispiel für `update-stack-instances` wird erneut versucht, Stack-Instances in zwei Konten in zwei Regionen mit den neuesten Einstellungen zu aktualisieren. Die angegebene Einstellung für die Fehlertoleranz stellt sicher, dass die Aktualisierung in allen Konten und Regionen versucht wird, auch wenn einige Stacks nicht aktualisiert werden können. ``` aws cloudformation update-stack-instances \ --stack-set-name my-stack-set \ --accounts 123456789012 567890123456 \ --regions us-east-1 us-west-2 \ --operation-preferences FailureToleranceCount=3 ``` Ausgabe: ``` { "OperationId": "103ebdf2-21ea-xmpl-8892-de5e30733132" } ``` + Einzelheiten zur API finden Sie [UpdateStackInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/update-stack-instances.html)in der *AWS CLI Befehlsreferenz*. ### `update-stack-set` Das folgende Codebeispiel zeigt die Verwendung`update-stack-set`. **AWS CLI** **So aktualisieren Sie einen Stack-Satz** Im folgenden Beispiel für `update-stack-set` wird ein Tag mit dem Schlüsselnamen `Owner` und einem Wert von `IT` zu den Stack-Instances im angegebenen Stack-Satz hinzugefügt. ``` aws cloudformation update-stack-set \ --stack-set-name my-stack-set \ --use-previous-template \ --tags Key=Owner,Value=IT ``` Ausgabe: ``` { "OperationId": "e2b60321-6cab-xmpl-bde7-530c6f47950e" } ``` + Einzelheiten zur API finden Sie [UpdateStackSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/update-stack-set.html)in der *AWS CLI Befehlsreferenz*. ### `update-stack` Das folgende Codebeispiel zeigt die Verwendung`update-stack`. **AWS CLI** **Um AWS CloudFormation Stacks zu aktualisieren** Der folgende Befehl `update-stack` aktualisiert die Vorlage und die Eingabeparameter für den Stapel `mystack` : ``` aws cloudformation update-stack --stack-name mystack --template-url https://s3.amazonaws.com/sample/updated.template --parameters ParameterKey=KeyPairName,ParameterValue=SampleKeyPair ParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,SampleSubnetID2 ``` Der folgende Befehl `update-stack` aktualisiert nur den Wert des Parameters `SubnetIDs` für den Stapel `mystack` . Wenn Sie keinen Parameterwert angeben, wird der Standardwert verwendet, der in der Vorlage angegeben ist: ``` aws cloudformation update-stack --stack-name mystack --template-url https://s3.amazonaws.com/sample/updated.template --parameters ParameterKey=KeyPairName,UsePreviousValue=true ParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,UpdatedSampleSubnetID2 ``` Der folgende `update-stack`-Befehl fügt dem `mystack`-Stack zwei Themen für Stackbenachrichtigungen hinzu: ``` aws cloudformation update-stack --stack-name mystack --use-previous-template --notification-arns "arn:aws:sns:use-east-1:123456789012:mytopic1" "arn:aws:sns:us-east-1:123456789012:mytopic2" ``` Weitere Informationen finden Sie unter [AWS CloudFormation Stack-Updates](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks.html) im *AWS CloudFormation Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateStack](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/update-stack.html)in der *AWS CLI Befehlsreferenz*. ### `update-termination-protection` Das folgende Codebeispiel zeigt die Verwendung`update-termination-protection`. **AWS CLI** **So aktivieren Sie den Beendigungsschutz** Im folgenden Beispiel für `update-termination-protection` wird der Beendigungsschutz für den angegebenen Stack aktiviert. ``` aws cloudformation update-termination-protection \ --stack-name my-stack \ --enable-termination-protection ``` Ausgabe: ``` { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204" } ``` + Einzelheiten zur API finden Sie [UpdateTerminationProtection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/update-termination-protection.html)in der *AWS CLI Befehlsreferenz*. ### `validate-template` Das folgende Codebeispiel zeigt die Verwendung`validate-template`. **AWS CLI** **Um eine AWS CloudFormation Vorlage zu validieren** Der folgende Befehl `validate-template` validiert die Vorlage `sampletemplate.json` : ``` aws cloudformation validate-template --template-body file://sampletemplate.json ``` Ausgabe: ``` { "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Parameters": [], "Capabilities": [] } ``` Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter Arbeiten mit AWS CloudFormation Vorlagen. + Einzelheiten zur API finden Sie [ValidateTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/validate-template.html)in der *AWS CLI Befehlsreferenz*. # CloudFront Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CloudFront. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-distribution-tenant-web-acl` Das folgende Codebeispiel zeigt, wie Sie`associate-distribution-tenant-web-acl`. **AWS CLI** **Um eine Web-ACL einem CloudFront Distributionsmandanten zuzuordnen** Im folgenden `associate-distribution-tenant-web-acl` Beispiel wird eine Web-ACL einer CloudFront Distribution mit zugeordnet ETag `E13V1IB3VIYABC`. ``` aws cloudfront associate-distribution-tenant-web-acl \ --id dt_2wjDZi3hD1ivOXf6rpZJO1AB \ --if-match E13V1IB3VIYABC \ --web-acl-arn arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f37123ABC ``` Ausgabe: ``` { "ETag": "E1VC38T7YXBABC", "Id": "dt_2wjDZi3hD1ivOXf6rpZJO1AB", "WebACLArn": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f37123ABC" } ``` Weitere Informationen finden Sie unter [Verwenden AWS von WAF-Schutzmaßnahmen](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-awswaf.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [AssociateDistributionTenantWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/associate-distribution-tenant-web-acl.html)in der *AWS CLI Befehlsreferenz*. ### `associate-distribution-web-acl` Das folgende Codebeispiel zeigt die Verwendung`associate-distribution-web-acl`. **AWS CLI** **Um eine Web-ACL einer CloudFront Distribution zuzuordnen** Im folgenden `associate-distribution-web-acl` Beispiel wird eine Web-ACL einer CloudFront Distribution zugeordnet. ``` aws cloudfront associate-distribution-web-acl \ --id E1XNX8R2GOAABC \ --if-match E2YWS1C2J3OABC \ --web-acl-arn arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f3746cABC ``` Ausgabe: ``` { "ETag": "E3QE7ED60U0ABC", "Id": "E1XNX8R2GOAABC", "WebACLArn": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f3746cABC" } ``` Weitere Informationen finden Sie unter [Verwenden AWS von WAF-Schutzmaßnahmen](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-awswaf.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [AssociateDistributionWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/associate-distribution-web-acl.html)in der *AWS CLI Befehlsreferenz*. ### `create-cloud-front-origin-access-identity` Das folgende Codebeispiel zeigt die Verwendung`create-cloud-front-origin-access-identity`. **AWS CLI** **Um eine CloudFront ursprüngliche Zugriffsidentität zu erstellen** Im folgenden Beispiel wird eine CloudFront Origin-Zugriffsidentität (OAI) erstellt, indem die OAI-Konfiguration als Befehlszeilenargument bereitgestellt wird: ``` aws cloudfront create-cloud-front-origin-access-identity \ --cloud-front-origin-access-identity-config \ CallerReference="cli-example",Comment="Example OAI" ``` Sie können dasselbe erreichen, indem Sie die OAI-Konfiguration in einer JSON-Datei bereitstellen, wie im folgenden Beispiel gezeigt: ``` aws cloudfront create-cloud-front-origin-access-identity \ --cloud-front-origin-access-identity-config file://OAI-config.json ``` Die Datei `OAI-config.json` ist ein JSON-Dokument im aktuellen Verzeichnis, das Folgendes enthält: ``` { "CallerReference": "cli-example", "Comment": "Example OAI" } ``` Unabhängig davon, ob Sie die OAI-Konfiguration mit einem Befehlszeilenargument oder einer JSON-Datei angeben, ist die Ausgabe identisch: ``` { "Location": "https://cloudfront.amazonaws.com/2019-03-26/origin-access-identity/cloudfront/E74FTE3AEXAMPLE", "ETag": "E2QWRUHEXAMPLE", "CloudFrontOriginAccessIdentity": { "Id": "E74FTE3AEXAMPLE", "S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE", "CloudFrontOriginAccessIdentityConfig": { "CallerReference": "cli-example", "Comment": "Example OAI" } } } ``` + Einzelheiten zur API finden Sie [CreateCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-cloud-front-origin-access-identity.html)in der *AWS CLI Befehlsreferenz*. ### `create-connection-group` Das folgende Codebeispiel zeigt die Verwendung`create-connection-group`. **AWS CLI** **Um eine Verbindungsgruppe in zu erstellen CloudFront** Das folgende `create-connection-group` Beispiel erstellt eine aktivierte Verbindungsgruppe, gibt eine statische Anycast-IP-Liste an und deaktiviert sie IPv6. ``` aws cloudfront create-connection-group \ --name cg-with-anycast-ip-list \ --no-ipv6-enabled \ --enabled \ --anycast-ip-list-id aip_CCkW6gKrDiBD4n78123ABC \ --tags "Items=[{Key=abc,Value=123}]" ``` Ausgabe: ``` { "ETag": "E23ZP02F085ABC", "ConnectionGroup": { "Id": "cg_2yb6uj74B4PCbfhT31WFdiSABC", "Name": "cg-with-anycast-ip-list", "Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2yb6uj74B4PCbfhT31WFdiSABC", "CreatedTime": "2025-06-16T16:25:50.061000+00:00", "LastModifiedTime": "2025-06-16T16:25:50.061000+00:00", "Tags": { "Items": [ { "Key": "abc", "Value": "123" } ] }, "Ipv6Enabled": false, "RoutingEndpoint": "dj6xusxq65abc.cloudfront.net", "AnycastIpListId": "aip_CCkW6gKrDiBD4n78123ABC", "Status": "InProgress", "Enabled": true, "IsDefault": false } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Verbindungsgruppe erstellen (optional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [CreateConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-connection-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-distribution-tenant` Das folgende Codebeispiel zeigt die Verwendung`create-distribution-tenant`. **AWS CLI** **Beispiel 1: Um einen CloudFront Distributionsmandanten zu erstellen, der ein benutzerdefiniertes Zertifikat verwendet** Im folgenden `create-distribution-tenant` Beispiel wird ein CloudFront Verteilungsmandant erstellt, der Anpassungen zur Deaktivierung von WAF und zum Hinzufügen von Geoeinschränkungen festlegt und ein anderes TLS-Zertifikat verwendet. ``` aws cloudfront create-distribution-tenant \ --cli-input-json file://tenant.json ``` Inhalt von `tenant.json`: ``` { "DistributionId": "E1XNX8R2GOAABC", "Domains": [ { "Domain": "example.com" } ], "Parameters": [ { "Name": "testParam", "Value": "defaultValue" } ], "ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC", "Enabled": false, "Tags": { "Items": [ { "Key": "tag", "Value": "tagValue" } ] }, "Name": "new-tenant-customizations", "Customizations": { "GeoRestrictions": { "Locations": ["DE"], "RestrictionType": "whitelist" }, "WebAcl": { "Action": "disable" }, "Certificate": { "Arn": "arn:aws:acm:us-east-1:123456789012:certificate/ec53f564-ea5a-4e4a-a0a2-e3c989449abc" } } } ``` Ausgabe: ``` { "ETag": "E23ZP02F085ABC", "DistributionTenant": { "Id": "dt_2yN5tYwVbPKr7m2IB69M1yp1AB", "DistributionId": "E1XNX8R2GOAABC", "Name": "new-tenant-customizations", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2yN5tYwVbPKr7m2IB69M1yp1AB", "Domains": [ { "Domain": "example.com", "Status": "active" } ], "Tags": { "Items": [ { "Key": "tag", "Value": "tagValue" } ] }, "Customizations": { "WebAcl": { "Action": "disable" }, "Certificate": { "Arn": "arn:aws:acm:us-east-1:123456789012:certificate/ec53f564-ea5a-4e4a-a0a2-e3c989449abc" }, "GeoRestrictions": { "RestrictionType": "whitelist", "Locations": [ "DE" ] } }, "Parameters": [ { "Name": "testParam", "Value": "defaultValue" } ], "ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC", "CreatedTime": "2025-06-11T17:20:06.432000+00:00", "LastModifiedTime": "2025-06-11T17:20:06.432000+00:00", "Enabled": false, "Status": "InProgress" } } ``` **Beispiel 2: So erstellen Sie einen Distributionsmandanten mit einem übernommenen Zertifikat** Im folgenden Beispiel für `create-distribution-tenant` wird ein Distributionsmandant erstellt und ein übernommenes TLS-Zertifikat aus der Multi-Tenant-Distribution angegeben. ``` aws cloudfront create-distribution-tenant \ --cli-input-json file://tenant.json ``` Inhalt von `tenant.json`: ``` { "DistributionId": "E1HVIAU7U12ABC", "Domains": [ { "Domain": "example.com" } ], "Parameters": [ { "Name": "tenantName", "Value": "first-tenant" } ], "Enabled": true, "Name": "new-tenant-no-cert" } ``` Ausgabe: ``` { "ETag": "E23ZP02F0ABC", "DistributionTenant": { "Id": "dt_2zhRB0vBe0B72LZCVy1mgzI1AB", "DistributionId": "E1HVIAU7U12ABC", "Name": "new-tenant-no-cert", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2zhRB0vBe0B72LZCVy1mgzI1AB", "Domains": [ { "Domain": "example.com", "Status": "active" } ], "Parameters": [ { "Name": "tenantName", "Value": "first-tenant" } ], "ConnectionGroupId": "cg_2yQEwpipGFN0hhA0ZemPabOABC", "CreatedTime": "2025-07-10T20:59:38.414000+00:00", "LastModifiedTime": "2025-07-10T20:59:38.414000+00:00", "Enabled": true, "Status": "InProgress" } } ``` **Beispiel 3: So erstellen Sie einen CloudFront Verteilungsmandanten mithilfe eines -gehosteten Validierungstokens CloudFront** Im folgenden `create-distribution-tenant` Beispiel wird ein Distributionsmandant erstellt und ein CloudFront -gehostetes Validierungstoken für Ihren Domainnamen verwendet. ``` aws cloudfront create-distribution-tenant \ --cli-input-json file://tenant.json ``` Inhalt von `tenant.json`: ``` { "DistributionId": "E2GJ5J9QN12ABC", "Domains": [ { "Domain": "example.com" } ], "Parameters": [ { "Name": "tenantName", "Value": "first-tenant" } ], "ConnectionGroupId": "cg_2yQEwpipGFN0hhA0ZemPabOABC", "Enabled": true, "Name": "new-tenant-cf-hosted", "ManagedCertificateRequest": { "ValidationTokenHost": "cloudfront" } } ``` **Wichtig:** Um diesen Befehl erfolgreich auszuführen, müssen Sie einen CNAME-DNS-Eintrag konfigurieren, der Ihre neue Domain (example.com) auf den Routing-Endpunkt der Verbindungsgruppe verweist, die dem Distributionsmandanten zugeordnet ist. Dieser CNAME-Eintrag muss ebenfalls weitergegeben werden, bevor diese Anfrage erfolgreich abgeschlossen werden CloudFront kann. Ausgabe: ``` { "ETag": "E23ZP02F0ABC", "DistributionTenant": { "Id": "dt_2zhStKrA524GvvTWJX92Ozl1AB", "DistributionId": "E2GJ5J9QN12ABC", "Name": "new-tenant-cf-hosted", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2zhStKrA524GvvTWJX92Ozl1AB", "Domains": [ { "Domain": "example.com", "Status": "inactive" } ], "Parameters": [ { "Name": "tenantName", "Value": "first-tenant" } ], "ConnectionGroupId": "cg_2zhSaGatwwXjTjE42nneZzqABC", "CreatedTime": "2025-07-10T21:13:46.416000+00:00", "LastModifiedTime": "2025-07-10T21:13:46.416000+00:00", "Enabled": true, "Status": "InProgress" } } ``` **Beispiel 4: So erstellen Sie einen CloudFront Distributionsmandanten mit einem selbst gehosteten Validierungstoken** Im folgenden `create-distribution-tenant` Beispiel wird ein CloudFront Distributionsmandant erstellt und ein selbst gehostetes Validierungstoken verwendet. ``` aws cloudfront create-distribution-tenant \ --cli-input-json file://tenant.json ``` Inhalt von `tenant.json`: ``` { "DistributionId": "E2GJ5J9QN12ABC", "Domains": [ { "Domain": "example.com" } ], "Parameters": [ { "Name": "tenantName", "Value": "first-tenant" } ], "Enabled": true, "Name": "new-tenant-self-hosted", "ManagedCertificateRequest": { "ValidationTokenHost": "self-hosted" } } ``` Ausgabe: ``` { "ETag": "E23ZP02F0ABC", "DistributionTenant": { "Id": "dt_2zhTFBV93OfFJJ3YMdNM5BC1AB", "DistributionId": "E2GJ5J9QN12ABC", "Name": "new-tenant-self-hosted", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2zhTFBV93OfFJJ3YMdNM5BC1AB", "Domains": [ { "Domain": "example.com", "Status": "inactive" } ], "Parameters": [ { "Name": "tenantName", "Value": "first-tenant" } ], "ConnectionGroupId": "cg_2yQEwpipGFN0hhA0ZemPabOABC", "CreatedTime": "2025-07-10T21:16:39.828000+00:00", "LastModifiedTime": "2025-07-10T21:16:39.828000+00:00", "Enabled": true, "Status": "InProgress" } } ``` **Wichtig:** Nachdem Sie diesen Befehl ausgeführt haben, wird der Distributionsmandant ohne Validierung erstellt. Informationen zur Validierung der verwalteten Zertifikatsanforderung und zur Konfiguration des DNS, wenn Sie bereit sind, Traffic zu empfangen, finden Sie unter [Vollständige Domaineinrichtung](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/managed-cloudfront-certificates.html#complete-domain-ownership) im *Amazon CloudFront Developer Guide*. Weitere Informationen zum Erstellen von Distributionsmandanten finden [Sie unter Erstellen einer Distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [CreateDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-distribution-tenant.html)unter *AWS CLI Befehlsreferenz*. ### `create-distribution-with-tags` Das folgende Codebeispiel zeigt die Verwendung`create-distribution-with-tags`. **AWS CLI** **Um eine CloudFront Distribution mit Tags zu erstellen** Im folgenden Beispiel für `create-distribution-with-tags` wird eine Distribution mit zwei Tags erstellt, indem die Distributionskonfiguration und die Tags in einer JSON-Datei mit dem Namen `dist-config-with-tags.json` bereitgestellt werden. ``` aws cloudfront create-distribution-with-tags \ --distribution-config-with-tags file://dist-config-with-tags.json ``` Die Datei `dist-config-with-tags.json` ist ein JSON-Dokument im aktuellen Ordner. Beachten Sie das Objekt `Tags` oben in der Datei, das zwei Tags enthält: `Name = ExampleDistribution``Project = ExampleProject` Inhalt von `dist-config-with-tags.json`: ``` { "Tags": { "Items": [ { "Key": "Name", "Value": "ExampleDistribution" }, { "Key": "Project", "Value": "ExampleProject" } ] }, "DistributionConfig": { "CallerReference": "cli-example", "Aliases": { "Quantity": 0 }, "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "ForwardedValues": { "QueryString": false, "Cookies": { "Forward": "none" }, "Headers": { "Quantity": 0 }, "QueryStringCacheKeys": { "Quantity": 0 } }, "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "MinTTL": 0, "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "DefaultTTL": 86400, "MaxTTL": 31536000, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "PriceClass": "PriceClass_All", "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "IsIPV6Enabled": true } } ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2019-03-26/distribution/EDFDVBD6EXAMPLE", "ETag": "E2QWRUHEXAMPLE", "Distribution": { "Id": "EDFDVBD6EXAMPLE", "ARN": "arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE", "Status": "InProgress", "LastModifiedTime": "2019-12-04T23:35:41.433Z", "InProgressInvalidationBatches": 0, "DomainName": "d111111abcdef8.cloudfront.net", "ActiveTrustedSigners": { "Enabled": false, "Quantity": 0 }, "DistributionConfig": { "CallerReference": "cli-example", "Aliases": { "Quantity": 0 }, "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "ForwardedValues": { "QueryString": false, "Cookies": { "Forward": "none" }, "Headers": { "Quantity": 0 }, "QueryStringCacheKeys": { "Quantity": 0 } }, "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "MinTTL": 0, "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "DefaultTTL": 86400, "MaxTTL": 31536000, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "PriceClass": "PriceClass_All", "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "IsIPV6Enabled": true } } } ``` + Einzelheiten zur API finden Sie [CreateDistributionWithTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-distribution-with-tags.html)in der *AWS CLI Befehlsreferenz*. ### `create-distribution` Das folgende Codebeispiel zeigt die Verwendung`create-distribution`. **AWS CLI** **Beispiel 1: Um eine CloudFront Distribution zu erstellen** Im folgenden `create-distribution`-Beispiel wird eine Distribution für einen S3-Bucket mit dem Namen `amzn-s3-demo-bucket` erstellt und `index.html` als Standardstammobjekt mithilfe von Befehlszeilenargumenten festgelegt. ``` aws cloudfront create-distribution \ --origin-domain-name amzn-s3-demo-bucket.s3.amazonaws.com \ --default-root-object index.html ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2019-03-26/distribution/EMLARXS9EXAMPLE", "ETag": "E9LHASXEXAMPLE", "Distribution": { "Id": "EMLARXS9EXAMPLE", "ARN": "arn:aws:cloudfront::123456789012:distribution/EMLARXS9EXAMPLE", "Status": "InProgress", "LastModifiedTime": "2019-11-22T00:55:15.705Z", "InProgressInvalidationBatches": 0, "DomainName": "d111111abcdef8.cloudfront.net", "ActiveTrustedSigners": { "Enabled": false, "Quantity": 0 }, "DistributionConfig": { "CallerReference": "cli-example", "Aliases": { "Quantity": 0 }, "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "ForwardedValues": { "QueryString": false, "Cookies": { "Forward": "none" }, "Headers": { "Quantity": 0 }, "QueryStringCacheKeys": { "Quantity": 0 } }, "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "MinTTL": 0, "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "DefaultTTL": 86400, "MaxTTL": 31536000, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "PriceClass": "PriceClass_All", "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "IsIPV6Enabled": true } } } ``` **Beispiel 2: Um eine CloudFront Distribution mit einer JSON-Datei zu erstellen** Im folgenden `create-distribution`-Beispiel wird eine Distribution für einen S3-Bucket mit dem Namen `amzn-s3-demo-bucket` erstellt und `index.html` als Standardstammobjekt mithilfe einer JSON-Datei festgelegt. ``` aws cloudfront create-distribution \ --distribution-config file://dist-config.json ``` Inhalt von `dist-config.json`: ``` { "CallerReference": "cli-example", "Aliases": { "Quantity": 0 }, "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "ForwardedValues": { "QueryString": false, "Cookies": { "Forward": "none" }, "Headers": { "Quantity": 0 }, "QueryStringCacheKeys": { "Quantity": 0 } }, "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "MinTTL": 0, "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "DefaultTTL": 86400, "MaxTTL": 31536000, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "PriceClass": "PriceClass_All", "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "IsIPV6Enabled": true } ``` Eine Beispielausgabe finden Sie in Beispiel 1. **Beispiel 3: Um eine CloudFront Multi-Tenant-Distribution mit einem Zertifikat zu erstellen** Im folgenden `create-distribution` Beispiel wird eine CloudFront Distribution mit Mehrmandantenunterstützung erstellt und ein TLS-Zertifikat angegeben. ``` aws cloudfront create-distribution \ --distribution-config file://dist-config.json ``` Inhalt von `dist-config.json`: ``` { "CallerReference": "cli-example-with-cert", "Comment": "CLI example distribution", "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "OriginPath": "/{{tenantName}}", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5ABC", "ViewerProtocolPolicy": "allow-all", "AllowedMethods": { "Quantity": 2, "Items": ["HEAD", "GET"], "CachedMethods": { "Quantity": 2, "Items": ["HEAD", "GET"] } } }, "Enabled": true, "ViewerCertificate": { "ACMCertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/191306a1-db01-49ca-90ef-fc414ee5dabc", "SSLSupportMethod": "sni-only" }, "HttpVersion": "http2", "ConnectionMode": "tenant-only", "TenantConfig": { "ParameterDefinitions": [ { "Name": "tenantName", "Definition": { "StringSchema": { "Comment": "tenantName parameter", "DefaultValue": "root", "Required": false } } } ] } } ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2020-05-31/distribution/E1HVIAU7UABC", "ETag": "E20LT7R1BABC", "Distribution": { "Id": "E1HVIAU7U12ABC", "ARN": "arn:aws:cloudfront::123456789012:distribution/E1HVIAU7U12ABC", "Status": "InProgress", "LastModifiedTime": "2025-07-10T20:33:31.117000+00:00", "InProgressInvalidationBatches": 0, "DomainName": "example.com", "ActiveTrustedSigners": { "Enabled": false, "Quantity": 0 }, "ActiveTrustedKeyGroups": { "Enabled": false, "Quantity": 0 }, "DistributionConfig": { "CallerReference": "cli-example-with-cert", "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "OriginPath": "/{{tenantName}}", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" }, "ConnectionAttempts": 3, "ConnectionTimeout": 10, "OriginShield": { "Enabled": false }, "OriginAccessControlId": "" } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "TrustedKeyGroups": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "AllowedMethods": { "Quantity": 2, "Items": ["HEAD", "GET"], "CachedMethods": { "Quantity": 2, "Items": ["HEAD", "GET"] } }, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "", "CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5ABC", "GrpcConfig": { "Enabled": false } }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "CLI example distribution", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": false, "ACMCertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/1954f095-11b6-4daf-9952-0c308a00abc", "SSLSupportMethod": "sni-only", "MinimumProtocolVersion": "TLSv1.2_2021", "Certificate": "arn:aws:acm:us-east-1:123456789012:certificate/1954f095-11b6-4daf-9952-0c308a00abc", "CertificateSource": "acm" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "TenantConfig": { "ParameterDefinitions": [ { "Name": "tenantName", "Definition": { "StringSchema": { "Comment": "tenantName parameter", "DefaultValue": "root", "Required": false } } } ] }, "ConnectionMode": "tenant-only" } } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Distributionen](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html) im *Amazon CloudFront Developer Guide*. **Beispiel 4: So erstellen Sie eine CloudFront Multi-Tenant-Distribution ohne Zertifikat** Im folgenden `create-distribution` Beispiel wird eine CloudFront Distribution mit Mehrmandantenunterstützung, aber ohne TLS-Zertifikat erstellt. ``` aws cloudfront create-distribution \ --distribution-config file://dist-config.json ``` Inhalt von `dist-config.json`: ``` { "CallerReference": "cli-example", "Comment": "CLI example distribution", "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "OriginPath": "/{{tenantName}}", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5ABC", "ViewerProtocolPolicy": "allow-all", "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } } }, "Enabled": true, "HttpVersion": "http2", "ConnectionMode": "tenant-only", "TenantConfig": { "ParameterDefinitions": [ { "Name": "tenantName", "Definition": { "StringSchema": { "Comment": "tenantName parameter", "DefaultValue": "root", "Required": false } } } ] } } ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2020-05-31/distribution/E2GJ5J9QN12ABC", "ETag": "E37YLVVQIABC", "Distribution": { "Id": "E2GJ5J9QNABC", "ARN": "arn:aws:cloudfront::123456789012:distribution/E2GJ5J9QN12ABC", "Status": "InProgress", "LastModifiedTime": "2025-07-10T20:35:20.565000+00:00", "InProgressInvalidationBatches": 0, "DomainName": "example.com", "ActiveTrustedSigners": { "Enabled": false, "Quantity": 0 }, "ActiveTrustedKeyGroups": { "Enabled": false, "Quantity": 0 }, "DistributionConfig": { "CallerReference": "cli-example-no-cert", "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "OriginPath": "/{{tenantName}}", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" }, "ConnectionAttempts": 3, "ConnectionTimeout": 10, "OriginShield": { "Enabled": false }, "OriginAccessControlId": "" } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "TrustedKeyGroups": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "", "CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5ABC", "GrpcConfig": { "Enabled": false } }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "CLI example distribution", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "SSLSupportMethod": "sni-only", "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "TenantConfig": { "ParameterDefinitions": [ { "Name": "tenantName", "Definition": { "StringSchema": { "Comment": "tenantName parameter", "DefaultValue": "root", "Required": false } } } ] }, "ConnectionMode": "tenant-only" } } } ``` Weitere Informationen finden [Sie unter Distributionen konfigurieren](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [CreateDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-distribution.html)in der *AWS CLI Befehlsreferenz.* ### `create-field-level-encryption-config` Das folgende Codebeispiel zeigt die Verwendung`create-field-level-encryption-config`. **AWS CLI** **Um eine Verschlüsselungskonfiguration auf CloudFront Feldebene zu erstellen** Im folgenden Beispiel wird eine Verschlüsselungskonfiguration auf Feldebene erstellt, indem die Konfigurationsparameter in einer JSON-Datei mit dem Namen `fle-config.json` bereitgestellt werden. Bevor Sie eine Verschlüsselungskonfiguration auf Feldebene erstellen können, müssen Sie über ein Verschlüsselungsprofil auf Feldebene verfügen. Informationen zum Erstellen eines Profils finden Sie unter dem Befehl create-field-level-encryption -profile. *Weitere Informationen zur Verschlüsselung auf CloudFront Feldebene finden Sie unter Verschlüsselung auf [Feldebene zum Schutz vertraulicher Daten verwenden](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html) im Amazon Developer Guide. CloudFront * ``` aws cloudfront create-field-level-encryption-config \ --field-level-encryption-config file://fle-config.json ``` Die Datei `fle-config.json` ist ein JSON-Dokument im aktuellen Verzeichnis, das Folgendes enthält: ``` { "CallerReference": "cli-example", "Comment": "Example FLE configuration", "QueryArgProfileConfig": { "ForwardWhenQueryArgProfileIsUnknown": true, "QueryArgProfiles": { "Quantity": 0 } }, "ContentTypeProfileConfig": { "ForwardWhenContentTypeIsUnknown": true, "ContentTypeProfiles": { "Quantity": 1, "Items": [ { "Format": "URLEncoded", "ProfileId": "P280MFCLSYOCVU", "ContentType": "application/x-www-form-urlencoded" } ] } } } ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2019-03-26/field-level-encryption/C3KM2WVD605UAY", "ETag": "E2P4Z4VU7TY5SG", "FieldLevelEncryption": { "Id": "C3KM2WVD605UAY", "LastModifiedTime": "2019-12-10T21:30:18.974Z", "FieldLevelEncryptionConfig": { "CallerReference": "cli-example", "Comment": "Example FLE configuration", "QueryArgProfileConfig": { "ForwardWhenQueryArgProfileIsUnknown": true, "QueryArgProfiles": { "Quantity": 0, "Items": [] } }, "ContentTypeProfileConfig": { "ForwardWhenContentTypeIsUnknown": true, "ContentTypeProfiles": { "Quantity": 1, "Items": [ { "Format": "URLEncoded", "ProfileId": "P280MFCLSYOCVU", "ContentType": "application/x-www-form-urlencoded" } ] } } } } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-field-level-encryption-config.html).AWS CLI * ### `create-field-level-encryption-profile` Das folgende Codebeispiel zeigt die Verwendung`create-field-level-encryption-profile`. **AWS CLI** **Um ein Verschlüsselungsprofil auf CloudFront Feldebene zu erstellen** Im folgenden Beispiel wird ein Verschlüsselungsprofil auf Feldebene erstellt, indem die Parameter in einer JSON-Datei mit dem Namen `fle-profile-config.json` bereitgestellt werden. Bevor Sie ein Verschlüsselungsprofil auf Feldebene erstellen können, benötigen Sie einen öffentlichen Schlüssel. CloudFront Informationen zum Erstellen eines CloudFront öffentlichen Schlüssels finden Sie im create-public-key Befehl. *Weitere Informationen zur Verschlüsselung auf CloudFront Feldebene finden Sie unter Verschlüsselung auf [Feldebene zum Schutz vertraulicher Daten verwenden](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html) im Amazon Developer Guide. CloudFront * ``` aws cloudfront create-field-level-encryption-profile \ --field-level-encryption-profile-config file://fle-profile-config.json ``` Die Datei `fle-profile-config.json` ist ein JSON-Dokument im aktuellen Verzeichnis, das Folgendes enthält: ``` { "Name": "ExampleFLEProfile", "CallerReference": "cli-example", "Comment": "FLE profile for AWS CLI example", "EncryptionEntities": { "Quantity": 1, "Items": [ { "PublicKeyId": "K2K8NC4HVFE3M0", "ProviderId": "ExampleFLEProvider", "FieldPatterns": { "Quantity": 1, "Items": [ "ExampleSensitiveField" ] } } ] } } ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2019-03-26/field-level-encryption-profile/PPK0UOSIF5WSV", "ETag": "E2QWRUHEXAMPLE", "FieldLevelEncryptionProfile": { "Id": "PPK0UOSIF5WSV", "LastModifiedTime": "2019-12-10T01:03:16.537Z", "FieldLevelEncryptionProfileConfig": { "Name": "ExampleFLEProfile", "CallerReference": "cli-example", "Comment": "FLE profile for AWS CLI example", "EncryptionEntities": { "Quantity": 1, "Items": [ { "PublicKeyId": "K2K8NC4HVFE3M0", "ProviderId": "ExampleFLEProvider", "FieldPatterns": { "Quantity": 1, "Items": [ "ExampleSensitiveField" ] } } ] } } } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-field-level-encryption-profile.html).AWS CLI * ### `create-invalidation-for-distribution-tenant` Das folgende Codebeispiel zeigt die Verwendung`create-invalidation-for-distribution-tenant`. **AWS CLI** **Um eine CloudFront Invalidierung für einen Distributionsmandanten zu erstellen** Im folgenden `create-invalidation-for-distribution-tenant` Beispiel wird eine Invalidierung für alle Dateien in einem CloudFront Verteilungsmandanten erstellt. ``` aws cloudfront create-invalidation-for-distribution-tenant \ --id dt_2wjDZi3hD1ivOXf6rpZJO1AB \ --invalidation-batch '{"Paths": {"Quantity": 1, "Items": ["/*"]}, "CallerReference": "invalidation-$(date +%s)"}' ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2020-05-31/distribution-tenant/dt_2wjDZi3hD1ivOXf6rpZJO1AB/invalidation/I2JGL2F1ZAA426PGG0YLLKABC", "Invalidation": { "Id": "I2JGL2F1ZAA426PGG0YLLKABC", "Status": "InProgress", "CreateTime": "2025-05-07T16:59:25.947000+00:00", "InvalidationBatch": { "Paths": { "Quantity": 1, "Items": [ "/*" ] }, "CallerReference": "invalidation-$(date +%s)" } } } ``` Weitere Informationen finden Sie unter [Dateien für ungültig erklären, um Inhalte zu entfernen](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [CreateInvalidationForDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-invalidation-for-distribution-tenant.html)in der *AWS CLI Befehlsreferenz.* ### `create-invalidation` Das folgende Codebeispiel zeigt die Verwendung`create-invalidation`. **AWS CLI** **Um eine Invalidierung für eine CloudFront Distribution zu erstellen** Das folgende `create-invalidation` Beispiel erstellt eine Invalidierung für die angegebenen Dateien in der angegebenen CloudFront Distribution: ``` aws cloudfront create-invalidation \ --distribution-id EDFDVBD6EXAMPLE \ --paths "/example-path/example-file.jpg" "/example-path/example-file2.png" ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2019-03-26/distribution/EDFDVBD6EXAMPLE/invalidation/I1JLWSDAP8FU89", "Invalidation": { "Id": "I1JLWSDAP8FU89", "Status": "InProgress", "CreateTime": "2019-12-05T18:24:51.407Z", "InvalidationBatch": { "Paths": { "Quantity": 2, "Items": [ "/example-path/example-file2.png", "/example-path/example-file.jpg" ] }, "CallerReference": "cli-1575570291-670203" } } } ``` Im vorherigen Beispiel generierte die AWS CLI automatisch ein zufälliges Ergebnis`CallerReference`. Wenn Sie Ihre eigene `CallerReference` angeben oder die Invalidierungsparameter nicht als Befehlszeilenargumente übergeben möchten, können Sie eine JSON-Datei verwenden. Im folgende Beispiel wird eine Invalidierung für zwei Dateien erstellt, indem die Invalidierungsparameter in einer JSON-Datei mit dem Namen `inv-batch.json` angegeben werden. ``` aws cloudfront create-invalidation \ --distribution-id EDFDVBD6EXAMPLE \ --invalidation-batch file://inv-batch.json ``` Inhalt von `inv-batch.json`: ``` { "Paths": { "Quantity": 2, "Items": [ "/example-path/example-file.jpg", "/example-path/example-file2.png" ] }, "CallerReference": "cli-example" } ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2019-03-26/distribution/EDFDVBD6EXAMPLE/invalidation/I2J0I21PCUYOIK", "Invalidation": { "Id": "I2J0I21PCUYOIK", "Status": "InProgress", "CreateTime": "2019-12-05T18:40:49.413Z", "InvalidationBatch": { "Paths": { "Quantity": 2, "Items": [ "/example-path/example-file.jpg", "/example-path/example-file2.png" ] }, "CallerReference": "cli-example" } } } ``` + Einzelheiten zur API finden Sie [CreateInvalidation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-invalidation.html)in der *AWS CLI Befehlsreferenz*. ### `create-public-key` Das folgende Codebeispiel zeigt die Verwendung`create-public-key`. **AWS CLI** **Um einen CloudFront öffentlichen Schlüssel zu erstellen** Im folgenden Beispiel wird ein CloudFront öffentlicher Schlüssel erstellt, indem die Parameter in einer JSON-Datei mit dem Namen bereitgestellt `pub-key-config.json` werden. Bevor Sie diesen Befehl verwenden können, benötigen Sie einen PEM-codierten öffentlichen Schlüssel. Weitere Informationen finden Sie unter [Create an RSA Key Pair](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html#field-level-encryption-setting-up-step1) im *Amazon CloudFront Developer Guide*. ``` aws cloudfront create-public-key \ --public-key-config file://pub-key-config.json ``` Die Datei `pub-key-config.json` ist ein JSON-Dokument im aktuellen Ordner, das Folgendes enthält. Beachten Sie, dass der öffentliche Schlüssel im PEM-Format verschlüsselt ist. ``` { "CallerReference": "cli-example", "Name": "ExampleKey", "EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n", "Comment": "example public key" } ``` Ausgabe: ``` { "Location": "https://cloudfront.amazonaws.com/2019-03-26/public-key/KDFB19YGCR002", "ETag": "E2QWRUHEXAMPLE", "PublicKey": { "Id": "KDFB19YGCR002", "CreatedTime": "2019-12-05T18:51:43.781Z", "PublicKeyConfig": { "CallerReference": "cli-example", "Name": "ExampleKey", "EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n", "Comment": "example public key" } } } ``` + Einzelheiten zur API finden Sie unter [CreatePublicKey AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-public-key.html)*Befehlsreferenz.* ### `delete-cloud-front-origin-access-identity` Das folgende Codebeispiel zeigt die Verwendung`delete-cloud-front-origin-access-identity`. **AWS CLI** **Um eine CloudFront ursprüngliche Zugriffsidentität zu löschen** Im folgenden Beispiel wird die Ursprungszugriffsidentität (OAI) mit der ID `E74FTE3AEXAMPLE` gelöscht. Um eine OAI zu löschen, benötigen Sie die ID und das `ETag` der OAI. Die OAI-ID wird in der Ausgabe der Befehle create-cloud-front-origin -access-identity und -access-identities zurückgegeben. list-cloud-front-origin Verwenden Sie den Befehl -access-identity oder -, um das `ETag` abzurufen. get-cloud-front-origin get-cloud-front-origin access-identity-config Verwenden Sie die Option `--if-match`, um das OAI-`ETag` bereitzustellen. ``` aws cloudfront delete-cloud-front-origin-access-identity \ --id E74FTE3AEXAMPLE \ --if-match E2QWRUHEXAMPLE ``` Bei erfolgreicher Ausführung gibt dieser Befehl keine Ausgabe aus. + *Einzelheiten zur API finden Sie [DeleteCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-cloud-front-origin-access-identity.html)in AWS CLI der Befehlsreferenz.* ### `delete-connection-group` Das folgende Codebeispiel zeigt die Verwendung`delete-connection-group`. **AWS CLI** **So löschen Sie eine Verbindungsgruppe** Im folgenden Beispiel für `delete-connection-group` wird eine Verbindungsgruppe gelöscht. Die Verbindungsgruppe muss deaktiviert sein und kann keinen CloudFront Ressourcen zugeordnet werden. ``` aws cloudfront delete-connection-group \ --id cg_2wjLpjbHkLUdhWAjHllcOeABC \ --if-match ETVPDKIKX0DABC ``` Bei erfolgreicher Ausführung gibt dieser Befehl keine Ausgabe aus. Weitere Informationen zur Verwaltung von Verbindungsgruppen finden Sie unter [Benutzerdefinierte Verbindungsgruppe erstellen (optional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [DeleteConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-connection-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-distribution-tenant` Das folgende Codebeispiel zeigt die Verwendung`delete-distribution-tenant`. **AWS CLI** **So löschen Sie einen Distributionsmandanten** Im folgenden `delete-distribution-tenant` Beispiel wird ein Distributionsmandant mit ETag `ETVPDKIKX0DABC` gelöscht. Der Verteilungsmandant muss deaktiviert sein und kann keinen CloudFront Ressourcen zugeordnet werden. ``` aws cloudfront delete-distribution-tenant \ --id dt_2wjMUbg3NHZEQ7OfoalP5zi1AB \ --if-match ETVPDKIKX0DABC ``` Bei erfolgreicher Ausführung gibt dieser Befehl keine Ausgabe aus. Weitere Informationen finden Sie unter [Löschen einer Distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/HowToDeleteDistribution.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [DeleteDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-distribution-tenant.html)in der *AWS CLI Befehlsreferenz*. ### `delete-distribution` Das folgende Codebeispiel zeigt die Verwendung`delete-distribution`. **AWS CLI** **Um eine CloudFront Distribution zu löschen** Im folgenden Beispiel wird die CloudFront Distribution mit der ID `EDFDVBD6EXAMPLE` gelöscht. Bevor Sie eine Distribution löschen können, müssen Sie sie deaktivieren. Verwenden Sie zum Deaktivieren einer Distribution den Befehl „update-distribution“. Weitere Informationen finden Sie in den Beispielen zu „update-distribution“. Wenn eine Distribution deaktiviert ist, können Sie sie löschen. Um eine Distribution zu löschen, müssen Sie die `--if-match`-Option verwenden, um den `ETag` der Distribution anzugeben. Verwenden Sie den Befehl get-distribution or `ETag`get-distribution-config , um das abzurufen. ``` aws cloudfront delete-distribution \ --id EDFDVBD6EXAMPLE \ --if-match E2QWRUHEXAMPLE ``` Bei erfolgreicher Ausführung gibt dieser Befehl keine Ausgabe aus. + Einzelheiten zur API finden Sie unter [DeleteDistribution AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-distribution.html)*Befehlsreferenz.* ### `delete-field-level-encryption-config` Das folgende Codebeispiel zeigt die Verwendung`delete-field-level-encryption-config`. **AWS CLI** **Um eine Verschlüsselungskonfiguration auf CloudFront Feldebene zu löschen** Im folgenden Beispiel wird die Verschlüsselungskonfiguration auf CloudFront Feldebene mit der ID gelöscht. `C3KM2WVD605UAY` Um eine Verschlüsselungskonfiguration auf Feldebene zu löschen, benötigen Sie die zugehörige ID und das `ETag`. Die ID wird in der Ausgabe der Befehle create-field-level-encryption -config und -configs zurückgegeben. list-field-level-encryption Verwenden Sie den Befehl get-field-level-encryption oder `ETag` get-field-level-encryption -config, um das abzurufen. Verwenden Sie die Option `--if-match`, um das `ETag` der Konfiguration bereitzustellen. ``` aws cloudfront delete-field-level-encryption-config \ --id C3KM2WVD605UAY \ --if-match E26M4BIAV81ZF6 ``` Bei erfolgreicher Ausführung gibt dieser Befehl keine Ausgabe aus. + Einzelheiten zur API finden Sie [DeleteFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-field-level-encryption-config.html)in der *AWS CLI Befehlsreferenz.* ### `delete-field-level-encryption-profile` Das folgende Codebeispiel zeigt die Verwendung`delete-field-level-encryption-profile`. **AWS CLI** **Um ein Verschlüsselungsprofil auf CloudFront Feldebene zu löschen** Im folgenden Beispiel wird das Verschlüsselungsprofil auf CloudFront Feldebene mit der ID gelöscht. `PPK0UOSIF5WSV` Um ein Verschlüsselungsprofil auf Feldebene zu löschen, benötigen Sie die zugehörige ID und das `ETag`. Die ID wird in der Ausgabe der Befehle -profile und create-field-level-encryption -profiles zurückgegeben. list-field-level-encryption Verwenden Sie den Befehl get-field-level-encryption -profile oder get-field-level-encryption -profile-config`ETag`, um das abzurufen. Verwenden Sie die Option `--if-match`, um das `ETag` des Profils bereitzustellen. ``` aws cloudfront delete-field-level-encryption-profile \ --id PPK0UOSIF5WSV \ --if-match EJETYFJ9CL66D ``` Bei erfolgreicher Ausführung gibt dieser Befehl keine Ausgabe aus. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-field-level-encryption-profile.html).AWS CLI * ### `delete-public-key` Das folgende Codebeispiel zeigt die Verwendung`delete-public-key`. **AWS CLI** **Um einen CloudFront öffentlichen Schlüssel zu löschen** Im folgenden Beispiel wird der CloudFront öffentliche Schlüssel mit der ID `KDFB19YGCR002` gelöscht. Um einen öffentlichen Schlüssel zu löschen, benötigen Sie seine ID und sein `ETag`. Die ID wird in der Ausgabe der list-public-keys Befehle create-public-key und zurückgegeben. Verwenden Sie den get-public-key-config Befehl get-public-key oder`ETag`, um das abzurufen. Verwenden Sie die Option `--if-match`, um das `ETag` des öffentlichen Schlüssels bereitzustellen. ``` aws cloudfront delete-public-key \ --id KDFB19YGCR002 \ --if-match E2QWRUHEXAMPLE ``` Bei erfolgreicher Ausführung gibt dieser Befehl keine Ausgabe aus. + Einzelheiten zur API finden Sie [DeletePublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-public-key.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-distribution-tenant-web-acl` Das folgende Codebeispiel zeigt die Verwendung`disassociate-distribution-tenant-web-acl`. **AWS CLI** **So trennen Sie eine Web-ACL von einem Distributionsmandanten** Im folgenden `disassociate-distribution-tenant-web-acl` Beispiel wird die Zuordnung einer Web-ACL zu einem Distributionsmandanten mit ETag `E1PA6795UKMABC` aufgehoben. ``` aws cloudfront disassociate-distribution-tenant-web-acl \ --id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB \ --if-match E1PA6795UKMABC ``` Ausgabe: ``` { "ETag": "E13V1IB3VIYABC", "Id": "dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB" } ``` Weitere Informationen finden [Sie unter Deaktivieren AWS des WAF-Sicherheitsschutzes](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/disable-waf.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [DisassociateDistributionTenantWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/disassociate-distribution-tenant-web-acl.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-distribution-web-acl` Das folgende Codebeispiel zeigt die Verwendung`disassociate-distribution-web-acl`. **AWS CLI** **Um eine Web-ACL von einer CloudFront Distribution zu trennen** Im folgenden `disassociate-distribution-web-acl` Beispiel wird die Zuordnung zwischen einer Web-ACL und einer CloudFront Distribution mit ETag `E13V1IB3VIYABC` entfernt. ``` aws cloudfront disassociate-distribution-web-acl \ --id E1XNX8R2GOAABC \ --if-match EEZQ9Z24VM1ABC ``` Ausgabe: ``` { "ETag": "E2YWS1C2J3OABC", "Id": "E1XNX8R2GOAABC" } ``` Weitere Informationen finden [Sie unter Deaktivieren AWS des WAF-Sicherheitsschutzes](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/disable-waf.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [DisassociateDistributionWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/disassociate-distribution-web-acl.html)in der *AWS CLI Befehlsreferenz*. ### `get-cloud-front-origin-access-identity-config` Das folgende Codebeispiel zeigt die Verwendung`get-cloud-front-origin-access-identity-config`. **AWS CLI** **Um eine Konfiguration der CloudFront Origin-Zugriffsidentität zu erhalten** Im folgenden Beispiel werden Metadaten zur ursprünglichen CloudFront Zugriffsidentität (OAI) mit der ID abgerufen`E74FTE3AEXAMPLE`, einschließlich ihrer`ETag`. Die OAI-ID wird in der Ausgabe der Befehle -access-identity und create-cloud-front-origin -access-identities zurückgegeben. list-cloud-front-origin ``` aws cloudfront get-cloud-front-origin-access-identity-config --id E74FTE3AEXAMPLE ``` Ausgabe: ``` { "ETag": "E2QWRUHEXAMPLE", "CloudFrontOriginAccessIdentityConfig": { "CallerReference": "cli-example", "Comment": "Example OAI" } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetCloudFrontOriginAccessIdentityConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-cloud-front-origin-access-identity-config.html)AWS CLI * ### `get-cloud-front-origin-access-identity` Das folgende Codebeispiel zeigt die Verwendung`get-cloud-front-origin-access-identity`. **AWS CLI** **Um eine CloudFront ursprüngliche Zugriffsidentität zu erhalten** Im folgenden Beispiel wird die ursprüngliche CloudFront Zugriffsidentität (OAI) mit der ID abgerufen`E74FTE3AEXAMPLE`, einschließlich ihrer `ETag` und der zugehörigen kanonischen S3-ID. Die OAI-ID wird in der Ausgabe der Befehle -access-identity und create-cloud-front-origin -access-identities zurückgegeben. list-cloud-front-origin ``` aws cloudfront get-cloud-front-origin-access-identity --id E74FTE3AEXAMPLE ``` Ausgabe: ``` { "ETag": "E2QWRUHEXAMPLE", "CloudFrontOriginAccessIdentity": { "Id": "E74FTE3AEXAMPLE", "S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE", "CloudFrontOriginAccessIdentityConfig": { "CallerReference": "cli-example", "Comment": "Example OAI" } } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-cloud-front-origin-access-identity.html)AWS CLI * ### `get-connection-group-by-routing-endpoint` Das folgende Codebeispiel zeigt die Verwendung`get-connection-group-by-routing-endpoint`. **AWS CLI** **So rufen Sie eine Verbindungsgruppe nach Routing-Endpunkt ab** Im folgenden Beispiel für `get-connection-group-by-routing-endpoint` werden Informationen über eine Verbindungsgruppe mithilfe ihres Routing-Endpunkts abgerufen. ``` aws cloudfront get-connection-group-by-routing-endpoint \ --routing-endpoint dvdg9gprgabc.cloudfront.net ``` Ausgabe: ``` { "ETag": "E23ZP02F085ABC", "ConnectionGroup": { "Id": "cg_2wjDWTBKTlRB87cAaUQFaakABC", "Name": "connection-group-2", "Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2wjDWTBKTlRB87cAaUQFaakABC", "CreatedTime": "2025-05-06T15:42:00.790000+00:00", "LastModifiedTime": "2025-05-06T15:42:00.790000+00:00", "Ipv6Enabled": true, "RoutingEndpoint": "dvdg9gprgabc.cloudfront.net", "Status": "Deployed", "Enabled": true, "IsDefault": false } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Verbindungsgruppe erstellen (optional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [GetConnectionGroupByRoutingEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-connection-group-by-routing-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `get-connection-group` Das folgende Codebeispiel zeigt die Verwendung`get-connection-group`. **AWS CLI** **Um eine CloudFront Verbindungsgruppe zu erhalten** Im folgenden `get-connection-group` Beispiel werden Informationen über eine CloudFront Verbindungsgruppe abgerufen. ``` aws cloudfront get-connection-group \ --identifier cg_2wjDWTBKTlRB87cAaUQFaakABC ``` Ausgabe: ``` { "ETag": "E23ZP02F085ABC", "ConnectionGroup": { "Id": "cg_2wjDWTBKTlRB87cAaUQFaakABC", "Name": "connection-group-2", "Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2wjDWTBKTlRB87cAaUQFaakABC", "CreatedTime": "2025-05-06T15:42:00.790000+00:00", "LastModifiedTime": "2025-05-06T15:42:00.790000+00:00", "Ipv6Enabled": true, "RoutingEndpoint": "dvdg9gprgabc.cloudfront.net", "Status": "Deployed", "Enabled": true, "IsDefault": false } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Verbindungsgruppe erstellen (optional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [GetConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-connection-group.html)in der *AWS CLI Befehlsreferenz*. ### `get-distribution-config` Das folgende Codebeispiel zeigt die Verwendung`get-distribution-config`. **AWS CLI** **Um eine CloudFront Distributionskonfiguration zu erhalten** Im folgenden Beispiel werden Metadaten über die CloudFront Distribution mit der ID abgerufen`EDFDVBD6EXAMPLE`, einschließlich ihrer`ETag`. Die Distributions-ID wird in den Befehlen „create-distribution“ und „list-distributions“ zurückgegeben. ``` aws cloudfront get-distribution-config \ --id EDFDVBD6EXAMPLE ``` Ausgabe: ``` { "ETag": "E2QWRUHEXAMPLE", "DistributionConfig": { "CallerReference": "cli-example", "Aliases": { "Quantity": 0 }, "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "ForwardedValues": { "QueryString": false, "Cookies": { "Forward": "none" }, "Headers": { "Quantity": 0 }, "QueryStringCacheKeys": { "Quantity": 0 } }, "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "MinTTL": 0, "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "DefaultTTL": 86400, "MaxTTL": 31536000, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "PriceClass": "PriceClass_All", "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "IsIPV6Enabled": true } } ``` + Einzelheiten zur API finden Sie [GetDistributionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution-config.html)unter *AWS CLI Befehlsreferenz*. ### `get-distribution-tenant-by-domain` Das folgende Codebeispiel zeigt die Verwendung`get-distribution-tenant-by-domain`. **AWS CLI** **So rufen Sie Informationen über den Distributionsmandanten nach Domain ab** Im folgenden Beispiel für `get-distribution-tenant-by-domain` werden Informationen über einen Distributionsmandanten abgerufen, der die angegebene Domain verwendet. ``` aws cloudfront get-distribution-tenant-by-domain \ --domain example.com ``` Ausgabe: ``` { "ETag": "E23ZP02F085ABC", "DistributionTenant": { "Id": "dt_2xVInRKCfUzQHgxosDs9hiLk1AB", "DistributionId": "E1XNX8R2GOAABC", "Name": "example-tenant-4", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2xVInRKCfUzQHgxosDs9hiLk1AB", "Domains": [ { "Domain": "example.com", "Status": "active" } ], "Parameters": [ { "Name": "testParam", "Value": "defaultValue" } ], "ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC", "CreatedTime": "2025-05-23T16:16:20.871000+00:00", "LastModifiedTime": "2025-05-23T16:16:20.871000+00:00", "Enabled": false, "Status": "Deployed" } } ``` Weitere Informationen finden Sie im *Amazon CloudFront Developer* [Guide unter Grundlegendes zur Funktionsweise von Multi-Tenant-Distributionen](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html). + Einzelheiten zur API finden Sie [GetDistributionTenantByDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution-tenant-by-domain.html)in der *AWS CLI Befehlsreferenz*. ### `get-distribution-tenant` Das folgende Codebeispiel zeigt die Verwendung`get-distribution-tenant`. **AWS CLI** **Um Details zu einem CloudFront Distributionsmandanten abzurufen** Im folgenden `get-distribution-tenant` Beispiel werden Informationen über einen CloudFront Verteilungsmandanten abgerufen. ``` aws cloudfront get-distribution-tenant \ --id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB ``` Ausgabe: ``` { "ETag": "E23ZP02F085ABC", "DistributionTenant": { "Id": "dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB", "DistributionId": "E1XNX8R2GOAABC", "Name": "example-tenant-2", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB", "Domains": [ { "Domain": "example.com", "Status": "inactive" } ], "ConnectionGroupId": "cg_2wjDWTBKTlRB87cAaUQFaakABC", "CreatedTime": "2025-05-06T15:42:28.542000+00:00", "LastModifiedTime": "2025-05-06T15:42:37.724000+00:00", "Enabled": true, "Status": "InProgress" } } ``` Weitere Informationen finden Sie im *Amazon CloudFront Developer* [Guide unter Grundlegendes zur Funktionsweise von Multi-Tenant-Distributionen](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html). + Einzelheiten zur API finden Sie [GetDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution-tenant.html)in der *AWS CLI Befehlsreferenz*. ### `get-distribution` Das folgende Codebeispiel zeigt die Verwendung`get-distribution`. **AWS CLI** **Um eine CloudFront Distribution zu erhalten** Im folgenden `get-distribution` Beispiel wird die CloudFront Distribution mit der ID abgerufen`EDFDVBD6EXAMPLE`, einschließlich ihrer`ETag`. Die Distributions-ID wird in den Befehlen „create-distribution“ und „list-distributions“ zurückgegeben. ``` aws cloudfront get-distribution \ --id EDFDVBD6EXAMPLE ``` Ausgabe: ``` { "ETag": "E2QWRUHEXAMPLE", "Distribution": { "Id": "EDFDVBD6EXAMPLE", "ARN": "arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE", "Status": "Deployed", "LastModifiedTime": "2019-12-04T23:35:41.433Z", "InProgressInvalidationBatches": 0, "DomainName": "d111111abcdef8.cloudfront.net", "ActiveTrustedSigners": { "Enabled": false, "Quantity": 0 }, "DistributionConfig": { "CallerReference": "cli-example", "Aliases": { "Quantity": 0 }, "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example", "ForwardedValues": { "QueryString": false, "Cookies": { "Forward": "none" }, "Headers": { "Quantity": 0 }, "QueryStringCacheKeys": { "Quantity": 0 } }, "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "MinTTL": 0, "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "DefaultTTL": 86400, "MaxTTL": 31536000, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "PriceClass": "PriceClass_All", "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "IsIPV6Enabled": true } } } ``` + Einzelheiten zur API finden Sie [GetDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution.html)in der *AWS CLI Befehlsreferenz*. ### `get-field-level-encryption-config` Das folgende Codebeispiel zeigt die Verwendung`get-field-level-encryption-config`. **AWS CLI** **Um Metadaten zu einer Verschlüsselungskonfiguration auf CloudFront Feldebene abzurufen** Im folgenden Beispiel werden Metadaten über die Verschlüsselungskonfiguration auf CloudFront Feldebene mit der ID `C3KM2WVD605UAY` abgerufen, einschließlich ihrer: `ETag` ``` aws cloudfront get-field-level-encryption-config --id C3KM2WVD605UAY ``` Ausgabe: ``` { "ETag": "E2P4Z4VU7TY5SG", "FieldLevelEncryptionConfig": { "CallerReference": "cli-example", "Comment": "Example FLE configuration", "QueryArgProfileConfig": { "ForwardWhenQueryArgProfileIsUnknown": true, "QueryArgProfiles": { "Quantity": 0, "Items": [] } }, "ContentTypeProfileConfig": { "ForwardWhenContentTypeIsUnknown": true, "ContentTypeProfiles": { "Quantity": 1, "Items": [ { "Format": "URLEncoded", "ProfileId": "P280MFCLSYOCVU", "ContentType": "application/x-www-form-urlencoded" } ] } } } } ``` + Einzelheiten zur API finden Sie unter [GetFieldLevelEncryptionConfig AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption-config.html)*Befehlsreferenz*. ### `get-field-level-encryption-profile-config` Das folgende Codebeispiel zeigt die Verwendung`get-field-level-encryption-profile-config`. **AWS CLI** **Um eine Konfiguration für ein Verschlüsselungsprofil CloudFront auf Feldebene zu erhalten** Im folgenden Beispiel werden Metadaten über das Verschlüsselungsprofil auf CloudFront Feldebene mit ID `PPK0UOSIF5WSV` abgerufen, einschließlich seiner: `ETag` ``` aws cloudfront get-field-level-encryption-profile-config --id PPK0UOSIF5WSV ``` Ausgabe: ``` { "ETag": "E1QQG65FS2L2GC", "FieldLevelEncryptionProfileConfig": { "Name": "ExampleFLEProfile", "CallerReference": "cli-example", "Comment": "FLE profile for AWS CLI example", "EncryptionEntities": { "Quantity": 1, "Items": [ { "PublicKeyId": "K2K8NC4HVFE3M0", "ProviderId": "ExampleFLEProvider", "FieldPatterns": { "Quantity": 1, "Items": [ "ExampleSensitiveField" ] } } ] } } } ``` + Einzelheiten zur API finden Sie unter [GetFieldLevelEncryptionProfileConfig AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption-profile-config.html)*Befehlsreferenz*. ### `get-field-level-encryption-profile` Das folgende Codebeispiel zeigt die Verwendung`get-field-level-encryption-profile`. **AWS CLI** **Um ein Verschlüsselungsprofil auf CloudFront Feldebene zu erhalten** Im folgenden Beispiel wird das Verschlüsselungsprofil auf CloudFront Feldebene mit der ID `PPK0UOSIF5WSV` abgerufen, einschließlich seiner: `ETag` ``` aws cloudfront get-field-level-encryption-profile --id PPK0UOSIF5WSV ``` Ausgabe: ``` { "ETag": "E1QQG65FS2L2GC", "FieldLevelEncryptionProfile": { "Id": "PPK0UOSIF5WSV", "LastModifiedTime": "2019-12-10T01:03:16.537Z", "FieldLevelEncryptionProfileConfig": { "Name": "ExampleFLEProfile", "CallerReference": "cli-example", "Comment": "FLE profile for AWS CLI example", "EncryptionEntities": { "Quantity": 1, "Items": [ { "PublicKeyId": "K2K8NC4HVFE3M0", "ProviderId": "ExampleFLEProvider", "FieldPatterns": { "Quantity": 1, "Items": [ "ExampleSensitiveField" ] } } ] } } } } ``` + Einzelheiten zur API finden Sie [GetFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption-profile.html)in der *AWS CLI Befehlsreferenz*. ### `get-field-level-encryption` Das folgende Codebeispiel zeigt die Verwendung`get-field-level-encryption`. **AWS CLI** **Um eine Verschlüsselungskonfiguration auf CloudFront Feldebene zu erhalten** Im folgenden Beispiel wird die Verschlüsselungskonfiguration auf CloudFront Feldebene mit der ID `C3KM2WVD605UAY` abgerufen, einschließlich ihrer: `ETag` ``` aws cloudfront get-field-level-encryption --id C3KM2WVD605UAY ``` Ausgabe: ``` { "ETag": "E2P4Z4VU7TY5SG", "FieldLevelEncryption": { "Id": "C3KM2WVD605UAY", "LastModifiedTime": "2019-12-10T21:30:18.974Z", "FieldLevelEncryptionConfig": { "CallerReference": "cli-example", "Comment": "Example FLE configuration", "QueryArgProfileConfig": { "ForwardWhenQueryArgProfileIsUnknown": true, "QueryArgProfiles": { "Quantity": 0, "Items": [] } }, "ContentTypeProfileConfig": { "ForwardWhenContentTypeIsUnknown": true, "ContentTypeProfiles": { "Quantity": 1, "Items": [ { "Format": "URLEncoded", "ProfileId": "P280MFCLSYOCVU", "ContentType": "application/x-www-form-urlencoded" } ] } } } } } ``` + Einzelheiten zur API finden Sie unter [GetFieldLevelEncryption AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption.html)*Befehlsreferenz*. ### `get-invalidation-for-distribution-tenant` Das folgende Codebeispiel zeigt die Verwendung`get-invalidation-for-distribution-tenant`. **AWS CLI** **So rufen Sie eine Invalidierung für einen Distributionsmandanten ab** Im folgenden Beispiel für `get-invalidation-for-distribution-tenant` werden Informationen zu einer Invalidierung für einen Distributionsmandanten abgerufen. ``` aws cloudfront get-invalidation-for-distribution-tenant \ --distribution-tenant-id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB \ --id I4CU23QAPKMUDUU06F9OFGFABC ``` Ausgabe: ``` { "Invalidation": { "Id": "I4CU23QAPKMUDUU06F9OFGFABC", "Status": "Completed", "CreateTime": "2025-05-06T15:46:12.824000+00:00", "InvalidationBatch": { "Paths": { "Quantity": 2, "Items": [ "/example/invalidation", "/more/invalidations" ] }, "CallerReference": "007ee5a6-d0a0-42be-bb61-e7b915969b48" } } } ``` Weitere Informationen finden Sie unter [Dateien für ungültig erklären, um Inhalte zu entfernen](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [GetInvalidationForDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-invalidation-for-distribution-tenant.html)in der *AWS CLI Befehlsreferenz.* ### `get-invalidation` Das folgende Codebeispiel zeigt die Verwendung`get-invalidation`. **AWS CLI** **Um eine CloudFront Ungültigerklärung zu erhalten** Im folgenden Beispiel wird die Invalidierung mit der ID `I2J0I21PCUYOIK` für die CloudFront Distribution mit der ID abgerufen: `EDFDVBD6EXAMPLE` ``` aws cloudfront get-invalidation --id I2J0I21PCUYOIK --distribution-id EDFDVBD6EXAMPLE ``` Ausgabe: ``` { "Invalidation": { "Status": "Completed", "InvalidationBatch": { "Paths": { "Items": [ "/example-path/example-file.jpg", "/example-path/example-file-2.jpg" ], "Quantity": 2 }, "CallerReference": "cli-example" }, "Id": "I2J0I21PCUYOIK", "CreateTime": "2019-12-05T18:40:49.413Z" } } ``` + Einzelheiten zur API finden Sie unter [GetInvalidation AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-invalidation.html)*Befehlsreferenz.* ### `get-managed-certificate-details` Das folgende Codebeispiel zeigt die Verwendung`get-managed-certificate-details`. **AWS CLI** **So rufen Sie Details zum verwalteten Zertifikat ab** Im folgenden `get-managed-certificate-details` Beispiel werden die Details eines CloudFront verwalteten ACM-Zertifikats abgerufen. ``` aws cloudfront get-managed-certificate-details \ --identifier dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB ``` Ausgabe: ``` { "ManagedCertificateDetails": { "CertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/655dc1fe-6d37-451d-a013-c2db3a034abc", "CertificateStatus": "pending-validation", "ValidationTokenHost": "self-hosted", "ValidationTokenDetails": [ { "Domain": "example.com", "RedirectTo": "validation.us-east-1.acm-validations.aws/123456789012/.well-known/pki-validation/b315c9ae21284e7918bb9f3f422ab1c7.txt", "RedirectFrom": "example.com/.well-known/pki-validation/b315c9ae21284e7918bb9f3f422ac3c7.txt" } ] } } ``` Weitere Informationen finden Sie im *Amazon CloudFront Developer Guide* unter [Zertifikate für Ihren CloudFront Distributionsmandanten anfordern](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/managed-cloudfront-certificates.html). + Einzelheiten zur API finden Sie [GetManagedCertificateDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-managed-certificate-details.html)unter *AWS CLI Befehlsreferenz*. ### `get-public-key-config` Das folgende Codebeispiel zeigt die Verwendung`get-public-key-config`. **AWS CLI** **Um eine Konfiguration mit CloudFront öffentlichen Schlüsseln zu erhalten** Im folgenden Beispiel werden Metadaten über den CloudFront öffentlichen Schlüssel mit der ID abgerufen`KDFB19YGCR002`, einschließlich seiner`ETag`. Die ID des öffentlichen Schlüssels wird in den list-public-keys Befehlen create-public-key und zurückgegeben. ``` aws cloudfront get-public-key-config --id KDFB19YGCR002 ``` Ausgabe: ``` { "ETag": "E2QWRUHEXAMPLE", "PublicKeyConfig": { "CallerReference": "cli-example", "Name": "ExampleKey", "EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n", "Comment": "example public key" } } ``` + Einzelheiten zur API finden Sie [GetPublicKeyConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-public-key-config.html)in der *AWS CLI Befehlsreferenz*. ### `get-public-key` Das folgende Codebeispiel zeigt die Verwendung`get-public-key`. **AWS CLI** **Um einen CloudFront öffentlichen Schlüssel zu erhalten** Das folgende Beispiel ruft den CloudFront öffentlichen Schlüssel mit der ID ab`KDFB19YGCR002`, einschließlich seiner`ETag`. Die ID des öffentlichen Schlüssels wird in den list-public-keys Befehlen create-public-key und zurückgegeben. ``` aws cloudfront get-public-key --id KDFB19YGCR002 ``` Ausgabe: ``` { "ETag": "E2QWRUHEXAMPLE", "PublicKey": { "Id": "KDFB19YGCR002", "CreatedTime": "2019-12-05T18:51:43.781Z", "PublicKeyConfig": { "CallerReference": "cli-example", "Name": "ExampleKey", "EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n", "Comment": "example public key" } } } ``` + Einzelheiten zur API finden Sie [GetPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-public-key.html)in der *AWS CLI Befehlsreferenz*. ### `list-cloud-front-origin-access-identities` Das folgende Codebeispiel zeigt die Verwendung`list-cloud-front-origin-access-identities`. **AWS CLI** **Um die ursprünglichen CloudFront Zugriffsidentitäten aufzulisten** Im folgenden Beispiel wird eine Liste der ursprünglichen CloudFront Zugriffsidentitäten (OAIs) in Ihrem AWS Konto abgerufen: ``` aws cloudfront list-cloud-front-origin-access-identities ``` Ausgabe: ``` { "CloudFrontOriginAccessIdentityList": { "Items": [ { "Id": "E74FTE3AEXAMPLE", "S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE", "Comment": "Example OAI" }, { "Id": "EH1HDMBEXAMPLE", "S3CanonicalUserId": "1489f6f2e6faacaae7ff64c4c3e6956c24f78788abfc1718c3527c263bf7a17EXAMPLE", "Comment": "Test OAI" }, { "Id": "E2X2C9TEXAMPLE", "S3CanonicalUserId": "cbfeebb915a64749f9be546a45b3fcfd3a31c779673c13c4dd460911ae402c2EXAMPLE", "Comment": "Example OAI #2" } ] } } ``` + Einzelheiten zur API finden Sie [ListCloudFrontOriginAccessIdentities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-cloud-front-origin-access-identities.html)in der *AWS CLI Befehlsreferenz.* ### `list-connection-groups` Das folgende Codebeispiel zeigt die Verwendung`list-connection-groups`. **AWS CLI** **So listen Sie Verbindungsgruppen auf** Das folgende `list-connection-groups` Beispiel listet die verfügbaren Verbindungsgruppen in Ihrem AWS Konto auf. ``` aws cloudfront list-connection-groups ``` Ausgabe: ``` { "ConnectionGroups": [ { "Id": "cg_2whCJoXMYCjHcxaLGrkllvyABC", "Name": "CreatedByCloudFront-cg_2whCJoXMYCjHcxaLGrkllvyABC", "Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2whCJoXMYCjHcxaLGrkllvyABC", "RoutingEndpoint": "d3sx0pso7m5abc.cloudfront.net", "CreatedTime": "2025-05-05T22:32:29.630000+00:00", "LastModifiedTime": "2025-05-05T22:32:29.630000+00:00", "ETag": "E23ZP02F085ABC", "Enabled": true, "Status": "Deployed", "IsDefault": true }, { "Id": "cg_2wjDWTBKTlRB87cAaUQFaakABC", "Name": "connection-group-2", "Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2wjDWTBKTlRB87cAaUQFaakABC", "RoutingEndpoint": "dvdg9gprgabc.cloudfront.net", "CreatedTime": "2025-05-06T15:42:00.790000+00:00", "LastModifiedTime": "2025-05-06T15:42:00.790000+00:00", "ETag": "E23ZP02F085ABC", "Enabled": true, "Status": "Deployed", "IsDefault": false } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Verbindungsgruppe erstellen (optional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [ListConnectionGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-connection-groups.html)in der *AWS CLI Befehlsreferenz*. ### `list-distribution-tenants-by-customization` Das folgende Codebeispiel zeigt die Verwendung`list-distribution-tenants-by-customization`. **AWS CLI** **So listen Sie Distributionsmandanten nach Anpassung auf** Im folgenden Beispiel für `list-distribution-tenants-by-customization` werden Distributionsmandanten aufgeführt, die die angegebene Web-ACL verwenden. ``` aws cloudfront list-distribution-tenants-by-customization \ --web-acl-arn arn:aws:wafv2:us-east-1:123456789012:global/webacl/CreatedByCloudFront-0273cd2f/a3c19bce-42b5-48a1-a8d4-b2bb2f28eabc ``` Ausgabe: ``` { "DistributionTenantList": [ { "Id": "dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB", "DistributionId": "E1XNX8R2GOAABC", "Name": "example-tenant-2", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB", "Domains": [ { "Domain": "example.com", "Status": "inactive" } ], "ConnectionGroupId": "cg_2wjDWTBKTlRB87cAaUQFaakABC", "Customizations": { "WebAcl": { "Action": "override", "Arn": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/CreatedByCloudFront-0273cd2f/a3c19bce-42b5-48a1-a8d4-b2bb2f28eabc" }, "GeoRestrictions": { "RestrictionType": "whitelist", "Locations": [ "AL" ] } }, "CreatedTime": "2025-05-06T15:42:28.542000+00:00", "LastModifiedTime": "2025-05-06T16:14:08.710000+00:00", "ETag": "E1F83G8C2ARABC", "Enabled": true, "Status": "Deployed" } ] } ``` Weitere Informationen finden Sie unter [Anpassungen für Distributions-Mandanten](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/tenant-customization.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [ListDistributionTenantsByCustomization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distribution-tenants-by-customization.html)in der *AWS CLI Befehlsreferenz.* ### `list-distribution-tenants` Das folgende Codebeispiel zeigt die Verwendung`list-distribution-tenants`. **AWS CLI** **Um CloudFront Distributionsmandanten aufzulisten** Im folgenden `list-distribution-tenants` Beispiel werden 3 CloudFront Verteilungsmandanten in Ihrem AWS Konto nach der zugehörigen Verbindungsgruppe aufgelistet. ``` aws cloudfront list-distribution-tenants \ --association-filter ConnectionGroupId=cg_2whCJoXMYCjHcxaLGrkllvyABC \ --max-items 3 ``` Ausgabe: ``` { "DistributionTenantList": [ { "Id": "dt_2yMvQgam3QkJo2z54FDl91dk1AB", "DistributionId": "E1XNX8R2GOAABC", "Name": "new-tenant-customizations", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2yMvQgam3QkJo2z54FDl91dk1AB", "Domains": [ { "Domain": "example.com", "Status": "active" } ], "ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC", "Customizations": { "WebAcl": { "Action": "disable" }, "GeoRestrictions": { "RestrictionType": "whitelist", "Locations": [ "DE" ] } }, "CreatedTime": "2025-06-11T15:54:02.142000+00:00", "LastModifiedTime": "2025-06-11T15:54:02.142000+00:00", "ETag": "E23ZP02F085ABC", "Enabled": false, "Status": "Deployed" }, { "Id": "dt_2yMuV7NJuBcAB0cwwxMCBZQ1AB", "DistributionId": "E1XNX8R2GOAABC", "Name": "new-tenant", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2yMuV7NJuBcAB0cwwxMCBZQ1AB", "Domains": [ { "Domain": "1.example.com", "Status": "active" } ], "ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC", "Customizations": { "GeoRestrictions": { "RestrictionType": "whitelist", "Locations": [ "DE" ] } }, "CreatedTime": "2025-06-11T15:46:23.466000+00:00", "LastModifiedTime": "2025-06-11T15:46:23.466000+00:00", "ETag": "E23ZP02F085ABC", "Enabled": false, "Status": "Deployed" }, { "Id": "dt_2xVInRKCfUzQHgxosDs9hiLk1AB", "DistributionId": "E1XNX8R2GOAABC", "Name": "new-tenant-2", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2xVInRKCfUzQHgxosDs9hiLk1AB", "Domains": [ { "Domain": "2.example.com", "Status": "active" } ], "ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC", "CreatedTime": "2025-05-23T16:16:20.871000+00:00", "LastModifiedTime": "2025-05-23T16:16:20.871000+00:00", "ETag": "E23ZP02F085ABC", "Enabled": false, "Status": "Deployed" } ], "NextToken": "eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAzfQ==" } ``` Weitere Informationen finden Sie im *Amazon CloudFront Developer* [Guide unter Grundlegendes zur Funktionsweise von Multi-Tenant-Distributionen](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html). + Einzelheiten zur API finden Sie [ListDistributionTenants](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distribution-tenants.html)in der *AWS CLI Befehlsreferenz*. ### `list-distributions-by-connection-mode` Das folgende Codebeispiel zeigt die Verwendung`list-distributions-by-connection-mode`. **AWS CLI** **Um CloudFront Distributionen nach Verbindungsmodus aufzulisten** Das folgende `list-distributions-by-connection-mode` Beispiel listet CloudFront Distributionen mit dem angegebenen Verbindungsmodus auf. ``` aws cloudfront list-distributions-by-connection-mode \ --connection-mode tenant-only ``` Ausgabe: ``` { "DistributionList": { "Items": [ { "Id": "E1XNX8R2GOAABC", "ARN": "arn:aws:cloudfront::123456789012:distribution/E1XNX8R2GOAABC", "ETag": "EPT4JPJQDY1ABC", "Status": "Deployed", "LastModifiedTime": "2025-05-23T16:16:15.691000+00:00", "DomainName": "-", "Aliases": { "Quantity": 0 }, "Origins": { "Quantity": 1, "Items": [ { "Id": "example-cfn-simple-distribution123", "DomainName": "example.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" }, "ConnectionAttempts": 3, "ConnectionTimeout": 10, "OriginShield": { "Enabled": false }, "OriginAccessControlId": "E2CJRMB5LKEABC" } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "example-cfn-simple-distribution123", "TrustedKeyGroups": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "Compress": true, "LambdaFunctionAssociations": { "Quantity": 0 }, "FunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "", "CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5abc", "GrpcConfig": { "Enabled": false } }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "PriceClass": "PriceClass_All", "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": false, "ACMCertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/ec53f564-ea5a-4e4a-a0a2-e3c989449abc", "SSLSupportMethod": "sni-only", "MinimumProtocolVersion": "TLSv1.2_2021", "Certificate": "arn:aws:acm:us-east-1:123456789012:certificate/ec53f564-ea5a-4e4a-a0a2-e3c989449abc", "CertificateSource": "acm" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f3746cabc", "HttpVersion": "http2", "IsIPV6Enabled": false, "Staging": false, "ConnectionMode": "tenant-only" } ] } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Verbindungsgruppe erstellen (optional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [ListDistributionsByConnectionMode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distributions-by-connection-mode.html)in der *AWS CLI Befehlsreferenz*. ### `list-distributions` Das folgende Codebeispiel zeigt die Verwendung`list-distributions`. **AWS CLI** **Um CloudFront Distributionen aufzulisten** Im folgenden Beispiel wird eine Liste der CloudFront Verteilungen in Ihrem AWS Konto abgerufen. ``` aws cloudfront list-distributions ``` Ausgabe: ``` { "DistributionList": { "Items": [ { "Id": "E23YS8OEXAMPLE", "ARN": "arn:aws:cloudfront::123456789012:distribution/E23YS8OEXAMPLE", "Status": "Deployed", "LastModifiedTime": "2024-08-05T18:23:40.375000+00:00", "DomainName": "abcdefgh12ijk.cloudfront.net", "Aliases": { "Quantity": 0 }, "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" }, "ConnectionAttempts": 3, "ConnectionTimeout": 10, "OriginShield": { "Enabled": false }, "OriginAccessControlId": "EIAP8PEXAMPLE" } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com", "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "TrustedKeyGroups": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "Compress": true, "LambdaFunctionAssociations": { "Quantity": 0 }, "FunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "", "CachePolicyId": "658327ea-f89d-4fab-a63d-7e886EXAMPLE" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "PriceClass": "PriceClass_All", "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "SSLSupportMethod": "vip", "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "HTTP2", "IsIPV6Enabled": true, "Staging": false } ] } } ``` + Einzelheiten zur API finden Sie [ListDistributions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distributions.html)in der *AWS CLI Befehlsreferenz.* ### `list-domain-conflicts` Das folgende Codebeispiel zeigt die Verwendung`list-domain-conflicts`. **AWS CLI** **Um Domänenkonflikte für eine CloudFront Distribution aufzulisten** Im folgenden `list-domain-conflicts` Beispiel werden Domänenkonflikte für eine CloudFront Distribution aufgeführt. ``` aws cloudfront list-domain-conflicts \ --domain example.com \ --domain-control-validation-resource "DistributionTenantId=dt_2x9GhoK0TZRsohWzv1b9It8J1AB" ``` Ausgabe: ``` { "DomainConflicts": [ { "Domain": "example.com", "ResourceType": "distribution-tenant", "ResourceId": "***************ohWzv1b9It8J1AB", "AccountId": "123456789012" } ] } ``` Weitere Informationen finden Sie unter [Verschieben eines alternativen Domainnamens in eine andere Distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/alternate-domain-names-move.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [ListDomainConflicts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-domain-conflicts.html)in der *AWS CLI Befehlsreferenz*. ### `list-field-level-encryption-configs` Das folgende Codebeispiel zeigt die Verwendung`list-field-level-encryption-configs`. **AWS CLI** **Um Verschlüsselungskonfigurationen auf CloudFront Feldebene aufzulisten** Im folgenden Beispiel wird eine Liste der Verschlüsselungskonfigurationen auf CloudFront Feldebene in Ihrem Konto abgerufen: AWS ``` aws cloudfront list-field-level-encryption-configs ``` Ausgabe: ``` { "FieldLevelEncryptionList": { "MaxItems": 100, "Quantity": 1, "Items": [ { "Id": "C3KM2WVD605UAY", "LastModifiedTime": "2019-12-10T21:30:18.974Z", "Comment": "Example FLE configuration", "QueryArgProfileConfig": { "ForwardWhenQueryArgProfileIsUnknown": true, "QueryArgProfiles": { "Quantity": 0, "Items": [] } }, "ContentTypeProfileConfig": { "ForwardWhenContentTypeIsUnknown": true, "ContentTypeProfiles": { "Quantity": 1, "Items": [ { "Format": "URLEncoded", "ProfileId": "P280MFCLSYOCVU", "ContentType": "application/x-www-form-urlencoded" } ] } } } ] } } ``` + Einzelheiten zur API finden Sie [ListFieldLevelEncryptionConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-field-level-encryption-configs.html)in der *AWS CLI Befehlsreferenz*. ### `list-field-level-encryption-profiles` Das folgende Codebeispiel zeigt die Verwendung`list-field-level-encryption-profiles`. **AWS CLI** **Um Verschlüsselungsprofile auf CloudFront Feldebene aufzulisten** Im folgenden Beispiel wird eine Liste der Verschlüsselungsprofile auf CloudFront Feldebene in Ihrem Konto abgerufen: AWS ``` aws cloudfront list-field-level-encryption-profiles ``` Ausgabe: ``` { "FieldLevelEncryptionProfileList": { "MaxItems": 100, "Quantity": 2, "Items": [ { "Id": "P280MFCLSYOCVU", "LastModifiedTime": "2019-12-05T01:05:39.896Z", "Name": "ExampleFLEProfile", "EncryptionEntities": { "Quantity": 1, "Items": [ { "PublicKeyId": "K2K8NC4HVFE3M0", "ProviderId": "ExampleFLEProvider", "FieldPatterns": { "Quantity": 1, "Items": [ "ExampleSensitiveField" ] } } ] }, "Comment": "FLE profile for AWS CLI example" }, { "Id": "PPK0UOSIF5WSV", "LastModifiedTime": "2019-12-10T01:03:16.537Z", "Name": "ExampleFLEProfile2", "EncryptionEntities": { "Quantity": 1, "Items": [ { "PublicKeyId": "K2ABC10EXAMPLE", "ProviderId": "ExampleFLEProvider2", "FieldPatterns": { "Quantity": 1, "Items": [ "ExampleSensitiveField2" ] } } ] }, "Comment": "FLE profile #2 for AWS CLI example" } ] } } ``` + Einzelheiten zur API finden Sie [ListFieldLevelEncryptionProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-field-level-encryption-profiles.html)in der *AWS CLI Befehlsreferenz*. ### `list-invalidations-for-distribution-tenant` Das folgende Codebeispiel zeigt die Verwendung`list-invalidations-for-distribution-tenant`. **AWS CLI** **Um Ungültigkeiten für einen CloudFront Distributionsmandanten aufzulisten** Im folgenden `list-invalidations-for-distribution-tenant` Beispiel werden die Ungültigerklärungen für einen Verteilungsmandanten aufgeführt. CloudFront ``` aws cloudfront list-invalidations-for-distribution-tenant \ --id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB ``` Ausgabe: ``` { "InvalidationList": { "Items": [ { "Id": "I4CU23QAPKMUDUU06F9OFGFABC", "CreateTime": "2025-05-06T15:46:12.824000+00:00", "Status": "Completed" } ] } } ``` Weitere Informationen finden Sie unter [Dateien für ungültig erklären, um Inhalte zu entfernen](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [ListInvalidationsForDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-invalidations-for-distribution-tenant.html)in der *AWS CLI Befehlsreferenz.* ### `list-invalidations` Das folgende Codebeispiel zeigt die Verwendung`list-invalidations`. **AWS CLI** **Um CloudFront Ungültigkeiten aufzulisten** Im folgenden Beispiel wird eine Liste der Ungültigerklärungen für die CloudFront Distribution mit der ID abgerufen: `EDFDVBD6EXAMPLE` ``` aws cloudfront list-invalidations --distribution-id EDFDVBD6EXAMPLE ``` Ausgabe: ``` { "InvalidationList": { "Marker": "", "Items": [ { "Status": "Completed", "Id": "YNY2LI2BVJ4NJU", "CreateTime": "2019-08-31T21:15:52.042Z" } ], "IsTruncated": false, "MaxItems": 100, "Quantity": 1 } } ``` + Einzelheiten zur API finden Sie unter [ListInvalidations AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-invalidations.html)*Befehlsreferenz*. ### `list-public-keys` Das folgende Codebeispiel zeigt die Verwendung`list-public-keys`. **AWS CLI** **Um CloudFront öffentliche Schlüssel aufzulisten** Im folgenden Beispiel wird eine Liste der CloudFront öffentlichen Schlüssel in Ihrem AWS Konto abgerufen: ``` aws cloudfront list-public-keys ``` Ausgabe: ``` { "PublicKeyList": { "MaxItems": 100, "Quantity": 2, "Items": [ { "Id": "K2K8NC4HVFE3M0", "Name": "ExampleKey", "CreatedTime": "2019-12-05T01:04:28.818Z", "EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n", "Comment": "example public key" }, { "Id": "K1S0LWQ2L5HTBU", "Name": "ExampleKey2", "CreatedTime": "2019-12-09T23:28:11.110Z", "EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApOCAg88A8+f4dujn9Izt\n26LxtgAkn2opGgo/NKpMiaisyw5qlg3f1gol7FV6pYNl78iJg3EO8JBbwtlH+cR9\nLGSf60NDeVhm76Oc39Np/vWgOdsGQcRbi9WmKZeSODqjQGzVZWqPmito3FzWVk6b\nfVY5N36U/RdbVAJm95Km+qaMYlbIdF40t72bi3IkKYV5hlB2XoDjlQ9F6ajQKyTB\nMHa3SN8q+3ZjQ4sJJ7D1V6r4wR8jDcFVD5NckWJmmgIVnkOQM37NYeoDnkaOuTpu\nha/+3b8tOb2z3LBVHPkp85zJRAOXacSwf5rZtPYKBNFsixTa2n55k2r218mOkMC4\nUwIDAQAB\n-----END PUBLIC KEY-----", "Comment": "example public key #2" } ] } } ``` + Einzelheiten zur API finden Sie [ListPublicKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-public-keys.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Um Tags für eine CloudFront Distribution aufzulisten** Im folgenden Beispiel wird eine Liste der Tags für eine CloudFront Distribution abgerufen: ``` aws cloudfront list-tags-for-resource \ --resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE ``` Ausgabe: ``` { "Tags": { "Items": [ { "Key": "DateCreated", "Value": "2019-12-04" }, { "Key": "Name", "Value": "Example name" }, { "Key": "Project", "Value": "Example project" } ] } } ``` + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `sign` Das folgende Codebeispiel zeigt die Verwendung`sign`. **AWS CLI** **Um eine CloudFront URL zu signieren** Das folgende Beispiel signiert eine CloudFront URL. Um eine URL zu signieren, benötigen Sie die Schlüsselpaar-ID (in der AWS Management Console als **Access Key-ID** bezeichnet) und den privaten Schlüssel des CloudFront key pair des vertrauenswürdigen Unterzeichners. Weitere Informationen zu signierten URLs finden Sie unter [Bereitstellung privater Inhalte mit signierten URLs und signierten Cookies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) im *Amazon CloudFront Developer Guide*. ``` aws cloudfront sign \ --url https://d111111abcdef8.cloudfront.net/private-content/private-file.html \ --key-pair-id APKAEIBAERJR2EXAMPLE \ --private-key file://cf-signer-priv-key.pem \ --date-less-than 2020-01-01 ``` Ausgabe: ``` https://d111111abcdef8.cloudfront.net/private-content/private-file.html?Expires=1577836800&Signature=nEXK7Kby47XKeZQKVc6pwkif6oZc-JWSpDkH0UH7EBGGqvgurkecCbgL5VfUAXyLQuJxFwRQWscz-owcq9KpmewCXrXQbPaJZNi9XSNwf4YKurPDQYaRQawKoeenH0GFteRf9ELK-Bs3nljTLjtbgzIUt7QJNKXcWr8AuUYikzGdJ4-qzx6WnxXfH~fxg4-GGl6l2kgCpXUB6Jx6K~Y3kpVOdzUPOIqFLHAnJojbhxqrVejomZZ2XrquDvNUCCIbePGnR3d24UPaLXG4FKOqNEaWDIBXu7jUUPwOyQCvpt-GNvjRJxqWf93uMobeMOiVYahb-e0KItiQewGcm0eLZQ__&Key-Pair-Id=APKAEIBAERJR2EXAMPLE ``` + Weitere API-Informationen finden Sie unter [Sign](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/sign.html) in der *AWS CLI -Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung von`tag-resource`. **AWS CLI** **Um eine CloudFront Distribution zu taggen** Im folgenden `tag-resource` Beispiel werden der angegebenen CloudFront Verteilung zwei Tags hinzugefügt. ``` aws cloudfront tag-resource \ --resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE \ --tags 'Items=[{Key=Name,Value="Example name"},{Key=Project,Value="Example project"}]' ``` Statt Befehlszeilenargumente zu verwenden, können Sie die Tags in einer JSON-Datei angeben, wie im folgenden Beispiel gezeigt: ``` aws cloudfront tag-resource \ --resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE \ --tags file://tags.json ``` Inhalt von `tags.json`: ``` { "Items": [ { "Key": "Name", "Value": "Example name" }, { "Key": "Project", "Value": "Example project" } ] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/tag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Um Tags aus einer CloudFront Distribution zu entfernen** Im folgenden Beispiel werden mithilfe von Befehlszeilenargumenten zwei Tags aus einer CloudFront Distribution entfernt: ``` aws cloudfront untag-resource \ --resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE \ --tag-keys Items=Name,Project ``` Statt Befehlszeilenargumente zu verwenden, können Sie die Tag-Schlüssel in einer JSON-Datei angeben, wie im folgenden Beispiel gezeigt: ``` aws cloudfront untag-resource \ --resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE \ --tag-keys file://tag-keys.json ``` Die Datei `tag-keys.json` ist ein JSON-Dokument im aktuellen Verzeichnis, das Folgendes enthält: ``` { "Items": [ "Name", "Project" ] } ``` Bei erfolgreicher Ausführung gibt dieser Befehl keine Ausgabe aus. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/untag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `update-cloud-front-origin-access-identity` Das folgende Codebeispiel zeigt die Verwendung`update-cloud-front-origin-access-identity`. **AWS CLI** **Um eine CloudFront ursprüngliche Zugriffsidentität zu aktualisieren** Im folgenden Beispiel wird die Ursprungszugriffsidentität (OAI) mit der ID `E74FTE3AEXAMPLE` aktualisiert. Das einzige Feld, das Sie aktualisieren können, ist das Feld `Comment` der OAI. Um eine OAI zu aktualisieren, benötigen Sie die ID und das `ETag` der OAI. Die OAI-ID wird in der Ausgabe der Befehle create-cloud-front-origin -access-identity und -access-identities zurückgegeben. list-cloud-front-origin Verwenden Sie den Befehl -access-identity oder -, um das `ETag` abzurufen. get-cloud-front-origin get-cloud-front-origin access-identity-config Verwenden Sie die Option `--if-match`, um das OAI-`ETag` bereitzustellen. ``` aws cloudfront update-cloud-front-origin-access-identity \ --id E74FTE3AEXAMPLE \ --if-match E2QWRUHEXAMPLE \ --cloud-front-origin-access-identity-config \ CallerReference=cli-example,Comment="Example OAI Updated" ``` Sie können dasselbe erreichen, indem Sie die OAI-Konfiguration in einer JSON-Datei bereitstellen, wie im folgenden Beispiel gezeigt: ``` aws cloudfront update-cloud-front-origin-access-identity \ --id E74FTE3AEXAMPLE \ --if-match E2QWRUHEXAMPLE \ --cloud-front-origin-access-identity-config file://OAI-config.json ``` Die Datei `OAI-config.json` ist ein JSON-Dokument im aktuellen Verzeichnis, das Folgendes enthält: ``` { "CallerReference": "cli-example", "Comment": "Example OAI Updated" } ``` Unabhängig davon, ob Sie die OAI-Konfiguration mit einem Befehlszeilenargument oder einer JSON-Datei angeben, ist die Ausgabe identisch: ``` { "ETag": "E9LHASXEXAMPLE", "CloudFrontOriginAccessIdentity": { "Id": "E74FTE3AEXAMPLE", "S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE", "CloudFrontOriginAccessIdentityConfig": { "CallerReference": "cli-example", "Comment": "Example OAI Updated" } } } ``` + *Einzelheiten zur API finden Sie [UpdateCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-cloud-front-origin-access-identity.html)in AWS CLI der Befehlsreferenz.* ### `update-connection-group` Das folgende Codebeispiel zeigt die Verwendung`update-connection-group`. **AWS CLI** **Um eine CloudFront Verbindungsgruppe zu aktualisieren** Das folgende `update-connection-group` Beispiel deaktiviert eine CloudFront Verbindungsgruppe und deaktiviert IPv6. ``` aws cloudfront update-connection-group \ --id cg_2yHsDkcPKeUlVkk3aEgLKcjABC \ --no-ipv6-enabled \ --no-enabled \ --if-match E3UN6WX5RRO2ABC ``` Ausgabe: ``` { "ETag": "E1F83G8C2ARABC", "ConnectionGroup": { "Id": "cg_2yHsDkcPKeUlVkk3aEgLKcjABC", "Name": "cg-example", "Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2yHsDkcPKeUlVkk3aEgLKcjABC", "CreatedTime": "2025-06-09T20:58:35.481000+00:00", "LastModifiedTime": "2025-06-11T16:25:54.280000+00:00", "Ipv6Enabled": false, "RoutingEndpoint": "du9xp1elo1abc.cloudfront.net", "Status": "InProgress", "Enabled": false, "IsDefault": false } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Verbindungsgruppe erstellen (optional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [UpdateConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-connection-group.html)in der *AWS CLI Befehlsreferenz*. ### `update-distribution-tenant` Das folgende Codebeispiel zeigt die Verwendung`update-distribution-tenant`. **AWS CLI** **Um einen CloudFront Distributionsmandanten zu aktualisieren** Im folgenden `update-distribution-tenant` Beispiel wird ein CloudFront Distributionsmandant mit einem neuen Parameterwert aktualisiert und den Geoeinschränkungen ein Land hinzugefügt. ``` aws cloudfront update-distribution-tenant \ --cli-input-json file://update-tenant.json ``` Inhalt von `update-tenant.json`: ``` { "Id": "dt_2yMvQgam3QkJo2z54FDl91dk1AB", "IfMatch": "E1F83G8C2ARABC", "Parameters": [ { "Name": "testParam", "Value": "newParameterValue" } ], "Customizations": { "WebAcl": { "Action": "disable" }, "GeoRestrictions": { "RestrictionType": "whitelist", "Locations": [ "DE", "GB", "ES" ] } } } ``` Ausgabe: ``` { "ETag": "E1PA6795UKMABC", "DistributionTenant": { "Id": "dt_2yMvQgam3QkJo2z54FDl91dk1AB", "DistributionId": "E1XNX8R2GOAABC", "Name": "new-tenant-customizations", "Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2yMvQgam3QkJo2z54FDl91dk1AB", "Domains": [ { "Domain": "example.com", "Status": "active" } ], "Customizations": { "WebAcl": { "Action": "disable" }, "GeoRestrictions": { "RestrictionType": "whitelist", "Locations": [ "DE", "ES", "GB" ] } }, "Parameters": [ { "Name": "testParam", "Value": "newParameterValue" } ], "ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC", "CreatedTime": "2025-06-11T15:54:02.142000+00:00", "LastModifiedTime": "2025-06-11T16:42:45.531000+00:00", "Enabled": false, "Status": "InProgress" } } ``` Weitere Informationen finden Sie unter [Anpassungen für Distributions-Mandanten](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/tenant-customization.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [UpdateDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-distribution-tenant.html)in der *AWS CLI Befehlsreferenz.* ### `update-distribution` Das folgende Codebeispiel zeigt die Verwendung`update-distribution`. **AWS CLI** **Beispiel 1: Um das Standard-Root-Objekt einer CloudFront Distribution zu aktualisieren** Im folgenden Beispiel wird das Standard-Stammobjekt `index.html` für die CloudFront Distribution mit der ID aktualisiert`EDFDVBD6EXAMPLE`. ``` aws cloudfront update-distribution \ --id EDFDVBD6EXAMPLE \ --default-root-object index.html ``` Ausgabe: ``` { "ETag": "E2QWRUHEXAMPLE", "Distribution": { "Id": "EDFDVBD6EXAMPLE", "ARN": "arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE", "Status": "InProgress", "LastModifiedTime": "2019-12-06T18:55:39.870Z", "InProgressInvalidationBatches": 0, "DomainName": "d111111abcdef8.cloudfront.net", "ActiveTrustedSigners": { "Enabled": false, "Quantity": 0 }, "DistributionConfig": { "CallerReference": "6b10378d-49be-4c4b-a642-419ccaf8f3b5", "Aliases": { "Quantity": 0 }, "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "example-website", "DomainName": "www.example.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "CustomOriginConfig": { "HTTPPort": 80, "HTTPSPort": 443, "OriginProtocolPolicy": "match-viewer", "OriginSslProtocols": { "Quantity": 2, "Items": [ "SSLv3", "TLSv1" ] }, "OriginReadTimeout": 30, "OriginKeepaliveTimeout": 5 } } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "example-website", "ForwardedValues": { "QueryString": false, "Cookies": { "Forward": "none" }, "Headers": { "Quantity": 1, "Items": [ "*" ] }, "QueryStringCacheKeys": { "Quantity": 0 } }, "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "MinTTL": 0, "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "DefaultTTL": 86400, "MaxTTL": 31536000, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "PriceClass": "PriceClass_All", "Enabled": true, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http1.1", "IsIPV6Enabled": true } } } ``` **Beispiel 2: Um eine CloudFront Distribution zu aktualisieren** Im folgenden Beispiel wird die CloudFront Distribution mit der ID deaktiviert, `EMLARXS9EXAMPLE` indem die Verteilungskonfiguration in einer JSON-Datei mit dem Namen `dist-config-disable.json` bereitgestellt wird. Um eine Distribution zu aktualisieren, müssen Sie die Option `--if-match` verwenden, um das `ETag` der Distribution anzugeben. Verwenden Sie den Befehl get-distribution or `ETag` get-distribution-config, um das abzurufen. Beachten Sie, dass das Feld `Enabled` in der JSON-Datei auf `false` gesetzt ist. Nachdem Sie das folgende Beispiel verwendet haben, um die Distribution zu deaktivieren, können Sie den Befehl „delete-distribution“ verwenden, um sie zu löschen. ``` aws cloudfront update-distribution \ --id EMLARXS9EXAMPLE \ --if-match E2QWRUHEXAMPLE \ --distribution-config file://dist-config-disable.json ``` Inhalt von `dist-config-disable.json`: ``` { "CallerReference": "cli-1574382155-496510", "Aliases": { "Quantity": 0 }, "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-1574382155-273939", "DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-1574382155-273939", "ForwardedValues": { "QueryString": false, "Cookies": { "Forward": "none" }, "Headers": { "Quantity": 0 }, "QueryStringCacheKeys": { "Quantity": 0 } }, "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "MinTTL": 0, "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "DefaultTTL": 86400, "MaxTTL": 31536000, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "PriceClass": "PriceClass_All", "Enabled": false, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "IsIPV6Enabled": true } ``` Ausgabe: ``` { "ETag": "E9LHASXEXAMPLE", "Distribution": { "Id": "EMLARXS9EXAMPLE", "ARN": "arn:aws:cloudfront::123456789012:distribution/EMLARXS9EXAMPLE", "Status": "InProgress", "LastModifiedTime": "2019-12-06T18:32:35.553Z", "InProgressInvalidationBatches": 0, "DomainName": "d111111abcdef8.cloudfront.net", "ActiveTrustedSigners": { "Enabled": false, "Quantity": 0 }, "DistributionConfig": { "CallerReference": "cli-1574382155-496510", "Aliases": { "Quantity": 0 }, "DefaultRootObject": "index.html", "Origins": { "Quantity": 1, "Items": [ { "Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-1574382155-273939", "DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com", "OriginPath": "", "CustomHeaders": { "Quantity": 0 }, "S3OriginConfig": { "OriginAccessIdentity": "" } } ] }, "OriginGroups": { "Quantity": 0 }, "DefaultCacheBehavior": { "TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-1574382155-273939", "ForwardedValues": { "QueryString": false, "Cookies": { "Forward": "none" }, "Headers": { "Quantity": 0 }, "QueryStringCacheKeys": { "Quantity": 0 } }, "TrustedSigners": { "Enabled": false, "Quantity": 0 }, "ViewerProtocolPolicy": "allow-all", "MinTTL": 0, "AllowedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ], "CachedMethods": { "Quantity": 2, "Items": [ "HEAD", "GET" ] } }, "SmoothStreaming": false, "DefaultTTL": 86400, "MaxTTL": 31536000, "Compress": false, "LambdaFunctionAssociations": { "Quantity": 0 }, "FieldLevelEncryptionId": "" }, "CacheBehaviors": { "Quantity": 0 }, "CustomErrorResponses": { "Quantity": 0 }, "Comment": "", "Logging": { "Enabled": false, "IncludeCookies": false, "Bucket": "", "Prefix": "" }, "PriceClass": "PriceClass_All", "Enabled": false, "ViewerCertificate": { "CloudFrontDefaultCertificate": true, "MinimumProtocolVersion": "TLSv1", "CertificateSource": "cloudfront" }, "Restrictions": { "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 } }, "WebACLId": "", "HttpVersion": "http2", "IsIPV6Enabled": true } } } ``` + Einzelheiten zur API finden Sie unter [UpdateDistribution AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-distribution.html)*Befehlsreferenz.* ### `update-domain-association` Das folgende Codebeispiel zeigt die Verwendung`update-domain-association`. **AWS CLI** **So aktualisieren Sie eine Domainzuordnung** Im folgenden `update-domain-association` Beispiel wird eine Domänenzuordnung für einen Verteilungsmandanten mit aktualisiert ETag `E23ZP02F085ABC`. ``` aws cloudfront update-domain-association \ --domain example.com \ --target-resource DistributionTenantId=dt_2x9GhoK0TZRsohWzv1b9It8J1AB \ --if-match E23ZP02F085ABC ``` Ausgabe: ``` { "ETag": "ETVPDKIKX0ABC", "Domain": "example.com", "ResourceId": "dt_2x9GhoK0TZRsohWzv1b9It8J1AB" } ``` Weitere Informationen finden Sie unter [Verschieben eines alternativen Domainnamens in eine andere Distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/alternate-domain-names-move.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [UpdateDomainAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-domain-association.html)in der *AWS CLI Befehlsreferenz*. ### `update-field-level-encryption-config` Das folgende Codebeispiel zeigt die Verwendung`update-field-level-encryption-config`. **AWS CLI** **Um eine Verschlüsselungskonfiguration auf CloudFront Feldebene zu aktualisieren** Im folgenden Beispiel wird das Feld `Comment` der Verschlüsselungskonfiguration auf Feldebene mit der ID `C3KM2WVD605UAY` aktualisiert, indem die Parameter in einer JSON-Datei bereitgestellt werden. Um eine Verschlüsselungskonfiguration auf Feldebene zu aktualisieren, benötigen Sie die ID und das `ETag` der Konfiguration. Die ID wird in der Ausgabe der Befehle create-field-level-encryption -config und list-field-level-encryption -configs zurückgegeben. Verwenden Sie den Befehl get-field-level-encryption oder `ETag` get-field-level-encryption -config, um das abzurufen. Verwenden Sie die Option `--if-match`, um das `ETag` der Konfiguration bereitzustellen. ``` aws cloudfront update-field-level-encryption-config \ --id C3KM2WVD605UAY \ --if-match E2P4Z4VU7TY5SG \ --field-level-encryption-config file://fle-config.json ``` Die Datei `fle-config.json` ist ein JSON-Dokument im aktuellen Verzeichnis, das Folgendes enthält: ``` { "CallerReference": "cli-example", "Comment": "Updated example FLE configuration", "QueryArgProfileConfig": { "ForwardWhenQueryArgProfileIsUnknown": true, "QueryArgProfiles": { "Quantity": 0 } }, "ContentTypeProfileConfig": { "ForwardWhenContentTypeIsUnknown": true, "ContentTypeProfiles": { "Quantity": 1, "Items": [ { "Format": "URLEncoded", "ProfileId": "P280MFCLSYOCVU", "ContentType": "application/x-www-form-urlencoded" } ] } } } ``` Ausgabe: ``` { "ETag": "E26M4BIAV81ZF6", "FieldLevelEncryption": { "Id": "C3KM2WVD605UAY", "LastModifiedTime": "2019-12-10T22:26:26.170Z", "FieldLevelEncryptionConfig": { "CallerReference": "cli-example", "Comment": "Updated example FLE configuration", "QueryArgProfileConfig": { "ForwardWhenQueryArgProfileIsUnknown": true, "QueryArgProfiles": { "Quantity": 0, "Items": [] } }, "ContentTypeProfileConfig": { "ForwardWhenContentTypeIsUnknown": true, "ContentTypeProfiles": { "Quantity": 1, "Items": [ { "Format": "URLEncoded", "ProfileId": "P280MFCLSYOCVU", "ContentType": "application/x-www-form-urlencoded" } ] } } } } } ``` + Einzelheiten zur API finden Sie [UpdateFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-field-level-encryption-config.html)in der *AWS CLI Befehlsreferenz.* ### `update-field-level-encryption-profile` Das folgende Codebeispiel zeigt die Verwendung`update-field-level-encryption-profile`. **AWS CLI** **Um ein Verschlüsselungsprofil auf CloudFront Feldebene zu aktualisieren** Im folgenden Beispiel wird das Verschlüsselungsprofil auf Feldebene mit der ID `PPK0UOSIF5WSV` aktualisiert. In diesem Beispiel werden die Parameter `Name` und `Comment` des Profils aktualisiert und ein zweites `FieldPatterns`-Element wird hinzugefügt, indem die Parameter in einer JSON-Datei bereitgestellt werden. Um ein Verschlüsselungsprofil auf Feldebene zu aktualisieren, benötigen Sie die ID und das `ETag` des Profils. Die ID wird in der Ausgabe der Befehle create-field-level-encryption -profile und list-field-level-encryption -profiles zurückgegeben. Verwenden Sie den Befehl get-field-level-encryption -profile oder get-field-level-encryption -profile-config`ETag`, um das abzurufen. Verwenden Sie die Option `--if-match`, um das `ETag` des Profils bereitzustellen. ``` aws cloudfront update-field-level-encryption-profile \ --id PPK0UOSIF5WSV \ --if-match E1QQG65FS2L2GC \ --field-level-encryption-profile-config file://fle-profile-config.json ``` Die Datei `fle-profile-config.json` ist ein JSON-Dokument im aktuellen Verzeichnis, das Folgendes enthält: ``` { "Name": "ExampleFLEProfileUpdated", "CallerReference": "cli-example", "Comment": "Updated FLE profile for AWS CLI example", "EncryptionEntities": { "Quantity": 1, "Items": [ { "PublicKeyId": "K2K8NC4HVFE3M0", "ProviderId": "ExampleFLEProvider", "FieldPatterns": { "Quantity": 2, "Items": [ "ExampleSensitiveField", "SecondExampleSensitiveField" ] } } ] } } ``` Ausgabe: ``` { "ETag": "EJETYFJ9CL66D", "FieldLevelEncryptionProfile": { "Id": "PPK0UOSIF5WSV", "LastModifiedTime": "2019-12-10T19:05:58.296Z", "FieldLevelEncryptionProfileConfig": { "Name": "ExampleFLEProfileUpdated", "CallerReference": "cli-example", "Comment": "Updated FLE profile for AWS CLI example", "EncryptionEntities": { "Quantity": 1, "Items": [ { "PublicKeyId": "K2K8NC4HVFE3M0", "ProviderId": "ExampleFLEProvider", "FieldPatterns": { "Quantity": 2, "Items": [ "ExampleSensitiveField", "SecondExampleSensitiveField" ] } } ] } } } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [UpdateFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-field-level-encryption-profile.html).AWS CLI * ### `verify-dns-configuration` Das folgende Codebeispiel zeigt die Verwendung`verify-dns-configuration`. **AWS CLI** **So überprüfen Sie die DNS-Konfiguration für eine Domain** Im folgenden Beispiel für `verify-dns-configuration` wird die DNS-Konfiguration für eine Domain überprüft. ``` aws cloudfront verify-dns-configuration \ --domain example.com \ --identifier dt_2x9GhoK0TZRsohWzv1b9It8J1AB ``` Ausgabe: ``` { "DnsConfigurationList": [ { "Domain": "example.com", "Status": "valid-configuration" } ] } ``` Weitere Informationen finden Sie unter [Verschieben eines alternativen Domainnamens in eine andere Distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/alternate-domain-names-move.html) im *Amazon CloudFront Developer Guide*. + Einzelheiten zur API finden Sie [VerifyDnsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/verify-dns-configuration.html)in der *AWS CLI Befehlsreferenz*. # CloudSearch Amazon-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS Command Line Interface mit Amazon verwenden CloudSearch. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `upload-documents` Das folgende Codebeispiel zeigt, wie Sie`upload-documents`. **AWS CLI** Der folgende `upload-documents` Befehl lädt einen Stapel von JSON-Dokumenten in eine CloudSearch Amazon-Domain hoch: ``` aws cloudsearchdomain upload-documents --endpoint-url https://doc-my-domain.us-west-1.cloudsearch.amazonaws.com --content-type application/json --documents document-batch.json ``` Ausgabe: ``` { "status": "success", "adds": 5000, "deletes": 0 } ``` + Einzelheiten zur API finden Sie [UploadDocuments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudsearchdomain/upload-documents.html)in der *AWS CLI Befehlsreferenz.* # CloudTrail Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CloudTrail. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-tags` Das folgende Codebeispiel zeigt, wie Sie`add-tags`. **AWS CLI** **So fügen Sie dem Trail Tags hinzu** Der folgende `add-tags`-Befehl fügt Tags für `Trail1` hinzu: ``` aws cloudtrail add-tags --resource-id arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1 --tags-list Key=name,Value=Alice Key=location,Value=us ``` + Einzelheiten zur API finden Sie [AddTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/add-tags.html)in der *AWS CLI Befehlsreferenz*. ### `create-subscription` Das folgende Codebeispiel zeigt die Verwendung`create-subscription`. **AWS CLI** **Um AWS Ressourcen für einen Trail zu erstellen und zu konfigurieren** Der folgende `create-subscription`-Befehl erstellt einen neuen S3-Bucket und ein neues SNS-Thema für `Trail1`. ``` aws cloudtrail create-subscription \ --name Trail1 \ --s3-new-bucket amzn-s3-demo-bucket \ --sns-new-topic my-topic ``` Ausgabe: ``` Setting up new S3 bucket amzn-s3-demo-bucket... Setting up new SNS topic my-topic... Creating/updating CloudTrail configuration... CloudTrail configuration: { "trailList": [ { "IncludeGlobalServiceEvents": true, "Name": "Trail1", "TrailARN": "arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1", "LogFileValidationEnabled": false, "IsMultiRegionTrail": false, "S3BucketName": "amzn-s3-demo-bucket", "SnsTopicName": "my-topic", "HomeRegion": "us-east-1" } ], "ResponseMetadata": { "HTTPStatusCode": 200, "RequestId": "f39e51f6-c615-11e5-85bd-d35ca21ee3e2" } } Starting CloudTrail service... Logs will be delivered to my-bucket ``` + Einzelheiten zur API finden Sie [CreateSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/create-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `create-trail` Das folgende Codebeispiel zeigt die Verwendung`create-trail`. **AWS CLI** **So erstellen Sie einen Trail** Im folgenden Beispiel für `create-trail` wird ein Multi-Region-Trail mit dem Namen `Trail1` erstellt und ein S3-Bucket angegeben. ``` aws cloudtrail create-trail \ --name Trail1 \ --s3-bucket-name amzn-s3-demo-bucket \ --is-multi-region-trail ``` Ausgabe: ``` { "IncludeGlobalServiceEvents": true, "Name": "Trail1", "TrailARN": "arn:aws:cloudtrail:us-west-2:123456789012:trail/Trail1", "LogFileValidationEnabled": false, "IsMultiRegionTrail": true, "S3BucketName": "amzn-s3-demo-bucket" } ``` + Einzelheiten zur API finden Sie [CreateTrail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/create-trail.html)in der *AWS CLI Befehlsreferenz*. ### `delete-trail` Das folgende Codebeispiel zeigt die Verwendung`delete-trail`. **AWS CLI** **So löschen Sie einen Trail** Der folgende `delete-trail`-Befehl löscht einen Trail mit dem Namen `Trail1`: ``` aws cloudtrail delete-trail --name Trail1 ``` + Einzelheiten zur API finden Sie [DeleteTrail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/delete-trail.html)in der *AWS CLI Befehlsreferenz*. ### `describe-trails` Das folgende Codebeispiel zeigt die Verwendung`describe-trails`. **AWS CLI** **So beschreiben Sie einen Trail** Im folgenden Beispiel für `describe-trails` wird der Wert für `Trail1` und `Trail2` zurückgegeben. ``` aws cloudtrail describe-trails \ --trail-name-list Trail1 Trail2 ``` Ausgabe: ``` { "trailList": [ { "IncludeGlobalServiceEvents": true, "Name": "Trail1", "TrailARN": "arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1", "LogFileValidationEnabled": false, "IsMultiRegionTrail": false, "S3BucketName": "amzn-s3-demo-bucket", "CloudWatchLogsRoleArn": "arn:aws:iam::123456789012:role/CloudTrail_CloudWatchLogs_Role", "CloudWatchLogsLogGroupArn": "arn:aws:logs:us-east-1:123456789012:log-group:CloudTrail:*", "SnsTopicName": "my-topic", "HomeRegion": "us-east-1" }, { "IncludeGlobalServiceEvents": true, "Name": "Trail2", "S3KeyPrefix": "my-prefix", "TrailARN": "arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail2", "LogFileValidationEnabled": false, "IsMultiRegionTrail": false, "S3BucketName": "amzn-s3-demo-bucket2", "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/4c5ae5ac-3c13-421e-8335-c7868ef6a769", "HomeRegion": "us-east-1" } ] } ``` + Einzelheiten zur API finden Sie [DescribeTrails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/describe-trails.html)in der *AWS CLI Befehlsreferenz*. ### `get-event-selectors` Das folgende Codebeispiel zeigt die Verwendung`get-event-selectors`. **AWS CLI** **So zeigen Sie die Einstellungen für die Ereignisauswahl für einen Trail an** Im folgenden Beispiel für `get-event-selectors` werden die Einstellungen für `Trail1` zurückgegeben: ``` aws cloudtrail get-event-selectors --trail-name Trail1 ``` Ausgabe: ``` { "EventSelectors": [ { "IncludeManagementEvents": true, "DataResources": [], "ReadWriteType": "All" } ], "TrailARN": "arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1" } ``` + Einzelheiten zur API finden Sie [GetEventSelectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/get-event-selectors.html)in der *AWS CLI Befehlsreferenz*. ### `get-trail-status` Das folgende Codebeispiel zeigt die Verwendung`get-trail-status`. **AWS CLI** **So rufen Sie den Status eines Trails ab** Der folgende `get-trail-status`-Befehl gibt die Liefer- und Protokollierungsdetails für `Trail1` zurück: ``` aws cloudtrail get-trail-status --name Trail1 ``` Ausgabe: ``` { "LatestNotificationTime": 1454022144.869, "LatestNotificationAttemptSucceeded": "2016-01-28T23:02:24Z", "LatestDeliveryAttemptTime": "2016-01-28T23:02:24Z", "LatestDeliveryTime": 1454022144.869, "TimeLoggingStarted": "2015-11-06T18:36:38Z", "LatestDeliveryAttemptSucceeded": "2016-01-28T23:02:24Z", "IsLogging": true, "LatestCloudWatchLogsDeliveryTime": 1454022144.918, "StartLoggingTime": 1446834998.695, "StopLoggingTime": 1446834996.933, "LatestNotificationAttemptTime": "2016-01-28T23:02:24Z", "TimeLoggingStopped": "2015-11-06T18:36:36Z" } ``` + Einzelheiten zur API finden Sie [GetTrailStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/get-trail-status.html)in der *AWS CLI Befehlsreferenz*. ### `list-public-keys` Das folgende Codebeispiel zeigt die Verwendung`list-public-keys`. **AWS CLI** **So listen Sie alle öffentlichen Schlüssel für einen Trail auf** Der folgende `list-public-keys`-Befehl gibt alle öffentlichen Schlüssel, deren private Schlüssel zum Signieren der Digest-Dateien verwendet wurden, für den angegebenen Zeitraum zurück: ``` aws cloudtrail list-public-keys --start-time 2016-01-01T20:30:00.000Z ``` Ausgabe: ``` { "PublicKeyList": [ { "ValidityStartTime": 1453076702.0, "ValidityEndTime": 1455668702.0, "Value": "MIIBCgKCAQEAlSS3cl92HDycr/MTj0moOhas8habjrraXw+KzlWF0axSI2tcF+3iJ9BKQAVSKxGwxwu3m0wG3J+kUl1xboEcEPHYoIYMbgfSw7KGnuDKwkLzsQWhUJ0cIbOHASox1vv/5fNXkrHhGbDCHeVXm804c83nvHUEFYThr1PfyP/8HwrCtR3FX5OANtQCP61C1nJtSSkC8JSQUOrIP4CuwJjc+4WGDk+BGH5m9iuiAKkipEHWmUl8/P7XpfpWQuk4h8g3pXZOrNXr08lbh4d39svj7UqdhvOXoBISp9t/EXYuePGEtBdrKD9Dz+VHwyUPtBQvYr9BnkF88qBnaPNhS44rzwIDAQAB", "Fingerprint": "7f3f401420072e50a65a141430817ab3" } ] } ``` + Einzelheiten zur API finden Sie [ListPublicKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/list-public-keys.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags` Das folgende Codebeispiel zeigt die Verwendung`list-tags`. **AWS CLI** **So listen Sie die Tags für einen Trail auf** Der folgende `list-tags`-Befehl listet die Tags für `Trail1` und `Trail2` auf: ``` aws cloudtrail list-tags --resource-id-list arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1 arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail2 ``` Ausgabe: ``` { "ResourceTagList": [ { "ResourceId": "arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1", "TagsList": [ { "Value": "Alice", "Key": "name" }, { "Value": "us", "Key": "location" } ] }, { "ResourceId": "arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail2", "TagsList": [ { "Value": "Bob", "Key": "name" } ] } ] } ``` + Einzelheiten zur API finden Sie [ListTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/list-tags.html)in der *AWS CLI Befehlsreferenz*. ### `lookup-events` Das folgende Codebeispiel zeigt die Verwendung`lookup-events`. **AWS CLI** **So rufen Sie Ereignisse für einen Trail ab** Der folgende `lookup-events`-Befehl ruft API-Aktivitätsereignisse anhand des Attributs `EventName` ab: ``` aws cloudtrail lookup-events --lookup-attributes AttributeKey=EventName,AttributeValue=ConsoleLogin ``` Ausgabe: ``` { "Events": [ { "EventId": "654ccbc0-ba0d-486a-9076-dbf7274677a7", "Username": "my-session-name", "EventTime": "2021-11-18T09:41:02-08:00", "CloudTrailEvent": "{\"eventVersion\":\"1.02\",\"userIdentity\":{\"type\":\"AssumedRole\",\"principalId\":\"AROAJIKPFTA72SWU4L7T4:my-session-name\",\"arn\":\"arn:aws:sts::123456789012:assumed-role/my-role/my-session-name\",\"accountId\":\"123456789012\",\"sessionContext\":{\"attributes\":{\"mfaAuthenticated\":\"false\",\"creationDate\":\"2016-01-26T21:42:12Z\"},\"sessionIssuer\":{\"type\":\"Role\",\"principalId\":\"AROAJIKPFTA72SWU4L7T4\",\"arn\":\"arn:aws:iam::123456789012:role/my-role\",\"accountId\":\"123456789012\",\"userName\":\"my-role\"}}},\"eventTime\":\"2016-01-26T21:42:12Z\",\"eventSource\":\"signin.amazonaws.com\",\"eventName\":\"ConsoleLogin\",\"awsRegion\":\"us-east-1\",\"sourceIPAddress\":\"72.21.198.70\",\"userAgent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.111 Safari/537.36\",\"requestParameters\":null,\"responseElements\":{\"ConsoleLogin\":\"Success\"},\"additionalEventData\":{\"MobileVersion\":\"No\",\"MFAUsed\":\"No\"},\"eventID\":\"654ccbc0-ba0d-486a-9076-dbf7274677a7\",\"eventType\":\"AwsConsoleSignIn\",\"recipientAccountId\":\"123456789012\"}", "EventName": "ConsoleLogin", "Resources": [] } ] } ``` + Einzelheiten zur API finden Sie [LookupEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/lookup-events.html)in der *AWS CLI Befehlsreferenz*. ### `put-event-selectors` Das folgende Codebeispiel zeigt die Verwendung`put-event-selectors`. **AWS CLI** **Beispiel 1: Konfigurieren eines Trails zum Protokollieren erweiterter Verwaltungs- und Datenereignisse mithilfe der erweiterten Ereignisauswahl** Sie können erweiterte Ereignisauswahlen und Bedingungen hierfür hinzufügen. Dabei gilt ein Höchstwert von 500 Werten für alle Bedingungen und Auswahlen in einem Trail. Sie können erweiterte Ereignisauswahlen verwenden, um alle verfügbaren Datenereignistypen zu protokollieren. Sie können entweder erweiterte Ereignisselektoren oder einfache Ereignisselektoren verwenden, aber nicht beide. Wenn Sie erweiterte Ereignisselektoren auf einen Trail anwenden, werden alle vorhandenen grundlegenden Ereignisselektoren überschrieben. Im folgenden `put-event-selectors` Beispiel wird eine erweiterte Ereignisauswahl für einen Trail mit dem Namen erstellt, um alle Verwaltungsereignisse `myTrail` zu protokollieren, S3 PutObject - und DeleteObject API-Aufrufe für alle bis auf einen S3-Bucket zu protokollieren, Daten-API-Aufrufe für eine Lambda-Funktion mit dem Namen `myFunction` zu protokollieren und Publish-API-Aufrufe zu einem SNS-Thema mit dem Namen zu protokollieren. `myTopic` ``` aws cloudtrail put-event-selectors \ --trail-name myTrail \ --advanced-event-selectors '[{"Name": "Log all management events", "FieldSelectors": [{ "Field": "eventCategory", "Equals": ["Management"] }] },{"Name": "Log PutObject and DeleteObject events for all but one bucket","FieldSelectors": [{ "Field": "eventCategory", "Equals": ["Data"] },{ "Field": "resources.type", "Equals": ["AWS::S3::Object"] },{ "Field": "eventName", "Equals": ["PutObject","DeleteObject"] },{ "Field": "resources.ARN", "NotStartsWith": ["arn:aws:s3:::amzn-s3-demo-bucket/"] }]},{"Name": "Log data events for a specific Lambda function","FieldSelectors": [{ "Field": "eventCategory", "Equals": ["Data"] },{ "Field": "resources.type", "Equals": ["AWS::Lambda::Function"] },{ "Field": "resources.ARN", "Equals": ["arn:aws:lambda:us-east-1:123456789012:function:myFunction"] }]},{"Name": "Log all Publish API calls on a specific SNS topic","FieldSelectors": [{ "Field": "eventCategory", "Equals": ["Data"] },{ "Field": "resources.type", "Equals": ["AWS::SNS::Topic"] },{ "Field": "eventName", "Equals": ["Publish"] },{ "Field": "resources.ARN", "Equals": ["arn:aws:sns:us-east-1:123456789012:myTopic.fifo"] }]}]' ``` Ausgabe: ``` { "TrailARN": "arn:aws:cloudtrail:us-east-1:123456789012:trail/myTrail", "AdvancedEventSelectors": [ { "Name": "Log all management events", "FieldSelectors": [ { "Field": "eventCategory", "Equals": [ "Management" ] } ] }, { "Name": "Log PutObject and DeleteObject events for all but one bucket", "FieldSelectors": [ { "Field": "eventCategory", "Equals": [ "Data" ] }, { "Field": "resources.type", "Equals": [ "AWS::S3::Object" ] }, { "Field": "eventName", "Equals": [ "PutObject", "DeleteObject" ] }, { "Field": "resources.ARN", "NotStartsWith": [ "arn:aws:s3:::amzn-s3-demo-bucket/" ] } ] }, { "Name": "Log data events for a specific Lambda function", "FieldSelectors": [ { "Field": "eventCategory", "Equals": [ "Data" ] }, { "Field": "resources.type", "Equals": [ "AWS::Lambda::Function" ] }, { "Field": "resources.ARN", "Equals": [ "arn:aws:lambda:us-east-1:123456789012:function:myFunction" ] } ] }, { "Name": "Log all Publish API calls on a specific SNS topic", "FieldSelectors": [ { "Field": "eventCategory", "Equals": [ "Data" ] }, { "Field": "resources.type", "Equals": [ "AWS::SNS::Topic" ] }, { "Field": "eventName", "Equals": [ "Publish" ] }, { "Field": "resources.ARN", "Equals": [ "arn:aws:sns:us-east-1:123456789012:myTopic.fifo" ] } ] } ] } ``` *Weitere Informationen finden Sie im Benutzerhandbuch unter [Ereignisse mithilfe erweiterter Ereignisselektoren protokollieren](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-advanced).AWS CloudTrail * **Beispiel 2: Konfigurieren von Ereignisauswahlen für einen Trail zum Protokollieren aller Verwaltungs- und Datenereignisse** Sie können bis zu 5 Ereignisauswahlen und bis zu 250 Datenressourcen für einen Trail konfigurieren. Ereignisauswahlen werden auch als grundlegende Ereignisauswahlen bezeichnet. Mit der Ereignisauswahl können Sie Verwaltungs- und Datenereignisse für S3-Objekte, Lambda-Funktionen und DynamoDB-Tabellen protokollieren. Zum Protokollieren von Datenereignissen für andere Ressourcentypen müssen Sie erweiterte Ereignisauswahlen verwenden. Das folgende `put-event-selectors` Beispiel erstellt einen Event-Selector für einen Trail, der so benannt ist, `TrailName` dass er alle Verwaltungsereignisse, Datenereignisse für zwei Amazon S3 bucket/prefix S3-Kombinationen und Datenereignisse für eine einzelne AWS Lambda-Funktion mit dem Namen umfasst. `hello-world-python-function` ``` aws cloudtrail put-event-selectors \ --trail-name TrailName \ --event-selectors '[{"ReadWriteType": "All","IncludeManagementEvents": true,"DataResources": [{"Type":"AWS::S3::Object", "Values": ["arn:aws:s3:::amzn-s3-demo-bucket/prefix","arn:aws:s3:::amzn-s3-demo-bucket2/prefix2"]},{"Type": "AWS::Lambda::Function","Values": ["arn:aws:lambda:us-west-2:999999999999:function:hello-world-python-function"]}]}]' ``` Ausgabe: ``` { "EventSelectors": [ { "IncludeManagementEvents": true, "DataResources": [ { "Values": [ "arn:aws:s3:::amzn-s3-demo-bucket/prefix", "arn:aws:s3:::amzn-s3-demo-bucket2/prefix2" ], "Type": "AWS::S3::Object" }, { "Values": [ "arn:aws:lambda:us-west-2:123456789012:function:hello-world-python-function" ], "Type": "AWS::Lambda::Function" }, ], "ReadWriteType": "All" } ], "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/TrailName" } ``` *Weitere Informationen finden Sie im Benutzerhandbuch unter [Protokollieren von Ereignissen mithilfe grundlegender Event-Selektoren](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-basic).AWS CloudTrail * **Beispiel 3: Konfigurieren von Ereignisauswahlen für einen Trail, um Verwaltungsereignisse, alle S3-Datenereignisse für S3-Objekte und alle Lambda-Datenereignisse für Funktionen in Ihrem Konto zu protokollieren** Das folgende `put-event-selectors` Beispiel erstellt einen Event-Selektor für einen Trail mit dem Namen`TrailName2`, der alle Verwaltungsereignisse und alle Datenereignisse für alle Amazon S3 S3-Buckets und AWS Lambda-Funktionen im Konto umfasst. AWS ``` aws cloudtrail put-event-selectors \ --trail-name TrailName2 \ --event-selectors '[{"ReadWriteType": "All","IncludeManagementEvents": true,"DataResources": [{"Type":"AWS::S3::Object", "Values": ["arn:aws:s3"]},{"Type": "AWS::Lambda::Function","Values": ["arn:aws:lambda"]}]}]' ``` Ausgabe: ``` { "EventSelectors": [ { "IncludeManagementEvents": true, "DataResources": [ { "Values": [ "arn:aws:s3" ], "Type": "AWS::S3::Object" }, { "Values": [ "arn:aws:lambda" ], "Type": "AWS::Lambda::Function" }, ], "ReadWriteType": "All" } ], "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/TrailName2" } ``` *Weitere Informationen finden Sie im Benutzerhandbuch unter [Protokollieren von Ereignissen mithilfe grundlegender Event-Selektoren](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-basic).AWS CloudTrail * + Einzelheiten zur API finden Sie [PutEventSelectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/put-event-selectors.html)in der *AWS CLI Befehlsreferenz.* ### `remove-tags` Das folgende Codebeispiel zeigt die Verwendung`remove-tags`. **AWS CLI** **So entfernen Sie Tags für einen Host** Der folgende `remove-tags`-Befehl entfernt die angegebenen Tags für `Trail1`: ``` aws cloudtrail remove-tags --resource-id arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1 --tags-list Key=name Key=location ``` + Einzelheiten zur API finden Sie [RemoveTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/remove-tags.html)in der *AWS CLI Befehlsreferenz*. ### `start-logging` Das folgende Codebeispiel zeigt die Verwendung`start-logging`. **AWS CLI** **So starten Sie das Protokollieren für einen Trail** Der folgende `start-logging`-Befehl aktiviert das Protokollieren für `Trail1`: ``` aws cloudtrail start-logging --name Trail1 ``` + Einzelheiten zur API finden Sie [StartLogging](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/start-logging.html)in der *AWS CLI Befehlsreferenz*. ### `stop-logging` Das folgende Codebeispiel zeigt die Verwendung`stop-logging`. **AWS CLI** **So beenden Sie die Protokollierung eines Trails** Der folgende `stop-logging`-Befehl deaktiviert die Protokollierung für `Trail1`: ``` aws cloudtrail stop-logging --name Trail1 ``` + Einzelheiten zur API finden Sie [StopLogging](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/stop-logging.html)in der *AWS CLI Befehlsreferenz*. ### `update-subscription` Das folgende Codebeispiel zeigt die Verwendung`update-subscription`. **AWS CLI** **So aktualisieren Sie die Konfigurationseinstellungen für einen Trail** Im folgenden Beispiel für `update-subscription` wird der Trail aktualisiert, sodass ein neuer S3-Bucket und ein neues SNS-Thema angegeben werden. ``` aws cloudtrail update-subscription \ --name Trail1 \ --s3-new-bucket amzn-s3-demo-bucket \ --sns-new-topic my-topic-new ``` Ausgabe: ``` Setting up new S3 bucket amzn-s3-demo-bucket... Setting up new SNS topic my-topic-new... Creating/updating CloudTrail configuration... CloudTrail configuration: { "trailList": [ { "IncludeGlobalServiceEvents": true, "Name": "Trail1", "TrailARN": "arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1", "LogFileValidationEnabled": false, "IsMultiRegionTrail": false, "S3BucketName": "amzn-s3-demo-bucket", "SnsTopicName": "my-topic-new", "HomeRegion": "us-east-1" } ], "ResponseMetadata": { "HTTPStatusCode": 200, "RequestId": "31126f8a-c616-11e5-9cc6-2fd637936879" } } ``` + Einzelheiten zur API finden Sie [UpdateSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/update-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `update-trail` Das folgende Codebeispiel zeigt die Verwendung`update-trail`. **AWS CLI** **So aktualisieren Sie einen Trail** Im folgenden Beispiel für `update-trail` wird ein Trail aktualisiert, um einen vorhandenen Bucket für die Protokollzustellung zu verwenden. ``` aws cloudtrail update-trail \ --name Trail1 \ --s3-bucket-name amzn-s3-demo-bucket ``` Ausgabe: ``` { "IncludeGlobalServiceEvents": true, "Name": "Trail1", "TrailARN": "arn:aws:cloudtrail:us-west-2:123456789012:trail/Trail1", "LogFileValidationEnabled": false, "IsMultiRegionTrail": true, "S3BucketName": "amzn-s3-demo-bucket" } ``` + Einzelheiten zur API finden Sie [UpdateTrail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/update-trail.html)in der *AWS CLI Befehlsreferenz*. ### `validate-logs` Das folgende Codebeispiel zeigt die Verwendung`validate-logs`. **AWS CLI** **So validieren Sie eine Protokolldatei** Der folgende `validate-logs`-Befehl validiert die Protokolle für `Trail1`: ``` aws cloudtrail validate-logs --trail-arn arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1 --start-time 20160129T19:00:00Z ``` Ausgabe: ``` Validating log files for trail arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1 between 2016-01-29T19:00:00Z and 2016-01-29T22:15:43Z Results requested for 2016-01-29T19:00:00Z to 2016-01-29T22:15:43Z Results found for 2016-01-29T19:24:57Z to 2016-01-29T21:24:57Z: 3/3 digest files valid 15/15 log files valid ``` + Einzelheiten zur API finden Sie [ValidateLogs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/validate-logs.html)in der *AWS CLI Befehlsreferenz*. # CloudWatch Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CloudWatch. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-alarms` Das folgende Codebeispiel zeigt, wie Sie`delete-alarms`. **AWS CLI** **So löschen Sie einen Alarm** Im folgenden Beispiel wird der `delete-alarms` Befehl verwendet, um den CloudWatch Amazon-Alarm mit dem Namen „myalarm“ zu löschen: ``` aws cloudwatch delete-alarms --alarm-names myalarm ``` Ausgabe: ``` This command returns to the prompt if successful. ``` + Einzelheiten zur API finden Sie [DeleteAlarms](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-alarms.html)in der *AWS CLI Befehlsreferenz.* ### `delete-anomaly-detector` Das folgende Codebeispiel zeigt die Verwendung`delete-anomaly-detector`. **AWS CLI** **So löschen Sie ein bestimmtes Anomalieerkennungsmodell** Im folgenden Beispiel für `delete-anomaly-detector` wird ein Anomalieerkennungsmodell im angegebenen Konto gelöscht. ``` aws cloudwatch delete-anomaly-detector \ --namespace AWS/Logs \ --metric-name IncomingBytes \ --stat SampleCount ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Modells zur Erkennung von Anomalien](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Anomaly_Detection_Alarm.html#Delete_Anomaly_Detection_Model) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-anomaly-detector.html)in der *AWS CLI Befehlsreferenz.* ### `delete-dashboards` Das folgende Codebeispiel zeigt die Verwendung`delete-dashboards`. **AWS CLI** **So löschen Sie bestimmte Dashboards** Im folgenden Beispiel für `delete-dashboards` werden zwei Dashboards mit den Namen `Dashboard-A` und `Dashboard-B` im angegebenen Konto gelöscht. ``` aws cloudwatch delete-dashboards \ --dashboard-names Dashboard-A Dashboard-B ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [ CloudWatch Amazon-Dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-dashboards.html)in der *AWS CLI Befehlsreferenz.* ### `delete-insight-rules` Das folgende Codebeispiel zeigt die Verwendung`delete-insight-rules`. **AWS CLI** **So löschen Sie angegebene Contributor-Insights-Regeln** Im folgenden Beispiel für `delete-insight-rules` werden zwei Contributor-Insights-Regeln mit dem Namen `Rule-A` und `Rule-B` im angegebenen Konto gelöscht. ``` aws cloudwatch delete-insight-rules \ --rule-names Rule-A Rule-B ``` Ausgabe: ``` { "Failures": [] } ``` *Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch * + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-insight-rules.html).AWS CLI * ### `delete-metric-stream` Das folgende Codebeispiel zeigt die Verwendung`delete-metric-stream`. **AWS CLI** **So löschen Sie einen angegebenen Metrik-Stream** Im folgenden Beispiel für `delete-metric-stream` wird der Metrik-Stream mit dem Namen `QuickPartial-gSCKvO` im angegebenen Konto gelöscht. ``` aws cloudwatch delete-metric-stream \ --name QuickPartial-gSCKvO ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-metric-stream.html)in der *AWS CLI Befehlsreferenz*. ### `describe-alarm-history` Das folgende Codebeispiel zeigt die Verwendung`describe-alarm-history`. **AWS CLI** **So rufen Sie den Verlauf eines Alarms ab** Im folgenden Beispiel wird der `describe-alarm-history` Befehl verwendet, um den Verlauf für den CloudWatch Amazon-Alarm mit dem Namen „myalarm“ abzurufen: ``` aws cloudwatch describe-alarm-history --alarm-name "myalarm" --history-item-type StateUpdate ``` Ausgabe: ``` { "AlarmHistoryItems": [ { "Timestamp": "2014-04-09T18:59:06.442Z", "HistoryItemType": "StateUpdate", "AlarmName": "myalarm", "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"},\"newState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}}}", "HistorySummary": "Alarm updated from ALARM to OK" }, { "Timestamp": "2014-04-09T18:59:05.805Z", "HistoryItemType": "StateUpdate", "AlarmName": "myalarm", "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.839999999999996, 39.714].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-03-11T22:45:41.569+0000\",\"startDate\":\"2014-03-11T22:30:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.839999999999996,39.714],\"threshold\":70.0}},\"newState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"}}", "HistorySummary": "Alarm updated from OK to ALARM" } ] } ``` + Einzelheiten zur API finden Sie [DescribeAlarmHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarm-history.html)in der *AWS CLI Befehlsreferenz.* ### `describe-alarms-for-metric` Das folgende Codebeispiel zeigt die Verwendung`describe-alarms-for-metric`. **AWS CLI** **So zeigen Sie Informationen über Alarme an, die einer Metrik zugeordnet sind** Im folgenden Beispiel wird der `describe-alarms-for-metric` Befehl verwendet, um Informationen zu allen Alarmen anzuzeigen, die mit der Amazon CPUUtilization EC2-Metrik und der Instance mit der ID i-0c986c72 verknüpft sind. : ``` aws cloudwatch describe-alarms-for-metric --metric-name CPUUtilization --namespace AWS/EC2 --dimensions Name=InstanceId,Value=i-0c986c72 ``` Ausgabe: ``` { "MetricAlarms": [ { "EvaluationPeriods": 10, "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm2", "StateUpdatedTimestamp": "2013-10-30T03:03:51.479Z", "AlarmConfigurationUpdatedTimestamp": "2013-10-30T03:03:50.865Z", "ComparisonOperator": "GreaterThanOrEqualToThreshold", "AlarmActions": [ "arn:aws:sns:us-east-1:111122223333:NotifyMe" ], "Namespace": "AWS/EC2", "AlarmDescription": "CPU usage exceeds 70 percent", "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2013-10-30T03:03:51.479+0000\",\"startDate\":\"2013-10-30T02:08:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[40.698,39.612,42.432,39.796,38.816,42.28,42.854,40.088,40.760000000000005,41.316],\"threshold\":70.0}", "Period": 300, "StateValue": "OK", "Threshold": 70.0, "AlarmName": "myHighCpuAlarm2", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0c986c72" } ], "Statistic": "Average", "StateReason": "Threshold Crossed: 10 datapoints were not greater than or equal to the threshold (70.0). The most recent datapoints: [40.760000000000005, 41.316].", "InsufficientDataActions": [], "OKActions": [], "ActionsEnabled": true, "MetricName": "CPUUtilization" }, { "EvaluationPeriods": 2, "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm", "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z", "AlarmConfigurationUpdatedTimestamp": "2014-04-09T22:26:05.958Z", "ComparisonOperator": "GreaterThanThreshold", "AlarmActions": [ "arn:aws:sns:us-east-1:111122223333:HighCPUAlarm" ], "Namespace": "AWS/EC2", "AlarmDescription": "CPU usage exceeds 70 percent", "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}", "Period": 300, "StateValue": "OK", "Threshold": 70.0, "AlarmName": "myHighCpuAlarm", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0c986c72" } ], "Statistic": "Average", "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].", "InsufficientDataActions": [], "OKActions": [], "ActionsEnabled": false, "MetricName": "CPUUtilization" } ] } ``` + Einzelheiten zur API finden Sie [DescribeAlarmsForMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms-for-metric.html)in der *AWS CLI Befehlsreferenz*. ### `describe-alarms` Das folgende Codebeispiel zeigt die Verwendung`describe-alarms`. **AWS CLI** **So listen Sie Informationen über einen Alarm auf** Im folgenden Beispiel wird der `describe-alarms`-Befehl verwendet, um Informationen über den Alarm mit dem Namen „myalarm“ bereitzustellen: ``` aws cloudwatch describe-alarms --alarm-names "myalarm" ``` Ausgabe: ``` { "MetricAlarms": [ { "EvaluationPeriods": 2, "AlarmArn": "arn:aws:cloudwatch:us-east-1:123456789012:alarm:myalarm", "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z", "AlarmConfigurationUpdatedTimestamp": "2012-12-27T00:49:54.032Z", "ComparisonOperator": "GreaterThanThreshold", "AlarmActions": [ "arn:aws:sns:us-east-1:123456789012:myHighCpuAlarm" ], "Namespace": "AWS/EC2", "AlarmDescription": "CPU usage exceeds 70 percent", "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}", "Period": 300, "StateValue": "OK", "Threshold": 70.0, "AlarmName": "myalarm", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0c986c72" } ], "Statistic": "Average", "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].", "InsufficientDataActions": [], "OKActions": [], "ActionsEnabled": true, "MetricName": "CPUUtilization" } ] } ``` + Einzelheiten zur API finden Sie [DescribeAlarms](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms.html)in der *AWS CLI Befehlsreferenz*. ### `describe-anomaly-detectors` Das folgende Codebeispiel zeigt die Verwendung`describe-anomaly-detectors`. **AWS CLI** **So rufen Sie eine Liste von Modellen zur Erkennung von Anomalien ab** Im folgenden Beispiel für `describe-anomaly-detectors` werden Informationen zu Anomalieerkennungsmodellen angezeigt, die dem `AWS/Logs`-Namespace im angegebenen Konto zugeordnet sind. ``` aws cloudwatch describe-anomaly-detectors \ --namespace AWS/Logs ``` Ausgabe: ``` { "AnomalyDetectors": [ { "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [], "Stat": "SampleCount", "Configuration": { "ExcludedTimeRanges": [] }, "StateValue": "TRAINED", "SingleMetricAnomalyDetector": { "AccountId": "123456789012", "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [], "Stat": "SampleCount" } }, { "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [ { "Name": "LogGroupName", "Value": "demo" } ], "Stat": "Average", "Configuration": { "ExcludedTimeRanges": [] }, "StateValue": "PENDING_TRAINING", "SingleMetricAnomalyDetector": { "AccountId": "123456789012", "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [ { "Name": "LogGroupName", "Value": "demo" } ], "Stat": "Average" } } ] } ``` Weitere Informationen finden Sie unter [Verwenden der CloudWatch Anomalieerkennung](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeAnomalyDetectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-anomaly-detectors.html)in der *AWS CLI Befehlsreferenz.* ### `describe-insight-rules` Das folgende Codebeispiel zeigt die Verwendung`describe-insight-rules`. **AWS CLI** **So rufen Sie eine Liste von Contributor-Insights-Regeln ab** Im folgenden Beispiel für `describe-insight-rules` werden alle Contributor-Insights-Regeln im angegebenen Konto angezeigt. ``` aws cloudwatch describe-insight-rules ``` Ausgabe: ``` { "InsightRules": [ { "Name": "Rule-A", "State": "ENABLED", "Schema": "CloudWatchLogRule/1", "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo\"\n\t]\n}", "ManagedRule": false }, { "Name": "Rule-B", "State": "ENABLED", "Schema": "CloudWatchLogRule/1", "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo-1\"\n\t]\n}", "ManagedRule": false } ] } ``` *Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch * + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DescribeInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-insight-rules.html).AWS CLI * ### `disable-alarm-actions` Das folgende Codebeispiel zeigt die Verwendung`disable-alarm-actions`. **AWS CLI** **So deaktivieren Sie Aktionen für einen Alarm** Das folgende Beispiel verwendet den `disable-alarm-actions`-Befehl, um alle Aktionen für den Alarm mit dem Namen „myalarm“ zu deaktivieren: ``` aws cloudwatch disable-alarm-actions --alarm-names myalarm ``` Wenn dieser Befehl erfolgreich war, kehrt er zum Prompt zurück. + Einzelheiten zur API finden Sie [DisableAlarmActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-alarm-actions.html)in der *AWS CLI Befehlsreferenz*. ### `disable-insight-rules` Das folgende Codebeispiel zeigt die Verwendung`disable-insight-rules`. **AWS CLI** **So deaktivieren Sie bestimmte Contributor-Insight-Regeln** Im folgenden Beispiel für `disable-insight-rules` werden zwei Contributor-Insights-Regeln mit dem Namen `Rule-A` und `Rule-B` im angegebenen Konto deaktiviert. ``` aws cloudwatch disable-insight-rules \ --rule-names Rule-A Rule-B ``` Ausgabe: ``` { "Failures": [] } ``` *Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch * + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DisableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-insight-rules.html).AWS CLI * ### `enable-alarm-actions` Das folgende Codebeispiel zeigt die Verwendung`enable-alarm-actions`. **AWS CLI** **So aktivieren Sie alle Aktionen für einen Alarm** Das folgende Beispiel verwendet den `enable-alarm-actions`-Befehl, um alle Aktionen für den Alarm mit dem Namen „myalarm“ zu aktivieren: ``` aws cloudwatch enable-alarm-actions --alarm-names myalarm ``` Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück. + Einzelheiten zur API finden Sie [EnableAlarmActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-alarm-actions.html)in der *AWS CLI Befehlsreferenz*. ### `enable-insight-rules` Das folgende Codebeispiel zeigt die Verwendung`enable-insight-rules`. **AWS CLI** **So aktivieren Sie bestimmte Contributor-Insight-Regeln** Im folgenden Beispiel für `enable-insight-rules` werden zwei Contributor-Insights-Regeln mit dem Namen `Rule-A` und `Rule-B` im angegebenen Konto aktiviert. ``` aws cloudwatch enable-insight-rules \ --rule-names Rule-A Rule-B ``` Ausgabe: ``` { "Failures": [] } ``` *Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch * + *Einzelheiten zur API finden Sie in der Befehlsreferenz [EnableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-insight-rules.html).AWS CLI * ### `get-dashboard` Das folgende Codebeispiel zeigt die Verwendung`get-dashboard`. **AWS CLI** **So rufen Sie Informationen zu einem Dashboard ab** Im folgenden Beispiel für `get-dashboard` werden Informationen zum Dashboard `Dashboard-A` im angegebenen Konto angezeigt. ``` aws cloudwatch get-dashboard \ --dashboard-name Dashboard-A ``` Ausgabe: ``` { "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A", "DashboardBody": "{\"widgets\":[{\"type\":\"metric\",\"x\":0,\"y\":0,\"width\":6,\"height\":6,\"properties\":{\"view\":\"timeSeries\",\"stacked\":false,\"metrics\":[[\"AWS/EC2\",\"NetworkIn\",\"InstanceId\",\"i-0131f062232ade043\"],[\".\",\"NetworkOut\",\".\",\".\"]],\"region\":\"us-east-1\"}}]}", "DashboardName": "Dashboard-A" } ``` Weitere Informationen finden Sie unter [ CloudWatch Amazon-Dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-dashboard.html)in der *AWS CLI Befehlsreferenz.* ### `get-insight-rule-report` Das folgende Codebeispiel zeigt die Verwendung`get-insight-rule-report`. **AWS CLI** **So rufen Sie die Zeitreihendaten ab, die durch eine Contributor-Insights-Regel erfasst wurden** Im folgenden Beispiel für `get-insight-rule-report` werden die Zeitreihendaten zurückgegeben, die durch eine Contributor-Insights-Regel erfasst wurden. ``` aws cloudwatch get-insight-rule-report \ --rule-name Rule-A \ --start-time 2024-10-13T20:15:00Z \ --end-time 2024-10-13T20:30:00Z \ --period 300 ``` Ausgabe: ``` { "KeyLabels": [ "PartitionKey" ], "AggregationStatistic": "Sum", "AggregateValue": 0.5, "ApproximateUniqueCount": 1, "Contributors": [ { "Keys": [ "RequestID" ], "ApproximateAggregateValue": 0.5, "Datapoints": [ { "Timestamp": "2024-10-13T21:00:00+00:00", "ApproximateValue": 0.5 } ] } ], "RuleAttributes": [] } ``` *Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch * + *Einzelheiten zur API finden Sie in der Befehlsreferenz [GetInsightRuleReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-insight-rule-report.html).AWS CLI * ### `get-metric-data` Das folgende Codebeispiel zeigt die Verwendung`get-metric-data`. **AWS CLI** **Beispiel 1: So rufen Sie die durchschnittlichen Gesamt-IOPS für die angegebene EC2-Instance mithilfe eines mathematischen Ausdrucks ab** Im folgenden `get-metric-data` Beispiel werden CloudWatch Metrikwerte für die EC2-Instance mit InstanceID abgerufen, wobei ein metrischer mathematischer Ausdruck `i-abcdef` verwendet wird, der Metriken kombiniert. `EBSReadOps` `EBSWriteOps` ``` aws cloudwatch get-metric-data \ --metric-data-queries file://file.json \ --start-time 2024-09-29T22:10:00Z \ --end-time 2024-09-29T22:15:00Z ``` Inhalt von `file.json`: ``` [ { "Id": "m3", "Expression": "(m1+m2)/300", "Label": "Avg Total IOPS" }, { "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "EBSReadOps", "Dimensions": [ { "Name": "InstanceId", "Value": "i-abcdef" } ] }, "Period": 300, "Stat": "Sum", "Unit": "Count" }, "ReturnData": false }, { "Id": "m2", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "EBSWriteOps", "Dimensions": [ { "Name": "InstanceId", "Value": "i-abcdef" } ] }, "Period": 300, "Stat": "Sum", "Unit": "Count" }, "ReturnData": false } ] ``` Ausgabe: ``` { "MetricDataResults": [ { "Id": "m3", "Label": "Avg Total IOPS", "Timestamps": [ "2024-09-29T22:10:00+00:00" ], "Values": [ 96.85 ], "StatusCode": "Complete" } ], "Messages": [] } ``` **Beispiel 2: Um die geschätzten Gebühren anhand von Abrechnungskennzahlen zu überwachen AWS CloudWatch ** Im folgenden `get-metric-data` Beispiel wird die `EstimatedCharges` CloudWatch Metrik aus dem Namespace AWS/Billing abgerufen. ``` aws cloudwatch get-metric-data \ --metric-data-queries '[{"Id":"m1","MetricStat":{"Metric":{"Namespace":"AWS/Billing","MetricName":"EstimatedCharges","Dimensions":[{"Name":"Currency","Value":"USD"}]},"Period":21600,"Stat":"Maximum"}}]' \ --start-time 2024-09-26T12:00:00Z \ --end-time 2024-09-26T18:00:00Z \ --region us-east-1 ``` Ausgabe: ``` { "MetricDataResults": [ { "Id": "m1", "Label": "EstimatedCharges", "Timestamps": [ "2024-09-26T12:00:00+00:00" ], "Values": [ 542.38 ], "StatusCode": "Complete" } ], "Messages": [] } ``` Weitere Informationen finden Sie unter [Verwenden von mathematischen Ausdrücken mit CloudWatch Metriken](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-metric-statistics` Das folgende Codebeispiel zeigt die Verwendung`get-metric-statistics`. **AWS CLI** **So rufen Sie die CPU-Auslastung pro EC2-Instance ab** Im folgenden Beispiel wird der `get-metric-statistics`-Befehl verwendet, um die CPU-Auslastung für eine EC2-Instance mit der ID i-abcdef abzurufen. ``` aws cloudwatch get-metric-statistics --metric-name CPUUtilization --start-time 2014-04-08T23:18:00Z --end-time 2014-04-09T23:18:00Z --period 3600 --namespace AWS/EC2 --statistics Maximum --dimensions Name=InstanceId,Value=i-abcdef ``` Ausgabe: ``` { "Datapoints": [ { "Timestamp": "2014-04-09T11:18:00Z", "Maximum": 44.79, "Unit": "Percent" }, { "Timestamp": "2014-04-09T20:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T19:18:00Z", "Maximum": 50.85, "Unit": "Percent" }, { "Timestamp": "2014-04-09T09:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T03:18:00Z", "Maximum": 76.84, "Unit": "Percent" }, { "Timestamp": "2014-04-09T21:18:00Z", "Maximum": 48.96, "Unit": "Percent" }, { "Timestamp": "2014-04-09T14:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T08:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T16:18:00Z", "Maximum": 45.55, "Unit": "Percent" }, { "Timestamp": "2014-04-09T06:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T13:18:00Z", "Maximum": 45.08, "Unit": "Percent" }, { "Timestamp": "2014-04-09T05:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T18:18:00Z", "Maximum": 46.88, "Unit": "Percent" }, { "Timestamp": "2014-04-09T17:18:00Z", "Maximum": 52.08, "Unit": "Percent" }, { "Timestamp": "2014-04-09T07:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T02:18:00Z", "Maximum": 51.23, "Unit": "Percent" }, { "Timestamp": "2014-04-09T12:18:00Z", "Maximum": 47.67, "Unit": "Percent" }, { "Timestamp": "2014-04-08T23:18:00Z", "Maximum": 46.88, "Unit": "Percent" }, { "Timestamp": "2014-04-09T10:18:00Z", "Maximum": 51.91, "Unit": "Percent" }, { "Timestamp": "2014-04-09T04:18:00Z", "Maximum": 47.13, "Unit": "Percent" }, { "Timestamp": "2014-04-09T15:18:00Z", "Maximum": 48.96, "Unit": "Percent" }, { "Timestamp": "2014-04-09T00:18:00Z", "Maximum": 48.16, "Unit": "Percent" }, { "Timestamp": "2014-04-09T01:18:00Z", "Maximum": 49.18, "Unit": "Percent" } ], "Label": "CPUUtilization" } ``` **Angeben mehrerer Dimensionen** Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Value Paar angegeben, wobei zwischen dem Namen und dem Wert ein Komma steht. Mehrere Dimensionen werden durch ein Leerzeichen getrennt. Wenn eine einzelne Metrik mehrere Dimensionen enthält, müssen Sie für jede definierte Dimension einen Wert angeben. Weitere Beispiele für die Verwendung des `get-metric-statistics` Befehls finden Sie unter Get Statistics for a Metric im *Amazon CloudWatch Developer Guide*. ``` aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceID,Value=i-abcdef Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60 ``` + Einzelheiten zur API finden Sie [GetMetricStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-statistics.html)unter *AWS CLI Befehlsreferenz*. ### `get-metric-stream` Das folgende Codebeispiel zeigt die Verwendung`get-metric-stream`. **AWS CLI** **So rufen Sie Informationen zu einem Metrik-Stream ab** Im folgenden Beispiel für `get-metric-stream` werden Informationen zum Metrik-Stream `QuickFull-GuaFbs` im angegebenen Konto angezeigt. ``` aws cloudwatch get-metric-stream \ --name QuickFull-GuaFbs ``` Ausgabe: ``` { "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs", "Name": "QuickFull-GuaFbs", "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG", "RoleArn": "arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3", "State": "running", "CreationDate": "2024-10-11T18:48:59.187000+00:00", "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00", "OutputFormat": "json", "IncludeLinkedAccountsMetrics": false } ``` Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-stream.html)in der *AWS CLI Befehlsreferenz*. ### `get-metric-widget-image` Das folgende Codebeispiel zeigt die Verwendung`get-metric-widget-image`. **AWS CLI** **Um ein Snapshot-Diagramm von abzurufen CPUUtilization** Im folgenden Beispiel für `get-metric-widget-image` wird das Snapshot-Diagramm für die Metrik `CPUUtilization` der EC2-Instance mit der ID `i-abcde` abgerufen und das abgerufene Bild als Datei mit dem Namen „image.png“ auf Ihrem lokalen Computer gespeichert. ``` aws cloudwatch get-metric-widget-image \ --metric-widget '{"metrics":[["AWS/EC2","CPUUtilization","InstanceId","i-abcde"]]}' \ --output-format png \ --output text | base64 --decode > image.png ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [GetMetricWidgetImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-widget-image.html)in der *AWS CLI Befehlsreferenz*. ### `list-dashboards` Das folgende Codebeispiel zeigt die Verwendung`list-dashboards`. **AWS CLI** **So rufen Sie eine Liste von Dashboards ab** Im folgenden Beispiel für `list-dashboards` werden alle Dashboards im angegebenen Konto aufgelistet. ``` aws cloudwatch list-dashboards ``` Ausgabe: ``` { "DashboardEntries": [ { "DashboardName": "Dashboard-A", "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A", "LastModified": "2024-10-11T18:40:11+00:00", "Size": 271 }, { "DashboardName": "Dashboard-B", "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-B", "LastModified": "2024-10-11T18:44:41+00:00", "Size": 522 } ] } ``` Weitere Informationen finden Sie unter [ CloudWatch Amazon-Dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-dashboards.html)in der *AWS CLI Befehlsreferenz.* ### `list-metric-streams` Das folgende Codebeispiel zeigt die Verwendung`list-metric-streams`. **AWS CLI** **So rufen Sie eine Liste von Metrik-Streams ab** Im folgenden Beispiel für `list-metric-streams` werden alle Metrik-Streams im angegebenen Konto aufgelistet. ``` aws cloudwatch list-metric-streams ``` Ausgabe: ``` { "Entries": [ { "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs", "CreationDate": "2024-10-11T18:48:59.187000+00:00", "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00", "Name": "QuickFull-GuaFbs", "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG", "State": "running", "OutputFormat": "json" } ] } ``` Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metric-streams.html)in der *AWS CLI Befehlsreferenz*. ### `list-metrics` Das folgende Codebeispiel zeigt die Verwendung`list-metrics`. **AWS CLI** **So listen Sie die Metriken für Amazon SNS auf** Im folgenden Beispiel für `list-metrics` werden die Metriken für Amazon SNS angezeigt. ``` aws cloudwatch list-metrics \ --namespace "AWS/SNS" ``` Ausgabe: ``` { "Metrics": [ { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "PublishSize" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "PublishSize" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "NumberOfNotificationsFailed" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "NumberOfNotificationsDelivered" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "NumberOfMessagesPublished" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "NumberOfMessagesPublished" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "NumberOfNotificationsDelivered" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "NumberOfNotificationsFailed" } ] } ``` + Einzelheiten zur API finden Sie [ListMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metrics.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags auf, die einem vorhandenen Alarm zugeordnet sind\$1** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags aufgelistet, die dem Alarm `demo` im angegebenen Konto zugeordnet sind. ``` aws cloudwatch list-tags-for-resource \ --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo ``` Ausgabe: ``` { "Tags": [ { "Key": "stack", "Value": "Production" }, { "Key": "team", "Value": "Devops" } ] } ``` Weitere Informationen finden Sie unter [Alarme und Tagging](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarms_and_tagging.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `put-anomaly-detector` Das folgende Codebeispiel zeigt die Verwendung`put-anomaly-detector`. **AWS CLI** **So erstellen Sie ein Anomalieerkennungsmodell** Im folgenden `put-anomaly-detector` Beispiel wird ein Modell zur Erkennung von Anomalien für eine CloudWatch Metrik erstellt. ``` aws cloudwatch put-anomaly-detector \ --namespace AWS/Logs \ --metric-name IncomingBytes \ --stat SampleCount ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden der CloudWatch Anomalieerkennung](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-anomaly-detector.html)in der *AWS CLI Befehlsreferenz.* ### `put-composite-alarm` Das folgende Codebeispiel zeigt die Verwendung`put-composite-alarm`. **AWS CLI** **So erstellen Sie einen zusammengesetzten CloudWatch-Alarm** Im folgenden Beispiel für `put-composite-alarm` wird ein zusammengesetzter Alarm mit dem Namen `ProdAlarm` im angegebenen Konto erstellt. ``` aws cloudwatch put-composite-alarm \ --alarm-name ProdAlarm \ --alarm-rule "ALARM(CPUUtilizationTooHigh) AND ALARM(MemUsageTooHigh)" \ --alarm-actions arn:aws:sns:us-east-1:123456789012:demo \ --actions-enabled ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen eines zusammengesetzten Alarms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Composite_Alarm_How_To.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutCompositeAlarm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-composite-alarm.html)in der *AWS CLI Befehlsreferenz*. ### `put-dashboard` Das folgende Codebeispiel zeigt die Verwendung`put-dashboard`. **AWS CLI** **So erstellen Sie ein Dashboard** Im folgenden Beispiel für `put-dashboard` wird ein Dashboard mit dem Namen `Dashboard-A` im angegebenen Konto erstellt. ``` aws cloudwatch put-dashboard \ --dashboard-name Dashboard-A \ --dashboard-body '{"widgets":[{"height":6,"width":6,"y":0,"x":0,"type":"metric","properties":{"view":"timeSeries","stacked":false,"metrics":[["Namespace","CPUUtilization","Environment","Prod","Type","App"]],"region":"us-east-1"}}]}' ``` Ausgabe: ``` { "DashboardValidationMessages": [] } ``` Weitere Informationen finden Sie unter [Erstellen eines CloudWatch Dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-dashboard.html)in der *AWS CLI Befehlsreferenz*. ### `put-insight-rule` Das folgende Codebeispiel zeigt die Verwendung`put-insight-rule`. **AWS CLI** **So erstellen Sie eine Contributor-Insights-Regel** Im folgenden Beispiel für `put-insight-rule` wird eine Contributor-Insights-Regel mit dem Namen `VPCFlowLogsContributorInsights` im angegebenen Konto erstellt. ``` aws cloudwatch put-insight-rule \ --rule-name VPCFlowLogsContributorInsights \ --rule-definition file://insight-rule.json \ --rule-state ENABLED ``` Inhalt von `insight-rule.json`: ``` { "Schema": { "Name": "CloudWatchLogRule", "Version": 1 }, "AggregateOn": "Count", "Contribution": { "Filters": [], "Keys": [ "tcp-flag" ] }, "LogFormat": "CLF", "LogGroupNames": [ "/vpc/flowlogs/*" ], "Fields": { "23": "tcp-flag" } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen einer Contributor Insights-Regel CloudWatch im CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights-CreateRule.html) *Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutInsightRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-insight-rule.html)in der *AWS CLI Befehlsreferenz.* ### `put-metric-alarm` Das folgende Codebeispiel zeigt die Verwendung`put-metric-alarm`. **AWS CLI** **So senden Sie eine E-Mail-Nachricht von Amazon Simple Notification Service, wenn die CPU-Auslastung 70 % übersteigt** Im folgenden Beispiel wird der `put-metric-alarm`-Befehl verwendet, um eine E-Mail-Nachricht von Amazon Simple Notification Service zu senden, wenn die CPU-Auslastung 70 % übersteigt: ``` aws cloudwatch put-metric-alarm --alarm-name cpu-mon --alarm-description "Alarm when CPU exceeds 70 percent" --metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 300 --threshold 70 --comparison-operator GreaterThanThreshold --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 --alarm-actions arn:aws:sns:us-east-1:111122223333:MyTopic --unit Percent ``` Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück. Wenn ein Alarm mit demselben Namen bereits vorhanden ist, wird er durch den neuen Alarm überschrieben. **So geben Sie mehrere Dimensionen an** Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Value Paar angegeben, wobei zwischen dem Namen und dem Wert ein Komma steht. Mehrere Dimensionen werden durch ein Leerzeichen getrennt: ``` aws cloudwatch put-metric-alarm --alarm-name "Default_Test_Alarm3" --alarm-description "The default example alarm" --namespace "CW EXAMPLE METRICS" --metric-name Default_Test --statistic Average --period 60 --evaluation-periods 3 --threshold 50 --comparison-operator GreaterThanOrEqualToThreshold --dimensions Name=key1,Value=value1 Name=key2,Value=value2 ``` + Einzelheiten zur API finden Sie unter [PutMetricAlarm AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-alarm.html)*Befehlsreferenz.* ### `put-metric-data` Das folgende Codebeispiel zeigt die Verwendung`put-metric-data`. **AWS CLI** **Um eine benutzerdefinierte Metrik auf Amazon zu veröffentlichen CloudWatch** Im folgenden Beispiel wird der `put-metric-data` Befehl verwendet, um eine benutzerdefinierte Metrik auf Amazon zu veröffentlichen CloudWatch: ``` aws cloudwatch put-metric-data --namespace "Usage Metrics" --metric-data file://metric.json ``` Die Werte für die Metrik selbst werden in der JSON-Datei `metric.json` gespeichert. Hier ist der Inhalt dieser Datei: ``` [ { "MetricName": "New Posts", "Timestamp": "Wednesday, June 12, 2013 8:28:20 PM", "Value": 0.50, "Unit": "Count" } ] ``` Weitere Informationen finden Sie unter Veröffentlichen benutzerdefinierter Metriken im *Amazon CloudWatch Developer Guide*. **So geben Sie mehrere Dimensionen an** Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Wert-Paar angegeben. Mehrere Dimensionen sind durch ein Komma getrennt: ``` aws cloudwatch put-metric-data --metric-name Buffers --namespace MyNameSpace --unit Bytes --value 231434333 --dimensions InstanceID=1-23456789,InstanceType=m1.small ``` + Einzelheiten zur API finden Sie [PutMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-data.html)in der *AWS CLI Befehlsreferenz*. ### `put-metric-stream` Das folgende Codebeispiel zeigt die Verwendung`put-metric-stream`. **AWS CLI** **So erstellen Sie einen Metrik-Stream** Im folgenden Beispiel für `put-metric-stream` wird ein Metrik-Stream mit dem Namen `QuickFull-GuaFb` im angegebenen Konto erstellt. ``` aws cloudwatch put-metric-stream \ --name QuickFull-GuaFbs \ --firehose-arn arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG \ --role-arn arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3 \ --output-format json \ --no-include-linked-accounts-metrics ``` Ausgabe: ``` { "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs" } ``` Weitere Informationen finden Sie unter [Metrik-Stream einrichten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-setup.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-stream.html)in der *AWS CLI Befehlsreferenz*. ### `set-alarm-state` Das folgende Codebeispiel zeigt die Verwendung`set-alarm-state`. **AWS CLI** **So ändern Sie den Status eines Alarms vorübergehend** Im folgenden Beispiel wird der `set-alarm-state` Befehl verwendet, um den Status eines CloudWatch Amazon-Alarms mit dem Namen „myalarm“ vorübergehend zu ändern und ihn zu Testzwecken auf den ALARM-Status zu setzen: ``` aws cloudwatch set-alarm-state --alarm-name "myalarm" --state-value ALARM --state-reason "testing purposes" ``` Wenn dieser Befehl erfolgreich war, kehrt er zum Prompt zurück. + Einzelheiten zur API finden Sie [SetAlarmState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/set-alarm-state.html)in der *AWS CLI Befehlsreferenz.* ### `start-metric-streams` Das folgende Codebeispiel zeigt die Verwendung`start-metric-streams`. **AWS CLI** **So starten Sie einen angegebenen Metrik-Stream** Im folgenden Beispiel für `start-metric-streams` wird der Metrik-Stream mit dem Namen `QuickFull-GuaFbs` im angegebenen Konto gestartet. ``` aws cloudwatch start-metric-streams \ --names QuickFull-GuaFbs ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/start-metric-streams.html)in der *AWS CLI Befehlsreferenz*. ### `stop-metric-streams` Das folgende Codebeispiel zeigt die Verwendung`stop-metric-streams`. **AWS CLI** **So beenden Sie einen angegebenen Metrik-Stream** Im folgenden Beispiel für `stop-metric-streams` wird der Metrik-Stream mit dem Namen `QuickFull-GuaFbs` im angegebenen Konto beendet. ``` aws cloudwatch stop-metric-streams \ --names QuickFull-GuaFbs ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/stop-metric-streams.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie der angegebenen Ressource einzelne oder mehrere Tags hinzu** Im folgenden Beispiel für `tag-resource` werden dem Cloudwatch-Alarm `demo` im angegebenen Konto zwei Tags hinzugefügt. ``` aws cloudwatch tag-resource \ --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \ --tags Key=stack,Value=Production Key=team,Value=Devops ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer CloudWatch Amazon-Ressourcen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie einzelne oder mehrere Tags aus der angegebenen Ressource** Im folgenden Beispiel für `untag-resource` werden zwei Tags aus dem Cloudwatch-Alarm `demo` im angegebenen Konto entfernt. ``` aws cloudwatch untag-resource \ --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \ --tag-keys stack team ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer CloudWatch Amazon-Ressourcen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/untag-resource.html)in der *AWS CLI Befehlsreferenz.* # CloudWatch Protokolliert Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with CloudWatch Logs Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-log-group` Das folgende Codebeispiel zeigt, wie Sie`create-log-group`. **AWS CLI** Der folgende Befehl erstellt eine Protokollgruppe mit dem Namen `my-logs`. ``` aws logs create-log-group --log-group-name my-logs ``` + Einzelheiten zur API finden Sie [CreateLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-log-stream` Das folgende Codebeispiel zeigt die Verwendung`create-log-stream`. **AWS CLI** Im folgenden Beispiel wird ein Protokollstream mit dem Namen `20150601` in der Protokollgruppe `my-logs` erstellt. ``` aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601 ``` + Einzelheiten zur API finden Sie [CreateLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-stream.html)in der *AWS CLI Befehlsreferenz*. ### `delete-log-group` Das folgende Codebeispiel zeigt die Verwendung`delete-log-group`. **AWS CLI** Mit dem folgenden Befehl wird eine Protokollgruppe mit dem Namen `my-logs` gelöscht: ``` aws logs delete-log-group --log-group-name my-logs ``` + Einzelheiten zur API finden Sie [DeleteLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-log-stream` Das folgende Codebeispiel zeigt die Verwendung`delete-log-stream`. **AWS CLI** Mit dem folgenden Befehl wird der Protokollstream mit dem Namen `20150531` aus der Protokollgruppe `my-logs` gelöscht: ``` aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531 ``` + Einzelheiten zur API finden Sie [DeleteLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-stream.html)in der *AWS CLI Befehlsreferenz*. ### `delete-retention-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-retention-policy`. **AWS CLI** Mit dem folgenden Befehl wird die Aufbewahrungsrichtlinie entfernt, die zuvor auf eine Protokollgruppe mit dem Namen `my-logs` angewendet wurde: ``` aws logs delete-retention-policy --log-group-name my-logs ``` + Einzelheiten zur API finden Sie [DeleteRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-retention-policy.html)in der *AWS CLI Befehlsreferenz*. ### `describe-log-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-log-groups`. **AWS CLI** Der folgende Befehl beschreibt eine Protokollgruppe mit dem Namen `my-logs`: ``` aws logs describe-log-groups --log-group-name-prefix my-logs ``` Ausgabe: ``` { "logGroups": [ { "storedBytes": 0, "metricFilterCount": 0, "creationTime": 1433189500783, "logGroupName": "my-logs", "retentionInDays": 5, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLogGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-log-streams` Das folgende Codebeispiel zeigt die Verwendung`describe-log-streams`. **AWS CLI** Der folgende Befehl zeigt alle Protokollstreams in der Protokollgruppe `my-logs` an, die mit dem Präfix `2015` beginnen: ``` aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015 ``` Ausgabe: ``` { "logStreams": [ { "creationTime": 1433189871774, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531", "logStreamName": "20150531", "storedBytes": 0 }, { "creationTime": 1433189873898, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601", "logStreamName": "20150601", "storedBytes": 0 } ] } ``` + Einzelheiten zur API finden Sie [DescribeLogStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-streams.html)in der *AWS CLI Befehlsreferenz*. ### `get-log-events` Das folgende Codebeispiel zeigt die Verwendung`get-log-events`. **AWS CLI** Der folgende Befehl ruft Protokollereignisse aus einem Protokollstream mit dem Namen `20150601` in der Protokollgruppe `my-logs` ab: ``` aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601 ``` Ausgabe: ``` { "nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130", "events": [ { "ingestionTime": 1433190494190, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190516679, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190494190, "timestamp": 1433190184358, "message": "Example Event 2" } ], "nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120" } ``` + Einzelheiten zur API finden Sie [GetLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/get-log-events.html)in der *AWS CLI Befehlsreferenz*. ### `put-log-events` Das folgende Codebeispiel zeigt die Verwendung`put-log-events`. **AWS CLI** Mit dem folgenden Befehl werden Protokollereignisse im Protokollstream `20150601` in der Protokollgruppe `my-logs` gespeichert: ``` aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events ``` Ausgabe: ``` { "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346" } ``` Mit dem obigen Beispiel wird ein JSON-Array von Ereignissen aus einer Datei mit dem Namen `events` im aktuellen Verzeichnis gelesen: ``` [ { "timestamp": 1433190184356, "message": "Example Event 1" }, { "timestamp": 1433190184358, "message": "Example Event 2" }, { "timestamp": 1433190184360, "message": "Example Event 3" } ] ``` Für jeden nachfolgenden Aufruf muss das nächste Sequenz-Token, das vom vorherigen Aufruf bereitgestellt wurde, mit der Sequenz-Token-Option angegeben werden: ``` aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346" ``` Ausgabe: ``` { "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826" } ``` + Einzelheiten zur API finden Sie [PutLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-log-events.html)in der *AWS CLI Befehlsreferenz*. ### `put-retention-policy` Das folgende Codebeispiel zeigt die Verwendung`put-retention-policy`. **AWS CLI** Mit dem folgenden Befehl wird einer Protokollgruppe mit dem Namen `my-logs` eine Aufbewahrungsrichtlinie für 5 Tage hinzugefügt: ``` aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5 ``` + Einzelheiten zur API finden Sie [PutRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-retention-policy.html)in der *AWS CLI Befehlsreferenz*. # CloudWatch Beispiele für Netzwerküberwachung mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit CloudWatch Network Monitoring Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-monitor` Das folgende Codebeispiel zeigt, wie Sie`create-monitor`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Netzwerkmonitor mit einem Aggregationszeitraum** Im folgenden Beispiel für `create-monitor` wird ein Monitor namens `Example_NetworkMonitor` mit einem auf `30` Sekunden festgelegten `aggregationPeriod` erstellt. Der ursprüngliche `state` des Monitors wird `INACTIVE` sein, da ihm keine Sonden zugeordnet sind. Der Status ändert sich nur dann in `ACTIVE`, wenn Sonden hinzugefügt werden. Sie können die Befehle [update-monitor](https://docs.aws.amazon.com/cli/latest/reference/networkmonitor/update-monitor.html) oder [create-probe](https://docs.aws.amazon.com/cli/latest/reference/networkmonitor/create-probe.html) verwenden, um diesem Monitor Sonden hinzuzufügen. ``` aws networkmonitor create-monitor \ --monitor-name Example_NetworkMonitor \ --aggregation-period 30 ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "INACTIVE", "aggregationPeriod": 30, "tags": {} } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. **Beispiel 2: So erstellen Sie einen Netzwerkmonitor mit einer Sonde, die TCP verwendet und auch Tags enthält** Im folgenden Beispiel für `create-monitor` wird ein Monitor mit dem Namen `Example_NetworkMonitor` erstellt. Der Befehl erstellt außerdem eine Sonde, die das `ICMP`-Protokoll verwendet und Tags enthält. Da in der Anfrage keine `aggregationPeriod` übergeben wird, ist die Standardeinstellung `60` Sekunden. Der `state` des Monitors mit der Sonde bleibt `PENDING`, bis der Monitor `ACTIVE` ist. Dies kann mehrere Minuten dauern. Ab diesem Zeitpunkt `state` wird der Wert geändert und Sie können mit der Anzeige der CloudWatch Messwerte beginnen. `ACTIVE` ``` aws networkmonitor create-monitor \ --monitor-name Example_NetworkMonitor \ --probes sourceArn=arn:aws:ec2:region:111122223333:subnet/subnet-id,destination=10.0.0.100,destinationPort=80,protocol=TCP,packetSize=56,probeTags={Name=Probe1} \ --tags Monitor=Monitor1 ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkmonitor:region111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "PENDING", "aggregationPeriod": 60, "tags": { "Monitor": "Monitor1" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. **Beispiel 3: So erstellen Sie mithilfe von ICMP einen Netzwerkmonitor mit einer Sonde, die auch Tags enthält** Im folgenden Beispiel für `create-monitor` wird ein Monitor namens `Example_NetworkMonitor` und einer `aggregationPeriod` von `30` Sekunden erstellt. Der Befehl erstellt außerdem eine Sonde, die das `ICMP`-Protokoll verwendet und Tags enthält. Da in der Anfrage keine `aggregationPeriod` übergeben wird, ist die Standardeinstellung `60` Sekunden. Der `state` des Monitors mit der Sonde bleibt `PENDING`, bis der Monitor `ACTIVE` ist. Dies kann mehrere Minuten dauern. Ab diesem Zeitpunkt `state` wird der Wert geändert und Sie können mit der Anzeige der CloudWatch Messwerte beginnen. `ACTIVE` ``` aws networkmonitor create-monitor \ --monitor-name Example_NetworkMonitor \ --aggregation-period 30 \ --probes sourceArn=arn:aws:ec2:region111122223333:subnet/subnet-id,destination=10.0.0.100,protocol=ICMP,packetSize=56,probeTags={Name=Probe1} \ --tags Monitor=Monitor1 ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "PENDING", "aggregationPeriod": 30, "tags": { "Monitor": "Monitor1" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/create-monitor.html)in der *AWS CLI Befehlsreferenz*. ### `create-probe` Das folgende Codebeispiel zeigt die Verwendung`create-probe`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Sonde, die TCP verwendet, und fügen sie einem Netzwerkmonitor hinzu** Im folgenden Beispiel für `create-probe` wird eine Sonde erstellt, die das `TCP`-`protocol` verwendet und die Sonde einem Monitor namens `Example_NetworkMonitor` hinzufügt. Nach der Erstellung bleibt der `state` des Monitors mit der Sonde `PENDING`, bis der Monitor `ACTIVE` ist. Dies kann mehrere Minuten dauern. Zu diesem Zeitpunkt wechselt der Status zu`ACTIVE`, und Sie können mit der Anzeige der CloudWatch Metriken beginnen. ``` aws networkmonitor create-probe \ --monitor-name Example_NetworkMonitor \ --probe sourceArn=arn:aws:ec2:region:111122223333:subnet/subnet-id,destination=10.0.0.100,destinationPort=80,protocol=TCP,packetSize=56,tags={Name=Probe1} ``` Ausgabe: ``` { "probeId": "probe-12345", "probeArn": "arn:aws:networkmonitor:region:111122223333:probe/probe-12345", "destination": "10.0.0.100", "destinationPort": 80, "packetSize": 56, "addressFamily": "IPV4", "vpcId": "vpc-12345", "state": "PENDING", "createdAt": "2024-03-29T12:41:57.314000-04:00", "modifiedAt": "2024-03-29T12:41:57.314000-04:00", "tags": { "Name": "Probe1" } } ``` **Beispiel 2: So erstellen Sie eine Sonde, die ICMP verwendet, und fügen sie einem Netzwerkmonitor hinzu** Im folgenden Beispiel für `create-probe` wird eine Sonde erstellt, die das `ICMP`-`protocol` verwendet und die Sonde einem Monitor namens `Example_NetworkMonitor` hinzufügt. Nach der Erstellung bleibt der `state` des Monitors mit der Sonde `PENDING`, bis der Monitor `ACTIVE` ist. Dies kann mehrere Minuten dauern. Zu diesem Zeitpunkt wird der Status geändert`ACTIVE`, und Sie können mit der Anzeige der CloudWatch Metriken beginnen. ``` aws networkmonitor create-probe \ --monitor-name Example_NetworkMonitor \ --probe sourceArn=arn:aws:ec2:region:012345678910:subnet/subnet-id,destination=10.0.0.100,protocol=ICMP,packetSize=56,tags={Name=Probe1} ``` Ausgabe: ``` { "probeId": "probe-12345", "probeArn": "arn:aws:networkmonitor:region:111122223333:probe/probe-12345", "destination": "10.0.0.100", "packetSize": 56, "addressFamily": "IPV4", "vpcId": "vpc-12345", "state": "PENDING", "createdAt": "2024-03-29T12:44:02.452000-04:00", "modifiedAt": "2024-03-29T12:44:02.452000-04:00", "tags": { "Name": "Probe1" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/create-probe.html)in der *AWS CLI Befehlsreferenz*. ### `delete-monitor` Das folgende Codebeispiel zeigt die Verwendung`delete-monitor`. **AWS CLI** **So löschen Sie einen Monitor** Im folgenden `delete-monitor`-Beispiel wird ein Monitor namens `Example_NetworkMonitor` gelöscht. ``` aws networkmonitor delete-monitor \ --monitor-name Example_NetworkMonitor ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/delete-monitor.html)in der *AWS CLI Befehlsreferenz*. ### `delete-probe` Das folgende Codebeispiel zeigt die Verwendung`delete-probe`. **AWS CLI** **So löschen Sie eine Sonde** Im folgenden Beispiel für `delete-probe` wird eine Sonde mit der ID `probe-12345` aus einem Netzwerkmonitor namens `Example_NetworkMonitor` gelöscht. ``` aws networkmonitor delete-probe \ --monitor-name Example_NetworkMonitor \ --probe-id probe-12345 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/delete-probe.html)in der *AWS CLI Befehlsreferenz*. ### `get-monitor` Das folgende Codebeispiel zeigt die Verwendung`get-monitor`. **AWS CLI** **So rufen Sie Monitorinformationen ab** Im folgenden Beispiel für `get-monitor` werden Informationen zu einem Monitor namens `Example_NetworkMonitor` abgerufen. ``` aws networkmonitor get-monitor \ --monitor-name Example_NetworkMonitor ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "ACTIVE", "aggregationPeriod": 60, "tags": {}, "probes": [], "createdAt": "2024-04-01T17:58:07.211000-04:00", "modifiedAt": "2024-04-01T17:58:07.211000-04:00" } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/get-monitor.html)in der *AWS CLI Befehlsreferenz*. ### `get-probe` Das folgende Codebeispiel zeigt die Verwendung`get-probe`. **AWS CLI** **So zeigen Sie Sondendetails an** Im folgenden Beispiel für `get-probe` werden Details zu einer Sonde mit `probeID`-`probe-12345` zurückgegeben, der einem Monitor namens `Example_NetworkMonitor` zugeordnet ist. ``` aws networkmonitor get-probe \ --monitor-name Example_NetworkMonitor \ --probe-id probe-12345 ``` Ausgabe: ``` { "probeId": "probe-12345", "probeArn": "arn:aws:networkmonitor:region:012345678910:probe/probe-12345", "sourceArn": "arn:aws:ec2:region:012345678910:subnet/subnet-12345", "destination": "10.0.0.100", "destinationPort": 80, "protocol": "TCP", "packetSize": 56, "addressFamily": "IPV4", "vpcId": "vpc-12345", "state": "ACTIVE", "createdAt": "2024-03-29T12:41:57.314000-04:00", "modifiedAt": "2024-03-29T12:42:28.610000-04:00", "tags": { "Name": "Probe1" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/get-probe.html)in der *AWS CLI Befehlsreferenz*. ### `list-monitors` Das folgende Codebeispiel zeigt die Verwendung`list-monitors`. **AWS CLI** **Beispiel 1: So listen Sie alle Monitore auf (einzelner Monitor)** Im folgenden Beispiel für `list-monitors` wird eine Liste mit nur einem einzigen Monitor zurückgegeben. Der `state` des Monitors ist `ACTIVE` und er hat eine `aggregationPeriod` von 60 Sekunden. ``` aws networkmonitor list-monitors ``` Ausgabe: ``` { "monitors": [{ "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "ACTIVE", "aggregationPeriod": 60, "tags": { "Monitor": "Monitor1" } } ] } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. **Beispiel 2: So listen Sie alle Monitore auf (mehrere Monitore)** Im folgenden Beispiel für `list-monitors` wird eine Liste mit drei Monitoren zurückgegeben. Das `state` ist ein Monitor `ACTIVE` und das Generieren von CloudWatch Metriken. Die Status der anderen beiden Monitore sind `INACTIVE` und generieren keine CloudWatch Metriken. Alle drei Monitore verwenden einen `aggregationPeriod` von 60 Sekunden. ``` aws networkmonitor list-monitors ``` Ausgabe: ``` { "monitors": [ { "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "INACTIVE", "aggregationPeriod": 60, "tags": {} }, { "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/Example_NetworkMonitor2", "monitorName": "Example_NetworkMonitor2", "state": "ACTIVE", "aggregationPeriod": 60, "tags": { "Monitor": "Monitor1" } }, { "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/TestNetworkMonitor_CLI", "monitorName": "TestNetworkMonitor_CLI", "state": "INACTIVE", "aggregationPeriod": 60, "tags": {} } ] } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListMonitors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/list-monitors.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` wird eine Liste von Tags für einen Monitor namens `Example_NetworkMonitor` zurückgegeben. ``` aws networkmonitor list-tags-for-resource \ --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor ``` Ausgabe: ``` { "tags": { "Environment": "Dev", "Application": "PetStore" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird ein Monitor namens `Example_NetworkMonitor` mit den Tags `Environment=Dev` und `Application=PetStore` markiert. ``` aws networkmonitor tag-resource \ --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \ --tags Environment=Dev,Application=PetStore ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags von einer Ressource** Im folgenden Beispiel für `untag-resource` wird ein `tag-keys`-Parameter mit dem Schlüssel-Wert-Paar von `Environment Application` aus seiner Zuordnung zu einem Monitor namens `Example_NetworkMonitor` entfernt. ``` aws networkmonitor untag-resource \ --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \ --tag-keys Environment Application ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-monitor` Das folgende Codebeispiel zeigt die Verwendung`update-monitor`. **AWS CLI** **So aktualisieren Sie einen Monitor** Im folgenden Beispiel für `update-monitor` wird die `aggregationPeriod` eines Monitors von `60` Sekunden auf `30` Sekunden geändert. ``` aws networkmonitor update-monitor \ --monitor-name Example_NetworkMonitor \ --aggregation-period 30 ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "PENDING", "aggregationPeriod": 30, "tags": { "Monitor": "Monitor1" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/update-monitor.html)in der *AWS CLI Befehlsreferenz*. ### `update-probe` Das folgende Codebeispiel zeigt die Verwendung`update-probe`. **AWS CLI** **So aktualisieren Sie eine Sonde** Im folgenden Beispiel für `update-probe` wird die ursprüngliche `destination`-IP-Adresse einer Sonde und auch die `packetSize` auf `60` aktualisiert. ``` aws networkmonitor update-probe \ --monitor-name Example_NetworkMonitor \ --probe-id probe-12345 \ --destination 10.0.0.150 \ --packet-size 60 ``` Ausgabe: ``` { "probeId": "probe-12345", "probeArn": "arn:aws:networkmonitor:region:012345678910:probe/probe-12345", "sourceArn": "arn:aws:ec2:region:012345678910:subnet/subnet-12345", "destination": "10.0.0.150", "destinationPort": 80, "protocol": "TCP", "packetSize": 60, "addressFamily": "IPV4", "vpcId": "vpc-12345", "state": "PENDING", "createdAt": "2024-03-29T12:41:57.314000-04:00", "modifiedAt": "2024-03-29T13:52:23.115000-04:00", "tags": { "Name": "Probe1" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/update-probe.html)in der *AWS CLI Befehlsreferenz*. # CloudWatch Beispiele für Observability Access Monitor mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit CloudWatch Observability Access Monitor Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-link` Das folgende Codebeispiel zeigt die Verwendung `create-link` von. **AWS CLI** **Um einen Link zu erstellen** Im folgenden Beispiel für `create-link` wird eine Verknüpfung zwischen einem Quellkonto und einem Sink hergestellt, den Sie in einem Überwachungskonto erstellt haben. ``` aws oam create-link \ --label-template sourceAccount \ --resource-types AWS::CloudWatch::Metric \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Label": "sourceAccount", "LabelTemplate": "sourceAccount", "ResourceTypes": [ "AWS::CloudWatch::Metric" ], "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Tags": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-link.html)in der *AWS CLI Befehlsreferenz*. ### `create-sink` Das folgende Codebeispiel zeigt die Verwendung`create-sink`. **AWS CLI** **So erstellen Sie einen Sink** Im folgenden `create-sink` Beispiel wird eine Senke in der Leistungsbilanz erstellt, sodass sie als Überwachungskonto für die CloudWatch kontenübergreifende Observability verwendet werden kann. ``` aws oam create-sink \ --name DemoSink ``` Ausgabe: ``` { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink", "Tags": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-sink.html)in der *AWS CLI Befehlsreferenz*. ### `delete-link` Das folgende Codebeispiel zeigt die Verwendung`delete-link`. **AWS CLI** **Um einen Link zu löschen** Im folgenden Beispiel für `delete-link` wird eine Verknüpfung zwischen einem Überwachungskonto-Sink und einem Quellkonto gelöscht. ``` aws oam delete-link \ --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-link.html)in der *AWS CLI Befehlsreferenz*. ### `delete-sink` Das folgende Codebeispiel zeigt die Verwendung`delete-sink`. **AWS CLI** **So löschen Sie einen Sink** Im folgenden Beispiel für `delete-sink` wird ein Sink gelöscht. Sie müssen alle Links zu einem Sink löschen, bevor Sie diesen löschen können. ``` aws oam delete-sink \ --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-sink.html)in der *AWS CLI Befehlsreferenz*. ### `get-link` Das folgende Codebeispiel zeigt die Verwendung`get-link`. **AWS CLI** **So geben Sie die vollständigen Informationen zu einem einzelnen Link zurück** Im folgenden Beispiel für `get-link` werden komplette Informationen zu einem Link zurückgegeben. ``` aws oam get-link \ --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 ``` Ausgabe: ``` { "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Label": "sourceAccount", "LabelTemplate": "sourceAccount", "ResourceTypes": [ "AWS::CloudWatch::Metric" ], "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Tags": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-link.html)in der *AWS CLI Befehlsreferenz*. ### `get-sink-policy` Das folgende Codebeispiel zeigt die Verwendung`get-sink-policy`. **AWS CLI** **So geben Sie die aktuelle Sink-Richtlinie zurück, die an den Sink angehängt ist** Im folgenden Beispiel für `get-sink-policy` wird die aktuelle Sink-Richtlinie zurückgegeben, die an den Sink angehängt ist ``` aws oam get-sink-policy \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345", "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}" } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-sink` Das folgende Codebeispiel zeigt die Verwendung`get-sink`. **AWS CLI** **So geben Sie die vollständigen Informationen über einen einzelnen Überwachungskonto-Sink zurück** Im folgenden Beispiel für `get-sink` werden komplette Informationen zu einem Überwachungskonto-Sink zurückgegeben. ``` aws oam get-sink \ --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink", "Tags": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink.html)in der *AWS CLI Befehlsreferenz*. ### `list-attached-links` Das folgende Codebeispiel zeigt die Verwendung`list-attached-links`. **AWS CLI** **So geben Sie eine Liste der Quellkonto-Links zurück, die mit diesem Überwachungskonto-Sink verknüpft sind** Im folgenden Beispiel für `list-attached-links` wird eine Liste von Quellkonten-Links zurückgegeben, die mit diesem Überwachungskonto-Sink verknüpft sind. ``` aws oam list-attached-links \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "Items": [{ "Label": "Monitoring account", "LinkArn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "ResourceTypes": [ "AWS::ApplicationInsights::Application", "AWS::Logs::LogGroup", "AWS::CloudWatch::Metric", "AWS::XRay::Trace" ] }] } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListAttachedLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-attached-links.html)in der *AWS CLI Befehlsreferenz*. ### `list-links` Das folgende Codebeispiel zeigt die Verwendung`list-links`. **AWS CLI** **So geben Sie eine Liste mit Links für einen Überwachungskonto-Sink zurück** Im folgenden Beispiel für `list-links` wird eine Liste von Links für einen Überwachungskonto-Sink zurückgegeben. Führen Sie diese Operation in einem Quellkonto aus, um eine Liste der Links zu Überwachungskonto-Sinks zurückzugeben, die dieses Quellkonto besitzt. ``` aws oam list-links ``` Ausgabe: ``` { "Items": [{ "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Label": "sourceAccount", "ResourceTypes": [ "AWS::CloudWatch::Metric" ], "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345" }] } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-links.html)in der *AWS CLI Befehlsreferenz*. ### `list-sinks` Das folgende Codebeispiel zeigt die Verwendung`list-sinks`. **AWS CLI** **So geben Sie die Liste der Sinks zurück, die im Überwachungskonto erstellt wurden** Im folgenden Beispiel für `list-sinks` wird eine Liste von Sinks zurückgegeben, die im Überwachungskonto erstellt wurden. Führen Sie diese Operation in einem Überwachungskonto aus. ``` aws oam list-sinks ``` Ausgabe: ``` { "Items": [ { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink" } ] } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListSinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-sinks.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So zeigen Sie die Tags an, die einer Ressource zugeordnet sind** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags angezeigt, die einem Sink zugeordnet sind. ``` aws oam list-tags-for-resource \ --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "Tags": { "Team": "Devops" } } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-sink-policy` Das folgende Codebeispiel zeigt die Verwendung`put-sink-policy`. **AWS CLI** **So erstellen oder aktualisieren Sie eine Ressourcenrichtlinie** Im folgenden Beispiel für `put-sink-policy` wird die Ressourcenrichtlinie erstellt, die Quellkonten berechtigt, eine Verbindung zum Überwachungskonto-Sink herzustellen. ``` aws oam put-sink-policy \ --policy '{"Version":"2012-10-17", "Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789111:root"},"Action":["oam:CreateLink","oam:UpdateLink"],"Resource":"*","Condition":{"ForAllValues:StringEquals":{"oam:ResourceTypes":["AWS::Logs::LogGroup","AWS::CloudWatch::Metric","AWS::XRay::Trace","AWS::ApplicationInsights::Application"]}}}]}' \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345", "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}" } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/put-sink-policy.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So weisen Sie der angegebenen Ressource einen oder mehrere Tags zu** Im folgenden Beispiel für `tag-resource` wird ein Sink `arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345` mit einem Tag versehen. ``` aws oam tag-resource \ --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 \ --tags team=Devops ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie einzelne oder mehrere Tags aus der angegebenen Ressource.** Im folgenden Beispiel für `untag-resource` wird ein Tag mit dem Schlüssel `team` aus dem Sink `arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345` entfernt. ``` aws oam untag-resource \ --resource-arn arn:aws:oam:us-east-2:123456789012:sink/f3f42f60-f0f2-425c-1234-12347bdd821f \ --tag-keys team ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-link` Das folgende Codebeispiel zeigt die Verwendung`update-link`. **AWS CLI** **So ändern Sie, welche Datentypen von einem Quellkonto an den zugehörigen Überwachungskonto-Sink weitergegeben werden** Im folgenden Beispiel für `update-link` wird der Link `arn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0` mit den Ressourcentypen `AWS::CloudWatch::Metric` und `AWS::Logs::LogGroup` aktualisiert. ``` aws oam update-link \ --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 \ --resource-types "AWS::CloudWatch::Metric" "AWS::Logs::LogGroup" ``` Ausgabe: ``` { "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Label": "sourceAccount", "LabelTemplate": "sourceAccount", "ResourceTypes": [ "AWS::CloudWatch::Metric", "AWS::Logs::LogGroup" ], "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Tags": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/update-link.html)in der *AWS CLI Befehlsreferenz*. # CloudWatch Beispiele für Observability Admin mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with CloudWatch Observability Admin Aktionen ausführen und gängige Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `get-telemetry-evaluation-status-for-organization` Das folgende Codebeispiel zeigt die Verwendung `get-telemetry-evaluation-status-for-organization` von. **AWS CLI** **So rufen Sie den Onboarding-Status der Telemetrie für die Organisation ab** Im folgenden Beispiel für `get-telemetry-evaluation-status-for-organization` wird der aktuelle Onboarding-Status der Telemetriekonfigurationsfunktion für die Organisation zurückgegeben. ``` aws observabilityadmin get-telemetry-evaluation-status-for-organization ``` Ausgabe: ``` { "Status": "RUNNING" } ``` Weitere Informationen finden Sie unter Prüfen [von CloudWatch Telemetriekonfigurationen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/telemetry-config-cloudwatch.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetTelemetryEvaluationStatusForOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/observabilityadmin/get-telemetry-evaluation-status-for-organization.html)in der *AWS CLI Befehlsreferenz.* ### `get-telemetry-evaluation-status` Das folgende Codebeispiel zeigt die Verwendung`get-telemetry-evaluation-status`. **AWS CLI** **So rufen Sie den Onboarding-Status der Telemetrie für das Konto ab** Im folgenden Beispiel für `get-telemetry-evaluation-status` wird der aktuelle Onboarding-Status der Telemetriekonfigurationsfunktion für das angegebene Konto zurückgegeben. ``` aws observabilityadmin get-telemetry-evaluation-status ``` Ausgabe: ``` { "Status": "RUNNING" } ``` Weitere Informationen finden Sie unter Prüfen [von CloudWatch Telemetriekonfigurationen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/telemetry-config-cloudwatch.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetTelemetryEvaluationStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/observabilityadmin/get-telemetry-evaluation-status.html)in der *AWS CLI Befehlsreferenz.* ### `list-resource-telemetry-for-organization` Das folgende Codebeispiel zeigt die Verwendung`list-resource-telemetry-for-organization`. **AWS CLI** **So rufen Sie die Telemetriekonfigurationen für die Organisation ab** Im folgenden `list-resource-telemetry-for-organization` Beispiel wird eine Liste der Telemetriekonfigurationen in der Organisation für AWS Ressourcen zurückgegeben, die von der Telemetriekonfiguration unterstützt werden. ``` aws observabilityadmin list-resource-telemetry-for-organization \ --resource-types AWS::EC2::Instance ``` Ausgabe: ``` { "TelemetryConfigurations": [ { "AccountIdentifier": "111111111111", "TelemetryConfigurationState": { "Logs": "NotApplicable", "Metrics": "Disabled", "Traces": "NotApplicable" }, "ResourceType": "AWS::EC2::Instance", "ResourceIdentifier": "i-a166400b", "ResourceTags": { "Name": "dev" }, "LastUpdateTimeStamp": 1733168548521 }, { "AccountIdentifier": "222222222222", "TelemetryConfigurationState": { "Logs": "NotApplicable", "Metrics": "Disabled", "Traces": "NotApplicable" }, "ResourceType": "AWS::EC2::Instance", "ResourceIdentifier": "i-b188560f", "ResourceTags": { "Name": "apache" }, "LastUpdateTimeStamp": 1732744260182 } ] } ``` Weitere Informationen finden Sie unter Prüfen [von CloudWatch Telemetriekonfigurationen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/telemetry-config-cloudwatch.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListResourceTelemetryForOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/observabilityadmin/list-resource-telemetry-for-organization.html)in der *AWS CLI Befehlsreferenz.* ### `list-resource-telemetry` Das folgende Codebeispiel zeigt die Verwendung`list-resource-telemetry`. **AWS CLI** **So rufen Sie die Telemetriekonfigurationen für das Konto ab** Das folgende `list-resource-telemetry` Beispiel gibt eine Liste von Telemetriekonfigurationen für AWS Ressourcen zurück, die von der Telemetriekonfiguration im angegebenen Konto unterstützt werden. ``` aws observabilityadmin list-resource-telemetry \ --resource-types AWS::EC2::Instance ``` Ausgabe: ``` { "TelemetryConfigurations": [ { "AccountIdentifier": "111111111111", "TelemetryConfigurationState": { "Logs": "NotApplicable", "Metrics": "Disabled", "Traces": "NotApplicable" }, "ResourceType": "AWS::EC2::Instance", "ResourceIdentifier": "i-0e979d278b040f856", "ResourceTags": { "Name": "apache" }, "LastUpdateTimeStamp": 1732744260182 } ] } ``` Weitere Informationen finden Sie unter Prüfen [von CloudWatch Telemetriekonfigurationen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/telemetry-config-cloudwatch.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListResourceTelemetry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/observabilityadmin/list-resource-telemetry.html)in der *AWS CLI Befehlsreferenz.* ### `start-telemetry-evaluation-for-organization` Das folgende Codebeispiel zeigt die Verwendung`start-telemetry-evaluation-for-organization`. **AWS CLI** **So aktivieren Sie die Telemetriekonfigurationsfunktion** Im folgenden Beispiel für `start-telemetry-evaluation-for-organization` wird die Telemetriekonfigurationsfunktion für die Organisation aktiviert. ``` aws observabilityadmin start-telemetry-evaluation-for-organization ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [unter CloudWatch Telemetrieprüfung](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/telemetry-config-turn-on.html) aktivieren im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartTelemetryEvaluationForOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/observabilityadmin/start-telemetry-evaluation-for-organization.html)in der *AWS CLI Befehlsreferenz.* ### `start-telemetry-evaluation` Das folgende Codebeispiel zeigt die Verwendung`start-telemetry-evaluation`. **AWS CLI** **So aktivieren Sie die Telemetriekonfigurationsfunktion** Im folgenden Beispiel für `start-telemetry-evaluation` wird die Telemetriekonfigurationsfunktion für das angegebene Konto aktiviert. ``` aws observabilityadmin start-telemetry-evaluation ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [unter CloudWatch Telemetrieprüfung](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/telemetry-config-turn-on.html) aktivieren im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartTelemetryEvaluation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/observabilityadmin/start-telemetry-evaluation.html)in der *AWS CLI Befehlsreferenz.* ### `stop-telemetry-evaluation-for-organization` Das folgende Codebeispiel zeigt die Verwendung`stop-telemetry-evaluation-for-organization`. **AWS CLI** **So deaktivieren Sie die Telemetriekonfigurationsfunktion** Im folgenden Beispiel für `stop-telemetry-evaluation-for-organization` wird die Telemetriekonfigurationsfunktion für die Organisation deaktiviert. ``` aws observabilityadmin stop-telemetry-evaluation-for-organization ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [ CloudWatch Telemetrieprüfungen ausschalten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/telemetry-config-turn-off.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopTelemetryEvaluationForOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/observabilityadmin/stop-telemetry-evaluation-for-organization.html)in der *AWS CLI Befehlsreferenz.* ### `stop-telemetry-evaluation` Das folgende Codebeispiel zeigt die Verwendung`stop-telemetry-evaluation`. **AWS CLI** **So deaktivieren Sie die Telemetriekonfigurationsfunktion** Im folgenden Beispiel für `stop-telemetry-evaluation` wird die Telemetriekonfigurationsfunktion für das angegebene Konto deaktiviert. ``` aws observabilityadmin stop-telemetry-evaluation ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [ CloudWatch Telemetrieprüfungen ausschalten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/telemetry-config-turn-off.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopTelemetryEvaluation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/observabilityadmin/stop-telemetry-evaluation.html)in der *AWS CLI Befehlsreferenz.* # CloudWatch Beispiele für Synthetics unter Verwendung AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with CloudWatch Synthetics Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-resource` Das folgende Codebeispiel zeigt die Verwendung `associate-resource` von. **AWS CLI** **So ordnen Sie einen Canary einer Gruppe zu** Im folgenden Beispiel für `associate-resource` wird ein Canary einer Gruppe namens `demo_group` zugeordnet. ``` aws synthetics associate-resource \ --group-identifier demo_group \ --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AssociateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/associate-resource.html)in der *AWS CLI Befehlsreferenz.* ### `create-canary` Das folgende Codebeispiel zeigt die Verwendung`create-canary`. **AWS CLI** **Um einen Kanarienvogel zu erstellen** Im folgenden Beispiel für `create-canary` wird ein Canary mit dem Namen `demo_canary` erstellt. ``` aws synthetics create-canary \ --name demo_canary \ --code '{"S3Bucket": "artifacts3bucket", "S3Key":"demo_canary.zip", "Handler": "index.lambda_handler"}' \ --artifact-s3-location s3://amzn-s3-demo-bucket/demo_canary.zip \ --execution-role-arn arn:aws:iam::123456789012:role/demo_canary_role \ --schedule Expression="rate(10 minutes)" \ --runtime-version syn-nodejs-puppeteer-9.1 ``` Ausgabe: ``` { "Canary": { "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Name": "demo_canary", "Code": { "Handler": "index.lambda_handler" }, "ExecutionRoleArn": "arn:aws:iam::123456789012:role/demo_canary_role", "Schedule": { "Expression": "rate(10 minutes)", "DurationInSeconds": 0 }, "RunConfig": { "TimeoutInSeconds": 600, "MemoryInMB": 1000, "ActiveTracing": false }, "SuccessRetentionPeriodInDays": 31, "FailureRetentionPeriodInDays": 31, "Status": { "State": "CREATING", "StateReasonCode": "CREATE_PENDING" }, "Timeline": { "Created": "2024-10-15T19:03:08.826000+05:30", "LastModified": "2024-10-15T19:03:08.826000+05:30" }, "ArtifactS3Location": "amzn-s3-demo-bucket/demo_canary.zip", "RuntimeVersion": "syn-nodejs-puppeteer-9.1", "Tags": {} } } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateCanary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/create-canary.html)in der *AWS CLI Befehlsreferenz.* ### `create-group` Das folgende Codebeispiel zeigt die Verwendung`create-group`. **AWS CLI** **So erstellen Sie eine Gruppe** Im folgenden Beispiel für `create-group` wird eine Gruppe namens `demo_group` erstellt. ``` aws synthetics create-group \ --name demo_group ``` Ausgabe: ``` { "Group": { "Id": "example123", "Name": "demo_group", "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123", "Tags": {}, "CreatedTime": "2024-10-15T14:47:23.811000+05:30", "LastModifiedTime": "2024-10-15T14:47:23.811000+05:30" } } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/create-group.html)in der *AWS CLI Befehlsreferenz.* ### `delete-canary` Das folgende Codebeispiel zeigt die Verwendung`delete-canary`. **AWS CLI** **So löschen Sie einen Canary dauerhaft** Im folgenden Beispiel für `delete-canary` wird ein Canary namens `demo_canary` gelöscht. ``` aws synthetics delete-canary \ --name demo_canary ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteCanary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/delete-canary.html)in der *AWS CLI Befehlsreferenz.* ### `delete-group` Das folgende Codebeispiel zeigt die Verwendung`delete-group`. **AWS CLI** **Um eine Gruppe zu löschen** Im folgenden Beispiel für `delete-group` wird eine Gruppe namens `demo_group` gelöscht. ``` aws synthetics delete-group \ --group-identifier demo_group ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/delete-group.html)in der *AWS CLI Befehlsreferenz.* ### `describe-canaries-last-run` Das folgende Codebeispiel zeigt die Verwendung`describe-canaries-last-run`. **AWS CLI** **So zeigen Sie Informationen aus dem letzten Lauf jedes Canary an** Im folgenden Beispiel für `describe-canaries-last-run` wird der letzten Lauf jedes Canary zurückgegeben, den Sie erstellt haben. ``` aws synthetics describe-canaries-last-run ``` Ausgabe: ``` { "CanariesLastRun": [ { "CanaryName": "demo_canary", "LastRun": { "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Name": "demo_canary", "Status": { "State": "PASSED", "StateReason": "", "StateReasonCode": "" }, "Timeline": { "Started": "2024-10-15T19:20:39.691000+05:30", "Completed": "2024-10-15T19:20:58.211000+05:30" }, "ArtifactS3Location": "cw-syn-results-123456789012-us-east-1/canary/us-east-1/demo_canary-abc-example1234/2024/10/15/13/50-39-690" } } ] } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeCanariesLastRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/describe-canaries-last-run.html)in der *AWS CLI Befehlsreferenz.* ### `describe-canaries` Das folgende Codebeispiel zeigt die Verwendung`describe-canaries`. **AWS CLI** **So listen Sie Canarys in Ihrem Konto auf** Im folgenden Beispiel für `describe-canaries` werden Details zu den Canarys in Ihrem Konto aufgelistet. ``` aws synthetics describe-canaries ``` Ausgabe: ``` { "Canaries": [ { "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Name": "demo_canary", "Code": { "SourceLocationArn": "arn:aws:lambda:us-east-1:123456789012:layer:cwsyn-demo_canary-a1b2c3d4-5678-90ab-cdef-example11111b8:1", "Handler": "pageLoadBlueprint.handler" }, "ExecutionRoleArn": "arn:aws:iam::123456789012:role/service-role/CloudWatchSyntheticsRole-demo_canary-a12-a123bc456789", "Schedule": { "Expression": "rate(5 minutes)", "DurationInSeconds": 0 }, "RunConfig": { "TimeoutInSeconds": 300, "MemoryInMB": 1000, "ActiveTracing": false }, "SuccessRetentionPeriodInDays": 31, "FailureRetentionPeriodInDays": 31, "Status": { "State": "RUNNING" }, "Timeline": { "Created": "2024-10-15T18:55:15.168000+05:30", "LastModified": "2024-10-15T18:55:40.540000+05:30", "LastStarted": "2024-10-15T18:55:40.540000+05:30" }, "ArtifactS3Location": "cw-syn-results-123456789012-us-east-1/canary/us-east-1/demo_canary-a12-a123bc456789", "EngineArn": "arn:aws:lambda:us-east-1:123456789012:function:cwsyn-demo_canary-a1b2c3d4-5678-90ab-cdef-example111118:1", "RuntimeVersion": "syn-nodejs-puppeteer-9.1", "Tags": { "blueprint": "heartbeat" } } ] } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeCanaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/describe-canaries.html)in der *AWS CLI Befehlsreferenz.* ### `describe-runtime-versions` Das folgende Codebeispiel zeigt die Verwendung`describe-runtime-versions`. **AWS CLI** **So geben Sie eine Liste der Runtime-Versionen von Synthetics Canary zurück** Im folgenden Beispiel für `describe-runtime-versions` wird die Liste der Runtime-Versionen von Synthetics Canary zurückgegeben. ``` aws synthetics describe-runtime-versions ``` Ausgabe: ``` { "RuntimeVersions": [ { "VersionName": "syn-nodejs-puppeteer-9.1", "Description": "Security fixes and bug fix for date range error in har. Dependencies: Node JS 20.x, Puppeteer-core 22.12.1, Chromium 126.0.6478.126", "ReleaseDate": "2024-10-02T05:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-9.0", "Description": "Upgraded Chromium and Puppeteer. Dependencies: Node JS 20.x, Puppeteer-core 22.12.1, Chromium 126.0.6478.126", "ReleaseDate": "2024-07-22T05:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-8.0", "Description": "Upgraded Chromium and Puppeteer. Dependencies: Node JS 20.x, Puppeteer-core 22.10.0, Chromium 125.0.6422.112", "ReleaseDate": "2024-06-21T05:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-7.0", "Description": "Upgraded Chromium and Puppeteer. Dependencies: Node JS 18.x, Puppeteer-core 21.9.0, Chromium 121.0.6167.139", "ReleaseDate": "2024-03-08T05:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-6.2", "Description": "Updated shared libraries for Chromium and added ephemeral storage monitoring. Dependencies: Node JS 18.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146", "ReleaseDate": "2024-02-02T05:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-6.1", "Description": "Added puppeteer launch retry. Dependencies: Node JS 18.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146", "ReleaseDate": "2023-11-13T05:30:00+05:30", "DeprecationDate": "2024-03-08T13:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-6.0", "Description": "Reduced X-Ray traces of a canary run, improved duration metric and upgraded to NodeJS 18.x. Dependencies: Node JS 18.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146", "ReleaseDate": "2023-09-15T05:30:00+05:30", "DeprecationDate": "2024-03-08T13:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-5.2", "Description": "Updated shared libraries for Chromium. Dependencies: Node JS 16.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146", "ReleaseDate": "2024-02-01T05:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-5.1", "Description": "Fixes a bug about missing request headers in har. Dependencies: Node JS 16.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146", "ReleaseDate": "2023-08-09T05:30:00+05:30", "DeprecationDate": "2024-03-08T13:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-5.0", "Description": "Upgraded Puppeteer and Chromium. Dependencies: Node JS 16.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146", "ReleaseDate": "2023-07-21T05:30:00+05:30", "DeprecationDate": "2024-03-08T13:30:00+05:30" }, { "VersionName": "syn-nodejs-puppeteer-4.0", "Description": "Upgraded to NodeJS 16.x. Dependencies: Node JS 16.x, Puppeteer-core 5.5.0, Chromium 92.0.4512.0", "ReleaseDate": "2023-05-01T05:30:00+05:30", "DeprecationDate": "2024-03-08T13:30:00+05:30" } ] } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeRuntimeVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/describe-runtime-versions.html)in der *AWS CLI Befehlsreferenz.* ### `disassociate-resource` Das folgende Codebeispiel zeigt die Verwendung`disassociate-resource`. **AWS CLI** **So entfernen Sie einen Canary aus einer Gruppe** Im folgenden Beispiel für `disassociate-resource` wird ein Canary aus einer Gruppe mit dem Namen `demo_group` entfernt. ``` aws synthetics disassociate-resource \ --group-identifier demo_group \ --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DisassociateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/disassociate-resource.html)in der *AWS CLI Befehlsreferenz.* ### `get-canary-runs` Das folgende Codebeispiel zeigt die Verwendung`get-canary-runs`. **AWS CLI** **So rufen Sie eine Liste von Läufen für einen bestimmten Canary ab** Im folgenden Beispiel für `get-canary-runs` wird eine Liste von Läufen für den Canary namens `demo_canary` abgerufen. ``` aws synthetics get-canary-runs \ --name demo_canary ``` Ausgabe: ``` { "CanaryRuns": [ { "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Name": "demo_canary", "Status": { "State": "PASSED", "StateReason": "", "StateReasonCode": "" }, "Timeline": { "Started": "2024-10-16T10:38:57.013000+05:30", "Completed": "2024-10-16T10:39:25.793000+05:30" }, "ArtifactS3Location": "cw-syn-results-123456789012-us-east-1/canary/us-east-1/demo_canary-abc-example1234/2024/10/15/13/50-39-690" } ] } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetCanaryRuns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/get-canary-runs.html)in der *AWS CLI Befehlsreferenz.* ### `get-canary` Das folgende Codebeispiel zeigt die Verwendung`get-canary`. **AWS CLI** **So rufen Sie die vollständigen Informationen zu einem einzelnen Canary ab** Im folgenden Beispiel für `get-canary` werden Informationen zu dem Canary namens `demo_canary` abgerufen. ``` aws synthetics get-canary \ --name demo_canary ``` Ausgabe: ``` { "Canary": { "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Name": "demo_canary", "Code": { "SourceLocationArn": "arn:aws:lambda:us-east-1:123456789012:layer:cwsyn-demo_canary-a1b2c3d4-5678-90ab-cdef-example111118:1", "Handler": "pageLoadBlueprint.handler" }, "ExecutionRoleArn": "arn:aws:iam::123456789012:role/demo_canary_role", "Schedule": { "Expression": "rate(10 minutes)", "DurationInSeconds": 0 }, "RunConfig": { "TimeoutInSeconds": 300, "MemoryInMB": 1000, "ActiveTracing": false }, "SuccessRetentionPeriodInDays": 31, "FailureRetentionPeriodInDays": 31, "Status": { "State": "RUNNING" }, "Timeline": { "Created": "2024-10-15T18:55:15.168000+05:30", "LastModified": "2024-10-15T18:55:40.540000+05:30", "LastStarted": "2024-10-15T18:55:40.540000+05:30" }, "ArtifactS3Location": "cw-syn-results-123456789012-us-east-1/canary/us-east-1/demo_canary-a12-a123bc456789", "EngineArn": "arn:aws:lambda:us-east-1:123456789012:function:cwsyn-demo_canary-a1b2c3d4-5678-90ab-cdef-example111118:1", "RuntimeVersion": "syn-nodejs-puppeteer-9.1", "Tags": { "blueprint": "heartbeat" } } } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetCanary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/get-canary.html)in der *AWS CLI Befehlsreferenz.* ### `get-group` Das folgende Codebeispiel zeigt die Verwendung`get-group`. **AWS CLI** **So geben Sie Informationen über eine Gruppe zurück** Im folgenden Beispiel für `get-group` werden Informationen über die Gruppe namens `demo_group` zurückgegeben. ``` aws synthetics get-group \ --group-identifier demo_group ``` Ausgabe: ``` { "Group": { "Id": "example123", "Name": "demo_group", "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123", "Tags": {}, "CreatedTime": "2024-10-15T14:47:23.811000+05:30", "LastModifiedTime": "2024-10-15T14:47:23.811000+05:30" } } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/get-group.html)in der *AWS CLI Befehlsreferenz.* ### `list-associated-groups` Das folgende Codebeispiel zeigt die Verwendung`list-associated-groups`. **AWS CLI** **So geben Sie eine Liste der Gruppen zurück** Im folgenden Beispiel für `list-associated-groups` wird eine Liste der Gruppen zurückgegeben, die dem Canary namens `demo_canary` zugeordnet sind. ``` aws synthetics list-associated-groups \ --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary ``` Ausgabe: ``` { "Groups": [ { "Id": "example123", "Name": "demo_group", "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123" } ] } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListAssociatedGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/list-associated-groups.html)in der *AWS CLI Befehlsreferenz.* ### `list-group-resources` Das folgende Codebeispiel zeigt die Verwendung`list-group-resources`. **AWS CLI** **Um eine Liste ARNs der Kanarienvögel zurückzugeben, die der angegebenen Gruppe zugeordnet sind** Das folgende `list-group-resources` Beispiel gibt eine Liste ARNs der Kanarienvögel zurück, die der genannten Gruppe zugeordnet sind. `demo_group` ``` aws synthetics list-group-resources \ --group-identifier demo_group ``` Ausgabe: ``` { "Resources": [ "arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary" ] } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListGroupResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/list-group-resources.html)in der *AWS CLI Befehlsreferenz.* ### `list-groups` Das folgende Codebeispiel zeigt die Verwendung`list-groups`. **AWS CLI** **So geben Sie eine Liste aller Gruppen im Konto zurück** Im folgenden Beispiel für `list-groups` wird eine Liste aller Gruppen im Konto zurückgegeben. ``` aws synthetics list-groups ``` Ausgabe: ``` { "Groups": [ { "Id": "example123", "Name": "demo_group", "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123" } ] } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/list-groups.html)in der *AWS CLI Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Beispiel 1: So zeigen Sie die Tags an, die einem Canary zugeordnet sind** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags zurückgegeben, die einem Canary namens `demo_canary` zugeordnet sind. ``` aws synthetics list-tags-for-resource \ --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary ``` Ausgabe: ``` { "Tags": { "blueprint": "heartbeat" } } ``` **Beispiel 2: So zeigen Sie die mit einer Gruppe verknüpften Tags an** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags zurückgegeben, die einer Gruppe namens `demo_group` zugeordnet sind. ``` aws synthetics list-tags-for-resource \ --resource-arn arn:aws:synthetics:us-east-1:123456789012:group:example123 ``` Ausgabe: ``` { "Tags": { "team": "Devops" } } ``` Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `start-canary` Das folgende Codebeispiel zeigt die Verwendung`start-canary`. **AWS CLI** **So führen Sie einen Canary aus** Im folgenden Beispiel für `start-canary` wird ein Canary namens `demo_canary` ausgeführt. ``` aws synthetics start-canary \ --name demo_canary ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartCanary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/start-canary.html)in der *AWS CLI Befehlsreferenz.* ### `stop-canary` Das folgende Codebeispiel zeigt die Verwendung`stop-canary`. **AWS CLI** **So stoppen Sie einen Canary** Im folgenden Beispiel für `stop-canary` wird der Canary namens `demo_canary` gestoppt. ``` aws synthetics stop-canary \ --name demo_canary ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopCanary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/stop-canary.html)in der *AWS CLI Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Beispiel 1: So weisen Sie dem Canary einen Tag zu** Im folgenden Beispiel für `tag-resource` wird dem Canary namens `demo_canary` ein Tag zugewiesen. ``` aws synthetics tag-resource \ --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary \ --tags blueprint=heartbeat ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So weisen Sie der Gruppe ein Tag zu** Im folgenden Beispiel für `tag-resource` wird der Gruppe namens `demo_group` ein Tag zugewiesen. ``` aws synthetics tag-resource \ --resource-arn arn:aws:synthetics:us-east-1:123456789012:group:example123 \ --tags team=Devops ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Beispiel 1: So entfernen Sie einen Tag vom Canary** Im folgenden Beispiel für `untag-resource` wird ein Tag von einem Canary namens `demo_canary` entfernt. ``` aws synthetics untag-resource \ --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary \ --tag-keys blueprint ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So entfernen Sie einen Tag von der Gruppe** Im folgenden Beispiel für `untag-resource` wird der Gruppe namens `demo_group` ein Tag zugewiesen. ``` aws synthetics untag-resource \ --resource-arn arn:aws:synthetics:us-east-1:123456789012:group:example123 \ --tag-keys team ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-canary` Das folgende Codebeispiel zeigt die Verwendung`update-canary`. **AWS CLI** **So aktualisieren Sie einen Canary** Im folgenden Beispiel für `update-canary` wird die Konfiguration eines Canary namens `demo_canary` aktualisiert. ``` aws synthetics update-canary \ --name demo_canary \ --schedule Expression="rate(15 minutes)" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Synthetic Monitoring (Canaries)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateCanary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/synthetics/update-canary.html)in der *AWS CLI Befehlsreferenz.* # CodeArtifact Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CodeArtifact. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-external-connection` Das folgende Codebeispiel zeigt, wie Sie`associate-external-connection`. **AWS CLI** **So fügen Sie einem Repository eine externe Verbindung hinzu** Im folgenden Beispiel für `associate-external-connection` wird einem Repository namens „test-repo“ eine externe Verbindung mit „npmjs.com“ hinzugefügt. ``` aws codeartifact associate-external-connection \ --repository test-repo \ --domain test-domain \ --external-connection public:npmjs ``` Ausgabe: ``` { "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "upstreams": [], "externalConnections": [ { "externalConnectionName": "public:npmjs", "packageFormat": "npm", "status": "AVAILABLE" } ] } } ``` Weitere Informationen finden [Sie im *AWS CodeArtifact Benutzerhandbuch* unter Hinzufügen einer externen Verbindung](https://docs.aws.amazon.com/codeartifact/latest/ug/external-connection.html). + Einzelheiten zur API finden Sie [AssociateExternalConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/associate-external-connection.html)unter *AWS CLI Befehlsreferenz*. ### `copy-package-versions` Das folgende Codebeispiel zeigt die Verwendung`copy-package-versions`. **AWS CLI** **So kopieren Sie Paketversionen aus einem Repository in ein anderes** Mit dem folgenden `copy-package-versions`-Befehl werden die Versionen 4.0.0 und 5.0.0 eines Pakets namens „test-package“ von „my-repo“ nach „test-repo“ verschoben. ``` aws codeartifact copy-package-versions \ --domain test-domain \ --source-repository my-repo \ --destination-repository test-repo \ --format npm \ --package test-package \ --versions '["4.0.0", "5.0.0"]' ``` Ausgabe: ``` { "format": "npm", "package": "test-package", "versions": [ { "version": "5.0.0", "revision": "REVISION-1-SAMPLE-6C81EFF7DA55CC", "status": "Published" }, { "version": "4.0.0", "revision": "REVISION-2-SAMPLE-55C752BEE772FC", "status": "Published" } ] } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Pakete zwischen Repositorys kopieren](https://docs.aws.amazon.com/codeartifact/latest/ug/copy-package.html). + Einzelheiten zur API finden Sie [CopyPackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/copy-package-versions.html)in der *AWS CLI Befehlsreferenz.* ### `create-domain` Das folgende Codebeispiel zeigt die Verwendung`create-domain`. **AWS CLI** **So erstellen Sie eine Domain** Im folgenden Beispiel für `create-domain` wird eine Domain namens „my-domain“ erstellt. ``` aws codeartifact create-domain \ --domain test-domain ``` Ausgabe: ``` { "domain": { "name": "test-domain", "owner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain", "status": "Active", "createdTime": "2020-10-20T13:16:48.559000-04:00", "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "repositoryCount": 0, "assetSizeBytes": 0 } } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Eine Domäne erstellen](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-create.html). + Einzelheiten zur API finden Sie [CreateDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/create-domain.html)unter *AWS CLI Befehlsreferenz*. ### `create-repository` Das folgende Codebeispiel zeigt die Verwendung`create-repository`. **AWS CLI** **So erstellen Sie ein Repository** Im folgenden Beispiel für `create-repository` wird ein Repository mit dem Namen „test-repo“ in der Domain „test-domain“ erstellt. ``` aws codeartifact create-repository \ --domain test-domain \ --domain-owner 111122223333 \ --repository test-repo \ --description "This is a test repository." ``` Ausgabe: ``` { "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "This is a test repository.", "upstreams": [], "externalConnections": [] } } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Eine Domäne erstellen](https://docs.aws.amazon.com/codeartifact/latest/ug/create-repo.html). + Einzelheiten zur API finden Sie [CreateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/create-repository.html)unter *AWS CLI Befehlsreferenz*. ### `delete-domain-permissions-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-domain-permissions-policy`. **AWS CLI** **So löschen Sie das Dokument mit den Berechtigungsrichtlinien aus einer Domain** Im folgenden Beispiel für `delete-domain-permissions-policy` wird die Berechtigungsrichtlinie aus einer Domain mit dem Namen „test-domain“ gelöscht. ``` aws codeartifact delete-domain-permissions-policy \ --domain test-domain ``` Ausgabe: ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "BasicDomainPolicy", "Action": [ "codeartifact:GetDomainPermissionsPolicy", "codeartifact:ListRepositoriesInDomain", "codeartifact:GetAuthorizationToken", "codeartifact:CreateRepository" ], "Effect": "Allow", "Resource": "*", "Principal": { "AWS": "arn:aws:iam::111122223333:root" } } ] } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Löschen einer Domänenrichtlinie](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-policies.html#deleting-a-domain-policy). + Einzelheiten zur API finden Sie [DeleteDomainPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-domain-permissions-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-domain` Das folgende Codebeispiel zeigt die Verwendung`delete-domain`. **AWS CLI** **So löschen Sie eine Domain** Im folgenden Beispiel für `delete-domain` wird eine Domain namens `test-domain` gelöscht. ``` aws codeartifact delete-domain \ --domain test-domain ``` Ausgabe: ``` { "domain": { "name": "test-domain", "owner": "417498243647", "arn": "arn:aws:codeartifact:us-west-2:417498243647:domain/test-domain", "status": "Deleted", "createdTime": "2020-10-20T13:16:48.559000-04:00", "encryptionKey": "arn:aws:kms:us-west-2:417498243647:key/c9fe2447-0795-4fda-afbe-8464574ae162", "repositoryCount": 0, "assetSizeBytes": 0 } } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Löschen einer Domäne](https://docs.aws.amazon.com/codeartifact/latest/ug/delete-domain.html). + Einzelheiten zur API finden Sie [DeleteDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-domain.html)in der *AWS CLI Befehlsreferenz*. ### `delete-package-versions` Das folgende Codebeispiel zeigt die Verwendung`delete-package-versions`. **AWS CLI** **So löschen Sie Paketversionen** Im folgenden Beispiel für `delete-package-versions` wird Version 4.0.0 eines Pakets namens „test-package“ gelöscht. ``` aws codeartifact delete-package-versions \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --versions 4.0.0 ``` Ausgabe: ``` { "successfulVersions": { "4.0.0": { "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "status": "Deleted" } }, "failedVersions": {} } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Löschen einer Paketversion](https://docs.aws.amazon.com/codeartifact/latest/ug/delete-package.html). + Einzelheiten zur API finden Sie [DeletePackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-package-versions.html)unter *AWS CLI Befehlsreferenz*. ### `delete-repository-permissions-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-repository-permissions-policy`. **AWS CLI** **So löschen Sie eine Berechtigungsrichtlinie aus einem Repository** Im folgenden Beispiel für `delete-repository-permissions-policy` wird die Berechtigungsrichtlinie aus einem Repository mit dem Namen „test-repo“ gelöscht. ``` aws codeartifact delete-repository-permissions-policy \ --domain test-domain \ --repository test-repo ``` Ausgabe: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": [ "codeartifact:DescribePackageVersion", "codeartifact:DescribeRepository", "codeartifact:GetPackageVersionReadme", "codeartifact:GetRepositoryEndpoint", "codeartifact:ListPackages", "codeartifact:ListPackageVersions", "codeartifact:ListPackageVersionAssets", "codeartifact:ListPackageVersionDependencies", "codeartifact:ReadFromRepository" ], "Resource": "*" } ] } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Löschen einer Richtlinie](https://docs.aws.amazon.com/codeartifact/latest/ug/repo-policies.html#deleting-a-policy). + Einzelheiten zur API finden Sie [DeleteRepositoryPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-repository-permissions-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-repository` Das folgende Codebeispiel zeigt die Verwendung`delete-repository`. **AWS CLI** **So löschen Sie ein Repository** Im folgenden Beispiel für `delete-repository` wird ein Repository mit dem Namen `test-repo` in der Domain `test-domain` gelöscht. ``` aws codeartifact delete-repository \ --domain test-domain \ --repository test-repo ``` Ausgabe: ``` { "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "This is a test repository", "upstreams": [], "externalConnections": [] } } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Löschen eines Repositorys](https://docs.aws.amazon.com/codeartifact/latest/ug/delete-repo.html). + Einzelheiten zur API finden Sie [DeleteRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-repository.html)in der *AWS CLI Befehlsreferenz*. ### `describe-domain` Das folgende Codebeispiel zeigt die Verwendung`describe-domain`. **AWS CLI** **So rufen Sie Informationen zu einer Domain auf** Das folgende `describe-domain` Beispiel gibt ein DomainDescription Objekt für eine Domäne mit dem Namen test-domain zurück. ``` aws codeartifact describe-domain \ --domain test-domain ``` Ausgabe: ``` { "domain": { "name": "test-domain", "owner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain", "status": "Active", "createdTime": "2020-10-20T13:16:48.559000-04:00", "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "repositoryCount": 2, "assetSizeBytes": 0, "s3BucketArn": "arn:aws:s3:::assets-111122223333-us-west-2" } } ``` Weitere Informationen finden Sie unter [Domänenübersicht](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-overview.html) im *AWS CodeArtifact Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/describe-domain.html)in der *AWS CLI Befehlsreferenz*. ### `describe-repository` Das folgende Codebeispiel zeigt die Verwendung`describe-repository`. **AWS CLI** **So rufen Sie Informationen zu einem Repository ab** Das folgende `describe-repository` Beispiel gibt ein RepositoryDescription Objekt für ein Repository mit dem Namen test-repo zurück. ``` aws codeartifact describe-repository \ --domain test-domain \ --repository test-repo ``` Ausgabe: ``` { "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "This is a test repository.", "upstreams": [], "externalConnections": [] } } ``` *Weitere Informationen finden Sie im Benutzerhandbuch unter [Create a domain](https://docs.aws.amazon.com/codeartifact/latest/ug/create-repo.html).AWS CodeArtifact * + Einzelheiten zur API finden Sie [DescribeRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/describe-repository.html)unter *AWS CLI Befehlsreferenz*. ### `disassociate-external-connection` Das folgende Codebeispiel zeigt die Verwendung`disassociate-external-connection`. **AWS CLI** **So entfernen Sie eine externe Verbindung aus einem Repository** Im folgenden Beispiel für `disassociate-external-connection` wird eine externe Verbindung mit „npmjs.com“ aus einem Repository namens „test-repo“ entfernt. ``` aws codeartifact disassociate-external-connection \ --repository test-repo \ --domain test-domain \ --external-connection public:npmjs ``` Ausgabe: ``` { "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "upstreams": [], "externalConnections": [] } } ``` Weitere Informationen finden [Sie im *AWS CodeArtifact Benutzerhandbuch* unter Entfernen einer externen Verbindung](https://docs.aws.amazon.com/codeartifact/latest/ug/external-connection.html#removing-an-external-connection). + Einzelheiten zur API finden Sie [DisassociateExternalConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/disassociate-external-connection.html)in der *AWS CLI Befehlsreferenz*. ### `dispose-package-versions` Das folgende Codebeispiel zeigt die Verwendung`dispose-package-versions`. **AWS CLI** **So löschen Sie die Komponenten einer Paketversion und legen ihren Status auf „Entsorgt“ fest** Im folgenden Beispiel für `dispose-package-versions` werden die Komponenten der „test-package“-Version 4.0.0 gelöscht und ihr Status auf „Entsorgt“ gesetzt. ``` aws codeartifact dispose-package-versions \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --versions 4.0.0 ``` Ausgabe: ``` { "successfulVersions": { "4.0.0": { "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "status": "Disposed" } }, "failedVersions": {} } ``` Weitere Informationen finden Sie [ CodeArtifactim *AWS CodeArtifact Benutzerhandbuch* unter Arbeiten mit Paketen](https://docs.aws.amazon.com/codeartifact/latest/ug/packages.html). + Einzelheiten zur API finden Sie [DisposePackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/dispose-package-versions.html)in der *AWS CLI Befehlsreferenz*. ### `get-authorization-token` Das folgende Codebeispiel zeigt die Verwendung`get-authorization-token`. **AWS CLI** **So rufen Sie ein Autorisierungstoken ab** Im folgenden `get-authorization-token` Beispiel wird ein CodeArtifact Autorisierungstoken abgerufen. ``` aws codeartifact get-authorization-token \ --domain test-domain \ --query authorizationToken \ --output text ``` Ausgabe: ``` This command will return the authorization token. You can store the output in an environment variable when calling the command. ``` Weitere Informationen finden [Sie unter Konfiguration von pip ohne den Login-Befehl](https://docs.aws.amazon.com/codeartifact/latest/ug/python-configure-without-pip.html) im *AWS CodeArtifact Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetAuthorizationToken AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-authorization-token.html)*Befehlsreferenz.* ### `get-domain-permissions-policy` Das folgende Codebeispiel zeigt die Verwendung`get-domain-permissions-policy`. **AWS CLI** **So rufen Sie das Dokument mit den Berechtigungsrichtlinien für eine Domain ab** Im folgenden Beispiel für `get-domain-permissions-policy` wird die Berechtigungsrichtlinie abgerufen, die einer Domain mit dem Namen „test-domain“ angefügt ist. ``` aws codeartifact get-domain-permissions-policy \ --domain test-domain ``` Ausgabe: ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "BasicDomainPolicy", "Action": [ "codeartifact:GetDomainPermissionsPolicy", "codeartifact:ListRepositoriesInDomain", "codeartifact:GetAuthorizationToken", "codeartifact:CreateRepository" ], "Effect": "Allow", "Resource": "*", "Principal": { "AWS": "arn:aws:iam::111122223333:root" } } ] } ``` Weitere Informationen finden [Sie unter Lesen einer Domänenrichtlinie](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-policies.html#reading-a-domain-policy) im *AWS CodeArtifact Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetDomainPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-domain-permissions-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-package-version-asset` Das folgende Codebeispiel zeigt die Verwendung`get-package-version-asset`. **AWS CLI** **So rufen Sie eine Komponente aus einer Paketversion ab** Im folgenden Beispiel für `get-package-version-asset` wird die `package.tgz`-Komponente für Version 4.0.0 eines npm-Pakets namens „test-package“ abgerufen. ``` aws codeartifact get-package-version-asset \ --domain test-domain \ --repository test-repo \ --format npm \ --package test-package \ --package-version 4.0.0 \ --asset 'package.tgz' \ outfileName ``` Ausgabe: ``` The output for this command will also store the raw asset in the file provided in place of outfileName. { "assetName": "package.tgz", "packageVersion": "4.0.0", "packageVersionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=" } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Paketversionselemente auflisten](https://docs.aws.amazon.com/codeartifact/latest/ug/list-assets.html). + Einzelheiten zur API finden Sie [GetPackageVersionAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-package-version-asset.html)in der *AWS CLI Befehlsreferenz*. ### `get-package-version-readme` Das folgende Codebeispiel zeigt die Verwendung`get-package-version-readme`. **AWS CLI** **So rufen Sie die Readme-Datei einer Paketversion ab** Im folgenden Beispiel für `get-package-version-readme` wird die Readme-Datei für Version 4.0.0 eines npm-Pakets namens „test-package“ abgerufen. ``` aws codeartifact get-package-version-readme \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --package-version 4.0.0 ``` Ausgabe: ``` { "format": "npm", "package": "test-package", "version": "4.0.0", "readme": "
\n ... more content ... \n", "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=" } ``` Weitere Informationen finden Sie in der [Readme-Datei zur Paketversion anzeigen](https://docs.aws.amazon.com/codeartifact/latest/ug/describe-package-version.html#view-package-readme) im *AWS CodeArtifact Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetPackageVersionReadme](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-package-version-readme.html)in der *AWS CLI Befehlsreferenz.* ### `get-repository-endpoint` Das folgende Codebeispiel zeigt die Verwendung`get-repository-endpoint`. **AWS CLI** **So rufen Sie den URL-Endpunkt eines Repositorys ab** Im folgenden Beispiel für `get-repository-endpoint` wird der NPM-Endpunkt für das Repository „test-repo“ zurückgegeben. ``` aws codeartifact get-repository-endpoint \ --domain test-domain \ --repository test-repo \ --format npm ``` Ausgabe: ``` { "repositoryEndpoint": "https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/" } ``` Weitere Informationen finden Sie unter [Connect zu einem Repository](https://docs.aws.amazon.com/codeartifact/latest/ug/connect-repo.html) herstellen im *AWS CodeArtifact Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetRepositoryEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-repository-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `get-repository-permissions-policy` Das folgende Codebeispiel zeigt die Verwendung`get-repository-permissions-policy`. **AWS CLI** **So rufen Sie das Dokument mit den Berechtigungsrichtlinien für ein Repository ab** Im folgenden Beispiel für `get-repository-permissions-policy` wird die Berechtigungsrichtlinie abgerufen, die einem Repository mit dem Namen „test-repo“ angefügt ist. ``` aws codeartifact get-repository-permissions-policy \ --domain test-domain \ --repository test-repo ``` Ausgabe: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": [ "codeartifact:DescribePackageVersion", "codeartifact:DescribeRepository", "codeartifact:GetPackageVersionReadme", "codeartifact:GetRepositoryEndpoint", "codeartifact:ListPackages", "codeartifact:ListPackageVersions", "codeartifact:ListPackageVersionAssets", "codeartifact:ListPackageVersionDependencies", "codeartifact:ReadFromRepository" ], "Resource": "*" } ] } ``` Weitere Informationen finden [Sie im *AWS CodeArtifact Benutzerhandbuch* unter Eine Richtlinie lesen](https://docs.aws.amazon.com/codeartifact/latest/ug/repo-policies.html#setting-a-policy). + Einzelheiten zur API finden Sie [GetRepositoryPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-repository-permissions-policy.html)in der *AWS CLI Befehlsreferenz*. ### `list-domains` Das folgende Codebeispiel zeigt die Verwendung`list-domains`. **AWS CLI** **So listen Sie Domains auf** Das folgende `list-domains` Beispiel gibt eine Zusammenfassung aller Domänen zurück, die dem AWS Konto gehören, das den Anruf tätigt. ``` aws codeartifact list-domains ``` Ausgabe: ``` { "domains": [ { "name": "my-domain", "owner": "111122223333", "status": "Active", "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, { "name": "test-domain", "owner": "111122223333", "status": "Active", "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ] } ``` Weitere Informationen finden Sie [ CodeArtifactim *AWS CodeArtifact Benutzerhandbuch* unter Arbeiten mit Domänen](https://docs.aws.amazon.com/codeartifact/latest/ug/domains.html). + Einzelheiten zur API finden Sie [ListDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-domains.html)in der *AWS CLI Befehlsreferenz*. ### `list-package-version-assets` Das folgende Codebeispiel zeigt die Verwendung`list-package-version-assets`. **AWS CLI** **So zeigen Sie die Komponenten einer Paketversion an** Im folgenden Beispiel für `list-package-version-assets` werden die Komponenten für Version 4.0.0 eines npm-Pakets namens „test-package“ abgerufen. ``` aws codeartifact list-package-version-assets \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --package-version 4.0.0 ``` Ausgabe: ``` { "format": "npm", "package": "test-package", "version": "4.0.0", "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "assets": [ { "name": "package.tgz", "size": 316680, "hashes": { "MD5": "60078ec6d9e76b89fb55c860832742b2", "SHA-1": "b44a9b6297bcb698f1c51a3545a2b3b368d59c52", "SHA-256": "d2aa8c6afc3c8591765785a37d1c5acae482a8eb3ab9729ed28922692454f2e2", "SHA-512": "3e585d15c8a594e20d7de57b362ea81754c011acb2641a19f1b72c8531ea39825896bab344ae616a0a5a824cb9a381df0b3cddd534645cf305aba70a93dac698" } } ] } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Paketversionselemente auflisten](https://docs.aws.amazon.com/codeartifact/latest/ug/list-assets.html). + Einzelheiten zur API finden Sie [ListPackageVersionAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-package-version-assets.html)in der *AWS CLI Befehlsreferenz*. ### `list-package-version-dependencies` Das folgende Codebeispiel zeigt die Verwendung`list-package-version-dependencies`. **AWS CLI** **So zeigen Sie die Abhängigkeiten einer Paketversion an** Im folgenden Beispiel für `list-package-version-dependencies` werden die Abhängigkeiten für Version 4.0.0 eines npm-Pakets namens „test-package“ abgerufen. ``` aws codeartifact list-package-version-dependencies \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --package-version 4.0.0 ``` Ausgabe: ``` { "format": "npm", "package": "test-package", "version": "4.0.0", "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "dependencies": [ { "namespace": "testns", "package": "testdep1", "dependencyType": "regular", "versionRequirement": "1.8.5" }, { "namespace": "testns", "package": "testdep2", "dependencyType": "regular", "versionRequirement": "1.8.5" } ] } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Anzeigen und Aktualisieren von Paketversionsdetails und Abhängigkeiten](https://docs.aws.amazon.com/codeartifact/latest/ug/describe-package-version.html). + Einzelheiten zur API finden Sie [ListPackageVersionDependencies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-package-version-dependencies.html)unter *AWS CLI Befehlsreferenz*. ### `list-package-versions` Das folgende Codebeispiel zeigt die Verwendung`list-package-versions`. **AWS CLI** **So listen Sie Paketversionen für ein Paket auf** Im folgenden Beispiel für `list-package-versions` wird eine Liste von Paketversionen für ein Paket mit dem Namen `kind-of` zurückgegeben. ``` aws codeartifact list-package-versions \ --package kind-of \ --domain test-domain \ --repository test-repo \ --format npm ``` Ausgabe: ``` { "defaultDisplayVersion": "1.0.1", "format": "npm", "package": "kind-of", "versions": [ { "version": "1.0.1", "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC", "status": "Published" }, { "version": "1.0.0", "revision": "REVISION-SAMPLE-2-C752BEEF6D2CFC", "status": "Published" }, { "version": "0.1.2", "revision": "REVISION-SAMPLE-3-654S65A5C5E1FC", "status": "Published" }, { "version": "0.1.1", "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"", "status": "Published" }, { "version": "0.1.0", "revision": "REVISION-SAMPLE-4-AF669139B772FC", "status": "Published" } ] } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Paketversionen auflisten](https://docs.aws.amazon.com/codeartifact/latest/ug/list-packages-versions.html). + Einzelheiten zur API finden Sie [ListPackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-package-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-packages` Das folgende Codebeispiel zeigt die Verwendung`list-packages`. **AWS CLI** **So listen Sie Pakete in einem Repository auf** Im folgenden Beispiel für `list-packages` werden Pakete in einem Repository mit dem Namen `test-repo` in der Domain `test-domain` aufgelistet. ``` aws codeartifact list-packages \ --domain test-domain \ --repository test-repo ``` Ausgabe: ``` { "packages": [ { "format": "npm", "package": "lodash" } { "format": "python", "package": "test-package" } ] } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Paketnamen auflisten](https://docs.aws.amazon.com/codeartifact/latest/ug/list-packages.html). + Einzelheiten zur API finden Sie [ListPackages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-packages.html)in der *AWS CLI Befehlsreferenz*. ### `list-repositories-in-domain` Das folgende Codebeispiel zeigt die Verwendung`list-repositories-in-domain`. **AWS CLI** **So listen Sie Repositorys in einer Domain auf** Im folgenden Beispiel für `list-repositories-in-domain` wird eine Zusammenfassung aller Repositorys in der Domain „test-domain“ zurückgegeben. ``` aws codeartifact list-repositories-in-domain \ --domain test-domain ``` Ausgabe: ``` { "repositories": [ { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "This is a test repository." }, { "name": "test-repo2", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2", "description": "This is a test repository." } ] } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Repositorys auflisten](https://docs.aws.amazon.com/codeartifact/latest/ug/list-repos.html). + Einzelheiten zur API finden Sie [ListRepositoriesInDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-repositories-in-domain.html)in der *AWS CLI Befehlsreferenz.* ### `list-repositories` Das folgende Codebeispiel zeigt die Verwendung`list-repositories`. **AWS CLI** **So listen Sie Repositorys auf** Das folgende `list-repositories` Beispiel gibt eine Zusammenfassung aller Repositorys in der Domäne zurück, die dem AWS Konto gehört, das den Anruf tätigt. ``` aws codeartifact list-repositories ``` Ausgabe: ``` { "repositories": [ { "name": "npm-store", "administratorAccount": "111122223333", "domainName": "my-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store", "description": "Provides npm artifacts from npm, Inc." }, { "name": "target-repo", "administratorAccount": "111122223333", "domainName": "my-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/target-repo", "description": "test target repo" }, { "name": "test-repo2", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2", "description": "This is a test repository." } ] } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Repositorys auflisten](https://docs.aws.amazon.com/codeartifact/latest/ug/list-repos.html). + Einzelheiten zur API finden Sie [ListRepositories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-repositories.html)in der *AWS CLI Befehlsreferenz.* ### `login` Das folgende Codebeispiel zeigt die Verwendung`login`. **AWS CLI** **So konfigurieren Sie die Authentifizierung für Ihr Repository mit dem Anmeldebefehl** Im folgenden Beispiel für `login` wird der npm-Paketmanager mit einem Repository mit dem Namen „test-repo“ in der Domain „test-domain“ konfiguriert. ``` aws codeartifact login \ --domain test-domain \ --repository test-repo \ --tool npm ``` Ausgabe: ``` Successfully configured npm to use AWS CodeArtifact repository https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/ Login expires in 12 hours at 2020-11-12 01:53:16-05:00 ``` Weitere Informationen finden Sie unter [Erste Schritte mit der AWS CLI](https://docs.aws.amazon.com/codeartifact/latest/ug/getting-started-cli.html) im *AWS CodeArtifact Benutzerhandbuch*. + Weitere API-Informationen finden Sie unter [Login](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/login.html) in der *AWS CLI -Befehlsreferenz*. ### `put-domain-permissions-policy` Das folgende Codebeispiel zeigt die Verwendung`put-domain-permissions-policy`. **AWS CLI** **So fügen Sie eine Berechtigungsrichtlinie an eine Domain an** Im folgenden Beispiel für `put-domain-permissions-policy` wird eine Berechtigungsrichtlinie, die in der Datei „policy.json“ definiert ist, an eine Domain mit dem Namen „test-domain“ angefügt. ``` aws codeartifact put-domain-permissions-policy \ --domain test-domain \ --policy-document file://PATH/TO/policy.json ``` Ausgabe: ``` { "policy": { "resourceArn": "arn:aws:codeartifact:region-id:111122223333:domain/test-domain", "document": "{ ...policy document content...}", "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx=" } } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Eine Domänenrichtlinie einrichten](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-policies.html#set-domain-policy). + Einzelheiten zur API finden Sie [PutDomainPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/put-domain-permissions-policy.html)in der *AWS CLI Befehlsreferenz*. ### `put-repository-permissions-policy` Das folgende Codebeispiel zeigt die Verwendung`put-repository-permissions-policy`. **AWS CLI** **So fügen Sie eine Berechtigungsrichtlinie an ein Repository an** Im folgenden Beispiel für `put-repository-permissions-policy` wird eine Berechtigungsrichtlinie, die in der Datei „policy.json“ definiert ist, an ein Repository mit dem Namen „test-repo“ angefügt. ``` aws codeartifact put-repository-permissions-policy \ --domain test-domain \ --repository test-repo \ --policy-document file://PATH/TO/policy.json ``` Ausgabe: ``` { "policy": { "resourceArn": "arn:aws:codeartifact:region-id:111122223333:repository/test-domain/test-repo", "document": "{ ...policy document content...}", "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx=" } } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Eine Richtlinie festlegen](https://docs.aws.amazon.com/codeartifact/latest/ug/repo-policies.html#setting-a-policy). + Einzelheiten zur API finden Sie [PutRepositoryPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/put-repository-permissions-policy.html)in der *AWS CLI Befehlsreferenz*. ### `update-package-versions-status` Das folgende Codebeispiel zeigt die Verwendung`update-package-versions-status`. **AWS CLI** **So aktualisieren Sie den Status der Paketversion** Im folgenden Beispiel für `update-package-versions-status` wird der Status von Version 4.0.0 des Pakets „test-package“ auf „Archiviert“ aktualisiert. ``` aws codeartifact update-package-versions-status \ --domain test-domain \ --repo test-repo \ --format npm \ --package test-package \ --versions 4.0.0 \ --target-status Archived ``` Ausgabe: ``` { "successfulVersions": { "4.0.0": { "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=", "status": "Archived" } }, "failedVersions": {} } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Versionsstatus des Aktualisierungspakets](https://docs.aws.amazon.com/codeartifact/latest/ug/describe-package-version.html#update-package-version-status). + Einzelheiten zur API finden Sie [UpdatePackageVersionsStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/update-package-versions-status.html)in der *AWS CLI Befehlsreferenz*. ### `update-repository` Das folgende Codebeispiel zeigt die Verwendung`update-repository`. **AWS CLI** **So aktualisieren Sie ein Repository** Im folgenden Beispiel für `update-repository` wird die Beschreibung eines Repositorys mit dem Namen „test-repo“ in der Domain „test-domain“ auf „this is an updated description“ aktualisiert. ``` aws codeartifact update-repository \ --domain test-domain \ --repository test-repo \ --description "this is an updated description" ``` Ausgabe: ``` { "repository": { "name": "test-repo", "administratorAccount": "111122223333", "domainName": "test-domain", "domainOwner": "111122223333", "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo", "description": "this is an updated description", "upstreams": [], "externalConnections": [] } } ``` Weitere Informationen finden Sie im *AWS CodeArtifact Benutzerhandbuch* unter [Eine Repository-Konfiguration anzeigen oder ändern](https://docs.aws.amazon.com/codeartifact/latest/ug/config-repos.html). + Einzelheiten zur API finden Sie [UpdateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/update-repository.html)unter *AWS CLI Befehlsreferenz*. # CodeBuild Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CodeBuild. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-delete-builds` Das folgende Codebeispiel zeigt, wie Sie`batch-delete-builds`. **AWS CLI** **Um Builds zu löschen AWS CodeBuild.** Im folgenden `batch-delete-builds` Beispiel werden Builds CodeBuild mit den angegebenen IDs Werten gelöscht. ``` aws codebuild batch-delete-builds --ids my-build-project-one:a1b2c3d4-5678-9012-abcd-11111EXAMPLE my-build-project-two:a1b2c3d4-5678-9012-abcd-22222EXAMPLE ``` Ausgabe: ``` { "buildsNotDeleted": [ { "id": "arn:aws:codebuild:us-west-2:123456789012:build/my-build-project-one:a1b2c3d4-5678-9012-abcd-11111EXAMPLE", "statusCode": "BUILD_IN_PROGRESS" } ], "buildsDeleted": [ "arn:aws:codebuild:us-west-2:123456789012:build/my-build-project-two:a1b2c3d4-5678-9012-abcd-22222EXAMPLE" ] } ``` Weitere Informationen finden Sie unter [Delete Builds (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-builds.html#delete-builds-cli) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [BatchDeleteBuilds](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/batch-delete-builds.html)in der *AWS CLI Befehlsreferenz*. ### `batch-get-build-batches` Das folgende Codebeispiel zeigt die Verwendung`batch-get-build-batches`. **AWS CLI** **Um Details von Builds in anzuzeigen AWS CodeBuild.** Im folgenden `batch-get-build-batches` Beispiel werden Informationen zu Build-Batches CodeBuild mit den angegebenen IDs Werten abgerufen. ``` aws codebuild batch-get-build-batches \ --ids codebuild-demo-project:e9c4f4df-3f43-41d2-ab3a-60fe2EXAMPLE ``` Ausgabe: ``` { "buildBatches": [ { "id": "codebuild-demo-project:e9c4f4df-3f43-41d2-ab3a-60fe2EXAMPLE", "arn": "arn:aws:codebuild:us-west-2:123456789012:build-batch/codebuild-demo-project:e9c4f4df-3f43-41d2-ab3a-60fe2EXAMPLE", "startTime": "2020-11-03T21:52:20.775000+00:00", "endTime": "2020-11-03T21:56:59.784000+00:00", "currentPhase": "SUCCEEDED", "buildBatchStatus": "SUCCEEDED", "resolvedSourceVersion": "0a6546f68309560d08a310daac92314c4d378f6b", "projectName": "codebuild-demo-project", "phases": [ { "phaseType": "SUBMITTED", "phaseStatus": "SUCCEEDED", "startTime": "2020-11-03T21:52:20.775000+00:00", "endTime": "2020-11-03T21:52:20.976000+00:00", "durationInSeconds": 0 }, { "phaseType": "DOWNLOAD_BATCHSPEC", "phaseStatus": "SUCCEEDED", "startTime": "2020-11-03T21:52:20.976000+00:00", "endTime": "2020-11-03T21:52:57.401000+00:00", "durationInSeconds": 36 }, { "phaseType": "IN_PROGRESS", "phaseStatus": "SUCCEEDED", "startTime": "2020-11-03T21:52:57.401000+00:00", "endTime": "2020-11-03T21:56:59.751000+00:00", "durationInSeconds": 242 }, { "phaseType": "COMBINE_ARTIFACTS", "phaseStatus": "SUCCEEDED", "startTime": "2020-11-03T21:56:59.751000+00:00", "endTime": "2020-11-03T21:56:59.784000+00:00", "durationInSeconds": 0 }, { "phaseType": "SUCCEEDED", "startTime": "2020-11-03T21:56:59.784000+00:00" } ], "source": { "type": "GITHUB", "location": "https://github.com/my-repo/codebuild-demo-project.git", "gitCloneDepth": 1, "gitSubmodulesConfig": { "fetchSubmodules": false }, "reportBuildStatus": false, "insecureSsl": false }, "secondarySources": [], "secondarySourceVersions": [], "artifacts": { "location": "" }, "secondaryArtifacts": [], "cache": { "type": "NO_CACHE" }, "environment": { "type": "LINUX_CONTAINER", "image": "aws/codebuild/amazonlinux2-x86_64-standard:3.0", "computeType": "BUILD_GENERAL1_SMALL", "environmentVariables": [], "privilegedMode": false, "imagePullCredentialsType": "CODEBUILD" }, "logConfig": { "cloudWatchLogs": { "status": "ENABLED" }, "s3Logs": { "status": "DISABLED", "encryptionDisabled": false } }, "buildTimeoutInMinutes": 60, "queuedTimeoutInMinutes": 480, "complete": true, "initiator": "Strohm", "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", "buildBatchNumber": 6, "buildBatchConfig": { "serviceRole": "arn:aws:iam::123456789012:role/service-role/codebuild-demo-project", "restrictions": { "maximumBuildsAllowed": 100 }, "timeoutInMins": 480 }, "buildGroups": [ { "identifier": "DOWNLOAD_SOURCE", "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:us-west-2:123456789012:build/codebuild-demo-project:379737d8-bc35-48ec-97fd-776d27545315", "requestedOn": "2020-11-03T21:52:21.394000+00:00", "buildStatus": "SUCCEEDED", "primaryArtifact": { "type": "no_artifacts", "identifier": "DOWNLOAD_SOURCE" }, "secondaryArtifacts": [] } }, { "identifier": "linux_small", "dependsOn": [], "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:us-west-2:123456789012:build/codebuild-demo-project:dd785171-ed84-4bb6-8ede-ceeb86e54bdb", "requestedOn": "2020-11-03T21:52:57.604000+00:00", "buildStatus": "SUCCEEDED", "primaryArtifact": { "type": "no_artifacts", "identifier": "linux_small" }, "secondaryArtifacts": [] } }, { "identifier": "linux_medium", "dependsOn": [ "linux_small" ], "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:us-west-2:123456789012:build/codebuild-demo-project:97cf7bd4-5313-4786-8243-4aef350a1267", "requestedOn": "2020-11-03T21:54:18.474000+00:00", "buildStatus": "SUCCEEDED", "primaryArtifact": { "type": "no_artifacts", "identifier": "linux_medium" }, "secondaryArtifacts": [] } }, { "identifier": "linux_large", "dependsOn": [ "linux_medium" ], "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:us-west-2:123456789012:build/codebuild-demo-project:60a194cd-0d03-4337-9db1-d41476a17d27", "requestedOn": "2020-11-03T21:55:39.203000+00:00", "buildStatus": "SUCCEEDED", "primaryArtifact": { "type": "no_artifacts", "identifier": "linux_large" }, "secondaryArtifacts": [] } } ] } ], "buildBatchesNotFound": [] } ``` *Weitere Informationen finden Sie unter Batch-Builds in AWS CodeBuild < https://docs.aws.amazon.com/codebuild/ latest/userguide/batch -build.html>) \$1\$1 im Benutzerhandbuch.AWS CodeBuild * + *Einzelheiten zur API finden Sie in der Befehlsreferenz [BatchGetBuildBatches](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/batch-get-build-batches.html).AWS CLI * ### `batch-get-builds` Das folgende Codebeispiel zeigt die Verwendung`batch-get-builds`. **AWS CLI** **Um Details von Builds in anzuzeigen AWS CodeBuild.** Im folgenden `batch-get-builds` Beispiel werden Informationen zu Builds CodeBuild mit den angegebenen Werten abgerufen IDs. ``` aws codebuild batch-get-builds --ids codebuild-demo-project:e9c4f4df-3f43-41d2-ab3a-60fe2EXAMPLE codebuild-demo-project:815e755f-bade-4a7e-80f0-efe51EXAMPLE ``` Ausgabe: ``` { "buildsNotFound": [], "builds": [ { "artifacts": { "md5sum": "0e95edf915048a0c22efe6d139fff837", "location": "arn:aws:s3:::codepipeline-us-west-2-820783811474/CodeBuild-Python-Pip/BuildArtif/6DJsqQa", "encryptionDisabled": false, "sha256sum": "cfa0df33a090966a737f64ae4fe498969fdc842a0c9aec540bf93c37ac0d05a2" }, "logs": { "cloudWatchLogs": { "status": "ENABLED" }, "s3Logs": { "status": "DISABLED" }, "streamName": "46472baf-8f6b-43c2-9255-b3b963af2732", "groupName": "/aws/codebuild/codebuild-demo-project", "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logEvent:group=/aws/codebuild/codebuild-demo-project;stream=46472baf-8f6b-43c2-9255-b3b963af2732" }, "timeoutInMinutes": 60, "environment": { "privilegedMode": false, "computeType": "BUILD_GENERAL1_MEDIUM", "image": "aws/codebuild/windows-base:1.0", "environmentVariables": [], "type": "WINDOWS_CONTAINER" }, "projectName": "codebuild-demo-project", "buildComplete": true, "source": { "gitCloneDepth": 1, "insecureSsl": false, "type": "CODEPIPELINE" }, "buildStatus": "SUCCEEDED", "secondaryArtifacts": [], "phases": [ { "durationInSeconds": 0, "startTime": 1548717462.122, "phaseType": "SUBMITTED", "endTime": 1548717462.484, "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 0, "startTime": 1548717462.484, "phaseType": "QUEUED", "endTime": 1548717462.775, "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 34, "endTime": 1548717496.909, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548717462.775, "phaseType": "PROVISIONING", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 15, "endTime": 1548717512.555, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548717496.909, "phaseType": "DOWNLOAD_SOURCE", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 0, "endTime": 1548717512.734, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548717512.555, "phaseType": "INSTALL", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 0, "endTime": 1548717512.924, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548717512.734, "phaseType": "PRE_BUILD", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 9, "endTime": 1548717522.254, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548717512.924, "phaseType": "BUILD", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 3, "endTime": 1548717525.498, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548717522.254, "phaseType": "POST_BUILD", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 9, "endTime": 1548717534.646, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548717525.498, "phaseType": "UPLOAD_ARTIFACTS", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 2, "endTime": 1548717536.846, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548717534.646, "phaseType": "FINALIZING", "phaseStatus": "SUCCEEDED" }, { "startTime": 1548717536.846, "phaseType": "COMPLETED" } ], "startTime": 1548717462.122, "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", "initiator": "codepipeline/CodeBuild-Pipeline", "secondarySources": [], "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", "currentPhase": "COMPLETED", "id": "codebuild-demo-project:e9c4f4df-3f43-41d2-ab3a-60fe2EXAMPLE", "cache": { "type": "NO_CACHE" }, "sourceVersion": "arn:aws:s3:::codepipeline-us-west-2-820783811474/CodeBuild-Python-Pip/SourceArti/1TspnN3.zip", "endTime": 1548717536.846, "arn": "arn:aws:codebuild:us-west-2:123456789012:build/codebuild-demo-project:e9c4f4df-3f43-41d2-ab3a-60fe2EXAMPLE", "queuedTimeoutInMinutes": 480, "resolvedSourceVersion": "f2194c1757bbdcb0f8f229254a4b3c8b27d43e0b" }, { "artifacts": { "md5sum": "", "overrideArtifactName": false, "location": "arn:aws:s3:::my-artifacts/codebuild-demo-project", "encryptionDisabled": false, "sha256sum": "" }, "logs": { "cloudWatchLogs": { "status": "ENABLED" }, "s3Logs": { "status": "DISABLED" }, "streamName": "4dea3ca4-20ec-4898-b22a-a9eb9292775d", "groupName": "/aws/codebuild/codebuild-demo-project", "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logEvent:group=/aws/codebuild/codebuild-demo-project;stream=4dea3ca4-20ec-4898-b22a-a9eb9292775d" }, "timeoutInMinutes": 60, "environment": { "privilegedMode": false, "computeType": "BUILD_GENERAL1_MEDIUM", "image": "aws/codebuild/windows-base:1.0", "environmentVariables": [], "type": "WINDOWS_CONTAINER" }, "projectName": "codebuild-demo-project", "buildComplete": true, "source": { "gitCloneDepth": 1, "location": "https://github.com/my-repo/codebuild-demo-project.git", "insecureSsl": false, "reportBuildStatus": false, "type": "GITHUB" }, "buildStatus": "SUCCEEDED", "secondaryArtifacts": [], "phases": [ { "durationInSeconds": 0, "startTime": 1548716241.89, "phaseType": "SUBMITTED", "endTime": 1548716242.241, "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 0, "startTime": 1548716242.241, "phaseType": "QUEUED", "endTime": 1548716242.536, "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 33, "endTime": 1548716276.171, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548716242.536, "phaseType": "PROVISIONING", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 15, "endTime": 1548716291.809, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548716276.171, "phaseType": "DOWNLOAD_SOURCE", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 0, "endTime": 1548716291.993, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548716291.809, "phaseType": "INSTALL", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 0, "endTime": 1548716292.191, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548716291.993, "phaseType": "PRE_BUILD", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 9, "endTime": 1548716301.622, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548716292.191, "phaseType": "BUILD", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 3, "endTime": 1548716304.783, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548716301.622, "phaseType": "POST_BUILD", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 8, "endTime": 1548716313.775, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548716304.783, "phaseType": "UPLOAD_ARTIFACTS", "phaseStatus": "SUCCEEDED" }, { "durationInSeconds": 2, "endTime": 1548716315.935, "contexts": [ { "statusCode": "", "message": "" } ], "startTime": 1548716313.775, "phaseType": "FINALIZING", "phaseStatus": "SUCCEEDED" }, { "startTime": 1548716315.935, "phaseType": "COMPLETED" } ], "startTime": 1548716241.89, "secondarySourceVersions": [], "initiator": "my-codebuild-project", "arn": "arn:aws:codebuild:us-west-2:123456789012:build/codebuild-demo-project:815e755f-bade-4a7e-80f0-efe51EXAMPLE", "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", "currentPhase": "COMPLETED", "id": "codebuild-demo-project:815e755f-bade-4a7e-80f0-efe51EXAMPLE", "cache": { "type": "NO_CACHE" }, "endTime": 1548716315.935, "secondarySources": [], "queuedTimeoutInMinutes": 480, "resolvedSourceVersion": "f2194c1757bbdcb0f8f229254a4b3c8b27d43e0b" } ] } ``` Weitere Informationen finden Sie unter [View Build Details (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/view-build-details.html#view-build-details-cli) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [BatchGetBuilds](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/batch-get-builds.html)in der *AWS CLI Befehlsreferenz*. ### `batch-get-projects` Das folgende Codebeispiel zeigt die Verwendung`batch-get-projects`. **AWS CLI** **Um eine Liste mit Namen von AWS CodeBuild Build-Projekten zu erhalten.** Im folgenden `batch-get-projects` Beispiel wird eine namentlich angegebene Liste von CodeBuild Build-Projekten abgerufen. ``` aws codebuild batch-get-projects --names codebuild-demo-project codebuild-demo-project2 my-other-demo-project ``` In der folgenden Ausgabe listet das `projectsNotFound`-Array alle Build-Projektnamen auf, die angegeben, aber nicht gefunden wurden. Das Array `projects` listet Details für jedes Build-Projekt auf, für das Informationen gefunden wurden. ``` { "projectsNotFound": [], "projects": [ { "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", "name": "codebuild-demo-project2", "queuedTimeoutInMinutes": 480, "timeoutInMinutes": 60, "source": { "buildspec": "version: 0.2\n\n#env:\n #variables:\n # key: \"value\"\n # key: \"value\"\n #parameter-store:\n # key: \"value\"\n # key:\"value\"\n\nphases:\n #install:\n #commands:\n # - command\n # - command\n #pre_build:\n #commands:\n # - command\n # - command\n build:\n commands:\n # - command\n # - command\n #post_build:\n #commands:\n # - command\n # - command\n#artifacts:\n #files:\n # - location\n # - location\n #name: $(date +%Y-%m-%d)\n #discard-paths: yes\n #base-directory: location\n#cache:\n #paths:\n # - paths", "type": "NO_SOURCE", "insecureSsl": false, "gitCloneDepth": 1 }, "artifacts": { "type": "NO_ARTIFACTS" }, "badge": { "badgeEnabled": false }, "lastModified": 1540588091.108, "created": 1540588091.108, "arn": "arn:aws:codebuild:us-west-2:123456789012:project/test-for-sample", "secondarySources": [], "secondaryArtifacts": [], "cache": { "type": "NO_CACHE" }, "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-test-role", "environment": { "image": "aws/codebuild/java:openjdk-8", "privilegedMode": true, "type": "LINUX_CONTAINER", "computeType": "BUILD_GENERAL1_SMALL", "environmentVariables": [] }, "tags": [] }, { "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", "name": "my-other-demo-project", "queuedTimeoutInMinutes": 480, "timeoutInMinutes": 60, "source": { "location": "https://github.com/iversonic/codedeploy-sample.git", "reportBuildStatus": false, "buildspec": "buildspec.yml", "insecureSsl": false, "gitCloneDepth": 1, "type": "GITHUB", "auth": { "type": "OAUTH" } }, "artifacts": { "type": "NO_ARTIFACTS" }, "badge": { "badgeEnabled": false }, "lastModified": 1523401711.73, "created": 1523401711.73, "arn": "arn:aws:codebuild:us-west-2:123456789012:project/Project2", "cache": { "type": "NO_CACHE" }, "serviceRole": "arn:aws:iam::123456789012:role/service-role/codebuild-Project2-service-role", "environment": { "image": "aws/codebuild/nodejs:4.4.7", "privilegedMode": false, "type": "LINUX_CONTAINER", "computeType": "BUILD_GENERAL1_SMALL", "environmentVariables": [] }, "tags": [] } ] } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Details eines Build-Projekts anzeigen (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/view-project-details.html#view-project-details-cli). + Einzelheiten zur API finden Sie [BatchGetProjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/batch-get-projects.html)in der *AWS CLI Befehlsreferenz*. ### `batch-get-report-groups` Das folgende Codebeispiel zeigt die Verwendung`batch-get-report-groups`. **AWS CLI** **Um Informationen zu einer oder mehreren Berichtsgruppen in zu erhalten AWS CodeBuild.** Im folgenden Beispiel für `batch-get-report-groups` ruft Informationen zur Berichtsgruppe mit dem angegebenen ARN ab. ``` aws codebuild batch-get-report-groups \ --report-group-arns arn:aws:codebuild:::report-group/ ``` Ausgabe: ``` { "reportGroups": [ { "arn": "arn:aws:codebuild:::report-group/", "name": "report-group-name", "type": "TEST", "exportConfig": { "exportConfigType": "NO_EXPORT" }, "created": "2020-10-01T18:04:08.466000+00:00", "lastModified": "2020-10-01T18:04:08.466000+00:00", "tags": [] } ], "reportGroupsNotFound": [] } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichtsgruppen](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report-group.html). + Einzelheiten zur API finden Sie [BatchGetReportGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/batch-get-report-groups.html)unter *AWS CLI Befehlsreferenz*. ### `batch-get-reports` Das folgende Codebeispiel zeigt die Verwendung`batch-get-reports`. **AWS CLI** **Um Informationen zu einem oder mehreren Berichten in zu erhalten AWS CodeBuild.** Im folgenden `batch-get-reports` Beispiel werden Informationen zu den Berichten mit den angegebenen ARNs Werten abgerufen. ``` aws codebuild batch-get-reports \ --report-arns arn:aws:codebuild:::report/: arn:aws:codebuild:::report/: ``` Ausgabe: ``` { "reports": [ { "arn": "arn:aws:codebuild:::report/:", "type": "TEST", "name": "", "reportGroupArn": "arn:aws:codebuild:::report-group/", "executionId": "arn:aws:codebuild:::build/test-reports:", "status": "FAILED", "created": "2020-10-01T11:25:22.531000-07:00", "expired": "2020-10-31T11:25:22-07:00", "exportConfig": { "exportConfigType": "NO_EXPORT" }, "truncated": false, "testSummary": { "total": 28, "statusCounts": { "ERROR": 5, "FAILED": 1, "SKIPPED": 4, "SUCCEEDED": 18, "UNKNOWN": 0 }, "durationInNanoSeconds": 94000000 } }, { "arn": "arn:aws:codebuild:::report/:", "type": "TEST", "name": "", "reportGroupArn": "arn:aws:codebuild:::report-group/", "executionId": "arn:aws:codebuild:::build/test-reports:", "status": "FAILED", "created": "2020-10-01T11:13:05.816000-07:00", "expired": "2020-10-31T11:13:05-07:00", "exportConfig": { "exportConfigType": "NO_EXPORT" }, "truncated": false, "testSummary": { "total": 28, "statusCounts": { "ERROR": 5, "FAILED": 1, "SKIPPED": 4, "SUCCEEDED": 18, "UNKNOWN": 0 }, "durationInNanoSeconds": 94000000 } } ], "reportsNotFound": [] } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichten](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report.html). + Einzelheiten zur API finden Sie [BatchGetReports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/batch-get-reports.html)in der *AWS CLI Befehlsreferenz*. ### `create-project` Das folgende Codebeispiel zeigt die Verwendung`create-project`. **AWS CLI** **Beispiel 1: Um ein AWS CodeBuild Build-Projekt zu erstellen** Im folgenden `create-project` Beispiel wird ein CodeBuild Build-Projekt mit Quelldateien aus einem S3-Bucket erstellt ``` aws codebuild create-project \ --name "my-demo-project" \ --source "{\"type\": \"S3\",\"location\": \"codebuild-us-west-2-123456789012-input-bucket/my-source.zip\"}" \ --artifacts {"\"type\": \"S3\",\"location\": \"codebuild-us-west-2-123456789012-output-bucket\""} \ --environment "{\"type\": \"LINUX_CONTAINER\",\"image\": \"aws/codebuild/standard:1.0\",\"computeType\": \"BUILD_GENERAL1_SMALL\"}" \ --service-role "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role" ``` Ausgabe: ``` { "project": { "arn": "arn:aws:codebuild:us-west-2:123456789012:project/my-demo-project", "name": "my-cli-demo-project", "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", "lastModified": 1556839783.274, "badge": { "badgeEnabled": false }, "queuedTimeoutInMinutes": 480, "environment": { "image": "aws/codebuild/standard:1.0", "computeType": "BUILD_GENERAL1_SMALL", "type": "LINUX_CONTAINER", "imagePullCredentialsType": "CODEBUILD", "privilegedMode": false, "environmentVariables": [] }, "artifacts": { "location": "codebuild-us-west-2-123456789012-output-bucket", "name": "my-cli-demo-project", "namespaceType": "NONE", "type": "S3", "packaging": "NONE", "encryptionDisabled": false }, "source": { "type": "S3", "location": "codebuild-us-west-2-123456789012-input-bucket/my-source.zip", "insecureSsl": false }, "timeoutInMinutes": 60, "cache": { "type": "NO_CACHE" }, "created": 1556839783.274 } } ``` **Beispiel 2: Um ein AWS CodeBuild Build-Projekt mit einer JSON-Eingabedatei für die Parameter zu erstellen** Im folgenden `create-project` Beispiel wird ein CodeBuild Build-Projekt erstellt, indem alle erforderlichen Parameter in einer JSON-Eingabedatei übergeben werden. Erstellen Sie die Vorlage für die Eingabedatei, indem Sie den Befehl nur mit `--generate-cli-skeleton parameter` ausführen. ``` aws codebuild create-project --cli-input-json file://create-project.json ``` Die JSON-Eingabedatei `create-project.json` enthält Folgendes: ``` { "name": "codebuild-demo-project", "source": { "type": "S3", "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip" }, "artifacts": { "type": "S3", "location": "codebuild-region-ID-account-ID-output-bucket" }, "environment": { "type": "LINUX_CONTAINER", "image": "aws/codebuild/standard:1.0", "computeType": "BUILD_GENERAL1_SMALL" }, "serviceRole": "serviceIAMRole" } ``` Ausgabe: ``` { "project": { "name": "codebuild-demo-project", "serviceRole": "serviceIAMRole", "tags": [], "artifacts": { "packaging": "NONE", "type": "S3", "location": "codebuild-region-ID-account-ID-output-bucket", "name": "message-util.zip" }, "lastModified": 1472661575.244, "timeoutInMinutes": 60, "created": 1472661575.244, "environment": { "computeType": "BUILD_GENERAL1_SMALL", "image": "aws/codebuild/standard:1.0", "type": "LINUX_CONTAINER", "environmentVariables": [] }, "source": { "type": "S3", "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip" }, "encryptionKey": "arn:aws:kms:region-ID:account-ID:alias/aws/s3", "arn": "arn:aws:codebuild:region-ID:account-ID:project/codebuild-demo-project" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Build-Projekts (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/create-project.html#create-project-cli) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/create-project.html)unter *AWS CLI Befehlsreferenz*. ### `create-report-group` Das folgende Codebeispiel zeigt die Verwendung`create-report-group`. **AWS CLI** **Um eine Berichtsgruppe in zu erstellen AWS CodeBuild.** Im folgenden Beispiel für `create-report-group` wird eine neue Berichtsgruppe erstellt. ``` aws codebuild create-report-group \ --cli-input-json file://create-report-group-source.json ``` Inhalt create-report-group-source von.json: ``` { "name": "cli-created-report-group", "type": "TEST", "exportConfig": { "exportConfigType": "S3", "s3Destination": { "bucket": "amzn-s3-demo-bucket", "path": "", "packaging": "ZIP", "encryptionDisabled": true } } } ``` Ausgabe: ``` { "reportGroup": { "arn": "arn:aws:codebuild:::report-group/cli-created-report-group", "name": "cli-created-report-group", "type": "TEST", "exportConfig": { "exportConfigType": "S3", "s3Destination": { "bucket": "amzn-s3-demo-bucket", "path": "", "packaging": "ZIP", "encryptionDisabled": true } }, "created": 1602020026.775, "lastModified": 1602020026.775 } } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichtsgruppen](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report-group.html). + Einzelheiten zur API finden Sie [CreateReportGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/create-report-group.html)unter *AWS CLI Befehlsreferenz*. ### `create-webhook` Das folgende Codebeispiel zeigt die Verwendung`create-webhook`. **AWS CLI** **Um Webhook-Filter für ein AWS CodeBuild Projekt zu erstellen** Im folgenden `create-webhook` Beispiel wird ein Webhook für ein CodeBuild Projekt mit dem Namen erstellt`my-project`, das zwei Filtergruppen hat. Die erste Filtergruppe gibt Pull-Anfragen an, die in Verzweigungen mit Git-Referenznamen, die dem regulären Ausdruck `^refs/heads/master$` entsprechen, und mit Kopfreferenzen, die `^refs/heads/myBranch$` entsprechen, erstellt, aktualisiert oder erneut geöffnet werden. Die zweite Filtergruppe gibt Push-Anforderungen in Branches mit Git-Referenznamen an, die dem regulären Ausdruck `^refs/heads/myBranch$` nicht entsprechen. ``` aws codebuild create-webhook \ --project-name my-project \ --filter-groups "[[{\"type\":\"EVENT\",\"pattern\":\"PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED\"},{\"type\":\"HEAD_REF\",\"pattern\":\"^refs/heads/myBranch$\",\"excludeMatchedPattern\":true},{\"type\":\"BASE_REF\",\"pattern\":\"^refs/heads/master$\",\"excludeMatchedPattern\":true}],[{\"type\":\"EVENT\",\"pattern\":\"PUSH\"},{\"type\":\"HEAD_REF\",\"pattern\":\"^refs/heads/myBranch$\",\"excludeMatchedPattern\":true}]]" ``` Ausgabe: ``` { "webhook": { "payloadUrl": "https://codebuild.us-west-2.amazonaws.com/webhooks?t=eyJlbmNyeXB0ZWREYXRhIjoiVVl5MGtoeGRwSzZFRXl2Wnh4bld1Z0tKZ291TVpQNEtFamQ3RDlDYWpRaGIreVFrdm9EQktIVk1NeHJEWEpmUDUrVUNOMUIyRHJRc1VxcHJ6QlNDSnljPSIsIml2UGFyYW1ldGVyU3BlYyI6InN4Tm1SeUt5MUhaUVRWbGciLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&v=1", "url": "https://api.github.com/repos/iversonic/codedeploy-sample/hooks/105190656", "lastModifiedSecret": 1556311319.069, "filterGroups": [ [ { "type": "EVENT", "pattern": "PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED", "excludeMatchedPattern": false }, { "type": "HEAD_REF", "pattern": "refs/heads/myBranch$", "excludeMatchedPattern": true }, { "type": "BASE_REF", "pattern": "refs/heads/master$", "excludeMatchedPattern": true } ], [ { "type": "EVENT", "pattern": "PUSH", "excludeMatchedPattern": false }, { "type": "HEAD_REF", "pattern": "refs/heads/myBranch$", "excludeMatchedPattern": true } ] ] } } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Filtern von GitHub Webhook-Ereignissen (SDK)](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-github-pull-request.html#sample-github-pull-request-filter-webhook-events-sdk). + Einzelheiten zur API finden Sie [CreateWebhook](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/create-webhook.html)in der *AWS CLI Befehlsreferenz.* ### `delete-build-batch` Das folgende Codebeispiel zeigt die Verwendung`delete-build-batch`. **AWS CLI** **Um ein Batch-Build in zu löschen AWS CodeBuild.** Im folgenden Beispiel für `delete-build-batch` wird der angegebene Batch-Build gelöscht. ``` aws codebuild delete-build-batch \ --id : ``` Ausgabe: ``` { "statusCode": "BATCH_DELETED", "buildsDeleted": [ "arn:aws:codebuild:::build/:", "arn:aws:codebuild:::build/:", "arn:aws:codebuild:::build/:", "arn:aws:codebuild:::build/:" ], "buildsNotDeleted": [] } ``` Weitere Informationen finden Sie [im *AWS CodeBuild Benutzerhandbuch* unter Batch-Builds AWS CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/batch-build.html) in. + Einzelheiten zur API finden Sie [DeleteBuildBatch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/delete-build-batch.html)in der *AWS CLI Befehlsreferenz*. ### `delete-project` Das folgende Codebeispiel zeigt die Verwendung`delete-project`. **AWS CLI** **Um ein AWS CodeBuild Build-Projekt zu löschen** Im folgenden `delete-project` Beispiel wird das angegebene CodeBuild Build-Projekt gelöscht. ``` aws codebuild delete-project --name my-project ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Build-Projekts (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/delete-project.html)unter *AWS CLI Befehlsreferenz*. ### `delete-report-group` Das folgende Codebeispiel zeigt die Verwendung`delete-report-group`. **AWS CLI** **Um einen Bericht zu löschen, gruppiert sich in AWS CodeBuild.** Im folgenden Beispiel für `delete-report-group` wird die Berichtsgruppe mit dem angegebenen ARN gelöscht. ``` aws codebuild delete-report-group \ --arn arn:aws:codebuild:::report-group/ ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichtsgruppen](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report-group.html). + Einzelheiten zur API finden Sie [DeleteReportGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/delete-report-group.html)unter *AWS CLI Befehlsreferenz*. ### `delete-report` Das folgende Codebeispiel zeigt die Verwendung`delete-report`. **AWS CLI** **Um einen Bericht in zu löschen AWS CodeBuild.** Im folgenden Beispiel für `delete-report` wird der angegebene Bericht gelöscht. ``` aws codebuild delete-report \ --arn arn:aws:codebuild:::report/: ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichten](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report.html). + Einzelheiten zur API finden Sie [DeleteReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/delete-report.html)in der *AWS CLI Befehlsreferenz*. ### `delete-source-credentials` Das folgende Codebeispiel zeigt die Verwendung`delete-source-credentials`. **AWS CLI** **So trennen Sie die Verbindung mit einem Quellanbieter und löschen dessen Zugriffstoken.** Im folgenden Beispiel für `delete-source-credentials` wird die Verbindung zu einem Quellanbieter getrennt und dessen Token werden entfernt. Der ARN der Quellanmeldeinformationen, die für die Verbindung mit dem Quellanbieter verwendet werden, bestimmt, welche Quellanmeldedaten verwendet werden. ``` aws codebuild delete-source-credentials --arn arn-of-your-credentials ``` Ausgabe: ``` { "arn": "arn:aws:codebuild:your-region:your-account-id:token/your-server-type" } ``` Weitere Informationen finden Sie unter [Connect Source Providers with Access Tokens (CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-access-tokens.html#sample-access-tokens-cli) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteSourceCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/delete-source-credentials.html)unter *AWS CLI Befehlsreferenz*. ### `delete-webhook` Das folgende Codebeispiel zeigt die Verwendung`delete-webhook`. **AWS CLI** **Um einen Webhook-Filter aus einem AWS CodeBuild Projekt zu löschen** Im folgenden `delete-webhook` Beispiel wird ein Webhook aus dem angegebenen Projekt gelöscht. CodeBuild ``` aws codebuild delete-webhook --project-name my-project ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Automatisches Ausführen von Builds (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/run-build.html#run-build-cli-auto-stop) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteWebhook](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/delete-webhook.html)in der *AWS CLI Befehlsreferenz*. ### `describe-code-coverages` Das folgende Codebeispiel zeigt die Verwendung`describe-code-coverages`. **AWS CLI** **Detaillierte Informationen zu den Testergebnissen der Codeabdeckung finden Sie unter AWS CodeBuild.** Im folgenden Beispiel für `describe-code-coverages` werden Informationen zu den Testergebnissen der Codeabdeckung im angegebenen Bericht abgerufen. ``` aws codebuild describe-code-coverages \ --report-arn arn:aws:codebuild:::report/: ``` Ausgabe: ``` { "codeCoverages": [ { "id": "20a0adcc-db13-4b66-804b-ecaf9f852855", "reportARN": "arn:aws:codebuild::972506530580:report/:", "filePath": "", "lineCoveragePercentage": 83.33, "linesCovered": 5, "linesMissed": 1, "branchCoveragePercentage": 50.0, "branchesCovered": 1, "branchesMissed": 1, "expired": "2020-11-20T21:22:45+00:00" }, { "id": "0887162d-bf57-4cf1-a164-e432373d1a83", "reportARN": "arn:aws:codebuild::972506530580:report/:", "filePath": "", "lineCoveragePercentage": 90.9, "linesCovered": 10, "linesMissed": 1, "branchCoveragePercentage": 50.0, "branchesCovered": 1, "branchesMissed": 1, "expired": "2020-11-20T21:22:45+00:00" } ] } ``` Weitere Informationen finden Sie unter [Berichte zur Codeabdeckung](https://docs.aws.amazon.com/codebuild/latest/userguide/code-coverage-report.html) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeCodeCoverages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/describe-code-coverages.html)in der *AWS CLI Befehlsreferenz*. ### `describe-test-cases` Das folgende Codebeispiel zeigt die Verwendung`describe-test-cases`. **AWS CLI** **Um detaillierte Informationen zu Testfällen zu erhalten, finden Sie in AWS CodeBuild.** Im folgenden Beispiel für `describe-test-cases` werden Informationen zu den Testfällen im angegebenen Bericht abgerufen. ``` aws codebuild describe-test-cases \ --report-arn arn:aws:codebuild:::report/: ``` Ausgabe: ``` { "testCases": [ { "reportArn": "arn:aws:codebuild:::report/:", "testRawDataPath": "", "prefix": "NUnit.Tests.Assemblies.MockTestFixture", "name": "NUnit.Tests.Assemblies.MockTestFixture.NotRunnableTest", "status": "ERROR", "durationInNanoSeconds": 0, "message": "No arguments were provided\n", "expired": "2020-11-20T17:52:10+00:00" }, { "reportArn": "arn:aws:codebuild:::report/:", "testRawDataPath": "", "prefix": "NUnit.Tests.Assemblies.MockTestFixture", "name": "NUnit.Tests.Assemblies.MockTestFixture.TestWithException", "status": "ERROR", "durationInNanoSeconds": 0, "message": "System.ApplicationException : Intentional Exception\nat NUnit.Tests.Assemblies.MockTestFixture.MethodThrowsException()\nat NUnit.Tests.Assemblies.MockTestFixture.TestWithException()\n\n", "expired": "2020-11-20T17:52:10+00:00" } ] } ``` Weitere Informationen finden Sie [AWS CodeBuildim *AWS CodeBuild Benutzerhandbuch* unter Arbeiten mit Testberichten](https://docs.aws.amazon.com/codebuild/latest/userguide/test-reporting.html). + Einzelheiten zur API finden Sie [DescribeTestCases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/describe-test-cases.html)in der *AWS CLI Befehlsreferenz*. ### `import-source-credentials` Das folgende Codebeispiel zeigt die Verwendung`import-source-credentials`. **AWS CLI** **Connect einen AWS CodeBuild Benutzer mit einem Quellanbieter, indem Sie Anmeldeinformationen für den Quellanbieter importieren.** Im folgenden Beispiel für `import-source-credentials` wird ein Token für ein Bitbucket-Repository importiert, das BASIC\$1AUTH als Authentifizierungstyp verwendet. ``` aws codebuild import-source-credentials --server-type BITBUCKET --auth-type BASIC_AUTH --token my-Bitbucket-password --username my-Bitbucket-username ``` Ausgabe: ``` { "arn": "arn:aws:codebuild:us-west-2:123456789012:token/bitbucket" } ``` Weitere Informationen finden Sie unter [Connect Source Providers with Access Tokens (CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-access-tokens.html#sample-access-tokens-cli) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ImportSourceCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/import-source-credentials.html)unter *AWS CLI Befehlsreferenz*. ### `invalidate-project-cache` Das folgende Codebeispiel zeigt die Verwendung`invalidate-project-cache`. **AWS CLI** **Um den Cache für ein AWS CodeBuild Build-Projekt zurückzusetzen.** Im folgenden `invalidate-project-cache` Beispiel wird der Cache für das angegebene CodeBuild Projekt zurückgesetzt. ``` aws codebuild invalidate-project-cache --project-name my-project ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Build Caching CodeBuild im AWS](https://docs.aws.amazon.com/codebuild/latest/userguide/build-caching.html) *CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [InvalidateProjectCache](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/invalidate-project-cache.html)in der *AWS CLI Befehlsreferenz.* ### `list-build-batches-for-project` Das folgende Codebeispiel zeigt die Verwendung`list-build-batches-for-project`. **AWS CLI** **Um Batch-Builds für ein bestimmtes Build-Projekt in aufzulisten AWS CodeBuild.** Das folgende `list-build-batches-for-project` Beispiel listet die CodeBuild Batch-Builds für das angegebene Projekt auf. ``` aws codebuild list-build-batches-for-project \ --project-name "" ``` Ausgabe: ``` { "ids": [ ":", ":" ] } ``` Weitere Informationen finden Sie [im *AWS CodeBuild Benutzerhandbuch* unter Batch-Builds AWS CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/batch-build.html) in. + Einzelheiten zur API finden Sie [ListBuildBatchesForProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-build-batches-for-project.html)in der *AWS CLI Befehlsreferenz*. ### `list-build-batches` Das folgende Codebeispiel zeigt die Verwendung`list-build-batches`. **AWS CLI** **Um Batch-Builds aufzulisten AWS CodeBuild.** Im folgenden `list-build-batches` Beispiel werden die CodeBuild Batch-Builds für das Girokonto aufgeführt. ``` aws codebuild list-build-batches ``` Ausgabe: ``` { "ids": [ ":", ":" ] } ``` *Weitere Informationen finden Sie unter Batch-Builds in AWS CodeBuild < https://docs.aws.amazon.com/codebuild/ latest/userguide/batch -build.html>) \$1\$1 im Benutzerhandbuch.AWS CodeBuild * + *Einzelheiten zur API finden Sie in der Befehlsreferenz [ListBuildBatches](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-build-batches.html).AWS CLI * ### `list-builds-for-project` Das folgende Codebeispiel zeigt die Verwendung`list-builds-for-project`. **AWS CLI** **Um eine Liste von Builds für ein AWS CodeBuild Build-Projekt anzuzeigen.** Im folgenden `list-builds-for-project` Beispiel wird der Build für das angegebene CodeBuild Build-Projekt IDs in absteigender Reihenfolge aufgeführt. ``` aws codebuild list-builds-for-project --project-name codebuild-demo-project --sort-order DESCENDING ``` Ausgabe: ``` { "ids": [ "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-11111example", "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-22222example", "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-33333example", "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-44444example", "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-55555example" ] } ``` Weitere Informationen finden Sie unter [Anzeigen einer Build-Liste IDs für ein Build-Projekt (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/view-builds-for-project.html#view-builds-for-project-cli) im *AWS CodeBuild Benutzerhandbuch* + Einzelheiten zur API finden Sie [ListBuildsForProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-builds-for-project.html)unter *AWS CLI Befehlsreferenz*. ### `list-builds` Das folgende Codebeispiel zeigt die Verwendung`list-builds`. **AWS CLI** **Um eine Liste von AWS CodeBuild Builds zu erhalten IDs.** Im folgenden `list-builds` Beispiel wird eine in aufsteigender Reihenfolge CodeBuild IDs sortierte Liste abgerufen. ``` aws codebuild list-builds --sort-order ASCENDING ``` Die Ausgabe enthält einen `nextToken`-Wert, der angibt, dass mehr Ausgaben verfügbar sind. ``` { "nextToken": "4AEA6u7J...The full token has been omitted for brevity...MzY2OA==", "ids": [ "codebuild-demo-project:815e755f-bade-4a7e-80f0-efe51EXAMPLE" "codebuild-demo-project:84a7f3d1-d40e-4956-b4cf-7a9d4EXAMPLE" ... The full list of build IDs has been omitted for brevity ... "codebuild-demo-project:931d0b72-bf6f-4040-a472-5c707EXAMPLE" ] } ``` Führen Sie diesen Befehl erneut aus und geben Sie den `nextToken`-Wert aus der vorherigen Antwort als Parameter an, um den nächsten Teil der Ausgabe abzurufen. Wiederholen Sie den Vorgang, bis Sie in der Antwort keinen `nextToken`-Wert mehr erhalten. ``` aws codebuild list-builds --sort-order ASCENDING --next-token 4AEA6u7J...The full token has been omitted for brevity...MzY2OA== ``` Nächster Teil der Ausgabe: ``` { "ids": [ "codebuild-demo-project:49015049-21cf-4b50-9708-df115EXAMPLE", "codebuild-demo-project:543e7206-68a3-46d6-a4da-759abEXAMPLE", ... The full list of build IDs has been omitted for brevity ... "codebuild-demo-project:c282f198-4582-4b38-bdc0-26f96EXAMPLE" ] } ``` Weitere Informationen finden Sie unter [View a List of Build IDs (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/view-build-list.html) im *AWS CodeBuild Benutzerhandbuch* + Einzelheiten zur API finden Sie [ListBuilds](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-builds.html)in der *AWS CLI Befehlsreferenz*. ### `list-curated-environment-images` Das folgende Codebeispiel zeigt die Verwendung`list-curated-environment-images`. **AWS CLI** **Um eine Liste der von Ihnen verwalteten Docker-Images zu erhalten AWS CodeBuild , die Sie für Ihre Builds verwenden können.** Das folgende `list-curated-environment-images` Beispiel listet die Docker-Images auf, die von verwaltet werden und CodeBuild die für Builds verwendet werden können. : ``` aws codebuild list-curated-environment-images ``` Ausgabe: ``` { "platforms": [ { "platform": "AMAZON_LINUX", "languages": [ { "language": "JAVA", "images": [ { "description": "AWS ElasticBeanstalk - Java 7 Running on Amazon Linux 64bit v2.1.3", "name": "aws/codebuild/eb-java-7-amazonlinux-64:2.1.3", "versions": [ "aws/codebuild/eb-java-7-amazonlinux-64:2.1.3-1.0.0" ] }, { "description": "AWS ElasticBeanstalk - Java 8 Running on Amazon Linux 64bit v2.1.3", "name": "aws/codebuild/eb-java-8-amazonlinux-64:2.1.3", "versions": [ "aws/codebuild/eb-java-8-amazonlinux-64:2.1.3-1.0.0" ] }, ... LIST TRUNCATED FOR BREVITY ... ] } ] } ] } ``` Weitere Informationen finden Sie CodeBuild im *AWS CodeBuild Benutzerhandbuch* unter [Docker-Images bereitgestellt von](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-available.html) + Einzelheiten zur API finden Sie [ListCuratedEnvironmentImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-curated-environment-images.html)in der *AWS CLI Befehlsreferenz.* ### `list-projects` Das folgende Codebeispiel zeigt die Verwendung`list-projects`. **AWS CLI** **Um eine Liste mit Namen von AWS CodeBuild Build-Projekten zu erhalten.** Im folgenden `list-projects` Beispiel wird eine Liste von CodeBuild Build-Projekten abgerufen, die in aufsteigender Reihenfolge nach Namen sortiert sind. ``` aws codebuild list-projects --sort-by NAME --sort-order ASCENDING ``` Die Ausgabe enthält einen `nextToken`-Wert, der angibt, dass mehr Ausgaben verfügbar sind. ``` { "nextToken": "Ci33ACF6...The full token has been omitted for brevity...U+AkMx8=", "projects": [ "codebuild-demo-project", "codebuild-demo-project2", ... The full list of build project names has been omitted for brevity ... "codebuild-demo-project99" ] } ``` Führen Sie diesen Befehl erneut aus und geben Sie den `nextToken`-Wert aus der vorherigen Antwort als Parameter an, um den nächsten Teil der Ausgabe abzurufen. Wiederholen Sie den Vorgang, bis Sie in der Antwort keinen `nextToken`-Wert mehr erhalten. ``` aws codebuild list-projects --sort-by NAME --sort-order ASCENDING --next-token Ci33ACF6...The full token has been omitted for brevity...U+AkMx8= { "projects": [ "codebuild-demo-project100", "codebuild-demo-project101", ... The full list of build project names has been omitted for brevity ... "codebuild-demo-project122" ] } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Anzeigen einer Liste von Build-Projektnamen (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/view-project-list.html#view-project-list-cli). + Einzelheiten zur API finden Sie [ListProjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-projects.html)in der *AWS CLI Befehlsreferenz*. ### `list-report-groups` Das folgende Codebeispiel zeigt die Verwendung`list-report-groups`. **AWS CLI** **Um eine Liste der Berichtsgruppe abzurufen, ARNs in AWS CodeBuild.** Im folgenden `list-report-groups` Beispiel wird die Berichtsgruppe ARNs für das Konto in der Region abgerufen. ``` aws codebuild list-report-groups ``` Ausgabe: ``` { "reportGroups": [ "arn:aws:codebuild:::report-group/report-group-1", "arn:aws:codebuild:::report-group/report-group-2", "arn:aws:codebuild:::report-group/report-group-3" ] } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichtsgruppen](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report-group.html). + Einzelheiten zur API finden Sie [ListReportGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-report-groups.html)unter *AWS CLI Befehlsreferenz*. ### `list-reports-for-report-group` Das folgende Codebeispiel zeigt die Verwendung`list-reports-for-report-group`. **AWS CLI** **Um eine Liste der Berichte in einer Berichtsgruppe in abzurufen AWS CodeBuild.** Im folgenden Beispiel für `list-report-for-report-groups` werden die Berichte in der angegebenen Berichtsgruppe für das Konto in der Region abgerufen. ``` aws codebuild list-reports-for-report-group \ --report-group-arn arn:aws:codebuild:::report-group/ ``` Ausgabe: ``` { "reports": [ "arn:aws:codebuild:::report/report-1", "arn:aws:codebuild:::report/report-2", "arn:aws:codebuild:::report/report-3" ] } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichtsgruppen](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report-group.html). + Einzelheiten zur API finden Sie [ListReportsForReportGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-reports-for-report-group.html)unter *AWS CLI Befehlsreferenz*. ### `list-reports` Das folgende Codebeispiel zeigt die Verwendung`list-reports`. **AWS CLI** **Um eine Liste der Berichte für das Girokonto in abzurufen AWS CodeBuild.** Im folgenden `list-reports` Beispiel werden die ARNs Berichte für das Girokonto abgerufen. ``` aws codebuild list-reports ``` Ausgabe: ``` { "reports": [ "arn:aws:codebuild:::report/:", "arn:aws:codebuild:::report/:", "arn:aws:codebuild:::report/:" ] } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichten](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report.html). + Einzelheiten zur API finden Sie [ListReports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-reports.html)in der *AWS CLI Befehlsreferenz*. ### `list-shared-projects` Das folgende Codebeispiel zeigt die Verwendung`list-shared-projects`. **AWS CLI** **Um das gemeinsam genutzte Projekt in aufzulisten AWS CodeBuild.** Im folgenden `list-shared-projects` Beispiel werden die CodeBuild gemeinsam genutzten Projekte aufgeführt, die für das aktuelle Konto verfügbar sind. ``` aws codebuild list-shared-projects ``` Ausgabe: ``` { "projects": [ "arn:aws:codebuild:::project/", "arn:aws:codebuild:::project/" ] } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit gemeinsam genutzten Projekten](https://docs.aws.amazon.com/codebuild/latest/userguide/project-sharing.html). + Einzelheiten zur API finden Sie [ListSharedProjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-shared-projects.html)in der *AWS CLI Befehlsreferenz*. ### `list-shared-report-groups` Das folgende Codebeispiel zeigt die Verwendung`list-shared-report-groups`. **AWS CLI** **Um eine Liste der gemeinsam genutzten Berichtsgruppe ARNs abzurufen AWS CodeBuild.** Im folgenden `list-shared-report-groups` Beispiel wird die Berichtsgruppe ARNs für das Konto in der Region abgerufen. ``` aws codebuild list-shared-report-groups ``` Ausgabe: ``` { "reportGroups": [ "arn:aws:codebuild:::report-group/report-group-1", "arn:aws:codebuild:::report-group/report-group-2", "arn:aws:codebuild:::report-group/report-group-3" ] } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichtsgruppen](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report-group.html). + Einzelheiten zur API finden Sie [ListSharedReportGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-shared-report-groups.html)unter *AWS CLI Befehlsreferenz*. ### `list-source-credentials` Das folgende Codebeispiel zeigt die Verwendung`list-source-credentials`. **AWS CLI** **Um eine Liste von anzuzeigen sourceCredentialsObjects** Das folgende `list-source-credentials` Beispiel listet Token für ein AWS Konto auf, das mit einem Bitbucket-Konto und einem GitHub Konto verbunden ist. Jedes `sourceCredentialsInfos`-Objekt in der Antwort enthält Informationen zu den verbundenen Quellanmeldedaten. ``` aws codebuild list-source-credentials ``` Ausgabe: ``` { "sourceCredentialsInfos": [ { "serverType": "BITBUCKET", "arn": "arn:aws:codebuild:us-west-2:123456789012:token/bitbucket", "authType": "BASIC_AUTH" }, { "serverType": "GITHUB", "arn": "arn:aws:codebuild:us-west-2:123456789012:token/github", "authType": "OAUTH" } ] } ``` Weitere Informationen finden Sie unter [Connect Source Providers with Access Tokens (CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-access-tokens.html#sample-access-tokens-cli) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListSourceCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/list-source-credentials.html)unter *AWS CLI Befehlsreferenz*. ### `retry-build-batch` Das folgende Codebeispiel zeigt die Verwendung`retry-build-batch`. **AWS CLI** **Um einen fehlgeschlagenen Batch-Build in AWS CodeBuild zu wiederholen.** Im folgenden Beispiel für `retry-build-batch` wird der angegebene Batch-Build neu gestartet. ``` aws codebuild retry-build-batch \ --id : ``` Ausgabe: ``` { "buildBatch": { "id": ":", "arn": "arn:aws:codebuild:::build-batch/:", "startTime": "2020-10-21T17:26:23.099000+00:00", "currentPhase": "SUBMITTED", "buildBatchStatus": "IN_PROGRESS", "resolvedSourceVersion": "3a9e11cb419e8fff14b03883dc4e64f6155aaa7e", "projectName": "", "phases": [ { "phaseType": "SUBMITTED", "phaseStatus": "SUCCEEDED", "startTime": "2020-10-21T17:26:23.099000+00:00", "endTime": "2020-10-21T17:26:23.457000+00:00", "durationInSeconds": 0 }, { "phaseType": "DOWNLOAD_BATCHSPEC", "phaseStatus": "SUCCEEDED", "startTime": "2020-10-21T17:26:23.457000+00:00", "endTime": "2020-10-21T17:26:54.902000+00:00", "durationInSeconds": 31 }, { "phaseType": "IN_PROGRESS", "phaseStatus": "CLIENT_ERROR", "startTime": "2020-10-21T17:26:54.902000+00:00", "endTime": "2020-10-21T17:28:16.060000+00:00", "durationInSeconds": 81 }, { "phaseType": "FAILED", "phaseStatus": "RETRY", "startTime": "2020-10-21T17:28:16.060000+00:00", "endTime": "2020-10-21T17:29:39.709000+00:00", "durationInSeconds": 83 }, { "phaseType": "SUBMITTED", "startTime": "2020-10-21T17:29:39.709000+00:00" } ], "source": { "type": "GITHUB", "location": "https://github.com/strohm-a/-graph.git", "gitCloneDepth": 1, "gitSubmodulesConfig": { "fetchSubmodules": false }, "reportBuildStatus": false, "insecureSsl": false }, "secondarySources": [], "secondarySourceVersions": [], "artifacts": { "location": "" }, "secondaryArtifacts": [], "cache": { "type": "NO_CACHE" }, "environment": { "type": "LINUX_CONTAINER", "image": "aws/codebuild/amazonlinux2-x86_64-standard:3.0", "computeType": "BUILD_GENERAL1_SMALL", "environmentVariables": [], "privilegedMode": false, "imagePullCredentialsType": "CODEBUILD" }, "logConfig": { "cloudWatchLogs": { "status": "ENABLED" }, "s3Logs": { "status": "DISABLED", "encryptionDisabled": false } }, "buildTimeoutInMinutes": 60, "queuedTimeoutInMinutes": 480, "complete": false, "initiator": "", "encryptionKey": "arn:aws:kms:::alias/aws/s3", "buildBatchNumber": 4, "buildBatchConfig": { "serviceRole": "arn:aws:iam:::role/service-role/", "restrictions": { "maximumBuildsAllowed": 100 }, "timeoutInMins": 480 }, "buildGroups": [ { "identifier": "DOWNLOAD_SOURCE", "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:::build/:", "requestedOn": "2020-10-21T17:26:23.889000+00:00", "buildStatus": "SUCCEEDED", "primaryArtifact": { "type": "no_artifacts", "identifier": "DOWNLOAD_SOURCE" }, "secondaryArtifacts": [] } }, { "identifier": "linux_small", "dependsOn": [], "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:::build/:", "requestedOn": "2020-10-21T17:26:55.115000+00:00", "buildStatus": "FAILED", "primaryArtifact": { "type": "no_artifacts", "identifier": "linux_small" }, "secondaryArtifacts": [] } }, { "identifier": "linux_medium", "dependsOn": [ "linux_small" ], "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:::build/:", "requestedOn": "2020-10-21T17:26:54.594000+00:00", "buildStatus": "STOPPED" } }, { "identifier": "linux_large", "dependsOn": [ "linux_medium" ], "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:::build/:", "requestedOn": "2020-10-21T17:26:54.701000+00:00", "buildStatus": "STOPPED" } } ] } } ``` Weitere Informationen finden Sie [im *AWS CodeBuild Benutzerhandbuch* unter Batch-Builds AWS CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/batch-build.html) in. + Einzelheiten zur API finden Sie [RetryBuildBatch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/retry-build-batch.html)in der *AWS CLI Befehlsreferenz*. ### `retry-build` Das folgende Codebeispiel zeigt die Verwendung`retry-build`. **AWS CLI** **Um ein fehlgeschlagenes Build-In AWS CodeBuild erneut zu versuchen.** Im folgenden Beispiel für `retry-build` wird der angegebene Build neu gestartet. ``` aws codebuild retry-build \ --id : ``` Ausgabe: ``` { "build": { "id": ":", "arn": "arn:aws:codebuild:::build/:", "buildNumber": 9, "startTime": "2020-10-21T17:51:38.161000+00:00", "currentPhase": "QUEUED", "buildStatus": "IN_PROGRESS", "projectName": "", "phases": [ { "phaseType": "SUBMITTED", "phaseStatus": "SUCCEEDED", "startTime": "2020-10-21T17:51:38.161000+00:00", "endTime": "2020-10-21T17:51:38.210000+00:00", "durationInSeconds": 0 }, { "phaseType": "QUEUED", "startTime": "2020-10-21T17:51:38.210000+00:00" } ], "source": { "type": "GITHUB", "location": "", "gitCloneDepth": 1, "gitSubmodulesConfig": { "fetchSubmodules": false }, "reportBuildStatus": false, "insecureSsl": false }, "secondarySources": [], "secondarySourceVersions": [], "artifacts": { "location": "" }, "secondaryArtifacts": [], "cache": { "type": "NO_CACHE" }, "environment": { "type": "LINUX_CONTAINER", "image": "aws/codebuild/amazonlinux2-x86_64-standard:3.0", "computeType": "BUILD_GENERAL1_SMALL", "environmentVariables": [], "privilegedMode": false, "imagePullCredentialsType": "CODEBUILD" }, "serviceRole": "arn:aws:iam:::role/service-role/", "logs": { "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=#logEvent:group=null;stream=null", "cloudWatchLogsArn": "arn:aws:logs:::log-group:null:log-stream:null", "cloudWatchLogs": { "status": "ENABLED" }, "s3Logs": { "status": "DISABLED", "encryptionDisabled": false } }, "timeoutInMinutes": 60, "queuedTimeoutInMinutes": 480, "buildComplete": false, "initiator": "", "encryptionKey": "arn:aws:kms:::alias/aws/s3" } } ``` Weitere Informationen finden Sie [im *AWS CodeBuild Benutzerhandbuch* unter Batch-Builds AWS CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/batch-build.html) in. + Einzelheiten zur API finden Sie [RetryBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/retry-build.html)in der *AWS CLI Befehlsreferenz*. ### `start-build-batch` Das folgende Codebeispiel zeigt die Verwendung`start-build-batch`. **AWS CLI** **Um einen Batch-Build in zu starten AWS CodeBuild.** Im folgenden Beispiel für `start-build-batch` wird ein Batch-Build des angegebenen Projekts gestartet. ``` aws codebuild start-build-batch \ --project-name ``` Ausgabe: ``` { "buildBatch": { "id": ":", "arn": "arn:aws:codebuild:::build-batch/:", "startTime": "2020-10-21T16:54:24.740000+00:00", "currentPhase": "SUBMITTED", "buildBatchStatus": "IN_PROGRESS", "projectName": "", "source": { "type": "GITHUB", "location": "", "gitCloneDepth": 1, "gitSubmodulesConfig": { "fetchSubmodules": false }, "reportBuildStatus": false, "insecureSsl": false }, "secondarySources": [], "secondarySourceVersions": [], "artifacts": { "location": "" }, "secondaryArtifacts": [], "cache": { "type": "NO_CACHE" }, "environment": { "type": "LINUX_CONTAINER", "image": "aws/codebuild/amazonlinux2-x86_64-standard:3.0", "computeType": "BUILD_GENERAL1_SMALL", "environmentVariables": [], "privilegedMode": false, "imagePullCredentialsType": "CODEBUILD" }, "logConfig": { "cloudWatchLogs": { "status": "ENABLED" }, "s3Logs": { "status": "DISABLED", "encryptionDisabled": false } }, "buildTimeoutInMinutes": 60, "queuedTimeoutInMinutes": 480, "complete": false, "initiator": "", "encryptionKey": "arn:aws:kms:::alias/aws/s3", "buildBatchNumber": 3, "buildBatchConfig": { "serviceRole": "arn:aws:iam:::role/service-role/", "restrictions": { "maximumBuildsAllowed": 100 }, "timeoutInMins": 480 } } } ``` Weitere Informationen finden Sie [im *AWS CodeBuild Benutzerhandbuch* unter Batch-Builds AWS CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/batch-build.html) in. + Einzelheiten zur API finden Sie [StartBuildBatch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/start-build-batch.html)in der *AWS CLI Befehlsreferenz*. ### `start-build` Das folgende Codebeispiel zeigt die Verwendung`start-build`. **AWS CLI** **Um mit der Ausführung eines AWS CodeBuild Build-Projekts zu beginnen.** Im folgenden `start-build` Beispiel wird ein Build für das angegebene CodeBuild Projekt gestartet. Der Build überschreibt sowohl die Einstellung des Projekts für die Anzahl der Minuten, die der Build in die Warteschlange gestellt werden darf, bis eine Zeitüberschreitung auftritt, als auch die Artefakteinstellungen des Projekts. ``` aws codebuild start-build \ --project-name "my-demo-project" \ --queued-timeout-in-minutes-override 5 \ --artifacts-override {"\"type\": \"S3\",\"location\": \"arn:aws:s3:::artifacts-override\",\"overrideArtifactName\":true"} ``` Ausgabe: ``` { "build": { "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", "buildStatus": "IN_PROGRESS", "buildComplete": false, "projectName": "my-demo-project", "timeoutInMinutes": 60, "source": { "insecureSsl": false, "type": "S3", "location": "codebuild-us-west-2-123456789012-input-bucket/my-source.zip" }, "queuedTimeoutInMinutes": 5, "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", "currentPhase": "QUEUED", "startTime": 1556905683.568, "environment": { "computeType": "BUILD_GENERAL1_MEDIUM", "environmentVariables": [], "type": "LINUX_CONTAINER", "privilegedMode": false, "image": "aws/codebuild/standard:1.0", "imagePullCredentialsType": "CODEBUILD" }, "phases": [ { "phaseStatus": "SUCCEEDED", "startTime": 1556905683.568, "phaseType": "SUBMITTED", "durationInSeconds": 0, "endTime": 1556905684.524 }, { "startTime": 1556905684.524, "phaseType": "QUEUED" } ], "logs": { "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logEvent:group=null;stream=null" }, "artifacts": { "encryptionDisabled": false, "location": "arn:aws:s3:::artifacts-override/my-demo-project", "overrideArtifactName": true }, "cache": { "type": "NO_CACHE" }, "id": "my-demo-project::12345678-a1b2-c3d4-e5f6-11111EXAMPLE", "initiator": "my-aws-account-name", "arn": "arn:aws:codebuild:us-west-2:123456789012:build/my-demo-project::12345678-a1b2-c3d4-e5f6-11111EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Run a Build (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/run-build.html#run-build-cli) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/start-build.html)unter *AWS CLI Befehlsreferenz*. ### `stop-build-batch` Das folgende Codebeispiel zeigt die Verwendung`stop-build-batch`. **AWS CLI** **Um einen laufenden Batch-Build in AWS CodeBuild Bearbeitung zu beenden.** Im folgenden Beispiel für `stop-build-batch` wird der angegebene Batch-Build beendet. ``` aws codebuild stop-build-batch \ --id : ``` Ausgabe: ``` { "buildBatch": { "id": ":", "arn": "arn:aws:codebuild:::build-batch/:", "startTime": "2020-10-21T16:54:24.740000+00:00", "endTime": "2020-10-21T16:56:05.152000+00:00", "currentPhase": "STOPPED", "buildBatchStatus": "STOPPED", "resolvedSourceVersion": "aef7744ed069c51098e15c360f4102cd2cd1ad64", "projectName": "", "phases": [ { "phaseType": "SUBMITTED", "phaseStatus": "SUCCEEDED", "startTime": "2020-10-21T16:54:24.740000+00:00", "endTime": "2020-10-21T16:54:25.039000+00:00", "durationInSeconds": 0 }, { "phaseType": "DOWNLOAD_BATCHSPEC", "phaseStatus": "SUCCEEDED", "startTime": "2020-10-21T16:54:25.039000+00:00", "endTime": "2020-10-21T16:54:56.583000+00:00", "durationInSeconds": 31 }, { "phaseType": "IN_PROGRESS", "phaseStatus": "STOPPED", "startTime": "2020-10-21T16:54:56.583000+00:00", "endTime": "2020-10-21T16:56:05.152000+00:00", "durationInSeconds": 68 }, { "phaseType": "STOPPED", "startTime": "2020-10-21T16:56:05.152000+00:00" } ], "source": { "type": "GITHUB", "location": "", "gitCloneDepth": 1, "gitSubmodulesConfig": { "fetchSubmodules": false }, "reportBuildStatus": false, "insecureSsl": false }, "secondarySources": [], "secondarySourceVersions": [], "artifacts": { "location": "" }, "secondaryArtifacts": [], "cache": { "type": "NO_CACHE" }, "environment": { "type": "LINUX_CONTAINER", "image": "aws/codebuild/amazonlinux2-x86_64-standard:3.0", "computeType": "BUILD_GENERAL1_SMALL", "environmentVariables": [], "privilegedMode": false, "imagePullCredentialsType": "CODEBUILD" }, "logConfig": { "cloudWatchLogs": { "status": "ENABLED" }, "s3Logs": { "status": "DISABLED", "encryptionDisabled": false } }, "buildTimeoutInMinutes": 60, "queuedTimeoutInMinutes": 480, "complete": true, "initiator": "Strohm", "encryptionKey": "arn:aws:kms:::alias/aws/s3", "buildBatchNumber": 3, "buildBatchConfig": { "serviceRole": "arn:aws:iam:::role/service-role/", "restrictions": { "maximumBuildsAllowed": 100 }, "timeoutInMins": 480 }, "buildGroups": [ { "identifier": "DOWNLOAD_SOURCE", "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:::build/:", "requestedOn": "2020-10-21T16:54:25.468000+00:00", "buildStatus": "SUCCEEDED", "primaryArtifact": { "type": "no_artifacts", "identifier": "DOWNLOAD_SOURCE" }, "secondaryArtifacts": [] } }, { "identifier": "linux_small", "dependsOn": [], "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:::build/:", "requestedOn": "2020-10-21T16:54:56.833000+00:00", "buildStatus": "IN_PROGRESS" } }, { "identifier": "linux_medium", "dependsOn": [ "linux_small" ], "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:::build/:", "requestedOn": "2020-10-21T16:54:56.211000+00:00", "buildStatus": "PENDING" } }, { "identifier": "linux_large", "dependsOn": [ "linux_medium" ], "ignoreFailure": false, "currentBuildSummary": { "arn": "arn:aws:codebuild:::build/:", "requestedOn": "2020-10-21T16:54:56.330000+00:00", "buildStatus": "PENDING" } } ] } } ``` Weitere Informationen finden Sie [im *AWS CodeBuild Benutzerhandbuch* unter Batch-Builds AWS CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/batch-build.html) in. + Einzelheiten zur API finden Sie [StopBuildBatch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/stop-build-batch.html)in der *AWS CLI Befehlsreferenz*. ### `stop-build` Das folgende Codebeispiel zeigt die Verwendung`stop-build`. **AWS CLI** **Um einen Build eines AWS CodeBuild Build-Projekts zu beenden.** Das folgende `stop-build` Beispiel stoppt den angegebenen CodeBuild Build. ``` aws codebuild stop-build --id my-demo-project:12345678-a1b2-c3d4-e5f6-11111EXAMPLE ``` Ausgabe: ``` { "build": { "startTime": 1556906956.318, "initiator": "my-aws-account-name", "projectName": "my-demo-project", "currentPhase": "COMPLETED", "cache": { "type": "NO_CACHE" }, "source": { "insecureSsl": false, "location": "codebuild-us-west-2-123456789012-input-bucket/my-source.zip", "type": "S3" }, "id": "my-demo-project:1a2b3c4d-5678-90ab-cdef-11111EXAMPLE", "endTime": 1556906974.781, "phases": [ { "durationInSeconds": 0, "phaseType": "SUBMITTED", "endTime": 1556906956.935, "phaseStatus": "SUCCEEDED", "startTime": 1556906956.318 }, { "durationInSeconds": 1, "phaseType": "QUEUED", "endTime": 1556906958.272, "phaseStatus": "SUCCEEDED", "startTime": 1556906956.935 }, { "phaseType": "PROVISIONING", "phaseStatus": "SUCCEEDED", "durationInSeconds": 14, "contexts": [ { "message": "", "statusCode": "" } ], "endTime": 1556906972.847, "startTime": 1556906958.272 }, { "phaseType": "DOWNLOAD_SOURCE", "phaseStatus": "SUCCEEDED", "durationInSeconds": 0, "contexts": [ { "message": "", "statusCode": "" } ], "endTime": 1556906973.552, "startTime": 1556906972.847 }, { "phaseType": "INSTALL", "phaseStatus": "SUCCEEDED", "durationInSeconds": 0, "contexts": [ { "message": "", "statusCode": "" } ], "endTime": 1556906973.75, "startTime": 1556906973.552 }, { "phaseType": "PRE_BUILD", "phaseStatus": "SUCCEEDED", "durationInSeconds": 0, "contexts": [ { "message": "", "statusCode": "" } ], "endTime": 1556906973.937, "startTime": 1556906973.75 }, { "durationInSeconds": 0, "phaseType": "BUILD", "endTime": 1556906974.781, "phaseStatus": "STOPPED", "startTime": 1556906973.937 }, { "phaseType": "COMPLETED", "startTime": 1556906974.781 } ], "artifacts": { "location": "arn:aws:s3:::artifacts-override/my-demo-project", "encryptionDisabled": false, "overrideArtifactName": true }, "buildComplete": true, "buildStatus": "STOPPED", "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", "queuedTimeoutInMinutes": 5, "timeoutInMinutes": 60, "environment": { "type": "LINUX_CONTAINER", "environmentVariables": [], "computeType": "BUILD_GENERAL1_MEDIUM", "privilegedMode": false, "image": "aws/codebuild/standard:1.0", "imagePullCredentialsType": "CODEBUILD" }, "logs": { "streamName": "1a2b3c4d-5678-90ab-cdef-11111EXAMPLE", "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logEvent:group=/aws/codebuild/my-demo-project;stream=1a2b3c4d-5678-90ab-cdef-11111EXAMPLE", "groupName": "/aws/codebuild/my-demo-project" }, "arn": "arn:aws:codebuild:us-west-2:123456789012:build/my-demo-project:1a2b3c4d-5678-90ab-cdef-11111EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Stop a Build (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/stop-build.html#stop-build-cli) im *AWS CodeBuild Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/stop-build.html)in der *AWS CLI Befehlsreferenz*. ### `update-project` Das folgende Codebeispiel zeigt die Verwendung`update-project`. **AWS CLI** **Um die Einstellungen eines AWS CodeBuild Build-Projekts zu ändern.** Im folgenden `update-project` Beispiel werden die Einstellungen des angegebenen CodeBuild Build-Projekts mit dem Namen geändert my-demo-project. ``` aws codebuild update-project --name "my-demo-project" \ --description "This project is updated" \ --source "{\"type\": \"S3\",\"location\": \"codebuild-us-west-2-123456789012-input-bucket/my-source-2.zip\"}" \ --artifacts {"\"type\": \"S3\",\"location\": \"codebuild-us-west-2-123456789012-output-bucket-2\""} \ --environment "{\"type\": \"LINUX_CONTAINER\",\"image\": \"aws/codebuild/standard:1.0\",\"computeType\": \"BUILD_GENERAL1_MEDIUM\"}" \ --service-role "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role" ``` Die Ausgabe zeigt die aktualisierten Einstellungen an. ``` { "project": { "arn": "arn:aws:codebuild:us-west-2:123456789012:project/my-demo-project", "environment": { "privilegedMode": false, "environmentVariables": [], "type": "LINUX_CONTAINER", "image": "aws/codebuild/standard:1.0", "computeType": "BUILD_GENERAL1_MEDIUM", "imagePullCredentialsType": "CODEBUILD" }, "queuedTimeoutInMinutes": 480, "description": "This project is updated", "artifacts": { "packaging": "NONE", "name": "my-demo-project", "type": "S3", "namespaceType": "NONE", "encryptionDisabled": false, "location": "codebuild-us-west-2-123456789012-output-bucket-2" }, "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", "badge": { "badgeEnabled": false }, "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", "lastModified": 1556840545.967, "tags": [], "timeoutInMinutes": 60, "created": 1556839783.274, "name": "my-demo-project", "cache": { "type": "NO_CACHE" }, "source": { "type": "S3", "insecureSsl": false, "location": "codebuild-us-west-2-123456789012-input-bucket/my-source-2.zip" } } } ``` Weitere Informationen finden Sie unter [Ändern der Einstellungen eines Build-Projekts (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/change-project.html#change-project-cli) im *AWS CodeBuild Benutzerhandbuch* + Einzelheiten zur API finden Sie [UpdateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/update-project.html)unter *AWS CLI Befehlsreferenz*. ### `update-report-group` Das folgende Codebeispiel zeigt die Verwendung`update-report-group`. **AWS CLI** **Um eine Berichtsgruppe in zu aktualisieren AWS CodeBuild.** Im folgenden Beispiel für `update-report-group` wird der Exporttyp der Berichtsgruppe in „NO\$1EXPORT“ geändert. ``` aws codebuild update-report-group \ --arn arn:aws:codebuild:::report-group/cli-created-report-group \ --export-config="exportConfigType=NO_EXPORT" ``` Ausgabe: ``` { "reportGroup": { "arn": "arn:aws:codebuild:::report-group/cli-created-report-group", "name": "cli-created-report-group", "type": "TEST", "exportConfig": { "exportConfigType": "NO_EXPORT" }, "created": 1602020686.009, "lastModified": 1602021033.454, "tags": [] } } ``` Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Arbeiten mit Berichtsgruppen](https://docs.aws.amazon.com/codebuild/latest/userguide/test-report-group.html). + Einzelheiten zur API finden Sie [UpdateReportGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/update-report-group.html)unter *AWS CLI Befehlsreferenz*. ### `update-webhook` Das folgende Codebeispiel zeigt die Verwendung`update-webhook`. **AWS CLI** **Um den Webhook für ein AWS CodeBuild Projekt zu aktualisieren** Im folgenden `update-webhook` Beispiel wird ein Webhook für das angegebene CodeBuild Projekt mit zwei Filtergruppen aktualisiert. Der `--rotate-secret` Parameter gibt an, dass der geheime Schlüssel des Projekts jedes Mal GitHub rotiert wird, wenn eine Codeänderung einen Build auslöst. Die erste Filtergruppe gibt Pull-Anfragen an, die in Verzweigungen mit Git-Referenznamen, die dem regulären Ausdruck `^refs/heads/master$` entsprechen, und mit Kopfreferenzen, die `^refs/heads/myBranch$` entsprechen, erstellt, aktualisiert oder erneut geöffnet werden. Die zweite Filtergruppe gibt Push-Anforderungen in Branches mit Git-Referenznamen an, die dem regulären Ausdruck `^refs/heads/myBranch$` nicht entsprechen. ``` aws codebuild update-webhook \ --project-name Project2 \ --rotate-secret \ --filter-groups "[[{\"type\":\"EVENT\",\"pattern\":\"PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED\"},{\"type\":\"HEAD_REF\",\"pattern\":\"^refs/heads/myBranch$\",\"excludeMatchedPattern\":true},{\"type\":\"BASE_REF\",\"pattern\":\"^refs/heads/master$\",\"excludeMatchedPattern\":true}],[{\"type\":\"EVENT\",\"pattern\":\"PUSH\"},{\"type\":\"HEAD_REF\",\"pattern\":\"^refs/heads/myBranch$\",\"excludeMatchedPattern\":true}]]" ``` Ausgabe: ``` { "webhook": { "filterGroups": [ [ { "pattern": "PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED", "type": "EVENT" }, { "excludeMatchedPattern": true, "pattern": "refs/heads/myBranch$", "type": "HEAD_REF" }, { "excludeMatchedPattern": true, "pattern": "refs/heads/master$", "type": "BASE_REF" } ], [ { "pattern": "PUSH", "type": "EVENT" }, { "excludeMatchedPattern": true, "pattern": "refs/heads/myBranch$", "type": "HEAD_REF" } ] ], "lastModifiedSecret": 1556312220.133 } } ``` Weitere Informationen finden Sie unter [Ändern der Einstellungen eines Build-Projekts (AWS CLI)](https://docs.aws.amazon.com/codebuild/latest/userguide/change-project.html#change-project-cli) im *AWS CodeBuild Benutzerhandbuch* + Einzelheiten zur API finden Sie [UpdateWebhook](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codebuild/update-webhook.html)unter *AWS CLI Befehlsreferenz*. # CodeCommit Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CodeCommit. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-approval-rule-template-with-repository` Das folgende Codebeispiel zeigt, wie Sie`associate-approval-rule-template-with-repository`. **AWS CLI** **So ordnen Sie eine Genehmigungsregelvorlage einem Repository zu** Im folgenden Beispiel für `associate-approval-rule-template-with-repository` wird die angegebene Genehmigungsregelvorlage einem Repository mit dem Namen `MyDemoRepo` zugeordnet. ``` aws codecommit associate-approval-rule-template-with-repository \ --repository-name MyDemoRepo \ --approval-rule-template-name 2-approver-rule-for-main ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Zuordnen einer Genehmigungsregelvorlage zu einem Repository](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-associate-template.html#associate-template-repository). + Einzelheiten zur API finden Sie [AssociateApprovalRuleTemplateWithRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/associate-approval-rule-template-with-repository.html)unter *AWS CLI Befehlsreferenz*. ### `batch-associate-approval-rule-template-with-repositories` Das folgende Codebeispiel zeigt die Verwendung`batch-associate-approval-rule-template-with-repositories`. **AWS CLI** **So ordnen Sie eine Genehmigungsregelvorlage mehreren Repositorys in einem einzigen Vorgang zu** Im folgenden Beispiel für `batch-associate-approval-rule-template-with-repositories` wird die angegebene Genehmigungsregelvorlage Repositorys mit den Namen `MyDemoRepo` und `MyOtherDemoRepo` zugeordnet. Hinweis: Vorlagen für Genehmigungsregeln sind spezifisch für die AWS Region, in der sie erstellt wurden. Sie können nur Repositorys in dieser AWS Region zugeordnet werden. ``` aws codecommit batch-associate-approval-rule-template-with-repositories \ --repository-names MyDemoRepo, MyOtherDemoRepo \ --approval-rule-template-name 2-approver-rule-for-main ``` Ausgabe: ``` { "associatedRepositoryNames": [ "MyDemoRepo", "MyOtherDemoRepo" ], "errors": [] } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Zuordnen einer Genehmigungsregelvorlage zu einem Repository](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-associate-template.html#batch-associate-template-repositories). + Einzelheiten zur API finden Sie [BatchAssociateApprovalRuleTemplateWithRepositories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/batch-associate-approval-rule-template-with-repositories.html)unter *AWS CLI Befehlsreferenz*. ### `batch-describe-merge-conflicts` Das folgende Codebeispiel zeigt die Verwendung`batch-describe-merge-conflicts`. **AWS CLI** **So rufen Sie Informationen zu Zusammenführungskonflikten in allen Dateien und einem Teilsatz von Dateien in einer Zusammenführung zwischen zwei Commit-Spezifizierern ab** Im folgenden Beispiel für `batch-describe-merge-conflicts` werden die Zusammenführungskonflikte beim Zusammenführen des Quell-Branches `feature-randomizationfeature` mit dem Ziel-Branch `main` mithilfe der `THREE_WAY_MERGE`-Strategie in einem Repository mit dem Namen `MyDemoRepo` ermittelt. ``` aws codecommit batch-describe-merge-conflicts \ --source-commit-specifier feature-randomizationfeature \ --destination-commit-specifier main \ --merge-option THREE_WAY_MERGE \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "conflicts": [ { "conflictMetadata": { "filePath": "readme.md", "fileSizes": { "source": 139, "destination": 230, "base": 85 }, "fileModes": { "source": "NORMAL", "destination": "NORMAL", "base": "NORMAL" }, "objectTypes": { "source": "FILE", "destination": "FILE", "base": "FILE" }, "numberOfConflicts": 1, "isBinaryFile": { "source": false, "destination": false, "base": false }, "contentConflict": true, "fileModeConflict": false, "objectTypeConflict": false, "mergeOperations": { "source": "M", "destination": "M" } }, "mergeHunks": [ { "isConflict": true, "source": { "startLine": 0, "endLine": 3, "hunkContent": "VGhpcyBpEXAMPLE==" }, "destination": { "startLine": 0, "endLine": 1, "hunkContent": "VXNlIHRoEXAMPLE=" } } ] } ], "errors": [], "destinationCommitId": "86958e0aEXAMPLE", "sourceCommitId": "6ccd57fdEXAMPLE", "baseCommitId": "767b6958EXAMPLE" } ``` Weitere Informationen finden Sie unter [Konflikte in einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-resolve-conflict-pull-request.html#batch-describe-merge-conflicts) lösen im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [BatchDescribeMergeConflicts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/batch-describe-merge-conflicts.html)in der *AWS CLI Befehlsreferenz*. ### `batch-disassociate-approval-rule-template-from-repositories` Das folgende Codebeispiel zeigt die Verwendung`batch-disassociate-approval-rule-template-from-repositories`. **AWS CLI** **So heben Sie die Zuordnung einer Genehmigungsregelvorlage für Repositorys in einem einzigen Vorgang auf** Im folgenden Beispiel für `batch-disassociate-approval-rule-template-from-repositories` wird die Zuordnung der angegebenen Genehmigungsregelvorlage für die Repositorys mit den Namen `MyDemoRepo` und `MyOtherDemoRepo` aufgehoben. ``` aws codecommit batch-disassociate-approval-rule-template-from-repositories \ --repository-names MyDemoRepo, MyOtherDemoRepo \ --approval-rule-template-name 1-approval-rule-for-all pull requests ``` Ausgabe: ``` { "disassociatedRepositoryNames": [ "MyDemoRepo", "MyOtherDemoRepo" ], "errors": [] } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* [unter Aufheben der Zuordnung einer Vorlage für Genehmigungsregeln](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-disassociate-template.html#batch-disassociate-template). + Einzelheiten zur API finden Sie unter [BatchDisassociateApprovalRuleTemplateFromRepositories AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/batch-disassociate-approval-rule-template-from-repositories.html)*Befehlsreferenz.* ### `batch-get-commits` Das folgende Codebeispiel zeigt die Verwendung`batch-get-commits`. **AWS CLI** **Um Informationen über mehrere Commits anzuzeigen** Im folgenden Beispiel für `batch-get-commits` werden die Details zu den angegebenen Commits angezeigt. ``` aws codecommit batch-get-commits \ --repository-name MyDemoRepo \ --commit-ids 317f8570EXAMPLE 4c925148EXAMPLE ``` Ausgabe: ``` { "commits": [ { "additionalData": "", "committer": { "date": "1508280564 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "author": { "date": "1508280564 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "commitId": "317f8570EXAMPLE", "treeId": "1f330709EXAMPLE", "parents": [ "6e147360EXAMPLE" ], "message": "Change variable name and add new response element" }, { "additionalData": "", "committer": { "date": "1508280542 -0800", "name": "Li Juan", "email": "li_juan@example.com" }, "author": { "date": "1508280542 -0800", "name": "Li Juan", "email": "li_juan@example.com" }, "commitId": "4c925148EXAMPLE", "treeId": "1f330709EXAMPLE", "parents": [ "317f8570EXAMPLE" ], "message": "Added new class" } } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Commit-Details anzeigen](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-view-commit-details.html#how-to-view-commit-details-cli-batch-get-commits). + Einzelheiten zur API finden Sie [BatchGetCommits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/batch-get-commits.html)in der *AWS CLI Befehlsreferenz*. ### `batch-get-repositories` Das folgende Codebeispiel zeigt die Verwendung`batch-get-repositories`. **AWS CLI** **So zeigen Sie Details zu mehreren Repositorys an** Dieses Beispiel zeigt Details zu mehreren AWS CodeCommit Repositorys. ``` aws codecommit batch-get-repositories \ --repository-names MyDemoRepo MyOtherDemoRepo ``` Ausgabe: ``` { "repositoriesNotFound": [], "repositories": [ { "creationDate": 1429203623.625, "defaultBranch": "main", "repositoryName": "MyDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "lastModifiedDate": 1430783812.0869999, "repositoryDescription": "My demonstration repository", "cloneUrlHttp": "https://codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "Arn": "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo" "accountId": "111111111111" }, { "creationDate": 1429203623.627, "defaultBranch": "main", "repositoryName": "MyOtherDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyOtherDemoRepo", "lastModifiedDate": 1430783812.0889999, "repositoryDescription": "My other demonstration repository", "cloneUrlHttp": "https://codecommit.us-east-2.amazonaws.com/v1/repos/MyOtherDemoRepo", "repositoryId": "cfc29ac4-b0cb-44dc-9990-f6f51EXAMPLE", "Arn": "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo" "accountId": "111111111111" } ], "repositoriesNotFound": [] } ``` + Einzelheiten zur API finden Sie [BatchGetRepositories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/batch-get-repositories.html)in der *AWS CLI Befehlsreferenz.* ### `create-approval-rule-template` Das folgende Codebeispiel zeigt die Verwendung`create-approval-rule-template`. **AWS CLI** **Um eine Vorlage für Genehmigungsregeln zu erstellen** Im folgenden Beispiel für `create-approval-rule-template` wird eine Genehmigungsregelvorlage mit dem Namen `2-approver-rule-for-main ``. The template requires two users who assume the role of ``CodeCommitReview` erstellt, um alle Pull-Anforderungen vor der Zusammenführung mit dem `main`-Branch zu genehmigen. ``` aws codecommit create-approval-rule-template \ --approval-rule-template-name 2-approver-rule-for-main \ --approval-rule-template-description "Requires two developers from the team to approve the pull request if the destination branch is main" \ --approval-rule-template-content "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}" ``` Ausgabe: ``` { "approvalRuleTemplate": { "approvalRuleTemplateName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "approvalRuleTemplateId": "dd8b17fe-EXAMPLE", "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "approvalRuleTemplateDescription": "Requires two developers from the team to approve the pull request if the destination branch is main", "lastModifiedDate": 1571356106.936, "ruleContentSha256": "4711b576EXAMPLE" } } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Erstellen einer Vorlage für Genehmigungsregeln](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-template.html#create-template-cli). + Einzelheiten zur API finden Sie [CreateApprovalRuleTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/create-approval-rule-template.html)unter *AWS CLI Befehlsreferenz*. ### `create-branch` Das folgende Codebeispiel zeigt die Verwendung`create-branch`. **AWS CLI** **So erstellen Sie einen Branch** In diesem Beispiel wird ein Branch in einem AWS CodeCommit Repository erstellt. Dieser Befehl liefert nur eine Ausgabe, wenn Fehler aufgetreten sind. Befehl: ``` aws codecommit create-branch --repository-name MyDemoRepo --branch-name MyNewBranch --commit-id 317f8570EXAMPLE ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [CreateBranch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/create-branch.html)in der *AWS CLI Befehlsreferenz*. ### `create-commit` Das folgende Codebeispiel zeigt die Verwendung`create-commit`. **AWS CLI** **Um einen Commit zu erstellen** Im folgenden Beispiel für `create-commit` wird gezeigt, wie Sie einen anfänglichen Commit für ein Repository erstellen, durch den eine `readme.md`-Datei zu einem Repository mit dem Namen `MyDemoRepo` im Branch `main` hinzugefügt wird. ``` aws codecommit create-commit \ --repository-name MyDemoRepo \ --branch-name main \ --put-files "filePath=readme.md,fileContent='Welcome to our team repository.'" ``` Ausgabe: ``` { "filesAdded": [ { "blobId": "5e1c309d-EXAMPLE", "absolutePath": "readme.md", "fileMode": "NORMAL" } ], "commitId": "4df8b524-EXAMPLE", "treeId": "55b57003-EXAMPLE", "filesDeleted": [], "filesUpdated": [] } ``` Weitere Informationen finden Sie unter [Create a Commit AWS CodeCommit im AWS](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-commit.html#how-to-create-commit-cli) *CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateCommit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/create-commit.html)in der *AWS CLI Befehlsreferenz*. ### `create-pull-request-approval-rule` Das folgende Codebeispiel zeigt die Verwendung`create-pull-request-approval-rule`. **AWS CLI** **So erstellen Sie eine Genehmigungsregel für eine Pull-Anforderung** Im folgenden Beispiel für `create-pull-request-approval-rule` wird eine Genehmigungsregel namens `Require two approved approvers` für die angegebene Pull-Anforderung erstellt. Die Regel gibt an, dass zwei Genehmigungen aus einem Genehmigungs-Pool erforderlich sind. Der Pool umfasst alle Benutzer, die darauf zugreifen, CodeCommit indem sie die Rolle von `CodeCommitReview` im `123456789012` AWS Konto übernehmen. Er umfasst auch entweder einen IAM-Benutzer oder einen Verbundbenutzer, der `Nikhil_Jayashankar` aus demselben AWS Konto stammt. ``` aws codecommit create-pull-request-approval-rule \ --approval-rule-name "Require two approved approvers" \ --approval-rule-content "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"CodeCommitApprovers:123456789012:Nikhil_Jayashankar\", \"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}" ``` Ausgabe: ``` { "approvalRule": { "approvalRuleName": "Require two approved approvers", "lastModifiedDate": 1570752871.932, "ruleContentSha256": "7c44e6ebEXAMPLE", "creationDate": 1570752871.932, "approvalRuleId": "aac33506-EXAMPLE", "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"CodeCommitApprovers:123456789012:Nikhil_Jayashankar\", \"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major" } } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Erstellen einer Genehmigungsregel](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-pull-request-approval-rule.html#how-to-create-pull-request-approval-rule-cli). + Einzelheiten zur API finden Sie [CreatePullRequestApprovalRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/create-pull-request-approval-rule.html)unter *AWS CLI Befehlsreferenz*. ### `create-pull-request` Das folgende Codebeispiel zeigt die Verwendung`create-pull-request`. **AWS CLI** **So erstellen Sie eine Pull-Anforderung** Im folgenden `create-pull-request` Beispiel wird eine Pull-Anfrage mit dem Namen „Pronunciation Difficulty Analyzer“ mit der Beschreibung „Bitte überprüfen Sie diese Änderungen bis Dienstag“ erstellt, die auf den Quell-Branch „jane-branch“ abzielt und mit dem Standardbranch „main“ in einem Repository namens 'zusammengeführt werden soll. AWS CodeCommit MyDemoRepo ``` aws codecommit create-pull-request \ --title "My Pull Request" \ --description "Please review these changes by Tuesday" \ --client-request-token 123Example \ --targets repositoryName=MyDemoRepo,sourceReference=MyNewBranch ``` Ausgabe: ``` { "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "originApprovalRuleTemplate": { "approvalRuleTemplateId": "dd3d22fe-EXAMPLE", "approvalRuleTemplateName": "2-approver-rule-for-main" }, "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::111111111111:user/Jane_Doe", "description": "Please review these changes by Tuesday", "title": "Pronunciation difficulty analyzer", "pullRequestTargets": [ { "destinationCommit": "5d036259EXAMPLE", "destinationReference": "refs/heads/main", "repositoryName": "MyDemoRepo", "sourceCommit": "317f8570EXAMPLE", "sourceReference": "refs/heads/jane-branch", "mergeMetadata": { "isMerged": false } } ], "lastActivityDate": 1508962823.285, "pullRequestId": "42", "clientRequestToken": "123Example", "pullRequestStatus": "OPEN", "creationDate": 1508962823.285 } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [CreatePullRequest](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/create-pull-request.html)AWS CLI * ### `create-repository` Das folgende Codebeispiel zeigt die Verwendung`create-repository`. **AWS CLI** **So erstellen Sie ein Repository** In diesem Beispiel wird ein Repository erstellt und es dem AWS Konto des Benutzers zugeordnet. Befehl: ``` aws codecommit create-repository --repository-name MyDemoRepo --repository-description "My demonstration repository" ``` Ausgabe: ``` { "repositoryMetadata": { "repositoryName": "MyDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo", "lastModifiedDate": 1444766838.027, "repositoryDescription": "My demonstration repository", "cloneUrlHttp": "https://git-codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo", "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "Arn": "arn:aws:codecommit:us-east-1:111111111111EXAMPLE:MyDemoRepo", "accountId": "111111111111" } } ``` + Einzelheiten zur API finden Sie [CreateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/create-repository.html)in der *AWS CLI Befehlsreferenz*. ### `create-unreferenced-merge-commit` Das folgende Codebeispiel zeigt die Verwendung`create-unreferenced-merge-commit`. **AWS CLI** **So erstellen Sie einen unreferenzierten Commit, der das Ergebnis des Zusammenführens von zwei Commit-Spezifizierern repräsentiert** Im folgenden Beispiel für `create-unreferenced-merge-commit` wird ein Commit erstellt, der die Ergebnisse einer Zusammenführung zwischen dem Quell-Branch `bugfix-1234` und dem Ziel-Branch `main` mithilfe der THREE\$1WAY\$1MERGE-Strategie im Repository `MyDemoRepo` darstellt. ``` aws codecommit create-unreferenced-merge-commit \ --source-commit-specifier bugfix-1234 \ --destination-commit-specifier main \ --merge-option THREE_WAY_MERGE \ --repository-name MyDemoRepo \ --name "Maria Garcia" \ --email "maria_garcia@example.com" \ --commit-message "Testing the results of this merge." ``` Ausgabe: ``` { "commitId": "4f178133EXAMPLE", "treeId": "389765daEXAMPLE" } ``` Weitere Informationen finden Sie unter [Konflikte in einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-resolve-conflict-pull-request.html#batch-describe-merge-conflicts) lösen im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateUnreferencedMergeCommit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/create-unreferenced-merge-commit.html)in der *AWS CLI Befehlsreferenz*. ### `credential-helper` Das folgende Codebeispiel zeigt die Verwendung`credential-helper`. **AWS CLI** **Um den in der AWS CLI enthaltenen Credential Helper einzurichten mit AWS CodeCommit** Das `credential-helper` Hilfsprogramm ist nicht dafür konzipiert, direkt von der AWS CLI aus aufgerufen zu werden. Stattdessen soll es als Parameter mit dem `git config`-Befehl zum Einrichten Ihres lokalen Computers verwendet werden. Es ermöglicht Git, HTTPS und eine kryptografisch signierte Version Ihrer IAM-Benutzeranmeldedaten oder Ihrer Amazon EC2 EC2-Instance-Rolle zu verwenden, wann immer Git sich authentifizieren muss, um mit AWS Repositorys zu interagieren. CodeCommit ``` git config --global credential.helper '!aws codecommit credential-helper $@' git config --global credential.UseHttpPath true ``` Ausgabe: ``` [credential] helper = !aws codecommit credential-helper $@ UseHttpPath = true ``` *Weitere Informationen finden Sie im Benutzerhandbuch unter Einrichtung für die AWS CodeCommit Verwendung anderer Methoden.AWS CodeCommit * Lesen Sie den Inhalt sorgfältig durch und folgen Sie dann den Anweisungen in einem der folgenden Themen: Für HTTPS-Verbindungen unter Linux, macOS oder Unix oder Für HTTPS-Verbindungen unter Windows im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CredentialHelper](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/credential-helper.html)in der *AWS CLI Befehlsreferenz*. ### `delete-approval-rule-template` Das folgende Codebeispiel zeigt die Verwendung`delete-approval-rule-template`. **AWS CLI** **Um eine Vorlage für Genehmigungsregeln zu löschen** Im folgenden Beispiel für `delete-approval-rule-template` wird die angegebene Genehmigungsregelvorlage gelöscht. ``` aws codecommit delete-approval-rule-template \ --approval-rule-template-name 1-approver-for-all-pull-requests ``` Ausgabe: ``` { "approvalRuleTemplateId": "41de97b7-EXAMPLE" } ``` Weitere Informationen finden Sie unter [Löschen einer Vorlage für Genehmigungsregeln](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-template.html#delete-template) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteApprovalRuleTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/delete-approval-rule-template.html)unter *AWS CLI Befehlsreferenz*. ### `delete-branch` Das folgende Codebeispiel zeigt die Verwendung`delete-branch`. **AWS CLI** **So löschen Sie einen Branch** Dieses Beispiel zeigt, wie ein Branch in einem AWS CodeCommit Repository gelöscht wird. Befehl: ``` aws codecommit delete-branch --repository-name MyDemoRepo --branch-name MyNewBranch ``` Ausgabe: ``` { "branch": { "commitId": "317f8570EXAMPLE", "branchName": "MyNewBranch" } } ``` + Einzelheiten zur API finden Sie [DeleteBranch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/delete-branch.html)in der *AWS CLI Befehlsreferenz*. ### `delete-comment-content` Das folgende Codebeispiel zeigt die Verwendung`delete-comment-content`. **AWS CLI** **So löschen Sie den Inhalt eines Kommentars** Sie können den Inhalt eines Kommentars nur löschen, wenn Sie den Kommentar selbst erstellt haben. Dieses Beispiel zeigt, wie der Inhalt eines Kommentars mit der vom System generierten ID `ff30b348EXAMPLEb9aa670f` gelöscht wird. ``` aws codecommit delete-comment-content \ --comment-id ff30b348EXAMPLEb9aa670f ``` Ausgabe: ``` { "comment": { "creationDate": 1508369768.142, "deleted": true, "lastModifiedDate": 1508369842.278, "clientRequestToken": "123Example", "commentId": "ff30b348EXAMPLEb9aa670f", "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "callerReactions": [], "reactionCounts": { "CLAP" : 1 } } } ``` + Einzelheiten zur API finden Sie [DeleteCommentContent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/delete-comment-content.html)in der *AWS CLI Befehlsreferenz*. ### `delete-file` Das folgende Codebeispiel zeigt die Verwendung`delete-file`. **AWS CLI** **So löschen Sie eine Datei** Im folgenden Beispiel für `delete-file` wird gezeigt, wie eine Datei mit dem Namen `README.md` aus dem Branch `main` mit der neuesten Commit-ID `c5709475EXAMPLE` in einem Repository mit dem Namen `MyDemoRepo` gelöscht wird. ``` aws codecommit delete-file \ --repository-name MyDemoRepo \ --branch-name main \ --file-path README.md \ --parent-commit-id c5709475EXAMPLE ``` Ausgabe: ``` { "blobId":"559b44fEXAMPLE", "commitId":"353cf655EXAMPLE", "filePath":"README.md", "treeId":"6bc824cEXAMPLE" } ``` Weitere Informationen finden Sie unter [Bearbeiten oder Löschen einer Datei AWS CodeCommit im AWS](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-edit-file.html?shortFooter=true#how-to-edit-file-cli) *CodeCommit API-Referenzhandbuch*. + Einzelheiten zur API finden Sie [DeleteFile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/delete-file.html)in der *AWS CLI Befehlsreferenz*. ### `delete-pull-request-approval-rule` Das folgende Codebeispiel zeigt die Verwendung`delete-pull-request-approval-rule`. **AWS CLI** **So löschen Sie eine Genehmigungsregel für eine Pull-Anforderung** Im folgenden Beispiel für `delete-pull-request-approval-rule` wird eine Genehmigungsregel namens `My Approval Rule` für die angegebene Pull-Anforderung gelöscht. ``` aws codecommit delete-pull-request-approval-rule \ --approval-rule-name "My Approval Rule" \ --pull-request-id 15 ``` Ausgabe: ``` { "approvalRuleId": "077d8e8a8-EXAMPLE" } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Bearbeiten oder Löschen einer Genehmigungsregel](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-edit-delete-pull-request-approval-rule.html#delete-pull-request-approval-rule). + Einzelheiten zur API finden Sie [DeletePullRequestApprovalRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/delete-pull-request-approval-rule.html)unter *AWS CLI Befehlsreferenz*. ### `delete-repository` Das folgende Codebeispiel zeigt die Verwendung`delete-repository`. **AWS CLI** **So löschen Sie ein Repository** Dieses Beispiel zeigt, wie ein AWS CodeCommit Repository gelöscht wird. Befehl: ``` aws codecommit delete-repository --repository-name MyDemoRepo ``` Ausgabe: ``` { "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE" } ``` + Einzelheiten zur API finden Sie [DeleteRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/delete-repository.html)in der *AWS CLI Befehlsreferenz*. ### `describe-merge-conflicts` Das folgende Codebeispiel zeigt die Verwendung`describe-merge-conflicts`. **AWS CLI** **So rufen Sie detaillierte Informationen zu Konflikten beim Zusammenführen ab** Im folgenden Beispiel für `describe-merge-conflicts` werden die Zusammenführungskonflikte für eine Datei namens `readme.md` im angegebenen Quell- und Ziel-Branch mithilfe der THREE\$1WAY\$1MERGE-Strategie ermittelt. ``` aws codecommit describe-merge-conflicts \ --source-commit-specifier feature-randomizationfeature \ --destination-commit-specifier main \ --merge-option THREE_WAY_MERGE \ --file-path readme.md \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "conflictMetadata": { "filePath": "readme.md", "fileSizes": { "source": 139, "destination": 230, "base": 85 }, "fileModes": { "source": "NORMAL", "destination": "NORMAL", "base": "NORMAL" }, "objectTypes": { "source": "FILE", "destination": "FILE", "base": "FILE" }, "numberOfConflicts": 1, "isBinaryFile": { "source": false, "destination": false, "base": false }, "contentConflict": true, "fileModeConflict": false, "objectTypeConflict": false, "mergeOperations": { "source": "M", "destination": "M" } }, "mergeHunks": [ { "isConflict": true, "source": { "startLine": 0, "endLine": 3, "hunkContent": "VGhpcyBpEXAMPLE=" }, "destination": { "startLine": 0, "endLine": 1, "hunkContent": "VXNlIHRoEXAMPLE=" } } ], "destinationCommitId": "86958e0aEXAMPLE", "sourceCommitId": "6ccd57fdEXAMPLE", "baseCommitId": "767b69580EXAMPLE" } ``` Weitere Informationen finden Sie unter [Konflikte in einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-resolve-conflict-pull-request.html#describe-merge-conflicts) lösen im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeMergeConflicts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/describe-merge-conflicts.html)in der *AWS CLI Befehlsreferenz*. ### `describe-pull-request-events` Das folgende Codebeispiel zeigt die Verwendung`describe-pull-request-events`. **AWS CLI** **So zeigen Sie Ereignisse in einer Pull-Anforderung an** Im folgenden Beispiel für `describe-pull-request-events` werden die Ereignisse für eine Pull-Anforderung mit der ID „8“ abgerufen. ``` aws codecommit describe-pull-request-events --pull-request-id 8 ``` Ausgabe: ``` { "pullRequestEvents": [ { "pullRequestId": "8", "pullRequestEventType": "PULL_REQUEST_CREATED", "eventDate": 1510341779.53, "actor": "arn:aws:iam::111111111111:user/Zhang_Wei" }, { "pullRequestStatusChangedEventMetadata": { "pullRequestStatus": "CLOSED" }, "pullRequestId": "8", "pullRequestEventType": "PULL_REQUEST_STATUS_CHANGED", "eventDate": 1510341930.72, "actor": "arn:aws:iam::111111111111:user/Jane_Doe" } ] } ``` + Einzelheiten zur API finden Sie [DescribePullRequestEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/describe-pull-request-events.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-approval-rule-template-from-repository` Das folgende Codebeispiel zeigt die Verwendung`disassociate-approval-rule-template-from-repository`. **AWS CLI** **Um die Zuordnung einer Genehmigungsregelvorlage zu einem Repository aufzuheben** Im folgenden Beispiel für `disassociate-approval-rule-template-from-repository` wird die Zuordnung zwischen der angegebenen Genehmigungsregelvorlage und dem Repository `MyDemoRepo` aufgehoben. ``` aws codecommit disassociate-approval-rule-template-from-repository \ --repository-name MyDemoRepo \ --approval-rule-template-name 1-approver-rule-for-all-pull-requests ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Trennen der Zuordnung zu einer Vorlage für Genehmigungsregeln](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-disassociate-template.html#disassociate-template). + Einzelheiten zur API finden Sie unter [DisassociateApprovalRuleTemplateFromRepository AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/disassociate-approval-rule-template-from-repository.html)*Befehlsreferenz.* ### `evaluate-pull-request-approval-rules` Das folgende Codebeispiel zeigt die Verwendung`evaluate-pull-request-approval-rules`. **AWS CLI** **So bewerten Sie, ob für eine Pull-Anforderung alle Genehmigungsregeln erfüllt sind** Im folgenden Beispiel für `evaluate-pull-request-approval-rules` wird der Status der Genehmigungsregeln für die angegebene Pull-Anforderung ausgewertet. In diesem Beispiel wurde eine Genehmigungsregel für die Pull-Anforderung nicht erfüllt, sodass die Ausgabe des Befehls den `approved`-Wert `false` anzeigt. ``` aws codecommit evaluate-pull-request-approval-rules \ --pull-request-id 27 \ --revision-id 9f29d167EXAMPLE ``` Ausgabe: ``` { "evaluation": { "approved": false, "approvalRulesNotSatisfied": [ "Require two approved approvers" ], "overridden": false, "approvalRulesSatisfied": [] } } ``` Weitere Informationen finden Sie unter [Zusammenführen einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-merge-pull-request.html#evaluate-pull-request-approval-rules) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [EvaluatePullRequestApprovalRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/evaluate-pull-request-approval-rules.html)in der *AWS CLI Befehlsreferenz*. ### `get-approval-rule-template` Das folgende Codebeispiel zeigt die Verwendung`get-approval-rule-template`. **AWS CLI** **Um den Inhalt einer Vorlage für Genehmigungsregeln abzurufen** Im folgenden Beispiel für `get-approval-rule-template` wird der Inhalt einer Genehmigungsregelvorlage mit dem Namen `1-approver-rule-for-all-pull-requests` abgerufen. ``` aws codecommit get-approval-rule-template \ --approval-rule-template-name 1-approver-rule-for-all-pull-requests ``` Ausgabe: ``` { "approvalRuleTemplate": { "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "ruleContentSha256": "621181bbEXAMPLE", "lastModifiedDate": 1571356106.936, "creationDate": 1571356106.936, "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests", "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan", "approvalRuleTemplateId": "a29abb15-EXAMPLE", "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team." } } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Vorlagen für Genehmigungsregeln verwalten](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-manage-templates.html#get-template). + Einzelheiten zur API finden Sie [GetApprovalRuleTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-approval-rule-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-blob` Das folgende Codebeispiel zeigt die Verwendung`get-blob`. **AWS CLI** **So zeigen Sie Informationen zu einem Git-Blob-Objekt an** Im folgenden `get-blob` Beispiel werden Informationen über einen Git-Blob mit der ID '2EB4AF3BExample' in einem Repository namens '' abgerufen. AWS CodeCommit MyDemoRepo ``` aws codecommit get-blob --repository-name MyDemoRepo --blob-id 2eb4af3bEXAMPLE ``` Ausgabe: ``` { "content": "QSBCaW5hcnkgTGFyToEXAMPLE=" } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetBlob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-blob.html)AWS CLI * ### `get-branch` Das folgende Codebeispiel zeigt die Verwendung`get-branch`. **AWS CLI** **So rufen Sie Informationen zu einem Branch ab** In diesem Beispiel werden Informationen über einen Branch in einem AWS CodeCommit Repository abgerufen. Befehl: ``` aws codecommit get-branch --repository-name MyDemoRepo --branch-name MyNewBranch ``` Ausgabe: ``` { "BranchInfo": { "commitID": "317f8570EXAMPLE", "branchName": "MyNewBranch" } } ``` + Einzelheiten zur API finden Sie [GetBranch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-branch.html)in der *AWS CLI Befehlsreferenz*. ### `get-comment-reactions` Das folgende Codebeispiel zeigt die Verwendung`get-comment-reactions`. **AWS CLI** **So zeigen Sie Emoji-Reaktionen auf einen Kommentar an** Im folgenden Beispiel für `get-comment-reactions` werden alle Emoji-Reaktionen auf einen Kommentar mit der ID `abcd1234EXAMPLEb5678efgh` aufgelistet. Wenn die Schriftart für Ihre Shell die Anzeige von Emoji-Version 1.0 unterstützt, wird das Emoji in der Ausgabe für `emoji` angezeigt. ``` aws codecommit get-comment-reactions \ --comment-id abcd1234EXAMPLEb5678efgh ``` Ausgabe: ``` { "reactionsForComment": { [ { "reaction": { "emoji:"??", "shortCode": "thumbsup", "unicode": "U+1F44D" }, "users": [ "arn:aws:iam::123456789012:user/Li_Juan", "arn:aws:iam::123456789012:user/Mary_Major", "arn:aws:iam::123456789012:user/Jorge_Souza" ] }, { "reaction": { "emoji": "??", "shortCode": "thumbsdown", "unicode": "U+1F44E" }, "users": [ "arn:aws:iam::123456789012:user/Nikhil_Jayashankar" ] }, { "reaction": { "emoji": "??", "shortCode": "confused", "unicode": "U+1F615" }, "users": [ "arn:aws:iam::123456789012:user/Saanvi_Sarkar" ] } ] } } ``` Weitere Informationen finden Sie unter [Kommentieren zu einem Commit AWS CodeCommit im AWS](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-commit-comment.html#how-to-commit-comment-cli-commit-emoji-view) *CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetCommentReactions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-comment-reactions.html)in der *AWS CLI Befehlsreferenz*. ### `get-comment` Das folgende Codebeispiel zeigt die Verwendung`get-comment`. **AWS CLI** **So zeigen Sie Details zu einem Kommentar an** Dieses Beispiel zeigt, wie Details eines Kommentars mit der vom System generierten ID `ff30b348EXAMPLEb9aa670f` angezeigt werden. ``` aws codecommit get-comment \ --comment-id ff30b348EXAMPLEb9aa670f ``` Ausgabe: ``` { "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "ff30b348EXAMPLEb9aa670f", "content": "Whoops - I meant to add this comment to the line, but I don't see how to delete it.", "creationDate": 1508369768.142, "deleted": false, "commentId": "", "lastModifiedDate": 1508369842.278, "callerReactions": [], "reactionCounts": { "SMILE" : 6, "THUMBSUP" : 1 } } } ``` + Einzelheiten zur API finden Sie [GetComment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-comment.html)in der *AWS CLI Befehlsreferenz*. ### `get-comments-for-compared-commit` Das folgende Codebeispiel zeigt die Verwendung`get-comments-for-compared-commit`. **AWS CLI** **Um Kommentare zu einem Commit anzusehen** Dieses Beispiel zeigt, wie Sie Kommentare zu dem Vergleich zwischen zwei Commits in einem Repository mit dem Namen `MyDemoRepo` anzeigen. ``` aws codecommit get-comments-for-compared-commit \ --repository-name MyDemoRepo \ --before-commit-ID 6e147360EXAMPLE \ --after-commit-id 317f8570EXAMPLE ``` Ausgabe: ``` { "commentsForComparedCommitData": [ { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "317f8570EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "6e147360EXAMPLE", "comments": [ { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "ff30b348EXAMPLEb9aa670f", "content": "Whoops - I meant to add this comment to the line, not the file, but I don't see how to delete it.", "creationDate": 1508369768.142, "deleted": false, "CommentId": "123abc-EXAMPLE", "lastModifiedDate": 1508369842.278, "callerReactions": [], "reactionCounts": { "SMILE" : 6, "THUMBSUP" : 1 } }, { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "553b509bEXAMPLE56198325", "content": "Can you add a test case for this?", "creationDate": 1508369612.240, "deleted": false, "commentId": "456def-EXAMPLE", "lastModifiedDate": 1508369612.240, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 2 } } ], "location": { "filePath": "cl_sample.js", "filePosition": 1232, "relativeFileVersion": "after" }, "repositoryName": "MyDemoRepo" } ], "nextToken": "exampleToken" } ``` + Einzelheiten zur API finden Sie [GetCommentsForComparedCommit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-comments-for-compared-commit.html)in der *AWS CLI Befehlsreferenz*. ### `get-comments-for-pull-request` Das folgende Codebeispiel zeigt die Verwendung`get-comments-for-pull-request`. **AWS CLI** **So zeigen Sie Kommentare zu einer Pull-Anforderung an** Dieses Beispiel zeigt, wie Sie Kommentare für eine Pull-Anforderung in einem Repository mit dem Namen `MyDemoRepo` anzeigen. ``` aws codecommit get-comments-for-pull-request \ --repository-name MyDemoRepo \ --before-commit-ID 317f8570EXAMPLE \ --after-commit-id 5d036259EXAMPLE ``` Ausgabe: ``` { "commentsForPullRequestData": [ { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "5d036259EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "317f8570EXAMPLE", "comments": [ { "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", "clientRequestToken": "", "commentId": "abcd1234EXAMPLEb5678efgh", "content": "These don't appear to be used anywhere. Can we remove them?", "creationDate": 1508369622.123, "deleted": false, "lastModifiedDate": 1508369622.123, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 6, "CONFUSED" : 1 } }, { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "442b498bEXAMPLE5756813", "content": "Good catch. I'll remove them.", "creationDate": 1508369829.104, "deleted": false, "lastModifiedDate": 150836912.273, "callerReactions": ["THUMBSUP"] "reactionCounts": { "THUMBSUP" : 14 } } ], "location": { "filePath": "ahs_count.py", "filePosition": 367, "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo", "pullRequestId": "42" } ], "nextToken": "exampleToken" } ``` + Einzelheiten zur API finden Sie [GetCommentsForPullRequest](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-comments-for-pull-request.html)in der *AWS CLI Befehlsreferenz*. ### `get-commit` Das folgende Codebeispiel zeigt die Verwendung`get-commit`. **AWS CLI** **So zeigen Sie Informationen zu einem Commit in einem Repository an** Dieses Beispiel zeigt Details zu einem Commit mit der vom System generierten ID '7e9fd3091thisisanexamplethisisanexample1' in einem Repository mit dem Namen ''. AWS CodeCommit MyDemoRepo Befehl: ``` aws codecommit get-commit --repository-name MyDemoRepo --commit-id 7e9fd3091thisisanexamplethisisanexample1 ``` Ausgabe: ``` { "commit": { "additionalData": "", "committer": { "date": "1484167798 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "author": { "date": "1484167798 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "treeId": "347a3408thisisanexampletreeidexample", "parents": [ "7aa87a031thisisanexamplethisisanexample1" ], "message": "Fix incorrect variable name" } } ``` + Einzelheiten [GetCommit AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-commit.html)*zur* API finden Sie in der Befehlsreferenz. ### `get-differences` Das folgende Codebeispiel zeigt die Verwendung`get-differences`. **AWS CLI** **So rufen Sie Informationen zu Unterschieden für einen Commit-Spezifizierer in einem Repository ab** In diesem Beispiel werden Metadateninformationen zu Änderungen zwischen zwei Commit-Spezifizierern (Branch, Tag, HEAD oder andere vollqualifizierte Verweise wie Commit IDs) in einem umbenannten MyDemoRepo Ordner im AWS CodeCommit Repository mit dem Namen angezeigt. Das Beispiel enthält mehrere Optionen, die nicht erforderlich sind, darunter --before-commit-specifier, --before-path und --after-path, um besser zu veranschaulichen, wie Sie diese Optionen verwenden können, um die Ergebnisse einzuschränken. Die Antwort beinhaltet Dateimodus-Berechtigungen. Befehl: ``` aws codecommit get-differences --repository-name MyDemoRepo --before-commit-specifier 955bba12thisisanexamplethisisanexample --after-commit-specifier 14a95463thisisanexamplethisisanexample --before-path tmp/example-folder --after-path tmp/renamed-folder ``` Ausgabe: ``` { "differences": [ { "afterBlob": { "path": "blob.txt", "blobId": "2eb4af3b1thisisanexamplethisisanexample1", "mode": "100644" }, "changeType": "M", "beforeBlob": { "path": "blob.txt", "blobId": "bf7fcf281thisisanexamplethisisanexample1", "mode": "100644" } } ] } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetDifferences](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-differences.html)AWS CLI * ### `get-file` Das folgende Codebeispiel zeigt die Verwendung`get-file`. **AWS CLI** **Um den Base-64-codierten Inhalt einer Datei in einem Repository abzurufen AWS CodeCommit ** Das folgende Beispiel für `get-file` zeigt, wie der Base-64-verschlüsselte Inhalt der Datei `README.md` aus dem Branch `main` in einem Repository mit dem Namen `MyDemoRepo` abgerufen wird. ``` aws codecommit get-file \ --repository-name MyDemoRepo \ --commit-specifier main \ --file-path README.md ``` Ausgabe: ``` { "blobId":"559b44fEXAMPLE", "commitId":"c5709475EXAMPLE", "fileContent":"IyBQaHVzEXAMPLE", "filePath":"README.md", "fileMode":"NORMAL", "fileSize":1563 } ``` Weitere Informationen finden Sie [GetFile](https://docs.aws.amazon.com/codecommit/latest/APIReference/API_GetFile.html)im *AWS CodeCommit API-Referenzhandbuch*. + Einzelheiten zur API finden Sie [GetFile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-file.html)in der *AWS CLI Befehlsreferenz*. ### `get-folder` Das folgende Codebeispiel zeigt die Verwendung`get-folder`. **AWS CLI** **Um den Inhalt eines Ordners in einem AWS CodeCommit Repository abzurufen** Das folgende Beispiel für `get-folder` zeigt, wie Sie den Inhalt eines Ordners der obersten Ebene aus einem Repository mit dem Namen `MyDemoRepo` abrufen. ``` aws codecommit get-folder --repository-name MyDemoRepo --folder-path "" ``` Ausgabe: ``` { "commitId":"c5709475EXAMPLE", "files":[ { "absolutePath":".gitignore", "blobId":"74094e8bEXAMPLE", "fileMode":"NORMAL", "relativePath":".gitignore" }, { "absolutePath":"Gemfile", "blobId":"9ceb72f6EXAMPLE", "fileMode":"NORMAL", "relativePath":"Gemfile" }, { "absolutePath":"Gemfile.lock", "blobId":"795c4a2aEXAMPLE", "fileMode":"NORMAL", "relativePath":"Gemfile.lock" }, { "absolutePath":"LICENSE.txt", "blobId":"0c7932c8EXAMPLE", "fileMode":"NORMAL", "relativePath":"LICENSE.txt" }, { "absolutePath":"README.md", "blobId":"559b44feEXAMPLE", "fileMode":"NORMAL", "relativePath":"README.md" } ], "folderPath":"", "subFolders":[ { "absolutePath":"public", "relativePath":"public", "treeId":"d5e92ae3aEXAMPLE" }, { "absolutePath":"tmp", "relativePath":"tmp", "treeId":"d564d0bcEXAMPLE" } ], "subModules":[], "symbolicLinks":[], "treeId":"7b3c4dadEXAMPLE" } ``` Weitere Informationen finden Sie GetFolder im *AWS CodeCommit API-Referenzhandbuch*. + Einzelheiten zur API finden Sie [GetFolder](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-folder.html)in der *AWS CLI Befehlsreferenz*. ### `get-merge-commit` Das folgende Codebeispiel zeigt die Verwendung`get-merge-commit`. **AWS CLI** **So rufen Sie detaillierte Informationen zu einem Commit für die Zusammenführung ab** Im folgenden Beispiel für `get-merge-commit` werden Details zu einem Commit für die Zusammenführung für den Quell-Branch `bugfix-bug1234` mit dem Ziel-Branch `main` in einem Repository mit dem Namen `MyDemoRepo` angezeigt. ``` aws codecommit get-merge-commit \ --source-commit-specifier bugfix-bug1234 \ --destination-commit-specifier main \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "sourceCommitId": "c5709475EXAMPLE", "destinationCommitId": "317f8570EXAMPLE", "baseCommitId": "fb12a539EXAMPLE", "mergeCommitId": "ffc4d608eEXAMPLE" } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Commit-Details anzeigen](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-view-commit-details.html#how-to-view-commit-details-cli-merge-commit). + Einzelheiten zur API finden Sie [GetMergeCommit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-merge-commit.html)in der *AWS CLI Befehlsreferenz*. ### `get-merge-conflicts` Das folgende Codebeispiel zeigt die Verwendung`get-merge-conflicts`. **AWS CLI** **So zeigen Sie an, ob für eine Pull-Anforderung Konflikte für die Zusammenführung vorliegen** Das folgende Beispiel für `get-merge-conflicts` zeigt an, ob es Zusammenführungskonflikte zwischen der Spitze eines Quell-Branches mit dem Namen `feature-randomizationfeature` und einem Ziel-Branch namens „main“ in einem Repository mit dem Namen `MyDemoRepo` gibt. ``` aws codecommit get-merge-conflicts \ --repository-name MyDemoRepo \ --source-commit-specifier feature-randomizationfeature \ --destination-commit-specifier main \ --merge-option THREE_WAY_MERGE ``` Ausgabe: ``` { "mergeable": false, "destinationCommitId": "86958e0aEXAMPLE", "sourceCommitId": "6ccd57fdEXAMPLE", "baseCommitId": "767b6958EXAMPLE", "conflictMetadataList": [ { "filePath": "readme.md", "fileSizes": { "source": 139, "destination": 230, "base": 85 }, "fileModes": { "source": "NORMAL", "destination": "NORMAL", "base": "NORMAL" }, "objectTypes": { "source": "FILE", "destination": "FILE", "base": "FILE" }, "numberOfConflicts": 1, "isBinaryFile": { "source": false, "destination": false, "base": false }, "contentConflict": true, "fileModeConflict": false, "objectTypeConflict": false, "mergeOperations": { "source": "M", "destination": "M" } } ] } ``` + Einzelheiten zur API finden Sie [GetMergeConflicts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-merge-conflicts.html)in der *AWS CLI Befehlsreferenz*. ### `get-merge-options` Das folgende Codebeispiel zeigt die Verwendung`get-merge-options`. **AWS CLI** **So rufen Sie Informationen zu den Zusammenführungsoptionen ab, die für das Zusammenführen zweier angegebener Branches verfügbar sind** Im folgenden Beispiel für `get-merge-options` werden die verfügbaren Zusammenführungsoptionen beim Zusammenführen des Quell-Branches `bugfix-bug1234` mit dem Ziel-Branch `main` in einem Repository mit dem Namen `MyDemoRepo` bestimmt. ``` aws codecommit get-merge-options \ --source-commit-specifier bugfix-bug1234 \ --destination-commit-specifier main \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "mergeOptions": [ "FAST_FORWARD_MERGE", "SQUASH_MERGE", "THREE_WAY_MERGE" ], "sourceCommitId": "18059494EXAMPLE", "destinationCommitId": "ffd3311dEXAMPLE", "baseCommitId": "ffd3311dEXAMPLE" } ``` Weitere Informationen finden Sie unter [Konflikte in einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-resolve-conflict-pull-request.html#get-merge-options) lösen im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetMergeOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-merge-options.html)in der *AWS CLI Befehlsreferenz*. ### `get-pull-request-approval-states` Das folgende Codebeispiel zeigt die Verwendung`get-pull-request-approval-states`. **AWS CLI** **So zeigen Sie Genehmigungen für eine Pull-Anforderung an** Im folgenden Beispiel für `get-pull-request-approval-states` werden Genehmigungen für die angegebene Pull-Anforderung zurückgegeben. ``` aws codecommit get-pull-request-approval-states \ --pull-request-id 8 \ --revision-id 9f29d167EXAMPLE ``` Ausgabe: ``` { "approvals": [ { "userArn": "arn:aws:iam::123456789012:user/Mary_Major", "approvalState": "APPROVE" } ] } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Pull Requests anzeigen](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-view-pull-request.html#get-pull-request-approval-state). + Einzelheiten zur API finden Sie [GetPullRequestApprovalStates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-pull-request-approval-states.html)in der *AWS CLI Befehlsreferenz*. ### `get-pull-request-override-state` Das folgende Codebeispiel zeigt die Verwendung`get-pull-request-override-state`. **AWS CLI** **Um Informationen über den Override-Status einer Pull-Anfrage abzurufen** Im folgenden Beispiel für `get-pull-request-override-state` wird der Überschreibungsstatus für die angegebene Pull-Anforderung zurückgegeben. In diesem Beispiel wurden die Genehmigungsregeln für die Pull-Anforderung von einem Benutzer namens „Mary Major“ außer Kraft gesetzt, sodass die Ausgabe den Wert `true` zurückgibt: ``` aws codecommit get-pull-request-override-state \ --pull-request-id 34 \ --revision-id 9f29d167EXAMPLE ``` Ausgabe: ``` { "overridden": true, "overrider": "arn:aws:iam::123456789012:user/Mary_Major" } ``` Weitere Informationen findest du unter [Genehmigungsregeln für eine Pull-Anfrage außer Kraft setzen](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-override-approval-rules.html#get-override-status) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetPullRequestOverrideState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-pull-request-override-state.html)unter *AWS CLI Befehlsreferenz*. ### `get-pull-request` Das folgende Codebeispiel zeigt die Verwendung`get-pull-request`. **AWS CLI** **So zeigen Sie Details zu einer bestimmten Pull-Anforderung an** In diesem Beispiel wird gezeigt, wie Informationen zu einer Pull-Anforderung mit der ID `27` angezeigt werden. ``` aws codecommit get-pull-request \ --pull-request-id 27 ``` Ausgabe: ``` { "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "ruleContentSha256": "4711b576EXAMPLE" } ], "lastActivityDate": 1562619583.565, "pullRequestTargets": [ { "sourceCommit": "ca45e279EXAMPLE", "sourceReference": "refs/heads/bugfix-1234", "mergeBase": "a99f5ddbEXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": false }, "destinationCommit": "2abfc6beEXAMPLE", "repositoryName": "MyDemoRepo" } ], "revisionId": "e47def21EXAMPLE", "title": "Quick fix for bug 1234", "authorArn": "arn:aws:iam::123456789012:user/Nikhil_Jayashankar", "clientRequestToken": "d8d7612e-EXAMPLE", "creationDate": 1562619583.565, "pullRequestId": "27", "pullRequestStatus": "OPEN" } } ``` + Einzelheiten zur API finden Sie [GetPullRequest](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-pull-request.html)in der *AWS CLI Befehlsreferenz*. ### `get-repository-triggers` Das folgende Codebeispiel zeigt die Verwendung`get-repository-triggers`. **AWS CLI** **So rufen Sie Informationen zu Triggern in einem Repository ab** Dieses Beispiel zeigt Details zu Triggern, die für ein AWS CodeCommit Repository mit dem Namen konfiguriert wurden`MyDemoRepo`. ``` aws codecommit get-repository-triggers \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "configurationId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "triggers": [ { "destinationArn": "arn:aws:sns:us-east-1:111111111111:MyCodeCommitTopic", "branches": [ "main", "preprod" ], "name": "MyFirstTrigger", "customData": "", "events": [ "all" ] }, { "destinationArn": "arn:aws:lambda:us-east-1:111111111111:function:MyCodeCommitPythonFunction", "branches": [], "name": "MySecondTrigger", "customData": "EXAMPLE", "events": [ "all" ] } ] } ``` + Einzelheiten zur API finden Sie [GetRepositoryTriggers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-repository-triggers.html)in der *AWS CLI Befehlsreferenz*. ### `get-repository` Das folgende Codebeispiel zeigt die Verwendung`get-repository`. **AWS CLI** **So rufen Sie Informationen zu einem Repository ab** Dieses Beispiel zeigt Details zu einem AWS CodeCommit Repository. ``` aws codecommit get-repository \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "repositoryMetadata": { "creationDate": 1429203623.625, "defaultBranch": "main", "repositoryName": "MyDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-1.amazonaws.com/v1/repos/v1/repos/MyDemoRepo", "lastModifiedDate": 1430783812.0869999, "repositoryDescription": "My demonstration repository", "cloneUrlHttp": "https://codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo", "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "Arn": "arn:aws:codecommit:us-east-1:80398EXAMPLE:MyDemoRepo "accountId": "111111111111" } } ``` + Einzelheiten zur API finden Sie [GetRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/get-repository.html)in der *AWS CLI Befehlsreferenz*. ### `list-approval-rule-templates` Das folgende Codebeispiel zeigt die Verwendung`list-approval-rule-templates`. **AWS CLI** **Um alle Vorlagen für Genehmigungsregeln in einer AWS Region aufzulisten** Im folgenden Beispiel für `list-approval-rule-templates` werden alle Genehmigungsregelvorlagen in der angegebenen Region aufgelistet. Wenn keine AWS Region als Parameter angegeben ist, gibt der Befehl Genehmigungsregelvorlagen für die Region zurück, die im AWS CLI-Profil angegeben ist, das zur Ausführung des Befehls verwendet wurde. ``` aws codecommit list-approval-rule-templates \ --region us-east-2 ``` Ausgabe: ``` { "approvalRuleTemplateNames": [ "2-approver-rule-for-main", "1-approver-rule-for-all-pull-requests" ] } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Vorlagen für Genehmigungsregeln verwalten](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-manage-templates.html#list-templates). + Einzelheiten zur API finden Sie [ListApprovalRuleTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/list-approval-rule-templates.html)in der *AWS CLI Befehlsreferenz*. ### `list-associated-approval-rule-templates-for-repository` Das folgende Codebeispiel zeigt die Verwendung`list-associated-approval-rule-templates-for-repository`. **AWS CLI** **Um alle Vorlagen aufzulisten, die einem Repository zugeordnet sind** Im folgenden Beispiel für `list-associated-approval-rule-templates-for-repository` werden alle Genehmigungsregelvorlagen aufgeführt, die einem Repository mit dem Namen `MyDemoRepo` zugeordnet sind. ``` aws codecommit list-associated-approval-rule-templates-for-repository \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "approvalRuleTemplateNames": [ "2-approver-rule-for-main", "1-approver-rule-for-all-pull-requests" ] } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Vorlagen für Genehmigungsregeln verwalten](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-manage-templates.html#list-associated-templates). + Einzelheiten zur API finden Sie [ListAssociatedApprovalRuleTemplatesForRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/list-associated-approval-rule-templates-for-repository.html)in der *AWS CLI Befehlsreferenz*. ### `list-branches` Das folgende Codebeispiel zeigt die Verwendung`list-branches`. **AWS CLI** **Um eine Liste von Zweignamen anzuzeigen** In diesem Beispiel werden alle Zweignamen in einem AWS CodeCommit Repository aufgeführt. ``` aws codecommit list-branches \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "branches": [ "MyNewBranch", "main" ] } ``` + Einzelheiten zur API finden Sie [ListBranches](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/list-branches.html)in der *AWS CLI Befehlsreferenz*. ### `list-pull-requests` Das folgende Codebeispiel zeigt die Verwendung`list-pull-requests`. **AWS CLI** **So zeigen Sie eine Liste von Pull-Anforderungen in einem Repository an** Dieses Beispiel zeigt, wie Pull-Requests, die von einem IAM-Benutzer mit dem ARN 'arn:aws:iam: :111111111111:user/li\$1Juan' und dem Status 'CLOSED' erstellt wurden, in einem Repository namens '' aufgelistet werden: AWS CodeCommit MyDemoRepo ``` aws codecommit list-pull-requests --author-arn arn:aws:iam::111111111111:user/Li_Juan --pull-request-status CLOSED --repository-name MyDemoRepo ``` Ausgabe: ``` { "nextToken": "", "pullRequestIds": ["2","12","16","22","23","35","30","39","47"] } ``` + Einzelheiten [ListPullRequests AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/list-pull-requests.html)*zur* API finden Sie in der Befehlsreferenz. ### `list-repositories-for-approval-rule-template` Das folgende Codebeispiel zeigt die Verwendung`list-repositories-for-approval-rule-template`. **AWS CLI** **Um alle Repositorys aufzulisten, die einer Vorlage zugeordnet sind** Im folgenden Beispiel für `list-repositories-for-approval-rule-template` werden alle Repositorys aufgelistet, die der angegebenen Genehmigungsregelvorlage zugeordnet sind. ``` aws codecommit list-repositories-for-approval-rule-template \ --approval-rule-template-name 2-approver-rule-for-main ``` Ausgabe: ``` { "repositoryNames": [ "MyDemoRepo", "MyClonedRepo" ] } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Vorlagen für Genehmigungsregeln verwalten](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-manage-templates.html#list-associated-repositories). + Einzelheiten zur API finden Sie [ListRepositoriesForApprovalRuleTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/list-repositories-for-approval-rule-template.html)in der *AWS CLI Befehlsreferenz*. ### `list-repositories` Das folgende Codebeispiel zeigt die Verwendung`list-repositories`. **AWS CLI** **So zeigen Sie eine Liste der Repositorys an** Dieses Beispiel listet alle AWS CodeCommit Repositorys auf, die dem AWS Konto des Benutzers zugeordnet sind. Befehl: ``` aws codecommit list-repositories ``` Ausgabe: ``` { "repositories": [ { "repositoryName": "MyDemoRepo" "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", }, { "repositoryName": "MyOtherDemoRepo" "repositoryId": "cfc29ac4-b0cb-44dc-9990-f6f51EXAMPLE" } ] } ``` + Einzelheiten zur API finden Sie [ListRepositories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/list-repositories.html)in der *AWS CLI Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Um die AWS Tags für ein Repository anzuzeigen** Im folgenden Beispiel für `list-tags-for-resource` werden Tag-Schlüssel und Tag-Werte für das angegebene Repository aufgelistet. ``` aws codecommit list-tags-for-resource \ --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo ``` Ausgabe: ``` { "tags": { "Status": "Secret", "Team": "Saanvi" } } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Tags für ein Repository anzeigen](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-tag-repository-list.html#how-to-tag-repository-list-cli). + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/list-tags-for-resource.html)unter *AWS CLI Befehlsreferenz*. ### `merge-branches-by-fast-forward` Das folgende Codebeispiel zeigt die Verwendung`merge-branches-by-fast-forward`. **AWS CLI** **So führen Sie zwei Branches mithilfe der Fast-Forward-Mergestrategie zusammen** Im folgenden Beispiel für `merge-branches-by-fast-forward` wird der angegebene Quell-Branch mit dem angegebenen Ziel-Branch in einem Repository mit dem Namen `MyDemoRepo` zusammengeführt. ``` aws codecommit merge-branches-by-fast-forward \ --source-commit-specifier bugfix-bug1234 \ --destination-commit-specifier bugfix-bug1233 \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "commitId": "4f178133EXAMPLE", "treeId": "389765daEXAMPLE" } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch unter [Branches vergleichen und zusammenführen](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-compare-branches.html#merge-branches-by-fast-forward)*. + Einzelheiten zur API finden Sie [MergeBranchesByFastForward](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/merge-branches-by-fast-forward.html)in der *AWS CLI Befehlsreferenz*. ### `merge-branches-by-squash` Das folgende Codebeispiel zeigt die Verwendung`merge-branches-by-squash`. **AWS CLI** **So führen Sie zwei Branches mithilfe der Squash-Zusammenführungsstrategie zusammen** Im folgenden Beispiel für `merge-branches-by-squash` wird der angegebene Quell-Branch mit dem angegebenen Ziel-Branch in einem Repository mit dem Namen `MyDemoRepo` zusammengeführt. ``` aws codecommit merge-branches-by-squash \ --source-commit-specifier bugfix-bug1234 \ --destination-commit-specifier bugfix-bug1233 \ --author-name "Maria Garcia" \ --email "maria_garcia@example.com" \ --commit-message "Merging two fix branches to prepare for a general patch." \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "commitId": "4f178133EXAMPLE", "treeId": "389765daEXAMPLE" } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch unter [Branches vergleichen und zusammenführen](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-compare-branches.html#merge-branches-by-squash)*. + Einzelheiten zur API finden Sie [MergeBranchesBySquash](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/merge-branches-by-squash.html)in der *AWS CLI Befehlsreferenz*. ### `merge-branches-by-three-way` Das folgende Codebeispiel zeigt die Verwendung`merge-branches-by-three-way`. **AWS CLI** **So führen Sie zwei Branches mithilfe der Dreiwegemerge-Strategie zusammen** Im folgenden Beispiel für `merge-branches-by-three-way` wird der angegebene Quell-Branch mit dem angegebenen Ziel-Branch in einem Repository mit dem Namen `MyDemoRepo` zusammengeführt. ``` aws codecommit merge-branches-by-three-way \ --source-commit-specifier main \ --destination-commit-specifier bugfix-bug1234 \ --author-name "Jorge Souza" --email "jorge_souza@example.com" \ --commit-message "Merging changes from main to bugfix branch before additional testing." \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "commitId": "4f178133EXAMPLE", "treeId": "389765daEXAMPLE" } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch unter [Branches vergleichen und zusammenführen](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-compare-branches.html#merge-branches-by-three-way)*. + Einzelheiten zur API finden Sie [MergeBranchesByThreeWay](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/merge-branches-by-three-way.html)in der *AWS CLI Befehlsreferenz*. ### `merge-pull-request-by-fast-forward` Das folgende Codebeispiel zeigt die Verwendung`merge-pull-request-by-fast-forward`. **AWS CLI** **So führen Sie eine Pull-Anforderung zusammen und schließen sie** In diesem Beispiel wird gezeigt, wie Sie eine Pull-Anforderung mit der ID „47“ und der Quell-Commit-ID „99132ab0EXAMPLE“ in einem Repository mit dem Namen `MyDemoRepo` zusammenführen und schließen. ``` aws codecommit merge-pull-request-by-fast-forward \ --pull-request-id 47 \ --source-commit-id 99132ab0EXAMPLE \ --repository-name MyDemoRepo ``` Ausgabe: ``` { "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "I want one approver for this pull request", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.142, "description": "Review the latest changes and updates to the global variables", "lastActivityDate": 1508887223.155, "pullRequestId": "47", "pullRequestStatus": "CLOSED", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": true, "mergedBy": "arn:aws:iam::123456789012:user/Mary_Major" }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } } ``` Weitere Informationen finden Sie unter [Zusammenführen einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-merge-pull-request.html#merge-pull-request-by-fast-forward) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [MergePullRequestByFastForward](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/merge-pull-request-by-fast-forward.html)in der *AWS CLI Befehlsreferenz*. ### `merge-pull-request-by-squash` Das folgende Codebeispiel zeigt die Verwendung`merge-pull-request-by-squash`. **AWS CLI** **So führen Sie eine Pull-Anforderung mithilfe der Squash-Zusammenführungsstrategie zusammen** Im folgenden Beispiel für `merge-pull-request-by-squash` wird die angegebene Pull-Anforderung mithilfe der Konfliktlösungsstrategie ACCEPT\$1SOURCE in einem Repository mit dem Namen `MyDemoRepo` zusammengeführt und geschlossen. ``` aws codecommit merge-pull-request-by-squash \ --pull-request-id 47 \ --source-commit-id 99132ab0EXAMPLE \ --repository-name MyDemoRepo \ --conflict-detail-level LINE_LEVEL \ --conflict-resolution-strategy ACCEPT_SOURCE \ --name "Jorge Souza" --email "jorge_souza@example.com" \ --commit-message "Merging pull request 47 by squash and accepting source in merge conflicts" ``` Ausgabe: ``` { "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "originApprovalRuleTemplate": { "approvalRuleTemplateId": "dd8b17fe-EXAMPLE", "approvalRuleTemplateName": "2-approver-rule-for-main" }, "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.142, "description": "Review the latest changes and updates to the global variables", "lastActivityDate": 1508887223.155, "pullRequestId": "47", "pullRequestStatus": "CLOSED", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": true, "mergedBy": "arn:aws:iam::123456789012:user/Mary_Major" }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } } ``` Weitere Informationen finden Sie unter [Zusammenführen einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-merge-pull-request.html#merge-pull-request-by-squash) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [MergePullRequestBySquash](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/merge-pull-request-by-squash.html)in der *AWS CLI Befehlsreferenz*. ### `merge-pull-request-by-three-way` Das folgende Codebeispiel zeigt die Verwendung`merge-pull-request-by-three-way`. **AWS CLI** **So führen Sie eine Pull-Anforderung mithilfe der Dreiwegemerge-Strategie zusammen** Im folgenden Beispiel für `merge-pull-request-by-three-way` wird die angegebene Pull-Anforderung mit den Standardoptionen für Konfliktdetails und Konfliktlösungsstrategie in einem Repository mit dem Namen `MyDemoRepo` zusammengeführt und geschlossen. ``` aws codecommit merge-pull-request-by-three-way \ --pull-request-id 47 \ --source-commit-id 99132ab0EXAMPLE \ --repository-name MyDemoRepo \ --name "Maria Garcia" \ --email "maria_garcia@example.com" \ --commit-message "Merging pull request 47 by three-way with default options" ``` Ausgabe: ``` { "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "originApprovalRuleTemplate": { "approvalRuleTemplateId": "dd8b17fe-EXAMPLE", "approvalRuleTemplateName": "2-approver-rule-for-main" }, "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.142, "description": "Review the latest changes and updates to the global variables", "lastActivityDate": 1508887223.155, "pullRequestId": "47", "pullRequestStatus": "CLOSED", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": true, "mergedBy": "arn:aws:iam::123456789012:user/Mary_Major" }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } } ``` Weitere Informationen finden Sie unter [Zusammenführen einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-merge-pull-request.html#merge-pull-request-by-three-way) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [MergePullRequestByThreeWay](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/merge-pull-request-by-three-way.html)in der *AWS CLI Befehlsreferenz*. ### `override-pull-request-approval-rules` Das folgende Codebeispiel zeigt die Verwendung`override-pull-request-approval-rules`. **AWS CLI** **Um die Anforderungen der Genehmigungsregeln für eine Pull-Anfrage zu überschreiben** Im folgenden Beispiel für `override-pull-request-approval-rules` werden die Genehmigungsregeln für die angegebene Pull-Anforderung überschrieben. Wenn Sie stattdessen eine Überschreibung widerrufen möchten, setzen Sie den `--override-status`-Parameterwert auf `REVOKE`. ``` aws codecommit override-pull-request-approval-rules \ --pull-request-id 34 \ --revision-id 927df8d8EXAMPLE \ --override-status OVERRIDE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Überschreiben von Genehmigungsregeln bei einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-override-approval-rules.html#override-approval-rules) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [OverridePullRequestApprovalRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/override-pull-request-approval-rules.html)unter *AWS CLI Befehlsreferenz*. ### `post-comment-for-compared-commit` Das folgende Codebeispiel zeigt die Verwendung`post-comment-for-compared-commit`. **AWS CLI** **Um einen Kommentar zu einem Commit zu erstellen** In diesem Beispiel wird gezeigt, wie der Kommentar `"Can you add a test case for this?"` zur Änderung der `cl_sample.js`-Datei im Vergleich zwischen zwei Commits in einem Repository mit dem Namen `MyDemoRepo` hinzugefügt wird. ``` aws codecommit post-comment-for-compared-commit \ --repository-name MyDemoRepo \ --before-commit-id 317f8570EXAMPLE \ --after-commit-id 5d036259EXAMPLE \ --client-request-token 123Example \ --content "Can you add a test case for this?" \ --location filePath=cl_sample.js,filePosition=1232,relativeFileVersion=AFTER ``` Ausgabe: ``` { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "317f8570EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "6e147360EXAMPLE", "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "553b509bEXAMPLE56198325", "content": "Can you add a test case for this?", "creationDate": 1508369612.203, "deleted": false, "commentId": "abc123-EXAMPLE", "lastModifiedDate": 1508369612.203, "callerReactions": [], "reactionCounts": [] }, "location": { "filePath": "cl_sample.js", "filePosition": 1232, "relativeFileVersion": "AFTER" , "repositoryName": "MyDemoRepo" } } ``` + Einzelheiten zur API finden Sie [PostCommentForComparedCommit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/post-comment-for-compared-commit.html)in der *AWS CLI Befehlsreferenz*. ### `post-comment-for-pull-request` Das folgende Codebeispiel zeigt die Verwendung`post-comment-for-pull-request`. **AWS CLI** **So fügen Sie einen Kommentar zu einer Pull-Anforderung hinzu** Im folgenden Beispiel für `post-comment-for-pull-request` wird der Kommentar „These don't appear to be used anywhere. Can we remove them?“ für die Änderung der Datei `ahs_count.py` in einer Pull-Anforderung mit der ID `47` im Repository `MyDemoRepo` hinzugefügt. ``` aws codecommit post-comment-for-pull-request \ --pull-request-id "47" \ --repository-name MyDemoRepo \ --before-commit-id 317f8570EXAMPLE \ --after-commit-id 5d036259EXAMPLE \ --client-request-token 123Example \ --content "These don't appear to be used anywhere. Can we remove them?" \ --location filePath=ahs_count.py,filePosition=367,relativeFileVersion=AFTER ``` Ausgabe: ``` { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "5d036259EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "317f8570EXAMPLE", "comment": { "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", "clientRequestToken": "123Example", "commentId": "abcd1234EXAMPLEb5678efgh", "content": "These don't appear to be used anywhere. Can we remove them?", "creationDate": 1508369622.123, "deleted": false, "CommentId": "", "lastModifiedDate": 1508369622.123, "callerReactions": [], "reactionCounts": [] }, "location": { "filePath": "ahs_count.py", "filePosition": 367, "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo", "pullRequestId": "47" } ``` + Einzelheiten zur API finden Sie [PostCommentForPullRequest](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/post-comment-for-pull-request.html)in der *AWS CLI Befehlsreferenz*. ### `post-comment-reply` Das folgende Codebeispiel zeigt die Verwendung`post-comment-reply`. **AWS CLI** **So antworten Sie auf einen Kommentar zu einem Commit oder in einer Pull-Anforderung** In diesem Beispiel wird gezeigt, wie dem Kommentar mit der vom System generierten ID `abcd1234EXAMPLEb5678efgh` die Antwort `"Good catch. I'll remove them."` hinzugefügt wird. ``` aws codecommit post-comment-reply \ --in-reply-to abcd1234EXAMPLEb5678efgh \ --content "Good catch. I'll remove them." \ --client-request-token 123Example ``` Ausgabe: ``` { "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "442b498bEXAMPLE5756813", "content": "Good catch. I'll remove them.", "creationDate": 1508369829.136, "deleted": false, "CommentId": "abcd1234EXAMPLEb5678efgh", "lastModifiedDate": 150836912.221, "callerReactions": [], "reactionCounts": [] } } ``` + Einzelheiten zur API finden Sie [PostCommentReply](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/post-comment-reply.html)in der *AWS CLI Befehlsreferenz*. ### `put-comment-reaction` Das folgende Codebeispiel zeigt die Verwendung`put-comment-reaction`. **AWS CLI** **So antworten Sie mit einem Emoji auf einen Kommentar zu einem Commit** Im folgenden Beispiel für `put-comment-reaction` wird auf einen Kommentar mit der ID `abcd1234EXAMPLEb5678efgh` mit dem Emoji-Reaktionswert `:thumbsup:` geantwortet. ``` aws codecommit put-comment-reaction \ --comment-id abcd1234EXAMPLEb5678efgh \ --reaction-value :thumbsup: ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kommentieren zu einem Commit AWS CodeCommit im AWS](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-commit-comment.html#how-to-commit-comment-cli-commit-reply-emoji) *CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutCommentReaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/put-comment-reaction.html)in der *AWS CLI Befehlsreferenz*. ### `put-file` Das folgende Codebeispiel zeigt die Verwendung`put-file`. **AWS CLI** **Um eine Datei zu einem Repository hinzuzufügen** Im folgenden `put-file` Beispiel wird eine Datei mit dem Namen 'ExampleSolution.py' zu einem Repository namens '' zu einem Branch namens MyDemoRepo 'feature-randomizationfeature' hinzugefügt, dessen neuester Commit die ID '4C925148Example' hat. ``` aws codecommit put-file \ --repository-name MyDemoRepo \ --branch-name feature-randomizationfeature \ --file-content file://MyDirectory/ExampleSolution.py \ --file-path /solutions/ExampleSolution.py \ --parent-commit-id 4c925148EXAMPLE \ --name "Maria Garcia" \ --email "maria_garcia@example.com" \ --commit-message "I added a third randomization routine." ``` Ausgabe: ``` { "blobId": "2eb4af3bEXAMPLE", "commitId": "317f8570EXAMPLE", "treeId": "347a3408EXAMPLE" } ``` + [PutFile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/put-file.html)Einzelheiten *AWS CLI zur* API finden Sie unter Befehlsreferenz. ### `put-repository-triggers` Das folgende Codebeispiel zeigt die Verwendung`put-repository-triggers`. **AWS CLI** **So fügen Sie einen Trigger in einem Repository hinzu oder aktualisieren ihn** Dieses Beispiel zeigt, wie Trigger mit den Namen '' und MyFirstTrigger 'MySecondTrigger' mithilfe einer bereits erstellten JSON-Datei (hier mit dem Namen MyTriggers .json) aktualisiert werden, die die Struktur aller Trigger für ein Repository mit dem Namen enthält. MyDemoRepo Informationen zum Abrufen des JSON-Codes für bestehende Trigger finden Sie im Befehl. get-repository-triggers ``` aws codecommit put-repository-triggers \ --repository-name MyDemoRepo file://MyTriggers.json ``` Inhalt von `MyTriggers.json`: ``` { "repositoryName": "MyDemoRepo", "triggers": [ { "destinationArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MyCodeCommitTopic", "branches": [ "main", "preprod" ], "name": "MyFirstTrigger", "customData": "", "events": [ "all" ] }, { "destinationArn": "arn:aws:lambda:us-east-1:111111111111:function:MyCodeCommitPythonFunction", "branches": [], "name": "MySecondTrigger", "customData": "EXAMPLE", "events": [ "all" ] } ] } ``` Ausgabe: ``` { "configurationId": "6fa51cd8-35c1-EXAMPLE" } ``` + Einzelheiten zur API finden Sie [PutRepositoryTriggers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/put-repository-triggers.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Um AWS Tags zu einem vorhandenen Repository hinzuzufügen** Im folgenden Beispiel für `tag-resource` wird das angegebene Repository mit zwei Tags versehen. ``` aws codecommit tag-resource \ --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo \ --tags Status=Secret,Team=Saanvi ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen eines Tags zu einem Repository](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-tag-repository-add.html#how-to-tag-repository-add-cli) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/tag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `test-repository-triggers` Das folgende Codebeispiel zeigt die Verwendung`test-repository-triggers`. **AWS CLI** **So testen Sie Trigger in einem Repository** Dieses Beispiel zeigt, wie ein Trigger mit dem Namen 'MyFirstTrigger' in einem AWS CodeCommit Repository mit dem Namen getestet wird MyDemoRepo. In diesem Beispiel lösen Ereignisse im Repository Benachrichtigungen zu einem Thema im Zusammenhang mit Amazon Simple Notification Service (Amazon SNS) aus. Befehl: ``` aws codecommit test-repository-triggers --repository-name MyDemoRepo --triggers name=MyFirstTrigger,destinationArn=arn:aws:sns:us-east-1:111111111111:MyCodeCommitTopic,branches=mainline,preprod,events=all ``` Ausgabe: ``` { "successfulExecutions": [ "MyFirstTrigger" ], "failedExecutions": [] } ``` + Einzelheiten zur API finden Sie [TestRepositoryTriggers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/test-repository-triggers.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Um AWS Tags aus einem Repository zu entfernen** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem angegebenen Schlüssel aus dem Repository `MyDemoRepo` entfernt. ``` aws codecommit untag-resource \ --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo \ --tag-keys Status ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Entfernen eines Tags aus einem Repository](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-tag-repository-delete.html#how-to-tag-repository-delete-cli) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-approval-rule-template-content` Das folgende Codebeispiel zeigt die Verwendung`update-approval-rule-template-content`. **AWS CLI** **Um den Inhalt einer Vorlage für Genehmigungsregeln zu aktualisieren** Im folgenden Beispiel für `update-approval-rule-template-content` wird der Inhalt der angegebenen Genehmigungsregelvorlage so geändert, dass der Genehmigungs-Pool mit Benutzern, die die Rolle `CodeCommitReview` annehmen, neu definiert wird. ``` aws codecommit update-approval-rule-template-content \ --approval-rule-template-name 1-approver-rule \ --new-rule-content "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}" ``` Ausgabe: ``` { "approvalRuleTemplate": { "creationDate": 1571352720.773, "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool", "lastModifiedDate": 1571358728.41, "approvalRuleTemplateId": "41de97b7-EXAMPLE", "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests", "ruleContentSha256": "2f6c21a5EXAMPLE", "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan" } } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Vorlagen für Genehmigungsregeln verwalten](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-manage-templates.html#update-template-content). + Einzelheiten zur API finden Sie [UpdateApprovalRuleTemplateContent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-approval-rule-template-content.html)in der *AWS CLI Befehlsreferenz*. ### `update-approval-rule-template-description` Das folgende Codebeispiel zeigt die Verwendung`update-approval-rule-template-description`. **AWS CLI** **Um die Beschreibung einer Vorlage für Genehmigungsregeln zu aktualisieren** Im folgenden Beispiel für `update-approval-rule-template-description` wird die Beschreibung der angegebenen Genehmigungsregelvorlage in `Requires 1 approval for all pull requests from the CodeCommitReview pool` geändert: ``` aws codecommit update-approval-rule-template-description \ --approval-rule-template-name 1-approver-rule-for-all-pull-requests \ --approval-rule-template-description "Requires 1 approval for all pull requests from the CodeCommitReview pool" ``` Ausgabe: ``` { "approvalRuleTemplate": { "creationDate": 1571352720.773, "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool", "lastModifiedDate": 1571358728.41, "approvalRuleTemplateId": "41de97b7-EXAMPLE", "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests", "ruleContentSha256": "2f6c21a5EXAMPLE", "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan" } } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Vorlagen für Genehmigungsregeln verwalten](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-manage-templates.html#update-template-description). + Einzelheiten zur API finden Sie [UpdateApprovalRuleTemplateDescription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-approval-rule-template-description.html)in der *AWS CLI Befehlsreferenz*. ### `update-approval-rule-template-name` Das folgende Codebeispiel zeigt die Verwendung`update-approval-rule-template-name`. **AWS CLI** **Um den Namen einer Vorlage für Genehmigungsregeln zu aktualisieren** Im folgenden `update-approval-rule-template-name` Beispiel wird der Name einer Vorlage für Genehmigungsregeln von in 1- `1-approver-rule` approver-rule-for-all -Pull-Requests` geändert. ``` aws codecommit update-approval-rule-template-name \ --old-approval-rule-template-name 1-approver-rule \ --new-approval-rule-template-name 1-approver-rule-for-all-pull-requests ``` Ausgabe: ``` { "approvalRuleTemplate": { "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests", "lastModifiedDate": 1571358241.619, "approvalRuleTemplateId": "41de97b7-EXAMPLE", "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "creationDate": 1571352720.773, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team.", "ruleContentSha256": "2f6c21a5cEXAMPLE" } } ``` *Weitere Informationen finden Sie im Benutzerhandbuch unter [Vorlagen für Genehmigungsregeln verwalten](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-manage-templates.html#update-template-description).AWS CodeCommit * + Einzelheiten zur API finden Sie [UpdateApprovalRuleTemplateName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-approval-rule-template-name.html)in der *AWS CLI Befehlsreferenz*. ### `update-comment` Das folgende Codebeispiel zeigt die Verwendung`update-comment`. **AWS CLI** **Um einen Kommentar zu einem Commit zu aktualisieren** In diesem Beispiel wird gezeigt, wie der Inhalt `"Fixed as requested. I'll update the pull request."` zu einem Kommentar mit der ID `442b498bEXAMPLE5756813` hinzugefügt wird. ``` aws codecommit update-comment \ --comment-id 442b498bEXAMPLE5756813 \ --content "Fixed as requested. I'll update the pull request." ``` Ausgabe: ``` { "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "442b498bEXAMPLE5756813", "content": "Fixed as requested. I'll update the pull request.", "creationDate": 1508369929.783, "deleted": false, "lastModifiedDate": 1508369929.287, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 2 } } } ``` + Einzelheiten zur API finden Sie [UpdateComment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-comment.html)in der *AWS CLI Befehlsreferenz*. ### `update-default-branch` Das folgende Codebeispiel zeigt die Verwendung`update-default-branch`. **AWS CLI** **So ändern Sie den Standard-Branch für ein Repository** In diesem Beispiel wird der Standardzweig für ein AWS CodeCommit Repository geändert. Dieser Befehl liefert nur eine Ausgabe, wenn Fehler aufgetreten sind. Befehl: ``` aws codecommit update-default-branch --repository-name MyDemoRepo --default-branch-name MyNewBranch ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [UpdateDefaultBranch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-default-branch.html)in der *AWS CLI Befehlsreferenz*. ### `update-pull-request-approval-rule-content` Das folgende Codebeispiel zeigt die Verwendung`update-pull-request-approval-rule-content`. **AWS CLI** **So bearbeiten Sie eine Genehmigungsregel für eine Pull-Anforderung** Im folgenden `update-pull-request-approval-rule-content` Beispiel wird die von ihr angegebene Genehmigungsregel dahingehend aktualisiert, dass eine Benutzergenehmigung aus einem Genehmigungspool erforderlich ist, der alle IAM-Benutzer im `123456789012` AWS Konto umfasst. ``` aws codecommit update-pull-request-approval-rule-content \ --pull-request-id 27 \ --approval-rule-name "Require two approved approvers" \ --approval-rule-content "{Version: 2018-11-08, Statements: [{Type: \"Approvers\", NumberOfApprovalsNeeded: 1, ApprovalPoolMembers:[\"CodeCommitApprovers:123456789012:user/*\"]}]}}" ``` Ausgabe: ``` { "approvalRule": { "approvalRuleContent": "{Version: 2018-11-08, Statements: [{Type: \"Approvers\", NumberOfApprovalsNeeded: 1, ApprovalPoolMembers:[\"CodeCommitApprovers:123456789012:user/*\"]}]}}", "approvalRuleId": "aac33506-EXAMPLE", "originApprovalRuleTemplate": {}, "creationDate": 1570752871.932, "lastModifiedDate": 1570754058.333, "approvalRuleName": Require two approved approvers", "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "ruleContentSha256": "cd93921cEXAMPLE", } } ``` Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Bearbeiten oder Löschen einer Genehmigungsregel](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-edit-delete-pull-request-approval-rule.html#update-pull-request-approval-rule-content). + Einzelheiten zur API finden Sie [UpdatePullRequestApprovalRuleContent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-pull-request-approval-rule-content.html)unter *AWS CLI Befehlsreferenz*. ### `update-pull-request-approval-state` Das folgende Codebeispiel zeigt die Verwendung`update-pull-request-approval-state`. **AWS CLI** **So gewähren oder widerrufen Sie die Genehmigung für eine Pull-Anforderung** Im folgenden Beispiel für `update-pull-request-approval-state` wird die Pull-Anforderung mit der ID `27` und der Revisions-ID `9f29d167EXAMPLE` genehmigt. Wenn Sie stattdessen die Genehmigung widerrufen möchten, setzen Sie den `--approval-state`-Parameterwert auf `REVOKE`. ``` aws codecommit update-pull-request-approval-state \ --pull-request-id 27 \ --revision-id 9f29d167EXAMPLE \ --approval-state "APPROVE" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Überprüfen einer Pull-Anfrage](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-review-pull-request.html#update-pull-request-approval-state) im *AWS CodeCommit Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdatePullRequestApprovalState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-pull-request-approval-state.html)in der *AWS CLI Befehlsreferenz*. ### `update-pull-request-description` Das folgende Codebeispiel zeigt die Verwendung`update-pull-request-description`. **AWS CLI** **So ändern Sie die Beschreibung einer Pull-Anforderung** Dieses Beispiel zeigt, wie die Beschreibung einer Pull-Anforderung mit der ID `47` geändert wird. ``` aws codecommit update-pull-request-description \ --pull-request-id 47 \ --description "Updated the pull request to remove unused global variable." ``` Ausgabe: ``` { "pullRequest": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.155, "description": "Updated the pull request to remove unused global variable.", "lastActivityDate": 1508372423.204, "pullRequestId": "47", "pullRequestStatus": "OPEN", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": false, }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } } ``` + Einzelheiten zur API finden Sie [UpdatePullRequestDescription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-pull-request-description.html)in der *AWS CLI Befehlsreferenz*. ### `update-pull-request-status` Das folgende Codebeispiel zeigt die Verwendung`update-pull-request-status`. **AWS CLI** **So ändern Sie den Status einer Pull-Anforderung** Dieses Beispiel zeigt, wie der Status einer Pull-Anfrage mit der ID von `42` in den Status `CLOSED` in einem AWS CodeCommit Repository mit dem Namen geändert werden kann`MyDemoRepo`. ``` aws codecommit update-pull-request-status \ --pull-request-id 42 \ --pull-request-status CLOSED ``` Ausgabe: ``` { "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approvers-needed-for-this-change", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.165, "description": "Updated the pull request to remove unused global variable.", "lastActivityDate": 1508372423.12, "pullRequestId": "47", "pullRequestStatus": "CLOSED", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": false, }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } } ``` + Einzelheiten zur API finden Sie [UpdatePullRequestStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-pull-request-status.html)in der *AWS CLI Befehlsreferenz*. ### `update-pull-request-title` Das folgende Codebeispiel zeigt die Verwendung`update-pull-request-title`. **AWS CLI** **So ändern Sie den Titel einer Pull-Anforderung** In diesem Beispiel wird gezeigt, wie der Titel einer Pull-Anforderung mit der ID `47` geändert wird. ``` aws codecommit update-pull-request-title \ --pull-request-id 47 \ --title "Consolidation of global variables - updated review" ``` Ausgabe: ``` { "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "originApprovalRuleTemplate": { "approvalRuleTemplateId": "dd8b26gr-EXAMPLE", "approvalRuleTemplateName": "2-approver-rule-for-main" }, "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.12, "description": "Review the latest changes and updates to the global variables. I have updated this request with some changes, including removing some unused variables.", "lastActivityDate": 1508372657.188, "pullRequestId": "47", "pullRequestStatus": "OPEN", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": false, }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables - updated review" } } ``` + Einzelheiten zur API finden Sie [UpdatePullRequestTitle](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-pull-request-title.html)in der *AWS CLI Befehlsreferenz*. ### `update-repository-description` Das folgende Codebeispiel zeigt die Verwendung`update-repository-description`. **AWS CLI** **So ändern Sie die Beschreibung eines Repositorys** In diesem Beispiel wird die Beschreibung eines AWS CodeCommit Repositorys geändert. Dieser Befehl liefert nur eine Ausgabe, wenn Fehler aufgetreten sind. Befehl: ``` aws codecommit update-repository-description --repository-name MyDemoRepo --repository-description "This description was changed" ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [UpdateRepositoryDescription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-repository-description.html)in der *AWS CLI Befehlsreferenz*. ### `update-repository-name` Das folgende Codebeispiel zeigt die Verwendung`update-repository-name`. **AWS CLI** **So ändern Sie den Namen eines Repositorys** In diesem Beispiel wird der Name eines AWS CodeCommit Repositorys geändert. Dieser Befehl liefert nur eine Ausgabe, wenn Fehler aufgetreten sind. Wenn Sie den Namen des AWS CodeCommit Repositorys ändern, ändern sich auch die SSH- und HTTPS-Werte URLs , die Benutzer benötigen, um sich mit dem Repository zu verbinden. Benutzer können erst eine Verbindung mit diesem Repository herstellen, wenn sie ihre Verbindungseinstellungen aktualisiert haben. Da sich auch der ARN des Repositorys ändert, wird durch die Änderung des Repository-Namens jede IAM-Benutzerrichtlinie ungültig, die den ARN dieses Repositorys verwendet. Befehl: ``` aws codecommit update-repository-name --old-name MyDemoRepo --new-name MyRenamedDemoRepo ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [UpdateRepositoryName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codecommit/update-repository-name.html)in der *AWS CLI Befehlsreferenz.* # CodeDeploy Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CodeDeploy. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-tags-to-on-premises-instances` Das folgende Codebeispiel zeigt, wie Sie`add-tags-to-on-premises-instances`. **AWS CLI** **So fügen Sie Tags zu On-Premises-Instances hinzu** Im folgenden `add-tags-to-on-premises-instances` Beispiel wird AWS CodeDeploy dasselbe lokale Instanz-Tag zwei lokalen Instanzen zugeordnet. Die lokalen Instanzen werden nicht bei registriert. AWS CodeDeploy ``` aws deploy add-tags-to-on-premises-instances \ --instance-names AssetTag12010298EX AssetTag23121309EX \ --tags Key=Name,Value=CodeDeployDemo-OnPrem ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [AddTagsToOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/add-tags-to-on-premises-instances.html)in der *AWS CLI Befehlsreferenz.* ### `batch-get-application-revisions` Das folgende Codebeispiel zeigt die Verwendung`batch-get-application-revisions`. **AWS CLI** **So rufen Sie Informationen über Anwendungsrevisionen ab** Im folgenden `batch-get-application-revisions` Beispiel werden Informationen über die angegebene Version abgerufen, die in einem GitHub Repository gespeichert ist. ``` aws deploy batch-get-application-revisions \ --application-name my-codedeploy-application \ --revisions "[{\"gitHubLocation\": {\"commitId\": \"fa85936EXAMPLEa31736c051f10d77297EXAMPLE\",\"repository\": \"my-github-token/my-repository\"},\"revisionType\": \"GitHub\"}]" ``` Ausgabe: ``` { "revisions": [ { "genericRevisionInfo": { "description": "Application revision registered by Deployment ID: d-A1B2C3111", "lastUsedTime": 1556912355.884, "registerTime": 1556912355.884, "firstUsedTime": 1556912355.884, "deploymentGroups": [] }, "revisionLocation": { "revisionType": "GitHub", "gitHubLocation": { "commitId": "fa85936EXAMPLEa31736c051f10d77297EXAMPLE", "repository": "my-github-token/my-repository" } } } ], "applicationName": "my-codedeploy-application", "errorMessage": "" } ``` Weitere Informationen finden Sie unter [BatchGetApplicationRevisions](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetApplicationRevisions.html) in der *AWS CodeDeploy -API-Referenz*. + Einzelheiten zur API finden Sie unter [BatchGetApplicationRevisions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-application-revisions.html)*Befehlsreferenz.* ### `batch-get-applications` Das folgende Codebeispiel zeigt die Verwendung`batch-get-applications`. **AWS CLI** **So rufen Sie Informationen zu mehreren Anwendungen ab** Im folgenden `batch-get-applications` Beispiel werden Informationen zu mehreren Anwendungen angezeigt, die dem AWS Konto des Benutzers zugeordnet sind. ``` aws deploy batch-get-applications --application-names WordPress_App MyOther_App ``` Ausgabe: ``` { "applicationsInfo": [ { "applicationName": "WordPress_App", "applicationId": "d9dd6993-f171-44fa-a811-211e4EXAMPLE", "createTime": 1407878168.078, "linkedToGitHub": false }, { "applicationName": "MyOther_App", "applicationId": "8ca57519-31da-42b2-9194-8bb16EXAMPLE", "createTime": 1407453571.63, "linkedToGitHub": false } ] } ``` + Einzelheiten zur API finden Sie [BatchGetApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-applications.html)unter *AWS CLI Befehlsreferenz*. ### `batch-get-deployment-groups` Das folgende Codebeispiel zeigt die Verwendung`batch-get-deployment-groups`. **AWS CLI** **So rufen Sie Informationen zu einzelnen oder mehreren Bereitstellungsgruppen ab** Im folgenden `batch-get-deployment-groups` Beispiel werden Informationen zu zwei der Bereitstellungsgruppen abgerufen, die der angegebenen CodeDeploy Anwendung zugeordnet sind. ``` aws deploy batch-get-deployment-groups \ --application-name my-codedeploy-application \ --deployment-group-names "[\"my-deployment-group-1\",\"my-deployment-group-2\"]" ``` Ausgabe: ``` { "deploymentGroupsInfo": [ { "deploymentStyle": { "deploymentOption": "WITHOUT_TRAFFIC_CONTROL", "deploymentType": "IN_PLACE" }, "autoRollbackConfiguration": { "enabled": false }, "onPremisesTagSet": { "onPremisesTagSetList": [] }, "serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployServiceRole", "lastAttemptedDeployment": { "endTime": 1556912366.415, "status": "Failed", "createTime": 1556912355.884, "deploymentId": "d-A1B2C3111" }, "autoScalingGroups": [], "deploymentGroupName": "my-deployment-group-1", "ec2TagSet": { "ec2TagSetList": [ [ { "Type": "KEY_AND_VALUE", "Value": "my-EC2-instance", "Key": "Name" } ] ] }, "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111example", "triggerConfigurations": [], "applicationName": "my-codedeploy-application", "computePlatform": "Server", "deploymentConfigName": "CodeDeployDefault.AllAtOnce" }, { "deploymentStyle": { "deploymentOption": "WITHOUT_TRAFFIC_CONTROL", "deploymentType": "IN_PLACE" }, "autoRollbackConfiguration": { "enabled": false }, "onPremisesTagSet": { "onPremisesTagSetList": [] }, "serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployServiceRole", "autoScalingGroups": [], "deploymentGroupName": "my-deployment-group-2", "ec2TagSet": { "ec2TagSetList": [ [ { "Type": "KEY_AND_VALUE", "Value": "my-EC2-instance", "Key": "Name" } ] ] }, "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-22222example", "triggerConfigurations": [], "applicationName": "my-codedeploy-application", "computePlatform": "Server", "deploymentConfigName": "CodeDeployDefault.AllAtOnce" } ], "errorMessage": "" } ``` Weitere Informationen finden Sie unter [BatchGetDeploymentGroups](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentGroups.html) in der *AWS CodeDeploy -API-Referenz*. + Einzelheiten zur API finden Sie unter [BatchGetDeploymentGroups AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployment-groups.html)*Befehlsreferenz.* ### `batch-get-deployment-targets` Das folgende Codebeispiel zeigt die Verwendung`batch-get-deployment-targets`. **AWS CLI** **So rufen Sie die mit einer Bereitstellung verknüpften Ziele ab** Im folgenden Beispiel für `batch-get-deployment-targets` werden Informationen zu einem der Ziele zurückgegeben, die mit der angegebenen Bereitstellung verknüpft sind. ``` aws deploy batch-get-deployment-targets \ --deployment-id "d-1A2B3C4D5" \ --target-ids "i-01a2b3c4d5e6f1111" ``` Ausgabe: ``` { "deploymentTargets": [ { "deploymentTargetType": "InstanceTarget", "instanceTarget": { "lifecycleEvents": [ { "startTime": 1556918592.162, "lifecycleEventName": "ApplicationStop", "status": "Succeeded", "endTime": 1556918592.247, "diagnostics": { "scriptName": "", "errorCode": "Success", "logTail": "", "message": "Succeeded" } }, { "startTime": 1556918593.193, "lifecycleEventName": "DownloadBundle", "status": "Succeeded", "endTime": 1556918593.981, "diagnostics": { "scriptName": "", "errorCode": "Success", "logTail": "", "message": "Succeeded" } }, { "startTime": 1556918594.805, "lifecycleEventName": "BeforeInstall", "status": "Succeeded", "endTime": 1556918681.807, "diagnostics": { "scriptName": "", "errorCode": "Success", "logTail": "", "message": "Succeeded" } } ], "targetArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-01a2b3c4d5e6f1111", "deploymentId": "d-1A2B3C4D5", "lastUpdatedAt": 1556918687.504, "targetId": "i-01a2b3c4d5e6f1111", "status": "Succeeded" } } ] } ``` Weitere Informationen finden Sie unter [BatchGetDeploymentTargets](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentTargets.html) in der *AWS CodeDeploy -API-Referenz*. + Einzelheiten zur API finden Sie [BatchGetDeploymentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployment-targets.html)in der *AWS CLI Befehlsreferenz*. ### `batch-get-deployments` Das folgende Codebeispiel zeigt die Verwendung`batch-get-deployments`. **AWS CLI** **So rufen Sie Informationen zu mehreren Bereitstellungen ab** Im folgenden `batch-get-deployments` Beispiel werden Informationen zu mehreren Bereitstellungen angezeigt, die dem AWS Konto des Benutzers zugeordnet sind. ``` aws deploy batch-get-deployments --deployment-ids d-A1B2C3111 d-A1B2C3222 ``` Ausgabe: ``` { "deploymentsInfo": [ { "applicationName": "WordPress_App", "status": "Failed", "deploymentOverview": { "Failed": 0, "InProgress": 0, "Skipped": 0, "Succeeded": 1, "Pending": 0 }, "deploymentConfigName": "CodeDeployDefault.OneAtATime", "creator": "user", "deploymentGroupName": "WordPress_DG", "revision": { "revisionType": "S3", "s3Location": { "bundleType": "zip", "version": "uTecLusEXAMPLEFXtfUcyfV8bEXAMPLE", "bucket": "amzn-s3-demo-bucket", "key": "WordPressApp.zip" } }, "deploymentId": "d-A1B2C3111", "createTime": 1408480721.9, "completeTime": 1408480741.822 }, { "applicationName": "MyOther_App", "status": "Failed", "deploymentOverview": { "Failed": 1, "InProgress": 0, "Skipped": 0, "Succeeded": 0, "Pending": 0 }, "deploymentConfigName": "CodeDeployDefault.OneAtATime", "creator": "user", "errorInformation": { "message": "Deployment failed: Constraint default violated: No hosts succeeded.", "code": "HEALTH_CONSTRAINTS" }, "deploymentGroupName": "MyOther_DG", "revision": { "revisionType": "S3", "s3Location": { "bundleType": "zip", "eTag": "\"dd56cfdEXAMPLE8e768f9d77fEXAMPLE\"", "bucket": "amzn-s3-demo-bucket", "key": "MyOtherApp.zip" } }, "deploymentId": "d-A1B2C3222", "createTime": 1409764576.589, "completeTime": 1409764596.101 } ] } ``` + Einzelheiten zur API finden Sie unter [BatchGetDeployments AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployments.html)*Befehlsreferenz.* ### `batch-get-on-premises-instances` Das folgende Codebeispiel zeigt die Verwendung`batch-get-on-premises-instances`. **AWS CLI** **So rufen Sie Informationen zu einzelnen oder mehreren On-Premises-Instances ab** Im folgenden Beispiel für `batch-get-on-premises-instances` werden Informationen zu zwei On-Premises-Instances abgerufen. ``` aws deploy batch-get-on-premises-instances --instance-names AssetTag12010298EX AssetTag23121309EX ``` Ausgabe: ``` { "instanceInfos": [ { "iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag12010298EX", "tags": [ { "Value": "CodeDeployDemo-OnPrem", "Key": "Name" } ], "instanceName": "AssetTag12010298EX", "registerTime": 1425579465.228, "instanceArn": "arn:aws:codedeploy:us-west-2:123456789012:instance/AssetTag12010298EX_4IwLNI2Alh" }, { "iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag23121309EX", "tags": [ { "Value": "CodeDeployDemo-OnPrem", "Key": "Name" } ], "instanceName": "AssetTag23121309EX", "registerTime": 1425595585.988, "instanceArn": "arn:aws:codedeploy:us-west-2:80398EXAMPLE:instance/AssetTag23121309EX_PomUy64Was" } ] } ``` + Einzelheiten zur API finden Sie [BatchGetOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-on-premises-instances.html)in der *AWS CLI Befehlsreferenz*. ### `continue-deployment` Das folgende Codebeispiel zeigt die Verwendung`continue-deployment`. **AWS CLI** **So beginnen Sie mit der Umleitung des Datenverkehrs, ohne die angegebene Wartezeit verstreichen zu lassen.** Im folgenden Beispiel für `continue-deployment` wird mit der Umleitung des Datenverkehrs von Instances in der ursprünglichen Umgebung begonnen, die bereit sind, den Datenverkehr zu Instances in der Austauschumgebung zu verlagern. ``` aws deploy continue-deployment \ --deployment-id "d-A1B2C3111" \ --deployment-wait-type "READY_WAIT" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [ContinueDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ContinueDeployment.html) in der *AWS CodeDeploy -API-Referenz*. + Einzelheiten zur API finden Sie [ContinueDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/continue-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `create-application` Das folgende Codebeispiel zeigt die Verwendung`create-application`. **AWS CLI** **So erstellen Sie eine Anwendung** Das folgende `create-application` Beispiel erstellt eine Anwendung und ordnet sie dem AWS Konto des Benutzers zu. ``` aws deploy create-application --application-name MyOther_App ``` Ausgabe: ``` { "applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" } ``` + Einzelheiten zur API finden Sie [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-application.html)unter *AWS CLI Befehlsreferenz*. ### `create-deployment-config` Das folgende Codebeispiel zeigt die Verwendung`create-deployment-config`. **AWS CLI** **So erstellen Sie eine benutzerdefinierte Bereitstellungskonfiguration** Im folgenden `create-deployment-config` Beispiel wird eine benutzerdefinierte Bereitstellungskonfiguration erstellt und sie dem AWS Benutzerkonto zugeordnet. ``` aws deploy create-deployment-config \ --deployment-config-name ThreeQuartersHealthy \ --minimum-healthy-hosts type=FLEET_PERCENT,value=75 ``` Ausgabe: ``` { "deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" } ``` + Einzelheiten zur API finden Sie [CreateDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment-config.html)unter *AWS CLI Befehlsreferenz*. ### `create-deployment-group` Das folgende Codebeispiel zeigt die Verwendung`create-deployment-group`. **AWS CLI** **So erstellen Sie eine Bereitstellungsgruppe** Im folgenden `create-deployment-group` Beispiel wird eine Bereitstellungsgruppe erstellt und sie der angegebenen Anwendung und dem AWS Benutzerkonto zugeordnet. ``` aws deploy create-deployment-group \ --application-name WordPress_App \ --auto-scaling-groups CodeDeployDemo-ASG \ --deployment-config-name CodeDeployDefault.OneAtATime \ --deployment-group-name WordPress_DG \ --ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE \ --service-role-arn arn:aws:iam::123456789012:role/CodeDeployDemoRole ``` Ausgabe: ``` { "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" } ``` + Einzelheiten zur API finden Sie [CreateDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment-group.html)unter *AWS CLI Befehlsreferenz*. ### `create-deployment` Das folgende Codebeispiel zeigt die Verwendung`create-deployment`. **AWS CLI** **Beispiel 1: Um eine CodeDeploy Bereitstellung mithilfe der EC2/On-Premises-Computing-Plattform zu erstellen** Das folgende `create-deployment` Beispiel erstellt eine Bereitstellung und ordnet sie dem Konto des Benutzers zu. AWS ``` aws deploy create-deployment \ --application-name WordPress_App \ --deployment-config-name CodeDeployDefault.OneAtATime \ --deployment-group-name WordPress_DG \ --description "My demo deployment" \ --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip ``` Ausgabe: ``` { "deploymentId": "d-A1B2C3111" } ``` **Beispiel 2: So erstellen Sie eine CodeDeploy Bereitstellung mit der Amazon ECS-Rechenplattform** Im folgenden Beispiel für `create-deployment` werden die folgenden zwei Dateien verwendet, um einen Amazon-ECS-Service bereitzustellen. Inhalt der `create-deployment.json`-Datei: ``` { "applicationName": "ecs-deployment", "deploymentGroupName": "ecs-deployment-dg", "revision": { "revisionType": "S3", "s3Location": { "bucket": "ecs-deployment-bucket", "key": "appspec.yaml", "bundleType": "YAML" } } } ``` Diese Datei wiederum ruft die folgende `appspec.yaml`-Datei aus einem S3-Bucket mit dem Namen `ecs-deployment-bucket` ab. ``` version: 0.0 Resources: - TargetService: Type: AWS::ECS::Service Properties: TaskDefinition: "arn:aws:ecs:region:123456789012:task-definition/ecs-task-def:2" LoadBalancerInfo: ContainerName: "sample-app" ContainerPort: 80 PlatformVersion: "LATEST" ``` Befehl: ``` aws deploy create-deployment \ --cli-input-json file://create-deployment.json \ --region us-east-1 ``` Ausgabe: ``` { "deploymentId": "d-1234ABCDE" } ``` Weitere Informationen finden Sie unter [CreateDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html) in der *AWS CodeDeploy -API-Referenz*. + Einzelheiten zur API finden Sie [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `delete-application` Das folgende Codebeispiel zeigt die Verwendung`delete-application`. **AWS CLI** **So löschen Sie eine Anwendung** Im folgenden `delete-application` Beispiel wird die angegebene Anwendung gelöscht, die dem AWS Konto des Benutzers zugeordnet ist. ``` aws deploy delete-application --application-name WordPress_App ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie unter [DeleteApplication AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-application.html)*Befehlsreferenz.* ### `delete-deployment-config` Das folgende Codebeispiel zeigt die Verwendung`delete-deployment-config`. **AWS CLI** **So löschen Sie eine Bereitstellungskonfiguration** Im folgenden `delete-deployment-config` Beispiel wird eine benutzerdefinierte Bereitstellungskonfiguration gelöscht, die dem AWS Konto des Benutzers zugeordnet ist. ``` aws deploy delete-deployment-config --deployment-config-name ThreeQuartersHealthy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie unter [DeleteDeploymentConfig AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-deployment-config.html)*Befehlsreferenz.* ### `delete-deployment-group` Das folgende Codebeispiel zeigt die Verwendung`delete-deployment-group`. **AWS CLI** **So löschen Sie eine Bereitstellungsgruppe** Im folgenden Beispiel für `delete-deployment-group` wird eine Bereitstellungsgruppe gelöscht, die der angegebenen Anwendung zugeordnet ist. ``` aws deploy delete-deployment-group \ --application-name WordPress_App \ --deployment-group-name WordPress_DG ``` Ausgabe: ``` { "hooksNotCleanedUp": [] } ``` + Einzelheiten zur API finden Sie [DeleteDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-deployment-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-git-hub-account-token` Das folgende Codebeispiel zeigt die Verwendung`delete-git-hub-account-token`. **AWS CLI** **Um eine GitHub Kontoverbindung zu löschen** Im folgenden `delete-git-hub-account-token` Beispiel wird die Verbindung des angegebenen GitHub Kontos gelöscht. ``` aws deploy delete-git-hub-account-token --token-name my-github-account ``` Ausgabe: ``` { "tokenName": "my-github-account" } ``` Weitere Informationen finden Sie unter [DeleteGitHubAccountToken](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeleteGitHubAccountToken.html) in der *AWS CodeDeploy -API-Referenz*. + Einzelheiten zur API finden Sie unter [DeleteGitHubAccountToken AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-git-hub-account-token.html)*Befehlsreferenz.* ### `deregister-on-premises-instance` Das folgende Codebeispiel zeigt die Verwendung`deregister-on-premises-instance`. **AWS CLI** **So heben Sie die Registrierung einer On-Premises-Instance auf** Im folgenden `deregister-on-premises-instance` Beispiel wird die Registrierung einer lokalen Instance aufgehoben AWS CodeDeploy, der der Instance zugeordnete IAM-Benutzer wird jedoch nicht gelöscht, und es wird auch nicht die Zuordnung in AWS CodeDeploy den lokalen Instance-Tags zur Instance aufgehoben. Außerdem wird weder der AWS CodeDeploy Agent von der Instanz deinstalliert noch die lokale Konfigurationsdatei aus der Instanz entfernt. ``` aws deploy deregister-on-premises-instance --instance-name AssetTag12010298EX ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie unter [DeregisterOnPremisesInstance AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/deregister-on-premises-instance.html)*Befehlsreferenz.* ### `deregister` Das folgende Codebeispiel zeigt die Verwendung`deregister`. **AWS CLI** **So heben Sie die Registrierung einer On-Premises-Instance auf** Im folgenden `deregister` Beispiel wird die Registrierung einer lokalen Instanz mit aufgehoben. AWS CodeDeploy Der mit der Instance verbundene IAM-Benutzer wird nicht gelöscht. Es trennt die Zuordnung zwischen den lokalen AWS CodeDeploy Tags und der Instanz. Dabei wird weder der AWS CodeDeploy Agent von der Instanz deinstalliert noch die lokale Konfigurationsdatei aus der Instanz entfernt. ``` aws deploy deregister \ --instance-name AssetTag12010298EX \ --no-delete-iam-user \ --region us-west-2 ``` Ausgabe: ``` Retrieving on-premises instance information... DONE IamUserArn: arn:aws:iam::80398EXAMPLE:user/AWS/CodeDeploy/AssetTag12010298EX Tags: Key=Name,Value=CodeDeployDemo-OnPrem Removing tags from the on-premises instance... DONE Deregistering the on-premises instance... DONE Run the following command on the on-premises instance to uninstall the codedeploy-agent: aws deploy uninstall ``` + Weitere API-Informationen finden Sie unter [Deregister](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/deregister.html) in der *AWS CLI -Befehlsreferenz*. ### `get-application-revision` Das folgende Codebeispiel zeigt die Verwendung`get-application-revision`. **AWS CLI** **So rufen Sie Informationen zu einer Anwendungsrevision ab** Im folgenden Beispiel für `get-application-revision` werden Informationen zu einer Anwendungsrevision angezeigt, die der angegebenen Anwendung zugeordnet ist. ``` aws deploy get-application-revision \ --application-name WordPress_App \ --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip ``` Ausgabe: ``` { "applicationName": "WordPress_App", "revisionInfo": { "description": "Application revision registered by Deployment ID: d-A1B2C3111", "registerTime": 1411076520.009, "deploymentGroups": "WordPress_DG", "lastUsedTime": 1411076520.009, "firstUsedTime": 1411076520.009 }, "revision": { "revisionType": "S3", "s3Location": { "bundleType": "zip", "eTag": "dd56cfdEXAMPLE8e768f9d77fEXAMPLE", "bucket": "amzn-s3-demo-bucket", "key": "WordPressApp.zip" } } } ``` + Einzelheiten zur API finden Sie [GetApplicationRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-application-revision.html)in der *AWS CLI Befehlsreferenz*. ### `get-application` Das folgende Codebeispiel zeigt die Verwendung`get-application`. **AWS CLI** **So rufen Sie Informationen zu einer Anwendung ab** Im folgenden `get-application` Beispiel werden Informationen zu einer Anwendung angezeigt, die dem AWS Konto des Benutzers zugeordnet ist. ``` aws deploy get-application --application-name WordPress_App ``` Ausgabe: ``` { "application": { "applicationName": "WordPress_App", "applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "createTime": 1407878168.078, "linkedToGitHub": false } } ``` + Einzelheiten zur API finden Sie [GetApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-application.html)unter *AWS CLI Befehlsreferenz*. ### `get-deployment-config` Das folgende Codebeispiel zeigt die Verwendung`get-deployment-config`. **AWS CLI** **So rufen Sie Informationen zu einer Bereitstellungskonfiguration ab** Im folgenden `get-deployment-config` Beispiel werden Informationen zu einer Bereitstellungskonfiguration angezeigt, die dem AWS Konto des Benutzers zugeordnet ist. ``` aws deploy get-deployment-config --deployment-config-name ThreeQuartersHealthy ``` Ausgabe: ``` { "deploymentConfigInfo": { "deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "minimumHealthyHosts": { "type": "FLEET_PERCENT", "value": 75 }, "createTime": 1411081164.379, "deploymentConfigName": "ThreeQuartersHealthy" } } ``` + Einzelheiten zur API finden Sie [GetDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-config.html)unter *AWS CLI Befehlsreferenz*. ### `get-deployment-group` Das folgende Codebeispiel zeigt die Verwendung`get-deployment-group`. **AWS CLI** **So zeigen Sie Informationen zu einer Bereitstellungsgruppe an** Im folgenden Beispiel für `get-deployment-group` werden Informationen zu einer Bereitstellungsgruppe angezeigt, die der angegebenen Anwendung zugeordnet ist. ``` aws deploy get-deployment-group \ --application-name WordPress_App \ --deployment-group-name WordPress_DG ``` Ausgabe: ``` { "deploymentGroupInfo": { "applicationName": "WordPress_App", "autoScalingGroups": [ "CodeDeployDemo-ASG" ], "deploymentConfigName": "CodeDeployDefault.OneAtATime", "ec2TagFilters": [ { "Type": "KEY_AND_VALUE", "Value": "CodeDeployDemo", "Key": "Name" } ], "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployDemoRole", "deploymentGroupName": "WordPress_DG" } } ``` + Einzelheiten zur API finden Sie [GetDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-group.html)in der *AWS CLI Befehlsreferenz*. ### `get-deployment-instance` Das folgende Codebeispiel zeigt die Verwendung`get-deployment-instance`. **AWS CLI** **So rufen Sie Informationen zu einer Bereitstellungs-Instance ab** Im folgenden Beispiel für `get-deployment-instance` werden Informationen zu einer Bereitstellungs-Instance angezeigt, die der angegebenen Anwendung zugeordnet ist. ``` aws deploy get-deployment-instance --deployment-id d-QA4G4F9EX --instance-id i-902e9fEX ``` Ausgabe: ``` { "instanceSummary": { "instanceId": "arn:aws:ec2:us-east-1:80398EXAMPLE:instance/i-902e9fEX", "lifecycleEvents": [ { "status": "Succeeded", "endTime": 1408480726.569, "startTime": 1408480726.437, "lifecycleEventName": "ApplicationStop" }, { "status": "Succeeded", "endTime": 1408480728.016, "startTime": 1408480727.665, "lifecycleEventName": "DownloadBundle" }, { "status": "Succeeded", "endTime": 1408480729.744, "startTime": 1408480729.125, "lifecycleEventName": "BeforeInstall" }, { "status": "Succeeded", "endTime": 1408480730.979, "startTime": 1408480730.844, "lifecycleEventName": "Install" }, { "status": "Failed", "endTime": 1408480732.603, "startTime": 1408480732.1, "lifecycleEventName": "AfterInstall" }, { "status": "Skipped", "endTime": 1408480732.606, "lifecycleEventName": "ApplicationStart" }, { "status": "Skipped", "endTime": 1408480732.606, "lifecycleEventName": "ValidateService" } ], "deploymentId": "d-QA4G4F9EX", "lastUpdatedAt": 1408480733.152, "status": "Failed" } } ``` + Einzelheiten zur API finden Sie [GetDeploymentInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-instance.html)in der *AWS CLI Befehlsreferenz*. ### `get-deployment-target` Das folgende Codebeispiel zeigt die Verwendung`get-deployment-target`. **AWS CLI** **So geben Sie Informationen zu einem Bereitstellungsziel zurück** Im folgenden Beispiel für `get-deployment-target` werden Informationen zu einem Bereitstellungsziel zurückgegeben, das der angegebenen Anwendung zugeordnet ist. ``` aws deploy get-deployment-target \ --deployment-id "d-A1B2C3111" \ --target-id "i-a1b2c3d4e5f611111" ``` Ausgabe: ``` { "deploymentTarget": { "deploymentTargetType": "InstanceTarget", "instanceTarget": { "lastUpdatedAt": 1556918687.504, "targetId": "i-a1b2c3d4e5f611111", "targetArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-a1b2c3d4e5f611111", "status": "Succeeded", "lifecycleEvents": [ { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "ApplicationStop", "startTime": 1556918592.162, "endTime": 1556918592.247 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "DownloadBundle", "startTime": 1556918593.193, "endTime": 1556918593.981 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "BeforeInstall", "startTime": 1556918594.805, "endTime": 1556918681.807 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "Install", "startTime": 1556918682.696, "endTime": 1556918683.005 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "AfterInstall", "startTime": 1556918684.135, "endTime": 1556918684.216 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "ApplicationStart", "startTime": 1556918685.211, "endTime": 1556918685.295 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "ValidateService", "startTime": 1556918686.65, "endTime": 1556918686.747 } ], "deploymentId": "d-A1B2C3111" } } } ``` Weitere Informationen finden Sie unter [GetDeploymentTarget](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeploymentTarget.html) in der *AWS CodeDeploy -API-Referenz*. + Einzelheiten zur API finden Sie [GetDeploymentTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-target.html)in der *AWS CLI Befehlsreferenz*. ### `get-deployment` Das folgende Codebeispiel zeigt die Verwendung`get-deployment`. **AWS CLI** **So rufen Sie Informationen zu einer Bereitstellung ab** Im folgenden `get-deployment` Beispiel werden Informationen zu einer Bereitstellung angezeigt, die dem AWS Konto des Benutzers zugeordnet ist. ``` aws deploy get-deployment --deployment-id d-A1B2C3123 ``` Ausgabe: ``` { "deploymentInfo": { "applicationName": "WordPress_App", "status": "Succeeded", "deploymentOverview": { "Failed": 0, "InProgress": 0, "Skipped": 0, "Succeeded": 1, "Pending": 0 }, "deploymentConfigName": "CodeDeployDefault.OneAtATime", "creator": "user", "description": "My WordPress app deployment", "revision": { "revisionType": "S3", "s3Location": { "bundleType": "zip", "eTag": "\"dd56cfdEXAMPLE8e768f9d77fEXAMPLE\"", "bucket": "amzn-s3-demo-bucket", "key": "WordPressApp.zip" } }, "deploymentId": "d-A1B2C3123", "deploymentGroupName": "WordPress_DG", "createTime": 1409764576.589, "completeTime": 1409764596.101, "ignoreApplicationStopFailures": false } } ``` + Einzelheiten zur API finden Sie [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment.html)unter *AWS CLI Befehlsreferenz*. ### `get-on-premises-instance` Das folgende Codebeispiel zeigt die Verwendung`get-on-premises-instance`. **AWS CLI** **So rufen Sie Informationen zu einer On-Premises-Instance ab** Im folgenden Beispiel für `get-on-premises-instance` werden Informationen zur angegebenen On-Premises-Instance abgerufen. ``` aws deploy get-on-premises-instance --instance-name AssetTag12010298EX ``` Ausgabe: ``` { "instanceInfo": { "iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag12010298EX", "tags": [ { "Value": "CodeDeployDemo-OnPrem", "Key": "Name" } ], "instanceName": "AssetTag12010298EX", "registerTime": 1425579465.228, "instanceArn": "arn:aws:codedeploy:us-east-1:123456789012:instance/AssetTag12010298EX_4IwLNI2Alh" } } ``` + Einzelheiten zur API finden Sie [GetOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-on-premises-instance.html)in der *AWS CLI Befehlsreferenz*. ### `install` Das folgende Codebeispiel zeigt die Verwendung`install`. **AWS CLI** **So installieren Sie eine On-Premises-Instance** Im folgenden `install` Beispiel wird die lokale Konfigurationsdatei vom angegebenen Speicherort auf der Instance an den Speicherort auf der Instance kopiert, von dem der AWS CodeDeploy Agent erwartet, dass er sie findet. Außerdem wird der AWS CodeDeploy Agent auf der Instanz installiert. Es erstellt keinen IAM-Benutzer, registriert die lokale Instanz nicht bei AWS CodeDeploy ihr und ordnet der Instanz auch keine lokalen Instanz-Tags AWS CodeDeploy zu. ``` aws deploy install \ --override-config \ --config-file C:\temp\codedeploy.onpremises.yml \ --region us-west-2 \ --agent-installer s3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msi ``` Ausgabe: ``` Creating the on-premises instance configuration file... DONE Installing the AWS CodeDeploy Agent... DONE ``` + Weitere API-Informationen finden Sie unter [Install](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/install.html) in der *AWS CLI -Befehlsreferenz*. ### `list-application-revisions` Das folgende Codebeispiel zeigt die Verwendung. `list-application-revisions` **AWS CLI** **So rufen Sie Informationen zu Anwendungsrevisionen ab** Im folgenden Beispiel für `list-application-revisions` werden Informationen zu allen Anwendungsrevisionen angezeigt, die der angegebenen Anwendung zugeordnet sind. ``` aws deploy list-application-revisions \ --application-name WordPress_App \ --s-3-bucket amzn-s3-demo-bucket \ --deployed exclude \ --s-3-key-prefix WordPress_ \ --sort-by lastUsedTime \ --sort-order descending ``` Ausgabe: ``` { "revisions": [ { "revisionType": "S3", "s3Location": { "version": "uTecLusvCB_JqHFXtfUcyfV8bEXAMPLE", "bucket": "amzn-s3-demo-bucket", "key": "WordPress_App.zip", "bundleType": "zip" } }, { "revisionType": "S3", "s3Location": { "version": "tMk.UxgDpMEVb7V187ZM6wVAWEXAMPLE", "bucket": "amzn-s3-demo-bucket", "key": "WordPress_App_2-0.zip", "bundleType": "zip" } } ] } ``` + Einzelheiten zur API finden Sie [ListApplicationRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-application-revisions.html)in der *AWS CLI Befehlsreferenz*. ### `list-applications` Das folgende Codebeispiel zeigt die Verwendung`list-applications`. **AWS CLI** **So rufen Sie Informationen zu Anwendungen ab** Im folgenden `list-applications` Beispiel werden Informationen zu allen Anwendungen angezeigt, die dem AWS Konto des Benutzers zugeordnet sind. ``` aws deploy list-applications ``` Ausgabe: ``` { "applications": [ "WordPress_App", "MyOther_App" ] } ``` + Einzelheiten zur API finden Sie [ListApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-applications.html)unter *AWS CLI Befehlsreferenz*. ### `list-deployment-configs` Das folgende Codebeispiel zeigt die Verwendung`list-deployment-configs`. **AWS CLI** **So rufen Sie Informationen zu Bereitstellungskonfigurationen ab** Im folgenden `list-deployment-configs` Beispiel werden Informationen zu allen Bereitstellungskonfigurationen angezeigt, die dem AWS Konto des Benutzers zugeordnet sind. ``` aws deploy list-deployment-configs ``` Ausgabe: ``` { "deploymentConfigsList": [ "ThreeQuartersHealthy", "CodeDeployDefault.AllAtOnce", "CodeDeployDefault.HalfAtATime", "CodeDeployDefault.OneAtATime" ] } ``` + Einzelheiten zur API finden Sie [ListDeploymentConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-configs.html)unter *AWS CLI Befehlsreferenz*. ### `list-deployment-groups` Das folgende Codebeispiel zeigt die Verwendung`list-deployment-groups`. **AWS CLI** **So rufen Sie Informationen zu Bereitstellungsgruppen ab** Im folgenden Beispiel für `list-deployment-groups` werden Informationen zu allen Bereitstellungsgruppen angezeigt, die der angegebenen Anwendung zugeordnet sind. ``` aws deploy list-deployment-groups --application-name WordPress_App ``` Ausgabe: ``` { "applicationName": "WordPress_App", "deploymentGroups": [ "WordPress_DG", "WordPress_Beta_DG" ] } ``` + Einzelheiten zur API finden Sie [ListDeploymentGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-groups.html)in der *AWS CLI Befehlsreferenz*. ### `list-deployment-instances` Das folgende Codebeispiel zeigt die Verwendung`list-deployment-instances`. **AWS CLI** **So rufen Sie Informationen zu Bereitstellungs-Instances ab** Im folgenden Beispiel für `list-deployment-instances` werden Informationen zu allen Bereitstellungs-Instances angezeigt, die der angegebenen Anwendung zugeordnet sind. ``` aws deploy list-deployment-instances \ --deployment-id d-A1B2C3111 \ --instance-status-filter Succeeded ``` Ausgabe: ``` { "instancesList": [ "i-EXAMPLE11", "i-EXAMPLE22" ] } ``` + Einzelheiten zur API finden Sie [ListDeploymentInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-instances.html)in der *AWS CLI Befehlsreferenz*. ### `list-deployment-targets` Das folgende Codebeispiel zeigt die Verwendung`list-deployment-targets`. **AWS CLI** **Um eine Liste von Zielen abzurufen IDs , die einer Bereitstellung zugeordnet sind** Im folgenden `list-deployment-targets` Beispiel wird eine Liste von Zielen abgerufen, die Bereitstellungen IDs zugeordnet sind, die den Status „Fehlgeschlagen“ oder „“ haben. InProgress ``` aws deploy list-deployment-targets \ --deployment-id "d-A1B2C3111" \ --target-filters "{\"TargetStatus\":[\"Failed\",\"InProgress\"]}" ``` Ausgabe: ``` { "targetIds": [ "i-0f1558aaf90e5f1f9" ] } ``` Weitere Informationen finden Sie unter [ListDeploymentTargets](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeploymentTargets.html) in der *AWS CodeDeploy -API-Referenz*. + Einzelheiten zur API finden Sie [ListDeploymentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-targets.html)in der *AWS CLI Befehlsreferenz*. ### `list-deployments` Das folgende Codebeispiel zeigt die Verwendung`list-deployments`. **AWS CLI** **So rufen Sie Informationen zu Bereitstellungen ab** Im folgenden Beispiel für `list-deployments` werden Informationen zu allen Bereitstellungen angezeigt, die der angegebenen Anwendung und Bereitstellungsgruppe zugeordnet sind. ``` aws deploy list-deployments \ --application-name WordPress_App \ --create-time-range start=2014-08-19T00:00:00,end=2014-08-20T00:00:00 \ --deployment-group-name WordPress_DG \ --include-only-statuses Failed ``` Ausgabe: ``` { "deployments": [ "d-EXAMPLE11", "d-EXAMPLE22", "d-EXAMPLE33" ] } ``` + Einzelheiten zur API finden Sie [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployments.html)in der *AWS CLI Befehlsreferenz*. ### `list-git-hub-account-token-names` Das folgende Codebeispiel zeigt die Verwendung`list-git-hub-account-token-names`. **AWS CLI** **Um die Namen der gespeicherten Verbindungen zu GitHub Konten aufzulisten** Im folgenden `list-git-hub-account-token-names` Beispiel werden die Namen der gespeicherten Verbindungen zu GitHub Konten für den aktuellen AWS Benutzer aufgeführt. ``` aws deploy list-git-hub-account-token-names ``` Ausgabe: ``` { "tokenNameList": [ "my-first-token", "my-second-token", "my-third-token" ] } ``` Weitere Informationen finden Sie unter [ListGitHubAccountTokenNames](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListGitHubAccountTokenNames.html) in der *AWS CodeDeploy -API-Referenz*. + Einzelheiten zur API finden Sie [ListGitHubAccountTokenNames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-git-hub-account-token-names.html)unter *AWS CLI Befehlsreferenz*. ### `list-on-premises-instances` Das folgende Codebeispiel zeigt die Verwendung`list-on-premises-instances`. **AWS CLI** **So rufen Sie Informationen zu einzelnen oder mehreren On-Premises-Instances ab** Im folgenden `list-on-premises-instances` Beispiel wird eine Liste verfügbarer lokaler Instanznamen für Instanzen abgerufen, die registriert sind AWS CodeDeploy und denen auch das angegebene lokale Instanz-Tag zugeordnet ist. AWS CodeDeploy ``` aws deploy list-on-premises-instances \ --registration-status Registered \ --tag-filters Key=Name,Value=CodeDeployDemo-OnPrem,Type=KEY_AND_VALUE ``` Ausgabe: ``` { "instanceNames": [ "AssetTag12010298EX" ] } ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz [ListOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-on-premises-instances.html).AWS CLI * ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für eine Ressource (Anwendung) auf)** Das folgende `list-tags-for-resource` Beispiel listet die Tags auf, die auf eine Anwendung namens TestApp in CodeDeploy angewendet wurden. ``` aws deploy list-tags-for-resource \ --resource-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp ``` Ausgabe: ``` { "Tags": [ { "Key": "Type", "Value": "testType" }, { "Key": "Name", "Value": "testName" } ] } ``` Weitere Informationen finden Sie [im CodeDeploy *AWS CodeDeploy Benutzerhandbuch* unter Tagging Instances für Deployment-Gruppen](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html). + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `push` Das folgende Codebeispiel zeigt die Verwendung`push`. **AWS CLI** **Um eine AWS CodeDeploy kompatible Anwendungsrevision für Amazon S3 zu bündeln und bereitzustellen** Im folgenden Beispiel für `push` wird eine Anwendungsrevision für Amazon S3 gebündelt, bereitgestellt und dann wird die Anwendungsrevision der angegebenen Anwendung zugeordnet. ``` aws deploy push \ --application-name WordPress_App \ --description "This is my deployment" \ --ignore-hidden-files \ --s3-location s3://amzn-s3-demo-bucket/WordPressApp.zip \ --source /tmp/MyLocalDeploymentFolder/ ``` In der Ausgabe wird beschrieben, wie der `create-deployment`-Befehl verwendet wird, um eine Bereitstellung zu erstellen, die die hochgeladene Anwendungsversion verwendet. ``` To deploy with this revision, run: aws deploy create-deployment --application-name WordPress_App --deployment-config-name --deployment-group-name --s3-location bucket=amzn-s3-demo-bucket,key=WordPressApp.zip,bundleType=zip,eTag="cecc9b8EXAMPLE50a6e71fdb88EXAMPLE",version=LFsJAUdEXAMPLEfvKtvi79L8EXAMPLE ``` + Weitere API-Informationen finden Sie unter [Push](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/push.html) in der *AWS CLI -Befehlsreferenz*. ### `register-application-revision` Das folgende Codebeispiel zeigt, wie Sie es verwenden`register-application-revision`. **AWS CLI** **So registrieren Sie Informationen zu einer bereits hochgeladenen Anwendungsrevision** Das folgende `register-application-revision` Beispiel registriert Informationen über eine bereits hochgeladene Anwendungsrevision, die in Amazon S3 gespeichert ist, mit. AWS CodeDeploy ``` aws deploy register-application-revision \ --application-name WordPress_App \ --description "Revised WordPress application" \ --s3-location bucket=amzn-s3-demo-bucket,key=RevisedWordPressApp.zip,bundleType=zip,eTag=cecc9b8a08eac650a6e71fdb88EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie unter [RegisterApplicationRevision AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register-application-revision.html)*Befehlsreferenz*. ### `register-on-premises-instance` Das folgende Codebeispiel zeigt die Verwendung`register-on-premises-instance`. **AWS CLI** **So registrieren Sie eine On-Premises-Instance** Im folgenden `register-on-premises-instance` Beispiel wird eine lokale Instanz bei AWS CodeDeploy registriert. Es erstellt weder den angegebenen IAM-Benutzer noch ordnet es der AWS CodeDeploy registrierten Instanz in lokalen Instanzen Tags zu. ``` aws deploy register-on-premises-instance \ --instance-name AssetTag12010298EX \ --iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser-OnPrem ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [RegisterOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register-on-premises-instance.html)in der *AWS CLI Befehlsreferenz*. ### `register` Das folgende Codebeispiel zeigt die Verwendung`register`. **AWS CLI** **So registrieren Sie eine On-Premises-Instance** Das folgende `register` Beispiel registriert eine lokale Instanz bei AWS CodeDeploy, ordnet AWS CodeDeploy das angegebene lokale Instanz-Tag der registrierten Instanz zu und erstellt eine lokale Konfigurationsdatei, die in die Instanz kopiert werden kann. Es erstellt weder den IAM-Benutzer noch installiert es den AWS CodeDeploy Agenten auf der Instanz. ``` aws deploy register \ --instance-name AssetTag12010298EX \ --iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployUser-OnPrem \ --tags Key=Name,Value=CodeDeployDemo-OnPrem \ --region us-west-2 ``` Ausgabe: ``` Registering the on-premises instance... DONE Adding tags to the on-premises instance... DONE Copy the on-premises configuration file named codedeploy.onpremises.yml to the on-premises instance, and run the following command on the on-premises instance to install and configure the AWS CodeDeploy Agent: aws deploy install --config-file codedeploy.onpremises.yml ``` + Weitere API-Informationen finden Sie unter [Register](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register.html) in der *AWS CLI -Befehlsreferenz*. ### `remove-tags-from-on-premises-instances` Das folgende Codebeispiel zeigt die Verwendung`remove-tags-from-on-premises-instances`. **AWS CLI** **So entfernen Sie Tags aus einzelnen oder mehreren On-Premises-Instances** Im folgenden `remove-tags-from-on-premises-instances` Beispiel wird die Zuordnung der angegebenen On-Premises-Tags zu lokalen AWS CodeDeploy Instanzen aufgehoben. Es wird weder die Registrierung der lokalen Instances in AWS CodeDeploy der Instance aufgehoben noch der AWS CodeDeploy Agent von der Instance deinstalliert, noch wird die lokale Konfigurationsdatei aus den Instances entfernt, noch werden die IAM-Benutzer gelöscht, die den Instances zugeordnet sind. ``` aws deploy remove-tags-from-on-premises-instances \ --instance-names AssetTag12010298EX AssetTag23121309EX \ --tags Key=Name,Value=CodeDeployDemo-OnPrem ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [RemoveTagsFromOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/remove-tags-from-on-premises-instances.html)AWS CLI * ### `stop-deployment` Das folgende Codebeispiel zeigt die Verwendung`stop-deployment`. **AWS CLI** **So versuchen Sie, eine Bereitstellung zu beenden** Im folgenden `stop-deployment` Beispiel wird versucht, eine laufende Bereitstellung zu beenden, die dem AWS Konto des Benutzers zugeordnet ist. aws deploy stop-deployment --deployment-id d-A1B2C3111 Ausgabe: ``` { "status": "Succeeded", "statusMessage": "No more commands will be scheduled for execution in the deployment instances" } ``` + Einzelheiten zur API finden Sie unter [StopDeployment AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/stop-deployment.html)*Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Um eine Ressource (Anwendung) zu taggen** Im folgenden `tag-resource` Beispiel werden zwei Tags mit den Schlüsseln Name und Type sowie den Werten TestName und TestType zu einer Anwendung namens TestApp in hinzugefügt. CodeDeploy : ``` aws deploy tag-resource \ --resource-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp \ --tags Key=Name,Value=testName Key=Type,Value=testType ``` Wenn er erfolgreich ist, erzeugt dieser Befehl keine Ausgabe. Weitere Informationen finden Sie unter [Tagging Instances für Deployment-Gruppen CodeDeploy im AWS](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) *CodeDeploy Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `uninstall` Das folgende Codebeispiel zeigt die Verwendung`uninstall`. **AWS CLI** **So deinstallieren Sie eine On-Premises-Instance** Im folgenden `uninstall` Beispiel wird der AWS CodeDeploy Agent von der lokalen Instanz deinstalliert und die lokale Konfigurationsdatei aus der Instanz entfernt. Es wird weder die Instance in der Instance deregistriert AWS CodeDeploy, noch die Zuordnung der lokalen Instance-Tags AWS CodeDeploy von der Instance getrennt, noch wird der IAM-Benutzer gelöscht, der der Instanz zugeordnet ist. ``` aws deploy uninstall ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Weitere API-Informationen finden Sie unter [Uninstall](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/uninstall.html) in der *AWS CLI -Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung. `untag-resource` **AWS CLI** **So entfernen Sie Tags aus einer Ressource (Anwendung)** Im folgenden `untag-resource` Beispiel werden zwei Tags mit den Schlüsseln Name und Type aus einer Anwendung namens TestApp in CodeDeploy entfernt. ``` aws deploy untag-resource \ --resource-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp \ --tag-keys Name Type ``` Wenn er erfolgreich ist, erzeugt dieser Befehl keine Ausgabe. Weitere Informationen finden Sie [im CodeDeploy *AWS CodeDeploy Benutzerhandbuch* unter Tagging Instances für Deployment-Gruppen](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html). + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-application` Das folgende Codebeispiel zeigt die Verwendung`update-application`. **AWS CLI** **So ändern Sie die Details einer Anwendung** Im folgenden `update-application` Beispiel wird der Name einer Anwendung geändert, die dem AWS Konto des Benutzers zugeordnet ist. ``` aws deploy update-application \ --application-name WordPress_App \ --new-application-name My_WordPress_App ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/update-application.html)unter *AWS CLI Befehlsreferenz*. ### `update-deployment-group` Das folgende Codebeispiel zeigt die Verwendung`update-deployment-group`. **AWS CLI** **So ändern Sie Informationen zu einer Bereitstellungsgruppe** Im folgenden Beispiel für `update-deployment-group` werden die Einstellungen einer Bereitstellungsgruppe geändert, die der angegebenen Anwendung zugeordnet ist. ``` aws deploy update-deployment-group \ --application-name WordPress_App \ --auto-scaling-groups My_CodeDeployDemo_ASG \ --current-deployment-group-name WordPress_DG \ --deployment-config-name CodeDeployDefault.AllAtOnce \ --ec2-tag-filters Key=Name,Type=KEY_AND_VALUE,Value=My_CodeDeployDemo \ --new-deployment-group-name My_WordPress_DepGroup \ --service-role-arn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo-2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UpdateDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/update-deployment-group.html)in der *AWS CLI Befehlsreferenz*. # CodeGuru Beispiele für Reviewer mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with CodeGuru Reviewer Aktionen ausführen und gängige Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-repository` Das folgende Codebeispiel zeigt, wie Sie`associate-repository`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Bitbucket-Repository-Zuordnung** Im folgenden Beispiel für `associate-repository` wird eine Repository-Zuordnung mithilfe eines vorhandenen Bitbucket-Repositorys erstellt. ``` aws codeguru-reviewer associate-repository \ --repository 'Bitbucket={Owner=sample-owner, Name=mySampleRepo, ConnectionArn=arn:aws:codestar-connections:us-west-2:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 }' ``` Ausgabe: ``` { "RepositoryAssociation": { "ProviderType": "Bitbucket", "Name": "mySampleRepo", "LastUpdatedTimeStamp": 1596216896.979, "AssociationId": "association:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "CreatedTimeStamp": 1596216896.979, "ConnectionArn": "arn:aws:codestar-connections:us-west-2:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "State": "Associating", "StateReason": "Pending Repository Association", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "Owner": "sample-owner" } } ``` Weitere Informationen finden Sie unter [Eine Bitbucket-Repository-Verknüpfung in Amazon CodeGuru Reviewer erstellen](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/create-bitbucket-association.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. **Beispiel 2: So erstellen Sie eine GitHub Enterprise-Repository-Zuordnung** Das folgende `associate-repository` Beispiel erstellt eine Repository-Zuordnung unter Verwendung eines vorhandenen GitHub Enterprise-Repositorys. ``` aws codeguru-reviewer associate-repository \ --repository 'GitHubEnterpriseServer={Owner=sample-owner, Name=mySampleRepo, ConnectionArn=arn:aws:codestar-connections:us-west-2:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 }' ``` Ausgabe: ``` { "RepositoryAssociation": { "ProviderType": "GitHubEnterpriseServer", "Name": "mySampleRepo", "LastUpdatedTimeStamp": 1596216896.979, "AssociationId": "association:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "CreatedTimeStamp": 1596216896.979, "ConnectionArn": "arn:aws:codestar-connections:us-west-2:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "State": "Associating", "StateReason": "Pending Repository Association", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "Owner": "sample-owner" } } ``` Weitere Informationen finden Sie unter [Erstellen einer GitHub Enterprise Server-Repository-Zuordnung in Amazon CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/create-github-enterprise-association.html) im *Amazon Codeguru Reviewer-Benutzerhandbuch*. **Beispiel 3: So erstellen Sie eine AWS CodeCommit Repository-Zuordnung** Das folgende `associate-repository` Beispiel erstellt eine Repository-Zuordnung unter Verwendung eines vorhandenen AWS CodeCommit Repositorys. ``` aws codeguru-reviewer associate-repository \ --repository CodeCommit={Name=mySampleRepo} ``` Ausgabe: ``` { "RepositoryAssociation": { "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Name": "My-ecs-beta-repo", "LastUpdatedTimeStamp": 1595634764.029, "ProviderType": "CodeCommit", "CreatedTimeStamp": 1595634764.029, "Owner": "544120495673", "State": "Associating", "StateReason": "Pending Repository Association", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:544120495673:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } } ``` Weitere Informationen finden Sie unter [Erstellen einer AWS CodeCommit Repository-Verknüpfung in Amazon CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/create-codecommit-association.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AssociateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/associate-repository.html)unter *AWS CLI Befehlsreferenz*. ### `create-code-review` Das folgende Codebeispiel zeigt die Verwendung`create-code-review`. **AWS CLI** **So erstellen eine Codeüberprüfung.** Im Folgenden `create-code-review` wird eine Überprüfung des Codes in der benannten `mainline` Verzweigung eines AWS CodeCommit Repositorys erstellt`my-repository-name`. ``` aws codeguru-reviewer create-code-review \ --name my-code-review \ --repository-association-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --type '{"RepositoryAnalysis": {"RepositoryHead": {"BranchName": "mainline"}}}' ``` Ausgabe: ``` { "CodeReview": { "Name": "my-code-review", "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222:code-review:RepositoryAnalysis-my-code-review", "RepositoryName": "my-repository-name", "Owner": "123456789012", "ProviderType": "CodeCommit", "State": "Pending", "StateReason": "CodeGuru Reviewer has received the request, and a code review is scheduled.", "CreatedTimeStamp": 1618873489.195, "LastUpdatedTimeStamp": 1618873489.195, "Type": "RepositoryAnalysis", "SourceCodeType": { "RepositoryHead": { "BranchName": "mainline" } }, "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } } ``` Weitere Informationen finden Sie unter [Code-Rezensionen in Amazon CodeGuru Reviewer erstellen](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/create-code-reviews.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateCodeReview](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/create-code-review.html)in der *AWS CLI Befehlsreferenz*. ### `describe-code-review` Das folgende Codebeispiel zeigt die Verwendung`describe-code-review`. **AWS CLI** **Auflisten von Details zu einer Codeüberprüfung.** Im Folgenden `describe-code-review` werden Informationen zur Überprüfung des Codes im Zweig „mainline“ eines AWS CodeCommit Repositorys mit dem Namen "my-repo-name" aufgeführt. ``` aws codeguru-reviewer put-recommendation-feedback \ --code-review-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:code-review:RepositoryAnalysis-my-repository-name-branch-abcdefgh12345678 \ --recommendation-id 3be1b2e5d7ef6e298a06499379ee290c9c596cf688fdcadb08285ddb0dd390eb \ --reactions ThumbsUp ``` Ausgabe ``` { "CodeReview": { "Name": "My-ecs-beta-repo-master-xs6di4kfd4j269dz", "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222:code-review:RepositoryAnalysis-my-repo-name", "RepositoryName": "My-ecs-beta-repo", "Owner": "123456789012", "ProviderType": "CodeCommit", "State": "Pending", "StateReason": "CodeGuru Reviewer is reviewing the source code.", "CreatedTimeStamp": 1618874226.226, "LastUpdatedTimeStamp": 1618874233.689, "Type": "RepositoryAnalysis", "SourceCodeType": { "RepositoryHead": { "BranchName": "mainline" } }, "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } } ``` Weitere Informationen finden Sie unter [Details zur Codeüberprüfung anzeigen](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/view-code-review-details.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeCodeReview](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/describe-code-review.html)in der *AWS CLI Befehlsreferenz*. ### `describe-recommendation-feedback` Das folgende Codebeispiel zeigt die Verwendung`describe-recommendation-feedback`. **AWS CLI** **So zeigen Sie Informationen zu Feedback für eine Empfehlung an** Mit dem folgenden `describe-recommendation-feedback`-Befehl werden Informationen zu Feedback für eine Empfehlung angezeigt. Diese Empfehlung hat eine `ThumbsUp`-Reaktion. ``` aws codeguru-reviewer describe-recommendation-feedback \ --code-review-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:code-review:RepositoryAnalysis-my-repository-name-branch-abcdefgh12345678 \ --recommendation-id 3be1b2e5d7ef6e298a06499379ee290c9c596cf688fdcadb08285ddb0dd390eb ``` Ausgabe: ``` { "RecommendationFeedback": { "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:code-review:RepositoryAnalysis-my-repository-name-branch-abcdefgh12345678", "RecommendationId": "3be1b2e5d7ef6e298a06499379ee290c9c596cf688fdcadb08285ddb0dd390eb", "Reactions": [ "ThumbsUp" ], "UserId": "aws-user-id", "CreatedTimeStamp": 1618877070.313, "LastUpdatedTimeStamp": 1618877948.881 } } ``` Weitere Informationen finden Sie unter [Empfehlungen anzeigen und Feedback geben](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/give-feedback-from-code-review-details.html) und [Schritt 4: Feedback geben](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/provide-feedback.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeRecommendationFeedback](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/describe-recommendation-feedback.html)in der *AWS CLI Befehlsreferenz*. ### `describe-repository-association` Das folgende Codebeispiel zeigt die Verwendung`describe-repository-association`. **AWS CLI** **Beispiel 1: Um Informationen über eine GitHub Repository-Zuordnung zurückzugeben** Das folgende `describe-repository-association` Beispiel gibt Informationen über eine Repository-Zuordnung zurück, die ein GitHub Enterprise-Repository verwendet und sich im `Associated` Status befindet. ``` aws codeguru-reviewer describe-repository-association \ --association-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "RepositoryAssociation": { "AssociationId": "b822717e-0711-4e8a-bada-0e738289c75e", "Name": "mySampleRepo", "LastUpdatedTimeStamp": 1588102637.649, "ProviderType": "GitHub", "CreatedTimeStamp": 1588102615.636, "Owner": "sample-owner", "State": "Associated", "StateReason": "Pull Request Notification configuration successful", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } } ``` Weitere Informationen finden Sie unter [Erstellen einer GitHub Enterprise Server-Repository-Zuordnung in Amazon CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/create-github-enterprise-association.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. **Beispiel 2: So geben Sie Informationen zu einer fehlgeschlagenen Repository-Zuordnung zurück** Das folgende `describe-repository-association` Beispiel gibt Informationen über eine Repository-Zuordnung zurück, die ein GitHub Enterprise-Repository verwendet und sich im `Failed` Status befindet. ``` aws codeguru-reviewer describe-repository-association \ --association-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "RepositoryAssociation": { "ProviderType": "GitHubEnterpriseServer", "Name": "mySampleRepo", "LastUpdatedTimeStamp": 1596217036.892, "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "CreatedTimeStamp": 1596216896.979, "ConnectionArn": "arn:aws:codestar-connections:us-west-2:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "State": "Failed", "StateReason": "Failed, Please retry.", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "Owner": "sample-owner" } } ``` Weitere Informationen finden Sie unter [Erstellen einer GitHub Enterprise Server-Repository-Zuordnung in Amazon CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/create-github-enterprise-association.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. **Beispiel 3: So geben Sie Informationen zu einer Repository-Zuordnung zurück, die getrennt wird** Das folgende `describe-repository-association` Beispiel gibt Informationen über eine Repository-Zuordnung zurück, die ein GitHub Enterprise-Repository verwendet und sich im `Disassociating` Status befindet. ``` aws codeguru-reviewer describe-repository-association \ --association-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "RepositoryAssociation": { "ProviderType": "GitHubEnterpriseServer", "Name": "mySampleRepo", "LastUpdatedTimeStamp": 1596217036.892, "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "CreatedTimeStamp": 1596216896.979, "ConnectionArn": "arn:aws:codestar-connections:us-west-2:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "State": "Disassociating", "StateReason": "Source code access removal in progress", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "Owner": "sample-owner" } } ``` Weitere Informationen finden Sie unter [Erstellen einer GitHub Enterprise Server-Repository-Zuordnung in Amazon CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/create-github-enterprise-association.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeRepositoryAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/describe-repository-association.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-repository` Das folgende Codebeispiel zeigt die Verwendung`disassociate-repository`. **AWS CLI** **So heben Sie die Zuordnung einer Repository-Verknüpfung auf** Im Folgenden wird `disassociate-repository` die Zuordnung einer Repository-Verknüpfung aufgehoben, die ein AWS CodeCommit Repository verwendet. ``` aws codeguru-reviewer disassociate-repository \ --association-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "RepositoryAssociation": { "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Name": "my-repository", "Owner": "123456789012", "ProviderType": "CodeCommit", "State": "Disassociating", "LastUpdatedTimeStamp": 1618939174.759, "CreatedTimeStamp": 1595636947.096 }, "Tags": { "Status": "Secret", "Team": "Saanvi" } } ``` Weitere Informationen finden Sie unter [Zuordnung eines Repositorys in CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/disassociate-repository-association.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DisassociateRepository AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/disassociate-repository.html)*Befehlsreferenz.* ### `list-code-reviews` Das folgende Codebeispiel zeigt die Verwendung`list-code-reviews`. **AWS CLI** **Um Code-Rezensionen aufzulisten, die in den letzten 90 Tagen in Ihrem AWS Konto erstellt wurden.** Im folgenden Beispiel für `list-code-reviews` werden die in den letzten 90 Tagen erstellten Codeüberprüfungen mithilfe von Pull-Anforderungen aufgelistet. ``` aws codeguru-reviewer list-code-reviews \ --type PullRequest ``` Ausgabe: ``` { "CodeReviewSummaries": [ { "LastUpdatedTimeStamp": 1588897288.054, "Name": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "ProviderType": "GitHub", "PullRequestId": "5", "MetricsSummary": { "MeteredLinesOfCodeCount": 24, "FindingsCount": 1 }, "CreatedTimeStamp": 1588897068.512, "State": "Completed", "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:code-review:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Owner": "sample-owner", "RepositoryName": "sample-repository-name", "Type": "PullRequest" }, { "LastUpdatedTimeStamp": 1588869793.263, "Name": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "ProviderType": "GitHub", "PullRequestId": "4", "MetricsSummary": { "MeteredLinesOfCodeCount": 29, "FindingsCount": 0 }, "CreatedTimeStamp": 1588869575.949, "State": "Completed", "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:code-review:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "Owner": "sample-owner", "RepositoryName": "sample-repository-name", "Type": "PullRequest" }, { "LastUpdatedTimeStamp": 1588870511.211, "Name": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ProviderType": "GitHub", "PullRequestId": "4", "MetricsSummary": { "MeteredLinesOfCodeCount": 2, "FindingsCount": 0 }, "CreatedTimeStamp": 1588870292.425, "State": "Completed", "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:code-review:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "Owner": "sample-owner", "RepositoryName": "sample-repository-name", "Type": "PullRequest" }, { "LastUpdatedTimeStamp": 1588118522.452, "Name": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "ProviderType": "GitHub", "PullRequestId": "3", "MetricsSummary": { "MeteredLinesOfCodeCount": 29, "FindingsCount": 0 }, "CreatedTimeStamp": 1588118301.131, "State": "Completed", "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:code-review:a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "Owner": "sample-owner", "RepositoryName": "sample-repository-name", "Type": "PullRequest" }, { "LastUpdatedTimeStamp": 1588112205.207, "Name": "a1b2c3d4-5678-90ab-cdef-EXAMPLE55555", "ProviderType": "GitHub", "PullRequestId": "2", "MetricsSummary": { "MeteredLinesOfCodeCount": 25, "FindingsCount": 0 }, "CreatedTimeStamp": 1588111987.443, "State": "Completed", "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:code-review:a1b2c3d4-5678-90ab-cdef-EXAMPLE55555", "Owner": "sample-owner", "RepositoryName": "sample-repository-name", "Type": "PullRequest" }, { "LastUpdatedTimeStamp": 1588104489.981, "Name": "a1b2c3d4-5678-90ab-cdef-EXAMPLE66666", "ProviderType": "GitHub", "PullRequestId": "1", "MetricsSummary": { "MeteredLinesOfCodeCount": 25, "FindingsCount": 0 }, "CreatedTimeStamp": 1588104270.223, "State": "Completed", "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:code-review:a1b2c3d4-5678-90ab-cdef-EXAMPLE66666", "Owner": "sample-owner", "RepositoryName": "sample-repository-name", "Type": "PullRequest" } ] } ``` Weitere Informationen finden Sie unter [Alle Code-Rezensionen anzeigen](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/view-all-code-reviews.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListCodeReviews](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/list-code-reviews.html)in der *AWS CLI Befehlsreferenz*. ### `list-recommendation-feedback` Das folgende Codebeispiel zeigt die Verwendung`list-recommendation-feedback`. **AWS CLI** **So listen Sie Kundenfeedback für eine Empfehlung in einem zugehörigen Repository auf** Mit dem folgenden `list-recommendation-feedback`-Befehl wird Kundenfeedback zu allen Empfehlungen im Rahmen einer Codeüberprüfung aufgelistet. Diese Codeüberprüfung enthält ein Feedback, ein "ThumbsUp„, von einem Kunden. ``` aws codeguru-reviewer list-recommendation-feedback \ --code-review-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:code-review:RepositoryAnalysis-my-repository-name-branch-abcdefgh12345678 ``` Ausgabe: ``` { "RecommendationFeedbackSummaries": [ { "RecommendationId": "3be1b2e5d7ef6e298a06499379ee290c9c596cf688fdcadb08285ddb0dd390eb", "Reactions": [ "ThumbsUp" ], "UserId": "aws-user-id" } ] } ``` Weitere Informationen finden Sie unter [Schritt 4: Feedback geben](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/provide-feedback.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListRecommendationFeedback](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/list-recommendation-feedback.html)in der *AWS CLI Befehlsreferenz*. ### `list-recommendations` Das folgende Codebeispiel zeigt die Verwendung`list-recommendations`. **AWS CLI** **So listen Sie die Empfehlungen für eine abgeschlossene Codeüberprüfung auf** Im folgenden `list-recommendations` Beispiel werden die Empfehlungen für eine abgeschlossene Codeüberprüfung aufgeführt. Diese Codeüberprüfung enthält eine Empfehlung. ``` aws codeguru-reviewer list-recommendations \ --code-review-arn arn:aws:codeguru-reviewer:us-west-2:544120495673:code-review:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "RecommendationSummaries": [ { "Description": "\n\n**Problem** \n You are using a `ConcurrentHashMap`, but your usage of `containsKey()` and `get()` may not be thread-safe at lines: **63 and 64**. In between the check and the `get()` another thread can remove the key and the `get()` will return `null`. The remove that can remove the key is at line: **59**.\n\n**Fix** \n Consider calling `get()`, checking instead of your current check if the returned object is `null`, and then using that object only, without calling `get()` again.\n\n**More info** \n [View an example on GitHub](https://github.com/apache/hadoop/blob/f16cf877e565084c66bc63605659b157c4394dc8/hadoop-tools/hadoop-aws/src/main/java/org/apache/hadoop/fs/s3a/s3guard/S3Guard.java#L302-L304) (external link).", "RecommendationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "StartLine": 63, "EndLine": 64, "FilePath": "src/main/java/com/company/sample/application/CreateOrderThread.java" } ] } ``` Weitere Informationen finden Sie unter [Schritt 4: Feedback geben](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/provide-feedback.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListRecommendations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/list-recommendations.html)in der *AWS CLI Befehlsreferenz*. ### `list-repository-associations` Das folgende Codebeispiel zeigt die Verwendung`list-repository-associations`. **AWS CLI** **Um die Repository-Verknüpfungen in Ihrem AWS Konto aufzulisten** Im folgenden Beispiel für `list-repository-associations` wird eine Liste von Zusammenfassungsobjekten für Repository-Zuordnungen in Ihrem Konto zurückgegeben. Sie können die zurückgegebene Liste nach `ProviderType`, `Name`, `State` und `Owner` filtern. ``` aws codeguru-reviewer list-repository-associations ``` Ausgabe: ``` { "RepositoryAssociationSummaries": [ { "LastUpdatedTimeStamp": 1595886609.616, "Name": "test", "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Owner": "sample-owner", "State": "Associated", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "ProviderType": "Bitbucket" }, { "LastUpdatedTimeStamp": 1595636969.035, "Name": "CodeDeploy-CodePipeline-ECS-Tutorial", "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "Owner": "123456789012", "State": "Associated", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "ProviderType": "CodeCommit" }, { "LastUpdatedTimeStamp": 1595634785.983, "Name": "My-ecs-beta-repo", "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "Owner": "123456789012", "State": "Associated", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ProviderType": "CodeCommit" }, { "LastUpdatedTimeStamp": 1590712811.77, "Name": "MyTestCodeCommit", "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "Owner": "123456789012", "State": "Associated", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "ProviderType": "CodeCommit" }, { "LastUpdatedTimeStamp": 1588102637.649, "Name": "aws-codeguru-profiler-sample-application", "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE55555", "Owner": "sample-owner", "State": "Associated", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE55555", "ProviderType": "GitHub" }, { "LastUpdatedTimeStamp": 1588028233.995, "Name": "codeguru-profiler-demo-app", "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE66666", "Owner": "sample-owner", "State": "Associated", "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE66666", "ProviderType": "GitHub" } ] } ``` Weitere Informationen finden Sie unter [Alle Repository-Verknüpfungen in CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/repository-association-view-all.html) anzeigen im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListRepositoryAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/list-repository-associations.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags für ein zugeordnetes Repository auf** Der folgende `list-tags-for-resource`-Befehl listet die Tags für ein zugeordnetes Repository auf. Dieses zugehörige Repository hat zwei Tags. ``` aws codeguru-reviewer list-tags-for-resource \ --resource-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "Tags": { "Status": "Secret", "Team": "Saanvi" } } ``` Weitere Informationen finden Sie unter [Tags für ein mit CodeGuru Reviewer verbundenes Repository (AWS CLI) anzeigen](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/how-to-tag-associated-repository-view-cli.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-recommendation-feedback` Das folgende Codebeispiel zeigt die Verwendung`put-recommendation-feedback`. **AWS CLI** **So fügen Sie eine Empfehlung zu einer Codeüberprüfung hinzu** Mit dem folgenden `put-recommendation-feedback`-Befehl wird einer Codeüberprüfung eine `ThumbsUp`-Empfehlung hinzugefügt. ``` aws codeguru-reviewer put-recommendation-feedback \ --code-review-arn \arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:code-review:RepositoryAnalysis-my-repository-name-branch-abcdefgh12345678 \ --recommendation-id 3be1b2e5d7ef6e298a06499379ee290c9c596cf688fdcadb08285ddb0dd390eb \ --reactions ThumbsUp ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schritt 4: Feedback geben](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/provide-feedback.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutRecommendationFeedback](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/put-recommendation-feedback.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie ein Tag zu einem zugeordneten Repository hinzu** Der folgende `tag-resource`-Befehl fügt einem zugeordneten Repository zwei Tags hinzu. ``` aws codeguru-reviewer tag-resource \ --resource-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --tags Status=Secret,Team=Saanvi ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen eines Tags zu einem CodeGuru Reviewer-assoziierten Repository (AWS CLI)](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/how-to-tag-associated-repository-add-cli.html) und [Hinzufügen oder Aktualisieren von Tags für ein CodeGuru Reviewer-assoziiertes Repository (AWS CLI)](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/how-to-tag-associated-repository-update-cli.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einem zugeordneten Repository** Mit dem folgenden `untag-resource`-Befehl werden zwei Tags mit den Schlüsseln „Secret“ und „Team“ aus einem zugehörigen Repository entfernt. ``` aws codeguru-reviewer untag-resource \ --resource-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --tag-keys Status Team ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tags aus einem mit CodeGuru Reviewer verknüpften Repository (AWS CLI) entfernen](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/how-to-tag-associated-repository-remove-cli.html) im *Amazon CodeGuru Reviewer-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeguru-reviewer/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # CodePipeline Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CodePipeline. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `acknowledge-job` Das folgende Codebeispiel zeigt, wie Sie`acknowledge-job`. **AWS CLI** **So rufen Sie Informationen zu einem angegebenen Auftrag ab** In diesem Beispiel werden Informationen zu einem angegebenen Auftrag zurückgegeben, einschließlich des Status dieses Jobs, falls vorhanden. Dieser Befehl wird nur für Auftragsworker und benutzerdefinierte Aktionen verwendet. Verwenden Sie aws poll-for-jobs codepipeline, um den Wert von nonce und die Job-ID zu ermitteln. Befehl: ``` aws codepipeline acknowledge-job --job-id f4f4ff82-2d11-EXAMPLE --nonce 3 ``` Ausgabe: ``` { "status": "InProgress" } ``` + Einzelheiten zur API finden Sie [AcknowledgeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/acknowledge-job.html)in der *AWS CLI Befehlsreferenz*. ### `create-custom-action-type` Das folgende Codebeispiel zeigt die Verwendung`create-custom-action-type`. **AWS CLI** **So erstellen Sie eine benutzerdefinierte Aktion** In diesem Beispiel wird eine benutzerdefinierte Aktion für die AWS CodePipeline Verwendung einer bereits erstellten JSON-Datei (hier MyCustomAction .json genannt) erstellt, die die Struktur der benutzerdefinierten Aktion enthält. Weitere Informationen zu den Anforderungen für die Erstellung einer benutzerdefinierten Aktion, einschließlich der Struktur der Datei, finden Sie im AWS CodePipeline Benutzerhandbuch. ``` aws codepipeline create-custom-action-type --cli-input-json file://MyCustomAction.json ``` Inhalt der JSON-Datei `MyCustomAction.json`: ``` { "category": "Build", "provider": "MyJenkinsProviderName", "version": "1", "settings": { "entityUrlTemplate": "https://192.0.2.4/job/{Config:ProjectName}/", "executionUrlTemplate": "https://192.0.2.4/job/{Config:ProjectName}/lastSuccessfulBuild/{ExternalExecutionId}/" }, "configurationProperties": [ { "name": "MyJenkinsExampleBuildProject", "required": true, "key": true, "secret": false, "queryable": false, "description": "The name of the build project must be provided when this action is added to the pipeline.", "type": "String" } ], "inputArtifactDetails": { "maximumCount": 1, "minimumCount": 0 }, "outputArtifactDetails": { "maximumCount": 1, "minimumCount": 0 } } ``` Dieser Befehl gibt die Struktur der benutzerdefinierten Aktion zurück. + Einzelheiten zur API finden Sie [CreateCustomActionType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/create-custom-action-type.html)in der *AWS CLI Befehlsreferenz*. ### `create-pipeline` Das folgende Codebeispiel zeigt die Verwendung`create-pipeline`. **AWS CLI** **Um eine Pipeline zu erstellen** In diesem Beispiel wird eine Pipeline AWS CodePipeline unter Verwendung einer bereits erstellten JSON-Datei (hier MySecondPipeline .json genannt) erstellt, die die Struktur der Pipeline enthält. Weitere Informationen zu den Anforderungen für die Erstellung einer Pipeline, einschließlich der Struktur der Datei, finden Sie im AWS CodePipeline Benutzerhandbuch. Befehl: ``` aws codepipeline create-pipeline --cli-input-json file://MySecondPipeline.json ``` Beispielinhalt für die JSON-Datei: ``` { "pipeline": { "roleArn": "arn:aws:iam::111111111111:role/AWS-CodePipeline-Service", "stages": [ { "name": "Source", "actions": [ { "inputArtifacts": [], "name": "Source", "actionTypeId": { "category": "Source", "owner": "AWS", "version": "1", "provider": "S3" }, "outputArtifacts": [ { "name": "MyApp" } ], "configuration": { "S3Bucket": "awscodepipeline-demo-bucket", "S3ObjectKey": "aws-codepipeline-s3-aws-codedeploy_linux.zip" }, "runOrder": 1 } ] }, { "name": "Beta", "actions": [ { "inputArtifacts": [ { "name": "MyApp" } ], "name": "CodePipelineDemoFleet", "actionTypeId": { "category": "Deploy", "owner": "AWS", "version": "1", "provider": "CodeDeploy" }, "outputArtifacts": [], "configuration": { "ApplicationName": "CodePipelineDemoApplication", "DeploymentGroupName": "CodePipelineDemoFleet" }, "runOrder": 1 } ] } ], "artifactStore": { "type": "S3", "location": "codepipeline-us-east-1-11EXAMPLE11" }, "name": "MySecondPipeline", "version": 1 } } ``` Ausgabe: ``` This command returns the structure of the pipeline. ``` + Einzelheiten zur API finden Sie [CreatePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/create-pipeline.html)in der *AWS CLI Befehlsreferenz*. ### `delete-custom-action-type` Das folgende Codebeispiel zeigt die Verwendung`delete-custom-action-type`. **AWS CLI** **So löschen Sie eine benutzerdefinierte Aktion** In diesem Beispiel AWS CodePipeline wird eine benutzerdefinierte Aktion mithilfe einer bereits erstellten JSON-Datei (hier „ DeleteMyCustomAction.json“ genannt) gelöscht, die den Aktionstyp, den Anbieternamen und die Versionsnummer der zu löschenden Aktion enthält. Verwenden Sie den list-action-types Befehl, um die richtigen Werte für Kategorie, Version und Anbieter anzuzeigen. Befehl: ``` aws codepipeline delete-custom-action-type --cli-input-json file://DeleteMyCustomAction.json ``` Beispielinhalt für die JSON-Datei: ``` { "category": "Build", "version": "1", "provider": "MyJenkinsProviderName" } ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [DeleteCustomActionType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/delete-custom-action-type.html)unter *AWS CLI Befehlsreferenz*. ### `delete-pipeline` Das folgende Codebeispiel zeigt die Verwendung`delete-pipeline`. **AWS CLI** **Um eine Pipeline zu löschen** In diesem Beispiel wird eine Pipeline mit dem Namen MySecondPipeline von AWS CodePipeline gelöscht. Verwenden Sie den Befehl list-pipelines, um eine Liste der Pipelines anzuzeigen, die Ihrem Konto zugeordnet sind. AWS Befehl: ``` aws codepipeline delete-pipeline --name MySecondPipeline ``` Ausgabe: ``` None. ``` + *Einzelheiten zur API finden Sie unter [DeletePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/delete-pipeline.html)Befehlsreferenz.AWS CLI * ### `delete-webhook` Das folgende Codebeispiel zeigt die Verwendung`delete-webhook`. **AWS CLI** **So löschen Sie einen Webhook** Im folgenden `delete-webhook` Beispiel wird ein Webhook für eine Quellaktion der GitHub Version 1 gelöscht. Sie müssen den `deregister-webhook-with-third-party`-Befehl verwenden, um die Registrierung des Webhooks aufzuheben, bevor Sie ihn löschen. ``` aws codepipeline delete-webhook \ --name my-webhook ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. *Weitere Informationen finden Sie [im Benutzerhandbuch unter Löschen des Webhooks für Ihre GitHub Quelle](https://docs.aws.amazon.com/codepipeline/latest/userguide/appendix-github-oauth.html#pipelines-webhooks-delete).AWS CodePipeline * + Einzelheiten zur API finden Sie [DeleteWebhook](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/delete-webhook.html)in der *AWS CLI Befehlsreferenz.* ### `deregister-webhook-with-third-party` Das folgende Codebeispiel zeigt die Verwendung`deregister-webhook-with-third-party`. **AWS CLI** **So heben Sie die Registrierung eines Webhooks auf** Im folgenden `deregister-webhook-with-third-party` Beispiel wird ein Webhook für eine Quellaktion der GitHub Version 1 gelöscht. Sie müssen den Webhook abmelden, bevor Sie ihn löschen. ``` aws codepipeline deregister-webhook-with-third-party \ --webhook-name my-webhook ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. *Weitere Informationen finden Sie [im Benutzerhandbuch unter Löschen des Webhooks für Ihre GitHub Quelle](https://docs.aws.amazon.com/codepipeline/latest/userguide/appendix-github-oauth.html#pipelines-webhooks-delete).AWS CodePipeline * + Einzelheiten zur API finden Sie [DeregisterWebhookWithThirdParty](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/deregister-webhook-with-third-party.html)in der *AWS CLI Befehlsreferenz.* ### `disable-stage-transition` Das folgende Codebeispiel zeigt die Verwendung`disable-stage-transition`. **AWS CLI** **So deaktivieren Sie den Übergang zu einer Phase in einer Pipeline** In diesem Beispiel werden Übergänge in die Betaphase der MyFirstPipeline Pipeline in AWS CodePipeline deaktiviert. Befehl: ``` aws codepipeline disable-stage-transition --pipeline-name MyFirstPipeline --stage-name Beta --transition-type Inbound ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [DisableStageTransition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/disable-stage-transition.html)in der *AWS CLI Befehlsreferenz.* ### `enable-stage-transition` Das folgende Codebeispiel zeigt die Verwendung`enable-stage-transition`. **AWS CLI** **So aktivieren Sie einen Übergang zu einer Phase in einer Pipeline** Dieses Beispiel ermöglicht Übergänge in die Betaphase der MyFirstPipeline Pipeline in AWS CodePipeline. Befehl: ``` aws codepipeline enable-stage-transition --pipeline-name MyFirstPipeline --stage-name Beta --transition-type Inbound ``` Ausgabe: ``` None. ``` + Einzelheiten zur API finden Sie [EnableStageTransition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/enable-stage-transition.html)in der *AWS CLI Befehlsreferenz*. ### `get-job-details` Das folgende Codebeispiel zeigt die Verwendung`get-job-details`. **AWS CLI** **So rufen Sie Details zu einem Auftrag ab** In diesem Beispiel werden Details zu einem Auftrag zurückgegeben, dessen ID durch „f4f4ff82-2d11-EXAMPLE“ dargestellt wird. Dieser Befehl wird nur für benutzerdefinierte Aktionen verwendet. Wenn dieser Befehl aufgerufen wird, werden temporäre Anmeldeinformationen für den Amazon S3 S3-Bucket AWS CodePipeline zurückgegeben, der zum Speichern von Artefakten für die Pipeline verwendet wird, falls dies für die benutzerdefinierte Aktion erforderlich ist. Dieser Befehl gibt auch alle geheimen Werte zurück, die für die Aktion definiert wurden, sofern welche definiert wurden. Befehl: ``` aws codepipeline get-job-details --job-id f4f4ff82-2d11-EXAMPLE ``` Ausgabe: ``` { "jobDetails": { "accountId": "111111111111", "data": { "actionConfiguration": { "__type": "ActionConfiguration", "configuration": { "ProjectName": "MyJenkinsExampleTestProject" } }, "actionTypeId": { "__type": "ActionTypeId", "category": "Test", "owner": "Custom", "provider": "MyJenkinsProviderName", "version": "1" }, "artifactCredentials": { "__type": "AWSSessionCredentials", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "secretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "sessionToken": "fICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9TrDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpEIbb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0FkbFFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTbNYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=" }, "inputArtifacts": [ { "__type": "Artifact", "location": { "s3Location": { "bucketName": "codepipeline-us-east-1-11EXAMPLE11", "objectKey": "MySecondPipeline/MyAppBuild/EXAMPLE" }, "type": "S3" }, "name": "MyAppBuild" } ], "outputArtifacts": [], "pipelineContext": { "__type": "PipelineContext", "action": { "name": "MyJenkinsTest-Action" }, "pipelineName": "MySecondPipeline", "stage": { "name": "Testing" } } }, "id": "f4f4ff82-2d11-EXAMPLE" } } ``` + Einzelheiten zur API finden Sie [GetJobDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/get-job-details.html)in der *AWS CLI Befehlsreferenz*. ### `get-pipeline-state` Das folgende Codebeispiel zeigt die Verwendung`get-pipeline-state`. **AWS CLI** **So rufen Sie Informationen zum Status einer Pipeline ab** In diesem Beispiel wird der letzte Status einer Pipeline mit dem Namen zurückgegeben MyFirstPipeline. Befehl: ``` aws codepipeline get-pipeline-state --name MyFirstPipeline ``` Ausgabe: ``` { "created": 1446137312.204, "pipelineName": "MyFirstPipeline", "pipelineVersion": 1, "stageStates": [ { "actionStates": [ { "actionName": "Source", "entityUrl": "https://console.aws.amazon.com/s3/home?#", "latestExecution": { "lastStatusChange": 1446137358.328, "status": "Succeeded" } } ], "stageName": "Source" }, { "actionStates": [ { "actionName": "CodePipelineDemoFleet", "entityUrl": "https://console.aws.amazon.com/codedeploy/home?#/applications/CodePipelineDemoApplication/deployment-groups/CodePipelineDemoFleet", "latestExecution": { "externalExecutionId": "d-EXAMPLE", "externalExecutionUrl": "https://console.aws.amazon.com/codedeploy/home?#/deployments/d-EXAMPLE", "lastStatusChange": 1446137493.131, "status": "Succeeded", "summary": "Deployment Succeeded" } } ], "inboundTransitionState": { "enabled": true }, "stageName": "Beta" } ], "updated": 1446137312.204 } ``` + Einzelheiten zur API finden Sie [GetPipelineState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/get-pipeline-state.html)unter *AWS CLI Befehlsreferenz*. ### `get-pipeline` Das folgende Codebeispiel zeigt die Verwendung`get-pipeline`. **AWS CLI** **So zeigen Sie die Struktur einer Pipeline an** In diesem Beispiel wird die Struktur einer Pipeline mit dem Namen zurückgegeben MyFirstPipeline. Befehl: ``` aws codepipeline get-pipeline --name MyFirstPipeline ``` Ausgabe: ``` { "pipeline": { "roleArn": "arn:aws:iam::111111111111:role/AWS-CodePipeline-Service", "stages": [ { "name": "Source", "actions": [ { "inputArtifacts": [], "name": "Source", "actionTypeId": { "category": "Source", "owner": "AWS", "version": "1", "provider": "S3" }, "outputArtifacts": [ { "name": "MyApp" } ], "configuration": { "S3Bucket": "awscodepipeline-demo-bucket", "S3ObjectKey": "aws-codepipeline-s3-aws-codedeploy_linux.zip" }, "runOrder": 1 } ] }, { "name": "Beta", "actions": [ { "inputArtifacts": [ { "name": "MyApp" } ], "name": "CodePipelineDemoFleet", "actionTypeId": { "category": "Deploy", "owner": "AWS", "version": "1", "provider": "CodeDeploy" }, "outputArtifacts": [], "configuration": { "ApplicationName": "CodePipelineDemoApplication", "DeploymentGroupName": "CodePipelineDemoFleet" }, "runOrder": 1 } ] } ], "artifactStore": { "type": "S3", "location": "codepipeline-us-east-1-11EXAMPLE11" }, "name": "MyFirstPipeline", "version": 1 } } ``` + Einzelheiten zur API finden Sie [GetPipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/get-pipeline.html)unter *AWS CLI Befehlsreferenz*. ### `list-action-executions` Das folgende Codebeispiel zeigt die Verwendung`list-action-executions`. **AWS CLI** **So listen Sie Aktionsausführungen auf** Im folgenden Bespiel für `list-action-executions` werden Aktionsausführungsdetails für eine Pipeline angezeigt, wie etwa die Aktionsausführungs-ID, Eingabeartefakte, Ausgabeartefakte sowie das Ausführungsergebnis und der Status. ``` aws codepipeline list-action-executions \ --pipeline-name myPipeline ``` Ausgabe: ``` { "actionExecutionDetails": [ { "pipelineExecutionId": "EXAMPLE0-adfc-488e-bf4c-1111111720d3", "actionExecutionId": "EXAMPLE4-2ee8-4853-bd6a-111111158148", "pipelineVersion": 12, "stageName": "Deploy", "actionName": "Deploy", "startTime": 1598572628.6, "lastUpdateTime": 1598572661.255, "status": "Succeeded", "input": { "actionTypeId": { "category": "Deploy", "owner": "AWS", "provider": "CodeDeploy", "version": "1" }, "configuration": { "ApplicationName": "my-application", "DeploymentGroupName": "my-deployment-group" }, "resolvedConfiguration": { "ApplicationName": "my-application", "DeploymentGroupName": "my-deployment-group" }, "region": "us-east-1", "inputArtifacts": [ { "name": "SourceArtifact", "s3location": { "bucket": "artifact-bucket", "key": "myPipeline/SourceArti/key" } } ], "namespace": "DeployVariables" }, "output": { "outputArtifacts": [], "executionResult": { "externalExecutionId": "d-EXAMPLEE5", "externalExecutionSummary": "Deployment Succeeded", "externalExecutionUrl": "https://myaddress.com" }, "outputVariables": {} } }, { "pipelineExecutionId": "EXAMPLE0-adfc-488e-bf4c-1111111720d3", "actionExecutionId": "EXAMPLE5-abb4-4192-9031-11111113a7b0", "pipelineVersion": 12, "stageName": "Source", "actionName": "Source", "startTime": 1598572624.387, "lastUpdateTime": 1598572628.16, "status": "Succeeded", "input": { "actionTypeId": { "category": "Source", "owner": "AWS", "provider": "CodeCommit", "version": "1" }, "configuration": { "BranchName": "production", "PollForSourceChanges": "false", "RepositoryName": "my-repo" }, "resolvedConfiguration": { "BranchName": "production", "PollForSourceChanges": "false", "RepositoryName": "my-repo" }, "region": "us-east-1", "inputArtifacts": [], "namespace": "SourceVariables" }, "output": { "outputArtifacts": [ { "name": "SourceArtifact", "s3location": { "bucket": "amzn-s3-demo-bucket", "key": "myPipeline/SourceArti/key" } } ], "executionResult": { "externalExecutionId": "1111111ad99dcd35914c00b7fbea13995EXAMPLE", "externalExecutionSummary": "Edited template.yml", "externalExecutionUrl": "https://myaddress.com" }, "outputVariables": { "AuthorDate": "2020-05-08T17:45:43Z", "BranchName": "production", "CommitId": "EXAMPLEad99dcd35914c00b7fbea139951111111", "CommitMessage": "Edited template.yml", "CommitterDate": "2020-05-08T17:45:43Z", "RepositoryName": "my-repo" } } }, . . . . ``` Weitere Informationen finden Sie unter [Aktionsausführungen (CLI) anzeigen](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-view-cli.html#pipelines-action-executions-cli) im *AWS CodePipeline Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListActionExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/list-action-executions.html)in der *AWS CLI Befehlsreferenz.* ### `list-action-types` Das folgende Codebeispiel zeigt die Verwendung`list-action-types`. **AWS CLI** **So zeigen Sie die verfügbaren Aktionstypen an** Der list-action-types Befehl wird eigenständig verwendet und gibt die Struktur aller Aktionen zurück, die für Ihr AWS Konto verfügbar sind. In diesem Beispiel wird die action-owner-filter Option -- verwendet, um nur benutzerdefinierte Aktionen zurückzugeben. Befehl: ``` aws codepipeline list-action-types --action-owner-filter Custom ``` Ausgabe: ``` { "actionTypes": [ { "inputArtifactDetails": { "maximumCount": 5, "minimumCount": 0 }, "actionConfigurationProperties": [ { "secret": false, "required": true, "name": "MyJenkinsExampleBuildProject", "key": true, "queryable": true } ], "outputArtifactDetails": { "maximumCount": 5, "minimumCount": 0 }, "id": { "category": "Build", "owner": "Custom", "version": "1", "provider": "MyJenkinsProviderName" }, "settings": { "entityUrlTemplate": "http://192.0.2.4/job/{Config:ProjectName}", "executionUrlTemplate": "http://192.0.2.4/job/{Config:ProjectName}/{ExternalExecutionId}" } }, { "inputArtifactDetails": { "maximumCount": 5, "minimumCount": 0 }, "actionConfigurationProperties": [ { "secret": false, "required": true, "name": "MyJenkinsExampleTestProject", "key": true, "queryable": true } ], "outputArtifactDetails": { "maximumCount": 5, "minimumCount": 0 }, "id": { "category": "Test", "owner": "Custom", "version": "1", "provider": "MyJenkinsProviderName" }, "settings": { "entityUrlTemplate": "http://192.0.2.4/job/{Config:ProjectName}", "executionUrlTemplate": "http://192.0.2.4/job/{Config:ProjectName}/{ExternalExecutionId}" } } ] } ``` + Einzelheiten zur API finden Sie [ListActionTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/list-action-types.html)in der *AWS CLI Befehlsreferenz*. ### `list-pipeline-executions` Das folgende Codebeispiel zeigt die Verwendung`list-pipeline-executions`. **AWS CLI** **Sie zeigen Sie den Ausführungsverlauf einer Pipeline an** Das folgende `list-pipeline-executions` Beispiel zeigt den Verlauf der Pipeline-Ausführung für eine Pipeline in Ihrem AWS Konto. ``` aws codepipeline list-pipeline-executions \ --pipeline-name MyPipeline ``` Ausgabe: ``` { "pipelineExecutionSummaries": [ { "lastUpdateTime": 1496380678.648, "pipelineExecutionId": "7cf7f7cb-3137-539g-j458-d7eu3EXAMPLE", "startTime": 1496380258.243, "status": "Succeeded" }, { "lastUpdateTime": 1496591045.634, "pipelineExecutionId": "3137f7cb-8d494hj4-039j-d84l-d7eu3EXAMPLE", "startTime": 1496590401.222, "status": "Succeeded" }, { "lastUpdateTime": 1496946071.6456, "pipelineExecutionId": "4992f7jf-7cf7-913k-k334-d7eu3EXAMPLE", "startTime": 1496945471.5645, "status": "Succeeded" } ] } ``` Weitere Informationen finden Sie im *AWS CodePipeline Benutzerhandbuch* unter [Ausführungsverlauf anzeigen](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-view-cli.html#pipelines-executions-cli). + Einzelheiten zur API finden Sie [ListPipelineExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/list-pipeline-executions.html)in der *AWS CLI Befehlsreferenz*. ### `list-pipelines` Das folgende Codebeispiel zeigt die Verwendung`list-pipelines`. **AWS CLI** **So zeigen Sie eine Liste von Pipelines an** In diesem Beispiel werden alle AWS CodePipeline Pipelines aufgeführt, die dem AWS Konto des Benutzers zugeordnet sind. Befehl: ``` aws codepipeline list-pipelines ``` Ausgabe: ``` { "pipelines": [ { "updated": 1439504274.641, "version": 1, "name": "MyFirstPipeline", "created": 1439504274.641 }, { "updated": 1436461837.992, "version": 2, "name": "MySecondPipeline", "created": 1436460801.381 } ] } ``` + Einzelheiten zur API finden Sie unter [ListPipelines AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/list-pipelines.html)*Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags auf** Im folgenden Beispiel für `list-tags-for-resource` wird eine Liste aller Tags abgerufen, die mit der angegebenen Pipeline-Ressource verknüpft sind. ``` aws codepipeline list-tags-for-resource \ --resource-arn arn:aws:codepipeline:us-east-1:123456789012:MyPipeline ``` Ausgabe: ``` { "tags": { "Project": "ProjectA", "IscontainerBased": "true" } } ``` Weitere Informationen finden Sie unter [Tags für eine Pipeline (CLI) anzeigen](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-tag.html#pipelines-tag-list-cli) im *AWS CodePipeline Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/list-tags-for-resource.html)unter *AWS CLI Befehlsreferenz*. ### `list-webhooks` Das folgende Codebeispiel zeigt die Verwendung`list-webhooks`. **AWS CLI** **So listen Sie Webhooks auf** Im folgenden Beispiel für `list-webhooks` wird eine Liste aller Tags abgerufen, die mit der angegebenen Pipeline-Ressource verknüpft sind. ``` aws codepipeline list-webhooks \ --endpoint-url "https://codepipeline.eu-central-1.amazonaws.com" \ --region "eu-central-1" ``` Ausgabe: ``` { "webhooks": [ { "url": "https://webhooks.domain.com/trigger111111111EXAMPLE11111111111111111": { "authenticationConfiguration": { "SecretToken": "Secret" }, "name": "my-webhook", "authentication": "GITHUB_HMAC", "targetPipeline": "my-Pipeline", "targetAction": "Source", "filters": [ { "jsonPath": "$.ref", "matchEquals": "refs/heads/{Branch}" } ] }, "arn": "arn:aws:codepipeline:eu-central-1:123456789012:webhook:my-webhook" } ] } ``` Weitere Informationen finden Sie im *AWS CodePipeline Benutzerhandbuch* unter [Auflisten von Webhooks in Ihrem Konto](https://docs.aws.amazon.com/codepipeline/latest/userguide/appendix-github-oauth.html#pipelines-webhooks-view). + Einzelheiten zur API finden Sie [ListWebhooks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/list-webhooks.html)in der *AWS CLI Befehlsreferenz.* ### `poll-for-jobs` Das folgende Codebeispiel zeigt die Verwendung`poll-for-jobs`. **AWS CLI** **So zeigen Sie alle verfügbaren Aufträge an** In diesem Beispiel werden Informationen zu allen Aufträgen zurückgegeben, auf die ein Auftragsworker reagieren kann. In diesem Beispiel wird eine vordefinierte JSON-Datei (MyActionTypeInfo.json) verwendet, um Informationen über den Aktionstyp bereitzustellen, für den der Job Worker Jobs verarbeitet. Dieser Befehl wird nur für benutzerdefinierte Aktionen verwendet. Wenn dieser Befehl aufgerufen wird, werden temporäre Anmeldeinformationen für den Amazon S3 S3-Bucket AWS CodePipeline zurückgegeben, der zum Speichern von Artefakten für die Pipeline verwendet wird. Dieser Befehl gibt auch alle geheimen Werte zurück, die für die Aktion definiert wurden, sofern welche definiert wurden. Befehl: ``` aws codepipeline poll-for-jobs --cli-input-json file://MyActionTypeInfo.json ``` Beispielinhalt für die JSON-Datei: ``` { "actionTypeId": { "category": "Test", "owner": "Custom", "provider": "MyJenkinsProviderName", "version": "1" }, "maxBatchSize": 5, "queryParam": { "ProjectName": "MyJenkinsTestProject" } } ``` Ausgabe: ``` { "jobs": [ { "accountId": "111111111111", "data": { "actionConfiguration": { "__type": "ActionConfiguration", "configuration": { "ProjectName": "MyJenkinsExampleTestProject" } }, "actionTypeId": { "__type": "ActionTypeId", "category": "Test", "owner": "Custom", "provider": "MyJenkinsProviderName", "version": "1" }, "artifactCredentials": { "__type": "AWSSessionCredentials", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "secretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "sessionToken": "fICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9TrDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpEIbb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0FkbFFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTbNYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=" }, "inputArtifacts": [ { "__type": "Artifact", "location": { "s3Location": { "bucketName": "codepipeline-us-east-1-11EXAMPLE11", "objectKey": "MySecondPipeline/MyAppBuild/EXAMPLE" }, "type": "S3" }, "name": "MyAppBuild" } ], "outputArtifacts": [], "pipelineContext": { "__type": "PipelineContext", "action": { "name": "MyJenkinsTest-Action" }, "pipelineName": "MySecondPipeline", "stage": { "name": "Testing" } } }, "id": "ef66c259-64f9-EXAMPLE", "nonce": "3" } ] } ``` + Einzelheiten zur API finden Sie [PollForJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/poll-for-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `put-webhook` Das folgende Codebeispiel zeigt die Verwendung`put-webhook`. **AWS CLI** **So erstellen Sie einen Webhook** Im folgenden `put-webhook` Beispiel wird ein Webhook für eine Quellaktion der GitHub Version 1 erstellt. Nachdem Sie den Webhook erstellt haben, müssen Sie ihn mit dem Befehl register-webhook-with-third -party registrieren. ``` aws codepipeline put-webhook \ --cli-input-json file://webhook_json.json \ --region "eu-central-1" ``` Inhalt von `webhook_json.json`: ``` { "webhook": { "name": "my-webhook", "targetPipeline": "pipeline_name", "targetAction": "source_action_name", "filters": [ { "jsonPath": "$.ref", "matchEquals": "refs/heads/{Branch}" } ], "authentication": "GITHUB_HMAC", "authenticationConfiguration": { "SecretToken": "secret" } } } ``` Ausgabe: ``` { "webhook": { "url": "https://webhooks.domain.com/trigger111111111EXAMPLE11111111111111111", "definition": { "authenticationConfiguration": { "SecretToken": "secret" }, "name": "my-webhook", "authentication": "GITHUB_HMAC", "targetPipeline": "pipeline_name", "targetAction": "Source", "filters": [ { "jsonPath": "$.ref", "matchEquals": "refs/heads/{Branch}" } ] }, "arn": "arn:aws:codepipeline:eu-central-1:123456789012:webhook:my-webhook" }, "tags": [ { "key": "Project", "value": "ProjectA" } ] } ``` *Weitere Informationen finden Sie im [Benutzerhandbuch unter Erstellen eines Webhooks für eine GitHub Quelle](https://docs.aws.amazon.com/codepipeline/latest/userguide/appendix-github-oauth.html#pipelines-webhooks-create).AWS CodePipeline * + Einzelheiten zur API finden Sie unter [PutWebhook AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/put-webhook.html)*Befehlsreferenz.* ### `retry-stage-execution` Das folgende Codebeispiel zeigt die Verwendung`retry-stage-execution`. **AWS CLI** **So wiederholen Sie eine fehlgeschlagene Aktion** Im folgenden Beispiel für `retry-stage-execution` wird eine Phase wiederholt, bei der eine Aktion fehlgeschlagen ist. ``` aws codepipeline retry-stage-execution \ --pipeline-name MyPipeline \ --stage-name Deploy \ --pipeline-execution-id b59babff-5f34-EXAMPLE \ --retry-mode FAILED_ACTIONS ``` Ausgabe: ``` { "pipelineExecutionId": "b59babff-5f34-EXAMPLE" } ``` Weitere Informationen finden Sie unter [Fehlgeschlagene Aktionen wiederholen (CLI)](https://docs.aws.amazon.com/codepipeline/latest/userguide/actions-retry.html#actions-retry-cli) im *AWS CodePipeline Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [RetryStageExecution AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/retry-stage-execution.html)*Befehlsreferenz.* ### `start-pipeline-execution` Das folgende Codebeispiel zeigt die Verwendung`start-pipeline-execution`. **AWS CLI** **So führen Sie die neueste Revision über eine Pipeline aus** In diesem Beispiel wird die letzte Version, die sich in der Quellphase einer Pipeline befindet, über die Pipeline mit dem Namen "MyFirstPipeline" ausgeführt. Befehl: ``` aws codepipeline start-pipeline-execution --name MyFirstPipeline ``` Ausgabe: ``` { "pipelineExecutionId": "3137f7cb-7cf7-EXAMPLE" } ``` + Einzelheiten zur API finden Sie [StartPipelineExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/start-pipeline-execution.html)unter *AWS CLI Befehlsreferenz*. ### `stop-pipeline-execution` Das folgende Codebeispiel zeigt die Verwendung`stop-pipeline-execution`. **AWS CLI** **So beenden Sie die Pipeline-Ausführung** Im folgenden Beispiel für `stop-pipeline-execution` wird standardmäßig gewartet, bis die laufenden Aktionen abgeschlossen sind. Dann wird die Pipeline-Ausführung beendet. Sie können sich nicht für das Anhalten und Warten entscheiden, wenn sich die Ausführung bereits in einem Stopping (Wird angehalten)-Status befindet. Sie können eine Ausführung, die sich bereits in einem Status Stopping (Wird angehalten) befindet, anhalten und beenden. ``` aws codepipeline stop-pipeline-execution \ --pipeline-name MyFirstPipeline \ --pipeline-execution-id d-EXAMPLE \ --reason "Stopping pipeline after the build action is done" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Stoppen einer Pipeline-Ausführung (CLI)](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-stop.html#pipelines-stop-cli) im *AWS CodePipeline Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopPipelineExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/stop-pipeline-execution.html)unter *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird ein Satz bereitgestellter Tags einer Pipeline zugeordnet. Verwenden Sie diesen Befehl, um Tags hinzuzufügen oder zu bearbeiten. ``` aws codepipeline tag-resource \ --resource-arn arn:aws:codepipeline:us-east-1:123456789012:MyPipeline \ --tags key=Project,value=ProjectA key=IscontainerBased,value=true ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen von Tags zu einer Pipeline (CLI)](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-tag.html#pipelines-tag-add-cli) im *AWS CodePipeline Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/tag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Um AWS Tags aus einer Verbindungsressource zu entfernen** Im folgenden Beispiel für `untag-resource` wird ein Tag aus der angegebenen Ressource entfernt. ``` aws codepipeline untag-resource \ --resource-arn arn:aws:codepipeline:us-east-1:123456789012:MyPipeline \ --tag-keys Project IscontainerBased ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Entfernen von Tags aus einer Pipeline (CLI)](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-tag.html#pipelines-tag-delete-cli) im *AWS CodePipeline Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/untag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `update-pipeline` Das folgende Codebeispiel zeigt die Verwendung`update-pipeline`. **AWS CLI** **So aktualisieren Sie die Struktur einer Pipeline** In diesem Beispiel wird der Befehl update-pipeline mit dem Argument -- cli-input-json verwendet. In diesem Beispiel wird eine vordefinierte JSON-Datei (MyFirstPipeline.json) verwendet, um die Struktur einer Pipeline zu aktualisieren. AWS CodePipeline erkennt den in der JSON-Datei enthaltenen Pipeline-Namen und wendet dann alle Änderungen an geänderten Feldern in der Pipeline-Struktur an, um die Pipeline zu aktualisieren. Beachten Sie beim Erstellen der vordefinierten JSON-Datei die folgenden Richtlinien: Wenn Sie mit einer Pipeline-Struktur arbeiten, die mit dem Befehl „get-pipeline“ abgerufen wurde, müssen Sie den Metadatenabschnitt aus der Pipeline-Struktur in der JSON-Datei entfernen (die Zeilen mit „metadata“: \$1\$1 und die darin enthaltenen Felder „created“, „pipelineARN“ und „updated“). Der Pipeline-Name kann nicht geändert werden. Befehl: ``` aws codepipeline update-pipeline --cli-input-json file://MyFirstPipeline.json ``` Inhalt einer JSON-Beispieldatei: ``` { "pipeline": { "roleArn": "arn:aws:iam::111111111111:role/AWS-CodePipeline-Service", "stages": [ { "name": "Source", "actions": [ { "inputArtifacts": [], "name": "Source", "actionTypeId": { "category": "Source", "owner": "AWS", "version": "1", "provider": "S3" }, "outputArtifacts": [ { "name": "MyApp" } ], "configuration": { "S3Bucket": "awscodepipeline-demo-bucket2", "S3ObjectKey": "aws-codepipeline-s3-aws-codedeploy_linux.zip" }, "runOrder": 1 } ] }, { "name": "Beta", "actions": [ { "inputArtifacts": [ { "name": "MyApp" } ], "name": "CodePipelineDemoFleet", "actionTypeId": { "category": "Deploy", "owner": "AWS", "version": "1", "provider": "CodeDeploy" }, "outputArtifacts": [], "configuration": { "ApplicationName": "CodePipelineDemoApplication", "DeploymentGroupName": "CodePipelineDemoFleet" }, "runOrder": 1 } ] } ], "artifactStore": { "type": "S3", "location": "codepipeline-us-east-1-11EXAMPLE11" }, "name": "MyFirstPipeline", "version": 1 } } ``` Ausgabe: ``` { "pipeline": { "artifactStore": { "location": "codepipeline-us-east-1-11EXAMPLE11", "type": "S3" }, "name": "MyFirstPipeline", "roleArn": "arn:aws:iam::111111111111:role/AWS-CodePipeline-Service", "stages": [ { "actions": [ { "actionTypeId": { "__type": "ActionTypeId", "category": "Source", "owner": "AWS", "provider": "S3", "version": "1" }, "configuration": { "S3Bucket": "awscodepipeline-demo-bucket2", "S3ObjectKey": "aws-codepipeline-s3-aws-codedeploy_linux.zip" }, "inputArtifacts": [], "name": "Source", "outputArtifacts": [ { "name": "MyApp" } ], "runOrder": 1 } ], "name": "Source" }, { "actions": [ { "actionTypeId": { "__type": "ActionTypeId", "category": "Deploy", "owner": "AWS", "provider": "CodeDeploy", "version": "1" }, "configuration": { "ApplicationName": "CodePipelineDemoApplication", "DeploymentGroupName": "CodePipelineDemoFleet" }, "inputArtifacts": [ { "name": "MyApp" } ], "name": "CodePipelineDemoFleet", "outputArtifacts": [], "runOrder": 1 } ], "name": "Beta" } ], "version": 3 } } ``` + Einzelheiten zur API finden Sie [UpdatePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codepipeline/update-pipeline.html)in der *AWS CLI Befehlsreferenz*. # AWS CodeStar Beispiele für Benachrichtigungen mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with AWS CodeStar Notifications Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-notification-rule` Das folgende Codebeispiel zeigt, wie Sie`create-notification-rule`. **AWS CLI** **Um eine Benachrichtigungsregel zu erstellen** Im folgenden `create-notification-rule` Beispiel wird eine JSON-Datei mit dem Namen verwendet`rule.json`, um eine Benachrichtigungsregel zu erstellen, `MyNotificationRule` die nach einem Repository benannt ist, das `MyDemoRepo` im angegebenen AWS Konto benannt ist. Benachrichtigungen mit dem Detailtyp `FULL` werden an das angegebene Amazon-SNS-Thema gesendet, wenn Branches und Tags erstellt werden. ``` aws codestar-notifications create-notification-rule \ --cli-input-json file://rule.json ``` Inhalt von `rule.json`: ``` { "Name": "MyNotificationRule", "EventTypeIds": [ "codecommit-repository-branches-and-tags-created" ], "Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo", "Targets": [ { "TargetType": "SNS", "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic" } ], "Status": "ENABLED", "DetailType": "FULL" } ``` Ausgabe: ``` { "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE" } ``` Weitere Informationen finden Sie unter [Erstellen einer Benachrichtigungsregel](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-create.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie [CreateNotificationRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/create-notification-rule.html)unter *AWS CLI Befehlsreferenz*. ### `delete-notification-rule` Das folgende Codebeispiel zeigt die Verwendung`delete-notification-rule`. **AWS CLI** **Um eine Benachrichtigungsregel zu löschen** Im folgenden Beispiel für `delete-notification-rule` wird die angegebene Benachrichtigungsregel gelöscht. ``` aws codestar-notifications delete-notification-rule \ --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE ``` Ausgabe: ``` { "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE" } ``` Weitere Informationen finden Sie unter [Löschen einer Benachrichtigungsregel](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-delete.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie [DeleteNotificationRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/delete-notification-rule.html)in der *AWS CLI Befehlsreferenz*. ### `delete-target` Das folgende Codebeispiel zeigt die Verwendung`delete-target`. **AWS CLI** **Um ein Ziel für eine Benachrichtigungsregel zu löschen** Im folgenden Beispiel für `delete-target` wird das angegebene Ziel aus allen Benachrichtigungsregeln entfernt, die für die Verwendung dieses Ziels als Ziel konfiguriert sind. Anschließend wird das Ziel gelöscht. ``` aws codestar-notifications delete-target \ --target-address arn:aws:sns:us-east-1:123456789012:MyNotificationTopic \ --force-unsubscribe-all ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Benachrichtigungsregelziels](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-target-delete.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie [DeleteTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/delete-target.html)in der *AWS CLI Befehlsreferenz*. ### `describe-notification-rule` Das folgende Codebeispiel zeigt die Verwendung`describe-notification-rule`. **AWS CLI** **So rufen Sie Details zu einer Benachrichtigungsregel ab** Im folgenden Beispiel für `describe-notification-rule` werden die Details der angegebenen Benachrichtigungsregel abgerufen. ``` aws codestar-notifications describe-notification-rule \ --arn arn:aws:codestar-notifications:us-west-2:123456789012:notificationrule/dc82df7a-EXAMPLE ``` Ausgabe: ``` { "LastModifiedTimestamp": 1569199844.857, "EventTypes": [ { "ServiceName": "CodeCommit", "EventTypeName": "Branches and tags: Created", "ResourceType": "Repository", "EventTypeId": "codecommit-repository-branches-and-tags-created" } ], "Status": "ENABLED", "DetailType": "FULL", "Resource": "arn:aws:codecommit:us-west-2:123456789012:MyDemoRepo", "Arn": "arn:aws:codestar-notifications:us-west-w:123456789012:notificationrule/dc82df7a-EXAMPLE", "Targets": [ { "TargetStatus": "ACTIVE", "TargetAddress": "arn:aws:sns:us-west-2:123456789012:MyNotificationTopic", "TargetType": "SNS" } ], "Name": "MyNotificationRule", "CreatedTimestamp": 1569199844.857, "CreatedBy": "arn:aws:iam::123456789012:user/Mary_Major" } ``` Weitere Informationen finden Sie unter [Anzeigen von Benachrichtigungsregeln](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-view.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie [DescribeNotificationRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/describe-notification-rule.html)in der *AWS CLI Befehlsreferenz*. ### `list-event-types` Das folgende Codebeispiel zeigt die Verwendung`list-event-types`. **AWS CLI** **So rufen Sie eine Liste mit Ereignistypen für eine Benachrichtigungsregel ab** Im folgenden `list-event-types` Beispiel wird eine gefilterte Liste aller verfügbaren Benachrichtigungsereignistypen für CodeDeploy Anwendungen abgerufen. Wenn Sie stattdessen keinen Filter verwenden, gibt der Befehl alle Benachrichtigungsereignistypen für alle Ressourcentypen zurück. ``` aws codestar-notifications list-event-types \ --filters Name=SERVICE_NAME,Value=CodeDeploy ``` Ausgabe: ``` { "EventTypes": [ { "EventTypeId": "codedeploy-application-deployment-succeeded", "ServiceName": "CodeDeploy", "EventTypeName": "Deployment: Succeeded", "ResourceType": "Application" }, { "EventTypeId": "codedeploy-application-deployment-failed", "ServiceName": "CodeDeploy", "EventTypeName": "Deployment: Failed", "ResourceType": "Application" }, { "EventTypeId": "codedeploy-application-deployment-started", "ServiceName": "CodeDeploy", "EventTypeName": "Deployment: Started", "ResourceType": "Application" } ] } ``` Weitere Informationen finden Sie unter [Erstellen einer Benachrichtigungsregel](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-create.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie unter [ListEventTypes AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/list-event-types.html)*Befehlsreferenz.* ### `list-notification-rules` Das folgende Codebeispiel zeigt die Verwendung`list-notification-rules`. **AWS CLI** **So rufen Sie eine Liste von Benachrichtigungsregeln ab** Im folgenden `list-notification-rules` Beispiel wird eine Liste aller Benachrichtigungsregeln in der angegebenen AWS Region abgerufen. ``` aws codestar-notifications list-notification-rules --region us-east-1 ``` Ausgabe: ``` { "NotificationRules": [ { "Id": "dc82df7a-EXAMPLE", "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE" }, { "Id": "8d1f0983-EXAMPLE", "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/8d1f0983-EXAMPLE" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen von Benachrichtigungsregeln](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-view.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie unter [ListNotificationRules AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/list-notification-rules.html)*Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So rufen Sie eine Liste von Tags ab, die an eine Benachrichtigungsregel angehängt sind** Im folgenden Beispiel für `list-tags-for-resource` wird eine Liste aller Tags abgerufen, die an die angegebene Benachrichtigungsregel angehängt sind. In diesem Beispiel sind der Benachrichtigungsregel derzeit keine Tags zugeordnet. ``` aws codestar-notifications list-tags-for-resource \ --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE ``` Ausgabe: ``` { "Tags": {} } ``` Weitere Informationen finden Sie unter [Erstellen einer Benachrichtigungsregel](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-create.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-targets` Das folgende Codebeispiel zeigt die Verwendung`list-targets`. **AWS CLI** **So rufen Sie eine Liste mit Benachrichtigungsregelzielen ab** Im folgenden `list-targets` Beispiel wird eine Liste aller Benachrichtigungsregelziele in der angegebenen AWS Region abgerufen. ``` aws codestar-notifications list-targets \ --region us-east-1 ``` Ausgabe: ``` { "Targets": [ { "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MySNSTopicForNotificationRules", "TargetType": "SNS", "TargetStatus": "ACTIVE" }, { "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MySNSTopicForNotificationsAboutMyDemoRepo", "TargetType": "SNS", "TargetStatus": "ACTIVE" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen von Benachrichtigungsregelzielen](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-target-view.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie unter [ListTargets AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/list-targets.html)*Befehlsreferenz.* ### `subscribe` Das folgende Codebeispiel zeigt die Verwendung`subscribe`. **AWS CLI** **Um ein Ziel zu einer Benachrichtigungsregel hinzuzufügen** Im folgenden Beispiel für `subscribe` wird ein Amazon-SNS-Thema als Ziel für die angegebene Benachrichtigungsregel hinzugefügt. ``` aws codestar-notifications subscribe \ --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE \ --target TargetType=SNS,TargetAddress=arn:aws:sns:us-east-1:123456789012:MyNotificationTopic ``` Ausgabe: ``` { "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE" } ``` Weitere Informationen finden Sie unter [Hinzufügen oder Entfernen eines Amazon-SNS-Themas als Ziel für eine Benachrichtigungsregel](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-target-change-rule.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Weitere API-Informationen finden Sie unter [Subscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/subscribe.html) in der *AWS CLI -Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt, wie man es benutzt`tag-resource`. **AWS CLI** **Um einer Benachrichtigungsregel ein Tag hinzuzufügen** Im folgenden Beispiel für `tag-resource` wird der angegebenen Benachrichtigungsregel ein Tag mit dem Schlüsselnamen `Team` und dem Wert `Li_Juan` hinzugefügt. ``` aws codestar-notifications tag-resource \ --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE \ --tags Team=Li_Juan ``` Ausgabe: ``` { "Tags": { "Team": "Li_Juan" } } ``` Weitere Informationen finden Sie unter [Erstellen einer Benachrichtigungsregel](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-create.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `unsubscribe` Das folgende Codebeispiel zeigt die Verwendung`unsubscribe`. **AWS CLI** **Um ein Ziel aus einer Benachrichtigungsregel zu entfernen** Im folgenden Beispiel für `unsubscribe` wird ein Amazon-SNS-Thema als Ziel aus der angegebenen Benachrichtigungsregel entfernt. ``` aws codestar-notifications unsubscribe \ --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE \ --target TargetType=SNS,TargetAddress=arn:aws:sns:us-east-1:123456789012:MyNotificationTopic ``` Ausgabe: ``` { "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE" "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic" } ``` Weitere Informationen finden Sie unter [Hinzufügen oder Entfernen eines Amazon-SNS-Themas als Ziel für eine Benachrichtigungsregel](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-target-change-rule.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Weitere API-Informationen finden Sie unter [Unsubscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/unsubscribe.html) in der *AWS CLI -Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt, wie man es benutzt`untag-resource`. **AWS CLI** **Um ein Tag aus einer Benachrichtigungsregel zu entfernen** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem Schlüsselnamen `Team` aus der angegebenen Benachrichtigungsregel entfernt. ``` aws codestar-notifications untag-resource \ --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE \ --tag-keys Team ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Bearbeiten einer Benachrichtigungsregel](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-edit.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-notification-rule` Das folgende Codebeispiel zeigt die Verwendung`update-notification-rule`. **AWS CLI** **So aktualisieren Sie eine Benachrichtigungsregel** Im folgenden `update-notification-rule` Beispiel wird eine `MyNotificationRule` im AWS Konto angegebene Benachrichtigungsregel `123456789012` mithilfe einer JSON-Datei mit dem Namen aktualisiert`update.json`. ``` aws codestar-notifications update-notification-rule \ --cli-input-json file://update.json ``` Inhalt von `update.json`: ``` { "Name": "MyUpdatedNotificationRule", "EventTypeIds": [ "codecommit-repository-branches-and-tags-created" ], "Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo", "Targets": [ { "TargetType": "SNS", "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic" } ], "Status": "ENABLED", "DetailType": "FULL" } ``` Ausgabe: ``` { "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE" } ``` Weitere Informationen finden Sie unter [Bearbeiten einer Benachrichtigungsregel](https://docs.aws.amazon.com/dtconsole/latest/userguide/notification-rule-edit.html) im *Benutzerhandbuch für AWS Developer Tools Console*. + Einzelheiten zur API finden Sie [UpdateNotificationRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/update-notification-rule.html)unter *AWS CLI Befehlsreferenz*. # CodeConnections Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CodeConnections. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-connection` Das folgende Codebeispiel zeigt, wie Sie`create-connection`. **AWS CLI** **Um eine Verbindung herzustellen** Das folgende Beispiel für `create-connection` zeigt, wie eine Verbindung mit einem Drittanbieter-Repository hergestellt wird. In diesem Beispiel wird eine Verbindung hergestellt, bei der der Drittanbieter Bitbucket ist. Eine Verbindung, die über die AWS CLI erstellt wurde oder AWS CloudFormation sich standardmäßig im Status Ausstehend befindet. Nachdem Sie eine Verbindung mit der CLI oder mit der Konsole hergestellt haben AWS CloudFormation, bearbeiten Sie die Verbindung, um ihren Status Verfügbar zu machen. ``` aws codestar-connections create-connection \ --provider-type Bitbucket \ --connection-name MyConnection ``` Ausgabe: ``` { "ConnectionArn": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f" } ``` Weitere Informationen zu Verbindungen finden Sie unter [Eine Verbindung erstellen](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [CreateConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/create-connection.html)in der *AWS CLI Befehlsreferenz*. ### `create-host` Das folgende Codebeispiel zeigt die Verwendung`create-host`. **AWS CLI** **So erstellen Sie einen Host** Das folgende Beispiel für `create-host` zeigt, wie Sie einen Host erstellen, der den Endpunkt für die Infrastruktur darstellt, in der der Drittanbieter installiert ist. In diesem Beispiel wird ein Host erstellt, auf dem GitHub Enterprise Server als Drittanbieter installiert ist. Ein über die AWS CLI erstellter Host hat standardmäßig den Status Ausstehend. Nachdem Sie mit der CLI einen Host erstellt haben, richten Sie mit der Konsole oder der CLI den Host so ein, dass er sich im Status „Verfügbar“ befindet. ``` aws codestar-connections create-host \ --name MyHost \ --provider-type GitHubEnterpriseServer \ --provider-endpoint "https://my-instance.dev" ``` Ausgabe: ``` { "HostArn": "arn:aws:codestar-connections:us-east-1:123456789012:host/My-Host-28aef605" } ``` Weitere Informationen finden Sie unter [Erstellen eines Hosts (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [CreateHost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/create-host.html)in der *AWS CLI Befehlsreferenz*. ### `delete-connection` Das folgende Codebeispiel zeigt die Verwendung`delete-connection`. **AWS CLI** **So löschen Sie eine Verbindung** Das folgende Beispiel für `delete-connection` zeigt, wie Sie eine Verbindung löschen. ``` aws codestar-connections delete-connection \ --connection-arn arn:aws:codestar-connections:us-west-2:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Verbindung (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-delete.html#connections-delete-cli) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/delete-connection.html)in der *AWS CLI Befehlsreferenz*. ### `delete-host` Das folgende Codebeispiel zeigt die Verwendung`delete-host`. **AWS CLI** **So löschen Sie einen Host** Im folgenden Beispiel für `delete-host` wird gezeigt, wie ein Host gelöscht wird. Bevor Sie einen Host löschen können, müssen Sie alle Verbindungen löschen, die mit dem Host verknüpft sind. ``` aws codestar-connections delete-host \ --host-arn "arn:aws:codestar-connections:us-east-1 :123456789012:host/My-Host-28aef605" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Hosts (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html#connections-host-delete-cli) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [DeleteHost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/delete-host.html)in der *AWS CLI Befehlsreferenz*. ### `get-connection` Das folgende Codebeispiel zeigt die Verwendung`get-connection`. **AWS CLI** **So rufen Sie Informationen zu einer Verbindung ab** Das folgende Beispiel für `get-connection` zeigt Details zu einer Verbindung. ``` aws codestar-connections get-connection \ --connection-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f ``` Ausgabe: ``` { "Connection": { "ConnectionName": "MyConnection", "ConnectionArn": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f", "ProviderType": "Bitbucket", "OwnerAccountId": "123456789012", "ConnectionStatus": "AVAILABLE" } } ``` Weitere Informationen zu Verbindungen finden Sie unter [Anzeigen von Verbindungsdetails](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-view-details.html) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [GetConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/get-connection.html)in der *AWS CLI Befehlsreferenz*. ### `get-host` Das folgende Codebeispiel zeigt die Verwendung`get-host`. **AWS CLI** **So rufen Sie Informationen zu einem Host ab** Das folgende Beispiel für `get-host` zeigt Details zu einem Host. ``` aws codestar-connections get-host \ --host-arn arn:aws:codestar-connections:us-east-1:123456789012:host/MyHost-28aef605 ``` Ausgabe: ``` { "Name": "MyHost", "Status": "AVAILABLE", "ProviderType": "GitHubEnterpriseServer", "ProviderEndpoint": "https://test-instance-1.dev/" } ``` Weitere Informationen finden Sie unter [View host details (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-view.html#connections-host-view-cli) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [GetHost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/get-host.html)in der *AWS CLI Befehlsreferenz*. ### `list-connections` Das folgende Codebeispiel zeigt die Verwendung`list-connections`. **AWS CLI** **So listen Sie Verbindungen auf** Im folgenden Beispiel für `list-connections` wird eine Liste aller Verbindungen in Ihrem Konto für den Bitbucket-Anbietertyp abgerufen: ``` aws codestar-connections list-connections \ --provider-type Bitbucket \ --max-results 5 \ --next-token: next-token ``` Ausgabe: ``` { "Connections": [ { "ConnectionName": "my-connection", "ProviderType": "Bitbucket", "Status": "PENDING", "ARN": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f", "OwnerAccountId": "123456789012" }, { "ConnectionName": "my-other-connection", "ProviderType": "Bitbucket", "Status": "AVAILABLE", "ARN": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f", "OwnerAccountId": "123456789012" }, ], "NextToken": "next-token" } ``` Weitere Informationen zu Verbindungen finden Sie unter [Auflisten von Verbindungen (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-list.html#connections-list-cli) im *Benutzerhandbuch für die Entwickler-Tools-Konsole*. + Einzelheiten zur API finden Sie [ListConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/list-connections.html)in der *AWS CLI Befehlsreferenz*. ### `list-hosts` Das folgende Codebeispiel zeigt die Verwendung`list-hosts`. **AWS CLI** **So listen Sie Hosts auf** Im folgenden Beispiel für `list-hosts` wird eine Liste aller Hosts in Ihrem Konto abgerufen. ``` aws codestar-connections list-hosts ``` Ausgabe: ``` { "Hosts": [ { "Name": "My-Host", "HostArn": "arn:aws:codestar-connections:us-east-1:123456789012:host/My-Host-28aef605", "ProviderType": "GitHubEnterpriseServer", "ProviderEndpoint": "https://my-instance.test.dev", "Status": "AVAILABLE" } ] } ``` Weitere Informationen zu Verbindungen finden Sie unter [Auflisten von Hosts (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-list.html) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [ListHosts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/list-hosts.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags auf** Im folgenden Beispiel für `list-tags-for-resource` wird eine Liste aller Tags abgerufen, die mit der angegebenen Verbindungsressource verknüpft sind. ``` aws codestar-connections list-tags-for-resource \ --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f ``` Ausgabe: ``` { "Tags": [ { "Key": "Project", "Value": "ProjectA" }, { "Key": "ReadOnly", "Value": "true" } ] } ``` Weitere Informationen zu Verbindungen finden Sie unter [Anzeigen von Tags für eine Verbindungsressource](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-tag.html#connections-tag-view) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird ein Satz bereitgestellter Tags einer Verbindung zugeordnet. Verwenden Sie diesen Befehl, um Tags hinzuzufügen oder zu bearbeiten. ``` aws codestar-connections tag-resource \ --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f \ --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen zu Verbindungen finden Sie unter [Hinzufügen von Tags zu einer Verbindungsressource](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-tag.html#connections-tag-add) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Um AWS Tags aus einer Verbindungsressource zu entfernen** Mit dem folgenden `untag-resource`-Befehl wird ein Tag aus der angegebenen Ressource entfernt. ``` aws codestar-connections untag-resource \ --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f \ --tag-keys Project ReadOnly ``` Ausgabe: ``` { "Tags": [] } ``` Weitere Informationen zu Verbindungen finden Sie unter [Entfernen von Tags aus einer Verbindungsressource](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-tag.html#connections-tag-delete) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Amazon Cognito Identity mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon Cognito Identity Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-identity-pool` Das folgende Codebeispiel zeigt, wie Sie`create-identity-pool`. **AWS CLI** **So erstellen Sie einen Identitätspool mit dem Cognito-Identitätspool-Anbieter** In diesem Beispiel wird ein Identitätspool mit dem Namen erstellt MyIdentityPool. Der Pool hat einen Cognito-Identitätspool-Anbieter. Nicht authentifizierte Identitäten sind nicht zulässig. Befehl: ``` aws cognito-identity create-identity-pool --identity-pool-name MyIdentityPool --no-allow-unauthenticated-identities --cognito-identity-providers ProviderName="cognito-idp.us-west-2.amazonaws.com/us-west-2_aaaaaaaaa",ClientId="3n4b5urk1ft4fl3mg5e62d9ado",ServerSideTokenCheck=false ``` Ausgabe: ``` { "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", "IdentityPoolName": "MyIdentityPool", "AllowUnauthenticatedIdentities": false, "CognitoIdentityProviders": [ { "ProviderName": "cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111", "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado", "ServerSideTokenCheck": false } ] } ``` + Einzelheiten zur API finden Sie [CreateIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/create-identity-pool.html)unter *AWS CLI Befehlsreferenz*. ### `delete-identities` Das folgende Codebeispiel zeigt die Verwendung`delete-identities`. **AWS CLI** **So löschen Sie einen Identitätspool** In diesem Beispiel wird ein Identitätspool gelöscht. Befehl: ``` aws cognito-identity delete-identity-pool --identity-ids-to-delete "us-west-2:11111111-1111-1111-1111-111111111111" ``` Ausgabe: ``` { "UnprocessedIdentityIds": [] } ``` + Einzelheiten zur API finden Sie [DeleteIdentities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/delete-identities.html)in der *AWS CLI Befehlsreferenz*. ### `delete-identity-pool` Das folgende Codebeispiel zeigt die Verwendung`delete-identity-pool`. **AWS CLI** **So löschen Sie einen Identitätspool** Im folgenden `delete-identity-pool`-Beispiel wird der angegebene Identitätspool gelöscht. Befehl: ``` aws cognito-identity delete-identity-pool \ --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/delete-identity-pool.html)in der *AWS CLI Befehlsreferenz*. ### `describe-identity-pool` Das folgende Codebeispiel zeigt die Verwendung`describe-identity-pool`. **AWS CLI** **So beschreiben Sie einen Identitätspool** In diesem Beispiel wird ein Identitätspool beschrieben. Befehl: ``` aws cognito-identity describe-identity-pool --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" ``` Ausgabe: ``` { "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", "IdentityPoolName": "MyIdentityPool", "AllowUnauthenticatedIdentities": false, "CognitoIdentityProviders": [ { "ProviderName": "cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111", "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado", "ServerSideTokenCheck": false } ] } ``` + Einzelheiten zur API finden Sie [DescribeIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/describe-identity-pool.html)in der *AWS CLI Befehlsreferenz*. ### `get-identity-pool-roles` Das folgende Codebeispiel zeigt die Verwendung`get-identity-pool-roles`. **AWS CLI** **So rufen Sie Rollen für einen Identitätspool ab** In diesem Beispiel werden Rollen für einen Identitätspool abgerufen. Befehl: ``` aws cognito-identity get-identity-pool-roles --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" ``` Ausgabe: ``` { "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", "Roles": { "authenticated": "arn:aws:iam::111111111111:role/Cognito_MyIdentityPoolAuth_Role", "unauthenticated": "arn:aws:iam::111111111111:role/Cognito_MyIdentityPoolUnauth_Role" } } ``` + Einzelheiten zur API finden Sie [GetIdentityPoolRoles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/get-identity-pool-roles.html)in der *AWS CLI Befehlsreferenz*. ### `list-identity-pools` Das folgende Codebeispiel zeigt die Verwendung`list-identity-pools`. **AWS CLI** **So listen Sie Identitätspools auf** In diesem Beispiel werden Identitätspools aufgeführt. Es werden maximal 20 Identitäten aufgeführt. Befehl: ``` aws cognito-identity list-identity-pools --max-results 20 ``` Ausgabe: ``` { "IdentityPools": [ { "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", "IdentityPoolName": "MyIdentityPool" }, { "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", "IdentityPoolName": "AnotherIdentityPool" }, { "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", "IdentityPoolName": "IdentityPoolRegionA" } ] } ``` + Einzelheiten zur API finden Sie [ListIdentityPools](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/list-identity-pools.html)in der *AWS CLI Befehlsreferenz*. ### `set-identity-pool-roles` Das folgende Codebeispiel zeigt die Verwendung`set-identity-pool-roles`. **AWS CLI** **So legen Sie Rollen für einen Identitätspool fest** Im folgenden Beispiel für `set-identity-pool-roles` wird eine Rolle für einen Identitätspool festgelegt. ``` aws cognito-identity set-identity-pool-roles \ --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" \ --roles authenticated="arn:aws:iam::111111111111:role/Cognito_MyIdentityPoolAuth_Role" ``` + Einzelheiten zur API finden Sie [SetIdentityPoolRoles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/set-identity-pool-roles.html)in der *AWS CLI Befehlsreferenz*. ### `update-identity-pool` Das folgende Codebeispiel zeigt die Verwendung`update-identity-pool`. **AWS CLI** **So aktualisieren Sie einen Identitätspool** In diesem Beispiel wird ein Identitätspool aktualisiert. Es setzt den Namen auf MyIdentityPool. Cognito wird als Identitätsanbieter hinzugefügt. Nicht authentifizierte Identitäten werden nicht zugelassen. Befehl: ``` aws cognito-identity update-identity-pool --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" --identity-pool-name "MyIdentityPool" --no-allow-unauthenticated-identities --cognito-identity-providers ProviderName="cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111",ClientId="3n4b5urk1ft4fl3mg5e62d9ado",ServerSideTokenCheck=false ``` Ausgabe: ``` { "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", "IdentityPoolName": "MyIdentityPool", "AllowUnauthenticatedIdentities": false, "CognitoIdentityProviders": [ { "ProviderName": "cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111", "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado", "ServerSideTokenCheck": false } ] } ``` + Einzelheiten zur API finden Sie [UpdateIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/update-identity-pool.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Amazon Cognito Identity Provider mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Cognito Identity Provider Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-custom-attributes` Das folgende Codebeispiel zeigt, wie Sie`add-custom-attributes`. **AWS CLI** **Um ein benutzerdefiniertes Attribut hinzuzufügen** In diesem Beispiel wird einem Benutzerpool das benutzerdefinierte Attribut CustomAttr 1 hinzugefügt. Es ist vom Typ Zeichenfolge und erfordert mindestens 1 und höchstens 15 Zeichen. Es ist nicht erforderlich. Befehl: ``` aws cognito-idp add-custom-attributes --user-pool-id us-west-2_aaaaaaaaa --custom-attributes Name="CustomAttr1",AttributeDataType="String",DeveloperOnlyAttribute=false,Required=false,StringAttributeConstraints="{MinLength=1,MaxLength=15}" ``` + Einzelheiten zur API finden Sie [AddCustomAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/add-custom-attributes.html)unter *AWS CLI Befehlsreferenz*. ### `admin-add-user-to-group` Das folgende Codebeispiel zeigt die Verwendung`admin-add-user-to-group`. **AWS CLI** **So fügen Sie einer Gruppe einen Benutzer hinzu** In diesem Beispiel wird der Benutzer Jane zur Gruppe hinzugefügt MyGroup. Befehl: ``` aws cognito-idp admin-add-user-to-group --user-pool-id us-west-2_aaaaaaaaa --username Jane --group-name MyGroup ``` + Einzelheiten zur API finden Sie [AdminAddUserToGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-add-user-to-group.html)in der *AWS CLI Befehlsreferenz*. ### `admin-confirm-sign-up` Das folgende Codebeispiel zeigt die Verwendung`admin-confirm-sign-up`. **AWS CLI** **So bestätigen Sie die Benutzerregistrierung** In diesem Beispiel wird der Benutzer jane@example.com bestätigt. Befehl: ``` aws cognito-idp admin-confirm-sign-up --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com ``` + Einzelheiten zur API finden Sie [AdminConfirmSignUp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-confirm-sign-up.html)in der *AWS CLI Befehlsreferenz*. ### `admin-create-user` Das folgende Codebeispiel zeigt die Verwendung`admin-create-user`. **AWS CLI** **Um einen Benutzer zu erstellen** Im folgenden Beispiel für `admin-create-user` wird ein Benutzer mit den angegebenen Einstellungen für E-Mail-Adresse und Telefonnummer erstellt. ``` aws cognito-idp admin-create-user \ --user-pool-id us-west-2_aaaaaaaaa \ --username diego \ --user-attributes Name=email,Value=diego@example.com Name=phone_number,Value="+15555551212" \ --message-action SUPPRESS ``` Ausgabe: ``` { "User": { "Username": "diego", "Attributes": [ { "Name": "sub", "Value": "7325c1de-b05b-4f84-b321-9adc6e61f4a2" }, { "Name": "phone_number", "Value": "+15555551212" }, { "Name": "email", "Value": "diego@example.com" } ], "UserCreateDate": 1548099495.428, "UserLastModifiedDate": 1548099495.428, "Enabled": true, "UserStatus": "FORCE_CHANGE_PASSWORD" } } ``` + Einzelheiten zur API finden Sie [AdminCreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-create-user.html)in der *AWS CLI Befehlsreferenz*. ### `admin-delete-user-attributes` Das folgende Codebeispiel zeigt die Verwendung`admin-delete-user-attributes`. **AWS CLI** **So löschen Sie ein Benutzerattribut** In diesem Beispiel wird das benutzerdefinierte Attribut CustomAttr 1 für den Benutzer diego@example.com gelöscht. Befehl: ``` aws cognito-idp admin-delete-user-attributes --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --user-attribute-names "custom:CustomAttr1" ``` + Einzelheiten zur API finden Sie [AdminDeleteUserAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-delete-user-attributes.html)in der *AWS CLI Befehlsreferenz.* ### `admin-delete-user` Das folgende Codebeispiel zeigt die Verwendung`admin-delete-user`. **AWS CLI** **So löschen Sie einen Benutzer** In diesem Beispiel wird ein Benutzer gelöscht. Befehl: ``` aws cognito-idp admin-delete-user --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com ``` + Einzelheiten zur API finden Sie [AdminDeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-delete-user.html)in der *AWS CLI Befehlsreferenz*. ### `admin-disable-provider-for-user` Das folgende Codebeispiel zeigt die Verwendung`admin-disable-provider-for-user`. **AWS CLI** **So heben Sie die Verknüpfung eines Verbundbenutzers mit einem lokalen Benutzerprofil auf** Im folgenden Beispiel für `admin-disable-provider-for-user` wird die Verknüpfung eines Google-Nutzers mit seinem verknüpften lokalen Profil aufgehoben. ``` aws cognito-idp admin-disable-provider-for-user \ --user-pool-id us-west-2_EXAMPLE \ --user ProviderAttributeName=Cognito_Subject,ProviderAttributeValue=0000000000000000,ProviderName=Google ``` Weitere Informationen finden Sie unter [Verknüpfen von Verbundbenutzern mit einem vorhandenen Benutzerprofil](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-identity-federation-consolidate-users.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AdminDisableProviderForUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-disable-provider-for-user.html)in der *AWS CLI Befehlsreferenz*. ### `admin-disable-user` Das folgende Codebeispiel zeigt die Verwendung`admin-disable-user`. **AWS CLI** **So verhindern Sie die Anmeldung durch einen Benutzer** Im folgenden Beispiel für `admin-disable-user` wird die Anmeldung durch den Benutzer `diego@example.com` verhindert. ``` aws cognito-idp admin-disable-user \ --user-pool-id us-west-2_EXAMPLE \ --username diego@example.com ``` Weitere Informationen finden Sie unter [Verwalten von Benutzern](https://docs.aws.amazon.com/cognito/latest/developerguide/managing-users.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AdminDisableUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-disable-user.html)in der *AWS CLI Befehlsreferenz*. ### `admin-enable-user` Das folgende Codebeispiel zeigt die Verwendung`admin-enable-user`. **AWS CLI** **So aktiveren Sie die Anmeldung durch einen Benutzer** Im folgenden Beispiel für `admin-enable-user` wird die Anmeldung durch den Benutzer diego@example.com aktiviert. ``` aws cognito-idp admin-enable-user \ --user-pool-id us-west-2_EXAMPLE \ --username diego@example.com ``` Weitere Informationen finden Sie unter [Verwalten von Benutzern](https://docs.aws.amazon.com/cognito/latest/developerguide/managing-users.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AdminEnableUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-enable-user.html)in der *AWS CLI Befehlsreferenz*. ### `admin-forget-device` Das folgende Codebeispiel zeigt die Verwendung`admin-forget-device`. **AWS CLI** **So verwerfen Sie ein Gerät** In diesem Beispiel wird das Gerät für den Benutzernamen jane@example.com verworfen. Befehl: ``` aws cognito-idp admin-forget-device --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com --device-key us-west-2_abcd_1234-5678 ``` + Einzelheiten zur API finden Sie [AdminForgetDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-forget-device.html)in der *AWS CLI Befehlsreferenz*. ### `admin-get-device` Das folgende Codebeispiel zeigt die Verwendung`admin-get-device`. **AWS CLI** **So rufen Sie ein Gerät ab** Im folgenden Beispiel für `admin-get-device` wird ein Gerät für den Benutzer `diego` angezeigt. ``` aws cognito-idp admin-get-device \ --user-pool-id us-west-2_EXAMPLE \ --username diego \ --device-key us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "Device": { "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeviceAttributes": [ { "Name": "device_status", "Value": "valid" }, { "Name": "device_name", "Value": "MyDevice" }, { "Name": "dev:device_arn", "Value": "arn:aws:cognito-idp:us-west-2:123456789012:owner/diego.us-west-2_EXAMPLE/device/us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, { "Name": "dev:device_owner", "Value": "diego.us-west-2_EXAMPLE" }, { "Name": "last_ip_used", "Value": "192.0.2.1" }, { "Name": "dev:device_remembered_status", "Value": "remembered" }, { "Name": "dev:device_sdk", "Value": "aws-sdk" } ], "DeviceCreateDate": 1715100742.022, "DeviceLastModifiedDate": 1723233651.167, "DeviceLastAuthenticatedDate": 1715100742.0 } } ``` Weitere Informationen finden Sie unter [Verwendung von Benutzergeräten in Ihrem Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-device-tracking.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AdminGetDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-get-device.html)in der *AWS CLI Befehlsreferenz*. ### `admin-get-user` Das folgende Codebeispiel zeigt die Verwendung`admin-get-user`. **AWS CLI** **So rufen Sie einen Benutzer ab** In diesem Beispiel werden Informationen zum Benutzernamen jane@example.com abgerufen. Befehl: ``` aws cognito-idp admin-get-user --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com ``` Ausgabe: ``` { "Username": "4320de44-2322-4620-999b-5e2e1c8df013", "Enabled": true, "UserStatus": "FORCE_CHANGE_PASSWORD", "UserCreateDate": 1548108509.537, "UserAttributes": [ { "Name": "sub", "Value": "4320de44-2322-4620-999b-5e2e1c8df013" }, { "Name": "email_verified", "Value": "true" }, { "Name": "phone_number_verified", "Value": "true" }, { "Name": "phone_number", "Value": "+01115551212" }, { "Name": "email", "Value": "jane@example.com" } ], "UserLastModifiedDate": 1548108509.537 } ``` + Einzelheiten zur API finden Sie [AdminGetUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-get-user.html)in der *AWS CLI Befehlsreferenz*. ### `admin-initiate-auth` Das folgende Codebeispiel zeigt die Verwendung`admin-initiate-auth`. **AWS CLI** **So melden Sie einen Benutzer als Administrator an** Im folgenden Beispiel für `admin-initiate-auth` wird der Benutzer diego@example.com angemeldet. Dieses Beispiel enthält auch Metadaten für den Bedrohungsschutz und ClientMetadata für Lambda-Trigger. Der Benutzer ist für TOTP MFA konfiguriert und erhält eine Aufforderung, einen Code von seiner Authenticator-App einzugeben, bevor er die Authentifizierung abschließen kann. ``` aws cognito-idp admin-initiate-auth \ --user-pool-id us-west-2_EXAMPLE \ --client-id 1example23456789 \ --auth-flow ADMIN_USER_PASSWORD_AUTH \ --auth-parameters USERNAME=diego@example.com,PASSWORD="My@Example$Password3!",SECRET_HASH=ExampleEncodedClientIdSecretAndUsername= \ --context-data="{\"EncodedData\":\"abc123example\",\"HttpHeaders\":[{\"headerName\":\"UserAgent\",\"headerValue\":\"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0\"}],\"IpAddress\":\"192.0.2.1\",\"ServerName\":\"example.com\",\"ServerPath\":\"/login\"}" \ --client-metadata="{\"MyExampleKey\": \"MyExampleValue\"}" ``` Ausgabe: ``` { "ChallengeName": "SOFTWARE_TOKEN_MFA", "Session": "AYABeExample...", "ChallengeParameters": { "FRIENDLY_DEVICE_NAME": "MyAuthenticatorApp", "USER_ID_FOR_SRP": "diego@example.com" } } ``` Weitere Informationen finden Sie unter [Ablauf der Administratorauthentifizierung](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-authentication-flow.html#amazon-cognito-user-pools-admin-authentication-flow) im *Entwicklerhandbuch für Amazon-Cognito*. + Einzelheiten zur API finden Sie [AdminInitiateAuth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-initiate-auth.html)in der *AWS CLI Befehlsreferenz.* ### `admin-link-provider-for-user` Das folgende Codebeispiel zeigt die Verwendung`admin-link-provider-for-user`. **AWS CLI** **So verknüpfen Sie einen lokalen Benutzer mit einem Verbundbenutzer** Im folgenden Beispiel für `admin-link-provider-for-user` wird der lokale Benutzer Diego mit einem Benutzer verknüpft, der die Verbundanmeldung mit Google durchführen wird. ``` aws cognito-idp admin-link-provider-for-user \ --user-pool-id us-west-2_EXAMPLE \ --destination-user ProviderName=Cognito,ProviderAttributeValue=diego \ --source-user ProviderAttributeName=Cognito_Subject,ProviderAttributeValue=0000000000000000,ProviderName=Google ``` Weitere Informationen finden Sie unter [Verknüpfen von Verbundbenutzern mit einem vorhandenen Benutzerprofil](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-identity-federation-consolidate-users.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AdminLinkProviderForUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-link-provider-for-user.html)in der *AWS CLI Befehlsreferenz*. ### `admin-list-devices` Das folgende Codebeispiel zeigt die Verwendung`admin-list-devices`. **AWS CLI** **So listen Sie alle Geräte für einen Benutzer auf** Im folgenden Beispiel für `admin-list-devices` werden die Geräte für den Benutzer Diego aufgelistet. ``` aws cognito-idp admin-list-devices \ --user-pool-id us-west-2_EXAMPLE \ --username diego \ --limit 1 ``` Ausgabe: ``` { "Devices": [ { "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeviceAttributes": [ { "Name": "device_status", "Value": "valid" }, { "Name": "device_name", "Value": "MyDevice" }, { "Name": "dev:device_arn", "Value": "arn:aws:cognito-idp:us-west-2:123456789012:owner/diego.us-west-2_EXAMPLE/device/us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, { "Name": "dev:device_owner", "Value": "diego.us-west-2_EXAMPLE" }, { "Name": "last_ip_used", "Value": "192.0.2.1" }, { "Name": "dev:device_remembered_status", "Value": "remembered" }, { "Name": "dev:device_sdk", "Value": "aws-sdk" } ], "DeviceCreateDate": 1715100742.022, "DeviceLastModifiedDate": 1723233651.167, "DeviceLastAuthenticatedDate": 1715100742.0 } ] } ``` Weitere Informationen finden Sie unter [Verwendung von Benutzergeräten in Ihrem Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-device-tracking.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AdminListDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-list-devices.html)in der *AWS CLI Befehlsreferenz*. ### `admin-list-groups-for-user` Das folgende Codebeispiel zeigt die Verwendung`admin-list-groups-for-user`. **AWS CLI** **So listen Sie Gruppen für einen Benutzer auf** In diesem Beispiel werden Gruppen für den Benutzernamen jane@example.com aufgeführt. Befehl: ``` aws cognito-idp admin-list-groups-for-user --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com ``` Ausgabe: ``` { "Groups": [ { "Description": "Sample group", "Precedence": 1, "LastModifiedDate": 1548097827.125, "RoleArn": "arn:aws:iam::111111111111:role/SampleRole", "GroupName": "SampleGroup", "UserPoolId": "us-west-2_aaaaaaaaa", "CreationDate": 1548097827.125 } ] } ``` + Einzelheiten zur API finden Sie [AdminListGroupsForUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-list-groups-for-user.html)in der *AWS CLI Befehlsreferenz*. ### `admin-list-user-auth-events` Das folgende Codebeispiel zeigt die Verwendung`admin-list-user-auth-events`. **AWS CLI** **So listen Sie Autorisierungsereignisse für einen Benutzer auf** Im folgenden Beispiel für `admin-list-user-auth-events` wird das letzte Ereignis im Benutzeraktivitätsprotokoll für den Benutzer Diego aufgeführt. ``` aws cognito-idp admin-list-user-auth-events \ --user-pool-id us-west-2_ywDJHlIfU \ --username brcotter+050123 \ --max-results 1 ``` Ausgabe: ``` { "AuthEvents": [ { "EventId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "EventType": "SignIn", "CreationDate": 1726694203.495, "EventResponse": "InProgress", "EventRisk": { "RiskDecision": "AccountTakeover", "RiskLevel": "Medium", "CompromisedCredentialsDetected": false }, "ChallengeResponses": [ { "ChallengeName": "Password", "ChallengeResponse": "Success" } ], "EventContextData": { "IpAddress": "192.0.2.1", "City": "Seattle", "Country": "United States" } } ], "NextToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222#2024-09-18T21:16:43.495Z" } ``` Weitere Informationen finden Sie unter [Anzeigen und Exportieren des Benutzerereignisverlaufs](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pool-settings-adaptive-authentication.html#user-pool-settings-adaptive-authentication-event-user-history) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AdminListUserAuthEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-list-user-auth-events.html)in der *AWS CLI Befehlsreferenz*. ### `admin-remove-user-from-group` Das folgende Codebeispiel zeigt die Verwendung`admin-remove-user-from-group`. **AWS CLI** **So entfernen Sie einen Benutzer aus einer Gruppe** In diesem Beispiel wird jane@example.com von entfernt SampleGroup. Befehl: ``` aws cognito-idp admin-remove-user-from-group --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com --group-name SampleGroup ``` + Einzelheiten zur API finden Sie [AdminRemoveUserFromGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-remove-user-from-group.html)in der *AWS CLI Befehlsreferenz*. ### `admin-reset-user-password` Das folgende Codebeispiel zeigt die Verwendung`admin-reset-user-password`. **AWS CLI** **So setzen Sie ein Benutzerpasswort zurück** In diesem Beispiel wird das Passwort für diego@example.com zurückgesetzt. Befehl: ``` aws cognito-idp admin-reset-user-password --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com ``` + Einzelheiten zur API finden Sie [AdminResetUserPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-reset-user-password.html)in der *AWS CLI Befehlsreferenz*. ### `admin-respond-to-auth-challenge` Das folgende Codebeispiel zeigt die Verwendung`admin-respond-to-auth-challenge`. **AWS CLI** **So reagieren Sie auf eine Authentifizierungsaufforderung** Abhängig von Ihrem Authentifizierungsablauf, der Konfiguration des Benutzerpools und den Benutzereinstellungen gibt es viele Möglichkeiten, auf unterschiedliche Authentifizierungsaufforderungen zu reagieren. Im folgenden Beispiel für `admin-respond-to-auth-challenge` wird ein TOTP-MFA-Code für diego@example.com bereitgestellt und die Anmeldung abgeschlossen. In diesem Benutzerpool ist die Geräteerkennung aktiviert, sodass das Authentifizierungsergebnis auch einen neuen Geräteschlüssel zurückgibt. ``` aws cognito-idp admin-respond-to-auth-challenge \ --user-pool-id us-west-2_EXAMPLE \ --client-id 1example23456789 \ --challenge-name SOFTWARE_TOKEN_MFA \ --challenge-responses USERNAME=diego@example.com,SOFTWARE_TOKEN_MFA_CODE=000000 \ --session AYABeExample... ``` Ausgabe: ``` { "ChallengeParameters": {}, "AuthenticationResult": { "AccessToken": "eyJra456defEXAMPLE", "ExpiresIn": 3600, "TokenType": "Bearer", "RefreshToken": "eyJra123abcEXAMPLE", "IdToken": "eyJra789ghiEXAMPLE", "NewDeviceMetadata": { "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeviceGroupKey": "-ExAmPlE1" } } } ``` Weitere Informationen finden Sie unter [Ablauf der Administratorauthentifizierung](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-authentication-flow.html#amazon-cognito-user-pools-admin-authentication-flow) im *Entwicklerhandbuch für Amazon-Cognito*. + Einzelheiten zur API finden Sie [AdminRespondToAuthChallenge](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-respond-to-auth-challenge.html)in der *AWS CLI Befehlsreferenz*. ### `admin-set-user-mfa-preference` Das folgende Codebeispiel zeigt die Verwendung`admin-set-user-mfa-preference`. **AWS CLI** **So legen Sie die Benutzer-MFA-Einstellung fest** In diesem Beispiel wird die SMS-MFA-Einstellung für den Benutzernamen diego@example.com festgelegt. Befehl: ``` aws cognito-idp admin-set-user-mfa-preference --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --sms-mfa-settings Enabled=false,PreferredMfa=false ``` + Einzelheiten zur API finden Sie [AdminSetUserMfaPreference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-set-user-mfa-preference.html)in der *AWS CLI Befehlsreferenz*. ### `admin-set-user-password` Das folgende Codebeispiel zeigt die Verwendung`admin-set-user-password`. **AWS CLI** **So legen Sie ein Benutzerpasswort als Administrator fest** Im folgenden Beispiel für `admin-set-user-password` wird das Passwort für diego@example.com dauerhaft festgelegt. ``` aws cognito-idp admin-set-user-password \ --user-pool-id us-west-2_EXAMPLE \ --username diego@example.com \ --password MyExamplePassword1! \ --permanent ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Passwörter, Passwortwiederherstellung und Passwortrichtlinien](https://docs.aws.amazon.com/cognito/latest/developerguide/managing-users-passwords.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AdminSetUserPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-set-user-password.html)in der *AWS CLI Befehlsreferenz*. ### `admin-set-user-settings` Das folgende Codebeispiel zeigt die Verwendung`admin-set-user-settings`. **AWS CLI** **So legen Sie Benutzereinstellungen fest** In diesem Beispiel wird die MFA-Bereitstellungseinstellung für den Benutzernamen diego@example.com auf EMAIL festgelegt. Befehl: ``` aws cognito-idp admin-set-user-settings --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --mfa-options DeliveryMedium=EMAIL ``` + Einzelheiten zur API finden Sie [AdminSetUserSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-set-user-settings.html)in der *AWS CLI Befehlsreferenz*. ### `admin-update-auth-event-feedback` Das folgende Codebeispiel zeigt die Verwendung`admin-update-auth-event-feedback`. **AWS CLI** **So geben Sie Feedback zu einem Autorisierungsereignis** In diesem Beispiel wird der Feedback-Wert für ein durch event-id identifiziertes Autorisierungsereignis auf „Valid“ festgelegt. Befehl: ``` aws cognito-idp admin-update-auth-event-feedback --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --event-id c2c2cf89-c0d3-482d-aba6-99d78a5b0bfe --feedback-value Valid ``` + Einzelheiten zur API finden Sie [AdminUpdateAuthEventFeedback](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-update-auth-event-feedback.html)in der *AWS CLI Befehlsreferenz*. ### `admin-update-device-status` Das folgende Codebeispiel zeigt die Verwendung`admin-update-device-status`. **AWS CLI** **So aktualisieren Sie den Gerätestatus** In diesem Beispiel wird der Status für die Geräteerkennung für das Gerät, das durch device-key identifiziert wird, auf „not\$1remembered“ festgelegt. Befehl: ``` aws cognito-idp admin-update-device-status --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --device-key xxxx --device-remembered-status not_remembered ``` + Einzelheiten zur API finden Sie [AdminUpdateDeviceStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-update-device-status.html)in der *AWS CLI Befehlsreferenz*. ### `admin-update-user-attributes` Das folgende Codebeispiel zeigt die Verwendung`admin-update-user-attributes`. **AWS CLI** **So aktualisieren Sie Benutzerattribute** In diesem Beispiel wird ein benutzerdefiniertes Benutzerattribut CustomAttr 1 für den Benutzer diego@example.com aktualisiert. Befehl: ``` aws cognito-idp admin-update-user-attributes --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --user-attributes Name="custom:CustomAttr1",Value="Purple" ``` + Einzelheiten zur API finden Sie [AdminUpdateUserAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-update-user-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `admin-user-global-sign-out` Das folgende Codebeispiel zeigt die Verwendung`admin-user-global-sign-out`. **AWS CLI** **So melden Sie einen Benutzer als Administrator ab** Im folgenden Beispiel für `admin-user-global-sign-out` wird der Benutzer diego@example.com abgemeldet. ``` aws cognito-idp admin-user-global-sign-out \ --user-pool-id us-west-2_EXAMPLE \ --username diego@example.com ``` Weitere Informationen finden Sie unter [Authentifizierung mit einem Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/authentication.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AdminUserGlobalSignOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/admin-user-global-sign-out.html)in der *AWS CLI Befehlsreferenz*. ### `associate-software-token` Das folgende Codebeispiel zeigt die Verwendung`associate-software-token`. **AWS CLI** **So generieren Sie einen geheimen Schlüssel für eine MFA-Authenticator-App** Im folgenden Beispiel für `associate-software-token` wird ein privater TOTP-Schlüssel für einen Benutzer generiert, der sich angemeldet und ein Zugriffstoken erhalten hat. Der resultierende private Schlüssel kann manuell in eine Authenticator-App eingegeben werden oder Anwendungen können ihn als QR-Code rendern, den der Benutzer scannen kann. ``` aws cognito-idp associate-software-token \ --access-token eyJra456defEXAMPLE ``` Ausgabe: ``` { "SecretCode": "QWERTYUIOP123456EXAMPLE" } ``` Weitere Informationen finden Sie unter [TOTP-Software-Token-MFA](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-mfa-totp.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [AssociateSoftwareToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/associate-software-token.html)in der *AWS CLI Befehlsreferenz*. ### `change-password` Das folgende Codebeispiel zeigt die Verwendung`change-password`. **AWS CLI** **So ändern Sie ein Passwort** In diesem Beispiel wird ein Passwort geändert. Befehl: ``` aws cognito-idp change-password --previous-password OldPassword --proposed-password NewPassword --access-token ACCESS_TOKEN ``` + Einzelheiten zur API finden Sie [ChangePassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/change-password.html)in der *AWS CLI Befehlsreferenz*. ### `confirm-device` Das folgende Codebeispiel zeigt die Verwendung`confirm-device`. **AWS CLI** **So bestätigen Sie ein Benutzergerät** Im folgenden Beispiel für `confirm-device` wird dem aktuellen Benutzer ein neues Gerät hinzugefügt, das erkannt werden kann. ``` aws cognito-idp confirm-device \ --access-token eyJra456defEXAMPLE \ --device-key us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --device-secret-verifier-config PasswordVerifier=TXlWZXJpZmllclN0cmluZw,Salt=TXlTUlBTYWx0 ``` Ausgabe: ``` { "UserConfirmationNecessary": false } ``` Weitere Informationen finden Sie unter [Verwendung von Benutzergeräten in Ihrem Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-device-tracking.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ConfirmDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/confirm-device.html)in der *AWS CLI Befehlsreferenz*. ### `confirm-forgot-password` Das folgende Codebeispiel zeigt die Verwendung`confirm-forgot-password`. **AWS CLI** **So bestätigen Sie ein vergessenes Passwort** In diesem Beispiel wird ein vergessenes Passwort für den Benutzernamen diego@example.com bestätigt. Befehl: ``` aws cognito-idp confirm-forgot-password --client-id 3n4b5urk1ft4fl3mg5e62d9ado --username=diego@example.com --password PASSWORD --confirmation-code CONF_CODE ``` + Einzelheiten zur API finden Sie [ConfirmForgotPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/confirm-forgot-password.html)in der *AWS CLI Befehlsreferenz*. ### `confirm-sign-up` Das folgende Codebeispiel zeigt die Verwendung`confirm-sign-up`. **AWS CLI** **So bestätigen Sie die Registrierung** In diesem Beispiel wird die Registrierung des Benutzernamens diego@example.com bestätigt. Befehl: ``` aws cognito-idp confirm-sign-up --client-id 3n4b5urk1ft4fl3mg5e62d9ado --username=diego@example.com --confirmation-code CONF_CODE ``` + Einzelheiten zur API finden Sie [ConfirmSignUp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/confirm-sign-up.html)in der *AWS CLI Befehlsreferenz*. ### `create-group` Das folgende Codebeispiel zeigt die Verwendung`create-group`. **AWS CLI** **So erstellen Sie eine Gruppe** In diesem Beispiel wird eine Gruppe mit einer Beschreibung erstellt. Befehl: ``` aws cognito-idp create-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyNewGroup --description "New group." ``` Ausgabe: ``` { "Group": { "GroupName": "MyNewGroup", "UserPoolId": "us-west-2_aaaaaaaaa", "Description": "New group.", "LastModifiedDate": 1548270073.795, "CreationDate": 1548270073.795 } } ``` **So erstellen Sie eine Gruppe mit einer Rolle und Priorität** In diesem Beispiel wird eine Gruppe mit einer Beschreibung erstellt. Sie enthält außerdem eine Rolle und eine Priorität. Befehl: ``` aws cognito-idp create-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyNewGroupWithRole --description "New group with a role." --role-arn arn:aws:iam::111111111111:role/MyNewGroupRole --precedence 2 ``` Ausgabe: ``` { "Group": { "GroupName": "MyNewGroupWithRole", "UserPoolId": "us-west-2_aaaaaaaaa", "Description": "New group with a role.", "RoleArn": "arn:aws:iam::111111111111:role/MyNewGroupRole", "Precedence": 2, "LastModifiedDate": 1548270211.761, "CreationDate": 1548270211.761 } } ``` + Einzelheiten zur API finden Sie [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/create-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-identity-provider` Das folgende Codebeispiel zeigt die Verwendung`create-identity-provider`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Benutzerpool-SAML-Identitätsanbieter (IDP) mit einer Metadaten-URL** Im folgenden Beispiel für `create-identity-provider` wird ein neuer SAML-IDP mit Metadaten aus einer öffentlichen URL, einer Attributzuordnung und zwei Bezeichnern erstellt. ``` aws cognito-idp create-identity-provider \ --user-pool-id us-west-2_EXAMPLE \ --provider-name MySAML \ --provider-type SAML \ --provider-details IDPInit=true,IDPSignout=true,EncryptedResponses=true,MetadataURL=https://auth.example.com/sso/saml/metadata,RequestSigningAlgorithm=rsa-sha256 \ --attribute-mapping email=emailaddress,phone_number=phone,custom:111=department \ --idp-identifiers CorpSAML WestSAML ``` Ausgabe: ``` { "IdentityProvider": { "UserPoolId": "us-west-2_EXAMPLE", "ProviderName": "MySAML", "ProviderType": "SAML", "ProviderDetails": { "ActiveEncryptionCertificate": "MIICvTCCAaEXAMPLE", "EncryptedResponses": "true", "IDPInit": "true", "IDPSignout": "true", "MetadataURL": "https://auth.example.com/sso/saml/metadata", "RequestSigningAlgorithm": "rsa-sha256", "SLORedirectBindingURI": "https://auth.example.com/slo/saml", "SSORedirectBindingURI": "https://auth.example.com/sso/saml" }, "AttributeMapping": { "custom:111": "department", "emailaddress": "email", "phone": "phone_number" }, "IdpIdentifiers": [ "CorpSAML", "WestSAML" ], "LastModifiedDate": 1726853833.977, "CreationDate": 1726853833.977 } } ``` Weitere Informationen finden Sie unter [Hinzufügen der Benutzerpoolanmeldung über einen Drittanbieter](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-identity-federation.html) im *Entwicklerhandbuch für Amazon Cognito*. **Beispiel 2: So erstellen Sie einen Benutzerpool-SAML-Identitätsanbieter (IdP) mit einer Metadaten-Datei** Im folgenden Beispiel für `create-identity-provider` wird ein neuer SAML-IDP mit Metadaten aus einer Datei, einer Attributzuordnung und zwei Bezeichnern erstellt. Die Dateisyntax kann sich je nach Betriebssystem im Hinblick auf den Parameter `--provider-details` unterscheiden. Es ist am einfachsten, eine JSON-Eingabedatei für diesen Vorgang zu erstellen. ``` aws cognito-idp create-identity-provider \ --cli-input-json file://.\SAML-identity-provider.json ``` Inhalt von `SAML-identity-provider.json`: ``` { "AttributeMapping": { "email" : "idp_email", "email_verified" : "idp_email_verified" }, "IdpIdentifiers": [ "platform" ], "ProviderDetails": { "MetadataFile": "[IDP_CERTIFICATE_DATA]urn:oasis:names:tc:SAML:1.1:nameid-format:unspecifiedurn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress", "IDPSignout" : "true", "RequestSigningAlgorithm" : "rsa-sha256", "EncryptedResponses" : "true", "IDPInit" : "true" }, "ProviderName": "MySAML2", "ProviderType": "SAML", "UserPoolId": "us-west-2_EXAMPLE" } ``` Ausgabe: ``` { "IdentityProvider": { "UserPoolId": "us-west-2_EXAMPLE", "ProviderName": "MySAML2", "ProviderType": "SAML", "ProviderDetails": { "ActiveEncryptionCertificate": "[USER_POOL_ENCRYPTION_CERTIFICATE_DATA]", "EncryptedResponses": "true", "IDPInit": "true", "IDPSignout": "true", "MetadataFile": "[IDP_CERTIFICATE_DATA]urn:oasis:names:tc:SAML:1.1:nameid-format:unspecifiedurn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress", "RequestSigningAlgorithm": "rsa-sha256", "SLORedirectBindingURI": "https://www.example.com/slo/saml", "SSORedirectBindingURI": "https://www.example.com/sso/saml" }, "AttributeMapping": { "email": "idp_email", "email_verified": "idp_email_verified" }, "IdpIdentifiers": [ "platform" ], "LastModifiedDate": 1726855290.731, "CreationDate": 1726855290.731 } } ``` Weitere Informationen finden Sie unter [Hinzufügen der Benutzerpoolanmeldung über einen Drittanbieter](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-identity-federation.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [CreateIdentityProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/create-identity-provider.html)in der *AWS CLI Befehlsreferenz*. ### `create-resource-server` Das folgende Codebeispiel zeigt die Verwendung`create-resource-server`. **AWS CLI** **So erstellen Sie einen Benutzerpoolclient** Im folgenden Beispiel für `create-resource-server` wird ein neuer Ressourcenserver mit benutzerdefinierten Bereichen erstellt. ``` aws cognito-idp create-resource-server \ --user-pool-id us-west-2_EXAMPLE \ --identifier solar-system-data \ --name "Solar system object tracker" \ --scopes ScopeName=sunproximity.read,ScopeDescription="Distance in AU from Sol" ScopeName=asteroids.add,ScopeDescription="Enter a new asteroid" ``` Ausgabe: ``` { "ResourceServer": { "UserPoolId": "us-west-2_EXAMPLE", "Identifier": "solar-system-data", "Name": "Solar system object tracker", "Scopes": [ { "ScopeName": "sunproximity.read", "ScopeDescription": "Distance in AU from Sol" }, { "ScopeName": "asteroids.add", "ScopeDescription": "Enter a new asteroid" } ] } } ``` Weitere Informationen finden Sie unter [Bereiche, M2M und APIs mit Ressourcenservern](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-define-resource-servers.html) im *Amazon Cognito* Developer Guide. + *Einzelheiten zur API finden Sie [CreateResourceServer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/create-resource-server.html)in AWS CLI der Befehlsreferenz.* ### `create-user-import-job` Das folgende Codebeispiel zeigt die Verwendung`create-user-import-job`. **AWS CLI** **So erstellen Sie einen Benutzerimportauftrag** In diesem Beispiel wird ein Benutzerimportauftrag mit dem Namen erstellt MyImportJob. Weitere Informationen zum Importieren von Benutzern finden Sie unter „Importieren von Benutzern aus einer CSV-Datei in Benutzerpools“. Befehl: ``` aws cognito-idp create-user-import-job --user-pool-id us-west-2_aaaaaaaaa --job-name MyImportJob --cloud-watch-logs-role-arn arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole ``` Ausgabe: ``` { "UserImportJob": { "JobName": "MyImportJob", "JobId": "import-qQ0DCt2fRh", "UserPoolId": "us-west-2_aaaaaaaaa", "PreSignedUrl": "PRE_SIGNED_URL", "CreationDate": 1548271795.471, "Status": "Created", "CloudWatchLogsRoleArn": "arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole", "ImportedUsers": 0, "SkippedUsers": 0, "FailedUsers": 0 } } ``` Laden Sie die CSV-Datei mit curl hoch und verwenden Sie dabei die vorsignierte URL: Befehl: ``` curl -v -T "PATH_TO_CSV_FILE" -H "x-amz-server-side-encryption:aws:kms" "PRE_SIGNED_URL" ``` + Einzelheiten zur API finden Sie [CreateUserImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/create-user-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `create-user-pool-client` Das folgende Codebeispiel zeigt die Verwendung`create-user-pool-client`. **AWS CLI** **So erstellen Sie einen Benutzerpoolclient** Im folgenden `create-user-pool-client` Beispiel wird ein neuer Benutzerpool-Client mit einem geheimen Client-Schlüssel, expliziten Lese- und Schreibattributen, Anmeldung mit Benutzername-Passwort und SRP-Flows, Anmeldung mit drei, Zugriff auf eine Teilmenge von OAuth Bereichen IdPs, PinPoint Analysen und einer erweiterten Gültigkeitsdauer der Authentifizierungssitzung erstellt. ``` aws cognito-idp create-user-pool-client \ --user-pool-id us-west-2_EXAMPLE \ --client-name MyTestClient \ --generate-secret \ --refresh-token-validity 10 \ --access-token-validity 60 \ --id-token-validity 60 \ --token-validity-units AccessToken=minutes,IdToken=minutes,RefreshToken=days \ --read-attributes email phone_number email_verified phone_number_verified \ --write-attributes email phone_number \ --explicit-auth-flows ALLOW_USER_PASSWORD_AUTH ALLOW_USER_SRP_AUTH ALLOW_REFRESH_TOKEN_AUTH \ --supported-identity-providers Google Facebook MyOIDC \ --callback-urls https://www.amazon.com https://example.com http://localhost:8001 myapp://example \ --allowed-o-auth-flows code implicit \ --allowed-o-auth-scopes openid profile aws.cognito.signin.user.admin solar-system-data/asteroids.add \ --allowed-o-auth-flows-user-pool-client \ --analytics-configuration ApplicationArn=arn:aws:mobiletargeting:us-west-2:767671399759:apps/thisisanexamplepinpointapplicationid,UserDataShared=TRUE \ --prevent-user-existence-errors ENABLED \ --enable-token-revocation \ --enable-propagate-additional-user-context-data \ --auth-session-validity 4 ``` Ausgabe: ``` { "UserPoolClient": { "UserPoolId": "us-west-2_EXAMPLE", "ClientName": "MyTestClient", "ClientId": "123abc456defEXAMPLE", "ClientSecret": "this1234is5678my91011example1213client1415secret", "LastModifiedDate": 1726788459.464, "CreationDate": 1726788459.464, "RefreshTokenValidity": 10, "AccessTokenValidity": 60, "IdTokenValidity": 60, "TokenValidityUnits": { "AccessToken": "minutes", "IdToken": "minutes", "RefreshToken": "days" }, "ReadAttributes": [ "email_verified", "phone_number_verified", "phone_number", "email" ], "WriteAttributes": [ "phone_number", "email" ], "ExplicitAuthFlows": [ "ALLOW_USER_PASSWORD_AUTH", "ALLOW_USER_SRP_AUTH", "ALLOW_REFRESH_TOKEN_AUTH" ], "SupportedIdentityProviders": [ "Google", "MyOIDC", "Facebook" ], "CallbackURLs": [ "https://example.com", "https://www.amazon.com", "myapp://example", "http://localhost:8001" ], "AllowedOAuthFlows": [ "implicit", "code" ], "AllowedOAuthScopes": [ "aws.cognito.signin.user.admin", "openid", "profile", "solar-system-data/asteroids.add" ], "AllowedOAuthFlowsUserPoolClient": true, "AnalyticsConfiguration": { "ApplicationArn": "arn:aws:mobiletargeting:us-west-2:123456789012:apps/thisisanexamplepinpointapplicationid", "RoleArn": "arn:aws:iam::123456789012:role/aws-service-role/cognito-idp.amazonaws.com/AWSServiceRoleForAmazonCognitoIdp", "UserDataShared": true }, "PreventUserExistenceErrors": "ENABLED", "EnableTokenRevocation": true, "EnablePropagateAdditionalUserContextData": true, "AuthSessionValidity": 4 } } ``` Weitere Informationen finden Sie unter [Anwendungsspezifische Einstellungen mit App-Clients](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html) im *Entwicklerhandbuch für Amazon Cognito*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [CreateUserPoolClient](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/create-user-pool-client.html)AWS CLI * ### `create-user-pool-domain` Das folgende Codebeispiel zeigt die Verwendung`create-user-pool-domain`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Benutzerpooldomain** Im folgenden Beispiel für `create-user-pool-domain` wird eine neue benutzerdefinierte Domain erstellt. ``` aws cognito-idp create-user-pool-domain \ --user-pool-id us-west-2_EXAMPLE \ --domain auth.example.com \ --custom-domain-config CertificateArn=arn:aws:acm:us-east-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 ``` Ausgabe: ``` { "CloudFrontDomain": "example1domain.cloudfront.net" } ``` Weitere Informationen finden Sie unter [Konfigurieren einer Benutzerpooldomain](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-assign-domain.html) im *Entwicklerhandbuch für Amazon Cognito*. **Beispiel 2: So erstellen Sie eine Benutzerpooldomain** Im folgenden Beispiel für `create-user-pool-domain` wird eine neue Domain mit einem serviceeigenen Präfix erstellt. ``` aws cognito-idp create-user-pool-domain \ --user-pool-id us-west-2_EXAMPLE2 \ --domain mydomainprefix ``` Weitere Informationen finden Sie unter [Konfigurieren einer Benutzerpooldomain](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-assign-domain.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [CreateUserPoolDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/create-user-pool-domain.html)in der *AWS CLI Befehlsreferenz*. ### `create-user-pool` Das folgende Codebeispiel zeigt die Verwendung`create-user-pool`. **AWS CLI** **So erstellen Sie einen minimal konfigurierten Benutzerpool** In diesem Beispiel wird ein Benutzerpool erstellt, der MyUserPool anhand von Standardwerten benannt wird. Es gibt keine erforderlichen Attribute und keine Anwendungsclients. MFA und erweiterte Sicherheit sind deaktiviert. Befehl: ``` aws cognito-idp create-user-pool --pool-name MyUserPool ``` Ausgabe: ``` { "UserPool": { "SchemaAttributes": [ { "Name": "sub", "StringAttributeConstraints": { "MinLength": "1", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": true, "AttributeDataType": "String", "Mutable": false }, { "Name": "name", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "given_name", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "family_name", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "middle_name", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "nickname", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "preferred_username", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "profile", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "picture", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "website", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "email", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "AttributeDataType": "Boolean", "DeveloperOnlyAttribute": false, "Required": false, "Name": "email_verified", "Mutable": true }, { "Name": "gender", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "birthdate", "StringAttributeConstraints": { "MinLength": "10", "MaxLength": "10" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "zoneinfo", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "locale", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "phone_number", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "AttributeDataType": "Boolean", "DeveloperOnlyAttribute": false, "Required": false, "Name": "phone_number_verified", "Mutable": true }, { "Name": "address", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "updated_at", "NumberAttributeConstraints": { "MinValue": "0" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "Number", "Mutable": true } ], "MfaConfiguration": "OFF", "Name": "MyUserPool", "LastModifiedDate": 1547833345.777, "AdminCreateUserConfig": { "UnusedAccountValidityDays": 7, "AllowAdminCreateUserOnly": false }, "EmailConfiguration": {}, "Policies": { "PasswordPolicy": { "RequireLowercase": true, "RequireSymbols": true, "RequireNumbers": true, "MinimumLength": 8, "RequireUppercase": true } }, "CreationDate": 1547833345.777, "EstimatedNumberOfUsers": 0, "Id": "us-west-2_aaaaaaaaa", "LambdaConfig": {} } } ``` **So erstellen Sie einen Benutzerpool mit zwei erforderlichen Attributen** In diesem Beispiel wird ein Benutzerpool erstellt MyUserPool. Der Pool ist so konfiguriert, dass er E-Mail-Adressen als Benutzernamensattribut akzeptiert. Außerdem wird die E-Mail-Quelladresse mit Amazon Simple Email Service auf eine validierte Adresse gesetzt. Befehl: ``` aws cognito-idp create-user-pool --pool-name MyUserPool --username-attributes "email" --email-configuration=SourceArn="arn:aws:ses:us-east-1:111111111111:identity/jane@example.com",ReplyToEmailAddress="jane@example.com" ``` Ausgabe: ``` { "UserPool": { "SchemaAttributes": [ { "Name": "sub", "StringAttributeConstraints": { "MinLength": "1", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": true, "AttributeDataType": "String", "Mutable": false }, { "Name": "name", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "given_name", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "family_name", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "middle_name", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "nickname", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "preferred_username", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "profile", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "picture", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "website", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "email", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "AttributeDataType": "Boolean", "DeveloperOnlyAttribute": false, "Required": false, "Name": "email_verified", "Mutable": true }, { "Name": "gender", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "birthdate", "StringAttributeConstraints": { "MinLength": "10", "MaxLength": "10" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "zoneinfo", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "locale", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "phone_number", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "AttributeDataType": "Boolean", "DeveloperOnlyAttribute": false, "Required": false, "Name": "phone_number_verified", "Mutable": true }, { "Name": "address", "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "String", "Mutable": true }, { "Name": "updated_at", "NumberAttributeConstraints": { "MinValue": "0" }, "DeveloperOnlyAttribute": false, "Required": false, "AttributeDataType": "Number", "Mutable": true } ], "MfaConfiguration": "OFF", "Name": "MyUserPool", "LastModifiedDate": 1547837788.189, "AdminCreateUserConfig": { "UnusedAccountValidityDays": 7, "AllowAdminCreateUserOnly": false }, "EmailConfiguration": { "ReplyToEmailAddress": "jane@example.com", "SourceArn": "arn:aws:ses:us-east-1:111111111111:identity/jane@example.com" }, "Policies": { "PasswordPolicy": { "RequireLowercase": true, "RequireSymbols": true, "RequireNumbers": true, "MinimumLength": 8, "RequireUppercase": true } }, "UsernameAttributes": [ "email" ], "CreationDate": 1547837788.189, "EstimatedNumberOfUsers": 0, "Id": "us-west-2_aaaaaaaaa", "LambdaConfig": {} } } ``` + Einzelheiten zur API finden Sie [CreateUserPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/create-user-pool.html)in der *AWS CLI Befehlsreferenz*. ### `delete-group` Das folgende Codebeispiel zeigt die Verwendung`delete-group`. **AWS CLI** **Um eine Gruppe zu löschen** In diesem Beispiel wird eine Gruppe gelöscht. Befehl: ``` aws cognito-idp delete-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyGroupName ``` + Einzelheiten zur API finden Sie [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/delete-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-identity-provider` Das folgende Codebeispiel zeigt die Verwendung`delete-identity-provider`. **AWS CLI** **So löschen Sie einen Identitätsanbieter** In diesem Beispiel wird ein Identitätsanbieter gelöscht. Befehl: ``` aws cognito-idp delete-identity-provider --user-pool-id us-west-2_aaaaaaaaa --provider-name Facebook ``` + Einzelheiten zur API finden Sie [DeleteIdentityProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/delete-identity-provider.html)in der *AWS CLI Befehlsreferenz*. ### `delete-resource-server` Das folgende Codebeispiel zeigt die Verwendung`delete-resource-server`. **AWS CLI** **So löschen Sie einen Ressourcenserver** In diesem Beispiel wird ein Ressourcenserver mit dem Namen weather.example.com gelöscht. Befehl: ``` aws cognito-idp delete-resource-server --user-pool-id us-west-2_aaaaaaaaa --identifier weather.example.com ``` + Einzelheiten zur API finden Sie [DeleteResourceServer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/delete-resource-server.html)in der *AWS CLI Befehlsreferenz*. ### `delete-user-attributes` Das folgende Codebeispiel zeigt die Verwendung`delete-user-attributes`. **AWS CLI** **So löschen Sie ein Benutzerattribut** Im folgenden Beispiel für `delete-user-attributes` wird das benutzerdefinierte Attribut „custom:attribute“ des aktuell angemeldeten Benutzers gelöscht. ``` aws cognito-idp delete-user-attributes \ --access-token ACCESS_TOKEN \ --user-attribute-names "custom:department" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit Benutzerattributen](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-attributes.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [DeleteUserAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/delete-user-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `delete-user-pool-client` Das folgende Codebeispiel zeigt die Verwendung`delete-user-pool-client`. **AWS CLI** **So löschen Sie einen Benutzerpoolclient** In diesem Beispiel wird ein Benutzerpoolclient gelöscht. Befehl: ``` aws cognito-idp delete-user-pool-client --user-pool-id us-west-2_aaaaaaaaa --client-id 38fjsnc484p94kpqsnet7mpld0 ``` + Einzelheiten zur API finden Sie [DeleteUserPoolClient](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/delete-user-pool-client.html)in der *AWS CLI Befehlsreferenz*. ### `delete-user-pool-domain` Das folgende Codebeispiel zeigt die Verwendung`delete-user-pool-domain`. **AWS CLI** **So löschen Sie eine Benutzerpooldomain** Im folgenden Beispiel für `delete-user-pool-domain` wird eine Benutzerpooldomain namens `my-domain` gelöscht. ``` aws cognito-idp delete-user-pool-domain \ --user-pool-id us-west-2_aaaaaaaaa \ --domain my-domain ``` + Einzelheiten zur API finden Sie [DeleteUserPoolDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/delete-user-pool-domain.html)in der *AWS CLI Befehlsreferenz*. ### `delete-user-pool` Das folgende Codebeispiel zeigt die Verwendung`delete-user-pool`. **AWS CLI** **Um einen Benutzerpool zu löschen** In diesem Beispiel wird ein Benutzerpool mit der Benutzerpool-ID us-west-2\$1aaaaaaaaa gelöscht. Befehl: ``` aws cognito-idp delete-user-pool --user-pool-id us-west-2_aaaaaaaaa ``` + Einzelheiten zur API finden Sie [DeleteUserPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/delete-user-pool.html)in der *AWS CLI Befehlsreferenz*. ### `delete-user` Das folgende Codebeispiel zeigt die Verwendung`delete-user`. **AWS CLI** **So löschen Sie einen Benutzer** In diesem Beispiel wird ein Benutzer gelöscht. Befehl: ``` aws cognito-idp delete-user --access-token ACCESS_TOKEN ``` + Einzelheiten zur API finden Sie [DeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/delete-user.html)in der *AWS CLI Befehlsreferenz*. ### `describe-identity-provider` Das folgende Codebeispiel zeigt die Verwendung`describe-identity-provider`. **AWS CLI** **So beschreiben Sie einen Identitätsanbieter** Dieses Beispiel beschreibt einen Identitätsanbieter namens Facebook. Befehl: ``` aws cognito-idp describe-identity-provider --user-pool-id us-west-2_aaaaaaaaa --provider-name Facebook ``` Ausgabe: ``` { "IdentityProvider": { "UserPoolId": "us-west-2_aaaaaaaaa", "ProviderName": "Facebook", "ProviderType": "Facebook", "ProviderDetails": { "attributes_url": "https://graph.facebook.com/me?fields=", "attributes_url_add_attributes": "true", "authorize_scopes": myscope", "authorize_url": "https://www.facebook.com/v2.9/dialog/oauth", "client_id": "11111", "client_secret": "11111", "token_request_method": "GET", "token_url": "https://graph.facebook.com/v2.9/oauth/access_token" }, "AttributeMapping": { "username": "id" }, "IdpIdentifiers": [], "LastModifiedDate": 1548105901.736, "CreationDate": 1548105901.736 } } ``` + Einzelheiten zur API finden Sie [DescribeIdentityProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/describe-identity-provider.html)in der *AWS CLI Befehlsreferenz*. ### `describe-resource-server` Das folgende Codebeispiel zeigt die Verwendung`describe-resource-server`. **AWS CLI** **So beschreiben Sie einen Ressourcenserver** In diesem Beispiel wird ein Ressourcenserver mit dem Namen weather.example.com beschrieben. Befehl: ``` aws cognito-idp describe-resource-server --user-pool-id us-west-2_aaaaaaaaa --identifier weather.example.com ``` Ausgabe: ``` { "ResourceServer": { "UserPoolId": "us-west-2_aaaaaaaaa", "Identifier": "weather.example.com", "Name": "Weather", "Scopes": [ { "ScopeName": "weather.update", "ScopeDescription": "Update weather forecast" }, { "ScopeName": "weather.read", "ScopeDescription": "Read weather forecasts" }, { "ScopeName": "weather.delete", "ScopeDescription": "Delete a weather forecast" } ] } } ``` + Einzelheiten zur API finden Sie [DescribeResourceServer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/describe-resource-server.html)in der *AWS CLI Befehlsreferenz*. ### `describe-risk-configuration` Das folgende Codebeispiel zeigt die Verwendung`describe-risk-configuration`. **AWS CLI** **So beschreiben Sie eine Risikokonfiguration** In diesem Beispiel wird die Risikokonfiguration im Zusammenhang mit Pool us-west-2\$1aaaaaaaaa beschrieben. Befehl: ``` aws cognito-idp describe-risk-configuration --user-pool-id us-west-2_aaaaaaaaa ``` Ausgabe: ``` { "RiskConfiguration": { "UserPoolId": "us-west-2_aaaaaaaaa", "CompromisedCredentialsRiskConfiguration": { "EventFilter": [ "SIGN_IN", "SIGN_UP", "PASSWORD_CHANGE" ], "Actions": { "EventAction": "BLOCK" } }, "AccountTakeoverRiskConfiguration": { "NotifyConfiguration": { "From": "diego@example.com", "ReplyTo": "diego@example.com", "SourceArn": "arn:aws:ses:us-east-1:111111111111:identity/diego@example.com", "BlockEmail": { "Subject": "Blocked sign-in attempt", "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n
We blocked an unrecognized sign-in to your account with this information:\n
    \n
  • Time: {login-time}
    • \n
  • Device: {device-name}
    • \n
  • Location: {city}, {country}
    • \n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know
\n\n", "TextBody": "We blocked an unrecognized sign-in to your account with this information:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" }, "NoActionEmail": { "Subject": "New sign-in attempt", "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n
We observed an unrecognized sign-in to your account with this information:\n
    \n
  • Time: {login-time}
    • \n
  • Device: {device-name}
    • \n
  • Location: {city}, {country}
    • \n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know
\n\n", "TextBody": "We observed an unrecognized sign-in to your account with this information:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" }, "MfaEmail": { "Subject": "New sign-in attempt", "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n
We required you to use multi-factor authentication for the following sign-in attempt:\n
    \n
  • Time: {login-time}
    • \n
  • Device: {device-name}
    • \n
  • Location: {city}, {country}
    • \n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know
\n\n", "TextBody": "We required you to use multi-factor authentication for the following sign-in attempt:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" } }, "Actions": { "LowAction": { "Notify": true, "EventAction": "NO_ACTION" }, "MediumAction": { "Notify": true, "EventAction": "MFA_IF_CONFIGURED" }, "HighAction": { "Notify": true, "EventAction": "MFA_IF_CONFIGURED" } } } } } ``` + Einzelheiten zur API finden Sie [DescribeRiskConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/describe-risk-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `describe-user-import-job` Das folgende Codebeispiel zeigt die Verwendung`describe-user-import-job`. **AWS CLI** **So beschreiben Sie einen Benutzerimportauftrag** In diesem Beispiel wird ein Benutzerimportauftrag beschrieben. Weitere Informationen zum Importieren von Benutzern finden Sie unter „Importieren von Benutzern aus einer CSV-Datei in Benutzerpools“. Befehl: ``` aws cognito-idp describe-user-import-job --user-pool-id us-west-2_aaaaaaaaa --job-id import-TZqNQvDRnW ``` Ausgabe: ``` { "UserImportJob": { "JobName": "import-Test1", "JobId": "import-TZqNQvDRnW", "UserPoolId": "us-west-2_aaaaaaaaa", "PreSignedUrl": "PRE_SIGNED URL", "CreationDate": 1548271708.512, "Status": "Created", "CloudWatchLogsRoleArn": "arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole", "ImportedUsers": 0, "SkippedUsers": 0, "FailedUsers": 0 } } ``` + Einzelheiten zur API finden Sie [DescribeUserImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/describe-user-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-user-pool-client` Das folgende Codebeispiel zeigt die Verwendung`describe-user-pool-client`. **AWS CLI** **So beschreiben Sie einen Benutzerpoolclient** In diesem Beispiel wird ein Benutzerpoolclient beschrieben. Befehl: ``` aws cognito-idp describe-user-pool-client --user-pool-id us-west-2_aaaaaaaaa --client-id 38fjsnc484p94kpqsnet7mpld0 ``` Ausgabe: ``` { "UserPoolClient": { "UserPoolId": "us-west-2_aaaaaaaaa", "ClientName": "MyApp", "ClientId": "38fjsnc484p94kpqsnet7mpld0", "ClientSecret": "CLIENT_SECRET", "LastModifiedDate": 1548108676.163, "CreationDate": 1548108676.163, "RefreshTokenValidity": 30, "ReadAttributes": [ "address", "birthdate", "custom:CustomAttr1", "custom:CustomAttr2", "email", "email_verified", "family_name", "gender", "given_name", "locale", "middle_name", "name", "nickname", "phone_number", "phone_number_verified", "picture", "preferred_username", "profile", "updated_at", "website", "zoneinfo" ], "WriteAttributes": [ "address", "birthdate", "custom:CustomAttr1", "custom:CustomAttr2", "email", "family_name", "gender", "given_name", "locale", "middle_name", "name", "nickname", "phone_number", "picture", "preferred_username", "profile", "updated_at", "website", "zoneinfo" ], "ExplicitAuthFlows": [ "ADMIN_NO_SRP_AUTH", "USER_PASSWORD_AUTH" ], "AllowedOAuthFlowsUserPoolClient": false } } ``` + Einzelheiten zur API finden Sie [DescribeUserPoolClient](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/describe-user-pool-client.html)in der *AWS CLI Befehlsreferenz*. ### `describe-user-pool-domain` Das folgende Codebeispiel zeigt die Verwendung`describe-user-pool-domain`. **AWS CLI** **So beschreiben Sie einen Benutzerpoolclient** In diesem Beispiel wird eine Benutzerpooldomain namens my-domain beschrieben. Befehl: ``` aws cognito-idp describe-user-pool-domain --domain my-domain ``` Ausgabe: ``` { "DomainDescription": { "UserPoolId": "us-west-2_aaaaaaaaa", "AWSAccountId": "111111111111", "Domain": "my-domain", "S3Bucket": "aws-cognito-prod-pdx-assets", "CloudFrontDistribution": "aaaaaaaaaaaaa.cloudfront.net", "Version": "20190128175402", "Status": "ACTIVE", "CustomDomainConfig": {} } } ``` + Einzelheiten zur API finden Sie [DescribeUserPoolDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/describe-user-pool-domain.html)in der *AWS CLI Befehlsreferenz*. ### `describe-user-pool` Das folgende Codebeispiel zeigt die Verwendung`describe-user-pool`. **AWS CLI** **So beschreiben Sie einen Benutzerpool** Im folgenden Beispiel wird ein Benutzerpool mit der Benutzerpool-ID us-west-2\$1EXAMPLE beschrieben. ``` aws cognito-idp describe-user-pool \ --user-pool-id us-west-2_EXAMPLE ``` Ausgabe: ``` { "UserPool": { "Id": "us-west-2_EXAMPLE", "Name": "MyUserPool", "Policies": { "PasswordPolicy": { "MinimumLength": 8, "RequireUppercase": true, "RequireLowercase": true, "RequireNumbers": true, "RequireSymbols": true, "TemporaryPasswordValidityDays": 1 } }, "DeletionProtection": "ACTIVE", "LambdaConfig": { "PreSignUp": "arn:aws:lambda:us-west-2:123456789012:function:MyPreSignUpFunction", "CustomMessage": "arn:aws:lambda:us-west-2:123456789012:function:MyCustomMessageFunction", "PostConfirmation": "arn:aws:lambda:us-west-2:123456789012:function:MyPostConfirmationFunction", "PreAuthentication": "arn:aws:lambda:us-west-2:123456789012:function:MyPreAuthenticationFunction", "PostAuthentication": "arn:aws:lambda:us-west-2:123456789012:function:MyPostAuthenticationFunction", "DefineAuthChallenge": "arn:aws:lambda:us-west-2:123456789012:function:MyDefineAuthChallengeFunction", "CreateAuthChallenge": "arn:aws:lambda:us-west-2:123456789012:function:MyCreateAuthChallengeFunction", "VerifyAuthChallengeResponse": "arn:aws:lambda:us-west-2:123456789012:function:MyVerifyAuthChallengeFunction", "PreTokenGeneration": "arn:aws:lambda:us-west-2:123456789012:function:MyPreTokenGenerationFunction", "UserMigration": "arn:aws:lambda:us-west-2:123456789012:function:MyMigrateUserFunction", "PreTokenGenerationConfig": { "LambdaVersion": "V2_0", "LambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:MyPreTokenGenerationFunction" }, "CustomSMSSender": { "LambdaVersion": "V1_0", "LambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:MyCustomSMSSenderFunction" }, "CustomEmailSender": { "LambdaVersion": "V1_0", "LambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:MyCustomEmailSenderFunction" }, "KMSKeyID": "arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" }, "LastModifiedDate": 1726784814.598, "CreationDate": 1602103465.273, "SchemaAttributes": [ { "Name": "sub", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": false, "Required": true, "StringAttributeConstraints": { "MinLength": "1", "MaxLength": "2048" } }, { "Name": "name", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "given_name", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "family_name", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "middle_name", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "nickname", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "preferred_username", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "profile", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "picture", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "website", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "email", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": true, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "email_verified", "AttributeDataType": "Boolean", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false }, { "Name": "gender", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "birthdate", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "10", "MaxLength": "10" } }, { "Name": "zoneinfo", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "locale", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "phone_number", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "phone_number_verified", "AttributeDataType": "Boolean", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false }, { "Name": "address", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "0", "MaxLength": "2048" } }, { "Name": "updated_at", "AttributeDataType": "Number", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "NumberAttributeConstraints": { "MinValue": "0" } }, { "Name": "identities", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": {} }, { "Name": "custom:111", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "1", "MaxLength": "256" } }, { "Name": "dev:custom:222", "AttributeDataType": "String", "DeveloperOnlyAttribute": true, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MinLength": "1", "MaxLength": "421" } }, { "Name": "custom:accesstoken", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MaxLength": "2048" } }, { "Name": "custom:idtoken", "AttributeDataType": "String", "DeveloperOnlyAttribute": false, "Mutable": true, "Required": false, "StringAttributeConstraints": { "MaxLength": "2048" } } ], "AutoVerifiedAttributes": [ "email" ], "SmsVerificationMessage": "Your verification code is {####}. ", "EmailVerificationMessage": "Your verification code is {####}. ", "EmailVerificationSubject": "Your verification code", "VerificationMessageTemplate": { "SmsMessage": "Your verification code is {####}. ", "EmailMessage": "Your verification code is {####}. ", "EmailSubject": "Your verification code", "EmailMessageByLink": "Please click the link below to verify your email address. {##Verify Your Email##}\n this is from us-west-2_ywDJHlIfU", "EmailSubjectByLink": "Your verification link", "DefaultEmailOption": "CONFIRM_WITH_LINK" }, "SmsAuthenticationMessage": "Your verification code is {####}. ", "UserAttributeUpdateSettings": { "AttributesRequireVerificationBeforeUpdate": [] }, "MfaConfiguration": "OPTIONAL", "DeviceConfiguration": { "ChallengeRequiredOnNewDevice": true, "DeviceOnlyRememberedOnUserPrompt": false }, "EstimatedNumberOfUsers": 166, "EmailConfiguration": { "SourceArn": "arn:aws:ses:us-west-2:123456789012:identity/admin@example.com", "EmailSendingAccount": "DEVELOPER" }, "SmsConfiguration": { "SnsCallerArn": "arn:aws:iam::123456789012:role/service-role/userpool-SMS-Role", "ExternalId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "SnsRegion": "us-west-2" }, "UserPoolTags": {}, "Domain": "myCustomDomain", "CustomDomain": "auth.example.com", "AdminCreateUserConfig": { "AllowAdminCreateUserOnly": false, "UnusedAccountValidityDays": 1, "InviteMessageTemplate": { "SMSMessage": "Your username is {username} and temporary password is {####}. ", "EmailMessage": "Your username is {username} and temporary password is {####}. ", "EmailSubject": "Your temporary password" } }, "UserPoolAddOns": { "AdvancedSecurityMode": "ENFORCED", "AdvancedSecurityAdditionalFlows": {} }, "Arn": "arn:aws:cognito-idp:us-west-2:123456789012:userpool/us-west-2_EXAMPLE", "AccountRecoverySetting": { "RecoveryMechanisms": [ { "Priority": 1, "Name": "verified_email" } ] } } } ``` Weitere Informationen finden Sie unter [Amazon-Cognito-Benutzerpools](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [DescribeUserPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/describe-user-pool.html)in der *AWS CLI Befehlsreferenz*. ### `forget-device` Das folgende Codebeispiel zeigt die Verwendung`forget-device`. **AWS CLI** **So verwerfen Sie ein Gerät** In diesem Beispiel wird ein Gerät verworfen. Befehl: ``` aws cognito-idp forget-device --device-key us-west-2_abcd_1234-5678 ``` + Einzelheiten zur API finden Sie [ForgetDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/forget-device.html)in der *AWS CLI Befehlsreferenz*. ### `forgot-password` Das folgende Codebeispiel zeigt die Verwendung`forgot-password`. **AWS CLI** **So erzwingen Sie eine Passwortänderung** Im folgenden Beispiel für `forgot-password` wird eine Nachricht an jane@example.com gesendet, um ihr Passwort zu ändern. ``` aws cognito-idp forgot-password --client-id 38fjsnc484p94kpqsnet7mpld0 --username jane@example.com ``` Ausgabe: ``` { "CodeDeliveryDetails": { "Destination": "j***@e***.com", "DeliveryMedium": "EMAIL", "AttributeName": "email" } } ``` + Einzelheiten zur API finden Sie [ForgotPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/forgot-password.html)in der *AWS CLI Befehlsreferenz*. ### `get-csv-header` Das folgende Codebeispiel zeigt die Verwendung`get-csv-header`. **AWS CLI** **So erstellen Sie einen CSV-Header** In diesem Beispiel wird ein CSV-Header erstellt. Weitere Informationen zum Importieren von Benutzern finden Sie unter „Importieren von Benutzern aus einer CSV-Datei in Benutzerpools“. Befehl: ``` aws cognito-idp get-csv-header --user-pool-id us-west-2_aaaaaaaaa ``` Ausgabe: ``` { "UserPoolId": "us-west-2_aaaaaaaaa", "CSVHeader": [ "name", "given_name", "family_name", "middle_name", "nickname", "preferred_username", "profile", "picture", "website", "email", "email_verified", "gender", "birthdate", "zoneinfo", "locale", "phone_number", "phone_number_verified", "address", "updated_at", "cognito:mfa_enabled", "cognito:username" ] } ``` ... Benutzer aus einer CSV-Datei in Benutzerpools importieren: https://docs.aws.amazon.com/cognito/ latest/developerguide/cognito - user-pools-using-import -tool.html + Einzelheiten zur API finden Sie [GetCsvHeader](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-csv-header.html)in der *AWS CLI Befehlsreferenz*. ### `get-device` Das folgende Codebeispiel zeigt die Verwendung`get-device`. **AWS CLI** **So rufen Sie ein Gerät ab** Im folgenden Beispiel für `get-device` wird ein (1) Gerät für den aktuell angemeldeten Benutzer angezeigt. ``` aws cognito-idp get-device \ --access-token eyJra456defEXAMPLE \ --device-key us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "Device": { "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeviceAttributes": [ { "Name": "device_status", "Value": "valid" }, { "Name": "device_name", "Value": "MyDevice" }, { "Name": "dev:device_arn", "Value": "arn:aws:cognito-idp:us-west-2:123456789012:owner/diego.us-west-2_EXAMPLE/device/us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, { "Name": "dev:device_owner", "Value": "diego.us-west-2_EXAMPLE" }, { "Name": "last_ip_used", "Value": "192.0.2.1" }, { "Name": "dev:device_remembered_status", "Value": "remembered" }, { "Name": "dev:device_sdk", "Value": "aws-sdk" } ], "DeviceCreateDate": 1715100742.022, "DeviceLastModifiedDate": 1723233651.167, "DeviceLastAuthenticatedDate": 1715100742.0 } } ``` Weitere Informationen finden Sie unter [Verwendung von Benutzergeräten in Ihrem Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-device-tracking.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GetDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-device.html)in der *AWS CLI Befehlsreferenz*. ### `get-group` Das folgende Codebeispiel zeigt die Verwendung`get-group`. **AWS CLI** **So rufen Sie Informationen über eine Gruppe ab** Im folgenden Beispiel für `get-group` wird die Eigenschaften der Benutzergruppe mit dem Namen `MyGroup` aufgelistet. Dieser Gruppe ist eine Priorität und eine IAM-Rolle zugeordnet. ``` aws cognito-idp get-group \ --user-pool-id us-west-2_EXAMPLE \ --group-name MyGroup ``` Ausgabe: ``` { "Group": { "GroupName": "MyGroup", "UserPoolId": "us-west-2_EXAMPLE", "RoleArn": "arn:aws:iam::123456789012:role/example-cognito-role", "Precedence": 7, "LastModifiedDate": 1697211218.305, "CreationDate": 1611685503.954 } } ``` Weitere Informationen finden Sie unter [Hinzufügen von Gruppen zu einem Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-user-groups.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-group.html)in der *AWS CLI Befehlsreferenz*. ### `get-identity-provider-by-identifier` Das folgende Codebeispiel zeigt die Verwendung`get-identity-provider-by-identifier`. **AWS CLI** **So rufen Sie die Konfiguration eines Identitätsanbieters aus der IDP-ID ab** Das folgende Beispiel für `get-identity-provider-by-identifier` gibt die Konfiguration des Identitätsanbieters mit der ID `mysso` zurück. ``` aws cognito-idp get-identity-provider-by-identifier \ --user-pool-id us-west-2_EXAMPLE \ --idp-identifier mysso ``` Ausgabe: ``` { "IdentityProvider": { "UserPoolId": "us-west-2_EXAMPLE", "ProviderName": "MYSAML", "ProviderType": "SAML", "ProviderDetails": { "ActiveEncryptionCertificate": "[Certificate contents]", "IDPSignout": "false", "MetadataURL": "https://auth.example.com/saml/metadata/", "SLORedirectBindingURI": "https://auth.example.com/saml/logout/", "SSORedirectBindingURI": "https://auth.example.com/saml/assertion/" }, "AttributeMapping": { "email": "email" }, "IdpIdentifiers": [ "mysso", "mysamlsso" ], "LastModifiedDate": 1705616729.188, "CreationDate": 1643734622.919 } } ``` Weitere Informationen finden Sie unter [Drittanbieter-IDP-Anmeldung](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-identity-federation.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GetIdentityProviderByIdentifier](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-identity-provider-by-identifier.html)in der *AWS CLI Befehlsreferenz*. ### `get-log-delivery-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-log-delivery-configuration`. **AWS CLI** **So zeigen Sie die Konfiguration für die Protokollbereitstellung an** Im folgenden Beispiel für `get-log-delivery-configuration` werden die Protokollexporteinstellungen des angeforderten Benutzerpools angezeigt. ``` aws cognito-idp get-log-delivery-configuration \ --user-pool-id us-west-2_EXAMPLE ``` Ausgabe: ``` { "LogDeliveryConfiguration": { "UserPoolId": "us-west-2_EXAMPLE", "LogConfigurations": [ { "LogLevel": "INFO", "EventSource": "userAuthEvents", "FirehoseConfiguration": { "StreamArn": "arn:aws:firehose:us-west-2:123456789012:deliverystream/my-test-deliverystream" } }, { "LogLevel": "ERROR", "EventSource": "userNotification", "CloudWatchLogsConfiguration": { "LogGroupArn": "arn:aws:logs:us-west-2:123456789012:log-group:my-message-delivery-logs" } } ] } } ``` Weitere Informationen finden Sie unter [Exportieren von Benutzerpoolprotokollen](https://docs.aws.amazon.com/cognito/latest/developerguide/exporting-quotas-and-usage.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GetLogDeliveryConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-log-delivery-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-signing-certificate` Das folgende Codebeispiel zeigt die Verwendung`get-signing-certificate`. **AWS CLI** **So zeigen Sie das SAML-Signaturzertifikat an** Im folgenden Beispiel für `get-signing-certificate` wird das SAML-2.0-Signaturzertifikat für den angeforderten Benutzerpool angezeigt. ``` aws cognito-idp get-signing-certificate \ --user-pool-id us-west-2_EXAMPLE ``` Ausgabe: ``` { "Certificate": "[Certificate content]" } ``` Weitere Informationen finden Sie unter [SAML-Signatur und -Verschlüsselung](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-SAML-signing-encryption.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GetSigningCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-signing-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `get-ui-customization` Das folgende Codebeispiel zeigt die Verwendung`get-ui-customization`. **AWS CLI** **So zeigen Sie die klassischen Anpassungseinstellungen für gehostete Benutzeroberflächen für einen App-Client an** Im folgenden Beispiel für `get-ui-customization` werden die klassischen Anpassungseinstellungen für gehostete Benutzeroberflächen für einen App-Client angezeigt, der keine Einstellungen aus dem Benutzerpool erbt. ``` aws cognito-idp get-ui-customization \ --user-pool-id us-west-2_EXAMPLE \ --client-id 1example23456789 ``` Ausgabe: ``` { "UICustomization": { "UserPoolId": "us-west-2_EXAMPLE", "ClientId": "1example23456789", "ImageUrl": "https://example.cloudfront.net/us-west-2_EXAMPLE/1example23456789/20250115191928/assets/images/image.jpg", "CSS": "\n.logo-customizable {\n max-width: 80%;\n max-height: 30%;\n}\n\n.banner-customizable {\n padding: 25px 0px 25px 0px;\n background-color: lightgray;\n}\n\n.label-customizable {\n font-weight: 400;\n}\n\n.textDescription-customizable {\n padding-top: 100px;\n padding-bottom: 10px;\n display: block;\n font-size: 12px;\n}\n\n.idpDescription-customizable {\n padding-top: 10px;\n padding-bottom: 10px;\n display: block;\n font-size: 16px;\n}\n\n.legalText-customizable {\n color: #747474;\n font-size: 11px;\n}\n\n.submitButton-customizable {\n font-size: 14px;\n font-weight: bold;\n margin: 20px 0px 10px 0px;\n height: 50px;\n width: 100%;\n color: #fff;\n background-color: #337ab7;\n}\n\n.submitButton-customizable:hover {\n color: #fff;\n background-color: #286090;\n}\n\n.errorMessage-customizable {\n padding: 5px;\n font-size: 12px;\n width: 100%;\n background: #F5F5F5;\n border: 2px solid #D64958;\n color: #D64958;\n}\n\n.inputField-customizable {\n width: 100%;\n height: 34px;\n color: #555;\n background-color: #fff;\n border: 1px solid #ccc;\n}\n\n.inputField-customizable:focus {\n border-color: #66afe9;\n outline: 0;\n}\n\n.idpButton-customizable {\n height: 40px;\n width: 100%;\n width: 100%;\n text-align: center;\n margin-bottom: 15px;\n color: #fff;\n background-color: #5bc0de;\n border-color: #46b8da;\n}\n\n.idpButton-customizable:hover {\n color: #fff;\n background-color: #31b0d5;\n}\n\n.socialButton-customizable {\n border-radius: 2px;\n height: 60px;\n margin-bottom: 15px;\n padding: 1px;\n text-align: left;\n width: 100%;\n}\n\n.redirect-customizable {\n text-align: center;\n}\n\n.passwordCheck-notValid-customizable {\n color: #DF3312;\n}\n\n.passwordCheck-valid-customizable {\n color: #19BF00;\n}\n\n.background-customizable {\n background-color: #fff;\n}\n", "CSSVersion": "20250115191928" } } ``` Weitere Informationen finden Sie unter [Branding für gehostete Benutzeroberflächen (klassisch)](https://docs.aws.amazon.com/cognito/latest/developerguide/hosted-ui-classic-branding.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GetUiCustomization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-ui-customization.html)in der *AWS CLI Befehlsreferenz*. ### `get-user-attribute-verification-code` Das folgende Codebeispiel zeigt die Verwendung`get-user-attribute-verification-code`. **AWS CLI** **So senden Sie einen Attributverifizierungscode an den aktuellen Benutzer** Im folgenden Beispiel für `get-user-attribute-verification-code` wird ein Attributverifizierungscode an die E-Mail-Adresse des aktuell angemeldeten Benutzers gesendet. ``` aws cognito-idp get-user-attribute-verification-code \ --access-token eyJra456defEXAMPLE \ --attribute-name email ``` Ausgabe: ``` { "CodeDeliveryDetails": { "Destination": "a***@e***", "DeliveryMedium": "EMAIL", "AttributeName": "email" } } ``` Weitere Informationen finden Sie unter [Registrieren und Bestätigen von Benutzerkonten](https://docs.aws.amazon.com/cognito/latest/developerguide/signing-up-users-in-your-app.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GetUserAttributeVerificationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-user-attribute-verification-code.html)in der *AWS CLI Befehlsreferenz*. ### `get-user-auth-factors` Das folgende Codebeispiel zeigt die Verwendung`get-user-auth-factors`. **AWS CLI** **So listen Sie die Authentifizierungsfaktoren auf, die dem aktuellen Benutzer zur Verfügung stehen** Im folgenden Beispiel für `get-user-auth-factors` werden die verfügbaren Authentifizierungsfaktoren für den aktuell angemeldeten Benutzer aufgeführt. ``` aws cognito-idp get-user-auth-factors \ --access-token eyJra456defEXAMPLE ``` Ausgabe: ``` { "Username": "testuser", "ConfiguredUserAuthFactors": [ "PASSWORD", "EMAIL_OTP", "SMS_OTP", "WEB_AUTHN" ] } ``` Weitere Informationen finden Sie unter [Authentifizierung](https://docs.aws.amazon.com/cognito/latest/developerguide/authentication.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GetUserAuthFactors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-user-auth-factors.html)in der *AWS CLI Befehlsreferenz*. ### `get-user-pool-mfa-config` Das folgende Codebeispiel zeigt die Verwendung`get-user-pool-mfa-config`. **AWS CLI** **Um die Multi-Faktor-Authentifizierung und die WebAuthn Einstellungen eines Benutzerpools anzuzeigen** Im folgenden `get-user-pool-mfa-config` Beispiel werden die MFA und die WebAuthn Konfiguration des angeforderten Benutzerpools angezeigt. ``` aws cognito-idp get-user-pool-mfa-config \ --user-pool-id us-west-2_EXAMPLE ``` Ausgabe: ``` { "SmsMfaConfiguration": { "SmsAuthenticationMessage": "Your OTP for MFA or sign-in: use {####}.", "SmsConfiguration": { "SnsCallerArn": "arn:aws:iam::123456789012:role/service-role/my-SMS-Role", "ExternalId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "SnsRegion": "us-west-2" } }, "SoftwareTokenMfaConfiguration": { "Enabled": true }, "EmailMfaConfiguration": { "Message": "Your OTP for MFA or sign-in: use {####}", "Subject": "OTP test" }, "MfaConfiguration": "OPTIONAL", "WebAuthnConfiguration": { "RelyingPartyId": "auth.example.com", "UserVerification": "preferred" } } ``` Weitere Informationen finden Sie unter [Hinzufügen von MFA](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-mfa.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie unter [GetUserPoolMfaConfig AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-user-pool-mfa-config.html)*Befehlsreferenz.* ### `get-user` Das folgende Codebeispiel zeigt die Verwendung`get-user`. **AWS CLI** **So rufen Sie die Details des aktuellen Benutzers ab** Im folgenden Beispiel für `get-user` wird das Profil für den aktuell angemeldeten Benutzer angezeigt. ``` aws cognito-idp get-user \ --access-token eyJra456defEXAMPLE ``` Ausgabe: ``` { "Username": "johndoe", "UserAttributes": [ { "Name": "sub", "Value": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, { "Name": "identities", "Value": "[{\"userId\":\"a1b2c3d4-5678-90ab-cdef-EXAMPLE22222\",\"providerName\":\"SignInWithApple\",\"providerType\":\"SignInWithApple\",\"issuer\":null,\"primary\":false,\"dateCreated\":1701125599632}]" }, { "Name": "email_verified", "Value": "true" }, { "Name": "custom:state", "Value": "Maine" }, { "Name": "name", "Value": "John Doe" }, { "Name": "phone_number_verified", "Value": "true" }, { "Name": "phone_number", "Value": "+12065551212" }, { "Name": "preferred_username", "Value": "jamesdoe" }, { "Name": "locale", "Value": "EMEA" }, { "Name": "email", "Value": "jamesdoe@example.com" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Benutzern](https://docs.aws.amazon.com/cognito/latest/developerguide/managing-users.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GetUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/get-user.html)in der *AWS CLI Befehlsreferenz*. ### `global-sign-out` Das folgende Codebeispiel zeigt die Verwendung`global-sign-out`. **AWS CLI** **So melden Sie den aktuellen Benutzer ab** Im folgenden Beispiel für `global-sign-out` wird der aktuelle Benutzer abgemeldet. ``` aws cognito-idp global-sign-out \ --access-token eyJra456defEXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Benutzern](https://docs.aws.amazon.com/cognito/latest/developerguide/managing-users.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [GlobalSignOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/global-sign-out.html)in der *AWS CLI Befehlsreferenz*. ### `initiate-auth` Das folgende Codebeispiel zeigt die Verwendung`initiate-auth`. **AWS CLI** **So melden Sie einen Benutzer an** Im folgenden Beispiel für `initiate-auth` wird ein Benutzer mit dem grundlegenden Benutzername-Passwort-Ablauf und ohne zusätzliche Aufforderungen angemeldet. ``` aws cognito-idp initiate-auth \ --auth-flow USER_PASSWORD_AUTH \ --client-id 1example23456789 \ --analytics-metadata AnalyticsEndpointId=d70b2ba36a8c4dc5a04a0451aEXAMPLE \ --auth-parameters USERNAME=testuser,PASSWORD=[Password] --user-context-data EncodedData=mycontextdata --client-metadata MyTestKey=MyTestValue ``` Ausgabe: ``` { "AuthenticationResult": { "AccessToken": "eyJra456defEXAMPLE", "ExpiresIn": 3600, "TokenType": "Bearer", "RefreshToken": "eyJra123abcEXAMPLE", "IdToken": "eyJra789ghiEXAMPLE", "NewDeviceMetadata": { "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeviceGroupKey": "-v7w9UcY6" } } } ``` Weitere Informationen finden Sie unter [Authentifizierung](https://docs.aws.amazon.com/cognito/latest/developerguide/authentication.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [InitiateAuth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/initiate-auth.html)in der *AWS CLI Befehlsreferenz*. ### `list-devices` Das folgende Codebeispiel zeigt die Verwendung`list-devices`. **AWS CLI** **So listen Sie die Geräte eines Benutzers auf** Im folgenden Beispiel für `list-devices` werden die Geräte aufgelistet, die der aktuelle Benutzer registriert hat. ``` aws cognito-idp list-devices \ --access-token eyJra456defEXAMPLE ``` Ausgabe: ``` { "Devices": [ { "DeviceAttributes": [ { "Name": "device_status", "Value": "valid" }, { "Name": "device_name", "Value": "Dart-device" }, { "Name": "last_ip_used", "Value": "192.0.2.1" } ], "DeviceCreateDate": 1715100742.022, "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeviceLastAuthenticatedDate": 1715100742.0, "DeviceLastModifiedDate": 1723233651.167 }, { "DeviceAttributes": [ { "Name": "device_status", "Value": "valid" }, { "Name": "last_ip_used", "Value": "192.0.2.2" } ], "DeviceCreateDate": 1726856147.993, "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "DeviceLastAuthenticatedDate": 1726856147.0, "DeviceLastModifiedDate": 1726856147.993 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Geräten](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-device-tracking.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ListDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-devices.html)in der *AWS CLI Befehlsreferenz*. ### `list-groups` Das folgende Codebeispiel zeigt die Verwendung`list-groups`. **AWS CLI** **So listen Sie die Gruppen in einem Benutzerpool auf** Im folgenden Beispiel für `list-groups` werden die ersten beiden Gruppen im angeforderten Benutzerpool aufgelistet. ``` aws cognito-idp list-groups \ --user-pool-id us-west-2_EXAMPLE \ --max-items 2 ``` Ausgabe: ``` { "Groups": [ { "CreationDate": 1681760899.633, "Description": "My test group", "GroupName": "testgroup", "LastModifiedDate": 1681760899.633, "Precedence": 1, "UserPoolId": "us-west-2_EXAMPLE" }, { "CreationDate": 1642632749.051, "Description": "Autogenerated group for users who sign in using Facebook", "GroupName": "us-west-2_EXAMPLE_Facebook", "LastModifiedDate": 1642632749.051, "UserPoolId": "us-west-2_EXAMPLE" } ], "NextToken": "[Pagination token]" } ``` Weitere Informationen finden Sie unter [Hinzufügen von Gruppen zu einem Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-user-groups.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-groups.html)in der *AWS CLI Befehlsreferenz*. ### `list-identity-providers` Das folgende Codebeispiel zeigt die Verwendung`list-identity-providers`. **AWS CLI** **So listen Sie Identitätsanbieter auf** Im folgenden Beispiel für `list-identity-providers` werden die ersten beiden Identitätsanbieter im angeforderten Benutzerpool aufgelistet. ``` aws cognito-idp list-identity-providers \ --user-pool-id us-west-2_EXAMPLE \ --max-items 2 ``` Ausgabe: ``` { "Providers": [ { "CreationDate": 1619477386.504, "LastModifiedDate": 1703798328.142, "ProviderName": "Azure", "ProviderType": "SAML" }, { "CreationDate": 1642698776.175, "LastModifiedDate": 1642699086.453, "ProviderName": "LoginWithAmazon", "ProviderType": "LoginWithAmazon" } ], "NextToken": "[Pagination token]" } ``` Weitere Informationen finden Sie unter [Drittanbieter-IDP-Anmeldung](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-identity-federation.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ListIdentityProviders](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-identity-providers.html)in der *AWS CLI Befehlsreferenz*. ### `list-resource-servers` Das folgende Codebeispiel zeigt die Verwendung`list-resource-servers`. **AWS CLI** **So listen Sie Ressourcenserver auf** Im folgenden Beispiel für `list-resource-servers` werden die ersten beiden Ressourcenserver im angeforderten Benutzerpool aufgelistet. ``` aws cognito-idp list-resource-servers \ --user-pool-id us-west-2_EXAMPLE \ --max-results 2 ``` Ausgabe: ``` { "ResourceServers": [ { "Identifier": "myapi.example.com", "Name": "Example API with custom access control scopes", "Scopes": [ { "ScopeDescription": "International customers", "ScopeName": "international.read" }, { "ScopeDescription": "Domestic customers", "ScopeName": "domestic.read" } ], "UserPoolId": "us-west-2_EXAMPLE" }, { "Identifier": "myapi2.example.com", "Name": "Another example API for access control", "Scopes": [ { "ScopeDescription": "B2B customers", "ScopeName": "b2b.read" } ], "UserPoolId": "us-west-2_EXAMPLE" } ], "NextToken": "[Pagination token]" } ``` Weitere Informationen finden Sie unter [Zugriffskontrolle mit Ressourcenservern](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-define-resource-servers.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ListResourceServers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-resource-servers.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Benutzerpool-Tags auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags aufgelistet, die dem Benutzerpool mit dem angeforderten ARN zugewiesen wurden. ``` aws cognito-idp list-tags-for-resource \ --resource-arn arn:aws:cognito-idp:us-west-2:123456789012:userpool/us-west-2_EXAMPLE ``` Ausgabe: ``` { "Tags": { "administrator": "Jie", "tenant": "ExampleCorp" } } ``` Weitere Informationen finden Sie unter [Tagging von Amazon-Cognito-Ressourcen](https://docs.aws.amazon.com/cognito/latest/developerguide/tagging.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-user-import-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-user-import-jobs`. **AWS CLI** **So listen Sie Benutzerimportaufträge und Status auf** Im folgenden Beispiel für `list-user-import-jobs` werden die ersten drei Benutzerimportaufträge und ihre Details im angeforderten Benutzerpool aufgelistet. ``` aws cognito-idp list-user-import-jobs \ --user-pool-id us-west-2_EXAMPLE \ --max-results 3 ``` Ausgabe: ``` { "PaginationToken": "us-west-2_EXAMPLE#import-example3#1667948397084", "UserImportJobs": [ { "CloudWatchLogsRoleArn": "arn:aws:iam::123456789012:role/service-role/Cognito-UserImport-Role", "CompletionDate": 1735329786.142, "CompletionMessage": "The user import job has expired.", "CreationDate": 1735241621.022, "FailedUsers": 0, "ImportedUsers": 0, "JobId": "import-example1", "JobName": "Test-import-job-1", "PreSignedUrl": "https://aws-cognito-idp-user-import-pdx.s3.us-west-2.amazonaws.com/123456789012/us-west-2_EXAMPLE/import-mAgUtd8PMm?X-Amz-Security-Token=[token]&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20241226T193341Z&X-Amz-SignedHeaders=host%3Bx-amz-server-side-encryption&X-Amz-Expires=899&X-Amz-Credential=[credential]&X-Amz-Signature=[signature]", "SkippedUsers": 0, "Status": "Expired", "UserPoolId": "us-west-2_EXAMPLE" }, { "CloudWatchLogsRoleArn": "arn:aws:iam::123456789012:role/service-role/Cognito-UserImport-Role", "CompletionDate": 1681509058.408, "CompletionMessage": "Too many users have failed or been skipped during the import.", "CreationDate": 1681509001.477, "FailedUsers": 1, "ImportedUsers": 0, "JobId": "import-example2", "JobName": "Test-import-job-2", "PreSignedUrl": "https://aws-cognito-idp-user-import-pdx.s3.us-west-2.amazonaws.com/123456789012/us-west-2_EXAMPLE/import-mAgUtd8PMm?X-Amz-Security-Token=[token]&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20241226T193341Z&X-Amz-SignedHeaders=host%3Bx-amz-server-side-encryption&X-Amz-Expires=899&X-Amz-Credential=[credential]&X-Amz-Signature=[signature]", "SkippedUsers": 0, "StartDate": 1681509057.965, "Status": "Failed", "UserPoolId": "us-west-2_EXAMPLE" }, { "CloudWatchLogsRoleArn": "arn:aws:iam::123456789012:role/service-role/Cognito-UserImport-Role", "CompletionDate": 1.667864578676E9, "CompletionMessage": "Import Job Completed Successfully.", "CreationDate": 1.667864480281E9, "FailedUsers": 0, "ImportedUsers": 6, "JobId": "import-example3", "JobName": "Test-import-job-3", "PreSignedUrl": "https://aws-cognito-idp-user-import-pdx.s3.us-west-2.amazonaws.com/123456789012/us-west-2_EXAMPLE/import-mAgUtd8PMm?X-Amz-Security-Token=[token]&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20241226T193341Z&X-Amz-SignedHeaders=host%3Bx-amz-server-side-encryption&X-Amz-Expires=899&X-Amz-Credential=[credential]&X-Amz-Signature=[signature]", "SkippedUsers": 0, "StartDate": 1.667864578167E9, "Status": "Succeeded", "UserPoolId": "us-west-2_EXAMPLE" } ] } ``` Weitere Informationen finden Sie unter [Importieren von Benutzern aus einer CSV-Datei](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-using-import-tool.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ListUserImportJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-user-import-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-user-pool-clients` Das folgende Codebeispiel zeigt die Verwendung`list-user-pool-clients`. **AWS CLI** **So listen Sie App-Clients auf** Im folgenden Beispiel für `list-user-pool-clients` werden die ersten beiden App-Clients im angeforderten Benutzerpool aufgelistet. ``` aws cognito-idp list-user-pool-clients \ --user-pool-id us-west-2_EXAMPLE \ --max-results 3 ``` Ausgabe: ``` { "NextToken": "[Pagination token]", "UserPoolClients": [ { "ClientId": "1example23456789", "ClientName": "app-client-1", "UserPoolId": "us-west-2_EXAMPLE" }, { "ClientId": "2example34567890", "ClientName": "app-client-2", "UserPoolId": "us-west-2_EXAMPLE" }, { "ClientId": "3example45678901", "ClientName": "app-client-3", "UserPoolId": "us-west-2_EXAMPLE" } ] } ``` Weitere Informationen finden Sie unter [App-Clients](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ListUserPoolClients](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-user-pool-clients.html)in der *AWS CLI Befehlsreferenz*. ### `list-user-pools` Das folgende Codebeispiel zeigt die Verwendung`list-user-pools`. **AWS CLI** **So listen Sie Benutzerpools auf** Das folgende `list-user-pools` Beispiel listet 3 der verfügbaren Benutzerpools im AWS Konto mit den aktuellen CLI-Anmeldeinformationen auf. ``` aws cognito-idp list-user-pools \ --max-results 3 ``` Ausgabe: ``` { "NextToken": "[Pagination token]", "UserPools": [ { "CreationDate": 1681502497.741, "Id": "us-west-2_EXAMPLE1", "LambdaConfig": { "CustomMessage": "arn:aws:lambda:us-east-1:123456789012:function:MyFunction", "PreSignUp": "arn:aws:lambda:us-east-1:123456789012:function:MyFunction", "PreTokenGeneration": "arn:aws:lambda:us-east-1:123456789012:function:MyFunction", "PreTokenGenerationConfig": { "LambdaArn": "arn:aws:lambda:us-east-1:123456789012:function:MyFunction", "LambdaVersion": "V1_0" } }, "LastModifiedDate": 1681502497.741, "Name": "user pool 1" }, { "CreationDate": 1686064178.717, "Id": "us-west-2_EXAMPLE2", "LambdaConfig": { }, "LastModifiedDate": 1686064178.873, "Name": "user pool 2" }, { "CreationDate": 1627681712.237, "Id": "us-west-2_EXAMPLE3", "LambdaConfig": { "UserMigration": "arn:aws:lambda:us-east-1:123456789012:function:MyFunction" }, "LastModifiedDate": 1678486942.479, "Name": "user pool 3" } ] } ``` Weitere Informationen finden Sie unter [Amazon-Cognito-Benutzerpools](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ListUserPools](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-user-pools.html)unter *AWS CLI Befehlsreferenz*. ### `list-users-in-group` Das folgende Codebeispiel zeigt die Verwendung`list-users-in-group`. **AWS CLI** **So listen Sie Benutzer in einer Gruppe auf** In diesem Beispiel werden Benutzer in einer Gruppe aufgeführt MyGroup. Befehl: ``` aws cognito-idp list-users-in-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyGroup ``` Ausgabe: ``` { "Users": [ { "Username": "acf10624-80bb-401a-ac61-607bee2110ec", "Attributes": [ { "Name": "sub", "Value": "acf10624-80bb-401a-ac61-607bee2110ec" }, { "Name": "custom:CustomAttr1", "Value": "New Value!" }, { "Name": "email", "Value": "jane@example.com" } ], "UserCreateDate": 1548102770.284, "UserLastModifiedDate": 1548103204.893, "Enabled": true, "UserStatus": "CONFIRMED" }, { "Username": "22704aa3-fc10-479a-97eb-2af5806bd327", "Attributes": [ { "Name": "sub", "Value": "22704aa3-fc10-479a-97eb-2af5806bd327" }, { "Name": "email_verified", "Value": "true" }, { "Name": "email", "Value": "diego@example.com" } ], "UserCreateDate": 1548089817.683, "UserLastModifiedDate": 1548089817.683, "Enabled": true, "UserStatus": "FORCE_CHANGE_PASSWORD" } ] } ``` + Einzelheiten zur API finden Sie [ListUsersInGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-users-in-group.html)in der *AWS CLI Befehlsreferenz*. ### `list-users` Das folgende Codebeispiel zeigt die Verwendung`list-users`. **AWS CLI** **Beispiel 1: So listen Sie Benutzer mit einem serverseitigen Filter auf** Im folgenden Beispiel für `list-users` werden 3 Benutzer im angeforderten Benutzerpool aufgeführt, deren E-Mail-Adressen mit `testuser` beginnen. ``` aws cognito-idp list-users \ --user-pool-id us-west-2_EXAMPLE \ --filter email^=\"testuser\" \ --max-items 3 ``` Ausgabe: ``` { "PaginationToken": "efgh5678EXAMPLE", "Users": [ { "Attributes": [ { "Name": "sub", "Value": "eaad0219-2117-439f-8d46-4db20e59268f" }, { "Name": "email", "Value": "testuser@example.com" } ], "Enabled": true, "UserCreateDate": 1682955829.578, "UserLastModifiedDate": 1689030181.63, "UserStatus": "CONFIRMED", "Username": "testuser" }, { "Attributes": [ { "Name": "sub", "Value": "3b994cfd-0b07-4581-be46-3c82f9a70c90" }, { "Name": "email", "Value": "testuser2@example.com" } ], "Enabled": true, "UserCreateDate": 1684427979.201, "UserLastModifiedDate": 1684427979.201, "UserStatus": "UNCONFIRMED", "Username": "testuser2" }, { "Attributes": [ { "Name": "sub", "Value": "5929e0d1-4c34-42d1-9b79-a5ecacfe66f7" }, { "Name": "email", "Value": "testuser3@example.com" } ], "Enabled": true, "UserCreateDate": 1684427823.641, "UserLastModifiedDate": 1684427823.641, "UserStatus": "UNCONFIRMED", "Username": "testuser3@example.com" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von und Suchen nach Benutzern](https://docs.aws.amazon.com/cognito/latest/developerguide/how-to-manage-user-accounts.html) im *Entwicklerhandbuch für Amazon Cognito*. **Beispiel 2: So listen Sie Benutzer mit einem clientseitigen Filter auf** Im folgenden Beispiel für `list-users` werden die Attribute von 3 Benutzern aufgelistet, deren Attribut, in diesem Fall ihre E-Mail-Adresse, die E-Mail-Domain „@example.com“ enthält. Wenn andere Attribute diese Zeichenfolge enthalten, werden sie ebenfalls angezeigt. Der zweite Benutzer hat keine Attribute, die der Abfrage entsprechen, und wird von der angezeigten Ausgabe ausgeschlossen, aber nicht von der Serverantwort. ``` aws cognito-idp list-users \ --user-pool-id us-west-2_EXAMPLE \ --max-items 3 --query Users\[\*\].Attributes\[\?Value\.contains\(\@\,\'@example.com\'\)\] ``` Ausgabe: ``` [ [ { "Name": "email", "Value": "admin@example.com" } ], [], [ { "Name": "email", "Value": "operator@example.com" } ] ] ``` Weitere Informationen finden Sie unter [Verwalten von und Suchen nach Benutzern](https://docs.aws.amazon.com/cognito/latest/developerguide/how-to-manage-user-accounts.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ListUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-users.html)in der *AWS CLI Befehlsreferenz*. ### `list-web-authn-credentials` Das folgende Codebeispiel zeigt die Verwendung`list-web-authn-credentials`. **AWS CLI** **So listen Sie die Passkey-Anmeldeinformationen auf** Im folgenden `list-web-authn-credentials` Beispiel werden die Hauptschlüssel oder WebAuthn Anmeldeinformationen für den aktuellen Benutzer aufgeführt. Sie verfügen über ein (1) registriertes Gerät. ``` aws cognito-idp list-web-authn-credentials \ --access-token eyJra456defEXAMPLE ``` Ausgabe: ``` { "Credentials": [ { "AuthenticatorAttachment": "cross-platform", "CreatedAt": 1736293876.115, "CredentialId": "8LApgk4-lNUFHbhm2w6Und7-uxcc8coJGsPxiogvHoItc64xWQc3r4CEXAMPLE", "FriendlyCredentialName": "Roaming passkey", "RelyingPartyId": "auth.example.com" } ] } ``` Weitere Informationen finden Sie unter [Anmeldung mit Passkey](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-authentication-flow-methods.html#amazon-cognito-user-pools-authentication-flow-methods-passkey) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie unter [ListWebAuthnCredentials AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/list-web-authn-credentials.html)*Befehlsreferenz.* ### `resend-confirmation-code` Das folgende Codebeispiel zeigt die Verwendung`resend-confirmation-code`. **AWS CLI** **So senden Sie einen Bestätigungscode erneut** Im folgenden Beispiel für `resend-confirmation-code` wird ein Bestätigungscode an den Benutzer `jane` gesendet. ``` aws cognito-idp resend-confirmation-code \ --client-id 12a3b456c7de890f11g123hijk \ --username jane ``` Ausgabe: ``` { "CodeDeliveryDetails": { "Destination": "j***@e***.com", "DeliveryMedium": "EMAIL", "AttributeName": "email" } } ``` Weitere Informationen finden Sie unter [Registrieren und Bestätigen von Benutzerkonten](https://docs.aws.amazon.com/cognito/latest/developerguide/signing-up-users-in-your-app.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [ResendConfirmationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/resend-confirmation-code.html)in der *AWS CLI Befehlsreferenz*. ### `respond-to-auth-challenge` Das folgende Codebeispiel zeigt die Verwendung`respond-to-auth-challenge`. **AWS CLI** **Beispiel 1: So antworten Sie auf eine NEW\$1PASSWORD\$1REQUIRED-Aufforderung** Das folgende Beispiel für `respond-to-auth-challenge` antwortet auf eine NEW\$1PASSWORD\$1REQUIRED-Aufforderung, die initiate-auth zurückgegeben hat. Es wird ein Passwort für den Benutzer `jane@example.com` festgelegt. ``` aws cognito-idp respond-to-auth-challenge \ --client-id 1example23456789 \ --challenge-name NEW_PASSWORD_REQUIRED \ --challenge-responses USERNAME=jane@example.com,NEW_PASSWORD=[Password] \ --session AYABeEv5HklEXAMPLE ``` Ausgabe: ``` { "ChallengeParameters": {}, "AuthenticationResult": { "AccessToken": "ACCESS_TOKEN", "ExpiresIn": 3600, "TokenType": "Bearer", "RefreshToken": "REFRESH_TOKEN", "IdToken": "ID_TOKEN", "NewDeviceMetadata": { "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeviceGroupKey": "-wt2ha1Zd" } } } ``` Weitere Informationen finden Sie unter [Authentifizierung](https://docs.aws.amazon.com/cognito/latest/developerguide/authentication.html) im *Entwicklerhandbuch für Amazon Cognito*. **Beispiel 2: So antworten Sie auf eine SELECT\$1MFA\$1TYPE-Aufforderung** Im folgenden Beispiel für `respond-to-auth-challenge` wird TOTP MFA als MFA-Option für den aktuellen Benutzer ausgewählt. Der Benutzer wurde aufgefordert, einen MFA-Typ auszuwählen, und wird im nächsten Schritt gebeten, seinen MFA-Code einzugeben. ``` aws cognito-idp respond-to-auth-challenge \ --client-id 1example23456789 --session AYABeEv5HklEXAMPLE --challenge-name SELECT_MFA_TYPE --challenge-responses USERNAME=testuser,ANSWER=SOFTWARE_TOKEN_MFA ``` Ausgabe: ``` { "ChallengeName": "SOFTWARE_TOKEN_MFA", "Session": "AYABeEv5HklEXAMPLE", "ChallengeParameters": { "FRIENDLY_DEVICE_NAME": "transparent" } } ``` Weitere Informationen finden Sie unter [Hinzufügen von MFA](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-mfa.html) im *Entwicklerhandbuch für Amazon Cognito*. **Beispiel 3: So antworten Sie auf eine SOFTWARE\$1TOKEN\$1MFA-Aufforderung** Im folgenden Beispiel für `respond-to-auth-challenge` wird ein TOTP-MFA-Code bereitgestellt und die Anmeldung abgeschlossen. ``` aws cognito-idp respond-to-auth-challenge \ --client-id 1example23456789 \ --session AYABeEv5HklEXAMPLE \ --challenge-name SOFTWARE_TOKEN_MFA \ --challenge-responses USERNAME=testuser,SOFTWARE_TOKEN_MFA_CODE=123456 ``` Ausgabe: ``` { "AuthenticationResult": { "AccessToken": "eyJra456defEXAMPLE", "ExpiresIn": 3600, "TokenType": "Bearer", "RefreshToken": "eyJra123abcEXAMPLE", "IdToken": "eyJra789ghiEXAMPLE", "NewDeviceMetadata": { "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeviceGroupKey": "-v7w9UcY6" } } } ``` Weitere Informationen finden Sie unter [Hinzufügen von MFA](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-mfa.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [RespondToAuthChallenge](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/respond-to-auth-challenge.html)in der *AWS CLI Befehlsreferenz*. ### `revoke-token` Das folgende Codebeispiel zeigt die Verwendung`revoke-token`. **AWS CLI** **So widerrufen Sie ein Aktualisierungstoken** Im folgenden Beispiel für `revoke-token` werden das angeforderte Aktualisierungstoken und die zugehörigen Zugriffstoken widerrufen. ``` aws cognito-idp revoke-token \ --token eyJjd123abcEXAMPLE \ --client-id 1example23456789 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Widerrufen von Token](https://docs.aws.amazon.com/cognito/latest/developerguide/token-revocation.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [RevokeToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/revoke-token.html)in der *AWS CLI Befehlsreferenz*. ### `set-log-delivery-configuration` Das folgende Codebeispiel zeigt die Verwendung`set-log-delivery-configuration`. **AWS CLI** **So richten Sie den Protokollexport aus einem Benutzerpool ein** Im folgenden Beispiel für `set-log-delivery-configuration` wird der angeforderte Benutzerpool mit der Fehlerprotokollierung von Benutzerbenachrichtigungen in einer Protokollgruppe und der Protokollierung von Benutzerauthentifizierungsinformationen in einem S3-Bucket konfiguriert. ``` aws cognito-idp set-log-delivery-configuration \ --user-pool-id us-west-2_EXAMPLE \ --log-configurations LogLevel=ERROR,EventSource=userNotification,CloudWatchLogsConfiguration={LogGroupArn=arn:aws:logs:us-west-2:123456789012:log-group:cognito-exported} LogLevel=INFO,EventSource=userAuthEvents,S3Configuration={BucketArn=arn:aws:s3:::amzn-s3-demo-bucket1} ``` Ausgabe: ``` { "LogDeliveryConfiguration": { "LogConfigurations": [ { "CloudWatchLogsConfiguration": { "LogGroupArn": "arn:aws:logs:us-west-2:123456789012:log-group:cognito-exported" }, "EventSource": "userNotification", "LogLevel": "ERROR" }, { "EventSource": "userAuthEvents", "LogLevel": "INFO", "S3Configuration": { "BucketArn": "arn:aws:s3:::amzn-s3-demo-bucket1" } } ], "UserPoolId": "us-west-2_EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Exportieren von Benutzerpoolprotokollen](https://docs.aws.amazon.com/cognito/latest/developerguide/exporting-quotas-and-usage.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [SetLogDeliveryConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/set-log-delivery-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `set-risk-configuration` Das folgende Codebeispiel zeigt die Verwendung`set-risk-configuration`. **AWS CLI** **So legen Sie die Risikokonfiguration für den Bedrohungsschutz fest** Im folgenden Beispiel für `set-risk-configuration` werden Nachrichten und Aktionen zum Schutz vor Bedrohungen, kompromittierte Anmeldeinformationen und Ausnahmen für IP-Adressen im angeforderten App-Client konfiguriert. Aufgrund der Komplexität des NotifyConfiguration Objekts ist die JSON-Eingabe eine bewährte Methode für diesen Befehl. ``` aws cognito-idp set-risk-configuration \ --cli-input-json file://set-risk-configuration.json ``` Inhalt von `set-risk-configuration.json`: ``` { "AccountTakeoverRiskConfiguration": { "Actions": { "HighAction": { "EventAction": "MFA_REQUIRED", "Notify": true }, "LowAction": { "EventAction": "NO_ACTION", "Notify": true }, "MediumAction": { "EventAction": "MFA_IF_CONFIGURED", "Notify": true } }, "NotifyConfiguration": { "BlockEmail": { "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n
We blocked an unrecognized sign-in to your account with this information:\n
    \n
  • Time: {login-time}
    • \n
  • Device: {device-name}
    • \n
  • Location: {city}, {country}
    • \n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know
\n\n", "Subject": "Blocked sign-in attempt", "TextBody": "We blocked an unrecognized sign-in to your account with this information:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" }, "From": "admin@example.com", "MfaEmail": { "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n
We required you to use multi-factor authentication for the following sign-in attempt:\n
    \n
  • Time: {login-time}
    • \n
  • Device: {device-name}
    • \n
  • Location: {city}, {country}
    • \n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know
\n\n", "Subject": "New sign-in attempt", "TextBody": "We required you to use multi-factor authentication for the following sign-in attempt:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" }, "NoActionEmail": { "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n
We observed an unrecognized sign-in to your account with this information:\n
    \n
  • Time: {login-time}
    • \n
  • Device: {device-name}
    • \n
  • Location: {city}, {country}
    • \n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know
\n\n", "Subject": "New sign-in attempt", "TextBody": "We observed an unrecognized sign-in to your account with this information:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" }, "ReplyTo": "admin@example.com", "SourceArn": "arn:aws:ses:us-west-2:123456789012:identity/admin@example.com" } }, "ClientId": "1example23456789", "CompromisedCredentialsRiskConfiguration": { "Actions": { "EventAction": "BLOCK" }, "EventFilter": [ "PASSWORD_CHANGE", "SIGN_UP", "SIGN_IN" ] }, "RiskExceptionConfiguration": { "BlockedIPRangeList": [ "192.0.2.1/32", "192.0.2.2/32" ], "SkippedIPRangeList": [ "203.0.113.1/32", "203.0.113.2/32" ] }, "UserPoolId": "us-west-2_EXAMPLE" } ``` Ausgabe: ``` { "RiskConfiguration": { "AccountTakeoverRiskConfiguration": { "Actions": { "HighAction": { "EventAction": "MFA_REQUIRED", "Notify": true }, "LowAction": { "EventAction": "NO_ACTION", "Notify": true }, "MediumAction": { "EventAction": "MFA_IF_CONFIGURED", "Notify": true } }, "NotifyConfiguration": { "BlockEmail": { "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n
We blocked an unrecognized sign-in to your account with this information:\n
    \n
  • Time: {login-time}
    • \n
  • Device: {device-name}
    • \n
  • Location: {city}, {country}
    • \n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know
\n\n", "Subject": "Blocked sign-in attempt", "TextBody": "We blocked an unrecognized sign-in to your account with this information:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" }, "From": "admin@example.com", "MfaEmail": { "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n
We required you to use multi-factor authentication for the following sign-in attempt:\n
    \n
  • Time: {login-time}
    • \n
  • Device: {device-name}
    • \n
  • Location: {city}, {country}
    • \n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know
\n\n", "Subject": "New sign-in attempt", "TextBody": "We required you to use multi-factor authentication for the following sign-in attempt:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" }, "NoActionEmail": { "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n
We observed an unrecognized sign-in to your account with this information:\n
    \n
  • Time: {login-time}
    • \n
  • Device: {device-name}
    • \n
  • Location: {city}, {country}
    • \n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know
\n\n", "Subject": "New sign-in attempt", "TextBody": "We observed an unrecognized sign-in to your account with this information:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" }, "ReplyTo": "admin@example.com", "SourceArn": "arn:aws:ses:us-west-2:123456789012:identity/admin@example.com" } }, "ClientId": "1example23456789", "CompromisedCredentialsRiskConfiguration": { "Actions": { "EventAction": "BLOCK" }, "EventFilter": [ "PASSWORD_CHANGE", "SIGN_UP", "SIGN_IN" ] }, "RiskExceptionConfiguration": { "BlockedIPRangeList": [ "192.0.2.1/32", "192.0.2.2/32" ], "SkippedIPRangeList": [ "203.0.113.1/32", "203.0.113.2/32" ] }, "UserPoolId": "us-west-2_EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Schutz vor Bedrohungen](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pool-settings-threat-protection.html) im *ntwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [SetRiskConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/set-risk-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `set-ui-customization` Das folgende Codebeispiel zeigt die Verwendung`set-ui-customization`. **AWS CLI** **Beispiel 1: So passen Sie die klassische gehostete Benutzeroberfläche für einen App-Client an** Im folgenden Beispiel für `set-ui-customization` wird der angeforderte App-Client mit benutzerdefiniertem CSS und dem Amazon-Cognito-Logo als Anwendungslogo konfiguriert. ``` aws cognito-idp set-ui-customization \ --user-pool-id us-west-2_ywDJHlIfU \ --client-id 14pq32c5q2uq2q7keorloqvb23 \ --css ".logo-customizable {\n\tmax-width: 60%;\n\tmax-height: 30%;\n}\n.banner-customizable {\n\tpadding: 25px 0px 25px 0px;\n\tbackground-color: lightgray;\n}\n.label-customizable {\n\tfont-weight: 400;\n}\n.textDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.idpDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.legalText-customizable {\n\tcolor: #747474;\n\tfont-size: 11px;\n}\n.submitButton-customizable {\n\tfont-size: 11px;\n\tfont-weight: normal;\n\tmargin: 20px -15px 10px -13px;\n\theight: 40px;\n\twidth: 108%;\n\tcolor: #fff;\n\tbackground-color: #337ab7;\n\ttext-align: center;\n}\n.submitButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #286090;\n}\n.errorMessage-customizable {\n\tpadding: 5px;\n\tfont-size: 14px;\n\twidth: 100%;\n\tbackground: #F5F5F5;\n\tborder: 2px solid #D64958;\n\tcolor: #D64958;\n}\n.inputField-customizable {\n\twidth: 100%;\n\theight: 34px;\n\tcolor: #555;\n\tbackground-color: #fff;\n\tborder: 1px solid #ccc;\n\tborder-radius: 0px;\n}\n.inputField-customizable:focus {\n\tborder-color: #66afe9;\n\toutline: 0;\n}\n.idpButton-customizable {\n\theight: 40px;\n\twidth: 100%;\n\twidth: 100%;\n\ttext-align: center;\n\tmargin-bottom: 15px;\n\tcolor: #fff;\n\tbackground-color: #5bc0de;\n\tborder-color: #46b8da;\n}\n.idpButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #31b0d5;\n}\n.socialButton-customizable {\n\tborder-radius: 2px;\n\theight: 40px;\n\tmargin-bottom: 15px;\n\tpadding: 1px;\n\ttext-align: left;\n\twidth: 100%;\n}\n.redirect-customizable {\n\ttext-align: center;\n}\n.passwordCheck-notValid-customizable {\n\tcolor: #DF3312;\n}\n.passwordCheck-valid-customizable {\n\tcolor: #19BF00;\n}\n.background-customizable {\n\tbackground-color: #fff;\n}\n" \ --image-file iVBORw0KGgoAAAANSUhEUgAAAFAAAABQCAMAAAC5zwKfAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAA2UExURd00TN9BV/Cmsfvm6f3y9P////fM0uqAj+yNmu6ZpvnZ3eNabuFNYuZneehzhPKzvPTAxwAAAOiMMlkAAAASdFJOU///////////////////////AOK/vxIAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAKDSURBVFhH7ZfpkoMgEISDHKuEw/d/2u2BQWMiBrG29o+fVsKatdPMAeZxc3Nz8w+ISekzmB++sYIw/I/tjHzrPpO2Tx62EbR2PNxFac+jVuKxRaV50IzXkUe76NOCoUuwlvnQKei02gNF0ykotOLRBq/nboeWRxAISx2EbsHFoRhK6Igk2JJlwScfQjgt06dOaWWiTbEDAe/iq8N9kqCw2uCbHkHlYkaXEF8EYeL9RDqT4FhC6XMIIEifdcUwCc4leNyhabadWU6OlKYJE1Oac3NSPhB5rlaXlSgmr/1lww4nPaU/1ylfLGxX1r6Y66ZZkCqvnOlqKWws59ELj7fULc2CubwySYkdDuuiY0/F0L6Q5pZiSG0SfZTSTCOUhxOCH1AdIoCpTTIjtd+VpEjUDDytQH/0Fpc661Aisas/4qmyUItD557pSCOSQQzlx27J+meyDGc5zZgfhWuXE1lGgmVOMwmWdeGdzhjqZV14x5vSj7vsC5JDz/Cl0Vhp56n2NQt1wQIpury1EPbwyaYm+IhmAQKoajkH51wg4cMZ1wQ3QG9efKWWOaDhYWnU6jXjCMdRmm21PArI+Pb5DYoH93hq0ZCPlxeGJho/DI15C6sQc/L2sTC47UFBKZGHT6k+zlXg7WebA0Nr0HTcLMfk/Y4Rc65D3iG6WDd7YLSlVqk87bVhUwhnClrx11RsVQwlAA818Mn+QEs71BhSFU6orsUfKhHp72XMGYXi4q9c64RXRvzkWurRfG2vI2be/VaNcNgpX0Evb/vio7nPMmj5qujkpQgSaPd1UcVqciHFDNZpOcGlcOPyi+AamCbIL9fitxAGeFN2Dl+3vZubm5u/4fH4Bd14HhIPdwZPAAAAAElFTkSuQmCC ``` Ausgabe: ``` { "UICustomization": { "UserPoolId": "us-west-2_ywDJHlIfU", "ClientId": "14pq32c5q2uq2q7keorloqvb23", "ImageUrl": "https://cf.thewrong.club/14pq32c5q2uq2q7keorloqvb23/20250117005911/assets/images/image.jpg", "CSS": ".logo-customizable {\n\tmax-width: 60%;\n\tmax-height: 30%;\n}\n.banner-customizable {\n\tpadding: 25px 0px 25px 0px;\n\tbackground-color: lightgray;\n}\n.label-customizable {\n\tfont-weight: 400;\n}\n.textDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.idpDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.legalText-customizable {\n\tcolor: #747474;\n\tfont-size: 11px;\n}\n.submitButton-customizable {\n\tfont-size: 11px;\n\tfont-weight: normal;\n\tmargin: 20px -15px 10px -13px;\n\theight: 40px;\n\twidth: 108%;\n\tcolor: #fff;\n\tbackground-color: #337ab7;\n\ttext-align: center;\n}\n.submitButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #286090;\n}\n.errorMessage-customizable {\n\tpadding: 5px;\n\tfont-size: 14px;\n\twidth: 100%;\n\tbackground: #F5F5F5;\n\tborder: 2px solid #D64958;\n\tcolor: #D64958;\n}\n.inputField-customizable {\n\twidth: 100%;\n\theight: 34px;\n\tcolor: #555;\n\tbackground-color: #fff;\n\tborder: 1px solid #ccc;\n\tborder-radius: 0px;\n}\n.inputField-customizable:focus {\n\tborder-color: #66afe9;\n\toutline: 0;\n}\n.idpButton-customizable {\n\theight: 40px;\n\twidth: 100%;\n\twidth: 100%;\n\ttext-align: center;\n\tmargin-bottom: 15px;\n\tcolor: #fff;\n\tbackground-color: #5bc0de;\n\tborder-color: #46b8da;\n}\n.idpButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #31b0d5;\n}\n.socialButton-customizable {\n\tborder-radius: 2px;\n\theight: 40px;\n\tmargin-bottom: 15px;\n\tpadding: 1px;\n\ttext-align: left;\n\twidth: 100%;\n}\n.redirect-customizable {\n\ttext-align: center;\n}\n.passwordCheck-notValid-customizable {\n\tcolor: #DF3312;\n}\n.passwordCheck-valid-customizable {\n\tcolor: #19BF00;\n}\n.background-customizable {\n\tbackground-color: #fff;\n}\n", "CSSVersion": "20250117005911" } } ``` **Beispiel 2: So legen Sie die standardmäßige Anpassung der Benutzeroberfläche für alle App-Clients fest** Im folgenden Beispiel für `set-ui-customization` wird der angeforderte Benutzerpool für alle App-Clients konfiguriert, die keine clientspezifische Konfiguration besitzen. Der Befehl wendet benutzerdefiniertes CSS an und verwendet das Amazon-Cognito-Logo als Anwendungslogo. ``` aws cognito-idp set-ui-customization \ --user-pool-id us-west-2_ywDJHlIfU \ --client-id ALL \ --css ".logo-customizable {\n\tmax-width: 60%;\n\tmax-height: 30%;\n}\n.banner-customizable {\n\tpadding: 25px 0px 25px 0px;\n\tbackground-color: lightgray;\n}\n.label-customizable {\n\tfont-weight: 400;\n}\n.textDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.idpDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.legalText-customizable {\n\tcolor: #747474;\n\tfont-size: 11px;\n}\n.submitButton-customizable {\n\tfont-size: 11px;\n\tfont-weight: normal;\n\tmargin: 20px -15px 10px -13px;\n\theight: 40px;\n\twidth: 108%;\n\tcolor: #fff;\n\tbackground-color: #337ab7;\n\ttext-align: center;\n}\n.submitButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #286090;\n}\n.errorMessage-customizable {\n\tpadding: 5px;\n\tfont-size: 14px;\n\twidth: 100%;\n\tbackground: #F5F5F5;\n\tborder: 2px solid #D64958;\n\tcolor: #D64958;\n}\n.inputField-customizable {\n\twidth: 100%;\n\theight: 34px;\n\tcolor: #555;\n\tbackground-color: #fff;\n\tborder: 1px solid #ccc;\n\tborder-radius: 0px;\n}\n.inputField-customizable:focus {\n\tborder-color: #66afe9;\n\toutline: 0;\n}\n.idpButton-customizable {\n\theight: 40px;\n\twidth: 100%;\n\twidth: 100%;\n\ttext-align: center;\n\tmargin-bottom: 15px;\n\tcolor: #fff;\n\tbackground-color: #5bc0de;\n\tborder-color: #46b8da;\n}\n.idpButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #31b0d5;\n}\n.socialButton-customizable {\n\tborder-radius: 2px;\n\theight: 40px;\n\tmargin-bottom: 15px;\n\tpadding: 1px;\n\ttext-align: left;\n\twidth: 100%;\n}\n.redirect-customizable {\n\ttext-align: center;\n}\n.passwordCheck-notValid-customizable {\n\tcolor: #DF3312;\n}\n.passwordCheck-valid-customizable {\n\tcolor: #19BF00;\n}\n.background-customizable {\n\tbackground-color: #fff;\n}\n" \ --image-file iVBORw0KGgoAAAANSUhEUgAAAFAAAABQCAMAAAC5zwKfAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAA2UExURd00TN9BV/Cmsfvm6f3y9P////fM0uqAj+yNmu6ZpvnZ3eNabuFNYuZneehzhPKzvPTAxwAAAOiMMlkAAAASdFJOU///////////////////////AOK/vxIAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAKDSURBVFhH7ZfpkoMgEISDHKuEw/d/2u2BQWMiBrG29o+fVsKatdPMAeZxc3Nz8w+ISekzmB++sYIw/I/tjHzrPpO2Tx62EbR2PNxFac+jVuKxRaV50IzXkUe76NOCoUuwlvnQKei02gNF0ykotOLRBq/nboeWRxAISx2EbsHFoRhK6Igk2JJlwScfQjgt06dOaWWiTbEDAe/iq8N9kqCw2uCbHkHlYkaXEF8EYeL9RDqT4FhC6XMIIEifdcUwCc4leNyhabadWU6OlKYJE1Oac3NSPhB5rlaXlSgmr/1lww4nPaU/1ylfLGxX1r6Y66ZZkCqvnOlqKWws59ELj7fULc2CubwySYkdDuuiY0/F0L6Q5pZiSG0SfZTSTCOUhxOCH1AdIoCpTTIjtd+VpEjUDDytQH/0Fpc661Aisas/4qmyUItD557pSCOSQQzlx27J+meyDGc5zZgfhWuXE1lGgmVOMwmWdeGdzhjqZV14x5vSj7vsC5JDz/Cl0Vhp56n2NQt1wQIpury1EPbwyaYm+IhmAQKoajkH51wg4cMZ1wQ3QG9efKWWOaDhYWnU6jXjCMdRmm21PArI+Pb5DYoH93hq0ZCPlxeGJho/DI15C6sQc/L2sTC47UFBKZGHT6k+zlXg7WebA0Nr0HTcLMfk/Y4Rc65D3iG6WDd7YLSlVqk87bVhUwhnClrx11RsVQwlAA818Mn+QEs71BhSFU6orsUfKhHp72XMGYXi4q9c64RXRvzkWurRfG2vI2be/VaNcNgpX0Evb/vio7nPMmj5qujkpQgSaPd1UcVqciHFDNZpOcGlcOPyi+AamCbIL9fitxAGeFN2Dl+3vZubm5u/4fH4Bd14HhIPdwZPAAAAAElFTkSuQmCC ``` Ausgabe: ``` { "UICustomization": { "UserPoolId": "us-west-2_ywDJHlIfU", "ClientId": "14pq32c5q2uq2q7keorloqvb23", "ImageUrl": "https://cf.thewrong.club/14pq32c5q2uq2q7keorloqvb23/20250117005911/assets/images/image.jpg", "CSS": ".logo-customizable {\n\tmax-width: 60%;\n\tmax-height: 30%;\n}\n.banner-customizable {\n\tpadding: 25px 0px 25px 0px;\n\tbackground-color: lightgray;\n}\n.label-customizable {\n\tfont-weight: 400;\n}\n.textDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.idpDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.legalText-customizable {\n\tcolor: #747474;\n\tfont-size: 11px;\n}\n.submitButton-customizable {\n\tfont-size: 11px;\n\tfont-weight: normal;\n\tmargin: 20px -15px 10px -13px;\n\theight: 40px;\n\twidth: 108%;\n\tcolor: #fff;\n\tbackground-color: #337ab7;\n\ttext-align: center;\n}\n.submitButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #286090;\n}\n.errorMessage-customizable {\n\tpadding: 5px;\n\tfont-size: 14px;\n\twidth: 100%;\n\tbackground: #F5F5F5;\n\tborder: 2px solid #D64958;\n\tcolor: #D64958;\n}\n.inputField-customizable {\n\twidth: 100%;\n\theight: 34px;\n\tcolor: #555;\n\tbackground-color: #fff;\n\tborder: 1px solid #ccc;\n\tborder-radius: 0px;\n}\n.inputField-customizable:focus {\n\tborder-color: #66afe9;\n\toutline: 0;\n}\n.idpButton-customizable {\n\theight: 40px;\n\twidth: 100%;\n\twidth: 100%;\n\ttext-align: center;\n\tmargin-bottom: 15px;\n\tcolor: #fff;\n\tbackground-color: #5bc0de;\n\tborder-color: #46b8da;\n}\n.idpButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #31b0d5;\n}\n.socialButton-customizable {\n\tborder-radius: 2px;\n\theight: 40px;\n\tmargin-bottom: 15px;\n\tpadding: 1px;\n\ttext-align: left;\n\twidth: 100%;\n}\n.redirect-customizable {\n\ttext-align: center;\n}\n.passwordCheck-notValid-customizable {\n\tcolor: #DF3312;\n}\n.passwordCheck-valid-customizable {\n\tcolor: #19BF00;\n}\n.background-customizable {\n\tbackground-color: #fff;\n}\n", "CSSVersion": "20250117005911" } } ``` Weitere Informationen finden Sie unter [Branding für gehostete Benutzeroberflächen (klassisch)](https://docs.aws.amazon.com/cognito/latest/developerguide/hosted-ui-classic-branding.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [SetUiCustomization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/set-ui-customization.html)in der *AWS CLI Befehlsreferenz*. ### `set-user-mfa-preference` Das folgende Codebeispiel zeigt die Verwendung`set-user-mfa-preference`. **AWS CLI** **So legen Sie die MFA-Einstellung für einen Benutzer fest** Im folgenden Beispiel für `set-user-mfa-preference` wird der aktuelle Benutzer für die Verwendung von TOTP MFA konfiguriert und alle anderen MFA-Faktoren werden deaktiviert. ``` aws cognito-idp set-user-mfa-preference \ --access-token eyJra456defEXAMPLE \ --software-token-mfa-settings Enabled=true,PreferredMfa=true \ --sms-mfa-settings Enabled=false,PreferredMfa=false \ --email-mfa-settings Enabled=false,PreferredMfa=false ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen von MFA](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-mfa.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [SetUserMfaPreference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/set-user-mfa-preference.html)in der *AWS CLI Befehlsreferenz*. ### `set-user-pool-mfa-config` Das folgende Codebeispiel zeigt die Verwendung`set-user-pool-mfa-config`. **AWS CLI** **Um den Benutzerpool MFA zu konfigurieren und WebAuthn** Im folgenden `set-user-pool-mfa-config` Beispiel wird der angeforderte Benutzerpool mit optionaler MFA mit allen verfügbaren MFA-Methoden konfiguriert und die Konfiguration festgelegt. WebAuthn ``` aws cognito-idp set-user-pool-mfa-config \ --user-pool-id us-west-2_EXAMPLE \ --sms-mfa-configuration "SmsAuthenticationMessage=\"Your OTP for MFA or sign-in: use {####}.\",SmsConfiguration={SnsCallerArn=arn:aws:iam::123456789012:role/service-role/test-SMS-Role,ExternalId=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111,SnsRegion=us-west-2}" \ --software-token-mfa-configuration Enabled=true \ --email-mfa-configuration "Message=\"Your OTP for MFA or sign-in: use {####}\",Subject=\"OTP test\"" \ --mfa-configuration OPTIONAL \ --web-authn-configuration RelyingPartyId=auth.example.com,UserVerification=preferred ``` Ausgabe: ``` { "EmailMfaConfiguration": { "Message": "Your OTP for MFA or sign-in: use {####}", "Subject": "OTP test" }, "MfaConfiguration": "OPTIONAL", "SmsMfaConfiguration": { "SmsAuthenticationMessage": "Your OTP for MFA or sign-in: use {####}.", "SmsConfiguration": { "ExternalId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "SnsCallerArn": "arn:aws:iam::123456789012:role/service-role/test-SMS-Role", "SnsRegion": "us-west-2" } }, "SoftwareTokenMfaConfiguration": { "Enabled": true }, "WebAuthnConfiguration": { "RelyingPartyId": "auth.example.com", "UserVerification": "preferred" } } ``` Weitere Informationen finden Sie unter [Hinzufügen von MFA](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-mfa.html) und [Passkey sign-in](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-authentication-flow-methods.html#amazon-cognito-user-pools-authentication-flow-methods-passkey) im *Entwicklerhandbuch für Amazon Cognito*. + *Einzelheiten zur API finden Sie [SetUserPoolMfaConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/set-user-pool-mfa-config.html)in AWS CLI der Befehlsreferenz.* ### `set-user-settings` Das folgende Codebeispiel zeigt die Verwendung`set-user-settings`. **AWS CLI** **So legen Sie Benutzereinstellungen fest** In diesem Beispiel wird die MFA-Bereitstellungseinstellung auf EMAIL festgelegt. Befehl: ``` aws cognito-idp set-user-settings --access-token ACCESS_TOKEN --mfa-options DeliveryMedium=EMAIL ``` + Einzelheiten zur API finden Sie [SetUserSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/set-user-settings.html)in der *AWS CLI Befehlsreferenz*. ### `sign-up` Das folgende Codebeispiel zeigt die Verwendung`sign-up`. **AWS CLI** **So registrieren einen Benutzer** In diesem Beispiel wird jane@example.com registriert. Befehl: ``` aws cognito-idp sign-up --client-id 3n4b5urk1ft4fl3mg5e62d9ado --username jane@example.com --password PASSWORD --user-attributes Name="email",Value="jane@example.com" Name="name",Value="Jane" ``` Ausgabe: ``` { "UserConfirmed": false, "UserSub": "e04d60a6-45dc-441c-a40b-e25a787d4862" } ``` + Einzelheiten zur API finden Sie [SignUp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/sign-up.html)in der *AWS CLI Befehlsreferenz*. ### `start-user-import-job` Das folgende Codebeispiel zeigt die Verwendung`start-user-import-job`. **AWS CLI** **So starten Sie einen Importauftrag** Im folgenden Beispiel für `start-user-import-job` wird der angeforderte Importauftrag im angeforderten Benutzerpool gestartet. ``` aws cognito-idp start-user-import-job \ --user-pool-id us-west-2_EXAMPLE \ --job-id import-mAgUtd8PMm ``` Ausgabe: ``` { "UserImportJob": { "CloudWatchLogsRoleArn": "arn:aws:iam::123456789012:role/example-cloudwatch-logs-role", "CreationDate": 1736442975.904, "FailedUsers": 0, "ImportedUsers": 0, "JobId": "import-mAgUtd8PMm", "JobName": "Customer import", "PreSignedUrl": "https://aws-cognito-idp-user-import-pdx.s3.us-west-2.amazonaws.com/123456789012/us-west-2_EXAMPLE/import-mAgUtd8PMm?X-Amz-Security-Token=[token]&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20241226T193341Z&X-Amz-SignedHeaders=host%3Bx-amz-server-side-encryption&X-Amz-Expires=899&X-Amz-Credential=[credential]&X-Amz-Signature=[signature]", "SkippedUsers": 0, "StartDate": 1736443020.081, "Status": "Pending", "UserPoolId": "us-west-2_EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Importieren von Benutzern in einen Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-using-import-tool.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [StartUserImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/start-user-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-web-authn-registration` Das folgende Codebeispiel zeigt die Verwendung`start-web-authn-registration`. **AWS CLI** **So rufen Sie Passkey-Registrierungsinformationen für einen angemeldeten Benutzer ab** Das folgende `start-web-authn-registration` Beispiel generiert WebAuthn Registrierungsoptionen für den aktuellen Benutzer. ``` aws cognito-idp start-web-authn-registration \ --access-token eyJra456defEXAMPLE ``` Ausgabe: ``` { "CredentialCreationOptions": { "authenticatorSelection": { "requireResidentKey": true, "residentKey": "required", "userVerification": "preferred" }, "challenge": "wxvbDicyqQqvF2EXAMPLE", "excludeCredentials": [ { "id": "8LApgk4-lNUFHbhm2w6Und7-uxcc8coJGsPxiogvHoItc64xWQc3r4CEXAMPLE", "type": "public-key" } ], "pubKeyCredParams": [ { "alg": -7, "type": "public-key" }, { "alg": -257, "type": "public-key" } ], "rp": { "id": "auth.example.com", "name": "auth.example.com" }, "timeout": 60000, "user": { "displayName": "testuser", "id": "ZWFhZDAyMTktMjExNy00MzlmLThkNDYtNGRiMjBlNEXAMPLE", "name": "testuser" } } } ``` Weitere Informationen finden Sie unter [Anmeldung mit Passkey](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-authentication-flow-methods.html#amazon-cognito-user-pools-authentication-flow-methods-passkey) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [StartWebAuthnRegistration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/start-web-authn-registration.html)in der *AWS CLI Befehlsreferenz*. ### `stop-user-import-job` Das folgende Codebeispiel zeigt die Verwendung`stop-user-import-job`. **AWS CLI** **So halten Sie einen Importauftrag an** Im folgenden Beispiel für `stop-user-import-job` wird der angeforderte laufende Benutzerimportauftrag im angeforderten Benutzerpool angehalten. ``` aws cognito-idp stop-user-import-job \ --user-pool-id us-west-2_EXAMPLE \ --job-id import-mAgUtd8PMm ``` Ausgabe: ``` { "UserImportJob": { "CloudWatchLogsRoleArn": "arn:aws:iam::123456789012:role/example-cloudwatch-logs-role", "CompletionDate": 1736443496.379, "CompletionMessage": "The Import Job was stopped by the developer.", "CreationDate": 1736443471.781, "FailedUsers": 0, "ImportedUsers": 0, "JobId": "import-mAgUtd8PMm", "JobName": "Customer import", "PreSignedUrl": "https://aws-cognito-idp-user-import-pdx.s3.us-west-2.amazonaws.com/123456789012/us-west-2_EXAMPLE/import-mAgUtd8PMm?X-Amz-Security-Token=[token]&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20241226T193341Z&X-Amz-SignedHeaders=host%3Bx-amz-server-side-encryption&X-Amz-Expires=899&X-Amz-Credential=[credential]&X-Amz-Signature=[signature]", "SkippedUsers": 0, "StartDate": 1736443494.154, "Status": "Stopped", "UserPoolId": "us-west-2_EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Importieren von Benutzern in einen Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-using-import-tool.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [StopUserImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/stop-user-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie einen Benutzerpool** Im folgenden Beispiel für `tag-resource` werden die Tags `administrator` und `department` auf den angeforderten Benutzerpool angewendet. ``` aws cognito-idp tag-resource \ --resource-arn arn:aws:cognito-idp:us-west-2:123456789012:userpool/us-west-2_EXAMPLE \ --tags administrator=Jie,tenant=ExampleCorp ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging von Amazon-Cognito-Ressourcen](https://docs.aws.amazon.com/cognito/latest/developerguide/tagging.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einem Benutzerpool** Im folgenden Beispiel für `untag-resource` werden die Tags `administrator` und `department` aus dem angeforderten Benutzerpool entfernt. ``` aws cognito-idp untag-resource \ --resource-arn arn:aws:cognito-idp:us-west-2:767671399759:userpool/us-west-2_l5cxwdm2K \ --tag-keys administrator tenant ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging von Amazon-Cognito-Ressourcen](https://docs.aws.amazon.com/cognito/latest/developerguide/tagging.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-auth-event-feedback` Das folgende Codebeispiel zeigt die Verwendung`update-auth-event-feedback`. **AWS CLI** **So aktualisieren Sie Feedback zu Authentifizierungsereignissen** In diesem Beispiel wird das Feedback zu Autorisierungsereignissen aktualisiert. Das Ereignis wird als „Valid“ markiert. Befehl: ``` aws cognito-idp update-auth-event-feedback --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --event-id EVENT_ID --feedback-token FEEDBACK_TOKEN --feedback-value "Valid" ``` + Einzelheiten zur API finden Sie [UpdateAuthEventFeedback](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-auth-event-feedback.html)in der *AWS CLI Befehlsreferenz*. ### `update-device-status` Das folgende Codebeispiel zeigt die Verwendung`update-device-status`. **AWS CLI** **So aktualisieren Sie den Gerätestatus** In diesem Beispiel wird der Status eines Geräts auf „not\$1remembered“ aktualisiert. Befehl: ``` aws cognito-idp update-device-status --access-token ACCESS_TOKEN --device-key DEVICE_KEY --device-remembered-status "not_remembered" ``` + Einzelheiten zur API finden Sie [UpdateDeviceStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-device-status.html)in der *AWS CLI Befehlsreferenz*. ### `update-group` Das folgende Codebeispiel zeigt die Verwendung`update-group`. **AWS CLI** **So aktualisieren Sie eine Gruppe** In diesem Beispiel werden die Beschreibung und die Rangfolge von aktualisiert. MyGroup Befehl: ``` aws cognito-idp update-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyGroup --description "New description" --precedence 2 ``` Ausgabe: ``` { "Group": { "GroupName": "MyGroup", "UserPoolId": "us-west-2_aaaaaaaaa", "Description": "New description", "RoleArn": "arn:aws:iam::111111111111:role/MyRole", "Precedence": 2, "LastModifiedDate": 1548800862.812, "CreationDate": 1548097827.125 } } ``` + Einzelheiten zur API finden Sie unter [UpdateGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-group.html)*Befehlsreferenz.* ### `update-identity-provider` Das folgende Codebeispiel zeigt die Verwendung`update-identity-provider`. **AWS CLI** **So aktualisieren Sie einen Identitätsanbieter für einen Benutzerpool** Das folgende `update-identity-provider` Beispiel aktualisiert den OIDC-Anbieter „My OIDCId P“ im angeforderten Benutzerpool. ``` aws cognito-idp update-identity-provider \ --cli-input-json file://update-identity-provider.json ``` Inhalt von `update-identity-provider.json`: ``` { "AttributeMapping": { "email": "idp_email", "email_verified": "idp_email_verified", "username": "sub" }, "CreationDate": 1.701129701653E9, "IdpIdentifiers": [ "corp", "dev" ], "LastModifiedDate": 1.701129701653E9, "ProviderDetails": { "attributes_request_method": "GET", "attributes_url": "https://example.com/userInfo", "attributes_url_add_attributes": "false", "authorize_scopes": "openid profile", "authorize_url": "https://example.com/authorize", "client_id": "idpexampleclient123", "client_secret": "idpexamplesecret456", "jwks_uri": "https://example.com/.well-known/jwks.json", "oidc_issuer": "https://example.com", "token_url": "https://example.com/token" }, "ProviderName": "MyOIDCIdP", "UserPoolId": "us-west-2_EXAMPLE" } ``` Ausgabe: ``` { "IdentityProvider": { "AttributeMapping": { "email": "idp_email", "email_verified": "idp_email_verified", "username": "sub" }, "CreationDate": 1701129701.653, "IdpIdentifiers": [ "corp", "dev" ], "LastModifiedDate": 1736444278.211, "ProviderDetails": { "attributes_request_method": "GET", "attributes_url": "https://example.com/userInfo", "attributes_url_add_attributes": "false", "authorize_scopes": "openid profile", "authorize_url": "https://example.com/authorize", "client_id": "idpexampleclient123", "client_secret": "idpexamplesecret456", "jwks_uri": "https://example.com/.well-known/jwks.json", "oidc_issuer": "https://example.com", "token_url": "https://example.com/token" }, "ProviderName": "MyOIDCIdP", "ProviderType": "OIDC", "UserPoolId": "us-west-2_EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Konfigurieren einer Domain](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-assign-domain.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie unter [UpdateIdentityProvider AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-identity-provider.html)*Befehlsreferenz*. ### `update-managed-login-branding` Das folgende Codebeispiel zeigt die Verwendung`update-managed-login-branding`. **AWS CLI** **So aktualisieren Sie den Branding-Stil einer verwalteten Anmeldung** Im folgenden Beispiel für `update-managed-login-branding` wird der Branding-Stil des angeforderten App-Clients aktualisiert. ``` aws cognito-idp update-managed-login-branding \ --cli-input-json file://update-managed-login-branding.json ``` Inhalt von `update-managed-login-branding.json`: ``` { "Assets": [ { "Bytes": "PHN2ZyB3aWR0aD0iMjAwMDAiIGhlaWdodD0iNDAwIiB2aWV3Qm94PSIwIDAgMjAwMDAgNDAwIiBmaWxsPSJub25lIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8ZyBjbGlwLXBhdGg9InVybCgjY2xpcDBfMTcyNTlfMjM2Njc0KSI+CjxyZWN0IHdpZHRoPSIyMDAwMCIgaGVpZ2h0PSI0MDAiIGZpbGw9InVybCgjcGFpbnQwX2xpbmVhcl8xNzI1OV8yMzY2NzQpIi8+CjxwYXRoIGQ9Ik0wIDBIMjAwMDBWNDAwSDBWMFoiIGZpbGw9IiMxMjIwMzciIGZpbGwtb3BhY2l0eT0iMC41Ii8+CjwvZz4KPGRlZnM+CjxsaW5lYXJHcmFkaWVudCBpZD0icGFpbnQwX2xpbmVhcl8xNzI1OV8yMzY2NzQiIHgxPSItODk0LjI0OSIgeTE9IjE5OS45MzEiIHgyPSIxODAzNC41IiB5Mj0iLTU4OTkuNTciIGdyYWRpZW50VW5pdHM9InVzZXJTcGFjZU9uVXNlIj4KPHN0b3Agc3RvcC1jb2xvcj0iI0JGODBGRiIvPgo8c3RvcCBvZmZzZXQ9IjEiIHN0b3AtY29sb3I9IiNGRjhGQUIiLz4KPC9saW5lYXJHcmFkaWVudD4KPGNsaXBQYXRoIGlkPSJjbGlwMF8xNzI1OV8yMzY2NzQiPgo8cmVjdCB3aWR0aD0iMjAwMDAiIGhlaWdodD0iNDAwIiBmaWxsPSJ3aGl0ZSIvPgo8L2NsaXBQYXRoPgo8L2RlZnM+Cjwvc3ZnPgo=", "Category": "PAGE_FOOTER_BACKGROUND", "ColorMode": "DARK", "Extension": "SVG" } ], "ManagedLoginBrandingId": "63f30090-6b1f-4278-b885-2bbb81f8e545", "Settings": { "categories": { "auth": { "authMethodOrder": [ [ { "display": "BUTTON", "type": "FEDERATED" }, { "display": "INPUT", "type": "USERNAME_PASSWORD" } ] ], "federation": { "interfaceStyle": "BUTTON_LIST", "order": [ ] } }, "form": { "displayGraphics": true, "instructions": { "enabled": false }, "languageSelector": { "enabled": false }, "location": { "horizontal": "CENTER", "vertical": "CENTER" }, "sessionTimerDisplay": "NONE" }, "global": { "colorSchemeMode": "LIGHT", "pageFooter": { "enabled": false }, "pageHeader": { "enabled": false }, "spacingDensity": "REGULAR" }, "signUp": { "acceptanceElements": [ { "enforcement": "NONE", "textKey": "en" } ] } }, "componentClasses": { "buttons": { "borderRadius": 8.0 }, "divider": { "darkMode": { "borderColor": "232b37ff" }, "lightMode": { "borderColor": "ebebf0ff" } }, "dropDown": { "borderRadius": 8.0, "darkMode": { "defaults": { "itemBackgroundColor": "192534ff" }, "hover": { "itemBackgroundColor": "081120ff", "itemBorderColor": "5f6b7aff", "itemTextColor": "e9ebedff" }, "match": { "itemBackgroundColor": "d1d5dbff", "itemTextColor": "89bdeeff" } }, "lightMode": { "defaults": { "itemBackgroundColor": "ffffffff" }, "hover": { "itemBackgroundColor": "f4f4f4ff", "itemBorderColor": "7d8998ff", "itemTextColor": "000716ff" }, "match": { "itemBackgroundColor": "414d5cff", "itemTextColor": "0972d3ff" } } }, "focusState": { "darkMode": { "borderColor": "539fe5ff" }, "lightMode": { "borderColor": "0972d3ff" } }, "idpButtons": { "icons": { "enabled": true } }, "input": { "borderRadius": 8.0, "darkMode": { "defaults": { "backgroundColor": "0f1b2aff", "borderColor": "5f6b7aff" }, "placeholderColor": "8d99a8ff" }, "lightMode": { "defaults": { "backgroundColor": "ffffffff", "borderColor": "7d8998ff" }, "placeholderColor": "5f6b7aff" } }, "inputDescription": { "darkMode": { "textColor": "8d99a8ff" }, "lightMode": { "textColor": "5f6b7aff" } }, "inputLabel": { "darkMode": { "textColor": "d1d5dbff" }, "lightMode": { "textColor": "000716ff" } }, "link": { "darkMode": { "defaults": { "textColor": "539fe5ff" }, "hover": { "textColor": "89bdeeff" } }, "lightMode": { "defaults": { "textColor": "0972d3ff" }, "hover": { "textColor": "033160ff" } } }, "optionControls": { "darkMode": { "defaults": { "backgroundColor": "0f1b2aff", "borderColor": "7d8998ff" }, "selected": { "backgroundColor": "539fe5ff", "foregroundColor": "000716ff" } }, "lightMode": { "defaults": { "backgroundColor": "ffffffff", "borderColor": "7d8998ff" }, "selected": { "backgroundColor": "0972d3ff", "foregroundColor": "ffffffff" } } }, "statusIndicator": { "darkMode": { "error": { "backgroundColor": "1a0000ff", "borderColor": "eb6f6fff", "indicatorColor": "eb6f6fff" }, "pending": { "indicatorColor": "AAAAAAAA" }, "success": { "backgroundColor": "001a02ff", "borderColor": "29ad32ff", "indicatorColor": "29ad32ff" }, "warning": { "backgroundColor": "1d1906ff", "borderColor": "e0ca57ff", "indicatorColor": "e0ca57ff" } }, "lightMode": { "error": { "backgroundColor": "fff7f7ff", "borderColor": "d91515ff", "indicatorColor": "d91515ff" }, "pending": { "indicatorColor": "AAAAAAAA" }, "success": { "backgroundColor": "f2fcf3ff", "borderColor": "037f0cff", "indicatorColor": "037f0cff" }, "warning": { "backgroundColor": "fffce9ff", "borderColor": "8d6605ff", "indicatorColor": "8d6605ff" } } } }, "components": { "alert": { "borderRadius": 12.0, "darkMode": { "error": { "backgroundColor": "1a0000ff", "borderColor": "eb6f6fff" } }, "lightMode": { "error": { "backgroundColor": "fff7f7ff", "borderColor": "d91515ff" } } }, "favicon": { "enabledTypes": [ "ICO", "SVG" ] }, "form": { "backgroundImage": { "enabled": false }, "borderRadius": 8.0, "darkMode": { "backgroundColor": "0f1b2aff", "borderColor": "424650ff" }, "lightMode": { "backgroundColor": "ffffffff", "borderColor": "c6c6cdff" }, "logo": { "enabled": false, "formInclusion": "IN", "location": "CENTER", "position": "TOP" } }, "idpButton": { "custom": { }, "standard": { "darkMode": { "active": { "backgroundColor": "354150ff", "borderColor": "89bdeeff", "textColor": "89bdeeff" }, "defaults": { "backgroundColor": "0f1b2aff", "borderColor": "c6c6cdff", "textColor": "c6c6cdff" }, "hover": { "backgroundColor": "192534ff", "borderColor": "89bdeeff", "textColor": "89bdeeff" } }, "lightMode": { "active": { "backgroundColor": "d3e7f9ff", "borderColor": "033160ff", "textColor": "033160ff" }, "defaults": { "backgroundColor": "ffffffff", "borderColor": "424650ff", "textColor": "424650ff" }, "hover": { "backgroundColor": "f2f8fdff", "borderColor": "033160ff", "textColor": "033160ff" } } } }, "pageBackground": { "darkMode": { "color": "0f1b2aff" }, "image": { "enabled": true }, "lightMode": { "color": "ffffffff" } }, "pageFooter": { "backgroundImage": { "enabled": false }, "darkMode": { "background": { "color": "0f141aff" }, "borderColor": "424650ff" }, "lightMode": { "background": { "color": "fafafaff" }, "borderColor": "d5dbdbff" }, "logo": { "enabled": false, "location": "START" } }, "pageHeader": { "backgroundImage": { "enabled": false }, "darkMode": { "background": { "color": "0f141aff" }, "borderColor": "424650ff" }, "lightMode": { "background": { "color": "fafafaff" }, "borderColor": "d5dbdbff" }, "logo": { "enabled": false, "location": "START" } }, "pageText": { "darkMode": { "bodyColor": "b6bec9ff", "descriptionColor": "b6bec9ff", "headingColor": "d1d5dbff" }, "lightMode": { "bodyColor": "414d5cff", "descriptionColor": "414d5cff", "headingColor": "000716ff" } }, "phoneNumberSelector": { "displayType": "TEXT" }, "primaryButton": { "darkMode": { "active": { "backgroundColor": "539fe5ff", "textColor": "000716ff" }, "defaults": { "backgroundColor": "539fe5ff", "textColor": "000716ff" }, "disabled": { "backgroundColor": "ffffffff", "borderColor": "ffffffff" }, "hover": { "backgroundColor": "89bdeeff", "textColor": "000716ff" } }, "lightMode": { "active": { "backgroundColor": "033160ff", "textColor": "ffffffff" }, "defaults": { "backgroundColor": "0972d3ff", "textColor": "ffffffff" }, "disabled": { "backgroundColor": "ffffffff", "borderColor": "ffffffff" }, "hover": { "backgroundColor": "033160ff", "textColor": "ffffffff" } } }, "secondaryButton": { "darkMode": { "active": { "backgroundColor": "354150ff", "borderColor": "89bdeeff", "textColor": "89bdeeff" }, "defaults": { "backgroundColor": "0f1b2aff", "borderColor": "539fe5ff", "textColor": "539fe5ff" }, "hover": { "backgroundColor": "192534ff", "borderColor": "89bdeeff", "textColor": "89bdeeff" } }, "lightMode": { "active": { "backgroundColor": "d3e7f9ff", "borderColor": "033160ff", "textColor": "033160ff" }, "defaults": { "backgroundColor": "ffffffff", "borderColor": "0972d3ff", "textColor": "0972d3ff" }, "hover": { "backgroundColor": "f2f8fdff", "borderColor": "033160ff", "textColor": "033160ff" } } } } }, "UseCognitoProvidedValues": false, "UserPoolId": "ca-central-1_EXAMPLE" } ``` Ausgabe: ``` { "ManagedLoginBranding": { "Assets": [ { "Bytes": "PHN2ZyB3aWR0aD0iMjAwMDAiIGhlaWdodD0iNDAwIiB2aWV3Qm94PSIwIDAgMjAwMDAgNDAwIiBmaWxsPSJub25lIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8ZyBjbGlwLXBhdGg9InVybCgjY2xpcDBfMTcyNTlfMjM2Njc0KSI+CjxyZWN0IHdpZHRoPSIyMDAwMCIgaGVpZ2h0PSI0MDAiIGZpbGw9InVybCgjcGFpbnQwX2xpbmVhcl8xNzI1OV8yMzY2NzQpIi8+CjxwYXRoIGQ9Ik0wIDBIMjAwMDBWNDAwSDBWMFoiIGZpbGw9IiMxMjIwMzciIGZpbGwtb3BhY2l0eT0iMC41Ii8+CjwvZz4KPGRlZnM+CjxsaW5lYXJHcmFkaWVudCBpZD0icGFpbnQwX2xpbmVhcl8xNzI1OV8yMzY2NzQiIHgxPSItODk0LjI0OSIgeTE9IjE5OS45MzEiIHgyPSIxODAzNC41IiB5Mj0iLTU4OTkuNTciIGdyYWRpZW50VW5pdHM9InVzZXJTcGFjZU9uVXNlIj4KPHN0b3Agc3RvcC1jb2xvcj0iI0JGODBGRiIvPgo8c3RvcCBvZmZzZXQ9IjEiIHN0b3AtY29sb3I9IiNGRjhGQUIiLz4KPC9saW5lYXJHcmFkaWVudD4KPGNsaXBQYXRoIGlkPSJjbGlwMF8xNzI1OV8yMzY2NzQiPgo8cmVjdCB3aWR0aD0iMjAwMDAiIGhlaWdodD0iNDAwIiBmaWxsPSJ3aGl0ZSIvPgo8L2NsaXBQYXRoPgo8L2RlZnM+Cjwvc3ZnPgo=", "Category": "PAGE_FOOTER_BACKGROUND", "ColorMode": "DARK", "Extension": "SVG" } ], "CreationDate": 1732138490.642, "LastModifiedDate": 1732140420.301, "ManagedLoginBrandingId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Settings": { "categories": { "auth": { "authMethodOrder": [ [ { "display": "BUTTON", "type": "FEDERATED" }, { "display": "INPUT", "type": "USERNAME_PASSWORD" } ] ], "federation": { "interfaceStyle": "BUTTON_LIST", "order": [ ] } }, "form": { "displayGraphics": true, "instructions": { "enabled": false }, "languageSelector": { "enabled": false }, "location": { "horizontal": "CENTER", "vertical": "CENTER" }, "sessionTimerDisplay": "NONE" }, "global": { "colorSchemeMode": "LIGHT", "pageFooter": { "enabled": false }, "pageHeader": { "enabled": false }, "spacingDensity": "REGULAR" }, "signUp": { "acceptanceElements": [ { "enforcement": "NONE", "textKey": "en" } ] } }, "componentClasses": { "buttons": { "borderRadius": 8.0 }, "divider": { "darkMode": { "borderColor": "232b37ff" }, "lightMode": { "borderColor": "ebebf0ff" } }, "dropDown": { "borderRadius": 8.0, "darkMode": { "defaults": { "itemBackgroundColor": "192534ff" }, "hover": { "itemBackgroundColor": "081120ff", "itemBorderColor": "5f6b7aff", "itemTextColor": "e9ebedff" }, "match": { "itemBackgroundColor": "d1d5dbff", "itemTextColor": "89bdeeff" } }, "lightMode": { "defaults": { "itemBackgroundColor": "ffffffff" }, "hover": { "itemBackgroundColor": "f4f4f4ff", "itemBorderColor": "7d8998ff", "itemTextColor": "000716ff" }, "match": { "itemBackgroundColor": "414d5cff", "itemTextColor": "0972d3ff" } } }, "focusState": { "darkMode": { "borderColor": "539fe5ff" }, "lightMode": { "borderColor": "0972d3ff" } }, "idpButtons": { "icons": { "enabled": true } }, "input": { "borderRadius": 8.0, "darkMode": { "defaults": { "backgroundColor": "0f1b2aff", "borderColor": "5f6b7aff" }, "placeholderColor": "8d99a8ff" }, "lightMode": { "defaults": { "backgroundColor": "ffffffff", "borderColor": "7d8998ff" }, "placeholderColor": "5f6b7aff" } }, "inputDescription": { "darkMode": { "textColor": "8d99a8ff" }, "lightMode": { "textColor": "5f6b7aff" } }, "inputLabel": { "darkMode": { "textColor": "d1d5dbff" }, "lightMode": { "textColor": "000716ff" } }, "link": { "darkMode": { "defaults": { "textColor": "539fe5ff" }, "hover": { "textColor": "89bdeeff" } }, "lightMode": { "defaults": { "textColor": "0972d3ff" }, "hover": { "textColor": "033160ff" } } }, "optionControls": { "darkMode": { "defaults": { "backgroundColor": "0f1b2aff", "borderColor": "7d8998ff" }, "selected": { "backgroundColor": "539fe5ff", "foregroundColor": "000716ff" } }, "lightMode": { "defaults": { "backgroundColor": "ffffffff", "borderColor": "7d8998ff" }, "selected": { "backgroundColor": "0972d3ff", "foregroundColor": "ffffffff" } } }, "statusIndicator": { "darkMode": { "error": { "backgroundColor": "1a0000ff", "borderColor": "eb6f6fff", "indicatorColor": "eb6f6fff" }, "pending": { "indicatorColor": "AAAAAAAA" }, "success": { "backgroundColor": "001a02ff", "borderColor": "29ad32ff", "indicatorColor": "29ad32ff" }, "warning": { "backgroundColor": "1d1906ff", "borderColor": "e0ca57ff", "indicatorColor": "e0ca57ff" } }, "lightMode": { "error": { "backgroundColor": "fff7f7ff", "borderColor": "d91515ff", "indicatorColor": "d91515ff" }, "pending": { "indicatorColor": "AAAAAAAA" }, "success": { "backgroundColor": "f2fcf3ff", "borderColor": "037f0cff", "indicatorColor": "037f0cff" }, "warning": { "backgroundColor": "fffce9ff", "borderColor": "8d6605ff", "indicatorColor": "8d6605ff" } } } }, "components": { "alert": { "borderRadius": 12.0, "darkMode": { "error": { "backgroundColor": "1a0000ff", "borderColor": "eb6f6fff" } }, "lightMode": { "error": { "backgroundColor": "fff7f7ff", "borderColor": "d91515ff" } } }, "favicon": { "enabledTypes": [ "ICO", "SVG" ] }, "form": { "backgroundImage": { "enabled": false }, "borderRadius": 8.0, "darkMode": { "backgroundColor": "0f1b2aff", "borderColor": "424650ff" }, "lightMode": { "backgroundColor": "ffffffff", "borderColor": "c6c6cdff" }, "logo": { "enabled": false, "formInclusion": "IN", "location": "CENTER", "position": "TOP" } }, "idpButton": { "custom": { }, "standard": { "darkMode": { "active": { "backgroundColor": "354150ff", "borderColor": "89bdeeff", "textColor": "89bdeeff" }, "defaults": { "backgroundColor": "0f1b2aff", "borderColor": "c6c6cdff", "textColor": "c6c6cdff" }, "hover": { "backgroundColor": "192534ff", "borderColor": "89bdeeff", "textColor": "89bdeeff" } }, "lightMode": { "active": { "backgroundColor": "d3e7f9ff", "borderColor": "033160ff", "textColor": "033160ff" }, "defaults": { "backgroundColor": "ffffffff", "borderColor": "424650ff", "textColor": "424650ff" }, "hover": { "backgroundColor": "f2f8fdff", "borderColor": "033160ff", "textColor": "033160ff" } } } }, "pageBackground": { "darkMode": { "color": "0f1b2aff" }, "image": { "enabled": true }, "lightMode": { "color": "ffffffff" } }, "pageFooter": { "backgroundImage": { "enabled": false }, "darkMode": { "background": { "color": "0f141aff" }, "borderColor": "424650ff" }, "lightMode": { "background": { "color": "fafafaff" }, "borderColor": "d5dbdbff" }, "logo": { "enabled": false, "location": "START" } }, "pageHeader": { "backgroundImage": { "enabled": false }, "darkMode": { "background": { "color": "0f141aff" }, "borderColor": "424650ff" }, "lightMode": { "background": { "color": "fafafaff" }, "borderColor": "d5dbdbff" }, "logo": { "enabled": false, "location": "START" } }, "pageText": { "darkMode": { "bodyColor": "b6bec9ff", "descriptionColor": "b6bec9ff", "headingColor": "d1d5dbff" }, "lightMode": { "bodyColor": "414d5cff", "descriptionColor": "414d5cff", "headingColor": "000716ff" } }, "phoneNumberSelector": { "displayType": "TEXT" }, "primaryButton": { "darkMode": { "active": { "backgroundColor": "539fe5ff", "textColor": "000716ff" }, "defaults": { "backgroundColor": "539fe5ff", "textColor": "000716ff" }, "disabled": { "backgroundColor": "ffffffff", "borderColor": "ffffffff" }, "hover": { "backgroundColor": "89bdeeff", "textColor": "000716ff" } }, "lightMode": { "active": { "backgroundColor": "033160ff", "textColor": "ffffffff" }, "defaults": { "backgroundColor": "0972d3ff", "textColor": "ffffffff" }, "disabled": { "backgroundColor": "ffffffff", "borderColor": "ffffffff" }, "hover": { "backgroundColor": "033160ff", "textColor": "ffffffff" } } }, "secondaryButton": { "darkMode": { "active": { "backgroundColor": "354150ff", "borderColor": "89bdeeff", "textColor": "89bdeeff" }, "defaults": { "backgroundColor": "0f1b2aff", "borderColor": "539fe5ff", "textColor": "539fe5ff" }, "hover": { "backgroundColor": "192534ff", "borderColor": "89bdeeff", "textColor": "89bdeeff" } }, "lightMode": { "active": { "backgroundColor": "d3e7f9ff", "borderColor": "033160ff", "textColor": "033160ff" }, "defaults": { "backgroundColor": "ffffffff", "borderColor": "0972d3ff", "textColor": "0972d3ff" }, "hover": { "backgroundColor": "f2f8fdff", "borderColor": "033160ff", "textColor": "033160ff" } } } } }, "UseCognitoProvidedValues": false, "UserPoolId": "ca-central-1_EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Anwenden des Brandings auf verwaltete Anmeldeseiten](https://docs.aws.amazon.com/cognito/latest/developerguide/managed-login-branding.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [UpdateManagedLoginBranding](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-managed-login-branding.html)in der *AWS CLI Befehlsreferenz*. ### `update-resource-server` Das folgende Codebeispiel zeigt die Verwendung`update-resource-server`. **AWS CLI** **So aktualisieren Sie einen Ressourcenserver** In diesem Beispiel wird der Ressourcenserver Weather aktualisiert. Es wird ein neuer Bereich hinzugefügt. Befehl: ``` aws cognito-idp update-resource-server --user-pool-id us-west-2_aaaaaaaaa --identifier weather.example.com --name Weather --scopes ScopeName=NewScope,ScopeDescription="New scope description" ``` Ausgabe: ``` { "ResourceServer": { "UserPoolId": "us-west-2_aaaaaaaaa", "Identifier": "weather.example.com", "Name": "Happy", "Scopes": [ { "ScopeName": "NewScope", "ScopeDescription": "New scope description" } ] } } ``` + Einzelheiten zur API finden Sie [UpdateResourceServer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-resource-server.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-attributes` Das folgende Codebeispiel zeigt die Verwendung`update-user-attributes`. **AWS CLI** **So aktualisieren Sie Benutzerattribute** In diesem Beispiel wird das Benutzerattribut „nickname“ aktualisiert. Befehl: ``` aws cognito-idp update-user-attributes --access-token ACCESS_TOKEN --user-attributes Name="nickname",Value="Dan" ``` + Einzelheiten zur API finden Sie [UpdateUserAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-user-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-pool-client` Das folgende Codebeispiel zeigt die Verwendung`update-user-pool-client`. **AWS CLI** **So aktualisieren Sie einen App-Client** Im folgenden Beispiel für `update-user-pool-client` wird die Konfiguration des angeforderten App-Clients aktualisiert. ``` aws cognito-idp update-user-pool-client \ --user-pool-id us-west-2_EXAMPLE \ --client-id 1example23456789 \ --client-name my-test-app \ --refresh-token-validity 30 \ --access-token-validity 60 \ --id-token-validity 60 \ --token-validity-units AccessToken=minutes,IdToken=minutes,RefreshToken=days \ --read-attributes "address" "birthdate" "email" "email_verified" "family_name" "gender" "locale" "middle_name" "name" "nickname" "phone_number" "phone_number_verified" "picture" "preferred_username" "profile" "updated_at" "website" "zoneinfo" \ --write-attributes "address" "birthdate" "email" "family_name" "gender" "locale" "middle_name" "name" "nickname" "phone_number" "picture" "preferred_username" "profile" "updated_at" "website" "zoneinfo" \ --explicit-auth-flows "ALLOW_ADMIN_USER_PASSWORD_AUTH" "ALLOW_CUSTOM_AUTH" "ALLOW_REFRESH_TOKEN_AUTH" "ALLOW_USER_PASSWORD_AUTH" "ALLOW_USER_SRP_AUTH" \ --supported-identity-providers "MySAML" "COGNITO" "Google" \ --callback-urls "https://www.example.com" "https://app2.example.com" \ --logout-urls "https://auth.example.com/login?client_id=1example23456789&response_type=code&redirect_uri=https%3A%2F%2Fwww.example.com" "https://example.com/logout" \ --default-redirect-uri "https://www.example.com" \ --allowed-o-auth-flows "code" "implicit" \ --allowed-o-auth-scopes "openid" "profile" "aws.cognito.signin.user.admin" \ --allowed-o-auth-flows-user-pool-client \ --prevent-user-existence-errors ENABLED \ --enable-token-revocation \ --no-enable-propagate-additional-user-context-data \ --auth-session-validity 3 ``` Ausgabe: ``` { "UserPoolClient": { "UserPoolId": "us-west-2_EXAMPLE", "ClientName": "my-test-app", "ClientId": "1example23456789", "LastModifiedDate": "2025-01-31T14:40:12.498000-08:00", "CreationDate": "2023-09-13T16:26:34.408000-07:00", "RefreshTokenValidity": 30, "AccessTokenValidity": 60, "IdTokenValidity": 60, "TokenValidityUnits": { "AccessToken": "minutes", "IdToken": "minutes", "RefreshToken": "days" }, "ReadAttributes": [ "website", "zoneinfo", "address", "birthdate", "email_verified", "gender", "profile", "phone_number_verified", "preferred_username", "locale", "middle_name", "picture", "updated_at", "name", "nickname", "phone_number", "family_name", "email" ], "WriteAttributes": [ "website", "zoneinfo", "address", "birthdate", "gender", "profile", "preferred_username", "locale", "middle_name", "picture", "updated_at", "name", "nickname", "phone_number", "family_name", "email" ], "ExplicitAuthFlows": [ "ALLOW_CUSTOM_AUTH", "ALLOW_USER_PASSWORD_AUTH", "ALLOW_ADMIN_USER_PASSWORD_AUTH", "ALLOW_USER_SRP_AUTH", "ALLOW_REFRESH_TOKEN_AUTH" ], "SupportedIdentityProviders": [ "Google", "COGNITO", "MySAML" ], "CallbackURLs": [ "https://www.example.com", "https://app2.example.com" ], "LogoutURLs": [ "https://example.com/logout", "https://auth.example.com/login?client_id=1example23456789&response_type=code&redirect_uri=https%3A%2F%2Fwww.example.com" ], "DefaultRedirectURI": "https://www.example.com", "AllowedOAuthFlows": [ "implicit", "code" ], "AllowedOAuthScopes": [ "aws.cognito.signin.user.admin", "openid", "profile" ], "AllowedOAuthFlowsUserPoolClient": true, "PreventUserExistenceErrors": "ENABLED", "EnableTokenRevocation": true, "EnablePropagateAdditionalUserContextData": false, "AuthSessionValidity": 3 } } ``` Weitere Informationen finden Sie unter [Anwendungsspezifische Einstellungen mit App-Clients](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [UpdateUserPoolClient](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-user-pool-client.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-pool-domain` Das folgende Codebeispiel zeigt die Verwendung`update-user-pool-domain`. **AWS CLI** **So aktualisieren Sie eine benutzerdefinierte Domain** Im folgenden Beispiel für `update-user-pool-domain` werden die Branding-Version und das Zertifikat für die benutzerdefinierte Domain des angeforderten Benutzerpools konfiguriert. ``` aws cognito-idp update-user-pool-domain \ --user-pool-id ca-central-1_EXAMPLE \ --domain auth.example.com \ --managed-login-version 2 \ --custom-domain-config CertificateArn=arn:aws:acm:us-east-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "CloudFrontDomain": "example.cloudfront.net", "ManagedLoginVersion": 2 } ``` Weitere Informationen finden Sie unter [Verwaltete Anmeldung](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-managed-login.html) und [Konfigurieren einer Domain](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-assign-domain.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [UpdateUserPoolDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-user-pool-domain.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-pool` Das folgende Codebeispiel zeigt die Verwendung`update-user-pool`. **AWS CLI** **So aktualisieren Sie einen Benutzerpool** Im folgenden Beispiel für `update-user-pool` wird ein Benutzerpool mit einer Beispielsyntax für jede der verfügbaren Konfigurationsoptionen geändert. Wenn Sie einen Benutzerpool aktualisieren möchten, müssen Sie alle zuvor konfigurierten Optionen angeben. Andernfalls werden sie auf einen Standardwert zurückgesetzt. ``` aws cognito-idp update-user-pool --user-pool-id us-west-2_EXAMPLE \ --policies PasswordPolicy=\{MinimumLength=6,RequireUppercase=true,RequireLowercase=true,RequireNumbers=true,RequireSymbols=true,TemporaryPasswordValidityDays=7\} \ --deletion-protection ACTIVE \ --lambda-config PreSignUp="arn:aws:lambda:us-west-2:123456789012:function:cognito-test-presignup-function",PreTokenGeneration="arn:aws:lambda:us-west-2:123456789012:function:cognito-test-pretoken-function" \ --auto-verified-attributes "phone_number" "email" \ --verification-message-template \{\"SmsMessage\":\""Your code is {####}"\",\"EmailMessage\":\""Your code is {####}"\",\"EmailSubject\":\""Your verification code"\",\"EmailMessageByLink\":\""Click {##here##} to verify your email address."\",\"EmailSubjectByLink\":\""Your verification link"\",\"DefaultEmailOption\":\"CONFIRM_WITH_LINK\"\} \ --sms-authentication-message "Your code is {####}" \ --user-attribute-update-settings AttributesRequireVerificationBeforeUpdate="email","phone_number" \ --mfa-configuration "OPTIONAL" \ --device-configuration ChallengeRequiredOnNewDevice=true,DeviceOnlyRememberedOnUserPrompt=true \ --email-configuration SourceArn="arn:aws:ses:us-west-2:123456789012:identity/admin@example.com",ReplyToEmailAddress="amdin+noreply@example.com",EmailSendingAccount=DEVELOPER,From="admin@amazon.com",ConfigurationSet="test-configuration-set" \ --sms-configuration SnsCallerArn="arn:aws:iam::123456789012:role/service-role/SNS-SMS-Role",ExternalId="12345",SnsRegion="us-west-2" \ --admin-create-user-config AllowAdminCreateUserOnly=false,InviteMessageTemplate=\{SMSMessage=\""Welcome {username}. Your confirmation code is {####}"\",EmailMessage=\""Welcome {username}. Your confirmation code is {####}"\",EmailSubject=\""Welcome to MyMobileGame"\"\} \ --user-pool-tags "Function"="MyMobileGame","Developers"="Berlin" \ --admin-create-user-config AllowAdminCreateUserOnly=false,InviteMessageTemplate=\{SMSMessage=\""Welcome {username}. Your confirmation code is {####}"\",EmailMessage=\""Welcome {username}. Your confirmation code is {####}"\",EmailSubject=\""Welcome to MyMobileGame"\"\} \ --user-pool-add-ons AdvancedSecurityMode="AUDIT" \ --account-recovery-setting RecoveryMechanisms=\[\{Priority=1,Name="verified_email"\},\{Priority=2,Name="verified_phone_number"\}\] ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktualisieren der Benutzerpoolkonfiguration](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pool-updating.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [UpdateUserPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/update-user-pool.html)in der *AWS CLI Befehlsreferenz*. ### `verify-software-token` Das folgende Codebeispiel zeigt die Verwendung`verify-software-token`. **AWS CLI** **So bestätigen Sie die Registrierung einer TOTP-Authentifizierung** Im folgenden Beispiel für `verify-software-token` wird die TOTP-Registrierung für den aktuellen Benutzer abgeschlossen. ``` aws cognito-idp verify-software-token \ --access-token eyJra456defEXAMPLE \ --user-code 123456 ``` Ausgabe: ``` { "Status": "SUCCESS" } ``` Weitere Informationen finden Sie unter [Hinzufügen der MFA zu einem Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-mfa.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [VerifySoftwareToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/verify-software-token.html)in der *AWS CLI Befehlsreferenz*. ### `verify-user-attribute` Das folgende Codebeispiel zeigt die Verwendung`verify-user-attribute`. **AWS CLI** **So überprüfen Sie eine Attributänderung** Im folgenden Beispiel für `verify-user-attribute` wird eine Änderung am E-Mail-Attribut des aktuellen Benutzers überprüft. ``` aws cognito-idp verify-user-attribute \ --access-token eyJra456defEXAMPLE \ --attribute-name email \ --code 123456 ``` Weitere Informationen finden Sie unter [Konfigurieren der Verifizierung per E-Mail und Telefon](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-email-phone-verification.html) im *Entwicklerhandbuch für Amazon Cognito*. + Einzelheiten zur API finden Sie [VerifyUserAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-idp/verify-user-attribute.html)in der *AWS CLI Befehlsreferenz*. # Amazon Comprehend Comprehend-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Comprehend Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-detect-dominant-language` Das folgende Codebeispiel zeigt die Verwendung von. `batch-detect-dominant-language` **AWS CLI** **So erkennen Sie die dominante Sprache mehrerer Eingabetexte** Im folgenden Beispiel für `batch-detect-dominant-language` werden mehrere Eingabetexte analysiert und jeweils die dominante Sprache wird zurückgegeben. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend batch-detect-dominant-language \ --text-list "Physics is the natural science that involves the study of matter and its motion and behavior through space and time, along with related concepts such as energy and force." ``` Ausgabe: ``` { "ResultList": [ { "Index": 0, "Languages": [ { "LanguageCode": "en", "Score": 0.9986501932144165 } ] } ], "ErrorList": [] } ``` Weitere Informationen finden Sie unter [Dominante Sprache](https://docs.aws.amazon.com/comprehend/latest/dg/how-languages.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [BatchDetectDominantLanguage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/batch-detect-dominant-language.html)in der *AWS CLI Befehlsreferenz*. ### `batch-detect-entities` Das folgende Codebeispiel zeigt die Verwendung`batch-detect-entities`. **AWS CLI** **So erkennen Sie Entitäten aus mehreren Eingabetexten** Im folgenden Beispiel für `batch-detect-entities` werden mehrere Eingabetexte analysiert und die benannten Entitäten zurückgegeben. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend batch-detect-entities \ --language-code en \ --text-list "Dear Jane, Your AnyCompany Financial Services LLC credit card account 1111-XXXX-1111-XXXX has a minimum payment of $24.53 that is due by July 31st." "Please send customer feedback to Sunshine Spa, 123 Main St, Anywhere or to Alice at AnySpa@example.com." ``` Ausgabe: ``` { "ResultList": [ { "Index": 0, "Entities": [ { "Score": 0.9985517859458923, "Type": "PERSON", "Text": "Jane", "BeginOffset": 5, "EndOffset": 9 }, { "Score": 0.9767839312553406, "Type": "ORGANIZATION", "Text": "AnyCompany Financial Services, LLC", "BeginOffset": 16, "EndOffset": 50 }, { "Score": 0.9856694936752319, "Type": "OTHER", "Text": "1111-XXXX-1111-XXXX", "BeginOffset": 71, "EndOffset": 90 }, { "Score": 0.9652159810066223, "Type": "QUANTITY", "Text": ".53", "BeginOffset": 116, "EndOffset": 119 }, { "Score": 0.9986667037010193, "Type": "DATE", "Text": "July 31st", "BeginOffset": 135, "EndOffset": 144 } ] }, { "Index": 1, "Entities": [ { "Score": 0.720084547996521, "Type": "ORGANIZATION", "Text": "Sunshine Spa", "BeginOffset": 33, "EndOffset": 45 }, { "Score": 0.9865870475769043, "Type": "LOCATION", "Text": "123 Main St", "BeginOffset": 47, "EndOffset": 58 }, { "Score": 0.5895616412162781, "Type": "LOCATION", "Text": "Anywhere", "BeginOffset": 60, "EndOffset": 68 }, { "Score": 0.6809214353561401, "Type": "PERSON", "Text": "Alice", "BeginOffset": 75, "EndOffset": 80 }, { "Score": 0.9979087114334106, "Type": "OTHER", "Text": "AnySpa@example.com", "BeginOffset": 84, "EndOffset": 99 } ] } ], "ErrorList": [] } ``` Weitere Informationen finden Sie unter [Entitäten](https://docs.aws.amazon.com/comprehend/latest/dg/how-entities.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [BatchDetectEntities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/batch-detect-entities.html)in der *AWS CLI Befehlsreferenz*. ### `batch-detect-key-phrases` Das folgende Codebeispiel zeigt die Verwendung`batch-detect-key-phrases`. **AWS CLI** **So erkennen Sie Schlüsselphrasen mehrerer Texteingaben** Im folgenden Beispiel für `batch-detect-key-phrases` werden mehrere Eingabetexte analysiert und die nominale Schlüsselphrase wird zurückgegeben. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend batch-detect-key-phrases \ --language-code en \ --text-list "Hello Zhang Wei, I am John, writing to you about the trip for next Saturday." "Dear Jane, Your AnyCompany Financial Services LLC credit card account 1111-XXXX-1111-XXXX has a minimum payment of $24.53 that is due by July 31st." "Please send customer feedback to Sunshine Spa, 123 Main St, Anywhere or to Alice at AnySpa@example.com." ``` Ausgabe: ``` { "ResultList": [ { "Index": 0, "KeyPhrases": [ { "Score": 0.99700927734375, "Text": "Zhang Wei", "BeginOffset": 6, "EndOffset": 15 }, { "Score": 0.9929308891296387, "Text": "John", "BeginOffset": 22, "EndOffset": 26 }, { "Score": 0.9997230172157288, "Text": "the trip", "BeginOffset": 49, "EndOffset": 57 }, { "Score": 0.9999470114707947, "Text": "next Saturday", "BeginOffset": 62, "EndOffset": 75 } ] }, { "Index": 1, "KeyPhrases": [ { "Score": 0.8358274102210999, "Text": "Dear Jane", "BeginOffset": 0, "EndOffset": 9 }, { "Score": 0.989359974861145, "Text": "Your AnyCompany Financial Services", "BeginOffset": 11, "EndOffset": 45 }, { "Score": 0.8812323808670044, "Text": "LLC credit card account 1111-XXXX-1111-XXXX", "BeginOffset": 47, "EndOffset": 90 }, { "Score": 0.9999381899833679, "Text": "a minimum payment", "BeginOffset": 95, "EndOffset": 112 }, { "Score": 0.9997439980506897, "Text": ".53", "BeginOffset": 116, "EndOffset": 119 }, { "Score": 0.996875524520874, "Text": "July 31st", "BeginOffset": 135, "EndOffset": 144 } ] }, { "Index": 2, "KeyPhrases": [ { "Score": 0.9990295767784119, "Text": "customer feedback", "BeginOffset": 12, "EndOffset": 29 }, { "Score": 0.9994127750396729, "Text": "Sunshine Spa", "BeginOffset": 33, "EndOffset": 45 }, { "Score": 0.9892991185188293, "Text": "123 Main St", "BeginOffset": 47, "EndOffset": 58 }, { "Score": 0.9969810843467712, "Text": "Alice", "BeginOffset": 75, "EndOffset": 80 }, { "Score": 0.9703696370124817, "Text": "AnySpa@example.com", "BeginOffset": 84, "EndOffset": 99 } ] } ], "ErrorList": [] } ``` Weitere Informationen finden Sie unter [Schlüsselphrasen](https://docs.aws.amazon.com/comprehend/latest/dg/how-key-phrases.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [BatchDetectKeyPhrases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/batch-detect-key-phrases.html)in der *AWS CLI Befehlsreferenz*. ### `batch-detect-sentiment` Das folgende Codebeispiel zeigt die Verwendung`batch-detect-sentiment`. **AWS CLI** **So erkennen Sie die vorherrschende Stimmung in mehreren Eingabetexten** Im folgenden Beispiel für `batch-detect-sentiment` werden mehrere Eingabetexte analysiert und die jeweils vorherrschende Stimmung (`POSITIVE`, `NEUTRAL`, `MIXED` oder `NEGATIVE`) wird zurückgegeben. ``` aws comprehend batch-detect-sentiment \ --text-list "That movie was very boring, I can't believe it was over four hours long." "It is a beautiful day for hiking today." "My meal was okay, I'm excited to try other restaurants." \ --language-code en ``` Ausgabe: ``` { "ResultList": [ { "Index": 0, "Sentiment": "NEGATIVE", "SentimentScore": { "Positive": 0.00011316669406369328, "Negative": 0.9995445609092712, "Neutral": 0.00014722718333359808, "Mixed": 0.00019498742767609656 } }, { "Index": 1, "Sentiment": "POSITIVE", "SentimentScore": { "Positive": 0.9981263279914856, "Negative": 0.00015240783977787942, "Neutral": 0.0013876151060685515, "Mixed": 0.00033366199932061136 } }, { "Index": 2, "Sentiment": "MIXED", "SentimentScore": { "Positive": 0.15930435061454773, "Negative": 0.11471917480230331, "Neutral": 0.26897063851356506, "Mixed": 0.45700588822364807 } } ], "ErrorList": [] } ``` Weitere Informationen finden Sie unter [Stimmung](https://docs.aws.amazon.com/comprehend/latest/dg/how-sentiment.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [BatchDetectSentiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/batch-detect-sentiment.html)in der *AWS CLI Befehlsreferenz*. ### `batch-detect-syntax` Das folgende Codebeispiel zeigt die Verwendung`batch-detect-syntax`. **AWS CLI** **So untersuchen Sie die Syntax und Wortarten in mehreren Eingabetexten** Im folgenden Beispiel für `batch-detect-syntax` wird die Syntax mehrerer Eingabetexte analysiert und die verschiedenen Wortarten werden zurückgegeben. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend batch-detect-syntax \ --text-list "It is a beautiful day." "Can you please pass the salt?" "Please pay the bill before the 31st." \ --language-code en ``` Ausgabe: ``` { "ResultList": [ { "Index": 0, "SyntaxTokens": [ { "TokenId": 1, "Text": "It", "BeginOffset": 0, "EndOffset": 2, "PartOfSpeech": { "Tag": "PRON", "Score": 0.9999740719795227 } }, { "TokenId": 2, "Text": "is", "BeginOffset": 3, "EndOffset": 5, "PartOfSpeech": { "Tag": "VERB", "Score": 0.999937117099762 } }, { "TokenId": 3, "Text": "a", "BeginOffset": 6, "EndOffset": 7, "PartOfSpeech": { "Tag": "DET", "Score": 0.9999926686286926 } }, { "TokenId": 4, "Text": "beautiful", "BeginOffset": 8, "EndOffset": 17, "PartOfSpeech": { "Tag": "ADJ", "Score": 0.9987891912460327 } }, { "TokenId": 5, "Text": "day", "BeginOffset": 18, "EndOffset": 21, "PartOfSpeech": { "Tag": "NOUN", "Score": 0.9999778866767883 } }, { "TokenId": 6, "Text": ".", "BeginOffset": 21, "EndOffset": 22, "PartOfSpeech": { "Tag": "PUNCT", "Score": 0.9999974966049194 } } ] }, { "Index": 1, "SyntaxTokens": [ { "TokenId": 1, "Text": "Can", "BeginOffset": 0, "EndOffset": 3, "PartOfSpeech": { "Tag": "AUX", "Score": 0.9999770522117615 } }, { "TokenId": 2, "Text": "you", "BeginOffset": 4, "EndOffset": 7, "PartOfSpeech": { "Tag": "PRON", "Score": 0.9999986886978149 } }, { "TokenId": 3, "Text": "please", "BeginOffset": 8, "EndOffset": 14, "PartOfSpeech": { "Tag": "INTJ", "Score": 0.9681622385978699 } }, { "TokenId": 4, "Text": "pass", "BeginOffset": 15, "EndOffset": 19, "PartOfSpeech": { "Tag": "VERB", "Score": 0.9999874830245972 } }, { "TokenId": 5, "Text": "the", "BeginOffset": 20, "EndOffset": 23, "PartOfSpeech": { "Tag": "DET", "Score": 0.9999827146530151 } }, { "TokenId": 6, "Text": "salt", "BeginOffset": 24, "EndOffset": 28, "PartOfSpeech": { "Tag": "NOUN", "Score": 0.9995040893554688 } }, { "TokenId": 7, "Text": "?", "BeginOffset": 28, "EndOffset": 29, "PartOfSpeech": { "Tag": "PUNCT", "Score": 0.999998152256012 } } ] }, { "Index": 2, "SyntaxTokens": [ { "TokenId": 1, "Text": "Please", "BeginOffset": 0, "EndOffset": 6, "PartOfSpeech": { "Tag": "INTJ", "Score": 0.9997857809066772 } }, { "TokenId": 2, "Text": "pay", "BeginOffset": 7, "EndOffset": 10, "PartOfSpeech": { "Tag": "VERB", "Score": 0.9999252557754517 } }, { "TokenId": 3, "Text": "the", "BeginOffset": 11, "EndOffset": 14, "PartOfSpeech": { "Tag": "DET", "Score": 0.9999842643737793 } }, { "TokenId": 4, "Text": "bill", "BeginOffset": 15, "EndOffset": 19, "PartOfSpeech": { "Tag": "NOUN", "Score": 0.9999588131904602 } }, { "TokenId": 5, "Text": "before", "BeginOffset": 20, "EndOffset": 26, "PartOfSpeech": { "Tag": "ADP", "Score": 0.9958304762840271 } }, { "TokenId": 6, "Text": "the", "BeginOffset": 27, "EndOffset": 30, "PartOfSpeech": { "Tag": "DET", "Score": 0.9999947547912598 } }, { "TokenId": 7, "Text": "31st", "BeginOffset": 31, "EndOffset": 35, "PartOfSpeech": { "Tag": "NOUN", "Score": 0.9924124479293823 } }, { "TokenId": 8, "Text": ".", "BeginOffset": 35, "EndOffset": 36, "PartOfSpeech": { "Tag": "PUNCT", "Score": 0.9999955892562866 } } ] } ], "ErrorList": [] } ``` Weitere Informationen finden Sie unter [Syntaxanalyse](https://docs.aws.amazon.com/comprehend/latest/dg/how-syntax.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [BatchDetectSyntax](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/batch-detect-syntax.html)in der *AWS CLI Befehlsreferenz*. ### `batch-detect-targeted-sentiment` Das folgende Codebeispiel zeigt die Verwendung`batch-detect-targeted-sentiment`. **AWS CLI** **So erkennen Sie die Stimmung und jede benannte Entität für mehrere Eingabetexte** Im folgenden Beispiel für `batch-detect-targeted-sentiment` werden mehrere Eingabetexte analysiert und die benannten Entitäten zusammen mit der vorherrschenden Stimmung, die mit jeder einzelnen Entität verbunden ist, zurückgegeben. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend batch-detect-targeted-sentiment \ --language-code en \ --text-list "That movie was really boring, the original was way more entertaining" "The trail is extra beautiful today." "My meal was just okay." ``` Ausgabe: ``` { "ResultList": [ { "Index": 0, "Entities": [ { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "Score": 0.9999009966850281, "GroupScore": 1.0, "Text": "movie", "Type": "MOVIE", "MentionSentiment": { "Sentiment": "NEGATIVE", "SentimentScore": { "Positive": 0.13887299597263336, "Negative": 0.8057460188865662, "Neutral": 0.05525200068950653, "Mixed": 0.00012799999967683107 } }, "BeginOffset": 5, "EndOffset": 10 } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "Score": 0.9921110272407532, "GroupScore": 1.0, "Text": "original", "Type": "MOVIE", "MentionSentiment": { "Sentiment": "POSITIVE", "SentimentScore": { "Positive": 0.9999989867210388, "Negative": 9.999999974752427e-07, "Neutral": 0.0, "Mixed": 0.0 } }, "BeginOffset": 34, "EndOffset": 42 } ] } ] }, { "Index": 1, "Entities": [ { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "Score": 0.7545599937438965, "GroupScore": 1.0, "Text": "trail", "Type": "OTHER", "MentionSentiment": { "Sentiment": "POSITIVE", "SentimentScore": { "Positive": 1.0, "Negative": 0.0, "Neutral": 0.0, "Mixed": 0.0 } }, "BeginOffset": 4, "EndOffset": 9 } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "Score": 0.9999960064888, "GroupScore": 1.0, "Text": "today", "Type": "DATE", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Positive": 9.000000318337698e-06, "Negative": 1.9999999949504854e-06, "Neutral": 0.9999859929084778, "Mixed": 3.999999989900971e-06 } }, "BeginOffset": 29, "EndOffset": 34 } ] } ] }, { "Index": 2, "Entities": [ { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "Score": 0.9999880194664001, "GroupScore": 1.0, "Text": "My", "Type": "PERSON", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Positive": 0.0, "Negative": 0.0, "Neutral": 1.0, "Mixed": 0.0 } }, "BeginOffset": 0, "EndOffset": 2 } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "Score": 0.9995260238647461, "GroupScore": 1.0, "Text": "meal", "Type": "OTHER", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Positive": 0.04695599898695946, "Negative": 0.003226999891921878, "Neutral": 0.6091709733009338, "Mixed": 0.34064599871635437 } }, "BeginOffset": 3, "EndOffset": 7 } ] } ] } ], "ErrorList": [] } ``` Weitere Informationen finden Sie unter [Zielgerichtete Stimmung](https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [BatchDetectTargetedSentiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/batch-detect-targeted-sentiment.html)in der *AWS CLI Befehlsreferenz*. ### `classify-document` Das folgende Codebeispiel zeigt die Verwendung`classify-document`. **AWS CLI** **So klassifizieren Sie ein Dokument mit einem modellspezifischen Endpunkt** Im folgenden Beispiel für `classify-document` wird ein Dokument mit einem Endpunkt eines benutzerdefinierten Modells klassifiziert. Das Modell in diesem Beispiel wurde anhand eines Datensatzes trainiert, der SMS-Nachrichten enthält, die als Spam oder Nicht-Spam oder „betrügerisch“ gekennzeichnet sind. ``` aws comprehend classify-document \ --endpoint-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier-endpoint/example-classifier-endpoint \ --text "CONGRATULATIONS! TXT 1235550100 to win $5000" ``` Ausgabe: ``` { "Classes": [ { "Name": "spam", "Score": 0.9998599290847778 }, { "Name": "ham", "Score": 0.00014001205272506922 } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Klassifizierung](https://docs.aws.amazon.com/comprehend/latest/dg/how-document-classification.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ClassifyDocument](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/classify-document.html)in der *AWS CLI Befehlsreferenz*. ### `contains-pii-entities` Das folgende Codebeispiel zeigt die Verwendung`contains-pii-entities`. **AWS CLI** **So analysieren Sie den Eingabetext auf das Vorhandensein von PII-Informationen** Im folgenden Beispiel für `contains-pii-entities` wird der Eingabetext auf das Vorhandensein persönlich identifizierbarer Informationen (PII) analysiert und die Bezeichnungen identifizierter PII-Entitätstypen wie Name, Adresse, Bankkontonummer oder Telefonnummer werden zurückgegeben. ``` aws comprehend contains-pii-entities \ --language-code en \ --text "Hello Zhang Wei, I am John. Your AnyCompany Financial Services, LLC credit card account 1111-XXXX-1111-XXXX has a minimum payment of $24.53 that is due by July 31st. Based on your autopay settings, we will withdraw your payment on the due date from your bank account number XXXXXX1111 with the routing number XXXXX0000. Customer feedback for Sunshine Spa, 100 Main St, Anywhere. Send comments to Alice at AnySpa@example.com." ``` Ausgabe: ``` { "Labels": [ { "Name": "NAME", "Score": 1.0 }, { "Name": "EMAIL", "Score": 1.0 }, { "Name": "BANK_ACCOUNT_NUMBER", "Score": 0.9995794296264648 }, { "Name": "BANK_ROUTING", "Score": 0.9173126816749573 }, { "Name": "CREDIT_DEBIT_NUMBER", "Score": 1.0 } } ``` Weitere Informationen Sie unter [Persönlich identifizierbare Informationen (PII)](https://docs.aws.amazon.com/comprehend/latest/dg/pii.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ContainsPiiEntities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/contains-pii-entities.html)in der *AWS CLI Befehlsreferenz*. ### `create-dataset` Das folgende Codebeispiel zeigt die Verwendung`create-dataset`. **AWS CLI** **So erstellen Sie einen Schwungrad-Datensatz** Im folgenden Beispiel für `create-dataset` wird ein Datensatz für ein Schwungrad erstellt. Dieser Datensatz wird als zusätzliche Trainingsdaten verwendet, wie im Tag `--dataset-type` angegeben. ``` aws comprehend create-dataset \ --flywheel-arn arn:aws:comprehend:us-west-2:111122223333:flywheel/flywheel-entity \ --dataset-name example-dataset \ --dataset-type "TRAIN" \ --input-data-config file://inputConfig.json ``` Inhalt von `file://inputConfig.json`: ``` { "DataFormat": "COMPREHEND_CSV", "DocumentClassifierInputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/training-data.csv" } } ``` Ausgabe: ``` { "DatasetArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/flywheel-entity/dataset/example-dataset" } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [CreateDataset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/create-dataset.html)in der *AWS CLI Befehlsreferenz*. ### `create-document-classifier` Das folgende Codebeispiel zeigt die Verwendung`create-document-classifier`. **AWS CLI** **So erstellen Sie einen Dokumentenklassifikator zur Kategorisierung von Dokumenten** Im folgenden Beispiel für `create-document-classifier` wird der Trainingsprozess für ein Dokumentenklassifikatormodell gestartet. Die Trainingsdatendatei, `training.csv`, befindet sich im Tag `--input-data-config`. `training.csv` ist ein zweispaltiges Dokument, in dem die Bezeichnungen oder Klassifizierungen in der ersten Spalte und die Dokumente in der zweiten Spalte angegeben sind. ``` aws comprehend create-document-classifier \ --document-classifier-name example-classifier \ --data-access-arn arn:aws:comprehend:us-west-2:111122223333:pii-entities-detection-job/123456abcdeb0e11022f22a11EXAMPLE \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/" \ --language-code en ``` Ausgabe: ``` { "DocumentClassifierArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier" } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Klassifizierung](https://docs.aws.amazon.com/comprehend/latest/dg/how-document-classification.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [CreateDocumentClassifier](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/create-document-classifier.html)in der *AWS CLI Befehlsreferenz*. ### `create-endpoint` Das folgende Codebeispiel zeigt die Verwendung`create-endpoint`. **AWS CLI** **So erstellen Sie einen Endpunkt für ein benutzerdefiniertes Modell** Im folgenden Beispiel für `create-endpoint` wird ein Endpunkt zur synchronen Inferenz für ein zuvor trainiertes benutzerdefiniertes Modell erstellt. ``` aws comprehend create-endpoint \ --endpoint-name example-classifier-endpoint-1 \ --model-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier \ --desired-inference-units 1 ``` Ausgabe: ``` { "EndpointArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier-endpoint/example-classifier-endpoint-1" } ``` Weitere Informationen finden Sie unter [Verwalten von Amazon-Comprehend-Endpunkten](https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [CreateEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/create-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `create-entity-recognizer` Das folgende Codebeispiel zeigt die Verwendung`create-entity-recognizer`. **AWS CLI** **So erstellen Sie eine benutzerdefinierte Entitätserkennung** Im folgenden Beispiel für `create-entity-recognizer` wird der Trainingsprozess für ein benutzerdefiniertes Entitätserkennungsmodell gestartet. In diesem Beispiel werden eine CSV-Datei mit Trainingsdokumenten, `raw_text.csv`, und eine CSV-Entitätsliste, `entity_list.csv`, verwendet, um das Modell zu trainieren. `entity-list.csv` enthält die folgenden Spalten: Text und Typ. ``` aws comprehend create-entity-recognizer \ --recognizer-name example-entity-recognizer --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role \ --input-data-config "EntityTypes=[{Type=DEVICE}],Documents={S3Uri=s3://amzn-s3-demo-bucket/trainingdata/raw_text.csv},EntityList={S3Uri=s3://amzn-s3-demo-bucket/trainingdata/entity_list.csv}" --language-code en ``` Ausgabe: ``` { "EntityRecognizerArn": "arn:aws:comprehend:us-west-2:111122223333:example-entity-recognizer/entityrecognizer1" } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Entitätserkennung](https://docs.aws.amazon.com/comprehend/latest/dg/custom-entity-recognition.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [CreateEntityRecognizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/create-entity-recognizer.html)in der *AWS CLI Befehlsreferenz*. ### `create-flywheel` Das folgende Codebeispiel zeigt die Verwendung`create-flywheel`. **AWS CLI** **So erstellen Sie ein Schwungrad** Im folgenden Beispiel für `create-flywheel` wird ein Schwungrad erstellt, um das fortlaufende Training eines Modells zur Dokumentenklassifizierung oder zur Erkennung von Entitäten zu koordinieren. Das Schwungrad in diesem Beispiel wurde erstellt, um ein vorhandenes trainiertes Modell zu verwalten, das durch das Tag `--active-model-arn` spezifiziert ist. Wenn das Schwungrad erstellt wird, wird am Tag `--input-data-lake` ein Data Lake erstellt. ``` aws comprehend create-flywheel \ --flywheel-name example-flywheel \ --active-model-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-model/version/1 \ --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role \ --data-lake-s3-uri "s3://amzn-s3-demo-bucket" ``` Ausgabe: ``` { "FlywheelArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel" } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [CreateFlywheel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/create-flywheel.html)in der *AWS CLI Befehlsreferenz*. ### `delete-document-classifier` Das folgende Codebeispiel zeigt die Verwendung`delete-document-classifier`. **AWS CLI** **So löschen Sie einen benutzerdefinierten Dokumentenklassifikator** Im folgenden Beispiel für `delete-document-classifier` wird ein benutzerdefiniertes Dokumentenklassifikatormodell gelöscht. ``` aws comprehend delete-document-classifier \ --document-classifier-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier-1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Amazon-Comprehend-Endpunkten](https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DeleteDocumentClassifier](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/delete-document-classifier.html)in der *AWS CLI Befehlsreferenz*. ### `delete-endpoint` Das folgende Codebeispiel zeigt die Verwendung`delete-endpoint`. **AWS CLI** **So löschen Sie einen Endpunkt für ein benutzerdefiniertes Modell** Im folgenden Beispiel für `delete-endpoint` wird ein modellspezifischer Endpunkt gelöscht. Alle Endpunkte müssen gelöscht werden, damit das Modell gelöscht werden kann. ``` aws comprehend delete-endpoint \ --endpoint-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier-endpoint/example-classifier-endpoint-1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Amazon-Comprehend-Endpunkten](https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DeleteEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/delete-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `delete-entity-recognizer` Das folgende Codebeispiel zeigt die Verwendung`delete-entity-recognizer`. **AWS CLI** **So löschen Sie ein benutzerdefiniertes Entitätserkennungsmodell** Im folgenden Beispiel für `delete-entity-recognizer` wird ein benutzerdefiniertes Entitätserkennungsmodell gelöscht. ``` aws comprehend delete-entity-recognizer \ --entity-recognizer-arn arn:aws:comprehend:us-west-2:111122223333:entity-recognizer/example-entity-recognizer-1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Amazon-Comprehend-Endpunkten](https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DeleteEntityRecognizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/delete-entity-recognizer.html)in der *AWS CLI Befehlsreferenz*. ### `delete-flywheel` Das folgende Codebeispiel zeigt die Verwendung`delete-flywheel`. **AWS CLI** **So löschen Sie ein Schwungrad** Im folgenden Beispiel für `delete-flywheel` wird ein Schwungrad gelöscht. Der Data Lake oder das Modell, der bzw. das dem Schwungrad zugeordnet ist, wird nicht gelöscht. ``` aws comprehend delete-flywheel \ --flywheel-arn arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel-1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DeleteFlywheel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/delete-flywheel.html)in der *AWS CLI Befehlsreferenz*. ### `delete-resource-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-resource-policy`. **AWS CLI** **So löschen Sie eine ressourcenbasierte Richtlinie** Im folgenden Beispiel für `delete-resource-policy` wird eine ressourcenbasierte Richtlinie von einer Amazon-Comprehend-Ressource gelöscht. ``` aws comprehend delete-resource-policy \ --resource-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier-1/version/1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kopieren von benutzerdefinierten Modellen zwischen AWS Konten](https://docs.aws.amazon.com/comprehend/latest/dg/custom-copy.html) im *Amazon Comprehend Developer Guide*. + Einzelheiten zur API finden Sie unter [DeleteResourcePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/delete-resource-policy.html)*Befehlsreferenz*. ### `describe-dataset` Das folgende Codebeispiel zeigt die Verwendung`describe-dataset`. **AWS CLI** **So beschreiben Sie einen Schwungrad-Datensatz** Im folgenden Beispiel für `describe-dataset` werden die Eigenschaften eines Schwungrad-Datensatzes abgerufen. ``` aws comprehend describe-dataset \ --dataset-arn arn:aws:comprehend:us-west-2:111122223333:flywheel/flywheel-entity/dataset/example-dataset ``` Ausgabe: ``` { "DatasetProperties": { "DatasetArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/flywheel-entity/dataset/example-dataset", "DatasetName": "example-dataset", "DatasetType": "TRAIN", "DatasetS3Uri": "s3://amzn-s3-demo-bucket/flywheel-entity/schemaVersion=1/12345678A123456Z/datasets/example-dataset/20230616T203710Z/", "Status": "CREATING", "CreationTime": "2023-06-16T20:37:10.400000+00:00" } } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeDataset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-dataset.html)in der *AWS CLI Befehlsreferenz*. ### `describe-document-classification-job` Das folgende Codebeispiel zeigt die Verwendung`describe-document-classification-job`. **AWS CLI** **So beschreiben Sie einen Auftrag zur Dokumentenklassifizierung** Im folgenden Beispiel für `describe-document-classification-job` werden die Eigenschaften eines asynchronen Dokumentenklassifizierungsauftrags abgerufen. ``` aws comprehend describe-document-classification-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "DocumentClassificationJobProperties": { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:document-classification-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "exampleclassificationjob", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-14T17:09:51.788000+00:00", "EndTime": "2023-06-14T17:15:58.582000+00:00", "DocumentClassifierArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/mymodel/version/1", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/jobdata/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-CLN-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-servicerole" } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Klassifizierung](https://docs.aws.amazon.com/comprehend/latest/dg/how-document-classification.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeDocumentClassificationJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-document-classification-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-document-classifier` Das folgende Codebeispiel zeigt die Verwendung`describe-document-classifier`. **AWS CLI** **So beschreiben Sie einen Dokumentenklassifikator** Im folgenden Beispiel für `describe-document-classifier` werden die Eigenschaften eines benutzerdefinierten Dokumentenklassifikatormodells abgerufen. ``` aws comprehend describe-document-classifier \ --document-classifier-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier-1 ``` Ausgabe: ``` { "DocumentClassifierProperties": { "DocumentClassifierArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier-1", "LanguageCode": "en", "Status": "TRAINED", "SubmitTime": "2023-06-13T19:04:15.735000+00:00", "EndTime": "2023-06-13T19:42:31.752000+00:00", "TrainingStartTime": "2023-06-13T19:08:20.114000+00:00", "TrainingEndTime": "2023-06-13T19:41:35.080000+00:00", "InputDataConfig": { "DataFormat": "COMPREHEND_CSV", "S3Uri": "s3://amzn-s3-demo-bucket/trainingdata" }, "OutputDataConfig": {}, "ClassifierMetadata": { "NumberOfLabels": 3, "NumberOfTrainedDocuments": 5016, "NumberOfTestDocuments": 557, "EvaluationMetrics": { "Accuracy": 0.9856, "Precision": 0.9919, "Recall": 0.9459, "F1Score": 0.9673, "MicroPrecision": 0.9856, "MicroRecall": 0.9856, "MicroF1Score": 0.9856, "HammingLoss": 0.0144 } }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role", "Mode": "MULTI_CLASS" } } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von benutzerdefinierten Modellen](https://docs.aws.amazon.com/comprehend/latest/dg/manage-models.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeDocumentClassifier](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-document-classifier.html)in der *AWS CLI Befehlsreferenz*. ### `describe-dominant-language-detection-job` Das folgende Codebeispiel zeigt die Verwendung`describe-dominant-language-detection-job`. **AWS CLI** **So beschreiben Sie einen Auftrag zur Erkennung der dominanten Sprache.** Im folgenden Beispiel für `describe-dominant-language-detection-job` werden die Eigenschaften eines asynchronen Auftrags zur Erkennung der dominanten Sprache abgerufen. ``` aws comprehend describe-dominant-language-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "DominantLanguageDetectionJobProperties": { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:dominant-language-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "languageanalysis1", "JobStatus": "IN_PROGRESS", "SubmitTime": "2023-06-09T18:10:38.037000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-LANGUAGE-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" } } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeDominantLanguageDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-dominant-language-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-endpoint` Das folgende Codebeispiel zeigt die Verwendung`describe-endpoint`. **AWS CLI** **So beschreiben Sie einen bestimmten Endpunkt** Im folgenden Beispiel für `describe-endpoint` werden die Eigenschaften eines modellspezifischen Endpunkts abgerufen. ``` aws comprehend describe-endpoint \ --endpoint-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier-endpoint/example-classifier-endpoint ``` Ausgabe: ``` { "EndpointProperties": { "EndpointArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier-endpoint/example-classifier-endpoint, "Status": "IN_SERVICE", "ModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier1", "DesiredModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier1", "DesiredInferenceUnits": 1, "CurrentInferenceUnits": 1, "CreationTime": "2023-06-13T20:32:54.526000+00:00", "LastModifiedTime": "2023-06-13T20:32:54.526000+00:00" } } ``` Weitere Informationen finden Sie unter [Verwalten von Amazon-Comprehend-Endpunkten](https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `describe-entities-detection-job` Das folgende Codebeispiel zeigt die Verwendung`describe-entities-detection-job`. **AWS CLI** **So beschreiben Sie einen Auftrag zur Erkennung von Entitäten** Im folgenden Beispiel für `describe-entities-detection-job` werden die Eigenschaften eines asynchronen Auftrags zur Entitätenerkennung abgerufen. ``` aws comprehend describe-entities-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "EntitiesDetectionJobProperties": { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "example-entity-detector", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-08T21:30:15.323000+00:00", "EndTime": "2023-06-08T21:40:23.509000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/thefolder/111122223333-NER-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::12345678012:role/service-role/AmazonComprehendServiceRole-example-role" } } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeEntitiesDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-entities-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-entity-recognizer` Das folgende Codebeispiel zeigt die Verwendung`describe-entity-recognizer`. **AWS CLI** **So beschreiben Sie eine Entitätserkennung** Im folgenden Beispiel für `describe-entity-recognizer` werden die Eigenschaften eines benutzerdefinierten Entitätserkennungsmodells abgerufen. ``` aws comprehend describe-entity-recognizer \ entity-recognizer-arn arn:aws:comprehend:us-west-2:111122223333:entity-recognizer/business-recongizer-1/version/1 ``` Ausgabe: ``` { "EntityRecognizerProperties": { "EntityRecognizerArn": "arn:aws:comprehend:us-west-2:111122223333:entity-recognizer/business-recongizer-1/version/1", "LanguageCode": "en", "Status": "TRAINED", "SubmitTime": "2023-06-14T20:44:59.631000+00:00", "EndTime": "2023-06-14T20:59:19.532000+00:00", "TrainingStartTime": "2023-06-14T20:48:52.811000+00:00", "TrainingEndTime": "2023-06-14T20:58:11.473000+00:00", "InputDataConfig": { "DataFormat": "COMPREHEND_CSV", "EntityTypes": [ { "Type": "BUSINESS" } ], "Documents": { "S3Uri": "s3://amzn-s3-demo-bucket/trainingdata/dataset/", "InputFormat": "ONE_DOC_PER_LINE" }, "EntityList": { "S3Uri": "s3://amzn-s3-demo-bucket/trainingdata/entity.csv" } }, "RecognizerMetadata": { "NumberOfTrainedDocuments": 1814, "NumberOfTestDocuments": 486, "EvaluationMetrics": { "Precision": 100.0, "Recall": 100.0, "F1Score": 100.0 }, "EntityTypes": [ { "Type": "BUSINESS", "EvaluationMetrics": { "Precision": 100.0, "Recall": 100.0, "F1Score": 100.0 }, "NumberOfTrainMentions": 1520 } ] }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role", "VersionName": "1" } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Entitätserkennung](https://docs.aws.amazon.com/comprehend/latest/dg/custom-entity-recognition.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeEntityRecognizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-entity-recognizer.html)in der *AWS CLI Befehlsreferenz*. ### `describe-events-detection-job` Das folgende Codebeispiel zeigt die Verwendung`describe-events-detection-job`. **AWS CLI** **So beschreiben Sie einen Auftrag zur Erkennung von Ereignissen.** Im folgenden Beispiel für `describe-events-detection-job` werden die Eigenschaften eines asynchronen Auftrags zur Ereigniserkennung abgerufen. ``` aws comprehend describe-events-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "EventsDetectionJobProperties": { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:events-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "events_job_1", "JobStatus": "IN_PROGRESS", "SubmitTime": "2023-06-12T18:45:56.054000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/EventsData", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-EVENTS-123456abcdeb0e11022f22a11EXAMPLE/output/" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role", "TargetEventTypes": [ "BANKRUPTCY", "EMPLOYMENT", "CORPORATE_ACQUISITION", "CORPORATE_MERGER", "INVESTMENT_GENERAL" ] } } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeEventsDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-events-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-flywheel-iteration` Das folgende Codebeispiel zeigt die Verwendung`describe-flywheel-iteration`. **AWS CLI** **So beschreiben Sie eine Schwungrad-Iteration** Im folgenden Beispiel für `describe-flywheel-iteration` werden die Eigenschaften einer Schwungrad-Iteration abgerufen. ``` aws comprehend describe-flywheel-iteration \ --flywheel-arn arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel \ --flywheel-iteration-id 20232222AEXAMPLE ``` Ausgabe: ``` { "FlywheelIterationProperties": { "FlywheelArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/flywheel-entity", "FlywheelIterationId": "20232222AEXAMPLE", "CreationTime": "2023-06-16T21:10:26.385000+00:00", "EndTime": "2023-06-16T23:33:16.827000+00:00", "Status": "COMPLETED", "Message": "FULL_ITERATION: Flywheel iteration performed all functions successfully.", "EvaluatedModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1", "EvaluatedModelMetrics": { "AverageF1Score": 0.7742663922375772, "AveragePrecision": 0.8287636394041166, "AverageRecall": 0.7427084833645399, "AverageAccuracy": 0.8795394154118689 }, "TrainedModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/Comprehend-Generated-v1-bb52d585", "TrainedModelMetrics": { "AverageF1Score": 0.9767700253081214, "AveragePrecision": 0.9767700253081214, "AverageRecall": 0.9767700253081214, "AverageAccuracy": 0.9858281665190434 }, "EvaluationManifestS3Prefix": "s3://amzn-s3-demo-destination-bucket/flywheel-entity/schemaVersion=1/20230616T200543Z/evaluation/20230616T211026Z/" } } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeFlywheelIteration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-flywheel-iteration.html)in der *AWS CLI Befehlsreferenz*. ### `describe-flywheel` Das folgende Codebeispiel zeigt die Verwendung`describe-flywheel`. **AWS CLI** **So beschreiben Sie ein Schwungrad** Im folgenden Beispiel für `describe-flywheel` werden die Eigenschaften eines Schwungrads abgerufen. In diesem Beispiel ist das dem Schwungrad zugeordnete Modell ein benutzerdefiniertes Klassifizierungsmodell, das darauf trainiert ist, Dokumente entweder als Spam, Nicht-Spam oder „betrügerisch“ zu klassifizieren. ``` aws comprehend describe-flywheel \ --flywheel-arn arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel ``` Ausgabe: ``` { "FlywheelProperties": { "FlywheelArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel", "ActiveModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-model/version/1", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role", "TaskConfig": { "LanguageCode": "en", "DocumentClassificationConfig": { "Mode": "MULTI_CLASS", "Labels": [ "ham", "spam" ] } }, "DataLakeS3Uri": "s3://amzn-s3-demo-bucket/example-flywheel/schemaVersion=1/20230616T200543Z/", "DataSecurityConfig": {}, "Status": "ACTIVE", "ModelType": "DOCUMENT_CLASSIFIER", "CreationTime": "2023-06-16T20:05:43.242000+00:00", "LastModifiedTime": "2023-06-16T20:21:43.567000+00:00" } } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeFlywheel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-flywheel.html)in der *AWS CLI Befehlsreferenz*. ### `describe-key-phrases-detection-job` Das folgende Codebeispiel zeigt die Verwendung`describe-key-phrases-detection-job`. **AWS CLI** **So beschreiben Sie Auftrag zur Erkennung von Schlüsselphrasen** Im folgenden Beispiel für `describe-key-phrases-detection-job` werden die Eigenschaften eines asynchronen Auftrags zur Erkennung von Schlüsselphrasen abgerufen. ``` aws comprehend describe-key-phrases-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "KeyPhrasesDetectionJobProperties": { "JobId": "69aa080c00fc68934a6a98f10EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/69aa080c00fc68934a6a98f10EXAMPLE", "JobName": "example-key-phrases-detection-job", "JobStatus": "COMPLETED", "SubmitTime": 1686606439.177, "EndTime": 1686606806.157, "InputDataConfig": { "S3Uri": "s3://dereksbucket1001/EventsData/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://dereksbucket1002/testfolder/111122223333-KP-69aa080c00fc68934a6a98f10EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-testrole" } } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeKeyPhrasesDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-key-phrases-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-pii-entities-detection-job` Das folgende Codebeispiel zeigt die Verwendung`describe-pii-entities-detection-job`. **AWS CLI** **So beschreiben Sie einen Auftrag zur Erkennung von PII-Entitäten** Im folgenden Beispiel für `describe-pii-entities-detection-job` werden die Eigenschaften eines asynchronen Auftrags zur Erkennung von PII-Entitäten abgerufen. ``` aws comprehend describe-pii-entities-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "PiiEntitiesDetectionJobProperties": { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:pii-entities-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "example-pii-entities-job", "JobStatus": "IN_PROGRESS", "SubmitTime": "2023-06-08T21:30:15.323000+00:00", "EndTime": "2023-06-08T21:40:23.509000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/thefolder/111122223333-NER-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::12345678012:role/service-role/AmazonComprehendServiceRole-example-role" } } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribePiiEntitiesDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-pii-entities-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-resource-policy` Das folgende Codebeispiel zeigt die Verwendung`describe-resource-policy`. **AWS CLI** **So beschreiben Sie eine Ressourcenrichtlinie, die an ein Modell angehängt ist** Im folgenden Beispiel für `describe-resource-policy` werden die Eigenschaften einer ressourcenbasierten Richtlinie abgerufen, die an ein Modell angehängt ist. ``` aws comprehend describe-resource-policy \ --resource-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1 ``` Ausgabe: ``` { "ResourcePolicy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"comprehend:ImportModel\",\"Resource\":\"*\"}]}", "CreationTime": "2023-06-19T18:44:26.028000+00:00", "LastModifiedTime": "2023-06-19T18:53:02.002000+00:00", "PolicyRevisionId": "baa675d069d07afaa2aa3106ae280f61" } ``` Weitere Informationen finden Sie unter [Kopieren von benutzerdefinierten Modellen zwischen AWS Konten](https://docs.aws.amazon.com/comprehend/latest/dg/custom-copy.html) im *Amazon Comprehend Developer Guide*. + Einzelheiten zur API finden Sie unter [DescribeResourcePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-resource-policy.html)*Befehlsreferenz*. ### `describe-sentiment-detection-job` Das folgende Codebeispiel zeigt die Verwendung`describe-sentiment-detection-job`. **AWS CLI** **So beschreiben Sie einen Auftrag zur Erkennung von Stimmungen** Im folgenden Beispiel für `describe-sentiment-detection-job` werden die Eigenschaften eines asynchronen Auftrags zur Stimmungserkennung abgerufen. ``` aws comprehend describe-sentiment-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "SentimentDetectionJobProperties": { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:sentiment-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "movie_review_analysis", "JobStatus": "IN_PROGRESS", "SubmitTime": "2023-06-09T23:16:15.956000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/MovieData", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-TS-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-servicerole" } } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeSentimentDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-sentiment-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-targeted-sentiment-detection-job` Das folgende Codebeispiel zeigt die Verwendung`describe-targeted-sentiment-detection-job`. **AWS CLI** **So beschreiben Sie einen Auftrag zur Erkennung von zielgerichteten Stimmungen** Im folgenden Beispiel für `describe-targeted-sentiment-detection-job` werden die Eigenschaften eines asynchronen Auftrags zur Erkennung zielgerichteter Stimmungen abgerufen. ``` aws comprehend describe-targeted-sentiment-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "TargetedSentimentDetectionJobProperties": { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:targeted-sentiment-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "movie_review_analysis", "JobStatus": "IN_PROGRESS", "SubmitTime": "2023-06-09T23:16:15.956000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/MovieData", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-TS-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-servicerole" } } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeTargetedSentimentDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-targeted-sentiment-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-topics-detection-job` Das folgende Codebeispiel zeigt die Verwendung`describe-topics-detection-job`. **AWS CLI** **So beschreiben Sie einen Auftrag zur Themenerkennung** Im folgenden Beispiel für `describe-topics-detection-job` werden die Eigenschaften eines asynchronen Auftrags zur Themenerkennung abgerufen. ``` aws comprehend describe-topics-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "TopicsDetectionJobProperties": { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:topics-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "example_topics_detection", "JobStatus": "IN_PROGRESS", "SubmitTime": "2023-06-09T18:44:43.414000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-TOPICS-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "NumberOfTopics": 10, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-examplerole" } } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DescribeTopicsDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-topics-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `detect-dominant-language` Das folgende Codebeispiel zeigt die Verwendung`detect-dominant-language`. **AWS CLI** **So erkennen Sie die dominante Sprache eines Eingabetexts** Im folgenden Beispiel für `detect-dominant-language` wird der Eingabetext analysiert und die dominante Sprache identifiziert. Der Konfidenzwert des vortrainierten Modells wird ebenfalls ausgegeben. ``` aws comprehend detect-dominant-language \ --text "It is a beautiful day in Seattle." ``` Ausgabe: ``` { "Languages": [ { "LanguageCode": "en", "Score": 0.9877256155014038 } ] } ``` Weitere Informationen finden Sie unter [Dominante Sprache](https://docs.aws.amazon.com/comprehend/latest/dg/how-languages.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DetectDominantLanguage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/detect-dominant-language.html)in der *AWS CLI Befehlsreferenz*. ### `detect-entities` Das folgende Codebeispiel zeigt die Verwendung`detect-entities`. **AWS CLI** **So erkennen Sie benannte Entitäten im Eingabetext** Im folgenden Beispiel für `detect-entities` wird der Eingabetext analysiert und die benannten Entitäten werden zurückgegeben. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend detect-entities \ --language-code en \ --text "Hello Zhang Wei, I am John. Your AnyCompany Financial Services, LLC credit card \ account 1111-XXXX-1111-XXXX has a minimum payment of $24.53 that is due by July 31st. Based on your autopay settings, \ we will withdraw your payment on the due date from your bank account number XXXXXX1111 with the routing number XXXXX0000. \ Customer feedback for Sunshine Spa, 123 Main St, Anywhere. Send comments to Alice at AnySpa@example.com." ``` Ausgabe: ``` { "Entities": [ { "Score": 0.9994556307792664, "Type": "PERSON", "Text": "Zhang Wei", "BeginOffset": 6, "EndOffset": 15 }, { "Score": 0.9981022477149963, "Type": "PERSON", "Text": "John", "BeginOffset": 22, "EndOffset": 26 }, { "Score": 0.9986887574195862, "Type": "ORGANIZATION", "Text": "AnyCompany Financial Services, LLC", "BeginOffset": 33, "EndOffset": 67 }, { "Score": 0.9959119558334351, "Type": "OTHER", "Text": "1111-XXXX-1111-XXXX", "BeginOffset": 88, "EndOffset": 107 }, { "Score": 0.9708039164543152, "Type": "QUANTITY", "Text": ".53", "BeginOffset": 133, "EndOffset": 136 }, { "Score": 0.9987268447875977, "Type": "DATE", "Text": "July 31st", "BeginOffset": 152, "EndOffset": 161 }, { "Score": 0.9858865737915039, "Type": "OTHER", "Text": "XXXXXX1111", "BeginOffset": 271, "EndOffset": 281 }, { "Score": 0.9700471758842468, "Type": "OTHER", "Text": "XXXXX0000", "BeginOffset": 306, "EndOffset": 315 }, { "Score": 0.9591118693351746, "Type": "ORGANIZATION", "Text": "Sunshine Spa", "BeginOffset": 340, "EndOffset": 352 }, { "Score": 0.9797496795654297, "Type": "LOCATION", "Text": "123 Main St", "BeginOffset": 354, "EndOffset": 365 }, { "Score": 0.994929313659668, "Type": "PERSON", "Text": "Alice", "BeginOffset": 394, "EndOffset": 399 }, { "Score": 0.9949769377708435, "Type": "OTHER", "Text": "AnySpa@example.com", "BeginOffset": 403, "EndOffset": 418 } ] } ``` Weitere Informationen finden Sie unter [Entitäten](https://docs.aws.amazon.com/comprehend/latest/dg/how-entities.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DetectEntities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/detect-entities.html)in der *AWS CLI Befehlsreferenz*. ### `detect-key-phrases` Das folgende Codebeispiel zeigt die Verwendung`detect-key-phrases`. **AWS CLI** **So erkennen Sie Schlüsselphrasen im Eingabetext** Im folgenden Beispiel für `detect-key-phrases` wird der Eingabetext analysiert und die wichtigsten Nominalphrasen werden zurückgegeben. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend detect-key-phrases \ --language-code en \ --text "Hello Zhang Wei, I am John. Your AnyCompany Financial Services, LLC credit card \ account 1111-XXXX-1111-XXXX has a minimum payment of $24.53 that is due by July 31st. Based on your autopay settings, \ we will withdraw your payment on the due date from your bank account number XXXXXX1111 with the routing number XXXXX0000. \ Customer feedback for Sunshine Spa, 123 Main St, Anywhere. Send comments to Alice at AnySpa@example.com." ``` Ausgabe: ``` { "KeyPhrases": [ { "Score": 0.8996376395225525, "Text": "Zhang Wei", "BeginOffset": 6, "EndOffset": 15 }, { "Score": 0.9992469549179077, "Text": "John", "BeginOffset": 22, "EndOffset": 26 }, { "Score": 0.988385021686554, "Text": "Your AnyCompany Financial Services", "BeginOffset": 28, "EndOffset": 62 }, { "Score": 0.8740853071212769, "Text": "LLC credit card account 1111-XXXX-1111-XXXX", "BeginOffset": 64, "EndOffset": 107 }, { "Score": 0.9999437928199768, "Text": "a minimum payment", "BeginOffset": 112, "EndOffset": 129 }, { "Score": 0.9998900890350342, "Text": ".53", "BeginOffset": 133, "EndOffset": 136 }, { "Score": 0.9979453086853027, "Text": "July 31st", "BeginOffset": 152, "EndOffset": 161 }, { "Score": 0.9983011484146118, "Text": "your autopay settings", "BeginOffset": 172, "EndOffset": 193 }, { "Score": 0.9996572136878967, "Text": "your payment", "BeginOffset": 211, "EndOffset": 223 }, { "Score": 0.9995037317276001, "Text": "the due date", "BeginOffset": 227, "EndOffset": 239 }, { "Score": 0.9702621698379517, "Text": "your bank account number XXXXXX1111", "BeginOffset": 245, "EndOffset": 280 }, { "Score": 0.9179925918579102, "Text": "the routing number XXXXX0000.Customer feedback", "BeginOffset": 286, "EndOffset": 332 }, { "Score": 0.9978160858154297, "Text": "Sunshine Spa", "BeginOffset": 337, "EndOffset": 349 }, { "Score": 0.9706913232803345, "Text": "123 Main St", "BeginOffset": 351, "EndOffset": 362 }, { "Score": 0.9941995143890381, "Text": "comments", "BeginOffset": 379, "EndOffset": 387 }, { "Score": 0.9759287238121033, "Text": "Alice", "BeginOffset": 391, "EndOffset": 396 }, { "Score": 0.8376792669296265, "Text": "AnySpa@example.com", "BeginOffset": 400, "EndOffset": 415 } ] } ``` Weitere Informationen finden Sie unter [Schlüsselphrasen](https://docs.aws.amazon.com/comprehend/latest/dg/how-key-phrases.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DetectKeyPhrases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/detect-key-phrases.html)in der *AWS CLI Befehlsreferenz*. ### `detect-pii-entities` Das folgende Codebeispiel zeigt die Verwendung`detect-pii-entities`. **AWS CLI** **So erkennen Sie PII-Entitäten im Eingabetext** Im folgenden Beispiel für `detect-pii-entities` wird der Eingabetext analysiert und es werden Entitäten identifiziert, die persönlich identifizierbare Informationen (PII) enthalten. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend detect-pii-entities \ --language-code en \ --text "Hello Zhang Wei, I am John. Your AnyCompany Financial Services, LLC credit card \ account 1111-XXXX-1111-XXXX has a minimum payment of $24.53 that is due by July 31st. Based on your autopay settings, \ we will withdraw your payment on the due date from your bank account number XXXXXX1111 with the routing number XXXXX0000. \ Customer feedback for Sunshine Spa, 123 Main St, Anywhere. Send comments to Alice at AnySpa@example.com." ``` Ausgabe: ``` { "Entities": [ { "Score": 0.9998322129249573, "Type": "NAME", "BeginOffset": 6, "EndOffset": 15 }, { "Score": 0.9998878240585327, "Type": "NAME", "BeginOffset": 22, "EndOffset": 26 }, { "Score": 0.9994089603424072, "Type": "CREDIT_DEBIT_NUMBER", "BeginOffset": 88, "EndOffset": 107 }, { "Score": 0.9999760985374451, "Type": "DATE_TIME", "BeginOffset": 152, "EndOffset": 161 }, { "Score": 0.9999449253082275, "Type": "BANK_ACCOUNT_NUMBER", "BeginOffset": 271, "EndOffset": 281 }, { "Score": 0.9999847412109375, "Type": "BANK_ROUTING", "BeginOffset": 306, "EndOffset": 315 }, { "Score": 0.999925434589386, "Type": "ADDRESS", "BeginOffset": 354, "EndOffset": 365 }, { "Score": 0.9989161491394043, "Type": "NAME", "BeginOffset": 394, "EndOffset": 399 }, { "Score": 0.9994171857833862, "Type": "EMAIL", "BeginOffset": 403, "EndOffset": 418 } ] } ``` Weitere Informationen Sie unter [Persönlich identifizierbare Informationen (PII)](https://docs.aws.amazon.com/comprehend/latest/dg/pii.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DetectPiiEntities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/detect-pii-entities.html)in der *AWS CLI Befehlsreferenz*. ### `detect-sentiment` Das folgende Codebeispiel zeigt die Verwendung`detect-sentiment`. **AWS CLI** **So erkennen Sie die Stimmung eines Eingabetextes** Im folgenden Beispiel für `detect-sentiment` wird der Eingabetext analysiert und eine Inferenz der vorherrschenden Stimmung (`POSITIVE`, `NEUTRAL`, `MIXED` oder `NEGATIVE`) wird zurückgegeben. ``` aws comprehend detect-sentiment \ --language-code en \ --text "It is a beautiful day in Seattle" ``` Ausgabe: ``` { "Sentiment": "POSITIVE", "SentimentScore": { "Positive": 0.9976957440376282, "Negative": 9.653854067437351e-05, "Neutral": 0.002169104292988777, "Mixed": 3.857641786453314e-05 } } ``` Weitere Informationen finden Sie unter [Stimmung](https://docs.aws.amazon.com/comprehend/latest/dg/how-sentiment.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DetectSentiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/detect-sentiment.html)in der *AWS CLI Befehlsreferenz*. ### `detect-syntax` Das folgende Codebeispiel zeigt die Verwendung`detect-syntax`. **AWS CLI** **So erkennen Sie die Wortarten in einem Eingabetext** Im folgenden Beispiel für `detect-syntax` wird die Syntax des Eingabetextes analysiert und die verschiedenen Wortarten werden zurückgegeben. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend detect-syntax \ --language-code en \ --text "It is a beautiful day in Seattle." ``` Ausgabe: ``` { "SyntaxTokens": [ { "TokenId": 1, "Text": "It", "BeginOffset": 0, "EndOffset": 2, "PartOfSpeech": { "Tag": "PRON", "Score": 0.9999740719795227 } }, { "TokenId": 2, "Text": "is", "BeginOffset": 3, "EndOffset": 5, "PartOfSpeech": { "Tag": "VERB", "Score": 0.999901294708252 } }, { "TokenId": 3, "Text": "a", "BeginOffset": 6, "EndOffset": 7, "PartOfSpeech": { "Tag": "DET", "Score": 0.9999938607215881 } }, { "TokenId": 4, "Text": "beautiful", "BeginOffset": 8, "EndOffset": 17, "PartOfSpeech": { "Tag": "ADJ", "Score": 0.9987351894378662 } }, { "TokenId": 5, "Text": "day", "BeginOffset": 18, "EndOffset": 21, "PartOfSpeech": { "Tag": "NOUN", "Score": 0.9999796748161316 } }, { "TokenId": 6, "Text": "in", "BeginOffset": 22, "EndOffset": 24, "PartOfSpeech": { "Tag": "ADP", "Score": 0.9998047947883606 } }, { "TokenId": 7, "Text": "Seattle", "BeginOffset": 25, "EndOffset": 32, "PartOfSpeech": { "Tag": "PROPN", "Score": 0.9940530061721802 } } ] } ``` Weitere Informationen finden Sie unter [Syntaxanalyse](https://docs.aws.amazon.com/comprehend/latest/dg/how-syntax.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DetectSyntax](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/detect-syntax.html)in der *AWS CLI Befehlsreferenz*. ### `detect-targeted-sentiment` Das folgende Codebeispiel zeigt die Verwendung`detect-targeted-sentiment`. **AWS CLI** **So erkennen Sie die zielgerichtete Stimmung benannter Entitäten in einem Eingabetext** Im folgenden Beispiel für `detect-targeted-sentiment` wird der Eingabetext analysiert und die benannten Entitäten sowie die zielgerichtete Stimmung, die jeder Entität zugeordnet ist, werden zurückgegeben. Der Konfidenzwert des vortrainierten Modells wird ebenfalls für jede Prognose ausgegeben. ``` aws comprehend detect-targeted-sentiment \ --language-code en \ --text "I do not enjoy January because it is too cold but August is the perfect temperature" ``` Ausgabe: ``` { "Entities": [ { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "Score": 0.9999979734420776, "GroupScore": 1.0, "Text": "I", "Type": "PERSON", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Positive": 0.0, "Negative": 0.0, "Neutral": 1.0, "Mixed": 0.0 } }, "BeginOffset": 0, "EndOffset": 1 } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "Score": 0.9638869762420654, "GroupScore": 1.0, "Text": "January", "Type": "DATE", "MentionSentiment": { "Sentiment": "NEGATIVE", "SentimentScore": { "Positive": 0.0031610000878572464, "Negative": 0.9967250227928162, "Neutral": 0.00011100000119768083, "Mixed": 1.9999999949504854e-06 } }, "BeginOffset": 15, "EndOffset": 22 } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { { "Score": 0.9664419889450073, "GroupScore": 1.0, "Text": "August", "Type": "DATE", "MentionSentiment": { "Sentiment": "POSITIVE", "SentimentScore": { "Positive": 0.9999549984931946, "Negative": 3.999999989900971e-06, "Neutral": 4.099999932805076e-05, "Mixed": 0.0 } }, "BeginOffset": 50, "EndOffset": 56 } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "Score": 0.9803199768066406, "GroupScore": 1.0, "Text": "temperature", "Type": "ATTRIBUTE", "MentionSentiment": { "Sentiment": "POSITIVE", "SentimentScore": { "Positive": 1.0, "Negative": 0.0, "Neutral": 0.0, "Mixed": 0.0 } }, "BeginOffset": 77, "EndOffset": 88 } ] } ] } ``` Weitere Informationen finden Sie unter [Zielgerichtete Stimmung](https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [DetectTargetedSentiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/detect-targeted-sentiment.html)in der *AWS CLI Befehlsreferenz*. ### `import-model` Das folgende Codebeispiel zeigt die Verwendung`import-model`. **AWS CLI** **So importieren Sie ein Modell** Im folgenden `import-model` Beispiel wird ein Modell aus einem anderen AWS Konto importiert. Das Dokumentenklassifizierungsmodell im Konto `444455556666` verfügt über eine ressourcenbasierte Richtlinie, die es dem Konto `111122223333` ermöglicht, das Modell zu importieren. ``` aws comprehend import-model \ --source-model-arn arn:aws:comprehend:us-west-2:444455556666:document-classifier/example-classifier ``` Ausgabe: ``` { "ModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier" } ``` Weitere Informationen finden Sie unter [Kopieren von benutzerdefinierten Modellen zwischen AWS Konten](https://docs.aws.amazon.com/comprehend/latest/dg/custom-copy.html) im *Amazon Comprehend Developer Guide*. + Einzelheiten zur API finden Sie unter [ImportModel AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/import-model.html)*Befehlsreferenz*. ### `list-datasets` Das folgende Codebeispiel zeigt die Verwendung`list-datasets`. **AWS CLI** **So listen Sie alle Schwungrad-Datensätze auf** Im folgenden Beispiel für `list-datasets` werden alle Datensätze aufgelistet, die einem Schwungrad zugeordnet sind. ``` aws comprehend list-datasets \ --flywheel-arn arn:aws:comprehend:us-west-2:111122223333:flywheel/flywheel-entity ``` Ausgabe: ``` { "DatasetPropertiesList": [ { "DatasetArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/flywheel-entity/dataset/example-dataset-1", "DatasetName": "example-dataset-1", "DatasetType": "TRAIN", "DatasetS3Uri": "s3://amzn-s3-demo-bucket/flywheel-entity/schemaVersion=1/20230616T200543Z/datasets/example-dataset-1/20230616T203710Z/", "Status": "CREATING", "CreationTime": "2023-06-16T20:37:10.400000+00:00" }, { "DatasetArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/flywheel-entity/dataset/example-dataset-2", "DatasetName": "example-dataset-2", "DatasetType": "TRAIN", "DatasetS3Uri": "s3://amzn-s3-demo-bucket/flywheel-entity/schemaVersion=1/20230616T200543Z/datasets/example-dataset-2/20230616T200607Z/", "Description": "TRAIN Dataset created by Flywheel creation.", "Status": "COMPLETED", "NumberOfDocuments": 5572, "CreationTime": "2023-06-16T20:06:07.722000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListDatasets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-datasets.html)in der *AWS CLI Befehlsreferenz*. ### `list-document-classification-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-document-classification-jobs`. **AWS CLI** **So listen Sie alle Aufträge zur Dokumentenklassifizierung auf** Im folgenden Beispiel für `list-document-classification-jobs` werden alle Aufträge zur Dokumentenklassifizierung aufgelistet. ``` aws comprehend list-document-classification-jobs ``` Ausgabe: ``` { "DocumentClassificationJobPropertiesList": [ { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:1234567890101:document-classification-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "exampleclassificationjob", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-14T17:09:51.788000+00:00", "EndTime": "2023-06-14T17:15:58.582000+00:00", "DocumentClassifierArn": "arn:aws:comprehend:us-west-2:1234567890101:document-classifier/mymodel/version/12", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/jobdata/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/thefolder/1234567890101-CLN-e758dd56b824aa717ceab551f11749fb/output/output.tar.gz" }, "DataAccessRoleArn": "arn:aws:iam::1234567890101:role/service-role/AmazonComprehendServiceRole-example-role" }, { "JobId": "123456abcdeb0e11022f22a1EXAMPLE2", "JobArn": "arn:aws:comprehend:us-west-2:1234567890101:document-classification-job/123456abcdeb0e11022f22a1EXAMPLE2", "JobName": "exampleclassificationjob2", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-14T17:22:39.829000+00:00", "EndTime": "2023-06-14T17:28:46.107000+00:00", "DocumentClassifierArn": "arn:aws:comprehend:us-west-2:1234567890101:document-classifier/mymodel/version/12", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/jobdata/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/thefolder/1234567890101-CLN-123456abcdeb0e11022f22a1EXAMPLE2/output/output.tar.gz" }, "DataAccessRoleArn": "arn:aws:iam::1234567890101:role/service-role/AmazonComprehendServiceRole-example-role" } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Klassifizierung](https://docs.aws.amazon.com/comprehend/latest/dg/how-document-classification.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListDocumentClassificationJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-document-classification-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-document-classifier-summaries` Das folgende Codebeispiel zeigt die Verwendung`list-document-classifier-summaries`. **AWS CLI** **So listen Sie die Zusammenfassungen aller erstellten Dokumentenklassifizierungen auf** Im folgenden Beispiel für `list-document-classifier-summaries` werden alle Zusammenfassungen der erstellten Dokumentenklassifizierungen aufgelistet. ``` aws comprehend list-document-classifier-summaries ``` Ausgabe: ``` { "DocumentClassifierSummariesList": [ { "DocumentClassifierName": "example-classifier-1", "NumberOfVersions": 1, "LatestVersionCreatedAt": "2023-06-13T22:07:59.825000+00:00", "LatestVersionName": "1", "LatestVersionStatus": "TRAINED" }, { "DocumentClassifierName": "example-classifier-2", "NumberOfVersions": 2, "LatestVersionCreatedAt": "2023-06-13T21:54:59.589000+00:00", "LatestVersionName": "2", "LatestVersionStatus": "TRAINED" } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von benutzerdefinierten Modellen](https://docs.aws.amazon.com/comprehend/latest/dg/manage-models.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListDocumentClassifierSummaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-document-classifier-summaries.html)in der *AWS CLI Befehlsreferenz*. ### `list-document-classifiers` Das folgende Codebeispiel zeigt die Verwendung`list-document-classifiers`. **AWS CLI** **So listen Sie alle Dokumentenklassifikatoren auf** Im folgenden Beispiel für `list-document-classifiers` werden alle trainierten und im Training befindlichen Dokumentenklassifikatorenmodelle aufgelistet. ``` aws comprehend list-document-classifiers ``` Ausgabe: ``` { "DocumentClassifierPropertiesList": [ { "DocumentClassifierArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier1", "LanguageCode": "en", "Status": "TRAINED", "SubmitTime": "2023-06-13T19:04:15.735000+00:00", "EndTime": "2023-06-13T19:42:31.752000+00:00", "TrainingStartTime": "2023-06-13T19:08:20.114000+00:00", "TrainingEndTime": "2023-06-13T19:41:35.080000+00:00", "InputDataConfig": { "DataFormat": "COMPREHEND_CSV", "S3Uri": "s3://amzn-s3-demo-bucket/trainingdata" }, "OutputDataConfig": {}, "ClassifierMetadata": { "NumberOfLabels": 3, "NumberOfTrainedDocuments": 5016, "NumberOfTestDocuments": 557, "EvaluationMetrics": { "Accuracy": 0.9856, "Precision": 0.9919, "Recall": 0.9459, "F1Score": 0.9673, "MicroPrecision": 0.9856, "MicroRecall": 0.9856, "MicroF1Score": 0.9856, "HammingLoss": 0.0144 } }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-testorle", "Mode": "MULTI_CLASS" }, { "DocumentClassifierArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier2", "LanguageCode": "en", "Status": "TRAINING", "SubmitTime": "2023-06-13T21:20:28.690000+00:00", "InputDataConfig": { "DataFormat": "COMPREHEND_CSV", "S3Uri": "s3://amzn-s3-demo-bucket/trainingdata" }, "OutputDataConfig": {}, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-testorle", "Mode": "MULTI_CLASS" } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von benutzerdefinierten Modellen](https://docs.aws.amazon.com/comprehend/latest/dg/manage-models.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListDocumentClassifiers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-document-classifiers.html)in der *AWS CLI Befehlsreferenz*. ### `list-dominant-language-detection-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-dominant-language-detection-jobs`. **AWS CLI** **So listen Sie alle Aufträge zur Erkennung der dominanten Sprache auf** Im folgenden Beispiel für `list-dominant-language-detection-jobs` werden alle laufenden und abgeschlossenen asynchronen Aufträge zur Erkennung der dominanten Sprache aufgelistet. ``` aws comprehend list-dominant-language-detection-jobs ``` Ausgabe: ``` { "DominantLanguageDetectionJobPropertiesList": [ { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:dominant-language-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "languageanalysis1", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-09T18:10:38.037000+00:00", "EndTime": "2023-06-09T18:18:45.498000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-LANGUAGE-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" }, { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:dominant-language-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "languageanalysis2", "JobStatus": "STOPPED", "SubmitTime": "2023-06-09T18:16:33.690000+00:00", "EndTime": "2023-06-09T18:24:40.608000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-LANGUAGE-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" } ] } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListDominantLanguageDetectionJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-dominant-language-detection-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-endpoints` Das folgende Codebeispiel zeigt die Verwendung`list-endpoints`. **AWS CLI** **So listen Sie alle Endpunkte auf** Im folgenden Beispiel für `list-endpoints` werden alle aktiven modellspezifischen Endpunkte aufgelistet. ``` aws comprehend list-endpoints ``` Ausgabe: ``` { "EndpointPropertiesList": [ { "EndpointArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier-endpoint/ExampleClassifierEndpoint", "Status": "IN_SERVICE", "ModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier1", "DesiredModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier1", "DesiredInferenceUnits": 1, "CurrentInferenceUnits": 1, "CreationTime": "2023-06-13T20:32:54.526000+00:00", "LastModifiedTime": "2023-06-13T20:32:54.526000+00:00" }, { "EndpointArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier-endpoint/ExampleClassifierEndpoint2", "Status": "IN_SERVICE", "ModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier2", "DesiredModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier2", "DesiredInferenceUnits": 1, "CurrentInferenceUnits": 1, "CreationTime": "2023-06-13T20:32:54.526000+00:00", "LastModifiedTime": "2023-06-13T20:32:54.526000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Amazon-Comprehend-Endpunkten](https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-endpoints.html)in der *AWS CLI Befehlsreferenz*. ### `list-entities-detection-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-entities-detection-jobs`. **AWS CLI** **So listen Sie alle Aufträge zur Erkennung von Entitäten auf** Im folgenden Beispiel für `list-entities-detection-jobs` werden alle asynchronen Aufträge zur Entitätserkennung aufgelistet. ``` aws comprehend list-entities-detection-jobs ``` Ausgabe: ``` { "EntitiesDetectionJobPropertiesList": [ { "JobId": "468af39c28ab45b83eb0c4ab9EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/468af39c28ab45b83eb0c4ab9EXAMPLE", "JobName": "example-entities-detection", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-08T20:57:46.476000+00:00", "EndTime": "2023-06-08T21:05:53.718000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/thefolder/111122223333-NER-468af39c28ab45b83eb0c4ab9EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" }, { "JobId": "809691caeaab0e71406f80a28EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/809691caeaab0e71406f80a28EXAMPLE", "JobName": "example-entities-detection-2", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-08T21:30:15.323000+00:00", "EndTime": "2023-06-08T21:40:23.509000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/thefolder/111122223333-NER-809691caeaab0e71406f80a28EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" }, { "JobId": "e00597c36b448b91d70dea165EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/e00597c36b448b91d70dea165EXAMPLE", "JobName": "example-entities-detection-3", "JobStatus": "STOPPED", "SubmitTime": "2023-06-08T22:19:28.528000+00:00", "EndTime": "2023-06-08T22:27:33.991000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/thefolder/111122223333-NER-e00597c36b448b91d70dea165EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" } ] } ``` Weitere Informationen finden Sie unter [Entitäten](https://docs.aws.amazon.com/comprehend/latest/dg/how-entities.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListEntitiesDetectionJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-entities-detection-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-entity-recognizer-summaries` Das folgende Codebeispiel zeigt die Verwendung`list-entity-recognizer-summaries`. **AWS CLI** **So listen Sie die Zusammenfassungen für alle erstellten Entitätserkennungen auf** Im folgenden Beispiel für `list-entity-recognizer-summaries` werden alle Zusammenfassungen für Entitätserkennungen aufgelistet. ``` aws comprehend list-entity-recognizer-summaries ``` Ausgabe: ``` { "EntityRecognizerSummariesList": [ { "RecognizerName": "entity-recognizer-3", "NumberOfVersions": 2, "LatestVersionCreatedAt": "2023-06-15T23:15:07.621000+00:00", "LatestVersionName": "2", "LatestVersionStatus": "STOP_REQUESTED" }, { "RecognizerName": "entity-recognizer-2", "NumberOfVersions": 1, "LatestVersionCreatedAt": "2023-06-14T22:55:27.805000+00:00", "LatestVersionName": "2" "LatestVersionStatus": "TRAINED" }, { "RecognizerName": "entity-recognizer-1", "NumberOfVersions": 1, "LatestVersionCreatedAt": "2023-06-14T20:44:59.631000+00:00", "LatestVersionName": "1", "LatestVersionStatus": "TRAINED" } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Entitätserkennung](https://docs.aws.amazon.com/comprehend/latest/dg/custom-entity-recognition.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListEntityRecognizerSummaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-entity-recognizer-summaries.html)in der *AWS CLI Befehlsreferenz*. ### `list-entity-recognizers` Das folgende Codebeispiel zeigt die Verwendung`list-entity-recognizers`. **AWS CLI** **So listen Sie alle benutzerdefinierten Entitätserkennungen auf** Im folgenden Beispiel für `list-entity-recognizers` werden alle erstellten benutzerdefinierten Entitätserkennungen aufgelistet. ``` aws comprehend list-entity-recognizers ``` Ausgabe: ``` { "EntityRecognizerPropertiesList": [ { "EntityRecognizerArn": "arn:aws:comprehend:us-west-2:111122223333:entity-recognizer/EntityRecognizer/version/1", "LanguageCode": "en", "Status": "TRAINED", "SubmitTime": "2023-06-14T20:44:59.631000+00:00", "EndTime": "2023-06-14T20:59:19.532000+00:00", "TrainingStartTime": "2023-06-14T20:48:52.811000+00:00", "TrainingEndTime": "2023-06-14T20:58:11.473000+00:00", "InputDataConfig": { "DataFormat": "COMPREHEND_CSV", "EntityTypes": [ { "Type": "BUSINESS" } ], "Documents": { "S3Uri": "s3://amzn-s3-demo-bucket/trainingdata/dataset/", "InputFormat": "ONE_DOC_PER_LINE" }, "EntityList": { "S3Uri": "s3://amzn-s3-demo-bucket/trainingdata/entity.csv" } }, "RecognizerMetadata": { "NumberOfTrainedDocuments": 1814, "NumberOfTestDocuments": 486, "EvaluationMetrics": { "Precision": 100.0, "Recall": 100.0, "F1Score": 100.0 }, "EntityTypes": [ { "Type": "BUSINESS", "EvaluationMetrics": { "Precision": 100.0, "Recall": 100.0, "F1Score": 100.0 }, "NumberOfTrainMentions": 1520 } ] }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-servicerole", "VersionName": "1" }, { "EntityRecognizerArn": "arn:aws:comprehend:us-west-2:111122223333:entity-recognizer/entityrecognizer3", "LanguageCode": "en", "Status": "TRAINED", "SubmitTime": "2023-06-14T22:57:51.056000+00:00", "EndTime": "2023-06-14T23:14:13.894000+00:00", "TrainingStartTime": "2023-06-14T23:01:33.984000+00:00", "TrainingEndTime": "2023-06-14T23:13:02.984000+00:00", "InputDataConfig": { "DataFormat": "COMPREHEND_CSV", "EntityTypes": [ { "Type": "DEVICE" } ], "Documents": { "S3Uri": "s3://amzn-s3-demo-bucket/trainingdata/raw_txt.csv", "InputFormat": "ONE_DOC_PER_LINE" }, "EntityList": { "S3Uri": "s3://amzn-s3-demo-bucket/trainingdata/entity_list.csv" } }, "RecognizerMetadata": { "NumberOfTrainedDocuments": 4616, "NumberOfTestDocuments": 3489, "EvaluationMetrics": { "Precision": 98.54227405247813, "Recall": 100.0, "F1Score": 99.26578560939794 }, "EntityTypes": [ { "Type": "DEVICE", "EvaluationMetrics": { "Precision": 98.54227405247813, "Recall": 100.0, "F1Score": 99.26578560939794 }, "NumberOfTrainMentions": 2764 } ] }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-servicerole" } ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Entitätserkennung](https://docs.aws.amazon.com/comprehend/latest/dg/custom-entity-recognition.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListEntityRecognizers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-entity-recognizers.html)in der *AWS CLI Befehlsreferenz*. ### `list-events-detection-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-events-detection-jobs`. **AWS CLI** **So listen Sie alle Aufträge zur Erkennung von Ereignissen auf** Im folgenden Beispiel für `list-events-detection-jobs` werden alle asynchronen Aufträge zur Ereigniserkennung aufgelistet. ``` aws comprehend list-events-detection-jobs ``` Ausgabe: ``` { "EventsDetectionJobPropertiesList": [ { "JobId": "aa9593f9203e84f3ef032ce18EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:1111222233333:events-detection-job/aa9593f9203e84f3ef032ce18EXAMPLE", "JobName": "events_job_1", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-12T19:14:57.751000+00:00", "EndTime": "2023-06-12T19:21:04.962000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-source-bucket/EventsData/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/1111222233333-EVENTS-aa9593f9203e84f3ef032ce18EXAMPLE/output/" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::1111222233333:role/service-role/AmazonComprehendServiceRole-example-role", "TargetEventTypes": [ "BANKRUPTCY", "EMPLOYMENT", "CORPORATE_ACQUISITION", "CORPORATE_MERGER", "INVESTMENT_GENERAL" ] }, { "JobId": "4a990a2f7e82adfca6e171135EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:1111222233333:events-detection-job/4a990a2f7e82adfca6e171135EXAMPLE", "JobName": "events_job_2", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-12T19:55:43.702000+00:00", "EndTime": "2023-06-12T20:03:49.893000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-source-bucket/EventsData/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/1111222233333-EVENTS-4a990a2f7e82adfca6e171135EXAMPLE/output/" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::1111222233333:role/service-role/AmazonComprehendServiceRole-example-role", "TargetEventTypes": [ "BANKRUPTCY", "EMPLOYMENT", "CORPORATE_ACQUISITION", "CORPORATE_MERGER", "INVESTMENT_GENERAL" ] } ] } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListEventsDetectionJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-events-detection-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-flywheel-iteration-history` Das folgende Codebeispiel zeigt die Verwendung`list-flywheel-iteration-history`. **AWS CLI** **So listen Sie den gesamten Verlauf der Schwungraditerationen auf** Im folgenden Beispiel für `list-flywheel-iteration-history` werden alle Iterationen eines Schwungrades aufgelistet. ``` aws comprehend list-flywheel-iteration-history --flywheel-arn arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel ``` Ausgabe: ``` { "FlywheelIterationPropertiesList": [ { "FlywheelArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel", "FlywheelIterationId": "20230619TEXAMPLE", "CreationTime": "2023-06-19T04:00:32.594000+00:00", "EndTime": "2023-06-19T04:00:49.248000+00:00", "Status": "COMPLETED", "Message": "FULL_ITERATION: Flywheel iteration performed all functions successfully.", "EvaluatedModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1", "EvaluatedModelMetrics": { "AverageF1Score": 0.7742663922375772, "AverageF1Score": 0.9876464664646313, "AveragePrecision": 0.9800000253081214, "AverageRecall": 0.9445600253081214, "AverageAccuracy": 0.9997281665190434 }, "EvaluationManifestS3Prefix": "s3://amzn-s3-demo-bucket/example-flywheel/schemaVersion=1/20230619TEXAMPLE/evaluation/20230619TEXAMPLE/" }, { "FlywheelArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel-2", "FlywheelIterationId": "20230616TEXAMPLE", "CreationTime": "2023-06-16T21:10:26.385000+00:00", "EndTime": "2023-06-16T23:33:16.827000+00:00", "Status": "COMPLETED", "Message": "FULL_ITERATION: Flywheel iteration performed all functions successfully.", "EvaluatedModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/spamvshamclassify/version/1", "EvaluatedModelMetrics": { "AverageF1Score": 0.7742663922375772, "AverageF1Score": 0.9767700253081214, "AveragePrecision": 0.9767700253081214, "AverageRecall": 0.9767700253081214, "AverageAccuracy": 0.9858281665190434 }, "EvaluationManifestS3Prefix": "s3://amzn-s3-demo-bucket/example-flywheel-2/schemaVersion=1/20230616TEXAMPLE/evaluation/20230616TEXAMPLE/" } ] } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListFlywheelIterationHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-flywheel-iteration-history.html)in der *AWS CLI Befehlsreferenz*. ### `list-flywheels` Das folgende Codebeispiel zeigt die Verwendung`list-flywheels`. **AWS CLI** **So listen Sie alle Schwungräder auf** Im folgenden Beispiel für `list-flywheels` werden alle erstellten Schwungräder aufgelistet. ``` aws comprehend list-flywheels ``` Ausgabe: ``` { "FlywheelSummaryList": [ { "FlywheelArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel-1", "ActiveModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier/version/1", "DataLakeS3Uri": "s3://amzn-s3-demo-bucket/example-flywheel-1/schemaVersion=1/20230616T200543Z/", "Status": "ACTIVE", "ModelType": "DOCUMENT_CLASSIFIER", "CreationTime": "2023-06-16T20:05:43.242000+00:00", "LastModifiedTime": "2023-06-19T04:00:43.027000+00:00", "LatestFlywheelIteration": "20230619T040032Z" }, { "FlywheelArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel-2", "ActiveModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/exampleclassifier2/version/1", "DataLakeS3Uri": "s3://amzn-s3-demo-bucket/example-flywheel-2/schemaVersion=1/20220616T200543Z/", "Status": "ACTIVE", "ModelType": "DOCUMENT_CLASSIFIER", "CreationTime": "2022-06-16T20:05:43.242000+00:00", "LastModifiedTime": "2022-06-19T04:00:43.027000+00:00", "LatestFlywheelIteration": "20220619T040032Z" } ] } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListFlywheels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-flywheels.html)in der *AWS CLI Befehlsreferenz*. ### `list-key-phrases-detection-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-key-phrases-detection-jobs`. **AWS CLI** **So listen Sie alle Aufträge zur Erkennung von Schlüsselphrasen auf** Im folgenden Beispiel für `list-key-phrases-detection-jobs` werden alle laufenden und abgeschlossenen asynchronen Aufträge zur Erkennung von Schlüsselphrasen aufgelistet. ``` aws comprehend list-key-phrases-detection-jobs ``` Ausgabe: ``` { "KeyPhrasesDetectionJobPropertiesList": [ { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "keyphrasesanalysis1", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-08T22:31:43.767000+00:00", "EndTime": "2023-06-08T22:39:52.565000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-source-bucket/AsyncBatchJobs/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-KP-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" }, { "JobId": "123456abcdeb0e11022f22a33EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/123456abcdeb0e11022f22a33EXAMPLE", "JobName": "keyphrasesanalysis2", "JobStatus": "STOPPED", "SubmitTime": "2023-06-08T22:57:52.154000+00:00", "EndTime": "2023-06-08T23:05:48.385000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-KP-123456abcdeb0e11022f22a33EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" }, { "JobId": "123456abcdeb0e11022f22a44EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/123456abcdeb0e11022f22a44EXAMPLE", "JobName": "keyphrasesanalysis3", "JobStatus": "FAILED", "Message": "NO_READ_ACCESS_TO_INPUT: The provided data access role does not have proper access to the input data.", "SubmitTime": "2023-06-09T16:47:04.029000+00:00", "EndTime": "2023-06-09T16:47:18.413000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-KP-123456abcdeb0e11022f22a44EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" } ] } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListKeyPhrasesDetectionJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-key-phrases-detection-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-pii-entities-detection-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-pii-entities-detection-jobs`. **AWS CLI** **So listen Sie alle Aufträge zur Erkennung von PII-Entitäten auf** Im folgenden Beispiel für `list-pii-entities-detection-jobs` werden alle laufenden und abgeschlossenen asynchronen Aufträge zur PII-Erkennung aufgelistet. ``` aws comprehend list-pii-entities-detection-jobs ``` Ausgabe: ``` { "PiiEntitiesDetectionJobPropertiesList": [ { "JobId": "6f9db0c42d0c810e814670ee4EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:pii-entities-detection-job/6f9db0c42d0c810e814670ee4EXAMPLE", "JobName": "example-pii-detection-job", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-09T21:02:46.241000+00:00", "EndTime": "2023-06-09T21:12:52.602000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-source-bucket/111122223333-PII-6f9db0c42d0c810e814670ee4EXAMPLE/output/" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role", "Mode": "ONLY_OFFSETS" }, { "JobId": "d927562638cfa739331a99b3cEXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:pii-entities-detection-job/d927562638cfa739331a99b3cEXAMPLE", "JobName": "example-pii-detection-job-2", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-09T21:20:58.211000+00:00", "EndTime": "2023-06-09T21:31:06.027000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/thefolder/111122223333-PII-d927562638cfa739331a99b3cEXAMPLE/output/" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role", "Mode": "ONLY_OFFSETS" } ] } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListPiiEntitiesDetectionJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-pii-entities-detection-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-sentiment-detection-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-sentiment-detection-jobs`. **AWS CLI** **So listen Sie alle Aufträge zur Erkennung von Stimmungen auf** Im folgenden Beispiel für `list-sentiment-detection-jobs` werden alle laufenden und abgeschlossenen asynchronen Aufträge zur Stimmungserkennung aufgelistet. ``` aws comprehend list-sentiment-detection-jobs ``` Ausgabe: ``` { "SentimentDetectionJobPropertiesList": [ { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:sentiment-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "example-sentiment-detection-job", "JobStatus": "IN_PROGRESS", "SubmitTime": "2023-06-09T22:42:20.545000+00:00", "EndTime": "2023-06-09T22:52:27.416000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/MovieData", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-TS-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" }, { "JobId": "123456abcdeb0e11022f22a1EXAMPLE2", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:sentiment-detection-job/123456abcdeb0e11022f22a1EXAMPLE2", "JobName": "example-sentiment-detection-job-2", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-09T23:16:15.956000+00:00", "EndTime": "2023-06-09T23:26:00.168000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/MovieData2", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-TS-123456abcdeb0e11022f22a1EXAMPLE2/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" } ] } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListSentimentDetectionJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-sentiment-detection-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für Ressourcen auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für eine Amazon-Comprehend-Ressource aufgeführt. ``` aws comprehend list-tags-for-resource \ --resource-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1 ``` Ausgabe: ``` { "ResourceArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1", "Tags": [ { "Key": "Department", "Value": "Finance" }, { "Key": "location", "Value": "Seattle" } ] } ``` Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/comprehend/latest/dg/tagging.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-targeted-sentiment-detection-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-targeted-sentiment-detection-jobs`. **AWS CLI** **So listen Sie alle Aufträge zur Erkennung von zielgerichteten Stimmungen auf** Im folgenden Beispiel für `list-targeted-sentiment-detection-jobs` werden alle laufenden und abgeschlossenen asynchronen Aufträge zur Erkennung von zielgerichteten Stimmungen aufgelistet. ``` aws comprehend list-targeted-sentiment-detection-jobs ``` Ausgabe: ``` { "TargetedSentimentDetectionJobPropertiesList": [ { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:targeted-sentiment-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName": "example-targeted-sentiment-detection-job", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-09T22:42:20.545000+00:00", "EndTime": "2023-06-09T22:52:27.416000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/MovieData", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-TS-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-IOrole" }, { "JobId": "123456abcdeb0e11022f22a1EXAMPLE2", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:targeted-sentiment-detection-job/123456abcdeb0e11022f22a1EXAMPLE2", "JobName": "example-targeted-sentiment-detection-job-2", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-09T23:16:15.956000+00:00", "EndTime": "2023-06-09T23:26:00.168000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket/MovieData2", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-TS-123456abcdeb0e11022f22a1EXAMPLE2/output/output.tar.gz" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" } ] } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListTargetedSentimentDetectionJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-targeted-sentiment-detection-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-topics-detection-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-topics-detection-jobs`. **AWS CLI** **So listen Sie alle Aufträge zur Themenerkennung auf** Im folgenden Beispiel für `list-topics-detection-jobs` werden alle laufenden und abgeschlossenen asynchronen Aufträge zur Themenerkennung aufgelistet. ``` aws comprehend list-topics-detection-jobs ``` Ausgabe: ``` { "TopicsDetectionJobPropertiesList": [ { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:topics-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobName" "topic-analysis-1" "JobStatus": "IN_PROGRESS", "SubmitTime": "2023-06-09T18:40:35.384000+00:00", "EndTime": "2023-06-09T18:46:41.936000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/thefolder/111122223333-TOPICS-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz" }, "NumberOfTopics": 10, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" }, { "JobId": "123456abcdeb0e11022f22a1EXAMPLE2", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:topics-detection-job/123456abcdeb0e11022f22a1EXAMPLE2", "JobName": "topic-analysis-2", "JobStatus": "COMPLETED", "SubmitTime": "2023-06-09T18:44:43.414000+00:00", "EndTime": "2023-06-09T18:50:50.872000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/thefolder/111122223333-TOPICS-123456abcdeb0e11022f22a1EXAMPLE2/output/output.tar.gz" }, "NumberOfTopics": 10, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" }, { "JobId": "123456abcdeb0e11022f22a1EXAMPLE3", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:topics-detection-job/123456abcdeb0e11022f22a1EXAMPLE3", "JobName": "topic-analysis-2", "JobStatus": "IN_PROGRESS", "SubmitTime": "2023-06-09T18:50:56.737000+00:00", "InputDataConfig": { "S3Uri": "s3://amzn-s3-demo-bucket", "InputFormat": "ONE_DOC_PER_LINE" }, "OutputDataConfig": { "S3Uri": "s3://amzn-s3-demo-destination-bucket/thefolder/111122223333-TOPICS-123456abcdeb0e11022f22a1EXAMPLE3/output/output.tar.gz" }, "NumberOfTopics": 10, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" } ] } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [ListTopicsDetectionJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/list-topics-detection-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `put-resource-policy` Das folgende Codebeispiel zeigt die Verwendung`put-resource-policy`. **AWS CLI** **So hängen Sie eine ressourcenbasierte Richtlinie an** Im folgenden `put-resource-policy` Beispiel wird eine ressourcenbasierte Richtlinie an ein Modell angehängt, sodass diese von einem anderen Konto importiert werden kann. AWS Die Richtlinie ist an das Modell im Konto `111122223333` angehängt und ermöglicht dem Konto `444455556666`, das Modell zu importieren. ``` aws comprehend put-resource-policy \ --resource-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1 \ --resource-policy '{"Version":"2012-10-17", "Statement":[{"Effect":"Allow","Action":"comprehend:ImportModel","Resource":"*","Principal":{"AWS":["arn:aws:iam::444455556666:root"]}}]}' ``` Ausgabe: ``` { "PolicyRevisionId": "aaa111d069d07afaa2aa3106aEXAMPLE" } ``` Weitere Informationen finden Sie unter [Kopieren von benutzerdefinierten Modellen zwischen AWS Konten](https://docs.aws.amazon.com/comprehend/latest/dg/custom-copy.html) im *Amazon Comprehend Developer Guide*. + Einzelheiten zur API finden Sie unter [PutResourcePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/put-resource-policy.html)*Befehlsreferenz*. ### `start-document-classification-job` Das folgende Codebeispiel zeigt die Verwendung`start-document-classification-job`. **AWS CLI** **So starten Sie einen Auftrag zur Dokumentenklassifizierung** Im folgenden Beispiel für `start-document-classification-job` wird ein Auftrag zur Dokumentenklassifizierung mit einem benutzerdefinierten Modell für alle Dateien an der durch das Tag `--input-data-config` angegebenen Adresse gestartet. In diesem Beispiel enthält der S3-Eingabe-Bucket `SampleSMStext1.txt`, `SampleSMStext2.txt` und `SampleSMStext3.txt`. Das Modell wurde zuvor anhand von Dokumentenklassifizierungen von Spam- und Nicht-Spam-SMS-Nachrichten bzw. „betrügerischen“ SMS-Nachrichten trainiert. Wenn der Auftrag abgeschlossen ist, wird `output.tar.gz` an der durch das `--output-data-config` Tag angegebenen Stelle platziert. `output.tar.gz` enthält die Datei `predictions.jsonl`, in der die Klassifikation der einzelnen Dokumente aufgeführt ist. Die JSON-Ausgabe wird in einer Zeile pro Datei gedruckt, ist aber hier zur besseren Lesbarkeit formatiert. ``` aws comprehend start-document-classification-job \ --job-name exampleclassificationjob \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket-INPUT/jobdata/" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role \ --document-classifier-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/mymodel/version/12 ``` Inhalt von `SampleSMStext1.txt`: ``` "CONGRATULATIONS! TXT 2155550100 to win $5000" ``` Inhalt von `SampleSMStext2.txt`: ``` "Hi, when do you want me to pick you up from practice?" ``` Inhalt von `SampleSMStext3.txt`: ``` "Plz send bank account # to 2155550100 to claim prize!!" ``` Ausgabe: ``` { "JobId": "e758dd56b824aa717ceab551fEXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:document-classification-job/e758dd56b824aa717ceab551fEXAMPLE", "JobStatus": "SUBMITTED" } ``` Inhalt von `predictions.jsonl`: ``` {"File": "SampleSMSText1.txt", "Line": "0", "Classes": [{"Name": "spam", "Score": 0.9999}, {"Name": "ham", "Score": 0.0001}]} {"File": "SampleSMStext2.txt", "Line": "0", "Classes": [{"Name": "ham", "Score": 0.9994}, {"Name": "spam", "Score": 0.0006}]} {"File": "SampleSMSText3.txt", "Line": "0", "Classes": [{"Name": "spam", "Score": 0.9999}, {"Name": "ham", "Score": 0.0001}]} ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Klassifizierung](https://docs.aws.amazon.com/comprehend/latest/dg/how-document-classification.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartDocumentClassificationJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-document-classification-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-dominant-language-detection-job` Das folgende Codebeispiel zeigt die Verwendung`start-dominant-language-detection-job`. **AWS CLI** **So starten Sie einen asynchronen Spracherkennungsauftrag** Im folgenden Beispiel für `start-dominant-language-detection-job` wird ein asynchroner Spracherkennungsauftrag für alle Dateien gestartet, die sich an der durch das Tag `--input-data-config` angegebenen Adresse befinden. In diesem Beispiel enthält der S3-Bucket `Sampletext1.txt`. Wenn der Auftrag abgeschlossen ist, wird der Ordner `output` an dem durch das Tag `--output-data-config` angegebenen Ort platziert. Der Ordner enthält die Datei `output.txt`, die die dominante Sprache der einzelnen Textdateien sowie den Konfidenzwert des vortrainierten Modells für jede Prognose beinhaltet. ``` aws comprehend start-dominant-language-detection-job \ --job-name example_language_analysis_job \ --language-code en \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role \ --language-code en ``` Inhalt von Sampletext1.txt: ``` "Physics is the natural science that involves the study of matter and its motion and behavior through space and time, along with related concepts such as energy and force." ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:dominant-language-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobStatus": "SUBMITTED" } ``` Inhalt von `output.txt`: ``` {"File": "Sampletext1.txt", "Languages": [{"LanguageCode": "en", "Score": 0.9913753867149353}], "Line": 0} ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartDominantLanguageDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-dominant-language-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-entities-detection-job` Das folgende Codebeispiel zeigt die Verwendung`start-entities-detection-job`. **AWS CLI** **Beispiel 1: So starten Sie einen Standardauftrag zur Erkennung von Entitäten mit dem vortrainierten Modell** Im folgenden Beispiel für `start-entities-detection-job` wird ein asynchroner Auftrag zur Entitätenerkennung für alle Dateien gestartet, die sich an der durch das Tag `--input-data-config` angegebenen Adresse befinden. In diesem Beispiel enthält der S3-Bucket `Sampletext1.txt`, `Sampletext2.txt` und `Sampletext3.txt`. Wenn der Auftrag abgeschlossen ist, wird der Ordner `output` an dem durch das Tag `--output-data-config` angegebenen Ort platziert. Der Ordner enthält die Datei `output.txt`, die alle benannten Entitäten, die in jeder Textdatei erkannt wurden, sowie den Konfidenzwert des vortrainierten Modells für jede Prognose aufführt. Die JSON-Ausgabe wird in einer Zeile pro Eingabedatei gedruckt, ist aber hier zur Lesbarkeit formatiert. ``` aws comprehend start-entities-detection-job \ --job-name entitiestest \ --language-code en \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role \ --language-code en ``` Inhalt von `Sampletext1.txt`: ``` "Hello Zhang Wei, I am John. Your AnyCompany Financial Services, LLC credit card account 1111-XXXX-1111-XXXX has a minimum payment of $24.53 that is due by July 31st." ``` Inhalt von `Sampletext2.txt`: ``` "Dear Max, based on your autopay settings for your account example1.org account, we will withdraw your payment on the due date from your bank account number XXXXXX1111 with the routing number XXXXX0000. " ``` Inhalt von `Sampletext3.txt`: ``` "Jane, please submit any customer feedback from this weekend to AnySpa, 123 Main St, Anywhere and send comments to Alice at AnySpa@example.com." ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobStatus": "SUBMITTED" } ``` Inhalt von `output.txt` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "Entities": [ { "BeginOffset": 6, "EndOffset": 15, "Score": 0.9994006636420306, "Text": "Zhang Wei", "Type": "PERSON" }, { "BeginOffset": 22, "EndOffset": 26, "Score": 0.9976647915128143, "Text": "John", "Type": "PERSON" }, { "BeginOffset": 33, "EndOffset": 67, "Score": 0.9984608700836206, "Text": "AnyCompany Financial Services, LLC", "Type": "ORGANIZATION" }, { "BeginOffset": 88, "EndOffset": 107, "Score": 0.9868521019555556, "Text": "1111-XXXX-1111-XXXX", "Type": "OTHER" }, { "BeginOffset": 133, "EndOffset": 139, "Score": 0.998242565709204, "Text": "$24.53", "Type": "QUANTITY" }, { "BeginOffset": 155, "EndOffset": 164, "Score": 0.9993039263159287, "Text": "July 31st", "Type": "DATE" } ], "File": "SampleText1.txt", "Line": 0 } { "Entities": [ { "BeginOffset": 5, "EndOffset": 8, "Score": 0.9866232147545232, "Text": "Max", "Type": "PERSON" }, { "BeginOffset": 156, "EndOffset": 166, "Score": 0.9797723450933329, "Text": "XXXXXX1111", "Type": "OTHER" }, { "BeginOffset": 191, "EndOffset": 200, "Score": 0.9247838572396843, "Text": "XXXXX0000", "Type": "OTHER" } ], "File": "SampleText2.txt", "Line": 0 } { "Entities": [ { "Score": 0.9990532994270325, "Type": "PERSON", "Text": "Jane", "BeginOffset": 0, "EndOffset": 4 }, { "Score": 0.9519651532173157, "Type": "DATE", "Text": "this weekend", "BeginOffset": 47, "EndOffset": 59 }, { "Score": 0.5566426515579224, "Type": "ORGANIZATION", "Text": "AnySpa", "BeginOffset": 63, "EndOffset": 69 }, { "Score": 0.8059805631637573, "Type": "LOCATION", "Text": "123 Main St, Anywhere", "BeginOffset": 71, "EndOffset": 92 }, { "Score": 0.998830258846283, "Type": "PERSON", "Text": "Alice", "BeginOffset": 114, "EndOffset": 119 }, { "Score": 0.997818112373352, "Type": "OTHER", "Text": "AnySpa@example.com", "BeginOffset": 123, "EndOffset": 138 } ], "File": "SampleText3.txt", "Line": 0 } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. **Beispiel 2: So starten Sie einen benutzerdefinierten Auftrag zur Erkennung von Entitäten** Im folgenden Beispiel für `start-entities-detection-job` wird ein asynchroner Auftrag zur Erkennung benutzerdefinierter Entitäten für alle Dateien gestartet, die sich an der durch das Tag `--input-data-config` angegebenen Adresse befinden. In diesem Beispiel enthält der S3-Bucket `SampleFeedback1.txt`, `SampleFeedback2.txt` und `SampleFeedback3.txt`. Das Entitätserkennungsmodell wurde anhand von Feedback des Kundensupports trainiert, um Gerätenamen zu erkennen. Wenn der Auftrag abgeschlossen ist, wird der Ordner `output` an dem durch das Tag `--output-data-config` angegebenen Ort platziert. Der Ordner enthält die Datei `output.txt`, die alle benannten Entitäten, die in jeder Textdatei erkannt wurden, sowie den Konfidenzwert des vortrainierten Modells für jede Prognose aufführt. Die JSON-Ausgabe wird in einer Zeile pro Datei gedruckt, ist aber hier zur besseren Lesbarkeit formatiert. ``` aws comprehend start-entities-detection-job \ --job-name customentitiestest \ --entity-recognizer-arn "arn:aws:comprehend:us-west-2:111122223333:entity-recognizer/entityrecognizer" \ --language-code en \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/jobdata/" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-IOrole" ``` Inhalt von `SampleFeedback1.txt`: ``` "I've been on the AnyPhone app have had issues for 24 hours when trying to pay bill. Cannot make payment. Sigh. | Oh man! Lets get that app up and running. DM me, and we can get to work!" ``` Inhalt von `SampleFeedback2.txt`: ``` "Hi, I have a discrepancy with my new bill. Could we get it sorted out? A rep added stuff I didn't sign up for when I did my AnyPhone 10 upgrade. | We can absolutely get this sorted!" ``` Inhalt von `SampleFeedback3.txt`: ``` "Is the by 1 get 1 free AnySmartPhone promo still going on? | Hi Christian! It ended yesterday, send us a DM if you have any questions and we can take a look at your options!" ``` Ausgabe: ``` { "JobId": "019ea9edac758806850fa8a79ff83021", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/019ea9edac758806850fa8a79ff83021", "JobStatus": "SUBMITTED" } ``` Inhalt von `output.txt` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "Entities": [ { "BeginOffset": 17, "EndOffset": 25, "Score": 0.9999728210205924, "Text": "AnyPhone", "Type": "DEVICE" } ], "File": "SampleFeedback1.txt", "Line": 0 } { "Entities": [ { "BeginOffset": 123, "EndOffset": 133, "Score": 0.9999892116761524, "Text": "AnyPhone 10", "Type": "DEVICE" } ], "File": "SampleFeedback2.txt", "Line": 0 } { "Entities": [ { "BeginOffset": 23, "EndOffset": 35, "Score": 0.9999971389852362, "Text": "AnySmartPhone", "Type": "DEVICE" } ], "File": "SampleFeedback3.txt", "Line": 0 } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Entitätserkennung](https://docs.aws.amazon.com/comprehend/latest/dg/custom-entity-recognition.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartEntitiesDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-entities-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-events-detection-job` Das folgende Codebeispiel zeigt die Verwendung`start-events-detection-job`. **AWS CLI** **So starten Sie einen asynchronen Ereigniserkennungsauftrag** Im folgenden Beispiel für `start-events-detection-job` wird ein asynchroner Auftrag zur Ereigniserkennung für alle Dateien gestartet, die sich an der durch das Tag `--input-data-config` angegebenen Adresse befinden. Zu den möglichen Zielereignistypen gehören `BANKRUPCTY`, `EMPLOYMENT`, `CORPORATE_ACQUISITION`, `INVESTMENT_GENERAL`, `CORPORATE_MERGER`, `IPO`, `RIGHTS_ISSUE`, `SECONDARY_OFFERING`, `SHELF_OFFERING`, `TENDER_OFFERING` und `STOCK_SPLIT`. In diesem Beispiel enthält der S3-Bucket `SampleText1.txt`, `SampleText2.txt` und `SampleText3.txt`. Wenn der Auftrag abgeschlossen ist, wird der Ordner `output` an dem durch das Tag `--output-data-config` angegebenen Ort platziert. Der Ordner enthält `SampleText1.txt.out`, `SampleText2.txt.out` und `SampleText3.txt.out`. Die JSON-Ausgabe wird in einer Zeile pro Datei gedruckt, ist aber hier zur besseren Lesbarkeit formatiert. ``` aws comprehend start-events-detection-job \ --job-name events-detection-1 \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/EventsData" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-servicerole \ --language-code en \ --target-event-types "BANKRUPTCY" "EMPLOYMENT" "CORPORATE_ACQUISITION" "CORPORATE_MERGER" "INVESTMENT_GENERAL" ``` Inhalt von `SampleText1.txt`: ``` "Company AnyCompany grew by increasing sales and through acquisitions. After purchasing competing firms in 2020, AnyBusiness, a part of the AnyBusinessGroup, gave Jane Does firm a going rate of one cent a gallon or forty-two cents a barrel." ``` Inhalt von `SampleText2.txt`: ``` "In 2021, AnyCompany officially purchased AnyBusiness for 100 billion dollars, surprising and exciting the shareholders." ``` Inhalt von `SampleText3.txt`: ``` "In 2022, AnyCompany stock crashed 50. Eventually later that year they filed for bankruptcy." ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:events-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobStatus": "SUBMITTED" } ``` Inhalt von `SampleText1.txt.out` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "Entities": [ { "Mentions": [ { "BeginOffset": 8, "EndOffset": 18, "Score": 0.99977, "Text": "AnyCompany", "Type": "ORGANIZATION", "GroupScore": 1 }, { "BeginOffset": 112, "EndOffset": 123, "Score": 0.999747, "Text": "AnyBusiness", "Type": "ORGANIZATION", "GroupScore": 0.979826 }, { "BeginOffset": 171, "EndOffset": 175, "Score": 0.999615, "Text": "firm", "Type": "ORGANIZATION", "GroupScore": 0.871647 } ] }, { "Mentions": [ { "BeginOffset": 97, "EndOffset": 102, "Score": 0.987687, "Text": "firms", "Type": "ORGANIZATION", "GroupScore": 1 } ] }, { "Mentions": [ { "BeginOffset": 103, "EndOffset": 110, "Score": 0.999458, "Text": "in 2020", "Type": "DATE", "GroupScore": 1 } ] }, { "Mentions": [ { "BeginOffset": 160, "EndOffset": 168, "Score": 0.999649, "Text": "John Doe", "Type": "PERSON", "GroupScore": 1 } ] } ], "Events": [ { "Type": "CORPORATE_ACQUISITION", "Arguments": [ { "EntityIndex": 0, "Role": "INVESTOR", "Score": 0.99977 } ], "Triggers": [ { "BeginOffset": 56, "EndOffset": 68, "Score": 0.999967, "Text": "acquisitions", "Type": "CORPORATE_ACQUISITION", "GroupScore": 1 } ] }, { "Type": "CORPORATE_ACQUISITION", "Arguments": [ { "EntityIndex": 1, "Role": "INVESTEE", "Score": 0.987687 }, { "EntityIndex": 2, "Role": "DATE", "Score": 0.999458 }, { "EntityIndex": 3, "Role": "INVESTOR", "Score": 0.999649 } ], "Triggers": [ { "BeginOffset": 76, "EndOffset": 86, "Score": 0.999973, "Text": "purchasing", "Type": "CORPORATE_ACQUISITION", "GroupScore": 1 } ] } ], "File": "SampleText1.txt", "Line": 0 } ``` Inhalt von `SampleText2.txt.out`: ``` { "Entities": [ { "Mentions": [ { "BeginOffset": 0, "EndOffset": 7, "Score": 0.999473, "Text": "In 2021", "Type": "DATE", "GroupScore": 1 } ] }, { "Mentions": [ { "BeginOffset": 9, "EndOffset": 19, "Score": 0.999636, "Text": "AnyCompany", "Type": "ORGANIZATION", "GroupScore": 1 } ] }, { "Mentions": [ { "BeginOffset": 45, "EndOffset": 56, "Score": 0.999712, "Text": "AnyBusiness", "Type": "ORGANIZATION", "GroupScore": 1 } ] }, { "Mentions": [ { "BeginOffset": 61, "EndOffset": 80, "Score": 0.998886, "Text": "100 billion dollars", "Type": "MONETARY_VALUE", "GroupScore": 1 } ] } ], "Events": [ { "Type": "CORPORATE_ACQUISITION", "Arguments": [ { "EntityIndex": 3, "Role": "AMOUNT", "Score": 0.998886 }, { "EntityIndex": 2, "Role": "INVESTEE", "Score": 0.999712 }, { "EntityIndex": 0, "Role": "DATE", "Score": 0.999473 }, { "EntityIndex": 1, "Role": "INVESTOR", "Score": 0.999636 } ], "Triggers": [ { "BeginOffset": 31, "EndOffset": 40, "Score": 0.99995, "Text": "purchased", "Type": "CORPORATE_ACQUISITION", "GroupScore": 1 } ] } ], "File": "SampleText2.txt", "Line": 0 } ``` Inhalt von `SampleText3.txt.out`: ``` { "Entities": [ { "Mentions": [ { "BeginOffset": 9, "EndOffset": 19, "Score": 0.999774, "Text": "AnyCompany", "Type": "ORGANIZATION", "GroupScore": 1 }, { "BeginOffset": 66, "EndOffset": 70, "Score": 0.995717, "Text": "they", "Type": "ORGANIZATION", "GroupScore": 0.997626 } ] }, { "Mentions": [ { "BeginOffset": 50, "EndOffset": 65, "Score": 0.999656, "Text": "later that year", "Type": "DATE", "GroupScore": 1 } ] } ], "Events": [ { "Type": "BANKRUPTCY", "Arguments": [ { "EntityIndex": 1, "Role": "DATE", "Score": 0.999656 }, { "EntityIndex": 0, "Role": "FILER", "Score": 0.995717 } ], "Triggers": [ { "BeginOffset": 81, "EndOffset": 91, "Score": 0.999936, "Text": "bankruptcy", "Type": "BANKRUPTCY", "GroupScore": 1 } ] } ], "File": "SampleText3.txt", "Line": 0 } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartEventsDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-events-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-flywheel-iteration` Das folgende Codebeispiel zeigt die Verwendung`start-flywheel-iteration`. **AWS CLI** **So starten Sie eine Schwungrad-Iteration** Im folgenden Beispiel für `start-flywheel-iteration` wird eine Schwungrad-Iteration gestartet. Bei dieser Operation werden alle neuen Datensätze im Schwungrad verwendet, um eine neue Modellversion zu trainieren. ``` aws comprehend start-flywheel-iteration \ --flywheel-arn arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel ``` Ausgabe: ``` { "FlywheelArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel", "FlywheelIterationId": "12345123TEXAMPLE" } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartFlywheelIteration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-flywheel-iteration.html)in der *AWS CLI Befehlsreferenz*. ### `start-key-phrases-detection-job` Das folgende Codebeispiel zeigt die Verwendung`start-key-phrases-detection-job`. **AWS CLI** **So starten Sie einen Auftrag zur Erkennung von Schlüsselphrasen** Im folgenden Beispiel für `start-key-phrases-detection-job` wird ein asynchroner Auftrag zur Erkennung von Schlüsselphrasen für alle Dateien gestartet, die sich an der durch das Tag `--input-data-config` angegebenen Adresse befinden. In diesem Beispiel enthält der S3-Bucket `Sampletext1.txt`, `Sampletext2.txt` und `Sampletext3.txt`. Wenn der Auftrag abgeschlossen ist, wird der Ordner `output` an dem durch das Tag `--output-data-config` angegebenen Ort platziert. Der Ordner enthält die Datei `output.txt`, die alle Schlüsselphrasen, die in jeder Textdatei erkannt wurden, sowie den Konfidenzwert des vortrainierten Modells für jede Prognose beinhaltet. Die JSON-Ausgabe wird in einer Zeile pro Datei gedruckt, ist aber hier zur besseren Lesbarkeit formatiert. ``` aws comprehend start-key-phrases-detection-job \ --job-name keyphrasesanalysistest1 \ --language-code en \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role" \ --language-code en ``` Inhalt von `Sampletext1.txt`: ``` "Hello Zhang Wei, I am John. Your AnyCompany Financial Services, LLC credit card account 1111-XXXX-1111-XXXX has a minimum payment of $24.53 that is due by July 31st." ``` Inhalt von `Sampletext2.txt`: ``` "Dear Max, based on your autopay settings for your account Internet.org account, we will withdraw your payment on the due date from your bank account number XXXXXX1111 with the routing number XXXXX0000. " ``` Inhalt von `Sampletext3.txt`: ``` "Jane, please submit any customer feedback from this weekend to Sunshine Spa, 123 Main St, Anywhere and send comments to Alice at AnySpa@example.com." ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobStatus": "SUBMITTED" } ``` Inhalt von `output.txt` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "File": "SampleText1.txt", "KeyPhrases": [ { "BeginOffset": 6, "EndOffset": 15, "Score": 0.9748965572679326, "Text": "Zhang Wei" }, { "BeginOffset": 22, "EndOffset": 26, "Score": 0.9997344722354619, "Text": "John" }, { "BeginOffset": 28, "EndOffset": 62, "Score": 0.9843791074032948, "Text": "Your AnyCompany Financial Services" }, { "BeginOffset": 64, "EndOffset": 107, "Score": 0.8976122401721824, "Text": "LLC credit card account 1111-XXXX-1111-XXXX" }, { "BeginOffset": 112, "EndOffset": 129, "Score": 0.9999612982629748, "Text": "a minimum payment" }, { "BeginOffset": 133, "EndOffset": 139, "Score": 0.99975728947036, "Text": "$24.53" }, { "BeginOffset": 155, "EndOffset": 164, "Score": 0.9940866241449973, "Text": "July 31st" } ], "Line": 0 } { "File": "SampleText2.txt", "KeyPhrases": [ { "BeginOffset": 0, "EndOffset": 8, "Score": 0.9974021100118472, "Text": "Dear Max" }, { "BeginOffset": 19, "EndOffset": 40, "Score": 0.9961120519515884, "Text": "your autopay settings" }, { "BeginOffset": 45, "EndOffset": 78, "Score": 0.9980620070116009, "Text": "your account Internet.org account" }, { "BeginOffset": 97, "EndOffset": 109, "Score": 0.999919660140754, "Text": "your payment" }, { "BeginOffset": 113, "EndOffset": 125, "Score": 0.9998370719754205, "Text": "the due date" }, { "BeginOffset": 131, "EndOffset": 166, "Score": 0.9955068678502509, "Text": "your bank account number XXXXXX1111" }, { "BeginOffset": 172, "EndOffset": 200, "Score": 0.8653433315829526, "Text": "the routing number XXXXX0000" } ], "Line": 0 } { "File": "SampleText3.txt", "KeyPhrases": [ { "BeginOffset": 0, "EndOffset": 4, "Score": 0.9142947833681668, "Text": "Jane" }, { "BeginOffset": 20, "EndOffset": 41, "Score": 0.9984325676596763, "Text": "any customer feedback" }, { "BeginOffset": 47, "EndOffset": 59, "Score": 0.9998782448150636, "Text": "this weekend" }, { "BeginOffset": 63, "EndOffset": 75, "Score": 0.99866741830757, "Text": "Sunshine Spa" }, { "BeginOffset": 77, "EndOffset": 88, "Score": 0.9695803485466054, "Text": "123 Main St" }, { "BeginOffset": 108, "EndOffset": 116, "Score": 0.9997065928550928, "Text": "comments" }, { "BeginOffset": 120, "EndOffset": 125, "Score": 0.9993466833825161, "Text": "Alice" }, { "BeginOffset": 129, "EndOffset": 144, "Score": 0.9654563612885667, "Text": "AnySpa@example.com" } ], "Line": 0 } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartKeyPhrasesDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-key-phrases-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-pii-entities-detection-job` Das folgende Codebeispiel zeigt die Verwendung`start-pii-entities-detection-job`. **AWS CLI** **So starten Sie einen asynchronen PII-Erkennungsauftrag** Im folgenden Beispiel für `start-pii-entities-detection-job` wird ein asynchroner Auftrag zur Erkennung persönlich identifizierbarer Informationen (PII) für alle Dateien gestartet, die sich an der durch das Tag `--input-data-config` angegebenen Adresse befinden. In diesem Beispiel enthält der S3-Bucket `Sampletext1.txt`, `Sampletext2.txt` und `Sampletext3.txt`. Wenn der Auftrag abgeschlossen ist, wird der Ordner `output` an dem durch das Tag `--output-data-config` angegebenen Ort platziert. Der Ordner enthält die Dateien `SampleText1.txt.out`, `SampleText2.txt.out` und `SampleText3.txt.out`, in denen die benannten Entitäten jeder Textdatei aufgeführt sind. Die JSON-Ausgabe wird in einer Zeile pro Datei gedruckt, ist aber hier zur besseren Lesbarkeit formatiert. ``` aws comprehend start-pii-entities-detection-job \ --job-name entities_test \ --language-code en \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role \ --language-code en \ --mode ONLY_OFFSETS ``` Inhalt von `Sampletext1.txt`: ``` "Hello Zhang Wei, I am John. Your AnyCompany Financial Services, LLC credit card account 1111-XXXX-1111-XXXX has a minimum payment of $24.53 that is due by July 31st." ``` Inhalt von `Sampletext2.txt`: ``` "Dear Max, based on your autopay settings for your account Internet.org account, we will withdraw your payment on the due date from your bank account number XXXXXX1111 with the routing number XXXXX0000. " ``` Inhalt von `Sampletext3.txt`: ``` "Jane, please submit any customer feedback from this weekend to Sunshine Spa, 123 Main St, Anywhere and send comments to Alice at AnySpa@example.com." ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:pii-entities-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobStatus": "SUBMITTED" } ``` Inhalt von `SampleText1.txt.out` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "Entities": [ { "BeginOffset": 6, "EndOffset": 15, "Type": "NAME", "Score": 0.9998490510222595 }, { "BeginOffset": 22, "EndOffset": 26, "Type": "NAME", "Score": 0.9998937958019426 }, { "BeginOffset": 88, "EndOffset": 107, "Type": "CREDIT_DEBIT_NUMBER", "Score": 0.9554297245278491 }, { "BeginOffset": 155, "EndOffset": 164, "Type": "DATE_TIME", "Score": 0.9999720462925257 } ], "File": "SampleText1.txt", "Line": 0 } ``` Inhalt von `SampleText2.txt.out` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "Entities": [ { "BeginOffset": 5, "EndOffset": 8, "Type": "NAME", "Score": 0.9994390774924007 }, { "BeginOffset": 58, "EndOffset": 70, "Type": "URL", "Score": 0.9999958276922101 }, { "BeginOffset": 156, "EndOffset": 166, "Type": "BANK_ACCOUNT_NUMBER", "Score": 0.9999721058045592 }, { "BeginOffset": 191, "EndOffset": 200, "Type": "BANK_ROUTING", "Score": 0.9998968945989909 } ], "File": "SampleText2.txt", "Line": 0 } ``` Inhalt von `SampleText3.txt.out` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "Entities": [ { "BeginOffset": 0, "EndOffset": 4, "Type": "NAME", "Score": 0.999949934606805 }, { "BeginOffset": 77, "EndOffset": 88, "Type": "ADDRESS", "Score": 0.9999035300466904 }, { "BeginOffset": 120, "EndOffset": 125, "Type": "NAME", "Score": 0.9998203838716296 }, { "BeginOffset": 129, "EndOffset": 144, "Type": "EMAIL", "Score": 0.9998313473105228 } ], "File": "SampleText3.txt", "Line": 0 } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartPiiEntitiesDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-pii-entities-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-sentiment-detection-job` Das folgende Codebeispiel zeigt die Verwendung`start-sentiment-detection-job`. **AWS CLI** **So starten Sie einen asynchronen Stimmungsanalyseauftrag** Im folgenden Beispiel für `start-sentiment-detection-job` wird ein asynchroner Erkennungsauftrag zur Stimmungsanalyse für alle Dateien gestartet, die sich an der durch das Tag `--input-data-config` angegebenen Adresse befinden. In diesem Beispiel enthält der S3-Bucket-Ordner `SampleMovieReview1.txt`, `SampleMovieReview2.txt` und `SampleMovieReview3.txt`. Wenn der Auftrag abgeschlossen ist, wird der Ordner `output` an dem durch das Tag `--output-data-config` angegebenen Ort platziert. Der Ordner enthält die Datei `output.txt`, die die vorherrschenden Stimmungen für jede Textdatei sowie den Konfidenzwert des vortrainierten Modells für jede Prognose beinhaltet. Die JSON-Ausgabe wird in einer Zeile pro Datei gedruckt, ist aber hier zur besseren Lesbarkeit formatiert. ``` aws comprehend start-sentiment-detection-job \ --job-name example-sentiment-detection-job \ --language-code en \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/MovieData" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role ``` Inhalt von `SampleMovieReview1.txt`: ``` "The film, AnyMovie2, is fairly predictable and just okay." ``` Inhalt von `SampleMovieReview2.txt`: ``` "AnyMovie2 is the essential sci-fi film that I grew up watching when I was a kid. I highly recommend this movie." ``` Inhalt von `SampleMovieReview3.txt`: ``` "Don't get fooled by the 'awards' for AnyMovie2. All parts of the film were poorly stolen from other modern directors." ``` Ausgabe: ``` { "JobId": "0b5001e25f62ebb40631a9a1a7fde7b3", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:sentiment-detection-job/0b5001e25f62ebb40631a9a1a7fde7b3", "JobStatus": "SUBMITTED" } ``` Inhalt von `output.txt` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "File": "SampleMovieReview1.txt", "Line": 0, "Sentiment": "MIXED", "SentimentScore": { "Mixed": 0.6591159105300903, "Negative": 0.26492202281951904, "Neutral": 0.035430654883384705, "Positive": 0.04053137078881264 } } { "File": "SampleMovieReview2.txt", "Line": 0, "Sentiment": "POSITIVE", "SentimentScore": { "Mixed": 0.000008718466233403888, "Negative": 0.00006134175055194646, "Neutral": 0.0002941041602753103, "Positive": 0.9996358156204224 } } { "File": "SampleMovieReview3.txt", "Line": 0, "Sentiment": "NEGATIVE", "SentimentScore": { "Mixed": 0.004146667663007975, "Negative": 0.9645107984542847, "Neutral": 0.016559595242142677, "Positive": 0.014782938174903393 } } } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartSentimentDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-sentiment-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-targeted-sentiment-detection-job` Das folgende Codebeispiel zeigt die Verwendung`start-targeted-sentiment-detection-job`. **AWS CLI** **So starten Sie einen asynchronen Auftrag zur Analyse der zielgerichteten Stimmung** Im folgenden Beispiel für `start-targeted-sentiment-detection-job` wird ein asynchroner Erkennungsauftrag zur Analyse der zielgerichteten Stimmung für alle Dateien gestartet, die sich an der durch das Tag `--input-data-config` angegebenen Adresse befinden. In diesem Beispiel enthält der S3-Bucket-Ordner `SampleMovieReview1.txt`, `SampleMovieReview2.txt` und `SampleMovieReview3.txt`. Wenn der Auftrag abgeschlossen ist, wird `output.tar.gz` an den durch das Tag `--output-data-config` angegebenen Ort platziert. `output.tar.gz`enthält die Dateien `SampleMovieReview1.txt.out`, `SampleMovieReview2.txt.out` und `SampleMovieReview3.txt.out`, die jeweils alle benannten Entitäten und die zugehörigen Stimmungen für eine einzelne Eingabetextdatei umfassen. ``` aws comprehend start-targeted-sentiment-detection-job \ --job-name targeted_movie_review_analysis1 \ --language-code en \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/MovieData" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role ``` Inhalt von `SampleMovieReview1.txt`: ``` "The film, AnyMovie, is fairly predictable and just okay." ``` Inhalt von `SampleMovieReview2.txt`: ``` "AnyMovie is the essential sci-fi film that I grew up watching when I was a kid. I highly recommend this movie." ``` Inhalt von `SampleMovieReview3.txt`: ``` "Don't get fooled by the 'awards' for AnyMovie. All parts of the film were poorly stolen from other modern directors." ``` Ausgabe: ``` { "JobId": "0b5001e25f62ebb40631a9a1a7fde7b3", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:targeted-sentiment-detection-job/0b5001e25f62ebb40631a9a1a7fde7b3", "JobStatus": "SUBMITTED" } ``` Inhalt von `SampleMovieReview1.txt.out` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "Entities": [ { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "BeginOffset": 4, "EndOffset": 8, "Score": 0.994972, "GroupScore": 1, "Text": "film", "Type": "MOVIE", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Mixed": 0, "Negative": 0, "Neutral": 1, "Positive": 0 } } } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "BeginOffset": 10, "EndOffset": 18, "Score": 0.631368, "GroupScore": 1, "Text": "AnyMovie", "Type": "ORGANIZATION", "MentionSentiment": { "Sentiment": "POSITIVE", "SentimentScore": { "Mixed": 0.001729, "Negative": 0.000001, "Neutral": 0.000318, "Positive": 0.997952 } } } ] } ], "File": "SampleMovieReview1.txt", "Line": 0 } ``` Inhalt von `SampleMovieReview2.txt.out` mit Einzügen zur besseren Lesbarkeit: ``` { "Entities": [ { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "BeginOffset": 0, "EndOffset": 8, "Score": 0.854024, "GroupScore": 1, "Text": "AnyMovie", "Type": "MOVIE", "MentionSentiment": { "Sentiment": "POSITIVE", "SentimentScore": { "Mixed": 0, "Negative": 0, "Neutral": 0.000007, "Positive": 0.999993 } } }, { "BeginOffset": 104, "EndOffset": 109, "Score": 0.999129, "GroupScore": 0.502937, "Text": "movie", "Type": "MOVIE", "MentionSentiment": { "Sentiment": "POSITIVE", "SentimentScore": { "Mixed": 0, "Negative": 0, "Neutral": 0, "Positive": 1 } } }, { "BeginOffset": 33, "EndOffset": 37, "Score": 0.999823, "GroupScore": 0.999252, "Text": "film", "Type": "MOVIE", "MentionSentiment": { "Sentiment": "POSITIVE", "SentimentScore": { "Mixed": 0, "Negative": 0, "Neutral": 0.000001, "Positive": 0.999999 } } } ] }, { "DescriptiveMentionIndex": [ 0, 1, 2 ], "Mentions": [ { "BeginOffset": 43, "EndOffset": 44, "Score": 0.999997, "GroupScore": 1, "Text": "I", "Type": "PERSON", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Mixed": 0, "Negative": 0, "Neutral": 1, "Positive": 0 } } }, { "BeginOffset": 80, "EndOffset": 81, "Score": 0.999996, "GroupScore": 0.52523, "Text": "I", "Type": "PERSON", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Mixed": 0, "Negative": 0, "Neutral": 1, "Positive": 0 } } }, { "BeginOffset": 67, "EndOffset": 68, "Score": 0.999994, "GroupScore": 0.999499, "Text": "I", "Type": "PERSON", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Mixed": 0, "Negative": 0, "Neutral": 1, "Positive": 0 } } } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "BeginOffset": 75, "EndOffset": 78, "Score": 0.999978, "GroupScore": 1, "Text": "kid", "Type": "PERSON", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Mixed": 0, "Negative": 0, "Neutral": 1, "Positive": 0 } } } ] } ], "File": "SampleMovieReview2.txt", "Line": 0 } ``` Inhalt von `SampleMovieReview3.txt.out` mit Zeileneinzügen zur besseren Lesbarkeit: ``` { "Entities": [ { "DescriptiveMentionIndex": [ 1 ], "Mentions": [ { "BeginOffset": 64, "EndOffset": 68, "Score": 0.992953, "GroupScore": 0.999814, "Text": "film", "Type": "MOVIE", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Mixed": 0.000004, "Negative": 0.010425, "Neutral": 0.989543, "Positive": 0.000027 } } }, { "BeginOffset": 37, "EndOffset": 45, "Score": 0.999782, "GroupScore": 1, "Text": "AnyMovie", "Type": "ORGANIZATION", "MentionSentiment": { "Sentiment": "POSITIVE", "SentimentScore": { "Mixed": 0.000095, "Negative": 0.039847, "Neutral": 0.000673, "Positive": 0.959384 } } } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "BeginOffset": 47, "EndOffset": 50, "Score": 0.999991, "GroupScore": 1, "Text": "All", "Type": "QUANTITY", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Mixed": 0.000001, "Negative": 0.000001, "Neutral": 0.999998, "Positive": 0 } } } ] }, { "DescriptiveMentionIndex": [ 0 ], "Mentions": [ { "BeginOffset": 106, "EndOffset": 115, "Score": 0.542083, "GroupScore": 1, "Text": "directors", "Type": "PERSON", "MentionSentiment": { "Sentiment": "NEUTRAL", "SentimentScore": { "Mixed": 0, "Negative": 0, "Neutral": 1, "Positive": 0 } } } ] } ], "File": "SampleMovieReview3.txt", "Line": 0 } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartTargetedSentimentDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-targeted-sentiment-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-topics-detection-job` Das folgende Codebeispiel zeigt die Verwendung`start-topics-detection-job`. **AWS CLI** **So starten Sie einen Analyseauftrag zur Themenerkennung** Im folgenden Beispiel für `start-topics-detection-job` wird ein asynchroner Auftrag zur Themenerkennung für alle Dateien gestartet, die sich an der durch das Tag `--input-data-config` angegebenen Adresse befinden. Wenn der Auftrag abgeschlossen ist, wird der Ordner `output` an dem durch das Tag `--ouput-data-config` angegebenen Ort platziert. `output` enthält die Dateien topic-terms.csv und doc-topics.csv. Die erste Ausgabedatei, topic-terms.csv, ist eine Liste von Themen in der Sammlung. Für jedes Thema enthält die Liste standardmäßig die wichtigsten Begriffe, sortiert nach Themen, entsprechend ihrer Gewichtung. In der zweiten Datei `doc-topics.csv` werden die Dokumente aufgeführt, die einem Thema zugeordnet sind, sowie der Anteil des Dokuments, der sich mit dem Thema befasst. ``` aws comprehend start-topics-detection-job \ --job-name example_topics_detection_job \ --language-code en \ --input-data-config "S3Uri=s3://amzn-s3-demo-bucket/" \ --output-data-config "S3Uri=s3://amzn-s3-demo-destination-bucket/testfolder/" \ --data-access-role-arn arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role \ --language-code en ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE", "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/123456abcdeb0e11022f22a11EXAMPLE", "JobStatus": "SUBMITTED" } ``` Weitere Informationen finden Sie unter [Themenmodellierung](https://docs.aws.amazon.com/comprehend/latest/dg/topic-modeling.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StartTopicsDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/start-topics-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-dominant-language-detection-job` Das folgende Codebeispiel zeigt die Verwendung`stop-dominant-language-detection-job`. **AWS CLI** **So starten Sie einen asynchronen Auftrag zur Erkennung der dominanten Sprache** Im folgenden Beispiel für `stop-dominant-language-detection-job` wird ein laufender asynchroner Auftrag zur Erkennung der dominanten Sprache angehalten. Wenn der aktuelle Auftragsstatus `IN_PROGRESS` lautet, wird der Auftrag zur Beendigung markiert und in den Status `STOP_REQUESTED` versetzt. Wenn der Auftrag abgeschlossen ist, bevor er angehalten werden kann, wird er in den Status `COMPLETED` versetzt. ``` aws comprehend stop-dominant-language-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE, "JobStatus": "STOP_REQUESTED" } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StopDominantLanguageDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/stop-dominant-language-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-entities-detection-job` Das folgende Codebeispiel zeigt die Verwendung`stop-entities-detection-job`. **AWS CLI** **So starten Sie einen asynchronen Auftrag zur Erkennung von Entitäten** Im folgenden Beispiel für `stop-entities-detection-job` wird ein laufender asynchroner Auftrag zur Entitätserkennung angehalten. Wenn der aktuelle Auftragsstatus `IN_PROGRESS` lautet, wird der Auftrag zur Beendigung markiert und in den Status `STOP_REQUESTED` versetzt. Wenn der Auftrag abgeschlossen ist, bevor er angehalten werden kann, wird er in den Status `COMPLETED` versetzt. ``` aws comprehend stop-entities-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE, "JobStatus": "STOP_REQUESTED" } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StopEntitiesDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/stop-entities-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-events-detection-job` Das folgende Codebeispiel zeigt die Verwendung`stop-events-detection-job`. **AWS CLI** **So halten Sie einen asynchronen Ereigniserkennungsauftrag an** Im folgenden Beispiel für `stop-events-detection-job` wird ein laufender asynchroner Auftrag zur Ereigniserkennung angehalten. Wenn der aktuelle Auftragsstatus `IN_PROGRESS` lautet, wird der Auftrag zur Beendigung markiert und in den Status `STOP_REQUESTED` versetzt. Wenn der Auftrag abgeschlossen ist, bevor er angehalten werden kann, wird er in den Status `COMPLETED` versetzt. ``` aws comprehend stop-events-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE, "JobStatus": "STOP_REQUESTED" } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StopEventsDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/stop-events-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-key-phrases-detection-job` Das folgende Codebeispiel zeigt die Verwendung`stop-key-phrases-detection-job`. **AWS CLI** **So halten Sie einen asynchronen Auftrag zur Erkennung von Schlüsselphrasen an** Im folgenden Beispiel für `stop-key-phrases-detection-job` wird ein laufender asynchroner Auftrag zur Erkennung von Schlüsselphrasen angehalten. Wenn der aktuelle Auftragsstatus `IN_PROGRESS` lautet, wird der Auftrag zur Beendigung markiert und in den Status `STOP_REQUESTED` versetzt. Wenn der Auftrag abgeschlossen ist, bevor er angehalten werden kann, wird er in den Status `COMPLETED` versetzt. ``` aws comprehend stop-key-phrases-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE, "JobStatus": "STOP_REQUESTED" } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StopKeyPhrasesDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/stop-key-phrases-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-pii-entities-detection-job` Das folgende Codebeispiel zeigt die Verwendung`stop-pii-entities-detection-job`. **AWS CLI** **So starten Sie einen asynchronen Auftrag zur Erkennung von PII-Entitäten** Im folgenden Beispiel für `stop-pii-entities-detection-job` wird ein laufender asynchroner Auftrag zur Erkennung von PII-Entitäten angehalten. Wenn der aktuelle Auftragsstatus `IN_PROGRESS` lautet, wird der Auftrag zur Beendigung markiert und in den Status `STOP_REQUESTED` versetzt. Wenn der Auftrag abgeschlossen ist, bevor er angehalten werden kann, wird er in den Status `COMPLETED` versetzt. ``` aws comprehend stop-pii-entities-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE, "JobStatus": "STOP_REQUESTED" } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StopPiiEntitiesDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/stop-pii-entities-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-sentiment-detection-job` Das folgende Codebeispiel zeigt die Verwendung`stop-sentiment-detection-job`. **AWS CLI** **So halten Sie einen asynchronen Auftrag zur Erkennung von Stimmungen an** Im folgenden Beispiel für `stop-sentiment-detection-job` wird ein laufender asynchroner Auftrag zur Stimmungserkennung angehalten. Wenn der aktuelle Auftragsstatus `IN_PROGRESS` lautet, wird der Auftrag zur Beendigung markiert und in den Status `STOP_REQUESTED` versetzt. Wenn der Auftrag abgeschlossen ist, bevor er angehalten werden kann, wird er in den Status `COMPLETED` versetzt. ``` aws comprehend stop-sentiment-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE, "JobStatus": "STOP_REQUESTED" } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StopSentimentDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/stop-sentiment-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-targeted-sentiment-detection-job` Das folgende Codebeispiel zeigt die Verwendung`stop-targeted-sentiment-detection-job`. **AWS CLI** **So halten Sie einen asynchronen Auftrag zur Erkennung von zielgerichteten Stimmungen an** Im folgenden Beispiel für `stop-targeted-sentiment-detection-job` wird ein laufender asynchroner Auftrag zur Erkennung von zielgerichteten Stimmungen angehalten. Wenn der aktuelle Auftragsstatus `IN_PROGRESS` lautet, wird der Auftrag zur Beendigung markiert und in den Status `STOP_REQUESTED` versetzt. Wenn der Auftrag abgeschlossen ist, bevor er angehalten werden kann, wird er in den Status `COMPLETED` versetzt. ``` aws comprehend stop-targeted-sentiment-detection-job \ --job-id 123456abcdeb0e11022f22a11EXAMPLE ``` Ausgabe: ``` { "JobId": "123456abcdeb0e11022f22a11EXAMPLE, "JobStatus": "STOP_REQUESTED" } ``` Weitere Informationen finden Sie unter [Asynchrone Analyse für Amazon-Comprehend-Erkenntnisse](https://docs.aws.amazon.com/comprehend/latest/dg/api-async-insights.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StopTargetedSentimentDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/stop-targeted-sentiment-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-training-document-classifier` Das folgende Codebeispiel zeigt die Verwendung`stop-training-document-classifier`. **AWS CLI** **So halten Sie das Training eines Dokumentenklassifizierungsmodells an** Im folgenden Beispiel für `stop-training-document-classifier` wird das laufende Training eines Dokumentenklassifizierungsmodells angehalten. ``` aws comprehend stop-training-document-classifier --document-classifier-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen und Verwalten von benutzerdefinierten Modellen](https://docs.aws.amazon.com/comprehend/latest/dg/manage-models.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StopTrainingDocumentClassifier](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/stop-training-document-classifier.html)in der *AWS CLI Befehlsreferenz*. ### `stop-training-entity-recognizer` Das folgende Codebeispiel zeigt die Verwendung`stop-training-entity-recognizer`. **AWS CLI** **So halten Sie das Training eines Entitätserkennungsmodells an** Im folgenden Beispiel für `stop-training-entity-recognizer` wird das laufende Training eines Entitätserkennungsmodells angehalten. ``` aws comprehend stop-training-entity-recognizer --entity-recognizer-arn "arn:aws:comprehend:us-west-2:111122223333:entity-recognizer/examplerecognizer1" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen und Verwalten von benutzerdefinierten Modellen](https://docs.aws.amazon.com/comprehend/latest/dg/manage-models.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [StopTrainingEntityRecognizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/stop-training-entity-recognizer.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Beispiel 1: So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird einer Amazon-Comprehend-Ressource ein einzelnes Tag hinzugefügt. ``` aws comprehend tag-resource \ --resource-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1 \ --tags Key=Location,Value=Seattle ``` Dieser Befehl hat keine Ausgabe. Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/comprehend/latest/dg/tagging.html) im *Entwicklerhandbuch für Amazon Comprehend*. **Beispiel 2: So fügen Sie einer Ressource mehrere Tags hinzu** Im folgenden Beispiel für `tag-resource` werden einer Amazon-Comprehend-Ressource mehrere Tags hinzugefügt. ``` aws comprehend tag-resource \ --resource-arn "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1" \ --tags Key=location,Value=Seattle Key=Department,Value=Finance ``` Dieser Befehl hat keine Ausgabe. Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/comprehend/latest/dg/tagging.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Beispiel 1: So entfernen Sie ein einzelnes Tag aus einer Ressource** Im folgenden Beispiel für `untag-resource` wird ein einzelnes Tag aus einer Amazon-Comprehend-Ressource entfernt. ``` aws comprehend untag-resource \ --resource-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1 --tag-keys Location ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/comprehend/latest/dg/tagging.html) im *Entwicklerhandbuch für Amazon Comprehend*. **Beispiel 2: So entfernen Sie mehrere Tags aus einer Ressource** Im folgenden Beispiel für `untag-resource` werden mehrere Tags aus einer Amazon-Comprehend-Ressource entfernt. ``` aws comprehend untag-resource \ --resource-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/1 --tag-keys Location Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/comprehend/latest/dg/tagging.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-endpoint` Das folgende Codebeispiel zeigt die Verwendung`update-endpoint`. **AWS CLI** **Beispiel 1: So aktualisieren Sie die Inferenzeinheiten eines Endpunkts** Im folgenden Beispiel für `update-endpoint` werden Informationen über einen Endpunkt aktualisiert. In diesem Beispiel wird die Anzahl der Inferenzeinheiten erhöht. ``` aws comprehend update-endpoint \ --endpoint-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier-endpoint/example-classifier-endpoint --desired-inference-units 2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Amazon-Comprehend-Endpunkten](https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html) im *Entwicklerhandbuch für Amazon Comprehend*. **Beispiel 2: So aktualisieren Sie das aktive Modell eines Endpunkts** Im folgenden Beispiel für `update-endpoint` werden Informationen über einen Endpunkt aktualisiert. In diesem Beispiel wird das aktive Modell geändert. ``` aws comprehend update-endpoint \ --endpoint-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier-endpoint/example-classifier-endpoint --active-model-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier-new ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Amazon-Comprehend-Endpunkten](https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [UpdateEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/update-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `update-flywheel` Das folgende Codebeispiel zeigt die Verwendung`update-flywheel`. **AWS CLI** **So aktualisieren Sie eine Schwungradkonfiguration** Im folgenden Beispiel für `update-flywheel` wird eine Schwungradkonfiguration aktualisiert. In diesem Beispiel wird das aktive Modell für das Schwungrad aktualisiert. ``` aws comprehend update-flywheel \ --flywheel-arn arn:aws:comprehend:us-west-2:111122223333:flywheel/example-flywheel-1 \ --active-model-arn arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/new-example-classifier-model ``` Ausgabe: ``` { "FlywheelProperties": { "FlywheelArn": "arn:aws:comprehend:us-west-2:111122223333:flywheel/flywheel-entity", "ActiveModelArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/example-classifier/version/new-example-classifier-model", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role", "TaskConfig": { "LanguageCode": "en", "DocumentClassificationConfig": { "Mode": "MULTI_CLASS" } }, "DataLakeS3Uri": "s3://amzn-s3-demo-bucket/flywheel-entity/schemaVersion=1/20230616T200543Z/", "DataSecurityConfig": {}, "Status": "ACTIVE", "ModelType": "DOCUMENT_CLASSIFIER", "CreationTime": "2023-06-16T20:05:43.242000+00:00", "LastModifiedTime": "2023-06-19T04:00:43.027000+00:00", "LatestFlywheelIteration": "20230619T040032Z" } } ``` Weitere Informationen finden Sie unter [Schwungrad-Übersicht](https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) im *Entwicklerhandbuch für Amazon Comprehend*. + Einzelheiten zur API finden Sie [UpdateFlywheel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/update-flywheel.html)in der *AWS CLI Befehlsreferenz*. # Beispiele von Amazon Comprehend Medical mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Comprehend Medical Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `describe-entities-detection-v2-job` Das folgende Codebeispiel zeigt die Verwendung von. `describe-entities-detection-v2-job` **AWS CLI** **So beschreiben Sie einen Auftrag zur Erkennung von Entitäten** Im folgenden Beispiel für `describe-entities-detection-v2-job` werden die Eigenschaften eines asynchronen Entitätserkennungsauftrags angezeigt. ``` aws comprehendmedical describe-entities-detection-v2-job \ --job-id "ab9887877365fe70299089371c043b96" ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobProperties": { "JobId": "ab9887877365fe70299089371c043b96", "JobStatus": "COMPLETED", "SubmitTime": "2020-03-18T21:20:15.614000+00:00", "EndTime": "2020-03-18T21:27:07.350000+00:00", "ExpirationTime": "2020-07-16T21:20:15+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "867139942017-EntitiesDetection-ab9887877365fe70299089371c043b96/" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "DetectEntitiesModelV20190930" } } ``` Weitere Informationen finden Sie unter [Batch APIs](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-batchapi.html) im *Amazon Comprehend Medical Developer Guide*. + *API-Details finden Sie unter [DescribeEntitiesDetectionV2Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/describe-entities-detection-v2-job.html) in der Befehlsreferenz.AWS CLI * ### `describe-icd10-cm-inference-job` Das folgende Codebeispiel zeigt die Verwendung. `describe-icd10-cm-inference-job` **AWS CLI** **So beschreiben Sie einen ICD-10-CM-Inferenzauftrag** Im folgenden Beispiel für `describe-icd10-cm-inference-job` werden die Eigenschaften des angeforderten Inferenzauftrags mit der angegebenen Auftrags-ID beschrieben. ``` aws comprehendmedical describe-icd10-cm-inference-job \ --job-id "5780034166536cdb52ffa3295a1b00a7" ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobProperties": { "JobId": "5780034166536cdb52ffa3295a1b00a7", "JobStatus": "COMPLETED", "SubmitTime": "2020-05-18T21:20:15.614000+00:00", "EndTime": "2020-05-18T21:27:07.350000+00:00", "ExpirationTime": "2020-09-16T21:20:15+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "0.1.0" } } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie unter [DescribeIcd10 CmInferenceJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/describe-icd10-cm-inference-job.html) in der *AWS CLI Befehlsreferenz*. ### `describe-phi-detection-job` Das folgende Codebeispiel zeigt, wie Sie es verwenden`describe-phi-detection-job`. **AWS CLI** **So beschreiben Sie einen PHI-Erkennungsauftrag** Im folgenden Beispiel für `describe-phi-detection-job` werden die Eigenschaften eines asynchronen Auftrags zur Erkennung geschützter Gesundheitsinformationen (PHI) angezeigt. ``` aws comprehendmedical describe-phi-detection-job \ --job-id "4750034166536cdb52ffa3295a1b00a3" ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobProperties": { "JobId": "4750034166536cdb52ffa3295a1b00a3", "JobStatus": "COMPLETED", "SubmitTime": "2020-03-19T20:38:37.594000+00:00", "EndTime": "2020-03-19T20:45:07.894000+00:00", "ExpirationTime": "2020-07-17T20:38:37+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "867139942017-PHIDetection-4750034166536cdb52ffa3295a1b00a3/" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "PHIModelV20190903" } } ``` Weitere Informationen finden Sie unter [Batch APIs](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-batchapi.html) im *Amazon Comprehend Medical Developer Guide*. + Einzelheiten zur API finden Sie [DescribePhiDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/describe-phi-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-rx-norm-inference-job` Das folgende Codebeispiel zeigt die Verwendung`describe-rx-norm-inference-job`. **AWS CLI** **Um einen RxNorm Inferenzjob zu beschreiben** Im folgenden Beispiel für `describe-rx-norm-inference-job` werden die Eigenschaften des angeforderten Inferenzauftrags mit der angegebenen Auftrags-ID beschrieben. ``` aws comprehendmedical describe-rx-norm-inference-job \ --job-id "eg8199877365fc70299089371c043b96" ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobProperties": { "JobId": "g8199877365fc70299089371c043b96", "JobStatus": "COMPLETED", "SubmitTime": "2020-05-18T21:20:15.614000+00:00", "EndTime": "2020-05-18T21:27:07.350000+00:00", "ExpirationTime": "2020-09-16T21:20:15+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "0.0.0" } } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie [DescribeRxNormInferenceJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/describe-rx-norm-inference-job.html)in der *AWS CLI Befehlsreferenz.* ### `describe-snomedct-inference-job` Das folgende Codebeispiel zeigt die Verwendung`describe-snomedct-inference-job`. **AWS CLI** **So beschreiben Sie einen SNOMED-CT-Inferenzauftrag** Im folgenden Beispiel für `describe-snomedct-inference-job` werden die Eigenschaften des angeforderten Inferenzauftrags mit der angegebenen Auftrags-ID beschrieben. ``` aws comprehendmedical describe-snomedct-inference-job \ --job-id "2630034166536cdb52ffa3295a1b00a7" ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobProperties": { "JobId": "2630034166536cdb52ffa3295a1b00a7", "JobStatus": "COMPLETED", "SubmitTime": "2021-12-18T21:20:15.614000+00:00", "EndTime": "2021-12-18T21:27:07.350000+00:00", "ExpirationTime": "2022-05-16T21:20:15+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "0.1.0" } } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie [DescribeSnomedctInferenceJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/describe-snomedct-inference-job.html)in der *AWS CLI Befehlsreferenz*. ### `detect-entities-v2` Das folgende Codebeispiel zeigt die Verwendung`detect-entities-v2`. **AWS CLI** **Beispiel 1: So erkennen Sie Entitäten direkt anhand des Texts** Das folgende Beispiel für `detect-entities-v2` zeigt die erkannten Entitäten und kennzeichnet sie direkt anhand des Eingabetexts nach Typ. ``` aws comprehendmedical detect-entities-v2 \ --text "Sleeping trouble on present dosage of Clonidine. Severe rash on face and leg, slightly itchy." ``` Ausgabe: ``` { "Id": 0, "BeginOffset": 38, "EndOffset": 47, "Score": 0.9942955374717712, "Text": "Clonidine", "Category": "MEDICATION", "Type": "GENERIC_NAME", "Traits": [] } ``` Weitere Informationen finden Sie unter [Detect Entities Version 2](https://docs.aws.amazon.com/comprehend/latest/dg/extracted-med-info-V2.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. **Beispiel 2: So erkennen Sie Entitäten anhand eines Dateipfads** Das folgende Beispiel für `detect-entities-v2` zeigt die erkannten Entitäten und kennzeichnet sie anhand eines Dateipfads nach Typ. ``` aws comprehendmedical detect-entities-v2 \ --text file://medical_entities.txt ``` Inhalt von `medical_entities.txt`: ``` { "Sleeping trouble on present dosage of Clonidine. Severe rash on face and leg, slightly itchy." } ``` Ausgabe: ``` { "Id": 0, "BeginOffset": 38, "EndOffset": 47, "Score": 0.9942955374717712, "Text": "Clonidine", "Category": "MEDICATION", "Type": "GENERIC_NAME", "Traits": [] } ``` Weitere Informationen finden Sie unter [Detect Entities Version 2](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-entitiesv2.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + API-Details finden Sie unter [DetectEntitiesV2](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/detect-entities-v2.html) in der *AWS CLI Befehlsreferenz*. ### `detect-phi` Das folgende Codebeispiel zeigt die Verwendung`detect-phi`. **AWS CLI** **Beispiel 1: So erkennen Sie geschützte Gesundheitsinformationen (PHI) direkt im Text** Im folgenden Beispiel für `detect-phi` werden die erkannten Entitäten geschützter Gesundheitsinformationen (PHI) direkt im Eingabetext angezeigt. ``` aws comprehendmedical detect-phi \ --text "Patient Carlos Salazar presented with rash on his upper extremities and dry cough. He lives at 100 Main Street, Anytown, USA where he works from his home as a carpenter." ``` Ausgabe: ``` { "Entities": [ { "Id": 0, "BeginOffset": 8, "EndOffset": 21, "Score": 0.9914507269859314, "Text": "Carlos Salazar", "Category": "PROTECTED_HEALTH_INFORMATION", "Type": "NAME", "Traits": [] }, { "Id": 1, "BeginOffset": 94, "EndOffset": 109, "Score": 0.871849775314331, "Text": "100 Main Street, Anytown, USA", "Category": "PROTECTED_HEALTH_INFORMATION", "Type": "ADDRESS", "Traits": [] }, { "Id": 2, "BeginOffset": 145, "EndOffset": 154, "Score": 0.8302185535430908, "Text": "carpenter", "Category": "PROTECTED_HEALTH_INFORMATION", "Type": "PROFESSION", "Traits": [] } ], "ModelVersion": "0.0.0" } ``` Weitere Informationen finden Sie unter [Detect PHI](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-phi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. **Beispiel 2: So erkennen Sie geschützte Gesundheitsinformationen (PHI) direkt anhand eines Dateipfads** Im folgenden Beispiel für `detect-phi` werden die erkannten Entitäten geschützter Gesundheitsinformationen (PHI) anhand eines Dateipfads angezeigt. ``` aws comprehendmedical detect-phi \ --text file://phi.txt ``` Inhalt von `phi.txt`: ``` "Patient Carlos Salazar presented with a rash on his upper extremities and a dry cough. He lives at 100 Main Street, Anytown, USA, where he works from his home as a carpenter." ``` Ausgabe: ``` { "Entities": [ { "Id": 0, "BeginOffset": 8, "EndOffset": 21, "Score": 0.9914507269859314, "Text": "Carlos Salazar", "Category": "PROTECTED_HEALTH_INFORMATION", "Type": "NAME", "Traits": [] }, { "Id": 1, "BeginOffset": 94, "EndOffset": 109, "Score": 0.871849775314331, "Text": "100 Main Street, Anytown, USA", "Category": "PROTECTED_HEALTH_INFORMATION", "Type": "ADDRESS", "Traits": [] }, { "Id": 2, "BeginOffset": 145, "EndOffset": 154, "Score": 0.8302185535430908, "Text": "carpenter", "Category": "PROTECTED_HEALTH_INFORMATION", "Type": "PROFESSION", "Traits": [] } ], "ModelVersion": "0.0.0" } ``` Weitere Informationen finden Sie unter [Detect PHI](https://docs.aws.amazon.com/comprehend/latest/dg/how-medical-phi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie [DetectPhi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/detect-phi.html)in der *AWS CLI Befehlsreferenz*. ### `infer-icd10-cm` Das folgende Codebeispiel zeigt die Verwendung`infer-icd10-cm`. **AWS CLI** **Beispiel 1: So erkennen Sie Entitäten für medizinische Erkrankungen und verknüpfen sie direkt anhand des Texts mit der ICD-10-CM-Ontologie** Im folgenden Beispiel für `infer-icd10-cm` werden die Entitäten für den erkannten Gesundheitszustand gekennzeichnet und diese Entitäten mit Codes in der Ausgabe 2019 der International Classification of Diseases Clinical Modification (ICD-10-CM) verknüpft. ``` aws comprehendmedical infer-icd10-cm \ --text "The patient complains of abdominal pain, has a long-standing history of diabetes treated with Micronase daily." ``` Ausgabe: ``` { "Entities": [ { "Id": 0, "Text": "abdominal pain", "Category": "MEDICAL_CONDITION", "Type": "DX_NAME", "Score": 0.9475538730621338, "BeginOffset": 28, "EndOffset": 42, "Attributes": [], "Traits": [ { "Name": "SYMPTOM", "Score": 0.6724207401275635 } ], "ICD10CMConcepts": [ { "Description": "Unspecified abdominal pain", "Code": "R10.9", "Score": 0.6904221177101135 }, { "Description": "Epigastric pain", "Code": "R10.13", "Score": 0.1364113688468933 }, { "Description": "Generalized abdominal pain", "Code": "R10.84", "Score": 0.12508003413677216 }, { "Description": "Left lower quadrant pain", "Code": "R10.32", "Score": 0.10063883662223816 }, { "Description": "Lower abdominal pain, unspecified", "Code": "R10.30", "Score": 0.09933677315711975 } ] }, { "Id": 1, "Text": "diabetes", "Category": "MEDICAL_CONDITION", "Type": "DX_NAME", "Score": 0.9899052977561951, "BeginOffset": 75, "EndOffset": 83, "Attributes": [], "Traits": [ { "Name": "DIAGNOSIS", "Score": 0.9258432388305664 } ], "ICD10CMConcepts": [ { "Description": "Type 2 diabetes mellitus without complications", "Code": "E11.9", "Score": 0.7158446311950684 }, { "Description": "Family history of diabetes mellitus", "Code": "Z83.3", "Score": 0.5704703330993652 }, { "Description": "Family history of other endocrine, nutritional and metabolic diseases", "Code": "Z83.49", "Score": 0.19856023788452148 }, { "Description": "Type 1 diabetes mellitus with ketoacidosis without coma", "Code": "E10.10", "Score": 0.13285516202449799 }, { "Description": "Type 2 diabetes mellitus with hyperglycemia", "Code": "E11.65", "Score": 0.0993388369679451 } ] } ], "ModelVersion": "0.1.0" } ``` Weitere Informationen finden Sie unter [Infer ICD10 -CM](https://docs.aws.amazon.com/comprehend/latest/dg/ontology-linking-icd10.html) im *Amazon Comprehend* Medical Developer Guide. **Beispiel 2: So erkennen Sie Entitäten für medizinische Erkrankungen und verknüpfen sie anhand eines Dateipfads mit der ICD-10-CM-Ontologie** Im folgenden Beispiel für `infer-icd-10-cm` werden die Entitäten für den erkannten Gesundheitszustand gekennzeichnet und diese Entitäten mit Codes in der Ausgabe 2019 der International Classification of Diseases Clinical Modification (ICD-10-CM) verknüpft. ``` aws comprehendmedical infer-icd10-cm \ --text file://icd10cm.txt ``` Inhalt von `icd10cm.txt`: ``` { "The patient complains of abdominal pain, has a long-standing history of diabetes treated with Micronase daily." } ``` Ausgabe: ``` { "Entities": [ { "Id": 0, "Text": "abdominal pain", "Category": "MEDICAL_CONDITION", "Type": "DX_NAME", "Score": 0.9475538730621338, "BeginOffset": 28, "EndOffset": 42, "Attributes": [], "Traits": [ { "Name": "SYMPTOM", "Score": 0.6724207401275635 } ], "ICD10CMConcepts": [ { "Description": "Unspecified abdominal pain", "Code": "R10.9", "Score": 0.6904221177101135 }, { "Description": "Epigastric pain", "Code": "R10.13", "Score": 0.1364113688468933 }, { "Description": "Generalized abdominal pain", "Code": "R10.84", "Score": 0.12508003413677216 }, { "Description": "Left lower quadrant pain", "Code": "R10.32", "Score": 0.10063883662223816 }, { "Description": "Lower abdominal pain, unspecified", "Code": "R10.30", "Score": 0.09933677315711975 } ] }, { "Id": 1, "Text": "diabetes", "Category": "MEDICAL_CONDITION", "Type": "DX_NAME", "Score": 0.9899052977561951, "BeginOffset": 75, "EndOffset": 83, "Attributes": [], "Traits": [ { "Name": "DIAGNOSIS", "Score": 0.9258432388305664 } ], "ICD10CMConcepts": [ { "Description": "Type 2 diabetes mellitus without complications", "Code": "E11.9", "Score": 0.7158446311950684 }, { "Description": "Family history of diabetes mellitus", "Code": "Z83.3", "Score": 0.5704703330993652 }, { "Description": "Family history of other endocrine, nutritional and metabolic diseases", "Code": "Z83.49", "Score": 0.19856023788452148 }, { "Description": "Type 1 diabetes mellitus with ketoacidosis without coma", "Code": "E10.10", "Score": 0.13285516202449799 }, { "Description": "Type 2 diabetes mellitus with hyperglycemia", "Code": "E11.65", "Score": 0.0993388369679451 } ] } ], "ModelVersion": "0.1.0" } ``` Weitere Informationen finden Sie unter [Infer- ICD10 -CM](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontology-icd10.html) im *Amazon Comprehend* Medical Developer Guide. + *Einzelheiten zur API finden Sie unter [InferIcd10Cm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/infer-icd10-cm.html) in der Befehlsreferenz.AWS CLI * ### `infer-rx-norm` Das folgende Codebeispiel zeigt die Verwendung`infer-rx-norm`. **AWS CLI** **Beispiel 1: Um Entitäten von Medikamenten zu erkennen und RxNorm direkt aus dem Text zu verlinken** Das folgende `infer-rx-norm` Beispiel zeigt und beschriftet die erkannten Arzneimittelentitäten und verknüpft diese Entitäten mit Konzeptkennungen (RxCUI) aus der Datenbank der National Library of Medicine. RxNorm ``` aws comprehendmedical infer-rx-norm \ --text "Patient reports taking Levothyroxine 125 micrograms p.o. once daily, but denies taking Synthroid." ``` Ausgabe: ``` { "Entities": [ { "Id": 0, "Text": "Levothyroxine", "Category": "MEDICATION", "Type": "GENERIC_NAME", "Score": 0.9996285438537598, "BeginOffset": 23, "EndOffset": 36, "Attributes": [ { "Type": "DOSAGE", "Score": 0.9892290830612183, "RelationshipScore": 0.9997978806495667, "Id": 1, "BeginOffset": 37, "EndOffset": 51, "Text": "125 micrograms", "Traits": [] }, { "Type": "ROUTE_OR_MODE", "Score": 0.9988924860954285, "RelationshipScore": 0.998291552066803, "Id": 2, "BeginOffset": 52, "EndOffset": 56, "Text": "p.o.", "Traits": [] }, { "Type": "FREQUENCY", "Score": 0.9953463673591614, "RelationshipScore": 0.9999889135360718, "Id": 3, "BeginOffset": 57, "EndOffset": 67, "Text": "once daily", "Traits": [] } ], "Traits": [], "RxNormConcepts": [ { "Description": "Levothyroxine Sodium 0.125 MG Oral Tablet", "Code": "966224", "Score": 0.9912070631980896 }, { "Description": "Levothyroxine Sodium 0.125 MG Oral Capsule", "Code": "966405", "Score": 0.8698278665542603 }, { "Description": "Levothyroxine Sodium 0.125 MG Oral Tablet [Synthroid]", "Code": "966191", "Score": 0.7448257803916931 }, { "Description": "levothyroxine", "Code": "10582", "Score": 0.7050482630729675 }, { "Description": "Levothyroxine Sodium 0.125 MG Oral Tablet [Levoxyl]", "Code": "966190", "Score": 0.6921631693840027 } ] }, { "Id": 4, "Text": "Synthroid", "Category": "MEDICATION", "Type": "BRAND_NAME", "Score": 0.9946461319923401, "BeginOffset": 86, "EndOffset": 95, "Attributes": [], "Traits": [ { "Name": "NEGATION", "Score": 0.5167351961135864 } ], "RxNormConcepts": [ { "Description": "Synthroid", "Code": "224920", "Score": 0.9462039470672607 }, { "Description": "Levothyroxine Sodium 0.088 MG Oral Tablet [Synthroid]", "Code": "966282", "Score": 0.8309829235076904 }, { "Description": "Levothyroxine Sodium 0.125 MG Oral Tablet [Synthroid]", "Code": "966191", "Score": 0.4945160448551178 }, { "Description": "Levothyroxine Sodium 0.05 MG Oral Tablet [Synthroid]", "Code": "966247", "Score": 0.3674522042274475 }, { "Description": "Levothyroxine Sodium 0.025 MG Oral Tablet [Synthroid]", "Code": "966158", "Score": 0.2588822841644287 } ] } ], "ModelVersion": "0.0.0" } ``` Weitere Informationen finden Sie unter [Infer RxNorm](https://docs.aws.amazon.com/comprehend/latest/dg/ontology-linking-rxnorm.html) im *Amazon Comprehend Medical* Developer Guide. **Beispiel 2: Um Entitäten für Medikamente zu erkennen und von einem Dateipfad RxNorm aus eine Verknüpfung herzustellen.** Das folgende `infer-rx-norm` Beispiel zeigt und beschriftet die erkannten Arzneimittelentitäten und verknüpft diese Entitäten mit Konzeptkennungen (RxCUI) aus der Datenbank der National Library of Medicine. RxNorm ``` aws comprehendmedical infer-rx-norm \ --text file://rxnorm.txt ``` Inhalt von `rxnorm.txt`: ``` { "Patient reports taking Levothyroxine 125 micrograms p.o. once daily, but denies taking Synthroid." } ``` Ausgabe: ``` { "Entities": [ { "Id": 0, "Text": "Levothyroxine", "Category": "MEDICATION", "Type": "GENERIC_NAME", "Score": 0.9996285438537598, "BeginOffset": 23, "EndOffset": 36, "Attributes": [ { "Type": "DOSAGE", "Score": 0.9892290830612183, "RelationshipScore": 0.9997978806495667, "Id": 1, "BeginOffset": 37, "EndOffset": 51, "Text": "125 micrograms", "Traits": [] }, { "Type": "ROUTE_OR_MODE", "Score": 0.9988924860954285, "RelationshipScore": 0.998291552066803, "Id": 2, "BeginOffset": 52, "EndOffset": 56, "Text": "p.o.", "Traits": [] }, { "Type": "FREQUENCY", "Score": 0.9953463673591614, "RelationshipScore": 0.9999889135360718, "Id": 3, "BeginOffset": 57, "EndOffset": 67, "Text": "once daily", "Traits": [] } ], "Traits": [], "RxNormConcepts": [ { "Description": "Levothyroxine Sodium 0.125 MG Oral Tablet", "Code": "966224", "Score": 0.9912070631980896 }, { "Description": "Levothyroxine Sodium 0.125 MG Oral Capsule", "Code": "966405", "Score": 0.8698278665542603 }, { "Description": "Levothyroxine Sodium 0.125 MG Oral Tablet [Synthroid]", "Code": "966191", "Score": 0.7448257803916931 }, { "Description": "levothyroxine", "Code": "10582", "Score": 0.7050482630729675 }, { "Description": "Levothyroxine Sodium 0.125 MG Oral Tablet [Levoxyl]", "Code": "966190", "Score": 0.6921631693840027 } ] }, { "Id": 4, "Text": "Synthroid", "Category": "MEDICATION", "Type": "BRAND_NAME", "Score": 0.9946461319923401, "BeginOffset": 86, "EndOffset": 95, "Attributes": [], "Traits": [ { "Name": "NEGATION", "Score": 0.5167351961135864 } ], "RxNormConcepts": [ { "Description": "Synthroid", "Code": "224920", "Score": 0.9462039470672607 }, { "Description": "Levothyroxine Sodium 0.088 MG Oral Tablet [Synthroid]", "Code": "966282", "Score": 0.8309829235076904 }, { "Description": "Levothyroxine Sodium 0.125 MG Oral Tablet [Synthroid]", "Code": "966191", "Score": 0.4945160448551178 }, { "Description": "Levothyroxine Sodium 0.05 MG Oral Tablet [Synthroid]", "Code": "966247", "Score": 0.3674522042274475 }, { "Description": "Levothyroxine Sodium 0.025 MG Oral Tablet [Synthroid]", "Code": "966158", "Score": 0.2588822841644287 } ] } ], "ModelVersion": "0.0.0" } ``` Weitere Informationen finden Sie unter [Infer RxNorm](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontology-RxNorm.html) im *Amazon Comprehend Medical* Developer Guide. + *Einzelheiten zur API finden Sie [InferRxNorm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/infer-rx-norm.html)in AWS CLI der Befehlsreferenz.* ### `infer-snomedct` Das folgende Codebeispiel zeigt die Verwendung`infer-snomedct`. **AWS CLI** **Beispiel: So erkennen Sie Entitäten und verknüpfen sie direkt anhand des Texts mit der SNOMED-CT-Ontologie** Das folgende Beispiel für `infer-snomedct` zeigt, wie medizinische Entitäten erkannt und mit Konzepten aus der Version 2021-03 der Systematized Nomenclature of Medicine, Clinical Terms (SNOMED CT) verknüpft werden. ``` aws comprehendmedical infer-snomedct \ --text "The patient complains of abdominal pain, has a long-standing history of diabetes treated with Micronase daily." ``` Ausgabe: ``` { "Entities": [ { "Id": 3, "BeginOffset": 26, "EndOffset": 40, "Score": 0.9598260521888733, "Text": "abdominal pain", "Category": "MEDICAL_CONDITION", "Type": "DX_NAME", "Traits": [ { "Name": "SYMPTOM", "Score": 0.6819021701812744 } ] }, { "Id": 4, "BeginOffset": 73, "EndOffset": 81, "Score": 0.9905840158462524, "Text": "diabetes", "Category": "MEDICAL_CONDITION", "Type": "DX_NAME", "Traits": [ { "Name": "DIAGNOSIS", "Score": 0.9255214333534241 } ] }, { "Id": 1, "BeginOffset": 95, "EndOffset": 104, "Score": 0.6371926665306091, "Text": "Micronase", "Category": "MEDICATION", "Type": "BRAND_NAME", "Traits": [], "Attributes": [ { "Type": "FREQUENCY", "Score": 0.9761165380477905, "RelationshipScore": 0.9984188079833984, "RelationshipType": "FREQUENCY", "Id": 2, "BeginOffset": 105, "EndOffset": 110, "Text": "daily", "Category": "MEDICATION", "Traits": [] } ] } ], "UnmappedAttributes": [], "ModelVersion": "1.0.0" } ``` Weitere Informationen finden Sie unter [InferSNOMEDCT](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontology-linking-snomed.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie [InferSnomedct](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/infer-snomedct.html)in der *AWS CLI Befehlsreferenz*. ### `list-entities-detection-v2-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-entities-detection-v2-jobs`. **AWS CLI** **So listen Sie Aufträge zur Erkennung von Entitäten auf** Im folgenden Beispiel für `list-entities-detection-v2-jobs` werden aktuelle asynchrone Erkennungsaufträge aufgelistet. ``` aws comprehendmedical list-entities-detection-v2-jobs ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobPropertiesList": [ { "JobId": "ab9887877365fe70299089371c043b96", "JobStatus": "COMPLETED", "SubmitTime": "2020-03-19T20:38:37.594000+00:00", "EndTime": "2020-03-19T20:45:07.894000+00:00", "ExpirationTime": "2020-07-17T20:38:37+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "867139942017-EntitiesDetection-ab9887877365fe70299089371c043b96/" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "DetectEntitiesModelV20190930" } ] } ``` Weitere Informationen finden Sie unter [Batch APIs](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-batchapi.html) im *Amazon Comprehend Medical Developer Guide*. + *Einzelheiten zur API finden Sie unter [ListEntitiesDetectionV2Jobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/list-entities-detection-v2-jobs.html) in der Befehlsreferenz.AWS CLI * ### `list-icd10-cm-inference-jobs` Das folgende Codebeispiel zeigt die Verwendung. `list-icd10-cm-inference-jobs` **AWS CLI** **So listen Sie alle aktuellen ICD-10-CM-Inferenzaufträge auf** Das folgende Beispiel zeigt, wie die Operation `list-icd10-cm-inference-jobs` eine Liste aktueller asynchroner ICD-10-CM-Batch-Inferenzaufträge zurückgibt. ``` aws comprehendmedical list-icd10-cm-inference-jobs ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobPropertiesList": [ { "JobId": "5780034166536cdb52ffa3295a1b00a7", "JobStatus": "COMPLETED", "SubmitTime": "2020-05-19T20:38:37.594000+00:00", "EndTime": "2020-05-19T20:45:07.894000+00:00", "ExpirationTime": "2020-09-17T20:38:37+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "0.1.0" } ] } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie unter [ListIcd10 CmInferenceJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/list-icd10-cm-inference-jobs.html) in der *AWS CLI Befehlsreferenz*. ### `list-phi-detection-jobs` Das folgende Codebeispiel zeigt, wie Sie es verwenden`list-phi-detection-jobs`. **AWS CLI** **So listen Sie Erkennungsaufträge für geschützte Gesundheitsinformationen (PHI) auf** Im folgenden Beispiel für `list-phi-detection-jobs` werden aktuelle Erkennungsaufträge für geschützte Gesundheitsinformationen (PHI) aufgeführt ``` aws comprehendmedical list-phi-detection-jobs ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobPropertiesList": [ { "JobId": "4750034166536cdb52ffa3295a1b00a3", "JobStatus": "COMPLETED", "SubmitTime": "2020-03-19T20:38:37.594000+00:00", "EndTime": "2020-03-19T20:45:07.894000+00:00", "ExpirationTime": "2020-07-17T20:38:37+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "867139942017-PHIDetection-4750034166536cdb52ffa3295a1b00a3/" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "PHIModelV20190903" } ] } ``` Weitere Informationen finden Sie unter [Batch APIs](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-batchapi.html) im *Amazon Comprehend Medical Developer Guide*. + Einzelheiten zur API finden Sie [ListPhiDetectionJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/list-phi-detection-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-rx-norm-inference-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-rx-norm-inference-jobs`. **AWS CLI** **So listen Sie alle aktuellen Rx-Norm-Inferenzaufträge auf** Das folgende Beispiel zeigt, wie `list-rx-norm-inference-jobs` eine Liste aktueller asynchroner Rx-Norm-Batch-Inferenzaufträge zurückgibt. ``` aws comprehendmedical list-rx-norm-inference-jobs ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobPropertiesList": [ { "JobId": "4980034166536cfb52gga3295a1b00a3", "JobStatus": "COMPLETED", "SubmitTime": "2020-05-19T20:38:37.594000+00:00", "EndTime": "2020-05-19T20:45:07.894000+00:00", "ExpirationTime": "2020-09-17T20:38:37+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "0.0.0" } ] } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie [ListRxNormInferenceJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/list-rx-norm-inference-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-snomedct-inference-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-snomedct-inference-jobs`. **AWS CLI** **So listen Sie alle SNOMED-CT-Inferenzaufträge auf** Das folgende Beispiel zeigt, wie die Operation `list-snomedct-inference-jobs` eine Liste aktueller asynchroner SNOMED-CT-Batch-Inferenzaufträge zurückgibt. ``` aws comprehendmedical list-snomedct-inference-jobs ``` Ausgabe: ``` { "ComprehendMedicalAsyncJobPropertiesList": [ { "JobId": "5780034166536cdb52ffa3295a1b00a7", "JobStatus": "COMPLETED", "SubmitTime": "2020-05-19T20:38:37.594000+00:00", "EndTime": "2020-05-19T20:45:07.894000+00:00", "ExpirationTime": "2020-09-17T20:38:37+00:00", "InputDataConfig": { "S3Bucket": "comp-med-input", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "OutputDataConfig": { "S3Bucket": "comp-med-output", "S3Key": "AKIAIOSFODNN7EXAMPLE" }, "LanguageCode": "en", "DataAccessRoleArn": "arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole", "ModelVersion": "0.1.0" } ] } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie [ListSnomedctInferenceJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/list-snomedct-inference-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `start-entities-detection-v2-job` Das folgende Codebeispiel zeigt die Verwendung`start-entities-detection-v2-job`. **AWS CLI** **So starten Sie einen Auftrag zur Erkennung von Entitäten** Im folgenden Beispiel für `start-entities-detection-v2-job` wird ein asynchronen Auftrag zur Erkennung von Entitäten gestartet. ``` aws comprehendmedical start-entities-detection-v2-job \ --input-data-config "S3Bucket=comp-med-input" \ --output-data-config "S3Bucket=comp-med-output" \ --data-access-role-arn arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole \ --language-code en ``` Ausgabe: ``` { "JobId": "ab9887877365fe70299089371c043b96" } ``` Weitere Informationen finden Sie unter [Batch APIs](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-batchapi.html) im *Amazon Comprehend Medical Developer Guide*. + *API-Details finden Sie unter [StartEntitiesDetectionV2Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/start-entities-detection-v2-job.html) in der Befehlsreferenz.AWS CLI * ### `start-icd10-cm-inference-job` Das folgende Codebeispiel zeigt die Verwendung. `start-icd10-cm-inference-job` **AWS CLI** **So starten Sie einen ICD-10-CM-Inferenzauftrag** Im folgenden Beispiel für `start-icd10-cm-inference-job` wird ein Inferenz-Batch-Analyseauftrag für ICD-10-CM gestartet. ``` aws comprehendmedical start-icd10-cm-inference-job \ --input-data-config "S3Bucket=comp-med-input" \ --output-data-config "S3Bucket=comp-med-output" \ --data-access-role-arn arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole \ --language-code en ``` Ausgabe: ``` { "JobId": "ef7289877365fc70299089371c043b96" } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie unter [StartIcd10 CmInferenceJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/start-icd10-cm-inference-job.html) in der *AWS CLI Befehlsreferenz*. ### `start-phi-detection-job` Das folgende Codebeispiel zeigt, wie Sie es verwenden`start-phi-detection-job`. **AWS CLI** **So starten Sie einen PHI-Erkennungsauftrag** Im folgenden Beispiel für `start-phi-detection-job` wird ein asynchronen Auftrag zur Erkennung von PHI-Entitäten gestartet. ``` aws comprehendmedical start-phi-detection-job \ --input-data-config "S3Bucket=comp-med-input" \ --output-data-config "S3Bucket=comp-med-output" \ --data-access-role-arn arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole \ --language-code en ``` Ausgabe: ``` { "JobId": "ab9887877365fe70299089371c043b96" } ``` Weitere Informationen finden Sie unter [Batch APIs](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-batchapi.html) im *Amazon Comprehend Medical Developer Guide*. + Einzelheiten zur API finden Sie [StartPhiDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/start-phi-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-rx-norm-inference-job` Das folgende Codebeispiel zeigt die Verwendung`start-rx-norm-inference-job`. **AWS CLI** **Um einen RxNorm Inferenzjob zu starten** Im folgenden `start-rx-norm-inference-job` Beispiel wird ein Auftrag zur Batch-Analyse von RxNorm Inferenzen gestartet. ``` aws comprehendmedical start-rx-norm-inference-job \ --input-data-config "S3Bucket=comp-med-input" \ --output-data-config "S3Bucket=comp-med-output" \ --data-access-role-arn arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole \ --language-code en ``` Ausgabe: ``` { "JobId": "eg8199877365fc70299089371c043b96" } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie unter [StartRxNormInferenceJob AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/start-rx-norm-inference-job.html)*Befehlsreferenz.* ### `start-snomedct-inference-job` Das folgende Codebeispiel zeigt die Verwendung`start-snomedct-inference-job`. **AWS CLI** **So starten Sie einen SNOMED-CT-Inferenzauftrag** Im folgenden Beispiel für `start-snomedct-inference-job` wird ein Inferenz-Batch-Analyseauftrag für SNOMED CT gestartet. ``` aws comprehendmedical start-snomedct-inference-job \ --input-data-config "S3Bucket=comp-med-input" \ --output-data-config "S3Bucket=comp-med-output" \ --data-access-role-arn arn:aws:iam::867139942017:role/ComprehendMedicalBatchProcessingRole \ --language-code en ``` Ausgabe: ``` { "JobId": "dg7289877365fc70299089371c043b96" } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie [StartSnomedctInferenceJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/start-snomedct-inference-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-entities-detection-v2-job` Das folgende Codebeispiel zeigt die Verwendung`stop-entities-detection-v2-job`. **AWS CLI** **So halten Sie einen Auftrag zur Erkennung von Entitäten an** Im folgenden Beispiel für `stop-entities-detection-v2-job` wird ein asynchronen Auftrag zur Erkennung von Entitäten angehalten. ``` aws comprehendmedical stop-entities-detection-v2-job \ --job-id "ab9887877365fe70299089371c043b96" ``` Ausgabe: ``` { "JobId": "ab9887877365fe70299089371c043b96" } ``` Weitere Informationen finden Sie unter [Batch APIs](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-batchapi.html) im *Amazon Comprehend Medical Developer Guide*. + *API-Details finden Sie unter [StopEntitiesDetectionV2Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/stop-entities-detection-v2-job.html) in der Befehlsreferenz.AWS CLI * ### `stop-icd10-cm-inference-job` Das folgende Codebeispiel zeigt die Verwendung. `stop-icd10-cm-inference-job` **AWS CLI** **So halten Sie einen ICD-10-CM-Inferenzauftrag an** Im folgenden Beispiel für `stop-icd10-cm-inference-job` wird ein Inferenz-Batch-Analyseauftrag für ICD-10-CM angehalten. ``` aws comprehendmedical stop-icd10-cm-inference-job \ --job-id "4750034166536cdb52ffa3295a1b00a3" ``` Ausgabe: ``` { "JobId": "ef7289877365fc70299089371c043b96", } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie unter [StopIcd10 CmInferenceJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/stop-icd10-cm-inference-job.html) in der *AWS CLI Befehlsreferenz*. ### `stop-phi-detection-job` Das folgende Codebeispiel zeigt, wie Sie es verwenden`stop-phi-detection-job`. **AWS CLI** **So halten Sie einen Erkennungsauftrag für geschützte Gesundheitsinformationen (PHI) an** Im folgenden Beispiel für `stop-phi-detection-job` wird ein asynchroner Auftrag zur Erkennung geschützter Gesundheitsinformationen (PHI) angehalten. ``` aws comprehendmedical stop-phi-detection-job \ --job-id "4750034166536cdb52ffa3295a1b00a3" ``` Ausgabe: ``` { "JobId": "ab9887877365fe70299089371c043b96" } ``` Weitere Informationen finden Sie unter [Batch APIs](https://docs.aws.amazon.com/comprehend-medical/latest/dev/textanalysis-batchapi.html) im *Amazon Comprehend Medical Developer Guide*. + Einzelheiten zur API finden Sie [StopPhiDetectionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/stop-phi-detection-job.html)in der *AWS CLI Befehlsreferenz*. ### `stop-rx-norm-inference-job` Das folgende Codebeispiel zeigt die Verwendung`stop-rx-norm-inference-job`. **AWS CLI** **Um einen RxNorm Inferenzjob zu beenden** Im folgenden Beispiel für `stop-rx-norm-inference-job` wird ein Inferenz-Batch-Analyseauftrag für ICD-10-CM angehalten. ``` aws comprehendmedical stop-rx-norm-inference-job \ --job-id "eg8199877365fc70299089371c043b96" ``` Ausgabe: ``` { "JobId": "eg8199877365fc70299089371c043b96", } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie [StopRxNormInferenceJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/stop-rx-norm-inference-job.html)in der *AWS CLI Befehlsreferenz.* ### `stop-snomedct-inference-job` Das folgende Codebeispiel zeigt die Verwendung`stop-snomedct-inference-job`. **AWS CLI** **So halten Sie einen SNOMED-CT-Inferenzauftrag an** Im folgenden Beispiel für `stop-snomedct-inference-job` wird ein Inferenz-Batch-Analyseauftrag für SNOMED CT angehalten. ``` aws comprehendmedical stop-snomedct-inference-job \ --job-id "8750034166436cdb52ffa3295a1b00a1" ``` Ausgabe: ``` { "JobId": "8750034166436cdb52ffa3295a1b00a1", } ``` Weitere Informationen finden Sie unter [Ontologie zur Verknüpfung von Batch-Analysen](https://docs.aws.amazon.com/comprehend-medical/latest/dev/ontologies-batchapi.html) im *Entwicklerhandbuch für Amazon Comprehend Medical*. + Einzelheiten zur API finden Sie [StopSnomedctInferenceJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehendmedical/stop-snomedct-inference-job.html)in der *AWS CLI Befehlsreferenz*. # AWS Config Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Config. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-config-rule` Das folgende Codebeispiel zeigt, wie Sie`delete-config-rule`. **AWS CLI** **Um eine AWS Config-Regel zu löschen** Der folgende Befehl löscht eine AWS Config-Regel mit dem Namen`MyConfigRule`: ``` aws configservice delete-config-rule --config-rule-name MyConfigRule ``` + Einzelheiten zur API finden Sie [DeleteConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/delete-config-rule.html)in der *AWS CLI Befehlsreferenz.* ### `delete-delivery-channel` Das folgende Codebeispiel zeigt die Verwendung`delete-delivery-channel`. **AWS CLI** **So löschen Sie einen Bereitstellungskanal** Mit dem folgendem Befehl wird der Standard-Bereitstellungskanal gelöscht: ``` aws configservice delete-delivery-channel --delivery-channel-name default ``` + Einzelheiten zur API finden Sie [DeleteDeliveryChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/delete-delivery-channel.html)in der *AWS CLI Befehlsreferenz*. ### `delete-evaluation-results` Das folgende Codebeispiel zeigt die Verwendung`delete-evaluation-results`. **AWS CLI** **Um Bewertungsergebnisse manuell zu löschen** Der folgende Befehl löscht die aktuellen Auswertungsergebnisse für die AWS verwaltete Regel s3-: bucket-versioning-enabled ``` aws configservice delete-evaluation-results --config-rule-name s3-bucket-versioning-enabled ``` + Einzelheiten zur API finden Sie [DeleteEvaluationResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/delete-evaluation-results.html)in der *AWS CLI Befehlsreferenz.* ### `deliver-config-snapshot` Das folgende Codebeispiel zeigt die Verwendung`deliver-config-snapshot`. **AWS CLI** **So stellen Sie einen Konfigurations-Snapshot bereit** Mit dem folgenden Befehl wird ein Konfigurations-Snapshot an den Amazon-S3-Bucket übermittelt, der zum Standard-Bereitstellungskanal gehört: ``` aws configservice deliver-config-snapshot --delivery-channel-name default ``` Ausgabe: ``` { "configSnapshotId": "d0333b00-a683-44af-921e-examplefb794" } ``` + Einzelheiten zur API finden Sie [DeliverConfigSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/deliver-config-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `describe-compliance-by-config-rule` Das folgende Codebeispiel zeigt die Verwendung`describe-compliance-by-config-rule`. **AWS CLI** **Um Compliance-Informationen für Ihre AWS Config-Regeln zu erhalten** Der folgende Befehl gibt Konformitätsinformationen für jede AWS Config-Regel zurück, gegen die eine oder mehrere AWS Ressourcen verstoßen: ``` aws configservice describe-compliance-by-config-rule --compliance-types NON_COMPLIANT ``` In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, wie viele Ressourcen der zugehörigen Regel nicht entsprechen. Die folgende Ausgabe gibt beispielsweise an, dass 3 Ressourcen der Regel mit dem Namen `InstanceTypesAreT2micro` nicht entsprechen. Ausgabe: ``` { "ComplianceByConfigRules": [ { "Compliance": { "ComplianceContributorCount": { "CappedCount": 3, "CapExceeded": false }, "ComplianceType": "NON_COMPLIANT" }, "ConfigRuleName": "InstanceTypesAreT2micro" }, { "Compliance": { "ComplianceContributorCount": { "CappedCount": 10, "CapExceeded": false }, "ComplianceType": "NON_COMPLIANT" }, "ConfigRuleName": "RequiredTagsForVolumes" } ] } ``` + Einzelheiten zur API finden Sie [DescribeComplianceByConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-compliance-by-config-rule.html)unter *AWS CLI Befehlsreferenz*. ### `describe-compliance-by-resource` Das folgende Codebeispiel zeigt die Verwendung`describe-compliance-by-resource`. **AWS CLI** **Um Compliance-Informationen für Ihre AWS Ressourcen zu erhalten** Der folgende Befehl gibt Konformitätsinformationen für jede EC2-Instance zurück, die von AWS Config aufgezeichnet wurde und gegen eine oder mehrere Regeln verstößt: ``` aws configservice describe-compliance-by-resource --resource-type AWS::EC2::Instance --compliance-types NON_COMPLIANT ``` In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, gegen wie viele Regeln die Ressource verstößt. Die folgende Ausgabe gibt beispielsweise an, dass die Instance `i-1a2b3c4d` gegen 2 Regeln verstößt. Ausgabe: ``` { "ComplianceByResources": [ { "ResourceType": "AWS::EC2::Instance", "ResourceId": "i-1a2b3c4d", "Compliance": { "ComplianceContributorCount": { "CappedCount": 2, "CapExceeded": false }, "ComplianceType": "NON_COMPLIANT" } }, { "ResourceType": "AWS::EC2::Instance", "ResourceId": "i-2a2b3c4d ", "Compliance": { "ComplianceContributorCount": { "CappedCount": 3, "CapExceeded": false }, "ComplianceType": "NON_COMPLIANT" } } ] } ``` + Einzelheiten zur API finden Sie [DescribeComplianceByResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-compliance-by-resource.html)in der *AWS CLI Befehlsreferenz*. ### `describe-config-rule-evaluation-status` Das folgende Codebeispiel zeigt die Verwendung`describe-config-rule-evaluation-status`. **AWS CLI** **Um Statusinformationen für eine AWS Config-Regel abzurufen** Der folgende Befehl gibt die Statusinformationen für eine AWS Config-Regel mit dem Namen zurück`MyConfigRule`: ``` aws configservice describe-config-rule-evaluation-status --config-rule-names MyConfigRule ``` Ausgabe: ``` { "ConfigRulesEvaluationStatus": [ { "ConfigRuleArn": "arn:aws:config:us-east-1:123456789012:config-rule/config-rule-abcdef", "FirstActivatedTime": 1450311703.844, "ConfigRuleId": "config-rule-abcdef", "LastSuccessfulInvocationTime": 1450314643.156, "ConfigRuleName": "MyConfigRule" } ] } ``` + Einzelheiten zur API finden Sie [DescribeConfigRuleEvaluationStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-config-rule-evaluation-status.html)in der *AWS CLI Befehlsreferenz*. ### `describe-config-rules` Das folgende Codebeispiel zeigt die Verwendung`describe-config-rules`. **AWS CLI** **Um Details für eine AWS Config-Regel abzurufen** Der folgende Befehl gibt Details für eine AWS Config-Regel mit dem Namen zurück`InstanceTypesAreT2micro`: ``` aws configservice describe-config-rules --config-rule-names InstanceTypesAreT2micro ``` Ausgabe: ``` { "ConfigRules": [ { "ConfigRuleState": "ACTIVE", "Description": "Evaluates whether EC2 instances are the t2.micro type.", "ConfigRuleName": "InstanceTypesAreT2micro", "ConfigRuleArn": "arn:aws:config:us-east-1:123456789012:config-rule/config-rule-abcdef", "Source": { "Owner": "CUSTOM_LAMBDA", "SourceIdentifier": "arn:aws:lambda:us-east-1:123456789012:function:InstanceTypeCheck", "SourceDetails": [ { "EventSource": "aws.config", "MessageType": "ConfigurationItemChangeNotification" } ] }, "InputParameters": "{\"desiredInstanceType\":\"t2.micro\"}", "Scope": { "ComplianceResourceTypes": [ "AWS::EC2::Instance" ] }, "ConfigRuleId": "config-rule-abcdef" } ] } ``` + Einzelheiten zur API finden Sie [DescribeConfigRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-config-rules.html)in der *AWS CLI Befehlsreferenz*. ### `describe-configuration-recorder-status` Das folgende Codebeispiel zeigt die Verwendung`describe-configuration-recorder-status`. **AWS CLI** **So rufen Sie Statusinformationen für den Konfigurations-Recorder ab** Der folgende Befehl gibt den Status des Standardkonfigurations-Recorders zurück: ``` aws configservice describe-configuration-recorder-status ``` Ausgabe: ``` { "ConfigurationRecordersStatus": [ { "name": "default", "lastStatus": "SUCCESS", "recording": true, "lastStatusChangeTime": 1452193834.344, "lastStartTime": 1441039997.819, "lastStopTime": 1441039992.835 } ] } ``` + Einzelheiten zur API finden Sie [DescribeConfigurationRecorderStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-configuration-recorder-status.html)in der *AWS CLI Befehlsreferenz*. ### `describe-configuration-recorders` Das folgende Codebeispiel zeigt die Verwendung`describe-configuration-recorders`. **AWS CLI** **So rufen Sie Details zum Konfigurations-Recorder ab** Der folgende Befehl gibt Details zum Standardkonfigurations-Recorder zurück: ``` aws configservice describe-configuration-recorders ``` Ausgabe: ``` { "ConfigurationRecorders": [ { "recordingGroup": { "allSupported": true, "resourceTypes": [], "includeGlobalResourceTypes": true }, "roleARN": "arn:aws:iam::123456789012:role/config-ConfigRole-A1B2C3D4E5F6", "name": "default" } ] } ``` + Einzelheiten zur API finden Sie [DescribeConfigurationRecorders](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-configuration-recorders.html)in der *AWS CLI Befehlsreferenz*. ### `describe-delivery-channel-status` Das folgende Codebeispiel zeigt die Verwendung`describe-delivery-channel-status`. **AWS CLI** **So rufen Sie Statusinformationen für den Bereitstellungskanal ab** Der folgende Befehl gibt den Status des Bereitstellungskanals zurück: ``` aws configservice describe-delivery-channel-status ``` Ausgabe: ``` { "DeliveryChannelsStatus": [ { "configStreamDeliveryInfo": { "lastStatusChangeTime": 1452193834.381, "lastStatus": "SUCCESS" }, "configHistoryDeliveryInfo": { "lastSuccessfulTime": 1450317838.412, "lastStatus": "SUCCESS", "lastAttemptTime": 1450317838.412 }, "configSnapshotDeliveryInfo": { "lastSuccessfulTime": 1452185597.094, "lastStatus": "SUCCESS", "lastAttemptTime": 1452185597.094 }, "name": "default" } ] } ``` + Einzelheiten zur API finden Sie [DescribeDeliveryChannelStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-delivery-channel-status.html)in der *AWS CLI Befehlsreferenz*. ### `describe-delivery-channels` Das folgende Codebeispiel zeigt die Verwendung`describe-delivery-channels`. **AWS CLI** **So rufen Sie Details über den Bereitstellungskanal ab** Der folgende Befehl gibt Details über den Bereitstellungskanal zurück: ``` aws configservice describe-delivery-channels ``` Ausgabe: ``` { "DeliveryChannels": [ { "snsTopicARN": "arn:aws:sns:us-east-1:123456789012:config-topic", "name": "default", "s3BucketName": "config-bucket-123456789012" } ] } ``` + Einzelheiten zur API finden Sie [DescribeDeliveryChannels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-delivery-channels.html)in der *AWS CLI Befehlsreferenz*. ### `get-compliance-details-by-config-rule` Das folgende Codebeispiel zeigt die Verwendung`get-compliance-details-by-config-rule`. **AWS CLI** **Um die Auswertungsergebnisse für eine AWS Config-Regel abzurufen** Der folgende Befehl gibt die Auswertungsergebnisse für alle Ressourcen zurück, die nicht einer AWS Config-Regel mit dem Namen entsprechen`InstanceTypesAreT2micro`: ``` aws configservice get-compliance-details-by-config-rule --config-rule-name InstanceTypesAreT2micro --compliance-types NON_COMPLIANT ``` Ausgabe: ``` { "EvaluationResults": [ { "EvaluationResultIdentifier": { "OrderingTimestamp": 1450314635.065, "EvaluationResultQualifier": { "ResourceType": "AWS::EC2::Instance", "ResourceId": "i-1a2b3c4d", "ConfigRuleName": "InstanceTypesAreT2micro" } }, "ResultRecordedTime": 1450314645.261, "ConfigRuleInvokedTime": 1450314642.948, "ComplianceType": "NON_COMPLIANT" }, { "EvaluationResultIdentifier": { "OrderingTimestamp": 1450314635.065, "EvaluationResultQualifier": { "ResourceType": "AWS::EC2::Instance", "ResourceId": "i-2a2b3c4d", "ConfigRuleName": "InstanceTypesAreT2micro" } }, "ResultRecordedTime": 1450314645.18, "ConfigRuleInvokedTime": 1450314642.902, "ComplianceType": "NON_COMPLIANT" }, { "EvaluationResultIdentifier": { "OrderingTimestamp": 1450314635.065, "EvaluationResultQualifier": { "ResourceType": "AWS::EC2::Instance", "ResourceId": "i-3a2b3c4d", "ConfigRuleName": "InstanceTypesAreT2micro" } }, "ResultRecordedTime": 1450314643.346, "ConfigRuleInvokedTime": 1450314643.124, "ComplianceType": "NON_COMPLIANT" } ] } ``` + Einzelheiten zur API finden Sie [GetComplianceDetailsByConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-details-by-config-rule.html)in der *AWS CLI Befehlsreferenz*. ### `get-compliance-details-by-resource` Das folgende Codebeispiel zeigt die Verwendung`get-compliance-details-by-resource`. **AWS CLI** **Um die Evaluierungsergebnisse für eine AWS Ressource abzurufen** Der folgende Befehl gibt die Auswertungsergebnisse für jede Regel zurück, der die EC2-Instance `i-1a2b3c4d` nicht entspricht: ``` aws configservice get-compliance-details-by-resource --resource-type AWS::EC2::Instance --resource-id i-1a2b3c4d --compliance-types NON_COMPLIANT ``` Ausgabe: ``` { "EvaluationResults": [ { "EvaluationResultIdentifier": { "OrderingTimestamp": 1450314635.065, "EvaluationResultQualifier": { "ResourceType": "AWS::EC2::Instance", "ResourceId": "i-1a2b3c4d", "ConfigRuleName": "InstanceTypesAreT2micro" } }, "ResultRecordedTime": 1450314643.288, "ConfigRuleInvokedTime": 1450314643.034, "ComplianceType": "NON_COMPLIANT" }, { "EvaluationResultIdentifier": { "OrderingTimestamp": 1450314635.065, "EvaluationResultQualifier": { "ResourceType": "AWS::EC2::Instance", "ResourceId": "i-1a2b3c4d", "ConfigRuleName": "RequiredTagForEC2Instances" } }, "ResultRecordedTime": 1450314645.261, "ConfigRuleInvokedTime": 1450314642.948, "ComplianceType": "NON_COMPLIANT" } ] } ``` + Einzelheiten zur API finden Sie [GetComplianceDetailsByResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-details-by-resource.html)in der *AWS CLI Befehlsreferenz*. ### `get-compliance-summary-by-config-rule` Das folgende Codebeispiel zeigt die Verwendung`get-compliance-summary-by-config-rule`. **AWS CLI** **Um die Konformitätsübersicht für Ihre AWS Config-Regeln abzurufen** Der folgende Befehl gibt die Anzahl der Regeln zurück, die konform sind, und die Anzahl derer, die nicht konform sind: ``` aws configservice get-compliance-summary-by-config-rule ``` In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, wie viele Regeln konform bzw. nicht konform sind. Ausgabe: ``` { "ComplianceSummary": { "NonCompliantResourceCount": { "CappedCount": 3, "CapExceeded": false }, "ComplianceSummaryTimestamp": 1452204131.493, "CompliantResourceCount": { "CappedCount": 2, "CapExceeded": false } } } ``` + Einzelheiten zur API finden Sie [GetComplianceSummaryByConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-summary-by-config-rule.html)in der *AWS CLI Befehlsreferenz*. ### `get-compliance-summary-by-resource-type` Das folgende Codebeispiel zeigt die Verwendung`get-compliance-summary-by-resource-type`. **AWS CLI** **So rufen Sie die Compliance-Zusammenfassung für alle Ressourcentypen ab** Der folgende Befehl gibt die Anzahl der AWS Ressourcen zurück, die nicht konform sind, und die Anzahl, die konform sind: ``` aws configservice get-compliance-summary-by-resource-type ``` In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, wie viele Ressourcen konform bzw. nicht konform sind. Ausgabe: ``` { "ComplianceSummariesByResourceType": [ { "ComplianceSummary": { "NonCompliantResourceCount": { "CappedCount": 16, "CapExceeded": false }, "ComplianceSummaryTimestamp": 1453237464.543, "CompliantResourceCount": { "CappedCount": 10, "CapExceeded": false } } } ] } ``` **So rufen Sie die Compliance-Zusammenfassung für einen bestimmten Ressourcentyp ab** Der folgende Befehl gibt die Anzahl der EC2-Instances zurück, die nicht konform sind, und die Anzahl derer, die konform sind: ``` aws configservice get-compliance-summary-by-resource-type --resource-types AWS::EC2::Instance ``` In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, wie viele Ressourcen konform bzw. nicht konform sind. Ausgabe: ``` { "ComplianceSummariesByResourceType": [ { "ResourceType": "AWS::EC2::Instance", "ComplianceSummary": { "NonCompliantResourceCount": { "CappedCount": 3, "CapExceeded": false }, "ComplianceSummaryTimestamp": 1452204923.518, "CompliantResourceCount": { "CappedCount": 7, "CapExceeded": false } } } ] } ``` + Einzelheiten zur API finden Sie unter [GetComplianceSummaryByResourceType AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-summary-by-resource-type.html)*Befehlsreferenz.* ### `get-resource-config-history` Das folgende Codebeispiel zeigt die Verwendung`get-resource-config-history`. **AWS CLI** **Um den Konfigurationsverlauf einer AWS Ressource abzurufen** Der folgende Befehl gibt eine Liste von Konfigurationselementen für eine EC2-Instance mit der ID `i-1a2b3c4d` zurück: ``` aws configservice get-resource-config-history --resource-type AWS::EC2::Instance --resource-id i-1a2b3c4d ``` + Einzelheiten zur API finden Sie [GetResourceConfigHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-resource-config-history.html)in der *AWS CLI Befehlsreferenz*. ### `get-status` Das folgende Codebeispiel zeigt die Verwendung`get-status`. **AWS CLI** **Um den Status für AWS Config abzurufen** Der folgende Befehl gibt den Status des Bereitstellungskanals und Konfigurations-Recorders zurück: ``` aws configservice get-status ``` Ausgabe: ``` Configuration Recorders: name: default recorder: ON last status: SUCCESS Delivery Channels: name: default last stream delivery status: SUCCESS last history delivery status: SUCCESS last snapshot delivery status: SUCCESS ``` + Einzelheiten zur API finden Sie [GetStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-status.html)in der *AWS CLI Befehlsreferenz*. ### `list-discovered-resources` Das folgende Codebeispiel zeigt die Verwendung`list-discovered-resources`. **AWS CLI** **Um Ressourcen aufzulisten, die AWS Config entdeckt hat** Der folgende Befehl listet die EC2-Instances auf, die AWS Config entdeckt hat: ``` aws configservice list-discovered-resources --resource-type AWS::EC2::Instance ``` Ausgabe: ``` { "resourceIdentifiers": [ { "resourceType": "AWS::EC2::Instance", "resourceId": "i-1a2b3c4d" }, { "resourceType": "AWS::EC2::Instance", "resourceId": "i-2a2b3c4d" }, { "resourceType": "AWS::EC2::Instance", "resourceId": "i-3a2b3c4d" } ] } ``` + Einzelheiten zur API finden Sie [ListDiscoveredResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/list-discovered-resources.html)in der *AWS CLI Befehlsreferenz.* ### `put-config-rule` Das folgende Codebeispiel zeigt die Verwendung`put-config-rule`. **AWS CLI** **So fügen Sie eine AWS verwaltete Konfigurationsregel hinzu** Der folgende Befehl stellt JSON-Code zum Hinzufügen einer AWS verwalteten Config-Regel bereit: ``` aws configservice put-config-rule --config-rule file://RequiredTagsForEC2Instances.json ``` `RequiredTagsForEC2Instances.json` ist eine JSON-Datei, die die Regelkonfiguration enthält: ``` { "ConfigRuleName": "RequiredTagsForEC2Instances", "Description": "Checks whether the CostCenter and Owner tags are applied to EC2 instances.", "Scope": { "ComplianceResourceTypes": [ "AWS::EC2::Instance" ] }, "Source": { "Owner": "AWS", "SourceIdentifier": "REQUIRED_TAGS" }, "InputParameters": "{\"tag1Key\":\"CostCenter\",\"tag2Key\":\"Owner\"}" } ``` Für das `ComplianceResourceTypes` Attribut beschränkt dieser JSON-Code den Bereich auf Ressourcen des `AWS::EC2::Instance` Typs, sodass AWS Config nur EC2-Instances anhand der Regel auswertet. Da es sich bei der Regel um eine verwaltete Regel handelt, ist das `Owner`-Attribut auf `AWS` und das `SourceIdentifier`-Attribut auf den Regelbezeichner `REQUIRED_TAGS` festgelegt. Für das `InputParameters`-Attribut werden die Tag-Schlüssel, `Owner` und `CostCenter`, die die Regel benötigt, angegeben. Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Um die Regelkonfiguration zu überprüfen, führen Sie den describe-config-rules Befehl aus und geben Sie den Regelnamen an. **So fügen Sie eine vom Kunden verwaltete Konfigurationsregel hinzu** Der folgende Befehl stellt JSON-Code zum Hinzufügen einer vom Kunden verwalteten Konfigurationsregel bereit: ``` aws configservice put-config-rule --config-rule file://InstanceTypesAreT2micro.json ``` `InstanceTypesAreT2micro.json` ist eine JSON-Datei, die die Regelkonfiguration enthält: ``` { "ConfigRuleName": "InstanceTypesAreT2micro", "Description": "Evaluates whether EC2 instances are the t2.micro type.", "Scope": { "ComplianceResourceTypes": [ "AWS::EC2::Instance" ] }, "Source": { "Owner": "CUSTOM_LAMBDA", "SourceIdentifier": "arn:aws:lambda:us-east-1:123456789012:function:InstanceTypeCheck", "SourceDetails": [ { "EventSource": "aws.config", "MessageType": "ConfigurationItemChangeNotification" } ] }, "InputParameters": "{\"desiredInstanceType\":\"t2.micro\"}" } ``` Für das `ComplianceResourceTypes` Attribut beschränkt dieser JSON-Code den Bereich auf Ressourcen des `AWS::EC2::Instance` Typs, sodass AWS Config nur EC2-Instances anhand der Regel auswertet. Da es sich bei dieser Regel um eine vom Kunden verwaltete Regel handelt`CUSTOM_LAMBDA`, ist das `Owner` Attribut auf und das `SourceIdentifier` Attribut auf den ARN der AWS Lambda-Funktion gesetzt. Das `SourceDetails`-Objekt ist erforderlich. Die für das `InputParameters` Attribut angegebenen Parameter werden an die AWS Lambda-Funktion übergeben, wenn AWS Config sie aufruft, um Ressourcen anhand der Regel auszuwerten. Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Um die Regelkonfiguration zu überprüfen, führen Sie den describe-config-rules Befehl aus und geben Sie den Regelnamen an. + Einzelheiten zur API finden Sie [PutConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/put-config-rule.html)unter *AWS CLI Befehlsreferenz*. ### `put-configuration-recorder` Das folgende Codebeispiel zeigt die Verwendung`put-configuration-recorder`. **AWS CLI** **Beispiel 1: So zeichnen Sie alle unterstützten Ressourcen auf** Der folgende Befehl erstellt einen Konfigurations-Recorder, der Änderungen an allen unterstützten Ressourcentypen, einschließlich globaler Ressourcentypen, verfolgt: ``` aws configservice put-configuration-recorder \ --configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role \ --recording-group allSupported=true,includeGlobalResourceTypes=true ``` Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den describe-configuration-recorders Befehl aus, um die Einstellungen Ihres Konfigurationsrekorders zu überprüfen. **Beispiel 2: So zeichnen Sie bestimmte Ressourcentypen auf** Der folgende Befehl erstellt einen Konfigurations-Recorder, der nur Änderungen an den Ressourcentypen verfolgt, die in der JSON-Datei für die Option --recording-group angegeben sind: ``` aws configservice put-configuration-recorder \ --configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role \ --recording-group file://recordingGroup.json ``` RecordingGroup.json ist eine JSON-Datei, die die Arten von Ressourcen angibt, die Config aufzeichnet: AWS ``` { "allSupported": false, "includeGlobalResourceTypes": false, "resourceTypes": [ "AWS::EC2::EIP", "AWS::EC2::Instance", "AWS::EC2::NetworkAcl", "AWS::EC2::SecurityGroup", "AWS::CloudTrail::Trail", "AWS::EC2::Volume", "AWS::EC2::VPC", "AWS::IAM::User", "AWS::IAM::Policy" ] } ``` Bevor Sie resourceTypes für den Schlüssel ResourceTypes angeben können, müssen Sie die Optionen AllSupported und includeGlobalResource Types auf false setzen oder sie weglassen. Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den describe-configuration-recorders Befehl aus, um die Einstellungen Ihres Konfigurationsrekorders zu überprüfen. **Beispiel 3: So wählen Sie alle unterstützten Ressourcen mit Ausnahme bestimmter Ressourcentypen aus** Der folgende Befehl erstellt einen Konfigurations-Recorder, der Änderungen an allen aktuell und künftig unterstützten Ressourcentypen verfolgt mit Ausnahme von Ressourcentypen, die in der JSON-Datei für die Option --recording-group angegeben sind: ``` aws configservice put-configuration-recorder \ --configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role \ --recording-group file://recordingGroup.json ``` RecordingGroup.json ist eine JSON-Datei, die die Arten von Ressourcen angibt, die Config aufzeichnet: AWS ``` { "allSupported": false, "exclusionByResourceTypes": { "resourceTypes": [ "AWS::Redshift::ClusterSnapshot", "AWS::RDS::DBClusterSnapshot", "AWS::CloudFront::StreamingDistribution" ] }, "includeGlobalResourceTypes": false, "recordingStrategy": { "useOnly": "EXCLUSION_BY_RESOURCE_TYPES" }, } ``` Bevor Sie Ressourcentypen angeben können, die von der Aufzeichnung ausgeschlossen werden sollen: 1) Sie müssen die Optionen AllSupported und includeGlobalResource Types auf false setzen oder sie weglassen, und 2) Sie müssen das Feld UseOnly auf EXCLUSION\$1BY\$1RESOURCE\$1TYPES setzen. RecordingStrategy Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den describe-configuration-recorders Befehl aus, um die Einstellungen Ihres Konfigurationsrekorders zu überprüfen. + Einzelheiten zur API finden Sie [PutConfigurationRecorder](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/put-configuration-recorder.html)in der *AWS CLI Befehlsreferenz*. ### `put-delivery-channel` Das folgende Codebeispiel zeigt die Verwendung`put-delivery-channel`. **AWS CLI** **So erstellen Sie einen Bereitstellungskanal** Der folgende Befehl stellt die Einstellungen für den Bereitstellungskanal als JSON-Code zur Verfügung: ``` aws configservice put-delivery-channel --delivery-channel file://deliveryChannel.json ``` Die Datei `deliveryChannel.json` gibt die Attribute des Bereitstellungskanals an: ``` { "name": "default", "s3BucketName": "config-bucket-123456789012", "snsTopicARN": "arn:aws:sns:us-east-1:123456789012:config-topic", "configSnapshotDeliveryProperties": { "deliveryFrequency": "Twelve_Hours" } } ``` In diesem Beispiel werden die folgenden Attribute festgelegt: `name`: Der Name des Übermittlungskanals. Standardmäßig weist AWS Config den Namen einem neuen Lieferkanal `default` zu. Sie können den Namen des Lieferkanals nicht mit dem Befehl aktualisieren. `put-delivery-channel` Die Schritte zum Ändern des Namens finden Sie unter „Umbenennen des Bereitstellungskanals“.`s3BucketName` - Der Name des Amazon S3 S3-Buckets, für den AWS Config Konfigurations-Snapshots und Konfigurationsverlaufsdateien bereitstellt. Wenn Sie einen Bucket angeben, der zu einem anderen AWS Konto gehört, muss dieser Bucket über Richtlinien verfügen, die Config Zugriffsberechtigungen gewähren. AWS Weitere Informationen finden Sie unter „Berechtigungen für den Amazon-S3-Bucket“. `snsTopicARN`— Der Amazon-Ressourcenname (ARN) des Amazon SNS-Themas, an das AWS Config Benachrichtigungen über Konfigurationsänderungen sendet. Wenn Sie ein Thema aus einem anderen Konto auswählen, muss das Thema über Richtlinien verfügen, die Config Zugriffsberechtigungen gewähren. AWS Weitere Informationen finden Sie unter „Berechtigungen für das Amazon-SNS-Thema“. `configSnapshotDeliveryProperties`- Enthält das `deliveryFrequency` Attribut, das festlegt, wie oft AWS Config Konfigurations-Snapshots liefert und wie oft es Evaluierungen für periodische Config-Regeln aufruft. Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den describe-delivery-channels Befehl aus, um die Einstellungen Ihres Lieferkanals zu überprüfen. + Einzelheiten zur API finden Sie [PutDeliveryChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/put-delivery-channel.html)in der *AWS CLI Befehlsreferenz*. ### `start-config-rules-evaluation` Das folgende Codebeispiel zeigt die Verwendung`start-config-rules-evaluation`. **AWS CLI** **So führen Sie eine On-Demand-Evaluierung für AWS Config-Regeln durch** Mit dem folgenden Befehl wird eine Evaluierung für zwei AWS verwaltete Regeln gestartet: ``` aws configservice start-config-rules-evaluation --config-rule-names s3-bucket-versioning-enabled cloudtrail-enabled ``` + Einzelheiten zur API finden Sie [StartConfigRulesEvaluation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/start-config-rules-evaluation.html)in der *AWS CLI Befehlsreferenz*. ### `start-configuration-recorder` Das folgende Codebeispiel zeigt die Verwendung`start-configuration-recorder`. **AWS CLI** **Um den Konfigurationsrekorder zu starten** Der folgende Befehl startet den Standard-Configuration-Recorder: ``` aws configservice start-configuration-recorder --configuration-recorder-name default ``` Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den Befehl get-status aus, um zu überprüfen, ob AWS Config Ihre Ressourcen aufzeichnet. + Einzelheiten zur API finden Sie [StartConfigurationRecorder](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/start-configuration-recorder.html)in der *AWS CLI Befehlsreferenz.* ### `stop-configuration-recorder` Das folgende Codebeispiel zeigt die Verwendung`stop-configuration-recorder`. **AWS CLI** **Um den Konfigurationsrekorder zu stoppen** Der folgende Befehl hält den Standard-Configuration-Recorder an: ``` aws configservice stop-configuration-recorder --configuration-recorder-name default ``` Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den Befehl get-status aus, um sicherzustellen, dass AWS Config Ihre Ressourcen nicht aufzeichnet. + Einzelheiten zur API finden Sie unter [StopConfigurationRecorder AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/stop-configuration-recorder.html)*Befehlsreferenz.* ### `subscribe` Das folgende Codebeispiel zeigt die Verwendung`subscribe`. **AWS CLI** **Um AWS Config zu abonnieren** Mit dem folgenden Befehl werden der Standardbereitstellungskanal und der Configuration Recorder erstellt: Der Befehl spezifiziert auch den Amazon S3 S3-Bucket und das Amazon SNS SNS-Thema, an das AWS Config Konfigurationsinformationen liefert: ``` aws configservice subscribe --s3-bucket config-bucket-123456789012 --sns-topic arn:aws:sns:us-east-1:123456789012:config-topic --iam-role arn:aws:iam::123456789012:role/ConfigRole-A1B2C3D4E5F6 ``` Ausgabe: ``` Using existing S3 bucket: config-bucket-123456789012 Using existing SNS topic: arn:aws:sns:us-east-1:123456789012:config-topic Subscribe succeeded: Configuration Recorders: [ { "recordingGroup": { "allSupported": true, "resourceTypes": [], "includeGlobalResourceTypes": false }, "roleARN": "arn:aws:iam::123456789012:role/ConfigRole-A1B2C3D4E5F6", "name": "default" } ] Delivery Channels: [ { "snsTopicARN": "arn:aws:sns:us-east-1:123456789012:config-topic", "name": "default", "s3BucketName": "config-bucket-123456789012" } ] ``` + Weitere API-Informationen finden Sie unter [Subscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/subscribe.html) in der *AWS CLI -Befehlsreferenz*. # Amazon Connect Connect-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon Connect Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-user` Das folgende Codebeispiel zeigt, wie Sie`create-user`. **AWS CLI** **Um einen Benutzer zu erstellen** Im folgenden Beispiel für `create-user` wird der angegebenen Amazon-Connect-Instance ein Benutzer mit den angegebenen Attributen hinzugefügt. ``` aws connect create-user \ --username Mary \ --password Pass@Word1 \ --identity-info FirstName=Mary,LastName=Major \ --phone-config PhoneType=DESK_PHONE,AutoAccept=true,AfterContactWorkTimeLimit=60,DeskPhoneNumber=+15555551212 \ --security-profile-id 12345678-1111-2222-aaaa-a1b2c3d4f5g7 \ --routing-profile-id 87654321-9999-3434-abcd-x1y2z3a1b2c3 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "UserId": "87654321-2222-1234-1234-111234567891", "UserArn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent/87654321-2222-1234-1234-111234567891" } ``` Weitere Informationen finden Sie unter [Hinzufügen von Benutzern](https://docs.aws.amazon.com/connect/latest/adminguide/user-management.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [CreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/create-user.html)in der *AWS CLI Befehlsreferenz*. ### `delete-user` Das folgende Codebeispiel zeigt die Verwendung`delete-user`. **AWS CLI** **So löschen Sie einen Benutzer** Im folgenden Beispiel für `delete-user` wird der angegebene Benutzer von der spezifizierten Amazon-Connect-Instance gelöscht. ``` aws connect delete-user \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --user-id 87654321-2222-1234-1234-111234567891 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Benutzern](https://docs.aws.amazon.com/connect/latest/adminguide/manage-users.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [DeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/delete-user.html)in der *AWS CLI Befehlsreferenz*. ### `describe-user-hierarchy-group` Das folgende Codebeispiel zeigt die Verwendung`describe-user-hierarchy-group`. **AWS CLI** **So zeigen Sie die Details für eine Hierarchiegruppe an** Im folgenden Beispiel für `describe-user-hierarchy-group` werden die Details für die angegebene Amazon-Connect-Hierarchiegruppe angezeigt. ``` aws connect describe-user-hierarchy-group \ --hierarchy-group-id 12345678-1111-2222-800e-aaabbb555gg \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "HierarchyGroup": { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group/12345678-1111-2222-800e-a2b3c4d5f6g7", "Name": "Example Corporation", "LevelId": "1", "HierarchyPath": { "LevelOne": { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group/abcdefgh-3333-4444-8af3-201123456789", "Name": "Example Corporation" } } } } ``` Weitere Informationen finden Sie unter [Einrichten von Kundendienstmitarbeiter-Hierarchien](https://docs.aws.amazon.com/connect/latest/adminguide/agent-hierarchy.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [DescribeUserHierarchyGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/describe-user-hierarchy-group.html)in der *AWS CLI Befehlsreferenz*. ### `describe-user-hierarchy-structure` Das folgende Codebeispiel zeigt die Verwendung`describe-user-hierarchy-structure`. **AWS CLI** **So zeigen Sie die Details für eine Hierarchiestruktur an** Im folgenden Beispiel für `describe-user-hierarchy-structure` werden die Details für die Hierarchiestruktur der angegebenen Amazon-Connect-Instance angezeigt. ``` aws connect describe-user-hierarchy-group \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "HierarchyStructure": { "LevelOne": { "Id": "12345678-1111-2222-800e-aaabbb555gg", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group-level/1", "Name": "Corporation" }, "LevelTwo": { "Id": "87654321-2222-3333-ac99-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group-level/2", "Name": "Services Division" }, "LevelThree": { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group-level/3", "Name": "EU Site" } } } ``` Weitere Informationen finden Sie unter [Einrichten von Kundendienstmitarbeiter-Hierarchien](https://docs.aws.amazon.com/connect/latest/adminguide/agent-hierarchy.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [DescribeUserHierarchyStructure](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/describe-user-hierarchy-structure.html)in der *AWS CLI Befehlsreferenz*. ### `describe-user` Das folgende Codebeispiel zeigt die Verwendung`describe-user`. **AWS CLI** **So zeigen Sie die Details für einen Benutzer an** Im folgenden Beispiel für `describe-user` werden die Details für den angegebenen Amazon-Connect-Benutzer angezeigt. ``` aws connect describe-user \ --user-id 0c245dc0-0cf5-4e37-800e-2a7481cc8a60 --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e ``` Ausgabe: ``` { "User": { "Id": "0c245dc0-0cf5-4e37-800e-2a7481cc8a60", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/0c245dc0-0cf5-4e37-800e-2a7481cc8a60", "Username": "Jane", "IdentityInfo": { "FirstName": "Jane", "LastName": "Doe", "Email": "example.com" }, "PhoneConfig": { "PhoneType": "SOFT_PHONE", "AutoAccept": false, "AfterContactWorkTimeLimit": 0, "DeskPhoneNumber": "" }, "DirectoryUserId": "8b444cf6-b368-4f29-ba18-07af27405658", "SecurityProfileIds": [ "b6f85a42-1dc5-443b-b621-de0abf70c9cf" ], "RoutingProfileId": "0be36ee9-2b5f-4ef4-bcf7-87738e5be0e5", "Tags": {} } } ``` Weitere Informationen finden Sie unter [Verwalten von Benutzern](https://docs.aws.amazon.com/connect/latest/adminguide/manage-users.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [DescribeUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/describe-user.html)in der *AWS CLI Befehlsreferenz*. ### `get-contact-attributes` Das folgende Codebeispiel zeigt die Verwendung`get-contact-attributes`. **AWS CLI** **So rufen Sie die Attribute für einen Kontakt ab** Im folgenden Beispiel für `get-contact-attributes` werden die Attribute abgerufen, die für den angegebenen Amazon-Connect-Kontakt festgelegt wurden. ``` aws connect get-contact-attributes \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --initial-contact-id 12345678-1111-2222-800e-a2b3c4d5f6g7 ``` Ausgabe: ``` { "Attributes": { "greetingPlayed": "true" } } ``` Weitere Informationen finden Sie unter [Verwenden von Amazon-Connect-Kontaktattributen](https://docs.aws.amazon.com/connect/latest/adminguide/connect-contact-attributes.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [GetContactAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/get-contact-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `list-contact-flows` Das folgende Codebeispiel zeigt die Verwendung`list-contact-flows`. **AWS CLI** **So listen Sie die Kontaktabläufe in einer Instance auf** Im folgenden Beispiel für `list-contact-flows` werden die Kontaktabläufe in der angegebenen Amazon-Connect-Instance aufgeführt. ``` aws connect list-contact-flows \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "ContactFlowSummaryList": [ { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/contact-flow/12345678-1111-2222-800e-a2b3c4d5f6g7", "Name": "Default queue transfer", "ContactFlowType": "QUEUE_TRANSFER" }, { "Id": "87654321-2222-3333-ac99-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/contact-flow/87654321-2222-3333-ac99-123456789102", "Name": "Default agent hold", "ContactFlowType": "AGENT_HOLD" }, { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/contact-flow/abcdefgh-3333-4444-8af3-201123456789", "Name": "Default customer hold", "ContactFlowType": "CUSTOMER_HOLD" }, ] } ``` Weitere Informationen finden Sie unter [Erstellen von Amazon-Connect-Kontaktabläufen](https://docs.aws.amazon.com/connect/latest/adminguide/connect-contact-flows.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [ListContactFlows](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-contact-flows.html)in der *AWS CLI Befehlsreferenz*. ### `list-hours-of-operations` Das folgende Codebeispiel zeigt die Verwendung`list-hours-of-operations`. **AWS CLI** **So führen Sie die Betriebsstunden einer Instance auf** Im folgenden Beispiel für `list-hours-of-operations` werden die Betriebsstunden für die angegebene Amazon-Connect-Instance aufgelistet. ``` aws connect list-hours-of-operations \ --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e ``` Ausgabe: ``` { "HoursOfOperationSummaryList": [ { "Id": "d69f1f84-7457-4924-8fbe-e64875546259", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/operating-hours/d69f1f84-7457-4924-8fbe-e64875546259", "Name": "Basic Hours" } ] } ``` Weitere Informationen finden Sie unter [Festlegen der Betriebszeiten für eine Warteschlange](https://docs.aws.amazon.com/connect/latest/adminguide/set-hours-operation.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [ListHoursOfOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-hours-of-operations.html)in der *AWS CLI Befehlsreferenz*. ### `list-phone-numbers` Das folgende Codebeispiel zeigt die Verwendung`list-phone-numbers`. **AWS CLI** **So führen Sie die Telefonnummern in einer Instance auf** Im folgenden Beispiel für `list-phone-numbers` werden die Telefonnummern in der angegebenen Amazon-Connect-Instance aufgeführt. ``` aws connect list-phone-numbers \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "PhoneNumberSummaryList": [ { "Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/phone-number/xyz80zxy-xyz1-80zx-zx80-11111EXAMPLE", "PhoneNumber": "+17065551212", "PhoneNumberType": "DID", "PhoneNumberCountryCode": "US" }, { "Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/phone-number/ccc0ccc-xyz1-80zx-zx80-22222EXAMPLE", "PhoneNumber": "+18555551212", "PhoneNumberType": "TOLL_FREE", "PhoneNumberCountryCode": "US" } ] } ``` Weitere Informationen finden Sie unter [Einrichten von Telefonnummern für Ihr Kontaktcenter](https://docs.aws.amazon.com/connect/latest/adminguide/contact-center-phone-number.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [ListPhoneNumbers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-phone-numbers.html)in der *AWS CLI Befehlsreferenz*. ### `list-queues` Das folgende Codebeispiel zeigt die Verwendung`list-queues`. **AWS CLI** **So listen Sie die Warteschlangen in einer Instance auf** Im folgenden Beispiel für `list-queues` werden die Warteschlangen in der angegebenen Amazon-Connect-Instance aufgeführt. ``` aws connect list-queues \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "QueueSummaryList": [ { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/agent/12345678-1111-2222-800e-a2b3c4d5f6g7", "QueueType": "AGENT" }, { "Id": "87654321-2222-3333-ac99-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/agent/87654321-2222-3333-ac99-123456789102", "QueueType": "AGENT" }, { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/agent/abcdefgh-3333-4444-8af3-201123456789", "QueueType": "AGENT" }, { "Id": "hgfedcba-4444-5555-a31f-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/hgfedcba-4444-5555-a31f-123456789102", "Name": "BasicQueue", "QueueType": "STANDARD" }, ] } ``` Weitere Informationen finden Sie unter [Erstellen einer Warteschlange](https://docs.aws.amazon.com/connect/latest/adminguide/create-queue.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [ListQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-queues.html)in der *AWS CLI Befehlsreferenz*. ### `list-routing-profiles` Das folgende Codebeispiel zeigt die Verwendung`list-routing-profiles`. **AWS CLI** **So listen Sie alle Routing-Profile in einer Instance auf** Im folgenden Beispiel für `list-routing-profiles` werden die Routing-Profile in der angegebenen Amazon-Connect-Instance aufgeführt. ``` aws connect list-routing-profiles \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "RoutingProfileSummaryList": [ { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/routing-profile/12345678-1111-2222-800e-a2b3c4d5f6g7", "Name": "Basic Routing Profile" }, ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Routing-Profils](https://docs.aws.amazon.com/connect/latest/adminguide/routing-profiles.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [ListRoutingProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-routing-profiles.html)in der *AWS CLI Befehlsreferenz*. ### `list-security-profiles` Das folgende Codebeispiel zeigt die Verwendung`list-security-profiles`. **AWS CLI** **So listen Sie alle Sicherheitsprofile in einer Instance auf** Im folgenden Beispiel für `list-security-profiles` werden die Sicherheitsprofile in der angegebenen Amazon-Connect-Instance aufgeführt. ``` aws connect list-security-profiles \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "SecurityProfileSummaryList": [ { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/12345678-1111-2222-800e-a2b3c4d5f6g7", "Name": "CallCenterManager" }, { "Id": "87654321-2222-3333-ac99-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/87654321-2222-3333-ac99-123456789102", "Name": "QualityAnalyst" }, { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/abcdefgh-3333-4444-8af3-201123456789", "Name": "Agent" }, { "Id": "12345678-1111-2222-800e-x2y3c4d5fzzzz", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/12345678-1111-2222-800e-x2y3c4d5fzzzz", "Name": "Admin" } ] } ``` Weitere Informationen finden Sie unter [Zuweisen von Berechtigungen: Sicherheitsprofile](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [ListSecurityProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-security-profiles.html)in der *AWS CLI Befehlsreferenz*. ### `list-user-hierarchy-groups` Das folgende Codebeispiel zeigt die Verwendung`list-user-hierarchy-groups`. **AWS CLI** **So listen Sie die Benutzerhierarchiegruppen in einer Instance auf** Im folgenden Beispiel für `list-user-hierarchy-groups` werden die Benutzerhierarchiegruppen in der angegebenen Amazon-Connect-Instance aufgeführt. ``` aws connect list-user-hierarchy-groups \ --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e ``` Ausgabe: ``` { "UserHierarchyGroupSummaryList": [ { "Id": "0e2f6d1d-b3ca-494b-8dbc-ba81d9f8182a", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent-group/0e2f6d1d-b3ca-494b-8dbc-ba81d9f8182a", "Name": "Example Corporation" }, ] } ``` Weitere Informationen finden Sie unter [Einrichten von Kundendienstmitarbeiter-Hierarchien](https://docs.aws.amazon.com/connect/latest/adminguide/agent-hierarchy.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [ListUserHierarchyGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-user-hierarchy-groups.html)in der *AWS CLI Befehlsreferenz*. ### `list-users` Das folgende Codebeispiel zeigt die Verwendung`list-users`. **AWS CLI** **So listen Sie die Benutzerhierarchiegruppen in einer Instance auf** Im folgenden Beispiel für `list-users` werden die Benutzer in der angegebenen Amazon-Connect-Instance aufgeführt. ``` aws connect list-users \ --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e ``` Ausgabe: ``` { "UserSummaryList": [ { "Id": "0c245dc0-0cf5-4e37-800e-2a7481cc8a60", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/0c245dc0-0cf5-4e37-800e-2a7481cc8a60", "Username": "Jane" }, { "Id": "46f0c67c-3fc7-4806-ac99-403798788c14", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/46f0c67c-3fc7-4806-ac99-403798788c14", "Username": "Paulo" }, { "Id": "55a83578-95e1-4710-8af3-2b7afe310e48", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/55a83578-95e1-4710-8af3-2b7afe310e48", "Username": "JohnD" }, { "Id": "703e27b5-c9f0-4f1f-a239-64ccbb160125", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/703e27b5-c9f0-4f1f-a239-64ccbb160125", "Username": "JohnS" } ] } ``` Weitere Informationen finden Sie unter [Hinzufügen von Benutzern](https://docs.aws.amazon.com/connect/latest/adminguide/user-management.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [ListUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-users.html)in der *AWS CLI Befehlsreferenz*. ### `update-contact-attributes` Das folgende Codebeispiel zeigt die Verwendung`update-contact-attributes`. **AWS CLI** **So aktualisieren Sie das Attribut eines Kontakts** Im folgenden Beispiel für `update-contact-attributes` wird das `greetingPlayed`-Attribut für den angegebenen Amazon-Connect-Benutzer aktualisiert. ``` aws connect update-contact-attributes \ --initial-contact-id 11111111-2222-3333-4444-12345678910 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --attributes greetingPlayed=false ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden von Amazon-Connect-Kontaktattributen](https://docs.aws.amazon.com/connect/latest/adminguide/connect-contact-attributes.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [UpdateContactAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-contact-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-hierarchy` Das folgende Codebeispiel zeigt die Verwendung`update-user-hierarchy`. **AWS CLI** **So aktualisieren Sie die Hierarchie eines Benutzers** Im folgenden Beispiel für `update-user-hierarchy` wird die Kundendienstmitarbeiter-Hierarchie für den angegebenen Amazon-Connect-Benutzer aktualisiert. ``` aws connect update-user-hierarchy \ --hierarchy-group-id 12345678-a1b2-c3d4-e5f6-123456789abc \ --user-id 87654321-2222-1234-1234-111234567891 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurieren von Kundendienstmitarbeiter-Einstellungen](https://docs.aws.amazon.com/connect/latest/adminguide/configure-agents.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [UpdateUserHierarchy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-hierarchy.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-identity-info` Das folgende Codebeispiel zeigt die Verwendung`update-user-identity-info`. **AWS CLI** **So aktualisieren Sie die Identitätsinformationen eines Benutzers** Im folgenden Beispiel für `update-user-identity-info` werden die Identitätsinformationen für den angegebenen Amazon-Connect-Benutzer aktualisiert. ``` aws connect update-user-identity-info \ --identity-info FirstName=Mary,LastName=Major,Email=marym@example.com \ --user-id 87654321-2222-1234-1234-111234567891 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurieren von Kundendienstmitarbeiter-Einstellungen](https://docs.aws.amazon.com/connect/latest/adminguide/configure-agents.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [UpdateUserIdentityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-identity-info.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-phone-config` Das folgende Codebeispiel zeigt die Verwendung`update-user-phone-config`. **AWS CLI** **So aktualisieren Sie die Telefonkonfiguration eines Benutzers** Im folgenden Beispiel für `update-user-phone-config` wird die Telefonkonfiguration für den angegebenen Benutzer aktualisiert. ``` aws connect update-user-phone-config \ --phone-config PhoneType=SOFT_PHONE,AutoAccept=false,AfterContactWorkTimeLimit=60,DeskPhoneNumber=+18005551212 \ --user-id 12345678-4444-3333-2222-111122223333 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurieren von Kundendienstmitarbeiter-Einstellungen](https://docs.aws.amazon.com/connect/latest/adminguide/configure-agents.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [UpdateUserPhoneConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-phone-config.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-routing-profile` Das folgende Codebeispiel zeigt die Verwendung`update-user-routing-profile`. **AWS CLI** **So aktualisieren Sie das Routing-Profil eines Benutzers** Im folgenden Beispiel für `update-user-routing-profile` wird das Routing-Profil für den angegebenen Amazon-Connect-Benutzer aktualisiert. ``` aws connect update-user-routing-profile \ --routing-profile-id 12345678-1111-3333-2222-4444EXAMPLE \ --user-id 87654321-2222-1234-1234-111234567891 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurieren von Kundendienstmitarbeiter-Einstellungen](https://docs.aws.amazon.com/connect/latest/adminguide/configure-agents.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [UpdateUserRoutingProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-routing-profile.html)in der *AWS CLI Befehlsreferenz*. ### `update-user-security-profiles` Das folgende Codebeispiel zeigt die Verwendung`update-user-security-profiles`. **AWS CLI** **So aktualisieren Sie die Sicherheitsprofile eines Benutzers** Im folgenden Beispiel für `update-user-security-profiles` wird das Sicherheitsprofil für den angegebenen Amazon-Connect-Benutzer aktualisiert. ``` aws connect update-user-security-profiles \ --security-profile-ids 12345678-1234-1234-1234-1234567892111 \ --user-id 87654321-2222-1234-1234-111234567891 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Zuweisen von Berechtigungen: Sicherheitsprofile](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html) im *Administratorhandbuch für Amazon Connect*. + Einzelheiten zur API finden Sie [UpdateUserSecurityProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-security-profiles.html)in der *AWS CLI Befehlsreferenz*. # AWS Cost and Usage Report Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Cost and Usage Report. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-report-definition` Das folgende Codebeispiel zeigt, wie Sie`delete-report-definition`. **AWS CLI** **Um einen AWS Kosten- und Nutzungsbericht zu löschen** In diesem Beispiel wird ein AWS Kosten- und Nutzungsbericht gelöscht. Befehl: ``` aws cur --region us-east-1 delete-report-definition --report-name "ExampleReport" ``` + Einzelheiten zur API finden Sie [DeleteReportDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cur/delete-report-definition.html)in der *AWS CLI Befehlsreferenz.* ### `describe-report-definitions` Das folgende Codebeispiel zeigt die Verwendung`describe-report-definitions`. **AWS CLI** **Um eine Liste mit AWS Kosten- und Nutzungsberichten abzurufen** In diesem Beispiel wird eine Liste von AWS Kosten- und Nutzungsberichten beschrieben, die einem Konto gehören. Befehl: ``` aws cur --region us-east-1 describe-report-definitions --max-items 5 ``` Ausgabe: ``` { "ReportDefinitions": [ { "ReportName": "ExampleReport", "Compression": "ZIP", "S3Region": "us-east-1", "Format": "textORcsv", "S3Prefix": "exampleprefix", "S3Bucket": "example-s3-bucket", "TimeUnit": "DAILY", "AdditionalArtifacts": [ "REDSHIFT", "QUICKSIGHT" ], "AdditionalSchemaElements": [ "RESOURCES" ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeReportDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cur/describe-report-definitions.html)in der *AWS CLI Befehlsreferenz*. ### `put-report-definition` Das folgende Codebeispiel zeigt die Verwendung`put-report-definition`. **AWS CLI** **Um AWS Kosten- und Nutzungsberichte zu erstellen** Im folgenden `put-report-definition` Beispiel wird ein täglicher AWS Kosten- und Nutzungsbericht erstellt, den Sie in Amazon Redshift oder Amazon QuickSight hochladen können. ``` aws cur put-report-definition --report-definition file://report-definition.json ``` Inhalt von `report-definition.json`: ``` { "ReportName": "ExampleReport", "TimeUnit": "DAILY", "Format": "textORcsv", "Compression": "ZIP", "AdditionalSchemaElements": [ "RESOURCES" ], "S3Bucket": "example-s3-bucket", "S3Prefix": "exampleprefix", "S3Region": "us-east-1", "AdditionalArtifacts": [ "REDSHIFT", "QUICKSIGHT" ] } ``` + Einzelheiten zur API finden Sie [PutReportDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cur/put-report-definition.html)in der *AWS CLI Befehlsreferenz.* # Beispiele für den Cost Explorer Explorer-Service mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe des With-Cost-Explorer-Dienstes Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `get-cost-and-usage` Das folgende Codebeispiel zeigt, wie Sie`get-cost-and-usage`. **AWS CLI** **So rufen Sie die S3-Nutzung eines Kontos für den Monat September 2017 ab 2017** Im folgenden Beispiel für `get-cost-and-usage` rufen Sie die S3-Nutzung eines Kontos für den Monat September 2017 ab. ``` aws ce get-cost-and-usage \ --time-period Start=2017-09-01,End=2017-10-01 \ --granularity MONTHLY \ --metrics "BlendedCost" "UnblendedCost" "UsageQuantity" \ --group-by Type=DIMENSION,Key=SERVICE Type=TAG,Key=Environment \ --filter file://filters.json ``` Inhalt von `filters.json`: ``` { "Dimensions": { "Key": "SERVICE", "Values": [ "Amazon Simple Storage Service" ] } } ``` Ausgabe: ``` { "GroupDefinitions": [ { "Type": "DIMENSION", "Key": "SERVICE" }, { "Type": "TAG", "Key": "Environment" } ], "ResultsByTime": [ { "Estimated": false, "TimePeriod": { "Start": "2017-09-01", "End": "2017-10-01" }, "Total": {}, "Groups": [ { "Keys": [ "Amazon Simple Storage Service", "Environment$" ], "Metrics": { "BlendedCost": { "Amount": "40.3527508453", "Unit": "USD" }, "UnblendedCost": { "Amount": "40.3543773134", "Unit": "USD" }, "UsageQuantity": { "Amount": "9312771.098461578", "Unit": "N/A" } } }, { "Keys": [ "Amazon Simple Storage Service", "Environment$Dev" ], "Metrics": { "BlendedCost": { "Amount": "0.2682364644", "Unit": "USD" }, "UnblendedCost": { "Amount": "0.2682364644", "Unit": "USD" }, "UsageQuantity": { "Amount": "22403.4395271182", "Unit": "N/A" } } } ] } ] } ``` + Einzelheiten zur API finden Sie [GetCostAndUsage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-cost-and-usage.html)in der *AWS CLI Befehlsreferenz*. ### `get-dimension-values` Das folgende Codebeispiel zeigt die Verwendung`get-dimension-values`. **AWS CLI** **So rufen Sie die Tags für die Dimension SERVICE mit dem Wert „Elastic“ ab"** In diesem Beispiel werden die Tags für die Dimension SERVICE mit dem Wert „Elastic“ für den Zeitraum 1. Januar 2017 bis 18. Mai 2017 abgerufen. Befehl: ``` aws ce get-dimension-values --search-string Elastic --time-period Start=2017-01-01,End=2017-05-18 --dimension SERVICE ``` Ausgabe: ``` { "TotalSize": 6, "DimensionValues": [ { "Attributes": {}, "Value": "Amazon ElastiCache" }, { "Attributes": {}, "Value": "EC2 - Other" }, { "Attributes": {}, "Value": "Amazon Elastic Compute Cloud - Compute" }, { "Attributes": {}, "Value": "Amazon Elastic Load Balancing" }, { "Attributes": {}, "Value": "Amazon Elastic MapReduce" }, { "Attributes": {}, "Value": "Amazon Elasticsearch Service" } ], "ReturnSize": 6 } ``` + Einzelheiten zur API finden Sie [GetDimensionValues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-dimension-values.html)in der *AWS CLI Befehlsreferenz*. ### `get-reservation-coverage` Das folgende Codebeispiel zeigt die Verwendung`get-reservation-coverage`. **AWS CLI** **So rufen Sie die Reservierungsabdeckung für t2.nano-Instances von EC2 in der Region us-east-1 ab** In diesem Beispiel rufen Sie die Reservierungsabdeckung für t2.nano-Instances von EC2 in der Region us-east-1 für Juli bis September 2017 ab. Befehl: ``` aws ce get-reservation-coverage --time-period Start=2017-07-01,End=2017-10-01 --group-by Type=Dimension,Key=REGION --filter file://filters.json ``` filters.json: ``` { "And": [ { "Dimensions": { "Key": "INSTANCE_TYPE", "Values": [ "t2.nano" ] }, "Dimensions": { "Key": "REGION", "Values": [ "us-east-1" ] } } ] } ``` Ausgabe: ``` { "TotalSize": 6, "DimensionValues": [ { "Attributes": {}, "Value": "Amazon ElastiCache" }, { "Attributes": {}, "Value": "EC2 - Other" }, { "Attributes": {}, "Value": "Amazon Elastic Compute Cloud - Compute" }, { "Attributes": {}, "Value": "Amazon Elastic Load Balancing" }, { "Attributes": {}, "Value": "Amazon Elastic MapReduce" }, { "Attributes": {}, "Value": "Amazon Elasticsearch Service" } ], "ReturnSize": 6 } ``` + Einzelheiten zur API finden Sie [GetReservationCoverage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-reservation-coverage.html)in der *AWS CLI Befehlsreferenz*. ### `get-reservation-purchase-recommendation` Das folgende Codebeispiel zeigt die Verwendung`get-reservation-purchase-recommendation`. **AWS CLI** **Um die Reservierungsempfehlungen für Partial Upfront EC2 RIs mit einer Laufzeit von drei Jahren abzurufen** Im folgenden Beispiel für `get-reservation-purchase-recommendation` werden Empfehlungen für EC2-Instances mit teilweiser Vorauszahlung und einer Laufzeit von 3 Jahren abgerufen, basierend auf den letzten 60 Tagen der EC2-Nutzung. ``` aws ce get-reservation-purchase-recommendation \ --service "Amazon Redshift" \ --lookback-period-in-days SIXTY_DAYS \ --term-in-years THREE_YEARS \ --payment-option PARTIAL_UPFRONT ``` Ausgabe: ``` { "Recommendations": [], "Metadata": { "GenerationTimestamp": "2018-08-08T15:20:57Z", "RecommendationId": "00d59dde-a1ad-473f-8ff2-iexample3330b" } } ``` + Einzelheiten zur API finden Sie [GetReservationPurchaseRecommendation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-reservation-purchase-recommendation.html)in der *AWS CLI Befehlsreferenz*. ### `get-reservation-utilization` Das folgende Codebeispiel zeigt die Verwendung`get-reservation-utilization`. **AWS CLI** **So rufen Sie Reservierungsauslastung für Ihr Konto ab** Im folgenden Beispiel für `get-reservation-utilization` wird die RI-Auslastung für alle t2.nano-Instance-Typen vom 01.03.2018 bis 01.08.2018 für das Konto abgerufen. ``` aws ce get-reservation-utilization \ --time-period Start=2018-03-01,End=2018-08-01 \ --filter file://filters.json ``` Inhalt von `filters.json`: ``` { "Dimensions": { "Key": "INSTANCE_TYPE", "Values": [ "t2.nano" ] } } ``` Ausgabe: ``` { "Total": { "TotalAmortizedFee": "0", "UtilizationPercentage": "0", "PurchasedHours": "0", "NetRISavings": "0", "TotalActualHours": "0", "AmortizedRecurringFee": "0", "UnusedHours": "0", "TotalPotentialRISavings": "0", "OnDemandCostOfRIHoursUsed": "0", "AmortizedUpfrontFee": "0" }, "UtilizationsByTime": [] } ``` + Einzelheiten zur API finden Sie [GetReservationUtilization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-reservation-utilization.html)in der *AWS CLI Befehlsreferenz*. ### `get-tags` Das folgende Codebeispiel zeigt die Verwendung`get-tags`. **AWS CLI** **So rufen Sie Schlüssel und Werte für ein Kostenzuordnungs-Tag ab** In diesem Beispiel werden alle Kostenzuordnungs-Tags mit dem Schlüssel „Project“ und einem Wert, der „secretProject“ enthält, abgerufen. Befehl: ``` aws ce get-tags --search-string secretProject --time-period Start=2017-01-01,End=2017-05-18 --tag-key Project ``` Ausgabe: ``` { "ReturnSize": 2, "Tags": [ "secretProject1", "secretProject2" ], "TotalSize": 2 } ``` + Einzelheiten zur API finden Sie [GetTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-tags.html)in der *AWS CLI Befehlsreferenz*. # Firehose-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Firehose Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `list-delivery-streams` Das folgende Codebeispiel zeigt die Verwendung `list-delivery-streams` von. **AWS CLI** **So listen Sie die verfügbaren Bereitstellungsstreams auf** Das folgende `list-delivery-streams` Beispiel listet die verfügbaren Lieferstreams in Ihrem AWS Konto auf. ``` aws firehose list-delivery-streams ``` Ausgabe: ``` { "DeliveryStreamNames": [ "my-stream" ], "HasMoreDeliveryStreams": false } ``` Weitere Informationen finden Sie unter [Erstellen eines Amazon Kinesis Data Firehose-Bereitstellungs-Streams](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) im *Entwicklerhandbuch für Amazon Kinesis Data Firehose*. + Einzelheiten zur API finden Sie [ListDeliveryStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/firehose/list-delivery-streams.html)in der *AWS CLI Befehlsreferenz*. ### `put-record-batch` Das folgende Codebeispiel zeigt die Verwendung`put-record-batch`. **AWS CLI** **So schreiben Sie mehrere Datensätze in einen Stream** Im folgenden Beispiel für `put-record-batch` werden drei Datensätze in einen Stream geschrieben. Die Daten sind im Base64-Format codiert. ``` aws firehose put-record-batch \ --delivery-stream-name my-stream \ --records file://records.json ``` Inhalt von `myfile.json`: ``` [ {"Data": "Rmlyc3QgdGhpbmc="}, {"Data": "U2Vjb25kIHRoaW5n"}, {"Data": "VGhpcmQgdGhpbmc="} ] ``` Ausgabe: ``` { "FailedPutCount": 0, "Encrypted": false, "RequestResponses": [ { "RecordId": "9D2OJ6t2EqCTZTXwGzeSv/EVHxRoRCw89xd+o3+sXg8DhYOaWKPSmZy/CGlRVEys1u1xbeKh6VofEYKkoeiDrcjrxhQp9iF7sUW7pujiMEQ5LzlrzCkGosxQn+3boDnURDEaD42V7GiixpOyLJkYZcae1i7HzlCEoy9LJhMr8EjDSi4Om/9Vc2uhwwuAtGE0XKpxJ2WD7ZRWtAnYlKAnvgSPRgg7zOWL" }, { "RecordId": "jFirejqxCLlK5xjH/UNmlMVcjktEN76I7916X9PaZ+PVaOSXDfU1WGOqEZhxq2js7xcZ552eoeDxsuTU1MSq9nZTbVfb6cQTIXnm/GsuF37Uhg67GKmR5z90l6XKJ+/+pDloFv7Hh9a3oUS6wYm3DcNRLTHHAimANp1PhkQvWpvLRfzbuCUkBphR2QVzhP9OiHLbzGwy8/DfH8sqWEUYASNJKS8GXP5s" }, { "RecordId": "oy0amQ40o5Y2YV4vxzufdcMOOw6n3EPr3tpPJGoYVNKH4APPVqNcbUgefo1stEFRg4hTLrf2k6eliHu/9+YJ5R3iiedHkdsfkIqX0XTySSutvgFYTjNY1TSrK0pM2sWxpjqqnk3+2UX1MV5z88xGro3cQm/DTBt3qBlmTj7Xq8SKVbO1S7YvMTpWkMKA86f8JfmT8BMKoMb4XZS/sOkQLe+qh0sYKXWl" } ] } ``` Weitere Informationen finden Sie unter [Senden von Daten an einen Bereitstellungsstream von Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-write.html) im *Entwicklerhandbuch für Amazon Kinesis Data Firehose*. + Einzelheiten zur API finden Sie [PutRecordBatch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/firehose/put-record-batch.html)in der *AWS CLI Befehlsreferenz*. ### `put-record` Das folgende Codebeispiel zeigt die Verwendung`put-record`. **AWS CLI** **So schreiben Sie einen Datensatz in einen Stream** Im folgenden Beispiel für `put-record` werden Daten in einen Stream geschrieben. Die Daten sind im Base64-Format codiert. ``` aws firehose put-record \ --delivery-stream-name my-stream \ --record '{"Data":"SGVsbG8gd29ybGQ="}' ``` Ausgabe: ``` { "RecordId": "RjB5K/nnoGFHqwTsZlNd/TTqvjE8V5dsyXZTQn2JXrdpMTOwssyEb6nfC8fwf1whhwnItt4mvrn+gsqeK5jB7QjuLg283+Ps4Sz/j1Xujv31iDhnPdaLw4BOyM9Amv7PcCuB2079RuM0NhoakbyUymlwY8yt20G8X2420wu1jlFafhci4erAt7QhDEvpwuK8N1uOQ1EuaKZWxQHDzcG6tk1E49IPeD9k", "Encrypted": false } ``` Weitere Informationen finden Sie unter [Senden von Daten an einen Bereitstellungsstream von Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-write.html) im *Entwicklerhandbuch für Amazon Kinesis Data Firehose*. + Einzelheiten zur API finden Sie [PutRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/firehose/put-record.html)in der *AWS CLI Befehlsreferenz*. # Amazon Data Lifecycle Manager Manager-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Data Lifecycle Manager Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-default-role` Das folgende Codebeispiel zeigt, wie Sie`create-default-role`. **AWS CLI** **So erstellen Sie die erforderliche IAM-Rolle für Amazon DLM** Im folgenden `dlm create-default-role` Beispiel wird die AWS DataLifecycleManagerDefaultRole Standardrolle für die Verwaltung von Snapshots erstellt. ``` aws dlm create-default-role \ --resource-type snapshot ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Standardservicerollen für Amazon Data Lifecycle Manager](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/service-role.html#default-service-roles) im *Benutzerhandbuch für Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie unter [CreateDefaultRole AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/create-default-role.html)*Befehlsreferenz.* ### `create-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`create-lifecycle-policy`. **AWS CLI** **So erstellen Sie eine Lebenszyklusrichtlinie** Im folgenden Beispiel für `create-lifecycle-policy` wird eine Lebenszyklusrichtlinie aufgestellt, die einen täglichen Snapshot der Volumes zum angegebenen Zeitpunkt erstellt. Die angegebenen Tags werden den Snapshots hinzugefügt. Tags werden auch aus dem Volume kopiert und den Snapshots hinzugefügt. Wenn das Erstellen eines neuen Snapshots die angegebene maximale Anzahl überschreitet, wird der älteste Snapshot gelöscht. ``` aws dlm create-lifecycle-policy \ --description "My first policy" \ --state ENABLED \ --execution-role-arn arn:aws:iam::12345678910:role/AWSDataLifecycleManagerDefaultRole \ --policy-details file://policyDetails.json ``` Inhalt von `policyDetails.json`: ``` { "ResourceTypes": [ "VOLUME" ], "TargetTags": [ { "Key": "costCenter", "Value": "115" } ], "Schedules":[ { "Name": "DailySnapshots", "CopyTags": true, "TagsToAdd": [ { "Key": "type", "Value": "myDailySnapshot" } ], "CreateRule": { "Interval": 24, "IntervalUnit": "HOURS", "Times": [ "03:00" ] }, "RetainRule": { "Count":5 } } ] } ``` Ausgabe: ``` { "PolicyId": "policy-0123456789abcdef0" } ``` + Einzelheiten zur API finden Sie [CreateLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/create-lifecycle-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-lifecycle-policy`. **AWS CLI** **So löschen Sie eine Lebenszyklus-Richtlinie** Im folgenden Beispiel wird die angegebene Lebenszyklus-Richtlinie gelöscht: ``` aws dlm delete-lifecycle-policy --policy-id policy-0123456789abcdef0 ``` + Einzelheiten zur API finden Sie [DeleteLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/delete-lifecycle-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-lifecycle-policies` Das folgende Codebeispiel zeigt die Verwendung`get-lifecycle-policies`. **AWS CLI** **So rufen Sie eine Zusammenfassung Ihrer Lebenszyklus-Richtlinien ab** Das folgende Beispiel für `get-lifecycle-policies` listet alle Ihre Lebenszyklus-Richtlinien auf. ``` aws dlm get-lifecycle-policies ``` Ausgabe: ``` { "Policies": [ { "PolicyId": "policy-0123456789abcdef0", "Description": "My first policy", "State": "ENABLED" } ] } ``` + Einzelheiten zur API finden Sie [GetLifecyclePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/get-lifecycle-policies.html)in der *AWS CLI Befehlsreferenz*. ### `get-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`get-lifecycle-policy`. **AWS CLI** **So beschreiben Sie eine Lebenszyklus-Richtlinie** Im folgenden Beispiel für `get-lifecycle-policy` werden die Details für die angegebene Lebenszyklus-Richtlinie angezeigt. ``` aws dlm get-lifecycle-policy \ --policy-id policy-0123456789abcdef0 ``` Ausgabe: ``` { "Policy": { "PolicyId": "policy-0123456789abcdef0", "Description": "My policy", "State": "ENABLED", "ExecutionRoleArn": "arn:aws:iam::123456789012:role/AWSDataLifecycleManagerDefaultRole", "DateCreated": "2019-08-08T17:45:42Z", "DateModified": "2019-08-08T17:45:42Z", "PolicyDetails": { "PolicyType": "EBS_SNAPSHOT_MANAGEMENT", "ResourceTypes": [ "VOLUME" ], "TargetTags": [ { "Key": "costCenter", "Value": "115" } ], "Schedules": [ { "Name": "DailySnapshots", "CopyTags": true, "TagsToAdd": [ { "Key": "type", "Value": "myDailySnapshot" } ], "CreateRule": { "Interval": 24, "IntervalUnit": "HOURS", "Times": [ "03:00" ] }, "RetainRule": { "Count": 5 } } ] } } } ``` + Einzelheiten zur API finden Sie [GetLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/get-lifecycle-policy.html)in der *AWS CLI Befehlsreferenz*. ### `update-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`update-lifecycle-policy`. **AWS CLI** **Beispiel 1: So aktivieren Sie eine Lebenszyklus-Richtlinie** Im folgenden Beispiel für `update-lifecycle-policy` wird die angegebene Lebenszyklus-Richtlinie aktiviert. ``` aws dlm update-lifecycle-policy \ --policy-id policy-0123456789abcdef0 \ --state ENABLED ``` **Beispiel 2: So deaktivieren Sie eine Lebenszyklus-Richtlinie** Im folgenden Beispiel für `update-lifecycle-policy` wird die angegebene Lebenszyklus-Richtlinie deaktiviert. ``` aws dlm update-lifecycle-policy \ --policy-id policy-0123456789abcdef0 \ --state DISABLED ``` **Beispiel 3: So aktualisieren Sie die Details für die Lebenszyklus-Richtlinie** Im folgenden Beispiel für `update-lifecycle-policy` werden die Ziel-Tags für die angegebene Lebenszyklus-Richtlinie aktualisiert. ``` aws dlm update-lifecycle-policy \ --policy-id policy-0123456789abcdef0 --policy-details file://policyDetails.json ``` Inhalt von `policyDetails.json`. Andere Details, auf die in dieser Datei nicht verwiesen wird, werden durch den Befehl nicht geändert. ``` { "TargetTags": [ { "Key": "costCenter", "Value": "120" }, { "Key": "project", "Value": "lima" } ] } ``` + Einzelheiten zur API finden Sie [UpdateLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/update-lifecycle-policy.html)in der *AWS CLI Befehlsreferenz*. # AWS Data Pipeline Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Data Pipeline. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `activate-pipeline` Das folgende Codebeispiel zeigt, wie Sie`activate-pipeline`. **AWS CLI** **Um eine Pipeline zu aktivieren** In diesem Beispiel wird die angegebene Pipeline aktiviert: ``` aws datapipeline activate-pipeline --pipeline-id df-00627471SOVYZEXAMPLE ``` Verwenden Sie den folgenden Befehl, um die Pipeline an einem bestimmten Zeitpunkt zu aktivieren: ``` aws datapipeline activate-pipeline --pipeline-id df-00627471SOVYZEXAMPLE --start-timestamp 2015-04-07T00:00:00Z ``` + Einzelheiten zur API finden Sie [ActivatePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/activate-pipeline.html)in der *AWS CLI Befehlsreferenz*. ### `add-tags` Das folgende Codebeispiel zeigt die Verwendung`add-tags`. **AWS CLI** **So fügen Sie einer Pipeline ein Tag hinzu** In diesem Beispiel wird der angegebenen Pipeline das spezifizierte Tag hinzugefügt: ``` aws datapipeline add-tags --pipeline-id df-00627471SOVYZEXAMPLE --tags key=environment,value=production key=owner,value=sales ``` Verwenden Sie den Befehl describe-pipelines, um die Tags anzuzeigen. Die im Beispielbefehl hinzugefügten Tags werden in der Ausgabe für describe-pipelines wie folgt angezeigt: ``` { ... "tags": [ { "value": "production", "key": "environment" }, { "value": "sales", "key": "owner" } ] ... } ``` + Einzelheiten zur API finden Sie [AddTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/add-tags.html)in der *AWS CLI Befehlsreferenz*. ### `create-pipeline` Das folgende Codebeispiel zeigt die Verwendung`create-pipeline`. **AWS CLI** **Um eine Pipeline zu erstellen** In diesem Beispiel wird eine Pipeline erstellt: ``` aws datapipeline create-pipeline --name my-pipeline --unique-id my-pipeline-token ``` Das Folgende ist eine Beispielausgabe: ``` { "pipelineId": "df-00627471SOVYZEXAMPLE" } ``` + Einzelheiten zur API finden Sie [CreatePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/create-pipeline.html)in der *AWS CLI Befehlsreferenz*. ### `deactivate-pipeline` Das folgende Codebeispiel zeigt die Verwendung`deactivate-pipeline`. **AWS CLI** **Um eine Pipeline zu deaktivieren** In diesem Beispiel wird die angegebene Pipeline deaktiviert: ``` aws datapipeline deactivate-pipeline --pipeline-id df-00627471SOVYZEXAMPLE ``` Verwenden Sie den folgenden Befehl, um die Pipeline erst nach der Ausführung aller Aktivitäten zu deaktivieren: ``` aws datapipeline deactivate-pipeline --pipeline-id df-00627471SOVYZEXAMPLE --no-cancel-active ``` + Einzelheiten zur API finden Sie [DeactivatePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/deactivate-pipeline.html)in der *AWS CLI Befehlsreferenz*. ### `delete-pipeline` Das folgende Codebeispiel zeigt die Verwendung`delete-pipeline`. **AWS CLI** **Um eine Pipeline zu löschen** In diesem Beispiel wird die angegebene Pipeline gelöscht: ``` aws datapipeline delete-pipeline --pipeline-id df-00627471SOVYZEXAMPLE ``` + Einzelheiten zur API finden Sie [DeletePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/delete-pipeline.html)in der *AWS CLI Befehlsreferenz*. ### `describe-pipelines` Das folgende Codebeispiel zeigt die Verwendung`describe-pipelines`. **AWS CLI** **So beschreiben Sie Ihre Pipelines** In diesem Beispiel wird die angegebene Pipeline beschrieben: ``` aws datapipeline describe-pipelines --pipeline-ids df-00627471SOVYZEXAMPLE ``` Das Folgende ist eine Beispielausgabe: ``` { "pipelineDescriptionList": [ { "fields": [ { "stringValue": "PENDING", "key": "@pipelineState" }, { "stringValue": "my-pipeline", "key": "name" }, { "stringValue": "2015-04-07T16:05:58", "key": "@creationTime" }, { "stringValue": "df-00627471SOVYZEXAMPLE", "key": "@id" }, { "stringValue": "123456789012", "key": "pipelineCreator" }, { "stringValue": "PIPELINE", "key": "@sphere" }, { "stringValue": "123456789012", "key": "@userId" }, { "stringValue": "123456789012", "key": "@accountId" }, { "stringValue": "my-pipeline-token", "key": "uniqueId" } ], "pipelineId": "df-00627471SOVYZEXAMPLE", "name": "my-pipeline", "tags": [] } ] } ``` + Einzelheiten zur API finden Sie [DescribePipelines](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/describe-pipelines.html)in der *AWS CLI Befehlsreferenz*. ### `get-pipeline-definition` Das folgende Codebeispiel zeigt die Verwendung`get-pipeline-definition`. **AWS CLI** **So rufen Sie eine Pipeline-Definition ab** Dieses Beispiel ruft die Pipeline-Definition für die angegebene Pipeline ab: ``` aws datapipeline get-pipeline-definition --pipeline-id df-00627471SOVYZEXAMPLE ``` Das Folgende ist eine Beispielausgabe: ``` { "parameters": [ { "type": "AWS::S3::ObjectKey", "id": "myS3OutputLoc", "description": "S3 output folder" }, { "default": "s3://us-east-1.elasticmapreduce.samples/pig-apache-logs/data", "type": "AWS::S3::ObjectKey", "id": "myS3InputLoc", "description": "S3 input folder" }, { "default": "grep -rc \"GET\" ${INPUT1_STAGING_DIR}/* > ${OUTPUT1_STAGING_DIR}/output.txt", "type": "String", "id": "myShellCmd", "description": "Shell command to run" } ], "objects": [ { "type": "Ec2Resource", "terminateAfter": "20 Minutes", "instanceType": "t1.micro", "id": "EC2ResourceObj", "name": "EC2ResourceObj" }, { "name": "Default", "failureAndRerunMode": "CASCADE", "resourceRole": "DataPipelineDefaultResourceRole", "schedule": { "ref": "DefaultSchedule" }, "role": "DataPipelineDefaultRole", "scheduleType": "cron", "id": "Default" }, { "directoryPath": "#{myS3OutputLoc}/#{format(@scheduledStartTime, 'YYYY-MM-dd-HH-mm-ss')}", "type": "S3DataNode", "id": "S3OutputLocation", "name": "S3OutputLocation" }, { "directoryPath": "#{myS3InputLoc}", "type": "S3DataNode", "id": "S3InputLocation", "name": "S3InputLocation" }, { "startAt": "FIRST_ACTIVATION_DATE_TIME", "name": "Every 15 minutes", "period": "15 minutes", "occurrences": "4", "type": "Schedule", "id": "DefaultSchedule" }, { "name": "ShellCommandActivityObj", "command": "#{myShellCmd}", "output": { "ref": "S3OutputLocation" }, "input": { "ref": "S3InputLocation" }, "stage": "true", "type": "ShellCommandActivity", "id": "ShellCommandActivityObj", "runsOn": { "ref": "EC2ResourceObj" } } ], "values": { "myS3OutputLoc": "s3://amzn-s3-demo-bucket/", "myS3InputLoc": "s3://us-east-1.elasticmapreduce.samples/pig-apache-logs/data", "myShellCmd": "grep -rc \"GET\" ${INPUT1_STAGING_DIR}/* > ${OUTPUT1_STAGING_DIR}/output.txt" } } ``` + Einzelheiten zur API finden Sie [GetPipelineDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/get-pipeline-definition.html)in der *AWS CLI Befehlsreferenz*. ### `list-pipelines` Das folgende Codebeispiel zeigt die Verwendung`list-pipelines`. **AWS CLI** **So listen Sie Ihre Pipelines auf** In diesem Beispiel werden Ihre Pipelines aufgelistet: ``` aws datapipeline list-pipelines ``` Das Folgende ist eine Beispielausgabe: ``` { "pipelineIdList": [ { "id": "df-00627471SOVYZEXAMPLE", "name": "my-pipeline" }, { "id": "df-09028963KNVMREXAMPLE", "name": "ImportDDB" }, { "id": "df-0870198233ZYVEXAMPLE", "name": "CrossRegionDDB" }, { "id": "df-00189603TB4MZEXAMPLE", "name": "CopyRedshift" } ] } ``` + Einzelheiten zur API finden Sie [ListPipelines](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/list-pipelines.html)in der *AWS CLI Befehlsreferenz*. ### `list-runs` Das folgende Codebeispiel zeigt die Verwendung`list-runs`. **AWS CLI** **Beispiel 1: So listen Sie Ihre Pipeline-Läufe auf** Im folgenden Beispiel für `list-runs` werden die Läufe für die angegebene Pipeline aufgelistet. ``` aws datapipeline list-runs --pipeline-id df-00627471SOVYZEXAMPLE ``` Ausgabe: ``` Name Scheduled Start Status ID Started Ended ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 1. EC2ResourceObj 2015-04-12T17:33:02 CREATING @EC2ResourceObj_2015-04-12T17:33:02 2015-04-12T17:33:10 2. S3InputLocation 2015-04-12T17:33:02 FINISHED @S3InputLocation_2015-04-12T17:33:02 2015-04-12T17:33:09 2015-04-12T17:33:09 3. S3OutputLocation 2015-04-12T17:33:02 WAITING_ON_DEPENDENCIES @S3OutputLocation_2015-04-12T17:33:02 2015-04-12T17:33:09 4. ShellCommandActivityObj 2015-04-12T17:33:02 WAITING_FOR_RUNNER @ShellCommandActivityObj_2015-04-12T17:33:02 2015-04-12T17:33:09 ``` **Beispiel 2: So listen Sie die Pipeline-Läufe zwischen den angegebenen Daten auf** Im folgenden Beispiel für `list-runs` wird `--start-interval` verwendet, um die Daten anzugeben, die in die Ausgabe aufgenommen werden sollen. ``` aws datapipeline list-runs --pipeline-id df-01434553B58A2SHZUKO5 --start-interval 2017-10-07T00:00:00,2017-10-08T00:00:00 ``` + Einzelheiten zur API finden Sie [ListRuns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/list-runs.html)in der *AWS CLI Befehlsreferenz*. ### `put-pipeline-definition` Das folgende Codebeispiel zeigt die Verwendung`put-pipeline-definition`. **AWS CLI** **So laden Sie eine Pipeline-Definition hoch** Dieses Beispiel lädt die angegebene Pipeline-Definition auf die spezifizierte Pipeline hoch: ``` aws datapipeline put-pipeline-definition --pipeline-id df-00627471SOVYZEXAMPLE --pipeline-definition file://my-pipeline-definition.json ``` Das Folgende ist eine Beispielausgabe: ``` { "validationErrors": [], "errored": false, "validationWarnings": [] } ``` + Einzelheiten zur API finden Sie [PutPipelineDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/put-pipeline-definition.html)in der *AWS CLI Befehlsreferenz*. ### `remove-tags` Das folgende Codebeispiel zeigt die Verwendung`remove-tags`. **AWS CLI** **So entfernen Sie ein Tag aus einer Pipeline** In diesem Beispiel wird das spezifizierte Tag aus der angegebenen Pipeline entfernt: ``` aws datapipeline remove-tags --pipeline-id df-00627471SOVYZEXAMPLE --tag-keys environment ``` + Einzelheiten zur API finden Sie [RemoveTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datapipeline/remove-tags.html)in der *AWS CLI Befehlsreferenz*. # DataSync Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren DataSync. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `update-location-azure-blob` Das folgende Codebeispiel zeigt, wie Sie`update-location-azure-blob`. **AWS CLI** **So aktualisieren Sie Ihren Übertragungsort mit einem neuen Agenten** Im folgenden `update-location-object-storage` Beispiel wird Ihr DataSync Standort für Microsoft Azure Blob Storage mit einem neuen Agenten aktualisiert. ``` aws datasync update-location-azure-blob \ --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \ --agent-arns arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 \ --sas-configuration '{ \ "Token": "sas-token-for-azure-blob-storage-access" \ }' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS DataSync Benutzerhandbuch* unter [Austauschen Ihres Agenten](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html). + Einzelheiten zur API finden Sie [UpdateLocationAzureBlob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-azure-blob.html)in der *AWS CLI Befehlsreferenz*. ### `update-location-hdfs` Das folgende Codebeispiel zeigt die Verwendung`update-location-hdfs`. **AWS CLI** **So aktualisieren Sie Ihren Übertragungsort mit einem neuen Agenten** Im folgenden `update-location-hdfs` Beispiel wird Ihr DataSync HDFS-Standort mit einem neuen Agenten aktualisiert. Sie benötigen die Optionen `--kerberos-keytab` und `--kerberos-krb5-conf` nur, wenn Ihr HDFS-Cluster die Kerberos-Authentifizierung verwendet. ``` aws datasync update-location-hdfs \ --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \ --agent-arns arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 \ --kerberos-keytab file://hdfs.keytab --kerberos-krb5-conf file://krb5.conf ``` Inhalt von `hdfs.keytab`: ``` N/A. The content of this file is encrypted and not human readable. ``` Inhalt von `krb5.conf`: ``` [libdefaults] default_realm = EXAMPLE.COM dns_lookup_realm = false dns_lookup_kdc = false rdns = true ticket_lifetime = 24h forwardable = true udp_preference_limit = 1000000 default_tkt_enctypes = aes256-cts-hmac-sha1-96 aes128-cts-hmac-sha1-96 des3-cbc-sha1 default_tgs_enctypes = aes256-cts-hmac-sha1-96 aes128-cts-hmac-sha1-96 des3-cbc-sha1 permitted_enctypes = aes256-cts-hmac-sha1-96 aes128-cts-hmac-sha1-96 des3-cbc-sha1 [realms] EXAMPLE.COM = { kdc = kdc1.example.com admin_server = krbadmin.example.com default_domain = example.com } [domain_realm] .example.com = EXAMPLE.COM example.com = EXAMPLE.COM [logging] kdc = FILE:/var/log/krb5kdc.log admin_server = FILE:/var/log/kerberos/kadmin.log default = FILE:/var/log/krb5libs.log ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS DataSync Benutzerhandbuch* unter [Austauschen Ihres Agenten](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html). + Einzelheiten zur API finden Sie [UpdateLocationHdfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-hdfs.html)in der *AWS CLI Befehlsreferenz*. ### `update-location-nfs` Das folgende Codebeispiel zeigt die Verwendung`update-location-nfs`. **AWS CLI** **So aktualisieren Sie Ihren Übertragungsort mit einem neuen Agenten** Im folgenden `update-location-nfs` Beispiel wird Ihr DataSync NFS-Standort mit einem neuen Agenten aktualisiert. ``` aws datasync update-location-nfs \ --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \ --on-prem-config AgentArns=arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS DataSync Benutzerhandbuch* unter [Austauschen Ihres Agenten](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html). + Einzelheiten zur API finden Sie [UpdateLocationNfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-nfs.html)in der *AWS CLI Befehlsreferenz*. ### `update-location-object-storage` Das folgende Codebeispiel zeigt die Verwendung`update-location-object-storage`. **AWS CLI** **So aktualisieren Sie Ihren Übertragungsort mit einem neuen Agenten** Im folgenden `update-location-object-storage` Beispiel wird Ihr DataSync Objektspeicherort mit einem neuen Agenten aktualisiert. ``` aws datasync update-location-object-storage \ --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \ --agent-arns arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 \ --secret-key secret-key-for-object-storage ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS DataSync Benutzerhandbuch* unter [Austauschen Ihres Agenten](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html). + Einzelheiten zur API finden Sie [UpdateLocationObjectStorage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-object-storage.html)in der *AWS CLI Befehlsreferenz*. ### `update-location-smb` Das folgende Codebeispiel zeigt die Verwendung`update-location-smb`. **AWS CLI** **So aktualisieren Sie Ihren Übertragungsort mit einem neuen Agenten** Im folgenden `update-location-smb` Beispiel wird Ihr DataSync SMB-Standort mit einem neuen Agenten aktualisiert. ``` aws datasync update-location-smb \ --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \ --agent-arns arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 \ --password smb-file-server-password ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS DataSync Benutzerhandbuch* unter [Austauschen Ihres Agenten](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html). + Einzelheiten zur API finden Sie [UpdateLocationSmb](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-smb.html)in der *AWS CLI Befehlsreferenz*. # DAX-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface mit DAX Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-cluster` Das folgende Codebeispiel zeigt, wie Sie`create-cluster`. **AWS CLI** **Um einen DAX-Cluster zu erstellen** Im folgenden Beispiel für `create-cluster` wird ein DAX-Cluster mit den angegebenen Einstellungen erstellt. ``` aws dax create-cluster \ --cluster-name daxcluster \ --node-type dax.r4.large \ --replication-factor 3 \ --iam-role-arn roleARN \ --sse-specification Enabled=true ``` Ausgabe: ``` { "Cluster": { "ClusterName": "daxcluster", "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster", "TotalNodes": 3, "ActiveNodes": 0, "NodeType": "dax.r4.large", "Status": "creating", "ClusterDiscoveryEndpoint": { "Port": 8111 }, "PreferredMaintenanceWindow": "thu:13:00-thu:14:00", "SubnetGroup": "default", "SecurityGroups": [ { "SecurityGroupIdentifier": "sg-1af6e36e", "Status": "active" } ], "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess", "ParameterGroup": { "ParameterGroupName": "default.dax1.0", "ParameterApplyStatus": "in-sync", "NodeIdsToReboot": [] }, "SSEDescription": { "Status": "ENABLED" } } } ``` Weitere Informationen finden Sie unter [Schritt 3: Erstellen eines DAX-Clusters](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.create-cluster.cli.create-cluster.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/create-cluster.html)unter *AWS CLI Befehlsreferenz*. ### `create-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`create-parameter-group`. **AWS CLI** **Um eine Parametergruppe zu erstellen** Das folgende create-parameter-group ````-Beispiel erstellt eine Parametergruppe mit den angegebenen Einstellungen. ``` aws dax create-parameter-group \ --parameter-group-name daxparametergroup \ --description "A new parameter group" ``` Ausgabe: ``` { "ParameterGroup": { "ParameterGroupName": "daxparametergroup", "Description": "A new parameter group" } } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html#DAX.cluster-management.custom-settings.ttl) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [CreateParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/create-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`create-subnet-group`. **AWS CLI** **So erstellen Sie eine DAX-Subnetzgruppe** Im folgenden Beispiel für `create-subnet-group` wird eine Subnetzgruppe mit den angegebenen Einstellungen erstellt. ``` aws dax create-subnet-group \ --subnet-group-name daxSubnetGroup \ --subnet-ids subnet-11111111 subnet-22222222 ``` Ausgabe: ``` { "SubnetGroup": { "SubnetGroupName": "daxSubnetGroup", "VpcId": "vpc-05a1fa8e00c325226", "Subnets": [ { "SubnetIdentifier": "subnet-11111111", "SubnetAvailabilityZone": "us-west-2b" }, { "SubnetIdentifier": "subnet-22222222", "SubnetAvailabilityZone": "us-west-2c" } ] } } ``` Weitere Informationen finden Sie unter [Schritt 2: Erstellen einer Subnetzgruppe](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.create-cluster.cli.create-subnet-group.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [CreateSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/create-subnet-group.html)in der *AWS CLI Befehlsreferenz*. ### `decrease-replication-factor` Das folgende Codebeispiel zeigt die Verwendung`decrease-replication-factor`. **AWS CLI** **So entfernen Sie einen oder mehrere Knoten aus dem Cluster** Im folgenden Beispiel für `decrease-replication-factor` wird die Anzahl der Knoten im angegebenen DAX-Cluster auf 1 reduziert. ``` aws dax decrease-replication-factor \ --cluster-name daxcluster \ --new-replication-factor 1 ``` Ausgabe: ``` { "Cluster": { "ClusterName": "daxcluster", "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster", "TotalNodes": 3, "ActiveNodes": 3, "NodeType": "dax.r4.large", "Status": "modifying", "ClusterDiscoveryEndpoint": { "Address": "daxcluster.ey3o9d.clustercfg.dax.usw2.cache.amazonaws.com", "Port": 8111 }, "Nodes": [ { "NodeId": "daxcluster-a", "Endpoint": { "Address": "daxcluster-a.ey3o9d.0001.dax.usw2.cache.amazonaws.com", "Port": 8111 }, "NodeCreateTime": 1576625059.509, "AvailabilityZone": "us-west-2c", "NodeStatus": "available", "ParameterGroupStatus": "in-sync" }, { "NodeId": "daxcluster-b", "Endpoint": { "Address": "daxcluster-b.ey3o9d.0001.dax.usw2.cache.amazonaws.com", "Port": 8111 }, "NodeCreateTime": 1576625059.509, "AvailabilityZone": "us-west-2a", "NodeStatus": "available", "ParameterGroupStatus": "in-sync" }, { "NodeId": "daxcluster-c", "Endpoint": { "Address": "daxcluster-c.ey3o9d.0001.dax.usw2.cache.amazonaws.com", "Port": 8111 }, "NodeCreateTime": 1576625059.509, "AvailabilityZone": "us-west-2b", "NodeStatus": "available", "ParameterGroupStatus": "in-sync" } ], "PreferredMaintenanceWindow": "thu:13:00-thu:14:00", "SubnetGroup": "default", "SecurityGroups": [ { "SecurityGroupIdentifier": "sg-1af6e36e", "Status": "active" } ], "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess", "ParameterGroup": { "ParameterGroupName": "default.dax1.0", "ParameterApplyStatus": "in-sync", "NodeIdsToReboot": [] }, "SSEDescription": { "Status": "ENABLED" } } } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html#DAX.cluster-management.custom-settings) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DecreaseReplicationFactor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/decrease-replication-factor.html)in der *AWS CLI Befehlsreferenz*. ### `delete-cluster` Das folgende Codebeispiel zeigt die Verwendung`delete-cluster`. **AWS CLI** **Um einen DAX-Cluster zu löschen** Im folgenden Beispiel für `delete-cluster` wird der angegebene DAX-Cluster gelöscht. ``` aws dax delete-cluster \ --cluster-name daxcluster ``` Ausgabe: ``` { "Cluster": { "ClusterName": "daxcluster", "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster", "TotalNodes": 3, "ActiveNodes": 0, "NodeType": "dax.r4.large", "Status": "deleting", "ClusterDiscoveryEndpoint": { "Address": "dd.ey3o9d.clustercfg.dax.usw2.cache.amazonaws.com", "Port": 8111 }, "PreferredMaintenanceWindow": "fri:06:00-fri:07:00", "SubnetGroup": "default", "SecurityGroups": [ { "SecurityGroupIdentifier": "sg-1af6e36e", "Status": "active" } ], "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess", "ParameterGroup": { "ParameterGroupName": "default.dax1.0", "ParameterApplyStatus": "in-sync", "NodeIdsToReboot": [] }, "SSEDescription": { "Status": "ENABLED" } } } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html#DAX.cluster-management.deleting) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/delete-cluster.html)unter *AWS CLI Befehlsreferenz*. ### `delete-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`delete-parameter-group`. **AWS CLI** **Um eine Parametergruppe zu löschen** Im folgenden Beispiel für `delete-parameter-group` wird die angegebene DAX-Parametergruppe gelöscht. ``` aws dax delete-parameter-group \ --parameter-group-name daxparametergroup ``` Ausgabe: ``` { "DeletionMessage": "Parameter group daxparametergroup has been deleted." } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DeleteParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/delete-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`delete-subnet-group`. **AWS CLI** **Um eine Subnetzgruppe zu löschen** Im folgenden Beispiel für `delete-subnet-group` wird die angegebene DAX-Subnetzgruppe gelöscht. ``` aws dax delete-subnet-group \ --subnet-group-name daxSubnetGroup ``` Ausgabe: ``` { "DeletionMessage": "Subnet group daxSubnetGroup has been deleted." } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DeleteSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/delete-subnet-group.html)in der *AWS CLI Befehlsreferenz.* ### `describe-clusters` Das folgende Codebeispiel zeigt die Verwendung`describe-clusters`. **AWS CLI** **So geben Sie Informationen über alle bereitgestellten DAX-Cluster zurück** Im folgenden Beispiel für `describe-clusters` werden Details zu allen bereitgestellten DAX-Clustern angezeigt. ``` aws dax describe-clusters ``` Ausgabe: ``` { "Clusters": [ { "ClusterName": "daxcluster", "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster", "TotalNodes": 1, "ActiveNodes": 1, "NodeType": "dax.r4.large", "Status": "available", "ClusterDiscoveryEndpoint": { "Address": "daxcluster.ey3o9d.clustercfg.dax.usw2.cache.amazonaws.com", "Port": 8111 }, "Nodes": [ { "NodeId": "daxcluster-a", "Endpoint": { "Address": "daxcluster-a.ey3o9d.0001.dax.usw2.cache.amazonaws.com", "Port": 8111 }, "NodeCreateTime": 1576625059.509, "AvailabilityZone": "us-west-2c", "NodeStatus": "available", "ParameterGroupStatus": "in-sync" } ], "PreferredMaintenanceWindow": "thu:13:00-thu:14:00", "SubnetGroup": "default", "SecurityGroups": [ { "SecurityGroupIdentifier": "sg-1af6e36e", "Status": "active" } ], "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess", "ParameterGroup": { "ParameterGroupName": "default.dax1.0", "ParameterApplyStatus": "in-sync", "NodeIdsToReboot": [] }, "SSEDescription": { "Status": "ENABLED" } } ] } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/describe-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-default-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-default-parameters`. **AWS CLI** **So geben Sie die Standard-Systemparameterinformationen für DAX zurück** Im folgenden Beispiel für `describe-default-parameters` werden die Standardsystemparameter für DAX angezeigt. ``` aws dax describe-default-parameters ``` Ausgabe: ``` { "Parameters": [ { "ParameterName": "query-ttl-millis", "ParameterType": "DEFAULT", "ParameterValue": "300000", "NodeTypeSpecificValues": [], "Description": "Duration in milliseconds for queries to remain cached", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": "TRUE", "ChangeType": "IMMEDIATE" }, { "ParameterName": "record-ttl-millis", "ParameterType": "DEFAULT", "ParameterValue": "300000", "NodeTypeSpecificValues": [], "Description": "Duration in milliseconds for records to remain valid in cache (Default: 0 = infinite)", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": "TRUE", "ChangeType": "IMMEDIATE" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeDefaultParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/describe-default-parameters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-events` Das folgende Codebeispiel zeigt die Verwendung`describe-events`. **AWS CLI** **So geben Sie alle Ereignisse im Zusammenhang mit DAX-Clustern und Parametergruppen zurück** Im folgenden Beispiel für `describe-events` werden Details zu Ereignissen angezeigt, die sich auf DAX-Cluster und Parametergruppen beziehen. ``` aws dax describe-events ``` Ausgabe: ``` { "Events": [ { "SourceName": "daxcluster", "SourceType": "CLUSTER", "Message": "Cluster deleted.", "Date": 1576702736.706 }, { "SourceName": "daxcluster", "SourceType": "CLUSTER", "Message": "Removed node daxcluster-b.", "Date": 1576702691.738 }, { "SourceName": "daxcluster", "SourceType": "CLUSTER", "Message": "Removed node daxcluster-a.", "Date": 1576702633.498 }, { "SourceName": "daxcluster", "SourceType": "CLUSTER", "Message": "Removed node daxcluster-c.", "Date": 1576702631.329 }, { "SourceName": "daxcluster", "SourceType": "CLUSTER", "Message": "Cluster created.", "Date": 1576626560.057 } ] } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/describe-events.html)in der *AWS CLI Befehlsreferenz*. ### `describe-parameter-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-parameter-groups`. **AWS CLI** **So beschreiben Sie die in DAX definierten Parametergruppen** Im folgenden Beispiel für `describe-parameter-groups` werden Details zu den Parametergruppen abgerufen, die in DAX definiert sind. ``` aws dax describe-parameter-groups ``` Ausgabe: ``` { "ParameterGroups": [ { "ParameterGroupName": "default.dax1.0", "Description": "Default parameter group for dax1.0" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/describe-parameter-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-parameters`. **AWS CLI** **So beschreiben Sie die Parameter in einer DB-Parametergruppe** Im folgenden Beispiel für `describe-parameters` werden Details zu den Parametern abgerufen, die in der angegebenen DAX-Parametergruppe definiert sind. ``` aws dax describe-parameters \ --parameter-group-name default.dax1.0 ``` Ausgabe: ``` { "Parameters": [ { "ParameterName": "query-ttl-millis", "ParameterType": "DEFAULT", "ParameterValue": "300000", "NodeTypeSpecificValues": [], "Description": "Duration in milliseconds for queries to remain cached", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": "TRUE", "ChangeType": "IMMEDIATE" }, { "ParameterName": "record-ttl-millis", "ParameterType": "DEFAULT", "ParameterValue": "300000", "NodeTypeSpecificValues": [], "Description": "Duration in milliseconds for records to remain valid in cache (Default: 0 = infinite)", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": "TRUE", "ChangeType": "IMMEDIATE" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/describe-parameters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-subnet-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-subnet-groups`. **AWS CLI** **So beschreiben Sie in DAX definierte Subnetzgruppen** Im folgenden Beispiel für `describe-subnet-groups` werden Details zu den Subnetzgruppen abgerufen, die in DAX definiert sind. ``` aws dax describe-subnet-groups ``` Ausgabe: ``` { "SubnetGroups": [ { "SubnetGroupName": "default", "Description": "Default CacheSubnetGroup", "VpcId": "vpc-ee70a196", "Subnets": [ { "SubnetIdentifier": "subnet-874953af", "SubnetAvailabilityZone": "us-west-2d" }, { "SubnetIdentifier": "subnet-bd3d1fc4", "SubnetAvailabilityZone": "us-west-2a" }, { "SubnetIdentifier": "subnet-72c2ff28", "SubnetAvailabilityZone": "us-west-2c" }, { "SubnetIdentifier": "subnet-09e6aa42", "SubnetAvailabilityZone": "us-west-2b" } ] } ] } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.concepts.cluster.html#DAX.concepts.cluster.security) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/describe-subnet-groups.html)in der *AWS CLI Befehlsreferenz*. ### `increase-replication-factor` Das folgende Codebeispiel zeigt die Verwendung`increase-replication-factor`. **AWS CLI** **So erhöhen Sie den Replikationsfaktor für einen DAX-Cluster** Im folgenden Beispiel für `increase-replication-factor` wird der Replikationsfaktor des angegebenen DAX-Clusters auf 3 erhöht. ``` aws dax increase-replication-factor \ --cluster-name daxcluster \ --new-replication-factor 3 ``` Ausgabe: ``` { "Cluster": { "ClusterName": "daxcluster", "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster", "TotalNodes": 3, "ActiveNodes": 1, "NodeType": "dax.r4.large", "Status": "modifying", "ClusterDiscoveryEndpoint": { "Address": "daxcluster.ey3o9d.clustercfg.dax.usw2.cache.amazonaws.com", "Port": 8111 }, "Nodes": [ { "NodeId": "daxcluster-a", "Endpoint": { "Address": "daxcluster-a.ey3o9d.0001.dax.usw2.cache.amazonaws.com", "Port": 8111 }, "NodeCreateTime": 1576625059.509, "AvailabilityZone": "us-west-2c", "NodeStatus": "available", "ParameterGroupStatus": "in-sync" }, { "NodeId": "daxcluster-b", "NodeStatus": "creating" }, { "NodeId": "daxcluster-c", "NodeStatus": "creating" } ], "PreferredMaintenanceWindow": "thu:13:00-thu:14:00", "SubnetGroup": "default", "SecurityGroups": [ { "SecurityGroupIdentifier": "sg-1af6e36e", "Status": "active" } ], "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess", "ParameterGroup": { "ParameterGroupName": "default.dax1.0", "ParameterApplyStatus": "in-sync", "NodeIdsToReboot": [] }, "SSEDescription": { "Status": "ENABLED" } } } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html#DAX.cluster-management.custom-settings) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [IncreaseReplicationFactor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/increase-replication-factor.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags` Das folgende Codebeispiel zeigt die Verwendung`list-tags`. **AWS CLI** **So listen Sie Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags` werden die Tag-Schlüssel und Werte aufgelistet, die an den angegebenen DAX-Cluster angehängt sind. ``` aws dax list-tags \ --resource-name arn:aws:dax:us-west-2:123456789012:cache/daxcluster ``` Ausgabe: ``` { "Tags": [ { "Key": "ClusterUsage", "Value": "prod" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html#DAX.management.tagging) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [ListTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/list-tags.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` werden der angegebene Tag-Schlüsselname und der zugehörige Wert an den angegebenen DAX-Cluster angehängt, um die Clusterauslastung zu beschreiben. ``` aws dax tag-resource \ --resource-name arn:aws:dax:us-west-2:123456789012:cache/daxcluster \ --tags="Key=ClusterUsage,Value=prod" ``` Ausgabe: ``` { "Tags": [ { "Key": "ClusterUsage", "Value": "prod" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html#DAX.management.tagging) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einer DAX-Ressource** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem angegebenen Schlüsselnamen von einem DAX-Cluster entfernt. ``` aws dax untag-resource \ --resource-name arn:aws:dax:us-west-2:123456789012:cache/daxcluster \ --tag-keys="ClusterUsage" ``` Ausgabe: ``` { "Tags": [] } ``` Weitere Informationen finden Sie unter [Verwalten von DAX-Clustern](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.cluster-management.html#DAX.management.tagging) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dax/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Detective mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Detective Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `accept-invitation` Das folgende Codebeispiel zeigt, wie Sie`accept-invitation`. **AWS CLI** **So nehmen Sie eine Einladung für ein Mitgliedskonto in einem Verhaltensdiagramm an** Im folgenden Beispiel für `accept-invitation` wird eine Einladung, ein Mitgliedskonto im Verhaltensdiagramm arn:aws:detective:us-east-1:111122223333:graph:123412341234 zu werden, angenommen. ``` aws detective accept-invitation \ --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Antworten auf eine Einladung zu einem Verhaltensdiagramm](https://docs.aws.amazon.com/detective/latest/adminguide/member-invitation-response.html) im *Administratorhandbuch für Amazon Detective*. + Einzelheiten zur API finden Sie [AcceptInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/accept-invitation.html)in der *AWS CLI Befehlsreferenz*. ### `create-graph` Das folgende Codebeispiel zeigt die Verwendung`create-graph`. **AWS CLI** **So aktivieren Sie Amazon Detective und erstellen ein neues Verhaltensdiagramm** Im folgenden `create-graph` Beispiel wird Detective für das AWS Konto aktiviert, das den Befehl in der Region ausführt, in der der Befehl ausgeführt wird. Es wird ein neues Verhaltensdiagramm erstellt, das dieses Konto als Administratorkonto verwendet. Der Befehl weist dem Department-Tag außerdem den Wert Finance zu. ``` aws detective create-graph \ --tags '{"Department": "Finance"}' ``` Ausgabe: ``` { "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899" } ``` Weitere Informationen finden Sie unter [Aktivieren von Amazon Detective](https://docs.aws.amazon.com/detective/latest/adminguide/detective-enabling.html) im *Administratorhandbuch für Amazon Detective*. + Einzelheiten zur API finden Sie [CreateGraph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/create-graph.html)unter *AWS CLI Befehlsreferenz*. ### `create-members` Das folgende Codebeispiel zeigt die Verwendung`create-members`. **AWS CLI** **So laden Sie Mitgliedskonten zu einem Verhaltensdiagramm ein** Im folgenden `create-members` Beispiel werden zwei AWS Konten eingeladen, Mitgliedskonten im Verhaltensdiagramm arn:aws:detective:us-east- 1:111122223333:graph:123412341234 zu werden. Für jedes Konto enthält AWS die Anfrage die Konto-ID und die E-Mail-Adresse des Root-Benutzers des Kontos. Die Anforderung enthält eine benutzerdefinierte Nachricht, die in die Einladungs-E-Mail eingefügt werden kann. ``` 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." ``` Ausgabe: ``` { "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": [ ] } ``` Weitere Informationen finden Sie unter Mitgliedskonten zu einem Verhaltensdiagramm einladen< https://docs.aws.amazon.com/detective/ latest/adminguide/graph - admin-add-member-accounts .html> im *Amazon Detective* Administration Guide. **So laden Sie Mitgliedskonten ein, ohne Einladungs-E-Mails zu senden** Im folgenden `create-members` Beispiel werden zwei AWS Konten eingeladen, Mitgliedskonten im Verhaltensdiagramm arn:aws:detective:us-east- 1:111122223333:graph:123412341234 zu werden. Für jedes Konto enthält AWS die Anfrage die Konto-ID und die E-Mail-Adresse des Root-Benutzers des Kontos. Die Mitgliedskonten erhalten keine Einladungs-E-Mails. ``` 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 ``` Ausgabe: ``` { "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": [ ] } ``` Weitere Informationen finden Sie unter Mitgliedskonten zu einem Verhaltensdiagramm einladen< https://docs.aws.amazon.com/detective/ latest/adminguide/graph - admin-add-member-accounts .html> im *Amazon Detective* Administration Guide. + *Einzelheiten zur API finden Sie [CreateMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/create-members.html)in AWS CLI der Befehlsreferenz.* ### `delete-graph` Das folgende Codebeispiel zeigt die Verwendung`delete-graph`. **AWS CLI** **So deaktivieren Sie Detective und löschen das Verhaltensdiagramm** Im folgenden Beispiel für `delete-graph` wird Detective deaktiviert und das angegebene Verhaltensdiagramm gelöscht. ``` aws detective delete-graph \ --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Deaktivieren von Amazon Detective](https://docs.aws.amazon.com/detective/latest/adminguide/detective-disabling.html) im *Administratorhandbuch für Amazon Detective*. + Einzelheiten zur API finden Sie [DeleteGraph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/delete-graph.html)in der *AWS CLI Befehlsreferenz*. ### `delete-members` Das folgende Codebeispiel zeigt die Verwendung`delete-members`. **AWS CLI** **So entfernen Sie Mitgliedskonten aus einem Verhaltensdiagramm** Im folgenden Beispiel für `delete-members` werden zwei Mitgliedskonten aus dem Verhaltensdiagramm arn:aws:detective:us-east-1:111122223333:graph:123412341234 entfernt. Um die Konten zu identifizieren, wird in der Anfrage das AWS Konto bereitgestellt IDs. ``` aws detective delete-members \ --account-ids 444455556666 123456789012 \ --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 ``` Ausgabe: ``` { "AccountIds": [ "444455556666", "123456789012" ], "UnprocessedAccounts": [ ] } ``` Weitere Informationen finden Sie unter Mitgliedskonten aus einem Verhaltensdiagramm entfernen< https://docs.aws.amazon.com/detective/ latest/adminguide/graph - admin-remove-member-accounts .html> im *Amazon Detective* Administration Guide. + *Einzelheiten zur API finden Sie [DeleteMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/delete-members.html)in AWS CLI der Befehlsreferenz.* ### `disassociate-membership` Das folgende Codebeispiel zeigt die Verwendung`disassociate-membership`. **AWS CLI** **So kündigen Sie die Mitgliedschaft in einem Verhaltensdiagramm** Im folgenden Beispiel für eine Disassociate-Mitgliedschaft wird das AWS Konto, das den Befehl ausführt, aus dem Verhaltensdiagramm arn:aws:detective:us-east- 1:111122223333:graph:123412341234 entfernt. ``` aws detective disassociate-membership \ --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 ``` Weitere Informationen finden Sie unter Entfernen Ihres Kontos aus einem Verhaltensdiagramm < https://docs.aws.amazon.com/detective/ latest/adminguide/member - remove-self-from-graph .html> im *Amazon Detective* Administration Guide. + *Einzelheiten zur API finden Sie [DisassociateMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/disassociate-membership.html)in AWS CLI der Befehlsreferenz.* ### `get-members` Das folgende Codebeispiel zeigt die Verwendung`get-members`. **AWS CLI** **So rufen Sie Informationen über ausgewählte Mitgliedskonten des Verhaltensdiagramms ab** Im folgenden Beispiel für `get-members` werden Informationen über zwei Mitgliedskonten im Verhaltensdiagramm arn:aws:detective:us-east-1:111122223333:graph:123412341234 abgerufen. Für die beiden Konten stellt die Anfrage das AWS Konto bereit IDs. ``` aws detective get-members \ --account-ids 444455556666 123456789012 \ --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 ``` Ausgabe: ``` { "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": [ ] } ``` Weitere Informationen finden Sie unter Kontenliste in einem Verhaltensdiagramm anzeigen< https://docs.aws.amazon.com/detective/ latest/adminguide/graph - admin-view-accounts .html> im *Amazon Detective* Administration Guide. + *Einzelheiten zur API finden Sie [GetMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/get-members.html)in AWS CLI der Befehlsreferenz.* ### `list-graphs` Das folgende Codebeispiel zeigt die Verwendung`list-graphs`. **AWS CLI** **So zeigen Sie eine Liste von Verhaltensdiagrammen an, für die Ihr Konto der Administrator ist** Im folgenden Beispiel für `list-graphs` werden die Verhaltensdiagramme abgerufen, für die das aufrufende Konto der Administrator in der aktuellen Region ist. ``` aws detective list-graphs ``` Ausgabe: ``` { "GraphList": [ { "Arn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234", "CreatedTime": 1579736111000 } ] } ``` + Einzelheiten zur API finden Sie [ListGraphs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/list-graphs.html)in der *AWS CLI Befehlsreferenz*. ### `list-invitations` Das folgende Codebeispiel zeigt die Verwendung`list-invitations`. **AWS CLI** **So zeigen Sie eine Liste von Verhaltensdiagrammen an, bei denen ein Konto Mitglied ist oder zu denen ein Konto eingeladen wurde** Im folgenden Beispiel für `list-invitations` werden die Verhaltensdiagramme abgerufen, zu denen das aufrufende Konto eingeladen wurde. Die Ergebnisse enthalten nur offene und angenommene Einladungen. Sie enthalten keine abgelehnten Einladungen oder gelöschte Mitgliedschaften. ``` aws detective list-invitations ``` Ausgabe: ``` { "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 } ] } ``` Weitere Informationen finden Sie unter Ihre Liste mit Einladungen zum Verhaltensdiagramm anzeigen< https://docs.aws.amazon.com/detective/ latest/adminguide/member - view-graph-invitations .html> im *Amazon* Detective Administration Guide. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [ListInvitations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/list-invitations.html).AWS CLI * ### `list-members` Das folgende Codebeispiel zeigt die Verwendung`list-members`. **AWS CLI** **So listen Sie die Mitgliedskonten in einem Verhaltensdiagramm auf** Im folgenden Beispiel für `list-members` werden die eingeladenen und aktivierten Mitgliedskonten für das Verhaltensdiagramm `arn:aws:detective:us-east-1:111122223333:graph:123412341234` abgerufen. In den Ergebnissen sind keine Mitgliedskonten enthalten, die entfernt wurden. ``` aws detective list-members \ --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 ``` Ausgabe: ``` { "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 } ] } ``` Weitere Informationen finden Sie unter [Anzeigen der Liste der Konten in einem Verhaltensdiagramm](https://docs.aws.amazon.com/detective/latest/adminguide/graph-admin-view-accounts.html) im *Administratorhandbuch für Amazon Detective*. + Einzelheiten zur API finden Sie [ListMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/list-members.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So rufen Sie die einem Verhaltensdiagramm zugewiesenen Tags ab** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags zurückgegeben, die dem angegebenen Verhaltensdiagramm zugewiesen sind. ``` aws detective list-tags-for-resource \ --resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 ``` Ausgabe: ``` { "Tags": { "Department" : "Finance" } } ``` Weitere Informationen finden Sie unter [Verwalten von Tags für ein Verhaltensdiagramm](https://docs.aws.amazon.com/detective/latest/adminguide/graph-tags.html) im *Administratorhandbuch für Amazon Detective*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `reject-invitation` Das folgende Codebeispiel zeigt die Verwendung`reject-invitation`. **AWS CLI** **So lehnen Sie eine Einladung für ein Mitgliedskonto in einem Verhaltensdiagramm ab** Im folgenden Beispiel für `reject-invitation` wird eine Einladung, ein Mitgliedskonto im Verhaltensdiagramm arn:aws:detective:us-east-1:111122223333:graph:123412341234 zu werden, abgelehnt. ``` aws detective reject-invitation \ --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. *Weitere Informationen finden Sie unter Auf eine Einladung mit einem Verhaltensdiagramm antworten < https://docs.aws.amazon.com/detective/ latest/adminguide/member -invitation-response.html> im Amazon Detective Administration Guide.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [RejectInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/reject-invitation.html)AWS CLI * ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So weisen Sie einer Ressource einen Tag zu** Im folgenden Beispiel für `tag-resource` wird dem angegebenen Verhaltensdiagramm ein Wert für das Department-Tag zugewiesen. ``` aws detective tag-resource \ --resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \ --tags '{"Department":"Finance"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Tags für ein Verhaltensdiagramm](https://docs.aws.amazon.com/detective/latest/adminguide/graph-tags.html) im *Administratorhandbuch für Amazon Detective*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag-Wert aus einer Ressource** Im folgenden Beispiel für `untag-resource` wird das Department-Tag aus dem angegebenen Verhaltensdiagramm entfernt. ``` aws detective untag-resource \ --resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \ --tag-keys "Department" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Tags für ein Verhaltensdiagramm](https://docs.aws.amazon.com/detective/latest/adminguide/graph-tags.html) im *Administratorhandbuch für Amazon Detective*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Device Farm mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Device Farm Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-device-pool` Das folgende Codebeispiel zeigt, wie Sie`create-device-pool`. **AWS CLI** **So erstellen Sie einen Gerätepool** Der folgende Befehl erstellt einen Android-Gerätepool für ein Projekt: ``` aws devicefarm create-device-pool --name pool1 --rules file://device-pool-rules.json --project-arn "arn:aws:devicefarm:us-west-2:123456789012:project:070fc3ca-7ec1-4741-9c1f-d3e044efc506" ``` Sie können den Projekt-ARN aus der Ausgabe von `create-project` oder `list-projects` abrufen. Die Datei `device-pool-rules.json` ist ein JSON-Dokument im aktuellen Ordner, das die Geräteplattform angibt: ``` [ { "attribute": "PLATFORM", "operator": "EQUALS", "value": "\"ANDROID\"" } ] ``` Ausgabe: ``` { "devicePool": { "rules": [ { "operator": "EQUALS", "attribute": "PLATFORM", "value": "\"ANDROID\"" } ], "type": "PRIVATE", "name": "pool1", "arn": "arn:aws:devicefarm:us-west-2:123456789012:devicepool:070fc3ca-7ec1-4741-9c1f-d3e044efc506/2aa8d2a9-5e73-47ca-b929-659cb34b7dcd" } } ``` + Einzelheiten zur API finden Sie [CreateDevicePool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/create-device-pool.html)in der *AWS CLI Befehlsreferenz*. ### `create-project` Das folgende Codebeispiel zeigt die Verwendung`create-project`. **AWS CLI** **So erstellen Sie ein Projekt** Der folgende Befehl erstellt ein neues Projekt mit dem Namen `my-project`: ``` aws devicefarm create-project --name my-project ``` Ausgabe: ``` { "project": { "name": "myproject", "arn": "arn:aws:devicefarm:us-west-2:123456789012:project:070fc3ca-7ec1-4741-9c1f-d3e044efc506", "created": 1503612890.057 } } ``` + Einzelheiten zur API finden Sie [CreateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/create-project.html)in der *AWS CLI Befehlsreferenz*. ### `create-upload` Das folgende Codebeispiel zeigt die Verwendung`create-upload`. **AWS CLI** **So erstellen Sie einen Upload** Der folgende Befehl erstellt einen Upload für eine Android-App: ``` aws devicefarm create-upload --project-arn "arn:aws:devicefarm:us-west-2:123456789012:project:070fc3ca-7ec1-4741-9c1f-d3e044efc506" --name app.apk --type ANDROID_APP ``` Sie können den Projekt-ARN aus der Ausgabe von create-project oder list-projects abrufen. Ausgabe: ``` { "upload": { "status": "INITIALIZED", "name": "app.apk", "created": 1503614408.769, "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789012%3Aproject%3A070fc3ca-c7e1-4471-91cf-d3e4efc50604/uploads/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789012%3Aupload%3A070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514/app.apk?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20170824T224008Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Credential=AKIAEXAMPLEPBUMBC3GA%2F20170824%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=05050370c38894ef5bd09f5d009f36fc8f96fa4bb04e1bba9aca71b8dbe49a0f", "type": "ANDROID_APP", "arn": "arn:aws:devicefarm:us-west-2:123456789012:upload:070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514" } } ``` Verwenden Sie die signierte URL in der Ausgabe, um eine Datei auf Device Farm hochzuladen: ``` curl -T app.apk "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789012%3Aproject%3A070fc3ca-c7e1-4471-91cf-d3e4efc50604/uploads/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789012%3Aupload%3A070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514/app.apk?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20170824T224008Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Credential=AKIAEXAMPLEPBUMBC3GA%2F20170824%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=05050370c38894ef5bd09f5d009f36fc8f96fa4bb04e1bba9aca71b8dbe49a0f" ``` + Einzelheiten zur API finden Sie [CreateUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/create-upload.html)in der *AWS CLI Befehlsreferenz*. ### `get-upload` Das folgende Codebeispiel zeigt die Verwendung`get-upload`. **AWS CLI** **So zeigen Sie einen Upload an** Mit dem folgenden Befehl werden Informationen über einen Upload abgerufen: ``` aws devicefarm get-upload --arn "arn:aws:devicefarm:us-west-2:123456789012:upload:070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514" ``` Sie können den Projekt-ARN aus der Ausgabe von `create-upload` abrufen. Ausgabe: ``` { "upload": { "status": "SUCCEEDED", "name": "app.apk", "created": 1505262773.186, "type": "ANDROID_APP", "arn": "arn:aws:devicefarm:us-west-2:123456789012:upload:070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514", "metadata": "{\"device_admin\":false,\"activity_name\":\"ccom.example.client.LauncherActivity\",\"version_name\":\"1.0.2.94\",\"screens\":[\"small\",\"normal\",\"large\",\"xlarge\"],\"error_type\":null,\"sdk_version\":\"16\",\"package_name\":\"com.example.client\",\"version_code\":\"20994\",\"native_code\":[\"armeabi-v7a\"],\"target_sdk_version\":\"25\"}" } } ``` + Einzelheiten zur API finden Sie [GetUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/get-upload.html)in der *AWS CLI Befehlsreferenz*. ### `list-projects` Das folgende Codebeispiel zeigt die Verwendung`list-projects`. **AWS CLI** **So listen Sie Projekte auf** Im Folgenden wird eine Liste von Projekten abgerufen: ``` aws devicefarm list-projects ``` Ausgabe: ``` { "projects": [ { "name": "myproject", "arn": "arn:aws:devicefarm:us-west-2:123456789012:project:070fc3ca-7ec1-4741-9c1f-d3e044efc506", "created": 1503612890.057 }, { "name": "otherproject", "arn": "arn:aws:devicefarm:us-west-2:123456789012:project:a5f5b752-8098-49d1-86bf-5f7682c1c77e", "created": 1505257519.337 } ] } ``` + Einzelheiten zur API finden Sie [ListProjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/list-projects.html)in der *AWS CLI Befehlsreferenz*. # Direct Connect Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren Direct Connect. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `accept-direct-connect-gateway-association-proposal` Das folgende Codebeispiel zeigt, wie Sie`accept-direct-connect-gateway-association-proposal`. **AWS CLI** **So akzeptieren Sie einen Gateway-Zuordnungsvorschlag** Im folgenden Beispiel für `accept-direct-connect-gateway-association-proposal` wird der angegebene Vorschlag akzeptiert. ``` aws directconnect accept-direct-connect-gateway-association-proposal \ --direct-connect-gateway-id 11460968-4ac1-4fd3-bdb2-00599EXAMPLE \ --proposal-id cb7f41cb-8128-43a5-93b1-dcaedEXAMPLE \ --associated-gateway-owner-account 111122223333 { "directConnectGatewayAssociation": { "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE", "directConnectGatewayOwnerAccount": "111122223333", "associationState": "associating", "associatedGateway": { "id": "tgw-02f776b1a7EXAMPLE", "type": "transitGateway", "ownerAccount": "111122223333", "region": "us-east-1" }, "associationId": "6441f8bf-5917-4279-ade1-9708bEXAMPLE", "allowedPrefixesToDirectConnectGateway": [ { "cidr": "192.168.1.0/30" } ] } } ``` Weitere Informationen finden Sie unter [Akzeptieren oder Ablehnen eines Transit-Gateway-Zuordnungsvorschlags](https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-tgw.html#multi-account-tgw-accept-reject-proposal) im *Benutzerhandbuch für AWS Direct Connect*. + Einzelheiten zur API finden Sie [AcceptDirectConnectGatewayAssociationProposal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/accept-direct-connect-gateway-association-proposal.html)in der *AWS CLI Befehlsreferenz*. ### `allocate-connection-on-interconnect` Das folgende Codebeispiel zeigt die Verwendung`allocate-connection-on-interconnect`. **AWS CLI** **So erstellen Sie eine gehostete Verbindung über eine Interconnect-Verbindung** Der folgende `allocate-connection-on-interconnect`-Befehl erstellt eine gehostete Verbindung über eine Interconnect-Verbindung: ``` aws directconnect allocate-connection-on-interconnect --bandwidth 500Mbps --connection-name mydcinterconnect --owner-account 123456789012 --interconnect-id dxcon-fgktov66 --vlan 101 ``` Ausgabe: ``` { "partnerName": "TIVIT", "vlan": 101, "ownerAccount": "123456789012", "connectionId": "dxcon-ffzc51m1", "connectionState": "ordering", "bandwidth": "500Mbps", "location": "TIVIT", "connectionName": "mydcinterconnect", "region": "sa-east-1" } ``` + Einzelheiten zur API finden Sie [AllocateConnectionOnInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-connection-on-interconnect.html)in der *AWS CLI Befehlsreferenz*. ### `allocate-hosted-connection` Das folgende Codebeispiel zeigt die Verwendung`allocate-hosted-connection`. **AWS CLI** **So erstellen Sie eine gehostete Verbindung über eine Interconnect-Verbindung** Im folgenden Beispiel für `allocate-hosted-connection` wird eine gehostete Verbindung über die angegebene Interconnect-Verbindung erstellt. ``` aws directconnect allocate-hosted-connection \ --bandwidth 500Mbps \ --connection-name mydcinterconnect \ --owner-account 123456789012 -connection-id dxcon-fgktov66 -vlan 101 ``` Ausgabe: ``` { "partnerName": "TIVIT", "vlan": 101, "ownerAccount": "123456789012", "connectionId": "dxcon-ffzc51m1", "connectionState": "ordering", "bandwidth": "500Mbps", "location": "TIVIT", "connectionName": "mydcinterconnect", "region": "sa-east-1" } ``` + Einzelheiten zur API finden Sie [AllocateHostedConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-hosted-connection.html)in der *AWS CLI Befehlsreferenz*. ### `allocate-private-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`allocate-private-virtual-interface`. **AWS CLI** **So stellen Sie eine private virtuelle Schnittstelle bereit** Der folgende `allocate-private-virtual-interface`-Befehl stellt eine private virtuelle Schnittstelle bereit, deren Eigentümer ein anderer Kunde sein soll: ``` aws directconnect allocate-private-virtual-interface --connection-id dxcon-ffjrkx17 --owner-account 123456789012 --new-private-virtual-interface-allocation virtualInterfaceName=PrivateVirtualInterface,vlan=1000,asn=65000,authKey=asdf34example,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30 ``` Ausgabe: ``` { "virtualInterfaceState": "confirming", "asn": 65000, "vlan": 1000, "customerAddress": "192.168.1.2/30", "ownerAccount": "123456789012", "connectionId": "dxcon-ffjrkx17", "virtualInterfaceId": "dxvif-fgy8orxu", "authKey": "asdf34example", "routeFilterPrefixes": [], "location": "TIVIT", "customerRouterConfig": "\n \n 1000\n 192.168.1.2/30\n 192.168.1.1/30\n 65000\n asdf34example\n 7224\n private\n\n", "amazonAddress": "192.168.1.1/30", "virtualInterfaceType": "private", "virtualInterfaceName": "PrivateVirtualInterface" } ``` + Einzelheiten zur API finden Sie [AllocatePrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-private-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `allocate-public-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`allocate-public-virtual-interface`. **AWS CLI** **Um eine öffentliche virtuelle Schnittstelle bereitzustellen** Der folgende `allocate-public-virtual-interface`-Befehl stellt eine öffentliche virtuelle Schnittstelle bereit, deren Eigentümer ein anderer Kunde sein soll: ``` aws directconnect allocate-public-virtual-interface --connection-id dxcon-ffjrkx17 --owner-account 123456789012 --new-public-virtual-interface-allocation virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,authKey=asdf34example,amazonAddress=203.0.113.1/30,customerAddress=203.0.113.2/30,routeFilterPrefixes=[{cidr=203.0.113.0/30},{cidr=203.0.113.4/30}] ``` Ausgabe: ``` { "virtualInterfaceState": "confirming", "asn": 65000, "vlan": 2000, "customerAddress": "203.0.113.2/30", "ownerAccount": "123456789012", "connectionId": "dxcon-ffjrkx17", "virtualInterfaceId": "dxvif-fg9xo9vp", "authKey": "asdf34example", "routeFilterPrefixes": [ { "cidr": "203.0.113.0/30" }, { "cidr": "203.0.113.4/30" } ], "location": "TIVIT", "customerRouterConfig": "\n\n 2000\n 203.0.113.2/30\n 203.0.113.1/30\n 65000\n asdf34example\n 7224\n public\n\n", "amazonAddress": "203.0.113.1/30", "virtualInterfaceType": "public", "virtualInterfaceName": "PublicVirtualInterface" } ``` + Einzelheiten zur API finden Sie [AllocatePublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-public-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `allocate-transit-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`allocate-transit-virtual-interface`. **AWS CLI** **Um eine virtuelle Transitschnittstelle bereitzustellen, die dem angegebenen AWS Konto gehört** Im folgenden Beispiel für `allocate-transit-virtual-interface` wird eine virtuelle Transit-Schnittstelle für das angegebene Konto bereitgestellt. ``` aws directconnect allocate-transit-virtual-interface \ --connection-id dxlag-fEXAMPLE \ --owner-account 123456789012 \ --new-transit-virtual-interface-allocation "virtualInterfaceName=Example Transit Virtual Interface,vlan=126,asn=65110,mtu=1500,authKey=0xzxgA9YoW9h58u8SEXAMPLE,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30,addressFamily=ipv4,tags=[{key=Tag,value=Example}]" ``` Ausgabe: ``` { "virtualInterface": { "ownerAccount": "123456789012", "virtualInterfaceId": "dxvif-fEXAMPLE", "location": "loc1", "connectionId": "dxlag-fEXAMPLE", "virtualInterfaceType": "transit", "virtualInterfaceName": "Example Transit Virtual Interface", "vlan": 126, "asn": 65110, "amazonSideAsn": 7224, "authKey": "0xzxgA9YoW9h58u8SEXAMPLE", "amazonAddress": "192.168.1.1/30", "customerAddress": "192.168.1.2/30", "addressFamily": "ipv4", "virtualInterfaceState": "confirming", "customerRouterConfig": "\n\n 126\n 192.168.1.2/30\n 192.168.1.1/30\n 65110\n 0xzxgA9YoW9h58u8SEXAMPLE\n 7224\n transit\n\n", "mtu": 1500, "jumboFrameCapable": true, "virtualGatewayId": "", "directConnectGatewayId": "", "routeFilterPrefixes": [], "bgpPeers": [ { "bgpPeerId": "dxpeer-fEXAMPLE", "asn": 65110, "authKey": "0xzxgA9YoW9h58u8EXAMPLE", "addressFamily": "ipv4", "amazonAddress": "192.168.1.1/30", "customerAddress": "192.168.1.2/30", "bgpPeerState": "pending", "bgpStatus": "down", "awsDeviceV2": "loc1-26wz6vEXAMPLE" } ], "region": "sa-east-1", "awsDeviceV2": "loc1-26wz6vEXAMPLE", "tags": [ { "key": "Tag", "value": "Example" } ] } } ``` Weitere Informationen finden Sie unter [Erstellen einer gehosteten virtuellen Transit-Schnittstelle](https://docs.aws.amazon.com/directconnect/latest/UserGuide/createhostedvirtualinterface.html#create-hosted-transit-vif) im *Benutzerhandbuch für AWS Direct Connect*. + Einzelheiten zur API finden Sie [AllocateTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-transit-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `associate-connection-with-lag` Das folgende Codebeispiel zeigt die Verwendung`associate-connection-with-lag`. **AWS CLI** **Um eine Verbindung mit einer LAG zu verknüpfen** Im folgenden Beispiel wird die angegebene Verbindung der spezifizierten LAG zugeordnet. Befehl: ``` aws directconnect associate-connection-with-lag --lag-id dxlag-fhccu14t --connection-id dxcon-fg9607vm ``` Ausgabe: ``` { "ownerAccount": "123456789012", "connectionId": "dxcon-fg9607vm", "lagId": "dxlag-fhccu14t", "connectionState": "requested", "bandwidth": "1Gbps", "location": "EqDC2", "connectionName": "Con2ForLag", "region": "us-east-1" } ``` + Einzelheiten zur API finden Sie [AssociateConnectionWithLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-connection-with-lag.html)in der *AWS CLI Befehlsreferenz*. ### `associate-hosted-connection` Das folgende Codebeispiel zeigt die Verwendung`associate-hosted-connection`. **AWS CLI** **So verknüpfen Sie eine gehostete Verbindung mit einer LAG** Im folgenden Beispiel wird die angegebene gehostete Verbindung der spezifizierten LAG zugeordnet. Befehl: ``` aws directconnect associate-hosted-connection --parent-connection-id dxlag-fhccu14t --connection-id dxcon-fg9607vm ``` Ausgabe: ``` { "partnerName": "TIVIT", "vlan": 101, "ownerAccount": "123456789012", "connectionId": "dxcon-fg9607vm", "lagId": "dxlag-fhccu14t", "connectionState": "ordering", "bandwidth": "500Mbps", "location": "TIVIT", "connectionName": "mydcinterconnect", "region": "sa-east-1" } ``` + Einzelheiten zur API finden Sie [AssociateHostedConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-hosted-connection.html)in der *AWS CLI Befehlsreferenz*. ### `associate-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`associate-virtual-interface`. **AWS CLI** **Um eine virtuelle Schnittstelle mit einer Verbindung zu verknüpfen** Im folgenden Beispiel wird die angegebene virtuelle Schnittstelle der spezifizierten LAG zugeordnet. Um die virtuelle Schnittstelle einer Verbindung zuzuordnen, geben Sie alternativ die ID einer AWS Direct Connect-Verbindung für `--connection-id` an, zum Beispiel`dxcon-ffnikghc`. Befehl: ``` aws directconnect associate-virtual-interface --connection-id dxlag-ffjhj9lx --virtual-interface-id dxvif-fgputw0j ``` Ausgabe: ``` { "virtualInterfaceState": "pending", "asn": 65000, "vlan": 123, "customerAddress": "169.254.255.2/30", "ownerAccount": "123456789012", "connectionId": "dxlag-ffjhj9lx", "addressFamily": "ipv4", "virtualGatewayId": "vgw-38e90b51", "virtualInterfaceId": "dxvif-fgputw0j", "authKey": "0x123pK5_VBqv.UQ3kJ4123_", "routeFilterPrefixes": [], "location": "CSVA1", "bgpPeers": [ { "bgpStatus": "down", "customerAddress": "169.254.255.2/30", "addressFamily": "ipv4", "authKey": "0x123pK5_VBqv.UQ3kJ4123_", "bgpPeerState": "deleting", "amazonAddress": "169.254.255.1/30", "asn": 65000 }, { "bgpStatus": "down", "customerAddress": "169.254.255.2/30", "addressFamily": "ipv4", "authKey": "0x123pK5_VBqv.UQ3kJ4123_", "bgpPeerState": "pending", "amazonAddress": "169.254.255.1/30", "asn": 65000 } ], "customerRouterConfig": "\n\n 123\n 169.254.255.2/30\n 169.254.255.1/30\n 65000\n 0x123pK5_VBqv.UQ3kJ4123_\n 7224\n private\n\n", "amazonAddress": "169.254.255.1/30", "virtualInterfaceType": "private", "virtualInterfaceName": "VIF1A" } ``` + Einzelheiten zur API finden Sie [AssociateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `confirm-connection` Das folgende Codebeispiel zeigt die Verwendung`confirm-connection`. **AWS CLI** **So bestätigen Sie die Erstellung einer gehosteten Verbindung über eine Interconnect-Verbindung** Der folgende `confirm-connection`-Befehl bestätigt die Erstellung einer gehosteten Verbindung über eine Interconnect-Verbindung: ``` aws directconnect confirm-connection --connection-id dxcon-fg2wi7hy ``` Ausgabe: ``` { "connectionState": "pending" } ``` + Einzelheiten zur API finden Sie [ConfirmConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-connection.html)in der *AWS CLI Befehlsreferenz*. ### `confirm-private-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`confirm-private-virtual-interface`. **AWS CLI** **So übernehmen Sie das Eigentum an einer privaten virtuellen Schnittstelle** Mit dem folgenden `confirm-private-virtual-interface`-Befehl wird das Eigentum an einer von einem anderen Kunden erstellten privaten virtuellen Schnittstelle übernommen: ``` aws directconnect confirm-private-virtual-interface --virtual-interface-id dxvif-fgy8orxu --virtual-gateway-id vgw-e4a47df9 ``` Ausgabe: ``` { "virtualInterfaceState": "pending" } ``` + Einzelheiten zur API finden Sie [ConfirmPrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-private-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `confirm-public-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`confirm-public-virtual-interface`. **AWS CLI** **So übernehmen Sie das Eigentum an einer öffentlichen virtuellen Schnittstelle** Mit dem folgenden `confirm-public-virtual-interface`-Befehl wird das Eigentum an einer von einem anderen Kunden erstellten öffentlichen virtuellen Schnittstelle übernommen: ``` aws directconnect confirm-public-virtual-interface --virtual-interface-id dxvif-fg9xo9vp ``` Ausgabe: ``` { "virtualInterfaceState": "verifying" } ``` + Einzelheiten zur API finden Sie [ConfirmPublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-public-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `confirm-transit-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`confirm-transit-virtual-interface`. **AWS CLI** **So übernehmen Sie das Eigentum an einer virtuellen Transit-Schnittstelle** Im folgenden Beispiel für `confirm-transit-virtual-interface` wird das Eigentum an einer von einem anderen Kunden erstellten virtuellen Transit-Schnittstelle übernommen. ``` aws directconnect confirm-transit-virtual-interface \ --virtual-interface-id dxvif-fEXAMPLE \ --direct-connect-gateway-id 4112ccf9-25e9-4111-8237-b6c5dEXAMPLE ``` Ausgabe: ``` { "virtualInterfaceState": "pending" } ``` Weitere Informationen finden Sie unter [Akzeptieren einer gehosteten virtuellen Schnittstelle](https://docs.aws.amazon.com/directconnect/latest/UserGuide/accepthostedvirtualinterface.html) im *Benutzerhandbuch für AWS Direct Connect*. + Einzelheiten zur API finden Sie [ConfirmTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-transit-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `create-bgp-peer` Das folgende Codebeispiel zeigt die Verwendung`create-bgp-peer`. **AWS CLI** **Um eine IPv6 BGP-Peering-Sitzung zu erstellen** Das folgende Beispiel erstellt eine IPv6 BGP-Peering-Sitzung auf einer privaten virtuellen Schnittstelle. `dxvif-fg1vuj3d` Die IPv6 Peer-Adressen werden automatisch von Amazon zugewiesen. Befehl: ``` aws directconnect create-bgp-peer --virtual-interface-id dxvif-fg1vuj3d --new-bgp-peer asn=64600,addressFamily=ipv6 ``` Ausgabe: ``` { "virtualInterface": { "virtualInterfaceState": "available", "asn": 65000, "vlan": 125, "customerAddress": "169.254.255.2/30", "ownerAccount": "123456789012", "connectionId": "dxcon-fguhmqlc", "addressFamily": "ipv4", "virtualGatewayId": "vgw-f9eb0c90", "virtualInterfaceId": "dxvif-fg1vuj3d", "authKey": "0xC_ukbCerl6EYA0example", "routeFilterPrefixes": [], "location": "EqDC2", "bgpPeers": [ { "bgpStatus": "down", "customerAddress": "169.254.255.2/30", "addressFamily": "ipv4", "authKey": "0xC_ukbCerl6EYA0uexample", "bgpPeerState": "available", "amazonAddress": "169.254.255.1/30", "asn": 65000 }, { "bgpStatus": "down", "customerAddress": "2001:db8:1100:2f0:0:1:9cb4:4216/125", "addressFamily": "ipv6", "authKey": "0xS27kAIU_VHPjjAexample", "bgpPeerState": "pending", "amazonAddress": "2001:db8:1100:2f0:0:1:9cb4:4211/125", "asn": 64600 } ], "customerRouterConfig": "\n\n 125\n 169.254.255.2/30\n 169.254.255.1/30\n 65000\n 0xC_ukbCerl6EYA0uexample\n 2001:db8:1100:2f0:0:1:9cb4:4216/125\n 2001:db8:1100:2f0:0:1:9cb4:4211/125\n 64600\n 0xS27kAIU_VHPjjAexample\n 7224\n private\n\n", "amazonAddress": "169.254.255.1/30", "virtualInterfaceType": "private", "virtualInterfaceName": "Test" } } ``` + Einzelheiten zur API finden Sie [CreateBgpPeer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-bgp-peer.html)in der *AWS CLI Befehlsreferenz*. ### `create-connection` Das folgende Codebeispiel zeigt die Verwendung`create-connection`. **AWS CLI** **So stellen Sie eine Verbindung von Ihrem Netzwerk zu einem AWS Direct Connect-Standort her** Mit dem folgenden `create-connection` Befehl wird eine Verbindung von Ihrem Netzwerk zu einem AWS Direct Connect-Standort hergestellt: ``` aws directconnect create-connection --location TIVIT --bandwidth 1Gbps --connection-name "Connection to AWS" ``` Ausgabe: ``` { "ownerAccount": "123456789012", "connectionId": "dxcon-fg31dyv6", "connectionState": "requested", "bandwidth": "1Gbps", "location": "TIVIT", "connectionName": "Connection to AWS", "region": "sa-east-1" } ``` + Einzelheiten zur API finden Sie [CreateConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-connection.html)in der *AWS CLI Befehlsreferenz*. ### `create-direct-connect-gateway-association-proposal` Das folgende Codebeispiel zeigt die Verwendung`create-direct-connect-gateway-association-proposal`. **AWS CLI** **So erstellen Sie einen Vorschlag zum Verknüpfen des angegebenen Transit-Gateways mit dem genannten Direct Connect Gateway** Im folgenden Beispiel für `create-direct-connect-gateway-association-proposal` wird ein Vorschlag zum Verknüpfen des angegebenen Transit-Gateways mit dem genannten Direct Connect Gateway erstellt. ``` aws directconnect create-direct-connect-gateway-association-proposal \ --direct-connect-gateway-id 11460968-4ac1-4fd3-bdb2-00599EXAMPLE \ --direct-connect-gateway-owner-account 111122223333 \ --gateway-id tgw-02f776b1a7EXAMPLE \ --add-allowed-prefixes-to-direct-connect-gateway cidr=192.168.1.0/30 ``` Ausgabe: ``` { "directConnectGatewayAssociationProposal": { "proposalId": "cb7f41cb-8128-43a5-93b1-dcaedEXAMPLE", "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE", "directConnectGatewayOwnerAccount": "111122223333", "proposalState": "requested", "associatedGateway": { "id": "tgw-02f776b1a7EXAMPLE", "type": "transitGateway", "ownerAccount": "111122223333", "region": "us-east-1" }, "requestedAllowedPrefixesToDirectConnectGateway": [ { "cidr": "192.168.1.0/30" } ] } } ``` Weitere Informationen finden Sie unter [Erstellen eines Transit-Gateway-Zuordnungsvorschlags](https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-tgw.html#multi-account-tgw-create-proposal) im *Benutzerhandbuch für AWS Direct Connect*. + Einzelheiten zur API finden Sie [CreateDirectConnectGatewayAssociationProposal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway-association-proposal.html)in der *AWS CLI Befehlsreferenz*. ### `create-direct-connect-gateway-association` Das folgende Codebeispiel zeigt die Verwendung`create-direct-connect-gateway-association`. **AWS CLI** **So verknüpfen Sie ein Virtual Private Gateway mit einem Direct Connect Gateway** Im folgenden Beispiel wird das Virtual Private Gateway `vgw-6efe725e` mit dem Direct Connect Gateway `5f294f92-bafb-4011-916d-9b0bexample` verknüpft. Sie müssen den Befehl in der Region ausführen, in der sich das Virtual Private Gateway befindet. Befehl: ``` aws directconnect create-direct-connect-gateway-association --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample --virtual-gateway-id vgw-6efe725e ``` Ausgabe: ``` { "directConnectGatewayAssociation": { "associationState": "associating", "virtualGatewayOwnerAccount": "123456789012", "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample", "virtualGatewayId": "vgw-6efe725e", "virtualGatewayRegion": "us-east-2" } } ``` + Einzelheiten zur API finden Sie [CreateDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway-association.html)in der *AWS CLI Befehlsreferenz*. ### `create-direct-connect-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-direct-connect-gateway`. **AWS CLI** **So erstellen Sie ein Direct-Connect-Gateway** Im folgenden Beispiel wird ein Direct-Connect-Gateway mit dem Namen `DxGateway1` erstellt. Befehl: ``` aws directconnect create-direct-connect-gateway --direct-connect-gateway-name "DxGateway1" ``` Ausgabe: ``` { "directConnectGateway": { "amazonSideAsn": 64512, "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bdexample", "ownerAccount": "123456789012", "directConnectGatewayName": "DxGateway1", "directConnectGatewayState": "available" } } ``` + Einzelheiten zur API finden Sie [CreateDirectConnectGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `create-interconnect` Das folgende Codebeispiel zeigt die Verwendung`create-interconnect`. **AWS CLI** **Um eine Verbindung zwischen dem Netzwerk eines Partners herzustellen und AWS** Mit dem folgenden `create-interconnect` Befehl wird eine Verbindung zwischen dem Netzwerk eines AWS Direct Connect-Partners und einem bestimmten AWS Direct Connect-Standort hergestellt: ``` aws directconnect create-interconnect --interconnect-name "1G Interconnect to AWS" --bandwidth 1Gbps --location TIVIT ``` Ausgabe: ``` { "region": "sa-east-1", "bandwidth": "1Gbps", "location": "TIVIT", "interconnectName": "1G Interconnect to AWS", "interconnectId": "dxcon-fgktov66", "interconnectState": "requested" } ``` + Einzelheiten zur API finden Sie [CreateInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-interconnect.html)in der *AWS CLI Befehlsreferenz.* ### `create-lag` Das folgende Codebeispiel zeigt die Verwendung`create-lag`. **AWS CLI** **Um eine LAG mit neuen Verbindungen zu erstellen** Das folgende Beispiel erstellt eine LAG und fordert zwei neue AWS Direct Connect-Verbindungen für die LAG mit einer Bandbreite von 1 Gbit/s an. Befehl: ``` aws directconnect create-lag --location CSVA1 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 1GBLag ``` Ausgabe: ``` { "awsDevice": "CSVA1-23u8tlpaz8iks", "numberOfConnections": 2, "lagState": "pending", "ownerAccount": "123456789012", "lagName": "1GBLag", "connections": [ { "ownerAccount": "123456789012", "connectionId": "dxcon-ffqr6x5q", "lagId": "dxlag-ffjhj9lx", "connectionState": "requested", "bandwidth": "1Gbps", "location": "CSVA1", "connectionName": "Requested Connection 1 for Lag dxlag-ffjhj9lx", "region": "us-east-1" }, { "ownerAccount": "123456789012", "connectionId": "dxcon-fflqyj95", "lagId": "dxlag-ffjhj9lx", "connectionState": "requested", "bandwidth": "1Gbps", "location": "CSVA1", "connectionName": "Requested Connection 2 for Lag dxlag-ffjhj9lx", "region": "us-east-1" } ], "lagId": "dxlag-ffjhj9lx", "minimumLinks": 0, "connectionsBandwidth": "1Gbps", "region": "us-east-1", "location": "CSVA1" } ``` **So erstellen Sie eine LAG anhand einer vorhandenen Verbindung** Im folgenden Beispiel werden eine LAG aus einer bestehenden Verbindung in Ihrem Konto erstellt und eine zweite neue Verbindung für die LAG mit derselben Bandbreite und demselben Standort wie die bestehende Verbindung angefordert. Befehl: ``` aws directconnect create-lag --location EqDC2 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 2ConnLAG --connection-id dxcon-fgk145dr ``` Ausgabe: ``` { "awsDevice": "EqDC2-4h6ce2r1bes6", "numberOfConnections": 2, "lagState": "pending", "ownerAccount": "123456789012", "lagName": "2ConnLAG", "connections": [ { "ownerAccount": "123456789012", "connectionId": "dxcon-fh6ljcvo", "lagId": "dxlag-fhccu14t", "connectionState": "requested", "bandwidth": "1Gbps", "location": "EqDC2", "connectionName": "Requested Connection 1 for Lag dxlag-fhccu14t", "region": "us-east-1" }, { "ownerAccount": "123456789012", "connectionId": "dxcon-fgk145dr", "lagId": "dxlag-fhccu14t", "connectionState": "down", "bandwidth": "1Gbps", "location": "EqDC2", "connectionName": "VAConn1", "region": "us-east-1" } ], "lagId": "dxlag-fhccu14t", "minimumLinks": 0, "connectionsBandwidth": "1Gbps", "region": "us-east-1", "location": "EqDC2" } ``` + Einzelheiten zur API finden Sie [CreateLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-lag.html)in der *AWS CLI Befehlsreferenz.* ### `create-private-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`create-private-virtual-interface`. **AWS CLI** **So erstellen Sie eine private virtuelle Schnittstelle** Der folgende `create-private-virtual-interface`-Befehl erstellt eine private virtuelle Schnittstelle: ``` aws directconnect create-private-virtual-interface --connection-id dxcon-ffjrkx17 --new-private-virtual-interface virtualInterfaceName=PrivateVirtualInterface,vlan=101,asn=65000,authKey=asdf34example,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30,virtualGatewayId=vgw-aba37db6 ``` Ausgabe: ``` { "virtualInterfaceState": "pending", "asn": 65000, "vlan": 101, "customerAddress": "192.168.1.2/30", "ownerAccount": "123456789012", "connectionId": "dxcon-ffjrkx17", "virtualGatewayId": "vgw-aba37db6", "virtualInterfaceId": "dxvif-ffhhk74f", "authKey": "asdf34example", "routeFilterPrefixes": [], "location": "TIVIT", "customerRouterConfig": "\n\n 101\n 192.168.1.2/30\n 192.168.1.1/30\n 65000\n asdf34example\n 7224\n private\n\n", "amazonAddress": "192.168.1.1/30", "virtualInterfaceType": "private", "virtualInterfaceName": "PrivateVirtualInterface" } ``` + Einzelheiten zur API finden Sie [CreatePrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-private-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `create-public-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`create-public-virtual-interface`. **AWS CLI** **Um eine öffentliche virtuelle Schnittstelle zu erstellen** Der folgende `create-public-virtual-interface`-Befehl erstellt eine öffentliche virtuelle Schnittstelle: ``` aws directconnect create-public-virtual-interface --connection-id dxcon-ffjrkx17 --new-public-virtual-interface virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,authKey=asdf34example,amazonAddress=203.0.113.1/30,customerAddress=203.0.113.2/30,routeFilterPrefixes=[{cidr=203.0.113.0/30},{cidr=203.0.113.4/30}] ``` Ausgabe: ``` { "virtualInterfaceState": "verifying", "asn": 65000, "vlan": 2000, "customerAddress": "203.0.113.2/30", "ownerAccount": "123456789012", "connectionId": "dxcon-ffjrkx17", "virtualInterfaceId": "dxvif-fgh0hcrk", "authKey": "asdf34example", "routeFilterPrefixes": [ { "cidr": "203.0.113.0/30" }, { "cidr": "203.0.113.4/30" } ], "location": "TIVIT", "customerRouterConfig": "\n\n 2000\n 203.0.113.2/30\n 203.0.113.1/30\n 65000\n asdf34example\n 7224\n public\n\n", "amazonAddress": "203.0.113.1/30", "virtualInterfaceType": "public", "virtualInterfaceName": "PublicVirtualInterface" } ``` + Einzelheiten zur API finden Sie [CreatePublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-public-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`create-transit-virtual-interface`. **AWS CLI** **So erstellen Sie eine virtuelle Transit-Schnittstelle** Im folgenden Beispiel für `create-transit-virtual-interface` wird eine virtuelle Transit-Schnittstelle für die angegebene Verbindung erstellt. ``` aws directconnect create-transit-virtual-interface \ --connection-id dxlag-fEXAMPLE \ --new-transit-virtual-interface "virtualInterfaceName=Example Transit Virtual Interface,vlan=126,asn=65110,mtu=1500,authKey=0xzxgA9YoW9h58u8SvEXAMPLE,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30,addressFamily=ipv4,directConnectGatewayId=8384da05-13ce-4a91-aada-5a1baEXAMPLE,tags=[{key=Tag,value=Example}]" ``` Ausgabe: ``` { "virtualInterface": { "ownerAccount": "1111222233333", "virtualInterfaceId": "dxvif-fEXAMPLE", "location": "loc1", "connectionId": "dxlag-fEXAMPLE", "virtualInterfaceType": "transit", "virtualInterfaceName": "Example Transit Virtual Interface", "vlan": 126, "asn": 65110, "amazonSideAsn": 4200000000, "authKey": "0xzxgA9YoW9h58u8SEXAMPLE", "amazonAddress": "192.168.1.1/30", "customerAddress": "192.168.1.2/30", "addressFamily": "ipv4", "virtualInterfaceState": "pending", "customerRouterConfig": "\n\n 126\n 192.168.1.2/30\n 192.168.1.1/30\n 65110\n 0xzxgA9YoW9h58u8SvOmXRTw\n 4200000000\n transit\n\n", "mtu": 1500, "jumboFrameCapable": true, "virtualGatewayId": "", "directConnectGatewayId": "8384da05-13ce-4a91-aada-5a1baEXAMPLE", "routeFilterPrefixes": [], "bgpPeers": [ { "bgpPeerId": "dxpeer-EXAMPLE", "asn": 65110, "authKey": "0xzxgA9YoW9h58u8SEXAMPLE", "addressFamily": "ipv4", "amazonAddress": "192.168.1.1/30", "customerAddress": "192.168.1.2/30", "bgpPeerState": "pending", "bgpStatus": "down", "awsDeviceV2": "loc1-26wz6vEXAMPLE" } ], "region": "sa-east-1", "awsDeviceV2": "loc1-26wz6vEXAMPLE", "tags": [ { "key": "Tag", "value": "Example" } ] } } ``` Weitere Informationen finden Sie unter [Erstellen einer virtuellen Transit-Schnittstelle für das Direct-Connect-Gateway](https://docs.aws.amazon.com/directconnect/latest/UserGuide/create-vif.html#create-transit-vif) im *Benutzerhandbuch für AWS Direct Connect*. + Einzelheiten zur API finden Sie [CreateTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-transit-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `delete-bgp-peer` Das folgende Codebeispiel zeigt die Verwendung`delete-bgp-peer`. **AWS CLI** **So löschen Sie einen BGP-Peer von einer virtuellen Schnittstelle** Das folgende Beispiel löscht den IPv6 BGP-Peer aus der virtuellen Schnittstelle. `dxvif-fg1vuj3d` Befehl: ``` aws directconnect delete-bgp-peer --virtual-interface-id dxvif-fg1vuj3d --asn 64600 --customer-address 2001:db8:1100:2f0:0:1:9cb4:4216/125 ``` Ausgabe: ``` { "virtualInterface": { "virtualInterfaceState": "available", "asn": 65000, "vlan": 125, "customerAddress": "169.254.255.2/30", "ownerAccount": "123456789012", "connectionId": "dxcon-fguhmqlc", "addressFamily": "ipv4", "virtualGatewayId": "vgw-f9eb0c90", "virtualInterfaceId": "dxvif-fg1vuj3d", "authKey": "0xC_ukbCerl6EYA0example", "routeFilterPrefixes": [], "location": "EqDC2", "bgpPeers": [ { "bgpStatus": "down", "customerAddress": "169.254.255.2/30", "addressFamily": "ipv4", "authKey": "0xC_ukbCerl6EYA0uexample", "bgpPeerState": "available", "amazonAddress": "169.254.255.1/30", "asn": 65000 }, { "bgpStatus": "down", "customerAddress": "2001:db8:1100:2f0:0:1:9cb4:4216/125", "addressFamily": "ipv6", "authKey": "0xS27kAIU_VHPjjAexample", "bgpPeerState": "deleting", "amazonAddress": "2001:db8:1100:2f0:0:1:9cb4:4211/125", "asn": 64600 } ], "customerRouterConfig": "\n\n 125\n 169.254.255.2/30\n 169.254.255.1/30\n 65000\n 0xC_ukbCerl6EYA0example\n 7224\n private\n\n", "amazonAddress": "169.254.255.1/30", "virtualInterfaceType": "private", "virtualInterfaceName": "Test" } } ``` + Einzelheiten zur API finden Sie unter [DeleteBgpPeer AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-bgp-peer.html)*Befehlsreferenz*. ### `delete-connection` Das folgende Codebeispiel zeigt die Verwendung`delete-connection`. **AWS CLI** **So löschen Sie eine Verbindung** Der folgende `delete-connection`-Befehl löscht die angegebene Verbindung. ``` aws directconnect delete-connection --connection-id dxcon-fg31dyv6 ``` Ausgabe: ``` { "ownerAccount": "123456789012", "connectionId": "dxcon-fg31dyv6", "connectionState": "deleted", "bandwidth": "1Gbps", "location": "TIVIT", "connectionName": "Connection to AWS", "region": "sa-east-1" } ``` + Einzelheiten zur API finden Sie [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-connection.html)in der *AWS CLI Befehlsreferenz*. ### `delete-direct-connect-gateway-association` Das folgende Codebeispiel zeigt die Verwendung`delete-direct-connect-gateway-association`. **AWS CLI** **So löschen Sie eine Zuordnung des Direct-Connect-Gateways** Im folgenden Beispiel für `delete-direct-connect-gateway-association` wird die Zuordnung des Direct-Connect-Gateways zu einem Transit-Gateway gelöscht, das die angegebene Zuordnungs-ID hat. ``` aws directconnect delete-direct-connect-gateway-association --association-id be85116d-46eb-4b43-a27a-da0c2ad648de ``` Ausgabe: ``` { "directConnectGatewayAssociation": { "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPlE", "directConnectGatewayOwnerAccount": "123456789012", "associationState": "disassociating", "associatedGateway": { "id": "tgw-095b3b0b54EXAMPLE", "type": "transitGateway", "ownerAccount": "123456789012", "region": "us-east-1" }, "associationId": " be85116d-46eb-4b43-a27a-da0c2ad648deEXAMPLE ", "allowedPrefixesToDirectConnectGateway": [ { "cidr": "192.0.1.0/28" } ] } } ``` Weitere Informationen finden Sie unter [Zuordnen und Aufheben der Zuordnung von Transit-Gateways](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-transit-gateways.html#associate-tgw-with-direct-connect-gateway) im *Benutzerhandbuch für AWS Direct Connect*. + Einzelheiten zur API finden Sie [DeleteDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-direct-connect-gateway-association.html)in der *AWS CLI Befehlsreferenz*. ### `delete-direct-connect-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-direct-connect-gateway`. **AWS CLI** **So löschen Sie ein Direct-Connect-Gateway** Im folgenden Beispiel wird das Direct-Connect-Gateway `5f294f92-bafb-4011-916d-9b0bexample` gelöscht. Befehl: ``` aws directconnect delete-direct-connect-gateway --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample ``` Ausgabe: ``` { "directConnectGateway": { "amazonSideAsn": 64512, "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample", "ownerAccount": "123456789012", "directConnectGatewayName": "DxGateway1", "directConnectGatewayState": "deleting" } } ``` + Einzelheiten zur API finden Sie [DeleteDirectConnectGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-direct-connect-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `delete-interconnect` Das folgende Codebeispiel zeigt die Verwendung`delete-interconnect`. **AWS CLI** **So löschen Sie eine Interconnect-Verbindung** Der folgende `delete-interconnect`-Befehl löscht die angegebene Interconnect-Verbindung: ``` aws directconnect delete-interconnect --interconnect-id dxcon-fgktov66 ``` Ausgabe: ``` { "interconnectState": "deleted" } ``` + Einzelheiten zur API finden Sie [DeleteInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-interconnect.html)in der *AWS CLI Befehlsreferenz*. ### `delete-lag` Das folgende Codebeispiel zeigt die Verwendung`delete-lag`. **AWS CLI** **Um eine LAG zu löschen** Im folgenden Beispiel wird die angegebene LAG gelöscht. Befehl: ``` aws directconnect delete-lag --lag-id dxlag-ffrhowd9 ``` Ausgabe: ``` { "awsDevice": "EqDC2-4h6ce2r1bes6", "numberOfConnections": 0, "lagState": "deleted", "ownerAccount": "123456789012", "lagName": "TestLAG", "connections": [], "lagId": "dxlag-ffrhowd9", "minimumLinks": 0, "connectionsBandwidth": "1Gbps", "region": "us-east-1", "location": "EqDC2" } ``` + Einzelheiten zur API finden Sie [DeleteLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-lag.html)in der *AWS CLI Befehlsreferenz*. ### `delete-virtual-interface` Das folgende Codebeispiel zeigt die Verwendung`delete-virtual-interface`. **AWS CLI** **Um eine virtuelle Schnittstelle zu löschen** Der folgende `delete-virtual-interface`-Befehl löscht die angegebene virtuelle Schnittstelle: ``` aws directconnect delete-virtual-interface --virtual-interface-id dxvif-ffhhk74f ``` Ausgabe: ``` { "virtualInterfaceState": "deleting" } ``` + Einzelheiten zur API finden Sie [DeleteVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-virtual-interface.html)in der *AWS CLI Befehlsreferenz*. ### `describe-connection-loa` Das folgende Codebeispiel zeigt die Verwendung`describe-connection-loa`. **AWS CLI** **So beschreiben Sie Ihre LOA-CFA für eine Verbindung unter Linux oder Mac OS X** Das folgende Beispiel beschreibt Ihre LOA-CFA für die Verbindung `dxcon-fh6ayh1d`. Der Inhalt der LOA-CFA ist base64-kodiert. Dieser Befehl verwendet die Parameter `--output` und `--query`, um die Ausgabe zu steuern und den Inhalt der Struktur `loaContent` zu extrahieren. Der letzte Teil des Befehls decodiert den Inhalt mit dem `base64`-Dienstprogramm und sendet die Ausgabe an eine PDF-Datei. ``` aws directconnect describe-connection-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf ``` **So beschreiben Sie Ihre LOA-CFA für eine Verbindung unter Windows** Das vorherige Beispiel erfordert die Verwendung des `base64`-Dienstprogramms, um die Ausgabe zu decodieren. Auf einem Windows-Computer können Sie stattdessen `certutil` verwenden. Im folgenden Beispiel beschreibt der erste Befehl Ihre LOA-CFA für die Verbindung `dxcon-fh6ayh1d` und verwendet die Parameter `--output` und `--query`, um die Ausgabe zu steuern sowie den Inhalt der Struktur `loaContent` in eine Datei mit dem Namen `myLoaCfa.base64` zu extrahieren. Der zweite Befehl verwendet das `certutil`-Dienstprogramm um die Datei zu dekodieren und die Ausgabe an eine PDF-Datei zu senden. ``` aws directconnect describe-connection-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64 ``` ``` certutil -decode myLoaCfa.base64 myLoaCfa.pdf ``` Weitere Informationen zur Steuerung der AWS CLI-Ausgabe finden Sie unter [Steuern der Befehlsausgabe über die AWS Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [DescribeConnectionLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connection-loa.html)unter *AWS CLI Befehlsreferenz*. ### `describe-connections-on-interconnect` Das folgende Codebeispiel zeigt die Verwendung`describe-connections-on-interconnect`. **AWS CLI** **So listen Sie Verbindungen über eine Interconnect-Verbindung auf** Der folgende `describe-connections-on-interconnect`-Befehl listet die Verbindungen auf, die über die angegebene Interconnect-Verbindung bereitgestellt wurden: ``` aws directconnect describe-connections-on-interconnect --interconnect-id dxcon-fgktov66 ``` Ausgabe: ``` { "connections": [ { "partnerName": "TIVIT", "vlan": 101, "ownerAccount": "123456789012", "connectionId": "dxcon-ffzc51m1", "connectionState": "ordering", "bandwidth": "500Mbps", "location": "TIVIT", "connectionName": "mydcinterconnect", "region": "sa-east-1" } ] } ``` + Einzelheiten zur API finden Sie [DescribeConnectionsOnInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connections-on-interconnect.html)in der *AWS CLI Befehlsreferenz*. ### `describe-connections` Das folgende Codebeispiel zeigt die Verwendung`describe-connections`. **AWS CLI** **So listen Sie alle Verbindungen in der aktuellen Region auf** Der folgende `describe-connections`-Befehl listet alle Verbindungen in der aktuellen Region auf: ``` aws directconnect describe-connections ``` Ausgabe: ``` { "connections": [ { "awsDevice": "EqDC2-123h49s71dabc", "ownerAccount": "123456789012", "connectionId": "dxcon-fguhmqlc", "lagId": "dxlag-ffrz71kw", "connectionState": "down", "bandwidth": "1Gbps", "location": "EqDC2", "connectionName": "My_Connection", "loaIssueTime": 1491568964.0, "region": "us-east-1" } ] } ``` + Einzelheiten zur API finden Sie [DescribeConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connections.html)in der *AWS CLI Befehlsreferenz*. ### `describe-direct-connect-gateway-association-proposals` Das folgende Codebeispiel zeigt die Verwendung`describe-direct-connect-gateway-association-proposals`. **AWS CLI** **So beschreiben Sie die Zuordnungsvorschläge für Ihr Direct-Connect-Gateway** Im folgenden Beispiel für `describe-direct-connect-gateway-association-proposals` werden Details zu den Zuordnungsvorschlägen für Ihr Direct-Connect-Gateway angezeigt. ``` aws directconnect describe-direct-connect-gateway-association-proposals ``` Ausgabe: ``` { "directConnectGatewayAssociationProposals": [ { "proposalId": "c2ede9b4-bbc6-4d33-923c-bc4feEXAMPLE", "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE", "directConnectGatewayOwnerAccount": "111122223333", "proposalState": "requested", "associatedGateway": { "id": "tgw-02f776b1a7EXAMPLE", "type": "transitGateway", "ownerAccount": "111122223333", "region": "us-east-1" }, "existingAllowedPrefixesToDirectConnectGateway": [ { "cidr": "192.168.2.0/30" }, { "cidr": "192.168.1.0/30" } ], "requestedAllowedPrefixesToDirectConnectGateway": [ { "cidr": "192.168.1.0/30" } ] }, { "proposalId": "cb7f41cb-8128-43a5-93b1-dcaedEXAMPLE", "directConnectGatewayId": "11560968-4ac1-4fd3-bcb2-00599EXAMPLE", "directConnectGatewayOwnerAccount": "111122223333", "proposalState": "accepted", "associatedGateway": { "id": "tgw-045776b1a7EXAMPLE", "type": "transitGateway", "ownerAccount": "111122223333", "region": "us-east-1" }, "existingAllowedPrefixesToDirectConnectGateway": [ { "cidr": "192.168.4.0/30" }, { "cidr": "192.168.5.0/30" } ], "requestedAllowedPrefixesToDirectConnectGateway": [ { "cidr": "192.168.5.0/30" } ] } ] } ``` Weitere Informationen finden Sie unter [Zuordnen und Aufheben der Zuordnung von Transit-Gateways](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-transit-gateways.html#associate-tgw-with-direct-connect-gateway) im *Benutzerhandbuch für AWS Direct Connect*. + Einzelheiten zur API finden Sie [DescribeDirectConnectGatewayAssociationProposals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-association-proposals.html)in der *AWS CLI Befehlsreferenz*. ### `describe-direct-connect-gateway-associations` Das folgende Codebeispiel zeigt die Verwendung`describe-direct-connect-gateway-associations`. **AWS CLI** **So beschreiben Sie Zuordnungen des Direct-Connect-Gateways** Das folgende Beispiel beschreibt alle Zuordnungen zum Direct-Connect-Gateway `5f294f92-bafb-4011-916d-9b0bexample`. Befehl: ``` aws directconnect describe-direct-connect-gateway-associations --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample ``` Ausgabe: ``` { "nextToken": "eyJ2IjoxLCJzIjoxLCJpIjoiOU83OTFodzdycnZCbkN4MExHeHVwQT09IiwiYyI6InIxTEN0UEVHV0I1UFlkaWFnNlUxanJkRWF6eW1iOElHM0FRVW1MdHRJK0dxcnN1RWtvcFBKWFE2ZjRNRGdGTkhCa0tDZmVINEtZOEYwZ0dEYWZpbmU0ZnZMYVhKRjdXRVdENmdQZ1Y4d2w0PSJ9", "directConnectGatewayAssociations": [ { "associationState": "associating", "virtualGatewayOwnerAccount": "123456789012", "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample", "virtualGatewayId": "vgw-6efe725e", "virtualGatewayRegion": "us-east-2" }, { "associationState": "disassociating", "virtualGatewayOwnerAccount": "123456789012", "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample", "virtualGatewayId": "vgw-ebaa27db", "virtualGatewayRegion": "us-east-2" } ] } ``` + Einzelheiten zur API finden Sie [DescribeDirectConnectGatewayAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-associations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-direct-connect-gateway-attachments` Das folgende Codebeispiel zeigt die Verwendung`describe-direct-connect-gateway-attachments`. **AWS CLI** **So beschreiben Sie Anhänge des Direct-Connect-Gateways** Das folgende Beispiel beschreibt die virtuellen Schnittstellen, die an das Direct-Connect-Gateway `5f294f92-bafb-4011-916d-9b0bexample` angehängt sind. Befehl: ``` aws directconnect describe-direct-connect-gateway-attachments --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample ``` Ausgabe: ``` { "directConnectGatewayAttachments": [ { "virtualInterfaceOwnerAccount": "123456789012", "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample", "virtualInterfaceRegion": "us-east-2", "attachmentState": "attaching", "virtualInterfaceId": "dxvif-fg9zyabc" } ], "nextToken": "eyJ2IjoxLCJzIjoxLCJpIjoibEhXdlNpUXF5RzhoL1JyUW52SlV2QT09IiwiYyI6Im5wQjFHQ0RyQUdRS3puNnNXcUlINCtkTTA4dTk3KzBiU0xtb05JQmlaczZ6NXRIYmk3c3VESUxFTTd6a2FzVHM0VTFwaGJkZGNxTytqWmQ3QzMzOGRQaTVrTThrOG1zelRsV3gyMWV3VTNFPSJ9" } ``` + Einzelheiten zur API finden Sie [DescribeDirectConnectGatewayAttachments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-attachments.html)in der *AWS CLI Befehlsreferenz*. ### `describe-direct-connect-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-direct-connect-gateways`. **AWS CLI** **So beschreiben Sie Ihre Direct-Connect-Gateways** Das folgende Beispiel beschreibt alle Ihre Direct-Connect-Gateways. Befehl: ``` aws directconnect describe-direct-connect-gateways ``` Ausgabe: ``` { "directConnectGateways": [ { "amazonSideAsn": 64512, "directConnectGatewayId": "cf68415c-f4ae-48f2-87a7-3b52cexample", "ownerAccount": "123456789012", "directConnectGatewayName": "DxGateway2", "directConnectGatewayState": "available" }, { "amazonSideAsn": 64512, "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bdexample", "ownerAccount": "123456789012", "directConnectGatewayName": "DxGateway1", "directConnectGatewayState": "available" } ] } ``` + Einzelheiten zur API finden Sie [DescribeDirectConnectGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateways.html)in der *AWS CLI Befehlsreferenz*. ### `describe-hosted-connections` Das folgende Codebeispiel zeigt die Verwendung`describe-hosted-connections`. **AWS CLI** **So listen Sie Verbindungen über eine Interconnect-Verbindung auf** Im folgenden Beispiel wird die Verbindungen aufgelistet, die über die angegebene Interconnect-Verbindung bereitgestellt wurden. Befehl: ``` aws directconnect describe-hosted-connections --connection-id dxcon-fgktov66 ``` Ausgabe: ``` { "connections": [ { "partnerName": "TIVIT", "vlan": 101, "ownerAccount": "123456789012", "connectionId": "dxcon-ffzc51m1", "connectionState": "ordering", "bandwidth": "500Mbps", "location": "TIVIT", "connectionName": "mydcinterconnect", "region": "sa-east-1" } ] } ``` + Einzelheiten zur API finden Sie [DescribeHostedConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-hosted-connections.html)in der *AWS CLI Befehlsreferenz*. ### `describe-interconnect-loa` Das folgende Codebeispiel zeigt die Verwendung`describe-interconnect-loa`. **AWS CLI** **So beschreiben Sie Ihre LOA-CFA für eine Interconnect-Verbindung unter Linux oder Mac OS X** Das folgende Beispiel beschreibt Ihre LOA-CFA für die Interconnect-Verbindung `dxcon-fh6ayh1d`. Der Inhalt der LOA-CFA ist base64-kodiert. Dieser Befehl verwendet die Parameter `--output` und `--query`, um die Ausgabe zu steuern und den Inhalt der Struktur `loaContent` zu extrahieren. Der letzte Teil des Befehls decodiert den Inhalt mit dem `base64`-Dienstprogramm und sendet die Ausgabe an eine PDF-Datei. ``` aws directconnect describe-interconnect-loa --interconnect-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf ``` **So beschreiben Sie Ihre LOA-CFA für eine Interconnect-Verbindung unter Windows** Das vorherige Beispiel erfordert die Verwendung des `base64`-Dienstprogramms, um die Ausgabe zu decodieren. Auf einem Windows-Computer können Sie stattdessen `certutil` verwenden. Im folgenden Beispiel beschreibt der erste Befehl Ihre LOA-CFA für die Interconnect-Verbindung `dxcon-fh6ayh1d` und verwendet die Parameter `--output` und `--query`, um die Ausgabe zu steuern sowie den Inhalt der Struktur `loaContent` in eine Datei mit dem Namen `myLoaCfa.base64` zu extrahieren. Der zweite Befehl verwendet das `certutil`-Dienstprogramm um die Datei zu dekodieren und die Ausgabe an eine PDF-Datei zu senden. ``` aws directconnect describe-interconnect-loa --interconnect-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64 ``` ``` certutil -decode myLoaCfa.base64 myLoaCfa.pdf ``` Weitere Informationen zur Steuerung der AWS CLI-Ausgabe finden Sie unter [Steuern der Befehlsausgabe über die AWS Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [DescribeInterconnectLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-interconnect-loa.html)unter *AWS CLI Befehlsreferenz*. ### `describe-interconnects` Das folgende Codebeispiel zeigt die Verwendung`describe-interconnects`. **AWS CLI** **So listen Sie Interconnect-Verbindungen auf** Der folgende `describe-interconnects` Befehl listet die Interconnects auf, die Ihrem AWS Konto gehören: ``` aws directconnect describe-interconnects ``` Ausgabe: ``` { "interconnects": [ { "region": "sa-east-1", "bandwidth": "1Gbps", "location": "TIVIT", "interconnectName": "1G Interconnect to AWS", "interconnectId": "dxcon-fgktov66", "interconnectState": "down" } ] } ``` + Einzelheiten zur API finden Sie [DescribeInterconnects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-interconnects.html)in der *AWS CLI Befehlsreferenz.* ### `describe-lags` Das folgende Codebeispiel zeigt die Verwendung`describe-lags`. **AWS CLI** **Um deine zu beschreiben LAGs** Der folgende Befehl beschreibt alle Ihre LAGs für die aktuelle Region. Befehl: ``` aws directconnect describe-lags ``` Ausgabe: ``` { "lags": [ { "awsDevice": "EqDC2-19y7z3m17xpuz", "numberOfConnections": 2, "lagState": "down", "ownerAccount": "123456789012", "lagName": "DA-LAG", "connections": [ { "ownerAccount": "123456789012", "connectionId": "dxcon-ffnikghc", "lagId": "dxlag-fgsu9erb", "connectionState": "requested", "bandwidth": "10Gbps", "location": "EqDC2", "connectionName": "Requested Connection 1 for Lag dxlag-fgsu9erb", "region": "us-east-1" }, { "ownerAccount": "123456789012", "connectionId": "dxcon-fglgbdea", "lagId": "dxlag-fgsu9erb", "connectionState": "requested", "bandwidth": "10Gbps", "location": "EqDC2", "connectionName": "Requested Connection 2 for Lag dxlag-fgsu9erb", "region": "us-east-1" } ], "lagId": "dxlag-fgsu9erb", "minimumLinks": 0, "connectionsBandwidth": "10Gbps", "region": "us-east-1", "location": "EqDC2" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-lags.html)in der *AWS CLI Befehlsreferenz*. ### `describe-loa` Das folgende Codebeispiel zeigt die Verwendung`describe-loa`. **AWS CLI** **So beschreiben Sie Ihre LOA-CFA für eine Verbindung unter Linux oder Mac OS X** Das folgende Beispiel beschreibt Ihre LOA-CFA für die Verbindung `dxcon-fh6ayh1d`. Der Inhalt der LOA-CFA ist base64-kodiert. Dieser Befehl verwendet die Parameter `--output` und `--query`, um die Ausgabe zu steuern und den Inhalt der Struktur `loaContent` zu extrahieren. Der letzte Teil des Befehls decodiert den Inhalt mit dem `base64`-Dienstprogramm und sendet die Ausgabe an eine PDF-Datei. ``` aws directconnect describe-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf ``` **So beschreiben Sie Ihre LOA-CFA für eine Verbindung unter Windows** Das vorherige Beispiel erfordert die Verwendung des `base64`-Dienstprogramms, um die Ausgabe zu decodieren. Auf einem Windows-Computer können Sie stattdessen `certutil` verwenden. Im folgenden Beispiel beschreibt der erste Befehl Ihre LOA-CFA für die Verbindung `dxcon-fh6ayh1d` und verwendet die Parameter `--output` und `--query`, um die Ausgabe zu steuern sowie den Inhalt der Struktur `loaContent` in eine Datei mit dem Namen `myLoaCfa.base64` zu extrahieren. Der zweite Befehl verwendet das `certutil`-Dienstprogramm um die Datei zu dekodieren und die Ausgabe an eine PDF-Datei zu senden. ``` aws directconnect describe-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64 ``` ``` certutil -decode myLoaCfa.base64 myLoaCfa.pdf ``` Weitere Informationen zur Steuerung der AWS CLI-Ausgabe finden Sie unter [Steuern der Befehlsausgabe über die AWS Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [DescribeLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-loa.html)unter *AWS CLI Befehlsreferenz*. ### `describe-locations` Das folgende Codebeispiel zeigt die Verwendung`describe-locations`. **AWS CLI** **Um AWS Direct Connect-Partner und Standorte aufzulisten** Mit dem folgenden `describe-locations` Befehl werden AWS Direct Connect-Partner und Standorte in der aktuellen Region aufgeführt: ``` aws directconnect describe-locations ``` Ausgabe: ``` { "locations": [ { "locationName": "NAP do Brasil, Barueri, Sao Paulo", "locationCode": "TNDB" }, { "locationName": "Tivit - Site Transamerica (Sao Paulo)", "locationCode": "TIVIT" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLocations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-locations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-tags` Das folgende Codebeispiel zeigt die Verwendung`describe-tags`. **AWS CLI** **Um Tags für Ihre AWS Direct Connect-Ressourcen zu beschreiben** Der folgende Befehl beschreibt die Tags für die Verbindung `dxcon-abcabc12`. Befehl: ``` aws directconnect describe-tags --resource-arns arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 ``` Ausgabe: ``` { "resourceTags": [ { "resourceArn": "arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12", "tags": [ { "value": "VAConnection", "key": "Name" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-tags.html)in der *AWS CLI Befehlsreferenz*. ### `describe-virtual-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-virtual-gateways`. **AWS CLI** **So listen Sie Virtual Private Gateways auf** Der folgende `describe-virtual-gateways` Befehl listet virtuelle private Gateways auf, die Ihrem AWS Konto gehören: ``` aws directconnect describe-virtual-gateways ``` Ausgabe: ``` { "virtualGateways": [ { "virtualGatewayId": "vgw-aba37db6", "virtualGatewayState": "available" } ] } ``` + Einzelheiten zur API finden Sie [DescribeVirtualGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-virtual-gateways.html)in der *AWS CLI Befehlsreferenz.* ### `describe-virtual-interfaces` Das folgende Codebeispiel zeigt die Verwendung`describe-virtual-interfaces`. **AWS CLI** **So listen Sie alle virtuellen Schnittstellen auf** Der folgende `describe-virtual-interfaces` Befehl listet die Informationen zu allen virtuellen Schnittstellen auf, die mit Ihrem AWS Konto verknüpft sind: ``` aws directconnect describe-virtual-interfaces --connection-id dxcon-ffjrkx17 ``` Ausgabe: ``` { "virtualInterfaces": [ { "virtualInterfaceState": "down", "asn": 65000, "vlan": 101, "customerAddress": "192.168.1.2/30", "ownerAccount": "123456789012", "connectionId": "dxcon-ffjrkx17", "virtualGatewayId": "vgw-aba37db6", "virtualInterfaceId": "dxvif-ffhhk74f", "authKey": "asdf34example", "routeFilterPrefixes": [], "location": "TIVIT", "customerRouterConfig": "\n\n 101\n 192.168.1.2/30\n 192.168.1.1/30\n 65000\n asdf34example\n 7224\n private\n\n", "amazonAddress": "192.168.1.1/30", "virtualInterfaceType": "private", "virtualInterfaceName": "PrivateVirtualInterface" }, { "virtualInterfaceState": "verifying", "asn": 65000, "vlan": 2000, "customerAddress": "203.0.113.2/30", "ownerAccount": "123456789012", "connectionId": "dxcon-ffjrkx17", "virtualGatewayId": "", "virtualInterfaceId": "dxvif-fgh0hcrk", "authKey": "asdf34example", "routeFilterPrefixes": [ { "cidr": "203.0.113.4/30" }, { "cidr": "203.0.113.0/30" } ], "location": "TIVIT", "customerRouterConfig": "\n\n 2000\n 203.0.113.2/30\n 203.0.113.1/30\n 65000\n asdf34example\n 7224\n public\n\n", "amazonAddress": "203.0.113.1/30", "virtualInterfaceType": "public", "virtualInterfaceName": "PublicVirtualInterface" } ] } ``` + Einzelheiten zur API finden Sie [DescribeVirtualInterfaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-virtual-interfaces.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-connection-from-lag` Das folgende Codebeispiel zeigt die Verwendung`disassociate-connection-from-lag`. **AWS CLI** **Um eine Verbindung von einer LAG zu trennen** Im folgenden Beispiel wird die Zuordnung der angegebene Verbindung zu der spezifizierten LAG aufgehoben. Befehl: ``` aws directconnect disassociate-connection-from-lag --lag-id dxlag-fhccu14t --connection-id dxcon-fg9607vm ``` Ausgabe: ``` { "ownerAccount": "123456789012", "connectionId": "dxcon-fg9607vm", "connectionState": "requested", "bandwidth": "1Gbps", "location": "EqDC2", "connectionName": "Con2ForLag", "region": "us-east-1" } ``` + Einzelheiten zur API finden Sie [DisassociateConnectionFromLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/disassociate-connection-from-lag.html)in der *AWS CLI Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer AWS Direct Connect-Ressource ein Tag hinzu** Der folgende Befehl fügt der Verbindung `dxcon-abcabc12` ein Tag mit dem Schlüssel `Name` und dem Wert `VAConnection` hinzu. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tags "key=Name,value=VAConnection" ``` + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag aus einer AWS Direct Connect-Ressource** Mit dem folgenden Befehl wird das Tag mit dem Schlüssel `Name` aus der Verbindung `dxcon-abcabc12` entfernt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tag-keys Name ``` + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-direct-connect-gateway-association` Das folgende Codebeispiel zeigt die Verwendung`update-direct-connect-gateway-association`. **AWS CLI** **So aktualisieren Sie die angegebenen Attribute der Zuordnung des Direct-Connect-Gateways** Im folgenden Beispiel für `update-direct-connect-gateway-association` wird der angegebene CIDR-Block einer Zuordnung des Direct-Connect-Gateways hinzugefügt. ``` aws directconnect update-direct-connect-gateway-association \ --association-id 820a6e4f-5374-4004-8317-3f64bEXAMPLE \ --add-allowed-prefixes-to-direct-connect-gateway cidr=192.168.2.0/30 ``` Ausgabe: ``` { "directConnectGatewayAssociation": { "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE", "directConnectGatewayOwnerAccount": "111122223333", "associationState": "updating", "associatedGateway": { "id": "tgw-02f776b1a7EXAMPLE", "type": "transitGateway", "ownerAccount": "111122223333", "region": "us-east-1" }, "associationId": "820a6e4f-5374-4004-8317-3f64bEXAMPLE", "allowedPrefixesToDirectConnectGateway": [ { "cidr": "192.168.2.0/30" }, { "cidr": "192.168.1.0/30" } ] } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Direct-Connect-Gateways](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-gateways.html) im *Benutzerhandbuch für AWS Direct Connect*. + Einzelheiten zur API finden Sie [UpdateDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-direct-connect-gateway-association.html)in der *AWS CLI Befehlsreferenz*. ### `update-lag` Das folgende Codebeispiel zeigt die Verwendung`update-lag`. **AWS CLI** **Um eine LAG zu aktualisieren** Im folgenden Beispiel wird der Name der angegebenen LAG geändert. Befehl: ``` aws directconnect update-lag --lag-id dxlag-ffjhj9lx --lag-name 2ConnLag ``` Ausgabe: ``` { "awsDevice": "CSVA1-23u8tlpaz8iks", "numberOfConnections": 2, "lagState": "down", "ownerAccount": "123456789012", "lagName": "2ConnLag", "connections": [ { "ownerAccount": "123456789012", "connectionId": "dxcon-fflqyj95", "lagId": "dxlag-ffjhj9lx", "connectionState": "requested", "bandwidth": "1Gbps", "location": "CSVA1", "connectionName": "Requested Connection 2 for Lag dxlag-ffjhj9lx", "region": "us-east-1" }, { "ownerAccount": "123456789012", "connectionId": "dxcon-ffqr6x5q", "lagId": "dxlag-ffjhj9lx", "connectionState": "requested", "bandwidth": "1Gbps", "location": "CSVA1", "connectionName": "Requested Connection 1 for Lag dxlag-ffjhj9lx", "region": "us-east-1" } ], "lagId": "dxlag-ffjhj9lx", "minimumLinks": 0, "connectionsBandwidth": "1Gbps", "region": "us-east-1", "location": "CSVA1" } ``` + Einzelheiten zur API finden Sie [UpdateLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-lag.html)in der *AWS CLI Befehlsreferenz*. ### `update-virtual-interface-attributes` Das folgende Codebeispiel zeigt die Verwendung`update-virtual-interface-attributes`. **AWS CLI** **So aktualisieren Sie die MTU für eine virtuelle Schnittstelle** Im folgenden Beispiel für `update-virtual-interface-attributes` wird die MTU der angegebenen virtuellen Schnittstelle aktualisiert. ``` aws directconnect update-virtual-interface-attributes \ --virtual-interface-id dxvif-fEXAMPLE \ --mtu 1500 ``` Ausgabe: ``` { "ownerAccount": "1111222233333", "virtualInterfaceId": "dxvif-fEXAMPLE", "location": "loc1", "connectionId": "dxlag-fEXAMPLE", "virtualInterfaceType": "transit", "virtualInterfaceName": "example transit virtual interface", "vlan": 125, "asn": 650001, "amazonSideAsn": 64512, "authKey": "0xzxgA9YoW9h58u8SEXAMPLE", "amazonAddress": "169.254.248.1/30", "customerAddress": "169.254.248.2/30", "addressFamily": "ipv4", "virtualInterfaceState": "down", "customerRouterConfig": "\n\n 125\n 169.254.248.2/30\n 169.254.248.1/30\n 650001\n 0xzxgA9YoW9h58u8SEXAMPLE\n 64512\n transit\n\n", "mtu": 1500, "jumboFrameCapable": true, "virtualGatewayId": "", "directConnectGatewayId": "879b76a1-403d-4700-8b53-4a56ed85436e", "routeFilterPrefixes": [], "bgpPeers": [ { "bgpPeerId": "dxpeer-fEXAMPLE", "asn": 650001, "authKey": "0xzxgA9YoW9h58u8SEXAMPLE", "addressFamily": "ipv4", "amazonAddress": "169.254.248.1/30", "customerAddress": "169.254.248.2/30", "bgpPeerState": "available", "bgpStatus": "down", "awsDeviceV2": "loc1-26wz6vEXAMPLE" } ], "region": "sa-east-1", "awsDeviceV2": "loc1-26wz6vEXAMPLE", "tags": [] } ``` Weitere Informationen finden Sie unter [Festlegen des Netzwerk-MTU für private virtuelle Schnittstellen oder virtuelle Transit-Schnittstellen](https://docs.aws.amazon.com/directconnect/latest/UserGuide/set-jumbo-frames-vif.html) im *Benutzerhandbuch für AWS Direct Connect*. + Einzelheiten zur API finden Sie [UpdateVirtualInterfaceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-virtual-interface-attributes.html)in der *AWS CLI Befehlsreferenz*. # Directory Service Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren Directory Service. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `describe-directories` Das folgende Codebeispiel zeigt, wie Sie`describe-directories`. **AWS CLI** **So rufen Sie Details zu Ihren Verzeichnissen ab** Im folgenden Beispiel für `describe-directories` werden die Details für das angegebene Verzeichnis angezeigt. ``` aws ds describe-directories \ --directory-id d-a1b2c3d4e5 ``` Ausgabe: ``` { "DirectoryDescriptions": [ { "DirectoryId": "d-a1b2c3d4e5", "Name": "mydirectory.example.com", "ShortName": "mydirectory", "Size": "Small", "Edition": "Standard", "Alias": "d-a1b2c3d4e5", "AccessUrl": "d-a1b2c3d4e5.awsapps.com", "Stage": "Active", "ShareStatus": "Shared", "ShareMethod": "HANDSHAKE", "ShareNotes": "These are my share notes", "LaunchTime": "2019-07-08T15:33:46.327000-07:00", "StageLastUpdatedDateTime": "2019-07-08T15:59:12.307000-07:00", "Type": "SharedMicrosoftAD", "SsoEnabled": false, "DesiredNumberOfDomainControllers": 0, "OwnerDirectoryDescription": { "DirectoryId": "d-b2c3d4e5f6", "AccountId": "123456789111", "DnsIpAddrs": [ "203.113.0.248", "203.113.0.253" ], "VpcSettings": { "VpcId": "vpc-a1b2c3d4", "SubnetIds": [ "subnet-a1b2c3d4", "subnet-d4c3b2a1" ], "AvailabilityZones": [ "us-west-2a", "us-west-2c" ] } } } ] } ``` + Einzelheiten zur API finden Sie [DescribeDirectories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ds/describe-directories.html)in der *AWS CLI Befehlsreferenz*. ### `describe-trusts` Das folgende Codebeispiel zeigt die Verwendung`describe-trusts`. **AWS CLI** **So rufen Sie Details zu Ihren Vertrauensbeziehungen ab** Im folgenden Beispiel für `describe-trusts` werden die Details zu den Vertrauensbeziehungen des angegebenen Verzeichnisses angezeigt. ``` aws ds describe-trusts \ --directory-id d-a1b2c3d4e5 ``` Ausgabe: ``` { "Trusts": [ { "DirectoryId": "d-a1b2c3d4e5", "TrustId": "t-9a8b7c6d5e", "RemoteDomainName": "other.example.com", "TrustType": "Forest", "TrustDirection": "Two-Way", "TrustState": "Verified", "CreatedDateTime": "2017-06-20T18:08:45.614000-07:00", "LastUpdatedDateTime": "2019-06-04T10:52:12.410000-07:00", "StateLastUpdatedDateTime": "2019-06-04T10:52:12.410000-07:00", "SelectiveAuth": "Disabled" } ] } ``` + Einzelheiten zur API finden Sie [DescribeTrusts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ds/describe-trusts.html)in der *AWS CLI Befehlsreferenz*. # Directory Service Datenbeispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Directory Service Data Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-group-member` Das folgende Codebeispiel zeigt, wie Sie`add-group-member`. **AWS CLI** **So fügen Sie einem Verzeichnis ein Gruppenmitglied hinzu** Im folgenden Beispiel für `add-group-member` wird der angegebene Benutzer der spezifizierten Gruppe im genannten Verzeichnis hinzugefügt. ``` aws ds-data add-group-member \ --directory-id d-1234567890 \ --group-name 'sales' \ --member-name 'john.doe' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen oder Entfernen von AWS verwalteten Microsoft AD-Mitgliedern zu Gruppen und Gruppen zu Gruppen](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_add_remove_user_group.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [AddGroupMember](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/add-group-member.html)unter *AWS CLI Befehlsreferenz*. ### `create-group` Das folgende Codebeispiel zeigt die Verwendung`create-group`. **AWS CLI** **So listen Sie die verfügbaren Widgets auf** Im folgenden Beispiel für `create-group` wird eine Gruppe in einem angegebenen Verzeichnis erstellt. ``` aws ds-data create-group \ --directory-id d-1234567890 \ --sam-account-name "sales" ``` Ausgabe: ``` { "DirectoryId": "d-1234567890", "SAMAccountName": "sales", "SID": "S-1-2-34-5567891234-5678912345-67891234567-8912" } ``` Weitere Informationen finden Sie unter [Erstellen einer AWS verwalteten Microsoft AD-Gruppe](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_create_group.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/create-group.html)unter *AWS CLI Befehlsreferenz*. ### `create-user` Das folgende Codebeispiel zeigt die Verwendung`create-user`. **AWS CLI** **Um einen Benutzer zu erstellen** Im folgenden Beispiel für `create-user` wird ein Benutzer in einem angegebenen Verzeichnis erstellt. ``` aws ds-data create-user \ --directory-id d-1234567890 \ --sam-account-name 'john.doe' ``` Ausgabe: ``` { "DirectoryId": "d-1234567890", "SAMAccountName": "john.doe", "SID": "S-1-2-34-5567891234-5678912345-67891234567-8912" } ``` Weitere Informationen finden Sie unter [Erstellen eines AWS verwalteten Microsoft AD-Benutzers](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_create_user.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [CreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/create-user.html)unter *AWS CLI Befehlsreferenz*. ### `delete-group` Das folgende Codebeispiel zeigt die Verwendung`delete-group`. **AWS CLI** **Um eine Gruppe zu löschen** Im folgenden Beispiel für `delete-group` wird die angegebene Gruppe aus dem spezifizierten Verzeichnis gelöscht. ``` aws ds-data delete-group \ --directory-id d-1234567890 \ --sam-account-name 'sales' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer AWS verwalteten Microsoft AD-Gruppe](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_delete_group.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/delete-group.html)unter *AWS CLI Befehlsreferenz*. ### `delete-user` Das folgende Codebeispiel zeigt die Verwendung`delete-user`. **AWS CLI** **So löschen Sie einen Benutzer** Im folgenden Beispiel für `delete-user` wird der angegebene Benutzer aus dem spezifizierten Verzeichnis gelöscht. ``` aws ds-data delete-user \ --directory-id d-1234567890 \ --sam-account-name 'john.doe' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines AWS verwalteten Microsoft AD-Benutzers](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_delete_user.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [DeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/delete-user.html)unter *AWS CLI Befehlsreferenz*. ### `describe-group` Das folgende Codebeispiel zeigt die Verwendung`describe-group`. **AWS CLI** **So listen Sie Details einer Gruppe auf** Im folgenden Beispiel für `describe-group` werden Informationen über die angegebene Gruppe im spezifizierten Verzeichnis abgerufen. ``` aws ds-data describe-group \ --directory-id d-1234567890 \ --sam-account-name 'sales' ``` Ausgabe: ``` { "DirectoryId": "d-1234567890", "DistinguishedName": "CN=sales,OU=Users,OU=CORP,DC=corp,DC=example,DC=com", "GroupScope": "Global", "GroupType": "Security", "Realm": "corp.example.com", "SAMAccountName": "sales", "SID": "S-1-2-34-5567891234-5678912345-67891234567-8912" } ``` Weitere Informationen finden Sie unter [Anzeigen und Aktualisieren der Details einer AWS verwalteten Microsoft AD-Gruppe](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_group.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [DescribeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/describe-group.html)unter *AWS CLI Befehlsreferenz*. ### `describe-user` Das folgende Codebeispiel zeigt die Verwendung`describe-user`. **AWS CLI** **So listen Sie Informationen für einen Benutzer auf** Im folgenden Beispiel für `describe-user` werden Informationen über den angegebenen Benutzer im spezifizierten Verzeichnis abgerufen. ``` aws ds-data describe-user command-name \ --directory-id d-1234567890 \ --sam-account-name 'john.doe' ``` Ausgabe: ``` { "DirectoryId": "d-1234567890", "DistinguishedName": "CN=john.doe,OU=Users,OU=CORP,DC=corp,DC=example,DC=com", "Enabled": false, "Realm": "corp.example.com", "SAMAccountName": "john.doe", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4567", "UserPrincipalName": "john.doe@CORP.EXAMPLE.COM" } ``` Weitere Informationen finden Sie unter [Einen AWS verwalteten Microsoft AD-Benutzer anzeigen und aktualisieren](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_user.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [DescribeUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/describe-user.html)unter *AWS CLI Befehlsreferenz*. ### `disable-directory-data-access` Das folgende Codebeispiel zeigt die Verwendung`disable-directory-data-access`. **AWS CLI** **So deaktivieren Sie die Directory Service Data API für ein Verzeichnis** Im folgenden Beispiel für `disable-directory-data-access` wird die Directory Service Data API für das angegebene Verzeichnis deaktiviert. ``` aws ds disable-directory-data-access \ --directory-id d-1234567890 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren oder Deaktivieren der Benutzer- und Gruppenverwaltung oder von AWS Verzeichnisdienstdaten](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_users_groups_mgmt_enable_disable.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie unter [DisableDirectoryDataAccess AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/disable-directory-data-access.html)*Befehlsreferenz.* ### `disable-user` Das folgende Codebeispiel zeigt die Verwendung`disable-user`. **AWS CLI** **Um einen Benutzer zu deaktivieren** Im folgenden Beispiel für `disable-user` wird der angegebene Benutzer im spezifizierten Verzeichnis deaktiviert. ``` aws ds-data disable-user \ --directory-id d-1234567890 \ --sam-account-name 'john.doe' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Deaktivieren eines AWS verwalteten Microsoft AD-Benutzers](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_disable_user.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie unter [DisableUser AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/disable-user.html)*Befehlsreferenz.* ### `enable-directory-data-access` Das folgende Codebeispiel zeigt die Verwendung`enable-directory-data-access`. **AWS CLI** **So aktivieren Sie Directory Service Data API für ein Verzeichnis** Im folgenden Beispiel für `enable-directory-data-access` wird die Directory Service Data API für das angegebene Verzeichnis aktiviert. ``` aws ds enable-directory-data-access \ --directory-id d-1234567890 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren oder Deaktivieren der Benutzer- und Gruppenverwaltung oder von AWS Verzeichnisdienstdaten](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_users_groups_mgmt_enable_disable.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie unter [EnableDirectoryDataAccess AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/enable-directory-data-access.html)*Befehlsreferenz.* ### `list-group-members` Das folgende Codebeispiel zeigt die Verwendung`list-group-members`. **AWS CLI** **So listen Sie die Gruppenmitglieder eines Verzeichnisses auf** Im folgenden Beispiel für `list-group-members` werden die Mitglieder der angegebenen Gruppe im spezifizierten Verzeichnis aufgelistet. ``` aws ds-data list-group-members \ --directory-id d-1234567890 \ --sam-account-name 'sales' ``` Ausgabe: ``` { "Members": [ { "MemberType": "USER", "SAMAccountName": "Jane Doe", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4568" }, { "MemberType": "USER", "SAMAccountName": "John Doe", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4569" } ], "DirectoryId": "d-1234567890", "MemberRealm": "corp.example.com", "Realm": "corp.example.com" } ``` Weitere Informationen finden Sie unter [Anzeigen und Aktualisieren der Details einer AWS verwalteten Microsoft AD-Gruppe](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_group.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [ListGroupMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/list-group-members.html)unter *AWS CLI Befehlsreferenz*. ### `list-groups-for-member` Das folgende Codebeispiel zeigt die Verwendung`list-groups-for-member`. **AWS CLI** **So listen Sie die Gruppenmitgliedschaft eines Verzeichnisses auf** Im folgenden Beispiel für `list-groups-for-member` wird die Gruppenmitgliedschaft für den angegebenen Benutzer im spezifizierten Verzeichnis aufgelistet. ``` aws ds-data list-groups-for-member \ --directory-id d-1234567890 \ --sam-account-name 'john.doe' ``` Ausgabe: ``` { "Groups": [ { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Domain Users", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4567" } ], "DirectoryId": "d-1234567890", "MemberRealm": "corp.example.com", "Realm": "corp.example.com" } ``` Weitere Informationen finden Sie unter [Einen AWS verwalteten Microsoft AD-Benutzer anzeigen und aktualisieren](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_user.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [ListGroupsForMember](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/list-groups-for-member.html)unter *AWS CLI Befehlsreferenz*. ### `list-groups` Das folgende Codebeispiel zeigt die Verwendung`list-groups`. **AWS CLI** **So listen Sie die Gruppen eines Verzeichnisses auf** Im folgenden Beispiel für `list-groups` werden die Gruppen im angegebenen Verzeichnis aufgelistet. ``` aws ds-data list-groups \ --directory-id d-1234567890 ``` Ausgabe: ``` { "Groups": [ { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Administrators", "SID": "S-1-2-33-441" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Users", "SID": "S-1-2-33-442" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Guests", "SID": "S-1-2-33-443" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Print Operators", "SID": "S-1-2-33-444" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Backup Operators", "SID": "S-1-2-33-445" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Replicator", "SID": "S-1-2-33-446" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Remote Desktop Users", "SID": "S-1-2-33-447" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Network Configuration Operators", "SID": "S-1-2-33-448" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Performance Monitor Users", "SID": "S-1-2-33-449" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Performance Log Users", "SID": "S-1-2-33-450" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Distributed COM Users", "SID": "S-1-2-33-451" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "IIS_IUSRS", "SID": "S-1-2-33-452" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Cryptographic Operators", "SID": "S-1-2-33-453" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Event Log Readers", "SID": "S-1-2-33-454" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Certificate Service DCOM Access", "SID": "S-1-2-33-456" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "RDS Remote Access Servers", "SID": "S-1-2-33-457" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "RDS Endpoint Servers", "SID": "S-1-2-33-458" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "RDS Management Servers", "SID": "S-1-2-33-459" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Hyper-V Administrators", "SID": "S-1-2-33-460" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Access Control Assistance Operators", "SID": "S-1-2-33-461" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Remote Management Users", "SID": "S-1-2-33-462" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Storage Replica Administrators", "SID": "S-1-2-33-463" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Domain Computers", "SID": "S-1-2-34-56789123456-7891012345-6789123486-789" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Domain Controllers", "SID": "S-1-2-34-56789123456-7891012345-6789123486-790" }, { "GroupScope": "Universal", "GroupType": "Security", "SAMAccountName": "Schema Admins", "SID": "S-1-2-34-56789123456-7891012345-6789123486-791" }, { "GroupScope": "Universal", "GroupType": "Security", "SAMAccountName": "Enterprise Admins", "SID": "S-1-2-34-56789123456-7891012345-6789123486-792" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "Cert Publishers", "SID": "S-1-2-34-56789123456-7891012345-6789123486-793" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Domain Admins", "SID": "S-1-2-34-56789123456-7891012345-6789123486-794" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Domain Users", "SID": "S-1-2-34-56789123456-7891012345-6789123486-795" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Domain Guests", "SID": "S-1-2-34-56789123456-7891012345-6789123486-796" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Group Policy Creator Owners", "SID": "S-1-2-34-56789123456-7891012345-6789123486-797" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "RAS and IAS Servers", "SID": "S-1-2-34-56789123456-7891012345-6789123486-798" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Server Operators", "SID": "S-1-2-33-464" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Account Operators", "SID": "S-1-2-33-465" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Pre-Windows 2000 Compatible Access", "SID": "S-1-2-33-466" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Incoming Forest Trust Builders", "SID": "S-1-2-33-467" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Windows Authorization Access Group", "SID": "S-1-2-33-468" }, { "GroupScope": "BuiltinLocal", "GroupType": "Security", "SAMAccountName": "Terminal Server License Servers", "SID": "S-1-2-33-469" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "Allowed RODC Password Replication Group", "SID": "S-1-2-34-56789123456-7891012345-6789123486-798" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "Denied RODC Password Replication Group", "SID": "S-1-2-34-56789123456-7891012345-6789123486-799" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Read-only Domain Controllers", "SID": "S-1-2-34-56789123456-7891012345-6789123486-800" }, { "GroupScope": "Universal", "GroupType": "Security", "SAMAccountName": "Enterprise Read-only Domain Controllers", "SID": "S-1-2-34-56789123456-7891012345-6789123486-801" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Cloneable Domain Controllers", "SID": "S-1-2-34-56789123456-7891012345-6789123486-802" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Protected Users", "SID": "S-1-2-34-56789123456-7891012345-6789123486-803" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Key Admins", "SID": "S-1-2-34-56789123456-7891012345-6789123486-804" }, { "GroupScope": "Universal", "GroupType": "Security", "SAMAccountName": "Enterprise Key Admins", "SID": "S-1-2-34-56789123456-7891012345-6789123486-805" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "DnsAdmins", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4567" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "DnsUpdateProxy", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4568" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "Admins", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4569" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWSAdministrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4570" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Object Management Service Accounts", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4571" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Private CA Connector for AD Delegated Group", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4572" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Application and Service Delegated Group", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4573" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4574" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated FSx Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4575" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Account Operators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4576" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Active Directory Based Activation Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4577" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Allowed to Authenticate Objects", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4578" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Allowed to Authenticate to Domain Controllers", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4579" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Deleted Object Lifetime Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4580" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Distributed File System Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4581" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Dynamic Host Configuration Protocol Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4582" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Enterprise Certificate Authority Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4583" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Fine Grained Password Policy Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4584" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Group Policy Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4585" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Managed Service Account Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4586" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Read Foreign Security Principals", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4587" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Remote Access Service Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4588" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Replicate Directory Changes Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4588" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Sites and Services Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4589" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated System Management Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4590" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Terminal Server Licensing Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4591" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated User Principal Name Suffix Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4592" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Add Workstations To Domain Users", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4593" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Domain Name System Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4594" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Kerberos Delegation Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4595" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated Server Administrators", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4596" }, { "GroupScope": "DomainLocal", "GroupType": "Security", "SAMAccountName": "AWS Delegated MS-NPRC Non-Compliant Devices", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4597" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Remote Access", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4598" }, { "GroupScope": "Global", "GroupType": "Security", "SAMAccountName": "Accounting", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4599" }, { "GroupScope": "Global", "GroupType": "Distribution", "SAMAccountName": "sales", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4567" } ], "DirectoryId": "d-1234567890", "Realm": "corp.example.com" } ``` Weitere Informationen finden Sie unter [Anzeigen und Aktualisieren der Details einer AWS verwalteten Microsoft AD-Gruppe](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_group.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/list-groups.html)unter *AWS CLI Befehlsreferenz*. ### `list-users` Das folgende Codebeispiel zeigt die Verwendung`list-users`. **AWS CLI** **So listen Sie die Benutzer eines Verzeichnisses auf** Im folgenden Beispiel für `list-users` werden die Benutzer im angegebenen Verzeichnis aufgelistet. ``` aws ds-data list-users \ --directory-id d-1234567890 ``` Ausgabe: ``` { "Users": [ { "Enabled": true, "SAMAccountName": "Administrator", "SID": "S-1-2-34-5678910123-4567895012-3456789012-345" }, { "Enabled": false, "SAMAccountName": "Guest", "SID": "S-1-2-34-5678910123-4567895012-3456789012-345" }, { "Enabled": false, "SAMAccountName": "krbtgt", "SID": "S-1-2-34-5678910123-4567895012-3456789012-346" }, { "Enabled": true, "SAMAccountName": "Admin", "SID": "S-1-2-34-5678910123-4567895012-3456789012-347" }, { "Enabled": true, "SAMAccountName": "Richard Roe", "SID": "S-1-2-34-5678910123-4567895012-3456789012-348" }, { "Enabled": true, "SAMAccountName": "Jane Doe", "SID": "S-1-2-34-5678910123-4567895012-3456789012-349" }, { "Enabled": true, "SAMAccountName": "AWS_WGnzYlN6YyY", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4567" }, { "Enabled": true, "SAMAccountName": "john.doe", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4568" } ], "DirectoryId": "d-1234567890", "Realm": "corp.example.com" } ``` Weitere Informationen finden Sie unter [Einen AWS verwalteten Microsoft AD-Benutzer anzeigen und aktualisieren](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_user.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [ListUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/list-users.html)unter *AWS CLI Befehlsreferenz*. ### `remove-group-member` Das folgende Codebeispiel zeigt die Verwendung`remove-group-member`. **AWS CLI** **So entfernen Sie ein Gruppenmitglied aus einem Verzeichnis** Im folgenden Beispiel für `remove-group-member` werden das angegebene Gruppenmitglied aus der genannten Gruppe im spezifizierten Verzeichnis entfernt. ``` aws ds-data remove-group-member \ --directory-id d-1234567890 \ --group-name 'sales' \ --member-name 'john.doe' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen und Entfernen von AWS verwalteten Microsoft AD-Mitgliedern zu Gruppen und Gruppen zu Gruppen](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_add_remove_user_group.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [RemoveGroupMember](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/remove-group-member.html)unter *AWS CLI Befehlsreferenz*. ### `reset-user-password` Das folgende Codebeispiel zeigt die Verwendung`reset-user-password`. **AWS CLI** **So setzen Sie ein Benutzerpasswort in einem Verzeichnis zurück** Im folgenden Beispiel für `reset-user-password` wird der angegebene Benutzer im spezifizierten Verzeichnis zurückgesetzt und aktiviert. ``` aws ds reset-user-password \ --directory-id d-1234567890 \ --user-name 'john.doe' \ --new-password 'password' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Zurücksetzen und Aktivieren des Kennworts eines AWS verwalteten Microsoft AD-Benutzers](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_reset_user_pswd.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [ResetUserPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/reset-user-password.html)in der *AWS CLI Befehlsreferenz*. ### `search-groups` Das folgende Codebeispiel zeigt die Verwendung`search-groups`. **AWS CLI** **So suchen Sie eine Gruppe in einem Verzeichnis** Im folgenden Beispiel für `search-groups` wird die angegebene Gruppe im spezifizierten Verzeichnis gesucht. ``` aws ds-data search-groups \ --directory-id d-1234567890 \ --search-attributes 'SamAccountName' \ --search-string 'sales' ``` Ausgabe: ``` { "Groups": [ { "GroupScope": "Global", "GroupType": "Distribution", "SAMAccountName": "sales", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4567" } ], "DirectoryId": "d-1234567890", "Realm": "corp.example.com" } ``` Weitere Informationen finden Sie unter [Anzeigen und Aktualisieren der Details einer AWS verwalteten Microsoft AD-Gruppe](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_group.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [SearchGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/search-groups.html)unter *AWS CLI Befehlsreferenz*. ### `search-users` Das folgende Codebeispiel zeigt die Verwendung`search-users`. **AWS CLI** **So suchen Sie einen Benutzer in einem Verzeichnis** Im folgenden Beispiel für `search-users` wird der angegebene Benutzer im spezifizierten Verzeichnis gesucht. ``` aws ds-data search-users \ --directory-id d-1234567890 \ --search-attributes 'SamAccountName' \ --Search-string 'john.doe' ``` Ausgabe: ``` { "Users": [ { "Enabled": true, "SAMAccountName": "john.doe", "SID": "S-1-2-34-5678901234-5678901234-5678910123-4567" } ], "DirectoryId": "d-1234567890", "Realm": "corp.example.com" } ``` Weitere Informationen finden Sie unter [Einen AWS verwalteten Microsoft AD-Benutzer anzeigen und aktualisieren](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_user.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [SearchUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/search-users.html)unter *AWS CLI Befehlsreferenz*. ### `update-group` Das folgende Codebeispiel zeigt die Verwendung`update-group`. **AWS CLI** **So aktualisieren Sie das Attribut einer Gruppe in einem Verzeichnis** Im folgenden Beispiel für `update-group` wird das angegebene Attribut für die spezifizierte Gruppe im genannten Verzeichnis aktualisiert. ``` aws ds-data update-group \ --directory-id d-1234567890 \ --sam-account-name 'sales' \ --update-type 'REPLACE' \ --group-type 'Distribution' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Anzeigen und Aktualisieren der Details einer AWS verwalteten Microsoft AD-Gruppe](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_group.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [UpdateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/update-group.html)unter *AWS CLI Befehlsreferenz*. ### `update-user` Das folgende Codebeispiel zeigt die Verwendung`update-user`. **AWS CLI** **So aktualisieren Sie das Attribut eines Benutzers in einem Verzeichnis** Im folgenden Beispiel für `update-user` wird das angegebene Attribut für den spezifizierten Benutzer im genannten Verzeichnis aktualisiert. ``` aws ds-data update-user \ --directory-id d-1234567890 \ --sam-account-name 'john.doe' \ --update-type 'ADD' \ --email-address 'example.corp.com' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Einen AWS verwalteten Microsoft AD-Benutzer anzeigen und aktualisieren](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_view_update_user.html) im *AWS Directory Service Administration Guide*. + Einzelheiten zur API finden Sie [UpdateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directory-service-data/update-user.html)unter *AWS CLI Befehlsreferenz*. # AWS DMS Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS DMS. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-tags-to-resource` Das folgende Codebeispiel zeigt, wie Sie`add-tags-to-resource`. **AWS CLI** **So fügen Sie einer Ressource Tags hinzu** Im folgenden Beispiel für `add-tags-to-resource` werden einer Replikations-Instance Tags hinzugefügt. ``` aws dms add-tags-to-resource \ --resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \ --tags Key=Environment,Value=PROD Key=Project,Value=dbMigration ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von Ressourcen](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tagging.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [AddTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/add-tags-to-resource.html)in der *AWS CLI Befehlsreferenz*. ### `create-endpoint` Das folgende Codebeispiel zeigt die Verwendung`create-endpoint`. **AWS CLI** **Um einen Endpunkt zu erstellen** Im folgenden Beispiel für `create-endpoint` wird Endpunkt für eine Amazon-S3-Quelle erstellt. ``` aws dms create-endpoint \ --endpoint-type source \ --engine-name s3 \ --endpoint-identifier src-endpoint \ --s3-settings file://s3-settings.json ``` Inhalt von `s3-settings.json`: ``` { "BucketName":"my-corp-data", "BucketFolder":"sourcedata", "ServiceAccessRoleArn":"arn:aws:iam::123456789012:role/my-s3-access-role" } ``` Ausgabe: ``` { "Endpoint": { "EndpointIdentifier": "src-endpoint", "EndpointType": "SOURCE", "EngineName": "s3", "EngineDisplayName": "Amazon S3", "ExtraConnectionAttributes": "bucketFolder=sourcedata;bucketName=my-corp-data;compressionType=NONE;csvDelimiter=,;csvRowDelimiter=\\n;", "Status": "active", "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U", "SslMode": "none", "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role", "S3Settings": { "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role", "CsvRowDelimiter": "\\n", "CsvDelimiter": ",", "BucketFolder": "sourcedata", "BucketName": "my-corp-data", "CompressionType": "NONE", "EnableStatistics": true } } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS DMS-Endpunkten](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateEndpoint AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-endpoint.html)*Befehlsreferenz*. ### `create-event-subscription` Das folgende Codebeispiel zeigt die Verwendung`create-event-subscription`. **AWS CLI** **So listen Sie Ereignisabonnements auf** Im folgenden `create-event-subscription` Beispiel wird ein Event-Abonnement für ein Amazon SNS SNS-Thema (my-sns-topic) erstellt. ``` aws dms create-event-subscription \ --subscription-name my-dms-events \ --sns-topic-arn arn:aws:sns:us-east-1:123456789012:my-sns-topic ``` Ausgabe: ``` { "EventSubscription": { "CustomerAwsId": "123456789012", "CustSubscriptionId": "my-dms-events", "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic", "Status": "creating", "SubscriptionCreationTime": "2020-05-21 21:58:38.598", "Enabled": true } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Ereignissen und Benachrichtigungen](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-event-subscription.html)in der *AWS CLI Befehlsreferenz.* ### `create-replication-instance` Das folgende Codebeispiel zeigt die Verwendung`create-replication-instance`. **AWS CLI** **So erstellen Sie eine Replikations-Instance** Im folgenden Beispiel für `create-replication-instance` wird eine Replikations-Instance erstellt. ``` aws dms create-replication-instance \ --replication-instance-identifier my-repl-instance \ --replication-instance-class dms.t2.micro \ --allocated-storage 5 ``` Ausgabe: ``` { "ReplicationInstance": { "ReplicationInstanceIdentifier": "my-repl-instance", "ReplicationInstanceClass": "dms.t2.micro", "ReplicationInstanceStatus": "creating", "AllocatedStorage": 5, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-f839b688", "Status": "active" } ], "ReplicationSubnetGroup": { "ReplicationSubnetGroupIdentifier": "default", "ReplicationSubnetGroupDescription": "default", "VpcId": "vpc-136a4c6a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-da327bf6", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-42599426", "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-bac383e0", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-6746046b", "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-d7c825e8", "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-cbfff283", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sat:12:35-sat:13:05", "PendingModifiedValues": {}, "MultiAZ": false, "EngineVersion": "3.3.2", "AutoMinorVersionUpgrade": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:ZK2VQBUWFDBAWHIXHAYG5G2PKY", "PubliclyAccessible": true } } ``` Weitere Informationen finden Sie unter [Arbeiten mit einer AWS DMS-Replikationsinstanz](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateReplicationInstance AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-replication-instance.html)*Befehlsreferenz.* ### `create-replication-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`create-replication-subnet-group`. **AWS CLI** **Um eine Subnetzgruppe zu erstellen** Im folgenden Beispiel für `create-replication-subnet-group` wird eine Gruppe bestehend aus 3 Subnetzen erstellt. ``` aws dms create-replication-subnet-group \ --replication-subnet-group-identifier my-subnet-group \ --replication-subnet-group-description "my subnet group" \ --subnet-ids subnet-da327bf6 subnet-bac383e0 subnet-d7c825e8 ``` Ausgabe: ``` { "ReplicationSubnetGroup": { "ReplicationSubnetGroupIdentifier": "my-subnet-group", "ReplicationSubnetGroupDescription": "my subnet group", "VpcId": "vpc-136a4c6a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-da327bf6", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-bac383e0", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-d7c825e8", "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active" } ] } } ``` Weitere Informationen finden Sie unter [Einrichten eines Netzwerks für eine Replikations-Instance](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.VPC.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [CreateReplicationSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-replication-subnet-group.html)in der *AWS CLI Befehlsreferenz.* ### `create-replication-task` Das folgende Codebeispiel zeigt die Verwendung`create-replication-task`. **AWS CLI** **So erstellen Sie eine Replikationsaufgabe** Im folgenden Beispiel für `create-replication-task` wird eine Replikationsaufgabe erstellt. ``` aws dms create-replication-task \ --replication-task-identifier movedata \ --source-endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA \ --target-endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U \ --replication-instance-arn $RI_ARN \ --migration-type full-load \ --table-mappings file://table-mappings.json ``` Inhalt von `table-mappings.json`: ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "prodrep", "table-name": "%" }, "rule-action": "include", "filters": [] } ] } ``` Ausgabe: ``` { "ReplicationTask": { "ReplicationTaskIdentifier": "moveit2", "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "MigrationType": "full-load", "TableMappings": ...output omitted... , "ReplicationTaskSettings": ...output omitted... , "Status": "creating", "ReplicationTaskCreationDate": 1590524772.505, "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS DMS-Aufgaben](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateReplicationTask AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-replication-task.html)*Befehlsreferenz.* ### `delete-connection` Das folgende Codebeispiel zeigt die Verwendung`delete-connection`. **AWS CLI** **So löschen Sie eine Verbindung** Im folgenden Beispiel für `delete-connection` wird die Zuordnung eines Endpunkts zu einer Replikations-Instance aufgehoben. ``` aws dms delete-connection \ --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA \ --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE ``` Ausgabe: ``` { "Connection": { "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "Status": "deleting", "EndpointIdentifier": "src-database-1", "ReplicationInstanceIdentifier": "my-repl-instance" } } ``` *Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/dms/latest/userguide/CHAP\$1Endpoints.Creating.html](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.Creating.html) im Database Migration Service Service-Benutzerhandbuch.AWS * + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-connection.html)AWS CLI * ### `delete-endpoint` Das folgende Codebeispiel zeigt die Verwendung`delete-endpoint`. **AWS CLI** **So löschen Sie einen Endpunkt** Im folgenden Beispiel für `delete-endpoint` wird ein Endpunkt gelöscht. ``` aws dms delete-endpoint \ --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:OUJJVXO4XZ4CYTSEG5XGMN2R3Y ``` Ausgabe: ``` { "Endpoint": { "EndpointIdentifier": "src-endpoint", "EndpointType": "SOURCE", "EngineName": "s3", "EngineDisplayName": "Amazon S3", "ExtraConnectionAttributes": "bucketFolder=sourcedata;bucketName=my-corp-data;compressionType=NONE;csvDelimiter=,;csvRowDelimiter=\\n;", "Status": "deleting", "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:OUJJVXO4XZ4CYTSEG5XGMN2R3Y", "SslMode": "none", "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role", "S3Settings": { "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role", "CsvRowDelimiter": "\\n", "CsvDelimiter": ",", "BucketFolder": "sourcedata", "BucketName": "my-corp-data", "CompressionType": "NONE", "EnableStatistics": true } } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS DMS-Endpunkten](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteEndpoint AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-endpoint.html)*Befehlsreferenz*. ### `delete-event-subscription` Das folgende Codebeispiel zeigt die Verwendung`delete-event-subscription`. **AWS CLI** **So löschen Sie ein Ereignisabonnement** Im folgenden Beispiel für `delete-event-subscription` wird ein Abonnement für ein Amazon-SNS-Thema gelöscht. ``` aws dms delete-event-subscription \ --subscription-name "my-dms-events" ``` Ausgabe: ``` { "EventSubscription": { "CustomerAwsId": "123456789012", "CustSubscriptionId": "my-dms-events", "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic", "Status": "deleting", "SubscriptionCreationTime": "2020-05-21 21:58:38.598", "Enabled": true } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Ereignissen und Benachrichtigungen](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-event-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `delete-replication-instance` Das folgende Codebeispiel zeigt die Verwendung`delete-replication-instance`. **AWS CLI** **So löschen Sie eine Replikations-Instance** Im folgenden Beispiel für `delete-replication-instance` wird eine Replikations-Instance gelöscht. ``` aws dms delete-replication-instance \ --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE ``` Ausgabe: ``` { "ReplicationInstance": { "ReplicationInstanceIdentifier": "my-repl-instance", "ReplicationInstanceClass": "dms.t2.micro", "ReplicationInstanceStatus": "deleting", "AllocatedStorage": 5, "InstanceCreateTime": 1590011235.952, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-f839b688", "Status": "active" } ], "AvailabilityZone": "us-east-1e", "ReplicationSubnetGroup": { "ReplicationSubnetGroupIdentifier": "default", "ReplicationSubnetGroupDescription": "default", "VpcId": "vpc-136a4c6a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-da327bf6", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-42599426", "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-bac383e0", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-6746046b", "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-d7c825e8", "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-cbfff283", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "wed:11:42-wed:12:12", "PendingModifiedValues": {}, "MultiAZ": true, "EngineVersion": "3.3.2", "AutoMinorVersionUpgrade": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "ReplicationInstancePublicIpAddress": "54.225.120.92", "ReplicationInstancePrivateIpAddress": "172.31.30.121", "ReplicationInstancePublicIpAddresses": [ "54.225.120.92", "3.230.18.248" ], "ReplicationInstancePrivateIpAddresses": [ "172.31.30.121", "172.31.75.90" ], "PubliclyAccessible": true, "SecondaryAvailabilityZone": "us-east-1b" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit einer AWS DMS-Replikationsinstanz](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteReplicationInstance AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-replication-instance.html)*Befehlsreferenz.* ### `delete-replication-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`delete-replication-subnet-group`. **AWS CLI** **Um eine Subnetzgruppe zu löschen** Im folgenden Beispiel für `delete-replication-subnet-group` wird eine Subnetzgruppe gelöscht. ``` aws dms delete-replication-subnet-group \ --replication-subnet-group-identifier my-subnet-group ``` Ausgabe: ``` (none) ``` Weitere Informationen finden Sie unter [Einrichten eines Netzwerks für eine Replikations-Instance](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.VPC.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DeleteReplicationSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-replication-subnet-group.html)in der *AWS CLI Befehlsreferenz.* ### `delete-replication-task` Das folgende Codebeispiel zeigt die Verwendung`delete-replication-task`. **AWS CLI** **So löschen Sie eine Replikationsaufgabe** Im folgenden Beispiel für `delete-replication-task` wird eine Replikationsaufgabe gelöscht. ``` aws dms delete-replication-task \ --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII ``` Ausgabe: ``` { "ReplicationTask": { "ReplicationTaskIdentifier": "moveit2", "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "MigrationType": "full-load", "TableMappings": ...output omitted..., "ReplicationTaskSettings": ...output omitted..., "Status": "deleting", "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED", "ReplicationTaskCreationDate": 1590524772.505, "ReplicationTaskStartDate": 1590789988.677, "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS DMS-Aufgaben](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteReplicationTask AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-replication-task.html)*Befehlsreferenz.* ### `describe-account-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-account-attributes`. **AWS CLI** **So beschreiben Sie Kontoattribute** Das folgende `describe-account-attributes` Beispiel listet die Attribute für Ihr AWS Konto auf. ``` aws dms describe-account-attributes ``` Ausgabe: ``` { "AccountQuotas": [ { "AccountQuotaName": "ReplicationInstances", "Used": 1, "Max": 20 }, { "AccountQuotaName": "AllocatedStorage", "Used": 5, "Max": 10000 }, ...remaining output omitted... ], "UniqueAccountIdentifier": "cqahfbfy5xee" } ``` + Einzelheiten zur API finden Sie [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-account-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-certificates` Das folgende Codebeispiel zeigt die Verwendung`describe-certificates`. **AWS CLI** **So listen Sie die verfügbaren Zertifikate auf** Das folgende `describe-certificates` Beispiel listet die verfügbaren Zertifikate in Ihrem AWS Konto auf. ``` aws dms describe-certificates ``` Ausgabe: ``` { "Certificates": [ { "CertificateIdentifier": "my-cert", "CertificateCreationDate": 1543259542.506, "CertificatePem": "-----BEGIN CERTIFICATE-----\nMIID9DCCAtygAwIBAgIBQjANBgkqhkiG9w0BAQ ...U" ... remaining output omittted ... } ] } ``` Weitere Informationen finden Sie unter [Verwenden von SSL](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Security.html#CHAP_Security.SSL) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DescribeCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `describe-connections` Das folgende Codebeispiel zeigt die Verwendung`describe-connections`. **AWS CLI** **So beschreiben Sie Verbindungen** Im folgenden Beispiel für `describe-connections` werden die Verbindungen aufgelistet, die Sie zwischen einer Replikations-Instance und einem Endpunkt getestet haben. ``` aws dms describe-connections ``` Ausgabe: ``` { "Connections": [ { "Status": "successful", "ReplicationInstanceIdentifier": "test", "EndpointArn": "arn:aws:dms:us-east-arn:aws:dms:us-east-1:123456789012:endpoint:ZW5UAN6P4E77EC7YWHK4RZZ3BE", "EndpointIdentifier": "testsrc1", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ" } ] } ``` Weitere Informationen finden Sie unter [Erstellen der Quell- und Zielendpunkte](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.Creating.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DescribeConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-connections.html)in der *AWS CLI Befehlsreferenz*. ### `describe-endpoint-types` Das folgende Codebeispiel zeigt die Verwendung`describe-endpoint-types`. **AWS CLI** **So listen die verfügbaren Endpunkttypen auf** Im folgenden Beispiel für `describe-endpoint-types` werden die verfügbaren MySQL-Endpunkttypen aufgelistet. ``` aws dms describe-endpoint-types \ --filters "Name=engine-name,Values=mysql" ``` Ausgabe: ``` { "SupportedEndpointTypes": [ { "EngineName": "mysql", "SupportsCDC": true, "EndpointType": "source", "EngineDisplayName": "MySQL" }, { "EngineName": "mysql", "SupportsCDC": true, "EndpointType": "target", "EngineDisplayName": "MySQL" } ] } ``` *Weitere Informationen finden Sie unter Working with AWS DMS Endpoints < https://docs.aws.amazon.com/dms/ latest/userguide/CHAP \$1endpoints.html>`\$1\$1 im Database Migration Service User Guide.AWS * + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DescribeEndpointTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-endpoint-types.html)AWS CLI * ### `describe-endpoints` Das folgende Codebeispiel zeigt die Verwendung`describe-endpoints`. **AWS CLI** **So beschreiben Sie Endpunkte** Das folgende `describe-endpoints` Beispiel listet die Endpunkte in Ihrem AWS Konto auf. ``` aws dms describe-endpoints ``` Ausgabe: ``` { "Endpoints": [ { "Username": "dms", "Status": "active", "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:SF2WOFLWYWKVEOHID2EKLP3SJI", "ServerName": "ec2-52-32-48-61.us-west-2.compute.amazonaws.com", "EndpointType": "SOURCE", "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/94d5c4e7-4e4c-44be-b58a-c8da7adf57cd", "DatabaseName": "test", "EngineName": "mysql", "EndpointIdentifier": "pri100", "Port": 8193 }, { "Username": "admin", "Status": "active", "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:TJJZCIH3CJ24TJRU4VC32WEWFR", "ServerName": "test.example.com", "EndpointType": "SOURCE", "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/2431021b-1cf2-a2d4-77b2-59a9e4bce323", "DatabaseName": "EMPL", "EngineName": "oracle", "EndpointIdentifier": "test", "Port": 1521 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS DMS-Endpunkten](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeEndpoints AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-endpoints.html)*Befehlsreferenz*. ### `describe-event-categories` Das folgende Codebeispiel zeigt die Verwendung`describe-event-categories`. **AWS CLI** **So beschreiben Sie Ereigniskategorien** Im folgenden Beispiel für `describe-event-categories` werden die verfügbaren Ereigniskategorien aufgelistet. ``` aws dms describe-event-categories ``` Ausgabe: ``` { "EventCategoryGroupList": [ { "SourceType": "replication-instance", "EventCategories": [ "low storage", "configuration change", "maintenance", "deletion", "creation", "failover", "failure" ] }, { "SourceType": "replication-task", "EventCategories": [ "configuration change", "state change", "deletion", "creation", "failure" ] } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Ereignissen und Benachrichtigungen](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DescribeEventCategories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-event-categories.html)in der *AWS CLI Befehlsreferenz*. ### `describe-event-subscriptions` Das folgende Codebeispiel zeigt die Verwendung`describe-event-subscriptions`. **AWS CLI** **So beschreiben Sie Ereignisabonnements** Im folgenden Beispiel für `describe-event-subscriptions` werden die Ereignisabonnements für ein Amazon-SNS-Thema aufgelistet. ``` aws dms describe-event-subscriptions ``` Ausgabe: ``` { "EventSubscriptionsList": [ { "CustomerAwsId": "123456789012", "CustSubscriptionId": "my-dms-events", "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic", "Status": "deleting", "SubscriptionCreationTime": "2020-05-21 22:28:51.924", "Enabled": true } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Ereignissen und Benachrichtigungen](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DescribeEventSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-event-subscriptions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-events` Das folgende Codebeispiel zeigt die Verwendung`describe-events`. **AWS CLI** **So listen Sie DMS-Ereignisse auf** Im folgenden Beispiel für `describe-events` werden die Ereignisse aufgeführt, die von einer Replikations-Instance stammen. ``` aws dms describe-events \ --source-type "replication-instance" ``` Ausgabe: ``` { "Events": [ { "SourceIdentifier": "my-repl-instance", "SourceType": "replication-instance", "Message": "Replication application shutdown", "EventCategories": [], "Date": 1590771645.776 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Ereignissen und Benachrichtigungen](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-events.html)in der *AWS CLI Befehlsreferenz*. ### `describe-orderable-replication-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-orderable-replication-instances`. **AWS CLI** **So beschreiben Sie bestellbare Replikations-Instances** Im folgenden Beispiel für `describe-orderable-replication-instances` werden die Replikations-Instance-Typen aufgelistet, die Sie bestellen können. ``` aws dms describe-orderable-replication-instances ``` Ausgabe: ``` { "OrderableReplicationInstances": [ { "EngineVersion": "3.3.2", "ReplicationInstanceClass": "dms.c4.2xlarge", "StorageType": "gp2", "MinAllocatedStorage": 5, "MaxAllocatedStorage": 6144, "DefaultAllocatedStorage": 100, "IncludedAllocatedStorage": 100, "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c", "us-east-1d", "us-east-1e", "us-east-1f" ] }, { "EngineVersion": "3.3.2", "ReplicationInstanceClass": "dms.c4.4xlarge", "StorageType": "gp2", "MinAllocatedStorage": 5, "MaxAllocatedStorage": 6144, "DefaultAllocatedStorage": 100, "IncludedAllocatedStorage": 100, "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c", "us-east-1d", "us-east-1e", "us-east-1f" ] }, ...remaining output omitted... } ``` Weitere Informationen finden Sie unter [Arbeiten mit einer AWS DMS-Replikationsinstanz](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeOrderableReplicationInstances AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-orderable-replication-instances.html)*Befehlsreferenz.* ### `describe-refresh-schemas-status` Das folgende Codebeispiel zeigt die Verwendung`describe-refresh-schemas-status`. **AWS CLI** **So listen Sie den Aktualisierungsstatus für einen Endpunkt auf** Im folgenden Beispiel für `describe-refresh-schemas-status` wird der Status einer vorherigen Aktualisierungsanforderung zurückgegeben. ``` aws dms describe-refresh-schemas-status \ --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA ``` Ausgabe: ``` { "RefreshSchemasStatus": { "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "Status": "successful", "LastRefreshDate": 1590786544.605 } } ``` + Einzelheiten zur API finden Sie [DescribeRefreshSchemasStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-refresh-schemas-status.html)in der *AWS CLI Befehlsreferenz*. ### `describe-replication-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-replication-instances`. **AWS CLI** **So beschreiben Sie Replikations-Instances** Das folgende `describe-replication-instances` Beispiel listet die Replikationsinstanzen in Ihrem AWS Konto auf. ``` aws dms describe-replication-instances ``` Ausgabe: ``` { "ReplicationInstances": [ { "ReplicationInstanceIdentifier": "my-repl-instance", "ReplicationInstanceClass": "dms.t2.micro", "ReplicationInstanceStatus": "available", "AllocatedStorage": 5, "InstanceCreateTime": 1590011235.952, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-f839b688", "Status": "active" } ], "AvailabilityZone": "us-east-1e", "ReplicationSubnetGroup": { "ReplicationSubnetGroupIdentifier": "default", "ReplicationSubnetGroupDescription": "default", "VpcId": "vpc-136a4c6a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-da327bf6", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-42599426", "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-bac383e0", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-6746046b", "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-d7c825e8", "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-cbfff283", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "wed:11:42-wed:12:12", "PendingModifiedValues": { "MultiAZ": true }, "MultiAZ": false, "EngineVersion": "3.3.2", "AutoMinorVersionUpgrade": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "ReplicationInstancePublicIpAddress": "3.230.18.248", "ReplicationInstancePrivateIpAddress": "172.31.75.90", "ReplicationInstancePublicIpAddresses": [ "3.230.18.248" ], "ReplicationInstancePrivateIpAddresses": [ "172.31.75.90" ], "PubliclyAccessible": true, "FreeUntil": 1590194829.267 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit einer AWS DMS-Replikationsinstanz](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeReplicationInstances AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-replication-instances.html)*Befehlsreferenz.* ### `describe-replication-subnet-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-replication-subnet-groups`. **AWS CLI** **So zeigen Sie die verfügbaren Subnetzgruppen an** Im folgenden Beispiel für `describe-replication-subnet-groups` werden die verfügbaren Subnetzgruppen aufgelistet. ``` aws dms describe-replication-subnet-groups \ --filter "Name=replication-subnet-group-id,Values=my-subnet-group" ``` Ausgabe: ``` { "ReplicationSubnetGroups": [ { "ReplicationSubnetGroupIdentifier": "my-subnet-group", "ReplicationSubnetGroupDescription": "my subnet group", "VpcId": "vpc-136a4c6a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-da327bf6", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-bac383e0", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-d7c825e8", "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active" } ] } ] } ``` Weitere Informationen finden Sie unter [Einrichten eines Netzwerks für eine Replikations-Instance](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.VPC.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DescribeReplicationSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-replication-subnet-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-replication-task-assessment-results` Das folgende Codebeispiel zeigt die Verwendung`describe-replication-task-assessment-results`. **AWS CLI** **So listen Sie die Ergebnisse der Bewertungen von Replikationsaufgaben auf** Im folgenden Beispiel für `describe-replication-task-assessment-results` werden die Ergebnisse einer vorherigen Aufgabenbewertung aufgeführt. ``` aws dms describe-replication-task-assessment-results ``` Ausgabe: ``` { "ReplicationTaskAssessmentResults": [ { "ReplicationTaskIdentifier": "moveit2", "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII", "ReplicationTaskLastAssessmentDate": 1590790230.0, "AssessmentStatus": "No issues found", "AssessmentResultsFile": "moveit2/2020-05-29-22-10" } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Aufgabenbewertungsberichts](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.AssessmentReport.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DescribeReplicationTaskAssessmentResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-replication-task-assessment-results.html)in der *AWS CLI Befehlsreferenz*. ### `describe-replication-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-replication-tasks`. **AWS CLI** **So beschreiben Sie eine Replikationsaufgabe** Im folgenden Beispiel für `describe-replication-tasks` werden aktuelle Replikationsaufgaben beschrieben. ``` aws dms describe-replication-tasks ``` Ausgabe: ``` { "ReplicationTasks": [ { "ReplicationTaskIdentifier": "moveit2", "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "MigrationType": "full-load", "TableMappings": ...output omitted... , "ReplicationTaskSettings": ...output omitted... , "Status": "stopped", "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED", "ReplicationTaskCreationDate": 1590524772.505, "ReplicationTaskStartDate": 1590619805.212, "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII", "ReplicationTaskStats": { "FullLoadProgressPercent": 100, "ElapsedTimeMillis": 0, "TablesLoaded": 0, "TablesLoading": 0, "TablesQueued": 0, "TablesErrored": 0, "FreshStartDate": 1590619811.528, "StartDate": 1590619811.528, "StopDate": 1590619842.068 } } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS DMS-Aufgaben](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeReplicationTasks AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-replication-tasks.html)*Befehlsreferenz.* ### `describe-schemas` Das folgende Codebeispiel zeigt die Verwendung`describe-schemas`. **AWS CLI** **Um Datenbankschemas zu beschreiben** Im folgenden Beispiel für `describe-schemas` werden die verfügbaren Tabellen an einem Endpunkt aufgelistet. ``` aws dms describe-schemas \ --endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA" ``` Ausgabe: ``` { "Schemas": [ "prodrep" ] } ``` Weitere Informationen finden Sie unter [Titel des Themas](https://link.to.the/topic/page) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [DescribeSchemas](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-schemas.html)in der *AWS CLI Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für eine Replikations-Instance aufgelistet. ``` aws dms list-tags-for-resource \ --resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE ``` Ausgabe: ``` { "TagList": [ { "Key": "Project", "Value": "dbMigration" }, { "Key": "Environment", "Value": "PROD" } ] } ``` Weitere Informationen finden Sie unter [Taggen von Ressourcen](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tagging.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `modify-endpoint` Das folgende Codebeispiel zeigt die Verwendung`modify-endpoint`. **AWS CLI** **So ändern Sie einen Endpunkt** Im folgenden Beispiel für `modify-endpoint` wird einem Endpunkt ein zusätzliches Verbindungsattribut hinzugefügt. ``` aws dms modify-endpoint \ --endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U" \ --extra-connection-attributes "compressionType=GZIP" ``` Ausgabe: ``` { "Endpoint": { "EndpointIdentifier": "src-endpoint", "EndpointType": "SOURCE", "EngineName": "s3", "EngineDisplayName": "Amazon S3", "ExtraConnectionAttributes": "compressionType=GZIP;csvDelimiter=,;csvRowDelimiter=\\n;", "Status": "active", "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U", "SslMode": "none", "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role", "S3Settings": { "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role", "CsvRowDelimiter": "\\n", "CsvDelimiter": ",", "BucketFolder": "", "BucketName": "", "CompressionType": "GZIP", "EnableStatistics": true } } } ``` *Weitere Informationen finden Sie unter Working with AWS DMS Endpoints < https://docs.aws.amazon.com/dms/ latest/userguide/CHAP \$1endpoints.html>`\$1\$1 im Database Migration Service User Guide.AWS * + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [ModifyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-endpoint.html)AWS CLI * ### `modify-event-subscription` Das folgende Codebeispiel zeigt die Verwendung`modify-event-subscription`. **AWS CLI** **So ändern Sie ein Ereignisabonnement** Im folgenden Beispiel für `modify-event-subscription` wird der Quelltyp eines Ereignisabonnements geändert. ``` aws dms modify-event-subscription \ --subscription-name "my-dms-events" \ --source-type replication-task ``` Ausgabe: ``` { "EventSubscription": { "CustomerAwsId": "123456789012", "CustSubscriptionId": "my-dms-events", "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic", "Status": "modifying", "SubscriptionCreationTime": "2020-05-29 17:04:40.262", "SourceType": "replication-task", "Enabled": true } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Ereignissen und Benachrichtigungen](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [ModifyEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-event-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `modify-replication-instance` Das folgende Codebeispiel zeigt die Verwendung`modify-replication-instance`. **AWS CLI** **So ändern Sie eine Replikations-Instance** Im folgenden Beispiel für `modify-replication-instance` wird eine Replikations-Instance so geändert, dass sie eine Multi-AZ-Bereitstellung verwendet. ``` aws dms modify-replication-instance \ --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \ --multi-az ``` Ausgabe: ``` { "ReplicationInstance": { "ReplicationInstanceIdentifier": "my-repl-instance", "ReplicationInstanceClass": "dms.t2.micro", "ReplicationInstanceStatus": "available", "AllocatedStorage": 5, "InstanceCreateTime": 1590011235.952, ...output omitted... "PendingModifiedValues": { "MultiAZ": true }, "MultiAZ": false, "EngineVersion": "3.3.2", "AutoMinorVersionUpgrade": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a", ...output omitted... } } ``` Weitere Informationen finden Sie unter [Arbeiten mit einer AWS DMS-Replikationsinstanz](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ModifyReplicationInstance AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-replication-instance.html)*Befehlsreferenz.* ### `modify-replication-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`modify-replication-subnet-group`. **AWS CLI** **Um eine Subnetzgruppe zu ändern** Im folgenden Beispiel für `modify-replication-subnet-group` werden die Listen der Subnetze geändert, die einer Subnetzgruppe zugeordnet sind. ``` aws dms modify-replication-subnet-group \ --replication-subnet-group-identifier my-subnet-group \ --subnet-id subnet-da327bf6 subnet-bac383e0 ``` Ausgabe: ``` { "ReplicationSubnetGroup": { "ReplicationSubnetGroupIdentifier": "my-subnet-group", "ReplicationSubnetGroupDescription": "my subnet group", "VpcId": "vpc-136a4c6a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-da327bf6", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-bac383e0", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" } ] } } ``` Weitere Informationen finden Sie unter [Einrichten eines Netzwerks für eine Replikations-Instance](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.VPC.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie unter [ModifyReplicationSubnetGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-replication-subnet-group.html)*Befehlsreferenz.* ### `modify-replication-task` Das folgende Codebeispiel zeigt die Verwendung`modify-replication-task`. **AWS CLI** **So ändern Sie eine Replikationsaufgabe** Im folgenden Beispiel für `modify-replication-task` werden die Tabellenzuordnungen für eine Aufgabe geändert. ``` aws dms modify-replication-task \ --replication-task-arn "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" \ --table-mappings file://table-mappings.json ``` Inhalt von `table-mappings.json`: ``` { "rules": [ { "rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": { "schema-name": "prodrep", "table-name": "ACCT_%" }, "rule-action": "include", "filters": [] } ] } ``` Ausgabe: ``` { "ReplicationTask": { "ReplicationTaskIdentifier": "moveit2", "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "MigrationType": "full-load", "TableMappings": ...output omitted..., "ReplicationTaskSettings": ...output omitted..., "Status": "modifying", "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED", "ReplicationTaskCreationDate": 1590524772.505, "ReplicationTaskStartDate": 1590789424.653, "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS DMS-Aufgaben](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ModifyReplicationTask AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-replication-task.html)*Befehlsreferenz.* ### `reboot-replication-instance` Das folgende Codebeispiel zeigt die Verwendung`reboot-replication-instance`. **AWS CLI** **So starten Sie eine Replikations-Instance neu** Im folgenden Beispiel für `reboot-replication-instance` wird eine Replikations-Instance neu gestartet. ``` aws dms reboot-replication-instance \ --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE ``` Ausgabe: ``` { "ReplicationInstance": { "ReplicationInstanceIdentifier": "my-repl-instance", "ReplicationInstanceClass": "dms.t2.micro", "ReplicationInstanceStatus": "rebooting", "AllocatedStorage": 5, "InstanceCreateTime": 1590011235.952, ... output omitted ... } } ``` Weitere Informationen finden Sie unter [Arbeiten mit einer AWS DMS-Replikationsinstanz](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [RebootReplicationInstance AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/reboot-replication-instance.html)*Befehlsreferenz.* ### `refresh-schemas` Das folgende Codebeispiel zeigt die Verwendung`refresh-schemas`. **AWS CLI** **So aktualisieren Sie Datenbankschemata** Das folgende `refresh-schemas` Beispiel fordert AWS DMS auf, die Liste der Schemas an einem Endpunkt zu aktualisieren. ``` aws dms refresh-schemas \ --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \ --endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA" ``` Ausgabe: ``` { "RefreshSchemasStatus": { "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "Status": "refreshing", "LastRefreshDate": 1590019949.103 } } ``` + Einzelheiten zur API finden Sie unter [RefreshSchemas AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/refresh-schemas.html)*Befehlsreferenz*. ### `reload-tables` Das folgende Codebeispiel zeigt die Verwendung`reload-tables`. **AWS CLI** **So aktualisieren Sie die Liste der auf einem Endpunkt verfügbaren Tabellen** Im folgenden Beispiel für `reload-tables` wird die Liste der verfügbaren Tabellen an einem Endpunkt neu geladen. ``` aws dms reload-tables \ --replication-task-arn "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" \ --tables-to-reload "SchemaName=prodrep,TableName=ACCT_BAL" ``` Ausgabe: ``` { "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" } ``` + Einzelheiten zur API finden Sie [ReloadTables](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/reload-tables.html)in der *AWS CLI Befehlsreferenz*. ### `remove-tags-from-resource` Das folgende Codebeispiel zeigt die Verwendung`remove-tags-from-resource`. **AWS CLI** **So entfernen Sie Tags aus einer Replikations-Instance** Im folgenden Beispiel für `remove-tags-from-resource` werden Tags aus einer Replikations-Instance entfernt. ``` aws dms remove-tags-from-resource \ --resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \ --tag-keys Environment Project ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von Ressourcen](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tagging.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [RemoveTagsFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/remove-tags-from-resource.html)in der *AWS CLI Befehlsreferenz*. ### `start-replication-task-assessment` Das folgende Codebeispiel zeigt die Verwendung`start-replication-task-assessment`. **AWS CLI** **So starten Sie eine Aufgabenbewertung** Im folgenden Beispiel für `start-replication-task-assessment` wird eine Bewertung der Replikationsaufgabe gestartet. ``` aws dms start-replication-task-assessment \ --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII ``` Ausgabe: ``` { "ReplicationTask": { "ReplicationTaskIdentifier": "moveit2", "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "MigrationType": "full-load", "TableMappings": ...output omitted..., "ReplicationTaskSettings": ...output omitted..., "Status": "testing", "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED", "ReplicationTaskCreationDate": 1590524772.505, "ReplicationTaskStartDate": 1590789988.677, "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Aufgabenbewertungsberichts](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.AssessmentReport.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [StartReplicationTaskAssessment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/start-replication-task-assessment.html)in der *AWS CLI Befehlsreferenz*. ### `start-replication-task` Das folgende Codebeispiel zeigt die Verwendung`start-replication-task`. **AWS CLI** **So starten Sie eine Replikationsaufgabe** Das folgende `command-name` Beispiel listet die verfügbaren Widgets in Ihrem AWS Konto auf. ``` aws dms start-replication-task \ --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII \ --start-replication-task-type reload-target ``` Ausgabe: ``` { "ReplicationTask": { "ReplicationTaskIdentifier": "moveit2", "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "MigrationType": "full-load", "TableMappings": ...output omitted... , "ReplicationTaskSettings": ...output omitted... , "Status": "starting", "ReplicationTaskCreationDate": 1590524772.505, "ReplicationTaskStartDate": 1590619805.212, "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS DMS-Aufgaben](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [StartReplicationTask AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/start-replication-task.html)*Befehlsreferenz.* ### `stop-replication-task` Das folgende Codebeispiel zeigt die Verwendung`stop-replication-task`. **AWS CLI** **So beenden Sie eine Aufgabe** Im folgenden Beispiel für `stop-replication-task` wird eine Aufgabe angehalten. ``` aws dms stop-replication-task \ --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII ``` Ausgabe: ``` { "ReplicationTask": { "ReplicationTaskIdentifier": "moveit2", "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U", "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "MigrationType": "full-load", "TableMappings": ...output omitted..., "ReplicationTaskSettings": ...output omitted..., "Status": "stopping", "ReplicationTaskCreationDate": 1590524772.505, "ReplicationTaskStartDate": 1590789424.653, "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS DMS-Aufgaben](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) im *AWS Database Migration Service Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [StopReplicationTask AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/stop-replication-task.html)*Befehlsreferenz.* ### `test-connection` Das folgende Codebeispiel zeigt die Verwendung`test-connection`. **AWS CLI** **So testen Sie eine Verbindung mit einem Endpunkt** Im folgenden Beispiel für `test-connection` wird getestet, ob von einer Replikations-Instance aus auf einen Endpunkt zugegriffen werden kann. ``` aws dms test-connection \ --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \ --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA ``` Ausgabe: ``` { "Connection": { "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE", "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA", "Status": "testing", "EndpointIdentifier": "src-database-1", "ReplicationInstanceIdentifier": "my-repl-instance" } } ``` Weitere Informationen finden Sie unter [Erstellen der Quell- und Zielendpunkte](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.Creating.html) im *Benutzerhandbuch für AWS Database Migration Service*. + Einzelheiten zur API finden Sie [TestConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/test-connection.html)in der *AWS CLI Befehlsreferenz*. # Amazon DocumentDB DocumentDB-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon DocumentDB Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-tags-to-resource` Das folgende Codebeispiel zeigt, wie Sie`add-tags-to-resource`. **AWS CLI** **So fügen Sie der angegebenen Ressource ein oder mehrere Tags hinzu** Im folgenden Beispiel für `add-tags-to-resource` werden `sample-cluster` 3 Tags hinzugefügt. Ein Tag (`CropB`) hat einen Schlüsselnamen, aber keinen Wert. ``` aws docdb add-tags-to-resource \ --resource-name arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster \ --tags Key="CropA",Value="Apple" Key="CropB" Key="CropC",Value="Corn" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von Amazon-DocumentDB-Ressourcen](https://docs.aws.amazon.com/documentdb/latest/developerguide/tagging.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [AddTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/add-tags-to-resource.html)in der *AWS CLI Befehlsreferenz*. ### `apply-pending-maintenance-action` Das folgende Codebeispiel zeigt die Verwendung`apply-pending-maintenance-action`. **AWS CLI** **So sorgen Sie dafür, dass ausstehende Wartungsaktionen während des nächsten Wartungsfensters ausgeführt werden** Im folgenden Beispiel für `apply-pending-maintenance-action` werden alle Aktionen zur Aktualisierung des Systems während des nächsten geplanten Wartungsfensters ausgeführt. ``` aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster \ --apply-action system-update \ --opt-in-type next-maintenance ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Anwenden von Amazon-DocumentDB-Aktualisierungen](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html#db-instance-updates-apply) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [ApplyPendingMaintenanceAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html)in der *AWS CLI Befehlsreferenz*. ### `copy-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`copy-db-cluster-parameter-group`. **AWS CLI** **So duplizieren Sie eine vorhandene DB-Cluster-Parametergruppe** Im folgenden Beispiel für `copy-db-cluster-parameter-group` wird eine Kopie der Parametergruppe `custom-docdb3-6` mit dem Namen `custom-docdb3-6-copy` erstellt. Beim Kopieren werden der neuen Parametergruppe Tags hinzugefügt. ``` aws docdb copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier custom-docdb3-6 \ --target-db-cluster-parameter-group-identifier custom-docdb3-6-copy \ --target-db-cluster-parameter-group-description "Copy of custom-docdb3-6" \ --tags Key="CopyNumber",Value="1" Key="Modifiable",Value="Yes" ``` Ausgabe: ``` { "DBClusterParameterGroup": { "DBParameterGroupFamily": "docdb3.6", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:12345678901:cluster-pg:custom-docdb3-6-copy", "DBClusterParameterGroupName": "custom-docdb3-6-copy", "Description": "Copy of custom-docdb3-6" } } ``` Weitere Informationen finden Sie unter [Kopieren einer Cluster-Parametergruppe von Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-parameter-group-copy.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [CopyDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/copy-db-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `copy-db-cluster-snapshot` Das folgende Codebeispiel zeigt die Verwendung`copy-db-cluster-snapshot`. **AWS CLI** **So erstellen Sie eine Kopie eines Snapshots** Im folgenden Beispiel für `copy-db-cluster-snapshot` wird eine Kopie von `sample-cluster-snapshot` mit dem Namen `sample-cluster-snapshot-copy` erstellt. Die Kopie enthält alle Tags des Originals sowie ein neues Tag mit dem Schlüsselnamen `CopyNumber`. ``` aws docdb copy-db-cluster-snapshot \ --source-db-cluster-snapshot-identifier sample-cluster-snapshot \ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \ --copy-tags \ --tags Key="CopyNumber",Value="1" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kopieren eines Cluster-Snapshots](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup-restore.db-cluster-snapshot-copy.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [CopyDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/copy-db-cluster-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`create-db-cluster-parameter-group`. **AWS CLI** **So erstellen Sie eine Parametergruppe für einen Amazon-DocumentDB-Cluster** Im folgenden Beispiel für `create-db-cluster-parameter-group` wird die DB-Cluster-Parametergruppe `sample-parameter-group` mithilfe der Familie `docdb3.6` erstellt. ``` aws docdb create-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --db-parameter-group-family docdb3.6 \ --description "Sample parameter group based on docdb3.6" ``` Ausgabe: ``` { "DBClusterParameterGroup": { "Description": "Sample parameter group based on docdb3.6", "DBParameterGroupFamily": "docdb3.6", "DBClusterParameterGroupArn": "arn:aws:rds:us-west-2:123456789012:cluster-pg:sample-parameter-group", "DBClusterParameterGroupName": "sample-parameter-group" } } ``` Weitere Informationen finden Sie unter [Erstellen einer Cluster-Parametergruppe in Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-parameter-group-create.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [CreateDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-db-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-cluster-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-db-cluster-snapshot`. **AWS CLI** **So erstellen Sie einen manuellen Snapshot eines Amazon DocumentDB-Clusters** Im folgenden `create-db-cluster-snapshot` Beispiel wird ein Amazon-DB-Cluster-Snapshot mit dem Namen erstellt sample-cluster-snapshot. ``` aws docdb create-db-cluster-snapshot \ --db-cluster-identifier sample-cluster \ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` Ausgabe: ``` { "DBClusterSnapshot": { "MasterUsername": "master-user", "SnapshotCreateTime": "2019-03-18T18:27:14.794Z", "AvailabilityZones": [ "us-west-2a", "us-west-2b", "us-west-2c", "us-west-2d", "us-west-2e", "us-west-2f" ], "SnapshotType": "manual", "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot", "EngineVersion": "3.6.0", "PercentProgress": 0, "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "Engine": "docdb", "DBClusterIdentifier": "sample-cluster", "Status": "creating", "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "Port": 0, "StorageEncrypted": false, "VpcId": "vpc-91280df6" } } ``` Weitere Informationen finden Sie unter [Erstellen eines manuellen Cluster-Snapshots](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup-restore.db-cluster-snapshot-create.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [CreateDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-db-cluster-snapshot.html)unter *AWS CLI Befehlsreferenz*. ### `create-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`create-db-cluster`. **AWS CLI** **So erstellen Sie einen Amazon-DocumentDB-Cluster** Im folgenden Beispiel für `create-db-cluster` wird ein Amazon-DocumentDB-Cluster mit dem Namen `sample-cluster` im bevorzugten Wartungsfenster sonntags zwischen 20:30 Uhr und 11:00 Uhr erstellt. ``` aws docdb create-db-cluster \ --db-cluster-identifier sample-cluster \ --engine docdb \ --master-username master-user \ --master-user-password password \ --preferred-maintenance-window Sun:20:30-Sun:21:00 ``` Ausgabe: ``` { "DBCluster": { "DBClusterParameterGroup": "default.docdb3.6", "AssociatedRoles": [], "DBSubnetGroup": "default", "ClusterCreateTime": "2019-03-18T18:06:34.616Z", "Status": "creating", "Port": 27017, "PreferredMaintenanceWindow": "sun:20:30-sun:21:00", "HostedZoneId": "ZNKXH85TT8WVW", "DBClusterMembers": [], "Engine": "docdb", "DBClusterIdentifier": "sample-cluster", "PreferredBackupWindow": "10:12-10:42", "AvailabilityZones": [ "us-west-2d", "us-west-2f", "us-west-2e" ], "MasterUsername": "master-user", "BackupRetentionPeriod": 1, "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "StorageEncrypted": false, "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "DbClusterResourceId": "cluster-L3R4YRSBUYDP4GLMTJ2WF5GH5Q", "MultiAZ": false, "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "EngineVersion": "3.6.0" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Amazon-DocumentDB-Clusters](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [CreateDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-instance` Das folgende Codebeispiel zeigt die Verwendung`create-db-instance`. **AWS CLI** **So erstellen Sie eine Instance in einem Amazon-DocumentDB-Cluster** Mit dem folgenden `create-db-instance`-Beispielcode wird die Instance `sample-cluster-instance-2` im Amazon-DocumentDB-Cluster `sample-cluster` erstellt. ``` aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-class db.r4.xlarge \ --db-instance-identifier sample-cluster-instance-2 \ --engine docdb ``` Ausgabe: ``` { "DBInstance": { "DBInstanceStatus": "creating", "PendingModifiedValues": { "PendingCloudwatchLogsExports": { "LogTypesToEnable": [ "audit" ] } }, "PubliclyAccessible": false, "PreferredBackupWindow": "00:00-00:30", "PromotionTier": 1, "EngineVersion": "3.6.0", "BackupRetentionPeriod": 3, "DBInstanceIdentifier": "sample-cluster-instance-2", "PreferredMaintenanceWindow": "tue:10:28-tue:10:58", "StorageEncrypted": false, "Engine": "docdb", "DBClusterIdentifier": "sample-cluster", "DBSubnetGroup": { "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetAvailabilityZone": { "Name": "us-west-2c" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0" } ], "DBSubnetGroupDescription": "default", "SubnetGroupStatus": "Complete", "VpcId": "vpc-91280df6", "DBSubnetGroupName": "default" }, "DBInstanceClass": "db.r4.xlarge", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster-instance-2", "DbiResourceId": "db-XEKJLEMGRV5ZKCARUVA4HO3ITE" } } ``` Weitere Informationen finden Sie unter [Hinzufügen einer Amazon-DocumentDB-Instance zu einem Cluster](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-add.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [CreateDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-db-instance.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`create-db-subnet-group`. **AWS CLI** **So erstellen Sie eine Amazon-DocumentDB-Subnetzgruppe** Im folgenden Beispiel für `create-db-subnet-group` wird eine Amazon-DocumentDB-Subnetzgruppe mit dem Namen `sample-subnet-group` erstellt. ``` aws docdb create-db-subnet-group \ --db-subnet-group-description "a sample subnet group" \ --db-subnet-group-name sample-subnet-group \ --subnet-ids "subnet-29ab1025" "subnet-991cb8d0" "subnet-53ab3636" ``` Ausgabe: ``` { "DBSubnetGroup": { "SubnetGroupStatus": "Complete", "DBSubnetGroupName": "sample-subnet-group", "DBSubnetGroupDescription": "a sample subnet group", "VpcId": "vpc-91280df6", "DBSubnetGroupArn": "arn:aws:rds:us-west-2:123456789012:subgrp:sample-subnet-group", "Subnets": [ { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-west-2d" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-west-2b" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-29ab1025", "SubnetAvailabilityZone": { "Name": "us-west-2c" } } ] } } ``` Weitere Informationen finden Sie unter [Erstellen einer Amazon-DocumentDB-Subnetzgruppe](https://docs.aws.amazon.com/documentdb/latest/developerguide/document-db-subnet-groups.html#document-db-subnet-group-create) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [CreateDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-db-subnet-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`delete-db-cluster-parameter-group`. **AWS CLI** **So löschen Sie eine Parametergruppe für einen Amazon-DocumentDB-Cluster** Im folgenden Beispiel für `delete-db-cluster-parameter-group` wird die Amazon-DocumentDB-Parametergruppe `sample-parameter-group` gelöscht. ``` aws docdb delete-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Cluster-Parametergruppe von Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-parameter-group-delete.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DeleteDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/delete-db-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-cluster-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-db-cluster-snapshot`. **AWS CLI** **So löschen Sie den Snapshot eines Amazon-DocumentDB-Clusters** Im folgenden Beispiel für `delete-db-cluster-snapshot` wird der Snapshot `sample-cluster-snapshot` des Amazon-DocumentDB-Clusters gelöscht. ``` aws docdb delete-db-cluster-snapshot \ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` Ausgabe: ``` { "DBClusterSnapshot": { "DBClusterIdentifier": "sample-cluster", "AvailabilityZones": [ "us-west-2a", "us-west-2b", "us-west-2c", "us-west-2d" ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "VpcId": "vpc-91280df6", "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot", "EngineVersion": "3.6.0", "Engine": "docdb", "SnapshotCreateTime": "2019-03-18T18:27:14.794Z", "Status": "available", "MasterUsername": "master-user", "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "PercentProgress": 100, "StorageEncrypted": false, "SnapshotType": "manual", "Port": 0 } } ``` Weitere Informationen finden Sie unter [Löschen eines Cluster-Snapshots](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup-restore.db-cluster-snapshot-delete.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DeleteDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/delete-db-cluster-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`delete-db-cluster`. **AWS CLI** **So löschen Sie einen Amazon-DocumentDB-Cluster** Im folgenden Beispiel für `delete-db-cluster` wird der Amazon-DocumentDB-Cluster `sample-cluster` gelöscht. Vor dem Löschen des Clusters wird keine Sicherungskopie erstellt. HINWEIS: Sie müssen alle dem Cluster zugeordneten Instances löschen, bevor Sie ihn entfernen können. ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot ``` Ausgabe: ``` { "DBCluster": { "DBClusterIdentifier": "sample-cluster", "DBSubnetGroup": "default", "EngineVersion": "3.6.0", "Engine": "docdb", "LatestRestorableTime": "2019-03-18T18:07:24.610Z", "PreferredMaintenanceWindow": "sun:20:30-sun:21:00", "StorageEncrypted": false, "EarliestRestorableTime": "2019-03-18T18:07:24.610Z", "Port": 27017, "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "MultiAZ": false, "MasterUsername": "master-user", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "Status": "available", "PreferredBackupWindow": "10:12-10:42", "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "AvailabilityZones": [ "us-west-2c", "us-west-2b", "us-west-2a" ], "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DbClusterResourceId": "cluster-L3R4YRSBUYDP4GLMTJ2WF5GH5Q", "ClusterCreateTime": "2019-03-18T18:06:34.616Z", "AssociatedRoles": [], "DBClusterParameterGroup": "default.docdb3.6", "HostedZoneId": "ZNKXH85TT8WVW", "BackupRetentionPeriod": 1, "DBClusterMembers": [] } } ``` Weitere Informationen finden Sie unter [Löschen eines Amazon-DocumentDB-Clusters](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-delete.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DeleteDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/delete-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-instance` Das folgende Codebeispiel zeigt die Verwendung`delete-db-instance`. **AWS CLI** **So löschen Sie eine Amazon-DocumentDB-Instance** Im folgenden Beispiel für `delete-db-instance` wird die Amazon-DocumentDB-Instance `sample-cluster-instance-2` gelöscht. ``` aws docdb delete-db-instance \ --db-instance-identifier sample-cluster-instance-2 ``` Ausgabe: ``` { "DBInstance": { "DBSubnetGroup": { "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetAvailabilityZone": { "Name": "us-west-2c" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0" } ], "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-91280df6", "SubnetGroupStatus": "Complete" }, "PreferredBackupWindow": "00:00-00:30", "InstanceCreateTime": "2019-03-18T18:37:33.709Z", "DBInstanceClass": "db.r4.xlarge", "DbiResourceId": "db-XEKJLEMGRV5ZKCARUVA4HO3ITE", "BackupRetentionPeriod": 3, "Engine": "docdb", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "AutoMinorVersionUpgrade": true, "PromotionTier": 1, "EngineVersion": "3.6.0", "Endpoint": { "Address": "sample-cluster-instance-2.corcjozrlsfc.us-west-2.docdb.amazonaws.com", "HostedZoneId": "ZNKXH85TT8WVW", "Port": 27017 }, "DBInstanceIdentifier": "sample-cluster-instance-2", "PreferredMaintenanceWindow": "tue:10:28-tue:10:58", "EnabledCloudwatchLogsExports": [ "audit" ], "PendingModifiedValues": {}, "DBInstanceStatus": "deleting", "PubliclyAccessible": false, "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster-instance-2", "DBClusterIdentifier": "sample-cluster", "AvailabilityZone": "us-west-2c", "StorageEncrypted": false } } ``` Weitere Informationen finden Sie unter [Löschen einer Amazon-DocumentDB-Instance](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-delete.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DeleteDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/delete-db-instance.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`delete-db-subnet-group`. **AWS CLI** **So löschen Sie eine Amazon-DocumentDB-Subnetzgruppe** Im folgenden Beispiel für `delete-db-subnet-group` wird die Amazon-DocumentDB-Subnetzgruppe `sample-subnet-group` gelöscht. ``` aws docdb delete-db-subnet-group \ --db-subnet-group-name sample-subnet-group ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Amazon-DocumentDB-Subnetzgruppe](https://docs.aws.amazon.com/documentdb/latest/developerguide/document-db-subnet-groups.html#document-db-subnet-group-delete) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DeleteDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/delete-db-subnet-group.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-cluster-parameter-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-parameter-groups`. **AWS CLI** **So sehen Sie die Details einer oder mehrerer Parametergruppen eines Amazon-DocumentDB-Clusters** Im folgenden Beispiel für `describe-db-cluster-parameter-groups` werden die Details für die Parametergruppe `custom3-6-param-grp` des Amazon-DocumentDB-Clusters angezeigt. ``` aws docdb describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name custom3-6-param-grp ``` Ausgabe: ``` { "DBClusterParameterGroups": [ { "DBParameterGroupFamily": "docdb3.6", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:custom3-6-param-grp", "Description": "Custom docdb3.6 parameter group", "DBClusterParameterGroupName": "custom3-6-param-grp" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen der Cluster-Parametergruppen von Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-parameter-group-describe.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DescribeDbClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-db-cluster-parameter-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-cluster-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-parameters`. **AWS CLI** **So zeigen Sie die detaillierte Parameterliste für eine Parametergruppe eines Amazon-DocumentDB-Clusters an.** Im folgenden Beispiel für `describe-db-cluster-parameters` werden die Parameter für die Amazon-DocumentDB-Parametergruppe custom3-6-param-grp aufgelistet. ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name custom3-6-param-grp ``` Ausgabe: ``` { "Parameters": [ { "DataType": "string", "ParameterName": "audit_logs", "IsModifiable": true, "ApplyMethod": "pending-reboot", "Source": "system", "ApplyType": "dynamic", "AllowedValues": "enabled,disabled", "Description": "Enables auditing on cluster.", "ParameterValue": "disabled" }, { "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "ApplyMethod": "pending-reboot", "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "Description": "Config to enable/disable TLS", "ParameterValue": "enabled" }, { "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "ApplyMethod": "pending-reboot", "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "Description": "Enables TTL Monitoring", "ParameterValue": "enabled" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen der Cluster-Parameter von Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-parameters-describe.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DescribeDbClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-db-cluster-parameters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-cluster-snapshot-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-snapshot-attributes`. **AWS CLI** **So listen Sie die Attributnamen und -werte eines Amazon-DocumentDB-Snapshots auf** Im folgenden Beispiel für `describe-db-cluster-snapshot-attributes` werden die Attributnamen und -werte für den Amazon-DocumentDB-Snapshot `sample-cluster-snapshot` aufgeführt. ``` aws docdb describe-db-cluster-snapshot-attributes \ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` Ausgabe: ``` { "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [] } ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot" } } ``` Weitere Informationen finden Sie unter [Describe DBCluster SnapshotAttributes](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusterSnapshotAttributes.html) im *Amazon DocumentDB Developer Guide*. + Einzelheiten zur API finden Sie [DescribeDbClusterSnapshotAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-db-cluster-snapshot-attributes.html)in der *AWS CLI Befehlsreferenz.* ### `describe-db-cluster-snapshots` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-snapshots`. **AWS CLI** **So beschreiben Sie Amazon-DocumentDB-Snapshots** Im folgenden Beispiel für `describe-db-cluster-snapshots` werden Details für den Amazon-DocumentDB-Snapshot `sample-cluster-snapshot` angezeigt. ``` aws docdb describe-db-cluster-snapshots \ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` Ausgabe: ``` { "DBClusterSnapshots": [ { "AvailabilityZones": [ "us-west-2a", "us-west-2b", "us-west-2c", "us-west-2d" ], "Status": "available", "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot", "SnapshotCreateTime": "2019-03-15T20:41:26.515Z", "SnapshotType": "manual", "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "DBClusterIdentifier": "sample-cluster", "MasterUsername": "master-user", "StorageEncrypted": false, "VpcId": "vpc-91280df6", "EngineVersion": "3.6.0", "PercentProgress": 100, "Port": 0, "Engine": "docdb", "ClusterCreateTime": "2019-03-15T20:29:58.836Z" } ] } ``` Weitere Informationen finden Sie unter [Describe DBCluster Snapshots](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusterSnapshots.html) im *Amazon DocumentDB Developer Guide*. + Einzelheiten zur API finden Sie [DescribeDbClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-db-cluster-snapshots.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-clusters` Das folgende Codebeispiel zeigt die Verwendung`describe-db-clusters`. **AWS CLI** **So rufen Sie detaillierte Informationen über einen oder mehrere Amazon-DocumentDB-Cluster ab.** Im folgenden Beispiel für `describe-db-clusters` werden die Details für den Amazon-DocumentDB-Cluster `sample-cluster` angezeigt. Wenn Sie den Parameter `--db-cluster-identifier` weglassen, können Sie Informationen von bis zu 100 Clustern abrufen. ``` aws docdb describe-db-clusters --db-cluster-identifier sample-cluster ``` Ausgabe: ``` { "DBClusters": [ { "DBClusterParameterGroup": "default.docdb3.6", "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "PreferredBackupWindow": "00:00-00:30", "DBClusterIdentifier": "sample-cluster", "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "LatestRestorableTime": "2019-03-18T20:28:03.239Z", "MasterUsername": "master-user", "DBClusterMembers": [ { "PromotionTier": 1, "DBClusterParameterGroupStatus": "in-sync", "IsClusterWriter": false, "DBInstanceIdentifier": "sample-cluster" }, { "PromotionTier": 1, "DBClusterParameterGroupStatus": "in-sync", "IsClusterWriter": true, "DBInstanceIdentifier": "sample-cluster2" } ], "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "Engine": "docdb", "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DBSubnetGroup": "default", "MultiAZ": true, "AvailabilityZones": [ "us-west-2a", "us-west-2c", "us-west-2b" ], "EarliestRestorableTime": "2019-03-15T20:30:47.020Z", "DbClusterResourceId": "cluster-UP4EF2PVDDFVHHDJQTYDAIGHLE", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "BackupRetentionPeriod": 3, "HostedZoneId": "ZNKXH85TT8WVW", "StorageEncrypted": false, "EnabledCloudwatchLogsExports": [ "audit" ], "AssociatedRoles": [], "EngineVersion": "3.6.0", "Port": 27017, "Status": "available" } ] } ``` Weitere Informationen finden Sie unter [Beschreiben von Amazon-DocumentDB-Clustern](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-view-details.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DescribeDbClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-db-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-engine-versions` Das folgende Codebeispiel zeigt die Verwendung`describe-db-engine-versions`. **AWS CLI** **So listen Sie verfügbare Engine-Versionen von Amazon DocumentDB auf** Im folgenden Beispiel für `describe-db-engine-versions` werden alle verfügbaren Engine-Versionen von Amazon DocumentDB aufgelistet. ``` aws docdb describe-db-engine-versions \ --engine docdb ``` Ausgabe: ``` { "DBEngineVersions": [ { "DBEngineVersionDescription": "DocDB version 1.0.200837", "DBParameterGroupFamily": "docdb3.6", "EngineVersion": "3.6.0", "ValidUpgradeTarget": [], "DBEngineDescription": "Amazon DocumentDB (with MongoDB compatibility)", "SupportsLogExportsToCloudwatchLogs": true, "Engine": "docdb", "ExportableLogTypes": [ "audit" ] } ] } ``` Weitere Informationen finden Sie unter [DBEngineVersionen beschreiben](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBEngineVersions.html) im *Amazon DocumentDB Developer Guide*. + Einzelheiten zur API finden Sie [DescribeDbEngineVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-db-engine-versions.html)in der *AWS CLI Befehlsreferenz.* ### `describe-db-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-db-instances`. **AWS CLI** **So suchen Sie Informationen über bereitgestellte Amazon-DocumentDB-Instances** Im folgenden Beispiel für `describe-db-instances` werden die Details für die Amazon-DocumentDB-Instance `sample-cluster-instance` angezeigt. Wenn Sie den Parameter `--db-instance-identifier` weglassen, können Sie Informationen von bis zu 100 Instances abrufen. ``` aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance ``` Ausgabe: ``` { "DBInstances": [ { "Endpoint": { "HostedZoneId": "ZNKXH85TT8WVW", "Address": "sample-cluster-instance.corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Port": 27017 }, "PreferredBackupWindow": "00:00-00:30", "DBInstanceStatus": "available", "DBInstanceClass": "db.r4.large", "EnabledCloudwatchLogsExports": [ "audit" ], "DBInstanceIdentifier": "sample-cluster-instance", "DBSubnetGroup": { "Subnets": [ { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263", "SubnetAvailabilityZone": { "Name": "us-west-2a" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4", "SubnetAvailabilityZone": { "Name": "us-west-2c" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-west-2d" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-west-2b" } } ], "DBSubnetGroupName": "default", "SubnetGroupStatus": "Complete", "DBSubnetGroupDescription": "default", "VpcId": "vpc-91280df6" }, "InstanceCreateTime": "2019-03-15T20:36:06.338Z", "Engine": "docdb", "StorageEncrypted": false, "AutoMinorVersionUpgrade": true, "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster-instance", "PreferredMaintenanceWindow": "tue:08:39-tue:09:09", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "DBClusterIdentifier": "sample-cluster", "PendingModifiedValues": {}, "BackupRetentionPeriod": 3, "PubliclyAccessible": false, "EngineVersion": "3.6.0", "PromotionTier": 1, "AvailabilityZone": "us-west-2c", "DbiResourceId": "db-A2GIKUV6KPOHITGGKI2NHVISZA" } ] } ``` Weitere Informationen finden Sie unter [Beschreiben von Amazon-DocumentDB-Instances](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-view-details.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DescribeDbInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-db-instances.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-subnet-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-db-subnet-groups`. **AWS CLI** **So rufen Sie eine Liste mit Amazon-DocumentDB-Subnetzbeschreibungen ab** Im folgenden Beispiel für `describe-db-subnet-groups` werden Details für das Amazon-DocumentDB-Subnetz namens `default` beschrieben. ``` aws docdb describe-db-subnet-groups \ --db-subnet-group-name default ``` Ausgabe: ``` { "DBSubnetGroups": [ { "VpcId": "vpc-91280df6", "DBSubnetGroupArn": "arn:aws:rds:us-west-2:123456789012:subgrp:default", "Subnets": [ { "SubnetIdentifier": "subnet-4e26d263", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2a" } }, { "SubnetIdentifier": "subnet-afc329f4", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2c" } }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2d" } }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2b" } } ], "DBSubnetGroupName": "default", "SubnetGroupStatus": "Complete", "DBSubnetGroupDescription": "default" } ] } ``` Weitere Informationen finden Sie unter [Beschreiben von Subnetzgruppen](https://docs.aws.amazon.com/documentdb/latest/developerguide/document-db-subnet-groups.html#document-db-subnet-groups-describe) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DescribeDbSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-db-subnet-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-engine-default-cluster-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-engine-default-cluster-parameters`. **AWS CLI** **So beschreiben Sie die Standard-Engine- und Systemparameterinformationen für Amazon DocumentDB** Im folgenden Beispiel für `describe-engine-default-cluster-parameters` werden Details zur Standard-Engine sowie Systemparameterinformationen für die Amazon-DocumentDB-Parametergruppe `docdb3.6` angezeigt. ``` aws docdb describe-engine-default-cluster-parameters \ --db-parameter-group-family docdb3.6 ``` Ausgabe: ``` { "EngineDefaults": { "DBParameterGroupFamily": "docdb3.6", "Parameters": [ { "ApplyType": "dynamic", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "DataType": "string", "MinimumEngineVersion": "3.6.0", "AllowedValues": "enabled,disabled", "ParameterName": "audit_logs", "IsModifiable": true }, { "ApplyType": "static", "ParameterValue": "enabled", "Description": "Config to enable/disable TLS", "Source": "system", "DataType": "string", "MinimumEngineVersion": "3.6.0", "AllowedValues": "disabled,enabled", "ParameterName": "tls", "IsModifiable": true }, { "ApplyType": "dynamic", "ParameterValue": "enabled", "Description": "Enables TTL Monitoring", "Source": "system", "DataType": "string", "MinimumEngineVersion": "3.6.0", "AllowedValues": "disabled,enabled", "ParameterName": "ttl_monitor", "IsModifiable": true } ] } } ``` Weitere Informationen finden Sie [DescribeEngineDefaultClusterParameters](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEngineDefaultClusterParameters.html)im *Amazon DocumentDB Developer Guide*. + Einzelheiten zur API finden Sie [DescribeEngineDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-engine-default-cluster-parameters.html)in der *AWS CLI Befehlsreferenz.* ### `describe-event-categories` Das folgende Codebeispiel zeigt die Verwendung`describe-event-categories`. **AWS CLI** **So beschreiben Sie alle Amazon-DocumentDB-Ereigniskategorien** Im folgenden Beispiel für `describe-event-categories` werden alle Kategorien für den Amazon-DocumentDB-Ereignisquellentyp `db-instance` aufgelistet. ``` aws docdb describe-event-categories \ --source-type db-cluster ``` Ausgabe: ``` { "EventCategoriesMapList": [ { "SourceType": "db-cluster", "EventCategories": [ "failover", "maintenance", "notification", "failure" ] } ] } ``` Weitere Informationen finden Sie unter [Anzeigen von Ereigniskategorien](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-events.html#viewing-event-categories) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DescribeEventCategories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-event-categories.html)in der *AWS CLI Befehlsreferenz*. ### `describe-events` Das folgende Codebeispiel zeigt die Verwendung`describe-events`. **AWS CLI** **So listen Sie Amazon-DocumentDB-Ereignisse auf** Im folgenden Beispiel für `describe-events` werden alle Amazon-DocumentDB-Ereignisse der letzten 24 Stunden (1 440 Minuten) aufgelistet. ``` aws docdb describe-events \ --duration 1440 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { "Events": [ { "EventCategories": [ "failover" ], "Message": "Started cross AZ failover to DB instance: sample-cluster", "Date": "2019-03-18T21:36:29.807Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "SourceIdentifier": "sample-cluster", "SourceType": "db-cluster" }, { "EventCategories": [ "availability" ], "Message": "DB instance restarted", "Date": "2019-03-18T21:36:40.793Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster", "SourceIdentifier": "sample-cluster", "SourceType": "db-instance" }, { "EventCategories": [], "Message": "A new writer was promoted. Restarting database as a reader.", "Date": "2019-03-18T21:36:43.873Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance restarted", "Date": "2019-03-18T21:36:51.257Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "failover" ], "Message": "Completed failover to DB instance: sample-cluster", "Date": "2019-03-18T21:36:53.462Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "SourceIdentifier": "sample-cluster", "SourceType": "db-cluster" }, { "Date": "2019-03-19T16:51:48.847Z", "EventCategories": [ "configuration change" ], "Message": "Updated parameter audit_logs to enabled with apply method pending-reboot", "SourceIdentifier": "custom3-6-param-grp", "SourceType": "db-parameter-group" }, { "EventCategories": [ "configuration change" ], "Message": "Applying modification to database instance class", "Date": "2019-03-19T17:55:20.095Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance shutdown", "Date": "2019-03-19T17:56:31.127Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "configuration change" ], "Message": "Finished applying modification to DB instance class", "Date": "2019-03-19T18:00:45.822Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance restarted", "Date": "2019-03-19T18:00:53.397Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance shutdown", "Date": "2019-03-19T18:23:36.045Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance restarted", "Date": "2019-03-19T18:23:46.209Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "Date": "2019-03-19T18:39:05.822Z", "EventCategories": [ "configuration change" ], "Message": "Updated parameter ttl_monitor to enabled with apply method immediate", "SourceIdentifier": "custom3-6-param-grp", "SourceType": "db-parameter-group" }, { "Date": "2019-03-19T18:39:48.067Z", "EventCategories": [ "configuration change" ], "Message": "Updated parameter audit_logs to disabled with apply method immediate", "SourceIdentifier": "custom3-6-param-grp", "SourceType": "db-parameter-group" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen von Amazon DocumentDB-Ereignissen](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-events.html#viewing-events) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-events.html)in der *AWS CLI Befehlsreferenz*. ### `describe-orderable-db-instance-options` Das folgende Codebeispiel zeigt die Verwendung`describe-orderable-db-instance-options`. **AWS CLI** **So suchen Sie die Instance-Optionen für Amazon DocumentDB, die Sie bestellen können** Im folgenden Beispiel für `describe-orderable-db-instance-options` werden alle Instance-Optionen für Amazon DocumentDB für eine Region aufgelistet. ``` aws docdb describe-orderable-db-instance-options \ --engine docdb \ --region us-east-1 ``` Ausgabe: ``` { "OrderableDBInstanceOptions": [ { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.16xlarge", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.2xlarge", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.4xlarge", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.8xlarge", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.large", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.xlarge", "LicenseModel": "na", "Engine": "docdb" } ] } ``` Weitere Informationen finden Sie unter [Hinzufügen einer Amazon-DocumentDB-Instance zu einem Cluster](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-add.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DescribeOrderableDbInstanceOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-orderable-db-instance-options.html)in der *AWS CLI Befehlsreferenz*. ### `describe-pending-maintenance-actions` Das folgende Codebeispiel zeigt die Verwendung`describe-pending-maintenance-actions`. **AWS CLI** **So listen Sie Ihre ausstehenden Amazon-DocumentDB-Wartungsaktionen auf** Im folgenden Beispiel für `describe-pending-maintenance-actions` werden alle Ihre ausstehenden Amazon-DocumentDB-Wartungsaktionen aufgelistet. ``` aws docdb describe-pending-maintenance-actions ``` Ausgabe: ``` { "PendingMaintenanceActions": [] } ``` Weitere Informationen finden Sie unter [Warten von Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [DescribePendingMaintenanceActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)in der *AWS CLI Befehlsreferenz*. ### `failover-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`failover-db-cluster`. **AWS CLI** **So erzwingen Sie ein Failover eines Amazon-DocumentDB-Clusters auf ein Replikat** Im folgenden Beispiel für `failover-db-cluster` wird für die primäre Instance im Amazon-DocumentDB-Cluster sample-cluster ein Failover auf ein Replikat ausgeführt. ``` aws docdb failover-db-cluster \ --db-cluster-identifier sample-cluster ``` Ausgabe: ``` { "DBCluster": { "AssociatedRoles": [], "DBClusterIdentifier": "sample-cluster", "EngineVersion": "3.6.0", "DBSubnetGroup": "default", "MasterUsername": "master-user", "EarliestRestorableTime": "2019-03-15T20:30:47.020Z", "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "AvailabilityZones": [ "us-west-2a", "us-west-2c", "us-west-2b" ], "LatestRestorableTime": "2019-03-18T21:35:23.548Z", "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "PreferredBackupWindow": "00:00-00:30", "Port": 27017, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "StorageEncrypted": false, "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "MultiAZ": true, "Status": "available", "DBClusterMembers": [ { "DBClusterParameterGroupStatus": "in-sync", "IsClusterWriter": false, "DBInstanceIdentifier": "sample-cluster", "PromotionTier": 1 }, { "DBClusterParameterGroupStatus": "in-sync", "IsClusterWriter": true, "DBInstanceIdentifier": "sample-cluster2", "PromotionTier": 2 } ], "EnabledCloudwatchLogsExports": [ "audit" ], "DBClusterParameterGroup": "default.docdb3.6", "HostedZoneId": "ZNKXH85TT8WVW", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "BackupRetentionPeriod": 3, "DbClusterResourceId": "cluster-UP4EF2PVDDFVHHDJQTYDAIGHLE", "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Engine": "docdb" } } ``` Weitere Informationen finden Sie unter [Amazon-DocumentDB-Failover](https://docs.aws.amazon.com/documentdb/latest/developerguide/failover.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [FailoverDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie alle Tags einer Amazon-DocumentDB-Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags des Amazon-DocumentDB-Clusters `sample-cluster` aufgelistet. ``` aws docdb list-tags-for-resource \ --resource-name arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster ``` Ausgabe: ``` { "TagList": [ { "Key": "A", "Value": "ALPHA" }, { "Key": "B", "Value": "" }, { "Key": "C", "Value": "CHARLIE" } ] } ``` Weitere Informationen finden Sie unter [Auflisten von Tags für eine Amazon-DocumentDB-Ressource](https://docs.aws.amazon.com/documentdb/latest/developerguide/tagging.html#tagging-list) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`modify-db-cluster-parameter-group`. **AWS CLI** **So ändern Sie eine Parametergruppe für einen Amazon-DocumentDB-Cluster** Im folgenden Beispiel für `modify-db-cluster-parameter-group` wird die Parametergruppe `custom3-6-param-grp` für den Amazon-DocumentDB-Cluster geändert, indem die beiden Parameter `audit_logs` und `ttl_monitor` auf aktiviert festgelegt werden. Die Änderungen werden beim nächsten Neustart übernommen. ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name custom3-6-param-grp \ --parameters ParameterName=audit_logs,ParameterValue=enabled,ApplyMethod=pending-reboot \ ParameterName=ttl_monitor,ParameterValue=enabled,ApplyMethod=pending-reboot ``` Ausgabe: ``` { "DBClusterParameterGroupName": "custom3-6-param-grp" } ``` Weitere Informationen finden Sie unter [Ändern einer Cluster-Parametergruppe von Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-parameter-group-modify.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [ModifyDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/modify-db-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-cluster-snapshot-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-db-cluster-snapshot-attribute`. **AWS CLI** **Beispiel 1: So fügen Sie einem Amazon-DocumentDB-Snapshot ein Attribut hinzu** Im folgenden Beispiel für `modify-db-cluster-snapshot-attribute` werden dem Snapshot eines Amazon-DocumentDB-Clusters vier Attributwerte hinzugefügt. ``` aws docdb modify-db-cluster-snapshot-attribute \ --db-cluster-snapshot-identifier sample-cluster-snapshot \ --attribute-name restore \ --values-to-add 123456789011 123456789012 123456789013 ``` Ausgabe: ``` { "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123456789011", "123456789012", "123456789013" ] } ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot" } } ``` **Beispiel 2: So entfernen Sie Attribute von einem Amazon-DocumentDB-Snapshot** Im folgenden Beispiel für `modify-db-cluster-snapshot-attribute` werden zwei Attributwerte von einem Snapshot eines Amazon-DocumentDB-Clusters entfernt. ``` aws docdb modify-db-cluster-snapshot-attribute \ --db-cluster-snapshot-identifier sample-cluster-snapshot \ --attribute-name restore \ --values-to-remove 123456789012 ``` Ausgabe: ``` { "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123456789011", "123456789013" ] } ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot" } } ``` Weitere Informationen finden Sie unter [Modify DBCluster SnapshotAttribute](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBClusterSnapshotAttribute.html) im *Amazon DocumentDB Developer Guide*. + Einzelheiten zur API finden Sie [ModifyDbClusterSnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/modify-db-cluster-snapshot-attribute.html)in der *AWS CLI Befehlsreferenz.* ### `modify-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`modify-db-cluster`. **AWS CLI** **So ändern Sie einen Amazon-DocumentDB-Cluster** Im folgenden Beispiel für `modify-db-cluster` wird der Amazon-DocumentDB-Cluster `sample-cluster` geändert, indem die Aufbewahrungsfrist für automatische Sicherungen auf 7 Tage festgelegt und die bevorzugten Fenster sowohl für Sicherungen als auch für Wartungen geändert werden. Diese Änderungen werden während des nächsten Wartungsfensters übernommen. ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --no-apply-immediately \ --backup-retention-period 7 \ --preferred-backup-window 18:00-18:30 \ --preferred-maintenance-window sun:20:00-sun:20:30 ``` Ausgabe: ``` { "DBCluster": { "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DBClusterMembers": [ { "DBClusterParameterGroupStatus": "in-sync", "DBInstanceIdentifier": "sample-cluster", "IsClusterWriter": true, "PromotionTier": 1 }, { "DBClusterParameterGroupStatus": "in-sync", "DBInstanceIdentifier": "sample-cluster2", "IsClusterWriter": false, "PromotionTier": 2 } ], "HostedZoneId": "ZNKXH85TT8WVW", "StorageEncrypted": false, "PreferredBackupWindow": "18:00-18:30", "MultiAZ": true, "EngineVersion": "3.6.0", "MasterUsername": "master-user", "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DBSubnetGroup": "default", "LatestRestorableTime": "2019-03-18T22:08:13.408Z", "EarliestRestorableTime": "2019-03-15T20:30:47.020Z", "PreferredMaintenanceWindow": "sun:20:00-sun:20:30", "AssociatedRoles": [], "EnabledCloudwatchLogsExports": [ "audit" ], "Engine": "docdb", "DBClusterParameterGroup": "default.docdb3.6", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "BackupRetentionPeriod": 7, "DBClusterIdentifier": "sample-cluster", "AvailabilityZones": [ "us-west-2a", "us-west-2c", "us-west-2b" ], "Status": "available", "DbClusterResourceId": "cluster-UP4EF2PVDDFVHHDJQTYDAIGHLE", "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "Port": 27017 } } ``` Weitere Informationen finden Sie unter [Ändern eines Amazon-DocumentDB-Clusters](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-modify.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [ModifyDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/modify-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-instance` Das folgende Codebeispiel zeigt die Verwendung`modify-db-instance`. **AWS CLI** **So ändern Sie eine Amazon-DocumentDB-Instance** Im folgenden Beispiel für `modify-db-instance` wird die Amazon-DocumentDB-Instance `sample-cluster2` geändert, indem ihre Instance-Klasse auf `db.r4.4xlarge` und ihre Erhebungsstufe auf `5` festgelegt wird. Die Änderungen werden sofort übernommen, sind aber erst sichtbar, wenn der Instance-Status verfügbar ist. ``` aws docdb modify-db-instance \ --db-instance-identifier sample-cluster2 \ --apply-immediately \ --db-instance-class db.r4.4xlarge \ --promotion-tier 5 ``` Ausgabe: ``` { "DBInstance": { "EngineVersion": "3.6.0", "StorageEncrypted": false, "DBInstanceClass": "db.r4.large", "PreferredMaintenanceWindow": "mon:08:39-mon:09:09", "AutoMinorVersionUpgrade": true, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "PreferredBackupWindow": "18:00-18:30", "EnabledCloudwatchLogsExports": [ "audit" ], "AvailabilityZone": "us-west-2f", "DBInstanceIdentifier": "sample-cluster2", "InstanceCreateTime": "2019-03-15T20:36:06.338Z", "Engine": "docdb", "BackupRetentionPeriod": 7, "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-4e26d263", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-afc329f4", "SubnetAvailabilityZone": { "Name": "us-west-2c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6" }, "PromotionTier": 2, "Endpoint": { "Address": "sample-cluster2.corcjozrlsfc.us-west-2.docdb.amazonaws.com", "HostedZoneId": "ZNKXH85TT8WVW", "Port": 27017 }, "DbiResourceId": "db-A2GIKUV6KPOHITGGKI2NHVISZA", "DBClusterIdentifier": "sample-cluster", "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "PendingModifiedValues": { "DBInstanceClass": "db.r4.4xlarge" }, "PubliclyAccessible": false, "DBInstanceStatus": "available" } } ``` Weitere Informationen finden Sie unter [Ändern einer Amazon-DocumentDB-Instance](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-modify.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [ModifyDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/modify-db-instance.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`modify-db-subnet-group`. **AWS CLI** **So ändern Sie eine Amazon-DocumentDB-Subnetzgruppe** Im folgenden Beispiel für `modify-db-subnet-group` wird die Subnetzgruppe `sample-subnet-group` geändert, indem die angegebenen Subnetze und eine neue Beschreibung hinzugefügt werden. ``` aws docdb modify-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --subnet-ids subnet-b3806e8f subnet-53ab3636 subnet-991cb8d0 \ --db-subnet-group-description "New subnet description" ``` Ausgabe: ``` { "DBSubnetGroup": { "DBSubnetGroupName": "sample-subnet-group", "SubnetGroupStatus": "Complete", "DBSubnetGroupArn": "arn:aws:rds:us-west-2:123456789012:subgrp:sample-subnet-group", "VpcId": "vpc-91280df6", "DBSubnetGroupDescription": "New subnet description", "Subnets": [ { "SubnetIdentifier": "subnet-b3806e8f", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2a" } }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2c" } }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2b" } } ] } } ``` Weitere Informationen finden Sie unter [Ändern einer Amazon-DocumentDB-Subnetzgruppe](https://docs.aws.amazon.com/documentdb/latest/developerguide/document-db-subnet-groups.html#document-db-subnet-group-modify) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [ModifyDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/modify-db-subnet-group.html)in der *AWS CLI Befehlsreferenz*. ### `reboot-db-instance` Das folgende Codebeispiel zeigt die Verwendung`reboot-db-instance`. **AWS CLI** **So starten Sie eine Amazon-DocumentDB-Instance neu** Im folgenden Beispiel für `reboot-db-instance` wird die Amazon-DocumentDB-Instance `sample-cluster2` neu gestartet. ``` aws docdb reboot-db-instance \ --db-instance-identifier sample-cluster2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { "DBInstance": { "PreferredBackupWindow": "18:00-18:30", "DBInstanceIdentifier": "sample-cluster2", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "DBSubnetGroup": { "VpcId": "vpc-91280df6", "Subnets": [ { "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2c" }, "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetIdentifier": "subnet-991cb8d0" } ], "SubnetGroupStatus": "Complete", "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default" }, "PendingModifiedValues": {}, "Endpoint": { "Address": "sample-cluster2.corcjozrlsfc.us-west-2.docdb.amazonaws.com", "HostedZoneId": "ZNKXH85TT8WVW", "Port": 27017 }, "EnabledCloudwatchLogsExports": [ "audit" ], "StorageEncrypted": false, "DbiResourceId": "db-A2GIKUV6KPOHITGGKI2NHVISZA", "AutoMinorVersionUpgrade": true, "Engine": "docdb", "InstanceCreateTime": "2019-03-15T20:36:06.338Z", "EngineVersion": "3.6.0", "PromotionTier": 5, "BackupRetentionPeriod": 7, "DBClusterIdentifier": "sample-cluster", "PreferredMaintenanceWindow": "mon:08:39-mon:09:09", "PubliclyAccessible": false, "DBInstanceClass": "db.r4.4xlarge", "AvailabilityZone": "us-west-2d", "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "DBInstanceStatus": "rebooting" } } ``` Weitere Informationen finden Sie unter Amazon DocumentDB [Rebooting an Amazon DocumentDB ILnstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-reboot.html) *Developer* Guide. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [RebootDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/reboot-db-instance.html).AWS CLI * ### `remove-tags-from-resource` Das folgende Codebeispiel zeigt die Verwendung`remove-tags-from-resource`. **AWS CLI** **So entfernen Sie Tags aus einer Amazon-DocumentDB-Ressource** Im folgenden Beispiel für `remove-tags-from-resource` wird das Tag mit dem Schlüssel namens `B` aus dem Amazon-DocumentDB-Cluster `sample-cluster` entfernt. ``` aws docdb remove-tags-from-resource \ --resource-name arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster \ --tag-keys B ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Entfernen von Tags aus einem Amazon-Dokument DBResource im Amazon](https://docs.aws.amazon.com/documentdb/latest/developerguide/tagging.html#tagging-remove) *DocumentDB-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [RemoveTagsFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/remove-tags-from-resource.html)in der *AWS CLI Befehlsreferenz.* ### `reset-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`reset-db-cluster-parameter-group`. **AWS CLI** **So setzen Sie den angegebenen Parameterwert in einer Amazon-DocumentDB-Parametergruppe auf den Standardwert zurück** Im folgenden Beispiel für `reset-db-cluster-parameter-group` wird der Parameter `ttl_monitor` in der Amazon-DocumentDB-Parametergruppe `custom3-6-param-grp` auf seinen Standardwert zurückgesetzt. ``` aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name custom3-6-param-grp \ --parameters ParameterName=ttl_monitor,ApplyMethod=immediate ``` Ausgabe: ``` { "DBClusterParameterGroupName": "custom3-6-param-grp" } ``` Weitere Informationen finden Sie unter dem entsprechenden Titel im *Entwicklerhandbuch für Amazon DocumentDB*. **So setzen Sie den angegebenen oder alle Parameterwerte in einer Amazon-DocumentDB-Parametergruppe auf die Standardwerte zurück** Im folgenden Beispiel für `reset-db-cluster-parameter-group` werden alle Parameter in der Amazon-DocumentDB-Parametergruppe `custom3-6-param-grp` auf ihren Standardwert zurückgesetzt. ``` aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name custom3-6-param-grp \ --reset-all-parameters ``` Ausgabe: ``` { "DBClusterParameterGroupName": "custom3-6-param-grp" } ``` Weitere Informationen finden Sie unter [Zurücksetzen einer Cluster-Parametergruppe von Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-parameter-group-reset.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [ResetDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/reset-db-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `restore-db-cluster-from-snapshot` Das folgende Codebeispiel zeigt die Verwendung`restore-db-cluster-from-snapshot`. **AWS CLI** **So stellen Sie einen Amazon-DocumentDB-Cluster aus einem automatischen oder manuellen Snapshot wieder her** Im folgenden Beispiel für `restore-db-cluster-from-snapshot` wird ein neuer Amazon-DocumentDB-Cluster mit dem Namen `sample-cluster-2019-03-16-00-01-restored` aus dem Snapshot `rds:sample-cluster-2019-03-16-00-01` erstellt. ``` aws docdb restore-db-cluster-from-snapshot \ --db-cluster-identifier sample-cluster-2019-03-16-00-01-restored \ --engine docdb \ --snapshot-identifier rds:sample-cluster-2019-03-16-00-01 ``` Ausgabe: ``` { "DBCluster": { "ClusterCreateTime": "2019-03-19T18:45:01.857Z", "HostedZoneId": "ZNKXH85TT8WVW", "Engine": "docdb", "DBClusterMembers": [], "MultiAZ": false, "AvailabilityZones": [ "us-west-2a", "us-west-2c", "us-west-2b" ], "StorageEncrypted": false, "ReaderEndpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Endpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Port": 27017, "PreferredBackupWindow": "00:00-00:30", "DBSubnetGroup": "default", "DBClusterIdentifier": "sample-cluster-2019-03-16-00-01-restored", "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster-2019-03-16-00-01-restored", "DBClusterParameterGroup": "default.docdb3.6", "DbClusterResourceId": "cluster-XOO46Q3RH4LWSYNH3NMZKXPISU", "MasterUsername": "master-user", "EngineVersion": "3.6.0", "BackupRetentionPeriod": 3, "AssociatedRoles": [], "Status": "creating", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ] } } ``` Weitere Informationen finden Sie unter [Wiederherstellen aus einem Cluster-Snapshot](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup-restore.restore-from-snapshot.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [RestoreDbClusterFromSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/restore-db-cluster-from-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `restore-db-cluster-to-point-in-time` Das folgende Codebeispiel zeigt die Verwendung`restore-db-cluster-to-point-in-time`. **AWS CLI** **So stellen Sie einen Amazon DocumentDB-Cluster point-in-time aus einem manuellen Snapshot wieder her** Im folgenden Beispiel für `restore-db-cluster-to-point-in-time` wird der `sample-cluster-snapshot` verwendet, um einen neuen Amazon-DocumentDB-Cluster, `sample-cluster-pit`, zu erstellen, wobei der letzte wiederherstellbare Zeitpunkt verwendet wird. ``` aws docdb restore-db-cluster-to-point-in-time \ --db-cluster-identifier sample-cluster-pit \ --source-db-cluster-identifier arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster \ --use-latest-restorable-time ``` Ausgabe: ``` { "DBCluster": { "StorageEncrypted": false, "BackupRetentionPeriod": 3, "MasterUsername": "master-user", "HostedZoneId": "ZNKXH85TT8WVW", "PreferredBackupWindow": "00:00-00:30", "MultiAZ": false, "DBClusterIdentifier": "sample-cluster-pit", "DBSubnetGroup": "default", "ClusterCreateTime": "2019-04-03T15:55:21.320Z", "AssociatedRoles": [], "DBClusterParameterGroup": "default.docdb3.6", "DBClusterMembers": [], "Status": "creating", "AvailabilityZones": [ "us-west-2a", "us-west-2d", "us-west-2b" ], "ReaderEndpoint": "sample-cluster-pit.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Port": 27017, "Engine": "docdb", "EngineVersion": "3.6.0", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "Endpoint": "sample-cluster-pit.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DbClusterResourceId": "cluster-NLCABBXOSE2QPQ4GOLZIFWEPLM", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster-pit" } } ``` Weitere Informationen finden Sie unter [Wiederherstellen eines Snapshots auf einen bestimmten Zeitpunkt](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup-restore.point-in-time-recovery.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [RestoreDbClusterToPointInTime](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/restore-db-cluster-to-point-in-time.html)in der *AWS CLI Befehlsreferenz.* ### `start-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`start-db-cluster`. **AWS CLI** **So starten Sie einen angehaltenen Amazon-DocumentDB-Cluster** Im folgenden Beispiel für `start-db-cluster` wird der angegebene Amazon-DocumentDB-Cluster gestartet. ``` aws docdb start-db-cluster \ --db-cluster-identifier sample-cluster ``` Ausgabe: ``` { "DBCluster": { "ClusterCreateTime": "2019-03-19T18:45:01.857Z", "HostedZoneId": "ZNKXH85TT8WVW", "Engine": "docdb", "DBClusterMembers": [], "MultiAZ": false, "AvailabilityZones": [ "us-east-1a", "us-east-1c", "us-east-1f" ], "StorageEncrypted": false, "ReaderEndpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-ro-corcjozrlsfc.us-east-1.docdb.amazonaws.com", "Endpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-corcjozrlsfc.us-east-1.docdb.amazonaws.com", "Port": 27017, "PreferredBackupWindow": "00:00-00:30", "DBSubnetGroup": "default", "DBClusterIdentifier": "sample-cluster-2019-03-16-00-01-restored", "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster-2019-03-16-00-01-restored", "DBClusterParameterGroup": "default.docdb3.6", "DbClusterResourceId": "cluster-XOO46Q3RH4LWSYNH3NMZKXPISU", "MasterUsername": "master-user", "EngineVersion": "3.6.0", "BackupRetentionPeriod": 3, "AssociatedRoles": [], "Status": "creating", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ] } } ``` Weitere Informationen finden Sie unter [Anhalten und Starten eines Amazon-DocumentDB-Clusters](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-stop-start.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [StartDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/start-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `stop-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`stop-db-cluster`. **AWS CLI** **So halten Sie einen laufenden Amazon-DocumentDB-Cluster an** Im folgenden Beispiel für `stop-db-cluster` wird der angegebene Amazon-DocumentDB-Cluster angehalten. ``` aws docdb stop-db-cluster \ --db-cluster-identifier sample-cluster ``` Ausgabe: ``` { "DBCluster": { "ClusterCreateTime": "2019-03-19T18:45:01.857Z", "HostedZoneId": "ZNKXH85TT8WVW", "Engine": "docdb", "DBClusterMembers": [], "MultiAZ": false, "AvailabilityZones": [ "us-east-1a", "us-east-1c", "us-east-1f" ], "StorageEncrypted": false, "ReaderEndpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-ro-corcjozrlsfc.us-east-1.docdb.amazonaws.com", "Endpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-corcjozrlsfc.us-east-1.docdb.amazonaws.com", "Port": 27017, "PreferredBackupWindow": "00:00-00:30", "DBSubnetGroup": "default", "DBClusterIdentifier": "sample-cluster-2019-03-16-00-01-restored", "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster-2019-03-16-00-01-restored", "DBClusterParameterGroup": "default.docdb3.6", "DbClusterResourceId": "cluster-XOO46Q3RH4LWSYNH3NMZKXPISU", "MasterUsername": "master-user", "EngineVersion": "3.6.0", "BackupRetentionPeriod": 3, "AssociatedRoles": [], "Status": "creating", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ] } } ``` Weitere Informationen finden Sie unter [Anhalten und Starten eines Amazon-DocumentDB-Clusters](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-stop-start.html) im *Entwicklerhandbuch für Amazon DocumentDB*. + Einzelheiten zur API finden Sie [StopDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/stop-db-cluster.html)in der *AWS CLI Befehlsreferenz*. # DynamoDB-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit DynamoDB Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-get-item` Das folgende Codebeispiel zeigt, wie Sie. `batch-get-item` **AWS CLI** **So rufen Sie mehrere Elemente aus einer Tabelle ab** Im folgenden Beispiel für `batch-get-items` werden mithilfe eines Batches von drei `GetItem`-Anfragen mehrere Elemente aus der `MusicCollection`-Tabelle gelesen und die Anzahl der durch den Vorgang verbrauchten Lesekapazitätseinheiten wird abgefragt. Der Befehl gibt nur das `AlbumTitle`-Attribut zurück. ``` aws dynamodb batch-get-item \ --request-items file://request-items.json \ --return-consumed-capacity TOTAL ``` Inhalt von `request-items.json`: ``` { "MusicCollection": { "Keys": [ { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"} }, { "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"} }, { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Scared of My Shadow"} } ], "ProjectionExpression":"AlbumTitle" } } ``` Ausgabe: ``` { "Responses": { "MusicCollection": [ { "AlbumTitle": { "S": "Somewhat Famous" } }, { "AlbumTitle": { "S": "Blue Sky Blues" } }, { "AlbumTitle": { "S": "Louder Than Ever" } } ] }, "UnprocessedKeys": {}, "ConsumedCapacity": [ { "TableName": "MusicCollection", "CapacityUnits": 1.5 } ] } ``` Weitere Informationen finden Sie unter [Batch-Vorgänge](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.BatchOperations) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [BatchGetItem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/batch-get-item.html)in der *AWS CLI Befehlsreferenz*. ### `batch-write-item` Das folgende Codebeispiel zeigt die Verwendung`batch-write-item`. **AWS CLI** **So fügen Sie mehrere Elemente einer Tabelle hinzu** Im folgenden Beispiel für `batch-write-item` werden der `MusicCollection`-Tabelle drei neue Elemente hinzugefügt, wobei ein Batch von drei `PutItem`-Anforderungen verwendet wird. Außerdem werden Informationen zur Anzahl der Schreibkapazitätseinheiten abgefragt, die von dem Vorgang verbraucht werden, sowie zu allen Elementsammlungen, die durch den Vorgang geändert werden. ``` aws dynamodb batch-write-item \ --request-items file://request-items.json \ --return-consumed-capacity INDEXES \ --return-item-collection-metrics SIZE ``` Inhalt von `request-items.json`: ``` { "MusicCollection": [ { "PutRequest": { "Item": { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"}, "AlbumTitle": {"S": "Somewhat Famous"} } } }, { "PutRequest": { "Item": { "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"}, "AlbumTitle": {"S": "Songs About Life"} } } }, { "PutRequest": { "Item": { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Scared of My Shadow"}, "AlbumTitle": {"S": "Blue Sky Blues"} } } } ] } ``` Ausgabe: ``` { "UnprocessedItems": {}, "ItemCollectionMetrics": { "MusicCollection": [ { "ItemCollectionKey": { "Artist": { "S": "No One You Know" } }, "SizeEstimateRangeGB": [ 0.0, 1.0 ] }, { "ItemCollectionKey": { "Artist": { "S": "Acme Band" } }, "SizeEstimateRangeGB": [ 0.0, 1.0 ] } ] }, "ConsumedCapacity": [ { "TableName": "MusicCollection", "CapacityUnits": 6.0, "Table": { "CapacityUnits": 3.0 }, "LocalSecondaryIndexes": { "AlbumTitleIndex": { "CapacityUnits": 3.0 } } } ] } ``` Weitere Informationen finden Sie unter [Batch-Vorgänge](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.BatchOperations) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [BatchWriteItem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/batch-write-item.html)in der *AWS CLI Befehlsreferenz*. ### `create-backup` Das folgende Codebeispiel zeigt die Verwendung`create-backup`. **AWS CLI** **So erstellen Sie eine Sicherung für eine vorhandene DynamoDB-Tabelle** Im folgenden Beispiel für `create-backup` wird ein Backup der `MusicCollection`-Tabelle erstellt. ``` aws dynamodb create-backup \ --table-name MusicCollection \ --backup-name MusicCollectionBackup ``` Ausgabe: ``` { "BackupDetails": { "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01576616366715-b4e58d3a", "BackupName": "MusicCollectionBackup", "BackupSizeBytes": 0, "BackupStatus": "CREATING", "BackupType": "USER", "BackupCreationDateTime": 1576616366.715 } } ``` Weitere Informationen finden Sie unter [On-Demand-Backup und -Wiederherstellung für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/BackupRestore.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [CreateBackup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/create-backup.html)in der *AWS CLI Befehlsreferenz*. ### `create-global-table` Das folgende Codebeispiel zeigt die Verwendung`create-global-table`. **AWS CLI** **So erstellen Sie eine globale Tabelle** Im folgenden `create-global-table` Beispiel wird eine globale Tabelle aus zwei identischen Tabellen in den angegebenen, separaten AWS Regionen erstellt. ``` aws dynamodb create-global-table \ --global-table-name MusicCollection \ --replication-group RegionName=us-east-2 RegionName=us-east-1 \ --region us-east-2 ``` Ausgabe: ``` { "GlobalTableDescription": { "ReplicationGroup": [ { "RegionName": "us-east-2" }, { "RegionName": "us-east-1" } ], "GlobalTableArn": "arn:aws:dynamodb::123456789012:global-table/MusicCollection", "CreationDateTime": 1576625818.532, "GlobalTableStatus": "CREATING", "GlobalTableName": "MusicCollection" } } ``` Weitere Informationen finden Sie unter [Globale DynamoDB-Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [CreateGlobalTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/create-global-table.html)unter *AWS CLI Befehlsreferenz*. ### `create-table` Das folgende Codebeispiel zeigt die Verwendung`create-table`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Tabelle mit Tags** Im folgenden Beispiel für `create-table` werden die angegebenen Attribute und das angegebene Schlüsselschema verwendet, um eine Tabelle mit dem Namen `MusicCollection` zu erstellen. Diese Tabelle verwendet den bereitgestellten Durchsatz und wird im Ruhezustand mit dem standardmäßigen AWS eigenen CMK verschlüsselt. Der Befehl weist der Tabelle außerdem ein Tag mit dem Schlüssel `Owner` und dem Wert `blueTeam` zu. ``` aws dynamodb create-table \ --table-name MusicCollection \ --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \ --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \ --tags Key=Owner,Value=blueTeam ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "WriteCapacityUnits": 5, "ReadCapacityUnits": 5 }, "TableSizeBytes": 0, "TableName": "MusicCollection", "TableStatus": "CREATING", "KeySchema": [ { "KeyType": "HASH", "AttributeName": "Artist" }, { "KeyType": "RANGE", "AttributeName": "SongTitle" } ], "ItemCount": 0, "CreationDateTime": "2020-05-26T16:04:41.627000-07:00", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } } ``` Weitere Informationen finden Sie unter [Grundlegende Operationen für Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 2: So erstellen Sie eine Tabelle im On-Demand-Modus** Im folgenden Beispiel wird mit dem On-Demand-Modus anstelle des bereitgestellten Durchsatzmodus eine Tabelle mit dem Namen `MusicCollection` erstellt. Dies ist nützlich für Tabellen mit unvorhersehbaren Workloads. ``` aws dynamodb create-table \ --table-name MusicCollection \ --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \ --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \ --billing-mode PAY_PER_REQUEST ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "TableName": "MusicCollection", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": "2020-05-27T11:44:10.807000-07:00", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 0, "WriteCapacityUnits": 0 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "BillingModeSummary": { "BillingMode": "PAY_PER_REQUEST" } } } ``` Weitere Informationen finden Sie unter [Grundlegende Operationen für Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 3: So erstellen Sie eine Tabelle und verschlüsseln sie mit einem kundenseitig verwalteten Schlüssel (Customer Managed Key; CMK).** Im folgenden Beispiel wird eine Tabelle mit dem Namen `MusicCollection` erstellt und mithilfe eines kundenseitig verwalteten Schlüssels (Customer Managed Key; CMK) verschlüsselt. ``` aws dynamodb create-table \ --table-name MusicCollection \ --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \ --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \ --sse-specification Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234 ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "TableName": "MusicCollection", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": "2020-05-27T11:12:16.431000-07:00", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 5, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "SSEDescription": { "Status": "ENABLED", "SSEType": "KMS", "KMSMasterKeyArn": "arn:aws:kms:us-west-2:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234" } } } ``` Weitere Informationen finden Sie unter [Grundlegende Operationen für Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Bespiel 4: So erstellen Sie eine Tabelle mit einem lokalen sekundären Index** Im folgenden Beispiel werden die angegebenen Attribute und das angegebene Schlüsselschema verwendet, um eine Tabelle namens `MusicCollection` mit dem lokalen sekundären Index `AlbumTitleIndex` zu erstellen. ``` aws dynamodb create-table \ --table-name MusicCollection \ --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S AttributeName=AlbumTitle,AttributeType=S \ --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \ --local-secondary-indexes \ "[ { \"IndexName\": \"AlbumTitleIndex\", \"KeySchema\": [ {\"AttributeName\": \"Artist\",\"KeyType\":\"HASH\"}, {\"AttributeName\": \"AlbumTitle\",\"KeyType\":\"RANGE\"} ], \"Projection\": { \"ProjectionType\": \"INCLUDE\", \"NonKeyAttributes\": [\"Genre\", \"Year\"] } } ]" ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "AlbumTitle", "AttributeType": "S" }, { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "TableName": "MusicCollection", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": "2020-05-26T15:59:49.473000-07:00", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "LocalSecondaryIndexes": [ { "IndexName": "AlbumTitleIndex", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "AlbumTitle", "KeyType": "RANGE" } ], "Projection": { "ProjectionType": "INCLUDE", "NonKeyAttributes": [ "Genre", "Year" ] }, "IndexSizeBytes": 0, "ItemCount": 0, "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/index/AlbumTitleIndex" } ] } } ``` Weitere Informationen finden Sie unter [Grundlegende Operationen für Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 5: So erstellen Sie eine Tabelle mit einem globalen sekundären Index** Im folgenden Beispiel wird eine Tabelle mit dem Namen `GameScores` mit einem globalen sekundären Index namens `GameTitleIndex` erstellt. Die Basistabelle hat einen Partitionsschlüssel von `UserId` und einen Sortierschlüssel von `GameTitle`, mit dem Sie effizient die beste Punktzahl eines einzelnen Benutzers für ein bestimmtes Spiel finden können, während die GSI einen Partitionsschlüssel von `GameTitle` und einen Sortierschlüssel von `TopScore` hat, mit dem Sie finden Sie schnell die höchste Gesamtpunktzahl für ein bestimmtes Spiel. ``` aws dynamodb create-table \ --table-name GameScores \ --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S AttributeName=TopScore,AttributeType=N \ --key-schema AttributeName=UserId,KeyType=HASH \ AttributeName=GameTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \ --global-secondary-indexes \ "[ { \"IndexName\": \"GameTitleIndex\", \"KeySchema\": [ {\"AttributeName\":\"GameTitle\",\"KeyType\":\"HASH\"}, {\"AttributeName\":\"TopScore\",\"KeyType\":\"RANGE\"} ], \"Projection\": { \"ProjectionType\":\"INCLUDE\", \"NonKeyAttributes\":[\"UserId\"] }, \"ProvisionedThroughput\": { \"ReadCapacityUnits\": 10, \"WriteCapacityUnits\": 5 } } ]" ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "GameTitle", "AttributeType": "S" }, { "AttributeName": "TopScore", "AttributeType": "N" }, { "AttributeName": "UserId", "AttributeType": "S" } ], "TableName": "GameScores", "KeySchema": [ { "AttributeName": "UserId", "KeyType": "HASH" }, { "AttributeName": "GameTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": "2020-05-26T17:28:15.602000-07:00", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "GlobalSecondaryIndexes": [ { "IndexName": "GameTitleIndex", "KeySchema": [ { "AttributeName": "GameTitle", "KeyType": "HASH" }, { "AttributeName": "TopScore", "KeyType": "RANGE" } ], "Projection": { "ProjectionType": "INCLUDE", "NonKeyAttributes": [ "UserId" ] }, "IndexStatus": "CREATING", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 }, "IndexSizeBytes": 0, "ItemCount": 0, "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/index/GameTitleIndex" } ] } } ``` Weitere Informationen finden Sie unter [Grundlegende Operationen für Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 6: So erstellen Sie eine Tabelle mit mehreren globalen sekundären Indizes gleichzeitig** Im folgenden Beispiel wird eine Tabelle namens `GameScores` mit zwei globalen sekundären Indizes erstellt. Die GSI-Schemas werden über eine Datei und nicht über die Befehlszeile übergeben. ``` aws dynamodb create-table \ --table-name GameScores \ --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S AttributeName=TopScore,AttributeType=N AttributeName=Date,AttributeType=S \ --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \ --global-secondary-indexes file://gsi.json ``` Inhalt von `gsi.json`: ``` [ { "IndexName": "GameTitleIndex", "KeySchema": [ { "AttributeName": "GameTitle", "KeyType": "HASH" }, { "AttributeName": "TopScore", "KeyType": "RANGE" } ], "Projection": { "ProjectionType": "ALL" }, "ProvisionedThroughput": { "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 } }, { "IndexName": "GameDateIndex", "KeySchema": [ { "AttributeName": "GameTitle", "KeyType": "HASH" }, { "AttributeName": "Date", "KeyType": "RANGE" } ], "Projection": { "ProjectionType": "ALL" }, "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 5 } } ] ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "Date", "AttributeType": "S" }, { "AttributeName": "GameTitle", "AttributeType": "S" }, { "AttributeName": "TopScore", "AttributeType": "N" }, { "AttributeName": "UserId", "AttributeType": "S" } ], "TableName": "GameScores", "KeySchema": [ { "AttributeName": "UserId", "KeyType": "HASH" }, { "AttributeName": "GameTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": "2020-08-04T16:40:55.524000-07:00", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "GlobalSecondaryIndexes": [ { "IndexName": "GameTitleIndex", "KeySchema": [ { "AttributeName": "GameTitle", "KeyType": "HASH" }, { "AttributeName": "TopScore", "KeyType": "RANGE" } ], "Projection": { "ProjectionType": "ALL" }, "IndexStatus": "CREATING", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 }, "IndexSizeBytes": 0, "ItemCount": 0, "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/index/GameTitleIndex" }, { "IndexName": "GameDateIndex", "KeySchema": [ { "AttributeName": "GameTitle", "KeyType": "HASH" }, { "AttributeName": "Date", "KeyType": "RANGE" } ], "Projection": { "ProjectionType": "ALL" }, "IndexStatus": "CREATING", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 5, "WriteCapacityUnits": 5 }, "IndexSizeBytes": 0, "ItemCount": 0, "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/index/GameDateIndex" } ] } } ``` Weitere Informationen finden Sie unter [Grundlegende Operationen für Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 7: So erstellen Sie eine Tabelle mit aktivierten Streams** Im folgenden Beispiel wird die Tabelle `GameScores` mit aktiviertem DynamoDB Streams aufgerufen. Sowohl neue als auch alte Images von jedem Element werden in den Stream geschrieben. ``` aws dynamodb create-table \ --table-name GameScores \ --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S \ --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \ --stream-specification StreamEnabled=TRUE,StreamViewType=NEW_AND_OLD_IMAGES ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "GameTitle", "AttributeType": "S" }, { "AttributeName": "UserId", "AttributeType": "S" } ], "TableName": "GameScores", "KeySchema": [ { "AttributeName": "UserId", "KeyType": "HASH" }, { "AttributeName": "GameTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": "2020-05-27T10:49:34.056000-07:00", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "StreamSpecification": { "StreamEnabled": true, "StreamViewType": "NEW_AND_OLD_IMAGES" }, "LatestStreamLabel": "2020-05-27T17:49:34.056", "LatestStreamArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/stream/2020-05-27T17:49:34.056" } } ``` Weitere Informationen finden Sie unter [Grundlegende Operationen für Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 8: So erstellen Sie eine Tabelle mit aktiviertem Keys-Only-Stream** Im folgenden Beispiel wird die Tabelle `GameScores` mit aktiviertem DynamoDB Streams aufgerufen. Nur die Schlüsselattribute von geänderten Elementen werden in den Stream geschrieben. ``` aws dynamodb create-table \ --table-name GameScores \ --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S \ --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \ --stream-specification StreamEnabled=TRUE,StreamViewType=KEYS_ONLY ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "GameTitle", "AttributeType": "S" }, { "AttributeName": "UserId", "AttributeType": "S" } ], "TableName": "GameScores", "KeySchema": [ { "AttributeName": "UserId", "KeyType": "HASH" }, { "AttributeName": "GameTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": "2023-05-25T18:45:34.140000+00:00", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "StreamSpecification": { "StreamEnabled": true, "StreamViewType": "KEYS_ONLY" }, "LatestStreamLabel": "2023-05-25T18:45:34.140", "LatestStreamArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/stream/2023-05-25T18:45:34.140", "DeletionProtectionEnabled": false } } ``` Weitere Informationen finden Sie unter [Ändern der Datenerfassung für DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 9: So erstellen Sie eine Tabelle mit der Klasse Standard Infrequent Access** Im folgenden Beispiel wird eine Tabelle mit dem Namen `GameScores` erstellt und die Tabellenklasse Standard-Infrequent Access (DynamoDB Standard-IA) zugewiesen. Diese Tabellenklasse ist dafür optimiert, dass Speicher der Hauptkostenfaktor ist. ``` aws dynamodb create-table \ --table-name GameScores \ --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S \ --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \ --table-class STANDARD_INFREQUENT_ACCESS ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "GameTitle", "AttributeType": "S" }, { "AttributeName": "UserId", "AttributeType": "S" } ], "TableName": "GameScores", "KeySchema": [ { "AttributeName": "UserId", "KeyType": "HASH" }, { "AttributeName": "GameTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": "2023-05-25T18:33:07.581000+00:00", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TableClassSummary": { "TableClass": "STANDARD_INFREQUENT_ACCESS" }, "DeletionProtectionEnabled": false } } ``` Weitere Informationen finden Sie unter [Tabellenklassen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.TableClasses.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 10: So erstellen Sie eine Tabelle mit aktiviertem Löschschutz** Im folgenden Beispiel wird eine Tabelle mit dem Namen `GameScores` erstellt und der Löschschutz aktiviert. ``` aws dynamodb create-table \ --table-name GameScores \ --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S \ --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \ --deletion-protection-enabled ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "GameTitle", "AttributeType": "S" }, { "AttributeName": "UserId", "AttributeType": "S" } ], "TableName": "GameScores", "KeySchema": [ { "AttributeName": "UserId", "KeyType": "HASH" }, { "AttributeName": "GameTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": "2023-05-25T23:02:17.093000+00:00", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeletionProtectionEnabled": true } } ``` Weitere Informationen finden Sie unter [Verwenden des Löschschutzes](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.DeletionProtection) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie unter [CreateTable AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/create-table.html)*Befehlsreferenz*. ### `delete-backup` Das folgende Codebeispiel zeigt die Verwendung`delete-backup`. **AWS CLI** **So löschen Sie ein vorhandenes DynamoDB-Backup** Im folgenden Beispiel für `delete-backup` wird die angegebene Sicherung gelöscht. ``` aws dynamodb delete-backup \ --backup-arn arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01576616366715-b4e58d3a ``` Ausgabe: ``` { "BackupDescription": { "BackupDetails": { "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01576616366715-b4e58d3a", "BackupName": "MusicCollectionBackup", "BackupSizeBytes": 0, "BackupStatus": "DELETED", "BackupType": "USER", "BackupCreationDateTime": 1576616366.715 }, "SourceTableDetails": { "TableName": "MusicCollection", "TableId": "b0c04bcc-309b-4352-b2ae-9088af169fe2", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableSizeBytes": 0, "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableCreationDateTime": 1576615228.571, "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 5 }, "ItemCount": 0, "BillingMode": "PROVISIONED" }, "SourceTableFeatureDetails": {} } } ``` Weitere Informationen finden Sie unter [On-Demand-Backup und -Wiederherstellung für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/BackupRestore.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DeleteBackup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/delete-backup.html)in der *AWS CLI Befehlsreferenz*. ### `delete-item` Das folgende Codebeispiel zeigt die Verwendung`delete-item`. **AWS CLI** **Beispiel 1: So löschen Sie ein Element** Im folgenden Beispiel für `delete-item` wird ein Element aus der `MusicCollection`-Tabelle gelöscht und es werden Details zu dem gelöschten Element und der von der Anforderung verwendeten Kapazität angefordert. ``` aws dynamodb delete-item \ --table-name MusicCollection \ --key file://key.json \ --return-values ALL_OLD \ --return-consumed-capacity TOTAL \ --return-item-collection-metrics SIZE ``` Inhalt von `key.json`: ``` { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Scared of My Shadow"} } ``` Ausgabe: ``` { "Attributes": { "AlbumTitle": { "S": "Blue Sky Blues" }, "Artist": { "S": "No One You Know" }, "SongTitle": { "S": "Scared of My Shadow" } }, "ConsumedCapacity": { "TableName": "MusicCollection", "CapacityUnits": 2.0 }, "ItemCollectionMetrics": { "ItemCollectionKey": { "Artist": { "S": "No One You Know" } }, "SizeEstimateRangeGB": [ 0.0, 1.0 ] } } ``` Weitere Informationen finden Sie unter [Schreiben eines Elements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.WritingData) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 2: So löschen Sie ein Element bedingungsabhängig** Im folgenden Beispiel wird ein Element nur dann aus der `ProductCatalog`-Tabelle gelöscht, wenn `ProductCategory` entweder `Sporting Goods` oder `Gardening Supplies` ist und der Preis zwischen 500 und 600 liegt. Es werden Details zu dem gelöschten Element zurückgegeben. ``` aws dynamodb delete-item \ --table-name ProductCatalog \ --key '{"Id":{"N":"456"}}' \ --condition-expression "(ProductCategory IN (:cat1, :cat2)) and (#P between :lo and :hi)" \ --expression-attribute-names file://names.json \ --expression-attribute-values file://values.json \ --return-values ALL_OLD ``` Inhalt von `names.json`: ``` { "#P": "Price" } ``` Inhalt von `values.json`: ``` { ":cat1": {"S": "Sporting Goods"}, ":cat2": {"S": "Gardening Supplies"}, ":lo": {"N": "500"}, ":hi": {"N": "600"} } ``` Ausgabe: ``` { "Attributes": { "Id": { "N": "456" }, "Price": { "N": "550" }, "ProductCategory": { "S": "Sporting Goods" } } } ``` Weitere Informationen finden Sie unter [Schreiben eines Elements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.WritingData) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DeleteItem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/delete-item.html)in der *AWS CLI Befehlsreferenz*. ### `delete-table` Das folgende Codebeispiel zeigt die Verwendung`delete-table`. **AWS CLI** **So löschen Sie eine Tabelle** Im folgenden Beispiel für `delete-table` wird die Tabelle `MusicCollection` gelöscht. ``` aws dynamodb delete-table \ --table-name MusicCollection ``` Ausgabe: ``` { "TableDescription": { "TableStatus": "DELETING", "TableSizeBytes": 0, "ItemCount": 0, "TableName": "MusicCollection", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "WriteCapacityUnits": 5, "ReadCapacityUnits": 5 } } } ``` Weitere Informationen finden Sie unter [Löschen einer Tabelle](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.DeleteTable) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DeleteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/delete-table.html)in der *AWS CLI Befehlsreferenz*. ### `describe-backup` Das folgende Codebeispiel zeigt die Verwendung`describe-backup`. **AWS CLI** **So rufen Sie Informationen über ein bestehendes Backup aus einer Tabelle ab** Im folgenden Beispiel für `describe-backup` werden Informationen zum angegebenen Backup angezeigt. ``` aws dynamodb describe-backup \ --backup-arn arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01576616366715-b4e58d3a ``` Ausgabe: ``` { "BackupDescription": { "BackupDetails": { "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01576616366715-b4e58d3a", "BackupName": "MusicCollectionBackup", "BackupSizeBytes": 0, "BackupStatus": "AVAILABLE", "BackupType": "USER", "BackupCreationDateTime": 1576616366.715 }, "SourceTableDetails": { "TableName": "MusicCollection", "TableId": "b0c04bcc-309b-4352-b2ae-9088af169fe2", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableSizeBytes": 0, "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableCreationDateTime": 1576615228.571, "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 5 }, "ItemCount": 0, "BillingMode": "PROVISIONED" }, "SourceTableFeatureDetails": {} } } ``` Weitere Informationen finden Sie unter [On-Demand-Backup und -Wiederherstellung für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/BackupRestore.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeBackup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-backup.html)in der *AWS CLI Befehlsreferenz*. ### `describe-continuous-backups` Das folgende Codebeispiel zeigt die Verwendung`describe-continuous-backups`. **AWS CLI** **So rufen Sie Informationen über kontinuierliche Backups für eine DynamoDB-Tabelle ab** Im folgenden Beispiel für `describe-continuous-backups` werden Details zu den Einstellungen für kontinuierliche Backups für die `MusicCollection`-Tabelle angezeigt. ``` aws dynamodb describe-continuous-backups \ --table-name MusicCollection ``` Ausgabe: ``` { "ContinuousBackupsDescription": { "ContinuousBackupsStatus": "ENABLED", "PointInTimeRecoveryDescription": { "PointInTimeRecoveryStatus": "DISABLED" } } } ``` Weitere Informationen finden Sie unter [Point-in-Time Recovery for DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PointInTimeRecovery.html) im *Amazon DynamoDB Developer Guide*. + *Einzelheiten zur API finden Sie unter [DescribeContinuousBackups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-continuous-backups.html)Befehlsreferenz.AWS CLI * ### `describe-contributor-insights` Das folgende Codebeispiel zeigt die Verwendung`describe-contributor-insights`. **AWS CLI** **So zeigen Sie Contributor-Insights-Einstellungen für eine DynamoDB-Tabelle an** Im folgenden Beispiel für `describe-contributor-insights` werden die Contributor-Insights-Einstellungen für die `MusicCollection`-Tabelle und den globalen sekundären Index `AlbumTitle-index` angezeigt. ``` aws dynamodb describe-contributor-insights \ --table-name MusicCollection \ --index-name AlbumTitle-index ``` Ausgabe: ``` { "TableName": "MusicCollection", "IndexName": "AlbumTitle-index", "ContributorInsightsRuleList": [ "DynamoDBContributorInsights-PKC-MusicCollection-1576629651520", "DynamoDBContributorInsights-SKC-MusicCollection-1576629651520", "DynamoDBContributorInsights-PKT-MusicCollection-1576629651520", "DynamoDBContributorInsights-SKT-MusicCollection-1576629651520" ], "ContributorInsightsStatus": "ENABLED", "LastUpdateDateTime": 1576629654.78 } ``` Weitere Informationen finden Sie unter [Analysieren des Datenzugriffs mithilfe von CloudWatch Contributor Insights for DynamoDB im *Amazon DynamoDB*](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/contributorinsights.html) Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [DescribeContributorInsights](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-contributor-insights.html)AWS CLI * ### `describe-endpoints` Das folgende Codebeispiel zeigt die Verwendung`describe-endpoints`. **AWS CLI** **So zeigen Sie regionale Endpunktinformationen an** Im folgenden `describe-endpoints` Beispiel werden Details zu den Endpunkten für die aktuelle AWS Region angezeigt. ``` aws dynamodb describe-endpoints ``` Ausgabe: ``` { "Endpoints": [ { "Address": "dynamodb.us-west-2.amazonaws.com", "CachePeriodInMinutes": 1440 } ] } ``` Weitere Informationen finden Sie unter [Endpunkte und Kontingente von Amazon DynamoDB](https://docs.aws.amazon.com/general/latest/gr/ddb.html) in der *Allgemeinen Referenz zu AWS *. + Einzelheiten zur API finden Sie unter [DescribeEndpoints AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-endpoints.html)*Befehlsreferenz.* ### `describe-global-table-settings` Das folgende Codebeispiel zeigt die Verwendung`describe-global-table-settings`. **AWS CLI** **So rufen Sie Informationen über die Einstellungen einer globalen DynamoDB-Tabelle ab** Im folgenden Beispiel für `describe-global-table-settings` werden die Einstellungen für die globale `MusicCollection`-Tabelle angezeigt. ``` aws dynamodb describe-global-table-settings \ --global-table-name MusicCollection ``` Ausgabe: ``` { "GlobalTableName": "MusicCollection", "ReplicaSettings": [ { "RegionName": "us-east-1", "ReplicaStatus": "ACTIVE", "ReplicaProvisionedReadCapacityUnits": 10, "ReplicaProvisionedReadCapacityAutoScalingSettings": { "AutoScalingDisabled": true }, "ReplicaProvisionedWriteCapacityUnits": 5, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "AutoScalingDisabled": true } }, { "RegionName": "us-east-2", "ReplicaStatus": "ACTIVE", "ReplicaProvisionedReadCapacityUnits": 10, "ReplicaProvisionedReadCapacityAutoScalingSettings": { "AutoScalingDisabled": true }, "ReplicaProvisionedWriteCapacityUnits": 5, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "AutoScalingDisabled": true } } ] } ``` Weitere Informationen finden Sie unter [Globale DynamoDB-Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeGlobalTableSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-global-table-settings.html)in der *AWS CLI Befehlsreferenz*. ### `describe-global-table` Das folgende Codebeispiel zeigt die Verwendung`describe-global-table`. **AWS CLI** **So zeigen Sie Informationen zu einer globalen DynamoDB-Tabelle an** Im folgenden Beispiel für `describe-global-table` werden Details zur globalen `MusicCollection`-Tabelle angezeigt. ``` aws dynamodb describe-global-table \ --global-table-name MusicCollection ``` Ausgabe: ``` { "GlobalTableDescription": { "ReplicationGroup": [ { "RegionName": "us-east-2" }, { "RegionName": "us-east-1" } ], "GlobalTableArn": "arn:aws:dynamodb::123456789012:global-table/MusicCollection", "CreationDateTime": 1576625818.532, "GlobalTableStatus": "ACTIVE", "GlobalTableName": "MusicCollection" } } ``` Weitere Informationen finden Sie unter [Globale DynamoDB-Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeGlobalTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-global-table.html)in der *AWS CLI Befehlsreferenz*. ### `describe-limits` Das folgende Codebeispiel zeigt die Verwendung`describe-limits`. **AWS CLI** **So zeigen Sie die Limits für die bereitgestellte Kapazität an** Im folgenden `describe-limits` Beispiel werden die bereitgestellten Kapazitätsgrenzen für Ihr Konto in der aktuellen Region angezeigt. AWS ``` aws dynamodb describe-limits ``` Ausgabe: ``` { "AccountMaxReadCapacityUnits": 80000, "AccountMaxWriteCapacityUnits": 80000, "TableMaxReadCapacityUnits": 40000, "TableMaxWriteCapacityUnits": 40000 } ``` Weitere Informationen finden Sie unter [Limits in DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + *Einzelheiten zur API finden Sie [DescribeLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-limits.html)in AWS CLI der Befehlsreferenz.* ### `describe-table-replica-auto-scaling` Das folgende Codebeispiel zeigt die Verwendung`describe-table-replica-auto-scaling`. **AWS CLI** **So zeigen Sie Auto-Scaling-Einstellungen für Replikate einer globalen Tabelle an** Im folgenden Beispiel für `describe-table-replica-auto-scaling` werden Auto-Scaling-Einstellungen für alle Replikate der globalen `MusicCollection`-Tabelle angezeigt. ``` aws dynamodb describe-table-replica-auto-scaling \ --table-name MusicCollection ``` Ausgabe: ``` { "TableAutoScalingDescription": { "TableName": "MusicCollection", "TableStatus": "ACTIVE", "Replicas": [ { "RegionName": "us-east-1", "GlobalSecondaryIndexes": [], "ReplicaProvisionedReadCapacityAutoScalingSettings": { "MinimumUnits": 5, "MaximumUnits": 40000, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBReadCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 70.0 } } ] }, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "MinimumUnits": 5, "MaximumUnits": 40000, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBWriteCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 70.0 } } ] }, "ReplicaStatus": "ACTIVE" }, { "RegionName": "us-east-2", "GlobalSecondaryIndexes": [], "ReplicaProvisionedReadCapacityAutoScalingSettings": { "MinimumUnits": 5, "MaximumUnits": 40000, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBReadCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 70.0 } } ] }, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "MinimumUnits": 5, "MaximumUnits": 40000, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBWriteCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 70.0 } } ] }, "ReplicaStatus": "ACTIVE" } ] } } ``` Weitere Informationen finden Sie unter [Globale DynamoDB-Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeTableReplicaAutoScaling](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-table-replica-auto-scaling.html)in der *AWS CLI Befehlsreferenz*. ### `describe-table` Das folgende Codebeispiel zeigt die Verwendung`describe-table`. **AWS CLI** **So beschreiben Sie eine Tabelle** Im folgenden Beispiel für `describe-table` wird die `MusicCollection`-Tabelle beschrieben. ``` aws dynamodb describe-table \ --table-name MusicCollection ``` Ausgabe: ``` { "Table": { "AttributeDefinitions": [ { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "WriteCapacityUnits": 5, "ReadCapacityUnits": 5 }, "TableSizeBytes": 0, "TableName": "MusicCollection", "TableStatus": "ACTIVE", "KeySchema": [ { "KeyType": "HASH", "AttributeName": "Artist" }, { "KeyType": "RANGE", "AttributeName": "SongTitle" } ], "ItemCount": 0, "CreationDateTime": 1421866952.062 } } ``` Weitere Informationen finden Sie unter [Beschreiben einer Tabelle](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.DescribeTable) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-table.html)in der *AWS CLI Befehlsreferenz*. ### `describe-time-to-live` Das folgende Codebeispiel zeigt die Verwendung`describe-time-to-live`. **AWS CLI** **So zeigen Sie Time-to-Live-Einstellungen für eine Tabelle an** Im folgenden Beispiel für `describe-time-to-live` werden die Time-to-Live-Einstellungen für die `MusicCollection`-Tabelle angezeigt. ``` aws dynamodb describe-time-to-live \ --table-name MusicCollection ``` Ausgabe: ``` { "TimeToLiveDescription": { "TimeToLiveStatus": "ENABLED", "AttributeName": "ttl" } } ``` Weitere Informationen finden Sie unter [Time to Live](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/TTL.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeTimeToLive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/describe-time-to-live.html)in der *AWS CLI Befehlsreferenz*. ### `get-item` Das folgende Codebeispiel zeigt die Verwendung`get-item`. **AWS CLI** **Beispiel 1: So lesen Sie ein Element in einer Tabelle** Das folgende Beispiel für `get-item` ruft ein Element aus der `MusicCollection`-Tabelle ab. Die Tabelle hat einen hash-and-range Primärschlüssel (`Artist`und`SongTitle`), daher müssen Sie diese beiden Attribute angeben. Der Befehl fragt auch Informationen über die Lesekapazität ab, die von der Operation verbraucht wird. ``` aws dynamodb get-item \ --table-name MusicCollection \ --key file://key.json \ --return-consumed-capacity TOTAL ``` Inhalt von `key.json`: ``` { "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"} } ``` Ausgabe: ``` { "Item": { "AlbumTitle": { "S": "Songs About Life" }, "SongTitle": { "S": "Happy Day" }, "Artist": { "S": "Acme Band" } }, "ConsumedCapacity": { "TableName": "MusicCollection", "CapacityUnits": 0.5 } } ``` Weitere Informationen finden Sie unter [Lesen eines Elements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.ReadingData) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 2: So lesen Sie ein Element mit einem konsistenten Lesevorgang** Das folgende Beispiel ruft mithilfe von strikt konsistenten Lesevorgängen ein Element aus der `MusicCollection`-Tabelle ab. ``` aws dynamodb get-item \ --table-name MusicCollection \ --key file://key.json \ --consistent-read \ --return-consumed-capacity TOTAL ``` Inhalt von `key.json`: ``` { "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"} } ``` Ausgabe: ``` { "Item": { "AlbumTitle": { "S": "Songs About Life" }, "SongTitle": { "S": "Happy Day" }, "Artist": { "S": "Acme Band" } }, "ConsumedCapacity": { "TableName": "MusicCollection", "CapacityUnits": 1.0 } } ``` Weitere Informationen finden Sie unter [Lesen eines Elements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.ReadingData) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 3: So rufen Sie bestimmte Attribute eines Elements ab** Im folgenden Beispiel wird ein Projektionsausdruck verwendet, um nur drei Attribute des gewünschten Elements abzurufen. ``` aws dynamodb get-item \ --table-name ProductCatalog \ --key '{"Id": {"N": "102"}}' \ --projection-expression "#T, #C, #P" \ --expression-attribute-names file://names.json ``` Inhalt von `names.json`: ``` { "#T": "Title", "#C": "ProductCategory", "#P": "Price" } ``` Ausgabe: ``` { "Item": { "Price": { "N": "20" }, "Title": { "S": "Book 102 Title" }, "ProductCategory": { "S": "Book" } } } ``` Weitere Informationen finden Sie unter [Lesen eines Elements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.ReadingData) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [GetItem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/get-item.html)unter *AWS CLI Befehlsreferenz*. ### `list-backups` Das folgende Codebeispiel zeigt die Verwendung`list-backups`. **AWS CLI** **Beispiel 1: So listen Sie alle vorhandenen DynamoDB-Sicherungen auf** Im folgenden Beispiel für `list-backups` werden alle vorhandenen Sicherungen aufgeführt. ``` aws dynamodb list-backups ``` Ausgabe: ``` { "BackupSummaries": [ { "TableName": "MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01234567890123-a1bcd234", "BackupName": "MusicCollectionBackup1", "BackupCreationDateTime": "2020-02-12T14:41:51.617000-08:00", "BackupStatus": "AVAILABLE", "BackupType": "USER", "BackupSizeBytes": 170 }, { "TableName": "MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01234567890123-b2abc345", "BackupName": "MusicCollectionBackup2", "BackupCreationDateTime": "2020-06-26T11:08:35.431000-07:00", "BackupStatus": "AVAILABLE", "BackupType": "USER", "BackupSizeBytes": 400 } ] } ``` Weitere Informationen finden Sie unter [On-Demand-Backup und -Wiederherstellung für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/BackupRestore.html) im *Entwicklerhandbuch für Amazon DynamoDB*. **Beispiel 2: So listen Sie von Benutzern erstellte Sicherungen in einem bestimmten Zeitraum auf** Im folgenden Beispiel werden nur Sicherungen der `MusicCollection`-Tabelle aufgeführt, die vom Benutzer (nicht automatisch von DynamoDB) erstellt wurden und deren Erstellungsdatum zwischen dem 1. Januar 2020 und dem 1. März 2020 liegt. ``` aws dynamodb list-backups \ --table-name MusicCollection \ --time-range-lower-bound 1577836800 \ --time-range-upper-bound 1583020800 \ --backup-type USER ``` Ausgabe: ``` { "BackupSummaries": [ { "TableName": "MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01234567890123-a1bcd234", "BackupName": "MusicCollectionBackup1", "BackupCreationDateTime": "2020-02-12T14:41:51.617000-08:00", "BackupStatus": "AVAILABLE", "BackupType": "USER", "BackupSizeBytes": 170 } ] } ``` Weitere Informationen finden Sie unter [On-Demand-Backup und -Wiederherstellung für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/BackupRestore.html) im *Entwicklerhandbuch für Amazon DynamoDB*. **Beispiel 3: So begrenzen Sie die Seitengröße** Das folgende Beispiel gibt eine Liste aller vorhandenen Sicherungen zurück, ruft jedoch bei jedem Aufruf nur ein Element ab und führt gegebenenfalls mehrere Aufrufe durch, um die gesamte Liste abzurufen. Die Begrenzung der Seitengröße ist nützlich, wenn Listenbefehle für eine große Anzahl von Ressourcen ausgeführt werden, was zu einem Timeout-Fehler führen kann, wenn die Standardseitengröße von 1 000 verwendet wird. ``` aws dynamodb list-backups \ --page-size 1 ``` Ausgabe: ``` { "BackupSummaries": [ { "TableName": "MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01234567890123-a1bcd234", "BackupName": "MusicCollectionBackup1", "BackupCreationDateTime": "2020-02-12T14:41:51.617000-08:00", "BackupStatus": "AVAILABLE", "BackupType": "USER", "BackupSizeBytes": 170 }, { "TableName": "MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01234567890123-b2abc345", "BackupName": "MusicCollectionBackup2", "BackupCreationDateTime": "2020-06-26T11:08:35.431000-07:00", "BackupStatus": "AVAILABLE", "BackupType": "USER", "BackupSizeBytes": 400 } ] } ``` Weitere Informationen finden Sie unter [On-Demand-Backup und -Wiederherstellung für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/BackupRestore.html) im *Entwicklerhandbuch für Amazon DynamoDB*. **Beispiel 4: So begrenzen Sie die Anzahl der zurückgegebenen Elemente** Im folgenden Beispiel wird die Anzahl der zurückgegebenen Elemente auf 1 begrenzt. Die Antwort enthält einen `NextToken`-Wert, mit dem die nächste Ergebnisseite abgerufen werden kann. ``` aws dynamodb list-backups \ --max-items 1 ``` Ausgabe: ``` { "BackupSummaries": [ { "TableName": "MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01234567890123-a1bcd234", "BackupName": "MusicCollectionBackup1", "BackupCreationDateTime": "2020-02-12T14:41:51.617000-08:00", "BackupStatus": "AVAILABLE", "BackupType": "USER", "BackupSizeBytes": 170 } ], "NextToken": "abCDeFGhiJKlmnOPqrSTuvwxYZ1aBCdEFghijK7LM51nOpqRSTuv3WxY3ZabC5dEFGhI2Jk3LmnoPQ6RST9" } ``` Weitere Informationen finden Sie unter [On-Demand-Backup und -Wiederherstellung für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/BackupRestore.html) im *Entwicklerhandbuch für Amazon DynamoDB*. **Beispiel 5: So rufen Sie die nächste Ergebnisseite ab** Der folgende Befehl verwendet den `NextToken`-Wert eines vorherigen Aufrufs des `list-backups`-Befehls, um eine weitere Ergebnisseite abzurufen. Da die Antwort in diesem Fall keinen `NextToken`-Wert enthält, wissen wir, dass wir das Ende der Ergebnisse erreicht haben. ``` aws dynamodb list-backups \ --starting-token abCDeFGhiJKlmnOPqrSTuvwxYZ1aBCdEFghijK7LM51nOpqRSTuv3WxY3ZabC5dEFGhI2Jk3LmnoPQ6RST9 ``` Ausgabe ``` { "BackupSummaries": [ { "TableName": "MusicCollection", "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "BackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01234567890123-b2abc345", "BackupName": "MusicCollectionBackup2", "BackupCreationDateTime": "2020-06-26T11:08:35.431000-07:00", "BackupStatus": "AVAILABLE", "BackupType": "USER", "BackupSizeBytes": 400 } ] } ``` Weitere Informationen finden Sie unter [On-Demand-Backup und -Wiederherstellung für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/BackupRestore.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [ListBackups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/list-backups.html)in der *AWS CLI Befehlsreferenz*. ### `list-contributor-insights` Das folgende Codebeispiel zeigt die Verwendung`list-contributor-insights`. **AWS CLI** **Beispiel 1: So zeigen Sie eine Liste mit Contributor-Insights-Zusammenfassungen an** Im folgenden Beispiel für `list-contributor-insights` wird eine Liste der Contributor-Insights-Zusammenfassungen angezeigt. ``` aws dynamodb list-contributor-insights ``` Ausgabe: ``` { "ContributorInsightsSummaries": [ { "TableName": "MusicCollection", "IndexName": "AlbumTitle-index", "ContributorInsightsStatus": "ENABLED" }, { "TableName": "ProductCatalog", "ContributorInsightsStatus": "ENABLED" }, { "TableName": "Forum", "ContributorInsightsStatus": "ENABLED" }, { "TableName": "Reply", "ContributorInsightsStatus": "ENABLED" }, { "TableName": "Thread", "ContributorInsightsStatus": "ENABLED" } ] } ``` Weitere Informationen finden Sie unter [Analysieren des Datenzugriffs mithilfe von CloudWatch Contributor Insights for DynamoDB im *Amazon DynamoDB*](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/contributorinsights.html) Developer Guide. **Beispiel 2: So begrenzen Sie die Anzahl der zurückgegebenen Elemente** Im folgenden Beispiel wird die Anzahl der zurückgegebenen Elemente auf 4 begrenzt. Die Antwort enthält einen `NextToken`-Wert, mit dem die nächste Ergebnisseite abgerufen werden kann. ``` aws dynamodb list-contributor-insights \ --max-results 4 ``` Ausgabe: ``` { "ContributorInsightsSummaries": [ { "TableName": "MusicCollection", "IndexName": "AlbumTitle-index", "ContributorInsightsStatus": "ENABLED" }, { "TableName": "ProductCatalog", "ContributorInsightsStatus": "ENABLED" }, { "TableName": "Forum", "ContributorInsightsStatus": "ENABLED" } ], "NextToken": "abCDeFGhiJKlmnOPqrSTuvwxYZ1aBCdEFghijK7LM51nOpqRSTuv3WxY3ZabC5dEFGhI2Jk3LmnoPQ6RST9" } ``` Weitere Informationen finden Sie unter [Analysieren des Datenzugriffs mithilfe von CloudWatch Contributor Insights for DynamoDB im *Amazon DynamoDB*](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/contributorinsights.html) Developer Guide. **Beispiel 3: So rufen Sie die nächste Ergebnisseite ab** Der folgende Befehl verwendet den `NextToken`-Wert eines vorherigen Aufrufs des `list-contributor-insights`-Befehls, um eine weitere Ergebnisseite abzurufen. Da die Antwort in diesem Fall keinen `NextToken`-Wert enthält, wissen wir, dass wir das Ende der Ergebnisse erreicht haben. ``` aws dynamodb list-contributor-insights \ --max-results 4 \ --next-token abCDeFGhiJKlmnOPqrSTuvwxYZ1aBCdEFghijK7LM51nOpqRSTuv3WxY3ZabC5dEFGhI2Jk3LmnoPQ6RST9 ``` Ausgabe: ``` { "ContributorInsightsSummaries": [ { "TableName": "Reply", "ContributorInsightsStatus": "ENABLED" }, { "TableName": "Thread", "ContributorInsightsStatus": "ENABLED" } ] } ``` Weitere Informationen finden Sie unter [Analysieren des Datenzugriffs mithilfe von CloudWatch Contributor Insights for DynamoDB im *Amazon DynamoDB*](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/contributorinsights.html) Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [ListContributorInsights](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/list-contributor-insights.html)AWS CLI * ### `list-global-tables` Das folgende Codebeispiel zeigt die Verwendung`list-global-tables`. **AWS CLI** **So listen Sie vorhandene globale DynamoDB-Tabellen auf** Im folgenden Beispiel für `list-global-tables` werden alle vorhandenen globalen Tabellen aufgeführt. ``` aws dynamodb list-global-tables ``` Ausgabe: ``` { "GlobalTables": [ { "GlobalTableName": "MusicCollection", "ReplicationGroup": [ { "RegionName": "us-east-2" }, { "RegionName": "us-east-1" } ] } ] } ``` Weitere Informationen finden Sie unter [Globale DynamoDB-Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [ListGlobalTables](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/list-global-tables.html)in der *AWS CLI Befehlsreferenz*. ### `list-tables` Das folgende Codebeispiel zeigt die Verwendung`list-tables`. **AWS CLI** **Beispiel 1: So listen Sie Tabellen auf** Das folgende `list-tables` Beispiel listet alle Tabellen auf, die dem AWS Girokonto und der Region zugeordnet sind. ``` aws dynamodb list-tables ``` Ausgabe: ``` { "TableNames": [ "Forum", "ProductCatalog", "Reply", "Thread" ] } ``` Weitere Informationen finden Sie unter [Auflisten von Tabellennamen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.ListTables) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 2: So begrenzen Sie die Seitengröße** Das folgende Beispiel gibt eine Liste aller vorhandenen Tabellen zurück, ruft jedoch bei jedem Aufruf nur ein Element ab und führt gegebenenfalls mehrere Aufrufe durch, um die gesamte Liste abzurufen. Die Begrenzung der Seitengröße ist nützlich, wenn Listenbefehle für eine große Anzahl von Ressourcen ausgeführt werden, was zu einem Timeout-Fehler führen kann, wenn die Standardseitengröße von 1 000 verwendet wird. ``` aws dynamodb list-tables \ --page-size 1 ``` Ausgabe: ``` { "TableNames": [ "Forum", "ProductCatalog", "Reply", "Thread" ] } ``` Weitere Informationen finden Sie unter [Auflisten von Tabellennamen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.ListTables) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 3: So begrenzen Sie die Anzahl der zurückgegebenen Elemente** Im folgenden Beispiel wird die Anzahl der zurückgegebenen Elemente auf 2 begrenzt. Die Antwort enthält einen `NextToken`-Wert, mit dem die nächste Ergebnisseite abgerufen werden kann. ``` aws dynamodb list-tables \ --max-items 2 ``` Ausgabe: ``` { "TableNames": [ "Forum", "ProductCatalog" ], "NextToken": "abCDeFGhiJKlmnOPqrSTuvwxYZ1aBCdEFghijK7LM51nOpqRSTuv3WxY3ZabC5dEFGhI2Jk3LmnoPQ6RST9" } ``` Weitere Informationen finden Sie unter [Auflisten von Tabellennamen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.ListTables) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 4: So rufen Sie die nächste Ergebnisseite ab** Der folgende Befehl verwendet den `NextToken`-Wert eines vorherigen Aufrufs des `list-tables`-Befehls, um eine weitere Ergebnisseite abzurufen. Da die Antwort in diesem Fall keinen `NextToken`-Wert enthält, wissen wir, dass wir das Ende der Ergebnisse erreicht haben. ``` aws dynamodb list-tables \ --starting-token abCDeFGhiJKlmnOPqrSTuvwxYZ1aBCdEFghijK7LM51nOpqRSTuv3WxY3ZabC5dEFGhI2Jk3LmnoPQ6RST9 ``` Ausgabe: ``` { "TableNames": [ "Reply", "Thread" ] } ``` Weitere Informationen finden Sie unter [Auflisten von Tabellennamen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.ListTables) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [ListTables](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/list-tables.html)unter *AWS CLI Befehlsreferenz*. ### `list-tags-of-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-of-resource`. **AWS CLI** **Beispiel 1: So listen Sie Tags einer DynamoDB-Ressource auf** Im folgenden Beispiel für `list-tags-of-resource` werden Tags für die `MusicCollection`-Tabelle angezeigt. ``` aws dynamodb list-tags-of-resource \ --resource-arn arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection ``` Ausgabe: ``` { "Tags": [ { "Key": "Owner", "Value": "blueTeam" }, { "Key": "Environment", "Value": "Production" } ] } ``` Weitere Informationen finden Sie unter [Tagging für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html) im *Entwicklerhandbuch für Amazon DynamoDB*. **Beispiel 2: So begrenzen Sie die Anzahl der zurückgegebenen Tags** Im folgenden Beispiel wird die Anzahl der zurückgegebenen Tags auf 1 begrenzt. Die Antwort enthält einen `NextToken`-Wert, mit dem die nächste Ergebnisseite abgerufen werden kann. ``` aws dynamodb list-tags-of-resource \ --resource-arn arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection \ --max-items 1 ``` Ausgabe: ``` { "Tags": [ { "Key": "Owner", "Value": "blueTeam" } ], "NextToken": "abCDeFGhiJKlmnOPqrSTuvwxYZ1aBCdEFghijK7LM51nOpqRSTuv3WxY3ZabC5dEFGhI2Jk3LmnoPQ6RST9" } ``` Weitere Informationen finden Sie unter [Tagging für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html) im *Entwicklerhandbuch für Amazon DynamoDB*. **Beispiel 3: So rufen Sie die nächste Ergebnisseite ab** Der folgende Befehl verwendet den `NextToken`-Wert eines vorherigen Aufrufs des `list-tags-of-resource`-Befehls, um eine weitere Ergebnisseite abzurufen. Da die Antwort in diesem Fall keinen `NextToken`-Wert enthält, wissen wir, dass wir das Ende der Ergebnisse erreicht haben. ``` aws dynamodb list-tags-of-resource \ --resource-arn arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection \ --starting-token abCDeFGhiJKlmnOPqrSTuvwxYZ1aBCdEFghijK7LM51nOpqRSTuv3WxY3ZabC5dEFGhI2Jk3LmnoPQ6RST9 ``` Ausgabe: ``` { "Tags": [ { "Key": "Environment", "Value": "Production" } ] } ``` Weitere Informationen finden Sie unter [Tagging für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [ListTagsOfResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/list-tags-of-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-item` Das folgende Codebeispiel zeigt die Verwendung`put-item`. **AWS CLI** **Beispiel 1: So fügen Sie einer Tabelle ein Element hinzu** Das folgende `put-item` Beispiel fügt der *MusicCollection*Tabelle ein neues Element hinzu. ``` aws dynamodb put-item \ --table-name MusicCollection \ --item file://item.json \ --return-consumed-capacity TOTAL \ --return-item-collection-metrics SIZE ``` Inhalt von `item.json`: ``` { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"}, "AlbumTitle": {"S": "Greatest Hits"} } ``` Ausgabe: ``` { "ConsumedCapacity": { "TableName": "MusicCollection", "CapacityUnits": 1.0 }, "ItemCollectionMetrics": { "ItemCollectionKey": { "Artist": { "S": "No One You Know" } }, "SizeEstimateRangeGB": [ 0.0, 1.0 ] } } ``` Weitere Informationen finden Sie unter [Schreiben eines Elements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.WritingData) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 2: So überschreiben Sie ein Element in einer Tabelle bedingungsabhängig** Im folgenden Beispiel für `put-item` wird ein vorhandenes Element in der `MusicCollection`-Tabelle nur dann überschrieben, wenn dieses vorhandene Element ein `AlbumTitle`-Attribut mit dem Wert `Greatest Hits` hat. Der Befehl gibt den vorherigen Wert des Elements zurück. ``` aws dynamodb put-item \ --table-name MusicCollection \ --item file://item.json \ --condition-expression "#A = :A" \ --expression-attribute-names file://names.json \ --expression-attribute-values file://values.json \ --return-values ALL_OLD ``` Inhalt von `item.json`: ``` { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"}, "AlbumTitle": {"S": "Somewhat Famous"} } ``` Inhalt von `names.json`: ``` { "#A": "AlbumTitle" } ``` Inhalt von `values.json`: ``` { ":A": {"S": "Greatest Hits"} } ``` Ausgabe: ``` { "Attributes": { "AlbumTitle": { "S": "Greatest Hits" }, "Artist": { "S": "No One You Know" }, "SongTitle": { "S": "Call Me Today" } } } ``` Wenn der Schlüssel bereits existiert, sollten Sie die folgende Ausgabe sehen: ``` A client error (ConditionalCheckFailedException) occurred when calling the PutItem operation: The conditional request failed. ``` Weitere Informationen finden Sie unter [Schreiben eines Elements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.WritingData) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [PutItem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/put-item.html)unter *AWS CLI Befehlsreferenz*. ### `query` Das folgende Codebeispiel zeigt die Verwendung`query`. **AWS CLI** **Beispiel 1: So fragen Sie eine Tabelle ab** Im folgenden Beispiel für `query` werden Elemente in der Tabelle `MusicCollection` abgefragt. Die Tabelle hat einen hash-and-range Primärschlüssel (`Artist`und`SongTitle`), aber diese Abfrage gibt nur den Hashschlüsselwert an. Es werden Songtitel des Künstlers mit dem Namen „No One You Know“ zurückgegeben. ``` aws dynamodb query \ --table-name MusicCollection \ --projection-expression "SongTitle" \ --key-condition-expression "Artist = :v1" \ --expression-attribute-values file://expression-attributes.json \ --return-consumed-capacity TOTAL ``` Inhalt von `expression-attributes.json`: ``` { ":v1": {"S": "No One You Know"} } ``` Ausgabe: ``` { "Items": [ { "SongTitle": { "S": "Call Me Today" }, "SongTitle": { "S": "Scared of My Shadow" } } ], "Count": 2, "ScannedCount": 2, "ConsumedCapacity": { "TableName": "MusicCollection", "CapacityUnits": 0.5 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Abfragen in DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 2: So fragen Sie eine Tabelle mit strikt konsistenten Lesevorgängen ab und durchlaufen den Index in absteigender Reihenfolge** Im folgenden Beispiel wird dieselbe Abfrage wie im ersten Beispiel ausgeführt, die Ergebnisse werden jedoch in umgekehrter Reihenfolge zurückgegeben und es werden strikt konsistente Lesevorgänge verwendet. ``` aws dynamodb query \ --table-name MusicCollection \ --projection-expression "SongTitle" \ --key-condition-expression "Artist = :v1" \ --expression-attribute-values file://expression-attributes.json \ --consistent-read \ --no-scan-index-forward \ --return-consumed-capacity TOTAL ``` Inhalt von `expression-attributes.json`: ``` { ":v1": {"S": "No One You Know"} } ``` Ausgabe: ``` { "Items": [ { "SongTitle": { "S": "Scared of My Shadow" } }, { "SongTitle": { "S": "Call Me Today" } } ], "Count": 2, "ScannedCount": 2, "ConsumedCapacity": { "TableName": "MusicCollection", "CapacityUnits": 1.0 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Abfragen in DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 3: So filtern Sie bestimmte Ergebnisse heraus** Im folgende Beispiel wird `MusicCollection` abgefragt, Ergebnisse mit bestimmten Werten im `AlbumTitle`-Attribut werden jedoch ausgeschlossen. Beachten Sie, dass sich dies nicht auf `ScannedCount` oder `ConsumedCapacity` auswirkt, da der Filter angewendet wird, nachdem die Elemente gelesen wurden. ``` aws dynamodb query \ --table-name MusicCollection \ --key-condition-expression "#n1 = :v1" \ --filter-expression "NOT (#n2 IN (:v2, :v3))" \ --expression-attribute-names file://names.json \ --expression-attribute-values file://values.json \ --return-consumed-capacity TOTAL ``` Inhalt von `values.json`: ``` { ":v1": {"S": "No One You Know"}, ":v2": {"S": "Blue Sky Blues"}, ":v3": {"S": "Greatest Hits"} } ``` Inhalt von `names.json`: ``` { "#n1": "Artist", "#n2": "AlbumTitle" } ``` Ausgabe: ``` { "Items": [ { "AlbumTitle": { "S": "Somewhat Famous" }, "Artist": { "S": "No One You Know" }, "SongTitle": { "S": "Call Me Today" } } ], "Count": 1, "ScannedCount": 2, "ConsumedCapacity": { "TableName": "MusicCollection", "CapacityUnits": 0.5 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Abfragen in DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 4: So rufen Sie nur die Elementanzahl ab** Das folgende Beispiel ruft eine Anzahl von Elementen ab, die der Abfrage entsprechen, ruft jedoch keines der Elemente selbst ab. ``` aws dynamodb query \ --table-name MusicCollection \ --select COUNT \ --key-condition-expression "Artist = :v1" \ --expression-attribute-values file://expression-attributes.json ``` Inhalt von `expression-attributes.json`: ``` { ":v1": {"S": "No One You Know"} } ``` Ausgabe: ``` { "Count": 2, "ScannedCount": 2, "ConsumedCapacity": null } ``` Weitere Informationen finden Sie unter [Arbeiten mit Abfragen in DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 5: So rufen Sie einen Index ab** Im folgenden Beispiel wird der lokale sekundäre Index `AlbumTitleIndex` abgefragt. Die Abfrage gibt alle Attribute aus der Basistabelle zurück, die in den lokalen sekundären Index projiziert wurden. Beachten Sie, dass Sie bei der Abfrage eines lokalen sekundären Index oder eines globalen sekundären Index auch den Namen der Basistabelle mit dem `table-name`-Parameter angeben müssen. ``` aws dynamodb query \ --table-name MusicCollection \ --index-name AlbumTitleIndex \ --key-condition-expression "Artist = :v1" \ --expression-attribute-values file://expression-attributes.json \ --select ALL_PROJECTED_ATTRIBUTES \ --return-consumed-capacity INDEXES ``` Inhalt von `expression-attributes.json`: ``` { ":v1": {"S": "No One You Know"} } ``` Ausgabe: ``` { "Items": [ { "AlbumTitle": { "S": "Blue Sky Blues" }, "Artist": { "S": "No One You Know" }, "SongTitle": { "S": "Scared of My Shadow" } }, { "AlbumTitle": { "S": "Somewhat Famous" }, "Artist": { "S": "No One You Know" }, "SongTitle": { "S": "Call Me Today" } } ], "Count": 2, "ScannedCount": 2, "ConsumedCapacity": { "TableName": "MusicCollection", "CapacityUnits": 0.5, "Table": { "CapacityUnits": 0.0 }, "LocalSecondaryIndexes": { "AlbumTitleIndex": { "CapacityUnits": 0.5 } } } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Abfragen in DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Weitere API-Informationen finden Sie unter [Query](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/query.html) in der *AWS CLI -Befehlsreferenz*. ### `restore-table-from-backup` Das folgende Codebeispiel zeigt, wie man es benutzt`restore-table-from-backup`. **AWS CLI** **So stellen Sie eine DynamoDB-Tabelle aus einer vorhandenen Sicherung wieder her** Im folgenden Beispiel für `restore-table-from-backup` wird die angegebene Tabelle aus einer vorhandenen Sicherung wieder hergestellt. ``` aws dynamodb restore-table-from-backup \ --target-table-name MusicCollection \ --backup-arnarn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01576616366715-b4e58d3a ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "TableName": "MusicCollection2", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": 1576618274.326, "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 5, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection2", "TableId": "114865c9-5ef3-496c-b4d1-c4cbdd2d44fb", "BillingModeSummary": { "BillingMode": "PROVISIONED" }, "RestoreSummary": { "SourceBackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01576616366715-b4e58d3a", "SourceTableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "RestoreDateTime": 1576616366.715, "RestoreInProgress": true } } } ``` Weitere Informationen finden Sie unter [On-Demand-Backup und -Wiederherstellung für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/BackupRestore.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [RestoreTableFromBackup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/restore-table-from-backup.html)in der *AWS CLI Befehlsreferenz*. ### `restore-table-to-point-in-time` Das folgende Codebeispiel zeigt die Verwendung`restore-table-to-point-in-time`. **AWS CLI** **So stellen Sie eine DynamoDB-Tabelle zu einem bestimmten Zeitpunkt wieder her** Im folgenden Beispiel für `restore-table-to-point-in-time` wird die `MusicCollection`-Tabelle zum angegebenen Zeitpunkt wieder hergestellt. ``` aws dynamodb restore-table-to-point-in-time \ --source-table-name MusicCollection \ --target-table-name MusicCollectionRestore \ --restore-date-time 1576622404.0 ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "TableName": "MusicCollectionRestore", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableStatus": "CREATING", "CreationDateTime": 1576623311.86, "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 5, "WriteCapacityUnits": 5 }, "TableSizeBytes": 0, "ItemCount": 0, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollectionRestore", "TableId": "befd9e0e-1843-4dc6-a147-d6d00e85cb1f", "BillingModeSummary": { "BillingMode": "PROVISIONED" }, "RestoreSummary": { "SourceTableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "RestoreDateTime": 1576622404.0, "RestoreInProgress": true } } } ``` Weitere Informationen finden Sie unter [Point-in-Time Recovery for DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PointInTimeRecovery.html) im *Amazon DynamoDB Developer Guide*. + *Einzelheiten zur API finden Sie unter [RestoreTableToPointInTime](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/restore-table-to-point-in-time.html)Befehlsreferenz.AWS CLI * ### `scan` Das folgende Codebeispiel zeigt die Verwendung`scan`. **AWS CLI** **So scannen Sie eine Tabelle** Im folgenden Beispiel für `scan` wird die gesamte `MusicCollection`-Tabelle gescannt und die Ergebnisse werden dann auf Songs des Künstlers „No One You Know“ eingegrenzt. Für jedes Element werden nur der Albumtitel und der Songtitel zurückgegeben. ``` aws dynamodb scan \ --table-name MusicCollection \ --filter-expression "Artist = :a" \ --projection-expression "#ST, #AT" \ --expression-attribute-names file://expression-attribute-names.json \ --expression-attribute-values file://expression-attribute-values.json ``` Inhalt von `expression-attribute-names.json`: ``` { "#ST": "SongTitle", "#AT":"AlbumTitle" } ``` Inhalt von `expression-attribute-values.json`: ``` { ":a": {"S": "No One You Know"} } ``` Ausgabe: ``` { "Count": 2, "Items": [ { "SongTitle": { "S": "Call Me Today" }, "AlbumTitle": { "S": "Somewhat Famous" } }, { "SongTitle": { "S": "Scared of My Shadow" }, "AlbumTitle": { "S": "Blue Sky Blues" } } ], "ScannedCount": 3, "ConsumedCapacity": null } ``` Weitere Informationen finden Sie unter [Arbeiten mit Scans in DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Scan.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Weitere API-Informationen finden Sie unter [Scan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/scan.html) in der *AWS CLI -Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer DynamoDB-Ressource Tags hinzu** Im folgenden `tag-resource` Beispiel wird der `MusicCollection` Tabelle ein key/value Tag-Paar hinzugefügt. ``` aws dynamodb tag-resource \ --resource-arn arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection \ --tags Key=Owner,Value=blueTeam ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/tag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `transact-get-items` Das folgende Codebeispiel zeigt die Verwendung`transact-get-items`. **AWS CLI** **So rufen Sie verschiedene Elemente aus einer oder mehreren Tabellen atomar ab** Im folgenden Beispiel für `transact-get-items` werden mehrere Elemente atomar abgerufen. ``` aws dynamodb transact-get-items \ --transact-items file://transact-items.json \ --return-consumed-capacity TOTAL ``` Inhalt von `transact-items.json`: ``` [ { "Get": { "Key": { "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"} }, "TableName": "MusicCollection" } }, { "Get": { "Key": { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"} }, "TableName": "MusicCollection" } } ] ``` Ausgabe: ``` { "ConsumedCapacity": [ { "TableName": "MusicCollection", "CapacityUnits": 4.0, "ReadCapacityUnits": 4.0 } ], "Responses": [ { "Item": { "AlbumTitle": { "S": "Songs About Life" }, "Artist": { "S": "Acme Band" }, "SongTitle": { "S": "Happy Day" } } }, { "Item": { "AlbumTitle": { "S": "Somewhat Famous" }, "Artist": { "S": "No One You Know" }, "SongTitle": { "S": "Call Me Today" } } } ] } ``` Weitere Informationen finden Sie unter [Verwalten komplexer Workflows mit DynamoDB-Transaktionen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [TransactGetItems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/transact-get-items.html)in der *AWS CLI Befehlsreferenz*. ### `transact-write-items` Das folgende Codebeispiel zeigt die Verwendung`transact-write-items`. **AWS CLI** **Beispiel 1: So schreiben Sie Elemente atomar in eine oder mehrere Tabellen** Im folgenden Beispiel für `transact-write-items` wird ein Element aktualisiert und ein anderes gelöscht. Der Vorgang schlägt fehl, wenn bei einer der Operationen ein Fehler auftritt oder eines der Elemente ein `Rating`-Attribut enthält. ``` aws dynamodb transact-write-items \ --transact-items file://transact-items.json \ --return-consumed-capacity TOTAL \ --return-item-collection-metrics SIZE ``` Inhalt der `transact-items.json`-Datei: ``` [ { "Update": { "Key": { "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"} }, "UpdateExpression": "SET AlbumTitle = :newval", "ExpressionAttributeValues": { ":newval": {"S": "Updated Album Title"} }, "TableName": "MusicCollection", "ConditionExpression": "attribute_not_exists(Rating)" } }, { "Delete": { "Key": { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"} }, "TableName": "MusicCollection", "ConditionExpression": "attribute_not_exists(Rating)" } } ] ``` Ausgabe: ``` { "ConsumedCapacity": [ { "TableName": "MusicCollection", "CapacityUnits": 10.0, "WriteCapacityUnits": 10.0 } ], "ItemCollectionMetrics": { "MusicCollection": [ { "ItemCollectionKey": { "Artist": { "S": "No One You Know" } }, "SizeEstimateRangeGB": [ 0.0, 1.0 ] }, { "ItemCollectionKey": { "Artist": { "S": "Acme Band" } }, "SizeEstimateRangeGB": [ 0.0, 1.0 ] } ] } } ``` Weitere Informationen finden Sie unter [Verwalten komplexer Workflows mit DynamoDB-Transaktionen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html) im *Entwicklerhandbuch für Amazon DynamoDB*. **Beispiel 2: So schreiben Sie Elemente mithilfe eines Clientanforderungstoken atomar** Im folgende Befehl wird ein Clientanforderungstoken verwendet, um den Aufruf an `transact-write-items` idempotent zu gestalten, was bedeutet, dass mehrere Aufrufe den gleichen Effekt haben wie ein einziger Aufruf. ``` aws dynamodb transact-write-items \ --transact-items file://transact-items.json \ --client-request-token abc123 ``` Inhalt der `transact-items.json`-Datei: ``` [ { "Update": { "Key": { "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"} }, "UpdateExpression": "SET AlbumTitle = :newval", "ExpressionAttributeValues": { ":newval": {"S": "Updated Album Title"} }, "TableName": "MusicCollection", "ConditionExpression": "attribute_not_exists(Rating)" } }, { "Delete": { "Key": { "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"} }, "TableName": "MusicCollection", "ConditionExpression": "attribute_not_exists(Rating)" } } ] ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten komplexer Workflows mit DynamoDB-Transaktionen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [TransactWriteItems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/transact-write-items.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag aus einer DynamoDB-Ressource** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem Schlüssel `Owner` aus der Tabelle `MusicCollection` entfernt. ``` aws dynamodb untag-resource \ --resource-arn arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection \ --tag-keys Owner ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-continuous-backups` Das folgende Codebeispiel zeigt die Verwendung`update-continuous-backups`. **AWS CLI** **So aktualisieren Sie die Einstellungen für kontinuierliche Sicherungen für eine DynamoDB-Tabelle** Das folgende `update-continuous-backups` Beispiel aktiviert die point-in-time Wiederherstellung für die `MusicCollection` Tabelle. ``` aws dynamodb update-continuous-backups \ --table-name MusicCollection \ --point-in-time-recovery-specification PointInTimeRecoveryEnabled=true ``` Ausgabe: ``` { "ContinuousBackupsDescription": { "ContinuousBackupsStatus": "ENABLED", "PointInTimeRecoveryDescription": { "PointInTimeRecoveryStatus": "ENABLED", "EarliestRestorableDateTime": 1576622404.0, "LatestRestorableDateTime": 1576622404.0 } } } ``` Weitere Informationen finden Sie unter [Point-in-Time Recovery for DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PointInTimeRecovery.html) im *Amazon DynamoDB Developer Guide*. + *Einzelheiten zur API finden Sie unter [UpdateContinuousBackups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/update-continuous-backups.html)Befehlsreferenz.AWS CLI * ### `update-contributor-insights` Das folgende Codebeispiel zeigt die Verwendung`update-contributor-insights`. **AWS CLI** **So aktivieren Sie Contributor Insights für eine Tabelle** Im folgenden Beispiel für `update-contributor-insights` wird Contributor Insights für die `MusicCollection`-Tabelle und den globalen sekundären Index `AlbumTitle-index` aktiviert. ``` aws dynamodb update-contributor-insights \ --table-name MusicCollection \ --index-name AlbumTitle-index \ --contributor-insights-action ENABLE ``` Ausgabe: ``` { "TableName": "MusicCollection", "IndexName": "AlbumTitle-index", "ContributorInsightsStatus": "ENABLING" } ``` Weitere Informationen finden Sie unter [Analysieren des Datenzugriffs mithilfe von CloudWatch Contributor Insights for DynamoDB im *Amazon DynamoDB*](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/contributorinsights.html) Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [UpdateContributorInsights](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/update-contributor-insights.html)AWS CLI * ### `update-global-table-settings` Das folgende Codebeispiel zeigt die Verwendung`update-global-table-settings`. **AWS CLI** **So aktualisieren Sie die bereitgestellten Schreibkapazitätseinstellungen für eine globale DynamoDB-Tabelle** Im folgenden Beispiel für `update-global-table-settings` wird die bereitgestellte Schreibkapazität der globalen `MusicCollection`-Tabelle auf 15 festgelegt. ``` aws dynamodb update-global-table-settings \ --global-table-name MusicCollection \ --global-table-provisioned-write-capacity-units 15 ``` Ausgabe: ``` { "GlobalTableName": "MusicCollection", "ReplicaSettings": [ { "RegionName": "eu-west-1", "ReplicaStatus": "UPDATING", "ReplicaProvisionedReadCapacityUnits": 10, "ReplicaProvisionedReadCapacityAutoScalingSettings": { "AutoScalingDisabled": true }, "ReplicaProvisionedWriteCapacityUnits": 10, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "AutoScalingDisabled": true } }, { "RegionName": "us-east-1", "ReplicaStatus": "UPDATING", "ReplicaProvisionedReadCapacityUnits": 10, "ReplicaProvisionedReadCapacityAutoScalingSettings": { "AutoScalingDisabled": true }, "ReplicaProvisionedWriteCapacityUnits": 10, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "AutoScalingDisabled": true } }, { "RegionName": "us-east-2", "ReplicaStatus": "UPDATING", "ReplicaProvisionedReadCapacityUnits": 10, "ReplicaProvisionedReadCapacityAutoScalingSettings": { "AutoScalingDisabled": true }, "ReplicaProvisionedWriteCapacityUnits": 10, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "AutoScalingDisabled": true } } ] } ``` Weitere Informationen finden Sie unter [Globale DynamoDB-Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [UpdateGlobalTableSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/update-global-table-settings.html)in der *AWS CLI Befehlsreferenz*. ### `update-global-table` Das folgende Codebeispiel zeigt die Verwendung`update-global-table`. **AWS CLI** **So aktualisieren Sie eine globale DynamoDB-Tabelle** Im folgenden Beispiel für `update-global-table` wird der globalen Tabelle `MusicCollection` ein Replikat in der angegebenen Region hinzugefügt. ``` aws dynamodb update-global-table \ --global-table-name MusicCollection \ --replica-updates Create={RegionName=eu-west-1} ``` Ausgabe: ``` { "GlobalTableDescription": { "ReplicationGroup": [ { "RegionName": "eu-west-1" }, { "RegionName": "us-east-2" }, { "RegionName": "us-east-1" } ], "GlobalTableArn": "arn:aws:dynamodb::123456789012:global-table/MusicCollection", "CreationDateTime": 1576625818.532, "GlobalTableStatus": "ACTIVE", "GlobalTableName": "MusicCollection" } } ``` Weitere Informationen finden Sie unter [Globale DynamoDB-Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [UpdateGlobalTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/update-global-table.html)in der *AWS CLI Befehlsreferenz*. ### `update-item` Das folgende Codebeispiel zeigt die Verwendung`update-item`. **AWS CLI** **Beispiel 1: So aktualisieren Sie ein Element in einer Tabelle** Im folgenden Beispiel für `update-item` wird ein Element in der Tabelle `MusicCollection` aktualisiert. Es wird ein neues Attribut (`Year`) hinzugefügt und das `AlbumTitle`-Attribut geändert. Alle Attribute im Element, wie sie nach dem Update erscheinen, werden in der Antwort zurückgegeben. ``` aws dynamodb update-item \ --table-name MusicCollection \ --key file://key.json \ --update-expression "SET #Y = :y, #AT = :t" \ --expression-attribute-names file://expression-attribute-names.json \ --expression-attribute-values file://expression-attribute-values.json \ --return-values ALL_NEW \ --return-consumed-capacity TOTAL \ --return-item-collection-metrics SIZE ``` Inhalt von `key.json`: ``` { "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"} } ``` Inhalt von `expression-attribute-names.json`: ``` { "#Y":"Year", "#AT":"AlbumTitle" } ``` Inhalt von `expression-attribute-values.json`: ``` { ":y":{"N": "2015"}, ":t":{"S": "Louder Than Ever"} } ``` Ausgabe: ``` { "Attributes": { "AlbumTitle": { "S": "Louder Than Ever" }, "Awards": { "N": "10" }, "Artist": { "S": "Acme Band" }, "Year": { "N": "2015" }, "SongTitle": { "S": "Happy Day" } }, "ConsumedCapacity": { "TableName": "MusicCollection", "CapacityUnits": 3.0 }, "ItemCollectionMetrics": { "ItemCollectionKey": { "Artist": { "S": "Acme Band" } }, "SizeEstimateRangeGB": [ 0.0, 1.0 ] } } ``` Weitere Informationen finden Sie unter [Schreiben eines Elements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.WritingData) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 2: So aktualisieren Sie ein Element bedingungsabhängig** Im folgenden Beispiel wird ein Element in der `MusicCollection`-Tabelle aktualisiert, jedoch nur, wenn das vorhandene Element noch kein `Year`-Attribut besitzt. ``` aws dynamodb update-item \ --table-name MusicCollection \ --key file://key.json \ --update-expression "SET #Y = :y, #AT = :t" \ --expression-attribute-names file://expression-attribute-names.json \ --expression-attribute-values file://expression-attribute-values.json \ --condition-expression "attribute_not_exists(#Y)" ``` Inhalt von `key.json`: ``` { "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"} } ``` Inhalt von `expression-attribute-names.json`: ``` { "#Y":"Year", "#AT":"AlbumTitle" } ``` Inhalt von `expression-attribute-values.json`: ``` { ":y":{"N": "2015"}, ":t":{"S": "Louder Than Ever"} } ``` Wenn das Element bereits über ein `Year`-Attribut verfügt, gibt DynamoDB die folgende Ausgabe zurück. ``` An error occurred (ConditionalCheckFailedException) when calling the UpdateItem operation: The conditional request failed ``` Weitere Informationen finden Sie unter [Schreiben eines Elements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html#WorkingWithItems.WritingData) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [UpdateItem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/update-item.html)in der *AWS CLI Befehlsreferenz*. ### `update-table-replica-auto-scaling` Das folgende Codebeispiel zeigt die Verwendung`update-table-replica-auto-scaling`. **AWS CLI** **So aktualisieren Sie Auto-Scaling-Einstellungen für Replikate einer globalen Tabelle** Im folgenden Beispiel für `update-table-replica-auto-scaling` werden Auto-Scaling-Einstellungen für die Schreibkapazität für alle Replikate der angegebenen globalen Tabelle angezeigt. ``` aws dynamodb update-table-replica-auto-scaling \ --table-name MusicCollection \ --provisioned-write-capacity-auto-scaling-update file://auto-scaling-policy.json ``` Inhalt von `auto-scaling-policy.json`: ``` { "MinimumUnits": 10, "MaximumUnits": 100, "AutoScalingDisabled": false, "ScalingPolicyUpdate": { "PolicyName": "DynamoDBWriteCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 80 } } } ``` Ausgabe: ``` { "TableAutoScalingDescription": { "TableName": "MusicCollection", "TableStatus": "ACTIVE", "Replicas": [ { "RegionName": "eu-central-1", "GlobalSecondaryIndexes": [], "ReplicaProvisionedReadCapacityAutoScalingSettings": { "MinimumUnits": 5, "MaximumUnits": 40000, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBReadCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 70.0 } } ] }, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "MinimumUnits": 10, "MaximumUnits": 100, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBWriteCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 80.0 } } ] }, "ReplicaStatus": "ACTIVE" }, { "RegionName": "us-east-1", "GlobalSecondaryIndexes": [], "ReplicaProvisionedReadCapacityAutoScalingSettings": { "MinimumUnits": 5, "MaximumUnits": 40000, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBReadCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 70.0 } } ] }, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "MinimumUnits": 10, "MaximumUnits": 100, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBWriteCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 80.0 } } ] }, "ReplicaStatus": "ACTIVE" }, { "RegionName": "us-east-2", "GlobalSecondaryIndexes": [], "ReplicaProvisionedReadCapacityAutoScalingSettings": { "MinimumUnits": 5, "MaximumUnits": 40000, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBReadCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 70.0 } } ] }, "ReplicaProvisionedWriteCapacityAutoScalingSettings": { "MinimumUnits": 10, "MaximumUnits": 100, "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable", "ScalingPolicies": [ { "PolicyName": "DynamoDBWriteCapacityUtilization:table/MusicCollection", "TargetTrackingScalingPolicyConfiguration": { "TargetValue": 80.0 } } ] }, "ReplicaStatus": "ACTIVE" } ] } } ``` Weitere Informationen finden Sie unter [Globale DynamoDB-Tabellen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [UpdateTableReplicaAutoScaling](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/update-table-replica-auto-scaling.html)in der *AWS CLI Befehlsreferenz*. ### `update-table` Das folgende Codebeispiel zeigt die Verwendung`update-table`. **AWS CLI** **Beispiel 1: So ändern Sie den Fakturierungsmodus einer Tabelle** Im folgenden Beispiel für `update-table` wird die bereitgestellte Lese- und Schreibkapazität für die `MusicCollection`-Tabelle erhöht. ``` aws dynamodb update-table \ --table-name MusicCollection \ --billing-mode PROVISIONED \ --provisioned-throughput ReadCapacityUnits=15,WriteCapacityUnits=10 ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "AlbumTitle", "AttributeType": "S" }, { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "TableName": "MusicCollection", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableStatus": "UPDATING", "CreationDateTime": "2020-05-26T15:59:49.473000-07:00", "ProvisionedThroughput": { "LastIncreaseDateTime": "2020-07-28T13:18:18.921000-07:00", "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 15, "WriteCapacityUnits": 10 }, "TableSizeBytes": 182, "ItemCount": 2, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableId": "abcd0123-01ab-23cd-0123-abcdef123456", "BillingModeSummary": { "BillingMode": "PROVISIONED", "LastUpdateToPayPerRequestDateTime": "2020-07-28T13:14:48.366000-07:00" } } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Tabelle](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.UpdateTable) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 2: So erstellen Sie einen globalen sekundären Index** Das folgende Beispiel fügt der `MusicCollection`-Tabelle einen globalen sekundären Index hinzu. ``` aws dynamodb update-table \ --table-name MusicCollection \ --attribute-definitions AttributeName=AlbumTitle,AttributeType=S \ --global-secondary-index-updates file://gsi-updates.json ``` Inhalt von `gsi-updates.json`: ``` [ { "Create": { "IndexName": "AlbumTitle-index", "KeySchema": [ { "AttributeName": "AlbumTitle", "KeyType": "HASH" } ], "ProvisionedThroughput": { "ReadCapacityUnits": 10, "WriteCapacityUnits": 10 }, "Projection": { "ProjectionType": "ALL" } } } ] ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "AlbumTitle", "AttributeType": "S" }, { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "TableName": "MusicCollection", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableStatus": "UPDATING", "CreationDateTime": "2020-05-26T15:59:49.473000-07:00", "ProvisionedThroughput": { "LastIncreaseDateTime": "2020-07-28T12:59:17.537000-07:00", "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 15, "WriteCapacityUnits": 10 }, "TableSizeBytes": 182, "ItemCount": 2, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableId": "abcd0123-01ab-23cd-0123-abcdef123456", "BillingModeSummary": { "BillingMode": "PROVISIONED", "LastUpdateToPayPerRequestDateTime": "2020-07-28T13:14:48.366000-07:00" }, "GlobalSecondaryIndexes": [ { "IndexName": "AlbumTitle-index", "KeySchema": [ { "AttributeName": "AlbumTitle", "KeyType": "HASH" } ], "Projection": { "ProjectionType": "ALL" }, "IndexStatus": "CREATING", "Backfilling": false, "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 10 }, "IndexSizeBytes": 0, "ItemCount": 0, "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/index/AlbumTitle-index" } ] } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Tabelle](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.UpdateTable) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 3: So aktivieren Sie DynamoDB Streams für eine Tabelle** Der folgende Befehl aktiviert DynamoDB Streams für die `MusicCollection`-Tabelle. ``` aws dynamodb update-table \ --table-name MusicCollection \ --stream-specification StreamEnabled=true,StreamViewType=NEW_IMAGE ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "AlbumTitle", "AttributeType": "S" }, { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "TableName": "MusicCollection", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableStatus": "UPDATING", "CreationDateTime": "2020-05-26T15:59:49.473000-07:00", "ProvisionedThroughput": { "LastIncreaseDateTime": "2020-07-28T12:59:17.537000-07:00", "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 15, "WriteCapacityUnits": 10 }, "TableSizeBytes": 182, "ItemCount": 2, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableId": "abcd0123-01ab-23cd-0123-abcdef123456", "BillingModeSummary": { "BillingMode": "PROVISIONED", "LastUpdateToPayPerRequestDateTime": "2020-07-28T13:14:48.366000-07:00" }, "LocalSecondaryIndexes": [ { "IndexName": "AlbumTitleIndex", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "AlbumTitle", "KeyType": "RANGE" } ], "Projection": { "ProjectionType": "INCLUDE", "NonKeyAttributes": [ "Year", "Genre" ] }, "IndexSizeBytes": 139, "ItemCount": 2, "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/index/AlbumTitleIndex" } ], "GlobalSecondaryIndexes": [ { "IndexName": "AlbumTitle-index", "KeySchema": [ { "AttributeName": "AlbumTitle", "KeyType": "HASH" } ], "Projection": { "ProjectionType": "ALL" }, "IndexStatus": "ACTIVE", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 10 }, "IndexSizeBytes": 0, "ItemCount": 0, "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/index/AlbumTitle-index" } ], "StreamSpecification": { "StreamEnabled": true, "StreamViewType": "NEW_IMAGE" }, "LatestStreamLabel": "2020-07-28T21:53:39.112", "LatestStreamArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/stream/2020-07-28T21:53:39.112" } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Tabelle](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.UpdateTable) im *Entwicklerhandbuch zu Amazon DynamoDB*. **Beispiel 4: So aktivieren Sie die serverseitige Verschlüsselung** Im folgenden Beispiel wird die serverseitige Verschlüsselung für die `MusicCollection`-Tabelle aktiviert. ``` aws dynamodb update-table \ --table-name MusicCollection \ --sse-specification Enabled=true,SSEType=KMS ``` Ausgabe: ``` { "TableDescription": { "AttributeDefinitions": [ { "AttributeName": "AlbumTitle", "AttributeType": "S" }, { "AttributeName": "Artist", "AttributeType": "S" }, { "AttributeName": "SongTitle", "AttributeType": "S" } ], "TableName": "MusicCollection", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "TableStatus": "ACTIVE", "CreationDateTime": "2020-05-26T15:59:49.473000-07:00", "ProvisionedThroughput": { "LastIncreaseDateTime": "2020-07-28T12:59:17.537000-07:00", "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 15, "WriteCapacityUnits": 10 }, "TableSizeBytes": 182, "ItemCount": 2, "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", "TableId": "abcd0123-01ab-23cd-0123-abcdef123456", "BillingModeSummary": { "BillingMode": "PROVISIONED", "LastUpdateToPayPerRequestDateTime": "2020-07-28T13:14:48.366000-07:00" }, "LocalSecondaryIndexes": [ { "IndexName": "AlbumTitleIndex", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "AlbumTitle", "KeyType": "RANGE" } ], "Projection": { "ProjectionType": "INCLUDE", "NonKeyAttributes": [ "Year", "Genre" ] }, "IndexSizeBytes": 139, "ItemCount": 2, "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/index/AlbumTitleIndex" } ], "GlobalSecondaryIndexes": [ { "IndexName": "AlbumTitle-index", "KeySchema": [ { "AttributeName": "AlbumTitle", "KeyType": "HASH" } ], "Projection": { "ProjectionType": "ALL" }, "IndexStatus": "ACTIVE", "ProvisionedThroughput": { "NumberOfDecreasesToday": 0, "ReadCapacityUnits": 10, "WriteCapacityUnits": 10 }, "IndexSizeBytes": 0, "ItemCount": 0, "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/index/AlbumTitle-index" } ], "StreamSpecification": { "StreamEnabled": true, "StreamViewType": "NEW_IMAGE" }, "LatestStreamLabel": "2020-07-28T21:53:39.112", "LatestStreamArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/stream/2020-07-28T21:53:39.112", "SSEDescription": { "Status": "UPDATING" } } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Tabelle](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.UpdateTable) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [UpdateTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/update-table.html)in der *AWS CLI Befehlsreferenz*. ### `update-time-to-live` Das folgende Codebeispiel zeigt die Verwendung`update-time-to-live`. **AWS CLI** **So aktualisieren Sie die Time-to-Live-Einstellungen für eine Tabelle** Im folgenden Beispiel für `update-time-to-live` wird Time to Live für die angegebene Tabelle aktiviert. ``` aws dynamodb update-time-to-live \ --table-name MusicCollection \ --time-to-live-specification Enabled=true,AttributeName=ttl ``` Ausgabe: ``` { "TimeToLiveSpecification": { "Enabled": true, "AttributeName": "ttl" } } ``` Weitere Informationen finden Sie unter [Time to Live](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/TTL.html) im *Entwicklerhandbuch zu Amazon DynamoDB*. + Einzelheiten zur API finden Sie [UpdateTimeToLive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodb/update-time-to-live.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für DynamoDB Streams mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Streams AWS Command Line Interface mit DynamoDB Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `describe-stream` Das folgende Codebeispiel zeigt, wie Sie. `describe-stream` **AWS CLI** **So rufen Sie Informationen zu einem DynamoDB-Stream ab** Der folgende `describe-stream`-Befehl zeigt Informationen über den angegebenen DynamoDB-Stream an. ``` aws dynamodbstreams describe-stream \ --stream-arn arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576 ``` Ausgabe: ``` { "StreamDescription": { "StreamArn": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576", "StreamLabel": "2019-10-22T18:02:01.576", "StreamStatus": "ENABLED", "StreamViewType": "NEW_AND_OLD_IMAGES", "CreationRequestDateTime": 1571767321.571, "TableName": "Music", "KeySchema": [ { "AttributeName": "Artist", "KeyType": "HASH" }, { "AttributeName": "SongTitle", "KeyType": "RANGE" } ], "Shards": [ { "ShardId": "shardId-00000001571767321804-697ce3d2", "SequenceNumberRange": { "StartingSequenceNumber": "4000000000000642977831", "EndingSequenceNumber": "4000000000000642977831" } }, { "ShardId": "shardId-00000001571780995058-40810d86", "SequenceNumberRange": { "StartingSequenceNumber": "757400000000005655171150" }, "ParentShardId": "shardId-00000001571767321804-697ce3d2" } ] } } ``` Weitere Informationen finden Sie unter [Erfassen der Tabellenaktivität mit DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [DescribeStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/describe-stream.html)in der *AWS CLI Befehlsreferenz*. ### `get-records` Das folgende Codebeispiel zeigt die Verwendung`get-records`. **AWS CLI** **So rufen Sie Datensätze aus einem DynamoDB-Stream ab** Der folgende `get-records`-Befehl ruft Datensätze mit dem angegebenen Shard-Iterator von Amazon DynamoDB ab. ``` aws dynamodbstreams get-records \ --shard-iterator "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576|1|AAAAAAAAAAGgM3YZ89vLZZxjmoQeo33r9M4x3+zmmTLsiL86MfrF4+B4EbsByi52InVmiONmy6xVW4IRcIIbs1zO7MNIlqZfx8WQzMwVDyINtGG2hCLg78JKbYxFasXeePGlApTyf3rJxR765uyOVaBvBHAJuwF2TXIuxhaAlOupNGHr52qAC3a49ZOmf+CjNPlqQjnyRSAnfOwWmKhL1/KNParWSfz2odf780oOObIDIWRRMkt7+Hyzh9SD+hFxFAWR5C7QIlOXPc8mRBfNIazfrVCjJK8/jsjCzsqNyXKzJbhh+GXCoxYN+Kpmg4nyj1EAsYhbGL35muvHFoHjcyuynbsczbWaXNfThDwRAyvoTmc8XhHKtAWUbJiaVd8ZPtQwDsThCrmDRPIdmTRGWllGfUr5ezN5LscvkQezzgpaU5p8BgCqRzjv5Vl8LB6wHgQWNG+w/lEGS05ha1qNP+Vl4+tuhz2TRnhnJo/pny9GI/yGpce97mWvSPr5KPwy+Dtcm5BHayBs+PVYHITaTliInFlT+LCwvaz1QH3MY3b8A05Z800wjpktm60iQqtMeDwN4NX6FrcxR34JoFKGsgR8XkHVJzz2xr1xqSJ12ycpNTyHnndusw==" ``` Ausgabe: ``` { "Records": [ { "eventID": "c3b5d798eef6215d42f8137b19a88e50", "eventName": "INSERT", "eventVersion": "1.1", "eventSource": "aws:dynamodb", "awsRegion": "us-west-1", "dynamodb": { "ApproximateCreationDateTime": 1571849028.0, "Keys": { "Artist": { "S": "No One You Know" }, "SongTitle": { "S": "Call Me Today" } }, "NewImage": { "AlbumTitle": { "S": "Somewhat Famous" }, "Artist": { "S": "No One You Know" }, "Awards": { "N": "1" }, "SongTitle": { "S": "Call Me Today" } }, "SequenceNumber": "700000000013256296913", "SizeBytes": 119, "StreamViewType": "NEW_AND_OLD_IMAGES" } }, { "eventID": "878960a6967867e2da16b27380a27328", "eventName": "INSERT", "eventVersion": "1.1", "eventSource": "aws:dynamodb", "awsRegion": "us-west-1", "dynamodb": { "ApproximateCreationDateTime": 1571849029.0, "Keys": { "Artist": { "S": "Acme Band" }, "SongTitle": { "S": "Happy Day" } }, "NewImage": { "AlbumTitle": { "S": "Songs About Life" }, "Artist": { "S": "Acme Band" }, "Awards": { "N": "10" }, "SongTitle": { "S": "Happy Day" } }, "SequenceNumber": "800000000013256297217", "SizeBytes": 100, "StreamViewType": "NEW_AND_OLD_IMAGES" } }, { "eventID": "520fabde080e159fc3710b15ee1d4daa", "eventName": "MODIFY", "eventVersion": "1.1", "eventSource": "aws:dynamodb", "awsRegion": "us-west-1", "dynamodb": { "ApproximateCreationDateTime": 1571849734.0, "Keys": { "Artist": { "S": "Acme Band" }, "SongTitle": { "S": "Happy Day" } }, "NewImage": { "AlbumTitle": { "S": "Updated Album Title" }, "Artist": { "S": "Acme Band" }, "Awards": { "N": "10" }, "SongTitle": { "S": "Happy Day" } }, "OldImage": { "AlbumTitle": { "S": "Songs About Life" }, "Artist": { "S": "Acme Band" }, "Awards": { "N": "10" }, "SongTitle": { "S": "Happy Day" } }, "SequenceNumber": "900000000013256687845", "SizeBytes": 170, "StreamViewType": "NEW_AND_OLD_IMAGES" } } ], "NextShardIterator": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-23T16:41:08.740|1|AAAAAAAAAAEhEI04jkFLW+LKOwivjT8d/IHEh3iExV2xK00aTxEzVy1C1C7Kbb5+ZOW6bT9VQ2n1/mrs7+PRiaOZCHJu7JHJVW7zlsqOi/ges3fw8GYEymyL+piEk35cx67rQqwKKyq+Q6w9JyjreIOj4F2lWLV26lBwRTrIYC4IB7C3BZZK4715QwYdDxNdVHiSBRZX8UqoS6WOt0F87xZLNB9F/NhYBLXi/wcGvAcBcC0TNIOH+N0NqwtoB/FGCkNrf8YZ0xRoNN6RgGuVWHF3pxOhxEJeFZoSoJTIKeG9YcYxzi5Ci/mhdtm7tBXnbw5c6xmsGsBqTirNjlDyJLcWl8Cl0UOLX63Ufo/5QliztcjEbKsQe28x8LM8o7VH1Is0fF/ITt8awSA4igyJS0P87GN8Qri8kj8iaE35805jBHWF2wvwT6Iy2xGrR2r2HzYps9dwGOarVdEITaJfWzNoL4HajMhmREZLYfM7Pb0PvRMO7JkENyPIU6e2w16W1CvJO2EGFIxtNk+V04i1YIeHMXJfcwetNRuIbdQXfJht2NQZa4PVV6iknY6d19MrdbSTMKoqAuvp6g3Q2jH4t7GKCLWgodcPAn8g5+43DaNkh4Z5zKOfNw==" } ``` Weitere Informationen finden Sie unter [Erfassen der Tabellenaktivität mit DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [GetRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/get-records.html)in der *AWS CLI Befehlsreferenz*. ### `get-shard-iterator` Das folgende Codebeispiel zeigt die Verwendung`get-shard-iterator`. **AWS CLI** **So rufen Sie einen Shard-Iterator ab** Der folgende `get-shard-iterator`-Befehl ruft einen Shard-Iterator für den angegebenen Shard ab. ``` aws dynamodbstreams get-shard-iterator \ --stream-arn arn:aws:dynamodb:us-west-1:12356789012:table/Music/stream/2019-10-22T18:02:01.576 \ --shard-id shardId-00000001571780995058-40810d86 \ --shard-iterator-type LATEST ``` Ausgabe: ``` { "ShardIterator": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576|1|AAAAAAAAAAGgM3YZ89vLZZxjmoQeo33r9M4x3+zmmTLsiL86MfrF4+B4EbsByi52InVmiONmy6xVW4IRcIIbs1zO7MNIlqZfx8WQzMwVDyINtGG2hCLg78JKbYxFasXeePGlApTyf3rJxR765uyOVaBvBHAJuwF2TXIuxhaAlOupNGHr52qAC3a49ZOmf+CjNPlqQjnyRSAnfOwWmKhL1/KNParWSfz2odf780oOObIDIWRRMkt7+Hyzh9SD+hFxFAWR5C7QIlOXPc8mRBfNIazfrVCjJK8/jsjCzsqNyXKzJbhh+GXCoxYN+Kpmg4nyj1EAsYhbGL35muvHFoHjcyuynbsczbWaXNfThDwRAyvoTmc8XhHKtAWUbJiaVd8ZPtQwDsThCrmDRPIdmTRGWllGfUr5ezN5LscvkQezzgpaU5p8BgCqRzjv5Vl8LB6wHgQWNG+w/lEGS05ha1qNP+Vl4+tuhz2TRnhnJo/pny9GI/yGpce97mWvSPr5KPwy+Dtcm5BHayBs+PVYHITaTliInFlT+LCwvaz1QH3MY3b8A05Z800wjpktm60iQqtMeDwN4NX6FrcxR34JoFKGsgR8XkHVJzz2xr1xqSJ12ycpNTyHnndusw==" } ``` Weitere Informationen finden Sie unter [Erfassen der Tabellenaktivität mit DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [GetShardIterator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/get-shard-iterator.html)in der *AWS CLI Befehlsreferenz*. ### `list-streams` Das folgende Codebeispiel zeigt die Verwendung`list-streams`. **AWS CLI** **So führen Sie DynamoDB-Streams auf** Der folgende `list-streams` Befehl listet alle vorhandenen Amazon DynamoDB DynamoDB-Streams in der AWS Standardregion auf. ``` aws dynamodbstreams list-streams ``` Ausgabe: ``` { "Streams": [ { "StreamArn": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576", "TableName": "Music", "StreamLabel": "2019-10-22T18:02:01.576" } ] } ``` Weitere Informationen finden Sie unter [Erfassen der Tabellenaktivität mit DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) im *Entwicklerhandbuch für Amazon DynamoDB*. + Einzelheiten zur API finden Sie [ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/list-streams.html)in der *AWS CLI Befehlsreferenz*. # Amazon EC2 EC2-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon EC2 Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `accept-address-transfer` Das folgende Codebeispiel zeigt, wie Sie`accept-address-transfer`. **AWS CLI** **So akzeptieren Sie die Übertragung einer Elastic-IP-Adresse auf Ihr Konto** Im folgenden Beispiel für `accept-address-transfer` wird die Übertragung der angegebenen Elastic-IP-Adresse auf Ihr Konto akzeptiert. ``` aws ec2 accept-address-transfer \ --address 100.21.184.216 ``` Ausgabe: ``` { "AddressTransfer": { "PublicIp": "100.21.184.216", "AllocationId": "eipalloc-09ad461b0d03f6aaf", "TransferAccountId": "123456789012", "TransferOfferExpirationTimestamp": "2023-02-22T20:51:10.000Z", "TransferOfferAcceptedTimestamp": "2023-02-22T22:52:54.000Z", "AddressTransferStatus": "accepted" } } ``` Weitere Informationen finden Sie unter [Übertragen von Elastic-IP-Adressen](https://docs.aws.amazon.com/vpc/latest/userguide/WorkWithEIPs.html#transfer-EIPs-intro) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [AcceptAddressTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/accept-address-transfer.html)in der *AWS CLI Befehlsreferenz*. ### `accept-reserved-instances-exchange-quote` Das folgende Codebeispiel zeigt die Verwendung`accept-reserved-instances-exchange-quote`. **AWS CLI** **So führen Sie einen Austausch von Convertible Reserved Instances durch** In diesem Beispiel wird ein Austausch der angegebenen Convertible Reserved Instances durchgeführt. Befehl: ``` aws ec2 accept-reserved-instances-exchange-quote --reserved-instance-ids 7b8750c3-397e-4da4-bbcb-a45ebexample --target-configurations OfferingId=b747b472-423c-48f3-8cee-679bcexample ``` Ausgabe: ``` { "ExchangeId": "riex-e68ed3c1-8bc8-4c17-af77-811afexample" } ``` + Einzelheiten zur API finden Sie [AcceptReservedInstancesExchangeQuote](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/accept-reserved-instances-exchange-quote.html)in der *AWS CLI Befehlsreferenz*. ### `accept-transit-gateway-peering-attachment` Das folgende Codebeispiel zeigt die Verwendung`accept-transit-gateway-peering-attachment`. **AWS CLI** **So akzeptieren Sie einen Anhang von Transit-Gateway-Peering** Im folgenden Beispiel für `accept-transit-gateway-peering-attachment` wird der angegebene Anhang von Transit-Gateway-Peering akzeptiert. Der Parameter `--region` gibt die Region an, in der sich das annehmende Transit-Gateway befindet. ``` aws ec2 accept-transit-gateway-peering-attachment \ --transit-gateway-attachment-id tgw-attach-4455667788aabbccd \ --region us-east-2 ``` Ausgabe: ``` { "TransitGatewayPeeringAttachment": { "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd", "RequesterTgwInfo": { "TransitGatewayId": "tgw-123abc05e04123abc", "OwnerId": "123456789012", "Region": "us-west-2" }, "AccepterTgwInfo": { "TransitGatewayId": "tgw-11223344aabbcc112", "OwnerId": "123456789012", "Region": "us-east-2" }, "State": "pending", "CreationTime": "2019-12-09T11:38:31.000Z" } } ``` Weitere Informationen finden Sie unter [Anhänge von Transit-Gateway-Peering](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-peering.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [AcceptTransitGatewayPeeringAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/accept-transit-gateway-peering-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `accept-transit-gateway-vpc-attachment` Das folgende Codebeispiel zeigt die Verwendung`accept-transit-gateway-vpc-attachment`. **AWS CLI** **So akzeptieren Sie eine Anforderung, eine VPC an ein Transit-Gateway anzuhängen.** Im folgenden Beispiel für `accept-transit-gateway-vpc-attachment` werden die Anforderung für den angegebenen Anhang akzeptiert. ``` aws ec2 accept-transit-gateway-vpc-attachment \ --transit-gateway-attachment-id tgw-attach-0a34fe6b4fEXAMPLE ``` Ausgabe: ``` { "TransitGatewayVpcAttachment": { "TransitGatewayAttachmentId": "tgw-attach-0a34fe6b4fEXAMPLE", "TransitGatewayId": "tgw-0262a0e521EXAMPLE", "VpcId": "vpc-07e8ffd50fEXAMPLE", "VpcOwnerId": "123456789012", "State": "pending", "SubnetIds": [ "subnet-0752213d59EXAMPLE" ], "CreationTime": "2019-07-10T17:33:46.000Z", "Options": { "DnsSupport": "enable", "Ipv6Support": "disable" } } } ``` Weitere Informationen finden Sie unter [Transit-Gateway-Anhänge an eine VPC](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [AcceptTransitGatewayVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/accept-transit-gateway-vpc-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `accept-vpc-endpoint-connections` Das folgende Codebeispiel zeigt die Verwendung`accept-vpc-endpoint-connections`. **AWS CLI** **So akzeptieren Sie eine Verbindungsanforderung für einen Schnittstellenendpunkt** In diesem Beispiel wird die angegebene Endpunkt-Verbindungsanforderung für den genannten Endpunktservice akzeptiert. Befehl: ``` aws ec2 accept-vpc-endpoint-connections --service-id vpce-svc-03d5ebb7d9579a2b3 --vpc-endpoint-ids vpce-0c1308d7312217abc ``` Ausgabe: ``` { "Unsuccessful": [] } ``` + Einzelheiten zur API finden Sie [AcceptVpcEndpointConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/accept-vpc-endpoint-connections.html)in der *AWS CLI Befehlsreferenz*. ### `accept-vpc-peering-connection` Das folgende Codebeispiel zeigt die Verwendung`accept-vpc-peering-connection`. **AWS CLI** **So akzeptieren Sie eine VPC-Peering-Verbindung** In diesem Beispiel wird die angegebene VPC-Peering-Verbindungsanforderung akzeptiert. Befehl: ``` aws ec2 accept-vpc-peering-connection --vpc-peering-connection-id pcx-1a2b3c4d ``` Ausgabe: ``` { "VpcPeeringConnection": { "Status": { "Message": "Provisioning", "Code": "provisioning" }, "Tags": [], "AccepterVpcInfo": { "OwnerId": "444455556666", "VpcId": "vpc-44455566", "CidrBlock": "10.0.1.0/28" }, "VpcPeeringConnectionId": "pcx-1a2b3c4d", "RequesterVpcInfo": { "OwnerId": "444455556666", "VpcId": "vpc-111abc45", "CidrBlock": "10.0.0.0/28" } } } ``` + Einzelheiten zur API finden Sie [AcceptVpcPeeringConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/accept-vpc-peering-connection.html)in der *AWS CLI Befehlsreferenz*. ### `advertise-byoip-cidr` Das folgende Codebeispiel zeigt die Verwendung`advertise-byoip-cidr`. **AWS CLI** **So geben Sie einen Adressbereich bekannt** Im folgenden `advertise-byoip-cidr` Beispiel wird der angegebene öffentliche IPv4 Adressbereich angekündigt. ``` aws ec2 advertise-byoip-cidr \ --cidr 203.0.113.25/24 ``` Ausgabe: ``` { "ByoipCidr": { "Cidr": "203.0.113.25/24", "StatusMessage": "ipv4pool-ec2-1234567890abcdef0", "State": "provisioned" } } ``` + Einzelheiten zur API finden Sie unter [AdvertiseByoipCidr AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/advertise-byoip-cidr.html)*Befehlsreferenz.* ### `allocate-address` Das folgende Codebeispiel zeigt die Verwendung`allocate-address`. **AWS CLI** **Beispiel 1: So weisen Sie eine Elastic-IP-Adresse aus dem Adress-Pool von Amazon zu** Im folgenden Beispiel für `allocate-address` wird eine Elastic-IP-Adresse zugewiesen. Amazon EC2 wählt die Adresse aus dem Adress-Pool von Amazon aus. ``` aws ec2 allocate-address ``` Ausgabe: ``` { "PublicIp": "70.224.234.241", "AllocationId": "eipalloc-01435ba59eEXAMPLE", "PublicIpv4Pool": "amazon", "NetworkBorderGroup": "us-west-2", "Domain": "vpc" } ``` Weitere Informationen finden Sie unter [Elastische IP-Adressen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 2: So weisen Sie eine Elastic-IP-Adresse zu und verknüpfen sie mit einer Netzwerkgrenzgruppe** Im folgenden Beispiel für `allocate-address` wird eine Elastic-IP-Adresse zugewiesen und sie der angegebenen Netzwerkgrenzgruppe zugeordnet. ``` aws ec2 allocate-address \ --network-border-group us-west-2-lax-1 ``` Ausgabe: ``` { "PublicIp": "70.224.234.241", "AllocationId": "eipalloc-e03dd489ceEXAMPLE", "PublicIpv4Pool": "amazon", "NetworkBorderGroup": "us-west-2-lax-1", "Domain": "vpc" } ``` Weitere Informationen finden Sie unter [Elastische IP-Adressen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 3: So weisen Sie eine Elastic-IP-Adresse aus einem Adress-Pool zu, der Ihnen gehört** Im folgenden Beispiel für `allocate-address` wird eine Elastic-IP-Adresse aus einem Adress-Pool zugewiesen, den Sie in Ihr Amazon-Web-Services-Konto eingebunden haben. Amazon EC2 wählt die Adresse aus dem Adress-Pool aus. ``` aws ec2 allocate-address \ --public-ipv4-pool ipv4pool-ec2-1234567890abcdef0 ``` Ausgabe: ``` { "AllocationId": "eipalloc-02463d08ceEXAMPLE", "NetworkBorderGroup": "us-west-2", "CustomerOwnedIp": "18.218.95.81", "CustomerOwnedIpv4Pool": "ipv4pool-ec2-1234567890abcdef0", "Domain": "vpc" "NetworkBorderGroup": "us-west-2", } ``` Weitere Informationen finden Sie unter [Elastische IP-Adressen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 4: So weisen Sie eine Elastic-IP-Adresse aus einem IPAM-Pool zu** Im folgenden Beispiel für `allocate-address` wird eine bestimmte /32 Elastic-IP-Adresse aus einem Pool von Amazon VPC IP Address Manager (IPAM) zugewiesen. ``` aws ec2 allocate-address \ --region us-east-1 \ --ipam-pool-id ipam-pool-1234567890abcdef0 \ --address 192.0.2.0 ``` Ausgabe: ``` { "PublicIp": "192.0.2.0", "AllocationId": "eipalloc-abcdef01234567890", "PublicIpv4Pool": "ipam-pool-1234567890abcdef0", "NetworkBorderGroup": "us-east-1", "Domain": "vpc" } ``` Weitere Informationen finden Sie unter [Zuweisen sequenzieller Elastic IP-Adressen aus einem IPAM-Pool](https://docs.aws.amazon.com/vpc/latest/ipam/tutorials-eip-pool.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [AllocateAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/allocate-address.html)in der *AWS CLI Befehlsreferenz*. ### `allocate-hosts` Das folgende Codebeispiel zeigt die Verwendung`allocate-hosts`. **AWS CLI** **Beispiel 1: So weisen Sie einen Dedicated Host zu** Im folgenden Beispiel für `allocate-hosts` wird ein einzelner Dedicated Host in der Availability Zone `eu-west-1a` zugewiesen, auf dem Sie `m5.large`-Instances starten können. Standardmäßig akzeptiert der Dedicated Host nur das Starten von Ziel-Instances und unterstützt keine Host-Wiederherstellung. ``` aws ec2 allocate-hosts \ --instance-type m5.large \ --availability-zone eu-west-1a \ --quantity 1 ``` Ausgabe: ``` { "HostIds": [ "h-07879acf49EXAMPLE" ] } ``` **Beispiel 2: So weisen Sie einen Dedicated Host mit aktivierter automatischer Platzierung und Host-Wiederherstellung zu** Im folgenden Beispiel für `allocate-hosts` wird ein einzelner Dedicated Host in der Availability Zone `eu-west-1a` zugewiesen, wobei die automatische Platzierung und die Host-Wiederherstellung aktiviert sind. ``` aws ec2 allocate-hosts \ --instance-type m5.large \ --availability-zone eu-west-1a \ --auto-placement on \ --host-recovery on \ --quantity 1 ``` Ausgabe: ``` { "HostIds": [ "h-07879acf49EXAMPLE" ] } ``` **Beispiel 3: So weisen Sie einen Dedicated Host mit Tags zu** Im folgenden Beispiel für `allocate-hosts` wird ein einzelner Dedicated Host zugewiesen und mit einem Tag mit dem Schlüssel `purpose` und dem Wert `production` versehen. ``` aws ec2 allocate-hosts \ --instance-type m5.large \ --availability-zone eu-west-1a \ --quantity 1 \ --tag-specifications 'ResourceType=dedicated-host,Tags={Key=purpose,Value=production}' ``` Ausgabe: ``` { "HostIds": [ "h-07879acf49EXAMPLE" ] } ``` Weitere Informationen finden Sie unter [Zuweisen eines Dedicated Hosts](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/dedicated-hosts-allocating.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [AllocateHosts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/allocate-hosts.html)in der *AWS CLI Befehlsreferenz*. ### `allocate-ipam-pool-cidr` Das folgende Codebeispiel zeigt die Verwendung`allocate-ipam-pool-cidr`. **AWS CLI** **So weisen Sie ein CIDR aus einem IPAM-Pool zu** Im folgenden Beispiel für `allocate-ipam-pool-cidr` wird ein CIDR aus einem IPAM-Pool zugewiesen. (Linux) ``` aws ec2 allocate-ipam-pool-cidr \ --ipam-pool-id ipam-pool-0533048da7d823723 \ --netmask-length 24 ``` (Windows) ``` aws ec2 allocate-ipam-pool-cidr ^ --ipam-pool-id ipam-pool-0533048da7d823723 ^ --netmask-length 24 ``` Ausgabe: ``` { "IpamPoolAllocation": { "Cidr": "10.0.0.0/24", "IpamPoolAllocationId": "ipam-pool-alloc-018ecc28043b54ba38e2cd99943cebfbd", "ResourceType": "custom", "ResourceOwner": "123456789012" } } ``` Weitere Informationen finden Sie unter [Manuelles Zuweisen eines CIDR zu einem Pool, um einen IP-Adressbereich zu reservieren](https://docs.aws.amazon.com/vpc/latest/ipam/manually-allocate-ipam.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [AllocateIpamPoolCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/allocate-ipam-pool-cidr.html)in der *AWS CLI Befehlsreferenz*. ### `apply-security-groups-to-client-vpn-target-network` Das folgende Codebeispiel zeigt die Verwendung`apply-security-groups-to-client-vpn-target-network`. **AWS CLI** **So wenden Sie Sicherheitsgruppen auf ein Zielnetzwerk für einen Client-VPN-Endpunkt an** Im folgenden Beispiel für `apply-security-groups-to-client-vpn-target-network` wird die Sicherheitsgruppe `sg-01f6e627a89f4db32` für die Zuordnung zwischen dem angegebenen Ziel-Netzwerk und dem Client-VPN-Endpunkt angewendet. ``` aws ec2 apply-security-groups-to-client-vpn-target-network \ --security-group-ids sg-01f6e627a89f4db32 \ --vpc-id vpc-0e2110c2f324332e0 \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde ``` Ausgabe: ``` { "SecurityGroupIds": [ "sg-01f6e627a89f4db32" ] } ``` Weitere Informationen finden Sie unter [Zielnetzwerke](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-target.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [ApplySecurityGroupsToClientVpnTargetNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/apply-security-groups-to-client-vpn-target-network.html)in der *AWS CLI Befehlsreferenz*. ### `assign-ipv6-addresses` Das folgende Codebeispiel zeigt die Verwendung`assign-ipv6-addresses`. **AWS CLI** **Um einer Netzwerkschnittstelle bestimmte IPv6 Adressen zuzuweisen** In diesem Beispiel werden die angegebenen IPv6 Adressen der angegebenen Netzwerkschnittstelle zugewiesen. Befehl: ``` aws ec2 assign-ipv6-addresses --network-interface-id eni-38664473 --ipv6-addresses 2001:db8:1234:1a00:3304:8879:34cf:4071 2001:db8:1234:1a00:9691:9503:25ad:1761 ``` Ausgabe: ``` { "AssignedIpv6Addresses": [ "2001:db8:1234:1a00:3304:8879:34cf:4071", "2001:db8:1234:1a00:9691:9503:25ad:1761" ], "NetworkInterfaceId": "eni-38664473" } ``` **Um IPv6 Adressen, die Amazon auswählt, einer Netzwerkschnittstelle zuzuweisen** In diesem Beispiel werden der angegebenen Netzwerkschnittstelle zwei IPv6 Adressen zugewiesen. Amazon weist diese IPv6 Adressen automatisch aus den verfügbaren IPv6 Adressen im IPv6 CIDR-Blockbereich des Subnetzes zu. Befehl: ``` aws ec2 assign-ipv6-addresses --network-interface-id eni-38664473 --ipv6-address-count 2 ``` Ausgabe: ``` { "AssignedIpv6Addresses": [ "2001:db8:1234:1a00:3304:8879:34cf:4071", "2001:db8:1234:1a00:9691:9503:25ad:1761" ], "NetworkInterfaceId": "eni-38664473" } ``` + *Einzelheiten zur API finden Sie unter [AssignIpv6Addresses in der Befehlsreferenz](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/assign-ipv6-addresses.html).AWS CLI * ### `assign-private-ip-addresses` Das folgende Codebeispiel zeigt die Verwendung`assign-private-ip-addresses`. **AWS CLI** **So weisen Sie einer Netzwerkschnittstelle eine bestimmte sekundäre private IP-Adresse zu** In diesem Beispiel werden die genannten sekundären privaten IP-Adressen der angegebenen Netzwerkschnittstelle zugewiesen. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 assign-private-ip-addresses --network-interface-id eni-e5aa89a3 --private-ip-addresses 10.0.0.82 ``` **So weisen Sie einer Netzwerkschnittstelle sekundäre private IP-Adressen zu, die Amazon EC2 auswählt** In diesem Beispiel werden zwei sekundäre private IP-Adressen der angegebenen Netzwerkschnittstelle zugewiesen. Amazon EC2 weist diese IP-Adressen automatisch aus den verfügbaren IP-Adressen im CIDR-Blockbereich des Subnetzes zu, dem die Netzwerkschnittstelle zugeordnet ist. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 assign-private-ip-addresses --network-interface-id eni-e5aa89a3 --secondary-private-ip-address-count 2 ``` + Einzelheiten zur API finden Sie [AssignPrivateIpAddresses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/assign-private-ip-addresses.html)in der *AWS CLI Befehlsreferenz*. ### `assign-private-nat-gateway-address` Das folgende Codebeispiel zeigt die Verwendung`assign-private-nat-gateway-address`. **AWS CLI** **So weisen Sie Ihrem privaten NAT-Gateway private IP-Adressen zu** Im folgenden Beispiel für `assign-private-nat-gateway-address` werden dem angegebenen privaten NAT-Gateway zwei private IP-Adressen zugewiesen. ``` aws ec2 assign-private-nat-gateway-address \ --nat-gateway-id nat-1234567890abcdef0 \ --private-ip-address-count 2 ``` Ausgabe: ``` { "NatGatewayId": "nat-1234567890abcdef0", "NatGatewayAddresses": [ { "NetworkInterfaceId": "eni-0065a61b324d1897a", "IsPrimary": false, "Status": "assigning" }, { "NetworkInterfaceId": "eni-0065a61b324d1897a", "IsPrimary": false, "Status": "assigning" } ] } ``` Weitere Informationen finden Sie unter [NAT-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [AssignPrivateNatGatewayAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/assign-private-nat-gateway-address.html)in der *AWS CLI Befehlsreferenz*. ### `associate-address` Das folgende Codebeispiel zeigt die Verwendung`associate-address`. **AWS CLI** **Beispiel 1: So ordnen Sie eine Elastic-IP-Adresse einer Instance zu** Im folgenden Beispiel für `associate-address` wird eine Elastic-IP-Adresse der angegebenen EC2-Instance zugeordnet. ``` aws ec2 associate-address \ --instance-id i-0b263919b6498b123 \ --allocation-id eipalloc-64d5890a ``` Ausgabe: ``` { "AssociationId": "eipassoc-2bebb745" } ``` **Beispiel 2: So ordnen Sie einer Elastic-IP-Adresse eine Netzwerkschnittstelle zu** Im folgenden Beispiel für `associate-address` wird die angegebene Elastic-IP-Adresse der genannten Netzwerkschnittstelle zugeordnet. ``` aws ec2 associate-address --allocation-id eipalloc-64d5890a \ --network-interface-id eni-1a2b3c4d ``` Ausgabe: ``` { "AssociationId": "eipassoc-2bebb745" } ``` **Beispiel 3: So weisen Sie einer Elastic-IP-Adresse eine private IP-Adresse zu** Im folgenden Beispiel für `associate-address` wird die angegebene Elastic-IP-Adresse der festgelegten privaten IP-Adresse in der genannten Netzwerkschnittstelle zugeordnet. ``` aws ec2 associate-address \ --allocation-id eipalloc-64d5890a \ --network-interface-id eni-1a2b3c4d \ --private-ip-address 10.0.0.85 ``` Ausgabe: ``` { "AssociationId": "eipassoc-2bebb745" } ``` Weitere Informationen finden Sie unter [Elastische IP-Adressen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [AssociateAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-address.html)in der *AWS CLI Befehlsreferenz*. ### `associate-client-vpn-target-network` Das folgende Codebeispiel zeigt die Verwendung`associate-client-vpn-target-network`. **AWS CLI** **So ordnen Sie ein Zielnetzwerk einem Client-VPN-Endpunkt zu** Im folgenden Beispiel für `associate-client-vpn-target-network` wird ein Subnetz einem angegebenen Client-VPN-Endpunkt zugeordnet. ``` aws ec2 associate-client-vpn-target-network \ --subnet-id subnet-0123456789abcabca \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde ``` Ausgabe: ``` { "AssociationId": "cvpn-assoc-12312312312312312", "Status": { "Code": "associating" } } ``` Weitere Informationen finden Sie unter [Zielnetzwerke](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-target.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [AssociateClientVpnTargetNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-client-vpn-target-network.html)in der *AWS CLI Befehlsreferenz*. ### `associate-dhcp-options` Das folgende Codebeispiel zeigt die Verwendung`associate-dhcp-options`. **AWS CLI** **So ordnen Sie Ihrer VPC einen DHCP-Optionssatz zu** In diesem Beispiel wird der angegebenen VPC der genannte DHCP-Optionssatz zugeordnet. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 associate-dhcp-options --dhcp-options-id dopt-d9070ebb --vpc-id vpc-a01106c2 ``` **So ordnen Sie Ihrer VPC den standardmäßigen DHCP-Optionssatz zu** In diesem Beispiel wird der angegebenen VPC der standardmäßige DHCP-Optionssatz zugeordnet. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 associate-dhcp-options --dhcp-options-id default --vpc-id vpc-a01106c2 ``` + Einzelheiten zur API finden Sie [AssociateDhcpOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-dhcp-options.html)in der *AWS CLI Befehlsreferenz*. ### `associate-iam-instance-profile` Das folgende Codebeispiel zeigt die Verwendung`associate-iam-instance-profile`. **AWS CLI** **So ordnen Sie einer Instance ein IAM-Instance-Profil zu** In diesem Beispiel wird der Instance `i-123456789abcde123` ein IAM-Instance-Profil mit dem Namen `admin-role` zugeordnet. Befehl: ``` aws ec2 associate-iam-instance-profile --instance-id i-123456789abcde123 --iam-instance-profile Name=admin-role ``` Ausgabe: ``` { "IamInstanceProfileAssociation": { "InstanceId": "i-123456789abcde123", "State": "associating", "AssociationId": "iip-assoc-0e7736511a163c209", "IamInstanceProfile": { "Id": "AIPAJBLK7RKJKWDXVHIEC", "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role" } } } ``` + Einzelheiten zur API finden Sie [AssociateIamInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-iam-instance-profile.html)in der *AWS CLI Befehlsreferenz*. ### `associate-instance-event-window` Das folgende Codebeispiel zeigt die Verwendung`associate-instance-event-window`. **AWS CLI** **Beispiel 1: So ordnen Sie einem Ereignisfenster eine oder mehrere Instances zu** Im folgenden Beispiel für `associate-instance-event-window` werden einem Ereignisfenster eine oder mehrere Instances zugeordnet. ``` aws ec2 associate-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7" ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [ "i-1234567890abcdef0", "i-0598c7d356eba48d7" ], "Tags": [], "DedicatedHostIds": [] }, "State": "creating" } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. **Beispiel 2: So ordnen Sie einem Ereignisfenster Instance-Tags zu** Im folgenden Beispiel für `associate-instance-event-window` werden einem Ereignisfenster Instance-Tags zugeordnet. Geben Sie einen `instance-event-window-id`-Parameter ein, um das Ereignisfenster zu spezifizieren. Zum Zuordnen von Instance-Tags geben Sie den `association-target`-Parameter und für den Parameterwert ein oder mehrere Tags an. ``` aws ec2 associate-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]" ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [ { "Key": "k2", "Value": "v2" }, { "Key": "k1", "Value": "v1" } ], "DedicatedHostIds": [] }, "State": "creating" } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. **Beispiel 3: So ordnen Sie einem Ereignisfenster einen Dedicated Host zu** Im folgenden Beispiel für `associate-instance-event-window` wird einem Ereignisfenster ein Dedicated Host zugeordnet. Geben Sie einen `instance-event-window-id`-Parameter ein, um das Ereignisfenster zu spezifizieren. Um einen Dedicated Host zuzuordnen, geben Sie den `--association-target` Parameter und für die Parameterwerte einen oder mehrere Dedicated Hosts an IDs. ``` aws ec2 associate-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "DedicatedHostIds=h-029fa35a02b99801d" ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [], "DedicatedHostIds": [ "h-029fa35a02b99801d" ] }, "State": "creating" } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. + Einzelheiten zur API finden Sie [AssociateInstanceEventWindow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-instance-event-window.html)in der *AWS CLI Befehlsreferenz*. ### `associate-ipam-resource-discovery` Das folgende Codebeispiel zeigt die Verwendung`associate-ipam-resource-discovery`. **AWS CLI** **So ordnen Sie einem IPAM eine Ressourcenerkennung zu** In diesem Beispiel sind Sie ein delegierter IPAM-Administrator, und ein anderes AWS Konto hat eine Ressourcenerkennung erstellt und mit Ihnen geteilt, sodass Sie IPAM verwenden können, um Ressourcen zu verwalten und zu überwachen, die dem anderen Konto CIDRs gehören. Hinweis Um diese Anfrage abzuschließen, benötigen Sie die Resource Discovery-ID, die Sie erhalten können, [describe-ipam-resource-discoveries](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-ipam-resource-discoveries.html)und die IPAM-ID, die Sie mit [describe-ipams](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-ipams.html) erhalten können. Die Resource Discovery, die Sie verknüpfen, muss zuerst über AWS RAM mit Ihrem Konto geteilt worden sein. Die von `--region` Ihnen eingegebene Region muss mit der Heimatregion des IPAM übereinstimmen, mit dem Sie sie verknüpfen. Im folgenden Beispiel für `associate-ipam-resource-discovery` wird einem IPAM eine Ressourcenerkennung zugeordnet. ``` aws ec2 associate-ipam-resource-discovery \ --ipam-id ipam-005f921c17ebd5107 \ --ipam-resource-discovery-id ipam-res-disco-03e0406de76a044ee \ --tag-specifications 'ResourceType=ipam-resource-discovery,Tags=[{Key=cost-center,Value=cc123}]' \ --region us-east-1 ``` Ausgabe: ``` { { "IpamResourceDiscoveryAssociation": { "OwnerId": "320805250157", "IpamResourceDiscoveryAssociationId": "ipam-res-disco-assoc-04382a6346357cf82", "IpamResourceDiscoveryAssociationArn": "arn:aws:ec2::320805250157:ipam-resource-discovery-association/ipam-res-disco-assoc-04382a6346357cf82", "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe", "IpamId": "ipam-005f921c17ebd5107", "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107", "IpamRegion": "us-east-1", "IsDefault": false, "ResourceDiscoveryStatus": "active", "State": "associate-in-progress", "Tags": [] } } } ``` Sobald Sie eine Resource Discovery verknüpft haben, können Sie die IP-Adressen der Ressourcen überwachen und and/or verwalten, die von den anderen Konten erstellt wurden. Weitere Informationen finden Sie unter [Integrieren von IPAM mit Konten außerhalb Ihrer Organisation](https://docs.aws.amazon.com/vpc/latest/ipam/enable-integ-ipam-outside-org.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [AssociateIpamResourceDiscovery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-ipam-resource-discovery.html)in der *AWS CLI Befehlsreferenz*. ### `associate-nat-gateway-address` Das folgende Codebeispiel zeigt die Verwendung`associate-nat-gateway-address`. **AWS CLI** **So ordnen Sie einem öffentlichen NAT-Gateway eine Elastic-IP-Adresse zu** Das folgende `associate-nat-gateway-address` Beispiel ordnet die angegebene Elastic IP-Adresse dem angegebenen öffentlichen NAT-Gateway zu. AWS weist automatisch eine sekundäre private IPv4 Adresse zu. ``` aws ec2 associate-nat-gateway-address \ --nat-gateway-id nat-1234567890abcdef0 \ --allocation-ids eipalloc-0be6ecac95EXAMPLE ``` Ausgabe: ``` { "NatGatewayId": "nat-1234567890abcdef0", "NatGatewayAddresses": [ { "AllocationId": "eipalloc-0be6ecac95EXAMPLE", "NetworkInterfaceId": "eni-09cc4b2558794f7f9", "IsPrimary": false, "Status": "associating" } ] } ``` Weitere Informationen finden Sie unter [NAT-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [AssociateNatGatewayAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-nat-gateway-address.html)in der *AWS CLI Befehlsreferenz.* ### `associate-route-table` Das folgende Codebeispiel zeigt die Verwendung`associate-route-table`. **AWS CLI** So ordnen Sie eine Routing-Tabelle einem Subnetz zu In diesem Beispiel wird die angegebene Routing-Tabelle dem festgelegten Subnetz zugeordnet. Befehl: ``` aws ec2 associate-route-table --route-table-id rtb-22574640 --subnet-id subnet-9d4a7b6c ``` Ausgabe: ``` { "AssociationId": "rtbassoc-781d0d1a" } ``` + Einzelheiten zur API finden Sie [AssociateRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `associate-security-group-vpc` Das folgende Codebeispiel zeigt die Verwendung`associate-security-group-vpc`. **AWS CLI** **So verknüpfen Sie eine Sicherheitsgruppe mit einer anderen VPC** Im folgenden Beispiel für `associate-security-group-vpc` wird die angegebene Sicherheitsgruppe mit der festgelegten VPC verknüpft. ``` aws ec2 associate-security-group-vpc \ --group-id sg-04dbb43907d3f8a78 \ --vpc-id vpc-0bf4c2739bc05a694 ``` Ausgabe: ``` { "State": "associating" } ``` Weitere Informationen finden Sie unter [Sicherheitsgruppen mehreren zuordnen VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/security-group-assoc.html) im *Amazon VPC-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [AssociateSecurityGroupVpc AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-security-group-vpc.html)*Befehlsreferenz.* ### `associate-subnet-cidr-block` Das folgende Codebeispiel zeigt die Verwendung`associate-subnet-cidr-block`. **AWS CLI** **Um einen IPv6 CIDR-Block einem Subnetz zuzuordnen** In diesem Beispiel wird dem angegebenen IPv6 Subnetz ein CIDR-Block zugeordnet. Befehl: ``` aws ec2 associate-subnet-cidr-block --subnet-id subnet-5f46ec3b --ipv6-cidr-block 2001:db8:1234:1a00::/64 ``` Ausgabe: ``` { "SubnetId": "subnet-5f46ec3b", "Ipv6CidrBlockAssociation": { "Ipv6CidrBlock": "2001:db8:1234:1a00::/64", "AssociationId": "subnet-cidr-assoc-3aa54053", "Ipv6CidrBlockState": { "State": "associating" } } } ``` + Einzelheiten zur API finden Sie unter [AssociateSubnetCidrBlock AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-subnet-cidr-block.html)*Befehlsreferenz*. ### `associate-transit-gateway-multicast-domain` Das folgende Codebeispiel zeigt die Verwendung`associate-transit-gateway-multicast-domain`. **AWS CLI** **So ordnen Sie einer Multicast-Domain ein Transit-Gateway zu** Im folgenden Beispiel für `associate-transit-gateway-multicast-domain` werden das angegebene Subnetz und der Anhang der festgelegten Multicast-Domain zugeordnet. ``` aws ec2 associate-transit-gateway-multicast-domain \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \ --transit-gateway-attachment-id tgw-attach-028c1dd0f8f5cbe8e \ --subnet-ids subnet-000de86e3b49c932a \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE ``` Ausgabe: ``` { "Associations": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597", "TransitGatewayAttachmentId": "tgw-attach-028c1dd0f8f5cbe8e", "ResourceId": "vpc-01128d2c240c09bd5", "ResourceType": "vpc", "Subnets": [ { "SubnetId": "subnet-000de86e3b49c932a", "State": "associating" } ] } } ``` Weitere Informationen finden Sie unter [Multicast-Domains](https://docs.aws.amazon.com/vpc/latest/tgw/multicast-domains-about.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [AssociateTransitGatewayMulticastDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-transit-gateway-multicast-domain.html)in der *AWS CLI Befehlsreferenz*. ### `associate-transit-gateway-route-table` Das folgende Codebeispiel zeigt die Verwendung`associate-transit-gateway-route-table`. **AWS CLI** **So ordnen Sie einem Transit-Gateway-Anhang eine Routing-Tabelle von Transit Gateway zu** Im folgenden Beispiel wird der angegebene VPC-Anhang der festgelegten Routing-Tabelle von Transit Gateways zugeordnet. ``` aws ec2 associate-transit-gateway-route-table \ --transit-gateway-route-table-id tgw-rtb-002573ed1eEXAMPLE \ --transit-gateway-attachment-id tgw-attach-0b5968d3b6EXAMPLE ``` Ausgabe: ``` { "Association": { "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE", "TransitGatewayAttachmentId": "tgw-attach-0b5968d3b6EXAMPLE", "ResourceId": "vpc-0065acced4EXAMPLE", "ResourceType": "vpc", "State": "associating" } } ``` Weitere Informationen finden Sie unter [Zuordnen einer Routing-Tabelle in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html#associate-tgw-route-table) in * Handbuch für AWS Transit Gateways*. + Einzelheiten zur API finden Sie [AssociateTransitGatewayRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-transit-gateway-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `associate-vpc-cidr-block` Das folgende Codebeispiel zeigt die Verwendung`associate-vpc-cidr-block`. **AWS CLI** **Beispiel 1: So verknüpfen Sie einen von Amazon bereitgestellten IPv6 CIDR-Block mit einer VPC** Das folgende `associate-vpc-cidr-block` Beispiel ordnet der angegebenen IPv6 VPC einen CIDR-Block zu. : ``` aws ec2 associate-vpc-cidr-block \ --amazon-provided-ipv6-cidr-block \ --ipv6-cidr-block-network-border-group us-west-2-lax-1 \ --vpc-id vpc-8EXAMPLE ``` Ausgabe: ``` { "Ipv6CidrBlockAssociation": { "AssociationId": "vpc-cidr-assoc-0838ce7d9dEXAMPLE", "Ipv6CidrBlockState": { "State": "associating" }, "NetworkBorderGroup": "us-west-2-lax-1" }, "VpcId": "vpc-8EXAMPLE" } ``` **Beispiel 2: So verknüpfen Sie einen zusätzlichen IPv4 CIDR-Block mit einer VPC** Im folgenden `associate-vpc-cidr-block` Beispiel wird der IPv4 CIDR-Block `10.2.0.0/16` der angegebenen VPC zugeordnet. ``` aws ec2 associate-vpc-cidr-block \ --vpc-id vpc-1EXAMPLE \ --cidr-block 10.2.0.0/16 ``` Ausgabe: ``` { "CidrBlockAssociation": { "AssociationId": "vpc-cidr-assoc-2EXAMPLE", "CidrBlock": "10.2.0.0/16", "CidrBlockState": { "State": "associating" } }, "VpcId": "vpc-1EXAMPLE" } ``` + Einzelheiten zur API finden Sie unter [AssociateVpcCidrBlock AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/associate-vpc-cidr-block.html)*Befehlsreferenz*. ### `attach-classic-link-vpc` Das folgende Codebeispiel zeigt die Verwendung`attach-classic-link-vpc`. **AWS CLI** **So können Sie einer VPC eine EC2-Classic-Instance zuordnen (anfügen** In diesem Beispiel wird die Instance i-1234567890abcdef0 über die VPC-Sicherheitsgruppe sg-12312312 mit der VPC vpc-88888888 verknüpft. Befehl: ``` aws ec2 attach-classic-link-vpc --instance-id i-1234567890abcdef0 --vpc-id vpc-88888888 --groups sg-12312312 ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [AttachClassicLinkVpc](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/attach-classic-link-vpc.html)in der *AWS CLI Befehlsreferenz*. ### `attach-internet-gateway` Das folgende Codebeispiel zeigt die Verwendung`attach-internet-gateway`. **AWS CLI** **So hängen Sie Ihrer VPC ein Internet-Gateway an** Im folgenden Beispiel für `attach-internet-gateway` wird der spezifischen VPC das angegebene Internet-Gateway angehängt. ``` aws ec2 attach-internet-gateway \ --internet-gateway-id igw-0d0fb496b3EXAMPLE \ --vpc-id vpc-0a60eb65b4EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Internet-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [AttachInternetGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/attach-internet-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `attach-network-interface` Das folgende Codebeispiel zeigt die Verwendung`attach-network-interface`. **AWS CLI** **Beispiel 1: So fügen Sie einer Instance eine Netzwerkschnittstelle an** Im folgenden Beispiel für `attach-network-interface` wird der spezifischen Instance die angegebene Netzwerkschnittstelle angefügt. ``` aws ec2 attach-network-interface \ --network-interface-id eni-0dc56a8d4640ad10a \ --instance-id i-1234567890abcdef0 \ --device-index 1 ``` Ausgabe: ``` { "AttachmentId": "eni-attach-01a8fc87363f07cf9" } ``` Weitere Informationen finden Sie unter [Elastic Network-Schnittstellen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So fügen Sie einer Instance mit mehreren Netzwerkkarten eine Netzwerkschnittstelle an** Im folgenden Beispiel für `attach-network-interface` wird der spezifischen Instance und Netzwerkkarte die angegebene Netzwerkschnittstelle angefügt. ``` aws ec2 attach-network-interface \ --network-interface-id eni-07483b1897541ad83 \ --instance-id i-01234567890abcdef \ --network-card-index 1 \ --device-index 1 ``` Ausgabe: ``` { "AttachmentId": "eni-attach-0fbd7ee87a88cd06c" } ``` Weitere Informationen finden Sie unter [Elastic Network-Schnittstellen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [AttachNetworkInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/attach-network-interface.html)in der *AWS CLI Befehlsreferenz*. ### `attach-verified-access-trust-provider` Das folgende Codebeispiel zeigt die Verwendung`attach-verified-access-trust-provider`. **AWS CLI** **So fügen Sie einer Instance einen Vertrauensanbieter an** Im folgenden Beispiel für `attach-verified-access-trust-provider` wird der angegebenen Instance für verifizierten Zugriff der festgelegte Vertrauensanbieter für verifizierten Zugriff angefügt. ``` aws ec2 attach-verified-access-trust-provider \ --verified-access-instance-id vai-0ce000c0b7643abea \ --verified-access-trust-provider-id vatp-0bb32de759a3e19e7 ``` Ausgabe: ``` { "VerifiedAccessTrustProvider": { "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7", "Description": "", "TrustProviderType": "user", "UserTrustProviderType": "iam-identity-center", "PolicyReferenceName": "idc", "CreationTime": "2023-08-25T19:00:38", "LastUpdatedTime": "2023-08-25T19:00:38" }, "VerifiedAccessInstance": { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "", "VerifiedAccessTrustProviders": [ { "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7", "TrustProviderType": "user", "UserTrustProviderType": "iam-identity-center" } ], "CreationTime": "2023-08-25T18:27:56", "LastUpdatedTime": "2023-08-25T18:27:56" } } ``` Weitere Informationen finden Sie unter [Verified-Access-Instances](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-instances.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [AttachVerifiedAccessTrustProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/attach-verified-access-trust-provider.html)in der *AWS CLI Befehlsreferenz*. ### `attach-volume` Das folgende Codebeispiel zeigt die Verwendung`attach-volume`. **AWS CLI** **So hängen Sie einer Instance ein Volume an** Dieser Beispielbefehl hängt ein Volume (`vol-1234567890abcdef0`) an eine Instance (`i-01474ef662b89480`) als `/dev/sdf` an. Befehl: ``` aws ec2 attach-volume --volume-id vol-1234567890abcdef0 --instance-id i-01474ef662b89480 --device /dev/sdf ``` Ausgabe: ``` { "AttachTime": "YYYY-MM-DDTHH:MM:SS.000Z", "InstanceId": "i-01474ef662b89480", "VolumeId": "vol-1234567890abcdef0", "State": "attaching", "Device": "/dev/sdf" } ``` + Einzelheiten zur API finden Sie [AttachVolume](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/attach-volume.html)in der *AWS CLI Befehlsreferenz*. ### `attach-vpn-gateway` Das folgende Codebeispiel zeigt die Verwendung`attach-vpn-gateway`. **AWS CLI** **So fügen Sie Ihrer VPC ein Virtual Private Gateway an** Im folgenden Beispiel für `attach-vpn-gateway` wird der spezifischen VPC das angegebene Virtual Private Gateway angefügt. ``` aws ec2 attach-vpn-gateway \ --vpn-gateway-id vgw-9a4cacf3 \ --vpc-id vpc-a01106c2 ``` Ausgabe: ``` { "VpcAttachment": { "State": "attaching", "VpcId": "vpc-a01106c2" } } ``` + Einzelheiten zur API finden Sie [AttachVpnGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/attach-vpn-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `authorize-client-vpn-ingress` Das folgende Codebeispiel zeigt die Verwendung`authorize-client-vpn-ingress`. **AWS CLI** **So fügen Sie eine Autorisierungsregel für einen Client-VPN-Endpunkt hinzu** Im folgenden Beispiel für `authorize-client-vpn-ingress` wird eine Eingangsautorisierungsregel hinzugefügt, die allen Clients den Zugriff auf das Internet gewährt (`0.0.0.0/0`). ``` aws ec2 authorize-client-vpn-ingress \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \ --target-network-cidr 0.0.0.0/0 \ --authorize-all-groups ``` Ausgabe: ``` { "Status": { "Code": "authorizing" } } ``` Weitere Informationen finden Sie unter [Autorisierungsregeln](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-rules.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [AuthorizeClientVpnIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/authorize-client-vpn-ingress.html)in der *AWS CLI Befehlsreferenz*. ### `authorize-security-group-egress` Das folgende Codebeispiel zeigt die Verwendung`authorize-security-group-egress`. **AWS CLI** **Beispiel 1: So fügen Sie eine Regel hinzu, die ausgehenden Datenverkehr in einem bestimmten Adressbereich zulässt** Im folgenden Beispiel für `authorize-security-group-egress` wird eine Regel hinzugefügt, die Zugriff auf die angegebenen Adressbereiche am TCP-Port 80 gewährt. ``` aws ec2 authorize-security-group-egress \ --group-id sg-1234567890abcdef0 \ --ip-permissions 'IpProtocol=tcp,FromPort=80,ToPort=80,IpRanges=[{CidrIp=10.0.0.0/16}]' ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-0b15794cdb17bf29c", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": true, "IpProtocol": "tcp", "FromPort": 80, "ToPort": 80, "CidrIpv4": "10.0.0.0/16" } ] } ``` **Beispiel 2: So fügen Sie eine Regel hinzu, die ausgehenden Datenverkehr an eine bestimmte Sicherheitsgruppe zulässt** Im folgenden Beispiel für `authorize-security-group-egress` wird eine Regel hinzugefügt, die Zugriff auf die angegebene Sicherheitsgruppe am TCP-Port 80 gewährt. ``` aws ec2 authorize-security-group-egress \ --group-id sg-1234567890abcdef0 \ --ip-permissions 'IpProtocol=tcp,FromPort=80,ToPort=80,UserIdGroupPairs=[{GroupId=sg-0aad1c26bbeec5c22}]' ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-0b5dd815afcea9cc3", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": true, "IpProtocol": "tcp", "FromPort": 80, "ToPort": 80, "ReferencedGroupInfo": { "GroupId": "sg-0aad1c26bbeec5c22", "UserId": "123456789012" } } ] } ``` Weitere Informationen finden Sie unter [Sicherheitsgruppen](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [AuthorizeSecurityGroupEgress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/authorize-security-group-egress.html)in der *AWS CLI Befehlsreferenz*. ### `authorize-security-group-ingress` Das folgende Codebeispiel zeigt die Verwendung`authorize-security-group-ingress`. **AWS CLI** **Beispiel 1: So fügen Sie eine Regel hinzu, die eingehenden SSH-Datenverkehr zulässt** Im folgenden Beispiel für `authorize-security-group-ingress` wird eine Regel hinzugefügt, die eingehenden Datenverkehr auf TCP-Anschluss 22 (SSH) zulässt. ``` aws ec2 authorize-security-group-ingress \ --group-id sg-1234567890abcdef0 \ --protocol tcp \ --port 22 \ --cidr 203.0.113.0/24 ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-01afa97ef3e1bedfc", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "tcp", "FromPort": 22, "ToPort": 22, "CidrIpv4": "203.0.113.0/24" } ] } ``` **Beispiel 2: So fügen Sie eine Regel hinzu, die eingehenden HTTP-Datenverkehr aus einer anderen Sicherheitsgruppe zulässt** Im folgenden Beispiel für `authorize-security-group-ingress` wird eine Regel hinzugefügt, die eingehenden Zugriff auf TCP-Anschluss 80 von der Quellsicherheitsgruppe `sg-1a2b3c4d` aus ermöglicht. Die Quellgruppe muss sich in derselben VPC oder einer Peer-VPC befinden (dazu ist eine VPC-Peering-Verbindung erforderlich). Eingehender Datenverkehr ist basierend auf den privaten IP-Adressen der Instances erlaubt, die der Quellsicherheitsgruppe zugeordnet sind (nicht die öffentliche IP-Adresse oder die Elastic-IP-Adresse). ``` aws ec2 authorize-security-group-ingress \ --group-id sg-1234567890abcdef0 \ --protocol tcp \ --port 80 \ --source-group sg-1a2b3c4d ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-01f4be99110f638a7", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "tcp", "FromPort": 80, "ToPort": 80, "ReferencedGroupInfo": { "GroupId": "sg-1a2b3c4d", "UserId": "123456789012" } } ] } ``` **Beispiel 3: So fügen Sie mehrere Regeln im selben Aufruf hinzu** Im folgenden Beispiel für `authorize-security-group-ingress` werden mithilfe des `ip-permissions`-Parameters zwei Regeln für eingehenden Datenverkehr hinzugefügt, eine, die den eingehenden Zugriff auf TCP-Anschluss 3389 (RDP) ermöglicht und die andere, die Ping/ICMP aktiviert. ``` aws ec2 authorize-security-group-ingress \ --group-id sg-1234567890abcdef0 \ --ip-permissions 'IpProtocol=tcp,FromPort=3389,ToPort=3389,IpRanges=[{CidrIp=172.31.0.0/16}]' 'IpProtocol=icmp,FromPort=-1,ToPort=-1,IpRanges=[{CidrIp=172.31.0.0/16}]' ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-00e06e5d3690f29f3", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "tcp", "FromPort": 3389, "ToPort": 3389, "CidrIpv4": "172.31.0.0/16" }, { "SecurityGroupRuleId": "sgr-0a133dd4493944b87", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "tcp", "FromPort": -1, "ToPort": -1, "CidrIpv4": "172.31.0.0/16" } ] } ``` **Beispiel 4: So fügen Sie eine Regel für ICMP-Datenverkehr hinzu** Im folgenden Beispiel für `authorize-security-group-ingress` wird der `ip-permissions`-Parameter verwendet, um eine eingehende Regel hinzuzufügen, die die ICMP-Nachricht `Destination Unreachable: Fragmentation Needed and Don't Fragment was Set`(Typ 3, Code 4) von überall her zulässt. ``` aws ec2 authorize-security-group-ingress \ --group-id sg-1234567890abcdef0 \ --ip-permissions 'IpProtocol=icmp,FromPort=3,ToPort=4,IpRanges=[{CidrIp=0.0.0.0/0}]' ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-0de3811019069b787", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "icmp", "FromPort": 3, "ToPort": 4, "CidrIpv4": "0.0.0.0/0" } ] } ``` **Beispiel 5: Um eine Regel für den IPv6 Verkehr hinzuzufügen** Im folgenden `authorize-security-group-ingress` Beispiel wird der `ip-permissions` Parameter verwendet, um eine Regel für eingehenden Datenverkehr hinzuzufügen, die SSH-Zugriff (Port 22) aus dem IPv6 Bereich ermöglicht. `2001:db8:1234:1a00::/64` ``` aws ec2 authorize-security-group-ingress \ --group-id sg-1234567890abcdef0 \ --ip-permissions 'IpProtocol=tcp,FromPort=22,ToPort=22,Ipv6Ranges=[{CidrIpv6=2001:db8:1234:1a00::/64}]' ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-0455bc68b60805563", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "tcp", "FromPort": 22, "ToPort": 22, "CidrIpv6": "2001:db8:1234:1a00::/64" } ] } ``` **Beispiel 6: Um eine Regel für den Datenverkehr hinzuzufügen ICMPv6 ** Im folgenden `authorize-security-group-ingress` Beispiel wird der `ip-permissions` Parameter verwendet, um eine Regel für eingehenden Datenverkehr hinzuzufügen, die ICMPv6 Datenverkehr von überall her zulässt. ``` aws ec2 authorize-security-group-ingress \ --group-id sg-1234567890abcdef0 \ --ip-permissions 'IpProtocol=icmpv6,Ipv6Ranges=[{CidrIpv6=::/0}]' ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-04b612d9363ab6327", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "icmpv6", "FromPort": -1, "ToPort": -1, "CidrIpv6": "::/0" } ] } ``` **Beispiel 7: Eine Regel mit einer Beschreibung hinzufügen** Im folgenden `authorize-security-group-ingress` Beispiel wird der `ip-permissions` Parameter verwendet, um eine Regel für eingehenden Datenverkehr hinzuzufügen, die RDP-Verkehr aus dem angegebenen IPv4 Adressbereich zulässt. Die Regel enthält eine Beschreibung, die Ihnen später hilft, sie zu identifizieren. ``` aws ec2 authorize-security-group-ingress \ --group-id sg-1234567890abcdef0 \ --ip-permissions 'IpProtocol=tcp,FromPort=3389,ToPort=3389,IpRanges=[{CidrIp=203.0.113.0/24,Description='RDP access from NY office'}]' ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-0397bbcc01e974db3", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "tcp", "FromPort": 3389, "ToPort": 3389, "CidrIpv4": "203.0.113.0/24", "Description": "RDP access from NY office" } ] } ``` **Beispiel 8: So fügen Sie eine eingehende Regel hinzu, die eine Präfixliste verwendet** Im folgenden Beispiel für `authorize-security-group-ingress` wird der `ip-permissions`-Parameter verwendet, um eine Regel für eingehenden Datenverkehr hinzuzufügen, die den gesamten Datenverkehr für die CIDR-Bereiche in der angegebenen Präfixliste zulässt. ``` aws ec2 authorize-security-group-ingress \ --group-id sg-04a351bfe432d4e71 \ --ip-permissions 'IpProtocol=all,PrefixListIds=[{PrefixListId=pl-002dc3ec097de1514}]' ``` Ausgabe: ``` { "Return": true, "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-09c74b32f677c6c7c", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "-1", "FromPort": -1, "ToPort": -1, "PrefixListId": "pl-0721453c7ac4ec009" } ] } ``` Weitere Informationen finden Sie unter [Sicherheitsgruppen](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie unter [AuthorizeSecurityGroupIngress AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/authorize-security-group-ingress.html)*Befehlsreferenz*. ### `bundle-instance` Das folgende Codebeispiel zeigt die Verwendung`bundle-instance`. **AWS CLI** **So bündeln Sie eine Instance** In diesem Beispiel wird die Instance `i-1234567890abcdef0` zu einem Bucket namens `bundletasks` gebündelt. Bevor Sie Werte für Ihren Zugriffsschlüssel angeben IDs, lesen und befolgen Sie die Anleitungen unter Bewährte Methoden für die Verwaltung von AWS Zugriffsschlüsseln. Befehl: ``` aws ec2 bundle-instance --instance-id i-1234567890abcdef0 --bucket bundletasks --prefix winami --owner-akid AK12AJEXAMPLE --owner-sak example123example ``` Ausgabe: ``` { "BundleTask": { "UpdateTime": "2015-09-15T13:30:35.000Z", "InstanceId": "i-1234567890abcdef0", "Storage": { "S3": { "Prefix": "winami", "Bucket": "bundletasks" } }, "State": "pending", "StartTime": "2015-09-15T13:30:35.000Z", "BundleId": "bun-294e041f" } } ``` + Einzelheiten zur API finden Sie [BundleInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/bundle-instance.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-bundle-task` Das folgende Codebeispiel zeigt die Verwendung`cancel-bundle-task`. **AWS CLI** **So brechen Sie eine Bündelungsaufgabe ab** In diesem Beispiel wird die Bündelungsaufgabe `bun-2a4e041c` abgebrochen. Befehl: ``` aws ec2 cancel-bundle-task --bundle-id bun-2a4e041c ``` Ausgabe: ``` { "BundleTask": { "UpdateTime": "2015-09-15T13:27:40.000Z", "InstanceId": "i-1234567890abcdef0", "Storage": { "S3": { "Prefix": "winami", "Bucket": "bundletasks" } }, "State": "cancelling", "StartTime": "2015-09-15T13:24:35.000Z", "BundleId": "bun-2a4e041c" } } ``` + Einzelheiten zur API finden Sie [CancelBundleTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-bundle-task.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-capacity-reservation-fleets` Das folgende Codebeispiel zeigt die Verwendung`cancel-capacity-reservation-fleets`. **AWS CLI** **So stornieren Sie eine Kapazitätsreservierungsflotte** Im folgenden Beispiel für `cancel-capacity-reservation-fleets` werden die angegebene Kapazitätsreservierungsflotte und die reservierte Kapazität storniert. Wenn Sie eine Flotte stornieren, ändert sich ihr Zustand in `cancelled` und sie kann keine neuen Kapazitätsreservierungen mehr erstellen. Außerdem werden alle individuellen Kapazitätsreservierungen in der Flotte storniert und die Instances, die zuvor in der reservierten Kapazität ausgeführt wurden, werden mit gemeinsam genutzter Kapazität weiter ausgeführt. ``` aws ec2 cancel-capacity-reservation-fleets \ --capacity-reservation-fleet-ids crf-abcdef01234567890 ``` Ausgabe: ``` { "SuccessfulFleetCancellations": [ { "CurrentFleetState": "cancelling", "PreviousFleetState": "active", "CapacityReservationFleetId": "crf-abcdef01234567890" } ], "FailedFleetCancellations": [] } ``` Weitere Informationen zu Kapazitätsreservierungsflotten finden Sie unter [Kapazitätsreservierungsflotten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cr-fleets.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CancelCapacityReservationFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-capacity-reservation-fleets.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-capacity-reservation` Das folgende Codebeispiel zeigt die Verwendung`cancel-capacity-reservation`. **AWS CLI** **So stornieren Sie eine Kapazitätsreservierung** Im folgenden Beispiel für `cancel-capacity-reservation` wird die angegebene Kapazitätsreservierung storniert. ``` aws ec2 cancel-capacity-reservation \ --capacity-reservation-id cr-1234abcd56EXAMPLE ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter Stornieren einer Kapazitätsreservierung im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CancelCapacityReservation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-capacity-reservation.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-conversion-task` Das folgende Codebeispiel zeigt die Verwendung`cancel-conversion-task`. **AWS CLI** **So brechen Sie eine aktive Konvertierung einer Instance oder eines Volumes ab** In diesem Beispiel wird der Upload abgebrochen, der mit der Aufgaben-ID import-i-fh 95npoc verknüpft ist. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 cancel-conversion-task --conversion-task-id import-i-fh95npoc ``` + *Einzelheiten zur API finden Sie unter [CancelConversionTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-conversion-task.html)Befehlsreferenz.AWS CLI * ### `cancel-export-task` Das folgende Codebeispiel zeigt die Verwendung`cancel-export-task`. **AWS CLI** **So brechen Sie eine aktive Exportaufgabe ab** In diesem Beispiel wird eine aktive Exportaufgabe mit der Task-ID export-i-fgelt 0i7 abgebrochen. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 cancel-export-task --export-task-id export-i-fgelt0i7 ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz [CancelExportTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-export-task.html).AWS CLI * ### `cancel-image-launch-permission` Das folgende Codebeispiel zeigt die Verwendung`cancel-image-launch-permission`. **AWS CLI** **So heben Sie die Freigabe eines AMI für Ihr Konto von Amazon Web Services auf** Im folgenden Beispiel für `cancel-image-launch-permission` wird Ihr Konto aus den Startberechtigungen des angegebenen AMIs entfernt. ``` aws ec2 cancel-image-launch-permission \ --image-id ami-0123456789example \ --region us-east-1 ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Aufheben der Freigabe eines AMI für Ihr Konto von Amazon Web Services](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cancel-sharing-an-AMI.html#cancel-image-launch-permission) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CancelImageLaunchPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-image-launch-permission.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-import-task` Das folgende Codebeispiel zeigt die Verwendung`cancel-import-task`. **AWS CLI** **So brechen Sie eine Importaufgabe ab** Im folgenden Beispiel für `cancel-import-task` wird die angegebene Aufgabe zum Importieren eines Image abgebrochen. ``` aws ec2 cancel-import-task \ --import-task-id import-ami-1234567890abcdef0 ``` Ausgabe: ``` { "ImportTaskId": "import-ami-1234567890abcdef0", "PreviousState": "active", "State": "deleting" } ``` + Einzelheiten zur API finden Sie [CancelImportTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-import-task.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-reserved-instances-listing` Das folgende Codebeispiel zeigt die Verwendung`cancel-reserved-instances-listing`. **AWS CLI** **So stornieren Sie ein Reserved-Instances-Angebot** Im folgenden Beispiel für `cancel-reserved-instances-listing` wird das angegebene Reserved-Instances-Angebot storniert. ``` aws ec2 cancel-reserved-instances-listing \ --reserved-instances-listing-id 5ec28771-05ff-4b9b-aa31-9e57dexample ``` + Einzelheiten zur API finden Sie [CancelReservedInstancesListing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-reserved-instances-listing.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-spot-fleet-requests` Das folgende Codebeispiel zeigt die Verwendung`cancel-spot-fleet-requests`. **AWS CLI** **Beispiel 1: So brechen Sie eine Spot-Flottenanforderung ab und beenden die zugehörigen Instances** Im folgenden Beispiel für `cancel-spot-fleet-requests` wird eine Spot-Flottenanforderung abgebrochen und die zugehörigen On-Demand-Instances und Spot Instances werden beendet. ``` aws ec2 cancel-spot-fleet-requests \ --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE \ --terminate-instances ``` Ausgabe: ``` { "SuccessfulFleetRequests": [ { "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", "CurrentSpotFleetRequestState": "cancelled_terminating", "PreviousSpotFleetRequestState": "active" } ], "UnsuccessfulFleetRequests": [] } ``` **Beispiel 2: So brechen Sie eine Spot-Flottenanforderung ab, ohne die zugehörigen Instances zu beenden** Im folgenden Beispiel für `cancel-spot-fleet-requests` wird eine Spot-Flottenanforderung abgebrochen, ohne die zugehörigen On-Demand-Instances und Spot Instances zu beenden. ``` aws ec2 cancel-spot-fleet-requests \ --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE \ --no-terminate-instances ``` Ausgabe: ``` { "SuccessfulFleetRequests": [ { "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", "CurrentSpotFleetRequestState": "cancelled_running", "PreviousSpotFleetRequestState": "active" } ], "UnsuccessfulFleetRequests": [] } ``` Weitere Informationen finden Sie unter [Abbrechen einer Spot-Flottenanforderung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cancel-spot-fleet.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CancelSpotFleetRequests](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-spot-fleet-requests.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-spot-instance-requests` Das folgende Codebeispiel zeigt die Verwendung`cancel-spot-instance-requests`. **AWS CLI** **So brechen Sie Spot-Instance-Anforderungen ab** Dieser Beispielbefehl bricht eine Spot-Instance-Anforderung ab. Befehl: ``` aws ec2 cancel-spot-instance-requests --spot-instance-request-ids sir-08b93456 ``` Ausgabe: ``` { "CancelledSpotInstanceRequests": [ { "State": "cancelled", "SpotInstanceRequestId": "sir-08b93456" } ] } ``` + Einzelheiten zur API finden Sie [CancelSpotInstanceRequests](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/cancel-spot-instance-requests.html)in der *AWS CLI Befehlsreferenz*. ### `confirm-product-instance` Das folgende Codebeispiel zeigt die Verwendung`confirm-product-instance`. **AWS CLI** **So bestätigen Sie die Produkt-Instance** In diesem Beispiel wird ermittelt, ob der angegebene Produktcode der spezifischen Instance zugeordnet ist. Befehl: ``` aws ec2 confirm-product-instance --product-code 774F4FF8 --instance-id i-1234567890abcdef0 ``` Ausgabe: ``` { "OwnerId": "123456789012" } ``` + Einzelheiten zur API finden Sie [ConfirmProductInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/confirm-product-instance.html)in der *AWS CLI Befehlsreferenz*. ### `copy-fpga-image` Das folgende Codebeispiel zeigt die Verwendung`copy-fpga-image`. **AWS CLI** **So kopieren Sie ein Amazon-FPGA-Image** In diesem Beispiel wird das angegebene AFI aus der Region `us-east-1` in die aktuelle Region (`eu-west-1`) kopiert. Befehl: ``` aws ec2 copy-fpga-image --name copy-afi --source-fpga-image-id afi-0d123e123bfc85abc --source-region us-east-1 --region eu-west-1 ``` Ausgabe: ``` { "FpgaImageId": "afi-06b12350a123fbabc" } ``` + Einzelheiten zur API finden Sie [CopyFpgaImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/copy-fpga-image.html)in der *AWS CLI Befehlsreferenz*. ### `copy-image` Das folgende Codebeispiel zeigt die Verwendung`copy-image`. **AWS CLI** **Beispiel 1: So kopieren Sie ein AMI in eine andere Region** Im folgenden Beispielbefehl für `copy-image` wird das angegebene AMI von der Region `us-west-2` in die Region `us-east-1` kopiert und eine kurze Beschreibung hinzugefügt. ``` aws ec2 copy-image \ --region us-east-1 \ --name ami-name \ --source-region us-west-2 \ --source-image-id ami-066877671789bd71b \ --description "This is my copied image." ``` Ausgabe: ``` { "ImageId": "ami-0123456789abcdefg" } ``` Weitere Informationen finden Sie unter [Kopieren eines AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So kopieren Sie ein AMI in eine andere Region und verschlüsseln den Sicherungs-Snapshot** Mit dem folgenden Befehl für `copy-image` wird das angegebene AMI von der Region `us-west-2` in die aktuelle Region kopiert und der Sicherungs-Snapshot mit dem angegebenen KMS-Schlüssel verschlüsselt. ``` aws ec2 copy-image \ --source-region us-west-2 \ --name ami-name \ --source-image-id ami-066877671789bd71b \ --encrypted \ --kms-key-id alias/my-kms-key ``` Ausgabe: ``` { "ImageId": "ami-0123456789abcdefg" } ``` Weitere Informationen finden Sie unter [Kopieren eines AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 3: So beziehen Sie Ihre benutzerdefinierten AMI-Tags beim Kopieren eines AMI ein** Im folgenden Befehl für `copy-image` wird der Parameter `--copy-image-tags` verwendet, um Ihre benutzerdefinierten AMI-Tags beim Kopieren des AMI zu kopieren. ``` aws ec2 copy-image \ --region us-east-1 \ --name ami-name \ --source-region us-west-2 \ --source-image-id ami-066877671789bd71b \ --description "This is my copied image." --copy-image-tags ``` Ausgabe: ``` { "ImageId": "ami-0123456789abcdefg" } ``` Weitere Informationen finden Sie unter [Kopieren eines AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CopyImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/copy-image.html)in der *AWS CLI Befehlsreferenz*. ### `copy-snapshot` Das folgende Codebeispiel zeigt die Verwendung`copy-snapshot`. **AWS CLI** **Beispiel 1: So kopieren Sie einen Snapshot in eine andere Region** Im folgenden Beispielbefehl für `copy-snapshot` wird der angegebene Snapshot von der Region `us-west-2` in die Region `us-east-1` kopiert und eine kurze Beschreibung hinzugefügt. ``` aws ec2 copy-snapshot \ --region us-east-1 \ --source-region us-west-2 \ --source-snapshot-id snap-066877671789bd71b \ --description 'This is my copied snapshot.' ``` Ausgabe: ``` { "SnapshotId": "snap-066877671789bd71b" } ``` **Beispiel 2: So kopieren Sie einen unverschlüsselten Snapshot und verschlüsseln den neuen Snapshot** Mit dem folgenden `copy-snapshot`-Befehl wird der angegebene unverschlüsselte Snapshot von der Region `us-west-2` in die aktuelle Region kopiert und der neue Snapshot mit dem angegebenen KMS-Schlüssel verschlüsselt. ``` aws ec2 copy-snapshot \ --source-region us-west-2 \ --source-snapshot-id snap-066877671789bd71b \ --encrypted \ --kms-key-id alias/my-kms-key ``` Ausgabe: ``` { "SnapshotId": "snap-066877671789bd71b" } ``` Weitere Informationen finden Sie unter [Kopieren eines Amazon-EBS-Snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-copy-snapshot.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [CopySnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/copy-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-capacity-reservation-fleet` Das folgende Codebeispiel zeigt die Verwendung`create-capacity-reservation-fleet`. **AWS CLI** **So erstellen Sie eine Kapazitätsreservierungsflotte** Im folgenden Beispiel für `create-capacity-reservation-fleet` wird eine Kapazitätsreservierungsflotte für den in der Anforderung angegebenen Instance-Typ erstellt, bis zu der angegebenen Gesamtzielkapazität. Die Anzahl der Instances, für die die Kapazitätsreservierungsflotte Kapazität reserviert, hängt von der Gesamtzielkapazität und den Instance-Typ-Gewichtungen ab, die Sie in der Anforderung angeben. Geben Sie die zu verwendenden Instance-Typen und eine Priorität für jeden der angegebenen Instance-Typen an. ``` aws ec2 create-capacity-reservation-fleet \ --total-target-capacity 24 \ --allocation-strategy prioritized \ --instance-match-criteria open \ --tenancy default \ --end-date 2022-12-31T23:59:59.000Z \ --instance-type-specifications file://instanceTypeSpecification.json ``` Inhalt von `instanceTypeSpecification.json`: ``` [ { "InstanceType": "m5.xlarge", "InstancePlatform": "Linux/UNIX", "Weight": 3.0, "AvailabilityZone":"us-east-1a", "EbsOptimized": true, "Priority" : 1 } ] ``` Ausgabe: ``` { "Status": "submitted", "TotalFulfilledCapacity": 0.0, "CapacityReservationFleetId": "crf-abcdef01234567890", "TotalTargetCapacity": 24 } ``` Weitere Informationen zu Kapazitätsreservierungsflotten finden Sie unter [Kapazitätsreservierungsflotten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cr-fleets.html) im *Benutzerhandbuch für Amazon EC2*. Weitere Informationen zur Gewichtung des Instance-Typs und zur Gesamtzielkapazität finden Sie unter [Instance-Typ-Gewichtung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#instance-weight) und [Gesamtzielkapazität](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#target-capacity) im *Benutzerhandbuch für Amazon EC2*. Weitere Informationen zur Festlegung von Prioritäten für bestimmte Instance-Typen finden Sie unter [Zuweisungsstrategie](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#allocation-strategy) und [Instance-Typ-Priorität](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#instance-priority) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateCapacityReservationFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-capacity-reservation-fleet.html)in der *AWS CLI Befehlsreferenz*. ### `create-capacity-reservation` Das folgende Codebeispiel zeigt die Verwendung`create-capacity-reservation`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Kapazitätsreservierung** Im folgenden `create-capacity-reservation` Beispiel wird eine Kapazitätsreservierung in der `eu-west-1a` Availability Zone erstellt, in der Sie drei `t2.medium` Instances starten können, auf denen ein Linux/Unix Betriebssystem ausgeführt wird. Standardmäßig wird die Kapazitätsreservierung mit offenen Instance-Übereinstimmungskriterien und ohne Unterstützung für flüchtigen Speicher erstellt. Sie bleibt aktiv, bis Sie sie manuell stornieren. ``` aws ec2 create-capacity-reservation \ --availability-zone eu-west-1a \ --instance-type t2.medium \ --instance-platform Linux/UNIX \ --instance-count 3 ``` Ausgabe: ``` { "CapacityReservation": { "CapacityReservationId": "cr-1234abcd56EXAMPLE ", "EndDateType": "unlimited", "AvailabilityZone": "eu-west-1a", "InstanceMatchCriteria": "open", "EphemeralStorage": false, "CreateDate": "2019-08-16T09:27:35.000Z", "AvailableInstanceCount": 3, "InstancePlatform": "Linux/UNIX", "TotalInstanceCount": 3, "State": "active", "Tenancy": "default", "EbsOptimized": false, "InstanceType": "t2.medium" } } ``` **Beispiel 2: So erstellen Sie eine Kapazitätsreservierung, die automatisch an einem bestimmten Datum/einer bestimmten Uhrzeit endet** Im folgenden `create-capacity-reservation` Beispiel wird eine Kapazitätsreservierung in der `eu-west-1a` Availability Zone erstellt, in der Sie drei `m5.large` Instances starten können, auf denen ein Linux/Unix Betriebssystem ausgeführt wird. Diese Kapazitätsreservierung endet automatisch am 31.08.2019 um 23:59:59 Uhr. ``` aws ec2 create-capacity-reservation \ --availability-zone eu-west-1a \ --instance-type m5.large \ --instance-platform Linux/UNIX \ --instance-count 3 \ --end-date-type limited \ --end-date 2019-08-31T23:59:59Z ``` Ausgabe: ``` { "CapacityReservation": { "CapacityReservationId": "cr-1234abcd56EXAMPLE ", "EndDateType": "limited", "AvailabilityZone": "eu-west-1a", "EndDate": "2019-08-31T23:59:59.000Z", "InstanceMatchCriteria": "open", "EphemeralStorage": false, "CreateDate": "2019-08-16T10:15:53.000Z", "AvailableInstanceCount": 3, "InstancePlatform": "Linux/UNIX", "TotalInstanceCount": 3, "State": "active", "Tenancy": "default", "EbsOptimized": false, "InstanceType": "m5.large" } } ``` **Beispiel 3: So erstellen Sie eine Kapazitätsreservierung, die nur gezielte Instance-Starts akzeptiert** Im folgenden Beispiel für `create-capacity-reservation` wird eine Kapazitätsreservierung erstellt, die nur gezielte Instance-Starts akzeptiert. ``` aws ec2 create-capacity-reservation \ --availability-zone eu-west-1a \ --instance-type m5.large \ --instance-platform Linux/UNIX \ --instance-count 3 \ --instance-match-criteria targeted ``` Ausgabe: ``` { "CapacityReservation": { "CapacityReservationId": "cr-1234abcd56EXAMPLE ", "EndDateType": "unlimited", "AvailabilityZone": "eu-west-1a", "InstanceMatchCriteria": "targeted", "EphemeralStorage": false, "CreateDate": "2019-08-16T10:21:57.000Z", "AvailableInstanceCount": 3, "InstancePlatform": "Linux/UNIX", "TotalInstanceCount": 3, "State": "active", "Tenancy": "default", "EbsOptimized": false, "InstanceType": "m5.large" } } ``` Weitere Informationen finden Sie unter [Erstellen einer Kapazitätsreservierung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateCapacityReservation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-capacity-reservation.html)in der *AWS CLI Befehlsreferenz*. ### `create-carrier-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-carrier-gateway`. **AWS CLI** **So erstellen Sie ein Carrier-Gateway** Im folgenden Beispiel für `create-carrier-gateway` wird ein Carrier-Gateway für die angegebene VPC erstellt. ``` aws ec2 create-carrier-gateway \ --vpc-id vpc-0c529aEXAMPLE1111 ``` Ausgabe: ``` { "CarrierGateway": { "CarrierGatewayId": "cagw-0465cdEXAMPLE1111", "VpcId": "vpc-0c529aEXAMPLE1111", "State": "pending", "OwnerId": "123456789012" } } ``` Weitere Informationen finden Sie unter [Carrier-Gateways](https://docs.aws.amazon.com/wavelength/latest/developerguide/carrier-gateways.html) im *Benutzerhandbuch für AWS Wavelength*. + Einzelheiten zur API finden Sie [CreateCarrierGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-carrier-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `create-client-vpn-endpoint` Das folgende Codebeispiel zeigt die Verwendung`create-client-vpn-endpoint`. **AWS CLI** **So erstellen Sie einen Client-VPN-Endpunkt** Im folgenden Beispiel für `create-client-vpn-endpoint` wird ein Client-VPN-Endpunkt erstellt, der gegenseitige Authentifizierung verwendet und einen Wert für den Client-CIDR-Block angibt. ``` aws ec2 create-client-vpn-endpoint \ --client-cidr-block "172.31.0.0/16" \ --server-certificate-arn arn:aws:acm:ap-south-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --authentication-options Type=certificate-authentication,MutualAuthentication={ClientRootCertificateChainArn=arn:aws:acm:ap-south-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE} \ --connection-log-options Enabled=false ``` Ausgabe: ``` { "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde", "Status": { "Code": "pending-associate" }, "DnsName": "cvpn-endpoint-123456789123abcde.prod.clientvpn.ap-south-1.amazonaws.com" } ``` Weitere Informationen finden Sie unter [Client-VPN-Endpunkte](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-endpoints.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [CreateClientVpnEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-client-vpn-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `create-client-vpn-route` Das folgende Codebeispiel zeigt die Verwendung`create-client-vpn-route`. **AWS CLI** **So erstellen Sie eine Route für einen Client-VPN-Endpunkt** Im folgenden Beispiel für `create-client-vpn-route` wird eine Route zum Internet (`0.0.0.0/0`) für das angegebene Subnetz des Client-VPN-Endpunkts hinzugefügt. ``` aws ec2 create-client-vpn-route \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \ --destination-cidr-block 0.0.0.0/0 \ --target-vpc-subnet-id subnet-0123456789abcabca ``` Ausgabe: ``` { "Status": { "Code": "creating" } } ``` Weitere Informationen finden Sie unter [Routen](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-routes.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [CreateClientVpnRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-client-vpn-route.html)in der *AWS CLI Befehlsreferenz*. ### `create-coip-cidr` Das folgende Codebeispiel zeigt die Verwendung`create-coip-cidr`. **AWS CLI** **So erstellen Sie einen Bereich kundeneigener IP-Adressen (CoIP)** Im folgenden Beispiel für `create-coip-cidr` wird der angegebene CoIP-Adressbereich im genannten CoIP-Pool erstellt. ``` aws ec2 create-coip-cidr \ --cidr 15.0.0.0/24 \ --coip-pool-id ipv4pool-coip-1234567890abcdefg ``` Ausgabe: ``` { "CoipCidr": { "Cidr": "15.0.0.0/24", "CoipPoolId": "ipv4pool-coip-1234567890abcdefg", "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890" } } ``` Weitere Informationen finden Sie unter [Kundeneigene IP-Adressen](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#ip-addressing) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [CreateCoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-coip-cidr.html)in der *AWS CLI Befehlsreferenz*. ### `create-coip-pool` Das folgende Codebeispiel zeigt die Verwendung`create-coip-pool`. **AWS CLI** **So erstellen Sie einen Pool kundeneigener IP-Adressen (CoIP)** Im folgenden Beispiel für `create-coip-pool` wird ein CoIP-Pool für CoIP-Adressen in der angegebenen lokalen Gateway-Routing-Tabelle erstellt. ``` aws ec2 create-coip-pool \ --local-gateway-route-table-id lgw-rtb-abcdefg1234567890 ``` Ausgabe: ``` { "CoipPool": { "PoolId": "ipv4pool-coip-1234567890abcdefg", "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890", "PoolArn": "arn:aws:ec2:us-west-2:123456789012:coip-pool/ipv4pool-coip-1234567890abcdefg" } } ``` Weitere Informationen finden Sie unter [Kundeneigene IP-Adressen](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#ip-addressing) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [CreateCoipPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-coip-pool.html)in der *AWS CLI Befehlsreferenz*. ### `create-customer-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-customer-gateway`. **AWS CLI** **So erstellen Sie ein Kunden-Gateway** In diesem Beispiel wird ein Kunden-Gateway mit der angegebenen IP-Adresse für die externe Schnittstelle erstellt. Befehl: ``` aws ec2 create-customer-gateway --type ipsec.1 --public-ip 12.1.2.3 --bgp-asn 65534 ``` Ausgabe: ``` { "CustomerGateway": { "CustomerGatewayId": "cgw-0e11f167", "IpAddress": "12.1.2.3", "State": "available", "Type": "ipsec.1", "BgpAsn": "65534" } } ``` + Einzelheiten zur API finden Sie [CreateCustomerGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-customer-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `create-default-subnet` Das folgende Codebeispiel zeigt die Verwendung`create-default-subnet`. **AWS CLI** **So erstellen Sie ein Standardsubnetz** In diesem Beispiel wird ein Standardsubnetz in der Availability Zone `us-east-2a` erstellt. Befehl: ``` aws ec2 create-default-subnet --availability-zone us-east-2a { "Subnet": { "AvailabilityZone": "us-east-2a", "Tags": [], "AvailableIpAddressCount": 4091, "DefaultForAz": true, "Ipv6CidrBlockAssociationSet": [], "VpcId": "vpc-1a2b3c4d", "State": "available", "MapPublicIpOnLaunch": true, "SubnetId": "subnet-1122aabb", "CidrBlock": "172.31.32.0/20", "AssignIpv6AddressOnCreation": false } } ``` + Einzelheiten zur API finden Sie [CreateDefaultSubnet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-default-subnet.html)in der *AWS CLI Befehlsreferenz*. ### `create-default-vpc` Das folgende Codebeispiel zeigt die Verwendung`create-default-vpc`. **AWS CLI** **So erstellen Sie eine Standard-VPC** In diesem Beispiel wird eine Standard-VPC erstellt. Befehl: ``` aws ec2 create-default-vpc ``` Ausgabe: ``` { "Vpc": { "VpcId": "vpc-8eaae5ea", "InstanceTenancy": "default", "Tags": [], "Ipv6CidrBlockAssociationSet": [], "State": "pending", "DhcpOptionsId": "dopt-af0c32c6", "CidrBlock": "172.31.0.0/16", "IsDefault": true } } ``` + Einzelheiten zur API finden Sie [CreateDefaultVpc](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-default-vpc.html)in der *AWS CLI Befehlsreferenz*. ### `create-dhcp-options` Das folgende Codebeispiel zeigt die Verwendung`create-dhcp-options`. **AWS CLI** **So erstellen Sie einen DHCP-Optionssatz** Im folgenden Beispiel für `create-dhcp-options` wird ein DHCP-Optionssatz erstellt, der den Domainnamen, die Domainnamenserver und den NetBIOS-Knotentyp angibt. ``` aws ec2 create-dhcp-options \ --dhcp-configuration \ "Key=domain-name-servers,Values=10.2.5.1,10.2.5.2" \ "Key=domain-name,Values=example.com" \ "Key=netbios-node-type,Values=2" ``` Ausgabe: ``` { "DhcpOptions": { "DhcpConfigurations": [ { "Key": "domain-name", "Values": [ { "Value": "example.com" } ] }, { "Key": "domain-name-servers", "Values": [ { "Value": "10.2.5.1" }, { "Value": "10.2.5.2" } ] }, { "Key": "netbios-node-type", "Values": [ { "Value": "2" } ] } ], "DhcpOptionsId": "dopt-06d52773eff4c55f3" } } ``` + Einzelheiten zur API finden Sie [CreateDhcpOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-dhcp-options.html)in der *AWS CLI Befehlsreferenz*. ### `create-egress-only-internet-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-egress-only-internet-gateway`. **AWS CLI** **So erstellen Sie ein Internet-Gateway nur für ausgehenden Verkehr** In diesem Beispiel wird ein Internet-Gateway nur für ausgehenden Verkehr für die angegebene VPC erstellt. Befehl: ``` aws ec2 create-egress-only-internet-gateway --vpc-id vpc-0c62a468 ``` Ausgabe: ``` { "EgressOnlyInternetGateway": { "EgressOnlyInternetGatewayId": "eigw-015e0e244e24dfe8a", "Attachments": [ { "State": "attached", "VpcId": "vpc-0c62a468" } ] } } ``` + Einzelheiten zur API finden Sie [CreateEgressOnlyInternetGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-egress-only-internet-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `create-fleet` Das folgende Codebeispiel zeigt die Verwendung`create-fleet`. **AWS CLI** **Beispiel 1: So erstellen Sie eine EC2-Flotte, die Spot Instances als Standardkaufmodell startet** Im folgenden Beispiel für `create-fleet` wird eine EC2-Flotte mit den minimalen Parametern erstellt, die zum Starten einer Flotte erforderlich sind: eine Startvorlage, eine Zielkapazität und ein Standardkaufmodell. Die Startvorlage wird durch ihre Startvorlagen-ID und Versionsnummer identifiziert. Die Zielkapazität für die Flotte beträgt 2 Instances, das Standardkaufmodell ist `spot`, was dazu führt, dass die Flotte 2 Spot Instances startet. Wenn Sie eine EC2-Flotte erstellen, verwenden Sie eine JSON-Datei, um Informationen über die zu startenden Instances anzugeben. ``` aws ec2 create-fleet \ --cli-input-json file://file_name.json ``` Inhalt von file\$1name.json: ``` { "LaunchTemplateConfigs": [ { "LaunchTemplateSpecification": { "LaunchTemplateId": "lt-0e8c754449b27161c", "Version": "1" } } ], "TargetCapacitySpecification": { "TotalTargetCapacity": 2, "DefaultTargetCapacityType": "spot" } } ``` Ausgabe: ``` { "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE" } ``` **Beispiel 2: So erstellen Sie eine EC2-Flotte, die On-Demand-Instances als Standardkaufmodell startet** Im folgenden Beispiel für `create-fleet` wird eine EC2-Flotte mit den minimalen Parametern erstellt, die zum Starten einer Flotte erforderlich sind: eine Startvorlage, eine Zielkapazität und ein Standardkaufmodell. Die Startvorlage wird durch ihre Startvorlagen-ID und Versionsnummer identifiziert. Die Zielkapazität für die Flotte beträgt 2 Instances, das Standardkaufmodell ist `on-demand`, was dazu führt, dass die Flotte 2 On-Demand-Instances startet. Wenn Sie eine EC2-Flotte erstellen, verwenden Sie eine JSON-Datei, um Informationen über die zu startenden Instances anzugeben. ``` aws ec2 create-fleet \ --cli-input-json file://file_name.json ``` Inhalt von file\$1name.json: ``` { "LaunchTemplateConfigs": [ { "LaunchTemplateSpecification": { "LaunchTemplateId": "lt-0e8c754449b27161c", "Version": "1" } } ], "TargetCapacitySpecification": { "TotalTargetCapacity": 2, "DefaultTargetCapacityType": "on-demand" } } ``` Ausgabe: ``` { "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE" } ``` **Beispiel 3: So erstellen Sie eine EC2-Flotte, die On-Demand-Instances als primäre Kapazität startet** Im folgenden Beispiel für `create-fleet` wird eine EC2-Flotte erstellt, die die Gesamtzielkapazität von 2 Instances für die Flotte und eine Zielkapazität von 1 On-Demand-Instance angibt. Das Standardkaufmodell ist `spot`. Die Flotte startet 1 On-Demand-Instance wie angegeben, muss aber noch eine weitere Instance launchen, um die gesamte Zielkapazität zu erreichen. Das Kaufmodell für die Differenz wird anhand der Formel `TotalTargetCapacity` – `OnDemandTargetCapacity` = `DefaultTargetCapacityType` berechnet, was dazu führt, dass die Flotte 1 Spot Instance startet. Wenn Sie eine EC2-Flotte erstellen, verwenden Sie eine JSON-Datei, um Informationen über die zu startenden Instances anzugeben. ``` aws ec2 create-fleet \ --cli-input-json file://file_name.json ``` Inhalt von file\$1name.json: ``` { "LaunchTemplateConfigs": [ { "LaunchTemplateSpecification": { "LaunchTemplateId": "lt-0e8c754449b27161c", "Version": "1" } } ], "TargetCapacitySpecification": { "TotalTargetCapacity": 2, "OnDemandTargetCapacity":1, "DefaultTargetCapacityType": "spot" } } ``` Ausgabe: ``` { "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE" } ``` **Beispiel 4: So erstellen Sie eine EC2-Flotte, die Spot Instances mit der Zuweisungsstrategie mit dem niedrigsten Preis startet** Wenn die Zuweisungsstrategie für Spot Instances nicht angegeben ist, wird die Standard-Zuweisungsstrategie, d. h. `lowest-price` verwendet. Im folgenden Beispiel für `create-fleet` wird mithilfe der Zuweisungsstrategie `lowest-price` eine EC2-Flotte erstellt. Die drei Startspezifikationen, die die Startvorlage überschreiben, haben unterschiedliche Instance-Typen, aber die gleiche gewichtete Kapazität und das gleiche Subnetz. Die Gesamtzielkapazität beträgt 2 Instances und das Standardkaufmodell ist `spot`. Die EC2-Flotte startet 2 Spot Instances mit dem Instance-Typ der Startspezifikation mit dem niedrigsten Preis. Wenn Sie eine EC2-Flotte erstellen, verwenden Sie eine JSON-Datei, um Informationen über die zu startenden Instances anzugeben. ``` aws ec2 create-fleet \ --cli-input-json file://file_name.jsonContents of file_name.json:: { "LaunchTemplateConfigs": [ { "LaunchTemplateSpecification": { "LaunchTemplateId": "lt-0e8c754449b27161c", "Version": "1" }, "Overrides": [ { "InstanceType": "c4.large", "WeightedCapacity": 1, "SubnetId": "subnet-a4f6c5d3" }, { "InstanceType": "c3.large", "WeightedCapacity": 1, "SubnetId": "subnet-a4f6c5d3" }, { "InstanceType": "c5.large", "WeightedCapacity": 1, "SubnetId": "subnet-a4f6c5d3" } ] } ], "TargetCapacitySpecification": { "TotalTargetCapacity": 2, "DefaultTargetCapacityType": "spot" } } ``` Ausgabe: ``` { "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE" } ``` + Einzelheiten zur API finden Sie [CreateFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-fleet.html)in der *AWS CLI Befehlsreferenz*. ### `create-flow-logs` Das folgende Codebeispiel zeigt die Verwendung`create-flow-logs`. **AWS CLI** **Beispiel 1: So erstellen Sie ein Flow-Protokoll** Im folgenden Beispiel für `create-flow-logs` wird ein Flow-Protokoll erstellt, das den gesamten abgelehnten Datenverkehr für die angegebene Netzwerkschnittstelle erfasst. Die Flow-Logs werden mithilfe der Berechtigungen in der angegebenen IAM-Rolle an eine Protokollgruppe in CloudWatch Logs übermittelt. ``` aws ec2 create-flow-logs \ --resource-type NetworkInterface \ --resource-ids eni-11223344556677889 \ --traffic-type REJECT \ --log-group-name my-flow-logs \ --deliver-logs-permission-arn arn:aws:iam::123456789101:role/publishFlowLogs ``` Ausgabe: ``` { "ClientToken": "so0eNA2uSHUNlHI0S2cJ305GuIX1CezaRdGtexample", "FlowLogIds": [ "fl-12345678901234567" ], "Unsuccessful": [] } ``` Weitere Informationen finden Sie unter [VPC-Flow-Protokolle](https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html) im *Benutzerhandbuch für Amazon VPC*. **Beispiel 2: So erstellen Sie ein Flow-Protokoll mit einem benutzerdefinierten Format** Im folgenden Beispiel für `create-flow-logs` wird ein Flow-Protokoll erstellt, das den gesamten Datenverkehr für die angegebene VPC erfasst und Flow-Protokolle an einen Amazon-S3-Bucket sendet. Der Parameter `--log-format` legt ein benutzerdefiniertes Format für die Flow-Protokolldatensätze fest. Zum Ausführen dieses Befehls unter Windows ändern Sie die einfachen Anführungszeichen (') in doppelte Anführungszeichen ("). ``` aws ec2 create-flow-logs \ --resource-type VPC \ --resource-ids vpc-00112233344556677 \ --traffic-type ALL \ --log-destination-type s3 \ --log-destination arn:aws:s3:::flow-log-bucket/my-custom-flow-logs/ \ --log-format '${version} ${vpc-id} ${subnet-id} ${instance-id} ${srcaddr} ${dstaddr} ${srcport} ${dstport} ${protocol} ${tcp-flags} ${type} ${pkt-srcaddr} ${pkt-dstaddr}' ``` Weitere Informationen finden Sie unter [VPC-Flow-Protokolle](https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html) im *Benutzerhandbuch für Amazon VPC*. **Beispiel 3: So erstellen Sie ein Flow-Protokoll mit einem maximalen Aggregationsintervall von einer Minute** Im folgenden Beispiel für `create-flow-logs` wird ein Flow-Protokoll erstellt, das den gesamten Datenverkehr für die angegebene VPC erfasst und Flow-Protokolle an einen Amazon-S3-Bucket sendet. Der Parameter `--max-aggregation-interval` gibt ein maximales Aggregationsintervall von 60 Sekunden (1 Minute) an. ``` aws ec2 create-flow-logs \ --resource-type VPC \ --resource-ids vpc-00112233344556677 \ --traffic-type ALL \ --log-destination-type s3 \ --log-destination arn:aws:s3:::flow-log-bucket/my-custom-flow-logs/ \ --max-aggregation-interval 60 ``` Weitere Informationen finden Sie unter [VPC-Flow-Protokolle](https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie unter [CreateFlowLogs AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-flow-logs.html)*Befehlsreferenz.* ### `create-fpga-image` Das folgende Codebeispiel zeigt die Verwendung`create-fpga-image`. **AWS CLI** **So erstellen Sie ein Amazon-FPGA-Image** In diesem Beispiel wird ein AFI aus dem angegebenen Tarball im festgelegten Bucket erstellt. Befehl: ``` aws ec2 create-fpga-image --name my-afi --description test-afi --input-storage-location Bucket=my-fpga-bucket,Key=dcp/17_12_22-103226.Developer_CL.tar --logs-storage-location Bucket=my-fpga-bucket,Key=logs ``` Ausgabe: ``` { "FpgaImageId": "afi-0d123e123bfc85abc", "FpgaImageGlobalId": "agfi-123cb27b5e84a0abc" } ``` + Einzelheiten zur API finden Sie [CreateFpgaImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-fpga-image.html)in der *AWS CLI Befehlsreferenz*. ### `create-image` Das folgende Codebeispiel zeigt die Verwendung`create-image`. **AWS CLI** **Beispiel 1: So erstellen Sie ein AMI aus einer Instance, die von Amazon EBS unterstützt wird** Im folgenden Beispiel für `create-image` wird ein AMI aus der angegebenen Instance erstellt. ``` aws ec2 create-image \ --instance-id i-1234567890abcdef0 \ --name "My server" \ --description "An AMI for my server" ``` Ausgabe: ``` { "ImageId": "ami-abcdef01234567890" } ``` Weitere Informationen zur Angabe von Blockgerät-Zuweisungen für Ihr AMI finden Sie unter [Angeben einer Blockgerät-Zuweisung für ein AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html#create-ami-bdm) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So erstellen Sie ein AMI ohne Neustart aus einer Instance, die von Amazon EBS unterstützt wird** Im folgenden Beispiel für `create-image` wird ein AMI erstellt und der Parameter --no-reboot festgelegt, sodass die Instance nicht neu gestartet wird, bevor das Image erstellt wird. ``` aws ec2 create-image \ --instance-id i-1234567890abcdef0 \ --name "My server" \ --no-reboot ``` Ausgabe: ``` { "ImageId": "ami-abcdef01234567890" } ``` Weitere Informationen zur Angabe von Blockgerät-Zuweisungen für Ihr AMI finden Sie unter [Angeben einer Blockgerät-Zuweisung für ein AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html#create-ami-bdm) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 3: So taggen Sie ein AMI und Snapshots bei der Erstellung** Im folgenden Beispiel für `create-image` wird ein AMI erstellt. Das AMI und die Snapshots werden dann mit demselben Tag markiert: `cost-center=cc123` ``` aws ec2 create-image \ --instance-id i-1234567890abcdef0 \ --name "My server" \ --tag-specifications "ResourceType=image,Tags=[{Key=cost-center,Value=cc123}]" "ResourceType=snapshot,Tags=[{Key=cost-center,Value=cc123}]" ``` Ausgabe: ``` { "ImageId": "ami-abcdef01234567890" } ``` Weitere Informationen zum Taggen Ihrer Ressourcen bei der Erstellung finden Sie unter [Hinzufügen von Tags bei der Erstellung von Ressourcen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-on-create-examples) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-image.html)in der *AWS CLI Befehlsreferenz*. ### `create-instance-connect-endpoint` Das folgende Codebeispiel zeigt die Verwendung`create-instance-connect-endpoint`. **AWS CLI** **So erstellen Sie einen Endpunkt für EC2 Instance Connect** Im folgenden Beispiel für `create-instance-connect-endpoint` wird ein Endpunkt für EC2 Instance Connect im angegebenen Subnetz erstellt. ``` aws ec2 create-instance-connect-endpoint \ --region us-east-1 \ --subnet-id subnet-0123456789example ``` Ausgabe: ``` { "VpcId": "vpc-0123abcd", "InstanceConnectEndpointArn": "arn:aws:ec2:us-east-1:111111111111:instance-connect-endpoint/eice-0123456789example", "AvailabilityZone": "us-east-1a", "NetworkInterfaceIds": [ "eni-0123abcd" ], "PreserveClientIp": true, "Tags": [], "FipsDnsName": "eice-0123456789example.0123abcd.fips.ec2-instance-connect-endpoint.us-east-1.amazonaws.com", "StateMessage": "", "State": "create-complete", "DnsName": "eice-0123456789example.0123abcd.ec2-instance-connect-endpoint.us-east-1.amazonaws.com", "SubnetId": "subnet-0123abcd", "OwnerId": "111111111111", "SecurityGroupIds": [ "sg-0123abcd" ], "InstanceConnectEndpointId": "eice-0123456789example", "CreatedAt": "2023-04-07T15:43:53.000Z" } ``` Weitere Informationen finden Sie unter [Erstellen eines Endpunkts für EC2-Instance-Verbindungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-ec2-instance-connect-endpoints.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateInstanceConnectEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-instance-connect-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `create-instance-event-window` Das folgende Codebeispiel zeigt die Verwendung`create-instance-event-window`. **AWS CLI** **Beispiel 1: So erstellen Sie ein Ereignisfenster mit einem Zeitraum** Im folgenden Beispiel für `create-instance-event-window` wird ein Ereignisfenster mit einem Zeitraum erstellt. Sie können außerdem den Parameter `cron-expression` nicht angeben. ``` aws ec2 create-instance-event-window \ --region us-east-1 \ --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 \ --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \ --name myEventWindowName ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "TimeRanges": [ { "StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8 } ], "Name": "myEventWindowName", "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. **Beispiel 2: So erstellen Sie ein Ereignisfenster mit einem Cron-Ausdruck** Im folgenden Beispiel für `create-instance-event-window` wird ein Ereignisfenster mit einem Cron-Ausdruck erstellt. Sie können außerdem den Parameter `time-range` nicht angeben. ``` aws ec2 create-instance-event-window \ --region us-east-1 \ --cron-expression "* 21-23 * * 2,3" \ --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \ --name myEventWindowName ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateInstanceEventWindow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-instance-event-window.html)in der *AWS CLI Befehlsreferenz*. ### `create-instance-export-task` Das folgende Codebeispiel zeigt die Verwendung`create-instance-export-task`. **AWS CLI** **So exportieren Sie eine Instance** Dieser Beispielbefehl erstellt eine Aufgabe zum Exportieren der Instance i-1234567890abcdef0 in den Amazon-S3-Bucket myexportbucket. Befehl: ``` aws ec2 create-instance-export-task --description "RHEL5 instance" --instance-id i-1234567890abcdef0 --target-environment vmware --export-to-s3-task DiskImageFormat=vmdk,ContainerFormat=ova,S3Bucket=myexportbucket,S3Prefix=RHEL5 ``` Ausgabe: ``` { "ExportTask": { "State": "active", "InstanceExportDetails": { "InstanceId": "i-1234567890abcdef0", "TargetEnvironment": "vmware" }, "ExportToS3Task": { "S3Bucket": "myexportbucket", "S3Key": "RHEL5export-i-fh8sjjsq.ova", "DiskImageFormat": "vmdk", "ContainerFormat": "ova" }, "Description": "RHEL5 instance", "ExportTaskId": "export-i-fh8sjjsq" } } ``` + Einzelheiten zur API finden Sie [CreateInstanceExportTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-instance-export-task.html)in der *AWS CLI Befehlsreferenz*. ### `create-internet-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-internet-gateway`. **AWS CLI** **So erstellen Sie ein Internet-Gateway** Im folgenden Beispiel für `create-internet-gateway` wird ein Internet-Gateway mit dem Tag `Name=my-igw` erstellt. ``` aws ec2 create-internet-gateway \ --tag-specifications ResourceType=internet-gateway,Tags=[{Key=Name,Value=my-igw}] ``` Ausgabe: ``` { "InternetGateway": { "Attachments": [], "InternetGatewayId": "igw-0d0fb496b3994d755", "OwnerId": "123456789012", "Tags": [ { "Key": "Name", "Value": "my-igw" } ] } } ``` Weitere Informationen finden Sie unter [Internet-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [CreateInternetGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-internet-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `create-ipam-pool` Das folgende Codebeispiel zeigt die Verwendung`create-ipam-pool`. **AWS CLI** **So erstellen Sie einen IPAM-Pool** Im folgenden Beispiel für `create-ipam-pool` wird ein IPAM-Pool erstellt. (Linux) ``` aws ec2 create-ipam-pool \ --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 \ --address-family ipv4 \ --auto-import \ --allocation-min-netmask-length 16 \ --allocation-max-netmask-length 26 \ --allocation-default-netmask-length 24 \ --allocation-resource-tags "Key=Environment,Value=Preprod" \ --tag-specifications 'ResourceType=ipam-pool,Tags=[{Key=Name,Value="Preprod pool"}]' ``` (Windows) ``` aws ec2 create-ipam-pool ^ --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 ^ --address-family ipv4 ^ --auto-import ^ --allocation-min-netmask-length 16 ^ --allocation-max-netmask-length 26 ^ --allocation-default-netmask-length 24 ^ --allocation-resource-tags "Key=Environment,Value=Preprod" ^ --tag-specifications ResourceType=ipam-pool,Tags=[{Key=Name,Value="Preprod pool"}] ``` Ausgabe: ``` { "IpamPool": { "OwnerId": "123456789012", "IpamPoolId": "ipam-pool-0533048da7d823723", "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0533048da7d823723", "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-02fc38cd4c48e7d38", "IpamScopeType": "private", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "Locale": "None", "PoolDepth": 1, "State": "create-in-progress", "AutoImport": true, "AddressFamily": "ipv4", "AllocationMinNetmaskLength": 16, "AllocationMaxNetmaskLength": 26, "AllocationDefaultNetmaskLength": 24, "AllocationResourceTags": [ { "Key": "Environment", "Value": "Preprod" } ], "Tags": [ { "Key": "Name", "Value": "Preprod pool" } ] } } ``` Weitere Informationen finden Sie unter [Planen der Bereitstellung von IP-Adressen](https://docs.aws.amazon.com/vpc/latest/ipam/planning-ipam.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [CreateIpamPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-ipam-pool.html)in der *AWS CLI Befehlsreferenz*. ### `create-ipam-resource-discovery` Das folgende Codebeispiel zeigt die Verwendung`create-ipam-resource-discovery`. **AWS CLI** **So erstellen Sie eine Ressourcenerkennung** In diesem Beispiel sind Sie ein delegierter IPAM-Administrator, der eine Ressourcenerkennung erstellen und mit dem IPAM-Administrator in einer anderen AWS Organisation teilen möchte, sodass der Administrator in der anderen Organisation die IP-Adressen der Ressourcen in Ihrer Organisation verwalten und überwachen kann. Wichtig Dieses Beispiel umfasst sowohl die Option `--region` als auch die Option `--operating-regions`, die zwar optional sind, aber auf eine bestimmte Weise konfiguriert werden müssen, um eine Ressourcenerkennung erfolgreich in ein IPAM zu integrieren. \$1 `--operating-regions` muss den Regionen entsprechen, in denen Sie über Ressourcen verfügen, die IPAM erkennen soll. Wenn es Regionen gibt, in denen IPAM die IP-Adressen nicht verwalten soll (z. B. aus Compliance-Gründen), schließen Sie sie nicht ein. \$1 `--region` muss mit der Heimatregion des IPAM übereinstimmen, dem Sie sie zuordnen möchten. Sie müssen die Ressourcenerkennung in derselben Region erstellen, in der der IPAM generiert wurde. Wenn der IPAM, mit dem Sie eine Verbindung herstellen, beispielsweise in us-east-1 erstellt wurde, fügen Sie `--region us-east-1` in die Anforderung ein. Die beiden Optionen `--region` und `--operating-regions` sind standardmäßig auf die Region eingestellt, in der Sie den Befehl ausführen, wenn Sie keinen anderen Wert angeben. In diesem Beispiel gehören zu den Betriebsregionen des IPAM, den wir integrieren, `us-west-1`, `us-west-2` und `ap-south-1`. Wenn wir die Ressourcenerkennung erstellen, möchten wir, dass der IPAM die Ressourcen-IP-Adressen in `us-west-1` und `us-west-2` erkennt, aber nicht in `ap-south-1`. Wir beziehen daher nur `--operating-regions RegionName='us-west-1' RegionName='us-west-2'` in die Anforderung ein. Im folgenden Beispiel für `create-ipam-resource-discovery` wird eine IPAM-Ressourcenerkennung erstellt. ``` aws ec2 create-ipam-resource-discovery \ --description 'Example-resource-discovery' \ --tag-specifications 'ResourceType=ipam-resource-discovery,Tags=[{Key=cost-center,Value=cc123}]' \ --operating-regions RegionName='us-west-1' RegionName='us-west-2' \ --region us-east-1 ``` Ausgabe: ``` { "IpamResourceDiscovery":{ "OwnerId": "149977607591", "IpamResourceDiscoveryId": "ipam-res-disco-0257046d8aa78b8bc", "IpamResourceDiscoveryArn": "arn:aws:ec2::149977607591:ipam-resource-discovery/ipam-res-disco-0257046d8aa78b8bc", "IpamResourceDiscoveryRegion": "us-east-1", "Description": "'Example-resource-discovery'", "OperatingRegions":[ {"RegionName": "us-west-1"}, {"RegionName": "us-west-2"}, {"RegionName": "us-east-1"} ], "IsDefault": false, "State": "create-in-progress", "Tags": [ { "Key": "cost-center", "Value": "cc123" } ] } ``` Sobald Sie eine Ressourcenerkennung erstellt haben, möchten Sie sie möglicherweise mit einem anderen delegierten IPAM-Administrator teilen, was Sie auch tun können. [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html) Weitere Informationen finden Sie unter [Integrieren von IPAM mit Konten außerhalb Ihrer Organisation](https://docs.aws.amazon.com/vpc/latest/ipam/enable-integ-ipam-outside-org.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [CreateIpamResourceDiscovery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-ipam-resource-discovery.html)in der *AWS CLI Befehlsreferenz*. ### `create-ipam-scope` Das folgende Codebeispiel zeigt die Verwendung`create-ipam-scope`. **AWS CLI** **So erstellen Sie einen IPAM-Bereich** Im folgenden Beispiel für `create-ipam-scope` wird ein IPAM-Bereich erstellt. (Linux) ``` aws ec2 create-ipam-scope \ --ipam-id ipam-08440e7a3acde3908 \ --description "Example description" \ --tag-specifications 'ResourceType=ipam-scope,Tags=[{Key=Name,Value="Example name value"}]' ``` (Windows) ``` aws ec2 create-ipam-scope ^ --ipam-id ipam-08440e7a3acde3908 ^ --description "Example description" ^ --tag-specifications ResourceType=ipam-scope,Tags=[{Key=Name,Value="Example name value"}] ``` Ausgabe: ``` { "IpamScope": { "OwnerId": "123456789012", "IpamScopeId": "ipam-scope-01c1ebab2b63bd7e4", "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-01c1ebab2b63bd7e4", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "IpamScopeType": "private", "IsDefault": false, "Description": "Example description", "PoolCount": 0, "State": "create-in-progress", "Tags": [ { "Key": "Name", "Value": "Example name value" } ] } } ``` Weitere Informationen finden Sie unter [Erstellen von zusätzlichen Bereichen](https://docs.aws.amazon.com/vpc/latest/ipam/add-scope-ipam.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [CreateIpamScope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-ipam-scope.html)in der *AWS CLI Befehlsreferenz*. ### `create-ipam` Das folgende Codebeispiel zeigt die Verwendung`create-ipam`. **AWS CLI** **So erstellen Sie einen IPAM** Im folgenden Beispiel für `create-ipam` wird ein IPAM erstellt. (Linux) ``` aws ec2 create-ipam \ --description "Example description" \ --operating-regions "RegionName=us-east-2" "RegionName=us-west-1" \ --tag-specifications 'ResourceType=ipam,Tags=[{Key=Name,Value=ExampleIPAM}]' ``` (Windows) ``` aws ec2 create-ipam ^ --description "Example description" ^ --operating-regions "RegionName=us-east-2" "RegionName=us-west-1" ^ --tag-specifications ResourceType=ipam,Tags=[{Key=Name,Value=ExampleIPAM}] ``` Ausgabe: ``` { "Ipam": { "OwnerId": "123456789012", "IpamId": "ipam-036486dfa6af58ee0", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-036486dfa6af58ee0", "IpamRegion": "us-east-1", "PublicDefaultScopeId": "ipam-scope-071b8042b0195c183", "PrivateDefaultScopeId": "ipam-scope-0807405dece705a30", "ScopeCount": 2, "OperatingRegions": [ { "RegionName": "us-east-2" }, { "RegionName": "us-west-1" }, { "RegionName": "us-east-1" } ], "State": "create-in-progress", "Tags": [ { "Key": "Name", "Value": "ExampleIPAM" } ] } } ``` Weitere Informationen finden Sie unter [Erstellen eines IPAM](https://docs.aws.amazon.com/vpc/latest/ipam/create-ipam.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [CreateIpam](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-ipam.html)in der *AWS CLI Befehlsreferenz*. ### `create-key-pair` Das folgende Codebeispiel zeigt die Verwendung`create-key-pair`. **AWS CLI** **So erstellen Sie ein Schlüsselpaar** In diesem Beispiel wird eine Schlüsselrolle mit dem Namen `MyKeyPair` erstellt. Befehl: ``` aws ec2 create-key-pair --key-name MyKeyPair ``` Die Ausgabe ist eine ASCII-Version des privaten Schlüssels und des Schlüsselfingerabdrucks. Sie müssen den Schlüssel in einer Datei speichern. Weitere Informationen finden Sie unter Verwenden von Schlüsselpaaren im Benutzerhandbuch zu* die AWS -Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [CreateKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-key-pair.html)in der *AWS CLI Befehlsreferenz*. ### `create-launch-template-version` Das folgende Codebeispiel zeigt die Verwendung`create-launch-template-version`. **AWS CLI** **So erstellen Sie eine Startvorlagenversion** Das folgende Beispiel erstellt eine neue Startvorlagenversion, die auf Version 1 der Startvorlage basiert und eine andere AMI-ID angibt. Befehl: ``` aws ec2 create-launch-template-version --launch-template-id lt-0abcd290751193123 --version-description WebVersion2 --source-version 1 --launch-template-data '{"ImageId":"ami-c998b6b2"}' ``` Ausgabe: ``` { "LaunchTemplateVersion": { "VersionDescription": "WebVersion2", "LaunchTemplateId": "lt-0abcd290751193123", "LaunchTemplateName": "WebServers", "VersionNumber": 2, "CreatedBy": "arn:aws:iam::123456789012:root", "LaunchTemplateData": { "ImageId": "ami-c998b6b2", "InstanceType": "t2.micro", "NetworkInterfaces": [ { "Ipv6Addresses": [ { "Ipv6Address": "2001:db8:1234:1a00::123" } ], "DeviceIndex": 0, "SubnetId": "subnet-7b16de0c", "AssociatePublicIpAddress": true } ] }, "DefaultVersion": false, "CreateTime": "2017-12-01T13:35:46.000Z" } } ``` + Einzelheiten zur API finden Sie [CreateLaunchTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-launch-template-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-launch-template` Das folgende Codebeispiel zeigt die Verwendung`create-launch-template`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Startvorlage** Im folgenden `create-launch-template` Beispiel wird eine Startvorlage erstellt, die das Subnetz angibt, in dem die Instance gestartet werden soll, der Instance eine öffentliche IP-Adresse und eine IPv6 Adresse zuweist und ein Tag für die Instance erstellt. ``` aws ec2 create-launch-template \ --launch-template-name TemplateForWebServer \ --version-description WebVersion1 \ --launch-template-data '{"NetworkInterfaces":[{"AssociatePublicIpAddress":true,"DeviceIndex":0,"Ipv6AddressCount":1,"SubnetId":"subnet-7b16de0c"}],"ImageId":"ami-8c1be5f6","InstanceType":"t2.small","TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"purpose","Value":"webserver"}]}]}' ``` Ausgabe: ``` { "LaunchTemplate": { "LatestVersionNumber": 1, "LaunchTemplateId": "lt-01238c059e3466abc", "LaunchTemplateName": "TemplateForWebServer", "DefaultVersionNumber": 1, "CreatedBy": "arn:aws:iam::123456789012:user/Bob", "CreateTime": "2019-01-27T09:13:24.000Z" } } ``` Weitere Informationen finden Sie unter Starten einer Instance von einer Startvorlage im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. Informationen zum Zitieren von JSON-formatierten Parametern finden Sie unter Quoting Strings im *AWS -Benutzerhandbuch zur Befehlszeilenschnittstelle*. **Beispiel 2: So erstellen Sie eine Startvorlage für Amazon EC2 Auto Scaling** Im folgenden Beispiel für `create-launch-template` wird eine Startvorlage mit mehreren Tags und einer Blockgerät-Zuweisung erstellt, um beim Start einer Instance ein zusätzliches EBS-Volume anzugeben. Geben Sie einen Wert für `Groups` an, der den Sicherheitsgruppen für die VPC entspricht, in dem Ihre Auto-Scaling-Gruppe Instances starten soll. Geben Sie die VPC und Subnetze als Eigenschaften der Auto-Scaling-Gruppe an. ``` aws ec2 create-launch-template \ --launch-template-name TemplateForAutoScaling \ --version-description AutoScalingVersion1 \ --launch-template-data '{"NetworkInterfaces":[{"DeviceIndex":0,"AssociatePublicIpAddress":true,"Groups":["sg-7c227019,sg-903004f8"],"DeleteOnTermination":true}],"ImageId":"ami-b42209de","InstanceType":"m4.large","TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"environment","Value":"production"},{"Key":"purpose","Value":"webserver"}]},{"ResourceType":"volume","Tags":[{"Key":"environment","Value":"production"},{"Key":"cost-center","Value":"cc123"}]}],"BlockDeviceMappings":[{"DeviceName":"/dev/sda1","Ebs":{"VolumeSize":100}}]}' --region us-east-1 ``` Ausgabe: ``` { "LaunchTemplate": { "LatestVersionNumber": 1, "LaunchTemplateId": "lt-0123c79c33a54e0abc", "LaunchTemplateName": "TemplateForAutoScaling", "DefaultVersionNumber": 1, "CreatedBy": "arn:aws:iam::123456789012:user/Bob", "CreateTime": "2019-04-30T18:16:06.000Z" } } ``` Weitere Informationen finden Sie unter Erstellen einer Startvorlage für eine Auto-Scaling-Gruppe im *Benutzerhandbuch zu Amazon EC2 Auto Scaling*. Informationen zum Zitieren von JSON-formatierten Parametern finden Sie unter Quoting Strings im *AWS -Benutzerhandbuch zur Befehlszeilenschnittstelle*. **Beispiel 3: So erstellen Sie eine Startvorlage, die die Verschlüsselung von EBS-Volumes festlegt** Im folgenden Beispiel für `create-launch-template` wird eine Startvorlage erstellt, die verschlüsselte EBS-Volumes enthält, die aus einem unverschlüsselten Snapshot erstellt wurden. Außerdem werden die Volumes bei der Erstellung mit Tags versehen. Wenn die standardmäßige Verschlüsselung deaktiviert ist, müssen Sie die `"Encrypted"`-Option wie im folgenden Beispiel gezeigt angeben. Wenn Sie die `"KmsKeyId"`-Option verwenden, um einen kundenseitig verwalteten Schlüssel (Customer Managed Key; CMK) anzugeben, müssen Sie die `"Encrypted"`-Option auch dann angeben, wenn die standardmäßige Verschlüsselung aktiviert ist. ``` aws ec2 create-launch-template \ --launch-template-name TemplateForEncryption \ --launch-template-data file://config.json ``` Inhalt von `config.json`: ``` { "BlockDeviceMappings":[ { "DeviceName":"/dev/sda1", "Ebs":{ "VolumeType":"gp2", "DeleteOnTermination":true, "SnapshotId":"snap-066877671789bd71b", "Encrypted":true, "KmsKeyId":"arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef" } } ], "ImageId":"ami-00068cd7555f543d5", "InstanceType":"c5.large", "TagSpecifications":[ { "ResourceType":"volume", "Tags":[ { "Key":"encrypted", "Value":"yes" } ] } ] } ``` Ausgabe: ``` { "LaunchTemplate": { "LatestVersionNumber": 1, "LaunchTemplateId": "lt-0d5bd51bcf8530abc", "LaunchTemplateName": "TemplateForEncryption", "DefaultVersionNumber": 1, "CreatedBy": "arn:aws:iam::123456789012:user/Bob", "CreateTime": "2020-01-07T19:08:36.000Z" } } ``` Weitere Informationen finden Sie unter Wiederherstellen eines Amazon-EBS-Volumes aus einem Snapshot und Standardmäßige Verschlüsselung im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie unter [CreateLaunchTemplate AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-launch-template.html)*Befehlsreferenz*. ### `create-local-gateway-route-table-virtual-interface-group-association` Das folgende Codebeispiel zeigt die Verwendung`create-local-gateway-route-table-virtual-interface-group-association`. **AWS CLI** **Um eine lokale Gateway-Routentabelle einer virtuellen Interfaces (VIFs) -Gruppe zuzuordnen** Im folgenden Beispiel für `create-local-gateway-route-table-virtual-interface-group-association` wird eine Zuordnung zwischen der angegebenen lokalen Gateway-Routing-Tabelle und der VIF-Gruppe erstellt. ``` aws ec2 create-local-gateway-route-table-virtual-interface-group-association \ --local-gateway-route-table-id lgw-rtb-exampleidabcd1234 \ --local-gateway-virtual-interface-group-id lgw-vif-grp-exampleid0123abcd ``` Ausgabe: ``` { "LocalGatewayRouteTableVirtualInterfaceGroupAssociation": { "LocalGatewayRouteTableVirtualInterfaceGroupAssociationId": "lgw-vif-grp-assoc-exampleid12345678", "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-exampleid0123abcd", "LocalGatewayId": "lgw-exampleid11223344", "LocalGatewayRouteTableId": "lgw-rtb-exampleidabcd1234", "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:111122223333:local-gateway-route-table/lgw-rtb-exampleidabcd1234", "OwnerId": "111122223333", "State": "pending", "Tags": [] } } ``` Weitere Informationen finden Sie unter [Zuordnungen von VIF-Gruppen](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#vif-group-associations) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [CreateLocalGatewayRouteTableVirtualInterfaceGroupAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-local-gateway-route-table-virtual-interface-group-association.html)in der *AWS CLI Befehlsreferenz*. ### `create-local-gateway-route-table-vpc-association` Das folgende Codebeispiel zeigt die Verwendung`create-local-gateway-route-table-vpc-association`. **AWS CLI** **So ordnen Sie einer Routing-Tabelle eine VPC zu** Im folgenden Beispiel für `create-local-gateway-route-table-vpc-association` wird der angegebenen lokalen Gateway-Routing-Tabelle die genannte VPC zugeordnet. ``` aws ec2 create-local-gateway-route-table-vpc-association \ --local-gateway-route-table-id lgw-rtb-059615ef7dEXAMPLE \ --vpc-id vpc-07ef66ac71EXAMPLE ``` Ausgabe: ``` { "LocalGatewayRouteTableVpcAssociation": { "LocalGatewayRouteTableVpcAssociationId": "lgw-vpc-assoc-0ee765bcc8EXAMPLE", "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE", "LocalGatewayId": "lgw-09b493aa7cEXAMPLE", "VpcId": "vpc-07ef66ac71EXAMPLE", "State": "associated" } } ``` + Einzelheiten zur API finden Sie [CreateLocalGatewayRouteTableVpcAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-local-gateway-route-table-vpc-association.html)in der *AWS CLI Befehlsreferenz*. ### `create-local-gateway-route-table` Das folgende Codebeispiel zeigt die Verwendung`create-local-gateway-route-table`. **AWS CLI** **So erstellen Sie eine lokale Gateway-Routing-Tabelle** Im folgenden Beispiel für `create-local-gateway-route-table` wird eine lokale Routing-Tabelle mit dem direkten VPC-Routing-Modus erstellt. ``` aws ec2 create-local-gateway-route-table \ --local-gateway-id lgw-1a2b3c4d5e6f7g8h9 \ --mode direct-vpc-routing ``` Ausgabe: ``` { "LocalGatewayRouteTable": { "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890", "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:111122223333:local-gateway-route-table/lgw-rtb-abcdefg1234567890", "LocalGatewayId": "lgw-1a2b3c4d5e6f7g8h9", "OutpostArn": "arn:aws:outposts:us-west-2:111122223333:outpost/op-021345abcdef67890", "OwnerId": "111122223333", "State": "pending", "Tags": [], "Mode": "direct-vpc-routing" } } ``` Weitere Informationen finden Sie unter [Roouting-Tabellen für lokale Gateways](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html) im *AWS Benutzerhandbuch für Outposts*. + Einzelheiten zur API finden Sie [CreateLocalGatewayRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-local-gateway-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `create-local-gateway-route` Das folgende Codebeispiel zeigt die Verwendung`create-local-gateway-route`. **AWS CLI** **So erstellen Sie eine statische Route für eine lokale Gateway-Routing-Tabelle** Im folgenden Beispiel für `create-local-gateway-route` wird die angegebene Route in der genannten lokalen Gateway-Routing-Tabelle erstellt. ``` aws ec2 create-local-gateway-route \ --destination-cidr-block 0.0.0.0/0 \ --local-gateway-route-table-id lgw-rtb-059615ef7dEXAMPLE ``` Ausgabe: ``` { "Route": { "DestinationCidrBlock": "0.0.0.0/0", "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE", "Type": "static", "State": "deleted", "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE" } } ``` + Einzelheiten zur API finden Sie [CreateLocalGatewayRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-local-gateway-route.html)in der *AWS CLI Befehlsreferenz*. ### `create-managed-prefix-list` Das folgende Codebeispiel zeigt die Verwendung`create-managed-prefix-list`. **AWS CLI** **So erstellen Sie eine Präfixliste** Das folgende `create-managed-prefix-list` Beispiel erstellt eine IPv4 Präfixliste mit maximal 10 Einträgen und erstellt 2 Einträge in der Präfixliste. ``` aws ec2 create-managed-prefix-list \ --address-family IPv4 \ --max-entries 10 \ --entries Cidr=10.0.0.0/16,Description=vpc-a Cidr=10.2.0.0/16,Description=vpc-b \ --prefix-list-name vpc-cidrs ``` Ausgabe: ``` { "PrefixList": { "PrefixListId": "pl-0123456abcabcabc1", "AddressFamily": "IPv4", "State": "create-in-progress", "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1", "PrefixListName": "vpc-cidrs", "MaxEntries": 10, "Version": 1, "Tags": [], "OwnerId": "123456789012" } } ``` Weitere Informationen finden Sie unter [Verwaltete Präfixlisten](https://docs.aws.amazon.com/vpc/latest/userguide/managed-prefix-lists.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [CreateManagedPrefixList](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-managed-prefix-list.html)unter *AWS CLI Befehlsreferenz*. ### `create-nat-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-nat-gateway`. **AWS CLI** **Beispiel 1: So erstellen Sie ein öffentliches NAT-Gateway** Im folgenden Beispiel für `create-nat-gateway` wird ein öffentliches NAT-Gateway im angegebenen Subnetz erstellt und die Elastic-IP-Adresse der genannten Zuweisungs-ID zugeordnet. Wenn Sie ein öffentliches NAT-Gateway erstellen, müssen Sie eine Elastic-IP-Adresse zuordnen. ``` aws ec2 create-nat-gateway \ --subnet-id subnet-0250c25a1fEXAMPLE \ --allocation-id eipalloc-09ad461b0dEXAMPLE ``` Ausgabe: ``` { "NatGateway": { "CreateTime": "2021-12-01T22:22:38.000Z", "NatGatewayAddresses": [ { "AllocationId": "eipalloc-09ad461b0dEXAMPLE" } ], "NatGatewayId": "nat-0c61bf8a12EXAMPLE", "State": "pending", "SubnetId": "subnet-0250c25a1fEXAMPLE", "VpcId": "vpc-0a60eb65b4EXAMPLE", "ConnectivityType": "public" } } ``` Weitere Informationen finden Sie unter [NAT-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) im *Benutzerhandbuch für Amazon VPC*. **Beispiel 2: So erstellen Sie ein privates NAT-Gateway** Im folgenden Beispiel für `create-nat-gateway` wird ein privates NAT-Gateway im angegebenen Subnetz erstellt. Einem privaten NAT-Gateway ist keine Elastic-IP-Adresse zugeordnet. ``` aws ec2 create-nat-gateway \ --subnet-id subnet-0250c25a1fEXAMPLE \ --connectivity-type private ``` Ausgabe: ``` { "NatGateway": { "CreateTime": "2021-12-01T22:26:00.000Z", "NatGatewayAddresses": [ {} ], "NatGatewayId": "nat-011b568379EXAMPLE", "State": "pending", "SubnetId": "subnet-0250c25a1fEXAMPLE", "VpcId": "vpc-0a60eb65b4EXAMPLE", "ConnectivityType": "private" } } ``` Weitere Informationen finden Sie unter [NAT-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [CreateNatGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-nat-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `create-network-acl-entry` Das folgende Codebeispiel zeigt die Verwendung`create-network-acl-entry`. **AWS CLI** **So erstellen Sie einen Eintrag für eine Netzwerk-ACL** In diesem Beispiel wird ein Eintrag für die angegebene Netzwerk-ACL erstellt. Die Regel erlaubt eingehenden Datenverkehr von einer beliebigen IPv4 Adresse (0.0.0.0/0) am UDP-Port 53 (DNS) in jedes zugehörige Subnetz. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 create-network-acl-entry --network-acl-id acl-5fb85d36 --ingress --rule-number 100 --protocol udp --port-range From=53,To=53 --cidr-block 0.0.0.0/0 --rule-action allow ``` In diesem Beispiel wird eine Regel für die angegebene Netzwerk-ACL erstellt, die eingehenden Datenverkehr von einer beliebigen IPv6 Adresse (:: /0) am TCP-Port 80 (HTTP) zulässt. Befehl: ``` aws ec2 create-network-acl-entry --network-acl-id acl-5fb85d36 --ingress --rule-number 120 --protocol tcp --port-range From=80,To=80 --ipv6-cidr-block ::/0 --rule-action allow ``` + Einzelheiten zur API finden Sie [CreateNetworkAclEntry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-network-acl-entry.html)in der *AWS CLI Befehlsreferenz*. ### `create-network-acl` Das folgende Codebeispiel zeigt die Verwendung`create-network-acl`. **AWS CLI** **So erstellen Sie eine Netzwerk-ACL** In diesem Beispiel wird eine Netzwerk-ACL für die angegebene VPC erstellt. Befehl: ``` aws ec2 create-network-acl --vpc-id vpc-a01106c2 ``` Ausgabe: ``` { "NetworkAcl": { "Associations": [], "NetworkAclId": "acl-5fb85d36", "VpcId": "vpc-a01106c2", "Tags": [], "Entries": [ { "CidrBlock": "0.0.0.0/0", "RuleNumber": 32767, "Protocol": "-1", "Egress": true, "RuleAction": "deny" }, { "CidrBlock": "0.0.0.0/0", "RuleNumber": 32767, "Protocol": "-1", "Egress": false, "RuleAction": "deny" } ], "IsDefault": false } } ``` + Einzelheiten zur API finden Sie [CreateNetworkAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-network-acl.html)in der *AWS CLI Befehlsreferenz*. ### `create-network-insights-access-scope` Das folgende Codebeispiel zeigt die Verwendung`create-network-insights-access-scope`. **AWS CLI** **So erstellen Sie einen Netzwerkzugriffsbereich** Im folgenden Beispiel für `create-network-insights-access-scope` wird ein Netzwerkzugriffsbereich erstellt. ``` aws ec2 create-network-insights-access-scope \ --cli-input-json file://access-scope-file.json ``` Inhalt von `access-scope-file.json`: ``` { "MatchPaths": [ { "Source": { "ResourceStatement": { "Resources": [ "vpc-abcd12e3" ] } } } ], "ExcludePaths": [ { "Source": { "ResourceStatement": { "ResourceTypes": [ "AWS::EC2::InternetGateway" ] } } } ] } ``` Ausgabe: ``` { "NetworkInsightsAccessScope": { "NetworkInsightsAccessScopeId": "nis-123456789abc01234", "NetworkInsightsAccessScopeArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-access-scope/nis-123456789abc01234", "CreatedDate": "2022-01-25T19:20:28.796000+00:00", "UpdatedDate": "2022-01-25T19:20:28.797000+00:00" }, "NetworkInsightsAccessScopeContent": { "NetworkInsightsAccessScopeId": "nis-123456789abc01234", "MatchPaths": [ { "Source": { "ResourceStatement": { "Resources": [ "vpc-abcd12e3" ] } } } ], "ExcludePaths": [ { "Source": { "ResourceStatement": { "ResourceTypes": [ "AWS::EC2::InternetGateway" ] } } } ] } } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Network Access Analyzer using the AWS CLI](https://docs.aws.amazon.com/vpc/latest/network-access-analyzer/getting-started-cli.html) im *Network Access Analyzer-Handbuch*. + Einzelheiten zur API finden Sie [CreateNetworkInsightsAccessScope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-network-insights-access-scope.html)unter *AWS CLI Befehlsreferenz*. ### `create-network-insights-path` Das folgende Codebeispiel zeigt die Verwendung`create-network-insights-path`. **AWS CLI** **So erstellen Sie einen Pfad** Im folgenden Beispiel für `create-network-insights-path` wird ein Pfad erstellt. Die Quelle ist das angegebene Internet-Gateway und das Ziel die festgelegte EC2-Instance. Wenn Sie feststellen möchten, ob das Ziel mit dem angegebenen Protokoll und Port erreichbar ist, analysieren Sie den Pfad mithilfe des Befehls `start-network-insights-analysis`. ``` aws ec2 create-network-insights-path \ --source igw-0797cccdc9d73b0e5 \ --destination i-0495d385ad28331c7 \ --destination-port 22 \ --protocol TCP ``` Ausgabe: ``` { "NetworkInsightsPaths": { "NetworkInsightsPathId": "nip-0b26f224f1d131fa8", "NetworkInsightsPathArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-path/nip-0b26f224f1d131fa8", "CreatedDate": "2021-01-20T22:43:46.933Z", "Source": "igw-0797cccdc9d73b0e5", "Destination": "i-0495d385ad28331c7", "Protocol": "tcp" } } ``` Weitere Informationen finden Sie unter [Erste Schritte mit der AWS CLI](https://docs.aws.amazon.com/vpc/latest/reachability/getting-started-cli.html) im *Reachability Analyzer-Handbuch*. + Einzelheiten zur API finden Sie unter [CreateNetworkInsightsPath AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-network-insights-path.html)*Befehlsreferenz*. ### `create-network-interface-permission` Das folgende Codebeispiel zeigt die Verwendung`create-network-interface-permission`. **AWS CLI** **So erstellen Sie eine Netzwerkschnittstellenberechtigung** In diesem Beispiel wird dem Konto `123456789012` die Berechtigung zum Zuordnen der Netzwerkschnittstelle `eni-1a2b3c4d` zu einer Instance erteilt. Befehl: ``` aws ec2 create-network-interface-permission --network-interface-id eni-1a2b3c4d --aws-account-id 123456789012 --permission INSTANCE-ATTACH ``` Ausgabe: ``` { "InterfacePermission": { "PermissionState": { "State": "GRANTED" }, "NetworkInterfacePermissionId": "eni-perm-06fd19020ede149ea", "NetworkInterfaceId": "eni-1a2b3c4d", "Permission": "INSTANCE-ATTACH", "AwsAccountId": "123456789012" } } ``` + Einzelheiten zur API finden Sie [CreateNetworkInterfacePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-network-interface-permission.html)in der *AWS CLI Befehlsreferenz*. ### `create-network-interface` Das folgende Codebeispiel zeigt die Verwendung`create-network-interface`. **AWS CLI** **Beispiel 1: Um eine IPv4 Adresse für eine Netzwerkschnittstelle anzugeben** Im folgenden `create-network-interface` Beispiel wird eine Netzwerkschnittstelle für das angegebene Subnetz mit der angegebenen primären IPv4 Adresse erstellt. ``` aws ec2 create-network-interface \ --subnet-id subnet-00a24d0d67acf6333 \ --description "my network interface" \ --groups sg-09dfba7ed20cda78b \ --private-ip-address 10.0.8.17 ``` Ausgabe: ``` { "NetworkInterface": { "AvailabilityZone": "us-west-2a", "Description": "my network interface", "Groups": [ { "GroupName": "my-security-group", "GroupId": "sg-09dfba7ed20cda78b" } ], "InterfaceType": "interface", "Ipv6Addresses": [], "MacAddress": "06:6a:0f:9a:49:37", "NetworkInterfaceId": "eni-0492b355f0cf3b3f8", "OwnerId": "123456789012", "PrivateDnsName": "ip-10-0-8-18.us-west-2.compute.internal", "PrivateIpAddress": "10.0.8.17", "PrivateIpAddresses": [ { "Primary": true, "PrivateDnsName": "ip-10-0-8-17.us-west-2.compute.internal", "PrivateIpAddress": "10.0.8.17" } ], "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE", "RequesterManaged": false, "SourceDestCheck": true, "Status": "pending", "SubnetId": "subnet-00a24d0d67acf6333", "TagSet": [], "VpcId": "vpc-02723a0feeeb9d57b" } } ``` **Beispiel 2: Um eine Netzwerkschnittstelle mit einer IPv4 Adresse und einer IPv6 Adresse zu erstellen** Im folgenden Beispiel für `create-network-interface` wird eine Netzwerkschnittstelle für das angegebene Subnetz mit einer IPv4- und einer IPv6-Adresse erstellt, die von Amazon EC2 ausgewählt wurden. ``` aws ec2 create-network-interface \ --subnet-id subnet-00a24d0d67acf6333 \ --description "my dual stack network interface" \ --ipv6-address-count 1 \ --groups sg-09dfba7ed20cda78b ``` Ausgabe: ``` { "NetworkInterface": { "AvailabilityZone": "us-west-2a", "Description": "my dual stack network interface", "Groups": [ { "GroupName": "my-security-group", "GroupId": "sg-09dfba7ed20cda78b" } ], "InterfaceType": "interface", "Ipv6Addresses": [ { "Ipv6Address": "2600:1f13:cfe:3650:a1dc:237c:393a:4ba7", "IsPrimaryIpv6": false } ], "MacAddress": "06:b8:68:d2:b2:2d", "NetworkInterfaceId": "eni-05da417453f9a84bf", "OwnerId": "123456789012", "PrivateDnsName": "ip-10-0-8-18.us-west-2.compute.internal", "PrivateIpAddress": "10.0.8.18", "PrivateIpAddresses": [ { "Primary": true, "PrivateDnsName": "ip-10-0-8-18.us-west-2.compute.internal", "PrivateIpAddress": "10.0.8.18" } ], "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE", "RequesterManaged": false, "SourceDestCheck": true, "Status": "pending", "SubnetId": "subnet-00a24d0d67acf6333", "TagSet": [], "VpcId": "vpc-02723a0feeeb9d57b", "Ipv6Address": "2600:1f13:cfe:3650:a1dc:237c:393a:4ba7" } } ``` **Beispiel 3: So erstellen Sie eine Netzwerkschnittstelle mit Konfigurationsoptionen für die Verbindungsverfolgung** Im folgenden Beispiel für `create-network-interface` wird eine Netzwerkschnittstelle erstellt und die Timeouts für die Verbindungsverfolgung im Leerlauf werden konfiguriert. ``` aws ec2 create-network-interface \ --subnet-id subnet-00a24d0d67acf6333 \ --groups sg-02e57dbcfe0331c1b \ --connection-tracking-specification TcpEstablishedTimeout=86400,UdpTimeout=60 ``` Ausgabe: ``` { "NetworkInterface": { "AvailabilityZone": "us-west-2a", "ConnectionTrackingConfiguration": { "TcpEstablishedTimeout": 86400, "UdpTimeout": 60 }, "Description": "", "Groups": [ { "GroupName": "my-security-group", "GroupId": "sg-02e57dbcfe0331c1b" } ], "InterfaceType": "interface", "Ipv6Addresses": [], "MacAddress": "06:4c:53:de:6d:91", "NetworkInterfaceId": "eni-0c133586e08903d0b", "OwnerId": "123456789012", "PrivateDnsName": "ip-10-0-8-94.us-west-2.compute.internal", "PrivateIpAddress": "10.0.8.94", "PrivateIpAddresses": [ { "Primary": true, "PrivateDnsName": "ip-10-0-8-94.us-west-2.compute.internal", "PrivateIpAddress": "10.0.8.94" } ], "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE", "RequesterManaged": false, "SourceDestCheck": true, "Status": "pending", "SubnetId": "subnet-00a24d0d67acf6333", "TagSet": [], "VpcId": "vpc-02723a0feeeb9d57b" } } ``` **Beispiel 4: So erstellen Sie einen Elastic Fabric Adapter** Im folgenden Beispiel für `create-network-interface` wird ein EFA erstellt. ``` aws ec2 create-network-interface \ --interface-type efa \ --subnet-id subnet-00a24d0d67acf6333 \ --description "my efa" \ --groups sg-02e57dbcfe0331c1b ``` Ausgabe: ``` { "NetworkInterface": { "AvailabilityZone": "us-west-2a", "Description": "my efa", "Groups": [ { "GroupName": "my-efa-sg", "GroupId": "sg-02e57dbcfe0331c1b" } ], "InterfaceType": "efa", "Ipv6Addresses": [], "MacAddress": "06:d7:a4:f7:4d:57", "NetworkInterfaceId": "eni-034acc2885e862b65", "OwnerId": "123456789012", "PrivateDnsName": "ip-10-0-8-180.us-west-2.compute.internal", "PrivateIpAddress": "10.0.8.180", "PrivateIpAddresses": [ { "Primary": true, "PrivateDnsName": "ip-10-0-8-180.us-west-2.compute.internal", "PrivateIpAddress": "10.0.8.180" } ], "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE", "RequesterManaged": false, "SourceDestCheck": true, "Status": "pending", "SubnetId": "subnet-00a24d0d67acf6333", "TagSet": [], "VpcId": "vpc-02723a0feeeb9d57b" } } ``` Weitere Informationen finden Sie unter [Elastic Network-Schnittstellen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateNetworkInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-network-interface.html)in der *AWS CLI Befehlsreferenz*. ### `create-placement-group` Das folgende Codebeispiel zeigt die Verwendung`create-placement-group`. **AWS CLI** **So erstellen Sie eine Platzierungsgruppe** Dieser Beispielbefehl erstellt eine Platzierungsgruppe mit dem angegebenen Namen. Befehl: ``` aws ec2 create-placement-group --group-name my-cluster --strategy cluster ``` **So erstellen Sie eine Partition-Placement-Gruppe** Dieser Beispielbefehl erstellt eine Partition-Placement-Gruppe mit dem Namen `HDFS-Group-A` und fünf Partitionen. Befehl: ``` aws ec2 create-placement-group --group-name HDFS-Group-A --strategy partition --partition-count 5 ``` + Einzelheiten zur API finden Sie [CreatePlacementGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-placement-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-replace-root-volume-task` Das folgende Codebeispiel zeigt die Verwendung`create-replace-root-volume-task`. **AWS CLI** **Beispiel 1: So stellen Sie den ursprünglichen Startstatus eines Stamm-Volumes wieder her** Im folgenden Beispiel für `create-replace-root-volume-task` wird das Stamm-Volume der Instance i-0123456789abcdefa auf den ursprünglichen Startstatus zurückgesetzt. ``` aws ec2 create-replace-root-volume-task \ --instance-id i-0123456789abcdefa ``` Ausgabe: ``` { "ReplaceRootVolumeTask": { "InstanceId": "i-0123456789abcdefa", "ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd", "TaskState": "pending", "StartTime": "2022-03-14T15:06:38Z", "Tags": [] } } ``` **Beispiel 2: So stellen Sie ein Stamm-Volume auf einem bestimmten Snapshot wieder her** Im folgenden Beispiel für `create-replace-root-volume-task` wird das Stamm-Volume der Instance i-0123456789abcdefa auf dem Snapshot snap-0abcdef1234567890 wiederhergestellt. ``` aws ec2 create-replace-root-volume-task \ --instance-id i-0123456789abcdefa \ --snapshot-id snap-0abcdef1234567890 ``` Ausgabe: ``` { "ReplaceRootVolumeTask": { "InstanceId": "i-0123456789abcdefa", "ReplaceRootVolumeTaskId": "replacevol-0555566667777abcd", "TaskState": "pending", "StartTime": "2022-03-14T15:16:28Z", "Tags": [] } } ``` Weitere Informationen finden Sie unter [Ersetzen eines Stamm-Volume](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/replace-root.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateReplaceRootVolumeTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-replace-root-volume-task.html)in der *AWS CLI Befehlsreferenz*. ### `create-reserved-instances-listing` Das folgende Codebeispiel zeigt die Verwendung`create-reserved-instances-listing`. **AWS CLI** **So listen Sie eine Reserved Instance im Reserved Instance Marketplace auf** Im folgenden Beispiel für `create-reserved-instances-listing` wird ein Eintrag für die angegebene Reserved Instance auf dem Reserved Instance Marketplace erstellt. ``` aws ec2 create-reserved-instances-listing \ --reserved-instances-id 5ec28771-05ff-4b9b-aa31-9e57dexample \ --instance-count 3 \ --price-schedules CurrencyCode=USD,Price=25.50 \ --client-token 550e8400-e29b-41d4-a716-446655440000 ``` + Einzelheiten zur API finden Sie [CreateReservedInstancesListing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-reserved-instances-listing.html)in der *AWS CLI Befehlsreferenz*. ### `create-restore-image-task` Das folgende Codebeispiel zeigt die Verwendung`create-restore-image-task`. **AWS CLI** **So stellen Sie ein AMI aus einem S3-Bucket wieder her** Im folgenden Beispiel für `create-restore-image-task` wird ein AMI aus einem S3-Bucket wiederhergestellt. Geben Sie unter Verwendung der Werte für `S3ObjectKey `` and ``Bucket` aus der Ausgabe von `describe-store-image-tasks` den Objektschlüssel des AMI und den Namen des S3-Buckets an, in den das AMI kopiert wurde. Geben Sie den Namen für das wiederhergestellte AMI an. Der Name muss AMIs in der Region für dieses Konto eindeutig sein. Das wiederhergestellte AMI erhält eine neue AMI-ID. ``` aws ec2 create-restore-image-task \ --object-key ami-1234567890abcdef0.bin \ --bucket my-ami-bucket \ --name 'New AMI Name' ``` Ausgabe: ``` { "ImageId": "ami-0eab20fe36f83e1a8" } ``` Weitere Informationen finden Sie unter [Speichern und Wiederherstellen eines AMI mit S3](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateRestoreImageTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-restore-image-task.html)in der *AWS CLI Befehlsreferenz*. ### `create-route-table` Das folgende Codebeispiel zeigt die Verwendung`create-route-table`. **AWS CLI** **So erstellen Sie eine Routing-Tabelle** Dieses Beispiel erstellt eine Routing-Tabelle für die angegebene VPC. Befehl: ``` aws ec2 create-route-table --vpc-id vpc-a01106c2 ``` Ausgabe: ``` { "RouteTable": { "Associations": [], "RouteTableId": "rtb-22574640", "VpcId": "vpc-a01106c2", "PropagatingVgws": [], "Tags": [], "Routes": [ { "GatewayId": "local", "DestinationCidrBlock": "10.0.0.0/16", "State": "active" } ] } } ``` + Einzelheiten zur API finden Sie [CreateRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `create-route` Das folgende Codebeispiel zeigt die Verwendung`create-route`. **AWS CLI** **So erstellen Sie eine Route** Dieses Beispiel erstellt eine Route für die angegebene Routing-Tabelle. Die Route entspricht dem gesamten IPv4 Datenverkehr (`0.0.0.0/0`) und leitet ihn an das angegebene Internet-Gateway weiter. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 create-route --route-table-id rtb-22574640 --destination-cidr-block 0.0.0.0/0 --gateway-id igw-c0a643a9 ``` Dieser Beispielbefehl erstellt eine Route in der Routing-Tabelle rtb-g8ff4ea2. Die Route entspricht dem Verkehr für den IPv4 CIDR-Block 10.0.0.0/16 und leitet ihn an die VPC-Peering-Verbindung pcx-111aaa22 weiter. Diese Route ermöglicht die Weiterleitung des Datenverkehrs an die Peer-VPC in der VPC-Peering-Verbindung. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 create-route --route-table-id rtb-g8ff4ea2 --destination-cidr-block 10.0.0.0/16 --vpc-peering-connection-id pcx-1a2b3c4d ``` In diesem Beispiel wird in der angegebenen Routentabelle eine Route erstellt, die dem gesamten Datenverkehr entspricht (), und ihn an das angegebene Internet-Gateway weiterleitet, das nur für ausgehenden IPv6 Datenverkehr bestimmt ist. `::/0` Befehl: ``` aws ec2 create-route --route-table-id rtb-dce620b8 --destination-ipv6-cidr-block ::/0 --egress-only-internet-gateway-id eigw-01eadbd45ecd7943f ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz [CreateRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-route.html).AWS CLI * ### `create-security-group` Das folgende Codebeispiel zeigt die Verwendung`create-security-group`. **AWS CLI** **So erstellen Sie eine Sicherheitsgruppe für EC2-Classic** In diesem Beispiel wird eine Sicherheitsgruppe mit dem Namen `MySecurityGroup` erstellt. Befehl: ``` aws ec2 create-security-group --group-name MySecurityGroup --description "My security group" ``` Ausgabe: ``` { "GroupId": "sg-903004f8" } ``` **So erstellen Sie eine Sicherheitsgruppe für EC2-VPC** In diesem Beispiel wird eine Sicherheitsgruppe mit dem Namen `MySecurityGroup` für die angegebene VPC erstellt. Befehl: ``` aws ec2 create-security-group --group-name MySecurityGroup --description "My security group" --vpc-id vpc-1a2b3c4d ``` Ausgabe: ``` { "GroupId": "sg-903004f8" } ``` Weitere Informationen finden Sie unter Verwenden von Sicherheitsgruppen im Benutzerhandbuch zu* die AWS -Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [CreateSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-security-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-snapshot`. **AWS CLI** **So erstellen Sie einen Snapshot** Dieser Beispielbefehl erstellt ein Snapshot des Volumes mit der Volume-ID `vol-1234567890abcdef0` und einer kurzen Beschreibung zur Identifizierung des Snapshots. Befehl: ``` aws ec2 create-snapshot --volume-id vol-1234567890abcdef0 --description "This is my root volume snapshot" ``` Ausgabe: ``` { "Description": "This is my root volume snapshot", "Tags": [], "Encrypted": false, "VolumeId": "vol-1234567890abcdef0", "State": "pending", "VolumeSize": 8, "StartTime": "2018-02-28T21:06:01.000Z", "Progress": "", "OwnerId": "012345678910", "SnapshotId": "snap-066877671789bd71b" } ``` **So erstellen Sie einen Snapshot mit Tags** Dieser Beispielbefehl erstellt einen Snapshot und wendet zwei Tags an: purpose=prod und costcenter=123. Befehl: ``` aws ec2 create-snapshot --volume-id vol-1234567890abcdef0 --description 'Prod backup' --tag-specifications 'ResourceType=snapshot,Tags=[{Key=purpose,Value=prod},{Key=costcenter,Value=123}]' ``` Ausgabe: ``` { "Description": "Prod backup", "Tags": [ { "Value": "prod", "Key": "purpose" }, { "Value": "123", "Key": "costcenter" } ], "Encrypted": false, "VolumeId": "vol-1234567890abcdef0", "State": "pending", "VolumeSize": 8, "StartTime": "2018-02-28T21:06:06.000Z", "Progress": "", "OwnerId": "012345678910", "SnapshotId": "snap-09ed24a70bc19bbe4" } ``` + Einzelheiten zur API finden Sie [CreateSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-snapshots` Das folgende Codebeispiel zeigt die Verwendung`create-snapshots`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Snapshot mit mehreren Volumes** Im folgenden Beispiel für `create-snapshots` werden Snapshots aller Volumes erstellt, die der angegebenen Instance angehängt sind. ``` aws ec2 create-snapshots \ --instance-specification InstanceId=i-1234567890abcdef0 \ --description "This is snapshot of a volume from my-instance" ``` Ausgabe: ``` { "Snapshots": [ { "Description": "This is a snapshot of a volume from my-instance", "Tags": [], "Encrypted": false, "VolumeId": "vol-0a01d2d5a34697479", "State": "pending", "VolumeSize": 16, "StartTime": "2019-08-05T16:58:19.000Z", "Progress": "", "OwnerId": "123456789012", "SnapshotId": "snap-07f30e3909aa0045e" }, { "Description": "This is a snapshot of a volume from my-instance", "Tags": [], "Encrypted": false, "VolumeId": "vol-02d0d4947008cb1a2", "State": "pending", "VolumeSize": 20, "StartTime": "2019-08-05T16:58:19.000Z", "Progress": "", "OwnerId": "123456789012", "SnapshotId": "snap-0ec20b602264aad48" }, ... ] } ``` **Beispiel 2: So erstellen Sie einen Snapshot mit mehreren Volumes und Tags aus dem Quell-Volume** Im folgenden Beispiel für `create-snapshots` werden Snapshots aller Volumes erstellt, die der angegebenen Instance angehängt sind, und die Tags von jedem Volume in den entsprechenden Snapshot kopiert. ``` aws ec2 create-snapshots \ --instance-specification InstanceId=i-1234567890abcdef0 \ --copy-tags-from-source volume \ --description "This is snapshot of a volume from my-instance" ``` Ausgabe: ``` { "Snapshots": [ { "Description": "This is a snapshot of a volume from my-instance", "Tags": [ { "Key": "Name", "Value": "my-volume" } ], "Encrypted": false, "VolumeId": "vol-02d0d4947008cb1a2", "State": "pending", "VolumeSize": 20, "StartTime": "2019-08-05T16:53:04.000Z", "Progress": "", "OwnerId": "123456789012", "SnapshotId": "snap-053bfaeb821a458dd" } ... ] } ``` **Beispiel 3: So erstellen Sie einen Snapshot mit mehreren Volumes ohne das Stamm-Volume** Im folgenden Beispiel für `create-snapshots` wird ein Snapshot aller Volumes erstellt, die der angegebenen Instance angehängt sind, mit Ausnahme des Stamm-Volumes. ``` aws ec2 create-snapshots \ --instance-specification InstanceId=i-1234567890abcdef0,ExcludeBootVolume=true ``` Eine Beispielausgabe finden Sie in Beispiel 1. **Beispiel 4: So erstellen Sie einen Snapshot mit mehreren Volumes und fügen Tags hinzu** Im folgenden Beispiel für `create-snapshots` werden Snapshots aller Volumes erstellt, die der angegebenen Instance angehängt sind, und jedem Snapshot werden zwei Tags hinzugefügt. ``` aws ec2 create-snapshots \ --instance-specification InstanceId=i-1234567890abcdef0 \ --tag-specifications 'ResourceType=snapshot,Tags=[{Key=Name,Value=backup},{Key=costcenter,Value=123}]' ``` Eine Beispielausgabe finden Sie in Beispiel 1. + Einzelheiten zur API finden Sie [CreateSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-snapshots.html)in der *AWS CLI Befehlsreferenz*. ### `create-spot-datafeed-subscription` Das folgende Codebeispiel zeigt die Verwendung`create-spot-datafeed-subscription`. **AWS CLI** **So erstellen Sie einen Daten-Feed für eine Spot Instance** Im folgenden Beispiel für `create-spot-datafeed-subscription` wird ein Daten-Feed für eine Spot Instance erstellt. ``` aws ec2 create-spot-datafeed-subscription \ --bucket amzn-s3-demo-bucket \ --prefix spot-data-feed ``` Ausgabe: ``` { "SpotDatafeedSubscription": { "Bucket": "amzn-s3-demo-bucket", "OwnerId": "123456789012", "Prefix": "spot-data-feed", "State": "Active" } } ``` Der Daten-Feed wird im Amazon-S3-Bucket gespeichert, den Sie angegeben haben. Die Dateinamen für diesen Daten-Feed haben das folgende Format. ``` amzn-s3-demo-bucket.s3.amazonaws.com/spot-data-feed/123456789012.YYYY-MM-DD-HH.n.abcd1234.gz ``` Weitere Informationen finden Sie unter [Daten-Feed für eine Spot Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-data-feeds.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateSpotDatafeedSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-spot-datafeed-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `create-store-image-task` Das folgende Codebeispiel zeigt die Verwendung`create-store-image-task`. **AWS CLI** **So speichern Sie ein AMI in einem S3-Bucket** Im folgenden Beispiel für `create-store-image-task` wird ein AMI in einem S3-Bucket gespeichert. Geben Sie die ID des AMI und den Namen des S3-Buckets an, in dem das AMI gespeichert werden soll. ``` aws ec2 create-store-image-task \ --image-id ami-1234567890abcdef0 \ --bucket my-ami-bucket ``` Ausgabe: ``` { "ObjectKey": "ami-1234567890abcdef0.bin" } ``` Weitere Informationen finden Sie unter [Speichern und Wiederherstellen eines AMI mit S3](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [CreateStoreImageTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-store-image-task.html)in der *AWS CLI Befehlsreferenz*. ### `create-subnet-cidr-reservation` Das folgende Codebeispiel zeigt die Verwendung`create-subnet-cidr-reservation`. **AWS CLI** **So erstellen Sie eine Subnetz-CIDR-Reservierung** Im folgenden Beispiel für `create-subnet-cidr-reservation` wird eine Subnetz-CIDR-Reservierung für das angegebene Subnetz und den genannten CIDR-Bereich erstellt. ``` aws ec2 create-subnet-cidr-reservation \ --subnet-id subnet-03c51e2eEXAMPLE \ --reservation-type prefix \ --cidr 10.1.0.20/26 ``` Ausgabe: ``` { "SubnetCidrReservation": { "SubnetCidrReservationId": "scr-044f977c4eEXAMPLE", "SubnetId": "subnet-03c51e2e6cEXAMPLE", "Cidr": "10.1.0.16/28", "ReservationType": "prefix", "OwnerId": "123456789012" } } ``` Weitere Informationen erhalten Sie unter [Subnetz-CIDR-Reservierungen](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-cidr-reservation.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [CreateSubnetCidrReservation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-subnet-cidr-reservation.html)in der *AWS CLI Befehlsreferenz*. ### `create-subnet` Das folgende Codebeispiel zeigt die Verwendung`create-subnet`. **AWS CLI** **Beispiel 1: Um ein Subnetz nur mit einem IPv4 CIDR-Block zu erstellen** Das folgende `create-subnet` Beispiel erstellt ein Subnetz in der angegebenen VPC mit dem angegebenen IPv4 CIDR-Block. ``` aws ec2 create-subnet \ --vpc-id vpc-081ec835f3EXAMPLE \ --cidr-block 10.0.0.0/24 \ --tag-specifications ResourceType=subnet,Tags=[{Key=Name,Value=my-ipv4-only-subnet}] ``` Ausgabe: ``` { "Subnet": { "AvailabilityZone": "us-west-2a", "AvailabilityZoneId": "usw2-az2", "AvailableIpAddressCount": 251, "CidrBlock": "10.0.0.0/24", "DefaultForAz": false, "MapPublicIpOnLaunch": false, "State": "available", "SubnetId": "subnet-0e99b93155EXAMPLE", "VpcId": "vpc-081ec835f3EXAMPLE", "OwnerId": "123456789012", "AssignIpv6AddressOnCreation": false, "Ipv6CidrBlockAssociationSet": [], "Tags": [ { "Key": "Name", "Value": "my-ipv4-only-subnet" } ], "SubnetArn": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0e99b93155EXAMPLE" } } ``` **Beispiel 2: Um ein Subnetz mit sowohl als auch mit CIDR-Blöcken zu erstellen IPv4 IPv6 ** Das folgende `create-subnet` Beispiel erstellt ein Subnetz in der angegebenen VPC mit den angegebenen IPv4 und IPv6 CIDR-Blöcken. ``` aws ec2 create-subnet \ --vpc-id vpc-081ec835f3EXAMPLE \ --cidr-block 10.0.0.0/24 \ --ipv6-cidr-block 2600:1f16:cfe:3660::/64 \ --tag-specifications ResourceType=subnet,Tags=[{Key=Name,Value=my-ipv4-ipv6-subnet}] ``` Ausgabe: ``` { "Subnet": { "AvailabilityZone": "us-west-2a", "AvailabilityZoneId": "usw2-az2", "AvailableIpAddressCount": 251, "CidrBlock": "10.0.0.0/24", "DefaultForAz": false, "MapPublicIpOnLaunch": false, "State": "available", "SubnetId": "subnet-0736441d38EXAMPLE", "VpcId": "vpc-081ec835f3EXAMPLE", "OwnerId": "123456789012", "AssignIpv6AddressOnCreation": false, "Ipv6CidrBlockAssociationSet": [ { "AssociationId": "subnet-cidr-assoc-06c5f904499fcc623", "Ipv6CidrBlock": "2600:1f13:cfe:3660::/64", "Ipv6CidrBlockState": { "State": "associating" } } ], "Tags": [ { "Key": "Name", "Value": "my-ipv4-ipv6-subnet" } ], "SubnetArn": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0736441d38EXAMPLE" } } ``` **Beispiel 3: Um ein Subnetz nur mit einem CIDR-Block zu erstellen IPv6 ** Das folgende `create-subnet` Beispiel erstellt ein Subnetz in der angegebenen VPC mit dem angegebenen IPv6 CIDR-Block. ``` aws ec2 create-subnet \ --vpc-id vpc-081ec835f3EXAMPLE \ --ipv6-native \ --ipv6-cidr-block 2600:1f16:115:200::/64 \ --tag-specifications ResourceType=subnet,Tags=[{Key=Name,Value=my-ipv6-only-subnet}] ``` Ausgabe: ``` { "Subnet": { "AvailabilityZone": "us-west-2a", "AvailabilityZoneId": "usw2-az2", "AvailableIpAddressCount": 0, "DefaultForAz": false, "MapPublicIpOnLaunch": false, "State": "available", "SubnetId": "subnet-03f720e7deEXAMPLE", "VpcId": "vpc-081ec835f3EXAMPLE", "OwnerId": "123456789012", "AssignIpv6AddressOnCreation": true, "Ipv6CidrBlockAssociationSet": [ { "AssociationId": "subnet-cidr-assoc-01ef639edde556709", "Ipv6CidrBlock": "2600:1f13:cfe:3660::/64", "Ipv6CidrBlockState": { "State": "associating" } } ], "Tags": [ { "Key": "Name", "Value": "my-ipv6-only-subnet" } ], "SubnetArn": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-03f720e7deEXAMPLE" } } ``` Weitere Informationen finden Sie unter [VPCs Subnetze](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html) im *Amazon VPC-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateSubnet AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-subnet.html)*Befehlsreferenz*. ### `create-tags` Das folgende Codebeispiel zeigt die Verwendung`create-tags`. **AWS CLI** **Beispiel 6: So fügen Sie einer Ressource ein Tag hinzu** Im folgenden Beispiel für `create-tags` wird das Tag `Stack=production` zu dem angegebenen Image hinzugefügt oder ein vorhandenes Tag für das AMI überschrieben, wobei der Tag-Schlüssel `Stack` ist. ``` aws ec2 create-tags \ --resources ami-1234567890abcdef0 \ --tags Key=Stack,Value=production ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So fügen Sie Tags mehreren Ressourcen hinzu** Im folgenden Beispiel für `create-tags` werden zwei Tags (Markierungen) für ein AMI und eine Instance hinzugefügt (oder überschreibt). Eines der Tags hat einen Schlüssel (`webserver`), aber keinen Wert (Wert ist auf eine leere Zeichenfolge festgelegt). Das andere Tag hat einen Schlüssel (`stack`) und einen Wert (`Production`). ``` aws ec2 create-tags \ --resources ami-1a2b3c4d i-1234567890abcdef0 \ --tags Key=webserver,Value= Key=stack,Value=Production ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 3: So fügen Sie Tags mit Sonderzeichen hinzu** In den folgenden Beispielen für `create-tags` wird das Tag `[Group]=test` für eine Instance hinzugefügt. Die eckigen Klammern ([ und ]) sind Sonderzeichen und müssen mit Escape-Zeichen versehen werden. In den folgenden Beispielen wird auch das Zeilenfortsetzungszeichen verwendet, das für jede Umgebung geeignet ist. Wenn Sie Windows verwenden, schließen Sie das Element, das Sonderzeichen enthält, in doppelte Anführungszeichen (") ein und stellen Sie jedem doppelten Anführungszeichen wie folgt einen umgekehrten Schrägstrich (\$1) voran. ``` aws ec2 create-tags ^ --resources i-1234567890abcdef0 ^ --tags Key=\"[Group]\",Value=test ``` Wenn Sie Windows verwenden PowerShell, setzen Sie für das Element den Wert, der Sonderzeichen enthält, doppelte Anführungszeichen („), stellen Sie jedem doppelten Anführungszeichen einen umgekehrten Schrägstrich (\$1) voran und setzen Sie dann die gesamte Schlüssel- und Wertstruktur wie folgt in einfache Anführungszeichen ('). ``` aws ec2 create-tags ` --resources i-1234567890abcdef0 ` --tags 'Key=\"[Group]\",Value=test' ``` Wenn Sie Linux oder OS X verwenden, schließen Sie das Element mit den Sonderzeichen mit doppelten Anführungszeichen (") ein und dann die gesamte Schlüssel- und Wertstruktur mit einfachen Anführungszeichen (’) wie folgt. ``` aws ec2 create-tags \ --resources i-1234567890abcdef0 \ --tags 'Key="[Group]",Value=test' ``` Weitere Informationen finden Sie unter [Markieren Ihrer Amazon-EC2-Ressourcen mit Tags](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html) im *Benutzerhandbuch für Amazon EC2*. + *Einzelheiten zur API finden Sie [CreateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-tags.html)in AWS CLI der Befehlsreferenz.* ### `create-traffic-mirror-filter-rule` Das folgende Codebeispiel zeigt die Verwendung`create-traffic-mirror-filter-rule`. **AWS CLI** **So erstellen Sie eine Filterregel für eingehenden TCP-Verkehr** Im folgenden Beispiel für `create-traffic-mirror-filter-rule` wird eine Regel erstellt, mit der Sie den gesamten eingehenden TCP-Verkehr spiegeln können. Bevor Sie diesen Befehl ausführen, verwenden Sie `create-traffic-mirror-filter`, um den Filter zum Spiegeln des Datenverkehrs zu erstellen. ``` aws ec2 create-traffic-mirror-filter-rule \ --description 'TCP Rule' \ --destination-cidr-block 0.0.0.0/0 \ --protocol 6 \ --rule-action accept \ --rule-number 1 \ --source-cidr-block 0.0.0.0/0 \ --traffic-direction ingress \ --traffic-mirror-filter-id tmf-04812ff784b25ae67 ``` Ausgabe: ``` { "TrafficMirrorFilterRule": { "DestinationCidrBlock": "0.0.0.0/0", "TrafficMirrorFilterId": "tmf-04812ff784b25ae67", "TrafficMirrorFilterRuleId": "tmfr-02d20d996673f3732", "SourceCidrBlock": "0.0.0.0/0", "TrafficDirection": "ingress", "Description": "TCP Rule", "RuleNumber": 1, "RuleAction": "accept", "Protocol": 6 }, "ClientToken": "4752b573-40a6-4eac-a8a4-a72058761219" } ``` Weitere Informationen finden Sie unter [Erstellen eines Filters zum Spiegeln von Datenverkehr](https://docs.aws.amazon.com/vpc/latest/mirroring/create-traffic-mirroring-filter.html) im *Benutzerhandbuch für Traffic Mirroring*. + Einzelheiten zur API finden Sie [CreateTrafficMirrorFilterRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-traffic-mirror-filter-rule.html)in der *AWS CLI Befehlsreferenz*. ### `create-traffic-mirror-filter` Das folgende Codebeispiel zeigt die Verwendung`create-traffic-mirror-filter`. **AWS CLI** **So erstellen Sie einen Filter zum Spiegeln von Datenverkehr** Im folgenden Beispiel für `create-traffic-mirror-filter` wird ein Filter zum Spiegeln von Datenverkehr erstellt. Nachdem Sie den Filter erstellt haben, fügen Sie mithilfe von `create-traffic-mirror-filter-rule` Regeln hinzu. ``` aws ec2 create-traffic-mirror-filter \ --description 'TCP Filter' ``` Ausgabe: ``` { "ClientToken": "28908518-100b-4987-8233-8c744EXAMPLE", "TrafficMirrorFilter": { "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE", "Description": "TCP Filter", "EgressFilterRules": [], "IngressFilterRules": [], "Tags": [], "NetworkServices": [] } } ``` Weitere Informationen finden Sie unter [Erstellen eines Filters zum Spiegeln von Datenverkehr](https://docs.aws.amazon.com/vpc/latest/mirroring/create-traffic-mirroring-filter.html) im *Benutzerhandbuch für Traffic Mirroring*. + Einzelheiten zur API finden Sie [CreateTrafficMirrorFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-traffic-mirror-filter.html)in der *AWS CLI Befehlsreferenz*. ### `create-traffic-mirror-session` Das folgende Codebeispiel zeigt die Verwendung`create-traffic-mirror-session`. **AWS CLI** **So erstellen Sie eine Datenverkehr-Spiegelungssitzung** Der folgende `create-traffic-mirror-session`-Befehl erstellt eine Datenverkehr-Spiegelungssitzung für die angegebene Quelle und das genannte Ziel für 25 Byte des Pakets. ``` aws ec2 create-traffic-mirror-session \ --description 'example session' \ --traffic-mirror-target-id tmt-07f75d8feeEXAMPLE \ --network-interface-id eni-070203f901EXAMPLE \ --session-number 1 \ --packet-length 25 \ --traffic-mirror-filter-id tmf-04812ff784EXAMPLE ``` Ausgabe: ``` { "TrafficMirrorSession": { "TrafficMirrorSessionId": "tms-08a33b1214EXAMPLE", "TrafficMirrorTargetId": "tmt-07f75d8feeEXAMPLE", "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE", "NetworkInterfaceId": "eni-070203f901EXAMPLE", "OwnerId": "111122223333", "PacketLength": 25, "SessionNumber": 1, "VirtualNetworkId": 7159709, "Description": "example session", "Tags": [] }, "ClientToken": "5236cffc-ee13-4a32-bb5b-388d9da09d96" } ``` Weitere Informationen finden Sie unter [Erstellen einer Datenverkehr-Spiegelungssitzung](https://docs.aws.amazon.com/vpc/latest/mirroring/create-traffic-mirroring-session.html) im *Benutzerhandbuch für Traffic Mirroring*. + Einzelheiten zur API finden Sie [CreateTrafficMirrorSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-traffic-mirror-session.html)in der *AWS CLI Befehlsreferenz*. ### `create-traffic-mirror-target` Das folgende Codebeispiel zeigt die Verwendung`create-traffic-mirror-target`. **AWS CLI** **So erstellen Sie ein Datenverkehr-Spiegelungsziel für einen Network Load Balancer** Im folgenden Beispiel für `create-traffic-mirror-target` wird ein Datenverkehr-Spiegelungsziel für einen Network Load Balancer erstellt. ``` aws ec2 create-traffic-mirror-target \ --description 'Example Network Load Balancer Target' \ --network-load-balancer-arn arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/net/NLB/7cdec873EXAMPLE ``` Ausgabe: ``` { "TrafficMirrorTarget": { "Type": "network-load-balancer", "Tags": [], "Description": "Example Network Load Balancer Target", "OwnerId": "111122223333", "NetworkLoadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:724145273726:loadbalancer/net/NLB/7cdec873EXAMPLE", "TrafficMirrorTargetId": "tmt-0dabe9b0a6EXAMPLE" }, "ClientToken": "d5c090f5-8a0f-49c7-8281-72c796a21f72" } ``` **So erstellen Sie ein Datenverkehr-Spiegelungsziel für ein Netzwerk** Im folgenden Beispiel für `create-traffic-mirror-target` wird ein Datenverkehr-Spiegelungsziel für eine Netzwerkschnittstelle erstellt. ``` aws ec2 create-traffic-mirror-target \ --description 'Network interface target' \ --network-interface-id eni-eni-01f6f631eEXAMPLE ``` Ausgabe: ``` { "ClientToken": "5289a345-0358-4e62-93d5-47ef3061d65e", "TrafficMirrorTarget": { "Description": "Network interface target", "NetworkInterfaceId": "eni-01f6f631eEXAMPLE", "TrafficMirrorTargetId": "tmt-02dcdbe2abEXAMPLE", "OwnerId": "111122223333", "Type": "network-interface", "Tags": [] } } ``` Weitere Informationen finden Sie unter [Erstellen eines Datenverkehr-Spiegelungsziels](https://docs.aws.amazon.com/vpc/latest/mirroring/create-traffic-mirroring-target.html) im *Benutzerhandbuch für Traffic Mirroring*. + Einzelheiten zur API finden Sie [CreateTrafficMirrorTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-traffic-mirror-target.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-gateway-connect-peer` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway-connect-peer`. **AWS CLI** **So erstellen Sie einen Connect-Peer in Transit Gateway** Im folgenden Beispiel für `create-transit-gateway-connect-peer` wird ein Connect-Peer erstellt. ``` aws ec2 create-transit-gateway-connect-peer \ --transit-gateway-attachment-id tgw-attach-0f0927767cEXAMPLE \ --peer-address 172.31.1.11 \ --inside-cidr-blocks 169.254.6.0/29 ``` Ausgabe: ``` { "TransitGatewayConnectPeer": { "TransitGatewayAttachmentId": "tgw-attach-0f0927767cEXAMPLE", "TransitGatewayConnectPeerId": "tgw-connect-peer-0666adbac4EXAMPLE", "State": "pending", "CreationTime": "2021-10-13T03:35:17.000Z", "ConnectPeerConfiguration": { "TransitGatewayAddress": "10.0.0.234", "PeerAddress": "172.31.1.11", "InsideCidrBlocks": [ "169.254.6.0/29" ], "Protocol": "gre", "BgpConfigurations": [ { "TransitGatewayAsn": 64512, "PeerAsn": 64512, "TransitGatewayAddress": "169.254.6.2", "PeerAddress": "169.254.6.1", "BgpStatus": "down" }, { "TransitGatewayAsn": 64512, "PeerAsn": 64512, "TransitGatewayAddress": "169.254.6.3", "PeerAddress": "169.254.6.1", "BgpStatus": "down" } ] } } } ``` Weitere Informationen finden Sie unter [Connect-Anhänge und Connect-Peers in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-connect.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [CreateTransitGatewayConnectPeer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway-connect-peer.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-gateway-connect` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway-connect`. **AWS CLI** **So erstellen Sie einen Connect-Anhang in Transit Gateway** Im folgenden Beispiel für `create-transit-gateway-connect` wird ein Connect-Anhang mit dem Protokoll „gre“ für den angegebenen Anhang erstellt. ``` aws ec2 create-transit-gateway-connect \ --transport-transit-gateway-attachment-id tgw-attach-0a89069f57EXAMPLE \ --options "Protocol=gre" ``` Ausgabe: ``` { "TransitGatewayConnect": { "TransitGatewayAttachmentId": "tgw-attach-037012e5dcEXAMPLE", "TransportTransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "State": "pending", "CreationTime": "2021-03-09T19:59:17+00:00", "Options": { "Protocol": "gre" } } } ``` Weitere Informationen finden Sie unter [Connect-Anhänge und Connect-Peers in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-connect.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [CreateTransitGatewayConnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway-connect.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-gateway-multicast-domain` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway-multicast-domain`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Multicast-Domain** Im folgenden Beispiel für `create-transit-gateway-multicast-domain` wird eine Multicast-Domain für das angegebene Transit-Gateway erstellt. Wenn statische Quellen deaktiviert sind, können Instances in Subnetzen, die mit der Multicast-Domain verknüpft sind, Multicast-Datenverkehr senden. Wenn mindestens ein Mitglied das IGMP-Protokoll verwendet, müssen Sie die IGMPv2 Unterstützung aktivieren. ``` aws ec2 create-transit-gateway-multicast-domain \ --transit-gateway-id tgw-0bf0bffefaEXAMPLE \ --options StaticSourcesSupport=disable,Igmpv2Support=enable ``` Ausgabe: ``` { "TransitGatewayMulticastDomain": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c9e29e2a7EXAMPLE", "TransitGatewayId": "tgw-0bf0bffefaEXAMPLE", "TransitGatewayMulticastDomainArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway-multicast-domain/tgw-mcast-domain-0c9e29e2a7EXAMPLE", "OwnerId": "123456789012", "Options": { "Igmpv2Support": "enable", "StaticSourcesSupport": "disable", "AutoAcceptSharedAssociations": "disable" }, "State": "pending", "CreationTime": "2021-09-29T22:17:13.000Z" } } ``` **Beispiel 2: So erstellen Sie eine statische Multicast-Domain** Im folgenden Beispiel für `create-transit-gateway-multicast-domain` wird eine Multicast-Domain für das angegebene Transit-Gateway erstellt. Wenn statische Quellen aktiviert sind, müssen Sie Quellen statisch hinzufügen. ``` aws ec2 create-transit-gateway-multicast-domain \ --transit-gateway-id tgw-0bf0bffefaEXAMPLE \ --options StaticSourcesSupport=enable,Igmpv2Support=disable ``` Ausgabe: ``` { "TransitGatewayMulticastDomain": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-000fb24d04EXAMPLE", "TransitGatewayId": "tgw-0bf0bffefaEXAMPLE", "TransitGatewayMulticastDomainArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway-multicast-domain/tgw-mcast-domain-000fb24d04EXAMPLE", "OwnerId": "123456789012", "Options": { "Igmpv2Support": "disable", "StaticSourcesSupport": "enable", "AutoAcceptSharedAssociations": "disable" }, "State": "pending", "CreationTime": "2021-09-29T22:20:19.000Z" } } ``` Weitere Informationen finden Sie unter [Verwalten von Multicast-Domains](https://docs.aws.amazon.com/vpc/latest/tgw/manage-domain.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [CreateTransitGatewayMulticastDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway-multicast-domain.html)in der *AWS CLI Befehlsreferenz.* ### `create-transit-gateway-peering-attachment` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway-peering-attachment`. **AWS CLI** **So erstellen Sie einen Anhang von Transit-Gateway-Peering** Im folgenden Beispiel für `create-transit-gateway-peering-attachment` wird eine Anforderung für einen Peering-Anhang zwischen den beiden angegebenen Transit-Gateways erstellt. ``` aws ec2 create-transit-gateway-peering-attachment \ --transit-gateway-id tgw-123abc05e04123abc \ --peer-transit-gateway-id tgw-11223344aabbcc112 \ --peer-account-id 123456789012 \ --peer-region us-east-2 ``` Ausgabe: ``` { "TransitGatewayPeeringAttachment": { "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd", "RequesterTgwInfo": { "TransitGatewayId": "tgw-123abc05e04123abc", "OwnerId": "123456789012", "Region": "us-west-2" }, "AccepterTgwInfo": { "TransitGatewayId": "tgw-11223344aabbcc112", "OwnerId": "123456789012", "Region": "us-east-2" }, "State": "initiatingRequest", "CreationTime": "2019-12-09T11:38:05.000Z" } } ``` Weitere Informationen finden Sie unter [Anhänge von Transit-Gateway-Peering](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-peering.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [CreateTransitGatewayPeeringAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway-peering-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-gateway-policy-table` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway-policy-table`. **AWS CLI** **So erstellen Sie eine Transit-Gateway-Richtlinientabelle** Im folgenden Beispiel für `create-transit-gateway-policy-table` wird eine Transit-Gateway-Richtlinientabelle für das angegebene Transit-Gateway erstellt. ``` aws ec2 create-transit-gateway-policy-table \ --transit-gateway-id tgw-067f8505c18f0bd6e ``` Ausgabe: ``` { "TransitGatewayPolicyTable": { "TransitGatewayPolicyTableId": "tgw-ptb-0a16f134b78668a81", "TransitGatewayId": "tgw-067f8505c18f0bd6e", "State": "pending", "CreationTime": "2023-11-28T16:36:43+00:00" } } ``` Weitere Informationen finden Sie unter [Transit-Gateway-Richtlinientabellen](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-policy-tables.html) im *Benutzerhandbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [CreateTransitGatewayPolicyTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway-policy-table.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-gateway-prefix-list-reference` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway-prefix-list-reference`. **AWS CLI** **So erstellen Sie einen Verweis auf eine Präfixliste** Im folgenden Beispiel für `create-transit-gateway-prefix-list-reference` wird ein Verweis auf die angegebene Präfixliste in der festgelegten Routing-Tabelle von Transit Gateway erstellt. ``` aws ec2 create-transit-gateway-prefix-list-reference \ --transit-gateway-route-table-id tgw-rtb-0123456789abcd123 \ --prefix-list-id pl-11111122222222333 \ --transit-gateway-attachment-id tgw-attach-aaaaaabbbbbb11111 ``` Ausgabe: ``` { "TransitGatewayPrefixListReference": { "TransitGatewayRouteTableId": "tgw-rtb-0123456789abcd123", "PrefixListId": "pl-11111122222222333", "PrefixListOwnerId": "123456789012", "State": "pending", "Blackhole": false, "TransitGatewayAttachment": { "TransitGatewayAttachmentId": "tgw-attach-aaaaaabbbbbb11111", "ResourceType": "vpc", "ResourceId": "vpc-112233445566aabbc" } } } ``` Weitere Informationen finden Sie unter [Erstellen eines Präfixlisten-Verweises](https://docs.aws.amazon.com/vpc/latest/tgw/create-prefix-list-reference.html) im *Benutzerhandbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [CreateTransitGatewayPrefixListReference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway-prefix-list-reference.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-gateway-route-table` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway-route-table`. **AWS CLI** **So erstellen Sie eine Routing-Tabelle in Transit Gateway** Im folgenden Beispiel für `create-transit-gateway-route-table` wird eine Routing-Tabelle für das angegebene Transit-Gateway erstellt. ``` aws ec2 create-transit-gateway-route-table \ --transit-gateway-id tgw-0262a0e521EXAMPLE ``` Ausgabe: ``` { "TransitGatewayRouteTable": { "TransitGatewayRouteTableId": "tgw-rtb-0960981be7EXAMPLE", "TransitGatewayId": "tgw-0262a0e521EXAMPLE", "State": "pending", "DefaultAssociationRouteTable": false, "DefaultPropagationRouteTable": false, "CreationTime": "2019-07-10T19:01:46.000Z" } } ``` Weitere Informationen finden Sie unter [Erstellen einer Routing-Tabelle in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html#create-tgw-route-table) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [CreateTransitGatewayRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-gateway-route` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway-route`. **AWS CLI** **So erstellen Sie eine Transit-Gateway-Route** Im folgenden Beispiel für `create-transit-gateway-route` wird eine Route für die angegebene Routing-Tabelle mit dem festgelegten Ziel erstellt. ``` aws ec2 create-transit-gateway-route \ --destination-cidr-block 10.0.2.0/24 \ --transit-gateway-route-table-id tgw-rtb-0b6f6aaa01EXAMPLE \ --transit-gateway-attachment-id tgw-attach-0b5968d3b6EXAMPLE ``` Ausgabe: ``` { "Route": { "DestinationCidrBlock": "10.0.2.0/24", "TransitGatewayAttachments": [ { "ResourceId": "vpc-0065acced4EXAMPLE", "TransitGatewayAttachmentId": "tgw-attach-0b5968d3b6EXAMPLE", "ResourceType": "vpc" } ], "Type": "static", "State": "active" } } ``` Weitere Informationen finden Sie unter [Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [CreateTransitGatewayRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway-route.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-gateway-vpc-attachment` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway-vpc-attachment`. **AWS CLI** **Beispiel 1: So ordnen Sie einer VPC ein Transit-Gateway zu** Im folgenden Beispiel für `create-transit-gateway-vpc-attachment` wird ein Transit-Gateway-Anhang für die angegebene VPC erstellt. ``` aws ec2 create-transit-gateway-vpc-attachment \ --transit-gateway-id tgw-0262a0e521EXAMPLE \ --vpc-id vpc-07e8ffd50f49335df \ --subnet-id subnet-0752213d59EXAMPLE ``` Ausgabe: ``` { "TransitGatewayVpcAttachment": { "TransitGatewayAttachmentId": "tgw-attach-0a34fe6b4fEXAMPLE", "TransitGatewayId": "tgw-0262a0e521EXAMPLE", "VpcId": "vpc-07e8ffd50fEXAMPLE", "VpcOwnerId": "111122223333", "State": "pending", "SubnetIds": [ "subnet-0752213d59EXAMPLE" ], "CreationTime": "2019-07-10T17:33:46.000Z", "Options": { "DnsSupport": "enable", "Ipv6Support": "disable" } } } ``` Weitere Informationen finden Sie unter [Erstellen eines Transit-Gateway-Anhangs für eine VPC](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html#create-vpc-attachment) im *Handbuch für Transit Gateway*. **Beispiel 2: So ordnen Sie einer VPC ein Transit-Gateway mit mehreren Subnetzen zu** Im folgenden Beispiel für `create-transit-gateway-vpc-attachment` wird ein Transit-Gateway-Anhang für die angegebene VPC und Subnetze erstellt. ``` aws ec2 create-transit-gateway-vpc-attachment \ --transit-gateway-id tgw-02f776b1a7EXAMPLE \ --vpc-id vpc-3EXAMPLE \ --subnet-ids "subnet-dEXAMPLE" "subnet-6EXAMPLE" ``` Ausgabe: ``` { "TransitGatewayVpcAttachment": { "TransitGatewayAttachmentId": "tgw-attach-0e141e0bebEXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "VpcId": "vpc-3EXAMPLE", "VpcOwnerId": "111122223333", "State": "pending", "SubnetIds": [ "subnet-6EXAMPLE", "subnet-dEXAMPLE" ], "CreationTime": "2019-12-17T20:07:52.000Z", "Options": { "DnsSupport": "enable", "Ipv6Support": "disable" } } } ``` Weitere Informationen finden Sie unter [Erstellen eines Transit-Gateway-Anhangs für eine VPC](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html#create-vpc-attachment) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [CreateTransitGatewayVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway-vpc-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `create-transit-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-transit-gateway`. **AWS CLI** **So erstellen Sie ein Transit-Gateway** Im folgenden Beispiel für `create-transit-gateway` wird ein Transit-Gateway erstellt. ``` aws ec2 create-transit-gateway \ --description MyTGW \ --options AmazonSideAsn=64516,AutoAcceptSharedAttachments=enable,DefaultRouteTableAssociation=enable,DefaultRouteTablePropagation=enable,VpnEcmpSupport=enable,DnsSupport=enable ``` Ausgabe: ``` { "TransitGateway": { "TransitGatewayId": "tgw-0262a0e521EXAMPLE", "TransitGatewayArn": "arn:aws:ec2:us-east-2:111122223333:transit-gateway/tgw-0262a0e521EXAMPLE", "State": "pending", "OwnerId": "111122223333", "Description": "MyTGW", "CreationTime": "2019-07-10T14:02:12.000Z", "Options": { "AmazonSideAsn": 64516, "AutoAcceptSharedAttachments": "enable", "DefaultRouteTableAssociation": "enable", "AssociationDefaultRouteTableId": "tgw-rtb-018774adf3EXAMPLE", "DefaultRouteTablePropagation": "enable", "PropagationDefaultRouteTableId": "tgw-rtb-018774adf3EXAMPLE", "VpnEcmpSupport": "enable", "DnsSupport": "enable" } } } ``` Weitere Informationen finden Sie unter [Erstellen eines Transit-Gateways](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-transit-gateways.html#create-tgw) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [CreateTransitGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-transit-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `create-verified-access-endpoint` Das folgende Codebeispiel zeigt die Verwendung`create-verified-access-endpoint`. **AWS CLI** **So erstellen Sie einen verifizierten Zugriffsendpunkt** Im folgenden `create-verified-access-endpoint` Beispiel wird ein Verified Access-Endpunkt für die angegebene Verified Access-Gruppe erstellt. Die angegebene Netzwerkschnittstelle und die Sicherheitsgruppe müssen zu derselben VPC gehören. ``` aws ec2 create-verified-access-endpoint \ --verified-access-group-id vagr-0dbe967baf14b7235 \ --endpoint-type network-interface \ --attachment-type vpc \ --domain-certificate-arn arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE \ --application-domain example.com \ --endpoint-domain-prefix my-ava-app \ --security-group-ids sg-004915970c4c8f13a \ --network-interface-options NetworkInterfaceId=eni-0aec70418c8d87a0f,Protocol=https,Port=443 \ --tag-specifications ResourceType=verified-access-endpoint,Tags=[{Key=Name,Value=my-va-endpoint}] ``` Ausgabe: ``` { "VerifiedAccessEndpoint": { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235", "VerifiedAccessEndpointId": "vae-066fac616d4d546f2", "ApplicationDomain": "example.com", "EndpointType": "network-interface", "AttachmentType": "vpc", "DomainCertificateArn": "arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE", "EndpointDomain": "my-ava-app.edge-00c3372d53b1540bb.vai-0ce000c0b7643abea.prod.verified-access.us-east-2.amazonaws.com", "SecurityGroupIds": [ "sg-004915970c4c8f13a" ], "NetworkInterfaceOptions": { "NetworkInterfaceId": "eni-0aec70418c8d87a0f", "Protocol": "https", "Port": 443 }, "Status": { "Code": "pending" }, "Description": "", "CreationTime": "2023-08-25T20:54:43", "LastUpdatedTime": "2023-08-25T20:54:43", "Tags": [ { "Key": "Name", "Value": "my-va-endpoint" } ] } } ``` Weitere Informationen finden Sie unter [Verified-Access-Endpunkte](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-endpoints.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [CreateVerifiedAccessEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-verified-access-endpoint.html)unter *AWS CLI Befehlsreferenz*. ### `create-verified-access-group` Das folgende Codebeispiel zeigt die Verwendung`create-verified-access-group`. **AWS CLI** **So erstellen Sie eine verifizierte Zugriffsgruppe** Im folgenden Beispiel für `create-verified-access-group` wird eine verifizierter Zugriffsgruppe für die angegebene verifizierte Zugriffs-Instance erstellt. ``` aws ec2 create-verified-access-group \ --verified-access-instance-id vai-0ce000c0b7643abea \ --tag-specifications ResourceType=verified-access-group,Tags=[{Key=Name,Value=my-va-group}] ``` Ausgabe: ``` { "VerifiedAccessGroup": { "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235", "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "", "Owner": "123456789012", "VerifiedAccessGroupArn": "arn:aws:ec2:us-east-2:123456789012:verified-access-group/vagr-0dbe967baf14b7235", "CreationTime": "2023-08-25T19:55:19", "LastUpdatedTime": "2023-08-25T19:55:19", "Tags": [ { "Key": "Name", "Value": "my-va-group" } ] } } ``` Weitere Informationen finden Sie unter [Verified-Access-Gruppen](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-groups.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [CreateVerifiedAccessGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-verified-access-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-verified-access-instance` Das folgende Codebeispiel zeigt die Verwendung`create-verified-access-instance`. **AWS CLI** **So erstellen Sie eine verifizierte Zugriffs-Instance** Im folgenden Beispiel für `create-verified-access-instance` wird eine verifizierte Zugriffs-Instance mit einem Namens-Tag erstellt. ``` aws ec2 create-verified-access-instance \ --tag-specifications ResourceType=verified-access-instance,Tags=[{Key=Name,Value=my-va-instance}] ``` Ausgabe: ``` { "VerifiedAccessInstance": { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "", "VerifiedAccessTrustProviders": [], "CreationTime": "2023-08-25T18:27:56", "LastUpdatedTime": "2023-08-25T18:27:56", "Tags": [ { "Key": "Name", "Value": "my-va-instance" } ] } } ``` Weitere Informationen finden Sie unter [Verified-Access-Instances](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-instances.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [CreateVerifiedAccessInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-verified-access-instance.html)in der *AWS CLI Befehlsreferenz*. ### `create-verified-access-trust-provider` Das folgende Codebeispiel zeigt die Verwendung`create-verified-access-trust-provider`. **AWS CLI** **So erstellen Sie einen Vertrauensanbieter für verifizierten Zugriff** Im folgenden `create-verified-access-trust-provider` Beispiel wird mithilfe von AWS Identity Center ein Vertrauensanbieter mit verifiziertem Zugriff eingerichtet. ``` aws ec2 create-verified-access-trust-provider \ --trust-provider-type user \ --user-trust-provider-type iam-identity-center \ --policy-reference-name idc \ --tag-specifications ResourceType=verified-access-trust-provider,Tags=[{Key=Name,Value=my-va-trust-provider}] ``` Ausgabe: ``` { "VerifiedAccessTrustProvider": { "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7", "Description": "", "TrustProviderType": "user", "UserTrustProviderType": "iam-identity-center", "PolicyReferenceName": "idc", "CreationTime": "2023-08-25T18:40:36", "LastUpdatedTime": "2023-08-25T18:40:36", "Tags": [ { "Key": "Name", "Value": "my-va-trust-provider" } ] } } ``` Weitere Informationen finden Sie unter [Vertrauensanbieter für Verified Access](https://docs.aws.amazon.com/verified-access/latest/ug/trust-providers.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [CreateVerifiedAccessTrustProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-verified-access-trust-provider.html)unter *AWS CLI Befehlsreferenz*. ### `create-volume` Das folgende Codebeispiel zeigt die Verwendung`create-volume`. **AWS CLI** **So erstellen Sie ein leeres Allzweck-SSD-Volume (gp2)** Im folgenden Beispiel für `create-volume` wird ein Allzweck-SSD-Volume (gp2) mit 80 GiB in der angegebenen Availability Zone erstellt. Beachten Sie, dass die aktuelle Region `us-east-1` sein muss. Sie können auch den Parameter `--region` hinzufügen, um die Region für den Befehl anzugeben. ``` aws ec2 create-volume \ --volume-type gp2 \ --size 80 \ --availability-zone us-east-1a ``` Ausgabe: ``` { "AvailabilityZone": "us-east-1a", "Tags": [], "Encrypted": false, "VolumeType": "gp2", "VolumeId": "vol-1234567890abcdef0", "State": "creating", "Iops": 240, "SnapshotId": "", "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z", "Size": 80 } ``` Wenn Sie keinen Volume-Typ angeben, wird der Standard-Volume-Typ `gp2` verwendet. ``` aws ec2 create-volume \ --size 80 \ --availability-zone us-east-1a ``` **Beispiel 2: So erstellen Sie ein bereitgestelltes IOPS-SSD-Volume (io1) aus einem Snapshot** Im folgenden Beispiel für `create-volume` wird mithilfe des angegebenen Snapshots ein bereitgestelltes IOPS-SSD-Volume (io1) mit 1 000 bereitgestellten IOPS in der angegebenen Availability Zone erstellt. ``` aws ec2 create-volume \ --volume-type io1 \ --iops 1000 \ --snapshot-id snap-066877671789bd71b \ --availability-zone us-east-1a ``` Ausgabe: ``` { "AvailabilityZone": "us-east-1a", "Tags": [], "Encrypted": false, "VolumeType": "io1", "VolumeId": "vol-1234567890abcdef0", "State": "creating", "Iops": 1000, "SnapshotId": "snap-066877671789bd71b", "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z", "Size": 500 } ``` **Beispiel 3: So erstellen Sie ein verschlüsseltes Volume** Im folgenden Beispiel für `create-volume` wird ein verschlüsseltes Volume erstellt, das den Standard-CMK für die EBS-Verschlüsselung verwendet. Wenn die standardmäßige Verschlüsselung deaktiviert ist, müssen Sie den Parameter `--encrypted` wie folgt angeben. ``` aws ec2 create-volume \ --size 80 \ --encrypted \ --availability-zone us-east-1a ``` Ausgabe: ``` { "AvailabilityZone": "us-east-1a", "Tags": [], "Encrypted": true, "VolumeType": "gp2", "VolumeId": "vol-1234567890abcdef0", "State": "creating", "Iops": 240, "SnapshotId": "", "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z", "Size": 80 } ``` Wenn die Verschlüsselung standardmäßig aktiviert ist, erstellt der folgende Beispielbefehl ein verschlüsseltes Volume, auch ohne den Parameter `--encrypted`. ``` aws ec2 create-volume \ --size 80 \ --availability-zone us-east-1a ``` Wenn Sie den Parameter `--kms-key-id` verwenden, um einen vom Kunden verwalteten Schlüssel anzugeben, müssen Sie den Parameter `--encrypted` auch dann angeben, wenn die standardmäßige Verschlüsselung aktiviert ist. ``` aws ec2 create-volume \ --volume-type gp2 \ --size 80 \ --encrypted \ --kms-key-id 0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE \ --availability-zone us-east-1a ``` **Beispiel 4: So erstellen Sie ein Volume mit Tags** Im folgenden Beispiel für `create-volume` wird ein Volume erstellt und zwei Tags werden hinzugefügt. ``` aws ec2 create-volume \ --availability-zone us-east-1a \ --volume-type gp2 \ --size 80 \ --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]' ``` + Einzelheiten zur API finden Sie [CreateVolume](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-volume.html)in der *AWS CLI Befehlsreferenz*. ### `create-vpc-endpoint-connection-notification` Das folgende Codebeispiel zeigt die Verwendung`create-vpc-endpoint-connection-notification`. **AWS CLI** **So erstellen Sie eine Endpunkt-Verbindungsbenachrichtigung** In diesem Beispiel wird eine Benachrichtigung für einen bestimmten Endpunktservice erstellt, die Sie informiert, wenn Schnittstellenendpunkte eine Verbindung mit Ihrem Service hergestellt haben und wenn Endpunkte für Ihren Service akzeptiert wurden. Befehl: ``` aws ec2 create-vpc-endpoint-connection-notification --connection-notification-arn arn:aws:sns:us-east-2:123456789012:VpceNotification --connection-events Connect Accept --service-id vpce-svc-1237881c0d25a3abc ``` Ausgabe: ``` { "ConnectionNotification": { "ConnectionNotificationState": "Enabled", "ConnectionNotificationType": "Topic", "ServiceId": "vpce-svc-1237881c0d25a3abc", "ConnectionEvents": [ "Accept", "Connect" ], "ConnectionNotificationId": "vpce-nfn-008776de7e03f5abc", "ConnectionNotificationArn": "arn:aws:sns:us-east-2:123456789012:VpceNotification" } } ``` + Einzelheiten zur API finden Sie [CreateVpcEndpointConnectionNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-vpc-endpoint-connection-notification.html)in der *AWS CLI Befehlsreferenz*. ### `create-vpc-endpoint-service-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-vpc-endpoint-service-configuration`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Endpunkt-Servicekonfiguration für einen Schnittstellenendpunkt** Im folgenden Beispiel für `create-vpc-endpoint-service-configuration` wird mithilfe des Network Load Balancer `nlb-vpce` eine VPC-Endpunkt-Servicekonfiguration erstellt. In diesem Beispiel wird auch angegeben, dass Anforderungen zum Herstellen einer Verbindung mit dem Service über einen Schnittstellenendpunkt akzeptiert werden müssen. ``` aws ec2 create-vpc-endpoint-service-configuration \ --network-load-balancer-arns arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/nlb-vpce/e94221227f1ba532 \ --acceptance-required ``` Ausgabe: ``` { "ServiceConfiguration": { "ServiceType": [ { "ServiceType": "Interface" } ], "NetworkLoadBalancerArns": [ "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/nlb-vpce/e94221227f1ba532" ], "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-03d5ebb7d9579a2b3", "ServiceState": "Available", "ServiceId": "vpce-svc-03d5ebb7d9579a2b3", "AcceptanceRequired": true, "AvailabilityZones": [ "us-east-1d" ], "BaseEndpointDnsNames": [ "vpce-svc-03d5ebb7d9579a2b3.us-east-1.vpce.amazonaws.com" ] } } ``` Weitere Informationen finden Sie im *AWS PrivateLink Benutzerhandbuch* unter [Erstellen eines Endpunktdienstes](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html). **Beispiel 2: So erstellen Sie eine Endpunkt-Servicekonfiguration für einen Endpunkt von Gateway Load Balancer** Im folgenden Beispiel für `create-vpc-endpoint-service-configuration` wird mithilfe des Gateway Load Balancers `GWLBService` eine VPC-Endpunkt-Servicekonfiguration erstellt. Anforderungen zum Herstellen einer Verbindung mit dem Service über einen Endpunkt von Gateway Load Balancer werden automatisch akzeptiert. ``` aws ec2 create-vpc-endpoint-service-configuration \ --gateway-load-balancer-arns arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/gwy/GWLBService/123123123123abcc \ --no-acceptance-required ``` Ausgabe: ``` { "ServiceConfiguration": { "ServiceType": [ { "ServiceType": "GatewayLoadBalancer" } ], "ServiceId": "vpce-svc-123123a1c43abc123", "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123", "ServiceState": "Available", "AvailabilityZones": [ "us-east-1d" ], "AcceptanceRequired": false, "ManagesVpcEndpoints": false, "GatewayLoadBalancerArns": [ "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/gwy/GWLBService/123123123123abcc" ] } } ``` Weitere Informationen finden Sie unter [Erstellen eines Gateway Load Balancer-Endpunktdienstes](https://docs.aws.amazon.com/vpc/latest/privatelink/create-gateway-load-balancer-endpoint-service.html) im *AWS PrivateLink Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateVpcEndpointServiceConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-vpc-endpoint-service-configuration.html)*Befehlsreferenz.* ### `create-vpc-endpoint` Das folgende Codebeispiel zeigt die Verwendung`create-vpc-endpoint`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Gateway-Endpunkt** Im folgenden Beispiel für `create-vpc-endpoint` wird ein Gateway-VPC-Endpunkt zwischen der VPC `vpc-1a2b3c4d` und Amazon S3 in der Region `us-east-1` erstellt und die Routing-Tabelle `rtb-11aa22bb` mit dem Endpunkt verknüpft. ``` aws ec2 create-vpc-endpoint \ --vpc-id vpc-1a2b3c4d \ --service-name com.amazonaws.us-east-1.s3 \ --route-table-ids rtb-11aa22bb ``` Ausgabe: ``` { "VpcEndpoint": { "PolicyDocument": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"\",\"Effect\":\"Allow\",\"Principal\":\"\*\",\"Action\":\"\*\",\"Resource\":\"\*\"}]}", "VpcId": "vpc-1a2b3c4d", "State": "available", "ServiceName": "com.amazonaws.us-east-1.s3", "RouteTableIds": [ "rtb-11aa22bb" ], "VpcEndpointId": "vpc-1a2b3c4d", "CreationTimestamp": "2015-05-15T09:40:50Z" } } ``` Weitere Informationen finden Sie im *Benutzerhandbuch* unter [Erstellen eines Gateway-Endpunkts](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html#create-gateway-endpoint-s3).AWS PrivateLink **Beispiel 2: So erstellen Sie einen Schnittstellenendpunkt** Im folgenden Beispiel für `create-vpc-endpoint` wird ein VPC-Schnittstellenendpunkt zwischen der VPC `vpc-1a2b3c4d` und Amazon S3 in der Region `us-east-1` erstellt. Der Befehl erstellt den Endpunkt im Subnetz `subnet-1a2b3c4d`, ordnet ihn der Sicherheitsgruppe `sg-1a2b3c4d` zu und fügt ein Tag mit dem Schlüssel „Service“ und dem Wert „S3" hinzu. ``` aws ec2 create-vpc-endpoint \ --vpc-id vpc-1a2b3c4d \ --vpc-endpoint-type Interface \ --service-name com.amazonaws.us-east-1.s3 \ --subnet-ids subnet-7b16de0c \ --security-group-id sg-1a2b3c4d \ --tag-specifications ResourceType=vpc-endpoint,Tags=[{Key=service,Value=S3}] ``` Ausgabe: ``` { "VpcEndpoint": { "VpcEndpointId": "vpce-1a2b3c4d5e6f1a2b3", "VpcEndpointType": "Interface", "VpcId": "vpc-1a2b3c4d", "ServiceName": "com.amazonaws.us-east-1.s3", "State": "pending", "RouteTableIds": [], "SubnetIds": [ "subnet-1a2b3c4d" ], "Groups": [ { "GroupId": "sg-1a2b3c4d", "GroupName": "default" } ], "PrivateDnsEnabled": false, "RequesterManaged": false, "NetworkInterfaceIds": [ "eni-0b16f0581c8ac6877" ], "DnsEntries": [ { "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg.s3.us-east-1.vpce.amazonaws.com", "HostedZoneId": "Z7HUB22UULQXV" }, { "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg-us-east-1c.s3.us-east-1.vpce.amazonaws.com", "HostedZoneId": "Z7HUB22UULQXV" } ], "CreationTimestamp": "2021-03-05T14:46:16.030000+00:00", "Tags": [ { "Key": "service", "Value": "S3" } ], "OwnerId": "123456789012" } } ``` Weitere Informationen finden Sie im *Benutzerhandbuch* unter [Erstellen eines Schnittstellen-VPC-Endpunkts](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html).AWS PrivateLink **Beispiel 3: So erstellen Sie einen Endpunkt für Gateway Load Balancer** Im folgenden Beispiel für `create-vpc-endpoint` wird ein Endpunkt für Gateway Load Balancer zwischen der VPC `vpc-111122223333aabbc` und einem Service erstellt, der mithilfe eines Gateway Load Balancers konfiguriert ist. ``` aws ec2 create-vpc-endpoint \ --service-name com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123 \ --vpc-endpoint-type GatewayLoadBalancer \ --vpc-id vpc-111122223333aabbc \ --subnet-ids subnet-0011aabbcc2233445 ``` Ausgabe: ``` { "VpcEndpoint": { "VpcEndpointId": "vpce-aabbaabbaabbaabba", "VpcEndpointType": "GatewayLoadBalancer", "VpcId": "vpc-111122223333aabbc", "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123", "State": "pending", "SubnetIds": [ "subnet-0011aabbcc2233445" ], "RequesterManaged": false, "NetworkInterfaceIds": [ "eni-01010120203030405" ], "CreationTimestamp": "2020-11-11T08:06:03.522Z", "OwnerId": "123456789012" } } ``` Weitere Informationen finden Sie unter [Gateway Load Balancer-Endpoints](https://docs.aws.amazon.com/vpc/latest/privatelink/gateway-load-balancer-endpoints.html) im *AWS PrivateLink Benutzerhandbuch*. **Beispiel 4: So erstellen Sie einen Ressourcenendpunkt** Im folgenden Beispiel für `create-vpc-endpoint` wird ein Ressourcenendpunkt erstellt. ``` aws ec2 create-vpc-endpoint \ --vpc-endpoint-type Resource \ --vpc-id vpc-111122223333aabbc \ --subnet-ids subnet-0011aabbcc2233445 \ --resource-configuration-arn arn:aws:vpc-lattice-us-east-1:123456789012:resourceconfiguration/rcfg-0123abcde98765432 ``` Ausgabe: ``` { "VpcEndpoint": { "VpcEndpointId": "vpce-00939a7ed9EXAMPLE", "VpcEndpointType": "Resource", "VpcId": "vpc-111122223333aabbc", "State": "Pending", "SubnetIds": [ "subnet-0011aabbcc2233445" ], "Groups": [ { "GroupId": "sg-03e2f15fbfc09b000", "GroupName": "default" } ], "IpAddressType": "IPV4", "PrivateDnsEnabled": false, "CreationTimestamp": "2025-02-06T23:38:49.525000+00:00", "Tags": [], "OwnerId": "123456789012", "ResourceConfigurationArn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-0123abcde98765432" } } ``` *Weitere Informationen finden Sie im Benutzerhandbuch unter [Ressourcenendpunkte](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-resources.html).AWS PrivateLink * **Beispiel 5: So erstellen Sie einen Service-Netzwerkendpunkt** Im folgenden Beispiel für `create-vpc-endpoint` wird ein Service-Netzwerkendpunkt erstellt. ``` aws ec2 create-vpc-endpoint \ --vpc-endpoint-type ServiceNetwork \ --vpc-id vpc-111122223333aabbc \ --subnet-ids subnet-0011aabbcc2233445 \ --service-network-arn arn:aws:vpc-lattice:us-east-1:123456789012:servicenetwork/sn-0101abcd5432abcd0 \ --security-group-ids sg-0123456789012abcd ``` Ausgabe: ``` { "VpcEndpoint": { "VpcEndpointId": "vpce-0f00567fa8EXAMPLE", "VpcEndpointType": "ServiceNetwork", "VpcId": "vpc-111122223333aabbc", "State": "Pending", "SubnetIds": [ "subnet-0011aabbcc2233445" ], "Groups": [ { "GroupId": "sg-0123456789012abcd", "GroupName": "my-security-group" } ], "IpAddressType": "IPV4", "PrivateDnsEnabled": false, "CreationTimestamp": "2025-02-06T23:44:20.449000+00:00", "Tags": [], "OwnerId": "123456789012", "ServiceNetworkArn": "arn:aws:vpc-lattice:us-east-1:123456789012:servicenetwork/sn-0101abcd5432abcd0" } } ``` Weitere Informationen finden Sie im *AWS PrivateLink Benutzerhandbuch* unter [Service-Netzwerkendpunkte](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-service-networks.html). + Einzelheiten zur API finden Sie [CreateVpcEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-vpc-endpoint.html)in der *AWS CLI Befehlsreferenz.* ### `create-vpc-peering-connection` Das folgende Codebeispiel zeigt die Verwendung`create-vpc-peering-connection`. **AWS CLI** **Um eine VPC-Peering-Verbindung zwischen Ihrem herzustellen VPCs** In diesem Beispiel wird eine Peering-Verbindung zwischen Ihrem VPCs vpc-1a2b3c4d und vpc-11122233 angefordert. Befehl: ``` aws ec2 create-vpc-peering-connection --vpc-id vpc-1a2b3c4d --peer-vpc-id vpc-11122233 ``` Ausgabe: ``` { "VpcPeeringConnection": { "Status": { "Message": "Initiating Request to 444455556666", "Code": "initiating-request" }, "Tags": [], "RequesterVpcInfo": { "OwnerId": "444455556666", "VpcId": "vpc-1a2b3c4d", "CidrBlock": "10.0.0.0/28" }, "VpcPeeringConnectionId": "pcx-111aaa111", "ExpirationTime": "2014-04-02T16:13:36.000Z", "AccepterVpcInfo": { "OwnerId": "444455556666", "VpcId": "vpc-11122233" } } } ``` **So erstellen Sie eine VPC-Peering-Verbindung mit einer VPC in einem anderen Konto** In diesem Beispiel wird eine Peering-Verbindung zwischen Ihrer VPC (vpc-1a2b3c4d) und einer VPC (vpc-11122233) angefordert, die zum Konto 123456789012 gehört. AWS Befehl: ``` aws ec2 create-vpc-peering-connection --vpc-id vpc-1a2b3c4d --peer-vpc-id vpc-11122233 --peer-owner-id 123456789012 ``` **So erstellen Sie eine VPC-Peering-Verbindung mit einer VPC in einer anderen Region** In diesem Beispiel wird eine Peering-Verbindung zwischen Ihrer VPC in der aktuellen Region (vpc-1a2b3c4d) und einer VPC (vpc-11122233) in Ihrem Konto in der Region `us-west-2` angefordert. Befehl: ``` aws ec2 create-vpc-peering-connection --vpc-id vpc-1a2b3c4d --peer-vpc-id vpc-11122233 --peer-region us-west-2 ``` In diesem Beispiel wird eine Peering-Verbindung zwischen Ihrer VPC in der aktuellen Region (vpc-1a2b3c4d) und einer VPC (vpc-11122233) angefordert, die zum Konto 123456789012 gehört, das sich in der Region befindet. AWS `us-west-2` Befehl: ``` aws ec2 create-vpc-peering-connection --vpc-id vpc-1a2b3c4d --peer-vpc-id vpc-11122233 --peer-owner-id 123456789012 --peer-region us-west-2 ``` + Einzelheiten zur [CreateVpcPeeringConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-vpc-peering-connection.html)API finden *Sie* in der Befehlsreferenz.AWS CLI ### `create-vpc` Das folgende Codebeispiel zeigt die Verwendung`create-vpc`. **AWS CLI** **Beispiel 1: So erstellen Sie eine VPC** Im folgenden `create-vpc` Beispiel wird eine VPC mit dem angegebenen IPv4 CIDR-Block und einem Name-Tag erstellt. ``` aws ec2 create-vpc \ --cidr-block 10.0.0.0/16 \ --tag-specifications ResourceType=vpc,Tags=[{Key=Name,Value=MyVpc}] ``` Ausgabe: ``` { "Vpc": { "CidrBlock": "10.0.0.0/16", "DhcpOptionsId": "dopt-5EXAMPLE", "State": "pending", "VpcId": "vpc-0a60eb65b4EXAMPLE", "OwnerId": "123456789012", "InstanceTenancy": "default", "Ipv6CidrBlockAssociationSet": [], "CidrBlockAssociationSet": [ { "AssociationId": "vpc-cidr-assoc-07501b79ecEXAMPLE", "CidrBlock": "10.0.0.0/16", "CidrBlockState": { "State": "associated" } } ], "IsDefault": false, "Tags": [ { "Key": "Name", "Value": MyVpc" } ] } } ``` **Beispiel 2: So erstellen Sie eine VPC mit dedizierter Tenancy** Im folgenden `create-vpc` Beispiel wird eine VPC mit dem angegebenen IPv4 CIDR-Block und einer dedizierten Tenancy erstellt. ``` aws ec2 create-vpc \ --cidr-block 10.0.0.0/16 \ --instance-tenancy dedicated ``` Ausgabe: ``` { "Vpc": { "CidrBlock": "10.0.0.0/16", "DhcpOptionsId": "dopt-19edf471", "State": "pending", "VpcId": "vpc-0a53287fa4EXAMPLE", "OwnerId": "111122223333", "InstanceTenancy": "dedicated", "Ipv6CidrBlockAssociationSet": [], "CidrBlockAssociationSet": [ { "AssociationId": "vpc-cidr-assoc-00b24cc1c2EXAMPLE", "CidrBlock": "10.0.0.0/16", "CidrBlockState": { "State": "associated" } } ], "IsDefault": false } } ``` **Beispiel 3: So erstellen Sie eine VPC mit einem IPv6 CIDR-Block** Im folgenden `create-vpc` Beispiel wird eine VPC mit einem von Amazon bereitgestellten CIDR-Block IPv6 erstellt. ``` aws ec2 create-vpc \ --cidr-block 10.0.0.0/16 \ --amazon-provided-ipv6-cidr-block ``` Ausgabe: ``` { "Vpc": { "CidrBlock": "10.0.0.0/16", "DhcpOptionsId": "dopt-dEXAMPLE", "State": "pending", "VpcId": "vpc-0fc5e3406bEXAMPLE", "OwnerId": "123456789012", "InstanceTenancy": "default", "Ipv6CidrBlockAssociationSet": [ { "AssociationId": "vpc-cidr-assoc-068432c60bEXAMPLE", "Ipv6CidrBlock": "", "Ipv6CidrBlockState": { "State": "associating" }, "Ipv6Pool": "Amazon", "NetworkBorderGroup": "us-west-2" } ], "CidrBlockAssociationSet": [ { "AssociationId": "vpc-cidr-assoc-0669f8f9f5EXAMPLE", "CidrBlock": "10.0.0.0/16", "CidrBlockState": { "State": "associated" } } ], "IsDefault": false } } ``` **Beispiel 4: So erstellen Sie eine VPC mit einer CIDR aus einem IPAM-Pool** Im folgenden Beispiel für `create-vpc` wird eine VPC mit CIDR aus einem Amazon VPC IP Address Manager (IPAM)-Pool erstellt. Linux und macOS: ``` aws ec2 create-vpc \ --ipv4-ipam-pool-id ipam-pool-0533048da7d823723 \ --tag-specifications ResourceType=vpc,Tags='[{Key=Environment,Value="Preprod"},{Key=Owner,Value="Build Team"}]' ``` Windows: ``` aws ec2 create-vpc ^ --ipv4-ipam-pool-id ipam-pool-0533048da7d823723 ^ --tag-specifications ResourceType=vpc,Tags=[{Key=Environment,Value="Preprod"},{Key=Owner,Value="Build Team"}] ``` Ausgabe: ``` { "Vpc": { "CidrBlock": "10.0.1.0/24", "DhcpOptionsId": "dopt-2afccf50", "State": "pending", "VpcId": "vpc-010e1791024eb0af9", "OwnerId": "123456789012", "InstanceTenancy": "default", "Ipv6CidrBlockAssociationSet": [], "CidrBlockAssociationSet": [ { "AssociationId": "vpc-cidr-assoc-0a77de1d803226d4b", "CidrBlock": "10.0.1.0/24", "CidrBlockState": { "State": "associated" } } ], "IsDefault": false, "Tags": [ { "Key": "Environment", "Value": "Preprod" }, { "Key": "Owner", "Value": "Build Team" } ] } } ``` Weitere Informationen finden Sie unter [Eine VPC erstellen, die einen IPAM-Pool CIDR verwendet](https://docs.aws.amazon.com/vpc/latest/ipam/create-vpc-ipam.html) im *Benutzerhandbuch zu Amazon VPC IPAM*. + *Einzelheiten zur API finden Sie unter [CreateVpc](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-vpc.html)Befehlsreferenz.AWS CLI * ### `create-vpn-connection-route` Das folgende Codebeispiel zeigt die Verwendung`create-vpn-connection-route`. **AWS CLI** **So erstellen Sie eine statische Route für eine VPN-Verbindung** Dieses Beispiel erstellt eine statische Routing-Tabelle für die angegebene VPN-Verbindung. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 create-vpn-connection-route --vpn-connection-id vpn-40f41529 --destination-cidr-block 11.12.0.0/16 ``` + Einzelheiten zur API finden Sie [CreateVpnConnectionRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-vpn-connection-route.html)in der *AWS CLI Befehlsreferenz*. ### `create-vpn-connection` Das folgende Codebeispiel zeigt die Verwendung`create-vpn-connection`. **AWS CLI** **Beispiel 1: So stellen Sie eine VPN-Verbindung mit dynamischem Routing her** Im folgenden Beispiel für `create-vpn-connection` werden eine VPN-Verbindung zwischen dem angegebenen Virtual Private Gateway und dem festgelegten Kunden-Gateway hergestellt und Tags auf die VPN-Verbindung angewendet. Die Ausgabe enthält die Konfigurationsinformationen für Ihr Kunden-Gateway-Gerät im XML-Format. ``` aws ec2 create-vpn-connection \ --type ipsec.1 \ --customer-gateway-id cgw-001122334455aabbc \ --vpn-gateway-id vgw-1a1a1a1a1a1a2b2b2 \ --tag-specification 'ResourceType=vpn-connection,Tags=[{Key=Name,Value=BGP-VPN}]' ``` Ausgabe: ``` { "VpnConnection": { "CustomerGatewayConfiguration": "...configuration information...", "CustomerGatewayId": "cgw-001122334455aabbc", "Category": "VPN", "State": "pending", "VpnConnectionId": "vpn-123123123123abcab", "VpnGatewayId": "vgw-1a1a1a1a1a1a2b2b2", "Options": { "EnableAcceleration": false, "StaticRoutesOnly": false, "LocalIpv4NetworkCidr": "0.0.0.0/0", "RemoteIpv4NetworkCidr": "0.0.0.0/0", "TunnelInsideIpVersion": "ipv4", "TunnelOptions": [ {}, {} ] }, "Routes": [], "Tags": [ { "Key": "Name", "Value": "BGP-VPN" } ] } } ``` Weitere Informationen finden Sie unter [So funktioniert AWS Site-to-Site VPN](https://docs.aws.amazon.com/vpn/latest/s2svpn/how_it_works.html) im *AWS Site-to-Site VPN-Benutzerhandbuch*. **Beispiel 2: So stellen Sie eine VPN-Verbindung mit statischem Routing her** Im folgenden Beispiel für `create-vpn-connection` wird eine VPN-Verbindung zwischen dem angegebenen Virtual Private Gateway und dem festgelegten Kunden-Gateway hergestellt. Die Optionen geben statisches Routing an. Die Ausgabe enthält die Konfigurationsinformationen für Ihr Kunden-Gateway-Gerät im XML-Format. ``` aws ec2 create-vpn-connection \ --type ipsec.1 \ --customer-gateway-id cgw-001122334455aabbc \ --vpn-gateway-id vgw-1a1a1a1a1a1a2b2b2 \ --options "{\"StaticRoutesOnly\":true}" ``` Ausgabe: ``` { "VpnConnection": { "CustomerGatewayConfiguration": "..configuration information...", "CustomerGatewayId": "cgw-001122334455aabbc", "Category": "VPN", "State": "pending", "VpnConnectionId": "vpn-123123123123abcab", "VpnGatewayId": "vgw-1a1a1a1a1a1a2b2b2", "Options": { "EnableAcceleration": false, "StaticRoutesOnly": true, "LocalIpv4NetworkCidr": "0.0.0.0/0", "RemoteIpv4NetworkCidr": "0.0.0.0/0", "TunnelInsideIpVersion": "ipv4", "TunnelOptions": [ {}, {} ] }, "Routes": [], "Tags": [] } } ``` Weitere Informationen finden Sie unter [So funktioniert AWS Site-to-Site VPN](https://docs.aws.amazon.com/vpn/latest/s2svpn/how_it_works.html) im *AWS Site-to-Site VPN-Benutzerhandbuch*. **Beispiel 3: So stellen Sie eine VPN-Verbindung her und geben Ihr eigenes internes CIDR sowie Ihren im Vorfeld freigegebenen Schlüssel an** Im folgenden Beispiel für `create-vpn-connection` wird eine VPN-Verbindung hergestellt und der CIDR-Block der internen IP-Adresse sowie ein benutzerdefinierter, im Vorfeld freigegebener Schlüssel für jeden Tunnel angegeben. Die angegebenen Werte werden in den `CustomerGatewayConfiguration`-Informationen zurückgegeben. ``` aws ec2 create-vpn-connection \ --type ipsec.1 \ --customer-gateway-id cgw-001122334455aabbc \ --vpn-gateway-id vgw-1a1a1a1a1a1a2b2b2 \ --options TunnelOptions='[{TunnelInsideCidr=169.254.12.0/30,PreSharedKey=ExamplePreSharedKey1},{TunnelInsideCidr=169.254.13.0/30,PreSharedKey=ExamplePreSharedKey2}]' ``` Ausgabe: ``` { "VpnConnection": { "CustomerGatewayConfiguration": "..configuration information...", "CustomerGatewayId": "cgw-001122334455aabbc", "Category": "VPN", "State": "pending", "VpnConnectionId": "vpn-123123123123abcab", "VpnGatewayId": "vgw-1a1a1a1a1a1a2b2b2", "Options": { "EnableAcceleration": false, "StaticRoutesOnly": false, "LocalIpv4NetworkCidr": "0.0.0.0/0", "RemoteIpv4NetworkCidr": "0.0.0.0/0", "TunnelInsideIpVersion": "ipv4", "TunnelOptions": [ { "OutsideIpAddress": "203.0.113.3", "TunnelInsideCidr": "169.254.12.0/30", "PreSharedKey": "ExamplePreSharedKey1" }, { "OutsideIpAddress": "203.0.113.5", "TunnelInsideCidr": "169.254.13.0/30", "PreSharedKey": "ExamplePreSharedKey2" } ] }, "Routes": [], "Tags": [] } } ``` Weitere Informationen finden Sie unter [So funktioniert AWS Site-to-Site VPN](https://docs.aws.amazon.com/vpn/latest/s2svpn/how_it_works.html) im *AWS Site-to-Site VPN-Benutzerhandbuch*. **Beispiel 4: So erstellen Sie eine VPN-Verbindung, die IPv6 Datenverkehr unterstützt** Im folgenden `create-vpn-connection` Beispiel wird eine VPN-Verbindung erstellt, die den IPv6 Verkehr zwischen dem angegebenen Transit-Gateway und dem angegebenen Kunden-Gateway unterstützt. Die Tunneloptionen für beide Tunnel geben an, dass die IKE-Verhandlung initiiert werden AWS muss. ``` aws ec2 create-vpn-connection \ --type ipsec.1 \ --transit-gateway-id tgw-12312312312312312 \ --customer-gateway-id cgw-001122334455aabbc \ --options TunnelInsideIpVersion=ipv6,TunnelOptions=[{StartupAction=start},{StartupAction=start}] ``` Ausgabe: ``` { "VpnConnection": { "CustomerGatewayConfiguration": "..configuration information...", "CustomerGatewayId": "cgw-001122334455aabbc", "Category": "VPN", "State": "pending", "VpnConnectionId": "vpn-11111111122222222", "TransitGatewayId": "tgw-12312312312312312", "Options": { "EnableAcceleration": false, "StaticRoutesOnly": false, "LocalIpv6NetworkCidr": "::/0", "RemoteIpv6NetworkCidr": "::/0", "TunnelInsideIpVersion": "ipv6", "TunnelOptions": [ { "OutsideIpAddress": "203.0.113.3", "StartupAction": "start" }, { "OutsideIpAddress": "203.0.113.5", "StartupAction": "start" } ] }, "Routes": [], "Tags": [] } } ``` Weitere Informationen finden Sie unter [So funktioniert AWS Site-to-Site VPN](https://docs.aws.amazon.com/vpn/latest/s2svpn/how_it_works.html) im *AWS Site-to-Site VPN-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateVpnConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-vpn-connection.html)in der *AWS CLI Befehlsreferenz*. ### `create-vpn-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-vpn-gateway`. **AWS CLI** **So erstellen Sie ein Virtual Private Gateway** In diesem Beispiel wird ein Virtual Private Gateway erstellt. Befehl: ``` aws ec2 create-vpn-gateway --type ipsec.1 ``` Ausgabe: ``` { "VpnGateway": { "AmazonSideAsn": 64512, "State": "available", "Type": "ipsec.1", "VpnGatewayId": "vgw-9a4cacf3", "VpcAttachments": [] } } ``` **So erstellen Sie ein Virtual Private Gateway mit einer bestimmten Amazon-seitigen ASN** In diesem Beispiel wird ein Virtual Private Gateway erstellt und die autonome Systemnummer (ASN) für die Amazon-Seite der BGP-Sitzung angegeben. Befehl: ``` aws ec2 create-vpn-gateway --type ipsec.1 --amazon-side-asn 65001 ``` Ausgabe: ``` { "VpnGateway": { "AmazonSideAsn": 65001, "State": "available", "Type": "ipsec.1", "VpnGatewayId": "vgw-9a4cacf3", "VpcAttachments": [] } } ``` + Einzelheiten zur API finden Sie [CreateVpnGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-vpn-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `delete-carrier-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-carrier-gateway`. **AWS CLI** **So löschen Sie Ihr Carrier-Gateway** Im folgenden Beispiel für `delete-carrier-gateway` wird das angegebene Carrier-Gateway gelöscht. ``` aws ec2 delete-carrier-gateway \ --carrier-gateway-id cagw-0465cdEXAMPLE1111 ``` Ausgabe: ``` { "CarrierGateway": { "CarrierGatewayId": "cagw-0465cdEXAMPLE1111", "VpcId": "vpc-0c529aEXAMPLE1111", "State": "deleting", "OwnerId": "123456789012" } } ``` Weitere Informationen finden Sie unter [Carrier-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/Carrier_Gateway.html) im *Benutzerhandbuch für Amazon Virtual Private Cloud*. + Einzelheiten zur API finden Sie [DeleteCarrierGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-carrier-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `delete-client-vpn-endpoint` Das folgende Codebeispiel zeigt die Verwendung`delete-client-vpn-endpoint`. **AWS CLI** **So löschen Sie einen Client-VPN-Endpunkt** Im folgenden Beispiel für `delete-client-vpn-endpoint` wird der angegebene Client-VPN-Endpunkt gelöscht. ``` aws ec2 delete-client-vpn-endpoint \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde ``` Ausgabe: ``` { "Status": { "Code": "deleting" } } ``` Weitere Informationen finden Sie unter [Client-VPN-Endpunkte](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-endpoints.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [DeleteClientVpnEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-client-vpn-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `delete-client-vpn-route` Das folgende Codebeispiel zeigt die Verwendung`delete-client-vpn-route`. **AWS CLI** **So löschen Sie eine Route für einen Client-VPN-Endpunkt** Im folgenden Beispiel für `delete-client-vpn-route` wird die Route `0.0.0.0/0` für das angegebene Subnetz eines Client-VPN-Endpunkts gelöscht. ``` aws ec2 delete-client-vpn-route \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \ --destination-cidr-block 0.0.0.0/0 \ --target-vpc-subnet-id subnet-0123456789abcabca ``` Ausgabe: ``` { "Status": { "Code": "deleting" } } ``` Weitere Informationen finden Sie unter [Routen](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-routes.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [DeleteClientVpnRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-client-vpn-route.html)in der *AWS CLI Befehlsreferenz*. ### `delete-coip-cidr` Das folgende Codebeispiel zeigt die Verwendung`delete-coip-cidr`. **AWS CLI** **So löschen Sie einen Bereich kundeneigener IP-Adressen (CoIP)** Im folgenden Beispiel für `delete-coip-cidr` wird der angegebene CoIP-Adressbereich im genannten CoIP-Pool gelöscht. ``` aws ec2 delete-coip-cidr \ --cidr 14.0.0.0/24 \ --coip-pool-id ipv4pool-coip-1234567890abcdefg ``` Ausgabe: ``` { "CoipCidr": { "Cidr": "14.0.0.0/24", "CoipPoolId": "ipv4pool-coip-1234567890abcdefg", "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890" } } ``` Weitere Informationen finden Sie unter [Kundeneigene IP-Adressen](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#ip-addressing) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [DeleteCoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-coip-cidr.html)in der *AWS CLI Befehlsreferenz*. ### `delete-coip-pool` Das folgende Codebeispiel zeigt die Verwendung`delete-coip-pool`. **AWS CLI** **So löschen Sie einen Pool kundeneigener IP-Adressen (CoIP)** Im folgenden Beispiel für `delete-coip-pool` wird ein CoIP-Pool mit CoIP-Adressen gelöscht. ``` aws ec2 delete-coip-pool \ --coip-pool-id ipv4pool-coip-1234567890abcdefg ``` Ausgabe: ``` { "CoipPool": { "PoolId": "ipv4pool-coip-1234567890abcdefg", "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890", "PoolArn": "arn:aws:ec2:us-west-2:123456789012:coip-pool/ipv4pool-coip-1234567890abcdefg" } } ``` Weitere Informationen finden Sie unter [Kundeneigene IP-Adressen](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#ip-addressing) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [DeleteCoipPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-coip-pool.html)in der *AWS CLI Befehlsreferenz*. ### `delete-customer-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-customer-gateway`. **AWS CLI** **So löschen Sie ein Kunden-Gateway** In diesem Beispiel wird das angegebene Kunden-Gateway gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-customer-gateway --customer-gateway-id cgw-0e11f167 ``` + Einzelheiten zur API finden Sie [DeleteCustomerGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-customer-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `delete-dhcp-options` Das folgende Codebeispiel zeigt die Verwendung`delete-dhcp-options`. **AWS CLI** **So löschen Sie einen DHCP-Optionssatz** In diesem Beispiel wird der angegebene DHCP-Optionssatz gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-dhcp-options --dhcp-options-id dopt-d9070ebb ``` + Einzelheiten zur API finden Sie [DeleteDhcpOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-dhcp-options.html)in der *AWS CLI Befehlsreferenz*. ### `delete-egress-only-internet-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-egress-only-internet-gateway`. **AWS CLI** **So löschen Sie ein Internet-Gateway für ausgehenden Verkehr** In diesem Beispiel wird das angegebene Internet-Gateway für ausgehenden Datenverkehr gelöscht. Befehl: ``` aws ec2 delete-egress-only-internet-gateway --egress-only-internet-gateway-id eigw-01eadbd45ecd7943f ``` Ausgabe: ``` { "ReturnCode": true } ``` + Einzelheiten zur API finden Sie [DeleteEgressOnlyInternetGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-egress-only-internet-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `delete-fleets` Das folgende Codebeispiel zeigt die Verwendung`delete-fleets`. **AWS CLI** **Beispiel 1: So löschen Sie eine EC2-Flotte und beenden die zugehörigen Instances** Im folgenden Beispiel für `delete-fleets` wird die angegebene EC2-Flotte gelöscht und die zugehörigen On-Demand-Instances und Spot Instances werden beendet. ``` aws ec2 delete-fleets \ --fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \ --terminate-instances ``` Ausgabe: ``` { "SuccessfulFleetDeletions": [ { "CurrentFleetState": "deleted_terminating", "PreviousFleetState": "active", "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE" } ], "UnsuccessfulFleetDeletions": [] } ``` Weitere Informationen finden Sie unter [Löschen einer EC2-Flotte](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-ec2-fleet.html#delete-fleet) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. **Beispiel 2: So löschen Sie eine EC2-Flotte, ohne die zugehörigen Instances zu beenden** Im folgenden Beispiel für `delete-fleets` wird die angegebene EC2-Flotte gelöscht, ohne die zugehörigen On-Demand-Instances und Spot Instances zu beenden. ``` aws ec2 delete-fleets \ --fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \ --no-terminate-instances ``` Ausgabe: ``` { "SuccessfulFleetDeletions": [ { "CurrentFleetState": "deleted_running", "PreviousFleetState": "active", "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE" } ], "UnsuccessfulFleetDeletions": [] } ``` Weitere Informationen finden Sie unter [Löschen einer EC2-Flotte](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-ec2-fleet.html#delete-fleet) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. + Einzelheiten zur API finden Sie [DeleteFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-fleets.html)in der *AWS CLI Befehlsreferenz*. ### `delete-flow-logs` Das folgende Codebeispiel zeigt die Verwendung`delete-flow-logs`. **AWS CLI** **So löschen Sie ein Flow-Protokoll** Im folgenden Beispiel für `delete-flow-logs` wird das angegebene Flow-Protokoll gelöscht. ``` aws ec2 delete-flow-logs --flow-log-id fl-11223344556677889 ``` Ausgabe: ``` { "Unsuccessful": [] } ``` + Einzelheiten zur API finden Sie [DeleteFlowLogs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-flow-logs.html)in der *AWS CLI Befehlsreferenz*. ### `delete-fpga-image` Das folgende Codebeispiel zeigt die Verwendung`delete-fpga-image`. **AWS CLI** **So löschen Sie ein Amazon-FPGA-Image** In diesem Beispiel wird das angegebene AFI gelöscht. Befehl: ``` aws ec2 delete-fpga-image --fpga-image-id afi-06b12350a123fbabc ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [DeleteFpgaImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-fpga-image.html)in der *AWS CLI Befehlsreferenz*. ### `delete-instance-connect-endpoint` Das folgende Codebeispiel zeigt die Verwendung`delete-instance-connect-endpoint`. **AWS CLI** **So löschen Sie einen Endpunkt für EC2-Instance-Verbindungen** Im folgenden Beispiel für `delete-instance-connect-endpoint` wird der angegebene Endpunkt für EC2-Instance-Verbindungen gelöscht. ``` aws ec2 delete-instance-connect-endpoint \ --instance-connect-endpoint-id eice-03f5e49b83924bbc7 ``` Ausgabe: ``` { "InstanceConnectEndpoint": { "OwnerId": "111111111111", "InstanceConnectEndpointId": "eice-0123456789example", "InstanceConnectEndpointArn": "arn:aws:ec2:us-east-1:111111111111:instance-connect-endpoint/eice-0123456789example", "State": "delete-in-progress", "StateMessage": "", "NetworkInterfaceIds": [], "VpcId": "vpc-0123abcd", "AvailabilityZone": "us-east-1d", "CreatedAt": "2023-02-07T12:05:37+00:00", "SubnetId": "subnet-0123abcd" } } ``` Weitere Informationen finden Sie unter [Entfernen eines Endpunkts für EC2-Instance-Verbindungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/delete-ec2-instance-connect-endpoint.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DeleteInstanceConnectEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-instance-connect-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `delete-instance-event-window` Das folgende Codebeispiel zeigt die Verwendung`delete-instance-event-window`. **AWS CLI** **Beispiel 1: So löschen Sie ein Ereignisfenster** Im folgenden Beispiel für `delete-instance-event-window` wird ein Ereignisfenster gelöscht. ``` aws ec2 delete-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 ``` Ausgabe: ``` { "InstanceEventWindowState": { "InstanceEventWindowId": "iew-0abcdef1234567890", "State": "deleting" } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. **Beispiel 2: So erzwingen Sie das Löschen eines Ereignisfensters** Im folgenden Beispiel für `delete-instance-event-window` wird das Löschen eines Ereignisfensters erzwungen, wenn das Ereignisfenster derzeit mit Zielen verknüpft ist. ``` aws ec2 delete-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 \ --force-delete ``` Ausgabe: ``` { "InstanceEventWindowState": { "InstanceEventWindowId": "iew-0abcdef1234567890", "State": "deleting" } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. + Einzelheiten zur API finden Sie [DeleteInstanceEventWindow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-instance-event-window.html)in der *AWS CLI Befehlsreferenz*. ### `delete-internet-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-internet-gateway`. **AWS CLI** **So löschen Sie ein Internet-Gateway** Im folgenden Beispiel für `delete-internet-gateway` wird das angegebene Internet-Gateway gelöscht. ``` aws ec2 delete-internet-gateway \ --internet-gateway-id igw-0d0fb496b3EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Internet-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DeleteInternetGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-internet-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `delete-ipam-pool` Das folgende Codebeispiel zeigt die Verwendung`delete-ipam-pool`. **AWS CLI** **So löschen Sie einen IPAM-Pool** In diesem Beispiel möchten Sie als delegierter IPAM-Administrator einen IPAM-Pool löschen, den Sie nicht mehr benötigen. Für den Pool wurde jedoch ein CIDR bereitgestellt. Sie können einen Pool nicht löschen, wenn er für ihn CIDRs bereitgestellt wurde, es sei denn, Sie verwenden die `--cascade` Option. Sie verwenden `--cascade` also. Gehen Sie wie folgt vor, um diese Anforderung abzuschließen: Sie benötigen die IPAM-Pool-ID, die Sie erhalten können. Sie `--region` muss [describe-ipam-pools](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-ipam-pools.html)die IPAM-Heimatregion sein. Das folgende `delete-ipam-pool` Beispiel löscht einen IPAM-Pool in Ihrem Konto. AWS ``` aws ec2 delete-ipam-pool \ --ipam-pool-id ipam-pool-050c886a3ca41cd5b \ --cascade \ --region us-east-1 ``` Ausgabe: ``` { "IpamPool": { "OwnerId": "320805250157", "IpamPoolId": "ipam-pool-050c886a3ca41cd5b", "IpamPoolArn": "arn:aws:ec2::320805250157:ipam-pool/ipam-pool-050c886a3ca41cd5b", "IpamScopeArn": "arn:aws:ec2::320805250157:ipam-scope/ipam-scope-0a158dde35c51107b", "IpamScopeType": "private", "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107", "IpamRegion": "us-east-1", "Locale": "None", "PoolDepth": 1, "State": "delete-in-progress", "Description": "example", "AutoImport": false, "AddressFamily": "ipv4", "AllocationMinNetmaskLength": 0, "AllocationMaxNetmaskLength": 32 } } ``` Weitere Informationen finden Sie unter [Löschen eines Pools](https://docs.aws.amazon.com/vpc/latest/ipam/delete-pool-ipam.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [DeleteIpamPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-ipam-pool.html)in der *AWS CLI Befehlsreferenz*. ### `delete-ipam-resource-discovery` Das folgende Codebeispiel zeigt die Verwendung`delete-ipam-resource-discovery`. **AWS CLI** **So löschen Sie eine Ressourcenerkennung** In diesem Beispiel sind Sie ein delegierter IPAM-Administrator, der eine nicht standardmäßige Ressourcenerkennung löschen möchte. Diese haben Sie erstellt, um sie während der Integration von IPAM in Konten außerhalb Ihrer Organisation mit einem anderen IPAM-Administrator zu teilen. Gehen Sie wie folgt vor, um diese Anforderung abzuschließen: Die `--region` muss die Region sein, in der Sie die Ressourcenerkennung erstellt haben. Sie können eine standardmäßige Ressourcenerkennung nicht löschen, wenn `"IsDefault": true` gilt. Eine standardmäßige Ressourcenerkennung wird automatisch in dem Konto generiert, das einen IPAM erstellt. Wenn Sie eine standardmäßige Ressourcenerkennung löschen möchten, müssen Sie den IPAM entfernen. Im folgenden Beispiel für `delete-ipam-resource-discovery` wird eine Ressourcenerkennung gelöscht. ``` aws ec2 delete-ipam-resource-discovery \ --ipam-resource-discovery-id ipam-res-disco-0e39761475298ee0f \ --region us-east-1 ``` Ausgabe: ``` { "IpamResourceDiscovery": { "OwnerId": "149977607591", "IpamResourceDiscoveryId": "ipam-res-disco-0e39761475298ee0f", "IpamResourceDiscoveryArn": "arn:aws:ec2::149977607591:ipam-resource-discovery/ipam-res-disco-0e39761475298ee0f", "IpamResourceDiscoveryRegion": "us-east-1", "OperatingRegions": [ { "RegionName": "us-east-1" } ], "IsDefault": false, "State": "delete-in-progress" } } ``` Weitere Informationen zu Ressourcenerkennungen finden Sie unter [Arbeiten mit Ressourcenerkennungen](https://docs.aws.amazon.com/vpc/latest/ipam/res-disc-work-with.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [DeleteIpamResourceDiscovery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-ipam-resource-discovery.html)in der *AWS CLI Befehlsreferenz*. ### `delete-ipam-scope` Das folgende Codebeispiel zeigt die Verwendung`delete-ipam-scope`. **AWS CLI** **So löschen Sie einen IPAM-Bereich** Im folgenden Beispiel für `delete-ipam-scope` wird ein IPAM gelöscht. ``` aws ec2 delete-ipam-scope \ --ipam-scope-id ipam-scope-01c1ebab2b63bd7e4 ``` Ausgabe: ``` { "IpamScope": { "OwnerId": "123456789012", "IpamScopeId": "ipam-scope-01c1ebab2b63bd7e4", "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-01c1ebab2b63bd7e4", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "IpamScopeType": "private", "IsDefault": false, "Description": "Example description", "PoolCount": 0, "State": "delete-in-progress" } } ``` Weitere Informationen finden Sie unter [Löschen eines Bereichs](https://docs.aws.amazon.com/vpc/latest/ipam/delete-scope-ipam.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [DeleteIpamScope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-ipam-scope.html)in der *AWS CLI Befehlsreferenz*. ### `delete-ipam` Das folgende Codebeispiel zeigt die Verwendung`delete-ipam`. **AWS CLI** **So löschen Sie einen IPAM** Im folgenden Beispiel für `delete-ipam` wird ein IPAM gelöscht. ``` aws ec2 delete-ipam \ --ipam-id ipam-036486dfa6af58ee0 ``` Ausgabe: ``` { "Ipam": { "OwnerId": "123456789012", "IpamId": "ipam-036486dfa6af58ee0", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-036486dfa6af58ee0", "IpamRegion": "us-east-1", "PublicDefaultScopeId": "ipam-scope-071b8042b0195c183", "PrivateDefaultScopeId": "ipam-scope-0807405dece705a30", "ScopeCount": 2, "OperatingRegions": [ { "RegionName": "us-east-1" }, { "RegionName": "us-east-2" }, { "RegionName": "us-west-1" } ], "State": "delete-in-progress" } } ``` Weitere Informationen finden Sie unter [Löschen eines IPAM](https://docs.aws.amazon.com/vpc/latest/ipam/delete-ipam.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [DeleteIpam](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-ipam.html)in der *AWS CLI Befehlsreferenz*. ### `delete-key-pair` Das folgende Codebeispiel zeigt die Verwendung`delete-key-pair`. **AWS CLI** **So löschen Sie ein Schlüsselpaar** Im folgenden Beispiel für `delete-key-pair` wird das angegebene Schlüsselpaar gelöscht. ``` aws ec2 delete-key-pair \ --key-name my-key-pair ``` Ausgabe: ``` { "Return": true, "KeyPairId": "key-03c8d3aceb53b507" } ``` Weitere Informationen finden Sie unter [Erstellen und Löschen von Schlüsselpaaren](https://docs.aws.amazon.com/cli/latest/userguide/cli-ec2-keypairs.html) im *Benutzerhandbuch für die AWS -Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [DeleteKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-key-pair.html)in der *AWS CLI Befehlsreferenz*. ### `delete-launch-template-versions` Das folgende Codebeispiel zeigt die Verwendung`delete-launch-template-versions`. **AWS CLI** **So löschen Sie eine Startvorlagenversion** In diesem Beispiel wird die angegebene Startvorlagenversion gelöscht. Befehl: ``` aws ec2 delete-launch-template-versions --launch-template-id lt-0abcd290751193123 --versions 1 ``` Ausgabe: ``` { "UnsuccessfullyDeletedLaunchTemplateVersions": [], "SuccessfullyDeletedLaunchTemplateVersions": [ { "LaunchTemplateName": "TestVersion", "VersionNumber": 1, "LaunchTemplateId": "lt-0abcd290751193123" } ] } ``` + Einzelheiten zur API finden Sie [DeleteLaunchTemplateVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-launch-template-versions.html)in der *AWS CLI Befehlsreferenz*. ### `delete-launch-template` Das folgende Codebeispiel zeigt die Verwendung`delete-launch-template`. **AWS CLI** **So löschen Sie eine Startvorlage** In diesem Beispiel wird die angegebene Startvorlage gelöscht. Befehl: ``` aws ec2 delete-launch-template --launch-template-id lt-0abcd290751193123 ``` Ausgabe: ``` { "LaunchTemplate": { "LatestVersionNumber": 2, "LaunchTemplateId": "lt-0abcd290751193123", "LaunchTemplateName": "TestTemplate", "DefaultVersionNumber": 2, "CreatedBy": "arn:aws:iam::123456789012:root", "CreateTime": "2017-11-23T16:46:25.000Z" } } ``` + Einzelheiten zur API finden Sie [DeleteLaunchTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-launch-template.html)in der *AWS CLI Befehlsreferenz*. ### `delete-local-gateway-route-table-virtual-interface-group-association` Das folgende Codebeispiel zeigt die Verwendung`delete-local-gateway-route-table-virtual-interface-group-association`. **AWS CLI** **Um die Zuordnung einer lokalen Gateway-Routentabelle zu einer Gruppe virtueller Schnittstellen (VIFs) zu trennen** Im folgenden Beispiel für `delete-local-gateway-route-table-virtual-interface-group-association` wird die Zuordnung zwischen der angegebenen lokalen Gateway-Routing-Tabelle und der VIF-Gruppe aufgehoben. ``` aws ec2 delete-local-gateway-route-table-virtual-interface-group-association \ --local-gateway-route-table-virtual-interface-group-association-id lgw-vif-grp-assoc-exampleid12345678 ``` Ausgabe: ``` { "LocalGatewayRouteTableVirtualInterfaceGroupAssociation": { "LocalGatewayRouteTableVirtualInterfaceGroupAssociationId": "lgw-vif-grp-assoc-exampleid12345678", "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-exampleid0123abcd", "LocalGatewayId": "lgw-exampleid11223344", "LocalGatewayRouteTableId": "lgw-rtb-exampleidabcd1234", "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:111122223333:local-gateway-route-table/lgw-rtb-exampleidabcd1234", "OwnerId": "111122223333", "State": "disassociating", "Tags": [] } } ``` Weitere Informationen finden Sie unter [Zuordnungen von VIF-Gruppen](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#vif-group-associations) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [DeleteLocalGatewayRouteTableVirtualInterfaceGroupAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-local-gateway-route-table-virtual-interface-group-association.html)in der *AWS CLI Befehlsreferenz.* ### `delete-local-gateway-route-table-vpc-association` Das folgende Codebeispiel zeigt die Verwendung`delete-local-gateway-route-table-vpc-association`. **AWS CLI** **So heben Sie die Zuordnung einer lokalen Gateway-Routing-Tabelle zu einer VPC auf** Im folgenden Beispiel für `delete-local-gateway-route-table-vpc-association` wird die Zuordnung zwischen der angegebenen lokalen Gateway-Routing-Tabelle und der VPC aufgehoben. ``` aws ec2 delete-local-gateway-route-table-vpc-association \ --local-gateway-route-table-vpc-association-id vpc-example0123456789 ``` Ausgabe: ``` { "LocalGatewayRouteTableVpcAssociation": { "LocalGatewayRouteTableVpcAssociationId": "lgw-vpc-assoc-abcd1234wxyz56789", "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890", "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:555555555555:local-gateway-route-table/lgw-rtb-abcdefg1234567890", "LocalGatewayId": "lgw-exampleid01234567", "VpcId": "vpc-example0123456789", "OwnerId": "555555555555", "State": "disassociating" } } ``` Weitere Informationen finden Sie unter [VPC-Zuordnungen](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#vpc-associations) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [DeleteLocalGatewayRouteTableVpcAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-local-gateway-route-table-vpc-association.html)in der *AWS CLI Befehlsreferenz*. ### `delete-local-gateway-route-table` Das folgende Codebeispiel zeigt die Verwendung`delete-local-gateway-route-table`. **AWS CLI** **So löschen Sie eine lokale Gateway-Routing-Tabelle** Im folgenden Beispiel für `delete-local-gateway-route-table` wird eine lokale Routing-Tabelle mit dem direkten VPC-Routing-Modus erstellt. ``` aws ec2 delete-local-gateway-route-table \ --local-gateway-route-table-id lgw-rtb-abcdefg1234567890 ``` Ausgabe: ``` { "LocalGatewayRouteTable": { "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890", "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:111122223333:local-gateway-route-table/lgw-rtb-abcdefg1234567890", "LocalGatewayId": "lgw-1a2b3c4d5e6f7g8h9", "OutpostArn": "arn:aws:outposts:us-west-2:111122223333:outpost/op-021345abcdef67890", "OwnerId": "111122223333", "State": "deleting", "Tags": [], "Mode": "direct-vpc-routing" } } ``` Weitere Informationen finden Sie unter [Roouting-Tabellen für lokale Gateways](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html) im *AWS Benutzerhandbuch für Outposts*. + Einzelheiten zur API finden Sie [DeleteLocalGatewayRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-local-gateway-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `delete-local-gateway-route` Das folgende Codebeispiel zeigt die Verwendung`delete-local-gateway-route`. **AWS CLI** **So löschen Sie eine Route aus der Routing-Tabelle eines lokalen Gateways** Im folgenden Beispiel für `delete-local-gateway-route` wird die angegebene Route in der genannten lokalen Gateway-Routing-Tabelle gelöscht. ``` aws ec2 delete-local-gateway-route \ --destination-cidr-block 0.0.0.0/0 \ --local-gateway-route-table-id lgw-rtb-059615ef7dEXAMPLE ``` Ausgabe: ``` { "Route": { "DestinationCidrBlock": "0.0.0.0/0", "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE", "Type": "static", "State": "deleted", "LocalGatewayRouteTableId": "lgw-rtb-059615ef7EXAMPLE" } } ``` + Einzelheiten zur API finden Sie [DeleteLocalGatewayRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-local-gateway-route.html)in der *AWS CLI Befehlsreferenz*. ### `delete-managed-prefix-list` Das folgende Codebeispiel zeigt die Verwendung`delete-managed-prefix-list`. **AWS CLI** **So löschen Sie eine Präfixliste** Im folgenden Beispiel für `delete-managed-prefix-list` wird die angegebene Präfixliste gelöscht. ``` aws ec2 delete-managed-prefix-list \ --prefix-list-id pl-0123456abcabcabc1 ``` Ausgabe: ``` { "PrefixList": { "PrefixListId": "pl-0123456abcabcabc1", "AddressFamily": "IPv4", "State": "delete-in-progress", "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1", "PrefixListName": "test", "MaxEntries": 10, "Version": 1, "OwnerId": "123456789012" } } ``` Weitere Informationen finden Sie unter [Verwaltete Präfixlisten](https://docs.aws.amazon.com/vpc/latest/userguide/managed-prefix-lists.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DeleteManagedPrefixList](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-managed-prefix-list.html)in der *AWS CLI Befehlsreferenz*. ### `delete-nat-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-nat-gateway`. **AWS CLI** **Um ein NAT-Gateway zu löschen** In diesem Beispiel wird das NAT-Gateway `nat-04ae55e711cec5680` gelöscht. Befehl: ``` aws ec2 delete-nat-gateway --nat-gateway-id nat-04ae55e711cec5680 ``` Ausgabe: ``` { "NatGatewayId": "nat-04ae55e711cec5680" } ``` + Einzelheiten zur API finden Sie [DeleteNatGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-nat-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `delete-network-acl-entry` Das folgende Codebeispiel zeigt die Verwendung`delete-network-acl-entry`. **AWS CLI** **So löschen Sie einen Netzwerk-ACL-Eintrag** In diesem Beispiel wird die Eingangsregel Nummer 100 aus der angegebenen Netzwerk-ACL gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-network-acl-entry --network-acl-id acl-5fb85d36 --ingress --rule-number 100 ``` + Einzelheiten zur API finden Sie [DeleteNetworkAclEntry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-network-acl-entry.html)in der *AWS CLI Befehlsreferenz*. ### `delete-network-acl` Das folgende Codebeispiel zeigt die Verwendung`delete-network-acl`. **AWS CLI** **Um eine Netzwerk-ACL zu löschen** In diesem Beispiel wird die angegebene Netzwerk-ACL gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-network-acl --network-acl-id acl-5fb85d36 ``` + Einzelheiten zur API finden Sie [DeleteNetworkAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-network-acl.html)in der *AWS CLI Befehlsreferenz*. ### `delete-network-insights-access-scope-analysis` Das folgende Codebeispiel zeigt die Verwendung`delete-network-insights-access-scope-analysis`. **AWS CLI** **So löschen Sie eine Netzwerkzugriffsbereichsanalyse** Im folgenden Beispiel für `delete-network-insights-access-scope-analysis` wird die angegebene Netzwerkzugriffsbereichsanalyse gelöscht. ``` aws ec2 delete-network-insights-access-scope-analysis \ --network-insights-access-scope-analysis-id nisa-01234567891abcdef ``` Ausgabe: ``` { "NetworkInsightsAccessScopeAnalysisId": "nisa-01234567891abcdef } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Network Access Analyzer using the AWS CLI](https://docs.aws.amazon.com/vpc/latest/network-access-analyzer/getting-started-cli.html) im *Network Access Analyzer-Handbuch*. + Einzelheiten zur API finden Sie [DeleteNetworkInsightsAccessScopeAnalysis](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-network-insights-access-scope-analysis.html)unter *AWS CLI Befehlsreferenz*. ### `delete-network-insights-access-scope` Das folgende Codebeispiel zeigt die Verwendung`delete-network-insights-access-scope`. **AWS CLI** **So löschen Sie einen Netzwerkzugriffsbereich** Im folgenden Beispiel für `delete-network-insights-access-scope` wird der angegebene Netzwerkzugriffsbereich gelöscht. ``` aws ec2 delete-network-insights-access-scope \ --network-insights-access-scope-id nis-123456789abc01234 ``` Ausgabe: ``` { "NetworkInsightsAccessScopeId": "nis-123456789abc01234" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Network Access Analyzer using the AWS CLI](https://docs.aws.amazon.com/vpc/latest/network-access-analyzer/getting-started-cli.html) im *Network Access Analyzer-Handbuch*. + Einzelheiten zur API finden Sie [DeleteNetworkInsightsAccessScope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-network-insights-access-scope.html)unter *AWS CLI Befehlsreferenz*. ### `delete-network-insights-analysis` Das folgende Codebeispiel zeigt die Verwendung`delete-network-insights-analysis`. **AWS CLI** **So löschen Sie eine Pfadanalyse** Im folgenden Beispiel für `delete-network-insights-analysis` wird die angegebene Analyse gelöscht. ``` aws ec2 delete-network-insights-analysis \ --network-insights-analysis-id nia-02207aa13eb480c7a ``` Ausgabe: ``` { "NetworkInsightsAnalysisId": "nia-02207aa13eb480c7a" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit der AWS CLI](https://docs.aws.amazon.com/vpc/latest/reachability/getting-started-cli.html) im *Reachability Analyzer-Handbuch*. + Einzelheiten zur API finden Sie unter [DeleteNetworkInsightsAnalysis AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-network-insights-analysis.html)*Befehlsreferenz*. ### `delete-network-insights-path` Das folgende Codebeispiel zeigt die Verwendung`delete-network-insights-path`. **AWS CLI** **So löschen Sie einen Pfad** Im folgenden Beispiel für `delete-network-insights-path` wird der angegebene Pfad gelöscht. Bevor Sie einen Pfad löschen können, müssen Sie alle zugehörigen Analysen mithilfe des Befehls `delete-network-insights-analysis` entfernen. ``` aws ec2 delete-network-insights-path \ --network-insights-path-id nip-0b26f224f1d131fa8 ``` Ausgabe: ``` { "NetworkInsightsPathId": "nip-0b26f224f1d131fa8" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit der AWS CLI](https://docs.aws.amazon.com/vpc/latest/reachability/getting-started-cli.html) im *Reachability Analyzer-Handbuch*. + Einzelheiten zur API finden Sie unter [DeleteNetworkInsightsPath AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-network-insights-path.html)*Befehlsreferenz*. ### `delete-network-interface-permission` Das folgende Codebeispiel zeigt die Verwendung`delete-network-interface-permission`. **AWS CLI** **So löschen Sie eine Netzwerkschnittstellenberechtigung** In diesem Beispiel wird die angegebene Netzwerkschnittstellenberechtigung gelöscht. Befehl: ``` aws ec2 delete-network-interface-permission --network-interface-permission-id eni-perm-06fd19020ede149ea ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [DeleteNetworkInterfacePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-network-interface-permission.html)in der *AWS CLI Befehlsreferenz*. ### `delete-network-interface` Das folgende Codebeispiel zeigt die Verwendung`delete-network-interface`. **AWS CLI** **So löschen Sie eine Netzwerkschnittstelle** In diesem Beispiel wird die angegebene Netzwerkschnittstelle gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-network-interface --network-interface-id eni-e5aa89a3 ``` + Einzelheiten zur API finden Sie [DeleteNetworkInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-network-interface.html)in der *AWS CLI Befehlsreferenz*. ### `delete-placement-group` Das folgende Codebeispiel zeigt die Verwendung`delete-placement-group`. **AWS CLI** **So löschen Sie eine Platzierungsgruppe** Dieser Beispielbefehl löscht die angegebene Platzierungsgruppe. Befehl: ``` aws ec2 delete-placement-group --group-name my-cluster ``` + Einzelheiten zur API finden Sie [DeletePlacementGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-placement-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-queued-reserved-instances` Das folgende Codebeispiel zeigt die Verwendung`delete-queued-reserved-instances`. **AWS CLI** **So löschen Sie einen in die Warteschlange eingestellten Kauf** Im folgenden Beispiel für `delete-queued-reserved-instances` wird die angegebene Reserved Instance gelöscht, die sich in der Warteschlange zum Kauf befand. ``` aws ec2 delete-queued-reserved-instances \ --reserved-instances-ids af9f760e-6f91-4559-85f7-4980eexample ``` Ausgabe: ``` { "SuccessfulQueuedPurchaseDeletions": [ { "ReservedInstancesId": "af9f760e-6f91-4559-85f7-4980eexample" } ], "FailedQueuedPurchaseDeletions": [] } ``` + Einzelheiten zur API finden Sie [DeleteQueuedReservedInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-queued-reserved-instances.html)in der *AWS CLI Befehlsreferenz*. ### `delete-route-table` Das folgende Codebeispiel zeigt die Verwendung`delete-route-table`. **AWS CLI** **So löschen Sie eine Routing-Tabelle** In diesem Beispiel wird die angegebene Routing-Tabelle gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-route-table --route-table-id rtb-22574640 ``` + Einzelheiten zur API finden Sie [DeleteRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `delete-route` Das folgende Codebeispiel zeigt die Verwendung`delete-route`. **AWS CLI** **So löschen Sie eine Route** In diesem Beispiel wird die angegebene Route aus der festgelegten Routing-Tabelle gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-route --route-table-id rtb-22574640 --destination-cidr-block 0.0.0.0/0 ``` + Einzelheiten zur API finden Sie [DeleteRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-route.html)in der *AWS CLI Befehlsreferenz*. ### `delete-security-group` Das folgende Codebeispiel zeigt die Verwendung`delete-security-group`. **AWS CLI** **[EC2-Classic] So löschen Sie eine Sicherheitsgruppe** In diesem Beispiel wird die Sicherheitsgruppe mit dem Namen `MySecurityGroup` gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-security-group --group-name MySecurityGroup ``` **[EC2-VPC] So löschen Sie eine Sicherheitsgruppe** In diesem Beispiel wird die Sicherheitsgruppe mit der ID `sg-903004f8` gelöscht. Sie können eine Sicherheitsgruppe für EC2-VPC nicht mit Namen referenzieren. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-security-group --group-id sg-903004f8 ``` Weitere Informationen finden Sie unter Verwenden von Sicherheitsgruppen im Benutzerhandbuch zu* die AWS -Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [DeleteSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-security-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-snapshot`. **AWS CLI** **So löschen Sie einen Snapshot** Dieser Beispielbefehl löscht einen Snapshot mit der Snapshot-ID von `snap-1234567890abcdef0`. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-snapshot --snapshot-id snap-1234567890abcdef0 ``` + Einzelheiten zur API finden Sie [DeleteSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `delete-spot-datafeed-subscription` Das folgende Codebeispiel zeigt die Verwendung`delete-spot-datafeed-subscription`. **AWS CLI** **So kündigen Sie ein Daten-Feed-Abonnement für eine Spot Instance** Dieser Beispielbefehl löscht ein Daten-Feed-Abonnement einer Spot Instance für das Konto. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-spot-datafeed-subscription ``` + Einzelheiten zur API finden Sie [DeleteSpotDatafeedSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-spot-datafeed-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `delete-subnet-cidr-reservation` Das folgende Codebeispiel zeigt die Verwendung`delete-subnet-cidr-reservation`. **AWS CLI** **So löschen Sie Subnetz-CIDR-Reservierungen** Im folgenden Beispiel für `delete-subnet-cidr-reservation` wird die angegebene Subnetz-CIDR-Reservierung gelöscht. ``` aws ec2 delete-subnet-cidr-reservation \ --subnet-cidr-reservation-id scr-044f977c4eEXAMPLE ``` Ausgabe: ``` { "DeletedSubnetCidrReservation": { "SubnetCidrReservationId": "scr-044f977c4eEXAMPLE", "SubnetId": "subnet-03c51e2e6cEXAMPLE", "Cidr": "10.1.0.16/28", "ReservationType": "prefix", "OwnerId": "123456789012" } } ``` Weitere Informationen erhalten Sie unter [Subnetz-CIDR-Reservierungen](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-cidr-reservation.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DeleteSubnetCidrReservation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-subnet-cidr-reservation.html)in der *AWS CLI Befehlsreferenz*. ### `delete-subnet` Das folgende Codebeispiel zeigt die Verwendung`delete-subnet`. **AWS CLI** **So löschen Sie ein Subnetz** In diesem Beispiel wird das angegebene Subnetz gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-subnet --subnet-id subnet-9d4a7b6c ``` + Einzelheiten zur API finden Sie [DeleteSubnet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-subnet.html)in der *AWS CLI Befehlsreferenz*. ### `delete-tags` Das folgende Codebeispiel zeigt die Verwendung`delete-tags`. **AWS CLI** **Beispiel 1: So löschen Sie ein Tag aus einer Ressource** Im folgenden Beispiel für `delete-tags` wird das Tag `Stack=Test` aus dem angegebenen Image gelöscht. Wenn Sie sowohl einen Wert als auch einen Schlüsselnamen angeben, wird das Tag nur gelöscht, wenn der Wert des Tags dem angegebenen Wert entspricht. ``` aws ec2 delete-tags \ --resources ami-1234567890abcdef0 \ --tags Key=Stack,Value=Test ``` Die Angabe des Werts für ein Tag ist optional. Im folgenden Beispiel für `delete-tags` wird das Tag mit dem Schlüsselnamen `purpose` aus der angegebenen Instance gelöscht, unabhängig vom Tag-Wert des Tags. ``` aws ec2 delete-tags \ --resources i-1234567890abcdef0 \ --tags Key=purpose ``` Wenn Sie die leere Zeichenfolge als Tag-Wert angeben, wird das Tag nur gelöscht, wenn der Tag-Wert eine leere Zeichenfolge ist. Im folgenden Beispiel für `delete-tags` wird die leere Zeichenfolge als Tag-Wert für das zu löschende Tag angegeben. ``` aws ec2 delete-tags \ --resources i-1234567890abcdef0 \ --tags Key=Name,Value= ``` **Beispiel 2: So löschen Sie ein Tag aus mehreren Ressourcen** Im folgenden Beispiel für `delete-tags` wird das Tag ``Purpose=Test`` sowohl aus einer Instance als auch aus einem AMI gelöscht. Wie im vorherigen Beispiel gezeigt, können Sie den Tag-Wert im Befehl weglassen. ``` aws ec2 delete-tags \ --resources i-1234567890abcdef0 ami-1234567890abcdef0 \ --tags Key=Purpose ``` + Einzelheiten zur API finden Sie [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-tags.html)in der *AWS CLI Befehlsreferenz*. ### `delete-traffic-mirror-filter-rule` Das folgende Codebeispiel zeigt die Verwendung`delete-traffic-mirror-filter-rule`. **AWS CLI** **So löschen Sie eine Datenverkehr-Spiegelungsfilterregel** Im folgenden Beispiel für `delete-traffic-mirror-filter-rule` wird die angegebene Datenverkehr-Spiegelungsfilterregel gelöscht. ``` aws ec2 delete-traffic-mirror-filter-rule \ --traffic-mirror-filter-rule-id tmfr-081f71283bEXAMPLE ``` Ausgabe: ``` { "TrafficMirrorFilterRuleId": "tmfr-081f71283bEXAMPLE" } ``` Weitere Informationen finden Sie unter [Ändern Ihrer Datenverkehr-Spiegelungsfilterregeln](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-filter.html#modify-traffic-mirroring-filter-rules) im *Handbuch für AWS Traffic Mirroring*. + Einzelheiten zur API finden Sie [DeleteTrafficMirrorFilterRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-traffic-mirror-filter-rule.html)in der *AWS CLI Befehlsreferenz*. ### `delete-traffic-mirror-filter` Das folgende Codebeispiel zeigt die Verwendung`delete-traffic-mirror-filter`. **AWS CLI** **So löschen Sie einen Datenverkehr-Spiegelungsfilter** Im folgenden Beispiel für `delete-traffic-mirror-filter` wird der angegebene Datenverkehr-Spiegelungsfilter gelöscht. ``` aws ec2 delete-traffic-mirror-filter \ --traffic-mirror-filter-id tmf-0be0b25fcdEXAMPLE ``` Ausgabe: ``` { "TrafficMirrorFilterId": "tmf-0be0b25fcdEXAMPLE" } ``` Weitere Informationen finden Sie unter [Löschen eines Datenverkehr-Spiegelungsfilters](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-filter.html#delete-traffic-mirroring-filter) im *Handbuch für AWS Traffic Mirroring*. + Einzelheiten zur API finden Sie [DeleteTrafficMirrorFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-traffic-mirror-filter.html)in der *AWS CLI Befehlsreferenz*. ### `delete-traffic-mirror-session` Das folgende Codebeispiel zeigt die Verwendung`delete-traffic-mirror-session`. **AWS CLI** **So löschen Sie eine Datenverkehr-Spiegelungssitzung** Im folgenden Beispiel für `delete-traffic-mirror-session` wird die angegebene Datenverkehr-Spiegelungssitzung gelöscht. ``` aws ec2 delete-traffic-mirror-session \ --traffic-mirror-session-id tms-0af3141ce5EXAMPLE ``` Ausgabe: ``` { "TrafficMirrorSessionId": "tms-0af3141ce5EXAMPLE" } ``` Weitere Informationen finden Sie unter [Löschen einer Datenverkehr-Spiegelungssitzung](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-session.html#delete-traffic-mirroring-session) im *Handbuch für AWS Traffic Mirroring*. + Einzelheiten zur API finden Sie [DeleteTrafficMirrorSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-traffic-mirror-session.html)in der *AWS CLI Befehlsreferenz*. ### `delete-traffic-mirror-target` Das folgende Codebeispiel zeigt die Verwendung`delete-traffic-mirror-target`. **AWS CLI** **So löschen Sie ein Datenverkehr-Spiegelungsziel** Im folgenden Beispiel für `delete-traffic-mirror-target` wird das angegebene Datenverkehr-Spiegelungsziel gelöscht. ``` aws ec2 delete-traffic-mirror-target \ --traffic-mirror-target-id tmt-060f48ce9EXAMPLE ``` Ausgabe: ``` { "TrafficMirrorTargetId": "tmt-060f48ce9EXAMPLE" } ``` Weitere Informationen finden Sie unter [Löschen eines Datenverkehr-Spiegelungsziels](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-target.html#delete-traffic-mirroring-target) im *Handbuch für AWS Traffic Mirroring*. + Einzelheiten zur API finden Sie [DeleteTrafficMirrorTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-traffic-mirror-target.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway-connect-peer` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway-connect-peer`. **AWS CLI** **So löschen Sie einen Verbindungs-Peer in Transit Gateway** Im folgenden Beispiel für `delete-transit-gateway-connect-peer` wird der angegebene Verbindungs-Peer gelöscht. ``` aws ec2 delete-transit-gateway-connect-peer \ --transit-gateway-connect-peer-id tgw-connect-peer-0666adbac4EXAMPLE ``` Ausgabe: ``` { "TransitGatewayConnectPeer": { "TransitGatewayAttachmentId": "tgw-attach-0f0927767cEXAMPLE", "TransitGatewayConnectPeerId": "tgw-connect-peer-0666adbac4EXAMPLE", "State": "deleting", "CreationTime": "2021-10-13T03:35:17.000Z", "ConnectPeerConfiguration": { "TransitGatewayAddress": "10.0.0.234", "PeerAddress": "172.31.1.11", "InsideCidrBlocks": [ "169.254.6.0/29" ], "Protocol": "gre", "BgpConfigurations": [ { "TransitGatewayAsn": 64512, "PeerAsn": 64512, "TransitGatewayAddress": "169.254.6.2", "PeerAddress": "169.254.6.1", "BgpStatus": "down" }, { "TransitGatewayAsn": 64512, "PeerAsn": 64512, "TransitGatewayAddress": "169.254.6.3", "PeerAddress": "169.254.6.1", "BgpStatus": "down" } ] } } } ``` Weitere Informationen finden Sie unter [Connect-Anhänge und Connect-Peers in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-connect.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DeleteTransitGatewayConnectPeer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway-connect-peer.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway-connect` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway-connect`. **AWS CLI** **So löschen Sie einen Verbindungsanhang in Transit Gateway** Im folgenden Beispiel für `delete-transit-gateway-connect` wird der angegebene Verbindungsanhang gelöscht. ``` aws ec2 delete-transit-gateway-connect \ --transit-gateway-attachment-id tgw-attach-037012e5dcEXAMPLE ``` Ausgabe: ``` { "TransitGatewayConnect": { "TransitGatewayAttachmentId": "tgw-attach-037012e5dcEXAMPLE", "TransportTransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "State": "deleting", "CreationTime": "2021-03-09T19:59:17+00:00", "Options": { "Protocol": "gre" } } } ``` Weitere Informationen finden Sie unter [Connect-Anhänge und Connect-Peers in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-connect.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DeleteTransitGatewayConnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway-connect.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway-multicast-domain` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway-multicast-domain`. **AWS CLI** **So löschen Sie eine Multicast-Domain in Transit Gateway** Im folgenden Beispiel für `delete-transit-gateway-multicast-domain` wird die angegebene Multicast-Domain gelöscht. ``` aws ec2 delete-transit-gateway-multicast-domain \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE ``` Ausgabe: ``` { "TransitGatewayMulticastDomain": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-02bb79002bEXAMPLE", "TransitGatewayId": "tgw-0d88d2d0d5EXAMPLE", "State": "deleting", "CreationTime": "2019-11-20T22:02:03.000Z" } } ``` Weitere Informationen finden Sie unter [Verwalten von Multicast-Domains](https://docs.aws.amazon.com/vpc/latest/tgw/manage-domain.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DeleteTransitGatewayMulticastDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway-multicast-domain.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway-peering-attachment` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway-peering-attachment`. **AWS CLI** **So löschen Sie einen Anhang eines Transit-Gateway-Peerings** Im folgenden Beispiel für `delete-transit-gateway-peering-attachment` wird der angegebene Anhang eines Transit-Gateway-Peerings gelöscht. ``` aws ec2 delete-transit-gateway-peering-attachment \ --transit-gateway-attachment-id tgw-attach-4455667788aabbccd ``` Ausgabe: ``` { "TransitGatewayPeeringAttachment": { "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd", "RequesterTgwInfo": { "TransitGatewayId": "tgw-123abc05e04123abc", "OwnerId": "123456789012", "Region": "us-west-2" }, "AccepterTgwInfo": { "TransitGatewayId": "tgw-11223344aabbcc112", "OwnerId": "123456789012", "Region": "us-east-2" }, "State": "deleting", "CreationTime": "2019-12-09T11:38:31.000Z" } } ``` Weitere Informationen finden Sie unter [Anhänge von Transit-Gateway-Peering](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-peering.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DeleteTransitGatewayPeeringAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway-peering-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway-policy-table` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway-policy-table`. **AWS CLI** **So löschen Sie eine Transit-Gateway-Richtlinientabelle** Im folgenden Beispiel für `delete-transit-gateway-policy-table` wird die angegebene Transit-Gateway-Richtlinientabelle gelöscht. ``` aws ec2 delete-transit-gateway-policy-table \ --transit-gateway-policy-table-id tgw-ptb-0a16f134b78668a81 ``` Ausgabe: ``` { "TransitGatewayPolicyTables": [ { "TransitGatewayPolicyTableId": "tgw-ptb-0a16f134b78668a81", "TransitGatewayId": "tgw-067f8505c18f0bd6e", "State": "deleting", "CreationTime": "2023-11-28T16:36:43+00:00", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Transit-Gateway-Richtlinientabellen](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-policy-tables.html) im *Benutzerhandbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [DeleteTransitGatewayPolicyTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway-policy-table.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway-prefix-list-reference` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway-prefix-list-reference`. **AWS CLI** **So löschen Sie eine Präfixlistenreferenz** Im folgenden Beispiel für `delete-transit-gateway-prefix-list-reference` wird die angegebene Präfixlistenreferenz gelöscht. ``` aws ec2 delete-transit-gateway-prefix-list-reference \ --transit-gateway-route-table-id tgw-rtb-0123456789abcd123 \ --prefix-list-id pl-11111122222222333 ``` Ausgabe: ``` { "TransitGatewayPrefixListReference": { "TransitGatewayRouteTableId": "tgw-rtb-0123456789abcd123", "PrefixListId": "pl-11111122222222333", "PrefixListOwnerId": "123456789012", "State": "deleting", "Blackhole": false, "TransitGatewayAttachment": { "TransitGatewayAttachmentId": "tgw-attach-aabbccddaabbccaab", "ResourceType": "vpc", "ResourceId": "vpc-112233445566aabbc" } } } ``` Weitere Informationen finden Sie unter [Präfixlistenreferenzen](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-prefix-lists.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DeleteTransitGatewayPrefixListReference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway-prefix-list-reference.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway-route-table` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway-route-table`. **AWS CLI** **So löschen Sie eine Routing-Tabelle in Transit Gateway** Im folgenden Beispiel für `delete-transit-gateway-route-table` wird die angegebene Routing-Tabelle in Transit Gateway gelöscht. ``` aws ec2 delete-transit-gateway-route-table \ --transit-gateway-route-table-id tgw-rtb-0b6f6aaa01EXAMPLE ``` Ausgabe: ``` { "TransitGatewayRouteTable": { "TransitGatewayRouteTableId": "tgw-rtb-0b6f6aaa01EXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "State": "deleting", "DefaultAssociationRouteTable": false, "DefaultPropagationRouteTable": false, "CreationTime": "2019-07-17T20:27:26.000Z" } } ``` Weitere Informationen finden Sie unter [Löschen einer Routing-Tabelle in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html#delete-tgw-route-table) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DeleteTransitGatewayRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway-route` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway-route`. **AWS CLI** **So löschen Sie einen CIDR-Block aus einer Routing-Tabelle** Im folgenden Beispiel für `delete-transit-gateway-route` wird der CIDR-Block aus der angegebenen Routing-Tabelle in Transit Gateway gelöscht. ``` aws ec2 delete-transit-gateway-route \ --transit-gateway-route-table-id tgw-rtb-0b6f6aaa01EXAMPLE \ --destination-cidr-block 10.0.2.0/24 ``` Ausgabe: ``` { "Route": { "DestinationCidrBlock": "10.0.2.0/24", "TransitGatewayAttachments": [ { "ResourceId": "vpc-0065acced4EXAMPLE", "TransitGatewayAttachmentId": "tgw-attach-0b5968d3b6EXAMPLE", "ResourceType": "vpc" } ], "Type": "static", "State": "deleted" } } ``` Weitere Informationen finden Sie unter [Löschen einer statischen Route](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html#tgw-delete-static-route) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DeleteTransitGatewayRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway-route.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway-vpc-attachment` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway-vpc-attachment`. **AWS CLI** **So löschen Sie einen Anhang einer Transit-Gateway-VPC** Im folgenden Beispiel für `delete-transit-gateway-vpc-attachment` wird der angegebene VPC-Anhang gelöscht. ``` aws ec2 delete-transit-gateway-vpc-attachment \ --transit-gateway-attachment-id tgw-attach-0d2c54bdbEXAMPLE ``` Ausgabe: ``` { "TransitGatewayVpcAttachment": { "TransitGatewayAttachmentId": "tgw-attach-0d2c54bdb3EXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "VpcId": "vpc-0065acced4f61c651", "VpcOwnerId": "111122223333", "State": "deleting", "CreationTime": "2019-07-17T16:04:27.000Z" } } ``` Weitere Informationen finden Sie unter [Löschen eines VPC-Anhangs](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html#delete-vpc-attachment) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DeleteTransitGatewayVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway-vpc-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `delete-transit-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-transit-gateway`. **AWS CLI** **So löschen Sie ein Transit-Gateway** Im folgenden Beispiel für `delete-transit-gateway` wird das angegebene Transit-Gateway gelöscht. ``` aws ec2 delete-transit-gateway \ --transit-gateway-id tgw-01f04542b2EXAMPLE ``` Ausgabe: ``` { "TransitGateway": { "TransitGatewayId": "tgw-01f04542b2EXAMPLE", "State": "deleting", "OwnerId": "123456789012", "Description": "Example Transit Gateway", "CreationTime": "2019-08-27T15:04:35.000Z", "Options": { "AmazonSideAsn": 64515, "AutoAcceptSharedAttachments": "disable", "DefaultRouteTableAssociation": "enable", "AssociationDefaultRouteTableId": "tgw-rtb-0ce7a6948fEXAMPLE", "DefaultRouteTablePropagation": "enable", "PropagationDefaultRouteTableId": "tgw-rtb-0ce7a6948fEXAMPLE", "VpnEcmpSupport": "enable", "DnsSupport": "enable" } } } ``` Weitere Informationen finden Sie unter [Löschen eines Transit-Gateways](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-transit-gateways.html#delete-tgw) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DeleteTransitGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-transit-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `delete-verified-access-endpoint` Das folgende Codebeispiel zeigt die Verwendung`delete-verified-access-endpoint`. **AWS CLI** **So löschen Sie einen verifizierten Zugriffsendpunkt** Im folgenden Beispiel für `delete-verified-access-endpoint` wird der angegebene verifizierte Zugriffsendpunkt gelöscht. ``` aws ec2 delete-verified-access-endpoint \ --verified-access-endpoint-id vae-066fac616d4d546f2 ``` Ausgabe: ``` { "VerifiedAccessEndpoint": { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235", "VerifiedAccessEndpointId": "vae-066fac616d4d546f2", "ApplicationDomain": "example.com", "EndpointType": "network-interface", "AttachmentType": "vpc", "DomainCertificateArn": "arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE", "EndpointDomain": "my-ava-app.edge-00c3372d53b1540bb.vai-0ce000c0b7643abea.prod.verified-access.us-east-2.amazonaws.com", "SecurityGroupIds": [ "sg-004915970c4c8f13a" ], "NetworkInterfaceOptions": { "NetworkInterfaceId": "eni-0aec70418c8d87a0f", "Protocol": "https", "Port": 443 }, "Status": { "Code": "deleting" }, "Description": "Testing Verified Access", "CreationTime": "2023-08-25T20:54:43", "LastUpdatedTime": "2023-08-25T22:46:32" } } ``` Weitere Informationen finden Sie unter [Verified-Access-Endpunkte](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-endpoints.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DeleteVerifiedAccessEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-verified-access-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `delete-verified-access-group` Das folgende Codebeispiel zeigt die Verwendung`delete-verified-access-group`. **AWS CLI** **So löschen Sie eine verifizierte Zugriffsgruppe** Im folgenden Beispiel für `delete-verified-access-group` wird die angegebene verifizierte Zugriffsgruppe gelöscht. ``` aws ec2 delete-verified-access-group \ --verified-access-group-id vagr-0dbe967baf14b7235 ``` Ausgabe: ``` { "VerifiedAccessGroup": { "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235", "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "Testing Verified Access", "Owner": "123456789012", "VerifiedAccessGroupArn": "arn:aws:ec2:us-east-2:123456789012:verified-access-group/vagr-0dbe967baf14b7235", "CreationTime": "2023-08-25T19:55:19", "LastUpdatedTime": "2023-08-25T22:49:03", "DeletionTime": "2023-08-26T00:58:31" } } ``` Weitere Informationen finden Sie unter [Verified-Access-Gruppen](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-groups.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DeleteVerifiedAccessGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-verified-access-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-verified-access-instance` Das folgende Codebeispiel zeigt die Verwendung`delete-verified-access-instance`. **AWS CLI** **So löschen Sie eine verifizierte Zugriffs-Instance** Im folgenden Beispiel für `delete-verified-access-instance` wird die angegebene Verified-Access-Instance gelöscht. ``` aws ec2 delete-verified-access-instance \ --verified-access-instance-id vai-0ce000c0b7643abea ``` Ausgabe: ``` { "VerifiedAccessInstance": { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "Testing Verified Access", "VerifiedAccessTrustProviders": [], "CreationTime": "2023-08-25T18:27:56", "LastUpdatedTime": "2023-08-26T01:00:18" } } ``` Weitere Informationen finden Sie unter [Verified-Access-Instances](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-instances.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DeleteVerifiedAccessInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-verified-access-instance.html)in der *AWS CLI Befehlsreferenz*. ### `delete-verified-access-trust-provider` Das folgende Codebeispiel zeigt die Verwendung`delete-verified-access-trust-provider`. **AWS CLI** **So löschen Sie einen Vertrauensanbieter für verifizierten Zugriff** Im folgenden Beispiel für `delete-verified-access-trust-provider` wird der angegebene Vertrauensanbieter für verifizierten Zugriff gelöscht. ``` aws ec2 delete-verified-access-trust-provider \ --verified-access-trust-provider-id vatp-0bb32de759a3e19e7 ``` Ausgabe: ``` { "VerifiedAccessTrustProvider": { "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7", "Description": "Testing Verified Access", "TrustProviderType": "user", "UserTrustProviderType": "iam-identity-center", "PolicyReferenceName": "idc", "CreationTime": "2023-08-25T18:40:36", "LastUpdatedTime": "2023-08-25T18:40:36" } } ``` Weitere Informationen finden Sie unter [Vertrauensanbieter für Verified Access](https://docs.aws.amazon.com/verified-access/latest/ug/trust-providers.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DeleteVerifiedAccessTrustProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-verified-access-trust-provider.html)in der *AWS CLI Befehlsreferenz*. ### `delete-volume` Das folgende Codebeispiel zeigt die Verwendung`delete-volume`. **AWS CLI** **So löschen Sie ein Volume** Dieser Beispielbefehl löscht ein verfügbares Volume mit der Volume-ID `vol-049df61146c4d7901`. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-volume --volume-id vol-049df61146c4d7901 ``` + Einzelheiten zur API finden Sie [DeleteVolume](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-volume.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vpc-endpoint-connection-notifications` Das folgende Codebeispiel zeigt die Verwendung`delete-vpc-endpoint-connection-notifications`. **AWS CLI** **So löschen Sie eine Endpunkt-Verbindungsbenachrichtigung** In diesem Beispiel wird die angegebene Endpunkt-Verbindungsbenachrichtigung gelöscht. Befehl: ``` aws ec2 delete-vpc-endpoint-connection-notifications --connection-notification-ids vpce-nfn-008776de7e03f5abc ``` Ausgabe: ``` { "Unsuccessful": [] } ``` + Einzelheiten zur API finden Sie [DeleteVpcEndpointConnectionNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-vpc-endpoint-connection-notifications.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vpc-endpoint-service-configurations` Das folgende Codebeispiel zeigt die Verwendung`delete-vpc-endpoint-service-configurations`. **AWS CLI** **So löschen Sie eine Endpunktservice-Konfiguration** In diesem Beispiel wird die angegebene Endpunktservice-Konfiguration gelöscht. Befehl: ``` aws ec2 delete-vpc-endpoint-service-configurations --service-ids vpce-svc-03d5ebb7d9579a2b3 ``` Ausgabe: ``` { "Unsuccessful": [] } ``` + Einzelheiten zur API finden Sie [DeleteVpcEndpointServiceConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-vpc-endpoint-service-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vpc-endpoints` Das folgende Codebeispiel zeigt die Verwendung`delete-vpc-endpoints`. **AWS CLI** **So löschen Sie einen Endpunkt** In diesem Beispiel werden die Endpunkte vpce-aa22bb33 und vpce-1a2b3c4d gelöscht. Wenn der Befehl teilweise oder gar nicht erfolgreich ist, wird eine Liste der erfolglosen Elemente zurückgegeben. Wenn der Befehl erfolgreich ausgeführt wurde, ist die zurückgegebene Liste leer. Befehl: ``` aws ec2 delete-vpc-endpoints --vpc-endpoint-ids vpce-aa22bb33 vpce-1a2b3c4d ``` Ausgabe: ``` { "Unsuccessful": [] } ``` + Einzelheiten zur API finden Sie [DeleteVpcEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-vpc-endpoints.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vpc-peering-connection` Das folgende Codebeispiel zeigt die Verwendung`delete-vpc-peering-connection`. **AWS CLI** **So löschen Sie eine VPC-Peering-Verbindung** In diesem Beispiel wird die angegebene VPC-Peering-Verbindung gelöscht. Befehl: ``` aws ec2 delete-vpc-peering-connection --vpc-peering-connection-id pcx-1a2b3c4d ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [DeleteVpcPeeringConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-vpc-peering-connection.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vpc` Das folgende Codebeispiel zeigt die Verwendung`delete-vpc`. **AWS CLI** **So löschen Sie eine VPC** In diesem Beispiel wird die angegebene VPC gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-vpc --vpc-id vpc-a01106c2 ``` + Einzelheiten zur API finden Sie [DeleteVpc](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-vpc.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vpn-connection-route` Das folgende Codebeispiel zeigt die Verwendung`delete-vpn-connection-route`. **AWS CLI** **So löschen Sie eine statische Route aus einer VPN-Verbindung** In diesem Beispiel wird die angegebene statische Route aus der festgelegten VPN-Verbindung gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-vpn-connection-route --vpn-connection-id vpn-40f41529 --destination-cidr-block 11.12.0.0/16 ``` + Einzelheiten zur API finden Sie [DeleteVpnConnectionRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-vpn-connection-route.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vpn-connection` Das folgende Codebeispiel zeigt die Verwendung`delete-vpn-connection`. **AWS CLI** **So löschen Sie eine VPN-Verbindung** In diesem Beispiel wird die angegebene VPN-Verbindung gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-vpn-connection --vpn-connection-id vpn-40f41529 ``` + Einzelheiten zur API finden Sie [DeleteVpnConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-vpn-connection.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vpn-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-vpn-gateway`. **AWS CLI** **So löschen Sie ein Virtual Private Gateway** In diesem Beispiel wird das angegebene Virtual Private Gateway gelöscht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 delete-vpn-gateway --vpn-gateway-id vgw-9a4cacf3 ``` + Einzelheiten zur API finden Sie [DeleteVpnGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-vpn-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `deprovision-byoip-cidr` Das folgende Codebeispiel zeigt die Verwendung`deprovision-byoip-cidr`. **AWS CLI** **So entfernen Sie einen IP-Adressbereich, damit er nicht mehr verwendet werden kann** Im folgenden Beispiel wird der angegebene Adressbereich aus der Verwendung mit entfernt AWS. ``` aws ec2 deprovision-byoip-cidr \ --cidr 203.0.113.25/24 ``` Ausgabe: ``` { "ByoipCidr": { "Cidr": "203.0.113.25/24", "State": "pending-deprovision" } } ``` + Einzelheiten zur API finden Sie [DeprovisionByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/deprovision-byoip-cidr.html)unter *AWS CLI Befehlsreferenz*. ### `deprovision-ipam-pool-cidr` Das folgende Codebeispiel zeigt die Verwendung`deprovision-ipam-pool-cidr`. **AWS CLI** **So heben Sie die Bereitstellung eines IPAM-Pool-CIDR auf** Im folgenden Beispiel für `deprovision-ipam-pool-cidr` wird die Bereitstellung eines CIDR aufgehoben, das für einen IPAM-Pool bereitgestellt ist. (Linux) ``` aws ec2 deprovision-ipam-pool-cidr \ --ipam-pool-id ipam-pool-02ec043a19bbe5d08 \ --cidr 11.0.0.0/16 ``` (Windows) ``` aws ec2 deprovision-ipam-pool-cidr ^ --ipam-pool-id ipam-pool-02ec043a19bbe5d08 ^ --cidr 11.0.0.0/16 ``` Ausgabe: ``` { "IpamPoolCidr": { "Cidr": "11.0.0.0/16", "State": "pending-deprovision" } } ``` Weitere Informationen finden Sie unter [Deprovision Pool CIDRs](https://docs.aws.amazon.com/vpc/latest/ipam/depro-pool-cidr-ipam.html) im *Amazon VPC IPAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [DeprovisionIpamPoolCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/deprovision-ipam-pool-cidr.html).AWS CLI * ### `deregister-image` Das folgende Codebeispiel zeigt die Verwendung`deregister-image`. **AWS CLI** **So heben Sie die Registrierung eines AMI auf** Dieses Beispiel hebt die Registrierung des angegebenen AMI auf. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 deregister-image --image-id ami-4fa54026 ``` + Einzelheiten zur API finden Sie [DeregisterImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/deregister-image.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-instance-event-notification-attributes` Das folgende Codebeispiel zeigt die Verwendung`deregister-instance-event-notification-attributes`. **AWS CLI** **Beispiel 1: So entfernen Sie alle Tags aus Ereignisbenachrichtigungen** Im folgenden Beispiel für `deregister-instance-event-notification-attributes` wird `IncludeAllTagsOfInstance=true` entfernt, was zur Folge hat, dass `IncludeAllTagsOfInstance` auf `false` festgelegt wird. ``` aws ec2 deregister-instance-event-notification-attributes \ --instance-tag-attribute IncludeAllTagsOfInstance=true ``` Ausgabe: ``` { "InstanceTagAttribute": { "InstanceTagKeys": [], "IncludeAllTagsOfInstance": true } } ``` Weitere Informationen finden Sie unter [Geplante Ereignisse für Ihre Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-instances-status-check_sched.html) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. **Beispiel 2: So entfernen Sie bestimmte Tags aus Ereignisbenachrichtigungen** Im folgenden Beispiel für `deregister-instance-event-notification-attributes` wird das angegebene Tag aus den Tags entfernt, die in den Ereignisbenachrichtigungen enthalten sind. Verwenden Sie `describe-instance-event-notification-attributes`, um die verbleibenden Tags zu beschreiben, die in Ereignisbenachrichtigungen enthalten sind. ``` aws ec2 deregister-instance-event-notification-attributes \ --instance-tag-attribute InstanceTagKeys="tag-key2" ``` Ausgabe: ``` { "InstanceTagAttribute": { "InstanceTagKeys": [ "tag-key2" ], "IncludeAllTagsOfInstance": false } } ``` Weitere Informationen finden Sie unter [Geplante Ereignisse für Ihre Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-instances-status-check_sched.html) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. + Einzelheiten zur API finden Sie [DeregisterInstanceEventNotificationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/deregister-instance-event-notification-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-transit-gateway-multicast-group-members` Das folgende Codebeispiel zeigt die Verwendung`deregister-transit-gateway-multicast-group-members`. **AWS CLI** **So entfernen Sie die Registrierung von Mitgliedern aus einer Multicast-Gruppe** In diesem Beispiel wird die Registrierung des angegebenen Netzwerkschnittstellen-Gruppenmitglieds aus der Multicast-Gruppe in Transit Gateway aufgehoben. ``` aws ec2 deregister-transit-gateway-multicast-group-members \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE \ --group-ip-address 224.0.1.0 \ --network-interface-ids eni-0e246d3269EXAMPLE ``` Ausgabe: ``` { "DeregisteredMulticastGroupMembers": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef7EXAMPLE", "RegisteredNetworkInterfaceIds": [ "eni-0e246d3269EXAMPLE" ], "GroupIpAddress": "224.0.1.0" } } ``` Weitere Informationen finden Sie unter [Entfernen der Registrierung von Mitgliedern aus einer Multicast-Gruppe](https://docs.aws.amazon.com/vpc/latest/tgw/working-with-multicast.html#remove-members-multicast-group) im *Benutzerhandbuch für AWS Transit Gateway*. + Einzelheiten zur API finden Sie [DeregisterTransitGatewayMulticastGroupMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/deregister-transit-gateway-multicast-group-members.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-transit-gateway-multicast-group-source` Das folgende Codebeispiel zeigt die Verwendung`deregister-transit-gateway-multicast-group-source`. **AWS CLI** **So entfernen Sie die Registrierung einer Quelle aus der Multicast-Gruppe in Transit Gateway** In diesem Beispiel wird die Registrierung der angegebenen Netzwerkschnittstellen-Gruppenquelle aus der Multicast-Gruppe aufgehoben. ``` aws ec2 register-transit-gateway-multicast-group-sources \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \ --group-ip-address 224.0.1.0 \ --network-interface-ids eni-07f290fc3c090cbae ``` Ausgabe: ``` { "DeregisteredMulticastGroupSources": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597", "DeregisteredNetworkInterfaceIds": [ "eni-07f290fc3c090cbae" ], "GroupIpAddress": "224.0.1.0" } } ``` Weitere Informationen finden Sie unter [Entfernen der Registrierung von Quellen aus einer Multicast-Gruppe](https://docs.aws.amazon.com/vpc/latest/tgw/working-with-multicast.html#remove-source-multicast-group) im *Benutzerhandbuch für AWS Transit Gateway*. + Einzelheiten zur API finden Sie [DeregisterTransitGatewayMulticastGroupSource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/deregister-transit-gateway-multicast-group-source.html)in der *AWS CLI Befehlsreferenz*. ### `describe-account-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-account-attributes`. **AWS CLI** **Um alle Attribute für Ihr AWS Konto zu beschreiben** In diesem Beispiel werden die Attribute für Ihr AWS Konto beschrieben. Befehl: ``` aws ec2 describe-account-attributes ``` Ausgabe: ``` { "AccountAttributes": [ { "AttributeName": "vpc-max-security-groups-per-interface", "AttributeValues": [ { "AttributeValue": "5" } ] }, { "AttributeName": "max-instances", "AttributeValues": [ { "AttributeValue": "20" } ] }, { "AttributeName": "supported-platforms", "AttributeValues": [ { "AttributeValue": "EC2" }, { "AttributeValue": "VPC" } ] }, { "AttributeName": "default-vpc", "AttributeValues": [ { "AttributeValue": "none" } ] }, { "AttributeName": "max-elastic-ips", "AttributeValues": [ { "AttributeValue": "5" } ] }, { "AttributeName": "vpc-max-elastic-ips", "AttributeValues": [ { "AttributeValue": "5" } ] } ] } ``` **Um ein einzelnes Attribut für Ihr AWS Konto zu beschreiben** In diesem Beispiel wird das `supported-platforms` Attribut für Ihr AWS Konto beschrieben. Befehl: ``` aws ec2 describe-account-attributes --attribute-names supported-platforms ``` Ausgabe: ``` { "AccountAttributes": [ { "AttributeName": "supported-platforms", "AttributeValues": [ { "AttributeValue": "EC2" }, { "AttributeValue": "VPC" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-account-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-address-transfers` Das folgende Codebeispiel zeigt die Verwendung`describe-address-transfers`. **AWS CLI** **So beschreiben Sie die Übertragung einer Elastic-IP-Adresse** Das folgende `describe-address-transfers`-Beispiel beschreibt die Übertragung der Elastic-IP-Adresse für die angegebene Elastic-IP-Adresse. ``` aws ec2 describe-address-transfers \ --allocation-ids eipalloc-09ad461b0d03f6aaf ``` Ausgabe: ``` { "AddressTransfers": [ { "PublicIp": "100.21.184.216", "AllocationId": "eipalloc-09ad461b0d03f6aaf", "TransferAccountId": "123456789012", "TransferOfferExpirationTimestamp": "2023-02-22T22:51:01.000Z", "AddressTransferStatus": "pending" } ] } ``` Weitere Informationen finden Sie unter [Übertragen von Elastic-IP-Adressen](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-eips.html#transfer-EIPs-intro) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DescribeAddressTransfers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-address-transfers.html)in der *AWS CLI Befehlsreferenz*. ### `describe-addresses-attribute` Das folgende Codebeispiel zeigt die Verwendung`describe-addresses-attribute`. **AWS CLI** **So zeigen Sie die Attribute des Domainnamens an, der einer Elastic-IP-Adresse zugeordnet ist** In den folgenden Beispielen für `describe-addresses-attribute` werden die Attribute des Domainnamens zurückgegeben, der mit der Elastic-IP-Adresse verknüpft ist. Linux: ``` aws ec2 describe-addresses-attribute \ --allocation-ids eipalloc-abcdef01234567890 \ --attribute domain-name ``` Windows: ``` aws ec2 describe-addresses-attribute ^ --allocation-ids eipalloc-abcdef01234567890 ^ --attribute domain-name ``` Ausgabe: ``` { "Addresses": [ { "PublicIp": "192.0.2.0", "AllocationId": "eipalloc-abcdef01234567890", "PtrRecord": "example.com." } ] } ``` Wenn Sie die Attribute einer Elastic-IP-Adresse anzeigen möchten, müssen Sie der Elastic-IP-Adresse zunächst einen Domainnamen zugeordnet haben. Weitere Informationen finden Sie unter [Verwenden von Reverse-DNS für E-Mail-Anwendungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html#Using_Elastic_Addressing_Reverse_DNS) im *Amazon EC2 EC2-Benutzerhandbuch* oder [modify-address-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-address-attribute.html)in der *AWS CLI Command Reference.* + Einzelheiten zur API finden Sie unter [DescribeAddressesAttribute AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-addresses-attribute.html)*Befehlsreferenz.* ### `describe-addresses` Das folgende Codebeispiel zeigt die Verwendung`describe-addresses`. **AWS CLI** **Beispiel 1: So rufen Sie Details über alle Ihre Elastic-IP-Adressen ab** Im folgenden Beispiel für `describe addresses` werden Details zu Ihren Elastic-IP-Adressen angezeigt. ``` aws ec2 describe-addresses ``` Ausgabe: ``` { "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" } ] } ``` **Beispiel 2: So rufen Sie Details zu Ihren Elastic-IP-Adressen für EC2-VPC ab** Im folgenden Beispiel für `describe-addresses` werden Details zu Ihren Elastic-IP-Adressen für die Verwendung mit Instances in einer VPC angezeigt. ``` aws ec2 describe-addresses \ --filters "Name=domain,Values=vpc" ``` Ausgabe: ``` { "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" } ] } ``` **Beispiel 3: So rufen Sie Details über eine durch die Zuweisungs-ID spezifizierte Elastic-IP-Adresse ab** Im folgenden Beispiel für `describe-addresses` werden Details zur Elastic-IP-Adresse mit der angegebenen Zuweisungs-ID angezeigt, die einer Instance in EC2-VPC zugeordnet ist. ``` aws ec2 describe-addresses \ --allocation-ids eipalloc-282d9641 ``` Ausgabe: ``` { "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" } ] } ``` **Beispiel 4: So rufen Sie Details über eine Elastic-IP-Adresse ab, die durch ihre private VPC-IP-Adresse angegeben ist** Im folgenden Beispiel für `describe-addresses` werden Details zur Elastic-IP-Adresse angezeigt, die einer bestimmten privaten IP-Adresse in EC2-VPC zugeordnet ist. ``` aws ec2 describe-addresses \ --filters "Name=private-ip-address,Values=10.251.50.12" ``` **Beispiel 5: So rufen Sie Details zu Elastic-IP-Adressen in EC2-Classic ab** Im folgenden `describe-addresses` Beispiel werden Details zu Ihren Elastic IP-Adressen für die Verwendung in EC2-Classic angezeigt. ``` aws ec2 describe-addresses \ --filters "Name=domain,Values=standard" ``` Ausgabe: ``` { "Addresses": [ { "InstanceId": "i-1234567890abcdef0", "PublicIp": "203.0.110.25", "PublicIpv4Pool": "amazon", "Domain": "standard" } ] } ``` **Beispiel 6: So rufen Sie Details über eine Elastic-IP-Adresse ab, die durch ihre öffentliche IP-Adresse angegeben ist** Im folgenden `describe-addresses` werden Details zur Elastic-IP-Adresse mit dem Wert `203.0.110.25` angezeigt, die mit einer Instance in EC2-Classic verbunden ist. ``` aws ec2 describe-addresses \ --public-ips 203.0.110.25 ``` Ausgabe: ``` { "Addresses": [ { "InstanceId": "i-1234567890abcdef0", "PublicIp": "203.0.110.25", "PublicIpv4Pool": "amazon", "Domain": "standard" } ] } ``` + Einzelheiten zur API finden Sie unter [DescribeAddresses AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-addresses.html)*Befehlsreferenz*. ### `describe-aggregate-id-format` Das folgende Codebeispiel zeigt die Verwendung`describe-aggregate-id-format`. **AWS CLI** **So beschreiben Sie die längeren ID-Formateinstellungen für alle Ressourcentypen in einer Region** Das folgende Beispiel für `describe-aggregate-id-format` beschreibt den insgesamt langen Status des ID-Formats für die aktuelle Region. Der Wert `Deadline` gibt an, dass die Fristen für die dauerhafte Umstellung dieser Ressourcen vom kurzen auf das lange ID-Format abgelaufen sind. Der Wert `UseLongIdsAggregated` gibt an, dass alle IAM-Benutzer und IAM-Rollen so konfiguriert sind, dass sie das lange ID-Format für alle Ressourcentypen verwenden. ``` aws ec2 describe-aggregate-id-format ``` Ausgabe: ``` { "UseLongIdsAggregated": true, "Statuses": [ { "Deadline": "2018-08-13T02:00:00.000Z", "Resource": "network-interface-attachment", "UseLongIds": true }, { "Deadline": "2016-12-13T02:00:00.000Z", "Resource": "instance", "UseLongIds": true }, { "Deadline": "2018-08-13T02:00:00.000Z", "Resource": "elastic-ip-association", "UseLongIds": true }, ... ] } ``` + Einzelheiten zur API finden Sie [DescribeAggregateIdFormat](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-aggregate-id-format.html)in der *AWS CLI Befehlsreferenz*. ### `describe-availability-zones` Das folgende Codebeispiel zeigt die Verwendung`describe-availability-zones`. **AWS CLI** **So beschreiben Sie Ihre Availability Zones** Das folgende Beispiel `describe-availability-zones` zeigt Details zu den Availability Zones, die für Sie verfügbar sind. Die Antwort umfasst nur Availability Zones für die aktuelle Region. In diesem Beispiel wird die Standardregion `us-west-2` (Oregon) des Profils verwendet. ``` aws ec2 describe-availability-zones ``` Ausgabe: ``` { "AvailabilityZones": [ { "State": "available", "OptInStatus": "opt-in-not-required", "Messages": [], "RegionName": "us-west-2", "ZoneName": "us-west-2a", "ZoneId": "usw2-az1", "GroupName": "us-west-2", "NetworkBorderGroup": "us-west-2" }, { "State": "available", "OptInStatus": "opt-in-not-required", "Messages": [], "RegionName": "us-west-2", "ZoneName": "us-west-2b", "ZoneId": "usw2-az2", "GroupName": "us-west-2", "NetworkBorderGroup": "us-west-2" }, { "State": "available", "OptInStatus": "opt-in-not-required", "Messages": [], "RegionName": "us-west-2", "ZoneName": "us-west-2c", "ZoneId": "usw2-az3", "GroupName": "us-west-2", "NetworkBorderGroup": "us-west-2" }, { "State": "available", "OptInStatus": "opt-in-not-required", "Messages": [], "RegionName": "us-west-2", "ZoneName": "us-west-2d", "ZoneId": "usw2-az4", "GroupName": "us-west-2", "NetworkBorderGroup": "us-west-2" }, { "State": "available", "OptInStatus": "opted-in", "Messages": [], "RegionName": "us-west-2", "ZoneName": "us-west-2-lax-1a", "ZoneId": "usw2-lax1-az1", "GroupName": "us-west-2-lax-1", "NetworkBorderGroup": "us-west-2-lax-1" } ] } ``` + Einzelheiten zur API finden Sie [DescribeAvailabilityZones](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-availability-zones.html)in der *AWS CLI Befehlsreferenz*. ### `describe-aws-network-performance-metric-subscription` Das folgende Codebeispiel zeigt die Verwendung`describe-aws-network-performance-metric-subscription`. **AWS CLI** **So beschreiben Sie Ihre Metrikabonnements** Im folgenden Beispiel für `describe-aws-network-performance-metric-subscriptions` werden Ihre Metrikabonnements beschrieben. ``` aws ec2 describe-aws-network-performance-metric-subscriptions ``` Ausgabe: ``` { "Subscriptions": [ { "Source": "us-east-1", "Destination": "eu-west-1", "Metric": "aggregate-latency", "Statistic": "p50", "Period": "five-minutes" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Abonnements](https://docs.aws.amazon.com/network-manager/latest/infrastructure-performance/nmip-subscriptions-cw.html) im *Benutzerhandbuch für Infrastructure Performance*. + Einzelheiten zur API finden Sie [DescribeAwsNetworkPerformanceMetricSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-aws-network-performance-metric-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `describe-aws-network-performance-metric-subscriptions` Das folgende Codebeispiel zeigt die Verwendung`describe-aws-network-performance-metric-subscriptions`. **AWS CLI** **So beschreiben Sie Ihre Metrikabonnements** Im folgenden Beispiel für `describe-aws-network-performance-metric-subscriptions` werden Ihre Metrikabonnements beschrieben. ``` aws ec2 describe-aws-network-performance-metric-subscriptions ``` Ausgabe: ``` { "Subscriptions": [ { "Source": "us-east-1", "Destination": "eu-west-1", "Metric": "aggregate-latency", "Statistic": "p50", "Period": "five-minutes" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Abonnements](https://docs.aws.amazon.com/network-manager/latest/infrastructure-performance/nmip-subscriptions-cw.html) im *Benutzerhandbuch für Infrastructure Performance*. + Einzelheiten zur API finden Sie [DescribeAwsNetworkPerformanceMetricSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-aws-network-performance-metric-subscriptions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-bundle-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-bundle-tasks`. **AWS CLI** **So beschreiben Sie Ihre Bündelungsaufgaben** In diesem Beispiel werden alle Ihre Bündelungsaufgaben beschrieben. Befehl: ``` aws ec2 describe-bundle-tasks ``` Ausgabe: ``` { "BundleTasks": [ { "UpdateTime": "2015-09-15T13:26:54.000Z", "InstanceId": "i-1234567890abcdef0", "Storage": { "S3": { "Prefix": "winami", "Bucket": "bundletasks" } }, "State": "bundling", "StartTime": "2015-09-15T13:24:35.000Z", "Progress": "3%", "BundleId": "bun-2a4e041c" } ] } ``` + Einzelheiten zur API finden Sie [DescribeBundleTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-bundle-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-byoip-cidrs` Das folgende Codebeispiel zeigt die Verwendung`describe-byoip-cidrs`. **AWS CLI** **So beschreiben Sie Ihre bereitgestellten Adressbereiche** Im folgenden `describe-byoip-cidrs` Beispiel werden Details zu den öffentlichen IPv4 Adressbereichen angezeigt, die Sie für die Verwendung durch AWS bereitgestellt haben. ``` aws ec2 describe-byoip-cidrs ``` Ausgabe: ``` { "ByoipCidrs": [ { "Cidr": "203.0.113.25/24", "StatusMessage": "ipv4pool-ec2-1234567890abcdef0", "State": "provisioned" } ] } ``` + Einzelheiten zur API finden Sie unter [DescribeByoipCidrs AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-byoip-cidrs.html)*Befehlsreferenz.* ### `describe-capacity-reservation-fleets` Das folgende Codebeispiel zeigt die Verwendung`describe-capacity-reservation-fleets`. **AWS CLI** **So zeigen Sie eine Kapazitätsreservierungsflotte an** Im folgenden Beispiel für `describe-capacity-reservation-fleets` werden Konfigurations- und Kapazitätsinformationen für die angegebene Kapazitätsreservierungsflotte aufgelistet. Außerdem werden Details zu den einzelnen Kapazitätsreservierungen angezeigt, die sich innerhalb der Flotte befinden. ``` aws ec2 describe-capacity-reservation-fleets \ --capacity-reservation-fleet-ids crf-abcdef01234567890 ``` Ausgabe: ``` { "CapacityReservationFleets": [ { "State": "active", "EndDate": "2022-12-31T23:59:59.000Z", "InstanceMatchCriteria": "open", "Tags": [], "CapacityReservationFleetId": "crf-abcdef01234567890", "Tenancy": "default", "InstanceTypeSpecifications": [ { "CapacityReservationId": "cr-1234567890abcdef0", "AvailabilityZone": "us-east-1a", "FulfilledCapacity": 5.0, "Weight": 1.0, "CreateDate": "2022-07-02T08:34:33.398Z", "InstancePlatform": "Linux/UNIX", "TotalInstanceCount": 5, "Priority": 1, "EbsOptimized": true, "InstanceType": "m5.xlarge" } ], "TotalTargetCapacity": 5, "TotalFulfilledCapacity": 5.0, "CreateTime": "2022-07-02T08:34:33.397Z", "AllocationStrategy": "prioritized" } ] } ``` Weitere Informationen zu Kapazitätsreservierungsflotten finden Sie unter [Kapazitätsreservierungsflotten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cr-fleets.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeCapacityReservationFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-capacity-reservation-fleets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-capacity-reservations` Das folgende Codebeispiel zeigt die Verwendung`describe-capacity-reservations`. **AWS CLI** **Beispiel 1: So beschreiben Sie eine oder mehrere Ihrer Kapazitätsreservierungen** Im folgenden `describe-capacity-reservations` Beispiel werden Details zu all Ihren Kapazitätsreservierungen in der aktuellen AWS Region angezeigt. ``` aws ec2 describe-capacity-reservations ``` Ausgabe: ``` { "CapacityReservations": [ { "CapacityReservationId": "cr-1234abcd56EXAMPLE ", "OwnerId": "123456789111", "CapacityReservationArn": "arn:aws:ec2:us-east-1:123456789111:capacity-reservation/cr-1234abcd56EXAMPLE", "AvailabilityZoneId": "use1-az2", "InstanceType": "c5.large", "InstancePlatform": "Linux/UNIX", "AvailabilityZone": "us-east-1a", "Tenancy": "default", "TotalInstanceCount": 1, "AvailableInstanceCount": 1, "EbsOptimized": true, "EphemeralStorage": false, "State": "active", "StartDate": "2024-10-23T15:00:24+00:00", "EndDateType": "unlimited", "InstanceMatchCriteria": "open", "CreateDate": "2024-10-23T15:00:24+00:00", "Tags": [], "CapacityAllocations": [] }, { "CapacityReservationId": "cr-abcdEXAMPLE9876ef ", "OwnerId": "123456789111", "CapacityReservationArn": "arn:aws:ec2:us-east-1:123456789111:capacity-reservation/cr-abcdEXAMPLE9876ef", "AvailabilityZoneId": "use1-az2", "InstanceType": "c4.large", "InstancePlatform": "Linux/UNIX", "AvailabilityZone": "us-east-1a", "Tenancy": "default", "TotalInstanceCount": 1, "AvailableInstanceCount": 1, "EbsOptimized": true, "EphemeralStorage": false, "State": "cancelled", "StartDate": "2024-10-23T15:01:03+00:00", "EndDateType": "unlimited", "InstanceMatchCriteria": "open", "CreateDate": "2024-10-23T15:01:02+00:00", "Tags": [], "CapacityAllocations": [] } ] } ``` **Beispiel 2: So beschreiben Sie eine oder mehrere Ihrer Kapazitätsreservierungen** Im folgenden Beispiel für `describe-capacity-reservations` werden die Details zu der angegebenen Kapazitätsreservierung angezeigt. ``` aws ec2 describe-capacity-reservations \ --capacity-reservation-ids cr-1234abcd56EXAMPLE ``` Ausgabe: ``` { "CapacityReservations": [ { "CapacityReservationId": "cr-abcdEXAMPLE9876ef ", "OwnerId": "123456789111", "CapacityReservationArn": "arn:aws:ec2:us-east-1:123456789111:capacity-reservation/cr-abcdEXAMPLE9876ef", "AvailabilityZoneId": "use1-az2", "InstanceType": "c4.large", "InstancePlatform": "Linux/UNIX", "AvailabilityZone": "us-east-1a", "Tenancy": "default", "TotalInstanceCount": 1, "AvailableInstanceCount": 1, "EbsOptimized": true, "EphemeralStorage": false, "State": "active", "StartDate": "2024-10-23T15:01:03+00:00", "EndDateType": "unlimited", "InstanceMatchCriteria": "open", "CreateDate": "2024-10-23T15:01:02+00:00", "Tags": [], "CapacityAllocations": [] } ] } ``` Weitere Informationen dazu finden Sie unter [Anzeigen einer Kapazitätsreservierung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#capacity-reservations-view) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. + Einzelheiten zur API finden Sie [DescribeCapacityReservations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-capacity-reservations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-carrier-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-carrier-gateways`. **AWS CLI** **So beschreiben Sie alle Carrier-Gateways** Im folgenden Beispiel für `describe-carrier-gateways` werden alle Ihre Carrier-Gateways aufgelistet. ``` aws ec2 describe-carrier-gateways ``` Ausgabe: ``` { "CarrierGateways": [ { "CarrierGatewayId": "cagw-0465cdEXAMPLE1111", "VpcId": "vpc-0c529aEXAMPLE", "State": "available", "OwnerId": "123456789012", "Tags": [ { "Key": "example", "Value": "tag" } ] } ] } ``` *Weitere Informationen finden Sie unter Carrier gateways< https://docs.aws.amazon.com/vpc/ latest/userguide/Carrier \$1gateway.html> im Amazon Virtual Private Cloud Cloud-Benutzerhandbuch.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DescribeCarrierGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-carrier-gateways.html)AWS CLI * ### `describe-classic-link-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-classic-link-instances`. **AWS CLI** **So beschreiben Sie verknüpfte EC2-Classic-Instances** In diesem Beispiel werden alle Ihre verknüpften EC2-Classic-Instances aufgelistet. Befehl: ``` aws ec2 describe-classic-link-instances ``` Ausgabe: ``` { "Instances": [ { "InstanceId": "i-1234567890abcdef0", "VpcId": "vpc-88888888", "Groups": [ { "GroupId": "sg-11122233" } ], "Tags": [ { "Value": "ClassicInstance", "Key": "Name" } ] }, { "InstanceId": "i-0598c7d356eba48d7", "VpcId": "vpc-12312312", "Groups": [ { "GroupId": "sg-aabbccdd" } ], "Tags": [ { "Value": "ClassicInstance2", "Key": "Name" } ] } ] } ``` In diesem Beispiel werden alle Ihre verknüpften EC2-Classic-Instances aufgelistet und die Antwort so gefiltert, dass sie nur Instances enthält, die mit VPC vpc-88888888 verknüpft sind. Befehl: ``` aws ec2 describe-classic-link-instances --filter "Name=vpc-id,Values=vpc-88888888" ``` Ausgabe: ``` { "Instances": [ { "InstanceId": "i-1234567890abcdef0", "VpcId": "vpc-88888888", "Groups": [ { "GroupId": "sg-11122233" } ], "Tags": [ { "Value": "ClassicInstance", "Key": "Name" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeClassicLinkInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-classic-link-instances.html)in der *AWS CLI Befehlsreferenz*. ### `describe-client-vpn-authorization-rules` Das folgende Codebeispiel zeigt die Verwendung`describe-client-vpn-authorization-rules`. **AWS CLI** **So beschreiben Sie die Autorisierungsregeln für einen Client-VPN-Endpunkt** Im folgenden Beispiel für `describe-client-vpn-authorization-rules` werden Details zu den Autorisierungsregeln für den angegebenen Client-VPN-Endpunkt angezeigt. ``` aws ec2 describe-client-vpn-authorization-rules \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde ``` Ausgabe: ``` { "AuthorizationRules": [ { "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde", "GroupId": "", "AccessAll": true, "DestinationCidr": "0.0.0.0/0", "Status": { "Code": "active" } } ] } ``` Weitere Informationen finden Sie unter [Autorisierungsregeln](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-rules.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [DescribeClientVpnAuthorizationRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-client-vpn-authorization-rules.html)in der *AWS CLI Befehlsreferenz*. ### `describe-client-vpn-connections` Das folgende Codebeispiel zeigt die Verwendung`describe-client-vpn-connections`. **AWS CLI** **So beschreiben Sie die Verbindungen mit einem Client-VPN-Endpunkt** Im folgenden Beispiel für `describe-client-vpn-connections` werden Details zu den Client-Verbindungen mit dem angegebenen Client-VPN-Endpunkt angezeigt. ``` aws ec2 describe-client-vpn-connections \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde ``` Ausgabe: ``` { "Connections": [ { "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde", "Timestamp": "2019-08-12 07:58:34", "ConnectionId": "cvpn-connection-0e03eb24267165acd", "ConnectionEstablishedTime": "2019-08-12 07:57:14", "IngressBytes": "32302", "EgressBytes": "5696", "IngressPackets": "332", "EgressPackets": "67", "ClientIp": "172.31.0.225", "CommonName": "client1.domain.tld", "Status": { "Code": "terminated" }, "ConnectionEndTime": "2019-08-12 07:58:34" }, { "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde", "Timestamp": "2019-08-12 08:02:54", "ConnectionId": "cvpn-connection-00668867a40f18253", "ConnectionEstablishedTime": "2019-08-12 08:02:53", "IngressBytes": "2951", "EgressBytes": "2611", "IngressPackets": "9", "EgressPackets": "6", "ClientIp": "172.31.0.226", "CommonName": "client1.domain.tld", "Status": { "Code": "active" }, "ConnectionEndTime": "-" } ] } ``` Weitere Informationen finden Sie unter [Clientverbindungen](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-connections.html) im *Benutzerhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [DescribeClientVpnConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-client-vpn-connections.html)in der *AWS CLI Befehlsreferenz*. ### `describe-client-vpn-endpoints` Das folgende Codebeispiel zeigt die Verwendung`describe-client-vpn-endpoints`. **AWS CLI** **So beschreiben Sie Ihre Client-VPN-Endpunkte** Im folgenden Beispiel für `describe-client-vpn-endpoints` werden Details zu all Ihren Client-VPN-Endpunkten angezeigt. ``` aws ec2 describe-client-vpn-endpoints ``` Ausgabe: ``` { "ClientVpnEndpoints": [ { "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde", "Description": "Endpoint for Admin access", "Status": { "Code": "available" }, "CreationTime": "2020-11-13T11:37:27", "DnsName": "*.cvpn-endpoint-123456789123abcde.prod.clientvpn.ap-south-1.amazonaws.com", "ClientCidrBlock": "172.31.0.0/16", "DnsServers": [ "8.8.8.8" ], "SplitTunnel": false, "VpnProtocol": "openvpn", "TransportProtocol": "udp", "VpnPort": 443, "ServerCertificateArn": "arn:aws:acm:ap-south-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "AuthenticationOptions": [ { "Type": "certificate-authentication", "MutualAuthentication": { "ClientRootCertificateChain": "arn:aws:acm:ap-south-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" } } ], "ConnectionLogOptions": { "Enabled": true, "CloudwatchLogGroup": "Client-vpn-connection-logs", "CloudwatchLogStream": "cvpn-endpoint-123456789123abcde-ap-south-1-2020/11/13-FCD8HEMVaCcw" }, "Tags": [ { "Key": "Name", "Value": "Client VPN" } ], "SecurityGroupIds": [ "sg-aabbcc11223344567" ], "VpcId": "vpc-a87f92c1", "SelfServicePortalUrl": "https://self-service.clientvpn.amazonaws.com/endpoints/cvpn-endpoint-123456789123abcde", "ClientConnectOptions": { "Enabled": false } } ] } ``` Weitere Informationen finden Sie unter [Client-VPN-Endpunkte](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-endpoints.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [DescribeClientVpnEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-client-vpn-endpoints.html)in der *AWS CLI Befehlsreferenz*. ### `describe-client-vpn-routes` Das folgende Codebeispiel zeigt die Verwendung`describe-client-vpn-routes`. **AWS CLI** **So beschreiben Sie die Routen für einen Client-VPN-Endpunkt** Im folgenden Beispiel für `describe-client-vpn-routes` werden Details zu den Routen des angegebenen Client-VPN-Endpunkts angezeigt. ``` aws ec2 describe-client-vpn-routes \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde ``` Ausgabe: ``` { "Routes": [ { "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde", "DestinationCidr": "10.0.0.0/16", "TargetSubnet": "subnet-0123456789abcabca", "Type": "Nat", "Origin": "associate", "Status": { "Code": "active" }, "Description": "Default Route" }, { "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde", "DestinationCidr": "0.0.0.0/0", "TargetSubnet": "subnet-0123456789abcabca", "Type": "Nat", "Origin": "add-route", "Status": { "Code": "active" } } ] } ``` Weitere Informationen finden Sie unter [Routen](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-routes.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [DescribeClientVpnRoutes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-client-vpn-routes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-client-vpn-target-networks` Das folgende Codebeispiel zeigt die Verwendung`describe-client-vpn-target-networks`. **AWS CLI** **So beschreiben Sie die Zielnetzwerke für einen Client-VPN-Endpunkt** Im folgenden Beispiel für `describe-client-vpn-target-networks` werden Details zu den Zielnetzwerken des angegebenen Client-VPN-Endpunkts angezeigt. ``` aws ec2 describe-client-vpn-target-networks \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde ``` Ausgabe: ``` { "ClientVpnTargetNetworks": [ { "AssociationId": "cvpn-assoc-012e837060753dc3d", "VpcId": "vpc-11111222222333333", "TargetNetworkId": "subnet-0123456789abcabca", "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde", "Status": { "Code": "associating" }, "SecurityGroups": [ "sg-012345678910abcab" ] } ] } ``` Weitere Informationen finden Sie unter [Zielnetzwerke](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-target.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [DescribeClientVpnTargetNetworks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-client-vpn-target-networks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-coip-pools` Das folgende Codebeispiel zeigt die Verwendung`describe-coip-pools`. **AWS CLI** **So beschreiben Sie kundeneigene IP-Adresspools** Das folgende `describe-coip-pools` Beispiel beschreibt die kundeneigenen IP-Adresspools in Ihrem AWS Konto. ``` aws ec2 describe-coip-pools ``` Ausgabe: ``` { "CoipPools": [ { "PoolId": "ipv4pool-coip-123a45678bEXAMPLE", "PoolCidrs": [ "0.0.0.0/0" ], "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE", "PoolArn": "arn:aws:ec2:us-west-2:123456789012:coip-pool/ipv4pool-coip-123a45678bEXAMPLE" } ] } ``` Weitere Informationen finden Sie unter [Kundeneigene IP-Adressen](https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [DescribeCoipPools](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-coip-pools.html)in der *AWS CLI Befehlsreferenz.* ### `describe-conversion-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-conversion-tasks`. **AWS CLI** **So zeigen Sie den Status einer Konvertierungsaufgabe an** In diesem Beispiel wird der Status einer Konvertierungsaufgabe mit der ID import-i-ffvko 9js zurückgegeben. Befehl: ``` aws ec2 describe-conversion-tasks --conversion-task-ids import-i-ffvko9js ``` Ausgabe: ``` { "ConversionTasks": [ { "ConversionTaskId": "import-i-ffvko9js", "ImportInstance": { "InstanceId": "i-1234567890abcdef0", "Volumes": [ { "Volume": { "Id": "vol-049df61146c4d7901", "Size": 16 }, "Status": "completed", "Image": { "Size": 1300687360, "ImportManifestUrl": "https://s3.amazonaws.com/myimportbucket/411443cd-d620-4f1c-9d66-13144EXAMPLE/RHEL5.vmdkmanifest.xml?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Expires=140EXAMPLE&Signature=XYNhznHNgCqsjDxL9wRL%2FJvEXAMPLE", "Format": "VMDK" }, "BytesConverted": 1300682960, "AvailabilityZone": "us-east-1d" } ] }, "ExpirationTime": "2014-05-14T22:06:23Z", "State": "completed" } ] } ``` + Einzelheiten zur API finden Sie [DescribeConversionTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-conversion-tasks.html)in der *AWS CLI Befehlsreferenz.* ### `describe-customer-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-customer-gateways`. **AWS CLI** **So beschreiben Sie Ihre Kunden-Gateways** Dieses Beispiel beschreibt Ihre Kunden-Gateways. Befehl: ``` aws ec2 describe-customer-gateways ``` Ausgabe: ``` { "CustomerGateways": [ { "CustomerGatewayId": "cgw-b4dc3961", "IpAddress": "203.0.113.12", "State": "available", "Type": "ipsec.1", "BgpAsn": "65000" }, { "CustomerGatewayId": "cgw-0e11f167", "IpAddress": "12.1.2.3", "State": "available", "Type": "ipsec.1", "BgpAsn": "65534" } ] } ``` **So beschreiben Sie ein bestimmtes Kunden-Gateway** In diesem Beispiel wird das angegebene Kunden-Gateway beschrieben. Befehl: ``` aws ec2 describe-customer-gateways --customer-gateway-ids cgw-0e11f167 ``` Ausgabe: ``` { "CustomerGateways": [ { "CustomerGatewayId": "cgw-0e11f167", "IpAddress": "12.1.2.3", "State": "available", "Type": "ipsec.1", "BgpAsn": "65534" } ] } ``` + Einzelheiten zur API finden Sie [DescribeCustomerGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-customer-gateways.html)in der *AWS CLI Befehlsreferenz*. ### `describe-dhcp-options` Das folgende Codebeispiel zeigt die Verwendung`describe-dhcp-options`. **AWS CLI** **Beispiel 1: So beschreiben Sie Ihre DHCP-Optionen** Im folgenden Beispiel für `describe-dhcp-options` werden Details über Ihre VPCs abgerufen. ``` aws ec2 describe-dhcp-options ``` Ausgabe: ``` { "DhcpOptions": [ { "DhcpConfigurations": [ { "Key": "domain-name", "Values": [ { "Value": "us-east-2.compute.internal" } ] }, { "Key": "domain-name-servers", "Values": [ { "Value": "AmazonProvidedDNS" } ] } ], "DhcpOptionsId": "dopt-19edf471", "OwnerId": "111122223333" }, { "DhcpConfigurations": [ { "Key": "domain-name", "Values": [ { "Value": "us-east-2.compute.internal" } ] }, { "Key": "domain-name-servers", "Values": [ { "Value": "AmazonProvidedDNS" } ] } ], "DhcpOptionsId": "dopt-fEXAMPLE", "OwnerId": "111122223333" } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit DHCP-Optionslisten](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html#DHCPOptionSet) im *Benutzerhandbuch für AWS VPC*. **Beispiel 2: So beschreiben Sie Ihre DHCP-Optionen und filtern die Ausgabe** Im folgenden Beispiel für `describe-dhcp-options` werden Ihre DHCP-Optionen beschrieben und ein Filter wird verwendet, um nur die DHCP-Optionen zurückzugeben, für die `example.com` als Domainnamenserver festgelegt ist. Im Beispiel wird der Parameter `--query` verwendet, um nur die Konfigurationsinformationen und die ID in der Ausgabe anzuzeigen. ``` aws ec2 describe-dhcp-options \ --filters Name=key,Values=domain-name-servers Name=value,Values=example.com \ --query "DhcpOptions[*].[DhcpConfigurations,DhcpOptionsId]" ``` Ausgabe: ``` [ [ [ { "Key": "domain-name", "Values": [ { "Value": "example.com" } ] }, { "Key": "domain-name-servers", "Values": [ { "Value": "172.16.16.16" } ] } ], "dopt-001122334455667ab" ] ] ``` Weitere Informationen finden Sie unter [Arbeiten mit DHCP-Optionslisten](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html#DHCPOptionSet) im *Benutzerhandbuch für AWS VPC*. + Einzelheiten zur API finden Sie [DescribeDhcpOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-dhcp-options.html)in der *AWS CLI Befehlsreferenz*. ### `describe-egress-only-internet-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-egress-only-internet-gateways`. **AWS CLI** **So beschreiben Sie Ihre Internet-Gateways nur für ausgehenden Verkehr** In diesem Beispiel werden Ihre Internet-Gateways nur für ausgehenden Verkehr beschrieben. Befehl: ``` aws ec2 describe-egress-only-internet-gateways ``` Ausgabe: ``` { "EgressOnlyInternetGateways": [ { "EgressOnlyInternetGatewayId": "eigw-015e0e244e24dfe8a", "Attachments": [ { "State": "attached", "VpcId": "vpc-0c62a468" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeEgressOnlyInternetGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-egress-only-internet-gateways.html)in der *AWS CLI Befehlsreferenz*. ### `describe-elastic-gpus` Das folgende Codebeispiel zeigt die Verwendung`describe-elastic-gpus`. **AWS CLI** **So beschreiben Sie eine Elastic GPU** Befehl: ``` aws ec2 describe-elastic-gpus --elastic-gpu-ids egpu-12345678901234567890abcdefghijkl ``` + Einzelheiten zur API finden Sie [DescribeElasticGpus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-elastic-gpus.html)in der *AWS CLI Befehlsreferenz*. ### `describe-export-image-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-export-image-tasks`. **AWS CLI** **So überwachen Sie eine Aufgabe zum Exportieren eines Image** Im folgenden Beispiel für `describe-export-image-tasks` wird der Status der angegebenen Aufgabe zum Exportieren eines Image überprüft. Die resultierende Image-Datei in Amazon S3 lautet `my-export-bucket/exports/export-ami-1234567890abcdef0.vmdk`. ``` aws ec2 describe-export-image-tasks \ --export-image-task-ids export-ami-1234567890abcdef0 ``` Ausgabe für eine Aufgabe zum Exportieren eines Image, die gerade ausgeführt wird. ``` { "ExportImageTasks": [ { "ExportImageTaskId": "export-ami-1234567890abcdef0" "Progress": "21", "S3ExportLocation": { "S3Bucket": "my-export-bucket", "S3Prefix": "exports/" }, "Status": "active", "StatusMessage": "updating" } ] } ``` Ausgabe für eine Aufgabe zum Exportieren eines Image, die abgeschlossen ist. ``` { "ExportImageTasks": [ { "ExportImageTaskId": "export-ami-1234567890abcdef0" "S3ExportLocation": { "S3Bucket": "my-export-bucket", "S3Prefix": "exports/" }, "Status": "completed" } ] } ``` Weitere Informationen finden Sie unter [Exportieren einer VM aus einem AMI](https://docs.aws.amazon.com/vm-import/latest/userguide/vmexport_image.html) im * Import/Export VM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeExportImageTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-export-image-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-export-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-export-tasks`. **AWS CLI** **So listen Sie Details zu einer Aufgabe zum Exportieren einer Instance auf** Dieses Beispiel beschreibt die Exportaufgabe mit der ID export-i-fh 8sjjsq. Befehl: ``` aws ec2 describe-export-tasks --export-task-ids export-i-fh8sjjsq ``` Ausgabe: ``` { "ExportTasks": [ { "State": "active", "InstanceExportDetails": { "InstanceId": "i-1234567890abcdef0", "TargetEnvironment": "vmware" }, "ExportToS3Task": { "S3Bucket": "myexportbucket", "S3Key": "RHEL5export-i-fh8sjjsq.ova", "DiskImageFormat": "vmdk", "ContainerFormat": "ova" }, "Description": "RHEL5 instance", "ExportTaskId": "export-i-fh8sjjsq" } ] } ``` + *Einzelheiten zur API finden Sie [DescribeExportTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-export-tasks.html)in AWS CLI der Befehlsreferenz.* ### `describe-fast-launch-images` Das folgende Codebeispiel zeigt die Verwendung`describe-fast-launch-images`. **AWS CLI** **Um die Details für Windows zu beschreiben AMIs , die für einen schnelleren Start konfiguriert sind** Das folgende `describe-fast-launch-images` Beispiel beschreibt die Details für alle AMIs in Ihrem Konto, die für einen schnelleren Start konfiguriert sind. Dazu gehören der Ressourcentyp, die Snapshot-Konfiguration, die Details der Startvorlage, die maximale Anzahl parallel Starts, die AMI-Besitzer-ID, der Status der Schnellstartkonfiguration, der Grund für die Statusänderung und der Zeitpunkt der Statusänderung. ``` aws ec2 describe-fast-launch-images ``` Ausgabe: ``` { "FastLaunchImages": [ { "ImageId": "ami-01234567890abcedf", "ResourceType": "snapshot", "SnapshotConfiguration": {}, "LaunchTemplate": { "LaunchTemplateId": "lt-01234567890abcedf", "LaunchTemplateName": "EC2FastLaunchDefaultResourceCreation-a8c6215d-94e6-441b-9272-dbd1f87b07e2", "Version": "1" }, "MaxParallelLaunches": 6, "OwnerId": "0123456789123", "State": "enabled", "StateTransitionReason": "Client.UserInitiated", "StateTransitionTime": "2022-01-27T22:20:06.552000+00:00" } ] } ``` Weitere Informationen zur Konfiguration eines Windows-AMI für einen schnelleren Start finden Sie unter [Konfigurieren von AMIs für schnelleres Starten](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/windows-ami-version-history.html#win-ami-config-fast-launch) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeFastLaunchImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-fast-launch-images.html)in der *AWS CLI Befehlsreferenz*. ### `describe-fast-snapshot-restores` Das folgende Codebeispiel zeigt die Verwendung`describe-fast-snapshot-restores`. **AWS CLI** **So beschreiben Sie schnelle Snapshot-Wiederherstellungen** Das folgende Beispiel für `describe-fast-snapshot-restores` zeigt Details für alle schnellen Snapshot-Wiederherstellungen mit dem Status `disabled` an. ``` aws ec2 describe-fast-snapshot-restores \ --filters Name=state,Values=disabled ``` Ausgabe: ``` { "FastSnapshotRestores": [ { "SnapshotId": "snap-1234567890abcdef0", "AvailabilityZone": "us-west-2c", "State": "disabled", "StateTransitionReason": "Client.UserInitiated - Lifecycle state transition", "OwnerId": "123456789012", "EnablingTime": "2020-01-25T23:57:49.596Z", "OptimizingTime": "2020-01-25T23:58:25.573Z", "EnabledTime": "2020-01-25T23:59:29.852Z", "DisablingTime": "2020-01-26T00:40:56.069Z", "DisabledTime": "2020-01-26T00:41:27.390Z" } ] } ``` Das folgende Beispiel für `describe-fast-snapshot-restores` beschreibt alle schnellen Snapshot-Wiederherstellungen. ``` aws ec2 describe-fast-snapshot-restores ``` + Einzelheiten zur API finden Sie [DescribeFastSnapshotRestores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-fast-snapshot-restores.html)in der *AWS CLI Befehlsreferenz*. ### `describe-fleet-history` Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-history`. **AWS CLI** **So beschreiben Sie den EC2-Flotten-Verlauf** Im folgenden Beispiel für `describe-fleet-history` wird der Verlauf für die angegebene EC2-Flotte zurückgegeben, die zum angegebenen Zeitpunkt startet. Die Ausgabe bezieht sich auf eine EC2-Flotte mit zwei ausgeführten Instances. ``` aws ec2 describe-fleet-history \ --fleet-id fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \ --start-time 2020-09-01T00:00:00Z ``` Ausgabe: ``` { "HistoryRecords": [ { "EventInformation": { "EventSubType": "submitted" }, "EventType": "fleetRequestChange", "Timestamp": "2020-09-01T18:26:05.000Z" }, { "EventInformation": { "EventSubType": "active" }, "EventType": "fleetRequestChange", "Timestamp": "2020-09-01T18:26:15.000Z" }, { "EventInformation": { "EventDescription": "t2.small, ami-07c8bc5c1ce9598c3, ...", "EventSubType": "progress" }, "EventType": "fleetRequestChange", "Timestamp": "2020-09-01T18:26:17.000Z" }, { "EventInformation": { "EventDescription": "{\"instanceType\":\"t2.small\", ...}", "EventSubType": "launched", "InstanceId": "i-083a1c446e66085d2" }, "EventType": "instanceChange", "Timestamp": "2020-09-01T18:26:17.000Z" }, { "EventInformation": { "EventDescription": "{\"instanceType\":\"t2.small\", ...}", "EventSubType": "launched", "InstanceId": "i-090db02406cc3c2d6" }, "EventType": "instanceChange", "Timestamp": "2020-09-01T18:26:17.000Z" } ], "LastEvaluatedTime": "2020-09-01T19:10:19.000Z", "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE", "StartTime": "2020-08-31T23:53:20.000Z" } ``` Weitere Informationen finden Sie unter [Verwalten einer EC2-Flotte](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-ec2-fleet.html) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. + Einzelheiten zur API finden Sie [DescribeFleetHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-fleet-history.html)in der *AWS CLI Befehlsreferenz*. ### `describe-fleet-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-instances`. **AWS CLI** **So beschreiben Sie die laufenden Instances für eine EC2-Flotte** Das folgende Beispiel für `describe-fleet-instances` beschreibt die laufenden Instances für die angegebene EC2-Flotte. ``` aws ec2 describe-fleet-instances \ --fleet-id 12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE ``` Ausgabe: ``` { "ActiveInstances": [ { "InstanceId": "i-090db02406cc3c2d6", "InstanceType": "t2.small", "SpotInstanceRequestId": "sir-a43gtpfk", "InstanceHealth": "healthy" }, { "InstanceId": "i-083a1c446e66085d2", "InstanceType": "t2.small", "SpotInstanceRequestId": "sir-iwcit2nj", "InstanceHealth": "healthy" } ], "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE" } ``` Weitere Informationen finden Sie unter [Verwalten einer EC2-Flotte](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-ec2-fleet.html) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. + Einzelheiten zur API finden Sie [DescribeFleetInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-fleet-instances.html)in der *AWS CLI Befehlsreferenz*. ### `describe-fleets` Das folgende Codebeispiel zeigt die Verwendung`describe-fleets`. **AWS CLI** **So beschreiben Sie eine EC2-Flotte** Das folgende Beispiel für `describe-fleets` beschreibt die angegebene EC2-Flotte. ``` aws ec2 describe-fleets \ --fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE ``` Ausgabe: ``` { "Fleets": [ { "ActivityStatus": "pending_fulfillment", "CreateTime": "2020-09-01T18:26:05.000Z", "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE", "FleetState": "active", "ExcessCapacityTerminationPolicy": "termination", "FulfilledCapacity": 0.0, "FulfilledOnDemandCapacity": 0.0, "LaunchTemplateConfigs": [ { "LaunchTemplateSpecification": { "LaunchTemplateId": "lt-0e632f2855a979cd5", "Version": "1" } } ], "TargetCapacitySpecification": { "TotalTargetCapacity": 2, "OnDemandTargetCapacity": 0, "SpotTargetCapacity": 2, "DefaultTargetCapacityType": "spot" }, "TerminateInstancesWithExpiration": false, "Type": "maintain", "ReplaceUnhealthyInstances": false, "SpotOptions": { "AllocationStrategy": "lowestPrice", "InstanceInterruptionBehavior": "terminate", "InstancePoolsToUseCount": 1 }, "OnDemandOptions": { "AllocationStrategy": "lowestPrice" } } ] } ``` Weitere Informationen finden Sie unter [Verwalten einer EC2-Flotte](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-ec2-fleet.html) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. + Einzelheiten zur API finden Sie [DescribeFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-fleets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-flow-logs` Das folgende Codebeispiel zeigt die Verwendung`describe-flow-logs`. **AWS CLI** **Beispiel 1: So beschreiben Sie alle Ihre Flow-Protokolle** Im folgenden Beispiel für `describe-flow-logs` werden Details für all Ihre Flow-Protokolle angezeigt. ``` aws ec2 describe-flow-logs ``` Ausgabe: ``` { "FlowLogs": [ { "CreationTime": "2018-02-21T13:22:12.644Z", "DeliverLogsPermissionArn": "arn:aws:iam::123456789012:role/flow-logs-role", "DeliverLogsStatus": "SUCCESS", "FlowLogId": "fl-aabbccdd112233445", "MaxAggregationInterval": 600, "FlowLogStatus": "ACTIVE", "LogGroupName": "FlowLogGroup", "ResourceId": "subnet-12345678901234567", "TrafficType": "ALL", "LogDestinationType": "cloud-watch-logs", "LogFormat": "${version} ${account-id} ${interface-id} ${srcaddr} ${dstaddr} ${srcport} ${dstport} ${protocol} ${packets} ${bytes} ${start} ${end} ${action} ${log-status}" }, { "CreationTime": "2020-02-04T15:22:29.986Z", "DeliverLogsStatus": "SUCCESS", "FlowLogId": "fl-01234567890123456", "MaxAggregationInterval": 60, "FlowLogStatus": "ACTIVE", "ResourceId": "vpc-00112233445566778", "TrafficType": "ACCEPT", "LogDestinationType": "s3", "LogDestination": "arn:aws:s3:::my-flow-log-bucket/custom", "LogFormat": "${version} ${vpc-id} ${subnet-id} ${instance-id} ${interface-id} ${account-id} ${type} ${srcaddr} ${dstaddr} ${srcport} ${dstport} ${pkt-srcaddr} ${pkt-dstaddr} ${protocol} ${bytes} ${packets} ${start} ${end} ${action} ${tcp-flags} ${log-status}" } ] } ``` **Beispiel 2: So beschreiben Sie eine Teilmenge Ihrer Flow-Protokolle** Das folgende `describe-flow-logs` Beispiel verwendet einen Filter, um Details nur für die Flow-Logs anzuzeigen, die sich in der angegebenen Protokollgruppe in Amazon CloudWatch Logs befinden. ``` aws ec2 describe-flow-logs \ --filter "Name=log-group-name,Values=MyFlowLogs" ``` + Einzelheiten zur API finden Sie [DescribeFlowLogs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-flow-logs.html)in der *AWS CLI Befehlsreferenz*. ### `describe-fpga-image-attribute` Das folgende Codebeispiel zeigt die Verwendung`describe-fpga-image-attribute`. **AWS CLI** **So beschreiben Sie die Attribute eines Amazon-FPGA-Image** In diesem Beispiel werden die Ladeberechtigungen für das angegebene AFI beschrieben. Befehl: ``` aws ec2 describe-fpga-image-attribute --fpga-image-id afi-0d123e123bfc85abc --attribute loadPermission ``` Ausgabe: ``` { "FpgaImageAttribute": { "FpgaImageId": "afi-0d123e123bfc85abc", "LoadPermissions": [ { "UserId": "123456789012" } ] } } ``` + Einzelheiten zur API finden Sie [DescribeFpgaImageAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-fpga-image-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `describe-fpga-images` Das folgende Codebeispiel zeigt die Verwendung`describe-fpga-images`. **AWS CLI** **So beschreiben Sie Amazon-FPGA-Images** In diesem Beispiel wird beschrieben AFIs , welche dem Konto gehören`123456789012`. Befehl: ``` aws ec2 describe-fpga-images --filters Name=owner-id,Values=123456789012 ``` Ausgabe: ``` { "FpgaImages": [ { "UpdateTime": "2017-12-22T12:09:14.000Z", "Name": "my-afi", "PciId": { "SubsystemVendorId": "0xfedd", "VendorId": "0x1d0f", "DeviceId": "0xf000", "SubsystemId": "0x1d51" }, "FpgaImageGlobalId": "agfi-123cb27b5e84a0abc", "Public": false, "State": { "Code": "available" }, "ShellVersion": "0x071417d3", "OwnerId": "123456789012", "FpgaImageId": "afi-0d123e123bfc85abc", "CreateTime": "2017-12-22T11:43:33.000Z", "Description": "my-afi" } ] } ``` + Einzelheiten zur API finden Sie [DescribeFpgaImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-fpga-images.html)in der *AWS CLI Befehlsreferenz*. ### `describe-host-reservation-offerings` Das folgende Codebeispiel zeigt die Verwendung`describe-host-reservation-offerings`. **AWS CLI** **So beschreiben Sie Reservierungsangebote für Dedicated Hosts** In diesem Beispiel werden die Dedicated-Host-Reservierungen für die M4-Instance-Familie beschrieben, die erworben werden können. Befehl: ``` aws ec2 describe-host-reservation-offerings --filter Name=instance-family,Values=m4 ``` Ausgabe: ``` { "OfferingSet": [ { "HourlyPrice": "1.499", "OfferingId": "hro-03f707bf363b6b324", "InstanceFamily": "m4", "PaymentOption": "NoUpfront", "UpfrontPrice": "0.000", "Duration": 31536000 }, { "HourlyPrice": "1.045", "OfferingId": "hro-0ef9181cabdef7a02", "InstanceFamily": "m4", "PaymentOption": "NoUpfront", "UpfrontPrice": "0.000", "Duration": 94608000 }, { "HourlyPrice": "0.714", "OfferingId": "hro-04567a15500b92a51", "InstanceFamily": "m4", "PaymentOption": "PartialUpfront", "UpfrontPrice": "6254.000", "Duration": 31536000 }, { "HourlyPrice": "0.484", "OfferingId": "hro-0d5d7a9d23ed7fbfe", "InstanceFamily": "m4", "PaymentOption": "PartialUpfront", "UpfrontPrice": "12720.000", "Duration": 94608000 }, { "HourlyPrice": "0.000", "OfferingId": "hro-05da4108ca998c2e5", "InstanceFamily": "m4", "PaymentOption": "AllUpfront", "UpfrontPrice": "23913.000", "Duration": 94608000 }, { "HourlyPrice": "0.000", "OfferingId": "hro-0a9f9be3b95a3dc8f", "InstanceFamily": "m4", "PaymentOption": "AllUpfront", "UpfrontPrice": "12257.000", "Duration": 31536000 } ] } ``` + Einzelheiten zur API finden Sie [DescribeHostReservationOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-host-reservation-offerings.html)in der *AWS CLI Befehlsreferenz*. ### `describe-host-reservations` Das folgende Codebeispiel zeigt die Verwendung`describe-host-reservations`. **AWS CLI** **So beschreiben Sie Reservierungen für Dedicated Hosts in Ihrem Konto** In diesem Beispiel werden Reservierungen für Dedicated Hosts in Ihrem Konto beschrieben. Befehl: ``` aws ec2 describe-host-reservations ``` Ausgabe: ``` { "HostReservationSet": [ { "Count": 1, "End": "2019-01-10T12:14:09Z", "HourlyPrice": "1.499", "InstanceFamily": "m4", "OfferingId": "hro-03f707bf363b6b324", "PaymentOption": "NoUpfront", "State": "active", "HostIdSet": [ "h-013abcd2a00cbd123" ], "Start": "2018-01-10T12:14:09Z", "HostReservationId": "hr-0d418a3a4ffc669ae", "UpfrontPrice": "0.000", "Duration": 31536000 } ] } ``` + Einzelheiten zur API finden Sie [DescribeHostReservations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-host-reservations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-hosts` Das folgende Codebeispiel zeigt die Verwendung`describe-hosts`. **AWS CLI** **So zeigen Sie die Details zu Dedicated Hosts an** Im folgenden `describe-hosts` Beispiel werden Details zu den `available` Dedicated Hosts in Ihrem AWS Konto angezeigt. ``` aws ec2 describe-hosts --filter "Name=state,Values=available" ``` Ausgabe: ``` { "Hosts": [ { "HostId": "h-07879acf49EXAMPLE", "Tags": [ { "Value": "production", "Key": "purpose" } ], "HostProperties": { "Cores": 48, "TotalVCpus": 96, "InstanceType": "m5.large", "Sockets": 2 }, "Instances": [], "State": "available", "AvailabilityZone": "eu-west-1a", "AvailableCapacity": { "AvailableInstanceCapacity": [ { "AvailableCapacity": 48, "InstanceType": "m5.large", "TotalCapacity": 48 } ], "AvailableVCpus": 96 }, "HostRecovery": "on", "AllocationTime": "2019-08-19T08:57:44.000Z", "AutoPlacement": "off" } ] } ``` Weitere Informationen dazu finden Sie unter [Anzeigen von Dedicated Hosts](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-dedicated-hosts-work.html#dedicated-hosts-managing) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. + Einzelheiten zur API finden Sie [DescribeHosts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-hosts.html)in der *AWS CLI Befehlsreferenz*. ### `describe-iam-instance-profile-associations` Das folgende Codebeispiel zeigt die Verwendung`describe-iam-instance-profile-associations`. **AWS CLI** **So beschreiben Sie die Zuordnungen von IAM-Instance-Profilen** In diesem Beispiel werden alle Ihre IAM-Instance-Profilzuordnungen beschrieben. Befehl: ``` aws ec2 describe-iam-instance-profile-associations ``` Ausgabe: ``` { "IamInstanceProfileAssociations": [ { "InstanceId": "i-09eb09efa73ec1dee", "State": "associated", "AssociationId": "iip-assoc-0db249b1f25fa24b8", "IamInstanceProfile": { "Id": "AIPAJVQN4F5WVLGCJDRGM", "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role" } }, { "InstanceId": "i-0402909a2f4dffd14", "State": "associating", "AssociationId": "iip-assoc-0d1ec06278d29f44a", "IamInstanceProfile": { "Id": "AGJAJVQN4F5WVLGCJABCM", "Arn": "arn:aws:iam::123456789012:instance-profile/user1-role" } } ] } ``` + Einzelheiten zur API finden Sie [DescribeIamInstanceProfileAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-iam-instance-profile-associations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-id-format` Das folgende Codebeispiel zeigt die Verwendung`describe-id-format`. **AWS CLI** **Beispiel 1: So beschreiben Sie das ID-Format einer Ressource** Das folgende Beispiel für `describe-id-format` beschreibt das ID-Format für Sicherheitsgruppen. ``` aws ec2 describe-id-format \ --resource security-group ``` In der folgenden Beispielausgabe gibt der Wert `Deadline` an, dass die Frist für den dauerhaften Wechsel dieses Ressourcentyps vom kurzen zum langen ID-Format am 15. August 2018 um 00:00 Uhr UTC abgelaufen ist. ``` { "Statuses": [ { "Deadline": "2018-08-15T00:00:00.000Z", "Resource": "security-group", "UseLongIds": true } ] } ``` **Beispiel 2: So beschreiben Sie das ID-Format für alle Ressourcen** Im folgenden Beispiel für `describe-id-format` wird das ID-Format für alle Ressourcentypen beschrieben. Alle Ressourcentypen, die das kurze ID-Format unterstützten, wurden auf das lange ID-Format umgestellt. ``` aws ec2 describe-id-format ``` + Einzelheiten zur API finden Sie [DescribeIdFormat](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-id-format.html)in der *AWS CLI Befehlsreferenz*. ### `describe-identity-id-format` Das folgende Codebeispiel zeigt die Verwendung`describe-identity-id-format`. **AWS CLI** **So beschreiben Sie das ID-Format für eine IAM-Rolle** Das folgende `describe-identity-id-format` Beispiel beschreibt das ID-Format, das von Instances empfangen wird, die von der IAM-Rolle `EC2Role` in Ihrem AWS Konto erstellt wurden. ``` aws ec2 describe-identity-id-format \ --principal-arn arn:aws:iam::123456789012:role/my-iam-role \ --resource instance ``` Die folgende Ausgabe zeigt, dass Instances, die von dieser Rolle erstellt wurden, IDs im Long-ID-Format empfangen werden. ``` { "Statuses": [ { "Deadline": "2016-12-15T00:00:00Z", "Resource": "instance", "UseLongIds": true } ] } ``` **So beschreiben Sie das ID-Format für einen IAM-Benutzer** Das folgende `describe-identity-id-format` Beispiel beschreibt das ID-Format, das von Snapshots empfangen wird, die vom IAM-Benutzer `AdminUser` in Ihrem AWS Konto erstellt wurden. ``` aws ec2 describe-identity-id-format \ --principal-arn arn:aws:iam::123456789012:user/AdminUser \ --resource snapshot ``` Die Ausgabe gibt an, dass von diesem Benutzer erstellte Snapshots IDs im Long-ID-Format empfangen werden. ``` { "Statuses": [ { "Deadline": "2016-12-15T00:00:00Z", "Resource": "snapshot", "UseLongIds": true } ] } ``` + Einzelheiten zur API finden Sie unter [DescribeIdentityIdFormat AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-identity-id-format.html)*Befehlsreferenz.* ### `describe-image-attribute` Das folgende Codebeispiel zeigt die Verwendung`describe-image-attribute`. **AWS CLI** **So beschreiben Sie die Startberechtigungen für ein AMI** In diesem Beispiel werden die Startberechtigungen für das angegebene AMI beschrieben. Befehl: ``` aws ec2 describe-image-attribute --image-id ami-5731123e --attribute launchPermission ``` Ausgabe: ``` { "LaunchPermissions": [ { "UserId": "123456789012" } ], "ImageId": "ami-5731123e", } ``` **So beschreiben Sie die Produktcodes für ein AMI** In diesem Beispiel werden die Produktcodes für das angegebene AMI beschrieben. Beachten Sie, dass dieses AMI keine Produktcodes hat. Befehl: ``` aws ec2 describe-image-attribute --image-id ami-5731123e --attribute productCodes ``` Ausgabe: ``` { "ProductCodes": [], "ImageId": "ami-5731123e", } ``` + Einzelheiten zur API finden Sie [DescribeImageAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-image-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `describe-images` Das folgende Codebeispiel zeigt die Verwendung`describe-images`. **AWS CLI** **Beispiel 1: So beschreiben Sie eine AMI** Im folgenden Beispiel für `describe-images` wird das angegebene AMI in der angegebenen Region beschrieben. ``` aws ec2 describe-images \ --region us-east-1 \ --image-ids ami-1234567890EXAMPLE ``` Ausgabe: ``` { "Images": [ { "VirtualizationType": "hvm", "Description": "Provided by Red Hat, Inc.", "PlatformDetails": "Red Hat Enterprise Linux", "EnaSupport": true, "Hypervisor": "xen", "State": "available", "SriovNetSupport": "simple", "ImageId": "ami-1234567890EXAMPLE", "UsageOperation": "RunInstances:0010", "BlockDeviceMappings": [ { "DeviceName": "/dev/sda1", "Ebs": { "SnapshotId": "snap-111222333444aaabb", "DeleteOnTermination": true, "VolumeType": "gp2", "VolumeSize": 10, "Encrypted": false } } ], "Architecture": "x86_64", "ImageLocation": "123456789012/RHEL-8.0.0_HVM-20190618-x86_64-1-Hourly2-GP2", "RootDeviceType": "ebs", "OwnerId": "123456789012", "RootDeviceName": "/dev/sda1", "CreationDate": "2019-05-10T13:17:12.000Z", "Public": true, "ImageType": "machine", "Name": "RHEL-8.0.0_HVM-20190618-x86_64-1-Hourly2-GP2" } ] } ``` Weitere Informationen dazu finden Sie unter [Amazon Machine Images (AMI)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: Zur Beschreibung AMIs anhand von Filtern** Das folgende `describe-images` Beispiel beschreibt Windows, das von Amazon AMIs bereitgestellt wird und von Amazon EBS unterstützt wird. ``` aws ec2 describe-images \ --owners amazon \ --filters "Name=platform,Values=windows" "Name=root-device-type,Values=ebs" ``` Ein Beispiel für die Ausgabe von `describe-images` finden Sie in Beispiel 1. Weitere Beispiele für die Verwendung von Filtern finden Sie unter [Auflisten und Filtern Ihrer Ressourcen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Filtering.html#Filtering_Resources_CLI) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 3: Zur Beschreibung auf der AMIs Grundlage von Tags** Das folgende `describe-images` Beispiel beschreibt alle AMIs , die das Tag haben`Type=Custom`. In dem Beispiel wird der `--query` Parameter verwendet, um nur das AMI anzuzeigen IDs. ``` aws ec2 describe-images \ --filters "Name=tag:Type,Values=Custom" \ --query 'Images[*].[ImageId]' \ --output text ``` Ausgabe: ``` ami-1234567890EXAMPLE ami-0abcdef1234567890 ``` Weitere Beispiele für die Verwendung von Tag-Filtern finden Sie unter [Arbeiten mit Tags](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_CLI) im *Amazon-EC2-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-images.html)in der *AWS CLI Befehlsreferenz*. ### `describe-import-image-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-import-image-tasks`. **AWS CLI** **So überwachen Sie eine Aufgabe zum Importieren von Images** Im folgenden Beispiel für `describe-import-image-tasks` wird der Status der angegebenen Image-Importaufgabe überprüft. ``` aws ec2 describe-import-image-tasks \ --import-task-ids import-ami-1234567890abcdef0 ``` Ausgabe für eine Aufgabe zum Importieren eines Image, die gerade ausgeführt wird. ``` { "ImportImageTasks": [ { "ImportTaskId": "import-ami-1234567890abcdef0", "Progress": "28", "SnapshotDetails": [ { "DiskImageSize": 705638400.0, "Format": "ova", "Status": "completed", "UserBucket": { "S3Bucket": "my-import-bucket", "S3Key": "vms/my-server-vm.ova" } } ], "Status": "active", "StatusMessage": "converting" } ] } ``` Ausgabe für eine Aufgabe zum Importieren eines Image, die abgeschlossen ist. Die ID des resultierenden AMI wird von `ImageId` bereitgestellt. ``` { "ImportImageTasks": [ { "ImportTaskId": "import-ami-1234567890abcdef0", "ImageId": "ami-1234567890abcdef0", "SnapshotDetails": [ { "DiskImageSize": 705638400.0, "Format": "ova", "SnapshotId": "snap-1234567890abcdef0" "Status": "completed", "UserBucket": { "S3Bucket": "my-import-bucket", "S3Key": "vms/my-server-vm.ova" } } ], "Status": "completed" } ] } ``` + Einzelheiten zur API finden Sie [DescribeImportImageTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-import-image-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-import-snapshot-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-import-snapshot-tasks`. **AWS CLI** **So überwachen Sie eine Snapshot-Importaufgabe** Im folgenden Beispiel für `describe-import-snapshot-tasks` wird der Status der angegebenen Aufgabe zum Importieren eines Snapshots überprüft. ``` aws ec2 describe-import-snapshot-tasks \ --import-task-ids import-snap-1234567890abcdef0 ``` Ausgabe für eine Aufgabe zum Importieren eines Snapshots, die gerade ausgeführt wird. ``` { "ImportSnapshotTasks": [ { "Description": "My server VMDK", "ImportTaskId": "import-snap-1234567890abcdef0", "SnapshotTaskDetail": { "Description": "My server VMDK", "DiskImageSize": "705638400.0", "Format": "VMDK", "Progress": "42", "Status": "active", "StatusMessage": "downloading/converting", "UserBucket": { "S3Bucket": "my-import-bucket", "S3Key": "vms/my-server-vm.vmdk" } } } ] } ``` Ausgabe für eine Aufgabe zum Importieren eines Snapshots, die abgeschlossen ist. Die ID des resultierenden Snapshots wird von `SnapshotId` bereitgestellt. ``` { "ImportSnapshotTasks": [ { "Description": "My server VMDK", "ImportTaskId": "import-snap-1234567890abcdef0", "SnapshotTaskDetail": { "Description": "My server VMDK", "DiskImageSize": "705638400.0", "Format": "VMDK", "SnapshotId": "snap-1234567890abcdef0" "Status": "completed", "UserBucket": { "S3Bucket": "my-import-bucket", "S3Key": "vms/my-server-vm.vmdk" } } } ] } ``` + Einzelheiten zur API finden Sie [DescribeImportSnapshotTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-import-snapshot-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instance-attribute` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-attribute`. **AWS CLI** **So beschreiben Sie den Instance-Typ** In diesem Beispiel wird der Instance-Typ der angegebenen Instance beschrieben. Befehl: ``` aws ec2 describe-instance-attribute --instance-id i-1234567890abcdef0 --attribute instanceType ``` Ausgabe: ``` { "InstanceId": "i-1234567890abcdef0" "InstanceType": { "Value": "t1.micro" } } ``` **Um das disableApiTermination Attribut zu beschreiben** In diesem Beispiel wird das `disableApiTermination`-Attribut der angegebenen Instance beschrieben. Befehl: ``` aws ec2 describe-instance-attribute --instance-id i-1234567890abcdef0 --attribute disableApiTermination ``` Ausgabe: ``` { "InstanceId": "i-1234567890abcdef0" "DisableApiTermination": { "Value": "false" } } ``` **So beschreiben Sie Blockgerät-Zuweisung für eine Instance** In diesem Beispiel wird das `blockDeviceMapping`-Attribut der angegebenen Instance beschrieben. Befehl: ``` aws ec2 describe-instance-attribute --instance-id i-1234567890abcdef0 --attribute blockDeviceMapping ``` Ausgabe: ``` { "InstanceId": "i-1234567890abcdef0" "BlockDeviceMappings": [ { "DeviceName": "/dev/sda1", "Ebs": { "Status": "attached", "DeleteOnTermination": true, "VolumeId": "vol-049df61146c4d7901", "AttachTime": "2013-05-17T22:42:34.000Z" } }, { "DeviceName": "/dev/sdf", "Ebs": { "Status": "attached", "DeleteOnTermination": false, "VolumeId": "vol-049df61146c4d7901", "AttachTime": "2013-09-10T23:07:00.000Z" } } ], } ``` + Einzelheiten zur API finden Sie [DescribeInstanceAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instance-connect-endpoints` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-connect-endpoints`. **AWS CLI** **So beschreiben Sie einen Endpunkt für EC2-Instance-Verbindungen** Im folgenden Beispiel für `describe-instance-connect-endpoints` wird der angegebene Endpunkt für EC2-Instance-Verbindungen beschrieben. ``` aws ec2 describe-instance-connect-endpoints \ --region us-east-1 \ --instance-connect-endpoint-ids eice-0123456789example ``` Ausgabe: ``` { "InstanceConnectEndpoints": [ { "OwnerId": "111111111111", "InstanceConnectEndpointId": "eice-0123456789example", "InstanceConnectEndpointArn": "arn:aws:ec2:us-east-1:111111111111:instance-connect-endpoint/eice-0123456789example", "State": "create-complete", "StateMessage": "", "DnsName": "eice-0123456789example.b67b86ba.ec2-instance-connect-endpoint.us-east-1.amazonaws.com", "NetworkInterfaceIds": [ "eni-0123456789example" ], "VpcId": "vpc-0123abcd", "AvailabilityZone": "us-east-1d", "CreatedAt": "2023-02-07T12:05:37+00:00", "SubnetId": "subnet-0123abcd", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Endpunkts für EC2-Instance-Verbindungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-ec2-instance-connect-endpoints.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeInstanceConnectEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-connect-endpoints.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instance-credit-specifications` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-credit-specifications`. **AWS CLI** **So beschreiben Sie die Guthaben-Option für die CPU-Nutzung einer oder mehrerer Instances** Im folgenden Beispiel für `describe-instance-credit-specifications` werden die CPU-Guthaben-Option für die angegebene Instance beschrieben. ``` aws ec2 describe-instance-credit-specifications \ --instance-ids i-1234567890abcdef0 ``` Ausgabe: ``` { "InstanceCreditSpecifications": [ { "InstanceId": "i-1234567890abcdef0", "CpuCredits": "unlimited" } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Instances mit Spitzenlastleistung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-how-to.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeInstanceCreditSpecifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-credit-specifications.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instance-event-notification-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-event-notification-attributes`. **AWS CLI** **So beschreiben Sie die Tags für Benachrichtigungen über geplante Ereignisse** Im folgenden Beispiel für `describe-instance-event-notification-attributes` werden die Tags beschrieben, die in Benachrichtigungen über geplante Ereignisse erscheinen sollen. ``` aws ec2 describe-instance-event-notification-attributes ``` Ausgabe: ``` { "InstanceTagAttribute": { "InstanceTagKeys": [], "IncludeAllTagsOfInstance": true } } ``` Weitere Informationen finden Sie unter [Geplante Ereignisse für Ihre Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-instances-status-check_sched.html) im *Benutzerhandbuch für Amazon Elastic Compute Cloud für Linux-Instances*. + Einzelheiten zur API finden Sie [DescribeInstanceEventNotificationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-event-notification-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instance-event-windows` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-event-windows`. **AWS CLI** **Beispiel 1: So beschreiben Sie alle Ereignisfenster** Im folgenden Beispiel für `describe-instance-event-windows` werden alle Ereignisfenster in der angegebenen Region beschrieben. ``` aws ec2 describe-instance-event-windows \ --region us-east-1 ``` Ausgabe: ``` { "InstanceEventWindows": [ { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [ "i-1234567890abcdef0", "i-0598c7d356eba48d7" ], "Tags": [], "DedicatedHostIds": [] }, "State": "active", "Tags": [] } ... ], "NextToken": "9d624e0c-388b-4862-a31e-a85c64fc1d4a" } ``` **Beispiel 2: So beschreiben Sie ein bestimmtes Ereignisfenster** Im folgenden Beispiel für `describe-instance-event-windows` wird ein spezifisches Ereignis beschrieben, indem der Parameter `instance-event-window` verwendet wird, um ein bestimmtes Ereignisfenster zu beschreiben. ``` aws ec2 describe-instance-event-windows \ --region us-east-1 \ --instance-event-window-ids iew-0abcdef1234567890 ``` Ausgabe: ``` { "InstanceEventWindows": [ { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [ "i-1234567890abcdef0", "i-0598c7d356eba48d7" ], "Tags": [], "DedicatedHostIds": [] }, "State": "active", "Tags": [] } } ``` **Beispiel 3: So beschreiben Sie Ereignisfenster, die einem oder mehreren Filtern entsprechen** Im folgenden Beispiel für `describe-instance-event-windows` werden Ereignisfenster, die mit einem oder mehreren Filtern übereinstimmen, mit dem Parameter `filter` beschrieben. Der `instance-id`-Filter wird verwendet, um alle Ereignisfenster zu beschreiben, die der angegebenen Instance zugeordnet sind. Wenn ein Filter verwendet wird, führt er eine direkte Übereinstimmung durch. Der `instance-id`-Filter ist jedoch anders. Wenn es keine direkte Übereinstimmung mit der Instance-ID gibt, wird auf indirekte Verknüpfungen mit dem Ereignisfenster zurückgegriffen, wie z. B. die Tags der Instance oder die Dedicated-Host-ID (wenn es sich bei der Instance um einen Dedicated Host handelt). ``` aws ec2 describe-instance-event-windows \ --region us-east-1 \ --filters Name=instance-id,Values=i-1234567890abcdef0 \ --max-results 100 \ --next-token ``` Ausgabe: ``` { "InstanceEventWindows": [ { "InstanceEventWindowId": "iew-0dbc0adb66f235982", "TimeRanges": [ { "StartWeekDay": "sunday", "StartHour": 2, "EndWeekDay": "sunday", "EndHour": 8 } ], "Name": "myEventWindowName", "AssociationTarget": { "InstanceIds": [], "Tags": [], "DedicatedHostIds": [ "h-0140d9a7ecbd102dd" ] }, "State": "active", "Tags": [] } ] } ``` In der Beispielausgabe befindet sich die Instance auf einem Dedicated Host, der dem Ereignisfenster zugeordnet ist. Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeInstanceEventWindows](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-event-windows.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instance-image-metadata` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-image-metadata`. **AWS CLI** **Beispiel 1: So beschreiben Sie die AMI-Metadaten für alle Instances** Das folgende `describe-instance-image-metadata` Beispiel beschreibt die AMI-Metadaten aller Instances in Ihrem AWS Konto in der angegebenen Region. ``` aws ec2 describe-instance-image-metadata \ --region us-east-1 ``` Ausgabe: ``` { "InstanceImageMetadata": [ { "InstanceId": "i-1234567890EXAMPLE", "InstanceType": "t2.micro", "LaunchTime": "2024-08-28T11:25:45+00:00", "AvailabilityZone": "us-east-1a", "State": { "Code": 16, "Name": "running" }, "OwnerId": "123412341234", "Tags": [ { "Key": "MyTagName", "Value": "my-tag-value" } ], "ImageMetadata": { "ImageId": "ami-0b752bf1df193a6c4", "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64", "OwnerId": "137112412989", "State": "available", "ImageOwnerAlias": "amazon", "CreationDate": "2023-01-25T17:20:40Z", "DeprecationTime": "2025-01-25T17:20:40Z", "IsPublic": true } } ], "NextToken": "...EXAMPLEwIAABAA2JHaFxLnEXAMPLE..." } ``` Weitere Informationen dazu finden Sie unter [Amazon Machine Images in Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So beschreiben Sie die AMI-Metadaten für die angegebenen Instances** Im folgenden Beispiel für `describe-instance-image-metadata` werden die AMI-Metadaten für die angegebenen Instances beschrieben. ``` aws ec2 describe-instance-image-metadata \ --region us-east-1 \ --instance-ids i-1234567890EXAMPLE i-0987654321EXAMPLE ``` Ausgabe: ``` { "InstanceImageMetadata": [ { "InstanceId": "i-1234567890EXAMPLE", "InstanceType": "t2.micro", "LaunchTime": "2024-08-28T11:25:45+00:00", "AvailabilityZone": "us-east-1a", "State": { "Code": 16, "Name": "running" }, "OwnerId": "123412341234", "Tags": [ { "Key": "MyTagName", "Value": "my-tag-value" } ], "ImageMetadata": { "ImageId": "ami-0b752bf1df193a6c4", "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64", "OwnerId": "137112412989", "State": "available", "ImageOwnerAlias": "amazon", "CreationDate": "2023-01-25T17:20:40Z", "DeprecationTime": "2025-01-25T17:20:40Z", "IsPublic": true } }, { "InstanceId": "i-0987654321EXAMPLE", "InstanceType": "t2.micro", "LaunchTime": "2024-08-28T11:25:45+00:00", "AvailabilityZone": "us-east-1a", "State": { "Code": 16, "Name": "running" }, "OwnerId": "123412341234", "Tags": [ { "Key": "MyTagName", "Value": "my-tag-value" } ], "ImageMetadata": { "ImageId": "ami-0b752bf1df193a6c4", "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64", "OwnerId": "137112412989", "State": "available", "ImageOwnerAlias": "amazon", "CreationDate": "2023-01-25T17:20:40Z", "DeprecationTime": "2025-01-25T17:20:40Z", "IsPublic": true } } ] } ``` Weitere Informationen dazu finden Sie unter [Amazon Machine Images in Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 3: So beschreiben Sie die AMI-Metadaten für Instances basierend auf Filtern** Im folgenden Beispiel für `describe-instance-image-metadata` werden die AMI-Metadaten für `t2.nano`- und `t2.micro`-Instances in der Availability Zone `us-east-1a` beschrieben. ``` aws ec2 describe-instance-image-metadata \ --region us-east-1 \ --filters Name=availability-zone,Values=us-east-1a Name=instance-type,Values=t2.nano,t2.micro ``` Ausgabe: ``` { "InstanceImageMetadata": [ { "InstanceId": "i-1234567890EXAMPLE", "InstanceType": "t2.micro", "LaunchTime": "2024-08-28T11:25:45+00:00", "AvailabilityZone": "us-east-1a", "State": { "Code": 16, "Name": "running" }, "OwnerId": "123412341234", "Tags": [ { "Key": "MyTagName", "Value": "my-tag-value" } ], "ImageMetadata": { "ImageId": "ami-0b752bf1df193a6c4", "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64", "OwnerId": "137112412989", "State": "available", "ImageOwnerAlias": "amazon", "CreationDate": "2023-01-25T17:20:40Z", "DeprecationTime": "2025-01-25T17:20:40Z", "IsPublic": true } }, { "InstanceId": "i-0987654321EXAMPLE", "InstanceType": "t2.micro", "LaunchTime": "2024-08-28T11:25:45+00:00", "AvailabilityZone": "us-east-1a", "State": { "Code": 16, "Name": "running" }, "OwnerId": "123412341234", "Tags": [ { "Key": "MyTagName", "Value": "my-tag-value" } ], "ImageMetadata": { "ImageId": "ami-0b752bf1df193a6c4", "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64", "OwnerId": "137112412989", "State": "available", "ImageOwnerAlias": "amazon", "CreationDate": "2023-01-25T17:20:40Z", "DeprecationTime": "2025-01-25T17:20:40Z", "IsPublic": true } } ], "NextToken": "...EXAMPLEV7ixRYHwIAABAA2JHaFxLnDAzpatfEXAMPLE..." } ``` Weitere Informationen dazu finden Sie unter [Amazon Machine Images in Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeInstanceImageMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-image-metadata.html)unter *AWS CLI Befehlsreferenz*. ### `describe-instance-status` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-status`. **AWS CLI** **So beschreiben Sie den Status einer Instance** Das folgende `describe-instance-status`-Beispiel beschreibt den aktuellen Status der angegebenen Instance. ``` aws ec2 describe-instance-status \ --instance-ids i-1234567890abcdef0 ``` Ausgabe: ``` { "InstanceStatuses": [ { "InstanceId": "i-1234567890abcdef0", "InstanceState": { "Code": 16, "Name": "running" }, "AvailabilityZone": "us-east-1d", "SystemStatus": { "Status": "ok", "Details": [ { "Status": "passed", "Name": "reachability" } ] }, "InstanceStatus": { "Status": "ok", "Details": [ { "Status": "passed", "Name": "reachability" } ] } } ] } ``` Weitere Informationen finden Sie unter [Den Status Ihrer Instances überwachen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-instances-status-check.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeInstanceStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-status.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instance-topology` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-topology`. **AWS CLI** **So beschreiben Sie die Instance-Topologie all Ihrer Instances** Im folgenden Beispiel für `describe-instance-topology` wird die Topologie all Ihrer Instances beschrieben, die den unterstützten Instance-Typen für diesen Befehl entsprechen. ``` aws ec2 describe-instance-topology \ --region us-west-2 ``` Ausgabe: ``` { "Instances": [ { "InstanceId": "i-1111111111example", "InstanceType": "p4d.24xlarge", "GroupName": "my-ml-cpg", "NetworkNodes": [ "nn-1111111111example", "nn-2222222222example", "nn-3333333333example" ], "ZoneId": "usw2-az2", "AvailabilityZone": "us-west-2a" }, { "InstanceId": "i-2222222222example", "InstanceType": "p4d.24xlarge", "NetworkNodes": [ "nn-1111111111example", "nn-2222222222example", "nn-3333333333example" ], "ZoneId": "usw2-az2", "AvailabilityZone": "us-west-2a" }, { "InstanceId": "i-3333333333example", "InstanceType": "trn1.32xlarge", "NetworkNodes": [ "nn-1212121212example", "nn-1211122211example", "nn-1311133311example" ], "ZoneId": "usw2-az4", "AvailabilityZone": "us-west-2d" }, { "InstanceId": "i-444444444example", "InstanceType": "trn1.2xlarge", "NetworkNodes": [ "nn-1111111111example", "nn-5434334334example", "nn-1235301234example" ], "ZoneId": "usw2-az2", "AvailabilityZone": "us-west-2a" } ], "NextToken": "SomeEncryptedToken" } ``` Weitere Informationen, einschließlich weiterer Beispiele, finden Sie unter [Topologie von Amazon-EC2-Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-topology.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeInstanceTopology](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-topology.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instance-type-offerings` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-type-offerings`. **AWS CLI** **Beispiel 1: So listen Sie die in einer Region angebotenen Instance-Typen auf** Das folgende `describe-instance-type-offerings` Beispiel listet die Instanztypen auf, die in der Region angeboten werden, die als Standardregion für die AWS CLI konfiguriert ist. ``` aws ec2 describe-instance-type-offerings ``` Zum Auflisten der Instance-Typen, die in einer anderen Region angeboten werden, geben Sie die Region mithilfe des `--region`-Parameters an. ``` aws ec2 describe-instance-type-offerings \ --region us-east-2 ``` Ausgabe: ``` { "InstanceTypeOfferings": [ { "InstanceType": "m5.2xlarge", "LocationType": "region", "Location": "us-east-2" }, { "InstanceType": "t3.micro", "LocationType": "region", "Location": "us-east-2" }, ... ] } ``` **Beispiel 2: So listen Sie die in einer Availability Zone angebotenen Instance-Typen auf** Im folgenden Beispiel für `describe-instance-type-offerings` werden die Instance-Typen aufgelistet, die in der angegebenen Availability Zone angeboten werden. Die Availability Zone muss sich in der angegebenen Region befinden. ``` aws ec2 describe-instance-type-offerings \ --location-type availability-zone \ --filters Name=location,Values=us-east-2a \ --region us-east-2 ``` **Beispiel 3: So überprüfen Sie, ob ein Instance-Typ unterstützt wird** Der folgende `describe-instance-type-offerings`-Befehl gibt an, ob der Instance-Typ `c5.xlarge` in der angegebenen Region unterstützt wird. ``` aws ec2 describe-instance-type-offerings \ --filters Name=instance-type,Values=c5.xlarge \ --region us-east-2 ``` Im folgenden Beispiel für `describe-instance-type-offerings` werden alle C5-Instance-Typen aufgelistet, die in der angegebenen Region unterstützt werden. ``` aws ec2 describe-instance-type-offerings \ --filters Name=instance-type,Values=c5* \ --query "InstanceTypeOfferings[].InstanceType" \ --region us-east-2 ``` Ausgabe: ``` [ "c5d.12xlarge", "c5d.9xlarge", "c5n.xlarge", "c5.xlarge", "c5d.metal", "c5n.metal", "c5.large", "c5d.2xlarge", "c5n.4xlarge", "c5.2xlarge", "c5n.large", "c5n.9xlarge", "c5d.large", "c5.18xlarge", "c5d.18xlarge", "c5.12xlarge", "c5n.18xlarge", "c5.metal", "c5d.4xlarge", "c5.24xlarge", "c5d.xlarge", "c5n.2xlarge", "c5d.24xlarge", "c5.9xlarge", "c5.4xlarge" ] ``` + Einzelheiten zur API finden Sie [DescribeInstanceTypeOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-type-offerings.html)unter *AWS CLI Befehlsreferenz*. ### `describe-instance-types` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-types`. **AWS CLI** **Beispiel 1: So beschreiben Sie einen Instance-Typ** Im folgenden Beispiel für `describe-instance-types` werden die Details für den angegebenen Instance-Typ angezeigt. ``` aws ec2 describe-instance-types \ --instance-types t2.micro ``` Ausgabe: ``` { "InstanceTypes": [ { "InstanceType": "t2.micro", "CurrentGeneration": true, "FreeTierEligible": true, "SupportedUsageClasses": [ "on-demand", "spot" ], "SupportedRootDeviceTypes": [ "ebs" ], "BareMetal": false, "Hypervisor": "xen", "ProcessorInfo": { "SupportedArchitectures": [ "i386", "x86_64" ], "SustainedClockSpeedInGhz": 2.5 }, "VCpuInfo": { "DefaultVCpus": 1, "DefaultCores": 1, "DefaultThreadsPerCore": 1, "ValidCores": [ 1 ], "ValidThreadsPerCore": [ 1 ] }, "MemoryInfo": { "SizeInMiB": 1024 }, "InstanceStorageSupported": false, "EbsInfo": { "EbsOptimizedSupport": "unsupported", "EncryptionSupport": "supported" }, "NetworkInfo": { "NetworkPerformance": "Low to Moderate", "MaximumNetworkInterfaces": 2, "Ipv4AddressesPerInterface": 2, "Ipv6AddressesPerInterface": 2, "Ipv6Supported": true, "EnaSupport": "unsupported" }, "PlacementGroupInfo": { "SupportedStrategies": [ "partition", "spread" ] }, "HibernationSupported": false, "BurstablePerformanceSupported": true, "DedicatedHostsSupported": false, "AutoRecoverySupported": true } ] } ``` Weitere Informationen finden Sie unter [Instance-Typen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) im *Benutzerhandbuch zu Amazon Elastic Compute Cloud für Linux-Instances*. **Beispiel 2: So filtern Sie die verfügbaren Instance-Typen** Sie können einen Filter angeben, um die Ergebnisse auf Instance-Typen mit einem bestimmten Merkmal zu beschränken. Im folgenden Beispiel für `describe-instance-types` werden die Instance-Typen aufgeführt, die den Ruhezustand unterstützen. ``` aws ec2 describe-instance-types \ --filters Name=hibernation-supported,Values=true --query 'InstanceTypes[*].InstanceType' ``` Ausgabe: ``` [ "m5.8xlarge", "r3.large", "c3.8xlarge", "r5.large", "m4.4xlarge", "c4.large", "m5.xlarge", "m4.xlarge", "c3.large", "c4.8xlarge", "c4.4xlarge", "c5.xlarge", "c5.12xlarge", "r5.4xlarge", "c5.4xlarge" ] ``` Weitere Informationen finden Sie unter [Instance-Typen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) im *Benutzerhandbuch zu Amazon Elastic Compute Cloud für Linux-Instances*. + Einzelheiten zur API finden Sie [DescribeInstanceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instance-types.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-instances`. **AWS CLI** **Beispiel 1: So beschreiben Sie eine Instance** Das folgende Beispiel für `describe-instances` beschreibt die angegebene Instance. ``` aws ec2 describe-instances \ --instance-ids i-1234567890abcdef0 ``` Ausgabe: ``` { "Reservations": [ { "Groups": [], "Instances": [ { "AmiLaunchIndex": 0, "ImageId": "ami-0abcdef1234567890", "InstanceId": "i-1234567890abcdef0", "InstanceType": "t3.nano", "KeyName": "my-key-pair", "LaunchTime": "2022-11-15T10:48:59+00:00", "Monitoring": { "State": "disabled" }, "Placement": { "AvailabilityZone": "us-east-2a", "GroupName": "", "Tenancy": "default" }, "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal", "PrivateIpAddress": "10-0-0-157", "ProductCodes": [], "PublicDnsName": "ec2-34-253-223-13.us-east-2.compute.amazonaws.com", "PublicIpAddress": "34.253.223.13", "State": { "Code": 16, "Name": "running" }, "StateTransitionReason": "", "SubnetId": "subnet-04a636d18e83cfacb", "VpcId": "vpc-1234567890abcdef0", "Architecture": "x86_64", "BlockDeviceMappings": [ { "DeviceName": "/dev/xvda", "Ebs": { "AttachTime": "2022-11-15T10:49:00+00:00", "DeleteOnTermination": true, "Status": "attached", "VolumeId": "vol-02e6ccdca7de29cf2" } } ], "ClientToken": "1234abcd-1234-abcd-1234-d46a8903e9bc", "EbsOptimized": true, "EnaSupport": true, "Hypervisor": "xen", "IamInstanceProfile": { "Arn": "arn:aws:iam::111111111111:instance-profile/AmazonSSMRoleForInstancesQuickSetup", "Id": "111111111111111111111" }, "NetworkInterfaces": [ { "Association": { "IpOwnerId": "amazon", "PublicDnsName": "ec2-34-253-223-13.us-east-2.compute.amazonaws.com", "PublicIp": "34.253.223.13" }, "Attachment": { "AttachTime": "2022-11-15T10:48:59+00:00", "AttachmentId": "eni-attach-1234567890abcdefg", "DeleteOnTermination": true, "DeviceIndex": 0, "Status": "attached", "NetworkCardIndex": 0 }, "Description": "", "Groups": [ { "GroupName": "launch-wizard-146", "GroupId": "sg-1234567890abcdefg" } ], "Ipv6Addresses": [], "MacAddress": "00:11:22:33:44:55", "NetworkInterfaceId": "eni-1234567890abcdefg", "OwnerId": "104024344472", "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal", "PrivateIpAddress": "10-0-0-157", "PrivateIpAddresses": [ { "Association": { "IpOwnerId": "amazon", "PublicDnsName": "ec2-34-253-223-13.us-east-2.compute.amazonaws.com", "PublicIp": "34.253.223.13" }, "Primary": true, "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal", "PrivateIpAddress": "10-0-0-157" } ], "SourceDestCheck": true, "Status": "in-use", "SubnetId": "subnet-1234567890abcdefg", "VpcId": "vpc-1234567890abcdefg", "InterfaceType": "interface" } ], "RootDeviceName": "/dev/xvda", "RootDeviceType": "ebs", "SecurityGroups": [ { "GroupName": "launch-wizard-146", "GroupId": "sg-1234567890abcdefg" } ], "SourceDestCheck": true, "Tags": [ { "Key": "Name", "Value": "my-instance" } ], "VirtualizationType": "hvm", "CpuOptions": { "CoreCount": 1, "ThreadsPerCore": 2 }, "CapacityReservationSpecification": { "CapacityReservationPreference": "open" }, "HibernationOptions": { "Configured": false }, "MetadataOptions": { "State": "applied", "HttpTokens": "optional", "HttpPutResponseHopLimit": 1, "HttpEndpoint": "enabled", "HttpProtocolIpv6": "disabled", "InstanceMetadataTags": "enabled" }, "EnclaveOptions": { "Enabled": false }, "PlatformDetails": "Linux/UNIX", "UsageOperation": "RunInstances", "UsageOperationUpdateTime": "2022-11-15T10:48:59+00:00", "PrivateDnsNameOptions": { "HostnameType": "ip-name", "EnableResourceNameDnsARecord": true, "EnableResourceNameDnsAAAARecord": false }, "MaintenanceOptions": { "AutoRecovery": "default" } } ], "OwnerId": "111111111111", "ReservationId": "r-1234567890abcdefg" } ] } ``` **Beispiel 2: So filtern Sie nach Instances mit dem angegebenen Typ** Im folgenden Beispiel für `describe-instances` werden Filter verwendet, um die Ergebnisse auf Instances des angegebenen Typs zu beschränken. ``` aws ec2 describe-instances \ --filters Name=instance-type,Values=m5.large ``` Ein Beispiel für eine Ausgabe finden Sie in Beispiel 1. Weitere Informationen finden Sie unter [Mit der CLI auflisten und filtern](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Filtering.html#Filtering_Resources_CLI) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 3: So filtern Sie nach Instances mit dem angegebenen Typ und der angegebenen Availability Zone** Im folgenden Beispiel für `describe-instances` werden mehrere Filter verwendet, um die Ergebnisse auf Instances mit dem angegebenen Typ zu beschränken, die sich ebenfalls in der angegebenen Availability Zone befinden. ``` aws ec2 describe-instances \ --filters Name=instance-type,Values=t2.micro,t3.micro Name=availability-zone,Values=us-east-2c ``` Ein Beispiel für eine Ausgabe finden Sie in Beispiel 1. **Beispiel 4: So filtern Sie mithilfe einer JSON-Datei nach Instances mit dem angegebenen Typ und der angegebenen Availability Zone** Das folgende `describe-instances`-Beispiel verwendet eine JSON-Eingabedatei, um dieselbe Filterung wie im vorherigen Beispiel durchzuführen. Wenn Filter komplizierter werden, können sie einfacher in einer JSON-Datei angegeben werden. ``` aws ec2 describe-instances \ --filters file://filters.json ``` Inhalt von `filters.json`: ``` [ { "Name": "instance-type", "Values": ["t2.micro", "t3.micro"] }, { "Name": "availability-zone", "Values": ["us-east-2c"] } ] ``` Ein Beispiel für eine Ausgabe finden Sie in Beispiel 1. **Beispiel 5: So filtern Sie nach Instances mit dem angegebenen Owner-Tag** Im folgenden Beispiel für `describe-instances` werden Tag-Filter verwendet, um die Ergebnisse unabhängig vom Tag-Wert auf Instances zu beschränken, die über ein Tag mit dem angegebenen Tag-Schlüssel (Owner) verfügen. ``` aws ec2 describe-instances \ --filters "Name=tag-key,Values=Owner" ``` Ein Beispiel für eine Ausgabe finden Sie in Beispiel 1. **Beispiel 6: So filtern Sie nach Instances mit dem angegebenen my-team-Tag-Wert** Im folgenden Beispiel für `describe-instances` werden Tag-Filter verwendet, um die Ergebnisse auf Instances zu beschränken, die ein Tag mit dem angegebenen Tag-Wert (my-team) haben, unabhängig vom Tag-Schlüssel. ``` aws ec2 describe-instances \ --filters "Name=tag-value,Values=my-team" ``` Ein Beispiel für eine Ausgabe finden Sie in Beispiel 1. **Beispiel 7: So filtern Sie nach Instances mit dem angegebenen Besitzer-Tag und my-team-Wert** Im folgenden Beispiel für `describe-instances` werden Tag-Filter verwendet, um die Ergebnisse auf Instances zu beschränken, die das angegebene Tag haben (Besitzer=my-team). ``` aws ec2 describe-instances \ --filters "Name=tag:Owner,Values=my-team" ``` Ein Beispiel für eine Ausgabe finden Sie in Beispiel 1. **Beispiel 8: Um nur Instance und Subnetz IDs für alle Instances anzuzeigen** In den folgenden `describe-instances` Beispielen `--query` wird der Parameter verwendet, um nur die Instanz und das Subnetz IDs für alle Instanzen im JSON-Format anzuzeigen. Linux und macOS: ``` aws ec2 describe-instances \ --query 'Reservations[*].Instances[*].{Instance:InstanceId,Subnet:SubnetId}' \ --output json ``` Windows: ``` aws ec2 describe-instances ^ --query "Reservations[*].Instances[*].{Instance:InstanceId,Subnet:SubnetId}" ^ --output json ``` Ausgabe: ``` [ { "Instance": "i-057750d42936e468a", "Subnet": "subnet-069beee9b12030077" }, { "Instance": "i-001efd250faaa6ffa", "Subnet": "subnet-0b715c6b7db68927a" }, { "Instance": "i-027552a73f021f3bd", "Subnet": "subnet-0250c25a1f4e15235" } ... ] ``` **Beispiel 9: Um Instanzen des angegebenen Typs zu filtern und nur ihre Instanz anzuzeigen IDs** Im folgenden `describe-instances` Beispiel werden Filter verwendet, um die Ergebnisse auf Instanzen des angegebenen Typs zu beschränken, und der `--query` Parameter verwendet, um nur die Instanz anzuzeigen IDs. ``` aws ec2 describe-instances \ --filters "Name=instance-type,Values=t2.micro" \ --query "Reservations[*].Instances[*].[InstanceId]" \ --output text ``` Ausgabe: ``` i-031c0dc19de2fb70c i-00d8bff789a736b75 i-0b715c6b7db68927a i-0626d4edd54f1286d i-00b8ae04f9f99908e i-0fc71c25d2374130c ``` **Beispiel 10: Um Instances des angegebenen Typs zu filtern und nur ihre Instanz IDs, Availability Zone und den angegebenen Tag-Wert anzuzeigen** In den folgenden `describe-instances`-Beispielen werden die Instance-ID, die Availability Zone und der Wert des `Name`-Tags für Instances, die ein Tag mit dem Namen `tag-key` haben, im Tabellenformat angezeigt. Linux und macOS: ``` aws ec2 describe-instances \ --filters Name=tag-key,Values=Name \ --query 'Reservations[*].Instances[*].{Instance:InstanceId,AZ:Placement.AvailabilityZone,Name:Tags[?Key==`Name`]|[0].Value}' \ --output table ``` Windows: ``` aws ec2 describe-instances ^ --filters Name=tag-key,Values=Name ^ --query "Reservations[*].Instances[*].{Instance:InstanceId,AZ:Placement.AvailabilityZone,Name:Tags[?Key=='Name']|[0].Value}" ^ --output table ``` Ausgabe: ``` ------------------------------------------------------------- | DescribeInstances | +--------------+-----------------------+--------------------+ | AZ | Instance | Name | +--------------+-----------------------+--------------------+ | us-east-2b | i-057750d42936e468a | my-prod-server | | us-east-2a | i-001efd250faaa6ffa | test-server-1 | | us-east-2a | i-027552a73f021f3bd | test-server-2 | +--------------+-----------------------+--------------------+ ``` **Beispiel 11: So beschreiben Sie Instances in einer Partition-Placement-Gruppe** Das folgende `describe-instances`-Beispiel beschreibt die angegebene Instance. Die Ausgabe enthält die Platzierungsinformationen für die Instance, die den Namen der Platzierungsgruppe und die Partitionsnummer für die Instance enthalten. ``` aws ec2 describe-instances \ --instance-ids i-0123a456700123456 \ --query "Reservations[*].Instances[*].Placement" ``` Ausgabe: ``` [ [ { "AvailabilityZone": "us-east-1c", "GroupName": "HDFS-Group-A", "PartitionNumber": 3, "Tenancy": "default" } ] ] ``` Weitere Informationen finden Sie unter [Beschreiben von Instances in einer Platzierungsgruppe](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html#describe-instance-placement) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 12: So filtern Sie auf Instances mit der angegebenen Platzierungsgruppe und Partitionsnummer** Im folgenden Beispiel für `describe-instances` werden die Ergebnisse nur nach den Instances mit der angegebenen Platzierungsgruppe und Partitionsnummer gefiltert. ``` aws ec2 describe-instances \ --filters "Name=placement-group-name,Values=HDFS-Group-A" "Name=placement-partition-number,Values=7" ``` Im Folgenden werden nur die relevanten Informationen aus der Ausgabe angezeigt. ``` "Instances": [ { "InstanceId": "i-0123a456700123456", "InstanceType": "r4.large", "Placement": { "AvailabilityZone": "us-east-1c", "GroupName": "HDFS-Group-A", "PartitionNumber": 7, "Tenancy": "default" } }, { "InstanceId": "i-9876a543210987654", "InstanceType": "r4.large", "Placement": { "AvailabilityZone": "us-east-1c", "GroupName": "HDFS-Group-A", "PartitionNumber": 7, "Tenancy": "default" } ], ``` Weitere Informationen finden Sie unter [Beschreiben von Instances in einer Platzierungsgruppe](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html#describe-instance-placement) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 13: So filtern Sie nach Instances, die so konfiguriert sind, dass sie den Zugriff auf Tags aus Instance-Metadaten erlauben** Im folgenden Beispiel für `describe-instances` werden die Ergebnisse nur nach den Instances gefiltert, die so konfiguriert sind, dass sie den Zugriff auf Instance-Tags aus den Instance-Metadaten ermöglichen. ``` aws ec2 describe-instances \ --filters "Name=metadata-options.instance-metadata-tags,Values=enabled" \ --query "Reservations[*].Instances[*].InstanceId" \ --output text ``` Im Folgenden wird die erwartete Ausgabe dargestellt. ``` i-1234567890abcdefg i-abcdefg1234567890 i-11111111aaaaaaaaa i-aaaaaaaa111111111 ``` Weitere Informationen finden Sie unter [Mit Instance-Tags in Instance-Metadaten arbeiten](https://docs.aws.amazon.com/en_us/AWSEC2/latest/UserGuide/Using_Tags.html#view-access-to-tags-in-IMDS) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instances.html)in der *AWS CLI Befehlsreferenz*. ### `describe-internet-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-internet-gateways`. **AWS CLI** **So beschreiben Sie ein Internet-Gateway** Im folgenden Beispiel für `describe-internet-gateways` wird das angegebene Internet-Gateway beschrieben. ``` aws ec2 describe-internet-gateways \ --internet-gateway-ids igw-0d0fb496b3EXAMPLE ``` Ausgabe: ``` { "InternetGateways": [ { "Attachments": [ { "State": "available", "VpcId": "vpc-0a60eb65b4EXAMPLE" } ], "InternetGatewayId": "igw-0d0fb496b3EXAMPLE", "OwnerId": "123456789012", "Tags": [ { "Key": "Name", "Value": "my-igw" } ] } ] } ``` Weitere Informationen finden Sie unter [Internet-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DescribeInternetGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-internet-gateways.html)in der *AWS CLI Befehlsreferenz*. ### `describe-ipam-pools` Das folgende Codebeispiel zeigt die Verwendung`describe-ipam-pools`. **AWS CLI** **So zeigen Sie die Details für einen IPAM-Pool an** Das folgende Beispiel für `describe-ipam-pools` zeigt die Details für Pools an. (Linux) ``` aws ec2 describe-ipam-pools \ --filters Name=owner-id,Values=123456789012 Name=ipam-scope-id,Values=ipam-scope-02fc38cd4c48e7d38 ``` (Windows) ``` aws ec2 describe-ipam-pools ^ --filters Name=owner-id,Values=123456789012 Name=ipam-scope-id,Values=ipam-scope-02fc38cd4c48e7d38 ``` Ausgabe: ``` { "IpamPools": [ { "OwnerId": "123456789012", "IpamPoolId": "ipam-pool-02ec043a19bbe5d08", "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-02ec043a19bbe5d08", "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-02fc38cd4c48e7d38", "IpamScopeType": "private", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "Locale": "None", "PoolDepth": 1, "State": "create-complete", "AutoImport": true, "AddressFamily": "ipv4", "AllocationMinNetmaskLength": 16, "AllocationMaxNetmaskLength": 26, "AllocationDefaultNetmaskLength": 24, "AllocationResourceTags": [ { "Key": "Environment", "Value": "Preprod" } ], "Tags": [ { "Key": "Name", "Value": "Preprod pool" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeIpamPools](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-ipam-pools.html)in der *AWS CLI Befehlsreferenz*. ### `describe-ipam-resource-discoveries` Das folgende Codebeispiel zeigt die Verwendung`describe-ipam-resource-discoveries`. **AWS CLI** **Beispiel 1: So zeigen Sie vollständige Details zu Ressourcenentdeckungen an** In diesem Beispiel sind Sie ein delegierter IPAM-Administrator, der eine Ressourcenerkennung erstellen und mit dem IPAM-Administrator in einer anderen AWS Organisation teilen möchte, damit der Administrator die IP-Adressen der Ressourcen in Ihrer Organisation verwalten und überwachen kann. Dieses Beispiel kann in folgenden Fällen nützlich sein: Sie haben versucht, eine Ressourcenerkennung zu erstellen, aber die Fehlermeldung erhalten, dass Sie Ihr Limit von 1 erreicht haben. Sie stellen fest, dass Sie möglicherweise bereits eine Ressourcenerkennung erstellt haben, und möchten diese in Ihrem Konto anzeigen. Sie haben Ressourcen in einer Region, die nicht vom IPAM erkannt werden. Sie möchten die für die Ressource definierten `--operating-regions` einsehen und sicherstellen, dass Sie die richtige Region als Betriebsregion hinzugefügt haben, damit die Ressourcen dort erkannt werden können. Das folgende `describe-ipam-resource-discoveries` Beispiel listet die Details der Ressourcenerkennung in Ihrem Konto auf. AWS Sie können eine Ressourcenerkennung pro AWS Region durchführen. ``` aws ec2 describe-ipam-resource-discoveries \ --region us-east-1 ``` Ausgabe: ``` { "IpamResourceDiscoveries": [ { "OwnerId": "149977607591", "IpamResourceDiscoveryId": "ipam-res-disco-0f8bdee9067137c0d", "IpamResourceDiscoveryArn": "arn:aws:ec2::149977607591:ipam-resource-discovery/ipam-res-disco-0f8bdee9067137c0d", "IpamResourceDiscoveryRegion": "us-east-1", "OperatingRegions": [ { "RegionName": "us-east-1" } ], "IsDefault": false, "State": "create-complete", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Integrieren von IPAM mit Konten außerhalb Ihrer Organisation](https://docs.aws.amazon.com/vpc/latest/ipam/enable-integ-ipam-outside-org.html) im *Benutzerhandbuch für Amazon VPC IPAM*. **Beispiel 2: Nur die Ressourcensuche anzeigen IDs** Im folgenden `describe-ipam-resource-discoveries` Beispiel wird die ID der Ressourcenerkennung in Ihrem AWS Konto aufgeführt. Sie können pro AWS Region eine Ressourcenerkennung durchführen. ``` aws ec2 describe-ipam-resource-discoveries \ --query "IpamResourceDiscoveries[*].IpamResourceDiscoveryId" \ --output text ``` Ausgabe: ``` ipam-res-disco-0481e39b242860333 ``` Weitere Informationen finden Sie unter [Integrieren von IPAM mit Konten außerhalb Ihrer Organisation](https://docs.aws.amazon.com/vpc/latest/ipam/enable-integ-ipam-outside-org.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [DescribeIpamResourceDiscoveries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-ipam-resource-discoveries.html)in der *AWS CLI Befehlsreferenz*. ### `describe-ipam-resource-discovery-associations` Das folgende Codebeispiel zeigt die Verwendung`describe-ipam-resource-discovery-associations`. **AWS CLI** **So zeigen Sie alle Ressourcenerkennungszuordnungen für Ihren IPAM an** In diesem Beispiel sind Sie ein delegierter IPAM-Administrator, der Ressourcenerkennungen mit Ihrem IPAM verknüpft hat, um andere Konten in Ihren IPAM zu integrieren. Sie haben festgestellt, dass Ihr IPAM die Ressourcen in den Betriebsregionen der Ressourcenerkennung nicht wie erwartet erkennt. Sie möchten den Status und den Zustand der Ressourcenerkennung überprüfen, um sicherzustellen, dass das Konto, mit dem sie erstellt wurde, immer noch aktiv ist und die Ressourcenerkennung weiterhin gemeinsam genutzt wird. Die `--region` muss die Heimatregion Ihres IPAM sein. Das folgende `describe-ipam-resource-discovery-associations` Beispiel listet die Ressourcenerkennungszuordnungen in Ihrem AWS Konto auf. ``` aws ec2 describe-ipam-resource-discovery-associations \ --region us-east-1 ``` Ausgabe: ``` { "IpamResourceDiscoveryAssociations": [ { "OwnerId": "320805250157", "IpamResourceDiscoveryAssociationId": "ipam-res-disco-assoc-05e6b45eca5bf5cf7", "IpamResourceDiscoveryAssociationArn": "arn:aws:ec2::320805250157:ipam-resource-discovery-association/ipam-res-disco-assoc-05e6b45eca5bf5cf7", "IpamResourceDiscoveryId": "ipam-res-disco-0f4ef577a9f37a162", "IpamId": "ipam-005f921c17ebd5107", "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107", "IpamRegion": "us-east-1", "IsDefault": true, "ResourceDiscoveryStatus": "active", "State": "associate-complete", "Tags": [] }, { "OwnerId": "149977607591", "IpamResourceDiscoveryAssociationId": "ipam-res-disco-assoc-0dfd21ae189ab5f62", "IpamResourceDiscoveryAssociationArn": "arn:aws:ec2::149977607591:ipam-resource-discovery-association/ipam-res-disco-assoc-0dfd21ae189ab5f62", "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe", "IpamId": "ipam-005f921c17ebd5107", "IpamArn": "arn:aws:ec2::149977607591:ipam/ipam-005f921c17ebd5107", "IpamRegion": "us-east-1", "IsDefault": false, "ResourceDiscoveryStatus": "active", "State": "create-complete", "Tags": [] } ] } ``` In diesem Beispiel stellen Sie nach der Ausführung dieses Befehls fest, dass Sie über eine nicht standardmäßige Ressourcenerkennung verfügen (`"IsDefault": false ``) that is ``"ResourceDiscoveryStatus": "not-found"` und `"State": "create-complete"`. Das Konto des Besitzers der Ressourcenerkennung wurde geschlossen. Wenn Sie in einem anderen Fall feststellen, dass `"ResourceDiscoveryStatus": "not-found"` und `"State": "associate-complete"` zutreffen, deutet dies darauf hin, dass einer der folgenden Fälle eingetreten ist: Die Ressourcenerkennung wurde vom entsprechenden Besitzer gelöscht. Der Besitzer hat die Freigabe der Ressourcenerkennung aufgehoben. Weitere Informationen finden Sie unter [Integrieren von IPAM mit Konten außerhalb Ihrer Organisation](https://docs.aws.amazon.com/vpc/latest/ipam/enable-integ-ipam-outside-org.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [DescribeIpamResourceDiscoveryAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-ipam-resource-discovery-associations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-ipam-scopes` Das folgende Codebeispiel zeigt die Verwendung`describe-ipam-scopes`. **AWS CLI** **So zeigen Sie die Details für einen IPAM-Bereich an** Das folgende Beispiel für `describe-ipam-scopes` zeigt die Details für Bereiche an. ``` aws ec2 describe-ipam-scopes \ --filters Name=owner-id,Values=123456789012 Name=ipam-id,Values=ipam-08440e7a3acde3908 ``` Ausgabe: ``` { "IpamScopes": [ { "OwnerId": "123456789012", "IpamScopeId": "ipam-scope-02fc38cd4c48e7d38", "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-02fc38cd4c48e7d38", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "IpamScopeType": "private", "IsDefault": true, "PoolCount": 2, "State": "create-complete", "Tags": [] }, { "OwnerId": "123456789012", "IpamScopeId": "ipam-scope-0b9eed026396dbc16", "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-0b9eed026396dbc16", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "IpamScopeType": "public", "IsDefault": true, "PoolCount": 0, "State": "create-complete", "Tags": [] }, { "OwnerId": "123456789012", "IpamScopeId": "ipam-scope-0f1aff29486355c22", "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-0f1aff29486355c22", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "IpamScopeType": "private", "IsDefault": false, "Description": "Example description", "PoolCount": 0, "State": "create-complete", "Tags": [ { "Key": "Name", "Value": "Example name value" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeIpamScopes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-ipam-scopes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-ipams` Das folgende Codebeispiel zeigt die Verwendung`describe-ipams`. **AWS CLI** **So zeigen Sie die Details für einen IPAM an** Das folgende Beispiel für `describe-ipams` zeigt die Details eines IPAM an. ``` aws ec2 describe-ipams \ --filters Name=owner-id,Values=123456789012 ``` Ausgabe: ``` { "Ipams": [ { "OwnerId": "123456789012", "IpamId": "ipam-08440e7a3acde3908", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "PublicDefaultScopeId": "ipam-scope-0b9eed026396dbc16", "PrivateDefaultScopeId": "ipam-scope-02fc38cd4c48e7d38", "ScopeCount": 3, "OperatingRegions": [ { "RegionName": "us-east-1" }, { "RegionName": "us-east-2" }, { "RegionName": "us-west-1" } ], "State": "create-complete", "Tags": [ { "Key": "Name", "Value": "ExampleIPAM" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeIpams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-ipams.html)in der *AWS CLI Befehlsreferenz*. ### `describe-ipv6-pools` Das folgende Codebeispiel zeigt die Verwendung`describe-ipv6-pools`. **AWS CLI** **Um Ihre IPv6 Adresspools zu beschreiben** Im folgenden `describe-ipv6-pools` Beispiel werden Details für all Ihre IPv6 Adresspools angezeigt. ``` aws ec2 describe-ipv6-pools ``` Ausgabe: ``` { "Ipv6Pools": [ { "PoolId": "ipv6pool-ec2-012345abc12345abc", "PoolCidrBlocks": [ { "Cidr": "2001:db8:123::/48" } ], "Tags": [ { "Key": "pool-1", "Value": "public" } ] } ] } ``` + API-Details finden Sie unter [DescribeIpv6Pools](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-ipv6-pools.html) in der *AWS CLI Befehlsreferenz.* ### `describe-key-pairs` Das folgende Codebeispiel zeigt die Verwendung`describe-key-pairs`. **AWS CLI** **So zeigen Sie ein Schlüsselpaar an** Im folgenden Beispiel für `describe-key-pairs` werden Informationen zu dem angegebenen Schlüsselpaar angezeigt. ``` aws ec2 describe-key-pairs \ --key-names my-key-pair ``` Ausgabe: ``` { "KeyPairs": [ { "KeyPairId": "key-0b94643da6EXAMPLE", "KeyFingerprint": "1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f", "KeyName": "my-key-pair", "KeyType": "rsa", "Tags": [], "CreateTime": "2022-05-27T21:51:16.000Z" } ] } ``` Weitere Informationen finden Sie unter [Öffentliche Schlüssel beschreiben](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/describe-keys.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeKeyPairs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-key-pairs.html)in der *AWS CLI Befehlsreferenz*. ### `describe-launch-template-versions` Das folgende Codebeispiel zeigt die Verwendung`describe-launch-template-versions`. **AWS CLI** **So beschreiben Sie Startvorlagenversionen** In diesem Beispiel werden die Versionen der angegebenen Startvorlage beschrieben. Befehl: ``` aws ec2 describe-launch-template-versions --launch-template-id lt-068f72b72934aff71 ``` Ausgabe: ``` { "LaunchTemplateVersions": [ { "LaunchTemplateId": "lt-068f72b72934aff71", "LaunchTemplateName": "Webservers", "VersionNumber": 3, "CreatedBy": "arn:aws:iam::123456789102:root", "LaunchTemplateData": { "KeyName": "kp-us-east", "ImageId": "ami-6057e21a", "InstanceType": "t2.small", "NetworkInterfaces": [ { "SubnetId": "subnet-7b16de0c", "DeviceIndex": 0, "Groups": [ "sg-7c227019" ] } ] }, "DefaultVersion": false, "CreateTime": "2017-11-20T13:19:54.000Z" }, { "LaunchTemplateId": "lt-068f72b72934aff71", "LaunchTemplateName": "Webservers", "VersionNumber": 2, "CreatedBy": "arn:aws:iam::123456789102:root", "LaunchTemplateData": { "KeyName": "kp-us-east", "ImageId": "ami-6057e21a", "InstanceType": "t2.medium", "NetworkInterfaces": [ { "SubnetId": "subnet-1a2b3c4d", "DeviceIndex": 0, "Groups": [ "sg-7c227019" ] } ] }, "DefaultVersion": false, "CreateTime": "2017-11-20T13:12:32.000Z" }, { "LaunchTemplateId": "lt-068f72b72934aff71", "LaunchTemplateName": "Webservers", "VersionNumber": 1, "CreatedBy": "arn:aws:iam::123456789102:root", "LaunchTemplateData": { "UserData": "", "KeyName": "kp-us-east", "ImageId": "ami-aabbcc11", "InstanceType": "t2.medium", "NetworkInterfaces": [ { "SubnetId": "subnet-7b16de0c", "DeviceIndex": 0, "DeleteOnTermination": false, "Groups": [ "sg-7c227019" ], "AssociatePublicIpAddress": true } ] }, "DefaultVersion": true, "CreateTime": "2017-11-20T12:52:33.000Z" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLaunchTemplateVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-launch-template-versions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-launch-templates` Das folgende Codebeispiel zeigt die Verwendung`describe-launch-templates`. **AWS CLI** **So beschreiben Sie Startvorlagen** In diesem Beispiel werden Ihre Startvorlagen beschrieben. Befehl: ``` aws ec2 describe-launch-templates ``` Ausgabe: ``` { "LaunchTemplates": [ { "LatestVersionNumber": 2, "LaunchTemplateId": "lt-0e06d290751193123", "LaunchTemplateName": "TemplateForWebServer", "DefaultVersionNumber": 2, "CreatedBy": "arn:aws:iam::123456789012:root", "CreateTime": "2017-11-27T09:30:23.000Z" }, { "LatestVersionNumber": 6, "LaunchTemplateId": "lt-0c45b5e061ec98456", "LaunchTemplateName": "DBServersTemplate", "DefaultVersionNumber": 1, "CreatedBy": "arn:aws:iam::123456789012:root", "CreateTime": "2017-11-20T09:25:22.000Z" }, { "LatestVersionNumber": 1, "LaunchTemplateId": "lt-0d47d774e8e52dabc", "LaunchTemplateName": "MyLaunchTemplate2", "DefaultVersionNumber": 1, "CreatedBy": "arn:aws:iam::123456789012:root", "CreateTime": "2017-11-02T12:06:21.000Z" }, { "LatestVersionNumber": 3, "LaunchTemplateId": "lt-01e5f948eb4f589d6", "LaunchTemplateName": "testingtemplate2", "DefaultVersionNumber": 1, "CreatedBy": "arn:aws:sts::123456789012:assumed-role/AdminRole/i-03ee35176e2e5aabc", "CreateTime": "2017-12-01T08:19:48.000Z" }, ] } ``` + Einzelheiten zur API finden Sie [DescribeLaunchTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-launch-templates.html)in der *AWS CLI Befehlsreferenz*. ### `describe-local-gateway-route-table-virtual-interface-group-associations` Das folgende Codebeispiel zeigt die Verwendung`describe-local-gateway-route-table-virtual-interface-group-associations`. **AWS CLI** **So beschreiben Sie Zuordnungen zwischen virtuellen Schnittstellengruppen und Routing-Tabellen des lokalen Gateways** Das folgende `describe-local-gateway-route-table-virtual-interface-group-associations` Beispiel beschreibt die Verknüpfungen zwischen virtuellen Schnittstellengruppen und lokalen Gateway-Routentabellen in Ihrem AWS Konto. ``` aws ec2 describe-local-gateway-route-table-virtual-interface-group-associations ``` Ausgabe: ``` { "LocalGatewayRouteTableVirtualInterfaceGroupAssociations": [ { "LocalGatewayRouteTableVirtualInterfaceGroupAssociationId": "lgw-vif-grp-assoc-07145b276bEXAMPLE", "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE", "LocalGatewayId": "lgw-0ab1c23d4eEXAMPLE", "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE", "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:123456789012:local-gateway-route-table/lgw-rtb-059615ef7dEXAMPLE", "OwnerId": "123456789012", "State": "associated", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit lokalen Gateways](https://docs.aws.amazon.com/outposts/latest/userguide/outposts-local-gateways.html) im Benutzerhandbuch für *AWS Outposts*. + Einzelheiten zur API finden Sie [DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-local-gateway-route-table-virtual-interface-group-associations.html)unter *AWS CLI Befehlsreferenz*. ### `describe-local-gateway-route-table-vpc-associations` Das folgende Codebeispiel zeigt die Verwendung`describe-local-gateway-route-table-vpc-associations`. **AWS CLI** **Zur Beschreibung der Verknüpfungen zwischen Routentabellen VPCs und lokalen Gateway-Routentabellen** Im folgenden `describe-local-gateway-route-table-vpc-associations` Beispiel werden Informationen zur angegebenen Zuordnung zwischen Routentabellen VPCs und lokalen Gateway-Routentabellen angezeigt. ``` aws ec2 describe-local-gateway-route-table-vpc-associations \ --local-gateway-route-table-vpc-association-ids lgw-vpc-assoc-0e0f27af15EXAMPLE ``` Ausgabe: ``` { "LocalGatewayRouteTableVpcAssociation": { "LocalGatewayRouteTableVpcAssociationId": "lgw-vpc-assoc-0e0f27af1EXAMPLE", "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE", "LocalGatewayId": "lgw-09b493aa7cEXAMPLE", "VpcId": "vpc-0efe9bde08EXAMPLE", "State": "associated" } } ``` Weitere Informationen finden Sie unter [Roouting-Tabellen für lokale Gateways](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html) im *Benutzerhandbuch für Outposts*. + Einzelheiten zur API finden Sie [DescribeLocalGatewayRouteTableVpcAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-local-gateway-route-table-vpc-associations.html)unter *AWS CLI Befehlsreferenz*. ### `describe-local-gateway-route-tables` Das folgende Codebeispiel zeigt die Verwendung`describe-local-gateway-route-tables`. **AWS CLI** **So beschreiben Sie die Routing-Tabellen Ihres lokalen Gateways** Im folgenden Beispiel für `describe-local-gateway-route-tables` werden Details zu den Routing-Tabellen des lokalen Gateways angezeigt. ``` aws ec2 describe-local-gateway-route-tables ``` Ausgabe: ``` { "LocalGatewayRouteTables": [ { "LocalGatewayRouteTableId": "lgw-rtb-059615ef7deEXAMPLE", "LocalGatewayId": "lgw-09b493aa7cEXAMPLE", "OutpostArn": "arn:aws:outposts:us-west-2:111122223333:outpost/op-0dc11b66edEXAMPLE", "State": "available" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLocalGatewayRouteTables](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-local-gateway-route-tables.html)in der *AWS CLI Befehlsreferenz*. ### `describe-local-gateway-virtual-interface-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-local-gateway-virtual-interface-groups`. **AWS CLI** **So beschreiben Sie virtuelle Schnittstellengruppen des lokalen Gateways** Im folgenden `describe-local-gateway-virtual-interface-groups` Beispiel werden die virtuellen Schnittstellengruppen des lokalen Gateways in Ihrem AWS Konto beschrieben. ``` aws ec2 describe-local-gateway-virtual-interface-groups ``` Ausgabe: ``` { "LocalGatewayVirtualInterfaceGroups": [ { "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE", "LocalGatewayVirtualInterfaceIds": [ "lgw-vif-01a23bc4d5EXAMPLE", "lgw-vif-543ab21012EXAMPLE" ], "LocalGatewayId": "lgw-0ab1c23d4eEXAMPLE", "OwnerId": "123456789012", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit lokalen Gateways](https://docs.aws.amazon.com/outposts/latest/userguide/outposts-local-gateways.html) im Benutzerhandbuch für *AWS Outposts*. + Einzelheiten zur API finden Sie [DescribeLocalGatewayVirtualInterfaceGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-local-gateway-virtual-interface-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-local-gateway-virtual-interfaces` Das folgende Codebeispiel zeigt die Verwendung`describe-local-gateway-virtual-interfaces`. **AWS CLI** **So beschreiben Sie die virtuellen Schnittstellen des lokalen Gateways** Das folgende `describe-local-gateway-virtual-interfaces` Beispiel beschreibt die virtuellen Schnittstellen des lokalen Gateways in Ihrem AWS Konto. ``` aws ec2 describe-local-gateway-virtual-interfaces ``` Ausgabe: ``` { "LocalGatewayVirtualInterfaces": [ { "LocalGatewayVirtualInterfaceId": "lgw-vif-01a23bc4d5EXAMPLE", "LocalGatewayId": "lgw-0ab1c23d4eEXAMPLE", "Vlan": 2410, "LocalAddress": "0.0.0.0/0", "PeerAddress": "0.0.0.0/0", "LocalBgpAsn": 65010, "PeerBgpAsn": 65000, "OwnerId": "123456789012", "Tags": [] }, { "LocalGatewayVirtualInterfaceId": "lgw-vif-543ab21012EXAMPLE", "LocalGatewayId": "lgw-0ab1c23d4eEXAMPLE", "Vlan": 2410, "LocalAddress": "0.0.0.0/0", "PeerAddress": "0.0.0.0/0", "LocalBgpAsn": 65010, "PeerBgpAsn": 65000, "OwnerId": "123456789012", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit lokalen Gateways](https://docs.aws.amazon.com/outposts/latest/userguide/outposts-local-gateways.html) im Benutzerhandbuch für *AWS Outposts*. + Einzelheiten zur API finden Sie [DescribeLocalGatewayVirtualInterfaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-local-gateway-virtual-interfaces.html)in der *AWS CLI Befehlsreferenz*. ### `describe-local-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-local-gateways`. **AWS CLI** **So beschreiben Sie Ihre lokalen Gateways** Das folgende Beispiel für `describe-local-gateways` zeigt Details zu den lokalen Gateways an, die für Sie verfügbar sind. ``` aws ec2 describe-local-gateways ``` Ausgabe: ``` { "LocalGateways": [ { "LocalGatewayId": "lgw-09b493aa7cEXAMPLE", "OutpostArn": "arn:aws:outposts:us-west-2:123456789012:outpost/op-0dc11b66ed59f995a", "OwnerId": "123456789012", "State": "available" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLocalGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-local-gateways.html)in der *AWS CLI Befehlsreferenz*. ### `describe-locked-snapshots` Das folgende Codebeispiel zeigt die Verwendung`describe-locked-snapshots`. **AWS CLI** **So beschreiben Sie den Sperrstatus eines Snapshots** Im folgenden Beispiel für `describe-locked-snapshots` wird der Sperrstatus des angegebenen Snapshots beschrieben. ``` aws ec2 describe-locked-snapshots \ --snapshot-ids snap-0b5e733b4a8df6e0d ``` Ausgabe: ``` { "Snapshots": [ { "OwnerId": "123456789012", "SnapshotId": "snap-0b5e733b4a8df6e0d", "LockState": "governance", "LockDuration": 365, "LockCreatedOn": "2024-05-05T00:56:06.208000+00:00", "LockDurationStartTime": "2024-05-05T00:56:06.208000+00:00", "LockExpiresOn": "2025-05-05T00:56:06.208000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Snapshot Lock](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-snapshot-lock.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [DescribeLockedSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-locked-snapshots.html)in der *AWS CLI Befehlsreferenz*. ### `describe-managed-prefix-lists` Das folgende Codebeispiel zeigt die Verwendung`describe-managed-prefix-lists`. **AWS CLI** **So beschreiben Sie verwaltete Präfixlisten** Das folgende `describe-managed-prefix-lists` Beispiel beschreibt die Präfixlisten, die dem AWS Konto gehören`123456789012`. ``` aws ec2 describe-managed-prefix-lists \ --filters Name=owner-id,Values=123456789012 ``` Ausgabe: ``` { "PrefixLists": [ { "PrefixListId": "pl-11223344556677aab", "AddressFamily": "IPv6", "State": "create-complete", "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-11223344556677aab", "PrefixListName": "vpc-ipv6-cidrs", "MaxEntries": 25, "Version": 1, "Tags": [], "OwnerId": "123456789012" }, { "PrefixListId": "pl-0123456abcabcabc1", "AddressFamily": "IPv4", "State": "active", "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1", "PrefixListName": "vpc-cidrs", "MaxEntries": 10, "Version": 1, "Tags": [], "OwnerId": "123456789012" } ] } ``` Weitere Informationen finden Sie unter [Verwaltete Präfixlisten](https://docs.aws.amazon.com/vpc/latest/userguide/managed-prefix-lists.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DescribeManagedPrefixLists](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-managed-prefix-lists.html)unter *AWS CLI Befehlsreferenz*. ### `describe-moving-addresses` Das folgende Codebeispiel zeigt die Verwendung`describe-moving-addresses`. **AWS CLI** **So beschreiben Sie Ihre Verschiebeadressen** In diesem Beispiel werden alle Ihre Elastic-IP-Adressen beschrieben, die verschoben werden. Befehl: ``` aws ec2 describe-moving-addresses ``` Ausgabe: ``` { "MovingAddressStatuses": [ { "PublicIp": "198.51.100.0", "MoveStatus": "MovingToVpc" } ] } ``` In diesem Beispiel werden alle Adressen beschrieben, die auf die EC2-VPC-Plattform verschoben werden. Befehl: ``` aws ec2 describe-moving-addresses --filters Name=moving-status,Values=MovingToVpc ``` + Einzelheiten zur API finden Sie [DescribeMovingAddresses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-moving-addresses.html)in der *AWS CLI Befehlsreferenz*. ### `describe-nat-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-nat-gateways`. **AWS CLI** **Beispiel 1: So beschreiben Sie ein öffentliches NAT-Gateway** Im folgenden Beispiel für `describe-nat-gateways` wird das angegebene öffentliche NAT-Gateway beschrieben. ``` aws ec2 describe-nat-gateways \ --nat-gateway-id nat-01234567890abcdef ``` Ausgabe: ``` { "NatGateways": [ { "CreateTime": "2023-08-25T01:56:51.000Z", "NatGatewayAddresses": [ { "AllocationId": "eipalloc-0790180cd2EXAMPLE", "NetworkInterfaceId": "eni-09cc4b2558794f7f9", "PrivateIp": "10.0.0.211", "PublicIp": "54.85.121.213", "AssociationId": "eipassoc-04d295cc9b8815b24", "IsPrimary": true, "Status": "succeeded" }, { "AllocationId": "eipalloc-0be6ecac95EXAMPLE", "NetworkInterfaceId": "eni-09cc4b2558794f7f9", "PrivateIp": "10.0.0.74", "PublicIp": "3.211.231.218", "AssociationId": "eipassoc-0f96bdca17EXAMPLE", "IsPrimary": false, "Status": "succeeded" } ], "NatGatewayId": "nat-01234567890abcdef", "State": "available", "SubnetId": "subnet-655eab5f08EXAMPLE", "VpcId": "vpc-098eb5ef58EXAMPLE", "Tags": [ { "Key": "Name", "Value": "public-nat" } ], "ConnectivityType": "public" } ] } ``` **Beispiel 2: So beschreiben Sie ein privates NAT-Gateway** Im folgenden Beispiel für `describe-nat-gateways` wird das angegebene private NAT-Gateway beschrieben. ``` aws ec2 describe-nat-gateways \ --nat-gateway-id nat-1234567890abcdef0 ``` Ausgabe: ``` { "NatGateways": [ { "CreateTime": "2023-08-25T00:50:05.000Z", "NatGatewayAddresses": [ { "NetworkInterfaceId": "eni-0065a61b324d1897a", "PrivateIp": "10.0.20.240", "IsPrimary": true, "Status": "succeeded" }, { "NetworkInterfaceId": "eni-0065a61b324d1897a", "PrivateIp": "10.0.20.33", "IsPrimary": false, "Status": "succeeded" }, { "NetworkInterfaceId": "eni-0065a61b324d1897a", "PrivateIp": "10.0.20.197", "IsPrimary": false, "Status": "succeeded" } ], "NatGatewayId": "nat-1234567890abcdef0", "State": "available", "SubnetId": "subnet-08fc749671EXAMPLE", "VpcId": "vpc-098eb5ef58EXAMPLE", "Tags": [ { "Key": "Name", "Value": "private-nat" } ], "ConnectivityType": "private" } ] } ``` Weitere Informationen finden Sie unter [NAT-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DescribeNatGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-nat-gateways.html)in der *AWS CLI Befehlsreferenz*. ### `describe-network-acls` Das folgende Codebeispiel zeigt die Verwendung`describe-network-acls`. **AWS CLI** **Um Ihr Netzwerk zu beschreiben ACLs** Im folgenden `describe-network-acls` Beispiel werden Details zu Ihrem Netzwerk ACLs abgerufen. ``` aws ec2 describe-network-acls ``` Ausgabe: ``` { "NetworkAcls": [ { "Associations": [ { "NetworkAclAssociationId": "aclassoc-0c1679dc41EXAMPLE", "NetworkAclId": "acl-0ea1f54ca7EXAMPLE", "SubnetId": "subnet-0931fc2fa5EXAMPLE" } ], "Entries": [ { "CidrBlock": "0.0.0.0/0", "Egress": true, "Protocol": "-1", "RuleAction": "allow", "RuleNumber": 100 }, { "CidrBlock": "0.0.0.0/0", "Egress": true, "Protocol": "-1", "RuleAction": "deny", "RuleNumber": 32767 }, { "CidrBlock": "0.0.0.0/0", "Egress": false, "Protocol": "-1", "RuleAction": "allow", "RuleNumber": 100 }, { "CidrBlock": "0.0.0.0/0", "Egress": false, "Protocol": "-1", "RuleAction": "deny", "RuleNumber": 32767 } ], "IsDefault": true, "NetworkAclId": "acl-0ea1f54ca7EXAMPLE", "Tags": [], "VpcId": "vpc-06e4ab6c6cEXAMPLE", "OwnerId": "111122223333" }, { "Associations": [], "Entries": [ { "CidrBlock": "0.0.0.0/0", "Egress": true, "Protocol": "-1", "RuleAction": "allow", "RuleNumber": 100 }, { "Egress": true, "Ipv6CidrBlock": "::/0", "Protocol": "-1", "RuleAction": "allow", "RuleNumber": 101 }, { "CidrBlock": "0.0.0.0/0", "Egress": true, "Protocol": "-1", "RuleAction": "deny", "RuleNumber": 32767 }, { "Egress": true, "Ipv6CidrBlock": "::/0", "Protocol": "-1", "RuleAction": "deny", "RuleNumber": 32768 }, { "CidrBlock": "0.0.0.0/0", "Egress": false, "Protocol": "-1", "RuleAction": "allow", "RuleNumber": 100 }, { "Egress": false, "Ipv6CidrBlock": "::/0", "Protocol": "-1", "RuleAction": "allow", "RuleNumber": 101 }, { "CidrBlock": "0.0.0.0/0", "Egress": false, "Protocol": "-1", "RuleAction": "deny", "RuleNumber": 32767 }, { "Egress": false, "Ipv6CidrBlock": "::/0", "Protocol": "-1", "RuleAction": "deny", "RuleNumber": 32768 } ], "IsDefault": true, "NetworkAclId": "acl-0e2a78e4e2EXAMPLE", "Tags": [], "VpcId": "vpc-03914afb3eEXAMPLE", "OwnerId": "111122223333" } ] } ``` Weitere Informationen finden Sie unter [Netzwerk ACLs](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) im *AWS VPC-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeNetworkAcls AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-network-acls.html)*Befehlsreferenz.* ### `describe-network-insights-access-scope-analyses` Das folgende Codebeispiel zeigt die Verwendung`describe-network-insights-access-scope-analyses`. **AWS CLI** **So beschreiben Sie die Analysen des Zugriffsbereichs von Network Insights** Das folgende `describe-network-insights-access-scope-analyses` Beispiel beschreibt die Analyse des Zugriffsumfangs in Ihrem AWS Konto. ``` aws ec2 describe-network-insights-access-scope-analyses \ --region us-east-1 ``` Ausgabe: ``` { "NetworkInsightsAccessScopeAnalyses": [ { "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789111", "NetworkInsightsAccessScopeAnalysisArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-access-scope-analysis/nisa-123456789111", "NetworkInsightsAccessScopeId": "nis-123456789222", "Status": "succeeded", "StartDate": "2022-01-25T19:45:36.842000+00:00", "FindingsFound": "true", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Network Access Analyzer using the AWS CLI](https://docs.aws.amazon.com/vpc/latest/network-access-analyzer/getting-started-cli-naa.html) im *Network Access Analyzer-Handbuch*. + Einzelheiten zur API finden Sie [DescribeNetworkInsightsAccessScopeAnalyses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-network-insights-access-scope-analyses.html)unter *AWS CLI Befehlsreferenz*. ### `describe-network-insights-access-scopes` Das folgende Codebeispiel zeigt die Verwendung`describe-network-insights-access-scopes`. **AWS CLI** **So beschreiben Sie die Zugriffsbereiche von Network Insights** Das folgende `describe-network-insights-access-scopes` Beispiel beschreibt die Access-Scope-Analysen in Ihrem AWS Konto. ``` aws ec2 describe-network-insights-access-scopes \ --region us-east-1 ``` Ausgabe: ``` { "NetworkInsightsAccessScopes": [ { "NetworkInsightsAccessScopeId": "nis-123456789111", "NetworkInsightsAccessScopeArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-access-scope/nis-123456789111", "CreatedDate": "2021-11-29T21:12:41.416000+00:00", "UpdatedDate": "2021-11-29T21:12:41.416000+00:00", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Network Access Analyzer using the AWS CLI](https://docs.aws.amazon.com/vpc/latest/network-access-analyzer/getting-started-cli-naa.html) im *Network Access Analyzer-Handbuch*. + Einzelheiten zur API finden Sie [DescribeNetworkInsightsAccessScopes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-network-insights-access-scopes.html)unter *AWS CLI Befehlsreferenz*. ### `describe-network-insights-analyses` Das folgende Codebeispiel zeigt die Verwendung`describe-network-insights-analyses`. **AWS CLI** **So zeigen Sie die Ergebnisse einer Pfadanalyse an** Im folgenden Beispiel für `describe-network-insights-analyses` wird die angegebene Analyse beschrieben. In diesem Beispiel ist die Quelle ein Internet-Gateway, das Ziel eine EC2-Instance und das Protokoll TCP. Die Analyse war erfolgreich (`Status` lautet `succeeded`) und der Pfad ist nicht erreichbar (`NetworkPathFound` ist `false`). Der Erklärungscode `ENI_SG_RULES_MISMATCH` weist darauf hin, dass die Sicherheitsgruppe für die Instance keine Regel enthält, die Datenverkehr am Zielport zulässt. ``` aws ec2 describe-network-insights-analyses \ --network-insights-analysis-ids nia-02207aa13eb480c7a ``` Ausgabe: ``` { "NetworkInsightsAnalyses": [ { "NetworkInsightsAnalysisId": "nia-02207aa13eb480c7a", "NetworkInsightsAnalysisArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-analysis/nia-02207aa13eb480c7a", "NetworkInsightsPathId": "nip-0b26f224f1d131fa8", "StartDate": "2021-01-20T22:58:37.495Z", "Status": "succeeded", "NetworkPathFound": false, "Explanations": [ { "Direction": "ingress", "ExplanationCode": "ENI_SG_RULES_MISMATCH", "NetworkInterface": { "Id": "eni-0a25edef15a6cc08c", "Arn": "arn:aws:ec2:us-east-1:123456789012:network-interface/eni-0a25edef15a6cc08c" }, "SecurityGroups": [ { "Id": "sg-02f0d35a850ba727f", "Arn": "arn:aws:ec2:us-east-1:123456789012:security-group/sg-02f0d35a850ba727f" } ], "Subnet": { "Id": "subnet-004ff41eccb4d1194", "Arn": "arn:aws:ec2:us-east-1:123456789012:subnet/subnet-004ff41eccb4d1194" }, "Vpc": { "Id": "vpc-f1663d98ad28331c7", "Arn": "arn:aws:ec2:us-east-1:123456789012:vpc/vpc-f1663d98ad28331c7" } } ], "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit der AWS CLI](https://docs.aws.amazon.com/vpc/latest/reachability/getting-started-cli.html) im *Reachability Analyzer-Handbuch*. + Einzelheiten zur API finden Sie unter [DescribeNetworkInsightsAnalyses AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-network-insights-analyses.html)*Befehlsreferenz*. ### `describe-network-insights-paths` Das folgende Codebeispiel zeigt die Verwendung`describe-network-insights-paths`. **AWS CLI** **So beschreiben Sie einen Pfad** Im folgenden Beispiel für `describe-network-insights-paths` wird der angegebene Pfad beschrieben. ``` aws ec2 describe-network-insights-paths \ --network-insights-path-ids nip-0b26f224f1d131fa8 ``` Ausgabe: ``` { "NetworkInsightsPaths": [ { "NetworkInsightsPathId": "nip-0b26f224f1d131fa8", "NetworkInsightsPathArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-path/nip-0b26f224f1d131fa8", "CreatedDate": "2021-01-20T22:43:46.933Z", "Source": "igw-0797cccdc9d73b0e5", "Destination": "i-0495d385ad28331c7", "Protocol": "tcp" } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit der AWS CLI](https://docs.aws.amazon.com/vpc/latest/reachability/getting-started-cli.html) im *Reachability Analyzer-Handbuch*. + Einzelheiten zur API finden Sie unter [DescribeNetworkInsightsPaths AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-network-insights-paths.html)*Befehlsreferenz*. ### `describe-network-interface-attribute` Das folgende Codebeispiel zeigt die Verwendung`describe-network-interface-attribute`. **AWS CLI** **So beschreiben Sie das attachment-Attribut einer Netzwerkschnittstelle** Dieser Beispielbefehl beschreibt das `attachment`-Attribut der angegebenen Netzwerkschnittstelle. Befehl: ``` aws ec2 describe-network-interface-attribute --network-interface-id eni-686ea200 --attribute attachment ``` Ausgabe: ``` { "NetworkInterfaceId": "eni-686ea200", "Attachment": { "Status": "attached", "DeviceIndex": 0, "AttachTime": "2015-05-21T20:02:20.000Z", "InstanceId": "i-1234567890abcdef0", "DeleteOnTermination": true, "AttachmentId": "eni-attach-43348162", "InstanceOwnerId": "123456789012" } } ``` **So beschreiben Sie das description-Attribut einer Netzwerkschnittstelle** Dieser Beispielbefehl beschreibt das `description`-Attribut der angegebenen Netzwerkschnittstelle. Befehl: ``` aws ec2 describe-network-interface-attribute --network-interface-id eni-686ea200 --attribute description ``` Ausgabe: ``` { "NetworkInterfaceId": "eni-686ea200", "Description": { "Value": "My description" } } ``` **So beschreiben Sie das groupSet-Attribut einer Netzwerkschnittstelle** Dieser Beispielbefehl beschreibt das `groupSet`-Attribut der angegebenen Netzwerkschnittstelle. Befehl: ``` aws ec2 describe-network-interface-attribute --network-interface-id eni-686ea200 --attribute groupSet ``` Ausgabe: ``` { "NetworkInterfaceId": "eni-686ea200", "Groups": [ { "GroupName": "my-security-group", "GroupId": "sg-903004f8" } ] } ``` **Um das sourceDestCheck Attribut einer Netzwerkschnittstelle zu beschreiben** Dieser Beispielbefehl beschreibt das `sourceDestCheck`-Attribut der angegebenen Netzwerkschnittstelle. Befehl: ``` aws ec2 describe-network-interface-attribute --network-interface-id eni-686ea200 --attribute sourceDestCheck ``` Ausgabe: ``` { "NetworkInterfaceId": "eni-686ea200", "SourceDestCheck": { "Value": true } } ``` + Einzelheiten zur API finden Sie [DescribeNetworkInterfaceAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-network-interface-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `describe-network-interface-permissions` Das folgende Codebeispiel zeigt die Verwendung`describe-network-interface-permissions`. **AWS CLI** **So beschreiben Sie Ihre Netzwerkschnittstellenberechtigungen** In diesem Beispiel werden alle Ihre Netzwerkschnittstellenberechtigungen beschrieben. Befehl: ``` aws ec2 describe-network-interface-permissions ``` Ausgabe: ``` { "NetworkInterfacePermissions": [ { "PermissionState": { "State": "GRANTED" }, "NetworkInterfacePermissionId": "eni-perm-06fd19020ede149ea", "NetworkInterfaceId": "eni-b909511a", "Permission": "INSTANCE-ATTACH", "AwsAccountId": "123456789012" } ] } ``` + Einzelheiten zur API finden Sie [DescribeNetworkInterfacePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-network-interface-permissions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-network-interfaces` Das folgende Codebeispiel zeigt die Verwendung`describe-network-interfaces`. **AWS CLI** **So beschreiben Sie Ihre Netzwerkschnittstellen** In diesem Beispiel werden alle Ihre Netzwerkschnittstellen beschrieben. Befehl: ``` aws ec2 describe-network-interfaces ``` Ausgabe: ``` { "NetworkInterfaces": [ { "Status": "in-use", "MacAddress": "02:2f:8f:b0:cf:75", "SourceDestCheck": true, "VpcId": "vpc-a01106c2", "Description": "my network interface", "Association": { "PublicIp": "203.0.113.12", "AssociationId": "eipassoc-0fbb766a", "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com", "IpOwnerId": "123456789012" }, "NetworkInterfaceId": "eni-e5aa89a3", "PrivateIpAddresses": [ { "PrivateDnsName": "ip-10-0-1-17.ec2.internal", "Association": { "PublicIp": "203.0.113.12", "AssociationId": "eipassoc-0fbb766a", "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com", "IpOwnerId": "123456789012" }, "Primary": true, "PrivateIpAddress": "10.0.1.17" } ], "RequesterManaged": false, "Ipv6Addresses": [], "PrivateDnsName": "ip-10-0-1-17.ec2.internal", "AvailabilityZone": "us-east-1d", "Attachment": { "Status": "attached", "DeviceIndex": 1, "AttachTime": "2013-11-30T23:36:42.000Z", "InstanceId": "i-1234567890abcdef0", "DeleteOnTermination": false, "AttachmentId": "eni-attach-66c4350a", "InstanceOwnerId": "123456789012" }, "Groups": [ { "GroupName": "default", "GroupId": "sg-8637d3e3" } ], "SubnetId": "subnet-b61f49f0", "OwnerId": "123456789012", "TagSet": [], "PrivateIpAddress": "10.0.1.17" }, { "Status": "in-use", "MacAddress": "02:58:f5:ef:4b:06", "SourceDestCheck": true, "VpcId": "vpc-a01106c2", "Description": "Primary network interface", "Association": { "PublicIp": "198.51.100.0", "IpOwnerId": "amazon" }, "NetworkInterfaceId": "eni-f9ba99bf", "PrivateIpAddresses": [ { "Association": { "PublicIp": "198.51.100.0", "IpOwnerId": "amazon" }, "Primary": true, "PrivateIpAddress": "10.0.1.149" } ], "RequesterManaged": false, "Ipv6Addresses": [], "AvailabilityZone": "us-east-1d", "Attachment": { "Status": "attached", "DeviceIndex": 0, "AttachTime": "2013-11-30T23:35:33.000Z", "InstanceId": "i-0598c7d356eba48d7", "DeleteOnTermination": true, "AttachmentId": "eni-attach-1b9db777", "InstanceOwnerId": "123456789012" }, "Groups": [ { "GroupName": "default", "GroupId": "sg-8637d3e3" } ], "SubnetId": "subnet-b61f49f0", "OwnerId": "123456789012", "TagSet": [], "PrivateIpAddress": "10.0.1.149" } ] } ``` In diesem Beispiel werden Netzwerkschnittstellen beschrieben, die ein Tag mit dem Schlüssel `Purpose` und dem Wert `Prod` besitzen. Befehl: ``` aws ec2 describe-network-interfaces --filters Name=tag:Purpose,Values=Prod ``` Ausgabe: ``` { "NetworkInterfaces": [ { "Status": "available", "MacAddress": "12:2c:bd:f9:bf:17", "SourceDestCheck": true, "VpcId": "vpc-8941ebec", "Description": "ProdENI", "NetworkInterfaceId": "eni-b9a5ac93", "PrivateIpAddresses": [ { "PrivateDnsName": "ip-10-0-1-55.ec2.internal", "Primary": true, "PrivateIpAddress": "10.0.1.55" }, { "PrivateDnsName": "ip-10-0-1-117.ec2.internal", "Primary": false, "PrivateIpAddress": "10.0.1.117" } ], "RequesterManaged": false, "PrivateDnsName": "ip-10-0-1-55.ec2.internal", "AvailabilityZone": "us-east-1d", "Ipv6Addresses": [], "Groups": [ { "GroupName": "MySG", "GroupId": "sg-905002f5" } ], "SubnetId": "subnet-31d6c219", "OwnerId": "123456789012", "TagSet": [ { "Value": "Prod", "Key": "Purpose" } ], "PrivateIpAddress": "10.0.1.55" } ] } ``` + Einzelheiten zur API finden Sie [DescribeNetworkInterfaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-network-interfaces.html)in der *AWS CLI Befehlsreferenz*. ### `describe-placement-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-placement-groups`. **AWS CLI** **So beschreiben Sie Ihre Platzierungsgruppen** Dieser Beispielbefehl beschreibt alle Ihre Platzierungsgruppen. Befehl: ``` aws ec2 describe-placement-groups ``` Ausgabe: ``` { "PlacementGroups": [ { "GroupName": "my-cluster", "State": "available", "Strategy": "cluster" }, ... ] } ``` + Einzelheiten zur API finden Sie [DescribePlacementGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-placement-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-prefix-lists` Das folgende Codebeispiel zeigt die Verwendung`describe-prefix-lists`. **AWS CLI** **So beschreiben Sie Präfixlisten** In diesem Beispiel werden alle verfügbaren Präfixlisten für die Region aufgeführt. Befehl: ``` aws ec2 describe-prefix-lists ``` Ausgabe: ``` { "PrefixLists": [ { "PrefixListName": "com.amazonaws.us-east-1.s3", "Cidrs": [ "54.231.0.0/17" ], "PrefixListId": "pl-63a5400a" } ] } ``` + Einzelheiten zur API finden Sie [DescribePrefixLists](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-prefix-lists.html)in der *AWS CLI Befehlsreferenz*. ### `describe-principal-id-format` Das folgende Codebeispiel zeigt die Verwendung`describe-principal-id-format`. **AWS CLI** **So beschreiben Sie das ID-Format für IAM-Benutzer und -Rollen mit aktiviertem Long-ID-Format** Im folgenden Beispiel für `describe-principal-id-format` wird das ID-Format für den Root-Benutzer, alle IAM-Rollen und alle IAM-Benutzer, für die das Long-ID-Format aktiviert ist, beschrieben. ``` aws ec2 describe-principal-id-format \ --resource instance ``` Ausgabe: ``` { "Principals": [ { "Arn": "arn:aws:iam::123456789012:root", "Statuses": [ { "Deadline": "2016-12-15T00:00:00.000Z", "Resource": "reservation", "UseLongIds": true }, { "Deadline": "2016-12-15T00:00:00.000Z", "Resource": "instance", "UseLongIds": true }, { "Deadline": "2016-12-15T00:00:00.000Z", "Resource": "volume", "UseLongIds": true }, ] }, ... ] } ``` + Einzelheiten zur API finden Sie [DescribePrincipalIdFormat](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-principal-id-format.html)in der *AWS CLI Befehlsreferenz*. ### `describe-public-ipv4-pools` Das folgende Codebeispiel zeigt die Verwendung`describe-public-ipv4-pools`. **AWS CLI** **Um Ihre öffentlichen IPv4 Adresspools zu beschreiben** Im folgenden `describe-public-ipv4-pools` Beispiel werden Details zu den Adresspools angezeigt, die erstellt wurden, als Sie öffentliche IPv4 Adressbereiche mithilfe von Bring Your Own IP Addresses (BYOIP) bereitgestellt haben. ``` aws ec2 describe-public-ipv4-pools ``` Ausgabe: ``` { "PublicIpv4Pools": [ { "PoolId": "ipv4pool-ec2-1234567890abcdef0", "PoolAddressRanges": [ { "FirstAddress": "203.0.113.0", "LastAddress": "203.0.113.255", "AddressCount": 256, "AvailableAddressCount": 256 } ], "TotalAddressCount": 256, "TotalAvailableAddressCount": 256 } ] } ``` + *API-Details finden Sie unter [DescribePublicIpv4Pools](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-public-ipv4-pools.html) in der Befehlsreferenz.AWS CLI * ### `describe-regions` Das folgende Codebeispiel zeigt die Verwendung`describe-regions`. **AWS CLI** **Beispiel 1: So beschreiben Sie alle von Ihnen aktivierten Regionen** Im folgenden Beispiel für `describe-regions` werden alle Regionen beschrieben, die für Ihr Konto aktiviert sind. ``` aws ec2 describe-regions ``` Ausgabe: ``` { "Regions": [ { "Endpoint": "ec2.eu-north-1.amazonaws.com", "RegionName": "eu-north-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-south-1.amazonaws.com", "RegionName": "ap-south-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.eu-west-3.amazonaws.com", "RegionName": "eu-west-3", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.eu-west-2.amazonaws.com", "RegionName": "eu-west-2", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.eu-west-1.amazonaws.com", "RegionName": "eu-west-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-northeast-3.amazonaws.com", "RegionName": "ap-northeast-3", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-northeast-2.amazonaws.com", "RegionName": "ap-northeast-2", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-northeast-1.amazonaws.com", "RegionName": "ap-northeast-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.sa-east-1.amazonaws.com", "RegionName": "sa-east-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ca-central-1.amazonaws.com", "RegionName": "ca-central-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-southeast-1.amazonaws.com", "RegionName": "ap-southeast-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-southeast-2.amazonaws.com", "RegionName": "ap-southeast-2", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.eu-central-1.amazonaws.com", "RegionName": "eu-central-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.us-east-1.amazonaws.com", "RegionName": "us-east-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.us-east-2.amazonaws.com", "RegionName": "us-east-2", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.us-west-1.amazonaws.com", "RegionName": "us-west-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.us-west-2.amazonaws.com", "RegionName": "us-west-2", "OptInStatus": "opt-in-not-required" } ] } ``` Weitere Informationen finden Sie unter [Regionen und Zones](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 2: So beschreiben Sie aktivierte Regionen mit einem Endpunkt, dessen Name eine bestimmte Zeichenfolge enthält** Das folgende `describe-regions`-Beispiel beschreibt alle Regionen, die Sie aktiviert haben und deren Endpunkt die Zeichenfolge „us“ enthält. ``` aws ec2 describe-regions \ --filters "Name=endpoint,Values=*us*" ``` Ausgabe: ``` { "Regions": [ { "Endpoint": "ec2.us-east-1.amazonaws.com", "RegionName": "us-east-1" }, { "Endpoint": "ec2.us-east-2.amazonaws.com", "RegionName": "us-east-2" }, { "Endpoint": "ec2.us-west-1.amazonaws.com", "RegionName": "us-west-1" }, { "Endpoint": "ec2.us-west-2.amazonaws.com", "RegionName": "us-west-2" } ] } ``` Weitere Informationen finden Sie unter [Regionen und Zones](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 3: So beschreiben Sie alle Regionen** Das folgende `describe-regions`-Beispiel beschreibt alle verfügbaren Regionen, einschließlich Regionen, die deaktiviert sind. ``` aws ec2 describe-regions \ --all-regions ``` Ausgabe: ``` { "Regions": [ { "Endpoint": "ec2.eu-north-1.amazonaws.com", "RegionName": "eu-north-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-south-1.amazonaws.com", "RegionName": "ap-south-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.eu-west-3.amazonaws.com", "RegionName": "eu-west-3", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.eu-west-2.amazonaws.com", "RegionName": "eu-west-2", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.eu-west-1.amazonaws.com", "RegionName": "eu-west-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-northeast-3.amazonaws.com", "RegionName": "ap-northeast-3", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.me-south-1.amazonaws.com", "RegionName": "me-south-1", "OptInStatus": "not-opted-in" }, { "Endpoint": "ec2.ap-northeast-2.amazonaws.com", "RegionName": "ap-northeast-2", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-northeast-1.amazonaws.com", "RegionName": "ap-northeast-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.sa-east-1.amazonaws.com", "RegionName": "sa-east-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ca-central-1.amazonaws.com", "RegionName": "ca-central-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-east-1.amazonaws.com", "RegionName": "ap-east-1", "OptInStatus": "not-opted-in" }, { "Endpoint": "ec2.ap-southeast-1.amazonaws.com", "RegionName": "ap-southeast-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.ap-southeast-2.amazonaws.com", "RegionName": "ap-southeast-2", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.eu-central-1.amazonaws.com", "RegionName": "eu-central-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.us-east-1.amazonaws.com", "RegionName": "us-east-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.us-east-2.amazonaws.com", "RegionName": "us-east-2", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.us-west-1.amazonaws.com", "RegionName": "us-west-1", "OptInStatus": "opt-in-not-required" }, { "Endpoint": "ec2.us-west-2.amazonaws.com", "RegionName": "us-west-2", "OptInStatus": "opt-in-not-required" } ] } ``` Weitere Informationen finden Sie unter [Regionen und Zones](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 4: So listen Sie nur die Namen der Regionen auf** Im folgenden Beispiel für `describe-regions` wird der `--query`-Parameter verwendet, um die Ausgabe zu filtern und nur die Namen der Regionen als Text zurückzugeben. ``` aws ec2 describe-regions \ --all-regions \ --query "Regions[].{Name:RegionName}" \ --output text ``` Ausgabe: ``` eu-north-1 ap-south-1 eu-west-3 eu-west-2 eu-west-1 ap-northeast-3 ap-northeast-2 me-south-1 ap-northeast-1 sa-east-1 ca-central-1 ap-east-1 ap-southeast-1 ap-southeast-2 eu-central-1 us-east-1 us-east-2 us-west-1 us-west-2 ``` Weitere Informationen finden Sie unter [Regionen und Zonen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) im *Amazon-EC2-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeRegions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-regions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-replace-root-volume-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-replace-root-volume-tasks`. **AWS CLI** **Beispiel 1: So zeigen Sie Informationen zu einer bestimmten Aufgabe zum Austausch eines Stamm-Volumes an** Im folgenden Beispiel für `describe-replace-root-volume-tasks` wird die Aufgabe zum Austausch des Stamm-Volumes replacevol-0111122223333abcd beschrieben. ``` aws ec2 describe-replace-root-volume-tasks \ --replace-root-volume-task-ids replacevol-0111122223333abcd ``` Ausgabe: ``` { "ReplaceRootVolumeTasks": [ { "ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd", "Tags": [], "InstanceId": "i-0123456789abcdefa", "TaskState": "succeeded", "StartTime": "2022-03-14T15:16:28Z", "CompleteTime": "2022-03-14T15:16:52Z" } ] } ``` Weitere Informationen finden Sie unter [Ersetzen eines Stamm-Volume](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html#replace-root) im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. **Beispiel 2: So zeigen Sie Informationen zu allen Aufgaben zum Austausch von Stamm-Volumes für eine bestimmte Instance an** Im folgenden Beispiel für `describe-replace-root-volume-tasks` werden alle Aufgaben zum Austausch von Stamm-Volumes für die Instance i-0123456789abcdefa beschrieben. ``` aws ec2 describe-replace-root-volume-tasks \ --filters Name=instance-id,Values=i-0123456789abcdefa ``` Ausgabe: ``` { "ReplaceRootVolumeTasks": [ { "ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd", "Tags": [], "InstanceId": "i-0123456789abcdefa", "TaskState": "succeeded", "StartTime": "2022-03-14T15:06:38Z", "CompleteTime": "2022-03-14T15:07:03Z" }, { "ReplaceRootVolumeTaskId": "replacevol-0444455555555abcd", "Tags": [], "InstanceId": "i-0123456789abcdefa", "TaskState": "succeeded", "StartTime": "2022-03-14T15:16:28Z", "CompleteTime": "2022-03-14T15:16:52Z" } ] } ``` Weitere Informationen finden Sie unter [Ersetzen eines Stamm-Volume](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html#replace-root) im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie [DescribeReplaceRootVolumeTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-replace-root-volume-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-reserved-instances-listings` Das folgende Codebeispiel zeigt die Verwendung`describe-reserved-instances-listings`. **AWS CLI** **So beschreiben Sie ein Reserved-Instance-Angebot** Im folgenden Beispiel für `describe-reserved-instances-listings` werden Informationen zum angegebenen Reserved-Instance-Angebot abgerufen. ``` aws ec2 describe-reserved-instances-listings \ --reserved-instances-listing-id 5ec28771-05ff-4b9b-aa31-9e57dexample ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DescribeReservedInstancesListings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-reserved-instances-listings.html)in der *AWS CLI Befehlsreferenz*. ### `describe-reserved-instances-modifications` Das folgende Codebeispiel zeigt die Verwendung`describe-reserved-instances-modifications`. **AWS CLI** **So beschreiben Sie Änderungen an Reserved Instances** Dieser Beispielbefehl beschreibt alle Änderungsanforderungen für Reserved Instances, die für Ihr Konto eingereicht wurden. Befehl: ``` aws ec2 describe-reserved-instances-modifications ``` Ausgabe: ``` { "ReservedInstancesModifications": [ { "Status": "fulfilled", "ModificationResults": [ { "ReservedInstancesId": "93bbbca2-62f1-4d9d-b225-16bada29e6c7", "TargetConfiguration": { "AvailabilityZone": "us-east-1b", "InstanceType": "m1.large", "InstanceCount": 3 } }, { "ReservedInstancesId": "1ba8e2e3-aabb-46c3-bcf5-3fe2fda922e6", "TargetConfiguration": { "AvailabilityZone": "us-east-1d", "InstanceType": "m1.xlarge", "InstanceCount": 1 } } ], "EffectiveDate": "2015-08-12T17:00:00.000Z", "CreateDate": "2015-08-12T17:52:52.630Z", "UpdateDate": "2015-08-12T18:08:06.698Z", "ClientToken": "c9adb218-3222-4889-8216-0cf0e52dc37e: "ReservedInstancesModificationId": "rimod-d3ed4335-b1d3-4de6-ab31-0f13aaf46687", "ReservedInstancesIds": [ { "ReservedInstancesId": "b847fa93-e282-4f55-b59a-1342f5bd7c02" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeReservedInstancesModifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-reserved-instances-modifications.html)in der *AWS CLI Befehlsreferenz*. ### `describe-reserved-instances-offerings` Das folgende Codebeispiel zeigt die Verwendung`describe-reserved-instances-offerings`. **AWS CLI** **So beschreiben Sie Reserved-Instances-Angebote** Dieser Beispielbefehl beschreibt alle Reserved Instances, die in der Region erhältlich sind. Befehl: ``` aws ec2 describe-reserved-instances-offerings ``` Ausgabe: ``` { "ReservedInstancesOfferings": [ { "OfferingType": "Partial Upfront", "AvailabilityZone": "us-east-1b", "InstanceTenancy": "default", "PricingDetails": [], "ProductDescription": "Red Hat Enterprise Linux", "UsagePrice": 0.0, "RecurringCharges": [ { "Amount": 0.088, "Frequency": "Hourly" } ], "Marketplace": false, "CurrencyCode": "USD", "FixedPrice": 631.0, "Duration": 94608000, "ReservedInstancesOfferingId": "9a06095a-bdc6-47fe-a94a-2a382f016040", "InstanceType": "c1.medium" }, { "OfferingType": "PartialUpfront", "AvailabilityZone": "us-east-1b", "InstanceTenancy": "default", "PricingDetails": [], "ProductDescription": "Linux/UNIX", "UsagePrice": 0.0, "RecurringCharges": [ { "Amount": 0.028, "Frequency": "Hourly" } ], "Marketplace": false, "CurrencyCode": "USD", "FixedPrice": 631.0, "Duration": 94608000, "ReservedInstancesOfferingId": "bfbefc6c-0d10-418d-b144-7258578d329d", "InstanceType": "c1.medium" }, ... } ``` **So beschreiben Sie Ihre Reserved-Instances-Angebote mithilfe von Optionen** In diesem Beispiel werden Reserved Instances aufgeführt, die von AWS mit den folgenden Spezifikationen angeboten werden: t1.micro-Instance-Typen, Windows-Produkte (Amazon VPC) und Angebote für hohe Auslastung. Befehl: ``` aws ec2 describe-reserved-instances-offerings --no-include-marketplace --instance-type "t1.micro" --product-description "Windows (Amazon VPC)" --offering-type "no upfront" ``` Ausgabe: ``` { "ReservedInstancesOfferings": [ { "OfferingType": "No Upfront", "AvailabilityZone": "us-east-1b", "InstanceTenancy": "default", "PricingDetails": [], "ProductDescription": "Windows", "UsagePrice": 0.0, "RecurringCharges": [ { "Amount": 0.015, "Frequency": "Hourly" } ], "Marketplace": false, "CurrencyCode": "USD", "FixedPrice": 0.0, "Duration": 31536000, "ReservedInstancesOfferingId": "c48ab04c-fe69-4f94-8e39-a23842292823", "InstanceType": "t1.micro" }, ... { "OfferingType": "No Upfront", "AvailabilityZone": "us-east-1d", "InstanceTenancy": "default", "PricingDetails": [], "ProductDescription": "Windows (Amazon VPC)", "UsagePrice": 0.0, "RecurringCharges": [ { "Amount": 0.015, "Frequency": "Hourly" } ], "Marketplace": false, "CurrencyCode": "USD", "FixedPrice": 0.0, "Duration": 31536000, "ReservedInstancesOfferingId": "3a98bf7d-2123-42d4-b4f5-8dbec4b06dc6", "InstanceType": "t1.micro" } ] } ``` + *Einzelheiten zur API finden Sie [DescribeReservedInstancesOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-reserved-instances-offerings.html)in AWS CLI der Befehlsreferenz.* ### `describe-reserved-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-reserved-instances`. **AWS CLI** **So beschreiben Sie Ihre Reserved Instances** Dieser Beispielbefehl beschreibt die Reserved Instances, die Sie besitzen. Befehl: ``` aws ec2 describe-reserved-instances ``` Ausgabe: ``` { "ReservedInstances": [ { "ReservedInstancesId": "b847fa93-e282-4f55-b59a-1342fexample", "OfferingType": "No Upfront", "AvailabilityZone": "us-west-1c", "End": "2016-08-14T21:34:34.000Z", "ProductDescription": "Linux/UNIX", "UsagePrice": 0.00, "RecurringCharges": [ { "Amount": 0.104, "Frequency": "Hourly" } ], "Start": "2015-08-15T21:34:35.086Z", "State": "active", "FixedPrice": 0.0, "CurrencyCode": "USD", "Duration": 31536000, "InstanceTenancy": "default", "InstanceType": "m3.medium", "InstanceCount": 2 }, ... ] } ``` **So beschreiben Sie Ihre Reserved Instances mithilfe von Filtern** In diesem Beispiel wird die Antwort so gefiltert, dass sie nur Linux/UNIX reservierte t2.micro-Instances mit einer Laufzeit von drei Jahren in us-west-1c enthält. Befehl: ``` aws ec2 describe-reserved-instances --filters Name=duration,Values=94608000 Name=instance-type,Values=t2.micro Name=product-description,Values=Linux/UNIX Name=availability-zone,Values=us-east-1e ``` Ausgabe: ``` { "ReservedInstances": [ { "ReservedInstancesId": "f127bd27-edb7-44c9-a0eb-0d7e09259af0", "OfferingType": "All Upfront", "AvailabilityZone": "us-east-1e", "End": "2018-03-26T21:34:34.000Z", "ProductDescription": "Linux/UNIX", "UsagePrice": 0.00, "RecurringCharges": [], "Start": "2015-03-27T21:34:35.848Z", "State": "active", "FixedPrice": 151.0, "CurrencyCode": "USD", "Duration": 94608000, "InstanceTenancy": "default", "InstanceType": "t2.micro", "InstanceCount": 1 } ] } ``` Weitere Informationen finden Sie unter Verwenden von Amazon-EC2-Instances im Benutzerhandbuch zu* die AWS -Befehlszeilenschnittstelle*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DescribeReservedInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-reserved-instances.html)AWS CLI * ### `describe-route-tables` Das folgende Codebeispiel zeigt die Verwendung`describe-route-tables`. **AWS CLI** **So beschreiben Sie Ihre Routing-Tabellen** Im folgenden Beispiel für `describe-route-tables` werden Details über Ihre Routing-Tabellen abgerufen. ``` aws ec2 describe-route-tables ``` Ausgabe: ``` { "RouteTables": [ { "Associations": [ { "Main": true, "RouteTableAssociationId": "rtbassoc-0df3f54e06EXAMPLE", "RouteTableId": "rtb-09ba434c1bEXAMPLE" } ], "PropagatingVgws": [], "RouteTableId": "rtb-09ba434c1bEXAMPLE", "Routes": [ { "DestinationCidrBlock": "10.0.0.0/16", "GatewayId": "local", "Origin": "CreateRouteTable", "State": "active" }, { "DestinationCidrBlock": "0.0.0.0/0", "NatGatewayId": "nat-06c018cbd8EXAMPLE", "Origin": "CreateRoute", "State": "blackhole" } ], "Tags": [], "VpcId": "vpc-0065acced4EXAMPLE", "OwnerId": "111122223333" }, { "Associations": [ { "Main": true, "RouteTableAssociationId": "rtbassoc-9EXAMPLE", "RouteTableId": "rtb-a1eec7de" } ], "PropagatingVgws": [], "RouteTableId": "rtb-a1eec7de", "Routes": [ { "DestinationCidrBlock": "172.31.0.0/16", "GatewayId": "local", "Origin": "CreateRouteTable", "State": "active" }, { "DestinationCidrBlock": "0.0.0.0/0", "GatewayId": "igw-fEXAMPLE", "Origin": "CreateRoute", "State": "active" } ], "Tags": [], "VpcId": "vpc-3EXAMPLE", "OwnerId": "111122223333" }, { "Associations": [ { "Main": false, "RouteTableAssociationId": "rtbassoc-0b100c28b2EXAMPLE", "RouteTableId": "rtb-07a98f76e5EXAMPLE", "SubnetId": "subnet-0d3d002af8EXAMPLE" } ], "PropagatingVgws": [], "RouteTableId": "rtb-07a98f76e5EXAMPLE", "Routes": [ { "DestinationCidrBlock": "10.0.0.0/16", "GatewayId": "local", "Origin": "CreateRouteTable", "State": "active" }, { "DestinationCidrBlock": "0.0.0.0/0", "GatewayId": "igw-06cf664d80EXAMPLE", "Origin": "CreateRoute", "State": "active" } ], "Tags": [], "VpcId": "vpc-0065acced4EXAMPLE", "OwnerId": "111122223333" } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Routing-Tabellen](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Route_Tables.html#WorkWithRouteTables) im *Benutzerhandbuch für AWS VPC*. + Einzelheiten zur API finden Sie [DescribeRouteTables](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-route-tables.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scheduled-instance-availability` Das folgende Codebeispiel zeigt die Verwendung`describe-scheduled-instance-availability`. **AWS CLI** **So beschreiben Sie einen verfügbaren Zeitplan** In diesem Beispiel wird ein Zeitplan beschrieben, der jede Woche am Sonntag beginnt und am angegebenen Datum startet. Befehl: ``` aws ec2 describe-scheduled-instance-availability --recurrence Frequency=Weekly,Interval=1,OccurrenceDays=[1] --first-slot-start-time-range EarliestTime=2016-01-31T00:00:00Z,LatestTime=2016-01-31T04:00:00Z ``` Ausgabe: ``` { "ScheduledInstanceAvailabilitySet": [ { "AvailabilityZone": "us-west-2b", "TotalScheduledInstanceHours": 1219, "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi...", "MinTermDurationInDays": 366, "AvailableInstanceCount": 20, "Recurrence": { "OccurrenceDaySet": [ 1 ], "Interval": 1, "Frequency": "Weekly", "OccurrenceRelativeToEnd": false }, "Platform": "Linux/UNIX", "FirstSlotStartTime": "2016-01-31T00:00:00Z", "MaxTermDurationInDays": 366, "SlotDurationInHours": 23, "NetworkPlatform": "EC2-VPC", "InstanceType": "c4.large", "HourlyPrice": "0.095" }, ... ] } ``` Zum Eingrenzen der Ergebnisse können Sie Filter hinzufügen, die das Betriebssystem, das Netzwerk und den Instance-Typ angeben. Befehl: --filters Name=platform,Values=Linux/UNIX Name=network-platform,Values=EC2-VPC Name=instance-type,Values=c4.large + Einzelheiten zur API finden Sie [DescribeScheduledInstanceAvailability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-scheduled-instance-availability.html)in der *AWS CLI Befehlsreferenz*. ### `describe-scheduled-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-scheduled-instances`. **AWS CLI** **So beschreiben Sie Ihre geplanten Instances** In diesem Beispiel wird die angegebene geplante Instance beschrieben. Befehl: ``` aws ec2 describe-scheduled-instances --scheduled-instance-ids sci-1234-1234-1234-1234-123456789012 ``` Ausgabe: ``` { "ScheduledInstanceSet": [ { "AvailabilityZone": "us-west-2b", "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012", "HourlyPrice": "0.095", "CreateDate": "2016-01-25T21:43:38.612Z", "Recurrence": { "OccurrenceDaySet": [ 1 ], "Interval": 1, "Frequency": "Weekly", "OccurrenceRelativeToEnd": false, "OccurrenceUnit": "" }, "Platform": "Linux/UNIX", "TermEndDate": "2017-01-31T09:00:00Z", "InstanceCount": 1, "SlotDurationInHours": 32, "TermStartDate": "2016-01-31T09:00:00Z", "NetworkPlatform": "EC2-VPC", "TotalScheduledInstanceHours": 1696, "NextSlotStartTime": "2016-01-31T09:00:00Z", "InstanceType": "c4.large" } ] } ``` In diesem Beispiel werden alle Ihre geplanten Instances beschrieben. Befehl: ``` aws ec2 describe-scheduled-instances ``` + Einzelheiten zur API finden Sie [DescribeScheduledInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-scheduled-instances.html)in der *AWS CLI Befehlsreferenz*. ### `describe-security-group-references` Das folgende Codebeispiel zeigt die Verwendung`describe-security-group-references`. **AWS CLI** **So beschreiben Sie Verweise auf Sicherheitsgruppen** In diesem Beispiel werden die Verweise auf Sicherheitsgruppen für `sg-bbbb2222` beschrieben. Die Antwort weist darauf hin, dass von einer Sicherheitsgruppe in der VPC `vpc-aaaaaaaa` auf die Sicherheitsgruppe `sg-bbbb2222` verwiesen wird. Befehl: ``` aws ec2 describe-security-group-references --group-id sg-bbbbb22222 ``` Ausgabe: ``` { "SecurityGroupsReferenceSet": [ { "ReferencingVpcId": "vpc-aaaaaaaa ", "GroupId": "sg-bbbbb22222", "VpcPeeringConnectionId": "pcx-b04deed9" } ] } ``` + Einzelheiten zur API finden Sie [DescribeSecurityGroupReferences](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-security-group-references.html)in der *AWS CLI Befehlsreferenz*. ### `describe-security-group-rules` Das folgende Codebeispiel zeigt die Verwendung`describe-security-group-rules`. **AWS CLI** **Beispiel 1: So beschreiben Sie die Sicherheitsgruppenregeln für eine Sicherheitsgruppe** Im folgenden Beispiel für `describe-security-group-rules` werden die Sicherheitsgruppenregeln einer angegebenen Sicherheitsgruppe beschrieben. Verwenden Sie die `filters`-Option, um die Ergebnisse auf eine bestimmte Sicherheitsgruppe zu beschränken. ``` aws ec2 describe-security-group-rules \ --filters Name="group-id",Values="sg-1234567890abcdef0" ``` Ausgabe: ``` { "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-abcdef01234567890", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "111122223333", "IsEgress": false, "IpProtocol": "-1", "FromPort": -1, "ToPort": -1, "ReferencedGroupInfo": { "GroupId": "sg-1234567890abcdef0", "UserId": "111122223333" }, "Tags": [] }, { "SecurityGroupRuleId": "sgr-bcdef01234567890a", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "111122223333", "IsEgress": true, "IpProtocol": "-1", "FromPort": -1, "ToPort": -1, "CidrIpv6": "::/0", "Tags": [] }, { "SecurityGroupRuleId": "sgr-cdef01234567890ab", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "111122223333", "IsEgress": true, "IpProtocol": "-1", "FromPort": -1, "ToPort": -1, "CidrIpv4": "0.0.0.0/0", "Tags": [] } ] } ``` **Beispiel 2: So beschreiben Sie eine Sicherheitsgruppenregel** Im folgenden Beispiel für `describe-security-group-rules` werden die Sicherheitsgruppenregeln beschrieben. ``` aws ec2 describe-security-group-rules \ --security-group-rule-ids sgr-cdef01234567890ab ``` Ausgabe: ``` { "SecurityGroupRules": [ { "SecurityGroupRuleId": "sgr-cdef01234567890ab", "GroupId": "sg-1234567890abcdef0", "GroupOwnerId": "111122223333", "IsEgress": true, "IpProtocol": "-1", "FromPort": -1, "ToPort": -1, "CidrIpv4": "0.0.0.0/0", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Sicherheitsgruppenregeln](https://docs.aws.amazon.com/vpc/latest/userguide/security-group-rules.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DescribeSecurityGroupRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-security-group-rules.html)in der *AWS CLI Befehlsreferenz*. ### `describe-security-group-vpc-associations` Das folgende Codebeispiel zeigt die Verwendung`describe-security-group-vpc-associations`. **AWS CLI** **So beschreiben Sie VPC-Zuordnungen** Im folgenden Beispiel für `describe-security-group-vpc-associations` werden die VPC-Zuordnungen für die angegebene Sicherheitsgruppe beschrieben. ``` aws ec2 describe-security-group-vpc-associations \ --filters Name=group-id,Values=sg-04dbb43907d3f8a78 ``` Ausgabe: ``` { "SecurityGroupVpcAssociations": [ { "GroupId": "sg-04dbb43907d3f8a78", "VpcId": "vpc-0bf4c2739bc05a694", "VpcOwnerId": "123456789012", "State": "associated" } ] } ``` Weitere Informationen finden Sie unter [Sicherheitsgruppen mehreren zuordnen VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/security-group-assoc.html) im *Amazon VPC-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeSecurityGroupVpcAssociations AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-security-group-vpc-associations.html)*Befehlsreferenz.* ### `describe-security-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-security-groups`. **AWS CLI** **Beispiel 1: So beschreiben Sie eine Sicherheitsgruppe** Das folgende `describe-security-groups`-Beispiel beschreibt die angegebene Sicherheitsgruppe. ``` aws ec2 describe-security-groups \ --group-ids sg-903004f8 ``` Ausgabe: ``` { "SecurityGroups": [ { "IpPermissionsEgress": [ { "IpProtocol": "-1", "IpRanges": [ { "CidrIp": "0.0.0.0/0" } ], "UserIdGroupPairs": [], "PrefixListIds": [] } ], "Description": "My security group", "Tags": [ { "Value": "SG1", "Key": "Name" } ], "IpPermissions": [ { "IpProtocol": "-1", "IpRanges": [], "UserIdGroupPairs": [ { "UserId": "123456789012", "GroupId": "sg-903004f8" } ], "PrefixListIds": [] }, { "PrefixListIds": [], "FromPort": 22, "IpRanges": [ { "Description": "Access from NY office", "CidrIp": "203.0.113.0/24" } ], "ToPort": 22, "IpProtocol": "tcp", "UserIdGroupPairs": [] } ], "GroupName": "MySecurityGroup", "VpcId": "vpc-1a2b3c4d", "OwnerId": "123456789012", "GroupId": "sg-903004f8", } ] } ``` **Beispiel 2: So beschreiben Sie Sicherheitsgruppen, die bestimmte Regeln haben** Im folgenden Beispiel für `describe-security-groups` werden Filter verwendet, um die Ergebnisse auf Sicherheitsgruppen zu beschränken, die über eine Regel verfügen, die SSH-Datenverkehr (Port 22) zulässt, und eine Regel, die Datenverkehr von allen Adressen zulässt (`0.0.0.0/0`). Im Beispiel wird der `--query`-Parameter verwendet, um nur die Namen der Sicherheitsgruppen anzuzeigen. Sicherheitsgruppen müssen mit allen Filtern übereinstimmen, die in den Ergebnissen zurückgegeben werden. Eine einzige Regel muss jedoch nicht mit allen Filtern übereinstimmen. Die Ausgabe liefert beispielsweise eine Sicherheitsgruppe mit einer Regel, die SSH-Verkehr von einer bestimmten IP-Adresse zulässt und einer anderen Regel, die HTTP-Verkehr von allen Adressen zulässt. ``` aws ec2 describe-security-groups \ --filters Name=ip-permission.from-port,Values=22 Name=ip-permission.to-port,Values=22 Name=ip-permission.cidr,Values='0.0.0.0/0' \ --query "SecurityGroups[*].[GroupName]" \ --output text ``` Ausgabe: ``` default my-security-group web-servers launch-wizard-1 ``` **Beispiel 3: So beschreiben Sie Sicherheitsgruppen anhand von Tags** Im folgenden Beispiel für `describe-security-groups` werden Filter verwendet, um die Ergebnisse auf Sicherheitsgruppen zu beschränken, die `test` im Namen der Sicherheitsgruppe enthalten und die das Tag `Test=To-delete` haben. Das Beispiel verwendet den `--query` Parameter, um nur die Namen und IDs der Sicherheitsgruppen anzuzeigen. ``` aws ec2 describe-security-groups \ --filters Name=group-name,Values=*test* Name=tag:Test,Values=To-delete \ --query "SecurityGroups[*].{Name:GroupName,ID:GroupId}" ``` Ausgabe: ``` [ { "Name": "testfornewinstance", "ID": "sg-33bb22aa" }, { "Name": "newgrouptest", "ID": "sg-1a2b3c4d" } ] ``` Weitere Beispiele für die Verwendung von Tag-Filtern finden Sie unter [Arbeiten mit Tags](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_CLI) im *Amazon-EC2-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-security-groups.html)unter *AWS CLI Befehlsreferenz*. ### `describe-snapshot-attribute` Das folgende Codebeispiel zeigt die Verwendung`describe-snapshot-attribute`. **AWS CLI** **So beschreiben Sie die snapshot-Attribute für einen Snapshot** Im folgenden Beispiel für `describe-snapshot-attribute` werden die Konten aufgelistet, mit denen ein Snapshot geteilt wird. ``` aws ec2 describe-snapshot-attribute \ --snapshot-id snap-01234567890abcedf \ --attribute createVolumePermission ``` Ausgabe: ``` { "SnapshotId": "snap-01234567890abcedf", "CreateVolumePermissions": [ { "UserId": "123456789012" } ] } ``` Weitere Informationen finden Sie unter [Teilen eines Amazon-EBS-Snapshots](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modifying-snapshot-permissions.html#share-unencrypted-snapshot) im *Benutzerhandbuch für Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie [DescribeSnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-snapshot-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `describe-snapshot-tier-status` Das folgende Codebeispiel zeigt die Verwendung`describe-snapshot-tier-status`. **AWS CLI** **So zeigen Sie Archivinformationen zu einem archivierten Snapshot an** Im folgenden Beispiel für `describe-snapshot-tier-status` werden Archivinformationen zu einem archivierten Snapshot bereitgestellt. ``` aws ec2 describe-snapshot-tier-status \ --filters "Name=snapshot-id, Values=snap-01234567890abcedf" ``` Ausgabe: ``` { "SnapshotTierStatuses": [ { "Status": "completed", "ArchivalCompleteTime": "2021-09-15T17:33:16.147Z", "LastTieringProgress": 100, "Tags": [], "VolumeId": "vol-01234567890abcedf", "LastTieringOperationState": "archival-completed", "StorageTier": "archive", "OwnerId": "123456789012", "SnapshotId": "snap-01234567890abcedf", "LastTieringStartTime": "2021-09-15T16:44:37.574Z" } ] } ``` Weitere Informationen finden Sie unter [Archivierte Snapshots anzeigen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/working-with-snapshot-archiving.html#view-archived-snapshot) im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie [DescribeSnapshotTierStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-snapshot-tier-status.html)in der *AWS CLI Befehlsreferenz*. ### `describe-snapshots` Das folgende Codebeispiel zeigt die Verwendung`describe-snapshots`. **AWS CLI** **Beispiel 1: So beschreiben Sie einen Snapshot** Das folgende `describe-snapshots`-Beispiel beschreibt den angegebenen Snapshot. ``` aws ec2 describe-snapshots \ --snapshot-ids snap-1234567890abcdef0 ``` Ausgabe: ``` { "Snapshots": [ { "Description": "This is my snapshot", "Encrypted": false, "VolumeId": "vol-049df61146c4d7901", "State": "completed", "VolumeSize": 8, "StartTime": "2019-02-28T21:28:32.000Z", "Progress": "100%", "OwnerId": "012345678910", "SnapshotId": "snap-01234567890abcdef", "Tags": [ { "Key": "Stack", "Value": "test" } ] } ] } ``` Weitere Informationen finden Sie unter [Amazon-EBS-Snapshots](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSSnapshots.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So beschreiben Sie Snapshots basierend auf Filtern** Im folgenden `describe-snapshots` Beispiel werden Filter verwendet, um die Ergebnisse auf Snapshots zu beschränken, die Ihrem AWS Konto gehören und sich im `pending` Bundesstaat befinden. Im Beispiel wird der `--query` Parameter verwendet, um nur den Snapshot IDs und die Uhrzeit anzuzeigen, zu der der Snapshot gestartet wurde. ``` aws ec2 describe-snapshots \ --owner-ids self \ --filters Name=status,Values=pending \ --query "Snapshots[*].{ID:SnapshotId,Time:StartTime}" ``` Ausgabe: ``` [ { "ID": "snap-1234567890abcdef0", "Time": "2019-08-04T12:48:18.000Z" }, { "ID": "snap-066877671789bd71b", "Time": "2019-08-04T02:45:16.000Z }, ... ] ``` Im folgenden Beispiel für `describe-snapshots` werden Filter verwendet, um die Ergebnisse auf Snapshots zu beschränken, die aus dem angegebenen Volume erstellt wurden. Das Beispiel verwendet den `--query` Parameter, um nur den Snapshot anzuzeigen IDs. ``` aws ec2 describe-snapshots \ --filters Name=volume-id,Values=049df61146c4d7901 \ --query "Snapshots[*].[SnapshotId]" \ --output text ``` Ausgabe: ``` snap-1234567890abcdef0 snap-08637175a712c3fb9 ... ``` Weitere Beispiele für die Verwendung von Filtern finden Sie unter [Auflisten und Filtern Ihrer Ressourcen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Filtering.html#Filtering_Resources_CLI) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 3: So beschreiben Sie Snapshots auf der Grundlage von Tags** Im folgenden Beispiel für `describe-snapshots` werden Tag-Filter verwendet, um die Ergebnisse auf Snapshots zu beschränken, die das Tag `Stack=Prod` enthalten. ``` aws ec2 describe-snapshots \ --filters Name=tag:Stack,Values=prod ``` Ein Beispiel für die Ausgabe von `describe-snapshots` finden Sie in Beispiel 1. Weitere Beispiele für die Verwendung von Tag-Filtern finden Sie unter [Arbeiten mit Tags](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_CLI) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 4: So beschreiben Sie Snapshots anhand des Alters** Im folgenden `describe-snapshots` Beispiel werden JMESPath Ausdrücke verwendet, um alle Snapshots zu beschreiben, die von Ihrem AWS Konto vor dem angegebenen Datum erstellt wurden. Es wird nur der Snapshot IDs angezeigt. ``` aws ec2 describe-snapshots \ --owner-ids 012345678910 \ --query "Snapshots[?(StartTime<='2020-03-31')].[SnapshotId]" ``` Weitere Beispiele für die Verwendung von Filtern finden Sie unter [Auflisten und Filtern Ihrer Ressourcen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Filtering.html#Filtering_Resources_CLI) im *Amazon-EC2-Benutzerhandbuch*. **Beispiel 5: So zeigen Sie nur archivierte Snapshots an** Im folgenden Beispiel für `describe-snapshots` werden ausschließlich Snapshots aufgeführt, die auf der Archivstufe gespeichert sind. ``` aws ec2 describe-snapshots \ --filters "Name=storage-tier,Values=archive" ``` Ausgabe: ``` { "Snapshots": [ { "Description": "Snap A", "Encrypted": false, "VolumeId": "vol-01234567890aaaaaa", "State": "completed", "VolumeSize": 8, "StartTime": "2021-09-07T21:00:00.000Z", "Progress": "100%", "OwnerId": "123456789012", "SnapshotId": "snap-01234567890aaaaaa", "StorageTier": "archive", "Tags": [] }, ] } ``` Weitere Informationen finden Sie unter [Archivierte Snapshots anzeigen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/working-with-snapshot-archiving.html#view-archived-snapshot) im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie [DescribeSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-snapshots.html)in der *AWS CLI Befehlsreferenz*. ### `describe-spot-datafeed-subscription` Das folgende Codebeispiel zeigt die Verwendung`describe-spot-datafeed-subscription`. **AWS CLI** **So beschreiben Sie das Daten-Feed-Abonnement für Spot Instances für ein Konto** Dieser Beispielbefehl beschreibt den Daten-Feed für das Konto. Befehl: ``` aws ec2 describe-spot-datafeed-subscription ``` Ausgabe: ``` { "SpotDatafeedSubscription": { "OwnerId": "123456789012", "Prefix": "spotdata", "Bucket": "amzn-s3-demo-bucket", "State": "Active" } } ``` + Einzelheiten zur API finden Sie [DescribeSpotDatafeedSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-spot-datafeed-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `describe-spot-fleet-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-spot-fleet-instances`. **AWS CLI** **So beschreiben Sie die Spot-Instances, die einer Spot-Flotte zugeordnet sind** Dieser Beispielbefehl listet die Spot Instances auf, die der angegebenen Spot-Flotte zugeordnet sind. Befehl: ``` aws ec2 describe-spot-fleet-instances --spot-fleet-request-id sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE ``` Ausgabe: ``` { "ActiveInstances": [ { "InstanceId": "i-1234567890abcdef0", "InstanceType": "m3.medium", "SpotInstanceRequestId": "sir-08b93456" }, ... ], "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" } ``` + Einzelheiten zur API finden Sie [DescribeSpotFleetInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-spot-fleet-instances.html)in der *AWS CLI Befehlsreferenz*. ### `describe-spot-fleet-request-history` Das folgende Codebeispiel zeigt die Verwendung`describe-spot-fleet-request-history`. **AWS CLI** **So beschreiben Sie den Verlauf der Spot-Flotte** Dieser Beispielbefehl gibt den Verlauf für die angegebene Spot-Flotte ab dem angegebenen Zeitpunkt zurück. Befehl: ``` aws ec2 describe-spot-fleet-request-history --spot-fleet-request-id sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE --start-time 2015-05-26T00:00:00Z ``` Die folgende Beispielausgabe zeigt die erfolgreichen Starts von zwei Spot Instances für die Spot-Flotte. Ausgabe: ``` { "HistoryRecords": [ { "Timestamp": "2015-05-26T23:17:20.697Z", "EventInformation": { "EventSubType": "submitted" }, "EventType": "fleetRequestChange" }, { "Timestamp": "2015-05-26T23:17:20.873Z", "EventInformation": { "EventSubType": "active" }, "EventType": "fleetRequestChange" }, { "Timestamp": "2015-05-26T23:21:21.712Z", "EventInformation": { "InstanceId": "i-1234567890abcdef0", "EventSubType": "launched" }, "EventType": "instanceChange" }, { "Timestamp": "2015-05-26T23:21:21.816Z", "EventInformation": { "InstanceId": "i-1234567890abcdef1", "EventSubType": "launched" }, "EventType": "instanceChange" } ], "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", "NextToken": "CpHNsscimcV5oH7bSbub03CI2Qms5+ypNpNm+53MNlR0YcXAkp0xFlfKf91yVxSExmbtma3awYxMFzNA663ZskT0AHtJ6TCb2Z8bQC2EnZgyELbymtWPfpZ1ZbauVg+P+TfGlWxWWB/Vr5dk5d4LfdgA/DRAHUrYgxzrEXAMPLE=", "StartTime": "2015-05-26T00:00:00Z" } ``` + Einzelheiten zur API finden Sie [DescribeSpotFleetRequestHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-spot-fleet-request-history.html)in der *AWS CLI Befehlsreferenz*. ### `describe-spot-fleet-requests` Das folgende Codebeispiel zeigt die Verwendung`describe-spot-fleet-requests`. **AWS CLI** **So beschreiben Sie die Spot-Flottenanforderungen** In diesem Beispiel werden alle Ihre Spot-Flottenanforderungen beschrieben. Befehl: ``` aws ec2 describe-spot-fleet-requests ``` Ausgabe: ``` { "SpotFleetRequestConfigs": [ { "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", "SpotFleetRequestConfig": { "TargetCapacity": 20, "LaunchSpecifications": [ { "EbsOptimized": false, "NetworkInterfaces": [ { "SubnetId": "subnet-a61dafcf", "DeviceIndex": 0, "DeleteOnTermination": false, "AssociatePublicIpAddress": true, "SecondaryPrivateIpAddressCount": 0 } ], "InstanceType": "cc2.8xlarge", "ImageId": "ami-1a2b3c4d" }, { "EbsOptimized": false, "NetworkInterfaces": [ { "SubnetId": "subnet-a61dafcf", "DeviceIndex": 0, "DeleteOnTermination": false, "AssociatePublicIpAddress": true, "SecondaryPrivateIpAddressCount": 0 } ], "InstanceType": "r3.8xlarge", "ImageId": "ami-1a2b3c4d" } ], "SpotPrice": "0.05", "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role" }, "SpotFleetRequestState": "active" }, { "SpotFleetRequestId": "sfr-306341ed-9739-402e-881b-ce47bEXAMPLE", "SpotFleetRequestConfig": { "TargetCapacity": 20, "LaunchSpecifications": [ { "EbsOptimized": false, "NetworkInterfaces": [ { "SubnetId": "subnet-6e7f829e", "DeviceIndex": 0, "DeleteOnTermination": false, "AssociatePublicIpAddress": true, "SecondaryPrivateIpAddressCount": 0 } ], "InstanceType": "m3.medium", "ImageId": "ami-1a2b3c4d" } ], "SpotPrice": "0.05", "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role" }, "SpotFleetRequestState": "active" } ] } ``` **So beschreiben Sie eine Spot-Flottenanforderung** In diesem Beispiel wird die angegebene Spot-Flottenanforderung beschrieben. Befehl: ``` aws ec2 describe-spot-fleet-requests --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE ``` Ausgabe: ``` { "SpotFleetRequestConfigs": [ { "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", "SpotFleetRequestConfig": { "TargetCapacity": 20, "LaunchSpecifications": [ { "EbsOptimized": false, "NetworkInterfaces": [ { "SubnetId": "subnet-a61dafcf", "DeviceIndex": 0, "DeleteOnTermination": false, "AssociatePublicIpAddress": true, "SecondaryPrivateIpAddressCount": 0 } ], "InstanceType": "cc2.8xlarge", "ImageId": "ami-1a2b3c4d" }, { "EbsOptimized": false, "NetworkInterfaces": [ { "SubnetId": "subnet-a61dafcf", "DeviceIndex": 0, "DeleteOnTermination": false, "AssociatePublicIpAddress": true, "SecondaryPrivateIpAddressCount": 0 } ], "InstanceType": "r3.8xlarge", "ImageId": "ami-1a2b3c4d" } ], "SpotPrice": "0.05", "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role" }, "SpotFleetRequestState": "active" } ] } ``` + Einzelheiten zur API finden Sie [DescribeSpotFleetRequests](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-spot-fleet-requests.html)in der *AWS CLI Befehlsreferenz*. ### `describe-spot-instance-requests` Das folgende Codebeispiel zeigt die Verwendung`describe-spot-instance-requests`. **AWS CLI** **Beispiel 1: So beschreiben Sie eine Spot-Instance-Anforderung** Im folgenden Beispiel für `describe-spot-instance-requests` wird die angegebene Spot-Instance-Anforderung beschrieben. ``` aws ec2 describe-spot-instance-requests \ --spot-instance-request-ids sir-08b93456 ``` Ausgabe: ``` { "SpotInstanceRequests": [ { "CreateTime": "2018-04-30T18:14:55.000Z", "InstanceId": "i-1234567890abcdef1", "LaunchSpecification": { "InstanceType": "t2.micro", "ImageId": "ami-003634241a8fcdec0", "KeyName": "my-key-pair", "SecurityGroups": [ { "GroupName": "default", "GroupId": "sg-e38f24a7" } ], "BlockDeviceMappings": [ { "DeviceName": "/dev/sda1", "Ebs": { "DeleteOnTermination": true, "SnapshotId": "snap-0e54a519c999adbbd", "VolumeSize": 8, "VolumeType": "standard", "Encrypted": false } } ], "NetworkInterfaces": [ { "DeleteOnTermination": true, "DeviceIndex": 0, "SubnetId": "subnet-049df61146c4d7901" } ], "Placement": { "AvailabilityZone": "us-east-2b", "Tenancy": "default" }, "Monitoring": { "Enabled": false } }, "LaunchedAvailabilityZone": "us-east-2b", "ProductDescription": "Linux/UNIX", "SpotInstanceRequestId": "sir-08b93456", "SpotPrice": "0.010000" "State": "active", "Status": { "Code": "fulfilled", "Message": "Your Spot request is fulfilled.", "UpdateTime": "2018-04-30T18:16:21.000Z" }, "Tags": [], "Type": "one-time", "InstanceInterruptionBehavior": "terminate" } ] } ``` **Beispiel 2: So beschreiben Sie Spot-Instance-Anforderungen basierend auf Filtern** Im folgenden Beispiel für `describe-spot-instance-requests` werden Filter verwendet, um die Ergebnisse auf Spot Instances mit dem angegebenen Instance-Typ in der festgelegten Availability Zone zu beschränken. Das Beispiel verwendet den `--query` Parameter, um nur die Instanz anzuzeigen IDs. ``` aws ec2 describe-spot-instance-requests \ --filters Name=launch.instance-type,Values=m3.medium Name=launched-availability-zone,Values=us-east-2a \ --query "SpotInstanceRequests[*].[InstanceId]" \ --output text ``` Ausgabe: ``` i-057750d42936e468a i-001efd250faaa6ffa i-027552a73f021f3bd ... ``` Weitere Beispiele für die Verwendung von Filtern finden Sie unter [Listing and filtering your resources](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Filtering.html#Filtering_Resources_CLI) im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. **Beispiel 3: So beschreiben Sie Spot-Instance-Anforderungen basierend auf Tags** Im folgenden Beispiel für `describe-spot-instance-requests` werden Tag-Filter verwendet, um die Ergebnisse auf Spot-Instance-Anforderungen zu beschränken, die das Tag `cost-center=cc123` enthalten. ``` aws ec2 describe-spot-instance-requests \ --filters Name=tag:cost-center,Values=cc123 ``` Ein Beispiel für die Ausgabe von `describe-spot-instance-requests` finden Sie in Beispiel 1. Weitere Beispiele für die Verwendung von Tag-Filtern finden Sie unter [Arbeiten mit Tags](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_CLI) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeSpotInstanceRequests](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-spot-instance-requests.html)unter *AWS CLI Befehlsreferenz*. ### `describe-spot-price-history` Das folgende Codebeispiel zeigt die Verwendung`describe-spot-price-history`. **AWS CLI** **So beschreiben Sie den Spot-Preisverlauf** Dieser Beispielbefehl gibt den Spot-Preisverlauf für m1.xlarge-Instances für einen bestimmten Tag im Januar zurück. Befehl: ``` aws ec2 describe-spot-price-history --instance-types m1.xlarge --start-time 2014-01-06T07:08:09 --end-time 2014-01-06T08:09:10 ``` Ausgabe: ``` { "SpotPriceHistory": [ { "Timestamp": "2014-01-06T07:10:55.000Z", "ProductDescription": "SUSE Linux", "InstanceType": "m1.xlarge", "SpotPrice": "0.087000", "AvailabilityZone": "us-west-1b" }, { "Timestamp": "2014-01-06T07:10:55.000Z", "ProductDescription": "SUSE Linux", "InstanceType": "m1.xlarge", "SpotPrice": "0.087000", "AvailabilityZone": "us-west-1c" }, { "Timestamp": "2014-01-06T05:42:36.000Z", "ProductDescription": "SUSE Linux (Amazon VPC)", "InstanceType": "m1.xlarge", "SpotPrice": "0.087000", "AvailabilityZone": "us-west-1a" }, ... } ``` **Um die Spot-Preisentwicklung für Linux/UNIX Amazon VPC zu beschreiben** Dieser Beispielbefehl gibt den Spot-Preisverlauf für m1.xlarge, Linux/UNIX Amazon VPC-Instances für einen bestimmten Tag im Januar zurück. Befehl: ``` aws ec2 describe-spot-price-history --instance-types m1.xlarge --product-description "Linux/UNIX (Amazon VPC)" --start-time 2014-01-06T07:08:09 --end-time 2014-01-06T08:09:10 ``` Ausgabe: ``` { "SpotPriceHistory": [ { "Timestamp": "2014-01-06T04:32:53.000Z", "ProductDescription": "Linux/UNIX (Amazon VPC)", "InstanceType": "m1.xlarge", "SpotPrice": "0.080000", "AvailabilityZone": "us-west-1a" }, { "Timestamp": "2014-01-05T11:28:26.000Z", "ProductDescription": "Linux/UNIX (Amazon VPC)", "InstanceType": "m1.xlarge", "SpotPrice": "0.080000", "AvailabilityZone": "us-west-1c" } ] } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DescribeSpotPriceHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-spot-price-history.html).AWS CLI * ### `describe-stale-security-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-stale-security-groups`. **AWS CLI** **So beschreiben Sie veraltete Sicherheitsgruppen** In diesem Beispiel werden veraltete Sicherheitsgruppenregeln für `vpc-11223344` beschrieben. Die Antwort zeigt, dass sg-5fa68d3a in Ihrem Konto über eine veraltete SSH-Eingangsregel verfügt, die auf `sg-279ab042` in der Peer-VPC verweist, und dass `sg-fe6fba9a` in Ihrem Konto eine veraltete SSH-Ausgangsregel hat, die `sg-ef6fba8b` in der Peer-VPC referenziert. Befehl: ``` aws ec2 describe-stale-security-groups --vpc-id vpc-11223344 ``` Ausgabe: ``` { "StaleSecurityGroupSet": [ { "VpcId": "vpc-11223344", "StaleIpPermissionsEgress": [ { "ToPort": 22, "FromPort": 22, "UserIdGroupPairs": [ { "VpcId": "vpc-7a20e51f", "GroupId": "sg-ef6fba8b", "VpcPeeringConnectionId": "pcx-b04deed9", "PeeringStatus": "active" } ], "IpProtocol": "tcp" } ], "GroupName": "MySG1", "StaleIpPermissions": [], "GroupId": "sg-fe6fba9a", "Description": MySG1" }, { "VpcId": "vpc-11223344", "StaleIpPermissionsEgress": [], "GroupName": "MySG2", "StaleIpPermissions": [ { "ToPort": 22, "FromPort": 22, "UserIdGroupPairs": [ { "VpcId": "vpc-7a20e51f", "GroupId": "sg-279ab042", "Description": "Access from pcx-b04deed9", "VpcPeeringConnectionId": "pcx-b04deed9", "PeeringStatus": "active" } ], "IpProtocol": "tcp" } ], "GroupId": "sg-5fa68d3a", "Description": "MySG2" } ] } ``` + Einzelheiten zur API finden Sie [DescribeStaleSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-stale-security-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-store-image-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-store-image-tasks`. **AWS CLI** **So beschreiben Sie den Fortschritt einer AMI-Speicheraufgabe** Im folgenden Beispiel für `describe-store-image-tasks` wird der Fortschritt einer AMI-Speicheraufgabe beschrieben. ``` aws ec2 describe-store-image-tasks ``` Ausgabe: ``` { "StoreImageTaskResults": [ { "AmiId": "ami-1234567890abcdef0", "Bucket": "my-ami-bucket", "ProgressPercentage": 17, "S3objectKey": "ami-1234567890abcdef0.bin", "StoreTaskState": "InProgress", "StoreTaskFailureReason": null, "TaskStartTime": "2022-01-01T01:01:01.001Z" } ] } ``` *Weitere Informationen zum Speichern und Wiederherstellen eines AMI mit S3 finden Sie unter Speichern und Wiederherstellen eines AMI mit S3 im Amazon EC2 EC2-Benutzerhandbuch.* + Einzelheiten [DescribeStoreImageTasks AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-store-image-tasks.html)*zur* API finden Sie in der Befehlsreferenz. ### `describe-subnets` Das folgende Codebeispiel zeigt die Verwendung`describe-subnets`. **AWS CLI** **Beispiel 1: So beschreiben Sie Ihre Subnetze** Im folgenden Beispiel für `describe-subnets` werden die Details zu Ihren Subnetzen angezeigt. ``` aws ec2 describe-subnets ``` Ausgabe: ``` { "Subnets": [ { "AvailabilityZone": "us-east-1d", "AvailabilityZoneId": "use1-az2", "AvailableIpAddressCount": 4089, "CidrBlock": "172.31.80.0/20", "DefaultForAz": true, "MapPublicIpOnLaunch": false, "MapCustomerOwnedIpOnLaunch": true, "State": "available", "SubnetId": "subnet-0bb1c79de3EXAMPLE", "VpcId": "vpc-0ee975135dEXAMPLE", "OwnerId": "111122223333", "AssignIpv6AddressOnCreation": false, "Ipv6CidrBlockAssociationSet": [], "CustomerOwnedIpv4Pool:": 'pool-2EXAMPLE', "SubnetArn": "arn:aws:ec2:us-east-2:111122223333:subnet/subnet-0bb1c79de3EXAMPLE", "EnableDns64": false, "Ipv6Native": false, "PrivateDnsNameOptionsOnLaunch": { "HostnameType": "ip-name", "EnableResourceNameDnsARecord": false, "EnableResourceNameDnsAAAARecord": false } }, { "AvailabilityZone": "us-east-1d", "AvailabilityZoneId": "use1-az2", "AvailableIpAddressCount": 4089, "CidrBlock": "172.31.80.0/20", "DefaultForAz": true, "MapPublicIpOnLaunch": true, "MapCustomerOwnedIpOnLaunch": false, "State": "available", "SubnetId": "subnet-8EXAMPLE", "VpcId": "vpc-3EXAMPLE", "OwnerId": "1111222233333", "AssignIpv6AddressOnCreation": false, "Ipv6CidrBlockAssociationSet": [], "Tags": [ { "Key": "Name", "Value": "MySubnet" } ], "SubnetArn": "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-8EXAMPLE", "EnableDns64": false, "Ipv6Native": false, "PrivateDnsNameOptionsOnLaunch": { "HostnameType": "ip-name", "EnableResourceNameDnsARecord": false, "EnableResourceNameDnsAAAARecord": false } } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit VPCs und Subnetzen](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html) im *AWS VPC-Benutzerhandbuch*. **Beispiel 2: So beschreiben Sie die Subnetze einer bestimmten VPC** Im folgenden Beispiel für `describe-subnets` wird ein Filter verwendet, um Details für die Subnetze der angegebenen VPC abzurufen. ``` aws ec2 describe-subnets \ --filters "Name=vpc-id,Values=vpc-3EXAMPLE" ``` Ausgabe: ``` { "Subnets": [ { "AvailabilityZone": "us-east-1d", "AvailabilityZoneId": "use1-az2", "AvailableIpAddressCount": 4089, "CidrBlock": "172.31.80.0/20", "DefaultForAz": true, "MapPublicIpOnLaunch": true, "MapCustomerOwnedIpOnLaunch": false, "State": "available", "SubnetId": "subnet-8EXAMPLE", "VpcId": "vpc-3EXAMPLE", "OwnerId": "1111222233333", "AssignIpv6AddressOnCreation": false, "Ipv6CidrBlockAssociationSet": [], "Tags": [ { "Key": "Name", "Value": "MySubnet" } ], "SubnetArn": "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-8EXAMPLE", "EnableDns64": false, "Ipv6Native": false, "PrivateDnsNameOptionsOnLaunch": { "HostnameType": "ip-name", "EnableResourceNameDnsARecord": false, "EnableResourceNameDnsAAAARecord": false } } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit VPCs und Subnetzen](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html) im *AWS VPC-Benutzerhandbuch*. **Beispiel 3: So beschreiben Sie die Subnetze mit einem bestimmten Tag** Das folgende `describe-subnets` Beispiel verwendet einen Filter, um die Details der Subnetze mit dem Tag abzurufen, `CostCenter=123` und den `--query` Parameter, um das Subnetz IDs der Subnetze mit diesem Tag anzuzeigen. ``` aws ec2 describe-subnets \ --filters "Name=tag:CostCenter,Values=123" \ --query "Subnets[*].SubnetId" \ --output text ``` Ausgabe: ``` subnet-0987a87c8b37348ef subnet-02a95061c45f372ee subnet-03f720e7de2788d73 ``` Weitere Informationen finden Sie unter [Arbeiten mit VPCs und Subnetzen](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html) im *Amazon VPC-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeSubnets AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-subnets.html)*Befehlsreferenz*. ### `describe-tags` Das folgende Codebeispiel zeigt die Verwendung`describe-tags`. **AWS CLI** **Beispiel 1: So beschreiben Sie alle Tags für eine einzelne Ressource** Im folgenden Beispiel für `describe-tags` werden die Tags für die angegebene Instance beschrieben. ``` aws ec2 describe-tags \ --filters "Name=resource-id,Values=i-1234567890abcdef8" ``` Ausgabe: ``` { "Tags": [ { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef8", "Value": "Test", "Key": "Stack" }, { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef8", "Value": "Beta Server", "Key": "Name" } ] } ``` **Beispiel 2: So beschreiben Sie alle Tags für einen Ressourcentyp** Im folgenden Beispiel für `describe-tags` werden die Tags für Ihre Volumes beschrieben. ``` aws ec2 describe-tags \ --filters "Name=resource-type,Values=volume" ``` Ausgabe: ``` { "Tags": [ { "ResourceType": "volume", "ResourceId": "vol-1234567890abcdef0", "Value": "Project1", "Key": "Purpose" }, { "ResourceType": "volume", "ResourceId": "vol-049df61146c4d7901", "Value": "Logs", "Key": "Purpose" } ] } ``` **Beispiel 3: So beschreiben Sie alle Ihre Tags** Im folgenden Beispiel für `describe-tags` werden die Tags für alle Ihre Ressourcen beschrieben. ``` aws ec2 describe-tags ``` **Beispiel 4: So beschreiben Sie die Tags für Ihre Ressourcen anhand eines Tag-Schlüssels** Im folgenden Beispiel für `describe-tags` werden die Tags für Ihre Ressourcen beschrieben, die über ein Tag mit dem Schlüssel `Stack` verfügen. ``` aws ec2 describe-tags \ --filters Name=key,Values=Stack ``` Ausgabe: ``` { "Tags": [ { "ResourceType": "volume", "ResourceId": "vol-027552a73f021f3b", "Value": "Production", "Key": "Stack" }, { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef8", "Value": "Test", "Key": "Stack" } ] } ``` **Beispiel 5: So beschreiben Sie die Tags für Ihre Ressourcen anhand eines Tag-Schlüssels und eines Tag-Werts** Im folgenden Beispiel für `describe-tags` werden die Tags für Ihre Ressourcen beschrieben, die über das Tag `Stack=Test` verfügen. ``` aws ec2 describe-tags \ --filters Name=key,Values=Stack Name=value,Values=Test ``` Ausgabe: ``` { "Tags": [ { "ResourceType": "image", "ResourceId": "ami-3ac336533f021f3bd", "Value": "Test", "Key": "Stack" }, { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef8", "Value": "Test", "Key": "Stack" } ] } ``` Im folgenden Beispiel für `describe-tags` wird eine alternative Syntax verwendet, um Ressourcen mit dem Tag `Stack=Test` zu beschreiben. ``` aws ec2 describe-tags \ --filters "Name=tag:Stack,Values=Test" ``` Im folgenden Beispiel für `describe-tags` werden die Tags für alle Ihre Instances beschrieben, die über ein Tag mit dem Schlüssel `Purpose` verfügen und keinen Wert haben. ``` aws ec2 describe-tags \ --filters "Name=resource-type,Values=instance" "Name=key,Values=Purpose" "Name=value,Values=" ``` Ausgabe: ``` { "Tags": [ { "ResourceType": "instance", "ResourceId": "i-1234567890abcdef5", "Value": null, "Key": "Purpose" } ] } ``` + Einzelheiten zur API finden Sie [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-tags.html)in der *AWS CLI Befehlsreferenz*. ### `describe-traffic-mirror-filters` Das folgende Codebeispiel zeigt die Verwendung`describe-traffic-mirror-filters`. **AWS CLI** **So zeigen Sie Ihre Datenverkehr-Spiegelungsfilter an** Im folgenden Beispiel für `describe-traffic-mirror-filters` werden Details für alle Ihre Datenverkehr-Spiegelungsfilter angezeigt. ``` aws ec2 describe-traffic-mirror-filters ``` Ausgabe: ``` { "TrafficMirrorFilters": [ { "TrafficMirrorFilterId": "tmf-0293f26e86EXAMPLE", "IngressFilterRules": [ { "TrafficMirrorFilterRuleId": "tmfr-0ca76e0e08EXAMPLE", "TrafficMirrorFilterId": "tmf-0293f26e86EXAMPLE", "TrafficDirection": "ingress", "RuleNumber": 100, "RuleAction": "accept", "Protocol": 6, "DestinationCidrBlock": "10.0.0.0/24", "SourceCidrBlock": "10.0.0.0/24", "Description": "TCP Rule" } ], "EgressFilterRules": [], "NetworkServices": [], "Description": "Example filter", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Anzeigen Ihrer Datenverkehr-Spiegelungsfilter](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-filter.html#view-traffic-mirroring-filter) im Benutzerhandbuch zu *Traffic Mirroring*. + Einzelheiten zur API finden Sie [DescribeTrafficMirrorFilters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-traffic-mirror-filters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-traffic-mirror-sessions` Das folgende Codebeispiel zeigt die Verwendung`describe-traffic-mirror-sessions`. **AWS CLI** **So beschreiben Sie eine Datenverkehr-Spiegelungssitzung** Im folgenden Beispiel für `describe-traffic-mirror-sessions` werden Details Ihrer Datenverkehr-Spiegelungssitzungen angezeigt. ``` aws ec2 describe-traffic-mirror-sessions ``` Ausgabe: ``` { "TrafficMirrorSessions": [ { "Tags": [], "VirtualNetworkId": 42, "OwnerId": "111122223333", "Description": "TCP Session", "NetworkInterfaceId": "eni-0a471a5cf3EXAMPLE", "TrafficMirrorTargetId": "tmt-0dabe9b0a6EXAMPLE", "TrafficMirrorFilterId": "tmf-083e18f985EXAMPLE", "PacketLength": 20, "SessionNumber": 1, "TrafficMirrorSessionId": "tms-0567a4c684EXAMPLE" }, { "Tags": [ { "Key": "Name", "Value": "tag test" } ], "VirtualNetworkId": 13314501, "OwnerId": "111122223333", "Description": "TCP Session", "NetworkInterfaceId": "eni-0a471a5cf3EXAMPLE", "TrafficMirrorTargetId": "tmt-03665551cbEXAMPLE", "TrafficMirrorFilterId": "tmf-06c787846cEXAMPLE", "SessionNumber": 2, "TrafficMirrorSessionId": "tms-0060101cf8EXAMPLE" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen der Details einer Datenverkehr-Spiegelungssitzung](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-session.html#view-traffic-mirroring-session) im *Handbuch für AWS Traffic Mirroring*. + Einzelheiten zur API finden Sie [DescribeTrafficMirrorSessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-traffic-mirror-sessions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-traffic-mirror-targets` Das folgende Codebeispiel zeigt die Verwendung`describe-traffic-mirror-targets`. **AWS CLI** **So beschreiben Sie ein Datenverkehr-Spiegelungsziel** Im folgenden Beispiel für `describe-traffic-mirror-targets` werden Informationen zu dem angegebenen Datenverkehr-Spiegelungsziel angezeigt. ``` aws ec2 describe-traffic-mirror-targets \ --traffic-mirror-target-ids tmt-0dabe9b0a6EXAMPLE ``` Ausgabe: ``` { "TrafficMirrorTargets": [ { "TrafficMirrorTargetId": "tmt-0dabe9b0a6EXAMPLE", "NetworkLoadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/net/NLB/7cdec873fEXAMPLE", "Type": "network-load-balancer", "Description": "Example Network Load Balancer target", "OwnerId": "111122223333", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Datenverkehr-Spiegelungsziele](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-target.html) im *Handbuch für Amazon VPC Traffic Mirroring*. + Einzelheiten zur API finden Sie [DescribeTrafficMirrorTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-traffic-mirror-targets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transit-gateway-attachments` Das folgende Codebeispiel zeigt die Verwendung`describe-transit-gateway-attachments`. **AWS CLI** **So zeigen Sie Ihre Transit-Gateway-Anhänge an** Im folgenden Beispiel für `describe-transit-gateway-attachments` werden Details zu Ihren Transit-Gateway-Anhängen angezeigt. ``` aws ec2 describe-transit-gateway-attachments ``` Ausgabe: ``` { "TransitGatewayAttachments": [ { "TransitGatewayAttachmentId": "tgw-attach-01f8100bc7EXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "TransitGatewayOwnerId": "123456789012", "ResourceOwnerId": "123456789012", "ResourceType": "vpc", "ResourceId": "vpc-3EXAMPLE", "State": "available", "Association": { "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE", "State": "associated" }, "CreationTime": "2019-08-26T14:59:25.000Z", "Tags": [ { "Key": "Name", "Value": "Example" } ] }, { "TransitGatewayAttachmentId": "tgw-attach-0b5968d3b6EXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "TransitGatewayOwnerId": "123456789012", "ResourceOwnerId": "123456789012", "ResourceType": "vpc", "ResourceId": "vpc-0065acced4EXAMPLE", "State": "available", "Association": { "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE", "State": "associated" }, "CreationTime": "2019-08-07T17:03:07.000Z", "Tags": [] }, { "TransitGatewayAttachmentId": "tgw-attach-08e0bc912cEXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "TransitGatewayOwnerId": "123456789012", "ResourceOwnerId": "123456789012", "ResourceType": "direct-connect-gateway", "ResourceId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE", "State": "available", "Association": { "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE", "State": "associated" }, "CreationTime": "2019-08-14T20:27:44.000Z", "Tags": [] }, { "TransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "TransitGatewayOwnerId": "123456789012", "ResourceOwnerId": "123456789012", "ResourceType": "direct-connect-gateway", "ResourceId": "8384da05-13ce-4a91-aada-5a1baEXAMPLE", "State": "available", "Association": { "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE", "State": "associated" }, "CreationTime": "2019-08-14T20:33:02.000Z", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Transit-Gateways](https://docs.aws.amazon.com/vpc/latest/tgw/working-with-transit-gateways.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [DescribeTransitGatewayAttachments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-transit-gateway-attachments.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transit-gateway-connect-peers` Das folgende Codebeispiel zeigt die Verwendung`describe-transit-gateway-connect-peers`. **AWS CLI** **So beschreiben Sie einen Verbindungs-Peer in Transit Gateway** Im folgenden Beispiel für `describe-transit-gateway-connect-peers` wird der angegebene Verbindungs-Peer beschrieben. ``` aws ec2 describe-transit-gateway-connect-peers \ --transit-gateway-connect-peer-ids tgw-connect-peer-0666adbac4EXAMPLE ``` Ausgabe: ``` { "TransitGatewayConnectPeers": [ { "TransitGatewayAttachmentId": "tgw-attach-0f0927767cEXAMPLE", "TransitGatewayConnectPeerId": "tgw-connect-peer-0666adbac4EXAMPLE", "State": "available", "CreationTime": "2021-10-13T03:35:17.000Z", "ConnectPeerConfiguration": { "TransitGatewayAddress": "10.0.0.234", "PeerAddress": "172.31.1.11", "InsideCidrBlocks": [ "169.254.6.0/29" ], "Protocol": "gre", "BgpConfigurations": [ { "TransitGatewayAsn": 64512, "PeerAsn": 64512, "TransitGatewayAddress": "169.254.6.2", "PeerAddress": "169.254.6.1", "BgpStatus": "down" }, { "TransitGatewayAsn": 64512, "PeerAsn": 64512, "TransitGatewayAddress": "169.254.6.3", "PeerAddress": "169.254.6.1", "BgpStatus": "down" } ] }, "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Connect-Anhänge und Connect-Peers in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-connect.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DescribeTransitGatewayConnectPeers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-transit-gateway-connect-peers.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transit-gateway-connects` Das folgende Codebeispiel zeigt die Verwendung`describe-transit-gateway-connects`. **AWS CLI** **So beschreiben Sie einen Verbindungsanhang in Transit Gateway** Im folgenden Beispiel für `describe-transit-gateway-connects` wird der angegebene Verbindungsanhang beschrieben. ``` aws ec2 describe-transit-gateway-connects \ --transit-gateway-attachment-ids tgw-attach-037012e5dcEXAMPLE ``` Ausgabe: ``` { "TransitGatewayConnects": [ { "TransitGatewayAttachmentId": "tgw-attach-037012e5dcEXAMPLE", "TransportTransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE", "TransitGatewayId": "tgw-02f776b1a7EXAMPLE", "State": "available", "CreationTime": "2021-03-09T19:59:17+00:00", "Options": { "Protocol": "gre" }, "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Connect-Anhänge und Connect-Peers in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-connect.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DescribeTransitGatewayConnects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-transit-gateway-connects.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transit-gateway-multicast-domains` Das folgende Codebeispiel zeigt die Verwendung`describe-transit-gateway-multicast-domains`. **AWS CLI** **So beschreiben Sie Ihre Multicast-Domain in Transit Gateway** Im folgenden Beispiel für `describe-transit-gateway-multicast-domains` werden Details zu allen Ihren Multicast-Domains in Transit Gateway angezeigt. ``` aws ec2 describe-transit-gateway-multicast-domains ``` Ausgabe: ``` { "TransitGatewayMulticastDomains": [ { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-000fb24d04EXAMPLE", "TransitGatewayId": "tgw-0bf0bffefaEXAMPLE", "TransitGatewayMulticastDomainArn": "arn:aws:ec2:us-east-1:123456789012:transit-gateway-multicast-domain/tgw-mcast-domain-000fb24d04EXAMPLE", "OwnerId": "123456789012", "Options": { "Igmpv2Support": "disable", "StaticSourcesSupport": "enable", "AutoAcceptSharedAssociations": "disable" }, "State": "available", "CreationTime": "2019-12-10T18:32:50+00:00", "Tags": [ { "Key": "Name", "Value": "mc1" } ] } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Multicast-Domains](https://docs.aws.amazon.com/vpc/latest/tgw/manage-domain.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DescribeTransitGatewayMulticastDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-transit-gateway-multicast-domains.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transit-gateway-peering-attachments` Das folgende Codebeispiel zeigt die Verwendung`describe-transit-gateway-peering-attachments`. **AWS CLI** **So beschreiben Sie Ihre Peering-Anhänge in Transit Gateway** Im folgenden Beispiel für `describe-transit-gateway-peering-attachments` werden Details zu Ihren Peering-Anhängen in Transit Gateway angezeigt. ``` aws ec2 describe-transit-gateway-peering-attachments ``` Ausgabe: ``` { "TransitGatewayPeeringAttachments": [ { "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd", "RequesterTgwInfo": { "TransitGatewayId": "tgw-123abc05e04123abc", "OwnerId": "123456789012", "Region": "us-west-2" }, "AccepterTgwInfo": { "TransitGatewayId": "tgw-11223344aabbcc112", "OwnerId": "123456789012", "Region": "us-east-2" }, "State": "pendingAcceptance", "CreationTime": "2019-12-09T11:38:05.000Z", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Anhänge von Transit-Gateway-Peering](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-peering.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [DescribeTransitGatewayPeeringAttachments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-transit-gateway-peering-attachments.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transit-gateway-policy-tables` Das folgende Codebeispiel zeigt die Verwendung`describe-transit-gateway-policy-tables`. **AWS CLI** **So beschreiben Sie eine Transit-Gateway-Richtlinientabelle** Im folgenden Beispiel für `describe-transit-gateway-policy-tables` wird die angegebene Transit-Gateway-Richtlinientabelle beschrieben. ``` aws ec2 describe-transit-gateway-policy-tables \ --transit-gateway-policy-table-ids tgw-ptb-0a16f134b78668a81 ``` Ausgabe: ``` { "TransitGatewayPolicyTables": [ { "TransitGatewayPolicyTableId": "tgw-ptb-0a16f134b78668a81", "TransitGatewayId": "tgw-067f8505c18f0bd6e", "State": "available", "CreationTime": "2023-11-28T16:36:43+00:00", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Transit-Gateway-Richtlinientabellen](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-policy-tables.html) im *Benutzerhandbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [DescribeTransitGatewayPolicyTables](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-transit-gateway-policy-tables.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transit-gateway-route-tables` Das folgende Codebeispiel zeigt die Verwendung`describe-transit-gateway-route-tables`. **AWS CLI** **So beschreiben Sie die Routing-Tabellen in Transit Gateway** Im folgenden Beispiel für `describe-transit-gateway-route-tables` werden Details zu Ihren Routing-Tabellen in Transit Gateway angezeigt. ``` aws ec2 describe-transit-gateway-route-tables ``` Ausgabe: ``` { "TransitGatewayRouteTables": [ { "TransitGatewayRouteTableId": "tgw-rtb-0ca78a549EXAMPLE", "TransitGatewayId": "tgw-0bc994abffEXAMPLE", "State": "available", "DefaultAssociationRouteTable": true, "DefaultPropagationRouteTable": true, "CreationTime": "2018-11-28T14:24:49.000Z", "Tags": [] }, { "TransitGatewayRouteTableId": "tgw-rtb-0e8f48f148EXAMPLE", "TransitGatewayId": "tgw-0043d72bb4EXAMPLE", "State": "available", "DefaultAssociationRouteTable": true, "DefaultPropagationRouteTable": true, "CreationTime": "2018-11-28T14:24:00.000Z", "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Anzeigen von Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html#view-tgw-route-tables) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [DescribeTransitGatewayRouteTables](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-transit-gateway-route-tables.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transit-gateway-vpc-attachments` Das folgende Codebeispiel zeigt die Verwendung`describe-transit-gateway-vpc-attachments`. **AWS CLI** **So beschreiben Sie Ihre VPC-Anhänge in Transit Gateway** Im folgenden Beispiel für `describe-transit-gateway-vpc-attachments` werden Details zu Ihren VPC-Anhängen in Transit Gateway angezeigt. ``` aws ec2 describe-transit-gateway-vpc-attachments ``` Ausgabe: ``` { "TransitGatewayVpcAttachments": [ { "TransitGatewayAttachmentId": "tgw-attach-0a08e88308EXAMPLE", "TransitGatewayId": "tgw-0043d72bb4EXAMPLE", "VpcId": "vpc-0f501f7ee8EXAMPLE", "VpcOwnerId": "111122223333", "State": "available", "SubnetIds": [ "subnet-045d586432EXAMPLE", "subnet-0a0ad478a6EXAMPLE" ], "CreationTime": "2019-02-13T11:04:02.000Z", "Options": { "DnsSupport": "enable", "Ipv6Support": "disable" }, "Tags": [ { "Key": "Name", "Value": "attachment name" } ] } ] } ``` Weitere Informationen finden Sie unter [Anzeigen Ihrer VPC-Anhänge](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html#view-vpc-attachment) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [DescribeTransitGatewayVpcAttachments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-transit-gateway-vpc-attachments.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transit-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-transit-gateways`. **AWS CLI** **So beschreiben Sie Ihre Transit-Gateways** Im folgenden Beispiel für `describe-transit-gateways` werden Details über Ihre Transit-Gateways abgerufen. ``` aws ec2 describe-transit-gateways ``` Ausgabe: ``` { "TransitGateways": [ { "TransitGatewayId": "tgw-0262a0e521EXAMPLE", "TransitGatewayArn": "arn:aws:ec2:us-east-2:111122223333:transit-gateway/tgw-0262a0e521EXAMPLE", "State": "available", "OwnerId": "111122223333", "Description": "MyTGW", "CreationTime": "2019-07-10T14:02:12.000Z", "Options": { "AmazonSideAsn": 64516, "AutoAcceptSharedAttachments": "enable", "DefaultRouteTableAssociation": "enable", "AssociationDefaultRouteTableId": "tgw-rtb-018774adf3EXAMPLE", "DefaultRouteTablePropagation": "enable", "PropagationDefaultRouteTableId": "tgw-rtb-018774adf3EXAMPLE", "VpnEcmpSupport": "enable", "DnsSupport": "enable" }, "Tags": [] }, { "TransitGatewayId": "tgw-0fb8421e2dEXAMPLE", "TransitGatewayArn": "arn:aws:ec2:us-east-2:111122223333:transit-gateway/tgw-0fb8421e2da853bf3", "State": "available", "OwnerId": "111122223333", "CreationTime": "2019-03-15T22:57:33.000Z", "Options": { "AmazonSideAsn": 65412, "AutoAcceptSharedAttachments": "disable", "DefaultRouteTableAssociation": "enable", "AssociationDefaultRouteTableId": "tgw-rtb-06a241a3d8EXAMPLE", "DefaultRouteTablePropagation": "enable", "PropagationDefaultRouteTableId": "tgw-rtb-06a241a3d8EXAMPLE", "VpnEcmpSupport": "enable", "DnsSupport": "enable" }, "Tags": [ { "Key": "Name", "Value": "TGW1" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeTransitGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-transit-gateways.html)in der *AWS CLI Befehlsreferenz*. ### `describe-verified-access-endpoints` Das folgende Codebeispiel zeigt die Verwendung`describe-verified-access-endpoints`. **AWS CLI** **So beschreiben Sie einen Verified-Access-Endpunkt** Im folgenden Beispiel für `describe-verified-access-endpoints` wird der angegebene Verified-Access-Endpunkt beschrieben. ``` aws ec2 describe-verified-access-endpoints \ --verified-access-endpoint-ids vae-066fac616d4d546f2 ``` Ausgabe: ``` { "VerifiedAccessEndpoints": [ { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235", "VerifiedAccessEndpointId": "vae-066fac616d4d546f2", "ApplicationDomain": "example.com", "EndpointType": "network-interface", "AttachmentType": "vpc", "DomainCertificateArn": "arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE", "EndpointDomain": "my-ava-app.edge-00c3372d53b1540bb.vai-0ce000c0b7643abea.prod.verified-access.us-east-2.amazonaws.com", "SecurityGroupIds": [ "sg-004915970c4c8f13a" ], "NetworkInterfaceOptions": { "NetworkInterfaceId": "eni-0aec70418c8d87a0f", "Protocol": "https", "Port": 443 }, "Status": { "Code": "active" }, "Description": "", "CreationTime": "2023-08-25T20:54:43", "LastUpdatedTime": "2023-08-25T22:17:26", "Tags": [ { "Key": "Name", "Value": "my-va-endpoint" } ] } ] } ``` Weitere Informationen finden Sie unter [Verified-Access-Endpunkte](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-endpoints.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DescribeVerifiedAccessEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-verified-access-endpoints.html)in der *AWS CLI Befehlsreferenz*. ### `describe-verified-access-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-verified-access-groups`. **AWS CLI** **So beschreiben Sie eine Verified-Access-Gruppe** Im folgenden Beispiel für `describe-verified-access-groups` wird die angegebene verifizierte Zugriffsgruppe beschrieben. ``` aws ec2 describe-verified-access-groups \ --verified-access-group-ids vagr-0dbe967baf14b7235 ``` Ausgabe: ``` { "VerifiedAccessGroups": [ { "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235", "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "Testing Verified Access", "Owner": "123456789012", "VerifiedAccessGroupArn": "arn:aws:ec2:us-east-2:123456789012:verified-access-group/vagr-0dbe967baf14b7235", "CreationTime": "2023-08-25T19:55:19", "LastUpdatedTime": "2023-08-25T22:17:25", "Tags": [ { "Key": "Name", "Value": "my-va-group" } ] } ] } ``` Weitere Informationen finden Sie unter [Verified-Access-Gruppen](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-groups.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DescribeVerifiedAccessGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-verified-access-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-verified-access-instance-logging-configurations` Das folgende Codebeispiel zeigt die Verwendung`describe-verified-access-instance-logging-configurations`. **AWS CLI** **So beschreiben Sie die Protokollierungskonfiguration für eine Instance mit verifiziertem Zugriff** Im folgenden Beispiel für `describe-verified-access-instance-logging-configurations` wird die Protokollierungskonfiguration für die angegebene Verified-Access-Instance beschrieben. ``` aws ec2 describe-verified-access-instance-logging-configurations \ --verified-access-instance-ids vai-0ce000c0b7643abea ``` Ausgabe: ``` { "LoggingConfigurations": [ { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "AccessLogs": { "S3": { "Enabled": false }, "CloudWatchLogs": { "Enabled": true, "DeliveryStatus": { "Code": "success" }, "LogGroup": "my-log-group" }, "KinesisDataFirehose": { "Enabled": false }, "LogVersion": "ocsf-1.0.0-rc.2", "IncludeTrustContext": false } } ] } ``` Weitere Informationen finden Sie unter [Verified-Access-Protokolle](https://docs.aws.amazon.com/verified-access/latest/ug/access-logs.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DescribeVerifiedAccessInstanceLoggingConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-verified-access-instance-logging-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-verified-access-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-verified-access-instances`. **AWS CLI** **So beschreiben Sie eine Verified-Access-Instance** Im folgenden Beispiel für `describe-verified-access-instances` wird die angegebene verifizierte Zugriffs-Instance beschrieben. ``` aws ec2 describe-verified-access-instances \ --verified-access-instance-ids vai-0ce000c0b7643abea ``` Ausgabe: ``` { "VerifiedAccessInstances": [ { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "Testing Verified Access", "VerifiedAccessTrustProviders": [ { "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7", "TrustProviderType": "user", "UserTrustProviderType": "iam-identity-center" } ], "CreationTime": "2023-08-25T18:27:56", "LastUpdatedTime": "2023-08-25T19:03:32", "Tags": [ { "Key": "Name", "Value": "my-ava-instance" } ] } ] } ``` Weitere Informationen finden Sie unter [Verified-Access-Instances](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-instances.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DescribeVerifiedAccessInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-verified-access-instances.html)in der *AWS CLI Befehlsreferenz*. ### `describe-verified-access-trust-providers` Das folgende Codebeispiel zeigt die Verwendung`describe-verified-access-trust-providers`. **AWS CLI** **So beschreiben Sie einen Verified-Access-Vertrauensanbieter** Im folgenden Beispiel für `describe-verified-access-trust-providers` wird der angegebene Verified-Access-Vertrauensanbieter beschrieben. ``` aws ec2 describe-verified-access-trust-providers \ --verified-access-trust-provider-ids vatp-0bb32de759a3e19e7 ``` Ausgabe: ``` { "VerifiedAccessTrustProviders": [ { "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7", "Description": "Testing Verified Access", "TrustProviderType": "user", "UserTrustProviderType": "iam-identity-center", "PolicyReferenceName": "idc", "CreationTime": "2023-08-25T19:00:38", "LastUpdatedTime": "2023-08-25T19:03:32", "Tags": [ { "Key": "Name", "Value": "my-va-trust-provider" } ] } ] } ``` Weitere Informationen finden Sie unter [Vertrauensanbieter für Verified Access](https://docs.aws.amazon.com/verified-access/latest/ug/trust-providers.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DescribeVerifiedAccessTrustProviders](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-verified-access-trust-providers.html)in der *AWS CLI Befehlsreferenz*. ### `describe-volume-attribute` Das folgende Codebeispiel zeigt die Verwendung`describe-volume-attribute`. **AWS CLI** **So beschreiben Sie ein Volume-Attribut** Dieser Beispielbefehl beschreibt das Attribut `autoEnableIo` des Volumes mit der ID `vol-049df61146c4d7901`. Befehl: ``` aws ec2 describe-volume-attribute --volume-id vol-049df61146c4d7901 --attribute autoEnableIO ``` Ausgabe: ``` { "AutoEnableIO": { "Value": false }, "VolumeId": "vol-049df61146c4d7901" } ``` + Einzelheiten zur API finden Sie [DescribeVolumeAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-volume-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `describe-volume-status` Das folgende Codebeispiel zeigt die Verwendung`describe-volume-status`. **AWS CLI** **So beschreiben Sie den Status eines einzelnen Volumes** Dieser Beispielbefehl beschreibt den Status des Volumes `vol-1234567890abcdef0`. Befehl: ``` aws ec2 describe-volume-status --volume-ids vol-1234567890abcdef0 ``` Ausgabe: ``` { "VolumeStatuses": [ { "VolumeStatus": { "Status": "ok", "Details": [ { "Status": "passed", "Name": "io-enabled" }, { "Status": "not-applicable", "Name": "io-performance" } ] }, "AvailabilityZone": "us-east-1a", "VolumeId": "vol-1234567890abcdef0", "Actions": [], "Events": [] } ] } ``` **So beschreiben Sie den Status eines beeinträchtigten Volumes** Dieser Beispielbefehl beschreibt den Status aller Volumes, die beeinträchtigt sind. In dieser Beispielausgabe gibt es keine beeinträchtigten Volumes. Befehl: ``` aws ec2 describe-volume-status --filters Name=volume-status.status,Values=impaired ``` Ausgabe: ``` { "VolumeStatuses": [] } ``` Informationen zu einem Volume mit nicht bestandener Statusprüfung (der Status lautet „impaired“) finden Sie unter „Arbeiten mit einem beeinträchtigten Volume“ im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DescribeVolumeStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-volume-status.html)in der *AWS CLI Befehlsreferenz*. ### `describe-volumes-modifications` Das folgende Codebeispiel zeigt die Verwendung`describe-volumes-modifications`. **AWS CLI** **So beschreiben Sie den Änderungsstatus für ein Volume** Im folgenden Beispiel für `describe-volumes-modifications` wird der Status der Volume-Änderung für das angegebene Volume beschrieben. ``` aws ec2 describe-volumes-modifications \ --volume-ids vol-1234567890abcdef0 ``` Ausgabe: ``` { "VolumeModification": { "TargetSize": 150, "TargetVolumeType": "io1", "ModificationState": "optimizing", "VolumeId": " vol-1234567890abcdef0", "TargetIops": 100, "StartTime": "2019-05-17T11:27:19.000Z", "Progress": 70, "OriginalVolumeType": "io1", "OriginalIops": 100, "OriginalSize": 100 } } ``` + Einzelheiten zur API finden Sie [DescribeVolumesModifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-volumes-modifications.html)in der *AWS CLI Befehlsreferenz*. ### `describe-volumes` Das folgende Codebeispiel zeigt die Verwendung`describe-volumes`. **AWS CLI** **Beispiel 1: So beschreiben Sie ein Volume** Im folgenden Beispiel für `describe-volumes` werden die angegebenen Volumes in der aktuellen Region beschrieben. ``` aws ec2 describe-volumes \ --volume-ids vol-049df61146c4d7901 vol-1234567890abcdef0 ``` Ausgabe: ``` { "Volumes": [ { "AvailabilityZone": "us-east-1a", "Attachments": [ { "AttachTime": "2013-12-18T22:35:00.000Z", "InstanceId": "i-1234567890abcdef0", "VolumeId": "vol-049df61146c4d7901", "State": "attached", "DeleteOnTermination": true, "Device": "/dev/sda1" } ], "Encrypted": true, "KmsKeyId": "arn:aws:kms:us-east-2a:123456789012:key/8c5b2c63-b9bc-45a3-a87a-5513eEXAMPLE, "VolumeType": "gp2", "VolumeId": "vol-049df61146c4d7901", "State": "in-use", "Iops": 100, "SnapshotId": "snap-1234567890abcdef0", "CreateTime": "2019-12-18T22:35:00.084Z", "Size": 8 }, { "AvailabilityZone": "us-east-1a", "Attachments": [], "Encrypted": false, "VolumeType": "gp2", "VolumeId": "vol-1234567890abcdef0", "State": "available", "Iops": 300, "SnapshotId": "", "CreateTime": "2020-02-27T00:02:41.791Z", "Size": 100 } ] } ``` **Beispiel 2: So beschreiben Sie Volumes, die an eine bestimmte Instance angehängt sind** Im folgenden Beispiel für `describe-volumes` werden alle Volumes beschrieben, die sowohl an die angegebene Instance angehängt als auch so eingestellt sind, dass sie gelöscht werden, wenn die Instance beendet wird. ``` aws ec2 describe-volumes \ --region us-east-1 \ --filters Name=attachment.instance-id,Values=i-1234567890abcdef0 Name=attachment.delete-on-termination,Values=true ``` Ein Beispiel für die Ausgabe von `describe-volumes` finden Sie in Beispiel 1. **Beispiel 3: So beschreiben Sie verfügbare Volumes in einer bestimmten Availability Zone** Im folgenden Beispiel für `describe-volumes` werden alle Volumes beschrieben, die den Status `available` haben und sich in der angegebenen Availability Zone befinden. ``` aws ec2 describe-volumes \ --filters Name=status,Values=available Name=availability-zone,Values=us-east-1a ``` Ein Beispiel für die Ausgabe von `describe-volumes` finden Sie in Beispiel 1. **Beispiel 4: So beschreiben Sie Volumes anhand von Tags** Im folgenden Beispiel für `describe-volumes` werden alle Volumes beschrieben, die den Tag-Schlüssel `Name` und einen Wert haben, der mit `Test` beginnt. Die Ausgabe wird dann mit einer Abfrage gefiltert, bei der nur die Tags und IDs der Volumes angezeigt werden. ``` aws ec2 describe-volumes \ --filters Name=tag:Name,Values=Test* \ --query "Volumes[*].{ID:VolumeId,Tag:Tags}" ``` Ausgabe: ``` [ { "Tag": [ { "Value": "Test2", "Key": "Name" } ], "ID": "vol-1234567890abcdef0" }, { "Tag": [ { "Value": "Test1", "Key": "Name" } ], "ID": "vol-049df61146c4d7901" } ] ``` Weitere Beispiele für die Verwendung von Tag-Filtern finden Sie unter [Arbeiten mit Tags](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_CLI) im *Amazon-EC2-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeVolumes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-volumes.html)unter *AWS CLI Befehlsreferenz*. ### `describe-vpc-attribute` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-attribute`. **AWS CLI** **Um das enableDnsSupport Attribut zu beschreiben** In diesem Beispiel wird das Attribut `enableDnsSupport` beschrieben. Dieses Attribut gibt an, ob für die VPC die DNS-Auflösung aktiviert ist. Wenn dieses Attribut `true` ist, löst der Amazon-DNS-Server die DNS-Hostnamen der Instances in die entsprechenden IP-Adressen auf. Andernfalls geschieht das nicht. Befehl: ``` aws ec2 describe-vpc-attribute --vpc-id vpc-a01106c2 --attribute enableDnsSupport ``` Ausgabe: ``` { "VpcId": "vpc-a01106c2", "EnableDnsSupport": { "Value": true } } ``` **Um das enableDnsHostnames Attribut zu beschreiben** In diesem Beispiel wird das Attribut `enableDnsHostnames` beschrieben. Dieses Attribut gibt an, ob die in der VPC gestarteten Instances DNS-Hostnamen erhalten. Wenn dieses Attribut `true` ist, erhalten die Instances in der VPC DNS-Hostnamen. Andernfalls ist das nicht der Fall. Befehl: ``` aws ec2 describe-vpc-attribute --vpc-id vpc-a01106c2 --attribute enableDnsHostnames ``` Ausgabe: ``` { "VpcId": "vpc-a01106c2", "EnableDnsHostnames": { "Value": true } } ``` + Einzelheiten zur API finden Sie [DescribeVpcAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpc-classic-link-dns-support` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-classic-link-dns-support`. **AWS CLI** **Um die ClassicLink DNS-Unterstützung für Ihr zu beschreiben VPCs** Dieses Beispiel beschreibt den ClassicLink DNS-Unterstützungsstatus aller Ihrer VPCs. Befehl: ``` aws ec2 describe-vpc-classic-link-dns-support ``` Ausgabe: ``` { "Vpcs": [ { "VpcId": "vpc-88888888", "ClassicLinkDnsSupported": true }, { "VpcId": "vpc-1a2b3c4d", "ClassicLinkDnsSupported": false } ] } ``` + Einzelheiten zur API finden Sie [DescribeVpcClassicLinkDnsSupport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-classic-link-dns-support.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpc-classic-link` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-classic-link`. **AWS CLI** **Um den ClassicLink Status Ihres zu beschreiben VPCs** Dieses Beispiel listet den ClassicLink Status von vpc-88888888 auf. Befehl: ``` aws ec2 describe-vpc-classic-link --vpc-id vpc-88888888 ``` Ausgabe: ``` { "Vpcs": [ { "ClassicLinkEnabled": true, "VpcId": "vpc-88888888", "Tags": [ { "Value": "classiclinkvpc", "Key": "Name" } ] } ] } ``` In diesem Beispiel werden nur diejenigen aufgeführt VPCs , die für Classiclink aktiviert sind (der Filterwert von ist auf gesetzt). `is-classic-link-enabled` `true` Befehl: ``` aws ec2 describe-vpc-classic-link --filter "Name=is-classic-link-enabled,Values=true" ``` + Einzelheiten zur API finden Sie unter [DescribeVpcClassicLink AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-classic-link.html)*Befehlsreferenz*. ### `describe-vpc-endpoint-associations` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-endpoint-associations`. **AWS CLI** **So beschreiben Sie VPC-Endpunktzuordnungen** Im folgenden Beispiel für `describe-vpc-endpoint-associations` werden Ihre VPC-Endpunktzuordnungen beschrieben. ``` aws ec2 describe-vpc-endpoint-associations ``` Ausgabe: ``` { "VpcEndpointAssociations": [ { "Id": "vpce-rsc-asc-0a810ca6ac8866bf9", "VpcEndpointId": "vpce-019b90d6f16d4f958", "AssociatedResourceAccessibility": "Accessible", "DnsEntry": { "DnsName": "vpce-019b90d6f16d4f958.rcfg-07129f3acded87625.4232ccc.vpc-lattice-rsc.us-east-2.on.aws", "HostedZoneId": "Z03265862FOUNWMZOKUF4" }, "AssociatedResourceArn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625" } ] } ``` Weitere Informationen finden Sie im *AWS PrivateLink Benutzerhandbuch* unter [VPC-Endpunktzuordnungen verwalten](https://docs.aws.amazon.com/vpc/latest/privatelink/resource-configuration-associations.html#resource-config-manage-ep-association). + Einzelheiten zur API finden Sie unter [DescribeVpcEndpointAssociations AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-endpoint-associations.html)*Befehlsreferenz.* ### `describe-vpc-endpoint-connection-notifications` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-endpoint-connection-notifications`. **AWS CLI** **So beschreiben Sie Endpunkt-Verbindungsbenachrichtigungen** Im folgenden Beispiel für `describe-vpc-endpoint-connection-notifications` werden alle Ihre Endpunkt-Verbindungsbenachrichtigungen beschrieben. ``` aws ec2 describe-vpc-endpoint-connection-notifications ``` Ausgabe: ``` { "ConnectionNotificationSet": [ { "ConnectionNotificationState": "Enabled", "ConnectionNotificationType": "Topic", "ConnectionEvents": [ "Accept", "Reject", "Delete", "Connect" ], "ConnectionNotificationId": "vpce-nfn-04bcb952bc8af7abc", "ConnectionNotificationArn": "arn:aws:sns:us-east-1:123456789012:VpceNotification", "VpcEndpointId": "vpce-0324151a02f327123" } ] } ``` + Einzelheiten zur API finden Sie [DescribeVpcEndpointConnectionNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-endpoint-connection-notifications.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpc-endpoint-connections` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-endpoint-connections`. **AWS CLI** **So beschreiben Sie VPC-Endpunktverbindungen** In diesem Beispiel werden die Schnittstellen-Endpunktverbindungen zu Ihrem Endpunktservice beschrieben und die Ergebnisse so gefiltert, dass Endpunkte mit dem Status `PendingAcceptance` angezeigt werden. Befehl: ``` aws ec2 describe-vpc-endpoint-connections --filters Name=vpc-endpoint-state,Values=pendingAcceptance ``` Ausgabe: ``` { "VpcEndpointConnections": [ { "VpcEndpointId": "vpce-0abed31004e618123", "ServiceId": "vpce-svc-0abced088d20def56", "CreationTimestamp": "2017-11-30T10:00:24.350Z", "VpcEndpointState": "pendingAcceptance", "VpcEndpointOwner": "123456789012" } ] } ``` + Einzelheiten zur API finden Sie [DescribeVpcEndpointConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-endpoint-connections.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpc-endpoint-service-configurations` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-endpoint-service-configurations`. **AWS CLI** **So beschreiben Sie Endpunkt-Servicekonfigurationen** Im folgenden Beispiel für `describe-vpc-endpoint-service-configurations` werden Ihre Endpunkt-Servicekonfigurationen beschrieben. ``` aws ec2 describe-vpc-endpoint-service-configurations ``` Ausgabe: ``` { "ServiceConfigurations": [ { "ServiceType": [ { "ServiceType": "GatewayLoadBalancer" } ], "ServiceId": "vpce-svc-012d33a1c4321cabc", "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-012d33a1c4321cabc", "ServiceState": "Available", "AvailabilityZones": [ "us-east-1d" ], "AcceptanceRequired": false, "ManagesVpcEndpoints": false, "GatewayLoadBalancerArns": [ "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/gwy/GWLBService/123210844e429123" ], "Tags": [] }, { "ServiceType": [ { "ServiceType": "Interface" } ], "ServiceId": "vpce-svc-123cabc125efa123", "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123cabc125efa123", "ServiceState": "Available", "AvailabilityZones": [ "us-east-1a" ], "AcceptanceRequired": true, "ManagesVpcEndpoints": false, "NetworkLoadBalancerArns": [ "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/NLBforService/1238753950b25123" ], "BaseEndpointDnsNames": [ "vpce-svc-123cabc125efa123.us-east-1.vpce.amazonaws.com" ], "PrivateDnsName": "example.com", "PrivateDnsNameConfiguration": { "State": "failed", "Type": "TXT", "Value": "vpce:qUAth3FdeABCApUiXabc", "Name": "_1d367jvbg34znqvyefrj" }, "Tags": [] } ] } ``` Weitere Informationen finden Sie unter [Konzepte](https://docs.aws.amazon.com/vpc/latest/privatelink/concepts.html) im *AWS PrivateLink Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeVpcEndpointServiceConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-endpoint-service-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpc-endpoint-service-permissions` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-endpoint-service-permissions`. **AWS CLI** **So beschreiben Sie Berechtigungen für Endpunktservices** In diesem Beispiel werden die Berechtigungen für den angegebenen Endpunktservice beschrieben. Befehl: ``` aws ec2 describe-vpc-endpoint-service-permissions --service-id vpce-svc-03d5ebb7d9579a2b3 ``` Ausgabe: ``` { "AllowedPrincipals": [ { "PrincipalType": "Account", "Principal": "arn:aws:iam::123456789012:root" } ] } ``` + Einzelheiten zur API finden Sie [DescribeVpcEndpointServicePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-endpoint-service-permissions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpc-endpoint-services` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-endpoint-services`. **AWS CLI** **Beispiel 1: So beschreiben Sie alle VPC-Endpunktservices** Das folgende `describe-vpc-endpoint-services` Beispiel listet alle VPC-Endpunktdienste für eine AWS Region auf. ``` aws ec2 describe-vpc-endpoint-services ``` Ausgabe: ``` { "ServiceDetails": [ { "ServiceType": [ { "ServiceType": "Gateway" } ], "AcceptanceRequired": false, "ServiceName": "com.amazonaws.us-east-1.dynamodb", "VpcEndpointPolicySupported": true, "Owner": "amazon", "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c", "us-east-1d", "us-east-1e", "us-east-1f" ], "BaseEndpointDnsNames": [ "dynamodb.us-east-1.amazonaws.com" ] }, { "ServiceType": [ { "ServiceType": "Interface" } ], "PrivateDnsName": "ec2.us-east-1.amazonaws.com", "ServiceName": "com.amazonaws.us-east-1.ec2", "VpcEndpointPolicySupported": false, "Owner": "amazon", "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c", "us-east-1d", "us-east-1e", "us-east-1f" ], "AcceptanceRequired": false, "BaseEndpointDnsNames": [ "ec2.us-east-1.vpce.amazonaws.com" ] }, { "ServiceType": [ { "ServiceType": "Interface" } ], "PrivateDnsName": "ssm.us-east-1.amazonaws.com", "ServiceName": "com.amazonaws.us-east-1.ssm", "VpcEndpointPolicySupported": true, "Owner": "amazon", "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c", "us-east-1d", "us-east-1e" ], "AcceptanceRequired": false, "BaseEndpointDnsNames": [ "ssm.us-east-1.vpce.amazonaws.com" ] } ], "ServiceNames": [ "com.amazonaws.us-east-1.dynamodb", "com.amazonaws.us-east-1.ec2", "com.amazonaws.us-east-1.ec2messages", "com.amazonaws.us-east-1.elasticloadbalancing", "com.amazonaws.us-east-1.kinesis-streams", "com.amazonaws.us-east-1.s3", "com.amazonaws.us-east-1.ssm" ] } ``` **Beispiel 2: So beschreiben Sie die Details zu einem Endpunktservice** Im folgenden Beispiel für `describe-vpc-endpoint-services` werden die Details des Endpunktservice der Amazon-S3-Schnittstelle aufgelistet. ``` aws ec2 describe-vpc-endpoint-services \ --filter 'Name=service-type,Values=Interface' Name=service-name,Values=com.amazonaws.us-east-1.s3 ``` Ausgabe: ``` { "ServiceDetails": [ { "ServiceName": "com.amazonaws.us-east-1.s3", "ServiceId": "vpce-svc-081d84efcdEXAMPLE", "ServiceType": [ { "ServiceType": "Interface" } ], "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c", "us-east-1d", "us-east-1e", "us-east-1f" ], "Owner": "amazon", "BaseEndpointDnsNames": [ "s3.us-east-1.vpce.amazonaws.com" ], "VpcEndpointPolicySupported": true, "AcceptanceRequired": false, "ManagesVpcEndpoints": false, "Tags": [] } ], "ServiceNames": [ "com.amazonaws.us-east-1.s3" ] } ``` Weitere Informationen finden Sie im *AWS PrivateLink Benutzerhandbuch* unter [Verfügbare AWS Dienstnamen anzeigen](https://docs.aws.amazon.com/vpc/latest/privatelink/aws-services-privatelink-support.html#vpce-view-available-services). + Einzelheiten zur API finden Sie [DescribeVpcEndpointServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-endpoint-services.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpc-endpoints` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-endpoints`. **AWS CLI** **So beschreiben Sie Ihre VPC-Endpunkte** Im folgenden Beispiel für `describe-vpc-endpoints` werden Details für all Ihre VPC-Endpunkte angezeigt. ``` aws ec2 describe-vpc-endpoints ``` Ausgabe: ``` { "VpcEndpoints": [ { "PolicyDocument": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":\"*\",\"Resource\":\"*\"}]}", "VpcId": "vpc-aabb1122", "NetworkInterfaceIds": [], "SubnetIds": [], "PrivateDnsEnabled": true, "State": "available", "ServiceName": "com.amazonaws.us-east-1.dynamodb", "RouteTableIds": [ "rtb-3d560345" ], "Groups": [], "VpcEndpointId": "vpce-032a826a", "VpcEndpointType": "Gateway", "CreationTimestamp": "2017-09-05T20:41:28Z", "DnsEntries": [], "OwnerId": "123456789012" }, { "PolicyDocument": "{\n \"Statement\": [\n {\n \"Action\": \"*\", \n \"Effect\": \"Allow\", \n \"Principal\": \"*\", \n \"Resource\": \"*\"\n }\n ]\n}", "VpcId": "vpc-1a2b3c4d", "NetworkInterfaceIds": [ "eni-2ec2b084", "eni-1b4a65cf" ], "SubnetIds": [ "subnet-d6fcaa8d", "subnet-7b16de0c" ], "PrivateDnsEnabled": false, "State": "available", "ServiceName": "com.amazonaws.us-east-1.elasticloadbalancing", "RouteTableIds": [], "Groups": [ { "GroupName": "default", "GroupId": "sg-54e8bf31" } ], "VpcEndpointId": "vpce-0f89a33420c1931d7", "VpcEndpointType": "Interface", "CreationTimestamp": "2017-09-05T17:55:27.583Z", "DnsEntries": [ { "HostedZoneId": "Z7HUB22UULQXV", "DnsName": "vpce-0f89a33420c1931d7-bluzidnv.elasticloadbalancing.us-east-1.vpce.amazonaws.com" }, { "HostedZoneId": "Z7HUB22UULQXV", "DnsName": "vpce-0f89a33420c1931d7-bluzidnv-us-east-1b.elasticloadbalancing.us-east-1.vpce.amazonaws.com" }, { "HostedZoneId": "Z7HUB22UULQXV", "DnsName": "vpce-0f89a33420c1931d7-bluzidnv-us-east-1a.elasticloadbalancing.us-east-1.vpce.amazonaws.com" } ], "OwnerId": "123456789012" }, { "VpcEndpointId": "vpce-aabbaabbaabbaabba", "VpcEndpointType": "GatewayLoadBalancer", "VpcId": "vpc-111122223333aabbc", "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123", "State": "available", "SubnetIds": [ "subnet-0011aabbcc2233445" ], "RequesterManaged": false, "NetworkInterfaceIds": [ "eni-01010120203030405" ], "CreationTimestamp": "2020-11-11T08:06:03.522Z", "Tags": [], "OwnerId": "123456789012" } ] } ``` Weitere Informationen finden Sie unter [Konzepte](https://docs.aws.amazon.com/vpc/latest/privatelink/concepts.html) im *AWS PrivateLink Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeVpcEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-endpoints.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpc-peering-connections` Das folgende Codebeispiel zeigt die Verwendung`describe-vpc-peering-connections`. **AWS CLI** **So beschreiben Sie Ihre VPC-Peering-Verbindungen** In diesem Beispiel werden alle Ihre VPC-Peering-Verbindungen beschrieben. Befehl: ``` aws ec2 describe-vpc-peering-connections ``` Ausgabe: ``` { "VpcPeeringConnections": [ { "Status": { "Message": "Active", "Code": "active" }, "Tags": [ { "Value": "Peering-1", "Key": "Name" } ], "AccepterVpcInfo": { "OwnerId": "111122223333", "VpcId": "vpc-1a2b3c4d", "CidrBlock": "10.0.1.0/28" }, "VpcPeeringConnectionId": "pcx-11122233", "RequesterVpcInfo": { "PeeringOptions": { "AllowEgressFromLocalVpcToRemoteClassicLink": false, "AllowEgressFromLocalClassicLinkToRemoteVpc": false }, "OwnerId": "444455556666", "VpcId": "vpc-123abc45", "CidrBlock": "192.168.0.0/16" } }, { "Status": { "Message": "Pending Acceptance by 444455556666", "Code": "pending-acceptance" }, "Tags": [], "RequesterVpcInfo": { "PeeringOptions": { "AllowEgressFromLocalVpcToRemoteClassicLink": false, "AllowEgressFromLocalClassicLinkToRemoteVpc": false }, "OwnerId": "444455556666", "VpcId": "vpc-11aa22bb", "CidrBlock": "10.0.0.0/28" }, "VpcPeeringConnectionId": "pcx-abababab", "ExpirationTime": "2014-04-03T09:12:43.000Z", "AccepterVpcInfo": { "OwnerId": "444455556666", "VpcId": "vpc-33cc44dd" } } ] } ``` **So beschreiben Sie bestimmte VPC-Peering-Verbindungen** In diesem Beispiel werden alle Ihre VPC-Peering-Verbindungen beschrieben, die sich im Status pending-acceptance befinden. Befehl: ``` aws ec2 describe-vpc-peering-connections --filters Name=status-code,Values=pending-acceptance ``` In diesem Beispiel werden alle Ihre VPC-Peering-Verbindungen beschrieben, die das Tag Owner=Finance besitzen. Befehl: ``` aws ec2 describe-vpc-peering-connections --filters Name=tag:Owner,Values=Finance ``` In diesem Beispiel werden alle Ihre VPC-Peering-Verbindungen beschrieben, die Sie für die angegebene VPC, vpc-1a2b3c4d, angefordert haben. Befehl: ``` aws ec2 describe-vpc-peering-connections --filters Name=requester-vpc-info.vpc-id,Values=vpc-1a2b3c4d ``` + Einzelheiten zur API finden Sie [DescribeVpcPeeringConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-peering-connections.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpcs` Das folgende Codebeispiel zeigt die Verwendung`describe-vpcs`. **AWS CLI** **Beispiel 1: Um all deine zu beschreiben VPCs** Im folgenden `describe-vpcs` Beispiel werden Details zu Ihrem 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 CLI Befehlsreferenz.* ### `describe-vpn-connections` Das folgende Codebeispiel zeigt die Verwendung`describe-vpn-connections`. **AWS CLI** **Beispiel 1: So beschreiben Sie Ihre VPN-Verbindungen** Das folgende `describe-vpn-connections` Beispiel beschreibt all Ihre Site-to-Site VPN-Verbindungen. ``` aws ec2 describe-vpn-connections ``` Ausgabe: ``` { "VpnConnections": [ { "CustomerGatewayConfiguration": "...configuration information...", "CustomerGatewayId": "cgw-01234567abcde1234", "Category": "VPN", "State": "available", "Type": "ipsec.1", "VpnConnectionId": "vpn-1122334455aabbccd", "TransitGatewayId": "tgw-00112233445566aab", "Options": { "EnableAcceleration": false, "StaticRoutesOnly": true, "LocalIpv4NetworkCidr": "0.0.0.0/0", "RemoteIpv4NetworkCidr": "0.0.0.0/0", "TunnelInsideIpVersion": "ipv4" }, "Routes": [], "Tags": [ { "Key": "Name", "Value": "CanadaVPN" } ], "VgwTelemetry": [ { "AcceptedRouteCount": 0, "LastStatusChange": "2020-07-29T10:35:11.000Z", "OutsideIpAddress": "203.0.113.3", "Status": "DOWN", "StatusMessage": "" }, { "AcceptedRouteCount": 0, "LastStatusChange": "2020-09-02T09:09:33.000Z", "OutsideIpAddress": "203.0.113.5", "Status": "UP", "StatusMessage": "" } ] } ] } ``` Weitere Informationen finden Sie unter [So funktioniert AWS Site-to-Site VPN](https://docs.aws.amazon.com/vpn/latest/s2svpn/how_it_works.html) im *AWS Site-to-Site VPN-Benutzerhandbuch*. **Beispiel 2: So beschreiben Sie Ihre verfügbaren VPN-Verbindungen** Das folgende `describe-vpn-connections` Beispiel beschreibt Ihre Site-to-Site VPN-Verbindungen mit dem Status`available`. ``` aws ec2 describe-vpn-connections \ --filters "Name=state,Values=available" ``` Weitere Informationen finden Sie unter [So funktioniert AWS Site-to-Site VPN](https://docs.aws.amazon.com/vpn/latest/s2svpn/how_it_works.html) im *AWS Site-to-Site VPN-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeVpnConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpn-connections.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vpn-gateways` Das folgende Codebeispiel zeigt die Verwendung`describe-vpn-gateways`. **AWS CLI** **So beschreiben Sie Ihre Virtual Private Gateways** In diesem Beispiel werden Ihre Virtual Private Gateways beschrieben. Befehl: ``` aws ec2 describe-vpn-gateways ``` Ausgabe: ``` { "VpnGateways": [ { "State": "available", "Type": "ipsec.1", "VpnGatewayId": "vgw-f211f09b", "VpcAttachments": [ { "State": "attached", "VpcId": "vpc-98eb5ef5" } ] }, { "State": "available", "Type": "ipsec.1", "VpnGatewayId": "vgw-9a4cacf3", "VpcAttachments": [ { "State": "attaching", "VpcId": "vpc-a01106c2" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeVpnGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpn-gateways.html)in der *AWS CLI Befehlsreferenz*. ### `detach-classic-link-vpc` Das folgende Codebeispiel zeigt die Verwendung`detach-classic-link-vpc`. **AWS CLI** **So heben Sie die Verknüpfung einer EC2-Classic-Instance mit einer VPC auf (trennen** In diesem Beispiel wird die Instance i-0598c7d356eba48d7 von der VPC vpc-88888888 getrennt. Befehl: ``` aws ec2 detach-classic-link-vpc --instance-id i-0598c7d356eba48d7 --vpc-id vpc-88888888 ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [DetachClassicLinkVpc](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/detach-classic-link-vpc.html)in der *AWS CLI Befehlsreferenz*. ### `detach-internet-gateway` Das folgende Codebeispiel zeigt die Verwendung`detach-internet-gateway`. **AWS CLI** **So trennen Sie ein Internet-Gateway von Ihrer VPC** Im folgenden Beispiel für `detach-internet-gateway` wird das spezifische Internet-Gateway von der angegebenen VPC getrennt. ``` aws ec2 detach-internet-gateway \ --internet-gateway-id igw-0d0fb496b3EXAMPLE \ --vpc-id vpc-0a60eb65b4EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Internet-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DetachInternetGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/detach-internet-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `detach-network-interface` Das folgende Codebeispiel zeigt die Verwendung`detach-network-interface`. **AWS CLI** **So trennen Sie eine Netzwerkschnittstelle von Ihrer Instance** In diesem Beispiel wird die angegebene Netzwerkschnittstelle von der spezifischen Instance getrennt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 detach-network-interface --attachment-id eni-attach-66c4350a ``` + Einzelheiten zur API finden Sie [DetachNetworkInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/detach-network-interface.html)in der *AWS CLI Befehlsreferenz*. ### `detach-verified-access-trust-provider` Das folgende Codebeispiel zeigt die Verwendung`detach-verified-access-trust-provider`. **AWS CLI** **So trennen Sie einen Vertrauensanbieter von einer Instance** Im folgenden Beispiel für `detach-verified-access-trust-provider` wird der angegebene Vertrauensanbieter für verifizierten Zugriff von der Instance für verifizierten Zugriff getrennt. ``` aws ec2 detach-verified-access-trust-provider \ --verified-access-instance-id vai-0ce000c0b7643abea \ --verified-access-trust-provider-id vatp-0bb32de759a3e19e7 ``` Ausgabe: ``` { "VerifiedAccessTrustProvider": { "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7", "Description": "Testing Verified Access", "TrustProviderType": "user", "UserTrustProviderType": "iam-identity-center", "PolicyReferenceName": "idc", "CreationTime": "2023-08-25T19:00:38", "LastUpdatedTime": "2023-08-25T19:00:38" }, "VerifiedAccessInstance": { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "Testing Verified Access", "VerifiedAccessTrustProviders": [], "CreationTime": "2023-08-25T18:27:56", "LastUpdatedTime": "2023-08-25T18:27:56" } } ``` Weitere Informationen finden Sie unter [Verified-Access-Instances](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-instances.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [DetachVerifiedAccessTrustProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/detach-verified-access-trust-provider.html)in der *AWS CLI Befehlsreferenz*. ### `detach-volume` Das folgende Codebeispiel zeigt die Verwendung`detach-volume`. **AWS CLI** **So trennen Sie ein Volume von einer Instance** Dieser Beispielbefehl trennt das Volume (`vol-049df61146c4d7901`) von der Instance, an die es angehängt ist. Befehl: ``` aws ec2 detach-volume --volume-id vol-1234567890abcdef0 ``` Ausgabe: ``` { "AttachTime": "2014-02-27T19:23:06.000Z", "InstanceId": "i-1234567890abcdef0", "VolumeId": "vol-049df61146c4d7901", "State": "detaching", "Device": "/dev/sdb" } ``` + Einzelheiten zur API finden Sie [DetachVolume](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/detach-volume.html)in der *AWS CLI Befehlsreferenz*. ### `detach-vpn-gateway` Das folgende Codebeispiel zeigt die Verwendung`detach-vpn-gateway`. **AWS CLI** **So trennen Sie ein Virtual Private Gateway von Ihrer VPC** In diesem Beispiel wird das angegebene Virtual Private Gateway von der festgelegten VPC getrennt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 detach-vpn-gateway --vpn-gateway-id vgw-9a4cacf3 --vpc-id vpc-a01106c2 ``` + Einzelheiten zur API finden Sie [DetachVpnGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/detach-vpn-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `disable-address-transfer` Das folgende Codebeispiel zeigt die Verwendung`disable-address-transfer`. **AWS CLI** **So deaktivieren Sie die Übertragung einer Elastic-IP-Adresse** Im folgenden Beispiel für `disable-address-transfer` wird die Übertragung der Elastic-IP-Adresse für die angegebene Elastic-IP-Adresse beschrieben. ``` aws ec2 disable-address-transfer \ --allocation-id eipalloc-09ad461b0d03f6aaf ``` Ausgabe: ``` { "AddressTransfer": { "PublicIp": "100.21.184.216", "AllocationId": "eipalloc-09ad461b0d03f6aaf", "AddressTransferStatus": "disabled" } } ``` Weitere Informationen finden Sie unter [Übertragen von Elastic-IP-Adressen](https://docs.aws.amazon.com/vpc/latest/userguide/WorkWithEIPs.html#transfer-EIPs-intro) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DisableAddressTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-address-transfer.html)in der *AWS CLI Befehlsreferenz*. ### `disable-aws-network-performance-metric-subscription` Das folgende Codebeispiel zeigt die Verwendung`disable-aws-network-performance-metric-subscription`. **AWS CLI** **So deaktivieren Sie ein Metrikabonnement** Im folgenden Beispiel für `disable-aws-network-performance-metric-subscription` wird die Überwachung der aggregierten Netzwerklatenz zwischen den angegebenen Quell- und Zielregionen deaktiviert. ``` aws ec2 disable-aws-network-performance-metric-subscription \ --source us-east-1 \ --destination eu-west-1 \ --metric aggregate-latency \ --statistic p50 ``` Ausgabe: ``` { "Output": true } ``` Weitere Informationen finden Sie unter [Verwalten von CloudWatch Abonnements mit der CLI](https://docs.aws.amazon.com/network-manager/latest/infrastructure-performance/getting-started-nmip-cli.html) im *Infrastructure Performance User Guide*. + Einzelheiten zur API finden Sie [DisableAwsNetworkPerformanceMetricSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-aws-network-performance-metric-subscription.html)unter *AWS CLI Befehlsreferenz*. ### `disable-ebs-encryption-by-default` Das folgende Codebeispiel zeigt die Verwendung`disable-ebs-encryption-by-default`. **AWS CLI** **So deaktivieren Sie die EBS-Verschlüsselung standardmäßig** Im folgenden `disable-ebs-encryption-by-default` Beispiel wird die EBS-Verschlüsselung standardmäßig für Ihr AWS Konto in der aktuellen Region deaktiviert. ``` aws ec2 disable-ebs-encryption-by-default ``` Ausgabe: ``` { "EbsEncryptionByDefault": false } ``` + Einzelheiten zur API finden Sie unter [DisableEbsEncryptionByDefault AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-ebs-encryption-by-default.html)*Befehlsreferenz*. ### `disable-fast-launch` Das folgende Codebeispiel zeigt die Verwendung`disable-fast-launch`. **AWS CLI** **So beenden Sie den Schnellstart für ein Image** Im folgenden Beispiel für `disable-fast-launch` wird der Schnellstart für das angegebene AMI beendet und vorhandene vorab bereitgestellte Snapshots werden bereinigt. ``` aws ec2 disable-fast-launch \ --image-id ami-01234567890abcedf ``` Ausgabe: ``` { "ImageId": "ami-01234567890abcedf", "ResourceType": "snapshot", "SnapshotConfiguration": {}, "LaunchTemplate": { "LaunchTemplateId": "lt-01234567890abcedf", "LaunchTemplateName": "EC2FastLaunchDefaultResourceCreation-a8c6215d-94e6-441b-9272-dbd1f87b07e2", "Version": "1" }, "MaxParallelLaunches": 6, "OwnerId": "0123456789123", "State": "disabling", "StateTransitionReason": "Client.UserInitiated", "StateTransitionTime": "2022-01-27T22:47:29.265000+00:00" } ``` Weitere Informationen finden Sie unter [Konfigurieren der EC2-Schnellstarteinstellungen für Ihr Windows-AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/win-fast-launch-configure.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DisableFastLaunch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-fast-launch.html)in der *AWS CLI Befehlsreferenz*. ### `disable-fast-snapshot-restores` Das folgende Codebeispiel zeigt die Verwendung`disable-fast-snapshot-restores`. **AWS CLI** **So deaktivieren Sie schnelle Snapshot-Wiederherstellung** Im folgenden Beispiel für `disable-fast-snapshot-restores` wird die schnelle Snapshot-Wiederherstellung für den angegebenen Snapshot in den festgelegten Availability Zones deaktiviert. ``` aws ec2 disable-fast-snapshot-restores \ --availability-zones us-east-2a \ --source-snapshot-ids snap-1234567890abcdef0 ``` Ausgabe: ``` { "Successful": [ { "SnapshotId": "snap-1234567890abcdef0" "AvailabilityZone": "us-east-2a", "State": "disabling", "StateTransitionReason": "Client.UserInitiated", "OwnerId": "123456789012", "EnablingTime": "2020-01-25T23:57:49.602Z" } ], "Unsuccessful": [] } ``` + Einzelheiten zur API finden Sie [DisableFastSnapshotRestores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-fast-snapshot-restores.html)in der *AWS CLI Befehlsreferenz*. ### `disable-image-block-public-access` Das folgende Codebeispiel zeigt die Verwendung`disable-image-block-public-access`. **AWS CLI** **Um den öffentlichen Zugriff AMIs in der angegebenen Region zu deaktivieren** Im folgenden `disable-image-block-public-access` Beispiel wird die Sperrung des öffentlichen Zugriffs AMIs auf Kontoebene in der angegebenen Region deaktiviert. ``` aws ec2 disable-image-block-public-access \ --region us-east-1 ``` Ausgabe: ``` { "ImageBlockPublicAccessState": "unblocked" } ``` Weitere Informationen finden Sie unter [Sperren des öffentlichen Zugriffs auf Ihr AMIs](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-public-access-to-amis.html) im *Amazon EC2 EC2-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DisableImageBlockPublicAccess AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-image-block-public-access.html)*Befehlsreferenz.* ### `disable-image-deprecation` Das folgende Codebeispiel zeigt die Verwendung`disable-image-deprecation`. **AWS CLI** **So brechen Sie die Veralterung eines AMI ab** Im folgenden Beispiel für `disable-image-deprecation` wird die Veralterung eines AMI abgebrochen, wodurch das Feld `DeprecationTime` aus der Ausgabe `describe-images` entfernt wird. Sie müssen der AMI-Besitzer sein, um dieses Verfahren durchführen zu können. ``` aws ec2 disable-image-deprecation \ --image-id ami-1234567890abcdef0 ``` Ausgabe: ``` { "RequestID": "11aabb229-4eac-35bd-99ed-be587EXAMPLE", "Return": "true" } ``` Weitere Informationen finden Sie unter [Kennzeichnen eines AMI als veraltet](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deprecate.html) im *benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DisableImageDeprecation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-image-deprecation.html)in der *AWS CLI Befehlsreferenz*. ### `disable-image-deregistration-protection` Das folgende Codebeispiel zeigt die Verwendung`disable-image-deregistration-protection`. **AWS CLI** **So deaktivieren Sie den Abmeldeschutz** Im folgenden Beispiel für `disable-image-deregistration-protection` wird der Abmeldeschutz für das angegebene Image deaktiviert. ``` aws ec2 disable-image-deregistration-protection \ --image-id ami-0b1a928a144a74ec9 ``` Ausgabe: ``` { "Return": "disabled" } ``` Weitere Informationen finden Sie unter [Schützen eines AMI vor der Aufhebung der Registrierung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deregistration-protection.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DisableImageDeregistrationProtection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-image-deregistration-protection.html)in der *AWS CLI Befehlsreferenz*. ### `disable-image` Das folgende Codebeispiel zeigt die Verwendung`disable-image`. **AWS CLI** **So deaktivieren Sie ein AMI** Im folgenden Beispiel für `disable-image` wird das angegebene AMI deaktiviert. ``` aws ec2 disable-image \ --image-id ami-1234567890abcdef0 ``` Ausgabe: ``` { "Return": "true" } ``` Weitere Informationen finden Sie unter [Deaktivieren eines AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/disable-an-ami.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DisableImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-image.html)in der *AWS CLI Befehlsreferenz*. ### `disable-ipam-organization-admin-account` Das folgende Codebeispiel zeigt die Verwendung`disable-ipam-organization-admin-account`. **AWS CLI** **So deaktivieren Sie den delegierten IPAM-Administrator** In bestimmten Szenarien integrieren Sie IPAM in AWS Organizations. Wenn Sie das tun, delegiert das AWS Organisationsverwaltungskonto ein AWS Organisationen-Mitgliedskonto als IPAM-Administrator. In diesem Beispiel sind Sie das Verwaltungskonto der AWS Organizations, das das IPAM-Administratorkonto delegiert hat, und Sie möchten verhindern, dass dieses Konto der IPAM-Administrator ist. Sie können eine beliebige AWS Region für verwenden, `--region` wenn Sie diese Anfrage stellen. Sie müssen nicht die Region verwenden, in der Sie den Administrator ursprünglich delegiert haben oder in der der IPAM erstellt wurde. Sie müssen auch keine IPAM-Betriebsregion verwenden. Wenn Sie das delegierte Administratorkonto deaktivieren, können Sie es jederzeit wieder aktivieren oder ein neues Konto als IPAM-Administrator delegieren. Im folgenden `disable-ipam-organization-admin-account` Beispiel wird der delegierte IPAM-Administrator in Ihrem Konto deaktiviert. AWS ``` aws ec2 disable-ipam-organization-admin-account \ --delegated-admin-account-id 320805250157 \ --region ap-south-1 ``` Ausgabe: ``` { "Success": true } ``` Weitere Informationen finden Sie unter [Integrieren von IPAM mit Konten in einer AWS Organisation](https://docs.aws.amazon.com/vpc/latest/ipam/enable-integ-ipam.html) im *Amazon VPC IPAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [DisableIpamOrganizationAdminAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-ipam-organization-admin-account.html)in AWS CLI der Befehlsreferenz.* ### `disable-serial-console-access` Das folgende Codebeispiel zeigt die Verwendung`disable-serial-console-access`. **AWS CLI** **So deaktivieren Sie den Zugriff auf die serielle EC2-Konsole für Ihr Konto** Im folgenden Beispiel für `disable-serial-console-access` wird der Kontozugriff auf die serielle Konsole deaktiviert. ``` aws ec2 disable-serial-console-access ``` Ausgabe: ``` { "SerialConsoleAccessEnabled": false } ``` Weitere Informationen finden Sie unter [Serielle EC2-Konsole](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-serial-console.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [DisableSerialConsoleAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-serial-console-access.html)in der *AWS CLI Befehlsreferenz*. ### `disable-snapshot-block-public-access` Das folgende Codebeispiel zeigt die Verwendung`disable-snapshot-block-public-access`. **AWS CLI** **So deaktivieren Sie das Blockieren des öffentlichen Zugriffs für Snapshots** Im folgenden Beispiel für `disable-snapshot-block-public-access` wird das Blockieren des öffentlichen Zugriffs für Snapshots deaktiviert, um zuzulassen, dass Ihre Snapshots öffentlich freigegeben werden. ``` aws ec2 disable-snapshot-block-public-access ``` Ausgabe: ``` { "State": "unblocked" } ``` Weitere Informationen finden Sie unter [Blockieren des öffentlichen Zugriffs für Snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/block-public-access-snapshots.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [DisableSnapshotBlockPublicAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-snapshot-block-public-access.html)in der *AWS CLI Befehlsreferenz*. ### `disable-transit-gateway-route-table-propagation` Das folgende Codebeispiel zeigt die Verwendung`disable-transit-gateway-route-table-propagation`. **AWS CLI** **So deaktivieren Sie einen Transit-Gateway-Anhang, um Routen an die angegebene Übertragungs-Routing-Tabelle zu verteilen** Im folgenden Beispiel für `disable-transit-gateway-route-table-propagation` wird das Verteilen von Routen an die festgelegte Übertragungs-Routing-Tabelle durch den angegebenen Anhang deaktiviert. ``` aws ec2 disable-transit-gateway-route-table-propagation \ --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE \ --transit-gateway-attachment-id tgw-attach-09b52ccdb5EXAMPLE ``` Ausgabe: ``` { "Propagation": { "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE", "ResourceId": "vpc-4d7de228", "ResourceType": "vpc", "TransitGatewayRouteTableId": "tgw-rtb-0a823edbdeEXAMPLE", "State": "disabled" } } ``` Weitere Informationen finden Sie unter [Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [DisableTransitGatewayRouteTablePropagation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-transit-gateway-route-table-propagation.html)in der *AWS CLI Befehlsreferenz*. ### `disable-vgw-route-propagation` Das folgende Codebeispiel zeigt die Verwendung`disable-vgw-route-propagation`. **AWS CLI** **So deaktivieren Sie die Routing-Propagierung** In diesem Beispiel wird das Propagieren von statischen Routen an die angegebene Routing-Tabelle durch das festgelegte Virtual Private Gateway deaktiviert. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 disable-vgw-route-propagation --route-table-id rtb-22574640 --gateway-id vgw-9a4cacf3 ``` + Einzelheiten zur API finden Sie [DisableVgwRoutePropagation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-vgw-route-propagation.html)in der *AWS CLI Befehlsreferenz*. ### `disable-vpc-classic-link-dns-support` Das folgende Codebeispiel zeigt die Verwendung`disable-vpc-classic-link-dns-support`. **AWS CLI** **So deaktivieren Sie die ClassicLink DNS-Unterstützung für eine VPC** In diesem Beispiel wird die ClassicLink DNS-Unterstützung für deaktiviert. `vpc-88888888` Befehl: ``` aws ec2 disable-vpc-classic-link-dns-support --vpc-id vpc-88888888 ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [DisableVpcClassicLinkDnsSupport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-vpc-classic-link-dns-support.html)in der *AWS CLI Befehlsreferenz.* ### `disable-vpc-classic-link` Das folgende Codebeispiel zeigt die Verwendung`disable-vpc-classic-link`. **AWS CLI** **Zur Deaktivierung ClassicLink für eine VPC** Dieses Beispiel deaktiviert ClassicLink für vpc-8888888. Befehl: ``` aws ec2 disable-vpc-classic-link --vpc-id vpc-88888888 ``` Ausgabe: ``` { "Return": true } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DisableVpcClassicLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disable-vpc-classic-link.html)AWS CLI * ### `disassociate-address` Das folgende Codebeispiel zeigt die Verwendung`disassociate-address`. **AWS CLI** **So trennen Sie eine elastische IP-Adresse in EC2-Classic** In diesem Beispiel wird eine Elastic-IP-Adresse von einer Instance in EC2-Classic getrennt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 disassociate-address --public-ip 198.51.100.0 ``` **So trennen Sie die Zuordnung einer Elastic-IP-Adresse in EC2-VPC** In diesem Beispiel wird eine Elastic-IP-Adresse von einer Instance in einer VPC getrennt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 disassociate-address --association-id eipassoc-2bebb745 ``` + Einzelheiten zur API finden Sie [DisassociateAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-address.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-client-vpn-target-network` Das folgende Codebeispiel zeigt die Verwendung`disassociate-client-vpn-target-network`. **AWS CLI** **So trennen Sie ein Netzwerk von einem Client-VPN-Endpunkt** Im folgenden Beispiel für `disassociate-client-vpn-target-network` wird das Zielnetzwerk getrennt, das mit der Zuordnungs-ID `cvpn-assoc-12312312312312312` für den angegebenen Client-VPN-Endpunkt zugeordnet ist. ``` aws ec2 disassociate-client-vpn-target-network \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \ --association-id cvpn-assoc-12312312312312312 ``` Ausgabe: ``` { "AssociationId": "cvpn-assoc-12312312312312312", "Status": { "Code": "disassociating" } } ``` Weitere Informationen finden Sie unter [Zielnetzwerke](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-target.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [DisassociateClientVpnTargetNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-client-vpn-target-network.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-iam-instance-profile` Das folgende Codebeispiel zeigt die Verwendung`disassociate-iam-instance-profile`. **AWS CLI** **So heben Sie die Zuordnung eines IAM-Instance-Profils auf** In diesem Beispiel wird die Zuordnung eines IAM-Instance-Profils mit der Zuordnungs-ID `iip-assoc-05020b59952902f5f` aufgehoben. Befehl: ``` aws ec2 disassociate-iam-instance-profile --association-id iip-assoc-05020b59952902f5f ``` Ausgabe: ``` { "IamInstanceProfileAssociation": { "InstanceId": "i-123456789abcde123", "State": "disassociating", "AssociationId": "iip-assoc-05020b59952902f5f", "IamInstanceProfile": { "Id": "AIPAI5IVIHMFFYY2DKV5Y", "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role" } } } ``` + Einzelheiten zur API finden Sie [DisassociateIamInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-iam-instance-profile.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-instance-event-window` Das folgende Codebeispiel zeigt die Verwendung`disassociate-instance-event-window`. **AWS CLI** **Beispiel 1: So trennen Sie eine oder mehrere Instances von einem Ereignisfenster** Im folgenden Beispiel für `disassociate-instance-event-window` wird die Zuordnung eines oder mehrerer Instances zu einem Ereignisfenster aufgehoben. Geben Sie den `instance-event-window-id`-Parameter an, um das Ereignisfenster zu spezifizieren. Um die Zuordnung von Instanzen aufzuheben, geben Sie den `association-target` Parameter an, und geben Sie für die Parameterwerte eine oder mehrere Instanzen IDs an. ``` aws ec2 disassociate-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7" ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [], "DedicatedHostIds": [] }, "State": "creating" } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. **Beispiel 2: So trennen Sie die Instance-Tags von einem Ereignisfenster** Im folgenden Beispiel für `disassociate-instance-event-window` wird die Zuordnung von Instance-Tags zu einem Ereignisfenster aufgehoben. Geben Sie den `instance-event-window-id`-Parameter an, um das Ereignisfenster zu spezifizieren. Um die Zuordnung der Instance-Tags (Markierungen) aufzuheben, geben Sie den `association-target`-Parameter und für die Parameterwerte ein oder mehrere Tags (Markierungen) an. ``` aws ec2 disassociate-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]" ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [], "DedicatedHostIds": [] }, "State": "creating" } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. **Beispiel 3: So trennen Sie einen Dedicated Host von einem Ereignisfenster** Im folgenden Beispiel für `disassociate-instance-event-window` wird die Zuordnung eines Dedicated Hosts zu einem Ereignisfenster aufgehoben. Geben Sie den `instance-event-window-id`-Parameter an, um das Ereignisfenster zu spezifizieren. Um die Zuordnung eines Dedicated Hosts aufzuheben, geben Sie den `association-target` Parameter und für die Parameterwerte einen oder mehrere Dedicated Host an. IDs ``` aws ec2 disassociate-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target DedicatedHostIds=h-029fa35a02b99801d ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [], "DedicatedHostIds": [] }, "State": "creating" } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. + Einzelheiten zur API finden Sie [DisassociateInstanceEventWindow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-instance-event-window.html)in der *AWS CLI Befehlsreferenz.* ### `disassociate-ipam-resource-discovery` Das folgende Codebeispiel zeigt die Verwendung`disassociate-ipam-resource-discovery`. **AWS CLI** **So heben Sie die Zuordnung einer Ressourcenerkennung zu einem IPAM auf** In diesem Beispiel sind Sie ein delegiertes IPAM-Administratorkonto und möchten die Zuordnung einer IPAM-Ressourcenerkennung zu Ihrem IPAM aufheben. Sie haben den Befehl describe ausgeführt und festgestellt, dass `"ResourceDiscoveryStatus": "not-found"` gilt. Sie möchten die Zuordnung zu Ihrem IPAM aufheben, um Platz für andere Zuordnungen zu schaffen. Im folgenden `disassociate-ipam-resource-discovery` Beispiel wird die Zuordnung einer IPAM-Ressourcenerkennung in Ihrem AWS Konto aufgehoben. ``` aws ec2 disassociate-ipam-resource-discovery \ --ipam-resource-discovery-association-id ipam-res-disco-assoc-04382a6346357cf82 \ --region us-east-1 ``` Ausgabe: ``` { "IpamResourceDiscoveryAssociation": { "OwnerId": "320805250157", "IpamResourceDiscoveryAssociationId": "ipam-res-disco-assoc-04382a6346357cf82", "IpamResourceDiscoveryAssociationArn": "arn:aws:ec2::320805250157:ipam-resource-discovery-association/ipam-res-disco-assoc-04382a6346357cf82", "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe", "IpamId": "ipam-005f921c17ebd5107", "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107", "IpamRegion": "us-east-1", "IsDefault": false, "ResourceDiscoveryStatus": "not-found", "State": "disassociate-in-progress" } } ``` Weitere Informationen finden Sie unter [Integrieren von IPAM mit Konten außerhalb Ihrer Organisation](https://docs.aws.amazon.com/vpc/latest/ipam/enable-integ-ipam-outside-org.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [DisassociateIpamResourceDiscovery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-ipam-resource-discovery.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-nat-gateway-address` Das folgende Codebeispiel zeigt die Verwendung`disassociate-nat-gateway-address`. **AWS CLI** **So heben Sie die Zuordnung einer Elastic-IP-Adresse zu einem öffentlichen NAT-Gateway auf** Im folgenden Beispiel für `disassociate-nat-gateway-address` wird die Zuordnung der angegebenen Elastic-IP-Adresse zu dem spezifischen öffentlichen NAT-Gateway aufgehoben. ``` aws ec2 disassociate-nat-gateway-address \ --nat-gateway-id nat-1234567890abcdef0 \ --association-ids eipassoc-0f96bdca17EXAMPLE ``` Ausgabe: ``` { "NatGatewayId": "nat-1234567890abcdef0", "NatGatewayAddresses": [ { "AllocationId": "eipalloc-0be6ecac95EXAMPLE", "NetworkInterfaceId": "eni-09cc4b2558794f7f9", "PrivateIp": "10.0.0.74", "PublicIp": "3.211.231.218", "AssociationId": "eipassoc-0f96bdca17EXAMPLE", "IsPrimary": false, "Status": "disassociating" } ] } ``` Weitere Informationen finden Sie unter [NAT-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [DisassociateNatGatewayAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-nat-gateway-address.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-route-table` Das folgende Codebeispiel zeigt die Verwendung`disassociate-route-table`. **AWS CLI** **So heben Sie die Zuordnung einer Routing-Tabelle auf** In diesem Beispiel wird die Zuordnung der angegebenen Routing-Tabelle zu dem festgelegten Subnetz aufgehoben. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 disassociate-route-table --association-id rtbassoc-781d0d1a ``` + Einzelheiten zur API finden Sie [DisassociateRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-security-group-vpc` Das folgende Codebeispiel zeigt die Verwendung`disassociate-security-group-vpc`. **AWS CLI** **So heben Sie die Zuordnung einer Sicherheitsgruppe zu einer VPC auf** Im folgenden Beispiel für `disassociate-security-group-vpc` wird die Zuordnung der angegebenen Sicherheitsgruppe zu der festgelegten VPC aufgehoben. ``` aws ec2 disassociate-security-group-vpc \ --group-id sg-04dbb43907d3f8a78 \ --vpc-id vpc-0bf4c2739bc05a694 ``` Ausgabe: ``` { "State": "disassociating" } ``` Weitere Informationen finden Sie unter [Sicherheitsgruppen mehreren zuordnen VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/security-group-assoc.html) im *Amazon VPC-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DisassociateSecurityGroupVpc AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-security-group-vpc.html)*Befehlsreferenz.* ### `disassociate-subnet-cidr-block` Das folgende Codebeispiel zeigt die Verwendung`disassociate-subnet-cidr-block`. **AWS CLI** **Um einen IPv6 CIDR-Block von einem Subnetz zu trennen** In diesem Beispiel wird die Zuordnung eines IPv6 CIDR-Blocks zu einem Subnetz mithilfe der Zuordnungs-ID für den CIDR-Block aufgehoben. Befehl: ``` aws ec2 disassociate-subnet-cidr-block --association-id subnet-cidr-assoc-3aa54053 ``` Ausgabe: ``` { "SubnetId": "subnet-5f46ec3b", "Ipv6CidrBlockAssociation": { "Ipv6CidrBlock": "2001:db8:1234:1a00::/64", "AssociationId": "subnet-cidr-assoc-3aa54053", "Ipv6CidrBlockState": { "State": "disassociating" } } } ``` + *Einzelheiten zur API finden Sie unter [DisassociateSubnetCidrBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-subnet-cidr-block.html)Befehlsreferenz.AWS CLI * ### `disassociate-transit-gateway-multicast-domain` Das folgende Codebeispiel zeigt die Verwendung`disassociate-transit-gateway-multicast-domain`. **AWS CLI** **So heben Sie die Zuordnung von Subnetzen zu einer Multicast-Domain auf** Im folgenden Beispiel für `disassociate-transit-gateway-multicast-domain` wird die Zuordnung eines Subnetzes zur angegebenen Multicast-Domain aufgehoben. ``` aws ec2 disassociate-transit-gateway-multicast-domain \ --transit-gateway-attachment-id tgw-attach-070e571cd1EXAMPLE \ --subnet-id subnet-000de86e3bEXAMPLE \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE ``` Ausgabe: ``` { "Associations": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef7EXAMPLE", "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE", "ResourceId": "vpc-7EXAMPLE", "ResourceType": "vpc", "Subnets": [ { "SubnetId": "subnet-000de86e3bEXAMPLE", "State": "disassociating" } ] } } ``` Weitere Informationen finden Sie unter [Multicast-Domains](https://docs.aws.amazon.com/vpc/latest/tgw/multicast-domains-about.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [DisassociateTransitGatewayMulticastDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-transit-gateway-multicast-domain.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-transit-gateway-route-table` Das folgende Codebeispiel zeigt die Verwendung`disassociate-transit-gateway-route-table`. **AWS CLI** **So heben Sie die Zuordnung eine Routing-Tabelle in Transit Gateway zu einem Ressourcenanhang auf** Im folgenden Beispiel für `disassociate-transit-gateway-route-table` wird die Zuordnung des angegebenen Anhangs zu der Routing-Tabelle in Transit Gateway aufgehoben. ``` aws ec2 disassociate-transit-gateway-route-table \ --transit-gateway-route-table-id tgw-rtb-002573ed1eEXAMPLE \ --transit-gateway-attachment-id tgw-attach-08e0bc912cEXAMPLE ``` Ausgabe: ``` { "Association": { "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE", "TransitGatewayAttachmentId": "tgw-attach-08e0bc912cEXAMPLE", "ResourceId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE", "ResourceType": "direct-connect-gateway", "State": "disassociating" } } ``` Weitere Informationen finden Sie unter [Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [DisassociateTransitGatewayRouteTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-transit-gateway-route-table.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-vpc-cidr-block` Das folgende Codebeispiel zeigt die Verwendung`disassociate-vpc-cidr-block`. **AWS CLI** **So trennen Sie die Zuordnung eines IPv6 CIDR-Blocks zu einer VPC** In diesem Beispiel wird die Zuordnung eines IPv6 CIDR-Blocks zu einer VPC mithilfe der Zuordnungs-ID für den CIDR-Block aufgehoben. Befehl: ``` aws ec2 disassociate-vpc-cidr-block --association-id vpc-cidr-assoc-eca54085 ``` Ausgabe: ``` { "Ipv6CidrBlockAssociation": { "Ipv6CidrBlock": "2001:db8:1234:1a00::/56", "AssociationId": "vpc-cidr-assoc-eca54085", "Ipv6CidrBlockState": { "State": "disassociating" } }, "VpcId": "vpc-a034d6c4" } ``` **So trennen Sie die Zuordnung eines IPv4 CIDR-Blocks zu einer VPC** In diesem Beispiel wird die Zuordnung eines IPv4 CIDR-Blocks zu einer VPC getrennt. Befehl: ``` aws ec2 disassociate-vpc-cidr-block --association-id vpc-cidr-assoc-0287ac6b ``` Ausgabe: ``` { "CidrBlockAssociation": { "AssociationId": "vpc-cidr-assoc-0287ac6b", "CidrBlock": "172.18.0.0/16", "CidrBlockState": { "State": "disassociating" } }, "VpcId": "vpc-27621243" } ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz [DisassociateVpcCidrBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/disassociate-vpc-cidr-block.html).AWS CLI * ### `enable-address-transfer` Das folgende Codebeispiel zeigt die Verwendung`enable-address-transfer`. **AWS CLI** **So aktivieren Sie die Übertragung einer Elastic-IP-Adresse** Im folgenden Beispiel für `enable-address-transfer` wird die Übertragung von Elastic-IP-Adressen für die angegebene Elastic-IP-Adresse an das spezifizierte Konto aktiviert. ``` aws ec2 enable-address-transfer \ --allocation-id eipalloc-09ad461b0d03f6aaf \ --transfer-account-id 123456789012 ``` Ausgabe: ``` { "AddressTransfer": { "PublicIp": "100.21.184.216", "AllocationId": "eipalloc-09ad461b0d03f6aaf", "TransferAccountId": "123456789012", "TransferOfferExpirationTimestamp": "2023-02-22T20:51:01.000Z", "AddressTransferStatus": "pending" } } ``` Weitere Informationen finden Sie unter [Übertragen von Elastic-IP-Adressen](https://docs.aws.amazon.com/vpc/latest/userguide/WorkWithEIPs.html#transfer-EIPs-intro) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [EnableAddressTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-address-transfer.html)in der *AWS CLI Befehlsreferenz*. ### `enable-aws-network-performance-metric-subscription` Das folgende Codebeispiel zeigt die Verwendung`enable-aws-network-performance-metric-subscription`. **AWS CLI** **So aktivieren Sie ein Metrikabonnement** Im folgenden Beispiel für `enable-aws-network-performance-metric-subscription` wird die Überwachung der aggregierten Netzwerklatenz zwischen den angegebenen Quell- und Zielregionen aktiviert. ``` aws ec2 enable-aws-network-performance-metric-subscription \ --source us-east-1 \ --destination eu-west-1 \ --metric aggregate-latency \ --statistic p50 ``` Ausgabe: ``` { "Output": true } ``` Weitere Informationen finden Sie unter [Verwalten von Abonnements](https://docs.aws.amazon.com/network-manager/latest/infrastructure-performance/nmip-subscriptions-cw.html) im *Benutzerhandbuch für Infrastructure Performance*. + Einzelheiten zur API finden Sie [EnableAwsNetworkPerformanceMetricSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-aws-network-performance-metric-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `enable-ebs-encryption-by-default` Das folgende Codebeispiel zeigt die Verwendung`enable-ebs-encryption-by-default`. **AWS CLI** **So aktivieren Sie die EBS-Verschlüsselung standardmäßig** Das folgende `enable-ebs-encryption-by-default` Beispiel aktiviert standardmäßig die EBS-Verschlüsselung für Ihr AWS Konto in der aktuellen Region. ``` aws ec2 enable-ebs-encryption-by-default ``` Ausgabe: ``` { "EbsEncryptionByDefault": true } ``` + Einzelheiten zur API finden Sie [EnableEbsEncryptionByDefault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-ebs-encryption-by-default.html)in der *AWS CLI Befehlsreferenz.* ### `enable-fast-launch` Das folgende Codebeispiel zeigt die Verwendung`enable-fast-launch`. **AWS CLI** **So leiten Sie den Schnellstart für ein Image ein** Im folgenden Beispiel für `enable-fast-launch` wird das angegebene AMI für den Schnellstart konfiguriert und die maximale Anzahl der parallel zu startenden Instances auf 6 festgelegt. Der Ressourcentyp, die für die Vorabbereitstellung des AMI verwendet werden soll, ist auf `snapshot` festgelegt, was auch der Standardwert ist. ``` aws ec2 enable-fast-launch \ --image-id ami-01234567890abcedf \ --max-parallel-launches 6 \ --resource-type snapshot ``` Ausgabe: ``` { "ImageId": "ami-01234567890abcedf", "ResourceType": "snapshot", "SnapshotConfiguration": { "TargetResourceCount": 10 }, "LaunchTemplate": {}, "MaxParallelLaunches": 6, "OwnerId": "0123456789123", "State": "enabling", "StateTransitionReason": "Client.UserInitiated", "StateTransitionTime": "2022-01-27T22:16:03.199000+00:00" } ``` Weitere Informationen finden Sie unter [Konfigurieren der EC2-Schnellstarteinstellungen für Ihr Windows-AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/win-fast-launch-configure.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [EnableFastLaunch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-fast-launch.html)in der *AWS CLI Befehlsreferenz*. ### `enable-fast-snapshot-restores` Das folgende Codebeispiel zeigt die Verwendung`enable-fast-snapshot-restores`. **AWS CLI** **So aktivieren Sie die schnelle Snapshot-Wiederherstellung** Im folgenden Beispiel für `enable-fast-snapshot-restores` wird die schnelle Snapshot-Wiederherstellung für den angegebenen Snapshot in den festgelegten Availability Zones aktiviert. ``` aws ec2 enable-fast-snapshot-restores \ --availability-zones us-east-2a us-east-2b \ --source-snapshot-ids snap-1234567890abcdef0 ``` Ausgabe: ``` { "Successful": [ { "SnapshotId": "snap-1234567890abcdef0" "AvailabilityZone": "us-east-2a", "State": "enabling", "StateTransitionReason": "Client.UserInitiated", "OwnerId": "123456789012", "EnablingTime": "2020-01-25T23:57:49.602Z" }, { "SnapshotId": "snap-1234567890abcdef0" "AvailabilityZone": "us-east-2b", "State": "enabling", "StateTransitionReason": "Client.UserInitiated", "OwnerId": "123456789012", "EnablingTime": "2020-01-25T23:57:49.596Z" } ], "Unsuccessful": [] } ``` + Einzelheiten zur API finden Sie [EnableFastSnapshotRestores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-fast-snapshot-restores.html)in der *AWS CLI Befehlsreferenz*. ### `enable-image-block-public-access` Das folgende Codebeispiel zeigt die Verwendung`enable-image-block-public-access`. **AWS CLI** **Um den öffentlichen Zugriff blockieren für AMIs die angegebene Region zu aktivieren** Im folgenden `enable-image-block-public-access` Beispiel wird die Sperrung des öffentlichen Zugriffs AMIs auf Kontoebene in der angegebenen Region aktiviert. ``` aws ec2 enable-image-block-public-access \ --region us-east-1 \ --image-block-public-access-state block-new-sharing ``` Ausgabe: ``` { "ImageBlockPublicAccessState": "block-new-sharing" } ``` Weitere Informationen finden Sie unter [Sperren des öffentlichen Zugriffs auf Ihr AMIs](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/sharingamis-intro.html#block-public-access-to-amis) im *Amazon EC2 EC2-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [EnableImageBlockPublicAccess AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-image-block-public-access.html)*Befehlsreferenz.* ### `enable-image-deprecation` Das folgende Codebeispiel zeigt die Verwendung`enable-image-deprecation`. **AWS CLI** **So kennzeichnen Sie ein AMI als veraltet** Im folgenden Beispiel für `enable-image-deprecation` veraltet ein AMI an einem bestimmten Datum und einer bestimmten Uhrzeit. Wenn Sie einen Wert für Sekunden angeben, rundet Amazon EC2 die Sekunden auf die nächste Minute. Sie müssen der AMI-Besitzer sein, um dieses Verfahren durchführen zu können. ``` aws ec2 enable-image-deprecation \ --image-id ami-1234567890abcdef0 \ --deprecate-at '2022-10-15T13:17:12.000Z' ``` Ausgabe: ``` { "RequestID": "59dbff89-35bd-4eac-99ed-be587EXAMPLE", "Return": "true" } ``` Weitere Informationen finden Sie unter [Kennzeichnen eines AMI als veraltet](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deprecate.html#deprecate-ami) im *benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [EnableImageDeprecation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-image-deprecation.html)in der *AWS CLI Befehlsreferenz*. ### `enable-image-deregistration-protection` Das folgende Codebeispiel zeigt die Verwendung`enable-image-deregistration-protection`. **AWS CLI** **So aktivieren Sie den Abmeldeschutz** Im folgenden Beispiel für `enable-image-deregistration-protection` wird der Abmeldeschutz für das angegebene Image aktiviert. ``` aws ec2 enable-image-deregistration-protection \ --image-id ami-0b1a928a144a74ec9 ``` Ausgabe: ``` { "Return": "enabled-without-cooldown" } ``` Weitere Informationen finden Sie unter [Schützen eines EC2-AMI vor der Aufhebung der Registrierung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deregistration-protection.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [EnableImageDeregistrationProtection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-image-deregistration-protection.html)in der *AWS CLI Befehlsreferenz*. ### `enable-image` Das folgende Codebeispiel zeigt die Verwendung`enable-image`. **AWS CLI** **So aktivieren Sie ein AMI** Im folgenden Beispiel für `enable-image` wird das angegebene AMI aktiviert. ``` aws ec2 enable-image \ --image-id ami-1234567890abcdef0 ``` Ausgabe: ``` { "Return": "true" } ``` Weitere Informationen finden Sie unter [Deaktivieren eines AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/disable-an-ami.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [EnableImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-image.html)in der *AWS CLI Befehlsreferenz*. ### `enable-ipam-organization-admin-account` Das folgende Codebeispiel zeigt die Verwendung`enable-ipam-organization-admin-account`. **AWS CLI** **Um sich mit AWS Organizations zu integrieren und ein Mitgliedskonto als IPAM-Konto zu delegieren** Das folgende `enable-ipam-organization-admin-account` Beispiel integriert IPAM in AWS Organizations und delegiert ein Mitgliedskonto als IPAM-Konto. ``` aws ec2 enable-ipam-organization-admin-account \ --delegated-admin-account-id 320805250157 ``` Ausgabe: ``` { "Success": true } ``` Weitere Informationen finden Sie unter [Integrate IPAM with AWS Organizations](https://docs.aws.amazon.com/vpc/latest/ipam/enable-integ-ipam.html) im *Amazon VPC IPAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [EnableIpamOrganizationAdminAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-ipam-organization-admin-account.html).AWS CLI * ### `enable-reachability-analyzer-organization-sharing` Das folgende Codebeispiel zeigt die Verwendung`enable-reachability-analyzer-organization-sharing`. **AWS CLI** **So aktivieren Sie den vertrauenswürdigen Zugriff für Reachability Analyzer** Im folgenden Beispiel für `enable-reachability-analyzer-organization-sharing` wird der vertrauenswürdige Zugriff für Reachability Analyzer aktiviert. ``` aws ec2 enable-reachability-analyzer-organization-sharing ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontoübergreifende Analysen](https://docs.aws.amazon.com/vpc/latest/reachability/multi-account.html) im *Benutzerhandbuch für Reachability Analyzer*. + Einzelheiten zur API finden Sie [EnableReachabilityAnalyzerOrganizationSharing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-reachability-analyzer-organization-sharing.html)in der *AWS CLI Befehlsreferenz*. ### `enable-serial-console-access` Das folgende Codebeispiel zeigt die Verwendung`enable-serial-console-access`. **AWS CLI** **So aktivieren Sie den Zugriff auf die serielle Konsole für Ihr Konto** Im folgenden Beispiel für `enable-serial-console-access` wird der Kontozugriff auf die serielle Konsole aktiviert. ``` aws ec2 enable-serial-console-access ``` Ausgabe: ``` { "SerialConsoleAccessEnabled": true } ``` Weitere Informationen finden Sie unter [Serielle EC2-Konsole](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-serial-console.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [EnableSerialConsoleAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-serial-console-access.html)in der *AWS CLI Befehlsreferenz*. ### `enable-snapshot-block-public-access` Das folgende Codebeispiel zeigt die Verwendung`enable-snapshot-block-public-access`. **AWS CLI** **So aktivieren Sie das Blockieren des öffentlichen Zugriffs für Snapshots** Im folgenden Beispiel für `enable-snapshot-block-public-access` wird die gesamte öffentliche Freigabe Ihrer Snapshots blockiert. ``` aws ec2 enable-snapshot-block-public-access \ --state block-all-sharing ``` Ausgabe: ``` { "State": "block-all-sharing" } ``` Weitere Informationen finden Sie unter [Blockieren des öffentlichen Zugriffs für Snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/block-public-access-snapshots.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [EnableSnapshotBlockPublicAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-snapshot-block-public-access.html)in der *AWS CLI Befehlsreferenz*. ### `enable-transit-gateway-route-table-propagation` Das folgende Codebeispiel zeigt die Verwendung`enable-transit-gateway-route-table-propagation`. **AWS CLI** **So aktivieren Sie die Propagierung von Routen an die angegebene Übertragungs-Routing-Tabelle durch einen Transit-Gateway-Anhang** Im folgenden Beispiel für `enable-transit-gateway-route-table-propagation` wird das Verteilen von Routen an die festgelegte Übertragungs-Routing-Tabelle durch den angegebenen Anhang aktiviert. ``` aws ec2 enable-transit-gateway-route-table-propagation \ --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE \ --transit-gateway-attachment-id tgw-attach-09b52ccdb5EXAMPLE ``` Ausgabe: ``` { "Propagation": { "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE", "ResourceId": "vpc-4d7de228", "ResourceType": "vpc", "TransitGatewayRouteTableId": "tgw-rtb-0a823edbdeEXAMPLE", "State": "disabled" } } ``` Weitere Informationen finden Sie unter [Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [EnableTransitGatewayRouteTablePropagation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-transit-gateway-route-table-propagation.html)in der *AWS CLI Befehlsreferenz*. ### `enable-vgw-route-propagation` Das folgende Codebeispiel zeigt die Verwendung`enable-vgw-route-propagation`. **AWS CLI** **So aktivieren Sie die Routing-Verteilung** In diesem Beispiel wird das Verteilen von statischen Routen an die angegebene Routing-Tabelle durch das festgelegte Virtual Private Gateway aktiviert. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 enable-vgw-route-propagation --route-table-id rtb-22574640 --gateway-id vgw-9a4cacf3 ``` + Einzelheiten zur API finden Sie [EnableVgwRoutePropagation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-vgw-route-propagation.html)in der *AWS CLI Befehlsreferenz*. ### `enable-volume-io` Das folgende Codebeispiel zeigt die Verwendung`enable-volume-io`. **AWS CLI** **Um es I/O für ein Volume zu aktivieren** In diesem Beispiel wird ein Volume I/O aktiviert`vol-1234567890abcdef0`. Befehl: ``` aws ec2 enable-volume-io --volume-id vol-1234567890abcdef0 ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [EnableVolumeIo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-volume-io.html)in der *AWS CLI Befehlsreferenz*. ### `enable-vpc-classic-link-dns-support` Das folgende Codebeispiel zeigt die Verwendung`enable-vpc-classic-link-dns-support`. **AWS CLI** **So aktivieren Sie die ClassicLink DNS-Unterstützung für eine VPC** In diesem Beispiel wird die ClassicLink DNS-Unterstützung für `vpc-88888888` aktiviert. Befehl: ``` aws ec2 enable-vpc-classic-link-dns-support --vpc-id vpc-88888888 ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [EnableVpcClassicLinkDnsSupport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-vpc-classic-link-dns-support.html)in der *AWS CLI Befehlsreferenz*. ### `enable-vpc-classic-link` Das folgende Codebeispiel zeigt die Verwendung`enable-vpc-classic-link`. **AWS CLI** **So aktivieren Sie eine VPC für ClassicLink** Dieses Beispiel aktiviert vpc-8888888 für. ClassicLink Befehl: ``` aws ec2 enable-vpc-classic-link --vpc-id vpc-88888888 ``` Ausgabe: ``` { "Return": true } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [EnableVpcClassicLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/enable-vpc-classic-link.html).AWS CLI * ### `export-client-vpn-client-certificate-revocation-list` Das folgende Codebeispiel zeigt die Verwendung`export-client-vpn-client-certificate-revocation-list`. **AWS CLI** **So exportieren Sie eine Client-Zertifikatsperrliste** Im folgenden Beispiel für `export-client-vpn-client-certificate-revocation-list` wird die Client-Zertifikatsperrliste für den angegebenen Client-VPN-Endpunkt exportiert. In diesem Beispiel wird die Ausgabe im Textformat zurückgegeben, um das Lesen zu erleichtern. ``` aws ec2 export-client-vpn-client-certificate-revocation-list \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \ --output text ``` Ausgabe: ``` -----BEGIN X509 CRL----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END X509 CRL----- STATUS pending ``` Weitere Informationen finden Sie unter [Client-Zertifikatsperrlisten](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-certificates.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [ExportClientVpnClientCertificateRevocationList](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/export-client-vpn-client-certificate-revocation-list.html)in der *AWS CLI Befehlsreferenz*. ### `export-client-vpn-client-configuration` Das folgende Codebeispiel zeigt die Verwendung`export-client-vpn-client-configuration`. **AWS CLI** **So exportieren Sie die Client-Konfiguration** Im folgenden Beispiel für `export-client-vpn-client-configuration` wird die Client-Konfiguration für den angegebenen Client-VPN-Endpunkt exportiert. In diesem Beispiel wird die Ausgabe im Textformat zurückgegeben, um das Lesen zu erleichtern. ``` aws ec2 export-client-vpn-client-configuration \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \ --output text ``` Ausgabe: ``` client dev tun proto udp remote cvpn-endpoint-123456789123abcde.prod.clientvpn.ap-south-1.amazonaws.com 443 remote-random-hostname resolv-retry infinite nobind persist-key persist-tun remote-cert-tls server cipher AES-256-GCM verb 3 -----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE----- reneg-sec 0 ``` Weitere Informationen finden Sie unter [Export der Konfigurationsdatei für den Client-VPN-Endpunkt](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-endpoint-export.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [ExportClientVpnClientConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/export-client-vpn-client-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `export-image` Das folgende Codebeispiel zeigt die Verwendung`export-image`. **AWS CLI** **So exportieren Sie eine VM von einem AMI** Im folgenden Beispiel für `export-image` wird das angegebene AMI im angegebenen Format in den spezifizierten Bucket exportiert. ``` aws ec2 export-image \ --image-id ami-1234567890abcdef0 \ --disk-image-format VMDK \ --s3-export-location S3Bucket=my-export-bucket,S3Prefix=exports/ ``` Ausgabe: ``` { "DiskImageFormat": "vmdk", "ExportImageTaskId": "export-ami-1234567890abcdef0" "ImageId": "ami-1234567890abcdef0", "RoleName": "vmimport", "Progress": "0", "S3ExportLocation": { "S3Bucket": "my-export-bucket", "S3Prefix": "exports/" }, "Status": "active", "StatusMessage": "validating" } ``` + Einzelheiten zur API finden Sie [ExportImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/export-image.html)in der *AWS CLI Befehlsreferenz*. ### `get-associated-ipv6-pool-cidrs` Das folgende Codebeispiel zeigt die Verwendung`get-associated-ipv6-pool-cidrs`. **AWS CLI** **Um die Verknüpfungen für einen IPv6 Adresspool abzurufen** Im folgenden `get-associated-ipv6-pool-cidrs` Beispiel werden die Verknüpfungen für den angegebenen IPv6 Adresspool abgerufen. ``` aws ec2 get-associated-ipv6-pool-cidrs \ --pool-id ipv6pool-ec2-012345abc12345abc ``` Ausgabe: ``` { "Ipv6CidrAssociations": [ { "Ipv6Cidr": "2001:db8:1234:1a00::/56", "AssociatedResource": "vpc-111111222222333ab" } ] } ``` + Einzelheiten zur API finden Sie unter [GetAssociatedIpv6 PoolCidrs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-associated-ipv6-pool-cidrs.html) in der *AWS CLI Befehlsreferenz*. ### `get-aws-network-performance-data` Das folgende Codebeispiel zeigt die Verwendung`get-aws-network-performance-data`. **AWS CLI** **So rufen Sie Netzwerkleistungsdaten ab** Im folgenden Beispiel für `get-aws-network-performance-data` werden Daten zur Netzwerkleistung zwischen den angegebenen Regionen im festgelegten Zeitraum abgerufen. ``` aws ec2 get-aws-network-performance-data \ --start-time 2022-10-26T12:00:00.000Z \ --end-time 2022-10-26T12:30:00.000Z \ --data-queries Id=my-query,Source=us-east-1,Destination=eu-west-1,Metric=aggregate-latency,Statistic=p50,Period=five-minutes ``` Ausgabe: ``` { "DataResponses": [ { "Id": "my-query", "Source": "us-east-1", "Destination": "eu-west-1", "Metric": "aggregate-latency", "Statistic": "p50", "Period": "five-minutes", "MetricPoints": [ { "StartDate": "2022-10-26T12:00:00+00:00", "EndDate": "2022-10-26T12:05:00+00:00", "Value": 62.44349, "Status": "OK" }, { "StartDate": "2022-10-26T12:05:00+00:00", "EndDate": "2022-10-26T12:10:00+00:00", "Value": 62.483498, "Status": "OK" }, { "StartDate": "2022-10-26T12:10:00+00:00", "EndDate": "2022-10-26T12:15:00+00:00", "Value": 62.51248, "Status": "OK" }, { "StartDate": "2022-10-26T12:15:00+00:00", "EndDate": "2022-10-26T12:20:00+00:00", "Value": 62.635475, "Status": "OK" }, { "StartDate": "2022-10-26T12:20:00+00:00", "EndDate": "2022-10-26T12:25:00+00:00", "Value": 62.733974, "Status": "OK" }, { "StartDate": "2022-10-26T12:25:00+00:00", "EndDate": "2022-10-26T12:30:00+00:00", "Value": 62.773975, "Status": "OK" }, { "StartDate": "2022-10-26T12:30:00+00:00", "EndDate": "2022-10-26T12:35:00+00:00", "Value": 62.75349, "Status": "OK" } ] } ] } ``` Weitere Informationen finden Sie unter [Überwachen der Netzwerkleistung](https://docs.aws.amazon.com/network-manager/latest/infrastructure-performance/nmip-performance-cli.html) im *Benutzerhandbuch für Infrastructure Performance*. + Einzelheiten zur API finden Sie [GetAwsNetworkPerformanceData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-aws-network-performance-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-capacity-reservation-usage` Das folgende Codebeispiel zeigt die Verwendung`get-capacity-reservation-usage`. **AWS CLI** **Um die Nutzung der Kapazitätsreservierungen für mehrere AWS Konten anzuzeigen** Im folgenden Beispiel für `get-capacity-reservation-usage` werden die Nutzungsinformationen zu der angegebenen Kapazitätsreservierung angezeigt. ``` aws ec2 get-capacity-reservation-usage \ --capacity-reservation-id cr-1234abcd56EXAMPLE ``` Ausgabe: ``` { "CapacityReservationId": "cr-1234abcd56EXAMPLE ", "InstanceUsages": [ { "UsedInstanceCount": 1, "AccountId": "123456789012" } ], "AvailableInstanceCount": 4, "TotalInstanceCount": 5, "State": "active", "InstanceType": "t2.medium" } ``` Weitere Informationen finden Sie unter [Freigegebene Kapazitätsreservierungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservation-sharing.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [GetCapacityReservationUsage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-capacity-reservation-usage.html)in der *AWS CLI Befehlsreferenz*. ### `get-coip-pool-usage` Das folgende Codebeispiel zeigt die Verwendung`get-coip-pool-usage`. **AWS CLI** **So rufen Sie Nutzungsinformationen zum kundeneigenen IP-Adresspool ab** Im folgenden Beispiel für `get-coip-pool-usage` werden die Nutzungsdetails für den angegebenen kundeneigenen IP-Adresspool abgerufen. ``` aws ec2 get-coip-pool-usage \ --pool-id ipv4pool-coip-123a45678bEXAMPLE ``` Ausgabe: ``` { "CoipPoolId": "ipv4pool-coip-123a45678bEXAMPLE", "CoipAddressUsages": [ { "CoIp": "0.0.0.0" }, { "AllocationId": "eipalloc-123ab45c6dEXAMPLE", "AwsAccountId": "123456789012", "CoIp": "0.0.0.0" }, { "AllocationId": "eipalloc-123ab45c6dEXAMPLE", "AwsAccountId": "123456789111", "CoIp": "0.0.0.0" } ], "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE" } ``` Weitere Informationen finden Sie unter [Kundeneigene IP-Adressen](https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#ip-addressing) im *Benutzerhandbuch für AWS -Outposts für Outposts-Racks*. + Einzelheiten zur API finden Sie [GetCoipPoolUsage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-coip-pool-usage.html)in der *AWS CLI Befehlsreferenz*. ### `get-console-output` Das folgende Codebeispiel zeigt die Verwendung`get-console-output`. **AWS CLI** **Beispiel 1: So rufen Sie die Konsolenausgabe ab** Im folgenden Beispiel für `get-console-output` wird die Konsolenausgabe für die angegebene Linux-Instance abgerufen. ``` aws ec2 get-console-output \ --instance-id i-1234567890abcdef0 ``` Ausgabe: ``` { "InstanceId": "i-1234567890abcdef0", "Timestamp": "2013-07-25T21:23:53.000Z", "Output": "..." } ``` Weitere Informationen finden Sie unter [Instance-Konsolenausgabe](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-console.html#instance-console-console-output) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So rufen Sie die neueste Konsolenausgabe ab** Im folgenden Beispiel für `get-console-output` wird die neueste Konsolenausgabe für die angegebene Linux-Instance abgerufen. ``` aws ec2 get-console-output \ --instance-id i-1234567890abcdef0 \ --latest \ --output text ``` Ausgabe: ``` i-1234567890abcdef0 [ 0.000000] Command line: root=LABEL=/ console=tty1 console=ttyS0 selinux=0 nvme_core.io_timeout=4294967295 [ 0.000000] x86/fpu: Supporting XSAVE feature 0x001: 'x87 floating point registers' [ 0.000000] x86/fpu: Supporting XSAVE feature 0x002: 'SSE registers' [ 0.000000] x86/fpu: Supporting XSAVE feature 0x004: 'AVX registers' ... Cloud-init v. 0.7.6 finished at Wed, 09 May 2018 19:01:13 +0000. Datasource DataSourceEc2. Up 21.50 seconds Amazon Linux AMI release 2018.03 Kernel 4.14.26-46.32.amzn1.x ``` Weitere Informationen finden Sie unter [Instance-Konsolenausgabe](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-console.html#instance-console-console-output) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [GetConsoleOutput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-console-output.html)in der *AWS CLI Befehlsreferenz*. ### `get-console-screenshot` Das folgende Codebeispiel zeigt die Verwendung`get-console-screenshot`. **AWS CLI** **So rufen Sie einen Screenshot einer laufenden Instance ab** Im folgenden Beispiel für `get-console-screenshot` wird ein Screenshot der angegebenen Instance im JPG-Format abgerufen. Der Screenshot wird als Base64-kodierte Zeichenfolge zurückgegeben. ``` aws ec2 get-console-screenshot \ --instance-id i-1234567890abcdef0 ``` Ausgabe: ``` { "ImageData": "997987/8kgj49ikjhewkwwe0008084EXAMPLE", "InstanceId": "i-1234567890abcdef0" } ``` + Einzelheiten zur API finden Sie [GetConsoleScreenshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-console-screenshot.html)in der *AWS CLI Befehlsreferenz*. ### `get-default-credit-specification` Das folgende Codebeispiel zeigt die Verwendung`get-default-credit-specification`. **AWS CLI** **So beschreiben Sie die Standard-Guthabenoption** Im folgenden Beispiel für `get-default-credit-specification` wird die Standard-Guthabenoption für T2-Instances beschrieben. ``` aws ec2 get-default-credit-specification \ --instance-family t2 ``` Ausgabe: ``` { "InstanceFamilyCreditSpecification": { "InstanceFamily": "t2", "CpuCredits": "standard" } } ``` + Einzelheiten zur API finden Sie [GetDefaultCreditSpecification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-default-credit-specification.html)in der *AWS CLI Befehlsreferenz*. ### `get-ebs-default-kms-key-id` Das folgende Codebeispiel zeigt die Verwendung`get-ebs-default-kms-key-id`. **AWS CLI** **So beschreiben Sie Ihren Standard-CMK für die EBS-Verschlüsselung** Das folgende `get-ebs-default-kms-key-id` Beispiel beschreibt das Standard-CMK für die EBS-Verschlüsselung für Ihr AWS Konto. ``` aws ec2 get-ebs-default-kms-key-id ``` Die Ausgabe zeigt den Standard-CMK für die EBS-Verschlüsselung, bei dem es sich um einen AWS verwalteten CMK mit dem Alias handelt. `alias/aws/ebs` ``` { "KmsKeyId": "alias/aws/ebs" } ``` Die folgende Ausgabe zeigt einen benutzerdefinierten CMK für die EBS-Verschlüsselung. ``` { "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE" } ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz [GetEbsDefaultKmsKeyId](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-ebs-default-kms-key-id.html).AWS CLI * ### `get-ebs-encryption-by-default` Das folgende Codebeispiel zeigt die Verwendung`get-ebs-encryption-by-default`. **AWS CLI** **So beschreiben Sie, ob die EBS-Verschlüsselung standardmäßig aktiviert ist** Das folgende `get-ebs-encryption-by-default` Beispiel zeigt, ob die EBS-Verschlüsselung standardmäßig für Ihr AWS Konto in der aktuellen Region aktiviert ist. ``` aws ec2 get-ebs-encryption-by-default ``` Die folgende Ausgabe weist darauf hin, dass die EBS-Verschlüsselung standardmäßig deaktiviert ist. ``` { "EbsEncryptionByDefault": false } ``` Die folgende Ausgabe gibt an, dass die EBS-Verschlüsselung standardmäßig aktiviert ist. ``` { "EbsEncryptionByDefault": true } ``` + Einzelheiten zur API finden Sie unter [GetEbsEncryptionByDefault AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-ebs-encryption-by-default.html)*Befehlsreferenz.* ### `get-flow-logs-integration-template` Das folgende Codebeispiel zeigt die Verwendung`get-flow-logs-integration-template`. **AWS CLI** **Um eine CloudFormation Vorlage zur Automatisierung der Integration von VPC-Flow-Protokollen mit Amazon Athena zu erstellen** In den folgenden `get-flow-logs-integration-template` Beispielen wird eine CloudFormation Vorlage zur Automatisierung der Integration von VPC-Flow-Protokollen mit Amazon Athena erstellt. Linux: ``` aws ec2 get-flow-logs-integration-template \ --flow-log-id fl-1234567890abcdef0 \ --config-delivery-s3-destination-arn arn:aws:s3:::amzn-s3-demo-bucket \ --integrate-services AthenaIntegrations='[{IntegrationResultS3DestinationArn=arn:aws:s3:::amzn-s3-demo-bucket,PartitionLoadFrequency=none,PartitionStartDate=2021-07-21T00:40:00,PartitionEndDate=2021-07-21T00:42:00},{IntegrationResultS3DestinationArn=arn:aws:s3:::amzn-s3-demo-bucket,PartitionLoadFrequency=none,PartitionStartDate=2021-07-21T00:40:00,PartitionEndDate=2021-07-21T00:42:00}]' ``` Windows: ``` aws ec2 get-flow-logs-integration-template ^ --flow-log-id fl-1234567890abcdef0 ^ --config-delivery-s3-destination-arn arn:aws:s3:::amzn-s3-demo-bucket ^ --integrate-services AthenaIntegrations=[{IntegrationResultS3DestinationArn=arn:aws:s3:::amzn-s3-demo-bucket,PartitionLoadFrequency=none,PartitionStartDate=2021-07-21T00:40:00,PartitionEndDate=2021-07-21T00:42:00},{IntegrationResultS3DestinationArn=arn:aws:s3:::amzn-s3-demo-bucket,PartitionLoadFrequency=none,PartitionStartDate=2021-07-21T00:40:00,PartitionEndDate=2021-07-21T00:42:00}] ``` Ausgabe: ``` { "Result": "https://amzn-s3-demo-bucket.s3.us-east-2.amazonaws.com/VPCFlowLogsIntegrationTemplate_fl-1234567890abcdef0_Wed%20Jul%2021%2000%3A57%3A56%20UTC%202021.yml" } ``` Informationen zur Verwendung von CloudFormation Vorlagen finden Sie unter [Arbeiten mit AWS CloudFormation Vorlagen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html) im *AWS CloudFormation Benutzerhandbuch*. Informationen zur Verwendung von Amazon Athena und Flow-Protokollen finden Sie unter [Query flow logs using Amazon Athena](https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs-athena.html) im *Benutzerhandbuch für Amazon Virtual Private Cloud*. + Einzelheiten zur API finden Sie [GetFlowLogsIntegrationTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-flow-logs-integration-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-groups-for-capacity-reservation` Das folgende Codebeispiel zeigt die Verwendung`get-groups-for-capacity-reservation`. **AWS CLI** **So listen Sie die Ressourcengruppen mit einer Kapazitätsreservierung auf** Im folgenden für `get-groups-for-capacity-reservation` werden die Ressourcengruppen aufgelistet, denen die angegebene Kapazitätsreservierung hinzugefügt wurde. ``` aws ec2 get-groups-for-capacity-reservation \ --capacity-reservation-id cr-1234abcd56EXAMPLE ``` Ausgabe: ``` { "CapacityReservationsGroup": [ { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/my-resource-group", "OwnerId": "123456789012" } ] } ``` Weitere Informationen finden Sie unter [Kapazitätsreservierungsgruppen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-cr-group.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [GetGroupsForCapacityReservation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-groups-for-capacity-reservation.html)in der *AWS CLI Befehlsreferenz*. ### `get-host-reservation-purchase-preview` Das folgende Codebeispiel zeigt die Verwendung`get-host-reservation-purchase-preview`. **AWS CLI** **So rufen Sie eine Vorschau zum Kauf einer Dedicated-Host-Reservierung ab** Dieses Beispiel bietet eine Vorschau der Kosten für eine bestimmte Dedicated-Host-Reservierung für den angegebenen Dedicated Host in Ihrem Konto. Befehl: ``` aws ec2 get-host-reservation-purchase-preview --offering-id hro-03f707bf363b6b324 --host-id-set h-013abcd2a00cbd123 ``` Ausgabe: ``` { "TotalHourlyPrice": "1.499", "Purchase": [ { "HourlyPrice": "1.499", "InstanceFamily": "m4", "PaymentOption": "NoUpfront", "HostIdSet": [ "h-013abcd2a00cbd123" ], "UpfrontPrice": "0.000", "Duration": 31536000 } ], "TotalUpfrontPrice": "0.000" } ``` + Einzelheiten zur API finden Sie [GetHostReservationPurchasePreview](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-host-reservation-purchase-preview.html)in der *AWS CLI Befehlsreferenz*. ### `get-image-block-public-access-state` Das folgende Codebeispiel zeigt die Verwendung`get-image-block-public-access-state`. **AWS CLI** **Um den Status des Blockierens des öffentlichen Zugriffs AMIs in der angegebenen Region abzurufen** Im folgenden `get-image-block-public-access-state` Beispiel wird der Status „Öffentlicher Zugriff gesperrt“ AMIs auf Kontoebene in der angegebenen Region abgerufen. ``` aws ec2 get-image-block-public-access-state \ --region us-east-1 ``` Ausgabe: ``` { "ImageBlockPublicAccessState": "block-new-sharing" } ``` Weitere Informationen finden Sie unter [Sperren des öffentlichen Zugriffs auf Ihr AMIs](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/sharingamis-intro.html#block-public-access-to-amis) im *Amazon EC2 EC2-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetImageBlockPublicAccessState AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-image-block-public-access-state.html)*Befehlsreferenz.* ### `get-instance-types-from-instance-requirements` Das folgende Codebeispiel zeigt die Verwendung`get-instance-types-from-instance-requirements`. **AWS CLI** **So zeigen Sie eine Vorschau der Instance-Typen an, die den angegebenen Attributen entsprechen** Im folgenden Beispiel für `get-instance-types-from-instance-requirements` wird zunächst eine Liste aller möglichen Attribute generiert, die mithilfe des Parameters `--generate-cli-skeleton` angegeben werden können. Die Liste wird dann in einer JSON-Datei gespeichert. Anschließend wird die JSON-Datei verwendet, um die Attribute anzupassen, für die eine Vorschau der übereinstimmenden Instance-Typen angezeigt werden soll. Verwenden Sie den folgenden Befehl, um alle möglichen Attribute zu generieren und die Ausgabe direkt in einer JSON-Datei zu speichern. ``` aws ec2 get-instance-types-from-instance-requirements \ --region us-east-1 \ --generate-cli-skeleton input > attributes.json ``` Ausgabe: ``` { "DryRun": true, "ArchitectureTypes": [ "x86_64_mac" ], "VirtualizationTypes": [ "paravirtual" ], "InstanceRequirements": { "VCpuCount": { "Min": 0, "Max": 0 }, "MemoryMiB": { "Min": 0, "Max": 0 }, "CpuManufacturers": [ "intel" ], "MemoryGiBPerVCpu": { "Min": 0.0, "Max": 0.0 }, "ExcludedInstanceTypes": [ "" ], "InstanceGenerations": [ "current" ], "SpotMaxPricePercentageOverLowestPrice": 0, "OnDemandMaxPricePercentageOverLowestPrice": 0, "BareMetal": "included", "BurstablePerformance": "excluded", "RequireHibernateSupport": true, "NetworkInterfaceCount": { "Min": 0, "Max": 0 }, "LocalStorage": "required", "LocalStorageTypes": [ "hdd" ], "TotalLocalStorageGB": { "Min": 0.0, "Max": 0.0 }, "BaselineEbsBandwidthMbps": { "Min": 0, "Max": 0 }, "AcceleratorTypes": [ "inference" ], "AcceleratorCount": { "Min": 0, "Max": 0 }, "AcceleratorManufacturers": [ "xilinx" ], "AcceleratorNames": [ "t4" ], "AcceleratorTotalMemoryMiB": { "Min": 0, "Max": 0 } }, "MaxResults": 0, "NextToken": "" } ``` Konfigurieren Sie die JSON-Datei. Sie müssen Werte für `ArchitectureTypes`, `VirtualizationTypes`, `VCpuCount` und `MemoryMiB` angeben. Die anderen Attribute können Sie weglassen. Wenn sie weggelassen werden, kommen Standardwerte zum Einsatz. Eine Beschreibung der einzelnen Attribute und ihrer Standardwerte finden Sie unter get-instance-types-from -instance-requirements < - -requirements.html> https://docs.aws.amazon.com/cli/latest/reference/ec2/get. instance-types-from-instance Zeigen Sie die Instance-Typen mit den in `attributes.json` angegebenen Attributen in einer Vorschau an. Geben Sie mithilfe des Parameters `--cli-input-json` den Namen und den Pfad zu Ihrer JSON-Datei an. In der folgenden Anforderung wird die Ausgabe als Tabelle formatiert. ``` aws ec2 get-instance-types-from-instance-requirements \ --cli-input-json file://attributes.json \ --output table ``` Inhalt der `attributes.json`-Datei: ``` { "ArchitectureTypes": [ "x86_64" ], "VirtualizationTypes": [ "hvm" ], "InstanceRequirements": { "VCpuCount": { "Min": 4, "Max": 6 }, "MemoryMiB": { "Min": 2048 }, "InstanceGenerations": [ "current" ] } } ``` Ausgabe: ``` ------------------------------------------ |GetInstanceTypesFromInstanceRequirements| +----------------------------------------+ || InstanceTypes || |+--------------------------------------+| || InstanceType || |+--------------------------------------+| || c4.xlarge || || c5.xlarge || || c5a.xlarge || || c5ad.xlarge || || c5d.xlarge || || c5n.xlarge || || d2.xlarge || ... ``` Weitere Informationen zur attributbasierten Instance-Typ-Auswahl finden Sie unter [Funktionsweise der attributbasierten Auswahl von Instance-Typen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-attribute-based-instance-type-selection.html#ec2fleet-abs-how-it-works) im *Benutzerhandbuch für Amazon EC2*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetInstanceTypesFromInstanceRequirements](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-instance-types-from-instance-requirements.html)AWS CLI * ### `get-instance-uefi-data` Das folgende Codebeispiel zeigt die Verwendung`get-instance-uefi-data`. **AWS CLI** **So rufen Sie UEFI-Daten von einer Instance ab** Im folgenden Beispiel für `get-instance-uefi-data` werden UEFI-Daten von einer Instance abgerufen. Wenn die Ausgabe leer ist, enthält die Instance keine UEFI-Daten. ``` aws ec2 get-instance-uefi-data \ --instance-id i-0123456789example ``` Ausgabe: ``` { "InstanceId": "i-0123456789example", "UefiData": "QU1aTlVFRkkf+uLXAAAAAHj5a7fZ9+3dBzxXb/. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD4L/J/AODshho=" } ``` Weitere Informationen finden Sie unter [UEFI Secure Boot](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/uefi-secure-boot.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [GetInstanceUefiData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-instance-uefi-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-ipam-address-history` Das folgende Codebeispiel zeigt die Verwendung`get-ipam-address-history`. **AWS CLI** **So rufen Sie den Verlauf eines CIDR ab** Im folgenden Beispiel für `get-ipam-address-history` wird der Verlauf eines CIDR abgerufen. (Linux) ``` aws ec2 get-ipam-address-history \ --cidr 10.0.0.0/16 \ --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 \ --start-time 2021-12-08T01:00:00.000Z \ --end-time 2021-12-10T01:00:00.000Z ``` (Windows) ``` aws ec2 get-ipam-address-history ^ --cidr 10.0.0.0/16 ^ --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 ^ --start-time 2021-12-08T01:00:00.000Z ^ --end-time 2021-12-10T01:00:00.000Z ``` Ausgabe: ``` { "HistoryRecords": [ { "ResourceOwnerId": "123456789012", "ResourceRegion": "us-west-1", "ResourceType": "vpc", "ResourceId": "vpc-06cbefa9ee907e1c0", "ResourceCidr": "10.0.0.0/16", "ResourceName": "Demo", "ResourceComplianceStatus": "unmanaged", "ResourceOverlapStatus": "overlapping", "VpcId": "vpc-06cbefa9ee907e1c0", "SampledStartTime": "2021-12-08T19:54:57.675000+00:00" }, { "ResourceOwnerId": "123456789012", "ResourceRegion": "us-east-2", "ResourceType": "vpc", "ResourceId": "vpc-042702f474812c9ad", "ResourceCidr": "10.0.0.0/16", "ResourceName": "test", "ResourceComplianceStatus": "unmanaged", "ResourceOverlapStatus": "overlapping", "VpcId": "vpc-042702f474812c9ad", "SampledStartTime": "2021-12-08T19:54:59.019000+00:00" }, { "ResourceOwnerId": "123456789012", "ResourceRegion": "us-east-2", "ResourceType": "vpc", "ResourceId": "vpc-042b8a44f64267d67", "ResourceCidr": "10.0.0.0/16", "ResourceName": "tester", "ResourceComplianceStatus": "unmanaged", "ResourceOverlapStatus": "overlapping", "VpcId": "vpc-042b8a44f64267d67", "SampledStartTime": "2021-12-08T19:54:59.019000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen des Verlaufs von IP-Adressen](https://docs.aws.amazon.com/vpc/latest/ipam/view-history-cidr-ipam.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [GetIpamAddressHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-ipam-address-history.html)in der *AWS CLI Befehlsreferenz*. ### `get-ipam-discovered-accounts` Das folgende Codebeispiel zeigt die Verwendung`get-ipam-discovered-accounts`. **AWS CLI** **So sehen Sie die Konten ein, die von einem IPAM erkannt wurden** In diesem Szenario sind Sie ein delegierter IPAM-Administrator, der die AWS Konten einsehen möchte, denen Ressourcen gehören, die das IPAM entdeckt. Die `--discovery-region` ist die IPAM-Betriebsregion, in der Sie den Status der überwachten Konten einsehen möchten. Wenn Sie beispielsweise über drei IPAM-Betriebsregionen verfügen, können Sie diese Anfrage dreimal stellen, um die für die Erkennung spezifischen Zeitstempel in jeder dieser Regionen einzusehen. Das folgende `get-ipam-discovered-accounts` Beispiel listet die AWS Konten auf, denen Ressourcen gehören, die das IPAM entdeckt. ``` aws ec2 get-ipam-discovered-accounts \ --ipam-resource-discovery-id ipam-res-disco-0365d2977fc1672fe \ --discovery-region us-east-1 ``` Ausgabe: ``` { "IpamDiscoveredAccounts": [ { "AccountId": "149977607591", "DiscoveryRegion": "us-east-1", "LastAttemptedDiscoveryTime": "2024-02-09T19:04:31.379000+00:00", "LastSuccessfulDiscoveryTime": "2024-02-09T19:04:31.379000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Integrieren von IPAM mit Konten außerhalb Ihrer Organisation](https://docs.aws.amazon.com/vpc/latest/ipam/enable-integ-ipam-outside-org.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie unter [GetIpamDiscoveredAccounts AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-ipam-discovered-accounts.html)*Befehlsreferenz.* ### `get-ipam-discovered-public-addresses` Das folgende Codebeispiel zeigt die Verwendung`get-ipam-discovered-public-addresses`. **AWS CLI** **So zeigen Sie die erkannten öffentlichen IP-Adressen an** In diesem Beispiel sind Sie ein delegierter IPAM-Administrator und möchten die IP-Adressen der von IPAM erkannten Ressourcen einsehen. Sie können die Resource Discovery-ID mit abrufen [describe-ipam-resource-discoveries](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-ipam-resource-discoveries.html). Das folgende Beispiel für `get-ipam-discovered-public-addresses` zeigt die erkannten öffentlichen IP-Adressen für eine Ressourcenerkennung. ``` aws ec2 get-ipam-discovered-public-addresses \ --ipam-resource-discovery-id ipam-res-disco-0f4ef577a9f37a162 \ --address-region us-east-1 \ --region us-east-1 ``` Ausgabe: ``` { "IpamDiscoveredPublicAddresses": [ { "IpamResourceDiscoveryId": "ipam-res-disco-0f4ef577a9f37a162", "AddressRegion": "us-east-1", "Address": "54.208.155.7", "AddressOwnerId": "320805250157", "AssociationStatus": "associated", "AddressType": "ec2-public-ip", "VpcId": "vpc-073b294916198ce49", "SubnetId": "subnet-0b6c8a8839e9a4f15", "NetworkInterfaceId": "eni-081c446b5284a5e06", "NetworkInterfaceDescription": "", "InstanceId": "i-07459a6fca5b35823", "Tags": {}, "NetworkBorderGroup": "us-east-1c", "SecurityGroups": [ { "GroupName": "launch-wizard-2", "GroupId": "sg-0a489dd6a65c244ce" } ], "SampleTime": "2024-04-05T15:13:59.228000+00:00" }, { "IpamResourceDiscoveryId": "ipam-res-disco-0f4ef577a9f37a162", "AddressRegion": "us-east-1", "Address": "44.201.251.218", "AddressOwnerId": "470889052923", "AssociationStatus": "associated", "AddressType": "ec2-public-ip", "VpcId": "vpc-6c31a611", "SubnetId": "subnet-062f47608b99834b1", "NetworkInterfaceId": "eni-024845359c2c3ae9b", "NetworkInterfaceDescription": "", "InstanceId": "i-04ef786d9c4e03f41", "Tags": {}, "NetworkBorderGroup": "us-east-1a", "SecurityGroups": [ { "GroupName": "launch-wizard-32", "GroupId": "sg-0ed1a426e96a68374" } ], "SampleTime": "2024-04-05T15:13:59.145000+00:00" } } ``` Weitere Informationen finden Sie unter [Anzeigen von Einblicken in öffentliche IPs](https://docs.aws.amazon.com/vpc/latest/ipam/view-public-ip-insights.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [GetIpamDiscoveredPublicAddresses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-ipam-discovered-public-addresses.html)in der *AWS CLI Befehlsreferenz*. ### `get-ipam-discovered-resource-cidrs` Das folgende Codebeispiel zeigt die Verwendung`get-ipam-discovered-resource-cidrs`. **AWS CLI** **Um die von einem CIDRs IPAM erkannte IP-Adresse anzuzeigen** In diesem Beispiel sind Sie ein delegierter IPAM-Administrator, der Details CIDRs zur IP-Adresse von Ressourcen einsehen möchte, die das IPAM ermittelt. Gehen Sie wie folgt vor, um diese Anforderung abzuschließen: Die von Ihnen gewählte Ressourcenerkennung muss mit dem IPAM verknüpft sein. Dies `--resource-region` ist die Region, in der die Ressource erstellt wurde. AWS Im folgenden Beispiel für `get-ipam-discovered-resource-cidrs` werden die IP-Adressen für Ressourcen aufgelistet, die der IPAM erkennt. ``` aws ec2 get-ipam-discovered-resource-cidrs \ --ipam-resource-discovery-id ipam-res-disco-0365d2977fc1672fe \ --resource-region us-east-1 ``` Ausgabe: ``` { { "IpamDiscoveredResourceCidrs": [ { "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe", "ResourceRegion": "us-east-1", "ResourceId": "vpc-0c974c95ca7ceef4a", "ResourceOwnerId": "149977607591", "ResourceCidr": "172.31.0.0/16", "ResourceType": "vpc", "ResourceTags": [], "IpUsage": 0.375, "VpcId": "vpc-0c974c95ca7ceef4a", "SampleTime": "2024-02-09T19:15:16.529000+00:00" }, { "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe", "ResourceRegion": "us-east-1", "ResourceId": "subnet-07fe028119082a8c1", "ResourceOwnerId": "149977607591", "ResourceCidr": "172.31.0.0/20", "ResourceType": "subnet", "ResourceTags": [], "IpUsage": 0.0012, "VpcId": "vpc-0c974c95ca7ceef4a", "SampleTime": "2024-02-09T19:15:16.529000+00:00" }, { "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe", "ResourceRegion": "us-east-1", "ResourceId": "subnet-0a96893763984cc4e", "ResourceOwnerId": "149977607591", "ResourceCidr": "172.31.64.0/20", "ResourceType": "subnet", "ResourceTags": [], "IpUsage": 0.0012, "VpcId": "vpc-0c974c95ca7ceef4a", "SampleTime": "2024-02-09T19:15:16.529000+00:00" } } } ``` Weitere Informationen finden Sie unter [Überwachen der CIDR-Nutzung nach Ressource](https://docs.aws.amazon.com/vpc/latest/ipam/monitor-cidr-compliance-ipam.html) im *Benutzerhandbuch zu Amazon VPC IPAM*. + *Einzelheiten zur API finden Sie [GetIpamDiscoveredResourceCidrs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-ipam-discovered-resource-cidrs.html)in AWS CLI der Befehlsreferenz.* ### `get-ipam-pool-allocations` Das folgende Codebeispiel zeigt die Verwendung`get-ipam-pool-allocations`. **AWS CLI** **Um die CIDRs zugewiesenen Daten aus einem IPAM-Pool abzurufen** Im folgenden `get-ipam-pool-allocations` Beispiel wird der CIDRs zugewiesene Wert aus einem IPAM-Pool abgerufen. (Linux) ``` aws ec2 get-ipam-pool-allocations \ --ipam-pool-id ipam-pool-0533048da7d823723 \ --filters Name=ipam-pool-allocation-id,Values=ipam-pool-alloc-0e6186d73999e47389266a5d6991e6220 ``` (Windows) ``` aws ec2 get-ipam-pool-allocations ^ --ipam-pool-id ipam-pool-0533048da7d823723 ^ --filters Name=ipam-pool-allocation-id,Values=ipam-pool-alloc-0e6186d73999e47389266a5d6991e6220 ``` Ausgabe: ``` { "IpamPoolAllocations": [ { "Cidr": "10.0.0.0/16", "IpamPoolAllocationId": "ipam-pool-alloc-0e6186d73999e47389266a5d6991e6220", "ResourceType": "custom", "ResourceOwner": "123456789012" } ] } ``` + Einzelheiten zur API finden Sie [GetIpamPoolAllocations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-ipam-pool-allocations.html)in der *AWS CLI Befehlsreferenz.* ### `get-ipam-pool-cidrs` Das folgende Codebeispiel zeigt die Verwendung`get-ipam-pool-cidrs`. **AWS CLI** **Um die CIDRs bereitgestellten Daten in einen IPAM-Pool zu laden** Im folgenden `get-ipam-pool-cidrs` Beispiel wird das CIDRs Provisioning in einem IPAM-Pool abgerufen. (Linux) ``` aws ec2 get-ipam-pool-cidrs \ --ipam-pool-id ipam-pool-0533048da7d823723 \ --filters 'Name=cidr,Values=10.*' ``` (Windows) ``` aws ec2 get-ipam-pool-cidrs ^ --ipam-pool-id ipam-pool-0533048da7d823723 ^ --filters Name=cidr,Values=10.* ``` Ausgabe: ``` { "IpamPoolCidr": { "Cidr": "10.0.0.0/24", "State": "provisioned" } } ``` + Einzelheiten zur API finden Sie [GetIpamPoolCidrs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-ipam-pool-cidrs.html)in der *AWS CLI Befehlsreferenz*. ### `get-ipam-resource-cidrs` Das folgende Codebeispiel zeigt die Verwendung`get-ipam-resource-cidrs`. **AWS CLI** **Um das einer Ressource CIDRs zugewiesene zu erhalten** Im folgenden `get-ipam-resource-cidrs` Beispiel wird der einer Ressource CIDRs zugewiesene Wert abgerufen. (Linux) ``` aws ec2 get-ipam-resource-cidrs \ --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 \ --filters Name=management-state,Values=unmanaged ``` (Windows) ``` aws ec2 get-ipam-resource-cidrs ^ --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 ^ --filters Name=management-state,Values=unmanaged ``` Ausgabe: ``` { "IpamResourceCidrs": [ { "IpamId": "ipam-08440e7a3acde3908", "IpamScopeId": "ipam-scope-02fc38cd4c48e7d38", "ResourceRegion": "us-east-2", "ResourceOwnerId": "123456789012", "ResourceId": "vpc-621b8709", "ResourceName": "Default AWS VPC", "ResourceCidr": "172.33.0.0/16", "ResourceType": "vpc", "ResourceTags": [ { "Key": "Environment", "Value": "Test" }, { "Key": "Name", "Value": "Default AWS VPC" } ], "IpUsage": 0.0039, "ComplianceStatus": "unmanaged", "ManagementState": "unmanaged", "OverlapStatus": "nonoverlapping", "VpcId": "vpc-621b8709" } ] } ``` Weitere Informationen finden Sie unter [Überwachen der CIDR-Nutzung nach Ressource](https://docs.aws.amazon.com/vpc/latest/ipam/monitor-cidr-compliance-ipam.html) im *Benutzerhandbuch zu Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [GetIpamResourceCidrs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-ipam-resource-cidrs.html)in der *AWS CLI Befehlsreferenz*. ### `get-launch-template-data` Das folgende Codebeispiel zeigt die Verwendung`get-launch-template-data`. **AWS CLI** **So rufen Sie Instance-Daten für eine Startvorlage ab** In diesem Beispiel werden Daten über die angegebene Instance abgerufen und die `--query`-Option verwendet, um den Inhalt in `LaunchTemplateData` zurückzugeben. Sie können die Ausgabe als Basis zum Erstellen einer neuen Startvorlage oder einer neuen Version der Startvorlage verwenden. Befehl: ``` aws ec2 get-launch-template-data --instance-id i-0123d646e8048babc --query 'LaunchTemplateData' ``` Ausgabe: ``` { "Monitoring": {}, "ImageId": "ami-8c1be5f6", "BlockDeviceMappings": [ { "DeviceName": "/dev/xvda", "Ebs": { "DeleteOnTermination": true } } ], "EbsOptimized": false, "Placement": { "Tenancy": "default", "GroupName": "", "AvailabilityZone": "us-east-1a" }, "InstanceType": "t2.micro", "NetworkInterfaces": [ { "Description": "", "NetworkInterfaceId": "eni-35306abc", "PrivateIpAddresses": [ { "Primary": true, "PrivateIpAddress": "10.0.0.72" } ], "SubnetId": "subnet-7b16de0c", "Groups": [ "sg-7c227019" ], "Ipv6Addresses": [ { "Ipv6Address": "2001:db8:1234:1a00::123" } ], "PrivateIpAddress": "10.0.0.72" } ] } ``` + Einzelheiten zur API finden Sie [GetLaunchTemplateData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-launch-template-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-managed-prefix-list-associations` Das folgende Codebeispiel zeigt die Verwendung`get-managed-prefix-list-associations`. **AWS CLI** **So rufen Sie Präfixlistenzuordnungen ab** Im folgenden Beispiel für `get-managed-prefix-list-associations` werden die Ressourcen abgerufen, die der angegebenen Präfixliste zugeordnet sind. ``` aws ec2 get-managed-prefix-list-associations \ --prefix-list-id pl-0123456abcabcabc1 ``` Ausgabe: ``` { "PrefixListAssociations": [ { "ResourceId": "sg-0abc123456abc12345", "ResourceOwner": "123456789012" } ] } ``` Weitere Informationen finden Sie unter [Verwaltete Präfixlisten](https://docs.aws.amazon.com/vpc/latest/userguide/managed-prefix-lists.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [GetManagedPrefixListAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-managed-prefix-list-associations.html)in der *AWS CLI Befehlsreferenz*. ### `get-managed-prefix-list-entries` Das folgende Codebeispiel zeigt die Verwendung`get-managed-prefix-list-entries`. **AWS CLI** **So rufen Sie die Einträge für eine Präfixliste ab** Im folgenden Beispiel für `get-managed-prefix-list-entries` werden die Einträge für die angegebene Präfixliste abgerufen. ``` aws ec2 get-managed-prefix-list-entries \ --prefix-list-id pl-0123456abcabcabc1 ``` Ausgabe: ``` { "Entries": [ { "Cidr": "10.0.0.0/16", "Description": "vpc-a" }, { "Cidr": "10.2.0.0/16", "Description": "vpc-b" } ] } ``` Weitere Informationen finden Sie unter [Verwaltete Präfixlisten](https://docs.aws.amazon.com/vpc/latest/userguide/managed-prefix-lists.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [GetManagedPrefixListEntries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-managed-prefix-list-entries.html)in der *AWS CLI Befehlsreferenz*. ### `get-network-insights-access-scope-analysis-findings` Das folgende Codebeispiel zeigt die Verwendung`get-network-insights-access-scope-analysis-findings`. **AWS CLI** **So rufen Sie die Ergebnisse der Zugriffsbereichsanalyse von Network Insights ab** Im folgenden `get-network-insights-access-scope-analysis-findings` Beispiel werden die ausgewählten Ergebnisse der Umfangsanalyse in Ihrem AWS Konto abgerufen. ``` aws ec2 get-network-insights-access-scope-analysis-findings \ --region us-east-1 \ --network-insights-access-scope-analysis-id nis \ --nis-123456789111 ``` Ausgabe: ``` { "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789222", "AnalysisFindings": [ { "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789222", "NetworkInsightsAccessScopeId": "nis-123456789111", "FindingComponents": [ { "SequenceNumber": 1, "Component": { "Id": "eni-02e3d42d5cceca67d", "Arn": "arn:aws:ec2:us-east-1:936459623503:network-interface/eni-02e3d32d9cceca17d" }, "OutboundHeader": { "DestinationAddresses": [ "0.0.0.0/5", "11.0.0.0/8", "12.0.0.0/6", "128.0.0.0/3", "16.0.0.0/4", "160.0.0.0/5", "168.0.0.0/6", "172.0.0.0/12" "8.0.0.0/7" ], "DestinationPortRanges": [ { "From": 0, "To": 65535 } ], "Protocol": "6", "SourceAddresses": [ "10.0.2.253/32" ], "SourcePortRanges": [ { "From": 0, "To": 65535 } ] }, [etc] ] } } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Network Access Analyzer using the AWS CLI](https://docs.aws.amazon.com/vpc/latest/network-access-analyzer/getting-started-cli.html) im *Network Access Analyzer-Handbuch*. + Einzelheiten zur API finden Sie [GetNetworkInsightsAccessScopeAnalysisFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-network-insights-access-scope-analysis-findings.html)unter *AWS CLI Befehlsreferenz*. ### `get-network-insights-access-scope-content` Das folgende Codebeispiel zeigt die Verwendung`get-network-insights-access-scope-content`. **AWS CLI** **So rufen Sie den Inhalt des Network-Insights-Zugriffsbereichs ab** Im folgenden `get-network-insights-access-scope-content` Beispiel wird der Inhalt der ausgewählten Scopeanalyse-ID in Ihrem AWS Konto abgerufen. ``` aws ec2 get-network-insights-access-scope-content \ --region us-east-1 \ --network-insights-access-scope-id nis-123456789222 ``` Ausgabe: ``` { "NetworkInsightsAccessScopeContent": { "NetworkInsightsAccessScopeId": "nis-123456789222", "MatchPaths": [ { "Source": { "ResourceStatement": { "ResourceTypes": [ "AWS::EC2::NetworkInterface" ] } }, "Destination": { "ResourceStatement": { "ResourceTypes": [ "AWS::EC2::InternetGateway" ] } } } ] } } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Network Access Analyzer using the AWS CLI](https://docs.aws.amazon.com/vpc/latest/network-access-analyzer/getting-started-cli.html) im *Network Access Analyzer-Handbuch*. + Einzelheiten zur API finden Sie [GetNetworkInsightsAccessScopeContent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-network-insights-access-scope-content.html)unter *AWS CLI Befehlsreferenz*. ### `get-password-data` Das folgende Codebeispiel zeigt die Verwendung`get-password-data`. **AWS CLI** **So rufen Sie das verschlüsselte Passwort ab** In diesem Beispiel wird das verschlüsselte Passwort abgerufen. Befehl: ``` aws ec2 get-password-data --instance-id i-1234567890abcdef0 ``` Ausgabe: ``` { "InstanceId": "i-1234567890abcdef0", "Timestamp": "2013-08-07T22:18:38.000Z", "PasswordData": "gSlJFq+VpcZXqy+iktxMF6NyxQ4qCrT4+gaOuNOenX1MmgXPTj7XEXAMPLE UQ+YeFfb+L1U4C4AKv652Ux1iRB3CPTYP7WmU3TUnhsuBd+p6LVk7T2lKUml6OXbk6WPW1VYYm/TRPB1 e1DQ7PY4an/DgZT4mwcpRFigzhniQgDDeO1InvSDcwoUTwNs0Y1S8ouri2W4n5GNlriM3Q0AnNVelVz/ 53TkDtxbNoU606M1gK9zUWSxqEgwvbV2j8c5rP0WCuaMWSFl4ziDu4bd7q+4RSyi8NUsVWnKZ4aEZffu DPGzKrF5yLlf3etP2L4ZR6CvG7K1hx7VKOQVN32Dajw==" } ``` **So rufen Sie das entschlüsselte Passwort ab** In diesem Beispiel wird das entschlüsselte Passwort abgerufen. Befehl: ``` aws ec2 get-password-data --instance-id i-1234567890abcdef0 --priv-launch-key C:\Keys\MyKeyPair.pem ``` Ausgabe: ``` { "InstanceId": "i-1234567890abcdef0", "Timestamp": "2013-08-30T23:18:05.000Z", "PasswordData": "&ViJ652e*u" } ``` + Einzelheiten zur API finden Sie [GetPasswordData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-password-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-reserved-instances-exchange-quote` Das folgende Codebeispiel zeigt die Verwendung`get-reserved-instances-exchange-quote`. **AWS CLI** **So rufen Sie ein Angebot für den Austausch einer Convertible Reserved Instance ab** In diesem Beispiel werden die Informationen zum Austausch der angegebenen Convertible Reserved Instances abgerufen. Befehl: ``` aws ec2 get-reserved-instances-exchange-quote --reserved-instance-ids 7b8750c3-397e-4da4-bbcb-a45ebexample --target-configurations OfferingId=6fea5434-b379-434c-b07b-a7abexample ``` Ausgabe: ``` { "CurrencyCode": "USD", "ReservedInstanceValueSet": [ { "ReservedInstanceId": "7b8750c3-397e-4da4-bbcb-a45ebexample", "ReservationValue": { "RemainingUpfrontValue": "0.000000", "HourlyPrice": "0.027800", "RemainingTotalValue": "730.556200" } } ], "PaymentDue": "424.983828", "TargetConfigurationValueSet": [ { "TargetConfiguration": { "InstanceCount": 5, "OfferingId": "6fea5434-b379-434c-b07b-a7abexample" }, "ReservationValue": { "RemainingUpfrontValue": "424.983828", "HourlyPrice": "0.016000", "RemainingTotalValue": "845.447828" } } ], "IsValidExchange": true, "OutputReservedInstancesWillExpireAt": "2020-10-01T13:03:39Z", "ReservedInstanceValueRollup": { "RemainingUpfrontValue": "0.000000", "HourlyPrice": "0.027800", "RemainingTotalValue": "730.556200" }, "TargetConfigurationValueRollup": { "RemainingUpfrontValue": "424.983828", "HourlyPrice": "0.016000", "RemainingTotalValue": "845.447828" } } ``` + Einzelheiten zur API finden Sie [GetReservedInstancesExchangeQuote](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-reserved-instances-exchange-quote.html)in der *AWS CLI Befehlsreferenz*. ### `get-security-groups-for-vpc` Das folgende Codebeispiel zeigt die Verwendung`get-security-groups-for-vpc`. **AWS CLI** **So zeigen Sie Sicherheitsgruppen an, die Netzwerkschnittstellen in einer bestimmten VPC zugeordnet werden können.** Das folgende Beispiel für `get-security-groups-for-vpc` zeigt die Sicherheitsgruppen an, die Netzwerkschnittstellen in der VPC zugeordnet werden können. ``` aws ec2 get-security-groups-for-vpc \ --vpc-id vpc-6c31a611 \ --region us-east-1 ``` Ausgabe: ``` { "SecurityGroupForVpcs": [ { "Description": "launch-wizard-36 created 2022-08-29T15:59:35.338Z", "GroupName": "launch-wizard-36", "OwnerId": "470889052923", "GroupId": "sg-007e0c3027ee885f5", "Tags": [], "PrimaryVpcId": "vpc-6c31a611" }, { "Description": "launch-wizard-18 created 2024-01-19T20:22:27.527Z", "GroupName": "launch-wizard-18", "OwnerId": "470889052923", "GroupId": "sg-0147193bef51c9eef", "Tags": [], "PrimaryVpcId": "vpc-6c31a611" } } ``` + Einzelheiten zur API finden Sie [GetSecurityGroupsForVpc](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-security-groups-for-vpc.html)in der *AWS CLI Befehlsreferenz*. ### `get-serial-console-access-status` Das folgende Codebeispiel zeigt die Verwendung`get-serial-console-access-status`. **AWS CLI** **So zeigen Sie den Kontozugriffsstatus für die serielle Konsole an** Im folgenden Beispiel für `get-serial-console-access-status` wird ermittelt, ob der serielle Konsolenzugriff für Ihr Konto aktiviert ist. ``` aws ec2 get-serial-console-access-status ``` Ausgabe: ``` { "SerialConsoleAccessEnabled": true } ``` Weitere Informationen finden Sie unter [Serielle EC2-Konsole](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-serial-console.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [GetSerialConsoleAccessStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-serial-console-access-status.html)in der *AWS CLI Befehlsreferenz*. ### `get-snapshot-block-public-access-state` Das folgende Codebeispiel zeigt die Verwendung`get-snapshot-block-public-access-state`. **AWS CLI** **So rufen Sie den aktuellen Status von „öffentlichen Zugriff blockieren“ für Snapshots ab** Im folgenden Beispiel für `get-snapshot-block-public-access-state` wird der aktuelle Status „öffentlichen Zugriff blockieren“ für Snapshots abgerufen. ``` aws ec2 get-snapshot-block-public-access-state ``` Ausgabe: ``` { "State": "block-all-sharing" } ``` Weitere Informationen finden Sie unter [Blockieren des öffentlichen Zugriffs für Snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/block-public-access-snapshots.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [GetSnapshotBlockPublicAccessState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-snapshot-block-public-access-state.html)in der *AWS CLI Befehlsreferenz*. ### `get-spot-placement-scores` Das folgende Codebeispiel zeigt die Verwendung`get-spot-placement-scores`. **AWS CLI** **So berechnen Sie eine Spot-Platzierungsbewertung für bestimmte Anforderungen** Im folgenden Beispiel für `get-spot-placement-scores` wird zunächst eine Liste aller möglichen Parameter generiert, die mithilfe des Parameters `--generate-cli-skeleton` zur Konfiguration der Spot-Platzierungsbewertung angegeben werden können. Die Liste wird dann in einer JSON-Datei gespeichert. Anschließend wird die JSON-Datei verwendet, um die Anforderungen für die Berechnung der Spot-Platzierungsbewertung zu konfigurieren. So generieren Sie alle möglichen Parameter, die für die Konfiguration der Spot-Platzierungsbewertung angegeben werden können, und speichern die Ausgabe direkt in einer JSON-Datei ``` aws ec2 get-spot-placement-scores \ --region us-east-1 \ --generate-cli-skeleton input > attributes.json ``` Ausgabe: ``` { "InstanceTypes": [ "" ], "TargetCapacity": 0, "TargetCapacityUnitType": "vcpu", "SingleAvailabilityZone": true, "RegionNames": [ "" ], "InstanceRequirementsWithMetadata": { "ArchitectureTypes": [ "x86_64_mac" ], "VirtualizationTypes": [ "hvm" ], "InstanceRequirements": { "VCpuCount": { "Min": 0, "Max": 0 }, "MemoryMiB": { "Min": 0, "Max": 0 }, "CpuManufacturers": [ "amd" ], "MemoryGiBPerVCpu": { "Min": 0.0, "Max": 0.0 }, "ExcludedInstanceTypes": [ "" ], "InstanceGenerations": [ "previous" ], "SpotMaxPricePercentageOverLowestPrice": 0, "OnDemandMaxPricePercentageOverLowestPrice": 0, "BareMetal": "excluded", "BurstablePerformance": "excluded", "RequireHibernateSupport": true, "NetworkInterfaceCount": { "Min": 0, "Max": 0 }, "LocalStorage": "included", "LocalStorageTypes": [ "hdd" ], "TotalLocalStorageGB": { "Min": 0.0, "Max": 0.0 }, "BaselineEbsBandwidthMbps": { "Min": 0, "Max": 0 }, "AcceleratorTypes": [ "fpga" ], "AcceleratorCount": { "Min": 0, "Max": 0 }, "AcceleratorManufacturers": [ "amd" ], "AcceleratorNames": [ "vu9p" ], "AcceleratorTotalMemoryMiB": { "Min": 0, "Max": 0 } } }, "DryRun": true, "MaxResults": 0, "NextToken": "" } ``` Konfigurieren Sie die JSON-Datei. Sie müssen einen Wert für `TargetCapacity` angeben. Eine Beschreibung der einzelnen Parameter und ihrer Standardwerte finden Sie unter Calculate the Spot Placement Score (AWS CLI) . Berechnen Sie die Spot-Platzierungsbewertung für die in `attributes.json` angegebenen Anforderungen. Geben Sie mithilfe des Parameters `--cli-input-json` den Namen und den Pfad zu Ihrer JSON-Datei an. ``` aws ec2 get-spot-placement-scores \ --region us-east-1 \ --cli-input-json file://attributes.json ``` Die Ausgabe erfolgt, wenn `SingleAvailabilityZone` auf `false` festgelegt oder weggelassen wird (beim Weglassen wird der Standardwert `false` verwendet). Es wird eine Liste mit bewerteten Regionen zurückgegeben. ``` "Recommendation": [ { "Region": "us-east-1", "Score": 7 }, { "Region": "us-west-1", "Score": 5 }, ... ``` Die Ausgabe erfolgt, wenn `SingleAvailabilityZone` auf `true` festgelegt ist. Es SingleAvailability wird eine Liste von Zonen mit Punktzahlen zurückgegeben. ``` "Recommendation": [ { "Region": "us-east-1", "AvailabilityZoneId": "use1-az1" "Score": 8 }, { "Region": "us-east-1", "AvailabilityZoneId": "usw2-az3" "Score": 6 }, ... ``` Weitere Informationen zur Berechnung einer Spot-Platzierungsbewertung und Beispielkonfigurationen finden Sie unter [Berechnen einer Spot-Platzierungsbewertung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-placement-score.html#work-with-spot-placement-score) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [GetSpotPlacementScores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-spot-placement-scores.html)in der *AWS CLI Befehlsreferenz*. ### `get-subnet-cidr-reservations` Das folgende Codebeispiel zeigt die Verwendung`get-subnet-cidr-reservations`. **AWS CLI** **So rufen Sie Informationen über eine Subnetz-CIDR-Reservierung ab** Im folgenden Beispiel für `get-subnet-cidr-reservations` werden Informationen zur angegebenen Subnetz-CIDR-Reservierung angezeigt. ``` aws ec2 get-subnet-cidr-reservations \ --subnet-id subnet-03c51e2e6cEXAMPLE ``` Ausgabe: ``` { "SubnetIpv4CidrReservations": [ { "SubnetCidrReservationId": "scr-044f977c4eEXAMPLE", "SubnetId": "subnet-03c51e2e6cEXAMPLE", "Cidr": "10.1.0.16/28", "ReservationType": "prefix", "OwnerId": "123456789012" } ], "SubnetIpv6CidrReservations": [] } ``` Weitere Informationen erhalten Sie unter [Subnetz-CIDR-Reservierungen](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-cidr-reservation.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [GetSubnetCidrReservations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-subnet-cidr-reservations.html)in der *AWS CLI Befehlsreferenz*. ### `get-transit-gateway-attachment-propagations` Das folgende Codebeispiel zeigt die Verwendung`get-transit-gateway-attachment-propagations`. **AWS CLI** **So listen Sie die Routing-Tabellen auf, in die der angegebene Ressourcenanhang Routen verbreitet** Im folgenden Beispiel für `get-transit-gateway-attachment-propagations` wird die Routing-Tabelle aufgelistet, in die der angegebene Ressourcenanhang Routen verbreitet. ``` aws ec2 get-transit-gateway-attachment-propagations \ --transit-gateway-attachment-id tgw-attach-09fbd47ddfEXAMPLE ``` Ausgabe: ``` { "TransitGatewayAttachmentPropagations": [ { "TransitGatewayRouteTableId": "tgw-rtb-0882c61b97EXAMPLE", "State": "enabled" } ] } ``` Weitere Informationen finden Sie unter [Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [GetTransitGatewayAttachmentPropagations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-transit-gateway-attachment-propagations.html)in der *AWS CLI Befehlsreferenz*. ### `get-transit-gateway-multicast-domain-associations` Das folgende Codebeispiel zeigt die Verwendung`get-transit-gateway-multicast-domain-associations`. **AWS CLI** **So zeigen Sie die Informationen zu den Multicast-Domain-Zuordnungen in Transit Gateway an** Im folgenden Beispiel für `get-transit-gateway-multicast-domain-associations` werden die Zuordnungen für die angegebene Multicast-Domain zurückgegeben. ``` aws ec2 get-transit-gateway-multicast-domain-associations \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE ``` Ausgabe: ``` { "MulticastDomainAssociations": [ { "TransitGatewayAttachmentId": "tgw-attach-028c1dd0f8EXAMPLE", "ResourceId": "vpc-01128d2c24EXAMPLE", "ResourceType": "vpc", "Subnet": { "SubnetId": "subnet-000de86e3bEXAMPLE", "State": "associated" } }, { "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE", "ResourceId": "vpc-7EXAMPLE", "ResourceType": "vpc", "Subnet": { "SubnetId": "subnet-4EXAMPLE", "State": "associated" } }, { "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE", "ResourceId": "vpc-7EXAMPLE", "ResourceType": "vpc", "Subnet": { "SubnetId": "subnet-5EXAMPLE", "State": "associated" } }, { "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE", "ResourceId": "vpc-7EXAMPLE", "ResourceType": "vpc", "Subnet": { "SubnetId": "subnet-aEXAMPLE", "State": "associated" } }, { "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE", "ResourceId": "vpc-7EXAMPLE", "ResourceType": "vpc", "Subnet": { "SubnetId": "subnet-fEXAMPLE", "State": "associated" } } ] } ``` Weitere Informationen finden Sie unter [Multicast-Domains](https://docs.aws.amazon.com/vpc/latest/tgw/multicast-domains-about.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [GetTransitGatewayMulticastDomainAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-transit-gateway-multicast-domain-associations.html)in der *AWS CLI Befehlsreferenz*. ### `get-transit-gateway-prefix-list-references` Das folgende Codebeispiel zeigt die Verwendung`get-transit-gateway-prefix-list-references`. **AWS CLI** **So rufen Sie Präfixlistenreferenzen einer Routing-Tabelle in Transit Gateway ab** Im folgenden Beispiel für `get-transit-gateway-prefix-list-references` werden die Präfixlistenreferenzen für die angegebene Routing-Tabelle in Transit Gateway abgerufen und nach der ID einer bestimmten Präfixliste gefiltert. ``` aws ec2 get-transit-gateway-prefix-list-references \ --transit-gateway-route-table-id tgw-rtb-0123456789abcd123 \ --filters Name=prefix-list-id,Values=pl-11111122222222333 ``` Ausgabe: ``` { "TransitGatewayPrefixListReferences": [ { "TransitGatewayRouteTableId": "tgw-rtb-0123456789abcd123", "PrefixListId": "pl-11111122222222333", "PrefixListOwnerId": "123456789012", "State": "available", "Blackhole": false, "TransitGatewayAttachment": { "TransitGatewayAttachmentId": "tgw-attach-aabbccddaabbccaab", "ResourceType": "vpc", "ResourceId": "vpc-112233445566aabbc" } } ] } ``` Weitere Informationen finden Sie unter [Präfixlistenreferenzen](https://docs.aws.amazon.com/vpc/latest/tgw/create-prefix-list-reference.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [GetTransitGatewayPrefixListReferences](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-transit-gateway-prefix-list-references.html)in der *AWS CLI Befehlsreferenz*. ### `get-transit-gateway-route-table-associations` Das folgende Codebeispiel zeigt die Verwendung`get-transit-gateway-route-table-associations`. **AWS CLI** **So rufen Sie Informationen über die Zuordnungen der angegebenen Routing-Tabelle für Transit-Gateways ab** Im folgenden Beispiel für `get-transit-gateway-route-table-associations` werden Informationen über die Zuordnungen der angegebenen Routing-Tabelle des Transit-Gateways angezeigt. ``` aws ec2 get-transit-gateway-route-table-associations \ --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE ``` Ausgabe: ``` { "Associations": [ { "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE", "ResourceId": "vpc-4d7de228", "ResourceType": "vpc", "State": "associating" } ] } ``` Weitere Informationen finden Sie unter [Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html#associate-tgw-route-table) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [GetTransitGatewayRouteTableAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-transit-gateway-route-table-associations.html)in der *AWS CLI Befehlsreferenz*. ### `get-transit-gateway-route-table-propagations` Das folgende Codebeispiel zeigt die Verwendung`get-transit-gateway-route-table-propagations`. **AWS CLI** **So zeigen Sie Informationen über die Routing-Tabellen-Propagierungen für die angegebene Routing-Tabelle für Transit-Gateways an** Im folgenden Beispiel für `get-transit-gateway-route-table-propagations` werden die Routing-Tabellen-Propagierungen für die angegebene Routing-Tabelle zurückgegeben. ``` aws ec2 get-transit-gateway-route-table-propagations \ --transit-gateway-route-table-id tgw-rtb-002573ed1eEXAMPLE ``` Ausgabe: ``` { "TransitGatewayRouteTablePropagations": [ { "TransitGatewayAttachmentId": "tgw-attach-01f8100bc7EXAMPLE", "ResourceId": "vpc-3EXAMPLE", "ResourceType": "vpc", "State": "enabled" }, { "TransitGatewayAttachmentId": "tgw-attach-08e0bc912cEXAMPLE", "ResourceId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE", "ResourceType": "direct-connect-gateway", "State": "enabled" }, { "TransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE", "ResourceId": "8384da05-13ce-4a91-aada-5a1baEXAMPLE", "ResourceType": "direct-connect-gateway", "State": "enabled" } ] } ``` Weitere Informationen finden Sie unter [Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [GetTransitGatewayRouteTablePropagations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-transit-gateway-route-table-propagations.html)in der *AWS CLI Befehlsreferenz*. ### `get-verified-access-endpoint-policy` Das folgende Codebeispiel zeigt die Verwendung`get-verified-access-endpoint-policy`. **AWS CLI** **So rufen Sie die verifizierte Zugriffsrichtlinie eines Endpunkts ab** Im folgenden Beispiel für `get-verified-access-endpoint-policy` wird die verifizierte Zugriffsrichtlinie des angegebenen Endpunkts abgerufen. ``` aws ec2 get-verified-access-endpoint-policy \ --verified-access-endpoint-id vae-066fac616d4d546f2 ``` Ausgabe: ``` { "PolicyEnabled": true, "PolicyDocument": "permit(principal,action,resource)\nwhen {\n context.identity.groups.contains(\"finance\") &&\n context.identity.email_verified == true\n};" } ``` Weitere Informationen finden Sie unter [Verified-Access-Richtlinien](https://docs.aws.amazon.com/verified-access/latest/ug/auth-policies.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [GetVerifiedAccessEndpointPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-verified-access-endpoint-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-verified-access-group-policy` Das folgende Codebeispiel zeigt die Verwendung`get-verified-access-group-policy`. **AWS CLI** **So rufen Sie die verifizierte Zugriffsrichtlinie einer Gruppe ab** Im folgenden Beispiel für `get-verified-access-group-policy` wird die verifizierte Zugriffsrichtlinie der angegebenen Gruppe abgerufen. ``` aws ec2 get-verified-access-group-policy \ --verified-access-group-id vagr-0dbe967baf14b7235 ``` Ausgabe: ``` { "PolicyEnabled": true, "PolicyDocument": "permit(principal,action,resource)\nwhen {\n context.identity.groups.contains(\"finance\") &&\n context.identity.email_verified == true\n};" } ``` Weitere Informationen finden Sie unter [Verified-Access-Gruppen](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-groups.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [GetVerifiedAccessGroupPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-verified-access-group-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-vpn-connection-device-sample-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-vpn-connection-device-sample-configuration`. **AWS CLI** **So laden Sie eine Beispielkonfigurationsdatei herunter** Im folgenden Beispiel für `get-vpn-connection-device-sample-configuration` wird die angegebene Beispielkonfigurationsdatei heruntergeladen. Rufen Sie den Befehl `get-vpn-connection-device-types` auf, um die Gateway-Geräte mit einer Beispielkonfigurationsdatei aufzulisten. ``` aws ec2 get-vpn-connection-device-sample-configuration \ --vpn-connection-id vpn-123456789abc01234 \ --vpn-connection-device-type-id 5fb390ba ``` Ausgabe: ``` { "VpnConnectionDeviceSampleConfiguration": "contents-of-the-sample-configuration-file" } ``` Weitere Informationen finden [Sie unter Herunterladen der Konfigurationsdatei](https://docs.aws.amazon.com/vpn/latest/s2svpn/SetUpVPNConnections.html#vpn-download-config) im *AWS Site-to-Site VPN-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetVpnConnectionDeviceSampleConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-vpn-connection-device-sample-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-vpn-connection-device-types` Das folgende Codebeispiel zeigt die Verwendung`get-vpn-connection-device-types`. **AWS CLI** **So listen Sie Gateway-Geräte mit einer Beispielkonfigurationsdatei auf** Im folgenden Beispiel für `get-vpn-connection-device-types` werden die Gateway-Geräte von Palo Alto Networks aufgelistet, die über Beispielkonfigurationsdateien verfügen. ``` aws ec2 get-vpn-connection-device-types \ --query "VpnConnectionDeviceTypes[?Vendor==`Palo Alto Networks`]" ``` Ausgabe: ``` [ { "VpnConnectionDeviceTypeId": "754a6372", "Vendor": "Palo Alto Networks", "Platform": "PA Series", "Software": "PANOS 4.1.2+" }, { "VpnConnectionDeviceTypeId": "9612cbed", "Vendor": "Palo Alto Networks", "Platform": "PA Series", "Software": "PANOS 4.1.2+ (GUI)" }, { "VpnConnectionDeviceTypeId": "5fb390ba", "Vendor": "Palo Alto Networks", "Platform": "PA Series", "Software": "PANOS 7.0+" } ] ``` Weitere Informationen finden [Sie unter Herunterladen der Konfigurationsdatei](https://docs.aws.amazon.com/vpn/latest/s2svpn/SetUpVPNConnections.html#vpn-download-config) im *AWS Site-to-Site VPN-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetVpnConnectionDeviceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-vpn-connection-device-types.html)in der *AWS CLI Befehlsreferenz*. ### `import-client-vpn-client-certificate-revocation-list` Das folgende Codebeispiel zeigt die Verwendung`import-client-vpn-client-certificate-revocation-list`. **AWS CLI** **So importieren Sie eine Client-Zertifikatsperrliste** Im folgenden Beispiel für `import-client-vpn-client-certificate-revocation-list` wird eine Sperrliste für Client-Zertifikate in den Client-VPN-Endpunkt importiert, indem der Speicherort der Datei auf dem lokalen Computer angegeben wird. ``` aws ec2 import-client-vpn-client-certificate-revocation-list \ --certificate-revocation-list file:///path/to/crl.pem \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Client-Zertifikatsperrlisten](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-certificates.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [ImportClientVpnClientCertificateRevocationList](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/import-client-vpn-client-certificate-revocation-list.html)in der *AWS CLI Befehlsreferenz*. ### `import-image` Das folgende Codebeispiel zeigt die Verwendung`import-image`. **AWS CLI** **So importieren Sie eine VM-Image-Datei als AMI** Im folgenden Beispiel für `import-image` wird das angegebene OVA importiert. ``` aws ec2 import-image \ --disk-containers Format=ova,UserBucket="{S3Bucket=my-import-bucket,S3Key=vms/my-server-vm.ova}" ``` Ausgabe: ``` { "ImportTaskId": "import-ami-1234567890abcdef0", "Progress": "2", "SnapshotDetails": [ { "DiskImageSize": 0.0, "Format": "ova", "UserBucket": { "S3Bucket": "my-import-bucket", "S3Key": "vms/my-server-vm.ova" } } ], "Status": "active", "StatusMessage": "pending" } ``` + Einzelheiten zur API finden Sie [ImportImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/import-image.html)in der *AWS CLI Befehlsreferenz*. ### `import-key-pair` Das folgende Codebeispiel zeigt die Verwendung`import-key-pair`. **AWS CLI** **So importieren Sie einen öffentlichen Schlüssel** Generieren Sie zunächst ein Schlüsselpaar mit einem Tool Ihrer Wahl. Verwenden Sie beispielsweise den folgenden ssh-keygen-Befehl: Befehl: ``` ssh-keygen -t rsa -C "my-key" -f ~/.ssh/my-key ``` Ausgabe: ``` Generating public/private rsa key pair. Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /home/ec2-user/.ssh/my-key. Your public key has been saved in /home/ec2-user/.ssh/my-key.pub. ... ``` Dieser Beispielbefehl importiert den angegebenen öffentlichen Schlüssel. Befehl: ``` aws ec2 import-key-pair --key-name "my-key" --public-key-material fileb://~/.ssh/my-key.pub ``` Ausgabe: ``` { "KeyName": "my-key", "KeyFingerprint": "1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca" } ``` + Einzelheiten zur API finden Sie [ImportKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/import-key-pair.html)in der *AWS CLI Befehlsreferenz*. ### `import-snapshot` Das folgende Codebeispiel zeigt die Verwendung`import-snapshot`. **AWS CLI** **So importieren Sie einen Snapshot** Im folgenden Beispiel für `import-snapshot` wird der angegebene Datenträger als Snapshot importiert. ``` aws ec2 import-snapshot \ --description "My server VMDK" \ --disk-container Format=VMDK,UserBucket={'S3Bucket=my-import-bucket,S3Key=vms/my-server-vm.vmdk'} ``` Ausgabe: ``` { "Description": "My server VMDK", "ImportTaskId": "import-snap-1234567890abcdef0", "SnapshotTaskDetail": { "Description": "My server VMDK", "DiskImageSize": "0.0", "Format": "VMDK", "Progress": "3", "Status": "active", "StatusMessage": "pending" "UserBucket": { "S3Bucket": "my-import-bucket", "S3Key": "vms/my-server-vm.vmdk" } } } ``` + Einzelheiten zur API finden Sie [ImportSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/import-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `list-images-in-recycle-bin` Das folgende Codebeispiel zeigt die Verwendung`list-images-in-recycle-bin`. **AWS CLI** **So listen Sie die Images im Papierkorb auf** Im folgenden Beispiel für `list-images-in-recycle-bin` werden alle Images aufgelistet, die sich derzeit im Papierkorb befinden. ``` aws ec2 list-images-in-recycle-bin ``` Ausgabe: ``` { "Images": [ { "RecycleBinEnterTime": "2022-03-14T15:35:08.000Z", "Description": "Monthly AMI One", "RecycleBinExitTime": "2022-03-15T15:35:08.000Z", "Name": "AMI_01", "ImageId": "ami-0111222333444abcd" } ] } ``` Weitere Informationen finden Sie unter [ AMIs Aus dem Papierkorb gelöschte Dateien wiederherstellen](https://docs.aws.amazon.com/ebs/latest/userguide/recycle-bin-working-with-amis.html) im *Amazon EBS-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListImagesInRecycleBin AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/list-images-in-recycle-bin.html)*Befehlsreferenz*. ### `list-snapshots-in-recycle-bin` Das folgende Codebeispiel zeigt die Verwendung`list-snapshots-in-recycle-bin`. **AWS CLI** **So zeigen Sie Snapshots im Papierkorb an** Im folgenden Beispiel für `list-snapshots-in-recycle-bin` werden Informationen zu Snapshots im Papierkorb aufgeführt, darunter die Snapshot-ID, eine Beschreibung des Snapshots, die ID des Volumes, von dem der Snapshot erstellt wurde, das Datum und die Uhrzeit, an dem der Snapshot gelöscht und in den Papierkorb verschoben wurde, sowie Datum und Uhrzeit, zu dem die Aufbewahrungsfrist abläuft. ``` aws ec2 list-snapshots-in-recycle-bin \ --snapshot-id snap-01234567890abcdef ``` Ausgabe: ``` { "SnapshotRecycleBinInfo": [ { "Description": "Monthly data backup snapshot", "RecycleBinEnterTime": "2022-12-01T13:00:00.000Z", "RecycleBinExitTime": "2022-12-15T13:00:00.000Z", "VolumeId": "vol-abcdef09876543210", "SnapshotId": "snap-01234567890abcdef" } ] } ``` Weitere Informationen zum Papierkorb finden Sie unter [Wiederherstellen gelöschter Snapshots aus dem Papierkorb](https://docs.aws.amazon.com/ebs/latest/userguide/recycle-bin-working-with-snaps.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [ListSnapshotsInRecycleBin](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/list-snapshots-in-recycle-bin.html)in der *AWS CLI Befehlsreferenz*. ### `lock-snapshot` Das folgende Codebeispiel zeigt die Verwendung`lock-snapshot`. **AWS CLI** **Beispiel 1: So sperren Sie einen Snapshot im Governance-Modus** Im folgenden Beispiel für `lock-snapshot` wird der angegebene Snapshot im Governance-Modus gesperrt. ``` aws ec2 lock-snapshot \ --snapshot-id snap-0b5e733b4a8df6e0d \ --lock-mode governance \ --lock-duration 365 ``` Ausgabe: ``` { "SnapshotId": "snap-0b5e733b4a8df6e0d", "LockState": "governance", "LockDuration": 365, "LockCreatedOn": "2024-05-05T00:56:06.208000+00:00", "LockExpiresOn": "2025-05-05T00:56:06.208000+00:00", "LockDurationStartTime": "2024-05-05T00:56:06.208000+00:00" } ``` Weitere Informationen finden Sie unter [Snapshot Lock](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-snapshot-lock.html) im *Benutzerhandbuch für Amazon EBS*. **Beispiel 2: So sperren Sie einen Snapshot im Compliance-Modus** Im folgenden Beispiel für `lock-snapshot` wird der angegebene Snapshot im Compliance-Modus gesperrt. ``` aws ec2 lock-snapshot \ --snapshot-id snap-0163a8524c5b9901f \ --lock-mode compliance \ --cool-off-period 24 \ --lock-duration 365 ``` Ausgabe: ``` { "SnapshotId": "snap-0b5e733b4a8df6e0d", "LockState": "compliance-cooloff", "LockDuration": 365, "CoolOffPeriod": 24, "CoolOffPeriodExpiresOn": "2024-05-06T01:02:20.527000+00:00", "LockCreatedOn": "2024-05-05T01:02:20.527000+00:00", "LockExpiresOn": "2025-05-05T01:02:20.527000+00:00", "LockDurationStartTime": "2024-05-05T01:02:20.527000+00:00" } ``` Weitere Informationen finden Sie unter [Snapshot Lock](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-snapshot-lock.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [LockSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/lock-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `modify-address-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-address-attribute`. **AWS CLI** **So ändern Sie das mit einer Elastic-IP-Adresse verknüpfte Domainnamenattribut** In den folgenden Beispielen für `modify-address-attribute` wird das Domainnamenattribut einer Elastic-IP-Adresse geändert. Linux: ``` aws ec2 modify-address-attribute \ --allocation-id eipalloc-abcdef01234567890 \ --domain-name example.com ``` Windows: ``` aws ec2 modify-address-attribute ^ --allocation-id eipalloc-abcdef01234567890 ^ --domain-name example.com ``` Ausgabe: ``` { "Addresses": [ { "PublicIp": "192.0.2.0", "AllocationId": "eipalloc-abcdef01234567890", "PtrRecord": "example.net." "PtrRecordUpdate": { "Value": "example.com.", "Status": "PENDING" } ] } ``` Informationen zur Überwachung der ausstehenden Änderung und zum Anzeigen der geänderten Attribute einer elastischen IP-Adresse finden Sie [describe-addresses-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-addresses-attribute.html)in der *AWS CLI-Befehlsreferenz*. + Einzelheiten zur API finden Sie [ModifyAddressAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-address-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `modify-availability-zone-group` Das folgende Codebeispiel zeigt die Verwendung`modify-availability-zone-group`. **AWS CLI** **So aktivieren Sie eine Zonengruppe** Im folgenden Beispiel für `modify-availability-zone-group` wird die angegebene Zonengruppe aktiviert. ``` aws ec2 modify-availability-zone-group \ --group-name us-west-2-lax-1 \ --opt-in-status opted-in ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Regionen und Zonen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) im *Amazon-EC2-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ModifyAvailabilityZoneGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-availability-zone-group.html)in der *AWS CLI Befehlsreferenz*. ### `modify-capacity-reservation-fleet` Das folgende Codebeispiel zeigt die Verwendung`modify-capacity-reservation-fleet`. **AWS CLI** **Beispiel 1: So ändern Sie die Gesamtzielkapazität einer Flotte für Kapazitätsreservierungen** Im folgenden Beispiel für `modify-capacity-reservation-fleet` wird die Gesamtzielkapazität der angegebenen Flotte für Kapazitätsreservierungen geändert. Wenn Sie die Gesamtzielkapazität einer Kapazitätsreservierungsflotte ändern, erstellt die Flotte automatisch neue Kapazitätsreservierungen oder ändert bzw. storniert bestehende Kapazitätsreservierungen in der Flotte, um die neue Gesamtzielkapazität zu erreichen. Sie können keine zusätzlichen Änderungen an einer Flotte vornehmen, wenn sie sich im Zustand `modifying` befindet. ``` aws ec2 modify-capacity-reservation-fleet \ --capacity-reservation-fleet-id crf-01234567890abcedf \ --total-target-capacity 160 ``` Ausgabe: ``` { "Return": true } ``` **Beispiel 2: So ändern Sie das Enddatum einer Flotte für Kapazitätsreservierungen** Im folgenden Beispiel für `modify-capacity-reservation-fleet` wird das Enddatum der angegebenen Flotte für Kapazitätsreservierungen geändert. Wenn Sie das Enddatum für die Flotte ändern, werden die Enddaten für alle einzelnen Kapazitätsreservierungen entsprechend angepasst. Sie können keine zusätzlichen Änderungen an einer Flotte vornehmen, wenn sie sich im Zustand `modifying` befindet. ``` aws ec2 modify-capacity-reservation-fleet \ --capacity-reservation-fleet-id crf-01234567890abcedf \ --end-date 2022-07-04T23:59:59.000Z ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen zu Kapazitätsreservierungsflotten finden Sie unter [Kapazitätsreservierungsflotten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cr-fleets.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyCapacityReservationFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-capacity-reservation-fleet.html)in der *AWS CLI Befehlsreferenz*. ### `modify-capacity-reservation` Das folgende Codebeispiel zeigt die Verwendung`modify-capacity-reservation`. **AWS CLI** **Beispiel 1: So ändern Sie die Anzahl der Instances, die durch eine bestehende Kapazitätsreservierung reserviert wurden** Im folgenden Beispiel für `modify-capacity-reservation` wird die Anzahl der Instances geändert, für die die Kapazitätsreservierung Kapazität reserviert. ``` aws ec2 modify-capacity-reservation \ --capacity-reservation-id cr-1234abcd56EXAMPLE \ --instance-count 5 ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Ändern einer Kapazitätsreservierung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-modify.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So ändern Sie das Enddatum und die Endzeit für eine bestehende Kapazitätsreservierung** Im folgenden Beispiel für `modify-capacity-reservation` wird eine bestehende Kapazitätsreservierung so geändert, dass sie am angegebenen Datum und zur angegebenen Uhrzeit endet. ``` aws ec2 modify-capacity-reservation \ --capacity-reservation-id cr-1234abcd56EXAMPLE \ --end-date-type limited \ --end-date 2019-08-31T23:59:59Z ``` Weitere Informationen finden Sie unter [Ändern einer Kapazitätsreservierung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-modify.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyCapacityReservation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-capacity-reservation.html)in der *AWS CLI Befehlsreferenz*. ### `modify-client-vpn-endpoint` Das folgende Codebeispiel zeigt die Verwendung`modify-client-vpn-endpoint`. **AWS CLI** **So ändern Sie einen Client-VPN-Endpunkt** Im folgenden Beispiel für `modify-client-vpn-endpoint` wird die Clientverbindungsprotokollierung für den angegebenen Client-VPN-Endpunkt aktiviert. ``` aws ec2 modify-client-vpn-endpoint \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \ --connection-log-options Enabled=true,CloudwatchLogGroup=ClientVPNLogs ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Client-VPN-Endpunkte](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-endpoints.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [ModifyClientVpnEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-client-vpn-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `modify-default-credit-specification` Das folgende Codebeispiel zeigt die Verwendung`modify-default-credit-specification`. **AWS CLI** **So ändern Sie die Standard-Guthabenoption** Im folgenden Beispiel für `modify-default-credit-specification` wird die Standard-Guthabenoption für T2-Instances geändert. ``` aws ec2 modify-default-credit-specification \ --instance-family t2 \ --cpu-credits unlimited ``` Ausgabe: ``` { "InstanceFamilyCreditSpecification": { "InstanceFamily": "t2", "CpuCredits": "unlimited" } } ``` + Einzelheiten zur API finden Sie [ModifyDefaultCreditSpecification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-default-credit-specification.html)in der *AWS CLI Befehlsreferenz*. ### `modify-ebs-default-kms-key-id` Das folgende Codebeispiel zeigt die Verwendung`modify-ebs-default-kms-key-id`. **AWS CLI** **So legen Sie Ihren Standard-CMK für die EBS-Verschlüsselung fest** Im folgenden `modify-ebs-default-kms-key-id` Beispiel wird der angegebene CMK als Standard-CMK für die EBS-Verschlüsselung für Ihr AWS Konto in der aktuellen Region festgelegt. ``` aws ec2 modify-ebs-default-kms-key-id \ --kms-key-id alias/my-cmk ``` Ausgabe: ``` { "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE" } ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz [ModifyEbsDefaultKmsKeyId](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-ebs-default-kms-key-id.html).AWS CLI * ### `modify-fleet` Das folgende Codebeispiel zeigt die Verwendung`modify-fleet`. **AWS CLI** **So skalieren Sie eine EC2-Flotte** Im folgenden Beispiel für `modify-fleet` wird die Zielkapazität der angegebenen EC2-Flotte geändert. Wenn der angegebene Wert die aktuelle Kapazität übersteigt, startet die EC2-Flotte zusätzliche Instances. Wenn der angegebene Wert unter der aktuellen Kapazität liegt, bricht die EC2-Flotte alle offenen Anfragen ab. Wenn die Beendigungsrichtlinie `terminate` lautet, beendet die EC2-Flotte alle Instances, die die neue Zielkapazität überschreiten. ``` aws ec2 modify-fleet \ --fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \ --target-capacity-specification TotalTargetCapacity=5 ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Verwalten einer EC2-Flotte](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-ec2-fleet.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-fleet.html)in der *AWS CLI Befehlsreferenz*. ### `modify-fpga-image-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-fpga-image-attribute`. **AWS CLI** **So ändern Sie die Attribute eines Amazon FPGA Image** In diesem Beispiel werden Ladeberechtigungen für die Konto-ID `123456789012` des angegebenen AFI hinzugefügt. Befehl: ``` aws ec2 modify-fpga-image-attribute --attribute loadPermission --fpga-image-id afi-0d123e123bfc85abc --load-permission Add=[{UserId=123456789012}] ``` Ausgabe: ``` { "FpgaImageAttribute": { "FpgaImageId": "afi-0d123e123bfc85abc", "LoadPermissions": [ { "UserId": "123456789012" } ] } } ``` + Einzelheiten zur API finden Sie [ModifyFpgaImageAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-fpga-image-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `modify-hosts` Das folgende Codebeispiel zeigt die Verwendung`modify-hosts`. **AWS CLI** **Beispiel 1: So aktivieren Sie die automatische Platzierung für einen Dedicated Host** Im folgenden Beispiel für `modify-hosts` wird die automatische Platzierung für einen Dedicated Host aktiviert, sodass er alle nicht zielgerichteten Instance-Starts, die mit seiner Instance-Typkonfiguration übereinstimmen, akzeptiert. ``` aws ec2 modify-hosts \ --host-id h-06c2f189b4EXAMPLE \ --auto-placement on ``` Ausgabe: ``` { "Successful": [ "h-06c2f189b4EXAMPLE" ], "Unsuccessful": [] } ``` Weitere Informationen finden Sie unter [Ändern der Einstellung für die automatische Platzierung für einen Dedicated Host](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/modify-host-auto-placement.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So aktivieren Sie die Host-Wiederherstellung für einen Dedicated Host** Im folgenden Beispiel für `modify-hosts` wird die Host-Wiederherstellung für den angegebenen Dedicated Host aktiviert. ``` aws ec2 modify-hosts \ --host-id h-06c2f189b4EXAMPLE \ --host-recovery on ``` Ausgabe: ``` { "Successful": [ "h-06c2f189b4EXAMPLE" ], "Unsuccessful": [] } ``` Weitere Informationen finden Sie unter [Ändern der Einstellung für die automatische Platzierung für einen Dedicated Host](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/modify-host-auto-placement.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyHosts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-hosts.html)in der *AWS CLI Befehlsreferenz*. ### `modify-id-format` Das folgende Codebeispiel zeigt die Verwendung`modify-id-format`. **AWS CLI** **So aktivieren Sie das längere ID-Format für eine Ressource** Im folgenden Beispiel für `modify-id-format` wird das längere ID-Format für den `instance`-Ressourcentyp aktiviert. ``` aws ec2 modify-id-format \ --resource instance \ --use-long-ids ``` **So deaktivieren Sie das längere ID-Format für eine Ressource** Im folgenden Beispiel für `modify-id-format` wird das längere ID-Format für den `instance`-Ressourcentyp deaktiviert. ``` aws ec2 modify-id-format \ --resource instance \ --no-use-long-ids ``` Im folgenden Beispiel für `modify-id-format` wird das längere ID-Format für alle unterstützten Ressourcentypen aktiviert, die sich innerhalb des Opt-in-Zeitraums befinden. ``` aws ec2 modify-id-format \ --resource all-current \ --use-long-ids ``` + Einzelheiten zur API finden Sie [ModifyIdFormat](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-id-format.html)in der *AWS CLI Befehlsreferenz*. ### `modify-identity-id-format` Das folgende Codebeispiel zeigt die Verwendung`modify-identity-id-format`. **AWS CLI** **Um zu ermöglichen, dass eine IAM-Rolle länger IDs für eine Ressource verwendet wird** Das folgende `modify-identity-id-format` Beispiel aktiviert die IAM-Rolle `EC2Role` in Ihrem AWS Konto, das Long-ID-Format für den `instance` Ressourcentyp zu verwenden. ``` aws ec2 modify-identity-id-format \ --principal-arn arn:aws:iam::123456789012:role/EC2Role \ --resource instance \ --use-long-ids ``` **Um es einem IAM-Benutzer zu ermöglichen, eine Ressource IDs länger zu verwenden** Das folgende `modify-identity-id-format` Beispiel ermöglicht es dem IAM-Benutzer `AdminUser` in Ihrem AWS Konto, das längere ID-Format für den `volume` Ressourcentyp zu verwenden. ``` aws ec2 modify-identity-id-format \ --principal-arn arn:aws:iam::123456789012:user/AdminUser \ --resource volume \ --use-long-ids ``` Im folgenden `modify-identity-id-format` Beispiel kann der IAM-Benutzer `AdminUser` in Ihrem AWS Konto das längere ID-Format für alle unterstützten Ressourcentypen verwenden, die sich innerhalb der Anmeldefrist befinden. ``` aws ec2 modify-identity-id-format \ --principal-arn arn:aws:iam::123456789012:user/AdminUser \ --resource all-current \ --use-long-ids ``` + Einzelheiten zur API finden Sie [ModifyIdentityIdFormat](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-identity-id-format.html)in der *AWS CLI Befehlsreferenz*. ### `modify-image-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-image-attribute`. **AWS CLI** **Beispiel 1: So machen Sie ein AMI öffentlich zugänglich** Im folgenden Beispiel für `modify-instance-attribute` wird das angegebene AMI öffentlich zugänglich gemacht. ``` aws ec2 modify-image-attribute \ --image-id ami-5731123e \ --launch-permission "Add=[{Group=all}]" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So machen Sie ein AMI privat zugänglich** Im folgenden Beispiel für `modify-instance-attribute` wird das angegebene AMI privat zugänglich gemacht. ``` aws ec2 modify-image-attribute \ --image-id ami-5731123e \ --launch-permission "Remove=[{Group=all}]" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 3: Um einem AWS Konto die Startberechtigung zu erteilen** Im folgenden `modify-instance-attribute` Beispiel werden dem angegebenen AWS Konto Startberechtigungen erteilt. ``` aws ec2 modify-image-attribute \ --image-id ami-5731123e \ --launch-permission "Add=[{UserId=123456789012}]" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 4: Um einem AWS Konto die Startberechtigung zu entziehen** Im folgenden `modify-instance-attribute` Beispiel werden die Startberechtigungen aus dem angegebenen AWS Konto entfernt. ``` aws ec2 modify-image-attribute \ --image-id ami-5731123e \ --launch-permission "Remove=[{UserId=123456789012}]" ``` + Einzelheiten zur API finden Sie [ModifyImageAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-image-attribute.html)unter *AWS CLI Befehlsreferenz*. ### `modify-instance-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-instance-attribute`. **AWS CLI** **Beispiel 1: So ändern Sie den Instance-Typ** Im folgenden Beispiel für `modify-instance-attribute` wird der Typ der angegebenen Instance geändert. Die Instance muss sich im Status `stopped` befinden. ``` aws ec2 modify-instance-attribute \ --instance-id i-1234567890abcdef0 \ --instance-type "{\"Value\": \"m1.small\"}" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So aktivieren Sie Enhanced Networking auf einer Instance** Im folgenden Beispiel für `modify-instance-attribute` wird Enhanced Networking für die angegebene Instance aktiviert. Die Instance muss sich im Status `stopped` befinden. ``` aws ec2 modify-instance-attribute \ --instance-id i-1234567890abcdef0 \ --sriov-net-support simple ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 3: Um das sourceDestCheck Attribut zu ändern** Im folgenden Beispiel für `modify-instance-attribute` wird das `sourceDestCheck`-Attribut für die angegebene Instance in `true` geändert. Die Instance muss sich in einer VPC befinden. ``` aws ec2 modify-instance-attribute --instance-id i-1234567890abcdef0 --source-dest-check "{\"Value\": true}" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 4: Um das deleteOnTermination Attribut des Root-Volumes zu ändern** Im folgenden Beispiel für `modify-instance-attribute` wird das `deleteOnTermination`-Attribut für das Root-Volume der angegebenen, von Amazon EBS unterstützten Instance auf `false` festgelegt. Standardmäßig ist dieses Attribut für das Root-Volume auf `true` festgelegt. Befehl: ``` aws ec2 modify-instance-attribute \ --instance-id i-1234567890abcdef0 \ --block-device-mappings "[{\"DeviceName\": \"/dev/sda1\",\"Ebs\":{\"DeleteOnTermination\":false}}]" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 5: So ändern Sie die Benutzerdaten, die einer Instance angehängt sind** Im folgenden `modify-instance-attribute` Beispiel wird der Inhalt der Datei `UserData.txt` als UserData für die angegebene Instanz hinzugefügt. Inhalt der Originaldatei `UserData.txt`: ``` #!/bin/bash yum update -y service httpd start chkconfig httpd on ``` Der Inhalt der Datei muss base64-kodiert sein. Der erste Befehl konvertiert die Textdatei in base64 und speichert sie als neue Datei. Linux/macOS-Version des Befehls: ``` base64 UserData.txt > UserData.base64.txt ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Windows-Version des Befehls: ``` certutil -encode UserData.txt tmp.b64 && findstr /v /c:- tmp.b64 > UserData.base64.txt ``` Ausgabe: ``` Input Length = 67 Output Length = 152 CertUtil: -encode command completed successfully. ``` Jetzt können Sie im folgenden CLI-Befehl auf diese Datei verweisen: ``` aws ec2 modify-instance-attribute \ --instance-id=i-09b5a14dbca622e76 \ --attribute userData --value file://UserData.base64.txt ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Benutzerdaten und AWS CLI im](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html#user-data-api-cli) *EC2-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ModifyInstanceAttribute AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-attribute.html)*Befehlsreferenz.* ### `modify-instance-capacity-reservation-attributes` Das folgende Codebeispiel zeigt die Verwendung`modify-instance-capacity-reservation-attributes`. **AWS CLI** **Beispiel 1: So ändern Sie die Zieleinstellungen für Kapazitätsreservierungen einer Instance** Im folgenden Beispiel für `modify-instance-capacity-reservation-attributes` wird eine angehaltene Instance so geändert, dass sie auf eine bestimmte Kapazitätsreservierung abzielt. ``` aws ec2 modify-instance-capacity-reservation-attributes \ --instance-id i-EXAMPLE8765abcd4e \ --capacity-reservation-specification 'CapacityReservationTarget={CapacityReservationId= cr-1234abcd56EXAMPLE }' ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Ändern der Einstellungen für die Kapazitätsreservierung Ihrer Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-modify-instance.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So ändern Sie die Zieleinstellungen für Kapazitätsreservierungen einer Instance** Im folgenden Beispiel für `modify-instance-capacity-reservation-attributes` wird eine angehaltene Instance, die auf die angegebene Kapazitätsreservierung abzielt, so geändert, dass sie in jeder Kapazitätsreservierung gestartet wird, die übereinstimmende Attribute (Instance-Typ, Plattform, Availability Zone) und offene Instance-Übereinstimmungskriterien enthält. ``` aws ec2 modify-instance-capacity-reservation-attributes \ --instance-id i-EXAMPLE8765abcd4e \ --capacity-reservation-specification 'CapacityReservationPreference=open' ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Ändern der Einstellungen für die Kapazitätsreservierung Ihrer Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-modify-instance.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyInstanceCapacityReservationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-capacity-reservation-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `modify-instance-credit-specification` Das folgende Codebeispiel zeigt die Verwendung`modify-instance-credit-specification`. **AWS CLI** **So ändern Sie die Guthabenoption für die CPU-Nutzung einer Instance** In diesem Beispiel wird die Guthabenoption für die CPU-Nutzung der angegebenen Instance in der festgelegten Region in „unbegrenzt“ geändert. Gültige Guthabenoptionen sind „Standard“ und „unbegrenzt“. Befehl: ``` aws ec2 modify-instance-credit-specification --instance-credit-specification "InstanceId=i-1234567890abcdef0,CpuCredits=unlimited" ``` Ausgabe: ``` { "SuccessfulInstanceCreditSpecifications": [ { "InstanceId": "i-1234567890abcdef0" } ], "UnsuccessfulInstanceCreditSpecifications": [] } ``` + Einzelheiten zur API finden Sie [ModifyInstanceCreditSpecification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-credit-specification.html)in der *AWS CLI Befehlsreferenz*. ### `modify-instance-event-start-time` Das folgende Codebeispiel zeigt die Verwendung`modify-instance-event-start-time`. **AWS CLI** **So ändern Sie die Startzeit des Ereignisses für eine Instance** Der folgende `modify-instance-event-start-time`-Befehl zeigt, wie die Startzeit des Ereignisses für die angegebene Instance geändert wird. Geben Sie die Ereignis-ID mit dem `--instance-event-id`-Parameter an. Geben Sie das neue Datum und die Uhrzeit mit dem `--not-before`-Parameter an. ``` aws ec2 modify-instance-event-start-time --instance-id i-1234567890abcdef0 --instance-event-id instance-event-0abcdef1234567890 --not-before 2019-03-25T10:00:00.000 ``` Ausgabe: ``` "Event": { "InstanceEventId": "instance-event-0abcdef1234567890", "Code": "system-reboot", "Description": "scheduled reboot", "NotAfter": "2019-03-25T12:00:00.000Z", "NotBefore": "2019-03-25T10:00:00.000Z", "NotBeforeDeadline": "2019-04-22T21:00:00.000Z" } ``` Weitere Informationen finden Sie unter „Arbeiten mit Instances, für die der Neustart geplant ist“ im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie [ModifyInstanceEventStartTime](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-event-start-time.html)in der *AWS CLI Befehlsreferenz*. ### `modify-instance-event-window` Das folgende Codebeispiel zeigt die Verwendung`modify-instance-event-window`. **AWS CLI** **Beispiel 1: So ändern Sie den Zeitraum eines Ereignisfensters** Im folgenden Beispiel für `modify-instance-event-window` wird der Zeitraum eines Ereignisfensters geändert. Geben Sie den `time-range`-Parameter an, um den Zeitbereich zu ändern. Sie können außerdem den Parameter `cron-expression` nicht angeben. ``` aws ec2 modify-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "TimeRanges": [ { "StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8 } ], "Name": "myEventWindowName", "AssociationTarget": { "InstanceIds": [ "i-0abcdef1234567890", "i-0be35f9acb8ba01f0" ], "Tags": [], "DedicatedHostIds": [] }, "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. **Beispiel 2: So ändern Sie eine Reihe von Zeiträumen für ein Ereignisfenster** Im folgenden Beispiel für `modify-instance-event-window` wird der Zeitraum eines Ereignisfensters geändert. Geben Sie den `time-range`-Parameter an, um den Zeitbereich zu ändern. Sie können außerdem den Parameter `cron-expression` nicht angeben. ``` aws ec2 modify-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 \ --time-range '[{"StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8}, {"StartWeekDay": "thursday", "StartHour": 2, "EndWeekDay": "friday", "EndHour": 8}]' ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "TimeRanges": [ { "StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8 }, { "StartWeekDay": "thursday", "StartHour": 2, "EndWeekDay": "friday", "EndHour": 8 } ], "Name": "myEventWindowName", "AssociationTarget": { "InstanceIds": [ "i-0abcdef1234567890", "i-0be35f9acb8ba01f0" ], "Tags": [], "DedicatedHostIds": [] }, "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. **Beispiel 3: So ändern Sie den Cron-Ausdruck eines Ereignisfensters** Im folgenden Beispiel für `modify-instance-event-window` wird der Cron-Ausdruck eines Ereignisfensters geändert. Geben Sie den `cron-expression`-Parameter an, um den Cron-Ausdruck zu ändern. Sie können außerdem den Parameter `time-range` nicht angeben. ``` aws ec2 modify-instance-event-window \ --region us-east-1 \ --instance-event-window-id iew-0abcdef1234567890 \ --cron-expression "* 21-23 * * 2,3" ``` Ausgabe: ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [ "i-0abcdef1234567890", "i-0be35f9acb8ba01f0" ], "Tags": [], "DedicatedHostIds": [] }, "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` Informationen zu Einschränkungen des Ereignisfensters finden Sie unter [Überlegungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) im Abschnitt „Geplante Ereignisse“ des *Benutzerhandbuchs für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyInstanceEventWindow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-event-window.html)in der *AWS CLI Befehlsreferenz*. ### `modify-instance-maintenance-options` Das folgende Codebeispiel zeigt die Verwendung`modify-instance-maintenance-options`. **AWS CLI** **Beispiel 1: So deaktivieren Sie das Wiederherstellungsverhalten einer Instance** Im folgenden Beispiel für `modify-instance-maintenance-options` wird die vereinfachte automatische Wiederherstellung für eine laufende oder angehaltene Instance deaktiviert. ``` aws ec2 modify-instance-maintenance-options \ --instance-id i-0abcdef1234567890 \ --auto-recovery disabled ``` Ausgabe: ``` { "InstanceId": "i-0abcdef1234567890", "AutoRecovery": "disabled" } ``` Weitere Informationen finden Sie unter [Konfigurieren der vereinfachten automatischen Wiederherstellung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-configuration-recovery.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So legen Sie das Wiederherstellungsverhalten einer Instance auf den Standardwert fest** Im folgenden Beispiel für `modify-instance-maintenance-options` wird das automatische Wiederherstellungsverhalten auf den Standardwert festgelegt, wodurch eine vereinfachte automatische Wiederherstellung für unterstützte Instance-Typen ermöglicht wird. ``` aws ec2 modify-instance-maintenance-options \ --instance-id i-0abcdef1234567890 \ --auto-recovery default ``` Ausgabe: ``` { "InstanceId": "i-0abcdef1234567890", "AutoRecovery": "default" } ``` Weitere Informationen finden Sie unter [Konfigurieren der vereinfachten automatischen Wiederherstellung](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-configuration-recovery.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyInstanceMaintenanceOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-maintenance-options.html)in der *AWS CLI Befehlsreferenz*. ### `modify-instance-metadata-options` Das folgende Codebeispiel zeigt die Verwendung`modify-instance-metadata-options`. **AWS CLI** **Beispiel 1: Um zu aktivieren IMDSv2** Im folgenden `modify-instance-metadata-options` Beispiel wird die Verwendung von IMDSv2 auf der angegebenen Instanz konfiguriert. ``` aws ec2 modify-instance-metadata-options \ --instance-id i-1234567898abcdef0 \ --http-tokens required \ --http-endpoint enabled ``` Ausgabe: ``` { "InstanceId": "i-1234567898abcdef0", "InstanceMetadataOptions": { "State": "pending", "HttpTokens": "required", "HttpPutResponseHopLimit": 1, "HttpEndpoint": "enabled" } } ``` Weitere Informationen finden Sie unter [Instance-Metadaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So deaktivieren Sie Instance-Metadaten** Im folgenden Beispiel für `modify-instance-metadata-options` wird die Verwendung aller Versionen von Instance-Metadaten für die der angegebene Instance deaktiviert. ``` aws ec2 modify-instance-metadata-options \ --instance-id i-1234567898abcdef0 \ --http-endpoint disabled ``` Ausgabe: ``` { "InstanceId": "i-1234567898abcdef0", "InstanceMetadataOptions": { "State": "pending", "HttpTokens": "required", "HttpPutResponseHopLimit": 1, "HttpEndpoint": "disabled" } } ``` Weitere Informationen finden Sie unter [Instance-Metadaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 3: So aktivieren Sie den IPv6 Instanz-Metadaten-Endpunkt für Ihre Instance** Das folgende `modify-instance-metadata-options` Beispiel zeigt Ihnen, wie Sie den IPv6 Endpunkt für den Instanz-Metadatendienst aktivieren. Standardmäßig ist der IPv6 Endpunkt deaktiviert. Dies gilt auch dann, wenn Sie eine Instance in einem Subnetz gestartet haben, das IPv6 nur für das Subnetz zuständig ist. Der IPv6 Endpunkt für IMDS ist nur auf Instances zugänglich, die auf dem Nitro-System basieren. ``` aws ec2 modify-instance-metadata-options \ --instance-id i-1234567898abcdef0 \ --http-protocol-ipv6 enabled \ --http-endpoint enabled ``` Ausgabe: ``` { "InstanceId": "i-1234567898abcdef0", "InstanceMetadataOptions": { "State": "pending", "HttpTokens": "required", "HttpPutResponseHopLimit": 1, "HttpEndpoint": "enabled", HttpProtocolIpv6": "enabled" } } ``` Weitere Informationen finden Sie unter [Instance-Metadaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyInstanceMetadataOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-metadata-options.html)in der *AWS CLI Befehlsreferenz*. ### `modify-instance-placement` Das folgende Codebeispiel zeigt die Verwendung`modify-instance-placement`. **AWS CLI** **Beispiel 1: So entfernen Sie die Affinität einer Instance zu einem Dedicated Host** Im folgenden Beispiel für `modify-instance-placement` wird die Affinität einer Instance zu einem Dedicated Host entfernt und es wird ihr ermöglicht, auf einem beliebigen verfügbaren Dedicated Host in Ihrem Konto zu starten, der ihren Instance-Typ unterstützt. ``` aws ec2 modify-instance-placement \ --instance-id i-0e6ddf6187EXAMPLE \ --affinity default ``` Ausgabe: ``` { "Return": true } ``` **Beispiel 2: So stellen Sie Affinität zwischen einer Instance und dem angegebenen Dedicated Host her** Im folgenden Beispiel für `modify-instance-placement` wird eine Start-Beziehung zwischen einer Instance und einem Dedicated Host aufgebaut. Die Instance kann nur auf dem angegebenen Dedicated Host gestartet werden. ``` aws ec2 modify-instance-placement \ --instance-id i-0e6ddf6187EXAMPLE \ --affinity host \ --host-id i-0e6ddf6187EXAMPLE ``` Ausgabe: ``` { "Return": true } ``` **Beispiel 3: So verschieben Sie eine Instance in eine Platzierungsgruppe** Im folgenden Beispiel für `modify-instance-placement` wird eine Instance in eine Placement-Gruppe verschoben, die Instance angehalten, die Instance-Platzierung geändert und die Instance anschließend neu gestartet. ``` aws ec2 stop-instances \ --instance-ids i-0123a456700123456 aws ec2 modify-instance-placement \ --instance-id i-0123a456700123456 \ --group-name MySpreadGroup aws ec2 start-instances \ --instance-ids i-0123a456700123456 ``` **Beispiel 4: So entfernen Sie eine Instance aus einer Platzierungsgruppe** Im folgenden Beispiel für `modify-instance-placement` wird eine Instance aus einer Platzierungsgruppe entfernt, indem die Instance angehalten, die Instance-Platzierung geändert und die Instance anschließend neu gestartet wird. Im folgenden Beispiel wird eine leere Zeichenfolge („“) für den Namen der Platzierungsgruppe angegeben, um darauf hinzuweisen, dass sich die Instance nicht in einer Platzierungsgruppe befinden soll. Anhalten der Instance: ``` aws ec2 stop-instances \ --instance-ids i-0123a456700123456 ``` Ändern Sie die Platzierung (Windows-Eingabeaufforderung): ``` aws ec2 modify-instance-placement \ --instance-id i-0123a456700123456 \ --group-name "" ``` Ändern Sie die Platzierung (Windows PowerShell, Linux und macOS): ``` aws ec2 modify-instance-placement ` --instance-id i-0123a456700123456 ` --group-name '' ``` Starten Sie die Instance neu: ``` aws ec2 start-instances \ --instance-ids i-0123a456700123456 ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Ändern der Tenancy und Affinität eines Dedicated Host](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/moving-instances-dedicated-hosts.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyInstancePlacement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-placement.html)in der *AWS CLI Befehlsreferenz*. ### `modify-ipam-pool` Das folgende Codebeispiel zeigt die Verwendung`modify-ipam-pool`. **AWS CLI** **So ändern Sie einen IPAM-Pool** Im folgenden Beispiel für `modify-ipam-pool` wird ein IPAM-Pool geändert. (Linux) ``` aws ec2 modify-ipam-pool \ --ipam-pool-id ipam-pool-0533048da7d823723 \ --add-allocation-resource-tags "Key=Owner,Value=Build Team" \ --clear-allocation-default-netmask-length \ --allocation-min-netmask-length 14 ``` (Windows) ``` aws ec2 modify-ipam-pool ^ --ipam-pool-id ipam-pool-0533048da7d823723 ^ --add-allocation-resource-tags "Key=Owner,Value=Build Team" ^ --clear-allocation-default-netmask-length ^ --allocation-min-netmask-length 14 ``` Ausgabe: ``` { "IpamPool": { "OwnerId": "123456789012", "IpamPoolId": "ipam-pool-0533048da7d823723", "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0533048da7d823723", "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-02fc38cd4c48e7d38", "IpamScopeType": "private", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "Locale": "None", "PoolDepth": 1, "State": "modify-complete", "AutoImport": true, "AddressFamily": "ipv4", "AllocationMinNetmaskLength": 14, "AllocationMaxNetmaskLength": 26, "AllocationResourceTags": [ { "Key": "Environment", "Value": "Preprod" }, { "Key": "Owner", "Value": "Build Team" } ] } } ``` Weitere Informationen finden Sie unter [Bearbeiten eines Pools](https://docs.aws.amazon.com/vpc/latest/ipam/mod-pool-ipam.html) im *Benutzerhandbuch zu Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [ModifyIpamPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-ipam-pool.html)in der *AWS CLI Befehlsreferenz*. ### `modify-ipam-resource-cidr` Das folgende Codebeispiel zeigt die Verwendung`modify-ipam-resource-cidr`. **AWS CLI** **So ändern Sie das CIDR, das einer Ressource zugewiesen ist** Im folgenden Beispiel für `modify-ipam-resource-cidr` wird ein Ressourcen-CIDR geändert. (Linux) ``` aws ec2 modify-ipam-resource-cidr \ --current-ipam-scope-id ipam-scope-02fc38cd4c48e7d38 \ --destination-ipam-scope-id ipam-scope-0da34c61fd189a141 \ --resource-id vpc-010e1791024eb0af9 \ --resource-cidr 10.0.1.0/24 \ --resource-region us-east-1 \ --monitored ``` (Windows) ``` aws ec2 modify-ipam-resource-cidr ^ --current-ipam-scope-id ipam-scope-02fc38cd4c48e7d38 ^ --destination-ipam-scope-id ipam-scope-0da34c61fd189a141 ^ --resource-id vpc-010e1791024eb0af9 ^ --resource-cidr 10.0.1.0/24 ^ --resource-region us-east-1 ^ --monitored ``` Ausgabe: ``` { "IpamResourceCidr": { "IpamId": "ipam-08440e7a3acde3908", "IpamScopeId": "ipam-scope-0da34c61fd189a141", "IpamPoolId": "ipam-pool-0533048da7d823723", "ResourceRegion": "us-east-1", "ResourceOwnerId": "123456789012", "ResourceId": "vpc-010e1791024eb0af9", "ResourceCidr": "10.0.1.0/24", "ResourceType": "vpc", "ResourceTags": [ { "Key": "Environment", "Value": "Preprod" }, { "Key": "Owner", "Value": "Build Team" } ], "IpUsage": 0.0, "ComplianceStatus": "noncompliant", "ManagementState": "managed", "OverlapStatus": "overlapping", "VpcId": "vpc-010e1791024eb0af9" } } ``` Weitere Informationen zum Verschieben von Ressourcen finden Sie unter [Verschieben von Ressourcen CIDRs zwischen Bereichen](https://docs.aws.amazon.com/vpc/latest/ipam/move-resource-ipam.html) im *Amazon VPC IPAM-Benutzerhandbuch*. Weitere Informationen zum Ändern des Überwachungsstatus finden Sie unter [Ändern des Überwachungsstatus einer Ressource CIDRs](https://docs.aws.amazon.com/vpc/latest/ipam/change-monitoring-state-ipam.html) im *Amazon VPC IPAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ModifyIpamResourceCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-ipam-resource-cidr.html)in der *AWS CLI Befehlsreferenz*. ### `modify-ipam-resource-discovery` Das folgende Codebeispiel zeigt die Verwendung`modify-ipam-resource-discovery`. **AWS CLI** **So ändern Sie die Betriebsregionen einer Ressourcenerkennung** In diesem Beispiel sind Sie ein delegierter IPAM-Administrator, der die Betriebsregionen einer Ressourcenerkennung ändern möchte. Gehen Sie wie folgt vor, um diese Anforderung abzuschließen: Sie können eine standardmäßige Ressourcensuche nicht ändern, und Sie müssen der Besitzer der Ressourcenerkennung sein. Sie benötigen die Resource Discovery-ID, die Sie abrufen können. [describe-ipam-resource-discoveries](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-ipam-resource-discoveries.html) Im folgenden `modify-ipam-resource-discovery` Beispiel wird eine nicht standardmäßige Ressourcensuche in Ihrem Konto geändert. AWS ``` aws ec2 modify-ipam-resource-discovery \ --ipam-resource-discovery-id ipam-res-disco-0f4ef577a9f37a162 \ --add-operating-regions RegionName='us-west-1' \ --remove-operating-regions RegionName='us-east-2' \ --region us-east-1 ``` Ausgabe: ``` { "IpamResourceDiscovery": { "OwnerId": "149977607591", "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe", "IpamResourceDiscoveryArn": "arn:aws:ec2::149977607591:ipam-resource-discovery/ipam-res-disco-0365d2977fc1672fe", "IpamResourceDiscoveryRegion": "us-east-1", "Description": "Example", "OperatingRegions": [ { "RegionName": "us-east-1" }, { "RegionName": "us-west-1" } ], "IsDefault": false, "State": "modify-in-progress" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Ressourcenerkennungen](https://docs.aws.amazon.com/vpc/latest/ipam/res-disc-work-with.html) im *Benutzerhandbuch für Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [ModifyIpamResourceDiscovery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-ipam-resource-discovery.html)in der *AWS CLI Befehlsreferenz*. ### `modify-ipam-scope` Das folgende Codebeispiel zeigt die Verwendung`modify-ipam-scope`. **AWS CLI** **So ändern Sie die Beschreibung eines Bereichs** In diesem Szenario sind Sie ein delegierter IPAM-Administrator, der die Beschreibung eines IPAM-Bereichs ändern möchte. Um diese Anfrage abzuschließen, benötigen Sie die Bereichs-ID, die Sie erhalten können [describe-ipam-scopes](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-ipam-scopes.html). Im folgenden Beispiel für `modify-ipam-scope` wird die Beschreibung eines Bereichs aktualisiert. ``` aws ec2 modify-ipam-scope \ --ipam-scope-id ipam-scope-0d3539a30b57dcdd1 \ --description example \ --region us-east-1 ``` Ausgabe: ``` { "IpamScope": { "OwnerId": "320805250157", "IpamScopeId": "ipam-scope-0d3539a30b57dcdd1", "IpamScopeArn": "arn:aws:ec2::320805250157:ipam-scope/ipam-scope-0d3539a30b57dcdd1", "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107", "IpamRegion": "us-east-1", "IpamScopeType": "public", "IsDefault": true, "Description": "example", "PoolCount": 1, "State": "modify-in-progress" } } ``` Weitere Informationen zu Bereichen finden Sie unter [Funktionsweise von IPAM](https://docs.aws.amazon.com/vpc/latest/ipam/how-it-works-ipam.html) im *Benutzerhandbuch zu Amazon VPC IPAM*. + Einzelheiten zur API finden Sie [ModifyIpamScope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-ipam-scope.html)in der *AWS CLI Befehlsreferenz*. ### `modify-ipam` Das folgende Codebeispiel zeigt die Verwendung`modify-ipam`. **AWS CLI** **So ändern Sie einen IPAM** Im folgenden Beispiel für `modify-ipam` wird ein IPAM geändert, indem eine Betriebsregion hinzugefügt wird. (Linux) ``` aws ec2 modify-ipam \ --ipam-id ipam-08440e7a3acde3908 \ --add-operating-regions RegionName=us-west-2 ``` (Windows) ``` aws ec2 modify-ipam ^ --ipam-id ipam-08440e7a3acde3908 ^ --add-operating-regions RegionName=us-west-2 ``` Ausgabe: ``` { "Ipam": { "OwnerId": "123456789012", "IpamId": "ipam-08440e7a3acde3908", "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908", "IpamRegion": "us-east-1", "PublicDefaultScopeId": "ipam-scope-0b9eed026396dbc16", "PrivateDefaultScopeId": "ipam-scope-02fc38cd4c48e7d38", "ScopeCount": 3, "OperatingRegions": [ { "RegionName": "us-east-1" }, { "RegionName": "us-east-2" }, { "RegionName": "us-west-1" }, { "RegionName": "us-west-2" } ], "State": "modify-in-progress" } } ``` + Einzelheiten zur API finden Sie [ModifyIpam](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-ipam.html)in der *AWS CLI Befehlsreferenz*. ### `modify-launch-template` Das folgende Codebeispiel zeigt die Verwendung`modify-launch-template`. **AWS CLI** **So ändern Sie die Standardversion einer Startvorlage** In diesem Beispiel wird Version 2 der angegebenen Startvorlage als Standardversion festgelegt. Befehl: ``` aws ec2 modify-launch-template --launch-template-id lt-0abcd290751193123 --default-version 2 ``` Ausgabe: ``` { "LaunchTemplate": { "LatestVersionNumber": 2, "LaunchTemplateId": "lt-0abcd290751193123", "LaunchTemplateName": "WebServers", "DefaultVersionNumber": 2, "CreatedBy": "arn:aws:iam::123456789012:root", "CreateTime": "2017-12-01T13:35:46.000Z" } } ``` + Einzelheiten zur API finden Sie [ModifyLaunchTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-launch-template.html)in der *AWS CLI Befehlsreferenz*. ### `modify-managed-prefix-list` Das folgende Codebeispiel zeigt die Verwendung`modify-managed-prefix-list`. **AWS CLI** **So ändern Sie eine Präfixliste** Im folgenden Beispiel für `modify-managed-prefix-list` wird der angegebenen Präfixliste ein Eintrag hinzugefügt. ``` aws ec2 modify-managed-prefix-list \ --prefix-list-id pl-0123456abcabcabc1 \ --add-entries Cidr=10.1.0.0/16,Description=vpc-c \ --current-version 1 ``` Ausgabe: ``` { "PrefixList": { "PrefixListId": "pl-0123456abcabcabc1", "AddressFamily": "IPv4", "State": "modify-in-progress", "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1", "PrefixListName": "vpc-cidrs", "MaxEntries": 10, "Version": 1, "OwnerId": "123456789012" } } ``` Weitere Informationen finden Sie unter [Verwaltete Präfixlisten](https://docs.aws.amazon.com/vpc/latest/userguide/managed-prefix-lists.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [ModifyManagedPrefixList](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-managed-prefix-list.html)in der *AWS CLI Befehlsreferenz*. ### `modify-network-interface-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-network-interface-attribute`. **AWS CLI** **So ändern Sie das attachment-Attribut einer Netzwerkschnittstelle** Dieser Beispielbefehl beschreibt das `attachment`-Attribut der angegebenen Netzwerkschnittstelle. Befehl: ``` aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --attachment AttachmentId=eni-attach-43348162,DeleteOnTermination=false ``` **So ändern Sie das description-Attribut einer Netzwerkschnittstelle** Dieser Beispielbefehl beschreibt das `description`-Attribut der angegebenen Netzwerkschnittstelle. Befehl: ``` aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --description "My description" ``` **So ändern Sie das groupSet-Attribut einer Netzwerkschnittstelle** Dieser Beispielbefehl beschreibt das `groupSet`-Attribut der angegebenen Netzwerkschnittstelle. Befehl: ``` aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --groups sg-903004f8 sg-1a2b3c4d ``` **Um das sourceDestCheck Attribut einer Netzwerkschnittstelle zu ändern** Dieser Beispielbefehl beschreibt das `sourceDestCheck`-Attribut der angegebenen Netzwerkschnittstelle. Befehl: ``` aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --no-source-dest-check ``` + Einzelheiten zur API finden Sie [ModifyNetworkInterfaceAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-network-interface-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `modify-private-dns-name-options` Das folgende Codebeispiel zeigt die Verwendung`modify-private-dns-name-options`. **AWS CLI** **So ändern Sie die Optionen für Instance-Hostnamen** Im folgenden Beispiel für `modify-private-dns-name-options` wird die Option deaktiviert, auf DNS-Abfragen für Instance-Hostnamen mit DNS-A-Datensätzen zu antworten. ``` aws ec2 modify-private-dns-name-options \ --instance-id i-1234567890abcdef0 \ --no-enable-resource-name-dns-a-record ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Hostnamentypen für Amazon-EC2-Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-naming.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ModifyPrivateDnsNameOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-private-dns-name-options.html)in der *AWS CLI Befehlsreferenz*. ### `modify-reserved-instances` Das folgende Codebeispiel zeigt die Verwendung`modify-reserved-instances`. **AWS CLI** **So ändern Sie Reserved Instances** Dieser Beispielbefehl verschiebt eine Reserved Instance in eine andere Availability Zone in derselben Region. Befehl: ``` aws ec2 modify-reserved-instances --reserved-instances-ids b847fa93-e282-4f55-b59a-1342f5bd7c02 --target-configurations AvailabilityZone=us-west-1c,Platform=EC2-Classic,InstanceCount=10 ``` Ausgabe: ``` { "ReservedInstancesModificationId": "rimod-d3ed4335-b1d3-4de6-ab31-0f13aaf46687" } ``` **So ändern Sie die Netzwerkplattform von Reserved Instances** Dieser Beispielbefehl konvertiert EC2-Classic Reserved Instances in EC2-VPC. Befehl: ``` aws ec2 modify-reserved-instances --reserved-instances-ids f127bd27-edb7-44c9-a0eb-0d7e09259af0 --target-configurations AvailabilityZone=us-west-1c,Platform=EC2-VPC,InstanceCount=5 ``` Ausgabe: ``` { "ReservedInstancesModificationId": "rimod-82fa9020-668f-4fb6-945d-61537009d291" } ``` Weitere Informationen finden Sie unter „Ändern Ihrer Reserved Instances“ im *Benutzerhandbuch für Amazon EC2*. **So ändern Sie die Instance-Größe von Reserved Instances** Mit diesem Beispielbefehl wird eine Reserved Instance mit 10 Linux/UNIX m1.small-Instances in us-west-1c so geändert, dass aus 8 m1.small-Instances 2 m1.large-Instances werden und die verbleibenden 2 m1.small zu einer m1.medium-Instance in derselben Availability Zone werden. Befehl: ``` aws ec2 modify-reserved-instances --reserved-instances-ids 1ba8e2e3-3556-4264-949e-63ee671405a9 --target-configurations AvailabilityZone=us-west-1c,Platform=EC2-Classic,InstanceCount=2,InstanceType=m1.large AvailabilityZone=us-west-1c,Platform=EC2-Classic,InstanceCount=1,InstanceType=m1.medium ``` Ausgabe: ``` { "ReservedInstancesModificationId": "rimod-acc5f240-080d-4717-b3e3-1c6b11fa00b6" } ``` Weitere Informationen finden Sie unter „Ändern der Instance-Größe Ihrer Reservierungen“ im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten [ModifyReservedInstances AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-reserved-instances.html)*zur* API finden Sie in der Befehlsreferenz. ### `modify-security-group-rules` Das folgende Codebeispiel zeigt die Verwendung`modify-security-group-rules`. **AWS CLI** **Um die Regeln einer Sicherheitsgruppe zu ändern, um die Regelbeschreibung, das IP-Protokoll und den CidrIpv 4-Adressbereich zu aktualisieren** Im folgenden `modify-security-group-rules` Beispiel werden die Beschreibung, das IP-Protokoll und der IPV4 CIDR-Bereich einer angegebenen Sicherheitsgruppenregel aktualisiert. Verwenden Sie den `security-group-rules`-Parameter, um die Updates für die angegebenen Sicherheitsgruppenregeln einzugeben. `-1` gibt alle Protokolle an. ``` aws ec2 modify-security-group-rules \ --group-id sg-1234567890abcdef0 \ --security-group-rules SecurityGroupRuleId=sgr-abcdef01234567890,SecurityGroupRule='{Description=test,IpProtocol=-1,CidrIpv4=0.0.0.0/0}' ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen zu den Regeln der Sicherheitsgruppe finden Sie unter [Sicherheitsgruppenregeln](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie unter [ModifySecurityGroupRules AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-security-group-rules.html)*Befehlsreferenz.* ### `modify-snapshot-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-snapshot-attribute`. **AWS CLI** **Beispiel 1: So ändern Sie ein snapshot-Attribut** Im folgenden Beispiel für `modify-snapshot-attribute` wird das `createVolumePermission`-Attribut für den angegebenen Snapshot aktualisiert und die Volume-Berechtigungen für den angegebenen Benutzer entfernt. ``` aws ec2 modify-snapshot-attribute \ --snapshot-id snap-1234567890abcdef0 \ --attribute createVolumePermission \ --operation-type remove \ --user-ids 123456789012 ``` **Beispiel 2: So machen Sie einen Snapshot öffentlich zugänglich** Im folgenden Beispiel für `modify-snapshot-attribute` wird der angegebene Snapshot öffentlich zugänglich gemacht. ``` aws ec2 modify-snapshot-attribute \ --snapshot-id snap-1234567890abcdef0 \ --attribute createVolumePermission \ --operation-type add \ --group-names all ``` + Einzelheiten zur API finden Sie [ModifySnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-snapshot-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `modify-snapshot-tier` Das folgende Codebeispiel zeigt die Verwendung`modify-snapshot-tier`. **AWS CLI** **So archivieren Sie einen Snapshot** Im folgenden Beispiel für `modify-snapshot-tier` wird der angegebene Snapshot archiviert. Der `TieringStartTime`-Antwortparameter gibt Datum und Uhrzeit des Starts des Archivierungsvorgangs im UTC-Zeitformat (JJJJ-MM-TTTHH:MM:SSZ) an. ``` aws ec2 modify-snapshot-tier \ --snapshot-id snap-01234567890abcedf \ --storage-tier archive ``` Ausgabe: ``` { "SnapshotId": "snap-01234567890abcedf", "TieringStartTime": "2021-09-15T16:44:37.574Z" } ``` Weitere Informationen finden Sie unter [Archivieren von Amazon-EBS-Snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/snapshot-archive.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [ModifySnapshotTier](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-snapshot-tier.html)in der *AWS CLI Befehlsreferenz*. ### `modify-spot-fleet-request` Das folgende Codebeispiel zeigt die Verwendung`modify-spot-fleet-request`. **AWS CLI** **So ändern Sie eine Spot-Flotten-Anforderung** Dieser Beispielbefehl aktualisiert die Zielkapazität der angegebenen Spot-Flottenanforderung. Befehl: ``` aws ec2 modify-spot-fleet-request --target-capacity 20 --spot-fleet-request-id sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE ``` Ausgabe: ``` { "Return": true } ``` Dieser Beispielbefehl verringert die Zielkapazität der angegebenen Spot-Flottenanforderung, ohne dadurch Spot Instances zu beenden. Befehl: ``` aws ec2 modify-spot-fleet-request --target-capacity 10 --excess-capacity-termination-policy NoTermination --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [ModifySpotFleetRequest](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-spot-fleet-request.html)in der *AWS CLI Befehlsreferenz*. ### `modify-subnet-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-subnet-attribute`. **AWS CLI** **Um das Verhalten eines Subnetzes bei der öffentlichen IPv4 Adressierung zu ändern** In diesem Beispiel wird das Subnetz-1a2b3c4d dahingehend geändert, dass allen in diesem Subnetz gestarteten Instances eine öffentliche Adresse zugewiesen wird. IPv4 Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 modify-subnet-attribute --subnet-id subnet-1a2b3c4d --map-public-ip-on-launch ``` **Um IPv6 das Adressierungsverhalten eines Subnetzes zu ändern** In diesem Beispiel wird Subnet-1a2b3c4d dahingehend geändert, dass allen in diesem Subnetz gestarteten Instances eine Adresse aus dem Bereich des Subnetzes zugewiesen wird. IPv6 Befehl: ``` aws ec2 modify-subnet-attribute --subnet-id subnet-1a2b3c4d --assign-ipv6-address-on-creation ``` Weitere Informationen finden Sie unter „IP-Addressierung in Ihrer VPC“ im *Benutzerhandbuch für AWS Virtual Private Cloud*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [ModifySubnetAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-subnet-attribute.html)AWS CLI * ### `modify-traffic-mirror-filter-network-services` Das folgende Codebeispiel zeigt die Verwendung`modify-traffic-mirror-filter-network-services`. **AWS CLI** **So fügen Sie einem Datenverkehr-Spiegelungsfilter Netzwerkservices hinzu** Im folgende Beispiel für `modify-traffic-mirror-filter-network-services` wird dem angegebenen Filter die Amazon-DNS-Netzwerkservices hinzugefügt. ``` aws ec2 modify-traffic-mirror-filter-network-services \ --traffic-mirror-filter-id tmf-04812ff784EXAMPLE \ --add-network-service amazon-dns ``` Ausgabe: ``` { "TrafficMirrorFilter": { "Tags": [ { "Key": "Name", "Value": "Production" } ], "EgressFilterRules": [], "NetworkServices": [ "amazon-dns" ], "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE", "IngressFilterRules": [ { "SourceCidrBlock": "0.0.0.0/0", "RuleNumber": 1, "DestinationCidrBlock": "0.0.0.0/0", "Description": "TCP Rule", "Protocol": 6, "TrafficDirection": "ingress", "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE", "RuleAction": "accept", "TrafficMirrorFilterRuleId": "tmf-04812ff784EXAMPLE" } ] } } ``` Weitere Informationen finden Sie unter [Ändern der Netzwerkservices für den Datenverkehr-Spiegelungsfilter](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-filter.html#modify-traffic-mirroring-filter-network-services) im *Leitfaden für AWS Traffic Mirroring*. + Einzelheiten zur API finden Sie [ModifyTrafficMirrorFilterNetworkServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-traffic-mirror-filter-network-services.html)in der *AWS CLI Befehlsreferenz*. ### `modify-traffic-mirror-filter-rule` Das folgende Codebeispiel zeigt die Verwendung`modify-traffic-mirror-filter-rule`. **AWS CLI** **So ändern Sie eine Datenverkehr-Spiegelungsfilterregel** Im folgenden Beispiel für `modify-traffic-mirror-filter-rule` wird die Beschreibung der angegebenen Datenverkehr-Spiegelungsfilterregel geändert. ``` aws ec2 modify-traffic-mirror-filter-rule \ --traffic-mirror-filter-rule-id tmfr-0ca76e0e08EXAMPLE \ --description "TCP Rule" ``` Ausgabe: ``` { "TrafficMirrorFilterRule": { "TrafficMirrorFilterRuleId": "tmfr-0ca76e0e08EXAMPLE", "TrafficMirrorFilterId": "tmf-0293f26e86EXAMPLE", "TrafficDirection": "ingress", "RuleNumber": 100, "RuleAction": "accept", "Protocol": 6, "DestinationCidrBlock": "10.0.0.0/24", "SourceCidrBlock": "10.0.0.0/24", "Description": "TCP Rule" } } ``` Weitere Informationen finden Sie unter [Ändern Ihrer Datenverkehr-Spiegelungsfilterregeln](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-filter.html#modify-traffic-mirroring-filter-rules) im *Handbuch für AWS Traffic Mirroring*. + Einzelheiten zur API finden Sie [ModifyTrafficMirrorFilterRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-traffic-mirror-filter-rule.html)in der *AWS CLI Befehlsreferenz*. ### `modify-traffic-mirror-session` Das folgende Codebeispiel zeigt die Verwendung`modify-traffic-mirror-session`. **AWS CLI** **So ändern Sie eine Datenverkehr-Spiegelungssitzung** Im folgenden Beispiel für `modify-traffic-mirror-session` werden die Beschreibung der Datenverkehr-Spiegelungssitzung und die Anzahl der zu spiegelnden Pakete geändert. ``` aws ec2 modify-traffic-mirror-session \ --description "Change packet length" \ --traffic-mirror-session-id tms-08a33b1214EXAMPLE \ --remove-fields "packet-length" ``` Ausgabe: ``` { "TrafficMirrorSession": { "TrafficMirrorSessionId": "tms-08a33b1214EXAMPLE", "TrafficMirrorTargetId": "tmt-07f75d8feeEXAMPLE", "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE", "NetworkInterfaceId": "eni-070203f901EXAMPLE", "OwnerId": "111122223333", "SessionNumber": 1, "VirtualNetworkId": 7159709, "Description": "Change packet length", "Tags": [] } } ``` Weitere Informationen finden Sie unter [Ändern Ihrer Datenverkehr-Spiegelungssitzung](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-session.html#modify-traffic-mirroring-session) im *Benutzerhandbuch für Traffic Mirroring*. + Einzelheiten zur API finden Sie [ModifyTrafficMirrorSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-traffic-mirror-session.html)in der *AWS CLI Befehlsreferenz*. ### `modify-transit-gateway-prefix-list-reference` Das folgende Codebeispiel zeigt die Verwendung`modify-transit-gateway-prefix-list-reference`. **AWS CLI** **So ändern Sie eine Präfixlistenreferenz** Im folgenden Beispiel für `modify-transit-gateway-prefix-list-reference` wird die Referenz auf die Präfixliste in der angegebenen Routing-Tabelle geändert, indem der Anhang geändert wird, an den der Verkehr weitergeleitet wird. ``` aws ec2 modify-transit-gateway-prefix-list-reference \ --transit-gateway-route-table-id tgw-rtb-0123456789abcd123 \ --prefix-list-id pl-11111122222222333 \ --transit-gateway-attachment-id tgw-attach-aabbccddaabbccaab ``` Ausgabe: ``` { "TransitGatewayPrefixListReference": { "TransitGatewayRouteTableId": "tgw-rtb-0123456789abcd123", "PrefixListId": "pl-11111122222222333", "PrefixListOwnerId": "123456789012", "State": "modifying", "Blackhole": false, "TransitGatewayAttachment": { "TransitGatewayAttachmentId": "tgw-attach-aabbccddaabbccaab", "ResourceType": "vpc", "ResourceId": "vpc-112233445566aabbc" } } } ``` Weitere Informationen finden Sie unter [Präfixlistenreferenzen](https://docs.aws.amazon.com/vpc/latest/tgw/create-prefix-list-reference.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [ModifyTransitGatewayPrefixListReference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-transit-gateway-prefix-list-reference.html)in der *AWS CLI Befehlsreferenz*. ### `modify-transit-gateway-vpc-attachment` Das folgende Codebeispiel zeigt die Verwendung`modify-transit-gateway-vpc-attachment`. **AWS CLI** **So ändern Sie einen Anhang einer Transit-Gateway-VPC** Im folgenden Beispiel für `modify-transit-gateway-vpc-attachment` wird dem Anhang der angegebenen Transit-Gateway-VPC ein Subnetz hinzugefügt. ``` aws ec2 modify-transit-gateway-vpc-attachment \ --transit-gateway-attachment-id tgw-attach-09fbd47ddfEXAMPLE \ --add-subnet-ids subnet-0e51f45802EXAMPLE ``` Ausgabe: ``` { "TransitGatewayVpcAttachment": { "TransitGatewayAttachmentId": "tgw-attach-09fbd47ddfEXAMPLE", "TransitGatewayId": "tgw-0560315ccfEXAMPLE", "VpcId": "vpc-5eccc927", "VpcOwnerId": "111122223333", "State": "modifying", "SubnetIds": [ "subnet-0e51f45802EXAMPLE", "subnet-1EXAMPLE" ], "CreationTime": "2019-08-08T16:47:38.000Z", "Options": { "DnsSupport": "enable", "Ipv6Support": "disable" } } } ``` Weitere Informationen finden Sie unter [Transit-Gateway-Anhänge an eine VPC](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [ModifyTransitGatewayVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-transit-gateway-vpc-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `modify-transit-gateway` Das folgende Codebeispiel zeigt die Verwendung`modify-transit-gateway`. **AWS CLI** **So ändern Sie ein Transit-Gateway** Im folgenden Beispiel für `modify-transit-gateway` wird das angegebene Transit-Gateway geändert, indem die ECMP-Unterstützung für VPN-Anhänge aktiviert wird. ``` aws ec2 modify-transit-gateway \ --transit-gateway-id tgw-111111222222aaaaa \ --options VpnEcmpSupport=enable ``` Ausgabe: ``` { "TransitGateway": { "TransitGatewayId": "tgw-111111222222aaaaa", "TransitGatewayArn": "64512", "State": "modifying", "OwnerId": "123456789012", "CreationTime": "2020-04-30T08:41:37.000Z", "Options": { "AmazonSideAsn": 64512, "AutoAcceptSharedAttachments": "disable", "DefaultRouteTableAssociation": "enable", "AssociationDefaultRouteTableId": "tgw-rtb-0123456789abcd123", "DefaultRouteTablePropagation": "enable", "PropagationDefaultRouteTableId": "tgw-rtb-0123456789abcd123", "VpnEcmpSupport": "enable", "DnsSupport": "enable" } } } ``` Weitere Informationen finden Sie unter [Transit-Gateways](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-transit-gateways.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [ModifyTransitGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-transit-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `modify-verified-access-endpoint-policy` Das folgende Codebeispiel zeigt die Verwendung`modify-verified-access-endpoint-policy`. **AWS CLI** **So konfigurieren Sie die verifizierte Zugriffsrichtlinie für einen Endpunkt** Im folgenden Beispiel für `modify-verified-access-endpoint-policy` wird dem angegebenen verifizierten Zugriffsendpunkt die verifizierte Zugriffsrichtlinie hinzugefügt. ``` aws ec2 modify-verified-access-endpoint-policy \ --verified-access-endpoint-id vae-066fac616d4d546f2 \ --policy-enabled \ --policy-document file://policy.txt ``` Inhalt von `policy.txt`: ``` permit(principal,action,resource) when { context.identity.groups.contains("finance") && context.identity.email.verified == true }; ``` Ausgabe: ``` { "PolicyEnabled": true, "PolicyDocument": "permit(principal,action,resource)\nwhen {\n context.identity.groups.contains(\"finance\") &&\n context.identity.email_verified == true\n};" } ``` Weitere Informationen finden Sie unter [Verified-Access-Richtlinien](https://docs.aws.amazon.com/verified-access/latest/ug/auth-policies.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [ModifyVerifiedAccessEndpointPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-verified-access-endpoint-policy.html)in der *AWS CLI Befehlsreferenz*. ### `modify-verified-access-endpoint` Das folgende Codebeispiel zeigt die Verwendung`modify-verified-access-endpoint`. **AWS CLI** **So ändern Sie die Konfiguration eines verifizierten Zugriffsendpunkts** Im folgenden Beispiel für `modify-verified-access-endpoint` wird dem angegebenen verifizierten Zugriffsendpunkt die spezifizierte Beschreibung hinzugefügt. ``` aws ec2 modify-verified-access-endpoint \ --verified-access-endpoint-id vae-066fac616d4d546f2 \ --description 'Testing Verified Access' ``` Ausgabe: ``` { "VerifiedAccessEndpoint": { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235", "VerifiedAccessEndpointId": "vae-066fac616d4d546f2", "ApplicationDomain": "example.com", "EndpointType": "network-interface", "AttachmentType": "vpc", "DomainCertificateArn": "arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE", "EndpointDomain": "my-ava-app.edge-00c3372d53b1540bb.vai-0ce000c0b7643abea.prod.verified-access.us-east-2.amazonaws.com", "SecurityGroupIds": [ "sg-004915970c4c8f13a" ], "NetworkInterfaceOptions": { "NetworkInterfaceId": "eni-0aec70418c8d87a0f", "Protocol": "https", "Port": 443 }, "Status": { "Code": "updating" }, "Description": "Testing Verified Access", "CreationTime": "2023-08-25T20:54:43", "LastUpdatedTime": "2023-08-25T22:46:32" } } ``` Weitere Informationen finden Sie unter [Verified-Access-Endpunkte](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-endpoints.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [ModifyVerifiedAccessEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-verified-access-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `modify-verified-access-group-policy` Das folgende Codebeispiel zeigt die Verwendung`modify-verified-access-group-policy`. **AWS CLI** **So konfigurieren Sie eine verifizierte Zugriffsrichtlinie für eine Gruppe** Im folgenden Beispiel für `modify-verified-access-group-policy` wird der angegebenen verifizierten Zugriffsgruppe die verifizierte festgelegte verifizierte Zugriffsrichtlinie hinzugefügt. ``` aws ec2 modify-verified-access-group-policy \ --verified-access-group-id vagr-0dbe967baf14b7235 \ --policy-enabled \ --policy-document file://policy.txt ``` Inhalt von `policy.txt`: ``` permit(principal,action,resource) when { context.identity.groups.contains("finance") && context.identity.email.verified == true }; ``` Ausgabe: ``` { "PolicyEnabled": true, "PolicyDocument": "permit(principal,action,resource)\nwhen {\n context.identity.groups.contains(\"finance\") &&\n context.identity.email_verified == true\n};" } ``` Weitere Informationen finden Sie unter [Verified-Access-Gruppen](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-groups.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [ModifyVerifiedAccessGroupPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-verified-access-group-policy.html)in der *AWS CLI Befehlsreferenz*. ### `modify-verified-access-group` Das folgende Codebeispiel zeigt die Verwendung`modify-verified-access-group`. **AWS CLI** **So ändern Sie die Konfiguration einer verifizierten Zugriffsgruppe** Im folgenden Beispiel für `modify-verified-access-group` wird der angegebenen verifizierten Zugriffsgruppe die spezifizierte Beschreibung hinzugefügt. ``` aws ec2 modify-verified-access-group \ --verified-access-group-id vagr-0dbe967baf14b7235 \ --description "Testing Verified Access" ``` Ausgabe: ``` { "VerifiedAccessGroup": { "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235", "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "Testing Verified Access", "Owner": "123456789012", "VerifiedAccessGroupArn": "arn:aws:ec2:us-east-2:123456789012:verified-access-group/vagr-0dbe967baf14b7235", "CreationTime": "2023-08-25T19:55:19", "LastUpdatedTime": "2023-08-25T22:17:25" } } ``` Weitere Informationen finden Sie unter [Verified-Access-Gruppen](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-groups.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [ModifyVerifiedAccessGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-verified-access-group.html)in der *AWS CLI Befehlsreferenz*. ### `modify-verified-access-instance-logging-configuration` Das folgende Codebeispiel zeigt die Verwendung`modify-verified-access-instance-logging-configuration`. **AWS CLI** **So aktivieren Sie die Protokollierung für eine verifizierte Zugriffs-Instance** Im folgenden Beispiel für `modify-verified-access-instance-logging-configuration` wird die Zugriffsprotokollierung für die angegebene verifizierte Zugriffs-Instance aktiviert. Die Protokolle werden an die angegebene Protokollgruppe „ CloudWatch Protokolle“ übermittelt. ``` aws ec2 modify-verified-access-instance-logging-configuration \ --verified-access-instance-id vai-0ce000c0b7643abea \ --access-logs CloudWatchLogs={Enabled=true,LogGroup=my-log-group} ``` Ausgabe: ``` { "LoggingConfiguration": { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "AccessLogs": { "S3": { "Enabled": false }, "CloudWatchLogs": { "Enabled": true, "DeliveryStatus": { "Code": "success" }, "LogGroup": "my-log-group" }, "KinesisDataFirehose": { "Enabled": false }, "LogVersion": "ocsf-1.0.0-rc.2", "IncludeTrustContext": false } } } ``` Weitere Informationen finden Sie unter [Verified-Access-Protokolle](https://docs.aws.amazon.com/verified-access/latest/ug/access-logs.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [ModifyVerifiedAccessInstanceLoggingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-verified-access-instance-logging-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `modify-verified-access-instance` Das folgende Codebeispiel zeigt die Verwendung`modify-verified-access-instance`. **AWS CLI** **So ändern Sie die Konfiguration einer verifizierten Zugriffs-Instance** Im folgenden Beispiel für `modify-verified-access-instance` wird der angegebenen verifizierten Zugriffs-Instance die spezifizierte Beschreibung hinzugefügt. ``` aws ec2 modify-verified-access-instance \ --verified-access-instance-id vai-0ce000c0b7643abea \ --description "Testing Verified Access" ``` Ausgabe: ``` { "VerifiedAccessInstance": { "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea", "Description": "Testing Verified Access", "VerifiedAccessTrustProviders": [ { "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7", "TrustProviderType": "user", "UserTrustProviderType": "iam-identity-center" } ], "CreationTime": "2023-08-25T18:27:56", "LastUpdatedTime": "2023-08-25T22:41:04" } } ``` Weitere Informationen finden Sie unter [Verified-Access-Instances](https://docs.aws.amazon.com/verified-access/latest/ug/verified-access-instances.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [ModifyVerifiedAccessInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-verified-access-instance.html)in der *AWS CLI Befehlsreferenz*. ### `modify-verified-access-trust-provider` Das folgende Codebeispiel zeigt die Verwendung`modify-verified-access-trust-provider`. **AWS CLI** **So ändern Sie die Konfiguration eines Vertrauensanbieters für verifizierten Zugriff** Im folgenden Beispiel für `modify-verified-access-trust-provider` wird dem angegebenen Vertrauensanbieter für verifizierten Zugriff die spezifizierte Beschreibung hinzugefügt. ``` aws ec2 modify-verified-access-trust-provider \ --verified-access-trust-provider-id vatp-0bb32de759a3e19e7 \ --description "Testing Verified Access" ``` Ausgabe: ``` { "VerifiedAccessTrustProvider": { "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7", "Description": "Testing Verified Access", "TrustProviderType": "user", "UserTrustProviderType": "iam-identity-center", "PolicyReferenceName": "idc", "CreationTime": "2023-08-25T19:00:38", "LastUpdatedTime": "2023-08-25T19:18:21" } } ``` Weitere Informationen finden Sie unter [Vertrauensanbieter für Verified Access](https://docs.aws.amazon.com/verified-access/latest/ug/trust-providers.html) im *Benutzerhandbuch für AWS Verified Access*. + Einzelheiten zur API finden Sie [ModifyVerifiedAccessTrustProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-verified-access-trust-provider.html)in der *AWS CLI Befehlsreferenz*. ### `modify-volume-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-volume-attribute`. **AWS CLI** **So ändern Sie ein Volume-Attribut** In diesem Beispiel wird das `autoEnableIo`-Attribut des Volumes mit der ID `vol-1234567890abcdef0` auf `true` festgelegt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 modify-volume-attribute --volume-id vol-1234567890abcdef0 --auto-enable-io ``` + Einzelheiten zur API finden Sie [ModifyVolumeAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-volume-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `modify-volume` Das folgende Codebeispiel zeigt die Verwendung`modify-volume`. **AWS CLI** **Beispiel 1: So ändern Sie ein Volume, indem Sie seine Größe modifizieren** Im folgenden Beispiel für `modify-volume` wird die Größe des angegebenen Volumes in 150 GB geändert. Befehl: ``` aws ec2 modify-volume --size 150 --volume-id vol-1234567890abcdef0 ``` Ausgabe: ``` { "VolumeModification": { "TargetSize": 150, "TargetVolumeType": "io1", "ModificationState": "modifying", "VolumeId": " vol-1234567890abcdef0", "TargetIops": 100, "StartTime": "2019-05-17T11:27:19.000Z", "Progress": 0, "OriginalVolumeType": "io1", "OriginalIops": 100, "OriginalSize": 100 } } ``` **Beispiel 2: So ändern Sie ein Volume, indem Sie Typ, Größe und IOPS-Wert modifizieren** Im folgenden Beispiel für `modify-volume` wird der Volume-Typ in bereitgestellte IOPS SSD geändert, die Ziel-IOPS-Rate auf 10 000 und die Volume-Größe auf 350 GB festgelegt. ``` aws ec2 modify-volume \ --volume-type io1 \ --iops 10000 \ --size 350 \ --volume-id vol-1234567890abcdef0 ``` Ausgabe: ``` { "VolumeModification": { "TargetSize": 350, "TargetVolumeType": "io1", "ModificationState": "modifying", "VolumeId": "vol-0721c1a9d08c93bf6", "TargetIops": 10000, "StartTime": "2019-05-17T11:38:57.000Z", "Progress": 0, "OriginalVolumeType": "gp2", "OriginalIops": 150, "OriginalSize": 50 } } ``` + Einzelheiten zur API finden Sie [ModifyVolume](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-volume.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpc-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-vpc-attribute`. **AWS CLI** **Um das enableDnsSupport Attribut zu ändern** In diesem Beispiel wird das `enableDnsSupport`-Attribut geändert. Dieses Attribut gibt an, ob für die VPC die DNS-Auflösung aktiviert ist. Wenn dieses Attribut `true` ist, löst der Amazon-DNS-Server die DNS-Hostnamen der Instances in die entsprechenden IP-Adressen auf. Andernfalls geschieht das nicht. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 modify-vpc-attribute --vpc-id vpc-a01106c2 --enable-dns-support "{\"Value\":false}" ``` **Um das enableDnsHostnames Attribut zu ändern** In diesem Beispiel wird das `enableDnsHostnames`-Attribut geändert. Dieses Attribut gibt an, ob in der VPC gestartete Instances DNS-Hostnamen erhalten. Wenn dieses Attribut `true` ist, erhalten die Instances in der VPC DNS-Hostnamen. Andernfalls ist das nicht der Fall. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 modify-vpc-attribute --vpc-id vpc-a01106c2 --enable-dns-hostnames "{\"Value\":false}" ``` + Einzelheiten zur API finden Sie [ModifyVpcAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpc-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpc-endpoint-connection-notification` Das folgende Codebeispiel zeigt die Verwendung`modify-vpc-endpoint-connection-notification`. **AWS CLI** **So ändern Sie eine Endpunkt-Verbindungsbenachrichtigung** In diesem Beispiel wird das SNS-Thema für die angegebene Endpunkt-Verbindungsbenachrichtigung geändert. Befehl: ``` aws ec2 modify-vpc-endpoint-connection-notification --connection-notification-id vpce-nfn-008776de7e03f5abc --connection-events Accept Reject --connection-notification-arn arn:aws:sns:us-east-2:123456789012:mytopic ``` Ausgabe: ``` { "ReturnValue": true } ``` + Einzelheiten zur API finden Sie [ModifyVpcEndpointConnectionNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpc-endpoint-connection-notification.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpc-endpoint-service-configuration` Das folgende Codebeispiel zeigt die Verwendung`modify-vpc-endpoint-service-configuration`. **AWS CLI** **So ändern Sie eine Endpunktservice-Konfiguration** In diesem Beispiel wird die Akzeptanzanforderung für den angegebenen Endpunktservice geändert. Befehl: ``` aws ec2 modify-vpc-endpoint-service-configuration --service-id vpce-svc-09222513e6e77dc86 --no-acceptance-required ``` Ausgabe: ``` { "ReturnValue": true } ``` + Einzelheiten zur API finden Sie [ModifyVpcEndpointServiceConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpc-endpoint-service-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpc-endpoint-service-payer-responsibility` Das folgende Codebeispiel zeigt die Verwendung`modify-vpc-endpoint-service-payer-responsibility`. **AWS CLI** **So ändern Sie die Verantwortung des Zahlers** Im folgenden Beispiel für `modify-vpc-endpoint-service-payer-responsibility` wird die Verantwortung des Zahlers für den angegebenen Endpunktservice geändert. ``` aws ec2 modify-vpc-endpoint-service-payer-responsibility \ --service-id vpce-svc-071afff70666e61e0 \ --payer-responsibility ServiceOwner ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [ModifyVpcEndpointServicePayerResponsibility](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpc-endpoint-service-payer-responsibility.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpc-endpoint-service-permissions` Das folgende Codebeispiel zeigt die Verwendung`modify-vpc-endpoint-service-permissions`. **AWS CLI** **So ändern Sie die Berechtigungen des Endpunktservice** In diesem Beispiel wird einem AWS Konto die Berechtigung hinzugefügt, eine Verbindung mit dem angegebenen Endpunktdienst herzustellen. Befehl: ``` aws ec2 modify-vpc-endpoint-service-permissions --service-id vpce-svc-03d5ebb7d9579a2b3 --add-allowed-principals '["arn:aws:iam::123456789012:root"]' ``` Ausgabe: ``` { "ReturnValue": true } ``` In diesem Beispiel wird einem bestimmten IAM-Benutzer (`admin`) die Berechtigung hinzugefügt, eine Verbindung mit dem angegebenen Endpunktservice herzustellen. Befehl: ``` aws ec2 modify-vpc-endpoint-service-permissions --service-id vpce-svc-03d5ebb7d9579a2b3 --add-allowed-principals '["arn:aws:iam::123456789012:user/admin"]' ``` + Einzelheiten zur API finden Sie [ModifyVpcEndpointServicePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpc-endpoint-service-permissions.html)unter *AWS CLI Befehlsreferenz*. ### `modify-vpc-endpoint` Das folgende Codebeispiel zeigt die Verwendung`modify-vpc-endpoint`. **AWS CLI** **So ändern Sie einen Gateway-Endpunkt** In diesem Beispiel wird der Gateway-Endpunkt `vpce-1a2b3c4d` geändert, indem dem Endpunkt die Routing-Tabelle `rtb-aaa222bb` zugeordnet und das Richtliniendokument zurückgesetzt wird. Befehl: ``` aws ec2 modify-vpc-endpoint --vpc-endpoint-id vpce-1a2b3c4d --add-route-table-ids rtb-aaa222bb --reset-policy ``` Ausgabe: ``` { "Return": true } ``` **So ändern Sie einen Schnittstellenendpunkt** In diesem Beispiel wird der Schnittstellenendpunkt `vpce-0fe5b17a0707d6fa5` geändert, indem dem Endpunkt das Subnetz `subnet-d6fcaa8d` hinzugefügt wird. Befehl: ``` aws ec2 modify-vpc-endpoint --vpc-endpoint-id vpce-0fe5b17a0707d6fa5 --add-subnet-id subnet-d6fcaa8d ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [ModifyVpcEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpc-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpc-peering-connection-options` Das folgende Codebeispiel zeigt die Verwendung`modify-vpc-peering-connection-options`. **AWS CLI** **Um die Kommunikation über eine VPC-Peering-Verbindung von Ihrer lokalen Verbindung aus zu aktivieren ClassicLink ** In diesem Beispiel ändert der Besitzer der anfordernden VPC für eine Peering-Verbindung `pcx-aaaabbb` die VPC-Peering-Verbindungsoptionen, sodass eine lokale ClassicLink Verbindung mit der Peer-VPC kommunizieren kann. Befehl: ``` aws ec2 modify-vpc-peering-connection-options --vpc-peering-connection-id pcx-aaaabbbb --requester-peering-connection-options AllowEgressFromLocalClassicLinkToRemoteVpc=true ``` Ausgabe: ``` { "RequesterPeeringConnectionOptions": { "AllowEgressFromLocalClassicLinkToRemoteVpc": true } } ``` **Um die Kommunikation über eine VPC-Peering-Verbindung von Ihrer lokalen VPC zu einer Remoteverbindung zu ermöglichen ClassicLink ** In diesem Beispiel ändert der Besitzer der Akzepter-VPC die VPC-Peering-Verbindungsoptionen, sodass die lokale VPC mit der Verbindung in der Peer-VPC kommunizieren kann. ClassicLink Befehl: ``` aws ec2 modify-vpc-peering-connection-options --vpc-peering-connection-id pcx-aaaabbbb --accepter-peering-connection-options AllowEgressFromLocalVpcToRemoteClassicLink=true ``` Ausgabe: ``` { "AccepterPeeringConnectionOptions": { "AllowEgressFromLocalVpcToRemoteClassicLink": true } } ``` **So aktivieren Sie die DNS-Auflösungsunterstützung für die VPC-Peering-Verbindung** In diesem Beispiel ändert der Besitzer der anfordernden VPC die Optionen der VPC-Peering-Verbindung für `pcx-aaaabbbb` so, dass die lokale VPC öffentliche DNS-Hostnamen in private IP-Adressen auflösen kann, wenn dies von Instances in der Peer-VPC angefordert wird. Befehl: ``` aws ec2 modify-vpc-peering-connection-options --vpc-peering-connection-id pcx-aaaabbbb --requester-peering-connection-options AllowDnsResolutionFromRemoteVpc=true ``` Ausgabe: ``` { "RequesterPeeringConnectionOptions": { "AllowDnsResolutionFromRemoteVpc": true } } ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [ModifyVpcPeeringConnectionOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpc-peering-connection-options.html)AWS CLI * ### `modify-vpc-tenancy` Das folgende Codebeispiel zeigt die Verwendung`modify-vpc-tenancy`. **AWS CLI** **So ändern Sie die Tenancy einer VPC** In diesem Beispiel wird die Tenancy der VPC `vpc-1a2b3c4d` in `default` geändert. Befehl: ``` aws ec2 modify-vpc-tenancy --vpc-id vpc-1a2b3c4d --instance-tenancy default ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [ModifyVpcTenancy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpc-tenancy.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpn-connection-options` Das folgende Codebeispiel zeigt die Verwendung`modify-vpn-connection-options`. **AWS CLI** **So ändern Sie Ihre VPN-Verbindungsoptionen** Im folgenden `modify-vpn-connection-options` Beispiel wird der lokale IPv4 CIDR auf der Kunden-Gateway-Seite der angegebenen VPN-Verbindung geändert. ``` aws ec2 modify-vpn-connection-options \ --vpn-connection-id vpn-1122334455aabbccd \ --local-ipv4-network-cidr 10.0.0.0/16 ``` Ausgabe: ``` { "VpnConnections": [ { "CustomerGatewayConfiguration": "...configuration information...", "CustomerGatewayId": "cgw-01234567abcde1234", "Category": "VPN", "State": "modifying", "Type": "ipsec.1", "VpnConnectionId": "vpn-1122334455aabbccd", "TransitGatewayId": "tgw-00112233445566aab", "Options": { "EnableAcceleration": false, "StaticRoutesOnly": true, "LocalIpv4NetworkCidr": "10.0.0.0/16", "RemoteIpv4NetworkCidr": "0.0.0.0/0", "TunnelInsideIpVersion": "ipv4" }, "Routes": [], "Tags": [ { "Key": "Name", "Value": "CanadaVPN" } ], "VgwTelemetry": [ { "AcceptedRouteCount": 0, "LastStatusChange": "2020-07-29T10:35:11.000Z", "OutsideIpAddress": "203.0.113.3", "Status": "DOWN", "StatusMessage": "" }, { "AcceptedRouteCount": 0, "LastStatusChange": "2020-09-02T09:09:33.000Z", "OutsideIpAddress": "203.0.113.5", "Status": "UP", "StatusMessage": "" } ] } ] } ``` Weitere Informationen finden Sie im [ Site-to-Site*VPN-Benutzerhandbuch unter Ändern der AWS Site-to-Site VPN-Verbindungsoptionen*](https://docs.aws.amazon.com/vpn/latest/s2svpn/modify-vpn-connection-options.html). + Einzelheiten zur API finden Sie [ModifyVpnConnectionOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpn-connection-options.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpn-connection` Das folgende Codebeispiel zeigt die Verwendung`modify-vpn-connection`. **AWS CLI** **So ändern Sie eine VPN-Verbindung** Im folgenden Beispiel für `modify-vpn-connection` wird das Ziel-Gateway für die VPN-Verbindung `vpn-12345678901234567` in ein Virtual Private Gateway `vgw-11223344556677889` geändert: ``` aws ec2 modify-vpn-connection \ --vpn-connection-id vpn-12345678901234567 \ --vpn-gateway-id vgw-11223344556677889 ``` Ausgabe: ``` { "VpnConnection": { "CustomerGatewayConfiguration": "...configuration information...", "CustomerGatewayId": "cgw-aabbccddee1122334", "Category": "VPN", "State": "modifying", "Type": "ipsec.1", "VpnConnectionId": "vpn-12345678901234567", "VpnGatewayId": "vgw-11223344556677889", "Options": { "StaticRoutesOnly": false }, "VgwTelemetry": [ { "AcceptedRouteCount": 0, "LastStatusChange": "2019-07-17T07:34:00.000Z", "OutsideIpAddress": "18.210.3.222", "Status": "DOWN", "StatusMessage": "IPSEC IS DOWN" }, { "AcceptedRouteCount": 0, "LastStatusChange": "2019-07-20T21:20:16.000Z", "OutsideIpAddress": "34.193.129.33", "Status": "DOWN", "StatusMessage": "IPSEC IS DOWN" } ] } } ``` + Einzelheiten zur API finden Sie [ModifyVpnConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpn-connection.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpn-tunnel-certificate` Das folgende Codebeispiel zeigt die Verwendung`modify-vpn-tunnel-certificate`. **AWS CLI** **So rotieren Sie ein VPN-Tunnelzertifikat** Im folgenden Beispiel für `modify-vpn-tunnel-certificate` wird das Zertifikat für den angegebenen Tunnel für eine VPN-Verbindung rotiert. ``` aws ec2 modify-vpn-tunnel-certificate \ --vpn-tunnel-outside-ip-address 203.0.113.17 \ --vpn-connection-id vpn-12345678901234567 ``` Ausgabe: ``` { "VpnConnection": { "CustomerGatewayConfiguration": ...configuration information..., "CustomerGatewayId": "cgw-aabbccddee1122334", "Category": "VPN", "State": "modifying", "Type": "ipsec.1", "VpnConnectionId": "vpn-12345678901234567", "VpnGatewayId": "vgw-11223344556677889", "Options": { "StaticRoutesOnly": false }, "VgwTelemetry": [ { "AcceptedRouteCount": 0, "LastStatusChange": "2019-09-11T17:27:14.000Z", "OutsideIpAddress": "203.0.113.17", "Status": "DOWN", "StatusMessage": "IPSEC IS DOWN", "CertificateArn": "arn:aws:acm:us-east-1:123456789101:certificate/c544d8ce-20b8-4fff-98b0-example" }, { "AcceptedRouteCount": 0, "LastStatusChange": "2019-09-11T17:26:47.000Z", "OutsideIpAddress": "203.0.114.18", "Status": "DOWN", "StatusMessage": "IPSEC IS DOWN", "CertificateArn": "arn:aws:acm:us-east-1:123456789101:certificate/5ab64566-761b-4ad3-b259-example" } ] } } ``` + Einzelheiten zur API finden Sie [ModifyVpnTunnelCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpn-tunnel-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `modify-vpn-tunnel-options` Das folgende Codebeispiel zeigt die Verwendung`modify-vpn-tunnel-options`. **AWS CLI** **So ändern Sie die Tunnel-Optionen für eine VPN-Verbindung** Im folgenden Beispiel für `modify-vpn-tunnel-options` werden die Diffie-Hellman-Gruppen aktualisiert, die für den angegebenen Tunnel und die VPN-Verbindung zulässig sind. ``` aws ec2 modify-vpn-tunnel-options \ --vpn-connection-id vpn-12345678901234567 \ --vpn-tunnel-outside-ip-address 203.0.113.17 \ --tunnel-options Phase1DHGroupNumbers=[{Value=14},{Value=15},{Value=16},{Value=17},{Value=18}],Phase2DHGroupNumbers=[{Value=14},{Value=15},{Value=16},{Value=17},{Value=18}] ``` Ausgabe: ``` { "VpnConnection": { "CustomerGatewayConfiguration": "...configuration information...", "CustomerGatewayId": "cgw-aabbccddee1122334", "Category": "VPN", "State": "available", "Type": "ipsec.1", "VpnConnectionId": "vpn-12345678901234567", "VpnGatewayId": "vgw-11223344556677889", "Options": { "StaticRoutesOnly": false, "TunnelOptions": [ { "OutsideIpAddress": "203.0.113.17", "Phase1DHGroupNumbers": [ { "Value": 14 }, { "Value": 15 }, { "Value": 16 }, { "Value": 17 }, { "Value": 18 } ], "Phase2DHGroupNumbers": [ { "Value": 14 }, { "Value": 15 }, { "Value": 16 }, { "Value": 17 }, { "Value": 18 } ] }, { "OutsideIpAddress": "203.0.114.19" } ] }, "VgwTelemetry": [ { "AcceptedRouteCount": 0, "LastStatusChange": "2019-09-10T21:56:54.000Z", "OutsideIpAddress": "203.0.113.17", "Status": "DOWN", "StatusMessage": "IPSEC IS DOWN" }, { "AcceptedRouteCount": 0, "LastStatusChange": "2019-09-10T21:56:43.000Z", "OutsideIpAddress": "203.0.114.19", "Status": "DOWN", "StatusMessage": "IPSEC IS DOWN" } ] } } ``` + Einzelheiten zur API finden Sie [ModifyVpnTunnelOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-vpn-tunnel-options.html)in der *AWS CLI Befehlsreferenz*. ### `monitor-instances` Das folgende Codebeispiel zeigt die Verwendung`monitor-instances`. **AWS CLI** **So aktivieren Sie eine detaillierte Überwachung für eine Instance** Dieser Beispielbefehl aktiviert die detaillierte Überwachung für die angegebene Instance. Befehl: ``` aws ec2 monitor-instances --instance-ids i-1234567890abcdef0 ``` Ausgabe: ``` { "InstanceMonitorings": [ { "InstanceId": "i-1234567890abcdef0", "Monitoring": { "State": "pending" } } ] } ``` + Einzelheiten zur API finden Sie [MonitorInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/monitor-instances.html)in der *AWS CLI Befehlsreferenz*. ### `move-address-to-vpc` Das folgende Codebeispiel zeigt die Verwendung`move-address-to-vpc`. **AWS CLI** **So verschieben Sie eine Adresse zur EC2-VPC** In diesem Beispiel wird die Elastic-IP-Adresse 54.123.4.56 auf die EC2-VPC-Plattform verschoben. Befehl: ``` aws ec2 move-address-to-vpc --public-ip 54.123.4.56 ``` Ausgabe: ``` { "Status": "MoveInProgress" } ``` + Einzelheiten zur API finden Sie [MoveAddressToVpc](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/move-address-to-vpc.html)in der *AWS CLI Befehlsreferenz*. ### `move-byoip-cidr-to-ipam` Das folgende Codebeispiel zeigt die Verwendung`move-byoip-cidr-to-ipam`. **AWS CLI** **So übertragen Sie ein BYOIP-CIDR an IPAM** Im folgenden Beispiel für `move-byoip-cidr-to-ipam` wird ein BYOIP-CIDR an IPAM übertragen. (Linux) ``` aws ec2 move-byoip-cidr-to-ipam \ --region us-west-2 \ --ipam-pool-id ipam-pool-0a03d430ca3f5c035 \ --ipam-pool-owner 111111111111 \ --cidr 130.137.249.0/24 ``` (Windows) ``` aws ec2 move-byoip-cidr-to-ipam ^ --region us-west-2 ^ --ipam-pool-id ipam-pool-0a03d430ca3f5c035 ^ --ipam-pool-owner 111111111111 ^ --cidr 130.137.249.0/24 ``` Ausgabe: ``` { "ByoipCidr": { "Cidr": "130.137.249.0/24", "State": "pending-transfer" } } ``` Weitere Informationen finden Sie unter [Tutorial: Transfer a existing BYOIP IPv4 CIDR to IPAM im *Amazon VPC* IPAM-Benutzerhandbuch](https://docs.aws.amazon.com/vpc/latest/ipam/tutorials-byoip-ipam-transfer-ipv4.html). + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [MoveByoipCidrToIpam](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/move-byoip-cidr-to-ipam.html)AWS CLI * ### `network-insights-access-scope` Das folgende Codebeispiel zeigt die Verwendung`network-insights-access-scope`. **AWS CLI** **So erstellen Sie Zugriffsbereiche von Network Insights** Im folgenden `create-network-insights-access-scope` Beispiel wird ein Network Insights-Zugriffsbereich in Ihrem AWS Konto erstellt. ``` aws ec2 create-network-insights-access-scope \ --cli-input-json file://access-scope-file.json ``` Inhalt von `access-scope-file.json`: ``` { { "MatchPaths": [ { "Source": { "ResourceStatement": { "Resources": [ "vpc-abcd12e3" ] } } } ], "ExcludePaths": [ { "Source": { "ResourceStatement": { "ResourceTypes": [ "AWS::EC2::InternetGateway" ] } } } ] } } ``` Ausgabe: ``` { "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789111" }{ "NetworkInsightsAccessScope": { "NetworkInsightsAccessScopeId": "nis-123456789222", "NetworkInsightsAccessScopeArn": "arn:aws:ec2:us-east-1:123456789222:network-insights-access-scope/nis-123456789222", "CreatedDate": "2022-01-25T19:20:28.796000+00:00", "UpdatedDate": "2022-01-25T19:20:28.797000+00:00" }, "NetworkInsightsAccessScopeContent": { "NetworkInsightsAccessScopeId": "nis-04c0c0fbca737c404", "MatchPaths": [ { "Source": { "ResourceStatement": { "Resources": [ "vpc-abcd12e3" ] } } } ], "ExcludePaths": [ { "Source": { "ResourceStatement": { "ResourceTypes": [ "AWS::EC2::InternetGateway" ] } } } ] } } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Network Access Analyzer using the AWS CLI](https://docs.aws.amazon.com/vpc/latest/network-access-analyzer/getting-started-cli-naa.html) im *Network Access Analyzer-Handbuch*. + Einzelheiten zur API finden Sie [NetworkInsightsAccessScope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/network-insights-access-scope.html)unter *AWS CLI Befehlsreferenz*. ### `provision-byoip-cidr` Das folgende Codebeispiel zeigt die Verwendung`provision-byoip-cidr`. **AWS CLI** **So stellen Sie einen Adressbereich bereit** Das folgende `provision-byoip-cidr` Beispiel stellt einen öffentlichen IP-Adressbereich zur Verwendung mit bereit AWS. ``` aws ec2 provision-byoip-cidr \ --cidr 203.0.113.25/24 \ --cidr-authorization-context Message="$text_message",Signature="$signed_message" ``` Ausgabe: ``` { "ByoipCidr": { "Cidr": "203.0.113.25/24", "State": "pending-provision" } } ``` Weitere Informationen zum Erstellen der Nachrichtenzeichenfolgen für den Autorisierungskontext finden Sie unter [Verwenden eigener IP-Adressen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [ProvisionByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/provision-byoip-cidr.html)unter *AWS CLI Befehlsreferenz*. ### `provision-ipam-pool-cidr` Das folgende Codebeispiel zeigt die Verwendung`provision-ipam-pool-cidr`. **AWS CLI** **So stellen Sie ein CIDR für einen IPAM-Pool bereit** Im folgenden Beispiel für `provision-ipam-pool-cidr` wird ein CIDR für einen IPAM-Pool bereitgestellt. (Linux) ``` aws ec2 provision-ipam-pool-cidr \ --ipam-pool-id ipam-pool-0533048da7d823723 \ --cidr 10.0.0.0/24 ``` (Windows) ``` aws ec2 provision-ipam-pool-cidr ^ --ipam-pool-id ipam-pool-0533048da7d823723 ^ --cidr 10.0.0.0/24 ``` Ausgabe: ``` { "IpamPoolCidr": { "Cidr": "10.0.0.0/24", "State": "pending-provision" } } ``` Weitere Informationen finden Sie unter [Bereitstellung CIDRs für einen Pool](https://docs.aws.amazon.com/vpc/latest/ipam/prov-cidr-ipam.html) im *Amazon VPC IPAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ProvisionIpamPoolCidr AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/provision-ipam-pool-cidr.html)*Befehlsreferenz*. ### `purchase-host-reservation` Das folgende Codebeispiel zeigt die Verwendung`purchase-host-reservation`. **AWS CLI** **So erwerben Sie eine Dedicated-Host-Reservierung** In diesem Beispiel wird die angebotene Dedicated-Host-Reservierung für den festgelegten Dedicated Host in Ihrem Konto erworben. Befehl: ``` aws ec2 purchase-host-reservation --offering-id hro-03f707bf363b6b324 --host-id-set h-013abcd2a00cbd123 ``` Ausgabe: ``` { "TotalHourlyPrice": "1.499", "Purchase": [ { "HourlyPrice": "1.499", "InstanceFamily": "m4", "PaymentOption": "NoUpfront", "HostIdSet": [ "h-013abcd2a00cbd123" ], "HostReservationId": "hr-0d418a3a4ffc669ae", "UpfrontPrice": "0.000", "Duration": 31536000 } ], "TotalUpfrontPrice": "0.000" } ``` + Einzelheiten zur API finden Sie [PurchaseHostReservation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/purchase-host-reservation.html)in der *AWS CLI Befehlsreferenz*. ### `purchase-reserved-instances-offering` Das folgende Codebeispiel zeigt die Verwendung`purchase-reserved-instances-offering`. **AWS CLI** **So kaufen Sie ein Angebot für eine Reserved Instance** Dieser Beispielbefehl veranschaulicht den Kauf eines Reserved-Instance-Angebots, wobei eine Angebots-ID und die Anzahl der Instances angegeben werden. Befehl: ``` aws ec2 purchase-reserved-instances-offering --reserved-instances-offering-id ec06327e-dd07-46ee-9398-75b5fexample --instance-count 3 ``` Ausgabe: ``` { "ReservedInstancesId": "af9f760e-6f91-4559-85f7-4980eexample" } ``` + Einzelheiten zur API finden Sie [PurchaseReservedInstancesOffering](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/purchase-reserved-instances-offering.html)in der *AWS CLI Befehlsreferenz*. ### `purchase-scheduled-instances` Das folgende Codebeispiel zeigt die Verwendung`purchase-scheduled-instances`. **AWS CLI** **Um eine Scheduled Instance zu kaufen** In diesem Beispiel wird eine geplante Instance gekauft. Befehl: ``` aws ec2 purchase-scheduled-instances --purchase-requests file://purchase-request.json ``` Purchase-request.json: ``` [ { "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi...", "InstanceCount": 1 } ] ``` Ausgabe: ``` { "ScheduledInstanceSet": [ { "AvailabilityZone": "us-west-2b", "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012", "HourlyPrice": "0.095", "CreateDate": "2016-01-25T21:43:38.612Z", "Recurrence": { "OccurrenceDaySet": [ 1 ], "Interval": 1, "Frequency": "Weekly", "OccurrenceRelativeToEnd": false, "OccurrenceUnit": "" }, "Platform": "Linux/UNIX", "TermEndDate": "2017-01-31T09:00:00Z", "InstanceCount": 1, "SlotDurationInHours": 32, "TermStartDate": "2016-01-31T09:00:00Z", "NetworkPlatform": "EC2-VPC", "TotalScheduledInstanceHours": 1696, "NextSlotStartTime": "2016-01-31T09:00:00Z", "InstanceType": "c4.large" } ] } ``` + Einzelheiten zur API finden Sie [PurchaseScheduledInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/purchase-scheduled-instances.html)in der *AWS CLI Befehlsreferenz*. ### `reboot-instances` Das folgende Codebeispiel zeigt die Verwendung`reboot-instances`. **AWS CLI** **So starten Sie eine Amazon-EC2-Instance neu** In diesem Beispiel wird die angegebene Instance neu gestartet. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 reboot-instances --instance-ids i-1234567890abcdef5 ``` Weitere Informationen finden Sie unter Ihre Instance neu starten im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie [RebootInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reboot-instances.html)in der *AWS CLI Befehlsreferenz*. ### `register-image` Das folgende Codebeispiel zeigt die Verwendung`register-image`. **AWS CLI** **Beispiel 1: So registrieren Sie ein AMI mithilfe einer Manifestdatei** Im folgenden Beispiel für `register-image` wird ein AMI mithilfe der angegebenen Manifestdatei in Amazon S3 registriert. ``` aws ec2 register-image \ --name my-image \ --image-location amzn-s3-demo-bucket/myimage/image.manifest.xml ``` Ausgabe: ``` { "ImageId": "ami-1234567890EXAMPLE" } ``` Weitere Informationen dazu finden Sie unter [Amazon Machine Images (AMI)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So registrieren Sie ein AMI mithilfe eines Snapshots eines Root-Geräts** Im folgenden Beispiel für `register-image` wird ein AMI mit dem angegebenen Snapshot eines EBS-Stamm-Volumes als Gerät `/dev/xvda` registriert. Die Blockgerät-Zuweisung umfasst auch ein leeres EBS-Volume von 100 GiB als Gerät `/dev/xvdf`. ``` aws ec2 register-image \ --name my-image \ --root-device-name /dev/xvda \ --block-device-mappings DeviceName=/dev/xvda,Ebs={SnapshotId=snap-0db2cf683925d191f} DeviceName=/dev/xvdf,Ebs={VolumeSize=100} ``` Ausgabe: ``` { "ImageId": "ami-1a2b3c4d5eEXAMPLE" } ``` Weitere Informationen dazu finden Sie unter [Amazon Machine Images (AMI)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [RegisterImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-image.html)in der *AWS CLI Befehlsreferenz*. ### `register-instance-event-notification-attributes` Das folgende Codebeispiel zeigt die Verwendung`register-instance-event-notification-attributes`. **AWS CLI** **Beispiel 1: So schließen Sie alle Tags in Ereignisbenachrichtigungen ein** Im folgenden Beispiel für `register-instance-event-notification-attributes` werden alle Tags in Ereignisbenachrichtigungen eingeschlossen. ``` aws ec2 register-instance-event-notification-attributes \ --instance-tag-attribute IncludeAllTagsOfInstance=true ``` Ausgabe: ``` { "InstanceTagAttribute": { "InstanceTagKeys": [], "IncludeAllTagsOfInstance": true } } ``` Weitere Informationen finden Sie unter [Geplante Ereignisse für Ihre Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-instances-status-check_sched.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So schließen Sie bestimmte Tags in Ereignisbenachrichtigungen ein** Im folgenden Beispiel für `register-instance-event-notification-attributes` werden die angegebenen Tags in Ereignisbenachrichtigungen eingeschlossen. Sie können keine Tags angeben, wenn `IncludeAllTagsOfInstance` `true` ist. ``` aws ec2 register-instance-event-notification-attributes \ --instance-tag-attribute InstanceTagKeys="tag-key1","tag-key2" ``` Ausgabe: ``` { "InstanceTagAttribute": { "InstanceTagKeys": [ "tag-key1", "tag-key2" ], "IncludeAllTagsOfInstance": false } } ``` Weitere Informationen finden Sie unter [Geplante Ereignisse für Ihre Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-instances-status-check_sched.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [RegisterInstanceEventNotificationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-instance-event-notification-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `register-transit-gateway-multicase-group-sources` Das folgende Codebeispiel zeigt die Verwendung`register-transit-gateway-multicase-group-sources`. **AWS CLI** **So registrieren Sie eine Quelle mit einer Multicast-Gruppe in Transit Gateway.** In folgendem Beispiel für `register-transit-gateway-multicast-group-sources` wird die angegebene Netzwerkschnittstellen-Gruppenquelle mit einer Multicast-Gruppe registriert. ``` aws ec2 register-transit-gateway-multicast-group-sources \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \ --group-ip-address 224.0.1.0 \ --network-interface-ids eni-07f290fc3c090cbae ``` Ausgabe: ``` { "RegisteredMulticastGroupSources": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597", "RegisteredNetworkInterfaceIds": [ "eni-07f290fc3c090cbae" ], "GroupIpAddress": "224.0.1.0" } } ``` Weitere Informationen finden Sie unter [Registrieren von Quellen bei einer Multicast-Gruppe](https://docs.aws.amazon.com/vpc/latest/tgw/working-with-multicast.html#add-source-multicast-group) im *Benutzerhandbuch für AWS Transit Gateway*. + Einzelheiten zur API finden Sie [RegisterTransitGatewayMulticaseGroupSources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-transit-gateway-multicase-group-sources.html)in der *AWS CLI Befehlsreferenz*. ### `register-transit-gateway-multicast-group-members` Das folgende Codebeispiel zeigt die Verwendung`register-transit-gateway-multicast-group-members`. **AWS CLI** **So zeigen Sie die Informationen zu den Multicast-Domain-Zuordnungen in Transit Gateway an** Im folgenden Beispiel für `register-transit-gateway-multicast-group-members` werden die Zuordnungen für die angegebene Multicast-Domain zurückgegeben. ``` aws ec2 register-transit-gateway-multicast-group-members \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \ --group-ip-address 224.0.1.0 \ --network-interface-ids eni-0e246d32695012e81 ``` Ausgabe: ``` { "RegisteredMulticastGroupMembers": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597", "RegisteredNetworkInterfaceIds": [ "eni-0e246d32695012e81" ], "GroupIpAddress": "224.0.1.0" } } ``` Weitere Informationen finden Sie unter [Multicast-Domains](https://docs.aws.amazon.com/vpc/latest/tgw/multicast-domains-about.html) im *Benutzerhandbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [RegisterTransitGatewayMulticastGroupMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-transit-gateway-multicast-group-members.html)in der *AWS CLI Befehlsreferenz*. ### `register-transit-gateway-multicast-group-sources` Das folgende Codebeispiel zeigt die Verwendung`register-transit-gateway-multicast-group-sources`. **AWS CLI** **So registrieren Sie eine Quelle mit einer Multicast-Gruppe in Transit Gateway.** In folgendem Beispiel für `register-transit-gateway-multicast-group-sources` wird die angegebene Netzwerkschnittstellen-Gruppenquelle mit einer Multicast-Gruppe registriert. ``` aws ec2 register-transit-gateway-multicast-group-sources \ --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \ --group-ip-address 224.0.1.0 \ --network-interface-ids eni-07f290fc3c090cbae ``` Ausgabe: ``` { "RegisteredMulticastGroupSources": { "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597", "RegisteredNetworkInterfaceIds": [ "eni-07f290fc3c090cbae" ], "GroupIpAddress": "224.0.1.0" } } ``` Weitere Informationen finden Sie unter [Multicast-Domains](https://docs.aws.amazon.com/vpc/latest/tgw/multicast-domains-about.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [RegisterTransitGatewayMulticastGroupSources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-transit-gateway-multicast-group-sources.html)in der *AWS CLI Befehlsreferenz*. ### `reject-transit-gateway-peering-attachment` Das folgende Codebeispiel zeigt die Verwendung`reject-transit-gateway-peering-attachment`. **AWS CLI** **So lehnen Sie einen Anhang von Transit-Gateway-Peering ab** Im folgenden Beispiel für `reject-transit-gateway-peering-attachment` wird die Anforderung für den angegebenen Anhang von Transit-Gateway-Peering abgelehnt. Der Parameter `--region` gibt die Region an, in der sich das annehmende Transit-Gateway befindet. ``` aws ec2 reject-transit-gateway-peering-attachment \ --transit-gateway-attachment-id tgw-attach-4455667788aabbccd \ --region us-east-2 ``` Ausgabe: ``` { "TransitGatewayPeeringAttachment": { "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd", "RequesterTgwInfo": { "TransitGatewayId": "tgw-123abc05e04123abc", "OwnerId": "123456789012", "Region": "us-west-2" }, "AccepterTgwInfo": { "TransitGatewayId": "tgw-11223344aabbcc112", "OwnerId": "123456789012", "Region": "us-east-2" }, "State": "rejecting", "CreationTime": "2019-12-09T11:50:31.000Z" } } ``` Weitere Informationen finden Sie unter [Anhänge von Transit-Gateway-Peering](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-peering.html) im *Handbuch für Transit Gateways*. + Einzelheiten zur API finden Sie [RejectTransitGatewayPeeringAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reject-transit-gateway-peering-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `reject-transit-gateway-vpc-attachment` Das folgende Codebeispiel zeigt die Verwendung`reject-transit-gateway-vpc-attachment`. **AWS CLI** **So lehnen Sie einen Anhang einer Transit-Gateway-VPC ab** Im folgenden Beispiel für `reject-transit-gateway-vpc-attachment` wird der angegebene Anhang der Transit-Gateway-VPC abgelehnt. ``` aws ec2 reject-transit-gateway-vpc-attachment \ --transit-gateway-attachment-id tgw-attach-0a34fe6b4fEXAMPLE ``` Ausgabe: ``` { "TransitGatewayVpcAttachment": { "TransitGatewayAttachmentId": "tgw-attach-0a34fe6b4fEXAMPLE", "TransitGatewayId": "tgw-0262a0e521EXAMPLE", "VpcId": "vpc-07e8ffd50fEXAMPLE", "VpcOwnerId": "111122223333", "State": "pending", "SubnetIds": [ "subnet-0752213d59EXAMPLE" ], "CreationTime": "2019-07-10T17:33:46.000Z", "Options": { "DnsSupport": "enable", "Ipv6Support": "disable" } } } ``` Weitere Informationen finden Sie unter [Transit-Gateway-Anhänge an eine VPC](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [RejectTransitGatewayVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reject-transit-gateway-vpc-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `reject-transit-gateway-vpc-attachments` Das folgende Codebeispiel zeigt die Verwendung`reject-transit-gateway-vpc-attachments`. **AWS CLI** **So lehnen Sie einen Anhang einer Transit-Gateway-VPC ab** Im folgenden Beispiel für `reject-transit-gateway-vpc-attachment` wird der angegebene Anhang der Transit-Gateway-VPC abgelehnt. ``` aws ec2 reject-transit-gateway-vpc-attachment \ --transit-gateway-attachment-id tgw-attach-0a34fe6b4fEXAMPLE ``` Ausgabe: ``` { "TransitGatewayVpcAttachment": { "TransitGatewayAttachmentId": "tgw-attach-0a34fe6b4fEXAMPLE", "TransitGatewayId": "tgw-0262a0e521EXAMPLE", "VpcId": "vpc-07e8ffd50fEXAMPLE", "VpcOwnerId": "111122223333", "State": "pending", "SubnetIds": [ "subnet-0752213d59EXAMPLE" ], "CreationTime": "2019-07-10T17:33:46.000Z", "Options": { "DnsSupport": "enable", "Ipv6Support": "disable" } } } ``` Weitere Informationen finden Sie unter [Transit-Gateway-Anhänge an eine VPC](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [RejectTransitGatewayVpcAttachments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reject-transit-gateway-vpc-attachments.html)in der *AWS CLI Befehlsreferenz*. ### `reject-vpc-endpoint-connections` Das folgende Codebeispiel zeigt die Verwendung`reject-vpc-endpoint-connections`. **AWS CLI** **So lehnen Sie eine Anforderung für eine Schnittstellenendpunktverbindung ab** In diesem Beispiel wird die angegebene Endpunkt-Verbindungsanforderung für den genannten Endpunktservice abgelehnt. Befehl: ``` aws ec2 reject-vpc-endpoint-connections --service-id vpce-svc-03d5ebb7d9579a2b3 --vpc-endpoint-ids vpce-0c1308d7312217abc ``` Ausgabe: ``` { "Unsuccessful": [] } ``` + Einzelheiten zur API finden Sie [RejectVpcEndpointConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reject-vpc-endpoint-connections.html)in der *AWS CLI Befehlsreferenz*. ### `reject-vpc-peering-connection` Das folgende Codebeispiel zeigt die Verwendung`reject-vpc-peering-connection`. **AWS CLI** **So lehnen Sie eine VPC-Peering-Verbindung ab** In diesem Beispiel wird die angegebene VPC-Peering-Verbindungsanforderung abgelehnt. Befehl: ``` aws ec2 reject-vpc-peering-connection --vpc-peering-connection-id pcx-1a2b3c4d ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [RejectVpcPeeringConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reject-vpc-peering-connection.html)in der *AWS CLI Befehlsreferenz*. ### `release-address` Das folgende Codebeispiel zeigt die Verwendung`release-address`. **AWS CLI** **So geben Sie eine Elastic-IP-Adresse für EC2-Classic frei** Dieses Beispiel gibt eine Elastic-IP-Adresse zur Verwendung mit Instances in EC2-Classic frei. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 release-address --public-ip 198.51.100.0 ``` **So geben Sie eine Elastic-IP-Adresse für EC2-VPC frei** In diesem Beispiel wird eine Elastic-IP-Adresse zur Verwendung mit Instances in einer VPC freigegeben. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 release-address --allocation-id eipalloc-64d5890a ``` + Einzelheiten zur API finden Sie [ReleaseAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/release-address.html)in der *AWS CLI Befehlsreferenz*. ### `release-hosts` Das folgende Codebeispiel zeigt die Verwendung`release-hosts`. **AWS CLI** **So geben Sie einen Dedicated Host von Ihrem Konto frei** So geben Sie einen Dedicated Host von Ihrem Konto frei Instances, die sich auf dem Host befinden, müssen angehalten oder beendet werden, bevor der Host freigegeben werden kann. Befehl: ``` aws ec2 release-hosts --host-id=h-0029d6e3cacf1b3da ``` Ausgabe: ``` { "Successful": [ "h-0029d6e3cacf1b3da" ], "Unsuccessful": [] } ``` + Einzelheiten zur API finden Sie [ReleaseHosts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/release-hosts.html)in der *AWS CLI Befehlsreferenz*. ### `release-ipam-pool-allocation` Das folgende Codebeispiel zeigt die Verwendung`release-ipam-pool-allocation`. **AWS CLI** **So geben Sie eine IPAM-Pool-Zuweisung frei** In diesem Beispiel haben Sie als delegierter IPAM-Administrator versucht, einen IPAM-Pool zu löschen. Dabei haben jedoch die Fehlermeldung erhalten, dass Sie den Pool nicht löschen können, solange dieser über Zuweisungen verfügt. Sie verwenden diesen Befehl zum Freigeben einer Pool-Zuweisung. Beachten Sie Folgendes: Sie können diesen Befehl nur für benutzerdefinierte Zuweisungen verwenden. Um eine Zuweisung für eine Ressource zu entfernen, ohne die Ressource zu löschen, setzen Sie ihren überwachten Status mit [modify-ipam-resource-cidr](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-ipam-resource-cidr.html).Um diese Anfrage abzuschließen, benötigen Sie die IPAM-Pool-ID, die Sie abrufen können. [describe-ipam-pools](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-ipam-pools.html) Sie benötigen außerdem die Zuweisungs-ID, die Sie mit abrufen können. [get-ipam-pool-allocations](https://docs.aws.amazon.com/cli/latest/reference/ec2/get-ipam-pool-allocations.html)Wenn Sie Zuweisungen nicht einzeln entfernen möchten, können Sie `--cascade option` beim Löschen eines IPAM-Pool die Option verwenden, um alle Zuordnungen im Pool automatisch freizugeben, bevor Sie ihn löschen. Es gibt eine Reihe von Voraussetzungen, bevor Sie diesen Befehl ausführen. Weitere Informationen finden Sie unter [Freigeben einer Zuweisung](https://docs.aws.amazon.com/vpc/latest/ipam/release-alloc-ipam.html) im *Benutzerhandbuch für Amazon VPC IPAM*. Die `--region`, in der Sie diesen Befehl ausführen, muss das Gebietsschema des IPAM-Pools sein, in dem sich die Zuweisung befindet. Im folgenden Beispiel für `release-ipam-pool-allocation` wird eine IPAM-Poolzuweisung freigegeben. ``` aws ec2 release-ipam-pool-allocation \ --ipam-pool-id ipam-pool-07bdd12d7c94e4693 \ --cidr 10.0.0.0/23 \ --ipam-pool-allocation-id ipam-pool-alloc-0e66a1f730da54791b99465b79e7d1e89 \ --region us-west-1 ``` Ausgabe: ``` { "Success": true } ``` Sobald Sie eine Zuordnung freigegeben haben, möchten Sie sie möglicherweise ausführen. [delete-ipam-pool](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-ipam-pool.html) + Einzelheiten zur API finden Sie [ReleaseIpamPoolAllocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/release-ipam-pool-allocation.html)in der *AWS CLI Befehlsreferenz*. ### `replace-iam-instance-profile-association` Das folgende Codebeispiel zeigt die Verwendung`replace-iam-instance-profile-association`. **AWS CLI** **So ersetzen Sie ein IAM-Instance-Profil für eine Instance** Dieses Beispiel ersetzt das IAM-Instance-Profil, das durch die Verknüpfung `iip-assoc-060bae234aac2e7fa` mit dem genannten IAM-Instance-Profil `AdminRole` dargestellt wird. ``` aws ec2 replace-iam-instance-profile-association \ --iam-instance-profile Name=AdminRole \ --association-id iip-assoc-060bae234aac2e7fa ``` Ausgabe: ``` { "IamInstanceProfileAssociation": { "InstanceId": "i-087711ddaf98f9489", "State": "associating", "AssociationId": "iip-assoc-0b215292fab192820", "IamInstanceProfile": { "Id": "AIPAJLNLDX3AMYZNWYYAY", "Arn": "arn:aws:iam::123456789012:instance-profile/AdminRole" } } } ``` + Einzelheiten zur API finden Sie [ReplaceIamInstanceProfileAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/replace-iam-instance-profile-association.html)in der *AWS CLI Befehlsreferenz*. ### `replace-network-acl-association` Das folgende Codebeispiel zeigt die Verwendung`replace-network-acl-association`. **AWS CLI** **So ersetzen Sie die einem Subnetz zugeordnete Netzwerk-ACL** In diesem Beispiel wird die angegebene Netzwerk-ACL mit dem Subnetz für die angegebene Netzwerk-ACL-Zuordnung verknüpft. Befehl: ``` aws ec2 replace-network-acl-association --association-id aclassoc-e5b95c8c --network-acl-id acl-5fb85d36 ``` Ausgabe: ``` { "NewAssociationId": "aclassoc-3999875b" } ``` + Einzelheiten zur API finden Sie [ReplaceNetworkAclAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/replace-network-acl-association.html)in der *AWS CLI Befehlsreferenz*. ### `replace-network-acl-entry` Das folgende Codebeispiel zeigt die Verwendung`replace-network-acl-entry`. **AWS CLI** **So ersetzen Sie einen Netzwerk-ACL-Eintrag** In diesem Beispiel wird ein Eintrag in der angegebenen Netzwerk-ACL ersetzt. Die neue Regel 100 erlaubt eingehenden Datenverkehr von 203.0.113.12/24 am UDP-Port 53 (DNS) in ein beliebiges zugeordnetes Subnetz. Befehl: ``` aws ec2 replace-network-acl-entry --network-acl-id acl-5fb85d36 --ingress --rule-number 100 --protocol udp --port-range From=53,To=53 --cidr-block 203.0.113.12/24 --rule-action allow ``` + Einzelheiten zur API finden Sie [ReplaceNetworkAclEntry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/replace-network-acl-entry.html)in der *AWS CLI Befehlsreferenz*. ### `replace-route-table-association` Das folgende Codebeispiel zeigt die Verwendung`replace-route-table-association`. **AWS CLI** **So ersetzen Sie die Routing-Tabelle, die einem Subnetz zugeordnet ist** In diesem Beispiel wird die angegebene Routing-Tabelle dem festgelegten Subnetz für die angegebene Routing-Tabelle zugeordnet. Befehl: ``` aws ec2 replace-route-table-association --association-id rtbassoc-781d0d1a --route-table-id rtb-22574640 ``` Ausgabe: ``` { "NewAssociationId": "rtbassoc-3a1f0f58" } ``` + Einzelheiten zur API finden Sie [ReplaceRouteTableAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/replace-route-table-association.html)in der *AWS CLI Befehlsreferenz*. ### `replace-route` Das folgende Codebeispiel zeigt die Verwendung`replace-route`. **AWS CLI** **So ersetzen Sie eine Route** In diesem Beispiel wird die angegebene Route in der festgelegten Routing-Tabelle ersetzt. Die neue Route entspricht dem angegebenen CIDR und sendet den Datenverkehr an das angegebene Virtual Private Gateway. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 replace-route --route-table-id rtb-22574640 --destination-cidr-block 10.0.0.0/16 --gateway-id vgw-9a4cacf3 ``` + Einzelheiten zur API finden Sie [ReplaceRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/replace-route.html)in der *AWS CLI Befehlsreferenz*. ### `replace-transit-gateway-route` Das folgende Codebeispiel zeigt die Verwendung`replace-transit-gateway-route`. **AWS CLI** **So ersetzen Sie die angegebene Route in der spezifizierten Routing-Tabelle für Transit-Gateways** Im folgenden Beispiel für `replace-transit-gateway-route` wird die Route in der angegebenen Routing-Tabelle in Transit Gateway gelöscht. ``` aws ec2 replace-transit-gateway-route \ --destination-cidr-block 10.0.2.0/24 \ --transit-gateway-attachment-id tgw-attach-09b52ccdb5EXAMPLE \ --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE ``` Ausgabe: ``` { "Route": { "DestinationCidrBlock": "10.0.2.0/24", "TransitGatewayAttachments": [ { "ResourceId": "vpc-4EXAMPLE", "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE", "ResourceType": "vpc" } ], "Type": "static", "State": "active" } } ``` Weitere Informationen finden Sie unter [Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [ReplaceTransitGatewayRoute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/replace-transit-gateway-route.html)in der *AWS CLI Befehlsreferenz*. ### `report-instance-status` Das folgende Codebeispiel zeigt die Verwendung`report-instance-status`. **AWS CLI** **So geben Sie Feedback zum Status einer Instance** Dieser Beispielbefehl gibt Feedback zum Status der angegebenen Instance. Befehl: ``` aws ec2 report-instance-status --instances i-1234567890abcdef0 --status impaired --reason-codes unresponsive ``` + Einzelheiten zur API finden Sie [ReportInstanceStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/report-instance-status.html)in der *AWS CLI Befehlsreferenz*. ### `request-spot-fleet` Das folgende Codebeispiel zeigt die Verwendung`request-spot-fleet`. **AWS CLI** **So fordern Sie eine Spot-Flotte im Subnetz mit dem niedrigsten Preis an** Dieser Beispielbefehl erstellt eine Spot-Flottenanforderung mit zwei Startspezifikationen, die sich nur im Hinblick auf das Subnetz unterscheiden. Die Spot-Flotte startet die Instances im angegebenen Subnetz mit dem niedrigsten Preis. Wenn die Instances in einer Standard-VPC gestartet werden, erhalten sie standardmäßig eine öffentliche IP-Adresse. Wenn die Instances in einer nicht standardmäßigen VPC gestartet werden, erhalten sie keine öffentliche Adresse. Beachten Sie, dass Sie in einer Spot-Flotten-Anforderung nicht verschiedene Subnetze in derselben Availability Zone angeben können. Befehl: ``` aws ec2 request-spot-fleet --spot-fleet-request-config file://config.json ``` Config.json: ``` { "SpotPrice": "0.04", "TargetCapacity": 2, "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", "LaunchSpecifications": [ { "ImageId": "ami-1a2b3c4d", "KeyName": "my-key-pair", "SecurityGroups": [ { "GroupId": "sg-1a2b3c4d" } ], "InstanceType": "m3.medium", "SubnetId": "subnet-1a2b3c4d, subnet-3c4d5e6f", "IamInstanceProfile": { "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" } } ] } ``` Ausgabe: ``` { "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" } ``` **So fordern Sie eine Spot-Flotte in der Availability Zone mit dem niedrigsten Preis an** Dieser Beispielbefehl erstellt eine Spot-Flottenanforderung mit zwei Startspezifikationen, die sich nur im Hinblick auf die Availability Zone unterscheiden. Die Spot-Flotte startet die Instances in der angegebenen Availability Zone mit dem niedrigsten Preis. Wenn Ihr Konto nur EC2-VPC unterstützt, startet Amazon EC2 die Spot Instances im Standard-Subnetz der Availability Zone. Wenn Ihr Konto EC2-Classic unterstützt, startet Amazon EC2 die Instances in EC2-Classic in der Availability Zone. Befehl: ``` aws ec2 request-spot-fleet --spot-fleet-request-config file://config.json ``` Config.json: ``` { "SpotPrice": "0.04", "TargetCapacity": 2, "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", "LaunchSpecifications": [ { "ImageId": "ami-1a2b3c4d", "KeyName": "my-key-pair", "SecurityGroups": [ { "GroupId": "sg-1a2b3c4d" } ], "InstanceType": "m3.medium", "Placement": { "AvailabilityZone": "us-west-2a, us-west-2b" }, "IamInstanceProfile": { "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" } } ] } ``` **So starten Sie Spot Instances in einem Subnetz und weisen ihnen öffentliche IP-Adressen zu** Dieser Beispielbefehl weist Instances, die in einer nicht standardmäßigen VPC gestartet werden, öffentliche Adressen zu. Beachten Sie, dass Sie bei Angabe einer Netzwerkschnittstelle die Subnetz-ID und die Sicherheitsgruppen-ID mithilfe der Netzwerkschnittstelle angeben müssen. Befehl: ``` aws ec2 request-spot-fleet --spot-fleet-request-config file://config.json ``` Config.json: ``` { "SpotPrice": "0.04", "TargetCapacity": 2, "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", "LaunchSpecifications": [ { "ImageId": "ami-1a2b3c4d", "KeyName": "my-key-pair", "InstanceType": "m3.medium", "NetworkInterfaces": [ { "DeviceIndex": 0, "SubnetId": "subnet-1a2b3c4d", "Groups": [ "sg-1a2b3c4d" ], "AssociatePublicIpAddress": true } ], "IamInstanceProfile": { "Arn": "arn:aws:iam::880185128111:instance-profile/my-iam-role" } } ] } ``` **So fordern eine Spot-Flotte anhand der diversifizierten Zuweisungsstrategie an** Dieser Beispielbefehl erstellt eine Spot-Flottenanforderung, die 30 Instances unter Verwendung der diversifizierten Zuweisungsstrategie startet. Die Startspezifikationen unterscheiden sich je nach Instance-Typ. Die Spot-Flotte verteilt die Instances auf die Startspezifikationen, sodass 10 Instances von jedem Typ vorhanden sind. Befehl: ``` aws ec2 request-spot-fleet --spot-fleet-request-config file://config.json ``` Config.json: ``` { "SpotPrice": "0.70", "TargetCapacity": 30, "AllocationStrategy": "diversified", "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", "LaunchSpecifications": [ { "ImageId": "ami-1a2b3c4d", "InstanceType": "c4.2xlarge", "SubnetId": "subnet-1a2b3c4d" }, { "ImageId": "ami-1a2b3c4d", "InstanceType": "m3.2xlarge", "SubnetId": "subnet-1a2b3c4d" }, { "ImageId": "ami-1a2b3c4d", "InstanceType": "r3.2xlarge", "SubnetId": "subnet-1a2b3c4d" } ] } ``` Weitere Informationen finden Sie unter „Spot-Flottenanforderungen“ im *Benutzerhandbuch für Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie [RequestSpotFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/request-spot-fleet.html)in der *AWS CLI Befehlsreferenz*. ### `request-spot-instances` Das folgende Codebeispiel zeigt die Verwendung`request-spot-instances`. **AWS CLI** **So fordern Sie Spot Instances an** Dieser Beispielbefehl erstellt eine einmalige Spot-Instance-Anforderung für 5 Instances in der angegebenen Availability Zone. Wenn Ihr Konto nur EC2-VPC unterstützt, startet Amazon EC2 die Instances im Standard-Subnetz der angegebenen Availability Zone. Wenn Ihr Konto EC2-Classic unterstützt, startet Amazon EC2 die Instances in EC2-Classic in der angegebenen Availability Zone. Befehl: ``` aws ec2 request-spot-instances --spot-price "0.03" --instance-count 5 --type "one-time" --launch-specification file://specification.json ``` Specification.json: ``` { "ImageId": "ami-1a2b3c4d", "KeyName": "my-key-pair", "SecurityGroupIds": [ "sg-1a2b3c4d" ], "InstanceType": "m3.medium", "Placement": { "AvailabilityZone": "us-west-2a" }, "IamInstanceProfile": { "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" } } ``` Ausgabe: ``` { "SpotInstanceRequests": [ { "Status": { "UpdateTime": "2014-03-25T20:54:21.000Z", "Code": "pending-evaluation", "Message": "Your Spot request has been submitted for review, and is pending evaluation." }, "ProductDescription": "Linux/UNIX", "SpotInstanceRequestId": "sir-df6f405d", "State": "open", "LaunchSpecification": { "Placement": { "AvailabilityZone": "us-west-2a" }, "ImageId": "ami-1a2b3c4d", "KeyName": "my-key-pair", "SecurityGroups": [ { "GroupName": "my-security-group", "GroupId": "sg-1a2b3c4d" } ], "Monitoring": { "Enabled": false }, "IamInstanceProfile": { "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" }, "InstanceType": "m3.medium" }, "Type": "one-time", "CreateTime": "2014-03-25T20:54:20.000Z", "SpotPrice": "0.050000" }, ... ] } ``` Dieser Beispielbefehl erstellt eine einmalige Spot-Instance-Anforderung für 5 Instances im angegebenen Subnetz. Amazon EC2 startet die Instances im ausgewählten Subnetz. Wenn es sich bei der VPC um eine nicht standardmäßige VPC handelt, erhalten die Instances standardmäßig keine öffentliche IP-Adresse. Befehl: ``` aws ec2 request-spot-instances --spot-price "0.050" --instance-count 5 --type "one-time" --launch-specification file://specification.json ``` Specification.json: ``` { "ImageId": "ami-1a2b3c4d", "SecurityGroupIds": [ "sg-1a2b3c4d" ], "InstanceType": "m3.medium", "SubnetId": "subnet-1a2b3c4d", "IamInstanceProfile": { "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" } } ``` Ausgabe: ``` { "SpotInstanceRequests": [ { "Status": { "UpdateTime": "2014-03-25T22:21:58.000Z", "Code": "pending-evaluation", "Message": "Your Spot request has been submitted for review, and is pending evaluation." }, "ProductDescription": "Linux/UNIX", "SpotInstanceRequestId": "sir-df6f405d", "State": "open", "LaunchSpecification": { "Placement": { "AvailabilityZone": "us-west-2a" } "ImageId": "ami-1a2b3c4d" "SecurityGroups": [ { "GroupName": "my-security-group", "GroupID": "sg-1a2b3c4d" } ] "SubnetId": "subnet-1a2b3c4d", "Monitoring": { "Enabled": false }, "IamInstanceProfile": { "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" }, "InstanceType": "m3.medium", }, "Type": "one-time", "CreateTime": "2014-03-25T22:21:58.000Z", "SpotPrice": "0.050000" }, ... ] } ``` In diesem Beispiel werden Spot Instances, die Sie in einer nicht standardmäßigen VPC starten, eine öffentliche IP-Adresse zugewiesen. Beachten Sie, dass Sie bei Angabe einer Netzwerkschnittstelle die Subnetz-ID und die Sicherheitsgruppen-ID mithilfe der Netzwerkschnittstelle angeben müssen. Befehl: ``` aws ec2 request-spot-instances --spot-price "0.050" --instance-count 1 --type "one-time" --launch-specification file://specification.json ``` Specification.json: ``` { "ImageId": "ami-1a2b3c4d", "KeyName": "my-key-pair", "InstanceType": "m3.medium", "NetworkInterfaces": [ { "DeviceIndex": 0, "SubnetId": "subnet-1a2b3c4d", "Groups": [ "sg-1a2b3c4d" ], "AssociatePublicIpAddress": true } ], "IamInstanceProfile": { "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" } } ``` + Einzelheiten zur API finden Sie [RequestSpotInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/request-spot-instances.html)in der *AWS CLI Befehlsreferenz*. ### `reset-address-attribute` Das folgende Codebeispiel zeigt die Verwendung`reset-address-attribute`. **AWS CLI** **So setzen Sie das mit einer Elastic-IP-Adresse verknüpfte Domainnamenattribut zurück** In den folgenden Beispielen für `reset-address-attribute` wird das Domainnamenattribut einer Elastic-IP-Adresse zurückgesetzt. Linux: ``` aws ec2 reset-address-attribute \ --allocation-id eipalloc-abcdef01234567890 \ --attribute domain-name ``` Windows: ``` aws ec2 reset-address-attribute ^ --allocation-id eipalloc-abcdef01234567890 ^ --attribute domain-name ``` Ausgabe: ``` { "Addresses": [ { "PublicIp": "192.0.2.0", "AllocationId": "eipalloc-abcdef01234567890", "PtrRecord": "example.com." "PtrRecordUpdate": { "Value": "example.net.", "Status": "PENDING" } ] } ``` Informationen zur Überwachung der ausstehenden Änderung finden Sie [describe-addresses-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-addresses-attribute.html)in der *AWS CLI-Befehlsreferenz*. + Einzelheiten zur API finden Sie [ResetAddressAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reset-address-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `reset-ebs-default-kms-key-id` Das folgende Codebeispiel zeigt die Verwendung`reset-ebs-default-kms-key-id`. **AWS CLI** **So setzen Sie Ihren Standard-CMK für die EBS-Verschlüsselung zurück** Im folgenden `reset-ebs-default-kms-key-id` Beispiel wird der Standard-CMK für die EBS-Verschlüsselung für Ihr AWS Konto in der aktuellen Region zurückgesetzt. ``` aws ec2 reset-ebs-default-kms-key-id ``` Ausgabe: ``` { "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/8c5b2c63-b9bc-45a3-a87a-5513eEXAMPLE" } ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz [ResetEbsDefaultKmsKeyId](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reset-ebs-default-kms-key-id.html).AWS CLI * ### `reset-fpga-image-attribute` Das folgende Codebeispiel zeigt die Verwendung`reset-fpga-image-attribute`. **AWS CLI** **So setzen Sie die Attribute eines Amazon-FPGA-Image zurück** In diesem Beispiel werden die Ladeberechtigungen für das angegebene AFI zurückgesetzt. Befehl: ``` aws ec2 reset-fpga-image-attribute --fpga-image-id afi-0d123e123bfc85abc --attribute loadPermission ``` Ausgabe: ``` { "Return": true } ``` + Einzelheiten zur API finden Sie [ResetFpgaImageAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reset-fpga-image-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `reset-image-attribute` Das folgende Codebeispiel zeigt die Verwendung`reset-image-attribute`. **AWS CLI** **So setzen Sie das launchPermission-Attribut zurück** In diesem Beispiel wird das `launchPermission`-Attribut für das angegebene AMI auf seinen Standardwert zurückgesetzt. Standardmäßig AMIs sind sie privat. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 reset-image-attribute --image-id ami-5731123e --attribute launchPermission ``` + Einzelheiten zur API finden Sie [ResetImageAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reset-image-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `reset-instance-attribute` Das folgende Codebeispiel zeigt die Verwendung`reset-instance-attribute`. **AWS CLI** **Um das sourceDestCheck Attribut zurückzusetzen** In diesem Beispiel wird das `sourceDestCheck`-Attribut der angegebenen Instance zurückgesetzt. Die Instance muss sich in einer VPC befinden. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 reset-instance-attribute --instance-id i-1234567890abcdef0 --attribute sourceDestCheck ``` **So setzen Sie das kernel-Attribut zurück** In diesem Beispiel wird das `kernel`-Attribut der angegebenen Instance zurückgesetzt. Die Instance muss sich im Status `stopped` befinden. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 reset-instance-attribute --instance-id i-1234567890abcdef0 --attribute kernel ``` **So setzen Sie das ramdisk-Attribut zurück** In diesem Beispiel wird das `ramdisk`-Attribut der angegebenen Instance zurückgesetzt. Die Instance muss sich im Status `stopped` befinden. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 reset-instance-attribute --instance-id i-1234567890abcdef0 --attribute ramdisk ``` + Einzelheiten zur API finden Sie [ResetInstanceAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reset-instance-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `reset-network-interface-attribute` Das folgende Codebeispiel zeigt die Verwendung`reset-network-interface-attribute`. **AWS CLI** **So setzen Sie ein Netzwerkschnittstellenattribut zurück** Im folgenden `reset-network-interface-attribute` Beispiel wird der Wert des source/destination Checking-Attributs auf `true` zurückgesetzt. ``` aws ec2 reset-network-interface-attribute \ --network-interface-id eni-686ea200 \ --source-dest-check ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie unter [ResetNetworkInterfaceAttribute AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reset-network-interface-attribute.html)*Befehlsreferenz.* ### `reset-snapshot-attribute` Das folgende Codebeispiel zeigt die Verwendung`reset-snapshot-attribute`. **AWS CLI** **So setzen Sie ein snapshot-Attribut zurück** In diesem Beispiel werden die Berechtigungen zum Erstellen eines Volumes für den Snapshot `snap-1234567890abcdef0` zurückgesetzt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 reset-snapshot-attribute --snapshot-id snap-1234567890abcdef0 --attribute createVolumePermission ``` + Einzelheiten zur API finden Sie [ResetSnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/reset-snapshot-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `restore-address-to-classic` Das folgende Codebeispiel zeigt die Verwendung`restore-address-to-classic`. **AWS CLI** **So stellen Sie eine Adresse in EC2-Classic wieder her** In diesem Beispiel wird die Elastic-IP-Adresse 198.51.100.0 auf der EC2-Classic-Plattform wiederhergestellt. Befehl: ``` aws ec2 restore-address-to-classic --public-ip 198.51.100.0 ``` Ausgabe: ``` { "Status": "MoveInProgress", "PublicIp": "198.51.100.0" } ``` + Einzelheiten zur API finden Sie [RestoreAddressToClassic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/restore-address-to-classic.html)in der *AWS CLI Befehlsreferenz*. ### `restore-image-from-recycle-bin` Das folgende Codebeispiel zeigt die Verwendung`restore-image-from-recycle-bin`. **AWS CLI** **So stellen Sie ein Image aus dem Papierkorb wieder her** Im folgenden Beispiel für `restore-image-from-recycle-bin` wird das AMI ami-0111222333444abcd aus dem Papierkorb wiederhergestellt. ``` aws ec2 restore-image-from-recycle-bin \ --image-id ami-0111222333444abcd ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [ AMIs Aus dem Papierkorb gelöschte Dateien wiederherstellen](https://docs.aws.amazon.com/ebs/latest/userguide/recycle-bin-working-with-amis.html) im *Amazon EBS-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [RestoreImageFromRecycleBin AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/restore-image-from-recycle-bin.html)*Befehlsreferenz*. ### `restore-managed-prefix-list-version` Das folgende Codebeispiel zeigt die Verwendung`restore-managed-prefix-list-version`. **AWS CLI** us-west-2\$1\$1To restore a prefix list version\$1\$1 In der folgenden `restore-managed-prefix-list-version` werden die Einträge aus Version 1 der angegebenen Präfixliste wiederhergestellt. ``` aws ec2 restore-managed-prefix-list-version \ --prefix-list-id pl-0123456abcabcabc1 \ --current-version 2 \ --previous-version 1 ``` Ausgabe: ``` { "PrefixList": { "PrefixListId": "pl-0123456abcabcabc1", "AddressFamily": "IPv4", "State": "restore-in-progress", "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1", "PrefixListName": "vpc-cidrs", "MaxEntries": 10, "Version": 2, "OwnerId": "123456789012" } } ``` Weitere Informationen finden Sie unter [Verwaltete Präfixlisten](https://docs.aws.amazon.com/vpc/latest/userguide/managed-prefix-lists.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie [RestoreManagedPrefixListVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/restore-managed-prefix-list-version.html)in der *AWS CLI Befehlsreferenz*. ### `restore-snapshot-from-recycle-bin` Das folgende Codebeispiel zeigt die Verwendung`restore-snapshot-from-recycle-bin`. **AWS CLI** **So stellen Sie Snapshots aus dem Papierkorb wieder her** Im folgenden Beispiel für `restore-snapshot-from-recycle-bin` wird ein Snapshot aus dem Papierkorb wiederhergestellt. Wenn Sie einen Snapshot aus dem Papierkorb wiederherstellen, kann er sofort verwendet werden und wird aus dem Papierkorb entfernt. Sie können einen wiederhergestellten Snapshot genauso verwenden wie jeden anderen Snapshot in Ihrem Konto. ``` aws ec2 restore-snapshot-from-recycle-bin \ --snapshot-id snap-01234567890abcdef ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen zum Papierkorb finden Sie unter [Wiederherstellen gelöschter Snapshots aus dem Papierkorb](https://docs.aws.amazon.com/ebs/latest/userguide/recycle-bin-working-with-snaps.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [RestoreSnapshotFromRecycleBin](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/restore-snapshot-from-recycle-bin.html)in der *AWS CLI Befehlsreferenz*. ### `restore-snapshot-tier` Das folgende Codebeispiel zeigt die Verwendung`restore-snapshot-tier`. **AWS CLI** **Beispiel 1: So stellen Sie einen archivierten Snapshot dauerhaft wieder her** Im folgenden Beispiel für `restore-snapshot-tier` wird der angegebene Snapshot dauerhaft wiederhergestellt. Geben Sie die `--snapshot-id` an und schließen Sie sie die `permanent-restore`-Option ein. ``` aws ec2 restore-snapshot-tier \ --snapshot-id snap-01234567890abcedf \ --permanent-restore ``` Ausgabe: ``` { "SnapshotId": "snap-01234567890abcedf", "IsPermanentRestore": true } ``` Weitere Informationen finden Sie unter [Archivieren von Amazon-EBS-Snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/snapshot-archive.html) im *Benutzerhandbuch für Amazon EBS*. **Beispiel 2: So stellen Sie einen archivierten Snapshot temporär wieder her** Im folgenden Beispiel für `restore-snapshot-tier` wird der angegebene Snapshot temporär wiederhergestellt. Lassen Sie die `--permanent-restore`-Option weg. Geben Sie die `--snapshot-id` und für `temporary-restore-days` die Anzahl der Tage an, für die der Snapshot wiederhergestellt werden soll. `temporary-restore-days` muss in Tagen angegeben werden. Der zulässige Bereich ist `1` bis `180`. Wenn Sie keinen Wert angeben, wird standardmäßig `1` Tag verwendet. ``` aws ec2 restore-snapshot-tier \ --snapshot-id snap-01234567890abcedf \ --temporary-restore-days 5 ``` Ausgabe: ``` { "SnapshotId": "snap-01234567890abcedf", "RestoreDuration": 5, "IsPermanentRestore": false } ``` Weitere Informationen finden Sie unter [Archivieren von Amazon-EBS-Snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/snapshot-archive.html) im *Benutzerhandbuch für Amazon EBS*. **Beispiel 3: So ändern Sie den Wiederherstellungszeitraum** Im folgenden Beispiel für `restore-snapshot-tier` wird der Wiederherstellungszeitraum für den angegebenen Snapshot in `10` Tage geändert. ``` aws ec2 restore-snapshot-tier \ --snapshot-id snap-01234567890abcedf --temporary-restore-days 10 ``` Ausgabe: ``` { "SnapshotId": "snap-01234567890abcedf", "RestoreDuration": 10, "IsPermanentRestore": false } ``` Weitere Informationen finden Sie unter [Archivieren von Amazon-EBS-Snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/snapshot-archive.html) im *Benutzerhandbuch für Amazon EBS*. **Beispiel 4: So ändern Sie den Wiederherstellungstyp** Im folgenden Beispiel für `restore-snapshot-tier` wird der Wiederherstellungstyp für den angegebenen Snapshot von „Temporär“ in „Permanent“ geändert. ``` aws ec2 restore-snapshot-tier \ --snapshot-id snap-01234567890abcedf --permanent-restore ``` Ausgabe: ``` { "SnapshotId": "snap-01234567890abcedf", "IsPermanentRestore": true } ``` Weitere Informationen finden Sie unter [Archivieren von Amazon-EBS-Snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/snapshot-archive.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [RestoreSnapshotTier](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/restore-snapshot-tier.html)in der *AWS CLI Befehlsreferenz*. ### `revoke-client-vpn-ingress` Das folgende Codebeispiel zeigt die Verwendung`revoke-client-vpn-ingress`. **AWS CLI** **So widerrufen Sie eine Autorisierungsregel für einen Client-VPN-Endpunkt** Im folgenden Beispiel für `revoke-client-vpn-ingress` wird eine Regel für den Internetzugang (`0.0.0.0/0`) für alle Gruppen widerrufen. ``` aws ec2 revoke-client-vpn-ingress \ --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \ --target-network-cidr 0.0.0.0/0 --revoke-all-groups ``` Ausgabe: ``` { "Status": { "Code": "revoking" } } ``` Weitere Informationen finden Sie unter [Autorisierungsregeln](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-rules.html) im *Administratorhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [RevokeClientVpnIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/revoke-client-vpn-ingress.html)in der *AWS CLI Befehlsreferenz*. ### `revoke-security-group-egress` Das folgende Codebeispiel zeigt die Verwendung`revoke-security-group-egress`. **AWS CLI** **Beispiel 1: So entfernen Sie die Regel, die ausgehenden Datenverkehr in einem bestimmten Adressbereich zulässt** Mit dem folgenden `revoke-security-group-egress`-Beispielbefehl wird die Regel entfernt, die Zugriff auf die angegebenen Adressbereiche am TCP-Port 80 gewährt. ``` aws ec2 revoke-security-group-egress \ --group-id sg-026c12253ce15eff7 \ --ip-permissions [{IpProtocol=tcp,FromPort=80,ToPort=80,IpRanges=[{CidrIp=10.0.0.0/16}] ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Sicherheitsgruppen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So entfernen Sie die Regel, die ausgehenden Datenverkehr an eine bestimmte Sicherheitsgruppe zulässt** Mit dem folgenden `revoke-security-group-egress`-Beispielbefehl wird die Regel entfernt, die Zugriff auf die angegebene Sicherheitsgruppe am TCP-Port 80 gewährt. ``` aws ec2 revoke-security-group-egress \ --group-id sg-026c12253ce15eff7 \ --ip-permissions '[{"IpProtocol": "tcp", "FromPort": 443, "ToPort": 443,"UserIdGroupPairs": [{"GroupId": "sg-06df23a01ff2df86d"}]}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Sicherheitsgruppen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [RevokeSecurityGroupEgress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/revoke-security-group-egress.html)in der *AWS CLI Befehlsreferenz*. ### `revoke-security-group-ingress` Das folgende Codebeispiel zeigt die Verwendung`revoke-security-group-ingress`. **AWS CLI** **Beispiel 1: So entfernen Sie eine Regel aus einer Sicherheitsgruppe** Im folgenden Beispiel für `revoke-security-group-ingress` wird der Zugriff am TCP-Port 22 für den Adressbereich `203.0.113.0/24` aus der angegebenen Sicherheitsgruppe für eine Standard-VPC entfernt. ``` aws ec2 revoke-security-group-ingress \ --group-name mySecurityGroup --protocol tcp \ --port 22 \ --cidr 203.0.113.0/24 ``` Dieser Befehl erzeugt keine Ausgabe, wenn er erfolgreich ist. Weitere Informationen finden Sie unter [Sicherheitsgruppen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So entfernen Sie eine Regel mithilfe des IP-Berechtigungssatzes** Im folgenden Beispiel für `revoke-security-group-ingress` wird der `ip-permissions`-Parameter verwendet, um eine eingehende Regel zu entfernen, die die ICMP-Nachricht `Destination Unreachable: Fragmentation Needed and Don't Fragment was Set` (Typ 3, Code 4) zulässt. ``` aws ec2 revoke-security-group-ingress \ --group-id sg-026c12253ce15eff7 \ --ip-permissions IpProtocol=icmp,FromPort=3,ToPort=4,IpRanges=[{CidrIp=0.0.0.0/0}] ``` Dieser Befehl erzeugt keine Ausgabe, wenn er erfolgreich ist. Weitere Informationen finden Sie unter [Sicherheitsgruppen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [RevokeSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/revoke-security-group-ingress.html)in der *AWS CLI Befehlsreferenz*. ### `run-instances` Das folgende Codebeispiel zeigt die Verwendung`run-instances`. **AWS CLI** **Beispiel 1: So starten Sie eine Instance in einem Standard-Subnetz** Das folgende `run-instances`-Beispiel startet eine einzelne Instance des Typs `t2.micro` im Standardsubnetz für die aktuelle Region und ordnet sie dem Standardsubnetz für die Standard-VPC für die Region zu. Das Schlüsselpaar ist optional, wenn Sie nicht vorhaben, über SSH (Linux) oder RDP (Windows) eine Verbindung zu Ihrer Instance herzustellen. ``` aws ec2 run-instances \ --image-id ami-0abcdef1234567890 \ --instance-type t2.micro \ --key-name MyKeyPair ``` Ausgabe: ``` { "Instances": [ { "AmiLaunchIndex": 0, "ImageId": "ami-0abcdef1234567890", "InstanceId": "i-1231231230abcdef0", "InstanceType": "t2.micro", "KeyName": "MyKeyPair", "LaunchTime": "2018-05-10T08:05:20.000Z", "Monitoring": { "State": "disabled" }, "Placement": { "AvailabilityZone": "us-east-2a", "GroupName": "", "Tenancy": "default" }, "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal", "PrivateIpAddress": "10.0.0.157", "ProductCodes": [], "PublicDnsName": "", "State": { "Code": 0, "Name": "pending" }, "StateTransitionReason": "", "SubnetId": "subnet-04a636d18e83cfacb", "VpcId": "vpc-1234567890abcdef0", "Architecture": "x86_64", "BlockDeviceMappings": [], "ClientToken": "", "EbsOptimized": false, "Hypervisor": "xen", "NetworkInterfaces": [ { "Attachment": { "AttachTime": "2018-05-10T08:05:20.000Z", "AttachmentId": "eni-attach-0e325c07e928a0405", "DeleteOnTermination": true, "DeviceIndex": 0, "Status": "attaching" }, "Description": "", "Groups": [ { "GroupName": "MySecurityGroup", "GroupId": "sg-0598c7d356eba48d7" } ], "Ipv6Addresses": [], "MacAddress": "0a:ab:58:e0:67:e2", "NetworkInterfaceId": "eni-0c0a29997760baee7", "OwnerId": "123456789012", "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal", "PrivateIpAddress": "10.0.0.157", "PrivateIpAddresses": [ { "Primary": true, "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal", "PrivateIpAddress": "10.0.0.157" } ], "SourceDestCheck": true, "Status": "in-use", "SubnetId": "subnet-04a636d18e83cfacb", "VpcId": "vpc-1234567890abcdef0", "InterfaceType": "interface" } ], "RootDeviceName": "/dev/xvda", "RootDeviceType": "ebs", "SecurityGroups": [ { "GroupName": "MySecurityGroup", "GroupId": "sg-0598c7d356eba48d7" } ], "SourceDestCheck": true, "StateReason": { "Code": "pending", "Message": "pending" }, "Tags": [], "VirtualizationType": "hvm", "CpuOptions": { "CoreCount": 1, "ThreadsPerCore": 1 }, "CapacityReservationSpecification": { "CapacityReservationPreference": "open" }, "MetadataOptions": { "State": "pending", "HttpTokens": "optional", "HttpPutResponseHopLimit": 1, "HttpEndpoint": "enabled" } } ], "OwnerId": "123456789012", "ReservationId": "r-02a3f596d91211712" } ``` **Beispiel 2: So starten Sie eine Instance in einem nicht standardmäßigen Subnetz und fügen eine öffentliche IP-Adresse hinzu** Im folgenden Beispiel für `run-instances` wird eine öffentliche IP-Adresse für eine Instance angefordert, die Sie in einem nicht standardmäßigen Subnetz starten. Die Instance ist mit der angegebenen Sicherheitsgruppe verbunden. ``` aws ec2 run-instances \ --image-id ami-0abcdef1234567890 \ --instance-type t2.micro \ --subnet-id subnet-08fc749671b2d077c \ --security-group-ids sg-0b0384b66d7d692f9 \ --associate-public-ip-address \ --key-name MyKeyPair ``` Ein Beispiel für die Ausgabe von `run-instances` finden Sie in Beispiel 1. **Beispiel 3: So starten Sie eine Instance mit zusätzlichen Volumes** Das folgende `run-instances`-Beispiel verwendet eine Blockgerät-Zuweisung, die in mapping.json angegeben ist, um beim Start zusätzliche Volumes anzufügen. Eine Blockgerät-Zuweisung kann EBS-Volumes, Instance-Speicher-Volumes oder sowohl EBS-Volumes als auch Instance-Speicher-Volumes angeben. ``` aws ec2 run-instances \ --image-id ami-0abcdef1234567890 \ --instance-type t2.micro \ --subnet-id subnet-08fc749671b2d077c \ --security-group-ids sg-0b0384b66d7d692f9 \ --key-name MyKeyPair \ --block-device-mappings file://mapping.json ``` Inhalt von `mapping.json`. In diesem Beispiel wird `/dev/sdh` ein leeres EBS-Volume mit einer Größe von 100 GiB hinzugefügt. ``` [ { "DeviceName": "/dev/sdh", "Ebs": { "VolumeSize": 100 } } ] ``` Inhalt von `mapping.json`. In diesem Beispiel wird `ephemeral1` als Instance-Speicher-Volume hinzugefügt. ``` [ { "DeviceName": "/dev/sdc", "VirtualName": "ephemeral1" } ] ``` Ein Beispiel für die Ausgabe von `run-instances` finden Sie in Beispiel 1. Weitere Informationen zu Blockgerät-Zuweisungen finden Sie unter [Blockgerät-Zuweisungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 4: So starten Sie eine Instance und fügen bei der Erstellung Tags hinzu** Im folgenden Beispiel für `run-instances` wird ein Tag mit dem Schlüssel `webserver` und dem Wert `production` zur Instance hinzugefügt. Der folgende Befehl wendet ein Tag mit einem Schlüssel von `cost-center` und einem Wert von `cc123` auf ein erstelltes EBS-Volume an (in diesem Fall das Root-Volume). ``` aws ec2 run-instances \ --image-id ami-0abcdef1234567890 \ --instance-type t2.micro \ --count 1 \ --subnet-id subnet-08fc749671b2d077c \ --key-name MyKeyPair \ --security-group-ids sg-0b0384b66d7d692f9 \ --tag-specifications 'ResourceType=instance,Tags=[{Key=webserver,Value=production}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]' ``` Ein Beispiel für die Ausgabe von `run-instances` finden Sie in Beispiel 1. **Beispiel 5: So starten Sie eine Instance mit Benutzerdaten** Im folgenden Beispiel für `run-instances` werden Benutzerdaten in eine Datei mit dem Namen `my_script.txt` übergeben, die ein Konfigurationsskript für Ihre Instance enthält. Das Skript wird beim Start ausgeführt. ``` aws ec2 run-instances \ --image-id ami-0abcdef1234567890 \ --instance-type t2.micro \ --count 1 \ --subnet-id subnet-08fc749671b2d077c \ --key-name MyKeyPair \ --security-group-ids sg-0b0384b66d7d692f9 \ --user-data file://my_script.txt ``` Ein Beispiel für die Ausgabe von `run-instances` finden Sie in Beispiel 1. Weitere Informationen zu Instance-Benutzerdaten finden Sie unter [Arbeiten mit Instance-Benutzerdaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-add-user-data.html) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 6: So starten Sie eine Instance mit Spitzenlastleistung** Im folgenden Beispiel für `run-instances` wird eine t2.micro-Instance mit der `unlimited`-Kreditoption gestartet. Wenn Sie eine T2-Instance starten und keinen `--credit-specification` angeben, wird standardmäßig die Kreditoption `standard` verwendet. Wenn Sie eine T3-Instance starten, ist die Standardeinstellung die Kreditoption `unlimited`. ``` aws ec2 run-instances \ --image-id ami-0abcdef1234567890 \ --instance-type t2.micro \ --count 1 \ --subnet-id subnet-08fc749671b2d077c \ --key-name MyKeyPair \ --security-group-ids sg-0b0384b66d7d692f9 \ --credit-specification CpuCredits=unlimited ``` Ein Beispiel für die Ausgabe von `run-instances` finden Sie in Beispiel 1. Weitere Informationen über Burstable Performance Instances finden Sie unter [Burstable Performance Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [RunInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/run-instances.html)in der *AWS CLI Befehlsreferenz*. ### `run-scheduled-instances` Das folgende Codebeispiel zeigt die Verwendung`run-scheduled-instances`. **AWS CLI** **So starten Sie eine geplante Instance** In diesem Beispiel wird die angegebene geplante Instance in einer VPC gestartet. Befehl: ``` aws ec2 run-scheduled-instances --scheduled-instance-id sci-1234-1234-1234-1234-123456789012 --instance-count 1 --launch-specification file://launch-specification.json ``` Launch-specification.json: ``` { "ImageId": "ami-12345678", "KeyName": "my-key-pair", "InstanceType": "c4.large", "NetworkInterfaces": [ { "DeviceIndex": 0, "SubnetId": "subnet-12345678", "AssociatePublicIpAddress": true, "Groups": ["sg-12345678"] } ], "IamInstanceProfile": { "Name": "my-iam-role" } } ``` Ausgabe: ``` { "InstanceIdSet": [ "i-1234567890abcdef0" ] } ``` In diesem Beispiel wird die angegebene geplante Instance in EC2-Classic gestartet. Befehl: ``` aws ec2 run-scheduled-instances --scheduled-instance-id sci-1234-1234-1234-1234-123456789012 --instance-count 1 --launch-specification file://launch-specification.json ``` Launch-specification.json: ``` { "ImageId": "ami-12345678", "KeyName": "my-key-pair", "SecurityGroupIds": ["sg-12345678"], "InstanceType": "c4.large", "Placement": { "AvailabilityZone": "us-west-2b" } "IamInstanceProfile": { "Name": "my-iam-role" } } ``` Ausgabe: ``` { "InstanceIdSet": [ "i-1234567890abcdef0" ] } ``` + Einzelheiten zur API finden Sie [RunScheduledInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/run-scheduled-instances.html)in der *AWS CLI Befehlsreferenz*. ### `search-local-gateway-routes` Das folgende Codebeispiel zeigt die Verwendung`search-local-gateway-routes`. **AWS CLI** **So suchen Sie in der Routing-Tabelle eines lokalen Gateways nach Routen** Im folgenden Beispiel für `search-local-gateway-routes` wird in der angegebenen Routing-Tabelle des lokalen Gateways nach statischen Routen gesucht. ``` aws ec2 search-local-gateway-routes \ --local-gateway-route-table-id lgw-rtb-059615ef7dEXAMPLE \ --filters "Name=type,Values=static" ``` Ausgabe: ``` { "Route": { "DestinationCidrBlock": "0.0.0.0/0", "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE", "Type": "static", "State": "deleted", "LocalGatewayRouteTableId": "lgw-rtb-059615ef7EXAMPLE" } } ``` + Einzelheiten zur API finden Sie [SearchLocalGatewayRoutes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/search-local-gateway-routes.html)in der *AWS CLI Befehlsreferenz*. ### `search-transit-gateway-multicast-groups` Das folgende Codebeispiel zeigt die Verwendung`search-transit-gateway-multicast-groups`. **AWS CLI** **So suchen Sie eine oder mehrere Multicast-Gruppen eines Transit-Gateways und geben die Informationen zur Gruppenmitgliedschaft zurück** Im folgenden Beispiel für `search-transit-gateway-multicast-groups` wird die Gruppenmitgliedschaft der angegebenen Multicast-Gruppe zurückgegeben. ``` aws ec2 search-transit-gateway-multicast-groups \ --transit-gateway-multicast-domain-id tgw-mcast-domain-000fb24d04EXAMPLE ``` Ausgabe: ``` { "MulticastGroups": [ { "GroupIpAddress": "224.0.1.0", "TransitGatewayAttachmentId": "tgw-attach-0372e72386EXAMPLE", "SubnetId": "subnet-0187aff814EXAMPLE", "ResourceId": "vpc-0065acced4EXAMPLE", "ResourceType": "vpc", "NetworkInterfaceId": "eni-03847706f6EXAMPLE", "GroupMember": false, "GroupSource": true, "SourceType": "static" } ] } ``` Weitere Informationen finden Sie unter [Multicast auf Transit-Gateways](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-multicast-overview.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [SearchTransitGatewayMulticastGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/search-transit-gateway-multicast-groups.html)in der *AWS CLI Befehlsreferenz*. ### `search-transit-gateway-routes` Das folgende Codebeispiel zeigt die Verwendung`search-transit-gateway-routes`. **AWS CLI** **So suchen Sie nach Routen in der angegebenen Routing-Tabelle eines Transit-Gateways** Im folgenden Beispiel für `search-transit-gateway-routes` werden alle Routen vom Typ `static` in der angegebenen Routing-Tabelle zurückgegeben. ``` aws ec2 search-transit-gateway-routes \ --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE \ --filters "Name=type,Values=static" ``` Ausgabe: ``` { "Routes": [ { "DestinationCidrBlock": "10.0.2.0/24", "TransitGatewayAttachments": [ { "ResourceId": "vpc-4EXAMPLE", "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE", "ResourceType": "vpc" } ], "Type": "static", "State": "active" }, { "DestinationCidrBlock": "10.1.0.0/24", "TransitGatewayAttachments": [ { "ResourceId": "vpc-4EXAMPLE", "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE", "ResourceType": "vpc" } ], "Type": "static", "State": "active" } ], "AdditionalRoutesAvailable": false } ``` Weitere Informationen finden Sie unter [Routing-Tabellen in Transit Gateway](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-route-tables.html) im *Handbuch für Transit Gateway*. + Einzelheiten zur API finden Sie [SearchTransitGatewayRoutes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/search-transit-gateway-routes.html)in der *AWS CLI Befehlsreferenz*. ### `send-diagnostic-interrupt` Das folgende Codebeispiel zeigt die Verwendung`send-diagnostic-interrupt`. **AWS CLI** **So senden Sie ein Diagnose-Interrupt** Im folgenden Beispiel für `send-diagnostic-interrupt` wird ein Diagnose-Interrupt an die angegebene Instance gesendet. ``` aws ec2 send-diagnostic-interrupt \ --instance-id i-1234567890abcdef0 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [SendDiagnosticInterrupt](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/send-diagnostic-interrupt.html)in der *AWS CLI Befehlsreferenz*. ### `start-instances` Das folgende Codebeispiel zeigt die Verwendung`start-instances`. **AWS CLI** **So starten Sie eine Amazon-EC2-Instance** In diesem Beispiel wird die angegebene Amazon-EBS-gestützte Instance gestartet. Befehl: ``` aws ec2 start-instances --instance-ids i-1234567890abcdef0 ``` Ausgabe: ``` { "StartingInstances": [ { "InstanceId": "i-1234567890abcdef0", "CurrentState": { "Code": 0, "Name": "pending" }, "PreviousState": { "Code": 80, "Name": "stopped" } } ] } ``` Weitere Informationen finden Sie unter Ihre Instance anhalten und starten im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. + Einzelheiten zur API finden Sie [StartInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/start-instances.html)in der *AWS CLI Befehlsreferenz*. ### `start-network-insights-access-scope-analysis` Das folgende Codebeispiel zeigt die Verwendung`start-network-insights-access-scope-analysis`. **AWS CLI** **So starten Sie eine Zugriffsbereichsanalyse von Network Insights** Im folgenden `start-network-insights-access-scope-analysis` Beispiel wird die Umfangsanalyse in Ihrem AWS Konto gestartet. ``` aws ec2 start-network-insights-access-scope-analysis \ --region us-east-1 \ --network-insights-access-scope-id nis-123456789111 ``` Ausgabe: ``` { "NetworkInsightsAccessScopeAnalysis": { "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789222", "NetworkInsightsAccessScopeAnalysisArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-access-scope-analysis/nisa-123456789222", "NetworkInsightsAccessScopeId": "nis-123456789111", "Status": "running", "StartDate": "2022-01-26T00:47:06.814000+00:00" } } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Network Access Analyzer using the AWS CLI](https://docs.aws.amazon.com/vpc/latest/network-access-analyzer/getting-started-cli.html) im *Network Access Analyzer-Handbuch*. + Einzelheiten zur API finden Sie [StartNetworkInsightsAccessScopeAnalysis](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/start-network-insights-access-scope-analysis.html)unter *AWS CLI Befehlsreferenz*. ### `start-network-insights-analysis` Das folgende Codebeispiel zeigt die Verwendung`start-network-insights-analysis`. **AWS CLI** **So analysieren Sie einen Pfad** Im folgenden Beispiel für `start-network-insights-analysis` wird der Pfad zwischen der Quelle und dem Ziel analysiert. Verwenden Sie den `describe-network-insights-analyses`-Befehl, um die Ergebnisse der Pfadanalyse anzuzeigen. ``` aws ec2 start-network-insights-analysis \ --network-insights-path-id nip-0b26f224f1d131fa8 ``` Ausgabe: ``` { "NetworkInsightsAnalysis": { "NetworkInsightsAnalysisId": "nia-02207aa13eb480c7a", "NetworkInsightsAnalysisArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-analysis/nia-02207aa13eb480c7a", "NetworkInsightsPathId": "nip-0b26f224f1d131fa8", "StartDate": "2021-01-20T22:58:37.495Z", "Status": "running" } } ``` Weitere Informationen finden Sie unter [Erste Schritte mit der AWS CLI](https://docs.aws.amazon.com/vpc/latest/reachability/getting-started-cli.html) im *Reachability Analyzer-Handbuch*. + Einzelheiten zur API finden Sie unter [StartNetworkInsightsAnalysis AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/start-network-insights-analysis.html)*Befehlsreferenz*. ### `start-vpc-endpoint-service-private-dns-verification` Das folgende Codebeispiel zeigt die Verwendung`start-vpc-endpoint-service-private-dns-verification`. **AWS CLI** **So leiten Sie den DNS-Verifizierungsprozess ein** Im folgenden Beispiel für `start-vpc-endpoint-service-private-dns-verification` wird der DNS-Verifizierungsprozess für den angegebenen Endpunktservice eingeleitet. ``` aws ec2 start-vpc-endpoint-service-private-dns-verification \ --service-id vpce-svc-071afff70666e61e0 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS PrivateLink Benutzerhandbuch* unter [DNS-Namen verwalten](https://docs.aws.amazon.com/vpc/latest/privatelink/manage-dns-names.html). + Einzelheiten zur API finden Sie [StartVpcEndpointServicePrivateDnsVerification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/start-vpc-endpoint-service-private-dns-verification.html)in der *AWS CLI Befehlsreferenz*. ### `stop-instances` Das folgende Codebeispiel zeigt die Verwendung`stop-instances`. **AWS CLI** **Beispiel 1: So halten Sie eine Amazon-EC2-Instance an** Im folgenden Beispiel für `stop-instances` wird die angegebene Amazon-EBS-gestützte Instance angehalten. ``` aws ec2 stop-instances \ --instance-ids i-1234567890abcdef0 ``` Ausgabe: ``` { "StoppingInstances": [ { "InstanceId": "i-1234567890abcdef0", "CurrentState": { "Code": 64, "Name": "stopping" }, "PreviousState": { "Code": 16, "Name": "running" } } ] } ``` Weitere Informationen finden Sie unter [Ihre Instance anhalten und starten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html) im *Benutzerhandbuch zu Amazon Elastic Compute Cloud*. **Beispiel 2: So versetzen Sie eine Amazon-EC2-Instance in den Ruhezustand** Im folgenden Beispiel für `stop-instances` wird eine Amazon-EBS-gestützte Instance in den Ruhezustand versetzt, wenn für sie der Ruhezustand aktiviert wurde und sie die Voraussetzungen für den Ruhezustand erfüllt. Nachdem die Instance in den Ruhezustand versetzt wurde, wird die Instance angehalten. ``` aws ec2 stop-instances \ --instance-ids i-1234567890abcdef0 \ --hibernate ``` Ausgabe: ``` { "StoppingInstances": [ { "CurrentState": { "Code": 64, "Name": "stopping" }, "InstanceId": "i-1234567890abcdef0", "PreviousState": { "Code": 16, "Name": "running" } } ] } ``` Weitere Informationen finden Sie unter [Ihre On-Demand-Linux-Instance in den Ruhezustand versetzen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html) im *Benutzerhandbuch zu Amazon Elastic Cloud Compute*. + Einzelheiten zur API finden Sie [StopInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/stop-instances.html)in der *AWS CLI Befehlsreferenz*. ### `terminate-client-vpn-connections` Das folgende Codebeispiel zeigt die Verwendung`terminate-client-vpn-connections`. **AWS CLI** **So beenden Sie eine Verbindung mit einem Client-VPN-Endpunkt** Im folgenden Beispiel für `terminate-client-vpn-connections` wird die angegebene Verbindung mit dem Client-VPN-Endpunkt beendet. ``` aws ec2 terminate-client-vpn-connections \ --client-vpn-endpoint-id vpn-endpoint-123456789123abcde \ --connection-id cvpn-connection-04edd76f5201e0cb8 ``` Ausgabe: ``` { "ClientVpnEndpointId": "vpn-endpoint-123456789123abcde", "ConnectionStatuses": [ { "ConnectionId": "cvpn-connection-04edd76f5201e0cb8", "PreviousStatus": { "Code": "active" }, "CurrentStatus": { "Code": "terminating" } } ] } ``` Weitere Informationen finden Sie unter [Clientverbindungen](https://docs.aws.amazon.com/vpn/latest/clientvpn-admin/cvpn-working-connections.html) im *Benutzerhandbuch für AWS Client VPN*. + Einzelheiten zur API finden Sie [TerminateClientVpnConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/terminate-client-vpn-connections.html)in der *AWS CLI Befehlsreferenz*. ### `terminate-instances` Das folgende Codebeispiel zeigt die Verwendung`terminate-instances`. **AWS CLI** **So beenden Sie eine Amazon-EC2-Instance** In diesem Beispiel wird die angegebene Instance beendet. Befehl: ``` aws ec2 terminate-instances --instance-ids i-1234567890abcdef0 ``` Ausgabe: ``` { "TerminatingInstances": [ { "InstanceId": "i-1234567890abcdef0", "CurrentState": { "Code": 32, "Name": "shutting-down" }, "PreviousState": { "Code": 16, "Name": "running" } } ] } ``` Weitere Informationen finden Sie unter Verwenden von Amazon-EC2-Instances im Benutzerhandbuch zu* die AWS -Befehlszeilenschnittstelle*. + Einzelheiten zur API finden Sie [TerminateInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/terminate-instances.html)in der *AWS CLI Befehlsreferenz*. ### `unassign-ipv6-addresses` Das folgende Codebeispiel zeigt die Verwendung`unassign-ipv6-addresses`. **AWS CLI** **Um die Zuweisung einer IPv6 Adresse zu einer Netzwerkschnittstelle aufzuheben** In diesem Beispiel wird die Zuweisung der angegebenen IPv6 Adresse zur angegebenen Netzwerkschnittstelle aufgehoben. Befehl: ``` aws ec2 unassign-ipv6-addresses --ipv6-addresses 2001:db8:1234:1a00:3304:8879:34cf:4071 --network-interface-id eni-23c49b68 ``` Ausgabe: ``` { "NetworkInterfaceId": "eni-23c49b68", "UnassignedIpv6Addresses": [ "2001:db8:1234:1a00:3304:8879:34cf:4071" ] } ``` + *Einzelheiten zur API finden Sie unter [UnassignIpv6Addresses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/unassign-ipv6-addresses.html) in AWS CLI der Befehlsreferenz.* ### `unassign-private-ip-addresses` Das folgende Codebeispiel zeigt die Verwendung`unassign-private-ip-addresses`. **AWS CLI** **So heben Sie die Zuweisung einer sekundären privaten IP-Adresse zu einer Netzwerkschnittstelle auf** In diesem Beispiel wird die Zuweisung der genannten privaten IP-Adressen zu der spezifizierten Netzwerkschnittstelle aufgehoben. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. Befehl: ``` aws ec2 unassign-private-ip-addresses --network-interface-id eni-e5aa89a3 --private-ip-addresses 10.0.0.82 ``` + Einzelheiten zur API finden Sie [UnassignPrivateIpAddresses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/unassign-private-ip-addresses.html)in der *AWS CLI Befehlsreferenz*. ### `unassign-private-nat-gateway-address` Das folgende Codebeispiel zeigt die Verwendung`unassign-private-nat-gateway-address`. **AWS CLI** **So haben Sie die Zuweisung einer privaten IP-Adresse zu Ihrem privaten NAT-Gateway auf** Im folgenden `unassign-private-nat-gateway-address` Beispiel wird die Zuweisung der angegebenen IP-Adresse zum angegebenen privaten NAT-Gateway aufgehoben. ``` aws ec2 unassign-private-nat-gateway-address \ --nat-gateway-id nat-1234567890abcdef0 \ --private-ip-addresses 10.0.20.197 ``` Ausgabe: ``` { "NatGatewayId": "nat-0ee3edd182361f662", "NatGatewayAddresses": [ { "NetworkInterfaceId": "eni-0065a61b324d1897a", "PrivateIp": "10.0.20.197", "IsPrimary": false, "Status": "unassigning" } ] } ``` Weitere Informationen finden Sie unter [NAT-Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) im *Benutzerhandbuch für Amazon VPC*. + Einzelheiten zur API finden Sie unter [UnassignPrivateNatGatewayAddress AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/unassign-private-nat-gateway-address.html)*Befehlsreferenz*. ### `unlock-snapshot` Das folgende Codebeispiel zeigt die Verwendung`unlock-snapshot`. **AWS CLI** **So entsperren Sie einen Snapshot** Im folgenden Beispiel für `unlock-snapshot` wird der angegebene Snapshot entsperrt. ``` aws ec2 unlock-snapshot \ --snapshot-id snap-0b5e733b4a8df6e0d ``` Ausgabe: ``` { "SnapshotId": "snap-0b5e733b4a8df6e0d" } ``` Weitere Informationen finden Sie unter [Snapshot Lock](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-snapshot-lock.html) im *Benutzerhandbuch für Amazon EBS*. + Einzelheiten zur API finden Sie [UnlockSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/unlock-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `unmonitor-instances` Das folgende Codebeispiel zeigt die Verwendung`unmonitor-instances`. **AWS CLI** **So deaktivieren Sie die detaillierte Überwachung für eine Instance** Dieser Beispielbefehl deaktiviert die detaillierte Überwachung für die angegebene Instance. Befehl: ``` aws ec2 unmonitor-instances --instance-ids i-1234567890abcdef0 ``` Ausgabe: ``` { "InstanceMonitorings": [ { "InstanceId": "i-1234567890abcdef0", "Monitoring": { "State": "disabling" } } ] } ``` + Einzelheiten zur API finden Sie [UnmonitorInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/unmonitor-instances.html)in der *AWS CLI Befehlsreferenz*. ### `update-security-group-rule-descriptions-egress` Das folgende Codebeispiel zeigt die Verwendung`update-security-group-rule-descriptions-egress`. **AWS CLI** **So aktualisieren Sie die Beschreibung einer Sicherheitsgruppenregel für ausgehenden Datenverkehr** Im folgenden `update-security-group-rule-descriptions-egress` Beispiel wird die Beschreibung der Sicherheitsgruppenregel für den angegebenen Port und IPv4 Adressbereich aktualisiert. Die Beschreibung „`Outbound HTTP access to server 2`“ ersetzt alle vorhandenen Beschreibungen für die Regel. ``` aws ec2 update-security-group-rule-descriptions-egress \ --group-id sg-02f0d35a850ba727f \ --ip-permissions IpProtocol=tcp,FromPort=80,ToPort=80,IpRanges=[{CidrIp=203.0.113.0/24,Description="Outbound HTTP access to server 2"}] ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Sicherheitsgruppenregeln](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html#security-group-rules) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [UpdateSecurityGroupRuleDescriptionsEgress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/update-security-group-rule-descriptions-egress.html)unter *AWS CLI Befehlsreferenz*. ### `update-security-group-rule-descriptions-ingress` Das folgende Codebeispiel zeigt die Verwendung`update-security-group-rule-descriptions-ingress`. **AWS CLI** **Beispiel 1: So aktualisieren Sie die Beschreibung einer Sicherheitsgruppenregel für eingehenden Datenverkehr mit einer CIDR-Quelle** Im folgenden `update-security-group-rule-descriptions-ingress` Beispiel wird die Beschreibung der Sicherheitsgruppenregel für den angegebenen Port und IPv4 Adressbereich aktualisiert. Die Beschreibung „`SSH access from ABC office`“ ersetzt alle vorhandenen Beschreibungen für die Regel. ``` aws ec2 update-security-group-rule-descriptions-ingress \ --group-id sg-02f0d35a850ba727f \ --ip-permissions IpProtocol=tcp,FromPort=22,ToPort=22,IpRanges='[{CidrIp=203.0.113.0/16,Description="SSH access from corpnet"}]' ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Sicherheitsgruppenregeln](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html#security-group-rules) im *Benutzerhandbuch für Amazon EC2*. **Beispiel 2: So aktualisieren Sie die Beschreibung einer Sicherheitsgruppenregel für eingehenden Datenverkehr mit einer Präfixlistenquelle** Im folgenden Beispiel für `update-security-group-rule-descriptions-ingress` wird die Beschreibung der Sicherheitsgruppenregel für den angegebenen Port und die Präfixliste aktualisiert. Die Beschreibung „`SSH access from ABC office`“ ersetzt alle vorhandenen Beschreibungen für die Regel. ``` aws ec2 update-security-group-rule-descriptions-ingress \ --group-id sg-02f0d35a850ba727f \ --ip-permissions IpProtocol=tcp,FromPort=22,ToPort=22,PrefixListIds='[{PrefixListId=pl-12345678,Description="SSH access from corpnet"}]' ``` Ausgabe: ``` { "Return": true } ``` Weitere Informationen finden Sie unter [Sicherheitsgruppenregeln](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html#security-group-rules) im *Benutzerhandbuch für Amazon EC2*. + Einzelheiten zur API finden Sie [UpdateSecurityGroupRuleDescriptionsIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/update-security-group-rule-descriptions-ingress.html)unter *AWS CLI Befehlsreferenz*. ### `withdraw-byoip-cidr` Das folgende Codebeispiel zeigt die Verwendung`withdraw-byoip-cidr`. **AWS CLI** **So beenden Sie die Werbung für einen Adressbereich** Im folgenden Beispiel für `withdraw-byoip-cidr` wird die Werbung für den angegebenen Adressbereich beendet. ``` aws ec2 withdraw-byoip-cidr --cidr 203.0.113.25/24 ``` Ausgabe: ``` { "ByoipCidr": { "Cidr": "203.0.113.25/24", "StatusMessage": "ipv4pool-ec2-1234567890abcdef0", "State": "advertised" } } ``` + Einzelheiten zur API finden Sie [WithdrawByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/withdraw-byoip-cidr.html)in der *AWS CLI Befehlsreferenz*. # Amazon EC2 Instance Connect-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon EC2 Instance Connect Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `send-ssh-public-key` Das folgende Codebeispiel zeigt, wie Sie`send-ssh-public-key`. **AWS CLI** **So senden Sie einen öffentlichen SSH-Schlüssel an eine Instance** Im folgenden Beispiel für `send-ssh-public-key` wird der angegebene öffentliche SSH-Schlüssel an die genannte Instance gesendet. Der Schlüssel wird verwendet, um den angegebenen Benutzer zu authentifizieren. ``` aws ec2-instance-connect send-ssh-public-key \ --instance-id i-1234567890abcdef0 \ --instance-os-user ec2-user \ --availability-zone us-east-2b \ --ssh-public-key file://path/my-rsa-key.pub ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [SendSshPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2-instance-connect/send-ssh-public-key.html)in der *AWS CLI Befehlsreferenz*. # Amazon ECR-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon ECR Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-check-layer-availability` Das folgende Codebeispiel zeigt, wie Sie`batch-check-layer-availability`. **AWS CLI** **So prüfen Sie die Verfügbarkeit eines Layers** Im folgenden Beispiel für `batch-check-layer-availability` wird die Verfügbarkeit eines Layers mit dem Digest `sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed` im `cluster-autoscaler`-Repository überprüft. ``` aws ecr batch-check-layer-availability \ --repository-name cluster-autoscaler \ --layer-digests sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed ``` Ausgabe: ``` { "layers": [ { "layerDigest": "sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed", "layerAvailability": "AVAILABLE", "layerSize": 2777, "mediaType": "application/vnd.docker.container.image.v1+json" } ], "failures": [] } ``` + Einzelheiten zur API finden Sie [BatchCheckLayerAvailability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/batch-check-layer-availability.html)in der *AWS CLI Befehlsreferenz*. ### `batch-delete-image` Das folgende Codebeispiel zeigt die Verwendung`batch-delete-image`. **AWS CLI** **Beispiel 1: So löschen Sie ein Image** Im folgenden Beispiel für `batch-delete-image` wird ein Image mit dem Tag `precise` im angegebenen Repository im Standard-Registry für ein Konto gelöscht. ``` aws ecr batch-delete-image \ --repository-name ubuntu \ --image-ids imageTag=precise ``` Ausgabe: ``` { "failures": [], "imageIds": [ { "imageTag": "precise", "imageDigest": "sha256:19665f1e6d1e504117a1743c0a3d3753086354a38375961f2e665416ef4b1b2f" } ] } ``` **Beispiel 2: So löschen Sie mehrere Images** Im folgenden Beispiel für `batch-delete-image` werden alle Images gelöscht, die mit `prod` und `team1` im angegebenen Repository markiert sind. ``` aws ecr batch-delete-image \ --repository-name MyRepository \ --image-ids imageTag=prod imageTag=team1 ``` Ausgabe: ``` { "imageIds": [ { "imageDigest": "sha256:123456789012", "imageTag": "prod" }, { "imageDigest": "sha256:567890121234", "imageTag": "team1" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Löschen von Images](https://docs.aws.amazon.com/AmazonECR/latest/userguide/delete_image.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [BatchDeleteImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/batch-delete-image.html)in der *AWS CLI Befehlsreferenz*. ### `batch-get-image` Das folgende Codebeispiel zeigt die Verwendung`batch-get-image`. **AWS CLI** **Beispiel 1: So rufen Sie ein Image ab** Im folgenden Beispiel für `batch-get-image` wird ein Image mit dem Tag `v1.13.6` in einem Repository mit dem Namen `cluster-autoscaler` im Standard-Registry für ein Konto abgerufen. ``` aws ecr batch-get-image \ --repository-name cluster-autoscaler \ --image-ids imageTag=v1.13.6 ``` Ausgabe: ``` { "images": [ { "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "imageId": { "imageDigest": "sha256:4a1c6567c38904384ebc64e35b7eeddd8451110c299e3368d2210066487d97e5", "imageTag": "v1.13.6" }, "imageManifest": "{\n \"schemaVersion\": 2,\n \"mediaType\": \"application/vnd.docker.distribution.manifest.v2+json\",\n \"config\": {\n \"mediaType\": \"application/vnd.docker.container.image.v1+json\",\n \"size\": 2777,\n \"digest\": \"sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed\"\n },\n \"layers\": [\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 17743696,\n \"digest\": \"sha256:39fafc05754f195f134ca11ecdb1c9a691ab0848c697fffeb5a85f900caaf6e1\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 2565026,\n \"digest\": \"sha256:8c8a779d3a537b767ae1091fe6e00c2590afd16767aa6096d1b318d75494819f\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 28005981,\n \"digest\": \"sha256:c44ba47496991c9982ee493b47fd25c252caabf2b4ae7dd679c9a27b6a3c8fb7\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 775,\n \"digest\": \"sha256:e2c388b44226544363ca007be7b896bcce1baebea04da23cbd165eac30be650f\"\n }\n ]\n}" } ], "failures": [] } ``` **Beispiel 2: So rufen Sie mehrere Images ab** Im folgenden Beispiel für `batch-get-image` werden Details aller Images angezeigt, die mit `prod` und `team1` im angegebenen Repository markiert sind. ``` aws ecr batch-get-image \ --repository-name MyRepository \ --image-ids imageTag=prod imageTag=team1 ``` Ausgabe: ``` { "images": [ { "registryId": "123456789012", "repositoryName": "MyRepository", "imageId": { "imageDigest": "sha256:123456789012", "imageTag": "prod" }, "imageManifest": "manifestExample1" }, { "registryId": "567890121234", "repositoryName": "MyRepository", "imageId": { "imageDigest": "sha256:123456789012", "imageTag": "team1" }, "imageManifest": "manifestExample2" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Images](https://docs.aws.amazon.com/AmazonECR/latest/userguide/images.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [BatchGetImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/batch-get-image.html)in der *AWS CLI Befehlsreferenz*. ### `complete-layer-upload` Das folgende Codebeispiel zeigt die Verwendung`complete-layer-upload`. **AWS CLI** **So schließen Sie den Upload eines Image-Layers ab** Im folgenden Beispiel für `complete-layer-upload` wird der Upload eines Image-Layers in das `layer-test`-Repository abgeschlossen. ``` aws ecr complete-layer-upload \ --repository-name layer-test \ --upload-id 6cb64b8a-9378-0e33-2ab1-b780fab8a9e9 \ --layer-digests 6cb64b8a-9378-0e33-2ab1-b780fab8a9e9:48074e6d3a68b39aad8ccc002cdad912d4148c0f92b3729323e ``` Ausgabe: ``` { "uploadId": "6cb64b8a-9378-0e33-2ab1-b780fab8a9e9", "layerDigest": "sha256:9a77f85878aa1906f2020a0ecdf7a7e962d57e882250acd773383224b3fe9a02", "repositoryName": "layer-test", "registryId": "130757420319" } ``` + Einzelheiten zur API finden Sie [CompleteLayerUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/complete-layer-upload.html)in der *AWS CLI Befehlsreferenz*. ### `create-repository` Das folgende Codebeispiel zeigt die Verwendung`create-repository`. **AWS CLI** **Beispiel 1: So erstellen Sie ein Repository** Im folgenden Beispiel für `create-repository` wird ein Repository innerhalb des angegebenen Namespace im Standard-Registry für ein Konto erstellt. ``` aws ecr create-repository \ --repository-name project-a/sample-repo ``` Ausgabe: ``` { "repository": { "registryId": "123456789012", "repositoryName": "project-a/sample-repo", "repositoryArn": "arn:aws:ecr:us-west-2:123456789012:repository/project-a/sample-repo" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Repositorys](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html) im *Benutzerhandbuch für Amazon ECR*. **Beispiel 2: So erstellen Sie ein Repository, das mit der Unveränderlichkeit von Image-Tags konfiguriert ist** Im folgenden Beispiel für `create-repository` wird im Standard-Registry für ein Konto ein Repository erstellt, das für die Unveränderlichkeit von Tags konfiguriert ist. ``` aws ecr create-repository \ --repository-name project-a/sample-repo \ --image-tag-mutability IMMUTABLE ``` Ausgabe: ``` { "repository": { "registryId": "123456789012", "repositoryName": "project-a/sample-repo", "repositoryArn": "arn:aws:ecr:us-west-2:123456789012:repository/project-a/sample-repo", "imageTagMutability": "IMMUTABLE" } } ``` Weitere Informationen finden Sie unter [Veränderlichkeit von Image-Tags](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-tag-mutability.html) im *Benutzerhandbuch für Amazon ECR*. **Beispiel 3: So erstellen Sie ein Repository, das mit einer Scan-Konfiguration konfiguriert ist** Im folgenden Beispiel für `create-repository` wird im Standard-Registry für ein Konto ein Repository erstellt, das für die Durchführung eines Scans auf Schwachstellen beim Pushen von Images konfiguriert ist. ``` aws ecr create-repository \ --repository-name project-a/sample-repo \ --image-scanning-configuration scanOnPush=true ``` Ausgabe: ``` { "repository": { "registryId": "123456789012", "repositoryName": "project-a/sample-repo", "repositoryArn": "arn:aws:ecr:us-west-2:123456789012:repository/project-a/sample-repo", "imageScanningConfiguration": { "scanOnPush": true } } } ``` Weitere Informationen finden Sie unter [Scannen von Images](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-scanning.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [CreateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/create-repository.html)in der *AWS CLI Befehlsreferenz*. ### `delete-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-lifecycle-policy`. **AWS CLI** **So löschen Sie eine Lebenszyklusrichtlinie für ein Repository** Im folgenden Beispiel für `delete-lifecycle-policy` wird die Lebenszyklusrichtlinie für das `hello-world`-Repository gelöscht. ``` aws ecr delete-lifecycle-policy \ --repository-name hello-world ``` Ausgabe: ``` { "registryId": "012345678910", "repositoryName": "hello-world", "lifecyclePolicyText": "{\"rules\":[{\"rulePriority\":1,\"description\":\"Remove untagged images.\",\"selection\":{\"tagStatus\":\"untagged\",\"countType\":\"sinceImagePushed\",\"countUnit\":\"days\",\"countNumber\":10},\"action\":{\"type\":\"expire\"}}]}", "lastEvaluatedAt": 0.0 } ``` + Einzelheiten zur API finden Sie [DeleteLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/delete-lifecycle-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-repository-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-repository-policy`. **AWS CLI** **So löschen Sie die Repository-Richtlinie für ein Repository** Im folgenden Beispiel für `delete-repository-policy` wird die Repository-Richtlinie für das `cluster-autoscaler`-Repository gelöscht. ``` aws ecr delete-repository-policy \ --repository-name cluster-autoscaler ``` Ausgabe: ``` { "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"allow public pull\",\n \"Effect\" : \"Allow\",\n \"Principal\" : \"*\",\n \"Action\" : [ \"ecr:BatchCheckLayerAvailability\", \"ecr:BatchGetImage\", \"ecr:GetDownloadUrlForLayer\" ]\n } ]\n}" } ``` + Einzelheiten zur API finden Sie [DeleteRepositoryPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/delete-repository-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-repository` Das folgende Codebeispiel zeigt die Verwendung`delete-repository`. **AWS CLI** **So löschen Sie ein Repository** Der folgende `delete-repository`-Beispielbefehl erzwingt das Löschen des angegebenen Repositorys im Standard-Registry für ein Konto. Das `--force`-Flag ist erforderlich, wenn das Repository Images enthält. ``` aws ecr delete-repository \ --repository-name ubuntu \ --force ``` Ausgabe: ``` { "repository": { "registryId": "123456789012", "repositoryName": "ubuntu", "repositoryArn": "arn:aws:ecr:us-west-2:123456789012:repository/ubuntu" } } ``` Weitere Informationen finden Sie unter [Löschen eines Repositorys](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-delete.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [DeleteRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/delete-repository.html)in der *AWS CLI Befehlsreferenz*. ### `describe-image-scan-findings` Das folgende Codebeispiel zeigt die Verwendung`describe-image-scan-findings`. **AWS CLI** **So beschreiben Sie die Scanergebnisse für ein Image** Im folgenden Beispiel für `describe-image-scan-findings` werden die Ergebnisse des Image-Scans für ein Image mithilfe des Image-Digests im angegebenen Repository der Standard-Registry für ein Konto zurückgegeben. ``` aws ecr describe-image-scan-findings \ --repository-name sample-repo \ --image-id imageDigest=sha256:74b2c688c700ec95a93e478cdb959737c148df3fbf5ea706abe0318726e885e6 ``` Ausgabe: ``` { "imageScanFindings": { "findings": [ { "name": "CVE-2019-5188", "description": "A code execution vulnerability exists in the directory rehashing functionality of E2fsprogs e2fsck 1.45.4. A specially crafted ext4 directory can cause an out-of-bounds write on the stack, resulting in code execution. An attacker can corrupt a partition to trigger this vulnerability.", "uri": "http://people.ubuntu.com/~ubuntu-security/cve/CVE-2019-5188", "severity": "MEDIUM", "attributes": [ { "key": "package_version", "value": "1.44.1-1ubuntu1.1" }, { "key": "package_name", "value": "e2fsprogs" }, { "key": "CVSS2_VECTOR", "value": "AV:L/AC:L/Au:N/C:P/I:P/A:P" }, { "key": "CVSS2_SCORE", "value": "4.6" } ] } ], "imageScanCompletedAt": 1579839105.0, "vulnerabilitySourceUpdatedAt": 1579811117.0, "findingSeverityCounts": { "MEDIUM": 1 } }, "registryId": "123456789012", "repositoryName": "sample-repo", "imageId": { "imageDigest": "sha256:74b2c688c700ec95a93e478cdb959737c148df3fbf5ea706abe0318726e885e6" }, "imageScanStatus": { "status": "COMPLETE", "description": "The scan was completed successfully." } } ``` Weitere Informationen finden Sie unter [Scannen von Images](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-scanning.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [DescribeImageScanFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/describe-image-scan-findings.html)in der *AWS CLI Befehlsreferenz*. ### `describe-images` Das folgende Codebeispiel zeigt die Verwendung`describe-images`. **AWS CLI** **So beschreiben Sie ein Image in einem Repository** Im folgenden `describe-images` Beispiel werden Details zu einem Bild im `cluster-autoscaler` Repository mit dem Tag angezeigt`v1.13.6`. ``` aws ecr describe-images \ --repository-name cluster-autoscaler \ --image-ids imageTag=v1.13.6 ``` Ausgabe: ``` { "imageDetails": [ { "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "imageDigest": "sha256:4a1c6567c38904384ebc64e35b7eeddd8451110c299e3368d2210066487d97e5", "imageTags": [ "v1.13.6" ], "imageSizeInBytes": 48318255, "imagePushedAt": 1565128275.0 } ] } ``` + Einzelheiten zur API finden Sie [DescribeImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/describe-images.html)unter *AWS CLI Befehlsreferenz*. ### `describe-repositories` Das folgende Codebeispiel zeigt die Verwendung`describe-repositories`. **AWS CLI** **So beschreiben Sie die Repositorys in einem Registry** In diesem Beispiel werden die Repositorys im Standard-Registry für ein Konto beschrieben. Befehl: ``` aws ecr describe-repositories ``` Ausgabe: ``` { "repositories": [ { "registryId": "012345678910", "repositoryName": "ubuntu", "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/ubuntu" }, { "registryId": "012345678910", "repositoryName": "test", "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/test" } ] } ``` + Einzelheiten zur API finden Sie [DescribeRepositories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/describe-repositories.html)in der *AWS CLI Befehlsreferenz*. ### `get-authorization-token` Das folgende Codebeispiel zeigt die Verwendung`get-authorization-token`. **AWS CLI** **So rufen Sie ein Autorisierungstoken für Ihr Standard-Registry ab** Mit dem folgenden `get-authorization-token`-Beispielbefehl wird ein Autorisierungstoken für Ihr Standard-Registry abgerufen. ``` aws ecr get-authorization-token ``` Ausgabe: ``` { "authorizationData": [ { "authorizationToken": "QVdTOkN...", "expiresAt": 1448875853.241, "proxyEndpoint": "https://123456789012.dkr.ecr.us-west-2.amazonaws.com" } ] } ``` + Einzelheiten zur API finden Sie [GetAuthorizationToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/get-authorization-token.html)in der *AWS CLI Befehlsreferenz*. ### `get-download-url-for-layer` Das folgende Codebeispiel zeigt die Verwendung`get-download-url-for-layer`. **AWS CLI** **So rufen Sie die Download-URL eines Layers ab** Im folgenden Beispiel für `get-download-url-for-layer` wird die Download-URL eines Layers mit dem Digest `sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed` im `cluster-autoscaler`-Repository angezeigt. ``` aws ecr get-download-url-for-layer \ --repository-name cluster-autoscaler \ --layer-digest sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed ``` Ausgabe: ``` { "downloadUrl": "https://prod-us-west-2-starport-layer-bucket.s3.us-west-2.amazonaws.com/e501-012345678910-9cb60dc0-7284-5643-3987-da6dac0465f0/04620aac-66a5-4167-8232-55ee7ef6d565?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20190814T220617Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=AKIA32P3D2JDNMVAJLGF%2F20190814%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=9161345894947a1672467a0da7a1550f2f7157318312fe4941b59976239c3337", "layerDigest": "sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed" } ``` + Einzelheiten zur API finden Sie [GetDownloadUrlForLayer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/get-download-url-for-layer.html)in der *AWS CLI Befehlsreferenz*. ### `get-lifecycle-policy-preview` Das folgende Codebeispiel zeigt die Verwendung`get-lifecycle-policy-preview`. **AWS CLI** **So rufen Sie Details für eine Lebenszyklus-Richtlinienvorschau ab** Im folgenden Beispiel für `get-lifecycle-policy-preview` wird das Ergebnis einer Lebenszyklus-Richtlinienvorschau für das angegebene Repository im Standard-Registry für ein Konto abgerufen. Befehl: ``` aws ecr get-lifecycle-policy-preview \ --repository-name "project-a/amazon-ecs-sample" ``` Ausgabe: ``` { "registryId": "012345678910", "repositoryName": "project-a/amazon-ecs-sample", "lifecyclePolicyText": "{\n \"rules\": [\n {\n \"rulePriority\": 1,\n \"description\": \"Expire images older than 14 days\",\n \"selection\": {\n \"tagStatus\": \"untagged\",\n \"countType\": \"sinceImagePushed\",\n \"countUnit\": \"days\",\n \"countNumber\": 14\n },\n \"action\": {\n \"type\": \"expire\"\n }\n }\n ]\n}\n", "status": "COMPLETE", "previewResults": [], "summary": { "expiringImageTotalCount": 0 } } ``` Weitere Informationen finden Sie unter [Lebenszyklusrichtlinien](https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [GetLifecyclePolicyPreview](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/get-lifecycle-policy-preview.html)in der *AWS CLI Befehlsreferenz*. ### `get-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`get-lifecycle-policy`. **AWS CLI** **So rufen Sie eine Lebenszyklusrichtlinie ab** Im folgenden Beispiel für `get-lifecycle-policy` werden Details der Lebenszyklusrichtlinie für das angegebene Repository im Standard-Registry für das angezeigt. ``` aws ecr get-lifecycle-policy \ --repository-name "project-a/amazon-ecs-sample" ``` Ausgabe: ``` { "registryId": "123456789012", "repositoryName": "project-a/amazon-ecs-sample", "lifecyclePolicyText": "{\"rules\":[{\"rulePriority\":1,\"description\":\"Expire images older than 14 days\",\"selection\":{\"tagStatus\":\"untagged\",\"countType\":\"sinceImagePushed\",\"countUnit\":\"days\",\"countNumber\":14},\"action\":{\"type\":\"expire\"}}]}", "lastEvaluatedAt": 1504295007.0 } ``` Weitere Informationen finden Sie unter [Lebenszyklusrichtlinien](https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [GetLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/get-lifecycle-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-login-password` Das folgende Codebeispiel zeigt die Verwendung`get-login-password`. **AWS CLI** **So rufen Sie ein Passwort ab, um sich bei einem Registry zu authentifizieren** Im folgenden Beispiel für `get-login-password` wird ein Passwort angezeigt, das Sie mit einem Containerclient Ihrer Wahl verwenden können, um sich bei einem beliebigen Amazon-ECR-Registry zu authentifizieren, auf das Ihr IAM-Prinzipal Zugriff hat. ``` aws ecr get-login-password ``` Ausgabe: ``` ``` Zur Verwendung mit der Docker-CLI leiten Sie die Ausgabe des `get-login-password`-Befehls an den `docker login`-Befehl weiter. Stellen Sie beim Abrufen des Passworts sicher, dass Sie dieselbe Region angeben, in der sich Ihr Amazon-ECR-Registry befindet. ``` aws ecr get-login-password \ --region \ | docker login \ --username AWS \ --password-stdin .dkr.ecr..amazonaws.com ``` Weitere Informationen finden Sie unter [Registry-Authentifizierung](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries#registry_auth) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [GetLoginPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/get-login-password.html)in der *AWS CLI Befehlsreferenz*. ### `get-login` Das folgende Codebeispiel zeigt die Verwendung`get-login`. **AWS CLI** **So rufen Sie einen Docker-Anmeldebefehl für Ihr Standard-Registry ab** In diesem Beispiel wird ein Befehl gedruckt, mit dem Sie sich bei Ihrem standardmäßigen Amazon-ECR-Registry anmelden können. Befehl: ``` aws ecr get-login ``` Ausgabe: ``` docker login -u AWS -p -e none https://.dkr.ecr..amazonaws.com ``` **So melden Sie sich beim Registry eines anderen Kontos an** In diesem Beispiel werden ein oder mehrere Befehle gedruckt, mit denen Sie sich bei Amazon-ECR-Registrys anmelden können, die mit anderen Konten verknüpft sind. Befehl: ``` aws ecr get-login --registry-ids 012345678910 023456789012 ``` Ausgabe: ``` docker login -u -p -e none docker login -u -p -e none ``` + Einzelheiten zur API finden Sie [GetLogin](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/get-login.html)in der *AWS CLI Befehlsreferenz*. ### `get-repository-policy` Das folgende Codebeispiel zeigt die Verwendung`get-repository-policy`. **AWS CLI** **So rufen Sie die Repository-Richtlinie für ein Repository ab** Im folgenden Beispiel für `get-repository-policy` werden Details zur Repository-Richtlinie für das `cluster-autoscaler`-Repository angezeigt. ``` aws ecr get-repository-policy \ --repository-name cluster-autoscaler ``` Ausgabe: ``` { "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"allow public pull\",\n \"Effect\" : \"Allow\",\n \"Principal\" : \"*\",\n \"Action\" : [ \"ecr:BatchCheckLayerAvailability\", \"ecr:BatchGetImage\", \"ecr:GetDownloadUrlForLayer\" ]\n } ]\n}" } ``` + Einzelheiten zur API finden Sie [GetRepositoryPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/get-repository-policy.html)in der *AWS CLI Befehlsreferenz*. ### `initiate-layer-upload` Das folgende Codebeispiel zeigt die Verwendung`initiate-layer-upload`. **AWS CLI** **So initiieren Sie einen Upload eines Image-Layers** Im folgenden Beispiel für `initiate-layer-upload` wird der Upload eines Image-Layers in das `layer-test`-Repository initiiert. ``` aws ecr initiate-layer-upload \ --repository-name layer-test ``` Ausgabe: ``` { "partSize": 10485760, "uploadId": "6cb64b8a-9378-0e33-2ab1-b780fab8a9e9" } ``` + Einzelheiten zur API finden Sie [InitiateLayerUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/initiate-layer-upload.html)in der *AWS CLI Befehlsreferenz*. ### `list-images` Das folgende Codebeispiel zeigt die Verwendung`list-images`. **AWS CLI** **So listen Sie die Images in einem Repository auf** Im folgenden Beispiel für `list-images` wird eine Liste der Images im `cluster-autoscaler`-Repository angezeigt. ``` aws ecr list-images \ --repository-name cluster-autoscaler ``` Ausgabe: ``` { "imageIds": [ { "imageDigest": "sha256:99c6fb4377e9a420a1eb3b410a951c9f464eff3b7dbc76c65e434e39b94b6570", "imageTag": "v1.13.8" }, { "imageDigest": "sha256:99c6fb4377e9a420a1eb3b410a951c9f464eff3b7dbc76c65e434e39b94b6570", "imageTag": "v1.13.7" }, { "imageDigest": "sha256:4a1c6567c38904384ebc64e35b7eeddd8451110c299e3368d2210066487d97e5", "imageTag": "v1.13.6" } ] } ``` + Einzelheiten zur API finden Sie [ListImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/list-images.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags für ein Repository auf** Im folgenden Beispiel für `list-tags-for-resource` wird eine Liste der Tags angezeigt, die dem `hello-world`-Repository zugeordnet sind. ``` aws ecr list-tags-for-resource \ --resource-arn arn:aws:ecr:us-west-2:012345678910:repository/hello-world ``` Ausgabe: ``` { "tags": [ { "Key": "Stage", "Value": "Integ" } ] } ``` + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-image-scanning-configuration` Das folgende Codebeispiel zeigt die Verwendung`put-image-scanning-configuration`. **AWS CLI** **So aktualisieren Sie die Image-Scan-Konfiguration für ein Repository** Im folgenden Beispiel für `put-image-scanning-configuration` wird die Image-Scan-Konfiguration für das angegebenes Repository aktualisiert. ``` aws ecr put-image-scanning-configuration \ --repository-name sample-repo \ --image-scanning-configuration scanOnPush=true ``` Ausgabe: ``` { "registryId": "012345678910", "repositoryName": "sample-repo", "imageScanningConfiguration": { "scanOnPush": true } } ``` Weitere Informationen finden Sie unter [Scannen von Images](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-scanning.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [PutImageScanningConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/put-image-scanning-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `put-image-tag-mutability` Das folgende Codebeispiel zeigt die Verwendung`put-image-tag-mutability`. **AWS CLI** **So aktualisieren Sie die Einstellung zur Veränderlichkeit von Image-Tags für ein Repository** Im folgenden Beispiel für `put-image-tag-mutability` wird das angegebene Repository für die Unveränderlichkeit von Tags konfiguriert. Dies verhindert das Überschreiben aller Image-Tags innerhalb des Repositorys. ``` aws ecr put-image-tag-mutability \ --repository-name hello-repository \ --image-tag-mutability IMMUTABLE ``` Ausgabe: ``` { "registryId": "012345678910", "repositoryName": "sample-repo", "imageTagMutability": "IMMUTABLE" } ``` Weitere Informationen finden Sie unter [Veränderlichkeit von Image-Tags](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-tag-mutability.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [PutImageTagMutability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/put-image-tag-mutability.html)in der *AWS CLI Befehlsreferenz*. ### `put-image` Das folgende Codebeispiel zeigt die Verwendung`put-image`. **AWS CLI** **So markieren Sie ein Image erneut mit seinem Manifest** Im folgenden Beispiel für `put-image` wird ein neues Tag im `hello-world`-Repository mit einem vorhandenen Image-Manifest erstellt. ``` aws ecr put-image \ --repository-name hello-world \ --image-tag 2019.08 \ --image-manifest file://hello-world.manifest.json ``` Inhalt von `hello-world.manifest.json`: ``` { "schemaVersion": 2, "mediaType": "application/vnd.docker.distribution.manifest.v2+json", "config": { "mediaType": "application/vnd.docker.container.image.v1+json", "size": 5695, "digest": "sha256:cea5fe7701b7db3dd1c372f3cea6f43cdda444fcc488f530829145e426d8b980" }, "layers": [ { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 39096921, "digest": "sha256:d8868e50ac4c7104d2200d42f432b661b2da8c1e417ccfae217e6a1e04bb9295" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 57938, "digest": "sha256:83251ac64627fc331584f6c498b3aba5badc01574e2c70b2499af3af16630eed" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 423, "digest": "sha256:589bba2f1b36ae56f0152c246e2541c5aa604b058febfcf2be32e9a304fec610" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 680, "digest": "sha256:d62ecaceda3964b735cdd2af613d6bb136a52c1da0838b2ff4b4dab4212bcb1c" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 162, "digest": "sha256:6d93b41cfc6bf0d2522b7cf61588de4cd045065b36c52bd3aec2ba0622b2b22b" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 28268840, "digest": "sha256:6986b4d4c07932c680b3587f2eac8b0e013568c003cc23b04044628a5c5e599f" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 35369152, "digest": "sha256:8c5ec60f10102dc8da0649d866c7c2f706e459d0bdc25c83ad2de86f4996c276" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 155, "digest": "sha256:cde50b1c594539c5f67cbede9aef95c9ae321ccfb857f7b251b45b84198adc85" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 28737, "digest": "sha256:2e102807ab72a73fc9abf53e8c50e421bdc337a0a8afcb242176edeec65977e4" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 190, "digest": "sha256:fc379bbd5ed37808772bef016553a297356c59b8f134659e6ee4ecb563c2f5a7" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 28748, "digest": "sha256:021db240dfccf5a1aff19507d17c0177e5888e518acf295b52204b1825e8b7ee" } ] } ``` Ausgabe: ``` { "image": { "registryId": "130757420319", "repositoryName": "hello-world", "imageId": { "imageDigest": "sha256:8ece96b74f87652876199d83bd107d0435a196133af383ac54cb82b6cc5283ae", "imageTag": "2019.08" }, "imageManifest": "{\n \"schemaVersion\": 2,\n \"mediaType\": \"application/vnd.docker.distribution.manifest.v2+json\",\n \"config\": {\n \"mediaType\": \"application/vnd.docker.container.image.v1+json\",\n \"size\": 5695,\n \"digest\": \"sha256:cea5fe7701b7db3dd1c372f3cea6f43cdda444fcc488f530829145e426d8b980\"\n },\n \"layers\": [\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 39096921,\n \"digest\": \"sha256:d8868e50ac4c7104d2200d42f432b661b2da8c1e417ccfae217e6a1e04bb9295\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 57938,\n \"digest\": \"sha256:83251ac64627fc331584f6c498b3aba5badc01574e2c70b2499af3af16630eed\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 423,\n \"digest\": \"sha256:589bba2f1b36ae56f0152c246e2541c5aa604b058febfcf2be32e9a304fec610\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 680,\n \"digest\": \"sha256:d62ecaceda3964b735cdd2af613d6bb136a52c1da0838b2ff4b4dab4212bcb1c\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 162,\n \"digest\": \"sha256:6d93b41cfc6bf0d2522b7cf61588de4cd045065b36c52bd3aec2ba0622b2b22b\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 28268840,\n \"digest\": \"sha256:6986b4d4c07932c680b3587f2eac8b0e013568c003cc23b04044628a5c5e599f\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 35369152,\n \"digest\": \"sha256:8c5ec60f10102dc8da0649d866c7c2f706e459d0bdc25c83ad2de86f4996c276\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 155,\n \"digest\": \"sha256:cde50b1c594539c5f67cbede9aef95c9ae321ccfb857f7b251b45b84198adc85\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 28737,\n \"digest\": \"sha256:2e102807ab72a73fc9abf53e8c50e421bdc337a0a8afcb242176edeec65977e4\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 190,\n \"digest\": \"sha256:fc379bbd5ed37808772bef016553a297356c59b8f134659e6ee4ecb563c2f5a7\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 28748,\n \"digest\": \"sha256:021db240dfccf5a1aff19507d17c0177e5888e518acf295b52204b1825e8b7ee\"\n }\n ]\n}\n" } } ``` + Einzelheiten zur API finden Sie [PutImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/put-image.html)in der *AWS CLI Befehlsreferenz*. ### `put-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`put-lifecycle-policy`. **AWS CLI** **So erstellen Sie eine Lebenszyklusrichtlinie** Im folgenden Beispiel für `put-lifecycle-policy` wird eine Lebenszyklusrichtlinie für das angegebene Repository im Standard-Registry für ein Konto erstellt. ``` aws ecr put-lifecycle-policy \ --repository-name "project-a/amazon-ecs-sample" \ --lifecycle-policy-text "file://policy.json" ``` Inhalt von `policy.json`: ``` { "rules": [ { "rulePriority": 1, "description": "Expire images older than 14 days", "selection": { "tagStatus": "untagged", "countType": "sinceImagePushed", "countUnit": "days", "countNumber": 14 }, "action": { "type": "expire" } } ] } ``` Ausgabe: ``` { "registryId": "", "repositoryName": "project-a/amazon-ecs-sample", "lifecyclePolicyText": "{\"rules\":[{\"rulePriority\":1,\"description\":\"Expire images older than 14 days\",\"selection\":{\"tagStatus\":\"untagged\",\"countType\":\"sinceImagePushed\",\"countUnit\":\"days\",\"countNumber\":14},\"action\":{\"type\":\"expire\"}}]}" } ``` Weitere Informationen finden Sie unter [Lebenszyklusrichtlinien](https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [PutLifeCyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/put-life-cycle-policy.html)in der *AWS CLI Befehlsreferenz*. ### `set-repository-policy` Das folgende Codebeispiel zeigt die Verwendung`set-repository-policy`. **AWS CLI** **So legen Sie die Repository-Richtlinie für ein Repository fest** Im folgenden Beispiel für `set-repository-policy` wird eine in einer Datei enthaltene Repository-Richtlinie an das `cluster-autoscaler`-Repository angehängt. ``` aws ecr set-repository-policy \ --repository-name cluster-autoscaler \ --policy-text file://my-policy.json ``` Inhalt von `my-policy.json`: ``` { "Version":"2012-10-17", "Statement" : [ { "Sid" : "allow public pull", "Effect" : "Allow", "Principal" : "*", "Action" : [ "ecr:BatchCheckLayerAvailability", "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer" ] } ] } ``` Ausgabe: ``` { "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"allow public pull\",\n \"Effect\" : \"Allow\",\n \"Principal\" : \"*\",\n \"Action\" : [ \"ecr:BatchCheckLayerAvailability\", \"ecr:BatchGetImage\", \"ecr:GetDownloadUrlForLayer\" ]\n } ]\n}" } ``` + Einzelheiten zur API finden Sie [SetRepositoryPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/set-repository-policy.html)in der *AWS CLI Befehlsreferenz*. ### `start-image-scan` Das folgende Codebeispiel zeigt die Verwendung`start-image-scan`. **AWS CLI** **So starten Sie einen Schwachstellenscan für ein Image** Im folgenden Beispiel für `start-image-scan` wird ein Image-Scan für den Image-Digest im angegebenen Repository gestartet und von diesem spezifiziert. ``` aws ecr start-image-scan \ --repository-name sample-repo \ --image-id imageDigest=sha256:74b2c688c700ec95a93e478cdb959737c148df3fbf5ea706abe0318726e885e6 ``` Ausgabe: ``` { "registryId": "012345678910", "repositoryName": "sample-repo", "imageId": { "imageDigest": "sha256:74b2c688c700ec95a93e478cdb959737c148df3fbf5ea706abe0318726e885e6" }, "imageScanStatus": { "status": "IN_PROGRESS" } } ``` Weitere Informationen finden Sie unter [Scannen von Images](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-scanning.html) im *Benutzerhandbuch für Amazon ECR*. + Einzelheiten zur API finden Sie [StartImageScan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/start-image-scan.html)in der *AWS CLI Befehlsreferenz*. ### `start-lifecycle-policy-preview` Das folgende Codebeispiel zeigt die Verwendung`start-lifecycle-policy-preview`. **AWS CLI** **So erstellen Sie eine Lebenszyklus-Richtlinienvorschau** Im folgenden Beispiel für `start-lifecycle-policy-preview` wird eine Lebenszyklus-Richtlinienvorschau, die durch eine JSON-Datei definiert ist, für das angegebene Repository erstellt. ``` aws ecr start-lifecycle-policy-preview \ --repository-name "project-a/amazon-ecs-sample" \ --lifecycle-policy-text "file://policy.json" ``` Inhalt von `policy.json`: ``` { "rules": [ { "rulePriority": 1, "description": "Expire images older than 14 days", "selection": { "tagStatus": "untagged", "countType": "sinceImagePushed", "countUnit": "days", "countNumber": 14 }, "action": { "type": "expire" } } ] } ``` Ausgabe: ``` { "registryId": "012345678910", "repositoryName": "project-a/amazon-ecs-sample", "lifecyclePolicyText": "{\n \"rules\": [\n {\n \"rulePriority\": 1,\n \"description\": \"Expire images older than 14 days\",\n \"selection\": {\n \"tagStatus\": \"untagged\",\n \"countType\": \"sinceImagePushed\",\n \"countUnit\": \"days\",\n \"countNumber\": 14\n },\n \"action\": {\n \"type\": \"expire\"\n }\n }\n ]\n}\n", "status": "IN_PROGRESS" } ``` + Einzelheiten zur API finden Sie [StartLifecyclePolicyPreview](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/start-lifecycle-policy-preview.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie ein Repository** Im folgenden Beispiel für `tag-resource` wird ein Tag mit dem Schlüssel `Stage` und dem Wert `Integ` im `hello-world`-Repository festgelegt. ``` aws ecr tag-resource \ --resource-arn arn:aws:ecr:us-west-2:012345678910:repository/hello-world \ --tags Key=Stage,Value=Integ ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So heben Sie die Markierung eines Repositorys auf** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem Schlüssel `Stage` aus dem `hello-world`-Repository entfernt. ``` aws ecr untag-resource \ --resource-arn arn:aws:ecr:us-west-2:012345678910:repository/hello-world \ --tag-keys Stage ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `upload-layer-part` Das folgende Codebeispiel zeigt die Verwendung`upload-layer-part`. **AWS CLI** **So laden Sie einen Layer-Teil hoch** Im folgenden Beispiel für `upload-layer-part` wird ein Teil des Image-Layers in das `layer-test`-Repository hochgeladen. ``` aws ecr upload-layer-part \ --repository-name layer-test \ --upload-id 6cb64b8a-9378-0e33-2ab1-b780fab8a9e9 \ --part-first-byte 0 \ --part-last-byte 8323314 \ --layer-part-blob file:///var/lib/docker/image/overlay2/layerdb/sha256/ff986b10a018b48074e6d3a68b39aad8ccc002cdad912d4148c0f92b3729323e/layer.b64 ``` Ausgabe: ``` { "uploadId": "6cb64b8a-9378-0e33-2ab1-b780fab8a9e9", "registryId": "012345678910", "lastByteReceived": 8323314, "repositoryName": "layer-test" } ``` + Einzelheiten zur API finden Sie [UploadLayerPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr/upload-layer-part.html)in der *AWS CLI Befehlsreferenz*. # Öffentliche Amazon ECR Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon ECR Public Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-delete-image` Das folgende Codebeispiel zeigt, wie Sie`batch-delete-image`. **AWS CLI** **Beispiel 1: Sie löschen ein Image mithilfe von Image-Digest-IDs, indem das Image und alle zugehörigen Tags innerhalb eines Repositorys in einem öffentlichen Registry gelöscht werden** Im folgenden Beispiel für `batch-delete-image` wird ein Image gelöscht, indem der Image-Digest angegeben wird. ``` aws ecr-public batch-delete-image \ --repository-name project-a/nginx-web-app \ --image-ids imageDigest=sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2 ``` Ausgabe: ``` { "imageIds": [ { "imageDigest": "sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2", "imageTag": "latest" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Löschen eines Image in einem öffentlichen Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/public-image-delete.html) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 2: Sie löschen ein beliebiges Image, indem Sie das Tag angeben, das dem Image zugeordnet ist, das Sie aus dem Repository löschen möchten.** Im folgenden Beispiel für `batch-delete-image` wird ein Image gelöscht, indem das Tag angegeben wird, das mit dem Image-Repository namens `project-a/nginx-web-app` in einem öffentlichen Registry verknüpft ist. Wenn Sie nur ein Tag vorliegen haben und diesen Befehl ausführen, wird das Image entfernt. Haben Sie hingegen mehrere Tags für dasselbe Image vorliegen, geben Sie ein Tag an, sodass nur das Tag und nicht das Image aus dem Repository entfernt wird. ``` aws ecr-public batch-delete-image \ --repository-name project-a/nginx-web-app \ --image-ids imageTag=_temp ``` Ausgabe: ``` { "imageIds": [ { "imageDigest": "sha256:f7a86a0760e2f8d7eff07e515fc87bf4bac45c35376c06f9a280f15ecad6d7e0", "imageTag": "_temp" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Löschen eines Image in einem öffentlichen Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/public-image-delete.html) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 3: Zum Löschen mehrerer Images können Sie mehrere Image-Tags oder Image-Digests in der Anforderung für ein Repository in einem öffentlichen Registry angeben.** Im folgenden `batch-delete-image` Beispiel werden mehrere Bilder aus einem Repository mit dem Namen project-a/ gelöscht, nginx-web-app indem in der Anforderung mehrere Bild-Tags oder Bildauszüge angegeben werden. ``` aws ecr-public batch-delete-image \ --repository-name project-a/nginx-web-app \ --image-ids imageTag=temp2.0 imageDigest=sha256:47ba980bc055353d9c0af89b1894f68faa43ca93856917b8406316be86f01278 ``` Ausgabe: ``` { "imageIds": [ { "imageDigest": "sha256:47ba980bc055353d9c0af89b1894f68faa43ca93856917b8406316be86f01278" }, { "imageDigest": "sha256:f7a86a0760e2f8d7eff07e515fc87bf4bac45c35376c06f9a280f15ecad6d7e0", "imageTag": "temp2.0" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Löschen eines Image in einem öffentlichen Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/public-image-delete.html) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 4: Um ein Bild im AWS Cross-Account-Verzeichnis mithilfe der Registry-ID- und Imagedigest-IDs zu löschen, werden das Bild und alle zugehörigen Tags in einem Repository in einer öffentlichen Registrierung gelöscht** Im folgenden `batch-delete-image` Beispiel wird ein Bild gelöscht, indem der Image-Digest im Cross-Konto angegeben wird. AWS : ``` aws ecr-public batch-delete-image \ --registry-id 123456789098 \ --repository-name project-a/nginx-web-app \ --image-ids imageDigest=sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2 \ --region us-east-1 ``` Ausgabe: ``` { "imageIds": [ { "imageDigest": "sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2", "imageTag": "temp2.0" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Löschen eines Image in einem öffentlichen Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/public-image-delete.html) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten zur API finden Sie [BatchDeleteImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/batch-delete-image.html)in der *AWS CLI Befehlsreferenz*. ### `create-repository` Das folgende Codebeispiel zeigt die Verwendung`create-repository`. **AWS CLI** **Beispiel 1: So erstellen Sie ein Repository in einem öffentlichen Registry** Das folgende `create-repository` Beispiel erstellt ein Repository mit dem Namen project-a/ nginx-web-app in einer öffentlichen Registrierung. ``` aws ecr-public create-repository \ --repository-name project-a/nginx-web-app ``` Ausgabe: ``` { "repository": { "repositoryArn": "arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app", "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "repositoryUri": "public.ecr.aws/public-registry-custom-alias/project-a/nginx-web-app", "createdAt": "2024-07-01T21:08:55.131000+00:00" }, "catalogData": {} } ``` Weitere Informationen finden Sie unter [Erstellen eines öffentlichen Repositorys](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-create.html) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 2: So erstellen Sie ein Repository in einem öffentlichen Registry mit einer kurzen Beschreibung des Inhalts des Repositorys sowie der System- und Betriebsarchitektur, mit der die Images im Repository kompatibel sind** Das folgende `create-repository` Beispiel erstellt ein Repository mit dem Namen project-a/ nginx-web-app in einer öffentlichen Registrierung mit einer kurzen Beschreibung des Inhalts des Repositorys sowie der System- und Betriebsarchitektur, mit denen die Images im Repository kompatibel sind. ``` aws ecr-public create-repository \ --repository-name project-a/nginx-web-app \ --catalog-data 'description=My project-a ECR Public Repository,architectures=ARM,ARM 64,x86,x86-64,operatingSystems=Linux' ``` Ausgabe: ``` { "repository": { "repositoryArn": "arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app", "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "repositoryUri": "public.ecr.aws/public-registry-custom-alias/project-a/nginx-web-app", "createdAt": "2024-07-01T21:23:20.455000+00:00" }, "catalogData": { "description": "My project-a ECR Public Repository", "architectures": [ "ARM", "ARM 64", "x86", "x86-64" ], "operatingSystems": [ "Linux" ] } } ``` Weitere Informationen finden Sie unter [Erstellen eines öffentlichen Repositorys](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-create.html) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 3: Um ein Repository in einer öffentlichen Registrierung zusammen mit Informationen zu AboutText, UsageText logoImageBlob und Tags zu erstellen** Das folgende `create-repository` Beispiel erstellt ein Repository mit dem Namen project-a/ nginx-web-app in einer öffentlichen Registrierung zusammen mit logoImageBlob AboutText-, UsageText- und Tag-Informationen. ``` aws ecr-public create-repository \ --cli-input-json file://myfile.json ``` Inhalt von `myfile.json`: ``` { "repositoryName": "project-a/nginx-web-app", "catalogData": { "description": "My project-a ECR Public Repository", "architectures": [ "ARM", "ARM 64", "x86", "x86-64" ], "operatingSystems": [ "Linux" ], "logoImageBlob": "iVBORw0KGgoA<>ErkJggg==", "aboutText": "## Quick reference\n\nMaintained by: [the Amazon Linux Team](https://github.com/aws/amazon-linux-docker-images)\n\nWhere to get help: [the Docker Community Forums](https://forums.docker.com/), [the Docker Community Slack](https://dockr.ly/slack), or [Stack Overflow](https://stackoverflow.com/search?tab=newest&q=docker)\n\n## Supported tags and respective `dockerfile` links\n\n* [`2.0.20200722.0`, `2`, `latest`](https://github.com/amazonlinux/container-images/blob/03d54f8c4d522bf712cffd6c8f9aafba0a875e78/Dockerfile)\n* [`2.0.20200722.0-with-sources`, `2-with-sources`, `with-sources`](https://github.com/amazonlinux/container-images/blob/1e7349845e029a2e6afe6dc473ef17d052e3546f/Dockerfile)\n* [`2018.03.0.20200602.1`, `2018.03`, `1`](https://github.com/amazonlinux/container-images/blob/f10932e08c75457eeb372bf1cc47ea2a4b8e98c8/Dockerfile)\n* [`2018.03.0.20200602.1-with-sources`, `2018.03-with-sources`, `1-with-sources`](https://github.com/amazonlinux/container-images/blob/8c9ee491689d901aa72719be0ec12087a5fa8faf/Dockerfile)\n\n## What is Amazon Linux?\n\nAmazon Linux is provided by Amazon Web Services (AWS). It is designed to provide a stable, secure, and high-performance execution environment for applications running on Amazon EC2. The full distribution includes packages that enable easy integration with AWS, including launch configuration tools and many popular AWS libraries and tools. AWS provides ongoing security and maintenance updates to all instances running Amazon Linux.\n\nThe Amazon Linux container image contains a minimal set of packages. To install additional packages, [use `yum`](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/managing-software.html).\n\nAWS provides two versions of Amazon Linux: [Amazon Linux 2](https://aws.amazon.com/amazon-linux-2/) and [Amazon Linux AMI](https://aws.amazon.com/amazon-linux-ami/).\n\nFor information on security updates for Amazon Linux, please refer to [Amazon Linux 2 Security Advisories](https://alas.aws.amazon.com/alas2.html) and [Amazon Linux AMI Security Advisories](https://alas.aws.amazon.com/). Note that Docker Hub's vulnerability scanning for Amazon Linux is currently based on RPM versions, which does not reflect the state of backported patches for vulnerabilities.\n\n## Where can I run Amazon Linux container images?\n\nYou can run Amazon Linux container images in any Docker based environment. Examples include, your laptop, in Amazon EC2 instances, and Amazon ECS clusters.\n\n## License\n\nAmazon Linux is available under the [GNU General Public License, version 2.0](https://github.com/aws/amazon-linux-docker-images/blob/master/LICENSE). Individual software packages are available under their own licenses; run `rpm -qi [package name]` or check `/usr/share/doc/[package name]-*` and `/usr/share/licenses/[package name]-*` for details.\n\nAs with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).\n\nSome additional license information which was able to be auto-detected might be found in [the `repo-info` repository's `amazonlinux/` directory](https://github.com/docker-library/repo-info/tree/master/repos/amazonlinux).\n\n## Security\n\nFor information on security updates for Amazon Linux, please refer to [Amazon Linux 2 Security Advisories](https://alas.aws.amazon.com/alas2.html) and [Amazon Linux AMI Security Advisories](https://alas.aws.amazon.com/). Note that Docker Hub's vulnerability scanning for Amazon Linux is currently based on RPM versions, which does not reflect the state of backported patches for vulnerabilities.", "usageText": "## Supported architectures\n\namd64, arm64v8\n\n## Where can I run Amazon Linux container images?\n\nYou can run Amazon Linux container images in any Docker based environment. Examples include, your laptop, in Amazon EC2 instances, and ECS clusters.\n\n## How do I install a software package from Extras repository in Amazon Linux 2?\n\nAvailable packages can be listed with the `amazon-linux-extras` command. Packages can be installed with the `amazon-linux-extras install ` command. Example: `amazon-linux-extras install rust1`\n\n## Will updates be available for Amazon Linux containers?\n\nSimilar to the Amazon Linux images for Amazon EC2 and on-premises use, Amazon Linux container images will get ongoing updates from Amazon in the form of security updates, bug fix updates, and other enhancements. Security bulletins for Amazon Linux are available at https://alas.aws.amazon.com/\n\n## Will AWS Support the current version of Amazon Linux going forward?\n\nYes; in order to avoid any disruption to your existing applications and to facilitate migration to Amazon Linux 2, AWS will provide regular security updates for Amazon Linux 2018.03 AMI and container image for 2 years after the final LTS build is announced. You can also use all your existing support channels such as AWS Support and Amazon Linux Discussion Forum to continue to submit support requests." }, "tags": [ { "Key": "Name", "Value": "project-a/nginx-web-app" }, { "Key": "Environment", "Value": "Prod" } ] } ``` Ausgabe: ``` { "repository": { "repositoryArn": "arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app", "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "repositoryUri": "public.ecr.aws/public-registry-custom-alias/project-a/nginx-web-app", "createdAt": "2024-07-01T21:53:05.749000+00:00" }, "catalogData": { "description": "My project-a ECR Public Repository", "architectures": [ "ARM", "ARM 64", "x86", "x86-64" ], "operatingSystems": [ "Linux" ], "logoUrl": "https://d3g9o9u8re44ak.cloudfront.net/logo/23861450-4b9b-403c-9a4c-7aa0ef140bb8/2f9bf5a7-a32f-45b4-b5cd-c5770a35e6d7.png", "aboutText": "## Quick reference\n\nMaintained by: [the Amazon Linux Team](https://github.com/aws/amazon-linux-docker-images)\n\nWhere to get help: [the Docker Community Forums](https://forums.docker.com/), [the Docker Community Slack](https://dockr.ly/slack), or [Stack Overflow](https://stackoverflow.com/search?tab=newest&q=docker)\n\n## Supported tags and respective `dockerfile` links\n\n* [`2.0.20200722.0`, `2`, `latest`](https://github.com/amazonlinux/container-images/blob/03d54f8c4d522bf712cffd6c8f9aafba0a875e78/Dockerfile)\n* [`2.0.20200722.0-with-sources`, `2-with-sources`, `with-sources`](https://github.com/amazonlinux/container-images/blob/1e7349845e029a2e6afe6dc473ef17d052e3546f/Dockerfile)\n* [`2018.03.0.20200602.1`, `2018.03`, `1`](https://github.com/amazonlinux/container-images/blob/f10932e08c75457eeb372bf1cc47ea2a4b8e98c8/Dockerfile)\n* [`2018.03.0.20200602.1-with-sources`, `2018.03-with-sources`, `1-with-sources`](https://github.com/amazonlinux/container-images/blob/8c9ee491689d901aa72719be0ec12087a5fa8faf/Dockerfile)\n\n## What is Amazon Linux?\n\nAmazon Linux is provided by Amazon Web Services (AWS). It is designed to provide a stable, secure, and high-performance execution environment for applications running on Amazon EC2. The full distribution includes packages that enable easy integration with AWS, including launch configuration tools and many popular AWS libraries and tools. AWS provides ongoing security and maintenance updates to all instances running Amazon Linux.\n\nThe Amazon Linux container image contains a minimal set of packages. To install additional packages, [use `yum`](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/managing-software.html).\n\nAWS provides two versions of Amazon Linux: [Amazon Linux 2](https://aws.amazon.com/amazon-linux-2/) and [Amazon Linux AMI](https://aws.amazon.com/amazon-linux-ami/).\n\nFor information on security updates for Amazon Linux, please refer to [Amazon Linux 2 Security Advisories](https://alas.aws.amazon.com/alas2.html) and [Amazon Linux AMI Security Advisories](https://alas.aws.amazon.com/). Note that Docker Hub's vulnerability scanning for Amazon Linux is currently based on RPM versions, which does not reflect the state of backported patches for vulnerabilities.\n\n## Where can I run Amazon Linux container images?\n\nYou can run Amazon Linux container images in any Docker based environment. Examples include, your laptop, in Amazon EC2 instances, and Amazon ECS clusters.\n\n## License\n\nAmazon Linux is available under the [GNU General Public License, version 2.0](https://github.com/aws/amazon-linux-docker-images/blob/master/LICENSE). Individual software packages are available under their own licenses; run `rpm -qi [package name]` or check `/usr/share/doc/[package name]-*` and `/usr/share/licenses/[package name]-*` for details.\n\nAs with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).\n\nSome additional license information which was able to be auto-detected might be found in [the `repo-info` repository's `amazonlinux/` directory](https://github.com/docker-library/repo-info/tree/master/repos/amazonlinux).\n\n## Security\n\nFor information on security updates for Amazon Linux, please refer to [Amazon Linux 2 Security Advisories](https://alas.aws.amazon.com/alas2.html) and [Amazon Linux AMI Security Advisories](https://alas.aws.amazon.com/). Note that Docker Hub's vulnerability scanning for Amazon Linux is currently based on RPM versions, which does not reflect the state of backported patches for vulnerabilities.", "usageText": "## Supported architectures\n\namd64, arm64v8\n\n## Where can I run Amazon Linux container images?\n\nYou can run Amazon Linux container images in any Docker based environment. Examples include, your laptop, in Amazon EC2 instances, and ECS clusters.\n\n## How do I install a software package from Extras repository in Amazon Linux 2?\n\nAvailable packages can be listed with the `amazon-linux-extras` command. Packages can be installed with the `amazon-linux-extras install ` command. Example: `amazon-linux-extras install rust1`\n\n## Will updates be available for Amazon Linux containers?\n\nSimilar to the Amazon Linux images for Amazon EC2 and on-premises use, Amazon Linux container images will get ongoing updates from Amazon in the form of security updates, bug fix updates, and other enhancements. Security bulletins for Amazon Linux are available at https://alas.aws.amazon.com/\n\n## Will AWS Support the current version of Amazon Linux going forward?\n\nYes; in order to avoid any disruption to your existing applications and to facilitate migration to Amazon Linux 2, AWS will provide regular security updates for Amazon Linux 2018.03 AMI and container image for 2 years after the final LTS build is announced. You can also use all your existing support channels such as AWS Support and Amazon Linux Discussion Forum to continue to submit support requests." } } ``` Weitere Informationen finden Sie unter [Erstellen eines öffentlichen Repositorys](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-create.html) im *Benutzerhandbuch zu Amazon ECR Public* und [Repository-Katalogdaten](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-catalog-data.html) im *Benutzerhandbuch für Amazon ECR Public*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [CreateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/create-repository.html)AWS CLI * ### `delete-repository-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-repository-policy`. **AWS CLI** **So löschen Sie eine Repository-Richtlinie in einem öffentlichen Registry** Das folgende `delete-repository-policy` Beispiel löscht die Repository-Richtlinie für das ECR Public Repository in Ihrem AWS Konto. ``` aws ecr-public delete-repository-policy \ --repository-name project-a/nginx-web-app \ --region us-east-1 ``` Ausgabe: ``` { "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"AllowPush\",\n \"Effect\" : \"Allow\",\n \"Principal\" : {\n \"AWS\" : [ \"arn:aws:iam:"123456789012":user/eksuser1\", \"arn:aws:iam:"123456789012":user/admin\" ]\n },\n \"Action\" : [ \"ecr-public:BatchCheckLayerAvailability\", \"ecr-public:PutImage\", \"ecr-public:InitiateLayerUpload\", \"ecr-public:UploadLayerPart\", \"ecr-public:CompleteLayerUpload\" ]\n } ]\n}" } ``` Weitere Informationen finden Sie unter [Löschen einer Richtlinienanweisung eines öffentlichen Repositorys](https://docs.aws.amazon.com/AmazonECR/latest/public/delete-public-repository-policy.html) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten zur API finden Sie [DeleteRepositoryPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/delete-repository-policy.html)in der *AWS CLI Befehlsreferenz.* ### `delete-repository` Das folgende Codebeispiel zeigt die Verwendung`delete-repository`. **AWS CLI** **So löschen Sie ein Repository in einem öffentlichen Registry** Im folgenden Beispiel für `delete-repository` wird ein Repository mit dem Namen `project-a/nginx-web-app` aus Ihrem öffentlichen Registry gelöscht. ``` aws ecr-public delete-repository \ --repository-name project-a/nginx-web-app ``` Ausgabe: ``` { "repository": { "repositoryArn": "arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app", "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "repositoryUri": "public.ecr.aws/public-registry-custom-alias/project-a/nginx-web-app", "createdAt": "2024-07-01T22:14:50.103000+00:00" } } ``` Weitere Informationen finden Sie unter [Löschen eines öffentlichen Repositorys](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-delete.html) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten zur API finden Sie [DeleteRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/delete-repository.html)in der *AWS CLI Befehlsreferenz*. ### `describe-image-tags` Das folgende Codebeispiel zeigt die Verwendung`describe-image-tags`. **AWS CLI** **Beispiel 1: So beschreiben Sie die Details von Image-Tags im öffentlichen Repository** Im folgenden Beispiel für `describe-image-tags` wird „imagetags“ im Beispiel-Repository `project-a/nginx-web-app` beschrieben. ``` aws ecr-public describe-image-tags \ --repository-name project-a/nginx-web-app \ --region us-east-1 ``` Ausgabe: ``` { "imageTagDetails": [ { "imageTag": "latest", "createdAt": "2024-07-10T22:29:00-05:00", "imageDetail": { "imageDigest": "sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2", "imageSizeInBytes": 121956548, "imagePushedAt": "2024-07-10T22:29:00-05:00", "imageManifestMediaType": "application/vnd.docker.distribution.manifest.v2+json", "artifactMediaType": "application/vnd.docker.container.image.v1+json" } } ] } ``` + Einzelheiten zur API finden Sie [DescribeImageTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/describe-image-tags.html)in der *AWS CLI Befehlsreferenz*. ### `describe-images` Das folgende Codebeispiel zeigt die Verwendung`describe-images`. **AWS CLI** **Beispiel 1: So beschreiben Sie Images in einem Repository eines öffentlichen Registrys** Im folgenden Beispiel für `describe-images` wird „imagesDetails“ in einem Repository mit dem Namen `project-a/nginx-web-app` eines öffentlichen Registrys beschrieben. ``` aws ecr-public describe-images \ --repository-name project-a/nginx-web-app \ --region us-east-1 ``` Ausgabe: ``` { "imageDetails": [ { "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "imageDigest": "sha256:0d8c93e72e82fa070d49565c00af32abbe8ddfd7f75e39f4306771ae0628c7e8", "imageTags": [ "temp1.0" ], "imageSizeInBytes": 123184716, "imagePushedAt": "2024-07-23T11:32:49-05:00", "imageManifestMediaType": "application/vnd.docker.distribution.manifest.v2+json", "artifactMediaType": "application/vnd.docker.container.image.v1+json" }, { "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "imageDigest": "sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2", "imageTags": [ "temp2.0" ], "imageSizeInBytes": 121956548, "imagePushedAt": "2024-07-23T11:39:38-05:00", "imageManifestMediaType": "application/vnd.docker.distribution.manifest.v2+json", "artifactMediaType": "application/vnd.docker.container.image.v1+json" }, { "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "imageDigest": "sha256:f7a86a0760e2f8d7eff07e515fc87bf4bac45c35376c06f9a280f15ecad6d7e0", "imageTags": [ "temp3.0", "latest" ], "imageSizeInBytes": 232108879, "imagePushedAt": "2024-07-22T00:54:34-05:00", "imageManifestMediaType": "application/vnd.docker.distribution.manifest.v2+json", "artifactMediaType": "application/vnd.docker.container.image.v1+json" } ] } ``` Weitere Informationen finden Sie unter [Beschreiben eines Image in einem öffentlichen Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/docker-push-multi-architecture-image.html) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 2: Um Bilder aus dem Repository nach der Sortierung ImageTags & zu beschreiben imagePushedAt** Das folgende `describe-images` Beispiel beschreibt Bilder innerhalb eines Repositorys mit dem Namen project-a/ nginx-web-app in einer öffentlichen Registrierung. ``` aws ecr-public describe-images \ --repository-name project-a/nginx-web-app \ --query 'sort_by(imageDetails,& imagePushedAt)[*].imageTags[*]' \ --output text ``` Ausgabe: ``` temp3.0 latest temp1.0 temp2.0 ``` **Beispiel 3: So beschreiben Sie Images im Repository, um die letzten 2 Image-Tags zu generieren, die in das Repository übertragen wurden** Im folgenden Beispiel für `describe-images` werden die Details zu den imagetags aus dem Repository mit dem Namen `project-a/nginx-web-app` in einem öffentlichen Registry abgerufen und das Ergebnis abgefragt, sodass nur die ersten beiden Datensätze angezeigt werden. ``` aws ecr-public describe-images \ --repository-name project-a/nginx-web-app \ --query 'sort_by(imageDetails,& imagePushedAt)[*].imageTags[*] | [0:2]' \ --output text ``` Ausgabe: ``` temp3.0 latest temp1.0 ``` + *Einzelheiten zur API finden Sie [DescribeImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/describe-images.html)in AWS CLI der Befehlsreferenz.* ### `describe-registries` Das folgende Codebeispiel zeigt die Verwendung`describe-registries`. **AWS CLI** **So beschreiben Sie alle Registrys in einem öffentlichen Registry** Im folgenden Beispiel für `describe-registries` werden alle Registrys in Ihrem Konto beschrieben. ``` aws ecr-public describe-registries ``` Ausgabe: ``` { "registries": [ { "registryId": "123456789012", "registryArn": "arn:aws:ecr-public::123456789012:registry/123456789012", "registryUri": "public.ecr.aws/publicregistrycustomalias", "verified": false, "aliases": [ { "name": "publicregistrycustomalias", "status": "ACTIVE", "primaryRegistryAlias": true, "defaultRegistryAlias": true } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeRegistries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/describe-registries.html)in der *AWS CLI Befehlsreferenz*. ### `describe-repository` Das folgende Codebeispiel zeigt die Verwendung`describe-repository`. **AWS CLI** **Beispiel 1: So beschreiben Sie ein Repository in einem öffentlichen Registry** Im folgenden Beispiel für `describe-repositories` wird ein Repository mit dem Namen `project-a/nginx-web-app` in einem öffentlichen Registry beschrieben. ``` aws ecr-public describe-repositories \ --repository-name project-a/nginx-web-app ``` Ausgabe: ``` { "repositories": [ { "repositoryArn": "arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app", "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "repositoryUri": "public.ecr.aws/public-registry-custom-alias/project-a/nginx-web-app", "createdAt": "2024-07-07T00:07:56.526000-05:00" } ] } ``` **Beispiel 2: So beschreiben Sie alle Repositorys in einem öffentlichen Registry einer Tabelle** Im folgenden Beispiel für `describe-repositories` werden alle Repositorys in einem öffentlichen Registry beschrieben und dann die Repository-Namen in einem Tabellenformat ausgegeben. ``` aws ecr-public describe-repositories \ --region us-east-1 \ --output table \ --query "repositories[*].repositoryName" ``` Ausgabe: ``` ----------------------------- | DescribeRepositories | +---------------------------+ | project-a/nginx-web-app | | nginx | | myfirstrepo1 | | helm-test-chart | | test-ecr-public | | nginx-web-app | | sample-repo | +---------------------------+ ``` + Einzelheiten zur API finden Sie [DescribeRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/describe-repository.html)in der *AWS CLI Befehlsreferenz*. ### `get-authorization-token` Das folgende Codebeispiel zeigt die Verwendung`get-authorization-token`. **AWS CLI** **Beispiel 1: So rufen Sie ein Autorisierungstoken für ein öffentliches Amazon-ECR-Registry ab, auf das der IAM-Prinzipal Zugriff hat** Im folgenden `get-authorization-token` Beispiel wird ein Autorisierungstoken mit der AWS CLI abgerufen und auf eine Umgebungsvariable gesetzt. ``` aws ecr-public get-authorization-token \ --region us-east-1 ``` Ausgabe: ``` { "authorizationData": { "authorizationToken": "QVdTOmV5SndZWGxzYjJKJFHDSFKJHERWUY65IOU36TRYEGFNSDLRIUOTUYTHJKLDFGOcmFUQk9OSFV2UVV4a0x6Sm1ZV0Z6TDFndlZtUjJSVmgxVEVObU9IZEdTWEZxU210c1JUQm5RWGxOUVV4NlNFUnROWG92ZWtGbWJFUjRkbWMyV0U5amFpczRNWGxTVkM5Tk5qWkVUM2RDYm05TVJqSkxjV3BsUVZvMmFYSm5iV1ZvVFdGSVRqVlFMMHN4VnpsTGVXbDFRWGRoTmpsbWFuQllhbVl6TkdGaGMwUjJha2xsYUhscWRscHZTRUpFVkVnNVQwNUdOVFpPY2xZclVFNVFVWGRSVFZvd04xUkhjVGxZZFVkQ1ZFZHBPRUptUzBVclYxQldMMjVMVkRsd2VFVlNSa1EzTWpWSlIxRkVWakJGZFZOVWEzaFBSVk5FWWpSc1lWZHZWMHBSYmxaMlJYWmhZekpaWVVOeFppdFlUa2xKU1RCdFUwdElVbXRJYlhGRk1WaFhNVTVRTkdwc1FYRlVNVWxZZUhkV05Xa3ZXWGd3ZUVZMWIyeE5VRU5QZEdSaWRHOU9lakZOZVdwTVZEUkNRVzlvYzNKSlpsRXhhR2cwWjJwRVJFVjNWalEzYjNCUmRIcEZUR1pYU1Rsc1kxSlNNbU5hUW5wRE1tOUpRMHR5Y1hkeGNXNDVMMmx4Um5GUlVGQnhjMVpQZG5WYUswOW9SQ3RPY0hwSlRsUk5lVXQyY0c1b1FsQjVZVEprVmtSdmJsQklOM05RU3pkNmQydERhMkZ5VmxSRmFVUndWVlE1ZGtsVWFXUkJWMFZEWVhoSFdXTk5VMXBTYTFreVRHZEVlVVZ0ZFRWRk4xTTVjRXBDUjBRMlYyTkdPVWhGWkVweVVGcEVaRFJxZUVablkwNXFaamh5YkVKWmJGSTNOVzFXSzFjdllXSTVTMWx2YUZacksxSnJWSFJ0Wml0T1NFSnpWVFZvV204eVFYbzFWRU5SYjNaR01Va3hPR3h2TWxkNVJsSmpUbTVSTjNjemJsUkdVRlZKVDBjeE9VeHlXVEpGVFRSS2NWbFdkVEJrV0VreFVsSktXbkpCVGtsMFdVZEJOMjltWjFFNGVHRktNbGRuWlVoUlNXNXdZV3A0VjI5M2FYZGljbE5tZGpkQ1ZYTmhOVFUyTDBzeVpteDBka0pUTVdkNGJ6TkxkSEJDYml0cE0waGhTbVpEZEZkQ00yOU1TM1pXTDNSVFlWaFpWelZXVWxjNFRXNXdhR3BhUmpoU1FuWnFkRlJMVW5abGRYRlNjVVJKZDBaSFpXUTRabEZUTUdOTVQwcFFkVXAyYjA5Tk9UaFlZMjEwVnpFMlpXdE9hMnBWV0hST1owUkpVV3R1VFU1dGJXWjNNVGc0VTAxUlNHZE9TbXRMY2tWYWJVeFljVVk0ZWpsTFdWWlRNbEZMVDJkMk1FaFBTMDl5YzJSM1NqTlplRGhUWVVOQlJGWnRlbkU1WTBKVFdqTktSR05WTkd0RGNEVjZNalJHVXpkVk9HTnVSa2xLUVd4SVJDODJXbGcyYldGemJVczJPRVp6TDBoNFMwWkRUMmdyYldGa1QwWjVhMlZQTm5SQ1l6QkpNbFpyVUhSaGVIbFVOR296VjFGVlQyMHpNeTlPWVVoSk1FdDBWalZFU2pneU5rcHNLemQxZDNwcVp6RlNja3AwVm10VU0yRnRWWGMzZDJnMFduSnFjVXczWTBjclNXeHFUVlUyVkZwWGNWY3ZSV0V6WW1oT2JIRklZVlJHU1RrMGEyOVJiMHBPVUhORk9FdERjbFJZY0daS2VVdHRZa2x5YjFORE4zSkJaWEJPZUU5eGR6WnhZMlY1WXprM1JtSkZhVFZFYkVFck5EUk9ZMWRyVEVNd1dqa2lMQ0prWVhSaGEyVjVJam9pWlhsS1VWSkdaMmxQYVVwV1ZXeENhVk5YVm14WFdFWk5VMjFrV21SRE9YaGFhWFF4VkhwS1MyTkljSHBVUms0MFlWaHNTbUpIYUhsWFZHdDZZVWhqZDFKRmFETldNbFYyWTJ0cmVVMUlTbHBWUjJONFRURlJNMDlHYUd4U01uaHVWRVJzUWxaV1pGZFJibkJLV1RCYU5HTXpUakpXTUhoWFRrWndhRTVyTVVwVFZFSkdWV3RzTUZaVVpEQlRSVGxyVkVkb2FGUlVVWHBaTVhCSFQxWmFOVlJxU20xaVZXUnVTM3BaTlZaV2NIcFdWMlJGVkcwMVRHSXdSakpXUnpoNlVsUm5kbUpzUmpGT2FUazFWVzFTY0dWR1FtOVdiVEZoVmpKc1NWRllhRmRTUkZwc1V6SkdSbUpWYkhCVlNFbDJWVzB4Ym1OVk1IWmFhelZ3WkZoa1FtVnFUa3BpTTJoTVRWVk9jMVo2V2t4aWJFWnJWRVUxVW1ONlp6QldWVFZPWW14c01sZFlZekprUjFwVFkxaE9kRnBXWkhaVFZWcGhWa2MxU2xWRlVtdFRiWE16WWpOVmVrNXFSa2RVTTJSd1QwaGtXbVJIVVhsbGJYQkRaRlp2ZGxvd1ZqWmlNbEl4Vkc1T2FtSldjRU5VU0ZVd1kwZDRjbU14WkhaVVYwNTRaRzV2TWxSVlVsQmpiSEJPVkc1VmVsZEZPVzVYYkVwWlUyNWtVbGRZWkZWaVdFWlNUVzF3VFZSSVFraE9XRnBwWVZoak0xUnJXak5OYm04eFpEQk9XbEZzYkhSTmEyaHpaRmRTUTJORVFUQlpWMk01VUZOSmMwbHJiRUpTUTBrMlNXNUZlbHA2U1RGVVZXeFVZekIwYVU5RWFEVmtiRVpzVVZWc2QxbHJWbmxOYW13MVZWaG9UazVzVWpWbFJHaDZZMjFHVkZVeFFubFZXRTVLVGpCMGFXSlZNWGhpUjBwTVlUSTVNRTVVYXpCTE0wVnlWakF4VG1WSE5VcGtSa0pRVld4V1UwOVdVWGhqTVc4eVZraFdlVnA2VGsxV01tUnhVV3Q0ZEdGcVRsUk5hMnN5V2tSV2FtUkdVakZqVm5CUFVrUlNjR0pHUm1GbGFscDRXV2x6Y2xFd1VYcGhSRnBZVmtaU2FVNXVSVFZYYlVaVFpXdHdkVmRZVGpaVGEyaDBWMnhDVlU0elZrWlRSRUpIVlVWa2MwNVlhRFZsUkVwelQwWkNSbE5WY0ZGWFNFWXhaVmMxVEZsVE9VeFdhMGt4V1ROS1Rrd3pXazFpYkhCdFVrUldWRlJHVlhaTmJVazBZbFZzUkV3d2N6UldSV2MxVDBWa05tSXpiM2hXVms1V1ZtMDFiRkZUT1hoUFJVcHpUMGRzU2xaSVJrTkxNVTVFWWtaa05WWnViRmRYVjJRd1RXcG5kMVJWUmpCa1JYQkdZVlYwZFZNeU1VVlpWVTVQV25wa1ExZHFVbE5sUjBaRVlWVTFXbVZwY3pSTE1HTTFVbFZGTlZwRll6UlRSMVoxVFcxb05XTnJkRUpWZWxsM1RETmplbUV4WkdGU1JsWm9ZVVpzZEdWR2JFTlVNblJYVkRCNE5HUXlkRXhaTWxKTlYxZDBWRTB5YUZwaFJsazFVMGR3Y0ZGVk9YaGxhekV6VVZRd09VbHVNRDBpTENKMlpYSnphVzl1SWpvaU15SXNJblI1Y0dVaU9pSkVRVlJCWDB0RldTSXNJbVY0Y0dseVlYUnBiMjRpT2pFM01qRTVOVGMzTmpKOQ==", "expiresAt": "2024-07-25T21:37:26.301000-04:00" } } ``` Weitere Informationen finden Sie unter [Öffentliche Amazon-ECR-Registrys](https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#registry_auth_http) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 2: So rufen Sie ein Autorisierungstoken für ein öffentliches Amazon-ECR-Registry ab, auf das der IAM-Prinzipal Zugriff hat** Im folgenden `get-authorization-token` Beispiel wird ein Autorisierungstoken mit der AWS CLI abgerufen und auf eine Umgebungsvariable gesetzt. ``` aws ecr-public get-authorization-token \ --region us-east-1 \ --output=text \ --query 'authorizationData.authorizationToken' ``` Ausgabe: ``` QVdTOmV5SndZWGxzYjJKJFHDSFKJHERWUY65IOU36TRYEGFNSDLRIUOTUYTHJKLDFGOcmFUQk9OSFV2UVV4a0x6Sm1ZV0Z6TDFndlZtUjJSVmgxVEVObU9IZEdTWEZxU210c1JUQm5RWGxOUVV4NlNFUnROWG92ZWtGbWJFUjRkbWMyV0U5amFpczRNWGxTVkM5Tk5qWkVUM2RDYm05TVJqSkxjV3BsUVZvMmFYSm5iV1ZvVFdGSVRqVlFMMHN4VnpsTGVXbDFRWGRoTmpsbWFuQllhbVl6TkdGaGMwUjJha2xsYUhscWRscHZTRUpFVkVnNVQwNUdOVFpPY2xZclVFNVFVWGRSVFZvd04xUkhjVGxZZFVkQ1ZFZHBPRUptUzBVclYxQldMMjVMVkRsd2VFVlNSa1EzTWpWSlIxRkVWakJGZFZOVWEzaFBSVk5FWWpSc1lWZHZWMHBSYmxaMlJYWmhZekpaWVVOeFppdFlUa2xKU1RCdFUwdElVbXRJYlhGRk1WaFhNVTVRTkdwc1FYRlVNVWxZZUhkV05Xa3ZXWGd3ZUVZMWIyeE5VRU5QZEdSaWRHOU9lakZOZVdwTVZEUkNRVzlvYzNKSlpsRXhhR2cwWjJwRVJFVjNWalEzYjNCUmRIcEZUR1pYU1Rsc1kxSlNNbU5hUW5wRE1tOUpRMHR5Y1hkeGNXNDVMMmx4Um5GUlVGQnhjMVpQZG5WYUswOW9SQ3RPY0hwSlRsUk5lVXQyY0c1b1FsQjVZVEprVmtSdmJsQklOM05RU3pkNmQydERhMkZ5VmxSRmFVUndWVlE1ZGtsVWFXUkJWMFZEWVhoSFdXTk5VMXBTYTFreVRHZEVlVVZ0ZFRWRk4xTTVjRXBDUjBRMlYyTkdPVWhGWkVweVVGcEVaRFJxZUVablkwNXFaamh5YkVKWmJGSTNOVzFXSzFjdllXSTVTMWx2YUZacksxSnJWSFJ0Wml0T1NFSnpWVFZvV204eVFYbzFWRU5SYjNaR01Va3hPR3h2TWxkNVJsSmpUbTVSTjNjemJsUkdVRlZKVDBjeE9VeHlXVEpGVFRSS2NWbFdkVEJrV0VreFVsSktXbkpCVGtsMFdVZEJOMjltWjFFNGVHRktNbGRuWlVoUlNXNXdZV3A0VjI5M2FYZGljbE5tZGpkQ1ZYTmhOVFUyTDBzeVpteDBka0pUTVdkNGJ6TkxkSEJDYml0cE0waGhTbVpEZEZkQ00yOU1TM1pXTDNSVFlWaFpWelZXVWxjNFRXNXdhR3BhUmpoU1FuWnFkRlJMVW5abGRYRlNjVVJKZDBaSFpXUTRabEZUTUdOTVQwcFFkVXAyYjA5Tk9UaFlZMjEwVnpFMlpXdE9hMnBWV0hST1owUkpVV3R1VFU1dGJXWjNNVGc0VTAxUlNHZE9TbXRMY2tWYWJVeFljVVk0ZWpsTFdWWlRNbEZMVDJkMk1FaFBTMDl5YzJSM1NqTlplRGhUWVVOQlJGWnRlbkU1WTBKVFdqTktSR05WTkd0RGNEVjZNalJHVXpkVk9HTnVSa2xLUVd4SVJDODJXbGcyYldGemJVczJPRVp6TDBoNFMwWkRUMmdyYldGa1QwWjVhMlZQTm5SQ1l6QkpNbFpyVUhSaGVIbFVOR296VjFGVlQyMHpNeTlPWVVoSk1FdDBWalZFU2pneU5rcHNLemQxZDNwcVp6RlNja3AwVm10VU0yRnRWWGMzZDJnMFduSnFjVXczWTBjclNXeHFUVlUyVkZwWGNWY3ZSV0V6WW1oT2JIRklZVlJHU1RrMGEyOVJiMHBPVUhORk9FdERjbFJZY0daS2VVdHRZa2x5YjFORE4zSkJaWEJPZUU5eGR6WnhZMlY1WXprM1JtSkZhVFZFYkVFck5EUk9ZMWRyVEVNd1dqa2lMQ0prWVhSaGEyVjVJam9pWlhsS1VWSkdaMmxQYVVwV1ZXeENhVk5YVm14WFdFWk5VMjFrV21SRE9YaGFhWFF4VkhwS1MyTkljSHBVUms0MFlWaHNTbUpIYUhsWFZHdDZZVWhqZDFKRmFETldNbFYyWTJ0cmVVMUlTbHBWUjJONFRURlJNMDlHYUd4U01uaHVWRVJzUWxaV1pGZFJibkJLV1RCYU5HTXpUakpXTUhoWFRrWndhRTVyTVVwVFZFSkdWV3RzTUZaVVpEQlRSVGxyVkVkb2FGUlVVWHBaTVhCSFQxWmFOVlJxU20xaVZXUnVTM3BaTlZaV2NIcFdWMlJGVkcwMVRHSXdSakpXUnpoNlVsUm5kbUpzUmpGT2FUazFWVzFTY0dWR1FtOVdiVEZoVmpKc1NWRllhRmRTUkZwc1V6SkdSbUpWYkhCVlNFbDJWVzB4Ym1OVk1IWmFhelZ3WkZoa1FtVnFUa3BpTTJoTVRWVk9jMVo2V2t4aWJFWnJWRVUxVW1ONlp6QldWVFZPWW14c01sZFlZekprUjFwVFkxaE9kRnBXWkhaVFZWcGhWa2MxU2xWRlVtdFRiWE16WWpOVmVrNXFSa2RVTTJSd1QwaGtXbVJIVVhsbGJYQkRaRlp2ZGxvd1ZqWmlNbEl4Vkc1T2FtSldjRU5VU0ZVd1kwZDRjbU14WkhaVVYwNTRaRzV2TWxSVlVsQmpiSEJPVkc1VmVsZEZPVzVYYkVwWlUyNWtVbGRZWkZWaVdFWlNUVzF3VFZSSVFraE9XRnBwWVZoak0xUnJXak5OYm04eFpEQk9XbEZzYkhSTmEyaHpaRmRTUTJORVFUQlpWMk01VUZOSmMwbHJiRUpTUTBrMlNXNUZlbHA2U1RGVVZXeFVZekIwYVU5RWFEVmtiRVpzVVZWc2QxbHJWbmxOYW13MVZWaG9UazVzVWpWbFJHaDZZMjFHVkZVeFFubFZXRTVLVGpCMGFXSlZNWGhpUjBwTVlUSTVNRTVVYXpCTE0wVnlWakF4VG1WSE5VcGtSa0pRVld4V1UwOVdVWGhqTVc4eVZraFdlVnA2VGsxV01tUnhVV3Q0ZEdGcVRsUk5hMnN5V2tSV2FtUkdVakZqVm5CUFVrUlNjR0pHUm1GbGFscDRXV2x6Y2xFd1VYcGhSRnBZVmtaU2FVNXVSVFZYYlVaVFpXdHdkVmRZVGpaVGEyaDBWMnhDVlU0elZrWlRSRUpIVlVWa2MwNVlhRFZsUkVwelQwWkNSbE5WY0ZGWFNFWXhaVmMxVEZsVE9VeFdhMGt4V1ROS1Rrd3pXazFpYkhCdFVrUldWRlJHVlhaTmJVazBZbFZzUkV3d2N6UldSV2MxVDBWa05tSXpiM2hXVms1V1ZtMDFiRkZUT1hoUFJVcHpUMGRzU2xaSVJrTkxNVTVFWWtaa05WWnViRmRYVjJRd1RXcG5kMVJWUmpCa1JYQkdZVlYwZFZNeU1VVlpWVTVQV25wa1ExZHFVbE5sUjBaRVlWVTFXbVZwY3pSTE1HTTFVbFZGTlZwRll6UlRSMVoxVFcxb05XTnJkRUpWZWxsM1RETmplbUV4WkdGU1JsWm9ZVVpzZEdWR2JFTlVNblJYVkRCNE5HUXlkRXhaTWxKTlYxZDBWRTB5YUZwaFJsazFVMGR3Y0ZGVk9YaGxhekV6VVZRd09VbHVNRDBpTENKMlpYSnphVzl1SWpvaU15SXNJblI1Y0dVaU9pSkVRVlJCWDB0RldTSXNJbVY0Y0dseVlYUnBiMjRpT2pFM01qRTVOVGMzTmpKOQ ``` Weitere Informationen finden Sie unter [Öffentliche Amazon-ECR-Registrys](https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#registry_auth_http) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten zur API finden Sie [GetAuthorizationToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/get-authorization-token.html)unter *AWS CLI Befehlsreferenz*. ### `get-login-password` Das folgende Codebeispiel zeigt die Verwendung`get-login-password`. **AWS CLI** **Beispiel 1: So authentifizieren Sie Docker bei einem öffentlichen Amazon-ECR-Registry** Im folgenden `get-login-password` Beispiel wird mithilfe der GetAuthorizationToken API ein Authentifizierungstoken abgerufen und angezeigt, mit dem Sie sich bei einer öffentlichen Amazon ECR-Registrierung authentifizieren können. ``` aws ecr-public get-login-password \ --region us-east-1 | docker login \ --username AWS \ --password-stdin public.ecr.aws ``` Dieser Befehl erzeugt keine Ausgabe im Terminal, sondern leitet die Ausgabe stattdessen an Docker weiter. Weitere Informationen finden Sie unter [Authentifizieren bei der öffentlichen Registry](https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#public-registry-auth) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 2: So authentifizieren Sie Docker bei Ihrer eigenen benutzerdefinierten öffentlichen Registry von Amazon ECR** Im folgenden `get-login-password` Beispiel wird mithilfe der GetAuthorizationToken API ein Authentifizierungstoken abgerufen und angezeigt, mit dem Sie sich bei Ihrer eigenen benutzerdefinierten öffentlichen Amazon ECR-Registrierung authentifizieren können. ``` aws ecr-public get-login-password \ --region us-east-1 \ | docker login \ --username AWS \ --password-stdin public.ecr.aws/ ``` Dieser Befehl erzeugt keine Ausgabe im Terminal, sondern leitet die Ausgabe stattdessen an Docker weiter. Weitere Informationen finden Sie unter [Authentifizieren bei Ihrer eigenen Amazon ECR Public](https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#public-registry-auth) im *Benutzerhandbuch für Amazon ECR Public*. + *Einzelheiten zur API finden Sie [GetLoginPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/get-login-password.html)in AWS CLI der Befehlsreferenz.* ### `get-registry-catalog-data` Das folgende Codebeispiel zeigt die Verwendung`get-registry-catalog-data`. **AWS CLI** **So rufen Sie Katalogmetadaten für ein öffentliches ECR-Registry ab** Im folgenden Beispiel für `get-registry-catalog-data` werden Katalogmetadaten für ein öffentliches ECR-Registry abgerufen. ``` aws ecr-public get-registry-catalog-data \ --region us-east-1 ``` Ausgabe: ``` { "registryCatalogData": { "displayName": "YourCustomPublicRepositoryalias" } } ``` + Einzelheiten zur API finden Sie [GetRegistryCatalogData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/get-registry-catalog-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-repository-catalog-data` Das folgende Codebeispiel zeigt die Verwendung`get-repository-catalog-data`. **AWS CLI** **So rufen Sie Katalogmetadaten für ein Repository in einem öffentlichen Registry ab** Im folgenden Beispiel für `get-repository-catalog-data` werden die Katalogmetadaten für das Repository `project-a/nginx-web-app` in einem öffentlichen Registry aufgeführt. ``` aws ecr-public get-repository-catalog-data \ --repository-name project-a/nginx-web-app \ --region us-east-1 ``` Ausgabe: ``` { "catalogData": { "description": "My project-a ECR Public Repository", "architectures": [ "ARM", "ARM 64", "x86", "x86-64" ], "operatingSystems": [ "Linux" ], "logoUrl": "https://d3g9o9u8re44ak.cloudfront.net/logo/491d3846-8f33-4d8b-a10c-c2ce271e6c0d/4f09d87c-2569-4916-a932-5c296bf6f88a.png", "aboutText": "## Quick reference\n\nMaintained ", "usageText": "## Supported architectures\n\namd64, arm64v8\n\n## " } } ``` Weitere Informationen finden Sie unter [Repository-Katalogdaten](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-catalog-data.html) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten zur API finden Sie [GetRepositoryCatalogData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/get-repository-catalog-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-repository-policy` Das folgende Codebeispiel zeigt die Verwendung`get-repository-policy`. **AWS CLI** **So rufen Sie eine dem Repository zugeordnete Repository-Richtlinie ab** Im folgenden Beispiel für `get-repository-policy` wird eine Repository-Richtlinie abgerufen, die dem Repository zugeordnet ist. ``` aws ecr-public get-repository-policy \ --repository-name project-a/nginx-web-app \ --region us-east-1 ``` Ausgabe: ``` { "registryId": "123456789012", "repositoryName": "project-a/nginx-web-app", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"AllowPush\",\n \"Effect\" : \"Allow\",\n \"Principal\" : {\n \"AWS\" : [ \"arn:aws:iam::123456789012:user/eksuser1\", \"arn:aws:iam::123456789012:user/admin\" ]\n },\n \"Action\" : [ \"ecr-public:BatchCheckLayerAvailability\", \"ecr-public:PutImage\", \"ecr-public:InitiateLayerUpload\", \"ecr-public:UploadLayerPart\", \"ecr-public:CompleteLayerUpload\" ]\n } ]\n}" } ``` Weitere Informationen finden Sie unter [Verwendung GetRepositoryPolicy mit einem AWS SDK oder CLI](https://docs.aws.amazon.com/AmazonECR/latest/userguide/example_ecr_GetRepositoryPolicy_section.html) im *Amazon ECR Public User Guide*. + Einzelheiten zur API finden Sie unter [GetRepositoryPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/get-repository-policy.html)*Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für ein öffentliches Repository in einem öffentlichen Registry auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für eine Ressource mit dem Namen `project-a/nginx-web-app` in einem öffentlichen Registry aufgelistet. ``` aws ecr-public list-tags-for-resource \ --resource-arn arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app \ --region us-east-1 ``` Ausgabe: ``` { "tags": [ { "Key": "Environment", "Value": "Prod" }, { "Key": "stack", "Value": "dev1" }, { "Key": "Name", "Value": "project-a/nginx-web-app" } ] } ``` Weitere Informationen finden Sie unter [Auflisten von Tags für ein öffentliches Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/ecr-public-using-tags.html) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-registry-catalog-data` Das folgende Codebeispiel zeigt die Verwendung`put-registry-catalog-data`. **AWS CLI** **So erstellen oder aktualisieren Sie Katalogmetadaten für ein öffentliches ECR-Registry** Im folgenden Beispiel für `put-registry-catalog-data` werden Katalogmetadaten für ein öffentliches ECR-Registry erstellt oder aktualisiert. Nur Konten, die über das Badge „verifiziertes Konto“ verfügen, können einen Anzeigenamen für das Registry aufweisen. ``` aws ecr-public put-registry-catalog-data \ --region us-east-1 \ --display-name ``` Ausgabe: ``` { "registryCatalogData": { "displayName": "YourCustomPublicRepositoryalias" } } ``` + Einzelheiten zur API finden Sie [PutRegistryCatalogData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/put-registry-catalog-data.html)in der *AWS CLI Befehlsreferenz*. ### `put-repository-catalog-data` Das folgende Codebeispiel zeigt die Verwendung`put-repository-catalog-data`. **AWS CLI** **So erstellen oder aktualisieren Sie die Katalogdaten für ein Repository in einem öffentlichen Registry** Im folgenden `put-repository-catalog-data` Beispiel werden Katalogdaten für das Repository mit dem Namen project-a/ nginx-web-app in einer öffentlichen Registrierung zusammen mit logoImageBlob AboutText-, UsageText- und Tag-Informationen erstellt oder aktualisiert. ``` aws ecr-public put-repository-catalog-data \ --repository-name project-a/nginx-web-app \ --cli-input-json file://repository-catalog-data.json \ --region us-east-1 ``` Inhalt von `repository-catalog-data.json`: ``` { "repositoryName": "project-a/nginx-web-app", "catalogData": { "description": "My project-a ECR Public Repository", "architectures": [ "ARM", "ARM 64", "x86", "x86-64" ], "operatingSystems": [ "Linux" ], "logoImageBlob": "iVBORw0KGgoA<>ErkJggg==", "aboutText": "## Quick reference.", "usageText": "## Supported architectures are as follows." } } ``` Ausgabe: ``` { "catalogData": { "description": "My project-a ECR Public Repository", "architectures": [ "ARM", "ARM 64", "x86", "x86-64" ], "operatingSystems": [ "Linux" ], "logoUrl": "https://d3g9o9u8re44ak.cloudfront.net/logo/df86cf58-ee60-4061-b804-0be24d97ccb1/4a9ed9b2-69e4-4ede-b924-461462d20ef0.png", "aboutText": "## Quick reference.", "usageText": "## Supported architectures are as follows." } } ``` Weitere Informationen finden Sie unter [Repository-Katalogdaten](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-catalog-data.html) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten [PutRepositoryCatalogData AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/put-repository-catalog-data.html)*zur* API finden Sie unter Befehlsreferenz. ### `set-repository-policy` Das folgende Codebeispiel zeigt die Verwendung`set-repository-policy`. **AWS CLI** **Beispiel 1: So legen Sie eine Repository-Richtlinie fest, die eine Pull-Anforderung des Repositorys ermöglicht** Im folgenden Beispiel für `set-repository-policy` wird eine ECR-Richtlinie für öffentliche Repositorys auf das angegebene Repository angewendet, um die Zugriffsberechtigungen zu kontrollieren. ``` aws ecr-public set-repository-policy \ --repository-name project-a/nginx-web-app \ --policy-text file://my-repository-policy.json ``` Inhalt von `my-repository-policy.json`: ``` { "Version":"2012-10-17", "Statement" : [ { "Sid" : "allow public pull", "Effect" : "Allow", "Principal" : "*", "Action" : [ "ecr:BatchCheckLayerAvailability", "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer" ] } ] } ``` Ausgabe: ``` { "registryId": "12345678901", "repositoryName": "project-a/nginx-web-app", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"allow public pull\",\n \"Effect\" : \"Allow\",\n \"Principal\" : \"*\",\n \"Action\" : [ \"ecr:BatchCheckLayerAvailability\", \"ecr:BatchGetImage\", \"ecr:GetDownloadUrlForLayer\" ]\n } ]\n}" } ``` Weitere Informationen finden Sie unter [Festlegen einer Richtlinienanweisung für ein Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-policy-examples.html) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 2: So legen Sie eine Repository-Richtlinie fest, die es einem IAM-Benutzer in Ihrem Konto ermöglicht, Images zu pushen** Das folgende `set-repository-policy` Beispiel ermöglicht es einem IAM-Benutzer in Ihrem Konto, Bilder mithilfe der `file://my-repository-policy.json` als Richtlinientext benannten Eingabedatei in ein ECR-Repository in Ihrem AWS Konto zu übertragen. ``` aws ecr-public set-repository-policy \ --repository-name project-a/nginx-web-app \ --policy-text file://my-repository-policy.json ``` Inhalt von `my-repository-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowPush", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::account-id:user/push-pull-user-1", "arn:aws:iam::account-id:user/push-pull-user-2" ] }, "Action": [ "ecr-public:BatchCheckLayerAvailability", "ecr-public:PutImage", "ecr-public:InitiateLayerUpload", "ecr-public:UploadLayerPart", "ecr-public:CompleteLayerUpload" ] } ] } ``` Ausgabe: ``` { "registryId": "12345678901", "repositoryName": "project-a/nginx-web-app", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"AllowPush\",\n \"Effect\" : \"Allow\",\n \"Principal\" : {\n \"AWS\" : [ \"arn:aws:iam::12345678901:user/admin\", \"arn:aws:iam::12345678901:user/eksuser1\" ]\n },\n \"Action\" : [ \"ecr-public:BatchCheckLayerAvailability\", \"ecr-public:PutImage\", \"ecr-public:InitiateLayerUpload\", \"ecr-public:UploadLayerPart\", \"ecr-public:CompleteLayerUpload\" ]\n } ]\n}" } ``` Weitere Informationen finden Sie unter [Festlegen einer Richtlinienanweisung für ein Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-policy-examples.html) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 3: So legen Sie eine Repository-Richtlinie fest, die es einem IAM-Benutzer eines anderen Kontos ermöglicht, Images zu pushen** Das folgende `set-repository-policy` Beispiel ermöglicht es einem bestimmten Konto, Bilder mithilfe der CLI-Eingabedatei://my-repository-policy.json in Ihrem Konto zu pushen. AWS ``` aws ecr-public set-repository-policy \ --repository-name project-a/nginx-web-app \ --policy-text file://my-repository-policy.json ``` Inhalt von `my-repository-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowCrossAccountPush", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::other-or-same-account-id:role/RoleName" }, "Action": [ "ecr-public:BatchCheckLayerAvailability", "ecr-public:PutImage", "ecr-public:InitiateLayerUpload", "ecr-public:UploadLayerPart", "ecr-public:CompleteLayerUpload" ] } ] } ``` Ausgabe: ``` { "registryId": "12345678901", "repositoryName": "project-a/nginx-web-app", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"AllowCrossAccountPush\",\n \"Effect\" : \"Allow\",\n \"Principal\" : {\n \"AWS\" : \"arn:aws:iam::12345678901:role/RoleName\"\n },\n \"Action\" : [ \"ecr-public:BatchCheckLayerAvailability\", \"ecr-public:PutImage\", \"ecr-public:InitiateLayerUpload\", \"ecr-public:UploadLayerPart\", \"ecr-public:CompleteLayerUpload\" ]\n } ]\n}" } ``` Weitere Informationen finden Sie unter [Beispiele für Richtlinien öffentlicher Repositorys](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-policy-examples.html) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten zur API finden Sie [SetRepositoryPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/set-repository-policy.html)in der *AWS CLI Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Beispiel 1: So taggen Sie ein vorhandenes öffentliches Repository in einem öffentlichen Registry** Im folgenden Beispiel für `tag-resource` wird ein Repository mit dem Namen `project-a/nginx-web-app` in einem öffentlichen Registry getaggt. ``` aws ecr-public tag-resource \ --resource-arn arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app \ --tags Key=stack,Value=dev \ --region us-east-1 ``` Weitere Informationen finden Sie unter [Verwenden von Tags für ein öffentliches Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/ecr-public-using-tags.html) im *Benutzerhandbuch für Amazon ECR Public*. **Beispiel 2: So taggen Sie ein vorhandenes öffentliches Repository mit mehreren Tags in einem öffentlichen Registry.** Im folgenden Beispiel für `tag-resource` wird ein vorhandenes Repository mit mehreren Tags markiert. ``` aws ecr-public tag-resource \ --resource-arn arn:aws:ecr-public::890517186334:repository/project-a/nginx-web-app \ --tags Key=key1,Value=value1 Key=key2,Value=value2 Key=key3,Value=value3 \ --region us-east-1 ``` Weitere Informationen finden Sie unter [Verwenden von Tags für ein öffentliches Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/ecr-public-using-tags.html) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Beispiel 1: So heben Sie die Markierungen eines vorhandenen öffentlichen Repository in einer öffentlichen Registry auf** Im folgenden Beispiel für `untag-resource` wird ein Repository mit dem Namen `project-a/nginx-web-app` in einem öffentlichen Registry getaggt. ``` aws ecr-public untag-resource \ --resource-arn arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app \ --tag-keys stack \ --region us-east-1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden von Tags für ein öffentliches Repository](https://docs.aws.amazon.com/AmazonECR/latest/public/ecr-public-using-tags.html) im *Benutzerhandbuch für Amazon ECR Public*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecr-public/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # Amazon ECS-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon ECS Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `capacity-provider-update` Das folgende Codebeispiel zeigt, wie Sie`capacity-provider-update`. **AWS CLI** **So aktualisieren Sie den Kapazitätsanbieter in einem ECS-Cluster** Das folgende Beispiel für `update-capacity-provider` zeigt, wie wir die Parameter des Kapazitätsanbieters in einem ECS-Cluster ändern können. ``` aws ecs update-capacity-provider \ --name Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt \ --auto-scaling-group-provider "managedScaling={status=DISABLED,targetCapacity=50,minimumScalingStepSize=2,maximumScalingStepSize=30,instanceWarmupPeriod=200},managedTerminationProtection=DISABLED,managedDraining=DISABLED" ``` Ausgabe: ``` { "capacityProvider": { "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt", "name": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt", "status": "ACTIVE", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:424941d1-b43f-4a17-adbb-08b6a6e397e1:autoScalingGroupName/Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-ECSAutoScalingGroup-f44jrQHS2nRB", "managedScaling": { "status": "ENABLED", "targetCapacity": 100, "minimumScalingStepSize": 1, "maximumScalingStepSize": 10000, "instanceWarmupPeriod": 300 }, "managedTerminationProtection": "DISABLED", "managedDraining": "ENABLED" }, "updateStatus": "UPDATE_IN_PROGRESS", "tags": [] } } ``` Weitere Informationen zum Kapazitätsanbieter finden Sie unter [Amazon-ECS-Kapazitätsanbieter für den EC2-Starttyp](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/asg-capacity-providers.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [CapacityProviderUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/capacity-provider-update.html)in der *AWS CLI Befehlsreferenz*. ### `create-capacity-provider` Das folgende Codebeispiel zeigt die Verwendung`create-capacity-provider`. **AWS CLI** **Um einen Kapazitätsanbieter zu erstellen** Im folgenden create-capacity-provider Beispiel wird ein Kapazitätsanbieter erstellt, der eine Auto Scaling Scaling-Gruppe namens myASG verwendet, für die verwaltete Skalierung und der verwaltete Kündigungsschutz aktiviert sind. Diese Konfiguration wird für die automatische Skalierung von Amazon ECS-Clustern verwendet. ``` aws ecs create-capacity-provider \ --name "MyCapacityProvider" \ --auto-scaling-group-provider "autoScalingGroupArn=arn:aws:autoscaling:us-east-1:123456789012:autoScalingGroup:57ffcb94-11f0-4d6d-bf60-3bac5EXAMPLE:autoScalingGroupName/MyASG,managedScaling={status=ENABLED,targetCapacity=100},managedTerminationProtection=ENABLED" ``` Ausgabe: ``` { "capacityProvider": { "capacityProviderArn": "arn:aws:ecs:us-east-1:123456789012:capacity-provider/MyCapacityProvider", "name": "MyCapacityProvider", "status": "ACTIVE", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-east-1:132456789012:autoScalingGroup:57ffcb94-11f0-4d6d-bf60-3bac5EXAMPLE:autoScalingGroupName/MyASG", "managedScaling": { "status": "ENABLED", "targetCapacity": 100, "minimumScalingStepSize": 1, "maximumScalingStepSize": 10000, "instanceWarmupPeriod": 300 }, "managedTerminationProtection": "ENABLED" }, "tags": [] } ``` Weitere Informationen finden Sie unter [Auto Scaling von Amazon-ECS-Clustern](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-auto-scaling.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [CreateCapacityProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/create-capacity-provider.html)in der *AWS CLI Befehlsreferenz*. ### `create-cluster` Das folgende Codebeispiel zeigt die Verwendung`create-cluster`. **AWS CLI** **Beispiel 1: So erstellen Sie einen neuen Cluster** Im folgenden `create-cluster` Beispiel wird ein Cluster mit dem Namen CloudWatch Container Insights mit verbesserter Beobachtbarkeit erstellt `MyCluster` und aktiviert. ``` aws ecs create-cluster \ --cluster-name MyCluster \ --settings name=containerInsights,value=enhanced ``` Ausgabe: ``` { "cluster": { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "MyCluster", "status": "ACTIVE", "registeredContainerInstancesCount": 0, "pendingTasksCount": 0, "runningTasksCount": 0, "activeServicesCount": 0, "statistics": [], "settings": [ { "name": "containerInsights", "value": "enhanced" } ], "tags": [] } } ``` Weitere Informationen finden Sie unter [Erstellen eines Clusters](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create_cluster.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So erstellen Sie einen neuen Cluster mithilfe von Kapazitätsanbietern** Im folgenden Beispiel für `create-cluster` wird ein Cluster erstellt und diesem werden zwei bestehende Kapazitätsanbieter zugeordnet. Mit dem `create-capacity-provider`-Befehl erstellen Sie einen Kapazitätsanbieter. Die Angabe einer Standardstrategie für Kapazitätsanbieter ist optional, wird jedoch empfohlen. In diesem Beispiel erstellen wir einen Cluster mit dem Namen `MyCluster` und ordnen ihm die Kapazitätsanbieter `MyCapacityProvider1` und `MyCapacityProvider2` zu. Eine Standardstrategie für Kapazitätsanbieter wird festgelegt, bei der die Aufgaben gleichmäßig auf beide Kapazitätsanbieter verteilt werden. ``` aws ecs create-cluster \ --cluster-name MyCluster \ --capacity-providers MyCapacityProvider1 MyCapacityProvider2 \ --default-capacity-provider-strategy capacityProvider=MyCapacityProvider1,weight=1 capacityProvider=MyCapacityProvider2,weight=1 ``` Ausgabe: ``` { "cluster": { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "MyCluster", "status": "PROVISIONING", "registeredContainerInstancesCount": 0, "pendingTasksCount": 0, "runningTasksCount": 0, "activeServicesCount": 0, "statistics": [], "settings": [ { "name": "containerInsights", "value": "enabled" } ], "capacityProviders": [ "MyCapacityProvider1", "MyCapacityProvider2" ], "defaultCapacityProviderStrategy": [ { "capacityProvider": "MyCapacityProvider1", "weight": 1, "base": 0 }, { "capacityProvider": "MyCapacityProvider2", "weight": 1, "base": 0 } ], "attachments": [ { "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918", "type": "asp", "status": "PRECREATED", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider1" }, { "name": "scalingPlanName", "value": "ECSManagedAutoScalingPlan-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ] }, { "id": "ae592060-2382-4663-9476-b015c685593c", "type": "asp", "status": "PRECREATED", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider2" }, { "name": "scalingPlanName", "value": "ECSManagedAutoScalingPlan-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ] } ], "attachmentsStatus": "UPDATE_IN_PROGRESS" } } ``` Weitere Informationen finden Sie unter [Cluster-Kapazitätsanbieter](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-capacity-providers.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 3: So erstellen Sie einen neuen Cluster mit mehreren Tags** Im folgenden Beispiel für `create-cluster` wird ein Cluster mit mehreren Tags erstellt. *Weitere Informationen zum Hinzufügen von Tags mithilfe der Kurzsyntax finden Sie unter [Verwenden der Kurzsyntax mit der AWS Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-shorthand.html) im AWS CLI-Benutzerhandbuch.* ``` aws ecs create-cluster \ --cluster-name MyCluster \ --tags key=key1,value=value1 key=key2,value=value2 ``` Ausgabe: ``` { "cluster": { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "MyCluster", "status": "ACTIVE", "registeredContainerInstancesCount": 0, "pendingTasksCount": 0, "runningTasksCount": 0, "activeServicesCount": 0, "statistics": [], "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] } } ``` Weitere Informationen finden Sie unter [Erstellen eines Clusters](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create_cluster.html) im *Entwicklerhandbuch für Amazon ECS*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/create-cluster.html).AWS CLI * ### `create-service` Das folgende Codebeispiel zeigt die Verwendung`create-service`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Service mit einer Fargate-Aufgabe** Das folgende Beispiel für `create-service` zeigt, wie Sie einen Service mithilfe einer Fargate-Aufgabe erstellen. ``` aws ecs create-service \ --cluster MyCluster \ --service-name MyService \ --task-definition sample-fargate:1 \ --desired-count 2 \ --launch-type FARGATE \ --platform-version LATEST \ --network-configuration 'awsvpcConfiguration={subnets=[subnet-12344321],securityGroups=[sg-12344321],assignPublicIp=ENABLED}' \ --tags key=key1,value=value1 key=key2,value=value2 key=key3,value=value3 ``` Ausgabe: ``` { "service": { "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/MyCluster/MyService", "serviceName": "MyService", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "loadBalancers": [], "serviceRegistries": [], "status": "ACTIVE", "desiredCount": 2, "runningCount": 0, "pendingCount": 0, "launchType": "FARGATE", "platformVersion": "LATEST", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:1", "deploymentConfiguration": { "maximumPercent": 200, "minimumHealthyPercent": 100 }, "deployments": [ { "id": "ecs-svc/1234567890123456789", "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:1", "desiredCount": 2, "pendingCount": 0, "runningCount": 0, "createdAt": 1557119253.821, "updatedAt": 1557119253.821, "launchType": "FARGATE", "platformVersion": "1.3.0", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } } } ], "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", "events": [], "createdAt": 1557119253.821, "placementConstraints": [], "placementStrategy": [], "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "schedulingStrategy": "REPLICA", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" }, { "key": "key3", "value": "value3" } ], "enableECSManagedTags": false, "propagateTags": "NONE" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Service](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-service-console-v2.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So erstellen Sie einen Service mit dem EC2-Starttyp** Das folgende Beispiel für `create-service` zeigt, wie Sie einen Service mit dem Namen `ecs-simple-service` mithilfe einer Aufgabe erstellen, die den EC2-Starttyp verwendet. Der Service verwendet die `sleep360`-Aufgabendefinition und behält 1 Instanziierung der Aufgabe bei. ``` aws ecs create-service \ --cluster MyCluster \ --service-name ecs-simple-service \ --task-definition sleep360:2 \ --desired-count 1 ``` Ausgabe: ``` { "service": { "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/MyCluster/ecs-simple-service", "serviceName": "ecs-simple-service", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "loadBalancers": [], "serviceRegistries": [], "status": "ACTIVE", "desiredCount": 1, "runningCount": 0, "pendingCount": 0, "launchType": "EC2", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep360:2", "deploymentConfiguration": { "maximumPercent": 200, "minimumHealthyPercent": 100 }, "deployments": [ { "id": "ecs-svc/1234567890123456789", "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep360:2", "desiredCount": 1, "pendingCount": 0, "runningCount": 0, "createdAt": 1557206498.798, "updatedAt": 1557206498.798, "launchType": "EC2" } ], "events": [], "createdAt": 1557206498.798, "placementConstraints": [], "placementStrategy": [], "schedulingStrategy": "REPLICA", "enableECSManagedTags": false, "propagateTags": "NONE" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Service](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-service-console-v2.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 3: So erstellen Sie einen Service, der einen externen Bereitstellungs-Controller verwendet** Im folgenden Beispiel für `create-service` wird ein Service erstellt, der einen externen Bereitstellungs-Controller verwendet. ``` aws ecs create-service \ --cluster MyCluster \ --service-name MyService \ --deployment-controller type=EXTERNAL \ --desired-count 1 ``` Ausgabe: ``` { "service": { "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/MyCluster/MyService", "serviceName": "MyService", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "loadBalancers": [], "serviceRegistries": [], "status": "ACTIVE", "desiredCount": 1, "runningCount": 0, "pendingCount": 0, "launchType": "EC2", "deploymentConfiguration": { "maximumPercent": 200, "minimumHealthyPercent": 100 }, "taskSets": [], "deployments": [], "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", "events": [], "createdAt": 1557128207.101, "placementConstraints": [], "placementStrategy": [], "schedulingStrategy": "REPLICA", "deploymentController": { "type": "EXTERNAL" }, "enableECSManagedTags": false, "propagateTags": "NONE" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Service](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-service-console-v2.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 4: So erstellen Sie einen neuen Service hinter einem Load Balancer** Das folgende Beispiel für `create-service` zeigt, wie Sie einen Service erstellen, der sich hinter einem Load Balancer befindet. Sie müssen einen Load Balancer in derselben Region wie Ihre Container-Instance konfiguriert haben. In diesem Beispiel werden die Option `--cli-input-json` und eine JSON-Eingabedatei mit dem Namen `ecs-simple-service-elb.json` und dem folgenden Inhalt verwendet. ``` aws ecs create-service \ --cluster MyCluster \ --service-name ecs-simple-service-elb \ --cli-input-json file://ecs-simple-service-elb.json ``` Inhalt von `ecs-simple-service-elb.json`: ``` { "serviceName": "ecs-simple-service-elb", "taskDefinition": "ecs-demo", "loadBalancers": [ { "loadBalancerName": "EC2Contai-EcsElast-123456789012", "containerName": "simple-demo", "containerPort": 80 } ], "desiredCount": 10, "role": "ecsServiceRole" } ``` Ausgabe: ``` { "service": { "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/ecs-demo:1", "pendingCount": 0, "loadBalancers": [ { "containerName": "ecs-demo", "containerPort": 80, "loadBalancerName": "EC2Contai-EcsElast-123456789012" } ], "roleArn": "arn:aws:iam::123456789012:role/ecsServiceRole", "desiredCount": 10, "serviceName": "ecs-simple-service-elb", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/ecs-simple-service-elb", "deployments": [ { "status": "PRIMARY", "pendingCount": 0, "createdAt": 1428100239.123, "desiredCount": 10, "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/ecs-demo:1", "updatedAt": 1428100239.123, "id": "ecs-svc/1234567890123456789", "runningCount": 0 } ], "events": [], "runningCount": 0 } } ``` Weitere Informationen finden Sie unter [Verwenden von Load Balancing zur Verteilung des Amazon-ECS-Servicedatenverkehrs](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 5: So konfigurieren Sie Amazon-EBS-Volumes bei der Serviceerstellung** Das folgende Beispiel für `create-service` zeigt, wie Amazon-EBS-Volumes für jede Aufgabe konfiguriert werden, die vom Service verwaltet wird. Sie müssen über eine Amazon-ECS-Infrastrukturrolle verfügen, die mit der angehängten verwalteten Richtlinie `AmazonECSInfrastructureRolePolicyForVolumes` konfiguriert ist. Sie müssen eine Aufgabendefinition mit demselben Volume-Namen wie in der `create-service`-Anforderung angeben. In diesem Beispiel werden die Option `--cli-input-json` und eine JSON-Eingabedatei mit dem Namen `ecs-simple-service-ebs.json` und dem folgenden Inhalt verwendet. ``` aws ecs create-service \ --cli-input-json file://ecs-simple-service-ebs.json ``` Inhalt von `ecs-simple-service-ebs.json`: ``` { "cluster": "mycluster", "taskDefinition": "mytaskdef", "serviceName": "ecs-simple-service-ebs", "desiredCount": 2, "launchType": "FARGATE", "networkConfiguration":{ "awsvpcConfiguration":{ "assignPublicIp": "ENABLED", "securityGroups": ["sg-12344321"], "subnets":["subnet-12344321"] } }, "volumeConfigurations": [ { "name": "myEbsVolume", "managedEBSVolume": { "roleArn":"arn:aws:iam::123456789012:role/ecsInfrastructureRole", "volumeType": "gp3", "sizeInGiB": 100, "iops": 3000, "throughput": 125, "filesystemType": "ext4" } } ] } ``` Ausgabe: ``` { "service": { "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/mycluster/ecs-simple-service-ebs", "serviceName": "ecs-simple-service-ebs", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/mycluster", "loadBalancers": [], "serviceRegistries": [], "status": "ACTIVE", "desiredCount": 2, "runningCount": 0, "pendingCount": 0, "launchType": "EC2", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:3", "deploymentConfiguration": { "deploymentCircuitBreaker": { "enable": false, "rollback": false }, "maximumPercent": 200, "minimumHealthyPercent": 100 }, "deployments": [ { "id": "ecs-svc/7851020056849183687", "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:3", "desiredCount": 0, "pendingCount": 0, "runningCount": 0, "failedTasks": 0, "createdAt": "2025-01-21T11:32:38.034000-06:00", "updatedAt": "2025-01-21T11:32:38.034000-06:00", "launchType": "EC2", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "DISABLED" } }, "rolloutState": "IN_PROGRESS", "rolloutStateReason": "ECS deployment ecs-svc/7851020056849183687 in progress.", "volumeConfigurations": [ { "name": "myEBSVolume", "managedEBSVolume": { "volumeType": "gp3", "sizeInGiB": 100, "iops": 3000, "throughput": 125, "roleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole", "filesystemType": "ext4" } } ] } ], "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", "events": [], "createdAt": "2025-01-21T11:32:38.034000-06:00", "placementConstraints": [], "placementStrategy": [], "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "DISABLED" } }, "healthCheckGracePeriodSeconds": 0, "schedulingStrategy": "REPLICA", "deploymentController": { "type": "ECS" }, "createdBy": "arn:aws:iam::123456789012:user/AIDACKCEVSQ6C2EXAMPLE", "enableECSManagedTags": false, "propagateTags": "NONE", "enableExecuteCommand": false, "availabilityZoneRebalancing": "DISABLED" } } ``` Weitere Informationen finden Sie unter [Verwenden von Amazon-EBS-Volumes mit Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/create-service.html)in der *AWS CLI Befehlsreferenz*. ### `create-task-set` Das folgende Codebeispiel zeigt die Verwendung`create-task-set`. **AWS CLI** **So erstellen Sie einen Aufgabensatz** Im folgenden Beispiel für `create-task-set` wird ein Aufgabensatz in einem Service erstellt, der einen externen Bereitstellungs-Controller verwendet. ``` aws ecs create-task-set \ --cluster MyCluster \ --service MyService \ --task-definition MyTaskDefinition:2 \ --network-configuration "awsvpcConfiguration={subnets=[subnet-12344321],securityGroups=[sg-12344321]}" ``` Ausgabe: ``` { "taskSet": { "id": "ecs-svc/1234567890123456789", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/MyTaskDefinition:2", "computedDesiredCount": 0, "pendingCount": 0, "runningCount": 0, "createdAt": 1557128360.711, "updatedAt": 1557128360.711, "launchType": "EC2", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "DISABLED" } }, "loadBalancers": [], "serviceRegistries": [], "scale": { "value": 0.0, "unit": "PERCENT" }, "stabilityStatus": "STABILIZING", "stabilityStatusAt": 1557128360.711 } } ``` + Einzelheiten zur API finden Sie [CreateTaskSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/create-task-set.html)in der *AWS CLI Befehlsreferenz*. ### `delete-account-setting` Das folgende Codebeispiel zeigt die Verwendung`delete-account-setting`. **AWS CLI** **So löschen Sie die Kontoeinstellungen für einen bestimmten IAM-Benutzer oder eine bestimmte IAM-Rolle** Im folgenden Beispiel für `delete-account-setting` werden die Kontoeinstellungen für den bestimmten IAM-Benutzer oder die bestimmte IAM-Rolle gelöscht. ``` aws ecs delete-account-setting \ --name serviceLongArnFormat \ --principal-arn arn:aws:iam::123456789012:user/MyUser ``` Ausgabe: ``` { "setting": { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam::123456789012:user/MyUser" } } ``` Weitere Informationen finden Sie unter [Amazon Resource Names (ARNs) und IDs](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-resource-ids.html) im *Amazon ECS Developer Guide*. + Einzelheiten zur API finden Sie [DeleteAccountSetting](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/delete-account-setting.html)in der *AWS CLI Befehlsreferenz*. ### `delete-attributes` Das folgende Codebeispiel zeigt die Verwendung`delete-attributes`. **AWS CLI** **So löschen Sie ein oder mehrere benutzerdefinierte Attribute aus einer Amazon-ECS-Ressource** Im folgenden Beispiel für `delete-attributes` wird ein Attribut mit dem Namen `stack` aus einer Container-Instance gelöscht. ``` aws ecs delete-attributes \ --attributes name=stack,targetId=arn:aws:ecs:us-west-2:130757420319:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34 ``` Ausgabe: ``` { "attributes": [ { "name": "stack", "targetId": "arn:aws:ecs:us-west-2:130757420319:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34", "value": "production" } ] } ``` + Einzelheiten zur API finden Sie [DeleteAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/delete-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `delete-capacity-provider` Das folgende Codebeispiel zeigt die Verwendung`delete-capacity-provider`. **AWS CLI** **Beispiel 1: So löschen Sie einen Kapazitätsanbieter mit dem Amazon-Ressourcennamen (ARN)** Im folgenden Beispiel für `delete-capacity-provider` wird ein Kapazitätsanbieter gelöscht, indem der Amazon-Ressourcenname (ARN) des Kapazitätsanbieters angegeben wird. Der ARN sowie der Status der Löschung des Kapazitätsanbieters können mit dem `describe-capacity-providers`-Befehl abgerufen werden. ``` aws ecs delete-capacity-provider \ --capacity-provider arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider ``` Ausgabe: ``` { "capacityProvider": { "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider", "name": "ExampleCapacityProvider", "status": "ACTIVE", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup", "managedScaling": { "status": "ENABLED", "targetCapacity": 100, "minimumScalingStepSize": 1, "maximumScalingStepSize": 10000 }, "managedTerminationProtection": "DISABLED" }, "updateStatus": "DELETE_IN_PROGRESS", "tags": [] } } ``` Weitere Informationen finden Sie unter [Cluster-Kapazitätsanbieter](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-capacity-providers.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So löschen Sie einen Kapazitätsanbieter anhand des Namens** Im folgenden Beispiel für `delete-capacity-provider` wird ein Kapazitätsanbieter gelöscht, indem der Kurzname des Kapazitätsanbieters angegeben wird. Der Kurzname sowie der Status der Löschung des Kapazitätsanbieters können mit dem `describe-capacity-providers`-Befehl abgerufen werden. ``` aws ecs delete-capacity-provider \ --capacity-provider ExampleCapacityProvider ``` Ausgabe: ``` { "capacityProvider": { "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider", "name": "ExampleCapacityProvider", "status": "ACTIVE", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup", "managedScaling": { "status": "ENABLED", "targetCapacity": 100, "minimumScalingStepSize": 1, "maximumScalingStepSize": 10000 }, "managedTerminationProtection": "DISABLED" }, "updateStatus": "DELETE_IN_PROGRESS", "tags": [] } } ``` Weitere Informationen finden Sie unter [Cluster-Kapazitätsanbieter](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-capacity-providers.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DeleteCapacityProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/delete-capacity-provider.html)in der *AWS CLI Befehlsreferenz*. ### `delete-cluster` Das folgende Codebeispiel zeigt die Verwendung`delete-cluster`. **AWS CLI** **So löschen Sie einen leeren Cluster** Im folgenden Beispiel für `delete-cluster` wird der angegebene leere Cluster gelöscht. ``` aws ecs delete-cluster --cluster MyCluster ``` Ausgabe: ``` { "cluster": { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "status": "INACTIVE", "clusterName": "MyCluster", "registeredContainerInstancesCount": 0, "pendingTasksCount": 0, "runningTasksCount": 0, "activeServicesCount": 0 "statistics": [], "tags": [] } } ``` Weitere Informationen finden Sie unter [Löschen eines Clusters](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/delete_cluster.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/delete-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `delete-service` Das folgende Codebeispiel zeigt die Verwendung`delete-service`. **AWS CLI** **So löschen Sie einen Service** Im folgenden Beispiel für `ecs delete-service` wird der angegebene Service aus einem Cluster gelöscht. Sie können den `--force`-Parameter angeben, um den Service auch dann zu löschen, wenn er nicht auf null Aufgaben herunterskaliert wurde. ``` aws ecs delete-service --cluster MyCluster --service MyService1 --force ``` Weitere Informationen finden Sie unter [Löschen eines Service](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/delete-service.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DeleteService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/delete-service.html)in der *AWS CLI Befehlsreferenz*. ### `delete-task-definitions` Das folgende Codebeispiel zeigt die Verwendung`delete-task-definitions`. **AWS CLI** **So löschen Sie eine Aufgabendefinition** Im folgenden Beispiel für `delete-task-definitions` wird eine INACTIVE-Aufgabendefinition gelöscht. ``` aws ecs delete-task-definitions \ --task-definition curltest:1 ``` Ausgabe: ``` { "taskDefinitions": [ { "taskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:task-definition/curltest:1", "containerDefinitions": [ { "name": "ctest", "image": "mreferre/eksutils", "cpu": 0, "portMappings": [], "essential": true, "entryPoint": [ "sh", "-c" ], "command": [ "curl ${ECS_CONTAINER_METADATA_URI_V4}/task" ], "environment": [], "mountPoints": [], "volumesFrom": [], "logConfiguration": { "logDriver": "awslogs", "options": { "awslogs-create-group": "true", "awslogs-group": "/ecs/curltest", "awslogs-region": "us-east-1", "awslogs-stream-prefix": "ecs" } } } ], "family": "curltest", "taskRoleArn": "arn:aws:iam::123456789012:role/ecsTaskExecutionRole", "executionRoleArn": "arn:aws:iam::123456789012:role/ecsTaskExecutionRole", "networkMode": "awsvpc", "revision": 1, "volumes": [], "status": "DELETE_IN_PROGRESS", "compatibilities": [ "EC2", "FARGATE" ], "requiresCompatibilities": [ "FARGATE" ], "cpu": "256", "memory": "512", "registeredAt": "2021-09-10T12:56:24.704000+00:00", "deregisteredAt": "2023-03-14T15:20:59.419000+00:00", "registeredBy": "arn:aws:sts::123456789012:assumed-role/Admin/jdoe" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabendefinitionen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DeleteTaskDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/delete-task-definitions.html)in der *AWS CLI Befehlsreferenz*. ### `delete-task-set` Das folgende Codebeispiel zeigt die Verwendung`delete-task-set`. **AWS CLI** **So löschen Sie einen Aufgabensatz** Im folgenden Beispiel für `delete-task-set` wird gezeigt, wie ein Aufgabensatz gelöscht wird. Sie können den `--force`-Parameter angeben, um den Aufgabensatz auch dann zu löschen, wenn er nicht auf null herunterskaliert wurde. ``` aws ecs delete-task-set \ --cluster MyCluster \ --service MyService \ --task-set arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789 \ --force ``` Ausgabe: ``` { "taskSet": { "id": "ecs-svc/1234567890123456789", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "status": "DRAINING", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", "computedDesiredCount": 0, "pendingCount": 0, "runningCount": 0, "createdAt": 1557130260.276, "updatedAt": 1557130290.707, "launchType": "EC2", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12345678" ], "securityGroups": [ "sg-12345678" ], "assignPublicIp": "DISABLED" } }, "loadBalancers": [], "serviceRegistries": [], "scale": { "value": 0.0, "unit": "PERCENT" }, "stabilityStatus": "STABILIZING", "stabilityStatusAt": 1557130290.707 } } ``` + Einzelheiten zur API finden Sie [DeleteTaskSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/delete-task-set.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-container-instance` Das folgende Codebeispiel zeigt die Verwendung`deregister-container-instance`. **AWS CLI** **So heben Sie die Registrierung einer Container-Instance bei einem Cluster auf** Im folgenden Beispiel für `deregister-container-instance` wird die Registrierung einer Container-Instance bei dem angegebenen Cluster aufgehoben. Wenn in der Container-Instance noch Aufgaben ausgeführt werden, müssen Sie entweder diese Aufgaben beenden, bevor Sie die Registrierung aufheben, oder die Option `--force` verwenden. ``` aws ecs deregister-container-instance \ --cluster arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster \ --container-instance arn:aws:ecs:us-west-2:123456789012:container-instance/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --force ``` Ausgabe: ``` { "containerInstance": { "remainingResources": [ { "integerValue": 1024, "doubleValue": 0.0, "type": "INTEGER", "longValue": 0, "name": "CPU" }, { "integerValue": 985, "doubleValue": 0.0, "type": "INTEGER", "longValue": 0, "name": "MEMORY" }, { "type": "STRINGSET", "integerValue": 0, "name": "PORTS", "stringSetValue": [ "22", "2376", "2375", "51678", "51679" ], "longValue": 0, "doubleValue": 0.0 }, { "type": "STRINGSET", "integerValue": 0, "name": "PORTS_UDP", "stringSetValue": [], "longValue": 0, "doubleValue": 0.0 } ], "agentConnected": true, "attributes": [ { "name": "ecs.capability.secrets.asm.environment-variables" }, { "name": "com.amazonaws.ecs.capability.logging-driver.syslog" }, { "value": "ami-01a82c3fce2c3ba58", "name": "ecs.ami-id" }, { "name": "ecs.capability.secrets.asm.bootstrap.log-driver" }, { "name": "com.amazonaws.ecs.capability.logging-driver.none" }, { "name": "ecs.capability.ecr-endpoint" }, { "name": "com.amazonaws.ecs.capability.logging-driver.json-file" }, { "value": "vpc-1234567890123467", "name": "ecs.vpc-id" }, { "name": "ecs.capability.execution-role-awslogs" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.17" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.18" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.19" }, { "name": "ecs.capability.docker-plugin.local" }, { "name": "ecs.capability.task-eni" }, { "name": "ecs.capability.task-cpu-mem-limit" }, { "name": "ecs.capability.secrets.ssm.bootstrap.log-driver" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.30" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.31" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.32" }, { "name": "ecs.capability.execution-role-ecr-pull" }, { "name": "ecs.capability.container-health-check" }, { "value": "subnet-1234567890123467", "name": "ecs.subnet-id" }, { "value": "us-west-2a", "name": "ecs.availability-zone" }, { "value": "t2.micro", "name": "ecs.instance-type" }, { "name": "com.amazonaws.ecs.capability.task-iam-role-network-host" }, { "name": "ecs.capability.aws-appmesh" }, { "name": "com.amazonaws.ecs.capability.logging-driver.awslogs" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.24" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.25" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.26" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.27" }, { "name": "com.amazonaws.ecs.capability.privileged-container" }, { "name": "ecs.capability.container-ordering" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.28" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.29" }, { "value": "x86_64", "name": "ecs.cpu-architecture" }, { "value": "93f43776-2018.10.0", "name": "ecs.capability.cni-plugin-version" }, { "name": "ecs.capability.secrets.ssm.environment-variables" }, { "name": "ecs.capability.pid-ipc-namespace-sharing" }, { "name": "com.amazonaws.ecs.capability.ecr-auth" }, { "value": "linux", "name": "ecs.os-type" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.20" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.21" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.22" }, { "name": "ecs.capability.task-eia" }, { "name": "ecs.capability.private-registry-authentication.secretsmanager" }, { "name": "com.amazonaws.ecs.capability.task-iam-role" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.23" } ], "pendingTasksCount": 0, "tags": [], "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "registeredResources": [ { "integerValue": 1024, "doubleValue": 0.0, "type": "INTEGER", "longValue": 0, "name": "CPU" }, { "integerValue": 985, "doubleValue": 0.0, "type": "INTEGER", "longValue": 0, "name": "MEMORY" }, { "type": "STRINGSET", "integerValue": 0, "name": "PORTS", "stringSetValue": [ "22", "2376", "2375", "51678", "51679" ], "longValue": 0, "doubleValue": 0.0 }, { "type": "STRINGSET", "integerValue": 0, "name": "PORTS_UDP", "stringSetValue": [], "longValue": 0, "doubleValue": 0.0 } ], "status": "INACTIVE", "registeredAt": 1557768075.681, "version": 4, "versionInfo": { "agentVersion": "1.27.0", "agentHash": "aabe65ee", "dockerVersion": "DockerVersion: 18.06.1-ce" }, "attachments": [], "runningTasksCount": 0, "ec2InstanceId": "i-12345678901234678" } } ``` Weitere Informationen finden Sie unter [Aufheben der Registrierung einer Container-Instance](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deregister_container_instance.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DeregisterContainerInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/deregister-container-instance.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-task-definition` Das folgende Codebeispiel zeigt die Verwendung`deregister-task-definition`. **AWS CLI** **Um die Registrierung einer Aufgabendefinition aufzuheben** Im folgenden Beispiel für `deregister-task-definition` wird die Registrierung der ersten Revision der `curler`-Aufgabendefinition in Ihrer Standardregion aufgehoben. ``` aws ecs deregister-task-definition --task-definition curler:1 ``` Beachten Sie, dass in der resultierenden Ausgabe für den Status der Aufgabendefinition `INACTIVE` angezeigt wird. ``` { "taskDefinition": { "status": "INACTIVE", "family": "curler", "volumes": [], "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/curler:1", "containerDefinitions": [ { "environment": [], "name": "curler", "mountPoints": [], "image": "curl:latest", "cpu": 100, "portMappings": [], "entryPoint": [], "memory": 256, "command": [ "curl -v http://example.com/" ], "essential": true, "volumesFrom": [] } ], "revision": 1 } } ``` Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabendefinitionen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie unter [DeregisterTaskDefinition AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/deregister-task-definition.html)*Befehlsreferenz*. ### `describe-capacity-providers` Das folgende Codebeispiel zeigt die Verwendung`describe-capacity-providers`. **AWS CLI** **Beispiel 1: So beschreiben Sie alle Kapazitätsanbieter** Im folgenden Beispiel für `describe-capacity-providers` werden Details zu allen Kapazitätsanbietern abgerufen. ``` aws ecs describe-capacity-providers ``` Ausgabe: ``` { "capacityProviders": [ { "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/MyCapacityProvider", "name": "MyCapacityProvider", "status": "ACTIVE", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup", "managedScaling": { "status": "ENABLED", "targetCapacity": 100, "minimumScalingStepSize": 1, "maximumScalingStepSize": 1000 }, "managedTerminationProtection": "ENABLED" }, "tags": [] }, { "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/FARGATE", "name": "FARGATE", "status": "ACTIVE", "tags": [] }, { "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/FARGATE_SPOT", "name": "FARGATE_SPOT", "status": "ACTIVE", "tags": [] } ] } ``` Weitere Informationen finden Sie unter [Cluster-Kapazitätsanbieter](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-capacity-providers.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So beschreiben Sie einen bestimmten Kapazitätsanbieter** Im folgenden Beispiel für `describe-capacity-providers` werden Details zu einem bestimmten Kapazitätsanbieter abgerufen. Durch die Verwendung des `--include TAGS`-Parameters werden der Ausgabe die mit dem Kapazitätsanbieter verknüpften Tags hinzugefügt. ``` aws ecs describe-capacity-providers \ --capacity-providers MyCapacityProvider \ --include TAGS ``` Ausgabe: ``` { "capacityProviders": [ { "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/MyCapacityProvider", "name": "MyCapacityProvider", "status": "ACTIVE", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup", "managedScaling": { "status": "ENABLED", "targetCapacity": 100, "minimumScalingStepSize": 1, "maximumScalingStepSize": 1000 }, "managedTerminationProtection": "ENABLED" }, "tags": [ { "key": "environment", "value": "production" } ] } ] } ``` Weitere Informationen finden Sie unter [Cluster-Kapazitätsanbieter](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-capacity-providers.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DescribeCapacityProviders](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/describe-capacity-providers.html)in der *AWS CLI Befehlsreferenz*. ### `describe-clusters` Das folgende Codebeispiel zeigt die Verwendung`describe-clusters`. **AWS CLI** **Beispiel 1: So beschreiben Sie einen Cluster** Im folgenden Beispiel für `describe-clusters` werden Details zum angegebenen Cluster abgerufen. ``` aws ecs describe-clusters \ --cluster default ``` Ausgabe: ``` { "clusters": [ { "status": "ACTIVE", "clusterName": "default", "registeredContainerInstancesCount": 0, "pendingTasksCount": 0, "runningTasksCount": 0, "activeServicesCount": 1, "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/default" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Amazon ECS-optimiertes Linux-AMI](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_clusters.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So beschreiben Sie einen Cluster mit der attachment-Option** Im folgenden Beispiel für `describe-clusters` wird die Option ATTACHMENTS spezifiziert. Es werden Details über den angegebenen Cluster und eine Liste von Ressourcen abgerufen, die dem Cluster in Form von Anhängen zugeordnet sind. Wenn Sie einen Kapazitätsanbieter mit einem Cluster verwenden, werden die Ressourcen, entweder AutoScaling Pläne oder Skalierungsrichtlinien, als ASP- oder AS\$1Policy-ATTACHMENTS dargestellt. ``` aws ecs describe-clusters \ --include ATTACHMENTS \ --clusters sampleCluster ``` Ausgabe: ``` { "clusters": [ { "clusterArn": "arn:aws:ecs:af-south-1:123456789222:cluster/sampleCluster", "clusterName": "sampleCluster", "status": "ACTIVE", "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "pendingTasksCount": 0, "activeServicesCount": 0, "statistics": [], "tags": [], "settings": [], "capacityProviders": [ "sampleCapacityProvider" ], "defaultCapacityProviderStrategy": [], "attachments": [ { "id": "a1b2c3d4-5678-901b-cdef-EXAMPLE22222", "type": "as_policy", "status": "CREATED", "details": [ { "name": "capacityProviderName", "value": "sampleCapacityProvider" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-3048e262-fe39-4eaf-826d-6f975d303188" } ] } ], "attachmentsStatus": "UPDATE_COMPLETE" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Amazon ECS-optimiertes Linux-AMI](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_clusters.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DescribeClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/describe-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-container-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-container-instances`. **AWS CLI** **So beschreiben Sie eine Container-Instance** Im folgenden Beispiel für `describe-container-instances` werden Details für eine Container-Instance im `update`-Cluster abgerufen, wobei die UUID der Container-Instance als Bezeichner verwendet wird. ``` aws ecs describe-container-instances \ --cluster update \ --container-instances a1b2c3d4-5678-90ab-cdef-11111EXAMPLE ``` Ausgabe: ``` { "failures": [], "containerInstances": [ { "status": "ACTIVE", "registeredResources": [ { "integerValue": 2048, "longValue": 0, "type": "INTEGER", "name": "CPU", "doubleValue": 0.0 }, { "integerValue": 3955, "longValue": 0, "type": "INTEGER", "name": "MEMORY", "doubleValue": 0.0 }, { "name": "PORTS", "longValue": 0, "doubleValue": 0.0, "stringSetValue": [ "22", "2376", "2375", "51678" ], "type": "STRINGSET", "integerValue": 0 } ], "ec2InstanceId": "i-A1B2C3D4", "agentConnected": true, "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "pendingTasksCount": 0, "remainingResources": [ { "integerValue": 2048, "longValue": 0, "type": "INTEGER", "name": "CPU", "doubleValue": 0.0 }, { "integerValue": 3955, "longValue": 0, "type": "INTEGER", "name": "MEMORY", "doubleValue": 0.0 }, { "name": "PORTS", "longValue": 0, "doubleValue": 0.0, "stringSetValue": [ "22", "2376", "2375", "51678" ], "type": "STRINGSET", "integerValue": 0 } ], "runningTasksCount": 0, "versionInfo": { "agentVersion": "1.0.0", "agentHash": "4023248", "dockerVersion": "DockerVersion: 1.5.0" } } ] } ``` Weitere Informationen finden Sie unter [Container-Instances in Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_instances.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DescribeContainerInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/describe-container-instances.html)in der *AWS CLI Befehlsreferenz*. ### `describe-service-deployments` Das folgende Codebeispiel zeigt die Verwendung`describe-service-deployments`. **AWS CLI** **So beschreiben Sie Details zur Servicebereitstellung** Im folgenden Beispiel für `describe-service-deployments` werden die Servicebereitstellungsdetails für die Servicebereitstellung mit dem ARN `arn:aws:ecs:us-east-1:123456789012:service-deployment/example-cluster/example-service/ejGvqq2ilnbKT9qj0vLJe` zurückgegeben. ``` aws ecs describe-service-deployments \ --service-deployment-arn arn:aws:ecs:us-east-1:123456789012:service-deployment/example-cluster/example-service/ejGvqq2ilnbKT9qj0vLJe ``` Ausgabe: ``` { "serviceDeployments": [ { "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/example-cluster/example-service/ejGvqq2ilnbKT9qj0vLJe", "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/example-cluster/example-service", "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/example-cluster", "createdAt": "2024-10-31T08:03:30.917000-04:00", "startedAt": "2024-10-31T08:03:32.510000-04:00", "finishedAt": "2024-10-31T08:05:04.527000-04:00", "updatedAt": "2024-10-31T08:05:04.527000-04:00", "sourceServiceRevisions": [], "targetServiceRevision": { "arn": "arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678", "requestedTaskCount": 1, "runningTaskCount": 1, "pendingTaskCount": 0 }, "status": "SUCCESSFUL", "deploymentConfiguration": { "deploymentCircuitBreaker": { "enable": true, "rollback": true }, "maximumPercent": 200, "minimumHealthyPercent": 100, "alarms": { "alarmNames": [], "rollback": false, "enable": false } }, "deploymentCircuitBreaker": { "status": "MONITORING_COMPLETE", "failureCount": 0, "threshold": 3 }, "alarms": { "status": "DISABLED" } } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Anzeigen des Serviceverlaufs mithilfe von Amazon-ECS-Servicebereitstellungen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployment.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DescribeServiceDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/describe-service-deployments.html)in der *AWS CLI Befehlsreferenz*. ### `describe-service-revisions` Das folgende Codebeispiel zeigt die Verwendung`describe-service-revisions`. **AWS CLI** **So beschreiben Sie die Details der Service-Revision** Im folgenden Beispiel für `describe-service-revisions` werden die Service-Revisionsdetails für die Service-Revision mit dem ARN `arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678` zurückgegeben. ``` aws ecs describe-service-revisions \ --service-revision-arns arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678 ``` Ausgabe: ``` { "serviceRevisions": [ { "serviceRevisionArn": "arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678", "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/example-cluster/example-service", "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/example-cluster", "taskDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/webserver:5", "capacityProviderStrategy": [ { "capacityProvider": "FARGATE", "weight": 1, "base": 0 } ], "platformVersion": "1.4.0", "platformFamily": "Linux", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-0d0eab1bb38d5ca64", "subnet-0db5010045995c2d5" ], "securityGroups": [ "sg-02556bf85a191f59a" ], "assignPublicIp": "ENABLED" } }, "containerImages": [ { "containerName": "aws-otel-collector", "imageDigest": "sha256:7a1b3560655071bcacd66902c20ebe9a69470d5691fe3bd36baace7c2f3c4640", "image": "public.ecr.aws/aws-observability/aws-otel-collector:v0.32.0" }, { "containerName": "web", "imageDigest": "sha256:28402db69fec7c17e179ea87882667f1e054391138f77ffaf0c3eb388efc3ffb", "image": "nginx" } ], "guardDutyEnabled": false, "serviceConnectConfiguration": { "enabled": false }, "createdAt": "2024-10-31T08:03:29.302000-04:00" } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Amazon ECS-optimiertes Linux-AMI](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-revision.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DescribeServiceRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/describe-service-revisions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-services` Das folgende Codebeispiel zeigt die Verwendung`describe-services`. **AWS CLI** **So beschreiben Sie einen Service** Im folgenden Beispiel für `describe-services` werden Details für den `my-http-service`-Service im Standard-Cluster abgerufen. ``` aws ecs describe-services --services my-http-service ``` Ausgabe: ``` { "services": [ { "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/amazon-ecs-sample:1", "pendingCount": 0, "loadBalancers": [], "desiredCount": 10, "createdAt": 1466801808.595, "serviceName": "my-http-service", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/default", "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/my-http-service", "deployments": [ { "status": "PRIMARY", "pendingCount": 0, "createdAt": 1466801808.595, "desiredCount": 10, "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/amazon-ecs-sample:1", "updatedAt": 1428326312.703, "id": "ecs-svc/1234567890123456789", "runningCount": 10 } ], "events": [ { "message": "(service my-http-service) has reached a steady state.", "id": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "createdAt": 1466801812.435 } ], "runningCount": 10 } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Services](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DescribeServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/describe-services.html)in der *AWS CLI Befehlsreferenz*. ### `describe-task-definition` Das folgende Codebeispiel zeigt die Verwendung`describe-task-definition`. **AWS CLI** **So beschreiben Sie eine Aufgabendefinition** Im folgenden Beispiel für `describe-task-definition` werden die Details einer Aufgabendefinition abgerufen. ``` aws ecs describe-task-definition \ --task-definition hello_world:8 ``` Ausgabe: ``` { "taskDefinition": { "taskDefinitionArn": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:8", "containerDefinitions": [ { "cpu": 10, "environment": [], "essential": true, "image": "wordpress", "links": [ "mysql" ] , "memory": 500, "mountPoints": [], "name": "wordpress", "portMappings": [ { "containerPort": 80, "hostPort": 80 } ], "volumesFrom": [] }, { "cpu": 10, "environment": [ { "name": "MYSQL_ROOT_PASSWORD", "value": "password" } ], "essential": true, "image": "mysql", "memory": 500, "mountPoints": [], "name": "mysql", "portMappings": [], "volumesFrom": [] } ], "family": "hello_world", "revision": 8, "volumes": [], "status": "ACTIVE", "placementConstraints": [], "compatibilities": [ "EXTERNAL", "EC2" ], "registeredAt": "2024-06-21T11:15:12.669000-05:00", "registeredBy": "arn:aws:sts::012345678910:assumed-role/demo-role/jane-doe" }, "tags": [] } ``` Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabendefinitionen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DescribeTaskDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/describe-task-definition.html)in der *AWS CLI Befehlsreferenz*. ### `describe-task-sets` Das folgende Codebeispiel zeigt die Verwendung`describe-task-sets`. **AWS CLI** **So beschreiben Sie einen Aufgabensatz** Im folgenden Beispiel für `describe-task-sets` wird ein Aufgabensatz in einem Service beschrieben, der einen externen Deployer verwendet. ``` aws ecs describe-task-sets \ --cluster MyCluster \ --service MyService \ --task-sets arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789 ``` Ausgabe: ``` { "taskSets": [ { "id": "ecs-svc/1234567890123456789", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", "computedDesiredCount": 0, "pendingCount": 0, "runningCount": 0, "createdAt": 1557207715.195, "updatedAt": 1557207740.014, "launchType": "EC2", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-1234431" ], "assignPublicIp": "DISABLED" } }, "loadBalancers": [], "serviceRegistries": [], "scale": { "value": 0.0, "unit": "PERCENT" }, "stabilityStatus": "STEADY_STATE", "stabilityStatusAt": 1557207740.014 } ], "failures": [] } ``` + Einzelheiten zur API finden Sie [DescribeTaskSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/describe-task-sets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-tasks`. **AWS CLI** **Beispiel 1: Um eine einzelne Aufgabe zu beschreiben** Im folgenden Beispiel für `describe-tasks` werden die Details einer Aufgabe in einem Cluster abgerufen. Sie können die Aufgabe angeben, indem Sie entweder die ID oder den vollständigen ARN der Aufgabe verwenden. Dieses Beispiel nutzt den vollständigen ARN der Aufgabe. ``` aws ecs describe-tasks \ --cluster MyCluster \ --tasks arn:aws:ecs:us-east-1:123456789012:task/MyCluster/4d590253bb114126b7afa7b58EXAMPLE ``` Ausgabe: ``` { "tasks": [ { "attachments": [], "attributes": [ { "name": "ecs.cpu-architecture", "value": "x86_64" } ], "availabilityZone": "us-east-1b", "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster", "connectivity": "CONNECTED", "connectivityAt": "2021-08-11T12:21:26.681000-04:00", "containerInstanceArn": "arn:aws:ecs:us-east-1:123456789012:container-instance/test/025c7e2c5e054a6790a29fc1fEXAMPLE", "containers": [ { "containerArn": "arn:aws:ecs:us-east-1:123456789012:container/MyCluster/4d590253bb114126b7afa7b58eea9221/a992d1cc-ea46-474a-b6e8-24688EXAMPLE", "taskArn": "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/4d590253bb114126b7afa7b58EXAMPLE", "name": "simple-app", "image": "httpd:2.4", "runtimeId": "91251eed27db90006ad67b1a08187290869f216557717dd5c39b37c94EXAMPLE", "lastStatus": "RUNNING", "networkBindings": [ { "bindIP": "0.0.0.0", "containerPort": 80, "hostPort": 80, "protocol": "tcp" } ], "networkInterfaces": [], "healthStatus": "UNKNOWN", "cpu": "10", "memory": "300" } ], "cpu": "10", "createdAt": "2021-08-11T12:21:26.681000-04:00", "desiredStatus": "RUNNING", "enableExecuteCommand": false, "group": "service:testupdate", "healthStatus": "UNKNOWN", "lastStatus": "RUNNING", "launchType": "EC2", "memory": "300", "overrides": { "containerOverrides": [ { "name": "simple-app" } ], "inferenceAcceleratorOverrides": [] }, "pullStartedAt": "2021-08-11T12:21:28.234000-04:00", "pullStoppedAt": "2021-08-11T12:21:33.793000-04:00", "startedAt": "2021-08-11T12:21:34.945000-04:00", "startedBy": "ecs-svc/968695068243EXAMPLE", "tags": [], "taskArn": "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/4d590253bb114126b7afa7b58eea9221", "taskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:task-definition/console-sample-app-static2:1", "version": 2 } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabendefinitionen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: Um mehrere Aufgaben zu beschreiben** Im folgenden Beispiel für `describe-tasks` werden die Details mehrerer Aufgaben in einem Cluster abgerufen. Sie können die Aufgabe angeben, indem Sie entweder die ID oder den vollständigen ARN der Aufgabe verwenden. In diesem Beispiel werden alle IDs Aufgaben verwendet. ``` aws ecs describe-tasks \ --cluster MyCluster \ --tasks "74de0355a10a4f979ac495c14EXAMPLE" "d789e94343414c25b9f6bd59eEXAMPLE" ``` Ausgabe: ``` { "tasks": [ { "attachments": [ { "id": "d9e7735a-16aa-4128-bc7a-b2d51EXAMPLE", "type": "ElasticNetworkInterface", "status": "ATTACHED", "details": [ { "name": "subnetId", "value": "subnet-0d0eab1bb3EXAMPLE" }, { "name": "networkInterfaceId", "value": "eni-0fa40520aeEXAMPLE" }, { "name": "macAddress", "value": "0e:89:76:28:07:b3" }, { "name": "privateDnsName", "value": "ip-10-0-1-184.ec2.internal" }, { "name": "privateIPv4Address", "value": "10.0.1.184" } ] } ], "attributes": [ { "name": "ecs.cpu-architecture", "value": "x86_64" } ], "availabilityZone": "us-east-1b", "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster", "connectivity": "CONNECTED", "connectivityAt": "2021-12-20T12:13:37.875000-05:00", "containers": [ { "containerArn": "arn:aws:ecs:us-east-1:123456789012:container/MyCluster/74de0355a10a4f979ac495c14EXAMPLE/aad3ba00-83b3-4dac-84d4-11f8cEXAMPLE", "taskArn": "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/74de0355a10a4f979ac495c14EXAMPLE", "name": "web", "image": "nginx", "runtimeId": "74de0355a10a4f979ac495c14EXAMPLE-265927825", "lastStatus": "RUNNING", "networkBindings": [], "networkInterfaces": [ { "attachmentId": "d9e7735a-16aa-4128-bc7a-b2d51EXAMPLE", "privateIpv4Address": "10.0.1.184" } ], "healthStatus": "UNKNOWN", "cpu": "99", "memory": "100" } ], "cpu": "256", "createdAt": "2021-12-20T12:13:20.226000-05:00", "desiredStatus": "RUNNING", "enableExecuteCommand": false, "group": "service:tdsevicetag", "healthStatus": "UNKNOWN", "lastStatus": "RUNNING", "launchType": "FARGATE", "memory": "512", "overrides": { "containerOverrides": [ { "name": "web" } ], "inferenceAcceleratorOverrides": [] }, "platformVersion": "1.4.0", "platformFamily": "Linux", "pullStartedAt": "2021-12-20T12:13:42.665000-05:00", "pullStoppedAt": "2021-12-20T12:13:46.543000-05:00", "startedAt": "2021-12-20T12:13:48.086000-05:00", "startedBy": "ecs-svc/988401040018EXAMPLE", "tags": [], "taskArn": "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/74de0355a10a4f979ac495c14EXAMPLE", "taskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:task-definition/webserver:2", "version": 3, "ephemeralStorage": { "sizeInGiB": 20 } }, { "attachments": [ { "id": "214eb5a9-45cd-4bf8-87bc-57fefEXAMPLE", "type": "ElasticNetworkInterface", "status": "ATTACHED", "details": [ { "name": "subnetId", "value": "subnet-0d0eab1bb3EXAMPLE" }, { "name": "networkInterfaceId", "value": "eni-064c7766daEXAMPLE" }, { "name": "macAddress", "value": "0e:76:83:01:17:a9" }, { "name": "privateDnsName", "value": "ip-10-0-1-41.ec2.internal" }, { "name": "privateIPv4Address", "value": "10.0.1.41" } ] } ], "attributes": [ { "name": "ecs.cpu-architecture", "value": "x86_64" } ], "availabilityZone": "us-east-1b", "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster", "connectivity": "CONNECTED", "connectivityAt": "2021-12-20T12:13:35.243000-05:00", "containers": [ { "containerArn": "arn:aws:ecs:us-east-1:123456789012:container/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE/9afef792-609b-43a5-bb6a-3efdbEXAMPLE", "taskArn": "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE", "name": "web", "image": "nginx", "runtimeId": "d789e94343414c25b9f6bd59eEXAMPLE-265927825", "lastStatus": "RUNNING", "networkBindings": [], "networkInterfaces": [ { "attachmentId": "214eb5a9-45cd-4bf8-87bc-57fefEXAMPLE", "privateIpv4Address": "10.0.1.41" } ], "healthStatus": "UNKNOWN", "cpu": "99", "memory": "100" } ], "cpu": "256", "createdAt": "2021-12-20T12:13:20.226000-05:00", "desiredStatus": "RUNNING", "enableExecuteCommand": false, "group": "service:tdsevicetag", "healthStatus": "UNKNOWN", "lastStatus": "RUNNING", "launchType": "FARGATE", "memory": "512", "overrides": { "containerOverrides": [ { "name": "web" } ], "inferenceAcceleratorOverrides": [] }, "platformVersion": "1.4.0", "platformFamily": "Linux", "pullStartedAt": "2021-12-20T12:13:44.611000-05:00", "pullStoppedAt": "2021-12-20T12:13:48.251000-05:00", "startedAt": "2021-12-20T12:13:49.326000-05:00", "startedBy": "ecs-svc/988401040018EXAMPLE", "tags": [], "taskArn": "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE", "taskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:task-definition/webserver:2", "version": 3, "ephemeralStorage": { "sizeInGiB": 20 } } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabendefinitionen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [DescribeTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/describe-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `execute-command` Das folgende Codebeispiel zeigt die Verwendung`execute-command`. **AWS CLI** **So führen Sie einen interaktiven /bin/sh-Befehl aus** Im folgenden `execute-command` Beispiel wird ein interaktiver /bin/sh-Befehl MyContainer für einen Container ausgeführt, der nach einer Aufgabe mit der ID von benannt ist. `arn:aws:ecs:us-east-1:123456789012:task/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE` ``` aws ecs execute-command \ --cluster MyCluster \ --task arn:aws:ecs:us-east-1:123456789012:task/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE \ --container MyContainer \ --interactive \ --command "/bin/sh" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden von Amazon ECS Exec für das Debugging](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html) im *Entwicklerhandbuch für Amazon ECS*. + *Einzelheiten zur API finden Sie [ExecuteCommand](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/execute-command.html)in AWS CLI der Befehlsreferenz.* ### `get-task-protection` Das folgende Codebeispiel zeigt die Verwendung`get-task-protection`. **AWS CLI** **So rufen Sie den Schutzstatus der Aufgabe im ECS-Service ab** Im folgenden Beispiel für `get-task-protection` wird der Schutzstatus von ECS-Aufgaben bereitgestellt, die zum Amazon-ECS-Service gehören. ``` aws ecs get-task-protection \ --cluster ECS-project-update-cluster \ --tasks c43ed3b1331041f289316f958adb6a24 ``` Ausgabe: ``` { "protectedTasks": [ { "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/c43ed3b1331041f289316f958adb6a24", "protectionEnabled": false } ], "failures": [] } ``` Weitere Informationen zum Schutz von Aufgaben finden Sie unter [Schützen Ihrer Amazon-ECS-Aufgaben vor dem Beenden durch Abskalierungsereignisse](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-scale-in-protection.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [GetTaskProtection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/get-task-protection.html)in der *AWS CLI Befehlsreferenz*. ### `list-account-settings` Das folgende Codebeispiel zeigt die Verwendung`list-account-settings`. **AWS CLI** **Beispiel 1: So zeigen Sie die Kontoeinstellungen für ein Konto an** Das folgende Beispiel für `list-account-settings` zeigt die effektiven Kontoeinstellungen für ein Konto an. ``` aws ecs list-account-settings --effective-settings ``` Ausgabe: ``` { "settings": [ { "name": "containerInstanceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam::123456789012:root" }, { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam::123456789012:root" }, { "name": "taskLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam::123456789012:root" } ] } ``` **Beispiel 2: So zeigen Sie die Kontoeinstellungen für einen bestimmten IAM-Benutzer oder eine bestimmte IAM-Rolle an** Im folgenden Beispiel für `list-account-settings` werden die Kontoeinstellungen für den bestimmten IAM-Benutzer oder die IAM-Rolle angezeigt. ``` aws ecs list-account-settings --principal-arn arn:aws:iam::123456789012:user/MyUser ``` Ausgabe: ``` { "settings": [ { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam::123456789012:user/MyUser" } ] } ``` Weitere Informationen finden Sie unter [Amazon Resource Names (ARNs) und IDs](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-resource-ids.html) im *Amazon ECS Developer Guide*. + Einzelheiten zur API finden Sie [ListAccountSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-account-settings.html)in der *AWS CLI Befehlsreferenz*. ### `list-attributes` Das folgende Codebeispiel zeigt die Verwendung`list-attributes`. **AWS CLI** **So führen Sie die Container-Instances auf, die ein bestimmtes Attribut enthalten** Im folgenden Beispiel werden die Attribute für Container-Instances aufgeführt, die das Attribut `stack=production` im Standard-Cluster enthalten. ``` aws ecs list-attributes \ --target-type container-instance \ --attribute-name stack \ --attribute-value production \ --cluster default ``` Ausgabe: ``` { "attributes": [ { "name": "stack", "targetId": "arn:aws:ecs:us-west-2:130757420319:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34", "value": "production" } ] } ``` Weitere Informationen finden Sie unter [Konfiguration des Container-Agenten von Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [ListAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `list-clusters` Das folgende Codebeispiel zeigt die Verwendung`list-clusters`. **AWS CLI** **So listen Sie Ihre verfügbaren Cluster auf** Im folgenden Beispiel für `list-clusters` werden alle verfügbaren Cluster aufgelistet. ``` aws ecs list-clusters ``` Ausgabe: ``` { "clusterArns": [ "arn:aws:ecs:us-west-2:123456789012:cluster/MyECSCluster1", "arn:aws:ecs:us-west-2:123456789012:cluster/AnotherECSCluster" ] } ``` Weitere Informationen finden Sie unter [Amazon ECS-optimiertes Linux-AMI](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_clusters.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [ListClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `list-container-instances` Das folgende Codebeispiel zeigt die Verwendung`list-container-instances`. **AWS CLI** **So listen Sie die Container-Instances in einem Cluster auf** Im folgenden Beispiel für `list-container-instances` werden alle verfügbaren Container-Instances in einem Cluster aufgelistet. ``` aws ecs list-container-instances --cluster MyCluster ``` Ausgabe: ``` { "containerInstanceArns": [ "arn:aws:ecs:us-west-2:123456789012:container-instance/MyCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "arn:aws:ecs:us-west-2:123456789012:container-instance/MyCluster/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" ] } ``` Weitere Informationen finden Sie unter [Container-Instances in Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_instances.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [ListContainerInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-container-instances.html)in der *AWS CLI Befehlsreferenz*. ### `list-service-deployments` Das folgende Codebeispiel zeigt die Verwendung`list-service-deployments`. **AWS CLI** **So listen Sie Servicebereitstellungen auf** Im folgenden Beispiel für `list-service-deployments` werden die Servicebereitstellungen für den Service mit dem Namen `example-service` abgerufen. ``` aws ecs list-service-deployments \ --service arn:aws:ecs:us-east-1:123456789012:service/example-cluster/example-service ``` Ausgabe: ``` { "serviceDeployments": [ { "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/example-cluster/example-service/ejGvqq2ilnbKT9qj0vLJe", "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/example-cluster/example-service", "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/example-cluster", "startedAt": "2024-10-31T08:03:32.510000-04:00", "createdAt": "2024-10-31T08:03:30.917000-04:00", "finishedAt": "2024-10-31T08:05:04.527000-04:00", "targetServiceRevisionArn": "arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678", "status": "SUCCESSFUL" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen des Serviceverlaufs mithilfe von Amazon-ECS-Servicebereitstellungen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployment.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [ListServiceDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-service-deployments.html)in der *AWS CLI Befehlsreferenz*. ### `list-services-by-namespace` Das folgende Codebeispiel zeigt die Verwendung`list-services-by-namespace`. **AWS CLI** **So listen Sie die Services in einem Namespace auf** Im folgenden Beispiel für `list-services-by-namespace` werden alle Services aufgelistet, die für den angegebenen Namespace in Ihrer Standardregion konfiguriert sind. ``` aws ecs list-services-by-namespace \ --namespace service-connect ``` Ausgabe: ``` { "serviceArns": [ "arn:aws:ecs:us-west-2:123456789012:service/MyCluster/MyService", "arn:aws:ecs:us-west-2:123456789012:service/tutorial/service-connect-nginx-service" ] } ``` Weitere Informationen finden Sie unter [Service Connect](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [ListServicesByNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-services-by-namespace.html)in der *AWS CLI Befehlsreferenz*. ### `list-services` Das folgende Codebeispiel zeigt die Verwendung`list-services`. **AWS CLI** **So listen Sie die Services in einem Cluster auf** Das folgende Beispiel für `list-services` zeigt, wie Sie die Services auflisten, die in einem Cluster ausgeführt werden. ``` aws ecs list-services --cluster MyCluster ``` Ausgabe: ``` { "serviceArns": [ "arn:aws:ecs:us-west-2:123456789012:service/MyCluster/MyService" ] } ``` Weitere Informationen finden Sie unter [Services](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [ListServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-services.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für einen bestimmten Cluster aufgelistet. ``` aws ecs list-tags-for-resource \ --resource-arn arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster ``` Ausgabe: ``` { "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" }, { "key": "key3", "value": "value3" } ] } ``` + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-task-definition-families` Das folgende Codebeispiel zeigt die Verwendung`list-task-definition-families`. **AWS CLI** **Beispiel 1: So listen Sie die registrierten Aufgabendefinitionsfamilien auf** Im folgenden Beispiel für `list-task-definition-families` werden alle registrierten Aufgabendefinitionsfamilien aufgelistet. ``` aws ecs list-task-definition-families ``` Ausgabe: ``` { "families": [ "node-js-app", "web-timer", "hpcc", "hpcc-c4-8xlarge" ] } ``` **Beispiel 2: So filtern Sie die registrierten Aufgabendefinitionsfamilien** Im folgenden Beispiel für `list-task-definition-families` werden die Revisionen der Aufgabendefinitionen aufgeführt, die mit „hpcc“ beginnen. ``` aws ecs list-task-definition-families --family-prefix hpcc ``` Ausgabe: ``` { "families": [ "hpcc", "hpcc-c4-8xlarge" ] } ``` Weitere Informationen finden Sie unter [Aufgabendefinitionsparameter](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#family) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [ListTaskDefinitionFamilies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-task-definition-families.html)in der *AWS CLI Befehlsreferenz*. ### `list-task-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-task-definitions`. **AWS CLI** **Beispiel 1: So listen Sie die registrierten Aufgabendefinitionen auf** Im folgenden Beispiel für `list-task-definitions` werden alle registrierten Aufgabendefinitionen aufgelistet. ``` aws ecs list-task-definitions ``` Ausgabe: ``` { "taskDefinitionArns": [ "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep300:2", "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep360:1", "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:3", "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:4", "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:5", "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:6" ] } ``` **Beispiel 2: So listen Sie die registrierten Aufgabendefinitionen in einer Familie auf** Im folgenden list-task-definitions Beispiel werden die Versionen der Aufgabendefinitionen für eine angegebene Familie aufgeführt. ``` aws ecs list-task-definitions --family-prefix wordpress ``` Ausgabe: ``` { "taskDefinitionArns": [ "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:3", "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:4", "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:5", "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:6" ] } ``` Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabendefinitionen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie unter [ListTaskDefinitions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-task-definitions.html)*Befehlsreferenz.* ### `list-tasks` Das folgende Codebeispiel zeigt die Verwendung`list-tasks`. **AWS CLI** **Beispiel 1: So listen Sie die Aufgaben in einem Cluster auf** Im folgenden Beispiel für `list-tasks` werden alle Aufgaben in einem Cluster aufgelistet. ``` aws ecs list-tasks --cluster default ``` Ausgabe: ``` { "taskArns": [ "arn:aws:ecs:us-west-2:123456789012:task/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "arn:aws:ecs:us-west-2:123456789012:task/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" ] } ``` **Beispiel 2: So listen Sie die Aufgaben auf einer bestimmten Container-Instance auf** Im folgenden Beispiel für `list-tasks` werden die Aufgaben auf einer Container-Instance aufgeführt, wobei die UUID der Container-Instance als Filter verwendet wird. ``` aws ecs list-tasks --cluster default --container-instance a1b2c3d4-5678-90ab-cdef-33333EXAMPLE ``` Ausgabe: ``` { "taskArns": [ "arn:aws:ecs:us-west-2:123456789012:task/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE" ] } ``` Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabendefinitionen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [ListTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/list-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `put-account-setting-default` Das folgende Codebeispiel zeigt die Verwendung`put-account-setting-default`. **AWS CLI** **So ändern Sie die Standardeinstellungen eines Kontos** Im folgenden Beispiel für `put-account-setting-default` wird die Standard-Kontoeinstellung für alle IAM-Benutzer oder -Rollen in Ihrem Konto geändert. Diese Änderungen gelten für das gesamte AWS Konto, sofern ein IAM-Benutzer oder eine IAM-Rolle diese Einstellungen nicht ausdrücklich für sich selbst außer Kraft setzt. ``` aws ecs put-account-setting-default --name serviceLongArnFormat --value enabled ``` Ausgabe: ``` { "setting": { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam::123456789012:root" } } ``` Weitere Informationen finden Sie unter [Amazon Resource Names (ARNs) und IDs](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-resource-ids.html) im *Amazon ECS Developer Guide*. + Einzelheiten zur API finden Sie [PutAccountSettingDefault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/put-account-setting-default.html)in der *AWS CLI Befehlsreferenz*. ### `put-account-setting` Das folgende Codebeispiel zeigt die Verwendung`put-account-setting`. **AWS CLI** **So ändern Sie die Kontoeinstellung für Ihr IAM-Benutzerkonto** Im folgenden Beispiel für `put-account-setting` wird die `containerInsights`-Kontoeinstellung für Ihr IAM-Benutzerkonto auf `enhanced` festgelegt. Dadurch wird Container Insights mit verbesserter Beobachtbarkeit aktiviert. ``` aws ecs put-account-setting \ --name containerInsights \ --value enhanced ``` Ausgabe: ``` { "setting": { "name": "containerInsights", "value": "enhanced", "principalArn": "arn:aws:iam::123456789012:user/johndoe", "type": "user" } } ``` Weitere Informationen finden Sie unter [Ändern der Kontoeinstellungen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-modifying-longer-id-settings.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [PutAccountSetting](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/put-account-setting.html)in der *AWS CLI Befehlsreferenz*. ### `put-account-settings` Das folgende Codebeispiel zeigt die Verwendung`put-account-settings`. **AWS CLI** **So ändern Sie die Kontoeinstellungen für einen IAM-Benutzer oder eine -Rolle** Im folgenden Beispiel für `put-account-setting` werden die Kontoeinstellungen für den bestimmten IAM-Benutzer oder die -Rolle geändert. ``` aws ecs put-account-setting \ --name serviceLongArnFormat \ --value enabled \ --principal-arn arn:aws:iam::123456789012:user/MyUser ``` Ausgabe: ``` { "setting": { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam::123456789012:user/MyUser" } } ``` + Einzelheiten zur API finden Sie [PutAccountSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/put-account-settings.html)in der *AWS CLI Befehlsreferenz*. ### `put-attributes` Das folgende Codebeispiel zeigt die Verwendung`put-attributes`. **AWS CLI** **So erstellen Sie ein Attribut und ordnen es einer Amazon-ECS-Ressource zu** Im folgenden Beispiel für `put-attributes` wird ein Attribut mit dem Namen Stack und dem Wert Production auf eine Container-Instance angewendet. ``` aws ecs put-attributes \ --attributes name=stack,value=production,targetId=arn:aws:ecs:us-west-2:130757420319:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34 ``` Ausgabe: ``` { "attributes": [ { "name": "stack", "targetId": "arn:aws:ecs:us-west-2:130757420319:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34", "value": "production" } ] } ``` + Einzelheiten zur API finden Sie [PutAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/put-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `put-cluster-capacity-providers` Das folgende Codebeispiel zeigt die Verwendung`put-cluster-capacity-providers`. **AWS CLI** **Beispiel 1: So fügen Sie einem Cluster einen vorhandenen Kapazitätsanbieter hinzu** Im folgenden Beispiel für `put-cluster-capacity-providers` wird einem Cluster ein vorhandener Kapazitätsanbieter hinzugefügt. Mit dem `create-capacity-provider`-Befehl erstellen Sie einen Kapazitätsanbieter. Mit dem `describe-clusters`-Befehl werden die aktuellen Kapazitätsanbieter und die Standardstrategie für Kapazitätsanbieter für einen Cluster beschrieben. Wenn Sie einem Cluster einen neuen Kapazitätsanbieter hinzufügen, müssen Sie zusätzlich zu dem neuen Kapazitätsanbieter, den Sie dem Cluster zuordnen möchten, alle vorhandenen Kapazitätsanbieter angeben. Außerdem müssen Sie die Standardstrategie für Kapazitätsanbieter angeben, die mit dem Cluster verknüpft werden soll. In diesem Beispiel ist dem Cluster `MyCluster` der Kapazitätsanbieter `MyCapacityProvider1` zugeordnet. Sie möchten den Kapazitätsanbieter `MyCapacityProvider2` hinzufügen und in die Standardstrategie für Kapazitätsanbieter aufnehmen, sodass die Aufgaben gleichmäßig auf beide Kapazitätsanbieter verteilt werden. ``` aws ecs put-cluster-capacity-providers \ --cluster MyCluster \ --capacity-providers MyCapacityProvider1 MyCapacityProvider2 \ --default-capacity-provider-strategy capacityProvider=MyCapacityProvider1,weight=1 capacityProvider=MyCapacityProvider2,weight=1 ``` Ausgabe: ``` { "cluster": { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "MyCluster", "status": "ACTIVE", "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "pendingTasksCount": 0, "activeServicesCount": 0, "statistics": [], "tags": [], "settings": [ { "name": "containerInsights", "value": "enabled" } ], "capacityProviders": [ "MyCapacityProvider1", "MyCapacityProvider2" ], "defaultCapacityProviderStrategy": [ { "capacityProvider": "MyCapacityProvider1", "weight": 1, "base": 0 }, { "capacityProvider": "MyCapacityProvider2", "weight": 1, "base": 0 } ], "attachments": [ { "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918", "type": "as_policy", "status": "ACTIVE", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider1" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ] }, { "id": "ae592060-2382-4663-9476-b015c685593c", "type": "as_policy", "status": "ACTIVE", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider2" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ] } ], "attachmentsStatus": "UPDATE_IN_PROGRESS" } } ``` Weitere Informationen finden Sie unter [Cluster-Kapazitätsanbieter](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-capacity-providers.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So entfernen Sie einen Kapazitätsanbieter aus einem Cluster** Im folgenden Beispiel für `put-cluster-capacity-providers` wird ein Kapazitätsanbieter aus einem Cluster entfernt. Mit dem `describe-clusters`-Befehl werden die aktuellen Kapazitätsanbieter, die einem Cluster zugeordnet sind, beschrieben. Wenn Sie einen Kapazitätsanbieter aus einem Cluster entfernen, müssen Sie die Kapazitätsanbieter angeben, die dem Cluster zugeordnet bleiben sollen, sowie die Standardstrategie für Kapazitätsanbieter, die dem Cluster zugeordnet werden soll. In diesem Beispiel sind dem Cluster die Kapazitätsanbieter `MyCapacityProvider1` und `MyCapacityProvider2` zugeordnet. Sie möchten den Kapazitätsanbieter `MyCapacityProvider2` entfernen und geben daher nur `MyCapacityProvider1` im Befehl zusammen mit der aktualisierten Standardstrategie für Kapazitätsanbieter an. ``` aws ecs put-cluster-capacity-providers \ --cluster MyCluster \ --capacity-providers MyCapacityProvider1 \ --default-capacity-provider-strategy capacityProvider=MyCapacityProvider1,weight=1,base=0 ``` Ausgabe: ``` { "cluster": { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "MyCluster", "status": "ACTIVE", "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "pendingTasksCount": 0, "activeServicesCount": 0, "statistics": [], "tags": [], "settings": [ { "name": "containerInsights", "value": "enabled" } ], "capacityProviders": [ "MyCapacityProvider1" ], "defaultCapacityProviderStrategy": [ "capacityProvider": "MyCapacityProvider1", "weight": 1, "base": 0 ], "attachments": [ { "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918", "type": "as_policy", "status": "ACTIVE", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider1" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ] }, { "id": "ae592060-2382-4663-9476-b015c685593c", "type": "as_policy", "status": "DELETING", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider2" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ] } ], "attachmentsStatus": "UPDATE_IN_PROGRESS" } } ``` Weitere Informationen finden Sie unter [Cluster-Kapazitätsanbieter](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-capacity-providers.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 3: So entfernen Sie alle Kapazitätsanbieter aus einem Cluster** Im folgenden Beispiel für `put-cluster-capacity-providers` werden alle vorhandenen Kapazitätsanbieter aus dem Cluster entfernt. ``` aws ecs put-cluster-capacity-providers \ --cluster MyCluster \ --capacity-providers [] \ --default-capacity-provider-strategy [] ``` Ausgabe: ``` { "cluster": { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "MyCluster", "status": "ACTIVE", "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "pendingTasksCount": 0, "activeServicesCount": 0, "statistics": [], "tags": [], "settings": [ { "name": "containerInsights", "value": "enabled" } ], "capacityProviders": [], "defaultCapacityProviderStrategy": [], "attachments": [ { "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918", "type": "as_policy", "status": "DELETING", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider1" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ] }, { "id": "ae592060-2382-4663-9476-b015c685593c", "type": "as_policy", "status": "DELETING", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider2" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ] } ], "attachmentsStatus": "UPDATE_IN_PROGRESS" } } ``` Weitere Informationen finden Sie unter [Cluster-Kapazitätsanbieter](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-capacity-providers.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [PutClusterCapacityProviders](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/put-cluster-capacity-providers.html)in der *AWS CLI Befehlsreferenz*. ### `register-task-definition` Das folgende Codebeispiel zeigt die Verwendung`register-task-definition`. **AWS CLI** **Beispiel 1: So registrieren Sie eine Aufgabendefinition mit einer JSON-Datei** Im folgenden Beispiel für `register-task-definition` wird eine Aufgabendefinition für die angegebene Familie registriert. Die Containerdefinitionen werden im JSON-Format am angegebenen Dateispeicherort abgelegt. ``` aws ecs register-task-definition \ --cli-input-json file:///sleep360.json ``` Inhalt von `sleep360.json`: ``` { "containerDefinitions": [ { "name": "sleep", "image": "busybox", "cpu": 10, "command": [ "sleep", "360" ], "memory": 10, "essential": true } ], "family": "sleep360" } ``` Ausgabe: ``` { "taskDefinition": { "status": "ACTIVE", "family": "sleep360", "placementConstraints": [], "compatibilities": [ "EXTERNAL", "EC2" ], "volumes": [], "taskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:task-definition/sleep360:1", "containerDefinitions": [ { "environment": [], "name": "sleep", "mountPoints": [], "image": "busybox", "cpu": 10, "portMappings": [], "command": [ "sleep", "360" ], "memory": 10, "essential": true, "volumesFrom": [] } ], "revision": 1 } } ``` Weitere Informationen finden Sie unter [Beispiele für Aufgabendefinitionen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/example_task_definitions.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So registrieren Sie eine Aufgabendefinition mit einem JSON-Zeichenfolgeparameter** Im folgenden Beispiel für `register-task-definition` wird eine Aufgabendefinition mithilfe von Containerdefinitionen registriert, die als JSON-Zeichenfolgeparameter mit auskommentierten doppelten Anführungszeichen bereitgestellt werden. ``` aws ecs register-task-definition \ --family sleep360 \ --container-definitions "[{\"name\":\"sleep\",\"image\":\"busybox\",\"cpu\":10,\"command\":[\"sleep\",\"360\"],\"memory\":10,\"essential\":true}]" ``` Die Ausgabe ist identisch mit dem vorherigen Beispiel. Weitere Informationen finden Sie unter [Erstellen einer Aufgabendefinition](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-task-definition.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [RegisterTaskDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/register-task-definition.html)in der *AWS CLI Befehlsreferenz*. ### `run-task` Das folgende Codebeispiel zeigt die Verwendung`run-task`. **AWS CLI** **Beispiel 1: So führen Sie eine Aufgabe auf Ihrem Standard-Cluster aus** Im folgenden Beispiel für `run-task` wird eine Aufgabe auf dem Standard-Cluster ausgeführt und ein Client-Token verwendet. ``` aws ecs run-task \ --cluster default \ --task-definition sleep360:1 \ --client-token 550e8400-e29b-41d4-a716-446655440000 ``` Ausgabe: ``` { "tasks": [ { "attachments": [], "attributes": [ { "name": "ecs.cpu-architecture", "value": "x86_64" } ], "availabilityZone": "us-east-1b", "capacityProviderName": "example-capacity-provider", "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/default", "containerInstanceArn": "arn:aws:ecs:us-east-1:123456789012:container-instance/default/bc4d2ec611d04bb7bb97e83ceEXAMPLE", "containers": [ { "containerArn": "arn:aws:ecs:us-east-1:123456789012:container/default/d6f51cc5bbc94a47969c92035e9f66f8/75853d2d-711e-458a-8362-0f0aEXAMPLE", "taskArn": "arn:aws:ecs:us-east-1:123456789012:task/default/d6f51cc5bbc94a47969c9203EXAMPLE", "name": "sleep", "image": "busybox", "lastStatus": "PENDING", "networkInterfaces": [], "cpu": "10", "memory": "10" } ], "cpu": "10", "createdAt": "2023-11-21T16:59:34.403000-05:00", "desiredStatus": "RUNNING", "enableExecuteCommand": false, "group": "family:sleep360", "lastStatus": "PENDING", "launchType": "EC2", "memory": "10", "overrides": { "containerOverrides": [ { "name": "sleep" } ], "inferenceAcceleratorOverrides": [] }, "tags": [], "taskArn": "arn:aws:ecs:us-east-1:123456789012:task/default/d6f51cc5bbc94a47969c9203EXAMPLE", "taskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:task-definition/sleep360:1", "version": 1 } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Ausführen einer Anwendung als eigenständige Aufgabe](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/standalone-task-create.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So konfigurieren Sie ein Amazon-EBS-Volume für eine eigenständige Aufgabe** Im folgenden Beispiel für `run-task` wird ein verschlüsseltes Amazon-EBS-Volume für eine Fargate-Aufgabe auf dem Standard-Cluster konfiguriert. Sie müssen über eine Amazon-ECS-Infrastrukturrolle verfügen, die mit der angehängten verwalteten Richtlinie `AmazonECSInfrastructureRolePolicyForVolumes` konfiguriert ist. Sie müssen eine Aufgabendefinition mit demselben Volume-Namen wie in der `run-task`-Anforderung angeben. In diesem Beispiel werden die Option `--cli-input-json` und eine JSON-Eingabedatei mit dem Namen `ebs.json` verwendet. ``` aws ecs run-task \ --cli-input-json file://ebs.json ``` Inhalt von `ebs.json`: ``` { "cluster": "default", "taskDefinition": "mytaskdef", "launchType": "FARGATE", "networkConfiguration":{ "awsvpcConfiguration":{ "assignPublicIp": "ENABLED", "securityGroups": ["sg-12344321"], "subnets":["subnet-12344321"] } }, "volumeConfigurations": [ { "name": "myEBSVolume", "managedEBSVolume": { "volumeType": "gp3", "sizeInGiB": 100, "roleArn":"arn:aws:iam::1111222333:role/ecsInfrastructureRole", "encrypted": true, "kmsKeyId": "arn:aws:kms:region:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" } } ] } ``` Ausgabe: ``` { "tasks": [ { "attachments": [ { "id": "ce868693-15ca-4083-91ac-f782f64000c9", "type": "ElasticNetworkInterface", "status": "PRECREATED", "details": [ { "name": "subnetId", "value": "subnet-070982705451dad82" } ] }, { "id": "a17ed863-786c-4372-b5b3-b23e53f37877", "type": "AmazonElasticBlockStorage", "status": "CREATED", "details": [ { "name": "roleArn", "value": "arn:aws:iam::123456789012:role/ecsInfrastructureRole" }, { "name": "volumeName", "value": "myEBSVolume" }, { "name": "deleteOnTermination", "value": "true" } ] } ], "attributes": [ { "name": "ecs.cpu-architecture", "value": "x86_64" } ], "availabilityZone": "us-west-2b", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/default", "containers": [ { "containerArn": "arn:aws:ecs:us-west-2:123456789012:container/default/7f1fbd3629434cc4b82d72d2f09b67c9/e21962a2-f328-4699-98a3-5161ac2c186a", "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/default/7f1fbd3629434cc4b82d72d2f09b67c9", "name": "container-using-ebs", "image": "amazonlinux:2", "lastStatus": "PENDING", "networkInterfaces": [], "cpu": "0" } ], "cpu": "1024", "createdAt": "2025-01-23T10:29:46.650000-06:00", "desiredStatus": "RUNNING", "enableExecuteCommand": false, "group": "family:mytaskdef", "lastStatus": "PROVISIONING", "launchType": "FARGATE", "memory": "3072", "overrides": { "containerOverrides": [ { "name": "container-using-ebs" } ], "inferenceAcceleratorOverrides": [] }, "platformVersion": "1.4.0", "platformFamily": "Linux", "tags": [], "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/default/7f1fbd3629434cc4b82d72d2f09b67c9", "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:4", "version": 1, "ephemeralStorage": { "sizeInGiB": 20 }, "fargateEphemeralStorage": { "sizeInGiB": 20 } } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Verwenden von Amazon-EBS-Volumes mit Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [RunTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/run-task.html)in der *AWS CLI Befehlsreferenz*. ### `start-task` Das folgende Codebeispiel zeigt die Verwendung`start-task`. **AWS CLI** **Beispiel 1: So starten Sie eine neue Aufgabe** Im folgenden Beispiel für `start-task` wird eine Aufgabe mit der neuesten Revision der `sleep360`-Aufgabendefinition auf der angegebenen Container-Instance im Standard-Cluster gestartet. ``` aws ecs start-task \ --task-definition sleep360 \ --container-instances 765936fadbdd46b5991a4bd70c2a43d4 ``` Ausgabe: ``` { "tasks": [ { "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/default/666fdccc2e2d4b6894dd422f4eeee8f8", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/default", "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep360:3", "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/default/765936fadbdd46b5991a4bd70c2a43d4", "overrides": { "containerOverrides": [ { "name": "sleep" } ] }, "lastStatus": "PENDING", "desiredStatus": "RUNNING", "cpu": "128", "memory": "128", "containers": [ { "containerArn": "arn:aws:ecs:us-west-2:123456789012:container/75f11ed4-8a3d-4f26-a33b-ad1db9e02d41", "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/default/666fdccc2e2d4b6894dd422f4eeee8f8", "name": "sleep", "lastStatus": "PENDING", "networkInterfaces": [], "cpu": "10", "memory": "10" } ], "version": 1, "createdAt": 1563421494.186, "group": "family:sleep360", "launchType": "EC2", "attachments": [], "tags": [] } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Planen Ihrer Container in Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So konfigurieren Sie ein Amazon-EBS-Volume beim Start einer Aufgabe** Im folgenden Beispiel für `start-task` wird ein verschlüsseltes Amazon-EBS-Volume für eine Aufgabe auf der angegebenen Container-Instance konfiguriert. Sie müssen über eine Amazon-ECS-Infrastrukturrolle verfügen, die mit der angehängten verwalteten Richtlinie `AmazonECSInfrastructureRolePolicyForVolumes` konfiguriert ist. Sie müssen eine Aufgabendefinition mit demselben Volume-Namen wie in der `start-task`-Anforderung angeben. In diesem Beispiel werden die Option `--cli-input-json` und eine JSON-Eingabedatei mit dem Namen `ebs.json` und dem folgenden Inhalt verwendet. ``` aws ecs start-task \ --cli-input-json file://ebs.json \ --container-instances 765936fadbdd46b5991a4bd70c2a43d4 ``` Inhalt von `ebs.json`: ``` { "cluster": "default", "taskDefinition": "mytaskdef", "networkConfiguration":{ "awsvpcConfiguration":{ "assignPublicIp": "ENABLED", "securityGroups": ["sg-12344321"], "subnets":["subnet-12344321"] } }, "volumeConfigurations": [ { "name": "myEBSVolume", "managedEBSVolume": { "volumeType": "gp3", "sizeInGiB": 100, "roleArn":"arn:aws:iam::123456789012:role/ecsInfrastructureRole", "encrypted": true, "kmsKeyId": "arn:aws:kms:region:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab" } } ] } ``` Ausgabe: ``` { "tasks": [ { "attachments": [ { "id": "aea29489-9dcd-49f1-8164-4d91566e1113", "type": "ElasticNetworkInterface", "status": "PRECREATED", "details": [ { "name": "subnetId", "value": "subnet-12344321" } ] }, { "id": "f29e1222-9a1e-410f-b499-a12a7cd6d42e", "type": "AmazonElasticBlockStorage", "status": "CREATED", "details": [ { "name": "roleArn", "value": "arn:aws:iam::123456789012:role/ecsInfrastructureRole" }, { "name": "volumeName", "value": "myEBSVolume" }, { "name": "deleteOnTermination", "value": "true" } ] } ], "attributes": [ { "name": "ecs.cpu-architecture", "value": "arm64" } ], "availabilityZone": "us-west-2c", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/default", "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/default/765936fadbdd46b5991a4bd70c2a43d4", "containers": [ { "containerArn": "arn:aws:ecs:us-west-2:123456789012:container/default/bb122ace3ed84add92c00a351a03c69e/a4a9ed10-51c7-4567-9653-50e71b94f867", "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/default/bb122ace3ed84add92c00a351a03c69e", "name": "container-using-ebs", "image": "amazonlinux:2", "lastStatus": "PENDING", "networkInterfaces": [], "cpu": "0" } ], "cpu": "1024", "createdAt": "2025-01-23T14:51:05.191000-06:00", "desiredStatus": "RUNNING", "enableExecuteCommand": false, "group": "family:mytaskdef", "lastStatus": "PROVISIONING", "launchType": "EC2", "memory": "3072", "overrides": { "containerOverrides": [ { "name": "container-using-ebs" } ], "inferenceAcceleratorOverrides": [] }, "tags": [], "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/default/bb122ace3ed84add92c00a351a03c69e", "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:4", "version": 1 } ], "failures": [] } ``` Weitere Informationen finden Sie unter [Verwenden von Amazon-EBS-Volumes mit Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [StartTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/start-task.html)in der *AWS CLI Befehlsreferenz*. ### `stop-task` Das folgende Codebeispiel zeigt die Verwendung`stop-task`. **AWS CLI** **So beenden Sie eine Aufgabe** Mit dem folgenden `stop-task`-Befehl wird die Ausführung der angegebenen Aufgabe im Standard-Cluster beendet. ``` aws ecs stop-task \ --task 666fdccc2e2d4b6894dd422f4eeee8f8 ``` Ausgabe: ``` { "task": { "taskArn": "arn:aws:ecs:us-west-2:130757420319:task/default/666fdccc2e2d4b6894dd422f4eeee8f8", "clusterArn": "arn:aws:ecs:us-west-2:130757420319:cluster/default", "taskDefinitionArn": "arn:aws:ecs:us-west-2:130757420319:task-definition/sleep360:3", "containerInstanceArn": "arn:aws:ecs:us-west-2:130757420319:container-instance/default/765936fadbdd46b5991a4bd70c2a43d4", "overrides": { "containerOverrides": [] }, "lastStatus": "STOPPED", "desiredStatus": "STOPPED", "cpu": "128", "memory": "128", "containers": [], "version": 2, "stoppedReason": "Taskfailedtostart", "stopCode": "TaskFailedToStart", "connectivity": "CONNECTED", "connectivityAt": 1563421494.186, "pullStartedAt": 1563421494.252, "pullStoppedAt": 1563421496.252, "executionStoppedAt": 1563421497, "createdAt": 1563421494.186, "stoppingAt": 1563421497.252, "stoppedAt": 1563421497.252, "group": "family:sleep360", "launchType": "EC2", "attachments": [], "tags": [] } } ``` + Einzelheiten zur API finden Sie [StopTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/stop-task.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird der angegebenen Ressource ein einzelnes Tag hinzugefügt. ``` aws ecs tag-resource \ --resource-arn arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster --tags key=key1,value=value1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **So fügen Sie einer Ressource mehrere Tags hinzu** Im folgenden Beispiel für `tag-resource` werden der angegebenen Ressource mehrere Tags hinzugefügt. ``` aws ecs tag-resource \ --resource-arn arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster \ --tags key=key1,value=value1 key=key2,value=value2 key=key3,value=value3 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einer Ressource** Im folgenden Beispiel für `untag-resource` werden die aufgeführten Tags von der angegebenen Ressource entfernt. ``` aws ecs untag-resource \ --resource-arn arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster \ --tag-keys key1,key2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-cluster-settings` Das folgende Codebeispiel zeigt die Verwendung`update-cluster-settings`. **AWS CLI** **So ändern Sie die Einstellungen für Ihren Cluster** Das folgende `update-cluster-settings` Beispiel aktiviert CloudWatch Container Insights mit verbesserter Beobachtbarkeit für den `MyCluster` Cluster. ``` aws ecs update-cluster-settings \ --cluster MyCluster \ --settings name=containerInsights,value=enhanced ``` Ausgabe: ``` { "cluster": { "clusterArn": "arn:aws:ecs:us-esat-1:123456789012:cluster/MyCluster", "clusterName": "default", "status": "ACTIVE", "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "pendingTasksCount": 0, "activeServicesCount": 0, "statistics": [], "tags": [], "settings": [ { "name": "containerInsights", "value": "enhanced" } ] } } ``` Weitere Informationen finden Sie unter [Ändern der Kontoeinstellungen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-modifying-longer-id-settings.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [UpdateClusterSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/update-cluster-settings.html)in der *AWS CLI Befehlsreferenz.* ### `update-cluster` Das folgende Codebeispiel zeigt die Verwendung`update-cluster`. **AWS CLI** **Beispiel 1: So aktualisieren Sie den ECS-Cluster und aktivieren containerInsights** Im folgenden Beispiel für `update-cluster` wird der containerInsights-Wert in einem bereits erstellten Cluster auf `enabled` aktualisiert. Standardmäßig ist er deaktiviert. ``` aws ecs update-cluster \ --cluster ECS-project-update-cluster \ --settings name=containerInsights,value=enabled ``` Ausgabe: ``` "cluster": { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster", "clusterName": "ECS-project-update-cluster", "status": "ACTIVE", "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "pendingTasksCount": 0, "activeServicesCount": 0, "statistics": [], "tags": [], "settings": [ { "name": "containerInsights", "value": "enabled" } ], "capacityProviders": [ "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" ], "defaultCapacityProviderStrategy": [ { "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt", "weight": 1, "base": 0 } ], "attachments": [ { "id": "069d002b-7634-42e4-b1d4-544f4c8f6380", "type": "as_policy", "status": "CREATED", "details": [ { "name": "capacityProviderName", "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93" } ] }, { "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a", "type": "managed_draining", "status": "CREATED", "details": [ { "name": "capacityProviderName", "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" }, { "name": "autoScalingLifecycleHookName", "value": "ecs-managed-draining-termination-hook" } ] }, { "id": "45d0b36f-8cff-46b6-9380-1288744802ab", "type": "sc", "status": "ATTACHED", "details": [] } ], "attachmentsStatus": "UPDATE_COMPLETE", "serviceConnectDefaults": { "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-igwrsylmy3kwvcdx" } } ``` **Beispiel 2: Aktualisieren Sie den ECS-Cluster, um einen standardmäßigen Service Connect-Namespace festzulegen** Im folgenden Beispiel für `update-cluster` wird der ECS-Cluster aktualisiert, indem ein standardmäßiger Service-Connect-Namespace festgelegt wird. ``` aws ecs update-cluster \ --cluster ECS-project-update-cluster \ --service-connect-defaults namespace=test ``` Ausgabe: ``` { "cluster": { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster", "clusterName": "ECS-project-update-cluster", "status": "ACTIVE", "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "pendingTasksCount": 0, "activeServicesCount": 0, "statistics": [], "tags": [], "settings": [ { "name": "containerInsights", "value": "enabled" } ], "capacityProviders": [ "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" ], "defaultCapacityProviderStrategy": [ { "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt", "weight": 1, "base": 0 } ], "attachments": [ { "id": "069d002b-7634-42e4-b1d4-544f4c8f6380", "type": "as_policy", "status": "CREATED", "details": [ { "name": "capacityProviderName", "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93" } ] }, { "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a", "type": "managed_draining", "status": "CREATED", "details": [ { "name": "capacityProviderName", "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" }, { "name": "autoScalingLifecycleHookName", "value": "ecs-managed-draining-termination-hook" } ] }, { "id": "45d0b36f-8cff-46b6-9380-1288744802ab", "type": "sc", "status": "DELETED", "details": [] }, { "id": "3e6890c3-609c-4832-91de-d6ca891b3ef1", "type": "sc", "status": "ATTACHED", "details": [] }, { "id": "961b8ec1-c2f1-4070-8495-e669b7668e90", "type": "sc", "status": "DELETED", "details": [] } ], "attachmentsStatus": "UPDATE_COMPLETE", "serviceConnectDefaults": { "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-dtjmxqpfi46ht7dr" } } } ``` Weitere Informationen zu Service Connect finden Sie unter [Verwenden von Service Connect, um Amazon-ECS-Services mit Kurznamen zu verbinden](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [UpdateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/update-cluster.html)in der *AWS CLI Befehlsreferenz.* ### `update-container-agent` Das folgende Codebeispiel zeigt die Verwendung`update-container-agent`. **AWS CLI** **So aktualisieren Sie den Container-Agenten auf einer Container-Instance von Amazon ECS** Im folgenden Beispiel für `update-container-agent` wird der Container-Agent auf der angegebenen Container-Instance im Standard-Cluster aktualisiert. ``` aws ecs update-container-agent --cluster default --container-instance a1b2c3d4-5678-90ab-cdef-11111EXAMPLE ``` Ausgabe: ``` { "containerInstance": { "status": "ACTIVE", ... "agentUpdateStatus": "PENDING", "versionInfo": { "agentVersion": "1.0.0", "agentHash": "4023248", "dockerVersion": "DockerVersion: 1.5.0" } } } ``` Weitere Informationen finden Sie unter [Aktualisieren des Container-Agenten von Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [UpdateContainerAgent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/update-container-agent.html)in der *AWS CLI Befehlsreferenz*. ### `update-container-instances-state` Das folgende Codebeispiel zeigt die Verwendung`update-container-instances-state`. **AWS CLI** **So aktualisieren Sie den Status einer Container-Instance** Im folgenden Beispiel für `update-container-instances-state` wird der Status der angegebenen Container-Instance auf `DRAINING` aktualisiert, wodurch sie aus dem Cluster entfernt wird, in dem sie registriert ist. ``` aws ecs update-container-instances-state \ --container-instances 765936fadbdd46b5991a4bd70c2a43d4 \ --status DRAINING ``` Ausgabe: ``` { "containerInstances": [ { "containerInstanceArn": "arn:aws:ecs:us-west-2:130757420319:container-instance/default/765936fadbdd46b5991a4bd70c2a43d4", "ec2InstanceId": "i-013d87ffbb4d513bf", "version": 4390, "versionInfo": { "agentVersion": "1.29.0", "agentHash": "a190a73f", "dockerVersion": "DockerVersion:18.06.1-ce" }, "remainingResources": [ { "name": "CPU", "type": "INTEGER", "doubleValue": 0, "longValue": 0, "integerValue": 1536 }, { "name": "MEMORY", "type": "INTEGER", "doubleValue": 0, "longValue": 0, "integerValue": 2681 }, { "name": "PORTS", "type": "STRINGSET", "doubleValue": 0, "longValue": 0, "integerValue": 0, "stringSetValue": [ "22", "2376", "2375", "51678", "51679" ] }, { "name": "PORTS_UDP", "type": "STRINGSET", "doubleValue": 0, "longValue": 0, "integerValue": 0, "stringSetValue": [] } ], "registeredResources": [ { "name": "CPU", "type": "INTEGER", "doubleValue": 0, "longValue": 0, "integerValue": 2048 }, { "name": "MEMORY", "type": "INTEGER", "doubleValue": 0, "longValue": 0, "integerValue": 3705 }, { "name": "PORTS", "type": "STRINGSET", "doubleValue": 0, "longValue": 0, "integerValue": 0, "stringSetValue": [ "22", "2376", "2375", "51678", "51679" ] }, { "name": "PORTS_UDP", "type": "STRINGSET", "doubleValue": 0, "longValue": 0, "integerValue": 0, "stringSetValue": [] } ], "status": "DRAINING", "agentConnected": true, "runningTasksCount": 2, "pendingTasksCount": 0, "attributes": [ { "name": "ecs.capability.secrets.asm.environment-variables" }, { "name": "ecs.capability.branch-cni-plugin-version", "value": "e0703516-" }, { "name": "ecs.ami-id", "value": "ami-00e0090ac21971297" }, { "name": "ecs.capability.secrets.asm.bootstrap.log-driver" }, { "name": "com.amazonaws.ecs.capability.logging-driver.none" }, { "name": "ecs.capability.ecr-endpoint" }, { "name": "ecs.capability.docker-plugin.local" }, { "name": "ecs.capability.task-cpu-mem-limit" }, { "name": "ecs.capability.secrets.ssm.bootstrap.log-driver" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.30" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.31" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.32" }, { "name": "ecs.availability-zone", "value": "us-west-2c" }, { "name": "ecs.capability.aws-appmesh" }, { "name": "com.amazonaws.ecs.capability.logging-driver.awslogs" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.24" }, { "name": "ecs.capability.task-eni-trunking" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.25" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.26" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.27" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.28" }, { "name": "com.amazonaws.ecs.capability.privileged-container" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.29" }, { "name": "ecs.cpu-architecture", "value": "x86_64" }, { "name": "com.amazonaws.ecs.capability.ecr-auth" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.20" }, { "name": "ecs.os-type", "value": "linux" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.21" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.22" }, { "name": "ecs.capability.task-eia" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.23" }, { "name": "ecs.capability.private-registry-authentication.secretsmanager" }, { "name": "com.amazonaws.ecs.capability.logging-driver.syslog" }, { "name": "com.amazonaws.ecs.capability.logging-driver.json-file" }, { "name": "ecs.capability.execution-role-awslogs" }, { "name": "ecs.vpc-id", "value": "vpc-1234" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.17" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.18" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.19" }, { "name": "ecs.capability.task-eni" }, { "name": "ecs.capability.execution-role-ecr-pull" }, { "name": "ecs.capability.container-health-check" }, { "name": "ecs.subnet-id", "value": "subnet-1234" }, { "name": "ecs.instance-type", "value": "c5.large" }, { "name": "com.amazonaws.ecs.capability.task-iam-role-network-host" }, { "name": "ecs.capability.container-ordering" }, { "name": "ecs.capability.cni-plugin-version", "value": "91ccefc8-2019.06.0" }, { "name": "ecs.capability.pid-ipc-namespace-sharing" }, { "name": "ecs.capability.secrets.ssm.environment-variables" }, { "name": "com.amazonaws.ecs.capability.task-iam-role" } ], "registeredAt": 1560788724.507, "attachments": [], "tags": [] } ], "failures": [] } ``` + Einzelheiten zur API finden Sie [UpdateContainerInstancesState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/update-container-instances-state.html)in der *AWS CLI Befehlsreferenz*. ### `update-service-primary-task-set` Das folgende Codebeispiel zeigt die Verwendung`update-service-primary-task-set`. **AWS CLI** **So aktualisieren Sie den primären Aufgabensatz für einen Service** Im folgenden Beispiel für `update-service-primary-task-set` wird der primäre Aufgabensatz für den angegebenen Service aktualisiert. ``` aws ecs update-service-primary-task-set \ --cluster MyCluster \ --service MyService \ --primary-task-set arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789 ``` Ausgabe: ``` { "taskSet": { "id": "ecs-svc/1234567890123456789", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", "computedDesiredCount": 1, "pendingCount": 0, "runningCount": 0, "createdAt": 1557128360.711, "updatedAt": 1557129412.653, "launchType": "EC2", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344312" ], "assignPublicIp": "DISABLED" } }, "loadBalancers": [], "serviceRegistries": [], "scale": { "value": 50.0, "unit": "PERCENT" }, "stabilityStatus": "STABILIZING", "stabilityStatusAt": 1557129279.914 } } ``` + Einzelheiten zur API finden Sie [UpdateServicePrimaryTaskSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/update-service-primary-task-set.html)in der *AWS CLI Befehlsreferenz*. ### `update-service` Das folgende Codebeispiel zeigt die Verwendung`update-service`. **AWS CLI** **Beispiel 1: So ändern Sie die in einem Service verwendete Aufgabendefinition** Im folgenden Beispiel für `update-service` wird der Service `my-http-service` auf die Verwendung der Aufgabendefinition `amazon-ecs-sample` aktualisiert. ``` aws ecs update-service \ --cluster test \ --service my-http-service \ --task-definition amazon-ecs-sample ``` Ausgabe: ``` { "service": { "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/test/my-http-service", "serviceName": "my-http-service", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/test", "loadBalancers": [], "serviceRegistries": [], "status": "ACTIVE", "desiredCount": 2, "runningCount": 2, "pendingCount": 0, "launchType": "FARGATE", "platformVersion": "1.4.0", "platformFamily": "Linux", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/amazon-ecs-sample:2", "deploymentConfiguration": { "deploymentCircuitBreaker": { "enable": true, "rollback": true }, "maximumPercent": 200, "minimumHealthyPercent": 100, "alarms": { "alarmNames": [], "rollback": false, "enable": false } }, "deployments": [ { "id": "ecs-svc/7419115625193919142", "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/amazon-ecs-sample:2", "desiredCount": 0, "pendingCount": 0, "runningCount": 0, "failedTasks": 0, "createdAt": "2025-02-21T13:26:02.734000-06:00", "updatedAt": "2025-02-21T13:26:02.734000-06:00", "launchType": "FARGATE", "platformVersion": "1.4.0", "platformFamily": "Linux", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "rolloutState": "IN_PROGRESS", "rolloutStateReason": "ECS deployment ecs-svc/7419115625193919142 in progress." }, { "id": "ecs-svc/1709597507655421668", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/old-amazon-ecs-sample:4", "desiredCount": 2, "pendingCount": 0, "runningCount": 2, "failedTasks": 0, "createdAt": "2025-01-24T11:13:07.621000-06:00", "updatedAt": "2025-02-02T16:11:30.838000-06:00", "launchType": "FARGATE", "platformVersion": "1.4.0", "platformFamily": "Linux", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "rolloutState": "COMPLETED", "rolloutStateReason": "ECS deployment ecs-svc/1709597507655421668 completed." } ], "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", "events": [ { "id": "e40b4d1c-80d9-4834-aaf3-6a268e530e17", "createdAt": "2025-02-21T10:31:26.037000-06:00", "message": "(my-http-service) has reached a steady state." }, { "id": "6ac069ad-fc8b-4e49-a35d-b5574a964c8e", "createdAt": "2025-02-21T04:31:22.703000-06:00", "message": "(my-http-service) has reached a steady state." }, { "id": "265f7d37-dfd1-4880-a846-ec486f341919", "createdAt": "2025-02-20T22:31:22.514000-06:00", "message": "(my-http-service) has reached a steady state." } ], "createdAt": "2024-10-30T17:12:43.218000-05:00", "placementConstraints": [], "placementStrategy": [], "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321", ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "healthCheckGracePeriodSeconds": 0, "schedulingStrategy": "REPLICA", "deploymentController": { "type": "ECS" }, "createdBy": "arn:aws:iam::123456789012:role/AIDACKCEVSQ6C2EXAMPLE", "enableECSManagedTags": true, "propagateTags": "NONE", "enableExecuteCommand": false, "availabilityZoneRebalancing": "DISABLED" } } ``` Weitere Informationen finden Sie unter [Aktualisieren eines Amazon-ECS-Service mithilfe der Konsole](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 2: So ändern Sie die Anzahl der Aufgaben in einem Service** Im folgenden Beispiel für `update-service` wird die gewünschte Aufgabenanzahl des Service `my-http-service` auf 2 aktualisiert. ``` aws ecs update-service \ --cluster MyCluster \ --service my-http-service \ --desired-count 2 ``` Ausgabe: ``` { "service": { "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/MyCluster/my-http-service", "serviceName": "my-http-service", "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster", "loadBalancers": [], "serviceRegistries": [], "status": "ACTIVE", "desiredCount": 2, "runningCount": 1, "pendingCount": 0, "capacityProviderStrategy": [ { "capacityProvider": "FARGATE", "weight": 1, "base": 0 } ], "platformVersion": "LATEST", "platformFamily": "Linux", "taskDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/MyTaskDefinition", "deploymentConfiguration": { "deploymentCircuitBreaker": { "enable": true, "rollback": true }, "maximumPercent": 200, "minimumHealthyPercent": 100, "alarms": { "alarmNames": [], "rollback": false, "enable": false } }, "deployments": [ { "id": "ecs-svc/1976744184940610707", "status": "PRIMARY", "taskkDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/MyTaskDefinition", "desiredCount": 1, "pendingCount": 0, "runningCount": 1, "failedTasks": 0, "createdAt": "2024-12-03T16:24:25.225000-05:00", "updatedAt": "2024-12-03T16:25:15.837000-05:00", "capacityProviderStrategy": [ { "capacityProvider": "FARGATE", "weight": 1, "base": 0 } ], "platformVersion": "1.4.0", "platformFamily": "Linux", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-0d0eab1bb38d5ca64", "subnet-0db5010045995c2d5" ], "securityGroups": [ "sg-02556bf85a191f59a" ], "assignPublicIp": "ENABLED" } }, "rolloutState": "COMPLETED", "rolloutStateReason": "ECS deployment ecs-svc/1976744184940610707 completed." } ], "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", "events": [ { "id": "f27350b9-4b2a-4e2e-b72e-a4b68380de45", "createdAt": "2024-12-30T13:24:07.345000-05:00", "message": "(service my-http-service) has reached a steady state." }, { "id": "e764ec63-f53f-45e3-9af2-d99f922d2957", "createdAt": "2024-12-30T12:32:21.600000-05:00", "message": "(service my-http-service) has reached a steady state." }, { "id": "28444756-c2fa-47f8-bd60-93a8e05f3991", "createdAt": "2024-12-08T19:26:10.367000-05:00", "message": "(service my-http-service) has reached a steady state." } ], "createdAt": "2024-12-03T16:24:25.225000-05:00", "placementConstraints": [], "placementStrategy": [], "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-0d0eab1bb38d5ca64", "subnet-0db5010045995c2d5" ], "securityGroups": [ "sg-02556bf85a191f59a" ], "assignPublicIp": "ENABLED" } }, "healthCheckGracePeriodSeconds": 0, "schedulingStrategy": "REPLICA", "deploymentController": { "type": "ECS" }, "createdBy": "arn:aws:iam::123456789012:role/Admin", "enableECSManagedTags": true, "propagateTags": "NONE", "enableExecuteCommand": false, "availabilityZoneRebalancing": "ENABLED" } } ``` Weitere Informationen finden Sie unter [Aktualisieren eines Amazon-ECS-Service mithilfe der Konsole](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 3: So konfigurieren Sie Amazon-EBS-Volumes für Anhänge beim Service-Update** Im folgenden Beispiel für `update-service` wird der Service `my-http-service` aktualisiert, sodass er Amazon-EBS-Volumes verwendet. Sie müssen über eine Amazon-ECS-Infrastrukturrolle verfügen, die mit der angehängten verwalteten Richtlinie `AmazonECSInfrastructureRolePolicyForVolumes` konfiguriert ist. Sie müssen eine Aufgabendefinition mit demselben Volume-Namen wie in der `update-service`-Anforderung angeben und `configuredAtLaunch` auf `true` festlegen. In diesem Beispiel werden die Option `--cli-input-json` und eine JSON-Eingabedatei mit dem Namen `ebs.json` verwendet. ``` aws ecs update-service \ --cli-input-json file://ebs.json ``` Inhalt von `ebs.json`: ``` { "cluster": "mycluster", "taskDefinition": "mytaskdef", "service": "my-http-service", "desiredCount": 2, "volumeConfigurations": [ { "name": "myEbsVolume", "managedEBSVolume": { "roleArn":"arn:aws:iam::123456789012:role/ecsInfrastructureRole", "volumeType": "gp3", "sizeInGiB": 100, "iops": 3000, "throughput": 125, "filesystemType": "ext4" } } ] } ``` Ausgabe: ``` { "service": { "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/mycluster/my-http-service", "serviceName": "my-http-service", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/mycluster", "loadBalancers": [], "serviceRegistries": [], "status": "ACTIVE", "desiredCount": 2, "runningCount": 2, "pendingCount": 0, "launchType": "FARGATE", "platformVersion": "LATEST", "platformFamily": "Linux", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:1", "deploymentConfiguration": { "deploymentCircuitBreaker": { "enable": true, "rollback": true }, "maximumPercent": 200, "minimumHealthyPercent": 100, "alarms": { "alarmNames": [], "rollback": false, "enable": false } }, "deployments": [ { "id": "ecs-svc/2420458347226626275", "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:1", "desiredCount": 0, "pendingCount": 0, "runningCount": 0, "failedTasks": 0, "createdAt": "2025-02-21T15:07:20.519000-06:00", "updatedAt": "2025-02-21T15:07:20.519000-06:00", "launchType": "FARGATE", "platformVersion": "1.4.0", "platformFamily": "Linux", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321", ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "rolloutState": "IN_PROGRESS", "rolloutStateReason": "ECS deployment ecs-svc/2420458347226626275 in progress.", "volumeConfigurations": [ { "name": "ebs-volume", "managedEBSVolume": { "volumeType": "gp3", "sizeInGiB": 100, "iops": 3000, "throughput": 125, "roleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole", "filesystemType": "ext4" } } ] }, { "id": "ecs-svc/5191625155316533644", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:2", "desiredCount": 2, "pendingCount": 0, "runningCount": 2, "failedTasks": 0, "createdAt": "2025-02-21T14:54:48.862000-06:00", "updatedAt": "2025-02-21T14:57:22.502000-06:00", "launchType": "FARGATE", "platformVersion": "1.4.0", "platformFamily": "Linux", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "rolloutState": "COMPLETED", "rolloutStateReason": "ECS deployment ecs-svc/5191625155316533644 completed." } ], "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", "events": [ { "id": "b5823113-c2c5-458e-9649-8c2ed38f23a5", "createdAt": "2025-02-21T14:57:22.508000-06:00", "message": "(service my-http-service) has reached a steady state." }, { "id": "b05a48e8-da35-4074-80aa-37ceb3167357", "createdAt": "2025-02-21T14:57:22.507000-06:00", "message": "(service my-http-service) (deployment ecs-svc/5191625155316533644) deployment completed." }, { "id": "a10cd55d-4ba6-4cea-a655-5a5d32ada8a0", "createdAt": "2025-02-21T14:55:32.833000-06:00", "message": "(service my-http-service) has started 1 tasks: (task fb9c8df512684aec92f3c57dc3f22361)." }, ], "createdAt": "2025-02-21T14:54:48.862000-06:00", "placementConstraints": [], "placementStrategy": [], "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "healthCheckGracePeriodSeconds": 0, "schedulingStrategy": "REPLICA", "deploymentController": { "type": "ECS" }, "createdBy": "arn:aws:iam::123456789012:role/AIDACKCEVSQ6C2EXAMPLE", "enableECSManagedTags": true, "propagateTags": "NONE", "enableExecuteCommand": false, "availabilityZoneRebalancing": "ENABLED" } } ``` Weitere Informationen finden Sie unter [Verwenden von Amazon-EBS-Volumes mit Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 4: So aktualisieren Sie einen Service dahingehend, dass er keine Amazon-EBS-Volumes mehr verwendet** Im folgenden Beispiel für `update-service` wird der Service `my-http-service` aktualisiert, sodass er keine Amazon-EBS-Volumes mehr verwendet. Sie müssen eine Aufgabendefinition angeben, bei der `configuredAtLaunch` auf `false` festgelegt ist. ``` aws ecs update-service \ --cluster mycluster \ --task-definition mytaskdef \ --service my-http-service \ --desired-count 2 \ --volume-configurations "[]" ``` Ausgabe: ``` { "service": { "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/mycluster/my-http-service", "serviceName": "my-http-service", "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/mycluster", "loadBalancers": [], "serviceRegistries": [], "status": "ACTIVE", "desiredCount": 2, "runningCount": 2, "pendingCount": 0, "launchType": "FARGATE", "platformVersion": "LATEST", "platformFamily": "Linux", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:3", "deploymentConfiguration": { "deploymentCircuitBreaker": { "enable": true, "rollback": true }, "maximumPercent": 200, "minimumHealthyPercent": 100, "alarms": { "alarmNames": [], "rollback": false, "enable": false } }, "deployments": [ { "id": "ecs-svc/7522791612543716777", "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:3", "desiredCount": 0, "pendingCount": 0, "runningCount": 0, "failedTasks": 0, "createdAt": "2025-02-21T15:25:38.598000-06:00", "updatedAt": "2025-02-21T15:25:38.598000-06:00", "launchType": "FARGATE", "platformVersion": "1.4.0", "platformFamily": "Linux", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "rolloutState": "IN_PROGRESS", "rolloutStateReason": "ECS deployment ecs-svc/7522791612543716777 in progress." }, { "id": "ecs-svc/2420458347226626275", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/myoldtaskdef:1", "desiredCount": 2, "pendingCount": 0, "runningCount": 2, "failedTasks": 0, "createdAt": "2025-02-21T15:07:20.519000-06:00", "updatedAt": "2025-02-21T15:10:59.955000-06:00", "launchType": "FARGATE", "platformVersion": "1.4.0", "platformFamily": "Linux", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "rolloutState": "COMPLETED", "rolloutStateReason": "ECS deployment ecs-svc/2420458347226626275 completed.", "volumeConfigurations": [ { "name": "ebs-volume", "managedEBSVolume": { "volumeType": "gp3", "sizeInGiB": 100, "iops": 3000, "throughput": 125, "roleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole", "filesystemType": "ext4" } } ] } ], "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", "events": [ { "id": "4f2c3ca1-7800-4048-ba57-bba210ada2ad", "createdAt": "2025-02-21T15:10:59.959000-06:00", "message": "(service my-http-service) has reached a steady state." }, { "id": "4b36a593-2d40-4ed6-8be8-b9b699eb6198", "createdAt": "2025-02-21T15:10:59.958000-06:00", "message": "(service my-http-service) (deployment ecs-svc/2420458347226626275) deployment completed." }, { "id": "88380089-14e2-4ef0-8dbb-a33991683371", "createdAt": "2025-02-21T15:09:39.055000-06:00", "message": "(service my-http-service) has stopped 1 running tasks: (task fb9c8df512684aec92f3c57dc3f22361)." }, { "id": "97d84243-d52f-4255-89bb-9311391c61f6", "createdAt": "2025-02-21T15:08:57.653000-06:00", "message": "(service my-http-service) has stopped 1 running tasks: (task 33eff090ad2c40539daa837e6503a9bc)." }, { "id": "672ece6c-e2d0-4021-b5da-eefb14001687", "createdAt": "2025-02-21T15:08:15.631000-06:00", "message": "(service my-http-service) has started 1 tasks: (task 996c02a66ff24f3190a4a8e0c841740f)." }, { "id": "a3cf9bea-9be6-4175-ac28-4c68360986eb", "createdAt": "2025-02-21T15:07:36.931000-06:00", "message": "(service my-http-service) has started 1 tasks: (task d5d23c39f89e46cf9a647b9cc6572feb)." }, { "id": "b5823113-c2c5-458e-9649-8c2ed38f23a5", "createdAt": "2025-02-21T14:57:22.508000-06:00", "message": "(service my-http-service) has reached a steady state." }, { "id": "b05a48e8-da35-4074-80aa-37ceb3167357", "createdAt": "2025-02-21T14:57:22.507000-06:00", "message": "(service my-http-service) (deployment ecs-svc/5191625155316533644) deployment completed." }, { "id": "a10cd55d-4ba6-4cea-a655-5a5d32ada8a0", "createdAt": "2025-02-21T14:55:32.833000-06:00", "message": "(service my-http-service) has started 1 tasks: (task fb9c8df512684aec92f3c57dc3f22361)." }, { "id": "42da91fa-e26d-42ef-88c3-bb5965c56b2f", "createdAt": "2025-02-21T14:55:02.703000-06:00", "message": "(service my-http-service) has started 1 tasks: (task 33eff090ad2c40539daa837e6503a9bc)." } ], "createdAt": "2025-02-21T14:54:48.862000-06:00", "placementConstraints": [], "placementStrategy": [], "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "ENABLED" } }, "healthCheckGracePeriodSeconds": 0, "schedulingStrategy": "REPLICA", "deploymentController": { "type": "ECS" }, "createdBy": "arn:aws:iam::123456789012:role/AIDACKCEVSQ6C2EXAMPLE", "enableECSManagedTags": true, "propagateTags": "NONE", "enableExecuteCommand": false, "availabilityZoneRebalancing": "ENABLED" } } ``` Weitere Informationen finden Sie unter [Verwenden von Amazon-EBS-Volumes mit Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html) im *Entwicklerhandbuch für Amazon ECS*. **Beispiel 5: So aktivieren Sie die Neuverteilung von Availability Zones für einen Service** Im folgenden Beispiel für `update-service` wird die Neuverteilung von Availability Zones für den Service `my-http-service` aktiviert. ``` aws ecs update-service \ --cluster MyCluster \ --service my-http-service \ --availability-zone-rebalancing ENABLED ``` Ausgabe: ``` { "service": { "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/MyCluster/my-http-service", "serviceName": "my-http-service", "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster", "loadBalancers": [], "serviceRegistries": [], "status": "ACTIVE", "desiredCount": 2, "runningCount": 1, "pendingCount": 0, "capacityProviderStrategy": [ { "capacityProvider": "FARGATE", "weight": 1, "base": 0 } ], "platformVersion": "LATEST", "platformFamily": "Linux", "taskDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/MyTaskDefinition", "deploymentConfiguration": { "deploymentCircuitBreaker": { "enable": true, "rollback": true }, "maximumPercent": 200, "minimumHealthyPercent": 100, "alarms": { "alarmNames": [], "rollback": false, "enable": false } }, "deployments": [ { "id": "ecs-svc/1976744184940610707", "status": "PRIMARY", "taskkDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/MyTaskDefinition", "desiredCount": 1, "pendingCount": 0, "runningCount": 1, "failedTasks": 0, "createdAt": "2024-12-03T16:24:25.225000-05:00", "updatedAt": "2024-12-03T16:25:15.837000-05:00", "capacityProviderStrategy": [ { "capacityProvider": "FARGATE", "weight": 1, "base": 0 } ], "platformVersion": "1.4.0", "platformFamily": "Linux", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-0d0eab1bb38d5ca64", "subnet-0db5010045995c2d5" ], "securityGroups": [ "sg-02556bf85a191f59a" ], "assignPublicIp": "ENABLED" } }, "rolloutState": "COMPLETED", "rolloutStateReason": "ECS deployment ecs-svc/1976744184940610707 completed." } ], "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", "events": [], "createdAt": "2024-12-03T16:24:25.225000-05:00", "placementConstraints": [], "placementStrategy": [], "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-0d0eab1bb38d5ca64", "subnet-0db5010045995c2d5" ], "securityGroups": [ "sg-02556bf85a191f59a" ], "assignPublicIp": "ENABLED" } }, "healthCheckGracePeriodSeconds": 0, "schedulingStrategy": "REPLICA", "deploymentController": { "type": "ECS" }, "createdBy": "arn:aws:iam::123456789012:role/Admin", "enableECSManagedTags": true, "propagateTags": "NONE", "enableExecuteCommand": false, "availabilityZoneRebalancing": "ENABLED" } } ``` Weitere Informationen finden Sie unter [Aktualisieren eines Amazon-ECS-Service mithilfe der Konsole](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/update-service.html)in der *AWS CLI Befehlsreferenz*. ### `update-task-protection` Das folgende Codebeispiel zeigt die Verwendung`update-task-protection`. **AWS CLI** **Beispiel 1: So aktivieren Sie den Aufgabenschutz für ECS-Aufgaben** Im Folgenden wird Ihre ECS-Aufgabe `update-task-protection` davor geschützt, dass Ihre ECS-Aufgabe während der Skalierung über Bereitstellungen oder Dienste beendet wird. AutoScaling Sie können einen benutzerdefinierten Ablaufzeitraum für den Aufgabenschutz zwischen 1 und 2 880 Minuten (48 Stunden) angeben. Wenn Sie keinen Ablaufzeitraum angeben, beträgt die Standardzeit für die Aktivierung des Aufgabenschutzes 2 Stunden. ``` aws ecs update-task-protection \ --cluster ECS-project-update-cluster \ --tasks c43ed3b1331041f289316f958adb6a24 \ --protection-enabled \ --expires-in-minutes 300 ``` Ausgabe: ``` { "protectedTasks": [ { "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/c43ed3b1331041f289316f958adb6a24", "protectionEnabled": true, "expirationDate": "2024-09-14T19:53:36.687000-05:00" } ], "failures": [] } ``` **Beispiel 2: So deaktivieren Sie den Aufgabenschutz für ECS-Aufgaben** Im Folgenden werden die Aufgaben `update-task-protection` deaktiviert, die vor der Skalierung aus Deployments oder Service geschützt sind. AutoScaling ``` aws ecs update-task-protection \ --cluster ECS-project-update-cluster \ --tasks c43ed3b1331041f289316f958adb6a24 \ --no-protection-enabled ``` Ausgabe: ``` { "protectedTasks": [ { "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/c43ed3b1331041f289316f958adb6a24", "protectionEnabled": false } ], "failures": [] } ``` Weitere Informationen zum Schutz von Aufgaben finden Sie unter [Schützen Ihrer Amazon-ECS-Aufgaben vor dem Beenden durch Abskalierungsereignisse](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-scale-in-protection.html) im *Entwicklerhandbuch für Amazon ECS*. + Einzelheiten zur API finden Sie [UpdateTaskProtection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/update-task-protection.html)in der *AWS CLI Befehlsreferenz*. ### `update-task-set` Das folgende Codebeispiel zeigt die Verwendung`update-task-set`. **AWS CLI** **So aktualisieren Sie einen Aufgabensatz** Im folgenden Beispiel für `update-task-set` wird ein Aufgabensatz aktualisiert, um die Skalierung anzupassen. ``` aws ecs update-task-set \ --cluster MyCluster \ --service MyService \ --task-set arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789 \ --scale value=50,unit=PERCENT ``` Ausgabe: ``` { "taskSet": { "id": "ecs-svc/1234567890123456789", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", "computedDesiredCount": 0, "pendingCount": 0, "runningCount": 0, "createdAt": 1557128360.711, "updatedAt": 1557129279.914, "launchType": "EC2", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-12344321" ], "securityGroups": [ "sg-12344321" ], "assignPublicIp": "DISABLED" } }, "loadBalancers": [], "serviceRegistries": [], "scale": { "value": 50.0, "unit": "PERCENT" }, "stabilityStatus": "STABILIZING", "stabilityStatusAt": 1557129279.914 } } ``` + Einzelheiten zur API finden Sie [UpdateTaskSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ecs/update-task-set.html)in der *AWS CLI Befehlsreferenz*. # Amazon EFS-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon EFS Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-file-system` Das folgende Codebeispiel zeigt, wie Sie`create-file-system`. **AWS CLI** **So erstellen Sie ein verschlüsseltes Dateisystem** Im folgenden Beispiel für `create-file-system` wird ein verschlüsseltes Dateisystem erstellt, das den Standard-CMK verwendet. Außerdem wird das Tag `Name=my-file-system` hinzugefügt. ``` aws efs create-file-system \ --performance-mode generalPurpose \ --throughput-mode bursting \ --encrypted \ --tags Key=Name,Value=my-file-system ``` Ausgabe: ``` { "OwnerId": "123456789012", "CreationToken": "console-d7f56c5f-e433-41ca-8307-9d9c0example", "FileSystemId": "fs-c7a0456e", "FileSystemArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-48499b4d", "CreationTime": 1595286880.0, "LifeCycleState": "creating", "Name": "my-file-system", "NumberOfMountTargets": 0, "SizeInBytes": { "Value": 0, "ValueInIA": 0, "ValueInStandard": 0 }, "PerformanceMode": "generalPurpose", "Encrypted": true, "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/a59b3472-e62c-42e4-adcf-30d92example", "ThroughputMode": "bursting", "Tags": [ { "Key": "Name", "Value": "my-file-system" } ] } ``` Weitere Informationen finden Sie unter [Erstellen von Amazon-EFS-Dateisystemen](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [CreateFileSystem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/create-file-system.html)in der *AWS CLI Befehlsreferenz*. ### `create-mount-target` Das folgende Codebeispiel zeigt die Verwendung`create-mount-target`. **AWS CLI** **So erstellen Sie ein Mount-Ziel** Im folgenden Beispiel für `create-mount-target` wird ein Mount-Ziel für das angegebene Dateisystem erstellt. ``` aws efs create-mount-target \ --file-system-id fs-c7a0456e \ --subnet-id subnet-02bf4c428bexample \ --security-groups sg-068f739363example ``` Ausgabe: ``` { "OwnerId": "123456789012", "MountTargetId": "fsmt-f9a14450", "FileSystemId": "fs-c7a0456e", "SubnetId": "subnet-02bf4c428bexample", "LifeCycleState": "creating", "IpAddress": "10.0.1.24", "NetworkInterfaceId": "eni-02d542216aexample", "AvailabilityZoneId": "use2-az2", "AvailabilityZoneName": "us-east-2b", "VpcId": "vpc-0123456789abcdef0" } ``` Weitere Informationen finden Sie unter [Erstellen von Mount-Zielen](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [CreateMountTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/create-mount-target.html)in der *AWS CLI Befehlsreferenz*. ### `delete-file-system` Das folgende Codebeispiel zeigt die Verwendung`delete-file-system`. **AWS CLI** **Um ein Dateisystem zu löschen** Im folgenden Beispiel für `delete-file-system` wird das angegebene Dateisystem gelöscht. ``` aws efs delete-file-system \ --file-system-id fs-c7a0456e ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Amazon-EFS-Dateisystems](https://docs.aws.amazon.com/efs/latest/ug/delete-efs-fs.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [DeleteFileSystem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/delete-file-system.html)in der *AWS CLI Befehlsreferenz*. ### `delete-mount-target` Das folgende Codebeispiel zeigt die Verwendung`delete-mount-target`. **AWS CLI** **So löschen Sie ein Mount-Ziel** Im folgenden Beispiel für `delete-mount-target` wird das angegebene Mount-Ziel gelöscht. ``` aws efs delete-mount-target \ --mount-target-id fsmt-f9a14450 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen von Mount-Zielen](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [DeleteMountTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/delete-mount-target.html)in der *AWS CLI Befehlsreferenz*. ### `describe-file-systems` Das folgende Codebeispiel zeigt die Verwendung`describe-file-systems`. **AWS CLI** **So beschreiben Sie ein Dateisystem** Im folgenden Beispiel für `describe-file-systems` wird das angegebene Dateisystem beschrieben. ``` aws efs describe-file-systems \ --file-system-id fs-c7a0456e ``` Ausgabe: ``` { "FileSystems": [ { "OwnerId": "123456789012", "CreationToken": "console-d7f56c5f-e433-41ca-8307-9d9c0example", "FileSystemId": "fs-c7a0456e", "FileSystemArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-48499b4d", "CreationTime": 1595286880.0, "LifeCycleState": "available", "Name": "my-file-system", "NumberOfMountTargets": 3, "SizeInBytes": { "Value": 6144, "Timestamp": 1600991437.0, "ValueInIA": 0, "ValueInStandard": 6144 }, "PerformanceMode": "generalPurpose", "Encrypted": true, "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/a59b3472-e62c-42e4-adcf-30d92example", "ThroughputMode": "bursting", "Tags": [ { "Key": "Name", "Value": "my-file-system" } ] } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Amazon-EFS-Dateisystemen](https://docs.aws.amazon.com/efs/latest/ug/managing.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [DescribeFileSystems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/describe-file-systems.html)in der *AWS CLI Befehlsreferenz*. ### `describe-mount-targets` Das folgende Codebeispiel zeigt die Verwendung`describe-mount-targets`. **AWS CLI** **So beschreiben Sie ein Mount-Ziel** Im folgenden Beispiel für `describe-mount-targets` wird das angegebene Mount-Ziel beschrieben. ``` aws efs describe-mount-targets \ --mount-target-id fsmt-f9a14450 ``` Ausgabe: ``` { "MountTargets": [ { "OwnerId": "123456789012", "MountTargetId": "fsmt-f9a14450", "FileSystemId": "fs-c7a0456e", "SubnetId": "subnet-02bf4c428bexample", "LifeCycleState": "creating", "IpAddress": "10.0.1.24", "NetworkInterfaceId": "eni-02d542216aexample", "AvailabilityZoneId": "use2-az2", "AvailabilityZoneName": "us-east-2b", "VpcId": "vpc-0123456789abcdef0" } ] } ``` Weitere Informationen finden Sie unter [Erstellen von Mount-Zielen](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [DescribeMountTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/describe-mount-targets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-tags` Das folgende Codebeispiel zeigt die Verwendung`describe-tags`. **AWS CLI** **So beschreiben Sie die Tags für ein Dateisystem** Im folgenden Beispiel für `describe-tags` werden die Tags das angegebene Dateisystem beschrieben. ``` aws efs describe-tags \ --file-system-id fs-c7a0456e ``` Ausgabe: ``` { "Tags": [ { "Key": "Name", "Value": "my-file-system" }, { "Key": "Department", "Value": "Business Intelligence" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Dateisystem-Tags](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-tags.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/describe-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So rufen Sie die Tags für eine Ressource ab** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags abgerufen, die dem angegebenen Dateisystem zugeordnet sind. ``` aws efs list-tags-for-resource \ --resource-id fs-c7a0456e ``` Ausgabe: ``` { "Tags": [ { "Key": "Name", "Value": "my-file-system" }, { "Key": "Department", "Value": "Business Intelligence" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Dateisystem-Tags](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-tags.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird dem Dateisystem das Tag `Department=Business Intelligence` hinzugefügt. ``` aws efs tag-resource \ --resource-id fs-c7a0456e \ --tags Key=Department,Value="Business Intelligence" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Dateisystem-Tags](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-tags.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einer Ressource** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem Tag-Schlüssel `Department` aus dem angegebenen Dateisystem entfernt. ``` aws efs untag-resource \ --resource-id fs-c7a0456e \ --tag-keys Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Dateisystem-Tags](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-tags.html) im *Benutzerhandbuch für Amazon Elastic File System*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # Amazon EKS-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon EKS Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-access-policy` Das folgende Codebeispiel zeigt, wie Sie`associate-access-policy`. **AWS CLI** **So ordnen Sie eine Zugriffsrichtlinie und ihren Geltungsbereich zum Zugriffseintrag des Clusters zu** Mit der folgenden `associate-access-policy` werden dem Zugriffseintrag des angegebenen Clusters eine Zugriffsrichtlinie und ihr Geltungsbereich zugeordnet. ``` aws eks associate-access-policy \ --cluster-name eks-customer \ --principal-arn arn:aws:iam::111122223333:role/Admin \ --policy-arn arn:aws:eks::aws:cluster-access-policy/AmazonEKSEditPolicy \ --access-scope type=namespace,namespaces=default ``` Ausgabe: ``` { "clusterName": "eks-customer", "principalArn": "arn:aws:iam::111122223333:role/Admin", "associatedAccessPolicy": { "policyArn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSEditPolicy", "accessScope": { "type": "namespace", "namespaces": [ "default" ] }, "associatedAt": "2025-05-24T15:59:51.981000-05:00", "modifiedAt": "2025-05-24T15:59:51.981000-05:00" } } ``` Weitere Informationen finden Sie unter [Zuordnen von Zugriffsrichtlinien zu Zugriffseinträgen](https://docs.aws.amazon.com/eks/latest/userguide/access-policies.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [AssociateAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/associate-access-policy.html)in der *AWS CLI Befehlsreferenz*. ### `associate-encryption-config` Das folgende Codebeispiel zeigt die Verwendung`associate-encryption-config`. **AWS CLI** **So ordnen Sie eine Verschlüsselungskonfiguration zu einem vorhandenen Cluster zu** Im folgenden Beispiel für `associate-encryption-config` wird die Verschlüsselung für vorhandene EKS-Cluster aktiviert, für die sie noch nicht aktiviert war. ``` aws eks associate-encryption-config \ --cluster-name my-eks-cluster \ --encryption-config '[{"resources":["secrets"],"provider":{"keyArn":"arn:aws:kms:region-code:account:key/key"}}]' ``` Ausgabe: ``` { "update": { "id": "3141b835-8103-423a-8e68-12c2521ffa4d", "status": "InProgress", "type": "AssociateEncryptionConfig", "params": [ { "type": "EncryptionConfig", "value": "[{\"resources\":[\"secrets\"],\"provider\":{\"keyArn\":\"arn:aws:kms:region-code:account:key/key\"}}]" } ], "createdAt": "2024-03-14T11:01:26.297000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktivieren der Verschlüsselung von Secrets in einem vorhandenen Cluster](https://docs.aws.amazon.com/eks/latest/userguide/enable-kms.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [AssociateEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/associate-encryption-config.html)in der *AWS CLI Befehlsreferenz*. ### `associate-identity-provider-config` Das folgende Codebeispiel zeigt die Verwendung`associate-identity-provider-config`. **AWS CLI** **Zuordnen eines Identitätsanbieters zu Ihrem Amazon-EKS-Cluster** Im folgenden Beispiel für `associate-identity-provider-config` wird Ihrem Amazon-EKS-Cluster ein Identitätsanbieter zugeordnet. ``` aws eks associate-identity-provider-config \ --cluster-name my-eks-cluster \ --oidc 'identityProviderConfigName=my-identity-provider,issuerUrl=https://oidc.eks.us-east-2.amazonaws.com/id/38D6A4619A0A69E342B113ED7F1A7652,clientId=kubernetes,usernameClaim=email,usernamePrefix=my-username-prefix,groupsClaim=my-claim,groupsPrefix=my-groups-prefix,requiredClaims={Claim1=value1,Claim2=value2}' \ --tags env=dev ``` Ausgabe: ``` { "update": { "id": "8c6c1bef-61fe-42ac-a242-89412387b8e7", "status": "InProgress", "type": "AssociateIdentityProviderConfig", "params": [ { "type": "IdentityProviderConfig", "value": "[{\"type\":\"oidc\",\"name\":\"my-identity-provider\"}]" } ], "createdAt": "2024-04-11T13:46:49.648000-04:00", "errors": [] }, "tags": { "env": "dev" } } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern für Ihren Cluster über einen OpenID-Connect-Identitätsanbieter – Zuordnen eines OIDC-Identitätsanbieters](https://docs.aws.amazon.com/eks/latest/userguide/authenticate-oidc-identity-provider.html#associate-oidc-identity-provider) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [AssociateIdentityProviderConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/associate-identity-provider-config.html)in der *AWS CLI Befehlsreferenz*. ### `create-access-entry` Das folgende Codebeispiel zeigt die Verwendung`create-access-entry`. **AWS CLI** **Beispiel 1: So erstellen Sie den Zugriffseintrag für EKS-Cluster** Mit dem folgenden Beispiel für `create-access-entry` wird ein Zugriffseintrag erstellt, der einem IAM-Prinzipal den Zugriff auf den EKS-Cluster ermöglicht. ``` aws eks create-access-entry \ --cluster-name eks-customer \ --principal-arn arn:aws:iam::111122223333:user/eks-user ``` Ausgabe: ``` { "accessEntry": { "clusterName": "eks-customer", "principalArn": "arn:aws:iam::111122223333:user/eks-user", "kubernetesGroups": [], "accessEntryArn": "arn:aws:eks:us-west-2:111122223333:access-entry/eks-customer/user/111122223333/eks-user/a1b2c3d4-5678-90ab-cdef-a6506e3d36p0", "createdAt": "2025-04-14T22:45:48.097000-05:00", "modifiedAt": "2025-04-14T22:45:48.097000-05:00", "tags": {}, "username": "arn:aws:iam::111122223333:user/eks-user", "type": "STANDARD" } } ``` Weitere Informationen finden Sie unter [Erstellen von Zugriffseinträgen](https://docs.aws.amazon.com/eks/latest/userguide/creating-access-entries.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: So erstellen Sie den Zugriffseintrag für den EKS-Cluster unter Angabe von dessen Typ** Im folgenden Beispiel für `create-access-entry` wird ein Zugriffseintrag vom Typ `EC2_LINUX` im EKS-Cluster erstellt. Standardmäßig wird ein Zugriffseintrag vom Typ `STANDARD` erstellt. Wenn andere Zugriffseintragstypen angegeben werden, muss abgesehen von der Standardeinstellung ein IAM-Rollen-ARN in der CLI übergeben werden. ``` aws eks create-access-entry \ --cluster-name eks-customer \ --principal-arn arn:aws:iam::111122223333:role/admin-test-ip \ --type EC2_LINUX ``` Ausgabe: ``` { "accessEntry": { "clusterName": "eks-customer", "principalArn": "arn:aws:iam::111122223333:role/admin-test-ip", "kubernetesGroups": [ "system:nodes" ], "accessEntryArn": "arn:aws:eks:us-west-2:111122223333:access-entry/eks-customer/role/111122223333/admin-test-ip/accb5418-f493-f390-3e6e-c3f19f725fcp", "createdAt": "2025-05-06T19:42:45.453000-05:00", "modifiedAt": "2025-05-06T19:42:45.453000-05:00", "tags": {}, "username": "system:node:{{EC2PrivateDNSName}}", "type": "EC2_LINUX" } } ``` Weitere Informationen finden Sie unter [Erstellen von Zugriffseinträgen](https://docs.aws.amazon.com/eks/latest/userguide/creating-access-entries.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [CreateAccessEntry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/create-access-entry.html)in der *AWS CLI Befehlsreferenz*. ### `create-addon` Das folgende Codebeispiel zeigt die Verwendung`create-addon`. **AWS CLI** **Beispiel 1: Um ein Amazon EKS-Add-on mit einer kompatiblen Standardversion für die jeweilige EKS-Cluster-Version zu erstellen** Der folgende `create-addon` Beispielbefehl erstellt ein Amazon EKS-Add-on mit einer kompatiblen Standardversion für die jeweilige EKS-Cluster-Version. ``` aws eks create-addon \ --cluster-name my-eks-cluster \ --addon-name my-eks-addon \ --service-account-role-arn arn:aws:iam::111122223333:role/role-name ``` Ausgabe: ``` { "addon": { "addonName": "my-eks-addon", "clusterName": "my-eks-cluster", "status": "CREATING", "addonVersion": "v1.15.1-eksbuild.1", "health": { "issues": [] }, "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/1ec71ee1-b9c2-8915-4e17-e8be0a55a149", "createdAt": "2024-03-14T12:20:03.264000-04:00", "modifiedAt": "2024-03-14T12:20:03.283000-04:00", "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name", "tags": {} } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: So erstellen Sie ein Amazon-EKS-Add-On mit einer bestimmten Add-On-Version** Mit dem folgenden `create-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On mit einer bestimmten Add-On-Version erstellt. ``` aws eks create-addon \ --cluster-name my-eks-cluster \ --addon-name my-eks-addon \ --service-account-role-arn arn:aws:iam::111122223333:role/role-name \ --addon-version v1.16.4-eksbuild.2 ``` Ausgabe: ``` { "addon": { "addonName": "my-eks-addon", "clusterName": "my-eks-cluster", "status": "CREATING", "addonVersion": "v1.16.4-eksbuild.2", "health": { "issues": [] }, "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/34c71ee6-7738-6c8b-c6bd-3921a176b5ff", "createdAt": "2024-03-14T12:30:24.507000-04:00", "modifiedAt": "2024-03-14T12:30:24.521000-04:00", "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name", "tags": {} } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 3: So erstellen Sie ein Amazon-EKS-Add-On mit benutzerdefinierten Konfigurationswerten und lösen Konfliktdetails** Mit dem folgenden `create-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On mit benutzerdefinierten Konfigurationswerten erstellt und Konfliktdetails werden gelöst. ``` aws eks create-addon \ --cluster-name my-eks-cluster \ --addon-name my-eks-addon \ --service-account-role-arn arn:aws:iam::111122223333:role/role-name \ --addon-version v1.16.4-eksbuild.2 \ --configuration-values '{"resources":{"limits":{"cpu":"100m"}}}' \ --resolve-conflicts OVERWRITE ``` Ausgabe: ``` { "addon": { "addonName": "my-eks-addon", "clusterName": "my-eks-cluster", "status": "CREATING", "addonVersion": "v1.16.4-eksbuild.2", "health": { "issues": [] }, "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/a6c71ee9-0304-9237-1be8-25af1b0f1ffb", "createdAt": "2024-03-14T12:35:58.313000-04:00", "modifiedAt": "2024-03-14T12:35:58.327000-04:00", "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name", "tags": {}, "configurationValues": "{\"resources\":{\"limits\":{\"cpu\":\"100m\"}}}" } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 4: So erstellen Sie ein Amazon-EKS-Add-On mit einer Datei mit benutzerdefinierten JSON-Konfigurationswerten** Mit dem folgenden `create-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On mit benutzerdefinierten Konfigurationswerten erstellt und Konfliktdetails werden gelöst. ``` aws eks create-addon \ --cluster-name my-eks-cluster \ --addon-name my-eks-addon \ --service-account-role-arn arn:aws:iam::111122223333:role/role-name \ --addon-version v1.16.4-eksbuild.2 \ --configuration-values 'file://configuration-values.json' \ --resolve-conflicts OVERWRITE \ --tags '{"eks-addon-key-1": "value-1" , "eks-addon-key-2": "value-2"}' ``` Inhalt von `configuration-values.json`: ``` { "resources": { "limits": { "cpu": "150m" } }, "env": { "AWS_VPC_K8S_CNI_LOGLEVEL": "ERROR" } } ``` Ausgabe: ``` { "addon": { "addonName": "my-eks-addon", "clusterName": "my-eks-cluster", "status": "CREATING", "addonVersion": "v1.16.4-eksbuild.2", "health": { "issues": [] }, "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/d8c71ef8-fbd8-07d0-fb32-6a7be19ececd", "createdAt": "2024-03-14T13:10:51.763000-04:00", "modifiedAt": "2024-03-14T13:10:51.777000-04:00", "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name", "tags": { "eks-addon-key-1": "value-1", "eks-addon-key-2": "value-2" }, "configurationValues": "{\n \"resources\": {\n \"limits\": {\n \"cpu\": \"150m\"\n }\n },\n \"env\": {\n \"AWS_VPC_K8S_CNI_LOGLEVEL\": \"ERROR\"\n }\n}" } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 5: So erstellen Sie ein Amazon-EKS-Add-On mit einer Datei mit benutzerdefinierten YAML-Konfigurationswerten** Mit dem folgenden `create-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On mit benutzerdefinierten Konfigurationswerten erstellt und Konfliktdetails werden gelöst. ``` aws eks create-addon \ --cluster-name my-eks-cluster \ --addon-name my-eks-addon \ --service-account-role-arn arn:aws:iam::111122223333:role/role-name \ --addon-version v1.16.4-eksbuild.2 \ --configuration-values 'file://configuration-values.yaml' \ --resolve-conflicts OVERWRITE \ --tags '{"eks-addon-key-1": "value-1" , "eks-addon-key-2": "value-2"}' ``` Inhalt von `configuration-values.yaml`: ``` resources: limits: cpu: '100m' env: AWS_VPC_K8S_CNI_LOGLEVEL: 'DEBUG' ``` Ausgabe: ``` { "addon": { "addonName": "my-eks-addon", "clusterName": "my-eks-cluster", "status": "CREATING", "addonVersion": "v1.16.4-eksbuild.2", "health": { "issues": [] }, "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/d4c71efb-3909-6f36-a548-402cd4b5d59e", "createdAt": "2024-03-14T13:15:45.220000-04:00", "modifiedAt": "2024-03-14T13:15:45.237000-04:00", "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name", "tags": { "eks-addon-key-3": "value-3", "eks-addon-key-4": "value-4" }, "configurationValues": "resources:\n limits:\n cpu: '100m'\nenv:\n AWS_VPC_K8S_CNI_LOGLEVEL: 'INFO'" } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [CreateAddon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/create-addon.html)in der *AWS CLI Befehlsreferenz*. ### `create-cluster` Das folgende Codebeispiel zeigt die Verwendung`create-cluster`. **AWS CLI** **So erstellen Sie einen neuen Cluster** Dieser Beispielbefehl erstellt ein Cluster namens `prod` Ihrer Standardregion. Befehl: ``` aws eks create-cluster --name prod \ --role-arn arn:aws:iam::012345678910:role/eks-service-role-AWSServiceRoleForAmazonEKS-J7ONKE3BQ4PI \ --resources-vpc-config subnetIds=subnet-6782e71e,subnet-e7e761ac,securityGroupIds=sg-6979fe18 ``` Ausgabe: ``` { "cluster": { "name": "prod", "arn": "arn:aws:eks:us-west-2:012345678910:cluster/prod", "createdAt": 1527808069.147, "version": "1.10", "roleArn": "arn:aws:iam::012345678910:role/eks-service-role-AWSServiceRoleForAmazonEKS-J7ONKE3BQ4PI", "resourcesVpcConfig": { "subnetIds": [ "subnet-6782e71e", "subnet-e7e761ac" ], "securityGroupIds": [ "sg-6979fe18" ], "vpcId": "vpc-950809ec" }, "status": "CREATING", "certificateAuthority": {} } } ``` **So erstellen Sie einen neuen Cluster mit aktiviertem privaten Endpunktzugriff und aktivierter Protokollierung** Dieser Beispielbefehl erstellt ein Cluster namens `example` in Ihrer Standardregion, bei dem der öffentliche Endpunktzugriff deaktiviert ist, der private Endpunktzugriff aktiviert ist und alle Protokollierungstypen aktiviert sind. Befehl: ``` aws eks create-cluster --name example --kubernetes-version 1.12 \ --role-arn arn:aws:iam::012345678910:role/example-cluster-ServiceRole-1XWBQWYSFRE2Q \ --resources-vpc-config subnetIds=subnet-0a188dccd2f9a632f,subnet-09290d93da4278664,subnet-0f21dd86e0e91134a,subnet-0173dead68481a583,subnet-051f70a57ed6fcab6,subnet-01322339c5c7de9b4,securityGroupIds=sg-0c5b580845a031c10,endpointPublicAccess=false,endpointPrivateAccess=true \ --logging '{"clusterLogging":[{"types":["api","audit","authenticator","controllerManager","scheduler"],"enabled":true}]}' ``` Ausgabe: ``` { "cluster": { "name": "example", "arn": "arn:aws:eks:us-west-2:012345678910:cluster/example", "createdAt": 1565804921.901, "version": "1.12", "roleArn": "arn:aws:iam::012345678910:role/example-cluster-ServiceRole-1XWBQWYSFRE2Q", "resourcesVpcConfig": { "subnetIds": [ "subnet-0a188dccd2f9a632f", "subnet-09290d93da4278664", "subnet-0f21dd86e0e91134a", "subnet-0173dead68481a583", "subnet-051f70a57ed6fcab6", "subnet-01322339c5c7de9b4" ], "securityGroupIds": [ "sg-0c5b580845a031c10" ], "vpcId": "vpc-0f622c01f68d4afec", "endpointPublicAccess": false, "endpointPrivateAccess": true }, "logging": { "clusterLogging": [ { "types": [ "api", "audit", "authenticator", "controllerManager", "scheduler" ], "enabled": true } ] }, "status": "CREATING", "certificateAuthority": {}, "platformVersion": "eks.3" } } ``` + Einzelheiten zur API finden Sie [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/create-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `create-fargate-profile` Das folgende Codebeispiel zeigt die Verwendung`create-fargate-profile`. **AWS CLI** **Beispiel 1: Erstellen eines EKS-Fargate-Profils für einen Selektor mit einem Namespace** Im folgenden Beispiel für `create-fargate-profile` wird ein EKS-Fargate-Profil für einen Selektor mit einem Namespace erstellt. ``` aws eks create-fargate-profile \ --cluster-name my-eks-cluster \ --pod-execution-role-arn arn:aws:iam::111122223333:role/role-name \ --fargate-profile-name my-fargate-profile \ --selectors '[{"namespace": "default"}]' ``` Ausgabe: ``` { "fargateProfile": { "fargateProfileName": "my-fargate-profile", "fargateProfileArn": "arn:aws:eks:us-east-2:111122223333:fargateprofile/my-eks-cluster/my-fargate-profile/a2c72bca-318e-abe8-8ed1-27c6d4892e9e", "clusterName": "my-eks-cluster", "createdAt": "2024-03-19T12:38:47.368000-04:00", "podExecutionRoleArn": "arn:aws:iam::111122223333:role/role-name", "subnets": [ "subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72" ], "selectors": [ { "namespace": "default" } ], "status": "CREATING", "tags": {} } } ``` Weitere Informationen finden Sie unter [AWS -Fargate-Profil – Erstellen eines Fargate-Profils](https://docs.aws.amazon.com/eks/latest/userguide/fargate-profile.html#create-fargate-profile) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: Erstellen eines EKS-Fargate-Profils für einen Selektor mit einem Namespace und Labels** Im folgenden Beispiel für `create-fargate-profile` wird ein EKS-Fargate-Profil für einen Selektor mit einem Namespace und Labels erstellt. ``` aws eks create-fargate-profile \ --cluster-name my-eks-cluster \ --pod-execution-role-arn arn:aws:iam::111122223333:role/role-name \ --fargate-profile-name my-fargate-profile \ --selectors '[{"namespace": "default", "labels": {"labelname1": "labelvalue1"}}]' ``` Ausgabe: ``` { "fargateProfile": { "fargateProfileName": "my-fargate-profile", "fargateProfileArn": "arn:aws:eks:us-east-2:111122223333:fargateprofile/my-eks-cluster/my-fargate-profile/88c72bc7-e8a4-fa34-44e4-2f1397224bb3", "clusterName": "my-eks-cluster", "createdAt": "2024-03-19T12:33:48.125000-04:00", "podExecutionRoleArn": "arn:aws:iam::111122223333:role/role-name", "subnets": [ "subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72" ], "selectors": [ { "namespace": "default", "labels": { "labelname1": "labelvalue1" } } ], "status": "CREATING", "tags": {} } } ``` Weitere Informationen finden Sie unter [AWS -Fargate-Profil – Erstellen eines Fargate-Profils](https://docs.aws.amazon.com/eks/latest/userguide/fargate-profile.html#create-fargate-profile) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 3: Erstellen Sie ein EKS Fargate-Profil für einen Selektor mit einem Namespace und Labels sowie Subnetzen, in denen ein IDs Pod gestartet werden soll.** Im folgenden `create-fargate-profile` Beispiel wird ein EKS Fargate-Profil für einen Selektor mit einem Namespace und Labels sowie Subnetzen erstellt, in denen ein IDs Pod gestartet werden soll. ``` aws eks create-fargate-profile \ --cluster-name my-eks-cluster \ --pod-execution-role-arn arn:aws:iam::111122223333:role/role-name \ --fargate-profile-name my-fargate-profile \ --selectors '[{"namespace": "default", "labels": {"labelname1": "labelvalue1"}}]' \ --subnets '["subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72"]' ``` Ausgabe: ``` { "fargateProfile": { "fargateProfileName": "my-fargate-profile", "fargateProfileArn": "arn:aws:eks:us-east-2:111122223333:fargateprofile/my-eks-cluster/my-fargate-profile/e8c72bc8-e87b-5eb6-57cb-ed4fe57577e3", "clusterName": "my-eks-cluster", "createdAt": "2024-03-19T12:35:58.640000-04:00", "podExecutionRoleArn": "arn:aws:iam::111122223333:role/role-name", "subnets": [ "subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72" ], "selectors": [ { "namespace": "default", "labels": { "labelname1": "labelvalue1" } } ], "status": "CREATING", "tags": {} } } ``` Weitere Informationen finden Sie unter [AWS -Fargate-Profil – Erstellen eines Fargate-Profils](https://docs.aws.amazon.com/eks/latest/userguide/fargate-profile.html#create-fargate-profile) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 4: Erstellen Sie ein EKS Fargate-Profil für einen Selektor mit mehreren Namespaces und Labels sowie Subnetzen, in denen ein IDs Pod gestartet werden soll** Das folgende `create-fargate-profile` Beispiel erstellt ein EKS-Fargate-Profil für einen Selektor mit mehreren Namespaces und Labels sowie Subnetzen, in denen ein IDs Pod gestartet werden soll. ``` aws eks create-fargate-profile \ --cluster-name my-eks-cluster \ --pod-execution-role-arn arn:aws:iam::111122223333:role/role-name \ --fargate-profile-name my-fargate-profile \ --selectors '[{"namespace": "default1", "labels": {"labelname1": "labelvalue1", "labelname2": "labelvalue2"}}, {"namespace": "default2", "labels": {"labelname1": "labelvalue1", "labelname2": "labelvalue2"}}]' \ --subnets '["subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72"]' \ --tags '{"eks-fargate-profile-key-1": "value-1" , "eks-fargate-profile-key-2": "value-2"}' ``` Ausgabe: ``` { "fargateProfile": { "fargateProfileName": "my-fargate-profile", "fargateProfileArn": "arn:aws:eks:us-east-2:111122223333:fargateprofile/my-eks-cluster/my-fargate-profile/4cc72bbf-b766-8ee6-8d29-e62748feb3cd", "clusterName": "my-eks-cluster", "createdAt": "2024-03-19T12:15:55.271000-04:00", "podExecutionRoleArn": "arn:aws:iam::111122223333:role/role-name", "subnets": [ "subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72" ], "selectors": [ { "namespace": "default1", "labels": { "labelname2": "labelvalue2", "labelname1": "labelvalue1" } }, { "namespace": "default2", "labels": { "labelname2": "labelvalue2", "labelname1": "labelvalue1" } } ], "status": "CREATING", "tags": { "eks-fargate-profile-key-2": "value-2", "eks-fargate-profile-key-1": "value-1" } } } ``` Weitere Informationen finden Sie unter [AWS -Fargate-Profil – Erstellen eines Fargate-Profils](https://docs.aws.amazon.com/eks/latest/userguide/fargate-profile.html#create-fargate-profile) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 5: Erstellen Sie ein EKS-Fargate-Profil mit einem Platzhalter-Selektor für Namespaces und Labels sowie Subnetze, in denen ein Pod gestartet werden IDs soll** Das folgende `create-fargate-profile` Beispiel erstellt ein EKS-Fargate-Profil für einen Selektor mit mehreren Namespaces und Labels sowie Subnetzen, in denen ein IDs Pod gestartet werden soll. ``` aws eks create-fargate-profile \ --cluster-name my-eks-cluster \ --pod-execution-role-arn arn:aws:iam::111122223333:role/role-name \ --fargate-profile-name my-fargate-profile \ --selectors '[{"namespace": "prod*", "labels": {"labelname*?": "*value1"}}, {"namespace": "*dev*", "labels": {"labelname*?": "*value*"}}]' \ --subnets '["subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72"]' \ --tags '{"eks-fargate-profile-key-1": "value-1" , "eks-fargate-profile-key-2": "value-2"}' ``` Ausgabe: ``` { "fargateProfile": { "fargateProfileName": "my-fargate-profile", "fargateProfileArn": "arn:aws:eks:us-east-2:111122223333:fargateprofile/my-eks-cluster/my-fargate-profile/e8c72bd6-5966-0bfe-b77b-1802893e5a6f", "clusterName": "my-eks-cluster", "createdAt": "2024-03-19T13:05:20.550000-04:00", "podExecutionRoleArn": "arn:aws:iam::111122223333:role/role-name", "subnets": [ "subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72" ], "selectors": [ { "namespace": "prod*", "labels": { "labelname*?": "*value1" } }, { "namespace": "*dev*", "labels": { "labelname*?": "*value*" } } ], "status": "CREATING", "tags": { "eks-fargate-profile-key-2": "value-2", "eks-fargate-profile-key-1": "value-1" } } } ``` Weitere Informationen finden Sie unter [AWS -Fargate-Profil – Erstellen eines Fargate-Profils](https://docs.aws.amazon.com/eks/latest/userguide/fargate-profile.html#create-fargate-profile) im *Benutzerhandbuch für Amazon EKS*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateFargateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/create-fargate-profile.html).AWS CLI * ### `create-nodegroup` Das folgende Codebeispiel zeigt die Verwendung`create-nodegroup`. **AWS CLI** **Beispiel 1: Erstellen einer verwalteten Knotengruppe für einen Amazon-EKS-Cluster** Im folgenden Beispiel für `create-nodegroup` wird eine verwaltete Knotengruppe für einen Amazon-EKS-Cluster erstellt. ``` aws eks create-nodegroup \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup \ --node-role arn:aws:iam::111122223333:role/role-name \ --subnets "subnet-0e2907431c9988b72" "subnet-04ad87f71c6e5ab4d" "subnet-09d912bb63ef21b9a" \ --scaling-config minSize=1,maxSize=3,desiredSize=1 \ --region us-east-2 ``` Ausgabe: ``` { "nodegroup": { "nodegroupName": "my-eks-nodegroup", "nodegroupArn": "arn:aws:eks:us-east-2:111122223333:nodegroup/my-eks-cluster/my-eks-nodegroup/bac7550f-b8b8-5fbb-4f3e-7502a931119e", "clusterName": "my-eks-cluster", "version": "1.26", "releaseVersion": "1.26.12-20240329", "createdAt": "2024-04-04T13:19:32.260000-04:00", "modifiedAt": "2024-04-04T13:19:32.260000-04:00", "status": "CREATING", "capacityType": "ON_DEMAND", "scalingConfig": { "minSize": 1, "maxSize": 3, "desiredSize": 1 }, "instanceTypes": [ "t3.medium" ], "subnets": [ "subnet-0e2907431c9988b72, subnet-04ad87f71c6e5ab4d, subnet-09d912bb63ef21b9a" ], "amiType": "AL2_x86_64", "nodeRole": "arn:aws:iam::111122223333:role/role-name", "diskSize": 20, "health": { "issues": [] }, "updateConfig": { "maxUnavailable": 1 }, "tags": {} } } ``` Weitere Informationen finden Sie unter [Erstellen einer verwalteten Knotengruppe](https://docs.aws.amazon.com/eks/latest/userguide/create-managed-node-group.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: Erstellen einer verwalteten Knotengruppe für einen Amazon-EKS-Cluster mit benutzerdefinierten Instance-Typen und benutzerdefinierter Datenträgergröße** Im folgenden Beispiel für `create-nodegroup` wird eine verwaltete Knotengruppe für einen Amazon-EKS-Cluster mit benutzerdefinierten Instance-Typen und benutzerdefinierter Datenträgergröße erstellt. ``` aws eks create-nodegroup \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup \ --node-role arn:aws:iam::111122223333:role/role-name \ --subnets "subnet-0e2907431c9988b72" "subnet-04ad87f71c6e5ab4d" "subnet-09d912bb63ef21b9a" \ --scaling-config minSize=1,maxSize=3,desiredSize=1 \ --capacity-type ON_DEMAND \ --instance-types 'm5.large' \ --disk-size 50 \ --region us-east-2 ``` Ausgabe: ``` { "nodegroup": { "nodegroupName": "my-eks-nodegroup", "nodegroupArn": "arn:aws:eks:us-east-2:111122223333:nodegroup/my-eks-cluster/my-eks-nodegroup/c0c7551b-e4f9-73d9-992c-a450fdb82322", "clusterName": "my-eks-cluster", "version": "1.26", "releaseVersion": "1.26.12-20240329", "createdAt": "2024-04-04T13:46:07.595000-04:00", "modifiedAt": "2024-04-04T13:46:07.595000-04:00", "status": "CREATING", "capacityType": "ON_DEMAND", "scalingConfig": { "minSize": 1, "maxSize": 3, "desiredSize": 1 }, "instanceTypes": [ "m5.large" ], "subnets": [ "subnet-0e2907431c9988b72", "subnet-04ad87f71c6e5ab4d", "subnet-09d912bb63ef21b9a" ], "amiType": "AL2_x86_64", "nodeRole": "arn:aws:iam::111122223333:role/role-name", "diskSize": 50, "health": { "issues": [] }, "updateConfig": { "maxUnavailable": 1 }, "tags": {} } } ``` Weitere Informationen finden Sie unter [Erstellen einer verwalteten Knotengruppe](https://docs.aws.amazon.com/eks/latest/userguide/create-managed-node-group.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 3: Erstellen einer verwalteten Knotengruppe für einen Amazon-EKS-Cluster mit Instance-Typen, Datenträgergröße, AMI-Typ, Kapazitätstyp, Update-Konfiguration, Labels, Taints und Tags gemäß Benutzerdefinition** Im folgenden Beispiel für `create-nodegroup` wird eine verwaltete Knotengruppe für einen Amazon-EKS-Cluster mit Instance-Typen, Datenträgergröße, AMI-Typ, Kapazitätstyp, Update-Konfiguration, Labels, Taints und Tags gemäß Benutzerdefinition erstellt. ``` aws eks create-nodegroup \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup \ --node-role arn:aws:iam::111122223333:role/role-name \ --subnets "subnet-0e2907431c9988b72" "subnet-04ad87f71c6e5ab4d" "subnet-09d912bb63ef21b9a" \ --scaling-config minSize=1,maxSize=5,desiredSize=4 \ --instance-types 't3.large' \ --disk-size 50 \ --ami-type AL2_x86_64 \ --capacity-type SPOT \ --update-config maxUnavailable=2 \ --labels '{"my-eks-nodegroup-label-1": "value-1" , "my-eks-nodegroup-label-2": "value-2"}' \ --taints '{"key": "taint-key-1" , "value": "taint-value-1", "effect": "NO_EXECUTE"}' \ --tags '{"my-eks-nodegroup-key-1": "value-1" , "my-eks-nodegroup-key-2": "value-2"}' ``` Ausgabe: ``` { "nodegroup": { "nodegroupName": "my-eks-nodegroup", "nodegroupArn": "arn:aws:eks:us-east-2:111122223333:nodegroup/my-eks-cluster/my-eks-nodegroup/88c75524-97af-0cb9-a9c5-7c0423ab5314", "clusterName": "my-eks-cluster", "version": "1.26", "releaseVersion": "1.26.12-20240329", "createdAt": "2024-04-04T14:05:07.940000-04:00", "modifiedAt": "2024-04-04T14:05:07.940000-04:00", "status": "CREATING", "capacityType": "SPOT", "scalingConfig": { "minSize": 1, "maxSize": 5, "desiredSize": 4 }, "instanceTypes": [ "t3.large" ], "subnets": [ "subnet-0e2907431c9988b72", "subnet-04ad87f71c6e5ab4d", "subnet-09d912bb63ef21b9a" ], "amiType": "AL2_x86_64", "nodeRole": "arn:aws:iam::111122223333:role/role-name", "labels": { "my-eks-nodegroup-label-2": "value-2", "my-eks-nodegroup-label-1": "value-1" }, "taints": [ { "key": "taint-key-1", "value": "taint-value-1", "effect": "NO_EXECUTE" } ], "diskSize": 50, "health": { "issues": [] }, "updateConfig": { "maxUnavailable": 2 }, "tags": { "my-eks-nodegroup-key-1": "value-1", "my-eks-nodegroup-key-2": "value-2" } } } ``` Weitere Informationen finden Sie unter [Erstellen einer verwalteten Knotengruppe](https://docs.aws.amazon.com/eks/latest/userguide/create-managed-node-group.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [CreateNodegroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/create-nodegroup.html)in der *AWS CLI Befehlsreferenz*. ### `create-pod-identity-association` Das folgende Codebeispiel zeigt die Verwendung`create-pod-identity-association`. **AWS CLI** **Beispiel 1: So erstellen Sie eine EKS-Pod-Identity-Zuordnung im EKS-Cluster** Im folgenden Beispiel für `create-pod-identity-association` wird eine EKS-Pod-Identity-Zuordnung zwischen einem Servicekonto im EKS-Cluster und einer IAM-Rolle erstellt. ``` aws eks create-pod-identity-association \ --cluster-name eks-customer \ --namespace default \ --service-account default \ --role-arn arn:aws:iam::111122223333:role/my-role ``` Ausgabe: ``` { "association": { "clusterName": "eks-customer", "namespace": "default", "serviceAccount": "default", "roleArn": "arn:aws:iam::111122223333:role/my-role", "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-8mvwvh57cu74mgcst", "associationId": "a-8mvwvh57cu74mgcst", "tags": {}, "createdAt": "2025-05-24T19:40:13.961000-05:00", "modifiedAt": "2025-05-24T19:40:13.961000-05:00" } } ``` Weitere Informationen finden [Sie im *Amazon EKS-Benutzerhandbuch* unter Erfahren Sie, wie EKS Pod Identity Pods Zugriff auf AWS Dienste gewährt](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html). **Beispiel 2: So erstellen Sie eine EKS-Pod-Identity-Zuordnung im EKS-Cluster mit Tags** Im folgenden Beispiel für `create-pod-identity-association` wird eine EKS-Pod-Identity-Zuordnung zwischen einem Servicekonto und einer IAM-Rolle im EKS-Cluster mit Tags erstellt. ``` aws eks create-pod-identity-association \ --cluster-name eks-customer \ --namespace default \ --service-account default \ --role-arn arn:aws:iam::111122223333:role/my-role \ --tags Key1=value1,Key2=value2 ``` Ausgabe: ``` { "association": { "clusterName": "eks-customer", "namespace": "default", "serviceAccount": "default", "roleArn": "arn:aws:iam::111122223333:role/my-role", "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-9njjin9gfghecgoda", "associationId": "a-9njjin9gfghecgoda", "tags": { "Key2": "value2", "Key1": "value1" }, "createdAt": "2025-05-24T19:52:14.135000-05:00", "modifiedAt": "2025-05-24T19:52:14.135000-05:00" } } ``` Weitere Informationen finden [Sie im *Amazon EKS-Benutzerhandbuch* unter Erfahren Sie, wie EKS Pod Identity Pods Zugriff auf AWS Dienste gewährt](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html). + Einzelheiten zur API finden Sie [CreatePodIdentityAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/create-pod-identity-association.html)in der *AWS CLI Befehlsreferenz*. ### `delete-access-entry` Das folgende Codebeispiel zeigt die Verwendung`delete-access-entry`. **AWS CLI** **So löschen Sie einen dem Cluster zugeordneten Zugriffseintrag** Mit dem folgenden `delete-access-entry` wird ein Zugriffseintrag gelöscht, der dem EKS-Cluster namens `eks-customer` zugeordnet ist. ``` aws eks delete-access-entry \ --cluster-name eks-customer \ --principal-arn arn:aws:iam::111122223333:role/Admin ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen von Zugriffseinträgen](https://docs.aws.amazon.com/eks/latest/userguide/deleting-access-entries.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DeleteAccessEntry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/delete-access-entry.html)in der *AWS CLI Befehlsreferenz*. ### `delete-addon` Das folgende Codebeispiel zeigt die Verwendung`delete-addon`. **AWS CLI** **Beispiel 1. So löschen Sie ein Amazon-EKS-Add-On, behalten aber die Add-On-Software im EKS-Cluster bei** Mit dem folgenden `delete-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On gelöscht, aber die Add-On-Software im EKS-Cluster beibehalten. ``` aws eks delete-addon \ --cluster-name my-eks-cluster \ --addon-name my-eks-addon \ --preserve ``` Ausgabe: ``` { "addon": { "addonName": "my-eks-addon", "clusterName": "my-eks-cluster", "status": "DELETING", "addonVersion": "v1.9.3-eksbuild.7", "health": { "issues": [] }, "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/a8c71ed3-944e-898b-9167-c763856af4b8", "createdAt": "2024-03-14T11:49:09.009000-04:00", "modifiedAt": "2024-03-14T12:03:49.776000-04:00", "tags": {} } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS – Löschen eines Add-Ons](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#removing-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2. So löschen Sie ein Amazon-EKS-Add-On und die Add-On-Software im EKS-Cluster** Mit dem folgenden `delete-addon`-Beispielbefehl werden ein Amazon-EKS-Add-On und die Add-On-Software im EKS-Cluster gelöscht. ``` aws eks delete-addon \ --cluster-name my-eks-cluster \ --addon-name my-eks-addon ``` Ausgabe: ``` { "addon": { "addonName": "my-eks-addon", "clusterName": "my-eks-cluster", "status": "DELETING", "addonVersion": "v1.15.1-eksbuild.1", "health": { "issues": [] }, "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/bac71ed1-ec43-3bb6-88ea-f243cdb58954", "createdAt": "2024-03-14T11:45:31.983000-04:00", "modifiedAt": "2024-03-14T11:58:40.136000-04:00", "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name", "tags": {} } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS – Löschen eines Add-Ons](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#removing-an-add-on) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DeleteAddon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/delete-addon.html)in der *AWS CLI Befehlsreferenz*. ### `delete-cluster` Das folgende Codebeispiel zeigt die Verwendung`delete-cluster`. **AWS CLI** **Löschen einer Steuerebene für Amazon-EKS-Cluster** Im folgenden Beispiel für `delete-cluster` wird eine Steuerebene eines Amazon-EKS-Clusters gelöscht. ``` aws eks delete-cluster \ --name my-eks-cluster ``` Ausgabe: ``` { "cluster": { "name": "my-eks-cluster", "arn": "arn:aws:eks:us-east-2:111122223333:cluster/my-eks-cluster", "createdAt": "2024-03-14T11:31:44.348000-04:00", "version": "1.27", "endpoint": "https://DALSJ343KE23J3RN45653DSKJTT647TYD.yl4.us-east-2.eks.amazonaws.com", "roleArn": "arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-cluster-ServiceRole-zMF6CBakwwbW", "resourcesVpcConfig": { "subnetIds": [ "subnet-0fb75d2d8401716e7", "subnet-02184492f67a3d0f9", "subnet-04098063527aab776", "subnet-0e2907431c9988b72", "subnet-04ad87f71c6e5ab4d", "subnet-09d912bb63ef21b9a" ], "securityGroupIds": [ "sg-0c1327f6270afbb36" ], "clusterSecurityGroupId": "sg-01c84d09d70f39a7f", "vpcId": "vpc-0012b8e1cc0abb17d", "endpointPublicAccess": true, "endpointPrivateAccess": true, "publicAccessCidrs": [ "0.0.0.0/0" ] }, "kubernetesNetworkConfig": { "serviceIpv4Cidr": "10.100.0.0/16", "ipFamily": "ipv4" }, "logging": { "clusterLogging": [ { "types": [ "api", "audit", "authenticator", "controllerManager", "scheduler" ], "enabled": true } ] }, "identity": { "oidc": { "issuer": "https://oidc.eks.us-east-2.amazonaws.com/id/DALSJ343KE23J3RN45653DSKJTT647TYD" } }, "status": "DELETING", "certificateAuthority": { "data": "XXX_CA_DATA_XXX" }, "platformVersion": "eks.16", "tags": { "aws:cloudformation:stack-name": "eksctl-my-eks-cluster-cluster", "alpha.eksctl.io/cluster-name": "my-eks-cluster", "karpenter.sh/discovery": "my-eks-cluster", "aws:cloudformation:stack-id": "arn:aws:cloudformation:us-east-2:111122223333:stack/eksctl-my-eks-cluster-cluster/e752ea00-e217-11ee-beae-0a9599c8c7ed", "auto-delete": "no", "eksctl.cluster.k8s.io/v1alpha1/cluster-name": "my-eks-cluster", "EKS-Cluster-Name": "my-eks-cluster", "alpha.eksctl.io/cluster-oidc-enabled": "true", "aws:cloudformation:logical-id": "ControlPlane", "alpha.eksctl.io/eksctl-version": "0.173.0-dev+a7ee89342.2024-03-01T03:40:57Z", "Name": "eksctl-my-eks-cluster-cluster/ControlPlane" }, "accessConfig": { "authenticationMode": "API_AND_CONFIG_MAP" } } } ``` Weitere Informationen finden Sie unter [Erweiterungen für Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/delete-cluster.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/delete-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `delete-fargate-profile` Das folgende Codebeispiel zeigt die Verwendung`delete-fargate-profile`. **AWS CLI** **Beispiel 1: Erstellen eines EKS-Fargate-Profils für einen Selektor mit einem Namespace** Im folgenden Beispiel für `delete-fargate-profile` wird ein EKS-Fargate-Profil für einen Selektor mit einem Namespace erstellt. ``` aws eks delete-fargate-profile \ --cluster-name my-eks-cluster \ --fargate-profile-name my-fargate-profile ``` Ausgabe: ``` { "fargateProfile": { "fargateProfileName": "my-fargate-profile", "fargateProfileArn": "arn:aws:eks:us-east-2:111122223333:fargateprofile/my-eks-cluster/my-fargate-profile/1ac72bb3-3fc6-2631-f1e1-98bff53bed62", "clusterName": "my-eks-cluster", "createdAt": "2024-03-19T11:48:39.975000-04:00", "podExecutionRoleArn": "arn:aws:iam::111122223333:role/role-name", "subnets": [ "subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72" ], "selectors": [ { "namespace": "default", "labels": { "foo": "bar" } } ], "status": "DELETING", "tags": {} } } ``` Weitere Informationen finden Sie unter [AWS -Fargate-Profil – Löschen eines Fargate-Profils](https://docs.aws.amazon.com/eks/latest/userguide/fargate-profile.html#delete-fargate-profile) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DeleteFargateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/delete-fargate-profile.html)in der *AWS CLI Befehlsreferenz*. ### `delete-nodegroup` Das folgende Codebeispiel zeigt die Verwendung`delete-nodegroup`. **AWS CLI** **Beispiel 1: Löschen einer verwalteten Knotengruppe für einen Amazon-EKS-Cluster** Im folgenden Beispiel für `delete-nodegroup` wird eine verwaltete Knotengruppe für einen Amazon-EKS-Cluster gelöscht. ``` aws eks delete-nodegroup \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup ``` Ausgabe: ``` { "nodegroup": { "nodegroupName": "my-eks-nodegroup", "nodegroupArn": "arn:aws:eks:us-east-2:111122223333:nodegroup/my-eks-cluster/my-eks-nodegroup/1ec75f5f-0e21-dcc0-b46e-f9c442685cd8", "clusterName": "my-eks-cluster", "version": "1.26", "releaseVersion": "1.26.12-20240329", "createdAt": "2024-04-08T13:25:15.033000-04:00", "modifiedAt": "2024-04-08T13:25:31.252000-04:00", "status": "DELETING", "capacityType": "SPOT", "scalingConfig": { "minSize": 1, "maxSize": 5, "desiredSize": 4 }, "instanceTypes": [ "t3.large" ], "subnets": [ "subnet-0e2907431c9988b72", "subnet-04ad87f71c6e5ab4d", "subnet-09d912bb63ef21b9a" ], "amiType": "AL2_x86_64", "nodeRole": "arn:aws:iam::111122223333:role/role-name", "labels": { "my-eks-nodegroup-label-2": "value-2", "my-eks-nodegroup-label-1": "value-1" }, "taints": [ { "key": "taint-key-1", "value": "taint-value-1", "effect": "NO_EXECUTE" } ], "diskSize": 50, "health": { "issues": [] }, "updateConfig": { "maxUnavailable": 2 }, "tags": { "my-eks-nodegroup-key-1": "value-1", "my-eks-nodegroup-key-2": "value-2" } } } ``` + Einzelheiten zur API finden Sie [DeleteNodegroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/delete-nodegroup.html)in der *AWS CLI Befehlsreferenz*. ### `delete-pod-identity-association` Das folgende Codebeispiel zeigt die Verwendung`delete-pod-identity-association`. **AWS CLI** **So löschen Sie die Zuordnung der EKS Pod Identity** Im folgenden Beispiel für `delete-pod-identity-association` wird die Zuordnung der EKS Pod Identity mit der Zuordnungs-ID `a-9njjin9gfghecgocd` aus dem EKS-Cluster namens `eks-customer` gelöscht. ``` aws eks delete-pod-identity-association \ --cluster-name eks-customer \ --association-id a-9njjin9gfghecgocd ``` Ausgabe: ``` { "association": { "clusterName": "eks-customer", "namespace": "default", "serviceAccount": "default", "roleArn": "arn:aws:iam::111122223333:role/s3-role", "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-9njjin9gfghecgocd", "associationId": "a-9njjin9gfghecgocd", "tags": { "Key2": "value2", "Key1": "value1" }, "createdAt": "2025-05-24T19:52:14.135000-05:00", "modifiedAt": "2025-05-25T21:10:56.923000-05:00" } } ``` Weitere Informationen finden [Sie im *Amazon EKS-Benutzerhandbuch* unter Erfahren Sie, wie EKS Pod Identity Pods Zugriff auf AWS Dienste gewährt](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html). + Einzelheiten zur API finden Sie [DeletePodIdentityAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/delete-pod-identity-association.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-cluster` Das folgende Codebeispiel zeigt die Verwendung`deregister-cluster`. **AWS CLI** **So melden Sie einen verbundenen Cluster ab, um ihn aus der Amazon-EKS-Steuerebene zu entfernen** Im folgenden Beispiel für `deregister-cluster` melden Sie einen verbundenen Cluster ab, um ihn aus der Amazon-EKS-Steuerebene zu entfernen. ``` aws eks deregister-cluster \ --name my-eks-anywhere-cluster ``` Ausgabe: ``` { "cluster": { "name": "my-eks-anywhere-cluster", "arn": "arn:aws:eks:us-east-2:111122223333:cluster/my-eks-anywhere-cluster", "createdAt": "2024-04-12T12:38:37.561000-04:00", "status": "DELETING", "tags": {}, "connectorConfig": { "activationId": "dfb5ad28-13c3-4e26-8a19-5b2457638c74", "activationExpiry": "2024-04-15T12:38:37.082000-04:00", "provider": "EKS_ANYWHERE", "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole" } } } ``` Weitere Informationen finden Sie unter [Aufheben der Registrierung eines Clusters](https://docs.aws.amazon.com/eks/latest/userguide/deregister-connected-cluster.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DeregisterCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/deregister-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `describe-access-entry` Das folgende Codebeispiel zeigt die Verwendung`describe-access-entry`. **AWS CLI** **So beschreiben Sie den Zugriffseintrag für den EKS-Cluster** Im folgenden Beispiel für `describe-access-entry` wird ein Zugriffseintrag für den EKS-Cluster beschrieben. ``` aws eks describe-access-entry \ --cluster-name eks-customer \ --principal-arn arn:aws:iam::111122223333:user/eks-admin-user ``` Ausgabe: ``` { "accessEntry": { "clusterName": "eks-customer", "principalArn": "arn:aws:iam::111122223333:user/eks-admin-user", "kubernetesGroups": [], "accessEntryArn": "arn:aws:eks:us-west-2:111122223333:access-entry/eks-customer/user/111122223333/eks-admin-user/0acb1bc6-cb0a-ede6-11ae-a6506e3d36p0", "createdAt": "2025-04-14T22:45:48.097000-05:00", "modifiedAt": "2025-04-14T22:45:48.097000-05:00", "tags": {}, "username": "arn:aws:iam::111122223333:user/eks-admin-user", "type": "STANDARD" } } ``` Weitere Informationen finden Sie unter [Gewähren des Zugriffs auf Kubernetes mit EKS-Zugriffseinträgen für IAM-Benutzer](https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DescribeAccessEntry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-access-entry.html)in der *AWS CLI Befehlsreferenz*. ### `describe-addon-configuration` Das folgende Codebeispiel zeigt die Verwendung`describe-addon-configuration`. **AWS CLI** **Beispiel 1: Verfügbare Konfigurationsoptionen bei der Erstellung oder Aktualisierung von Amazon vpc-cni AddOns** Im folgenden Beispiel für `describe-addon-configuration` wird das gesamte verfügbare Konfigurationsschema zurückgegeben, das verwendet wird, um ein vpc-cni-Add-On zu erstellen oder mit der entsprechenden Version zu aktualisieren. ``` aws eks describe-addon-configuration \ --addon-name vpc-cni \ --addon-version v1.15.1-eksbuild.1 ``` Ausgabe: ``` { "addonName": "vpc-cni", "addonVersion": "v1.15.1-eksbuild.1", "configurationSchema": "{\"$ref\":\"#/definitions/VpcCni\",\"$schema\":\"http://json-schema.org/draft-06/schema#\",\"definitions\":{\"Affinity\":{\"type\":[\"object\",\"null\"]},\"EniConfig\":{\"additionalProperties\":false,\"properties\":{\"create\":{\"type\":\"boolean\"},\"region\":{\"type\":\"string\"},\"subnets\":{\"additionalProperties\":{\"additionalProperties\":false,\"properties\":{\"id\":{\"type\":\"string\"},\"securityGroups\":{\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"id\"],\"type\":\"object\"},\"minProperties\":1,\"type\":\"object\"}},\"required\":[\"create\",\"region\",\"subnets\"],\"type\":\"object\"},\"Env\":{\"additionalProperties\":false,\"properties\":{\"ADDITIONAL_ENI_TAGS\":{\"type\":\"string\"},\"ANNOTATE_POD_IP\":{\"format\":\"boolean\",\"type\":\"string\"},\"AWS_EC2_ENDPOINT\":{\"type\":\"string\"},\"AWS_EXTERNAL_SERVICE_CIDRS\":{\"type\":\"string\"},\"AWS_MANAGE_ENIS_NON_SCHEDULABLE\":{\"format\":\"boolean\",\"type\":\"string\"},\"AWS_VPC_CNI_NODE_PORT_SUPPORT\":{\"format\":\"boolean\",\"type\":\"string\"},\"AWS_VPC_ENI_MTU\":{\"format\":\"integer\",\"type\":\"string\"},\"AWS_VPC_K8S_CNI_CUSTOM_NETWORK_CFG\":{\"format\":\"boolean\",\"type\":\"string\"},\"AWS_VPC_K8S_CNI_EXCLUDE_SNAT_CIDRS\":{\"type\":\"string\"},\"AWS_VPC_K8S_CNI_EXTERNALSNAT\":{\"format\":\"boolean\",\"type\":\"string\"},\"AWS_VPC_K8S_CNI_LOGLEVEL\":{\"type\":\"string\"},\"AWS_VPC_K8S_CNI_LOG_FILE\":{\"type\":\"string\"},\"AWS_VPC_K8S_CNI_RANDOMIZESNAT\":{\"type\":\"string\"},\"AWS_VPC_K8S_CNI_VETHPREFIX\":{\"type\":\"string\"},\"AWS_VPC_K8S_PLUGIN_LOG_FILE\":{\"type\":\"string\"},\"AWS_VPC_K8S_PLUGIN_LOG_LEVEL\":{\"type\":\"string\"},\"CLUSTER_ENDPOINT\":{\"type\":\"string\"},\"DISABLE_INTROSPECTION\":{\"format\":\"boolean\",\"type\":\"string\"},\"DISABLE_LEAKED_ENI_CLEANUP\":{\"format\":\"boolean\",\"type\":\"string\"},\"DISABLE_METRICS\":{\"format\":\"boolean\",\"type\":\"string\"},\"DISABLE_NETWORK_RESOURCE_PROVISIONING\":{\"format\":\"boolean\",\"type\":\"string\"},\"DISABLE_POD_V6\":{\"format\":\"boolean\",\"type\":\"string\"},\"ENABLE_BANDWIDTH_PLUGIN\":{\"format\":\"boolean\",\"type\":\"string\"},\"ENABLE_POD_ENI\":{\"format\":\"boolean\",\"type\":\"string\"},\"ENABLE_PREFIX_DELEGATION\":{\"format\":\"boolean\",\"type\":\"string\"},\"ENABLE_V4_EGRESS\":{\"format\":\"boolean\",\"type\":\"string\"},\"ENABLE_V6_EGRESS\":{\"format\":\"boolean\",\"type\":\"string\"},\"ENI_CONFIG_ANNOTATION_DEF\":{\"type\":\"string\"},\"ENI_CONFIG_LABEL_DEF\":{\"type\":\"string\"},\"INTROSPECTION_BIND_ADDRESS\":{\"type\":\"string\"},\"IP_COOLDOWN_PERIOD\":{\"format\":\"integer\",\"type\":\"string\"},\"MAX_ENI\":{\"format\":\"integer\",\"type\":\"string\"},\"MINIMUM_IP_TARGET\":{\"format\":\"integer\",\"type\":\"string\"},\"POD_SECURITY_GROUP_ENFORCING_MODE\":{\"type\":\"string\"},\"WARM_ENI_TARGET\":{\"format\":\"integer\",\"type\":\"string\"},\"WARM_IP_TARGET\":{\"format\":\"integer\",\"type\":\"string\"},\"WARM_PREFIX_TARGET\":{\"format\":\"integer\",\"type\":\"string\"}},\"title\":\"Env\",\"type\":\"object\"},\"Init\":{\"additionalProperties\":false,\"properties\":{\"env\":{\"$ref\":\"#/definitions/InitEnv\"}},\"title\":\"Init\",\"type\":\"object\"},\"InitEnv\":{\"additionalProperties\":false,\"properties\":{\"DISABLE_TCP_EARLY_DEMUX\":{\"format\":\"boolean\",\"type\":\"string\"},\"ENABLE_V6_EGRESS\":{\"format\":\"boolean\",\"type\":\"string\"}},\"title\":\"InitEnv\",\"type\":\"object\"},\"Limits\":{\"additionalProperties\":false,\"properties\":{\"cpu\":{\"type\":\"string\"},\"memory\":{\"type\":\"string\"}},\"title\":\"Limits\",\"type\":\"object\"},\"NodeAgent\":{\"additionalProperties\":false,\"properties\":{\"enableCloudWatchLogs\":{\"format\":\"boolean\",\"type\":\"string\"},\"enablePolicyEventLogs\":{\"format\":\"boolean\",\"type\":\"string\"},\"healthProbeBindAddr\":{\"format\":\"integer\",\"type\":\"string\"},\"metricsBindAddr\":{\"format\":\"integer\",\"type\":\"string\"}},\"title\":\"NodeAgent\",\"type\":\"object\"},\"Resources\":{\"additionalProperties\":false,\"properties\":{\"limits\":{\"$ref\":\"#/definitions/Limits\"},\"requests\":{\"$ref\":\"#/definitions/Limits\"}},\"title\":\"Resources\",\"type\":\"object\"},\"Tolerations\":{\"additionalProperties\":false,\"items\":{\"type\":\"object\"},\"type\":\"array\"},\"VpcCni\":{\"additionalProperties\":false,\"properties\":{\"affinity\":{\"$ref\":\"#/definitions/Affinity\"},\"enableNetworkPolicy\":{\"format\":\"boolean\",\"type\":\"string\"},\"enableWindowsIpam\":{\"format\":\"boolean\",\"type\":\"string\"},\"eniConfig\":{\"$ref\":\"#/definitions/EniConfig\"},\"env\":{\"$ref\":\"#/definitions/Env\"},\"init\":{\"$ref\":\"#/definitions/Init\"},\"livenessProbeTimeoutSeconds\":{\"type\":\"integer\"},\"nodeAgent\":{\"$ref\":\"#/definitions/NodeAgent\"},\"readinessProbeTimeoutSeconds\":{\"type\":\"integer\"},\"resources\":{\"$ref\":\"#/definitions/Resources\"},\"tolerations\":{\"$ref\":\"#/definitions/Tolerations\"}},\"title\":\"VpcCni\",\"type\":\"object\"}},\"description\":\"vpc-cni\"}" } ``` **Beispiel 2: Verfügbare Konfigurationsoptionen beim Erstellen oder Aktualisieren von Amazon-Coredns AddOns** Im folgenden Beispiel für `describe-addon-configuration` wird das gesamte verfügbare Konfigurationsschema zurückgegeben, das verwendet wird, um ein coredns-Add-On zu erstellen oder mit der entsprechenden Version zu aktualisieren. ``` aws eks describe-addon-configuration \ --addon-name coredns \ --addon-version v1.8.7-eksbuild.4 ``` Ausgabe: ``` { "addonName": "coredns", "addonVersion": "v1.8.7-eksbuild.4", "configurationSchema": "{\"$ref\":\"#/definitions/Coredns\",\"$schema\":\"http://json-schema.org/draft-06/schema#\",\"definitions\":{\"Coredns\":{\"additionalProperties\":false,\"properties\":{\"computeType\":{\"type\":\"string\"},\"corefile\":{\"description\":\"Entire corefile contents to use with installation\",\"type\":\"string\"},\"nodeSelector\":{\"additionalProperties\":{\"type\":\"string\"},\"type\":\"object\"},\"replicaCount\":{\"type\":\"integer\"},\"resources\":{\"$ref\":\"#/definitions/Resources\"}},\"title\":\"Coredns\",\"type\":\"object\"},\"Limits\":{\"additionalProperties\":false,\"properties\":{\"cpu\":{\"type\":\"string\"},\"memory\":{\"type\":\"string\"}},\"title\":\"Limits\",\"type\":\"object\"},\"Resources\":{\"additionalProperties\":false,\"properties\":{\"limits\":{\"$ref\":\"#/definitions/Limits\"},\"requests\":{\"$ref\":\"#/definitions/Limits\"}},\"title\":\"Resources\",\"type\":\"object\"}}}" } ``` Weitere Informationen finden Sie unter [Erstellen oder Aktualisieren einer kubeconfig-Datei für einen Amazon-EKS-Cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DescribeAddonConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-addon-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `describe-addon-versions` Das folgende Codebeispiel zeigt die Verwendung`describe-addon-versions`. **AWS CLI** **Beispiel 1: Auflisten aller verfügbaren Add-Ons für EKS-Cluster** Das folgende `describe-addon-versions` Beispiel listet alle verfügbaren AWS Addons auf. ``` aws eks describe-addon-versions \ --query 'sort_by(addons &owner)[].{publisher: publisher, owner: owner, addonName: addonName, type: type}' \ --output table ``` Ausgabe: ``` -------------------------------------------------------------------------------------------------------------------- | DescribeAddonVersions | +---------------------------------------------+------------------+-----------------------+-------------------------+ | addonName | owner | publisher | type | +---------------------------------------------+------------------+-----------------------+-------------------------+ | vpc-cni | aws | eks | networking | | snapshot-controller | aws | eks | storage | | kube-proxy | aws | eks | networking | | eks-pod-identity-agent | aws | eks | security | | coredns | aws | eks | networking | | aws-mountpoint-s3-csi-driver | aws | s3 | storage | | aws-guardduty-agent | aws | eks | security | | aws-efs-csi-driver | aws | eks | storage | | aws-ebs-csi-driver | aws | eks | storage | | amazon-cloudwatch-observability | aws | eks | observability | | adot | aws | eks | observability | | upwind-security_upwind-operator | aws-marketplace | Upwind Security | security | | upbound_universal-crossplane | aws-marketplace | upbound | infra-management | | tetrate-io_istio-distro | aws-marketplace | tetrate-io | policy-management | | teleport_teleport | aws-marketplace | teleport | policy-management | | stormforge_optimize-live | aws-marketplace | StormForge | cost-management | | splunk_splunk-otel-collector-chart | aws-marketplace | Splunk | monitoring | | solo-io_istio-distro | aws-marketplace | Solo.io | service-mesh | | rafay-systems_rafay-operator | aws-marketplace | rafay-systems | kubernetes-management | | new-relic_kubernetes-operator | aws-marketplace | New Relic | observability | | netapp_trident-operator | aws-marketplace | NetApp Inc. | storage | | leaksignal_leakagent | aws-marketplace | leaksignal | monitoring | | kubecost_kubecost | aws-marketplace | kubecost | cost-management | | kong_konnect-ri | aws-marketplace | kong | ingress-service-type | | kasten_k10 | aws-marketplace | Kasten by Veeam | data-protection | | haproxy-technologies_kubernetes-ingress-ee | aws-marketplace | HAProxy Technologies | ingress-controller | | groundcover_agent | aws-marketplace | groundcover | monitoring | | grafana-labs_kubernetes-monitoring | aws-marketplace | Grafana Labs | monitoring | | factorhouse_kpow | aws-marketplace | factorhouse | monitoring | | dynatrace_dynatrace-operator | aws-marketplace | dynatrace | monitoring | | datree_engine-pro | aws-marketplace | datree | policy-management | | datadog_operator | aws-marketplace | Datadog | monitoring | | cribl_cribledge | aws-marketplace | Cribl | observability | | calyptia_fluent-bit | aws-marketplace | Calyptia Inc | observability | | accuknox_kubearmor | aws-marketplace | AccuKnox | security | +---------------------------------------------+------------------+-----------------------+-------------------------+ ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: Listet alle verfügbaren Addons für die angegebene Kubernetes-Version auf, die für EKS unterstützt wird** Das folgende `describe-addon-versions` Beispiel listet alle verfügbaren Addons für die angegebene Kubernetes-Version auf, die für EKS unterstützt werden. ``` aws eks describe-addon-versions \ --kubernetes-version=1.26 \ --query 'sort_by(addons &owner)[].{publisher: publisher, owner: owner, addonName: addonName, type: type}' \ --output table ``` Ausgabe: ``` -------------------------------------------------------------------------------------------------------------------- | DescribeAddonVersions | +---------------------------------------------+------------------+-----------------------+-------------------------+ | addonName | owner | publisher | type | +---------------------------------------------+------------------+-----------------------+-------------------------+ | vpc-cni | aws | eks | networking | | snapshot-controller | aws | eks | storage | | kube-proxy | aws | eks | networking | | eks-pod-identity-agent | aws | eks | security | | coredns | aws | eks | networking | | aws-mountpoint-s3-csi-driver | aws | s3 | storage | | aws-guardduty-agent | aws | eks | security | | aws-efs-csi-driver | aws | eks | storage | | aws-ebs-csi-driver | aws | eks | storage | | amazon-cloudwatch-observability | aws | eks | observability | | adot | aws | eks | observability | | upwind-security_upwind-operator | aws-marketplace | Upwind Security | security | | tetrate-io_istio-distro | aws-marketplace | tetrate-io | policy-management | | stormforge_optimize-live | aws-marketplace | StormForge | cost-management | | splunk_splunk-otel-collector-chart | aws-marketplace | Splunk | monitoring | | solo-io_istio-distro | aws-marketplace | Solo.io | service-mesh | | rafay-systems_rafay-operator | aws-marketplace | rafay-systems | kubernetes-management | | new-relic_kubernetes-operator | aws-marketplace | New Relic | observability | | netapp_trident-operator | aws-marketplace | NetApp Inc. | storage | | leaksignal_leakagent | aws-marketplace | leaksignal | monitoring | | kubecost_kubecost | aws-marketplace | kubecost | cost-management | | kong_konnect-ri | aws-marketplace | kong | ingress-service-type | | haproxy-technologies_kubernetes-ingress-ee | aws-marketplace | HAProxy Technologies | ingress-controller | | groundcover_agent | aws-marketplace | groundcover | monitoring | | grafana-labs_kubernetes-monitoring | aws-marketplace | Grafana Labs | monitoring | | dynatrace_dynatrace-operator | aws-marketplace | dynatrace | monitoring | | datadog_operator | aws-marketplace | Datadog | monitoring | | cribl_cribledge | aws-marketplace | Cribl | observability | | calyptia_fluent-bit | aws-marketplace | Calyptia Inc | observability | | accuknox_kubearmor | aws-marketplace | AccuKnox | security | +---------------------------------------------+------------------+-----------------------+-------------------------+ ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 3: Listet alle verfügbaren vpc-cni-Addons-Versionen für die angegebene Kubernetes-Version auf, die für EKS unterstützt wird** Das folgende `describe-addon-versions` Beispiel listet alle verfügbaren vpc-cni-Addons-Versionen für die angegebene Kubernetes-Version auf, die für EKS unterstützt wird. ``` aws eks describe-addon-versions \ --kubernetes-version=1.26 \ --addon-name=vpc-cni \ --query='addons[].addonVersions[].addonVersion' ``` Ausgabe: ``` [ "v1.18.0-eksbuild.1", "v1.17.1-eksbuild.1", "v1.16.4-eksbuild.2", "v1.16.3-eksbuild.2", "v1.16.2-eksbuild.1", "v1.16.0-eksbuild.1", "v1.15.5-eksbuild.1", "v1.15.4-eksbuild.1", "v1.15.3-eksbuild.1", "v1.15.1-eksbuild.1", "v1.15.0-eksbuild.2", "v1.14.1-eksbuild.1", "v1.14.0-eksbuild.3", "v1.13.4-eksbuild.1", "v1.13.3-eksbuild.1", "v1.13.2-eksbuild.1", "v1.13.0-eksbuild.1", "v1.12.6-eksbuild.2", "v1.12.6-eksbuild.1", "v1.12.5-eksbuild.2", "v1.12.0-eksbuild.2" ] ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DescribeAddonVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-addon-versions.html)AWS CLI * ### `describe-addon` Das folgende Codebeispiel zeigt die Verwendung`describe-addon`. **AWS CLI** **Beschreiben eines aktiv ausgeführten EKS-Add-Ons in Ihrem Amazon-EKS-Cluster** Im folgenden Beispiel für `describe-addon` wird das aktiv ausgeführte EKS-Add-On in Ihrem Amazon-EKS-Cluster beschrieben. ``` aws eks describe-addon \ --cluster-name my-eks-cluster \ --addon-name vpc-cni ``` Ausgabe: ``` { "addon": { "addonName": "vpc-cni", "clusterName": "my-eks-cluster", "status": "ACTIVE", "addonVersion": "v1.16.4-eksbuild.2", "health": { "issues": [] }, "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/vpc-cni/0ec71efc-98dd-3203-60b0-4b939b2a5e5f", "createdAt": "2024-03-14T13:18:45.417000-04:00", "modifiedAt": "2024-03-14T13:18:49.557000-04:00", "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm", "tags": { "eks-addon-key-3": "value-3", "eks-addon-key-4": "value-4" }, "configurationValues": "resources:\n limits:\n cpu: '100m'\nenv:\n AWS_VPC_K8S_CNI_LOGLEVEL: 'DEBUG'" } } ``` + Einzelheiten zur API finden Sie [DescribeAddon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-addon.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cluster` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster`. **AWS CLI** **Beschreiben eines aktiv ausgeführten EKS-Add-Ons in Ihrem Amazon-EKS-Cluster** Im folgenden Beispiel für `describe-cluster` wird das aktiv ausgeführte EKS-Add-On in Ihrem Amazon-EKS-Cluster beschrieben. ``` aws eks describe-cluster \ --name my-eks-cluster ``` Ausgabe: ``` { "cluster": { "name": "my-eks-cluster", "arn": "arn:aws:eks:us-east-2:111122223333:cluster/my-eks-cluster", "createdAt": "2024-03-14T11:31:44.348000-04:00", "version": "1.26", "endpoint": "https://JSA79429HJDASKJDJ8223829MNDNASW.yl4.us-east-2.eks.amazonaws.com", "roleArn": "arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-cluster-ServiceRole-zMF6CBakwwbW", "resourcesVpcConfig": { "subnetIds": [ "subnet-0fb75d2d8401716e7", "subnet-02184492f67a3d0f9", "subnet-04098063527aab776", "subnet-0e2907431c9988b72", "subnet-04ad87f71c6e5ab4d", "subnet-09d912bb63ef21b9a" ], "securityGroupIds": [ "sg-0c1327f6270afbb36" ], "clusterSecurityGroupId": "sg-01c84d09d70f39a7f", "vpcId": "vpc-0012b8e1cc0abb17d", "endpointPublicAccess": true, "endpointPrivateAccess": true, "publicAccessCidrs": [ "22.19.18.2/32" ] }, "kubernetesNetworkConfig": { "serviceIpv4Cidr": "10.100.0.0/16", "ipFamily": "ipv4" }, "logging": { "clusterLogging": [ { "types": [ "api", "audit", "authenticator", "controllerManager", "scheduler" ], "enabled": true } ] }, "identity": { "oidc": { "issuer": "https://oidc.eks.us-east-2.amazonaws.com/id/JSA79429HJDASKJDJ8223829MNDNASW" } }, "status": "ACTIVE", "certificateAuthority": { "data": "CA_DATA_STRING..." }, "platformVersion": "eks.14", "tags": { "aws:cloudformation:stack-name": "eksctl-my-eks-cluster-cluster", "alpha.eksctl.io/cluster-name": "my-eks-cluster", "karpenter.sh/discovery": "my-eks-cluster", "aws:cloudformation:stack-id": "arn:aws:cloudformation:us-east-2:111122223333:stack/eksctl-my-eks-cluster-cluster/e752ea00-e217-11ee-beae-0a9599c8c7ed", "auto-delete": "no", "eksctl.cluster.k8s.io/v1alpha1/cluster-name": "my-eks-cluster", "EKS-Cluster-Name": "my-eks-cluster", "alpha.eksctl.io/cluster-oidc-enabled": "true", "aws:cloudformation:logical-id": "ControlPlane", "alpha.eksctl.io/eksctl-version": "0.173.0-dev+a7ee89342.2024-03-01T03:40:57Z", "Name": "eksctl-my-eks-cluster-cluster/ControlPlane" }, "health": { "issues": [] }, "accessConfig": { "authenticationMode": "API_AND_CONFIG_MAP" } } } ``` + Einzelheiten zur API finden Sie [DescribeCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `describe-fargate-profile` Das folgende Codebeispiel zeigt die Verwendung`describe-fargate-profile`. **AWS CLI** **Beschreiben eines Fargate-Profils** Im folgenden Beispiel für `describe-fargate-profile` wird ein Fargate-Profil beschrieben. ``` aws eks describe-fargate-profile \ --cluster-name my-eks-cluster \ --fargate-profile-name my-fargate-profile ``` Ausgabe: ``` { "fargateProfile": { "fargateProfileName": "my-fargate-profile", "fargateProfileArn": "arn:aws:eks:us-east-2:111122223333:fargateprofile/my-eks-cluster/my-fargate-profile/96c766ce-43d2-f9c9-954c-647334391198", "clusterName": "my-eks-cluster", "createdAt": "2024-04-11T10:42:52.486000-04:00", "podExecutionRoleArn": "arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-farga-FargatePodExecutionRole-1htfAaJdJUEO", "subnets": [ "subnet-09d912bb63ef21b9a", "subnet-04ad87f71c6e5ab4d", "subnet-0e2907431c9988b72" ], "selectors": [ { "namespace": "prod*", "labels": { "labelname*?": "*value1" } }, { "namespace": "*dev*", "labels": { "labelname*?": "*value*" } } ], "status": "ACTIVE", "tags": { "eks-fargate-profile-key-2": "value-2", "eks-fargate-profile-key-1": "value-1" } } } ``` + Einzelheiten zur API finden Sie [DescribeFargateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-fargate-profile.html)in der *AWS CLI Befehlsreferenz*. ### `describe-identity-provider-config` Das folgende Codebeispiel zeigt die Verwendung`describe-identity-provider-config`. **AWS CLI** **Beschreiben einer Identitätsanbieter-Konfiguration, die Ihrem Amazon-EKS-Cluster zugeordnet ist** Im folgenden Beispiel für `describe-identity-provider-config` wird eine Identitätsanbieter-Konfiguration beschrieben, die Ihrem Amazon-EKS-Cluster zugeordnet ist. ``` aws eks describe-identity-provider-config \ --cluster-name my-eks-cluster \ --identity-provider-config type=oidc,name=my-identity-provider ``` Ausgabe: ``` { "identityProviderConfig": { "oidc": { "identityProviderConfigName": "my-identity-provider", "identityProviderConfigArn": "arn:aws:eks:us-east-2:111122223333:identityproviderconfig/my-eks-cluster/oidc/my-identity-provider/8ac76722-78e4-cec1-ed76-d49eea058622", "clusterName": "my-eks-cluster", "issuerUrl": "https://oidc.eks.us-east-2.amazonaws.com/id/38D6A4619A0A69E342B113ED7F1A7652", "clientId": "kubernetes", "usernameClaim": "email", "usernamePrefix": "my-username-prefix", "groupsClaim": "my-claim", "groupsPrefix": "my-groups-prefix", "requiredClaims": { "Claim1": "value1", "Claim2": "value2" }, "tags": { "env": "dev" }, "status": "ACTIVE" } } } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern für Ihren Cluster über einen OpenID-Connect-Identitätsanbieter](https://docs.aws.amazon.com/eks/latest/userguide/authenticate-oidc-identity-provider.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DescribeIdentityProviderConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-identity-provider-config.html)in der *AWS CLI Befehlsreferenz*. ### `describe-insight` Das folgende Codebeispiel zeigt die Verwendung`describe-insight`. **AWS CLI** **So erhalten Sie Einzelheiten zu einem Insight für einen EKS-Cluster anhand seiner ID** Im folgenden Beispiel für `describe-insight` werden Details für den Insight zurückgegeben, der anhand des Clusternamens und der Insight-ID angegeben wurde. ``` aws eks describe-insight \ --cluster-name eks-customer \ --id 38ea7a64-a14f-4e0e-95c7-8dbcab3c3623 ``` Ausgabe: ``` { "insight": { "id": "38ea7a64-a14f-4e0e-95c7-8dbcab3c3623", "name": "Kubelet version skew", "category": "UPGRADE_READINESS", "kubernetesVersion": "1.33", "lastRefreshTime": "2025-05-24T11:22:50-05:00", "lastTransitionTime": "2025-05-24T11:22:50-05:00", "description": "Checks for kubelet versions of worker nodes in the cluster to see if upgrade would cause noncompliance with supported Kubernetes kubelet version skew policy.", "insightStatus": { "status": "PASSING", "reason": "Node kubelet versions match the cluster control plane version." }, "recommendation": "Upgrade your worker nodes to match the Kubernetes version of your cluster control plane.", "additionalInfo": { "Kubelet version skew policy": "https://kubernetes.io/releases/version-skew-policy/#kubelet", "Updating a managed node group": "https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html" }, "resources": [], "categorySpecificSummary": { "deprecationDetails": [] } } } ``` Weitere Informationen finden Sie unter [Anzeigen von Cluster-Insights](https://docs.aws.amazon.com/eks/latest/userguide/view-cluster-insights.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DescribeInsight](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-insight.html)in der *AWS CLI Befehlsreferenz*. ### `describe-nodegroup` Das folgende Codebeispiel zeigt die Verwendung`describe-nodegroup`. **AWS CLI** **Beschreiben einer verwalteten Knotengruppe für einen Amazon-EKS-Cluster** Im folgenden Beispiel für `describe-nodegroup` wird eine verwaltete Knotengruppe für einen Amazon-EKS-Cluster beschrieben. ``` aws eks describe-nodegroup \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup ``` Ausgabe: ``` { "nodegroup": { "nodegroupName": "my-eks-nodegroup", "nodegroupArn": "arn:aws:eks:us-east-2:111122223333:nodegroup/my-eks-cluster/my-eks-nodegroup/a8c75f2f-df78-a72f-4063-4b69af3de5b1", "clusterName": "my-eks-cluster", "version": "1.26", "releaseVersion": "1.26.12-20240329", "createdAt": "2024-04-08T11:42:10.555000-04:00", "modifiedAt": "2024-04-08T11:44:12.402000-04:00", "status": "ACTIVE", "capacityType": "ON_DEMAND", "scalingConfig": { "minSize": 1, "maxSize": 3, "desiredSize": 1 }, "instanceTypes": [ "t3.medium" ], "subnets": [ "subnet-0e2907431c9988b72", "subnet-04ad87f71c6e5ab4d", "subnet-09d912bb63ef21b9a" ], "amiType": "AL2_x86_64", "nodeRole": "arn:aws:iam::111122223333:role/role-name", "labels": {}, "resources": { "autoScalingGroups": [ { "name": "eks-my-eks-nodegroup-a8c75f2f-df78-a72f-4063-4b69af3de5b1" } ] }, "diskSize": 20, "health": { "issues": [] }, "updateConfig": { "maxUnavailable": 1 }, "tags": {} } } ``` + Einzelheiten zur API finden Sie [DescribeNodegroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-nodegroup.html)in der *AWS CLI Befehlsreferenz*. ### `describe-pod-identity-association` Das folgende Codebeispiel zeigt die Verwendung`describe-pod-identity-association`. **AWS CLI** **So geben Sie die Details zur Pod-Identity-Zuordnung an** Im folgenden Beispiel für `describe-pod-identity-association` wird eine Pod-Identity-Zuordnung im EKS-Cluster beschrieben. ``` aws eks describe-pod-identity-association \ --cluster-name eks-customer \ --association-id a-9njjin9gfghecgocd ``` Ausgabe: ``` { "association": { "clusterName": "eks-customer", "namespace": "default", "serviceAccount": "default", "roleArn": "arn:aws:iam::111122223333:role/my-role", "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-9njjin9gfghecgocd", "associationId": "a-9njjin9gfghecgocd", "tags": { "Key2": "value2", "Key1": "value1" }, "createdAt": "2025-05-24T19:52:14.135000-05:00", "modifiedAt": "2025-05-24T19:52:14.135000-05:00" } } ``` Weitere Informationen finden [Sie im *Amazon EKS-Benutzerhandbuch* unter Erfahren Sie, wie EKS Pod Identity Pods Zugriff auf AWS Dienste gewährt](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html). + Einzelheiten zur API finden Sie [DescribePodIdentityAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-pod-identity-association.html)in der *AWS CLI Befehlsreferenz*. ### `describe-update` Das folgende Codebeispiel zeigt die Verwendung`describe-update`. **AWS CLI** **Beispiel 1: So beschreiben Sie eine Aktualisierung für einen Cluster** Im folgenden Beispiel für `describe-update` wird eine Aktualisierung für einen Cluster beschrieben. ``` aws eks describe-update \ --name my-eks-cluster \ --update-id 10bddb13-a71b-425a-b0a6-71cd03e59161 ``` Ausgabe: ``` { "update": { "id": "10bddb13-a71b-425a-b0a6-71cd03e59161", "status": "Successful", "type": "EndpointAccessUpdate", "params": [ { "type": "EndpointPublicAccess", "value": "false" }, { "type": "EndpointPrivateAccess", "value": "true" } ], "createdAt": "2024-03-14T10:01:26.297000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktualisieren der Kubernetes-Version eines Amazon-EKS-Clusters](https://docs.aws.amazon.com/eks/latest/userguide/update-cluster.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: So beschreiben Sie eine Aktualisierung für einen Cluster** Im folgenden Beispiel für `describe-update` wird eine Aktualisierung für einen Cluster beschrieben. ``` aws eks describe-update \ --name my-eks-cluster \ --update-id e4994991-4c0f-475a-a040-427e6da52966 ``` Ausgabe: ``` { "update": { "id": "e4994991-4c0f-475a-a040-427e6da52966", "status": "Successful", "type": "AssociateEncryptionConfig", "params": [ { "type": "EncryptionConfig", "value": "[{\"resources\":[\"secrets\"],\"provider\":{\"keyArn\":\"arn:aws:kms:region-code:account:key/key\"}}]" } ], "createdAt": "2024-03-14T11:01:26.297000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktualisieren der Kubernetes-Version eines Amazon-EKS-Clusters](https://docs.aws.amazon.com/eks/latest/userguide/update-cluster.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 3: So beschreiben Sie eine Aktualisierung für einen Cluster** Im folgenden Beispiel für `describe-update` wird eine Aktualisierung für einen Cluster beschrieben. ``` aws eks describe-update \ --name my-eks-cluster \ --update-id b5f0ba18-9a87-4450-b5a0-825e6e84496f ``` Ausgabe: ``` { "update": { "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f", "status": "Successful", "type": "VersionUpdate", "params": [ { "type": "Version", "value": "1.29" }, { "type": "PlatformVersion", "value": "eks.1" } ], "createdAt": "2024-03-14T12:05:26.297000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktualisieren der Kubernetes-Version eines Amazon-EKS-Clusters](https://docs.aws.amazon.com/eks/latest/userguide/update-cluster.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DescribeUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/describe-update.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-access-policy` Das folgende Codebeispiel zeigt die Verwendung`disassociate-access-policy`. **AWS CLI** **So heben Sie die Zuordnung zwischen der Zugriffsrichtlinie und einem Zugriffseintrag auf** Im folgenden Beispiel für `disassociate-access-policy` wird die dem Zugriffseintrag zugeordnete Zugriffsrichtlinie entfernt. ``` aws eks disassociate-access-policy \ --cluster-name eks-customer \ --principal-arn arn:aws:iam::111122223333:role/Admin \ --policy-arn arn:aws:eks::aws:cluster-access-policy/AmazonEKSEditPolicy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Zuordnen von Zugriffsrichtlinien zu Zugriffseinträgen](https://docs.aws.amazon.com/eks/latest/userguide/access-policies.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DisassociateAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/disassociate-access-policy.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-identity-provider-config` Das folgende Codebeispiel zeigt die Verwendung`disassociate-identity-provider-config`. **AWS CLI** **Aufheben der Zuordnung eines Identitätsanbieters zum Amazon-EKS-Cluster** Im folgenden Beispiel für `disassociate-identity-provider-config` wird die Zuordnung eines Identitätsanbieters zu Ihrem Amazon-EKS-Cluster aufgehoben. ``` aws eks disassociate-identity-provider-config \ --cluster-name my-eks-cluster \ --identity-provider-config 'type=oidc,name=my-identity-provider' ``` Ausgabe: ``` { "update": { "id": "5f78d14e-c57b-4857-a3e4-cf664ae20949", "status": "InProgress", "type": "DisassociateIdentityProviderConfig", "params": [ { "type": "IdentityProviderConfig", "value": "[]" } ], "createdAt": "2024-04-11T13:53:43.314000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern für Ihren Cluster über einen OpenID-Connect-Identitätsanbieter – Aufheben der Zuordnung eines OIDC-Identitätsanbieters](https://docs.aws.amazon.com/eks/latest/userguide/authenticate-oidc-identity-provider.html#disassociate-oidc-identity-provider) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [DisassociateIdentityProviderConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/disassociate-identity-provider-config.html)in der *AWS CLI Befehlsreferenz*. ### `get-token` Das folgende Codebeispiel zeigt die Verwendung`get-token`. **AWS CLI** **Beispiel 1: Holen Sie sich ein Authentifizierungstoken für einen Amazon EKS-Cluster mit dem Namen `my-eks-cluster`** Im folgenden `get-token` Beispiel wird ein Authentifizierungstoken für einen Amazon EKS-Cluster mit dem Namen abgerufen my-eks-cluster. ``` aws eks get-token \ --cluster-name my-eks-cluster ``` Ausgabe: ``` { "kind": "ExecCredential", "apiVersion": "client.authentication.k8s.io/v1beta1", "spec": {}, "status": { "expirationTimestamp": "2024-04-11T20:59:56Z", "token": "k8s-aws-v1.EXAMPLE_TOKEN_DATA_STRING..." } } ``` **Beispiel 2: Ruft ein Authentifizierungstoken für einen Amazon EKS-Cluster mit dem Namen `my-eks-cluster` ab, indem beim Signieren des Tokens dieses roleARN für Anmeldeinformationen angenommen wird** Im folgenden `get-token` Beispiel wird ein Authentifizierungstoken für einen Amazon EKS-Cluster abgerufen, der benannt wird, my-eks-cluster indem beim Signieren des Tokens dieses roleARN für Anmeldeinformationen angenommen wird. ``` aws eks get-token \ --cluster-name my-eks-cluster \ --role-arn arn:aws:iam::111122223333:role/eksctl-EKS-Linux-Cluster-v1-24-cluster-ServiceRole-j1k7AfTIQtnM ``` Ausgabe: ``` { "kind": "ExecCredential", "apiVersion": "client.authentication.k8s.io/v1beta1", "spec": {}, "status": { "expirationTimestamp": "2024-04-11T21:05:26Z", "token": "k8s-aws-v1.EXAMPLE_TOKEN_DATA_STRING..." } } ``` + Einzelheiten zur API finden Sie [GetToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/get-token.html)in der *AWS CLI Befehlsreferenz.* ### `list-access-entries` Das folgende Codebeispiel zeigt die Verwendung`list-access-entries`. **AWS CLI** **So listen Sie die Zugriffseinträge für einen EKS-Cluster auf** Im folgenden Beispiel für `list-access-entries` wird die Liste der Zugriffseinträge zurückgegeben, die dem EKS-Cluster `eks-customer` zugeordnet sind. ``` aws eks list-access-entries \ --cluster-name eks-customer ``` Ausgabe: ``` { "accessEntries": [ "arn:aws:iam::111122223333:role/Admin", "arn:aws:iam::111122223333:role/admin-test-ip", "arn:aws:iam::111122223333:role/assume-worker-node-role", "arn:aws:iam::111122223333:user/eks-admin-user" ] } ``` Weitere Informationen finden Sie unter [Gewähren des Zugriffs auf Kubernetes mit EKS-Zugriffseinträgen für IAM-Benutzer](https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [ListAccessEntries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-access-entries.html)in der *AWS CLI Befehlsreferenz*. ### `list-access-policies` Das folgende Codebeispiel zeigt die Verwendung`list-access-policies`. **AWS CLI** **So listen Sie alle verfügbaren Zugriffsrichtlinien auf** In diesem Beispiel für `list-access-policies` wird die Liste aller verfügbaren Zugriffsrichtlinien zurückgegeben. ``` aws eks list-access-policies ``` Ausgabe: ``` { "accessPolicies": [ { "name": "AmazonEKSAdminPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSAdminPolicy" }, { "name": "AmazonEKSAdminViewPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSAdminViewPolicy" }, { "name": "AmazonEKSAutoNodePolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSAutoNodePolicy" }, { "name": "AmazonEKSBlockStorageClusterPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSBlockStorageClusterPolicy" }, { "name": "AmazonEKSBlockStoragePolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSBlockStoragePolicy" }, { "name": "AmazonEKSClusterAdminPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSClusterAdminPolicy" }, { "name": "AmazonEKSComputeClusterPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSComputeClusterPolicy" }, { "name": "AmazonEKSComputePolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSComputePolicy" }, { "name": "AmazonEKSEditPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSEditPolicy" }, { "name": "AmazonEKSHybridPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSHybridPolicy" }, { "name": "AmazonEKSLoadBalancingClusterPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSLoadBalancingClusterPolicy" }, { "name": "AmazonEKSLoadBalancingPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSLoadBalancingPolicy" }, { "name": "AmazonEKSNetworkingClusterPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSNetworkingClusterPolicy" }, { "name": "AmazonEKSNetworkingPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSNetworkingPolicy" }, { "name": "AmazonEKSViewPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSViewPolicy" }, { "name": "AmazonEMRJobPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonEMRJobPolicy" }, { "name": "AmazonSagemakerHyperpodClusterPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonSagemakerHyperpodClusterPolicy" }, { "name": "AmazonSagemakerHyperpodControllerPolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonSagemakerHyperpodControllerPolicy" }, { "name": "AmazonSagemakerHyperpodSystemNamespacePolicy", "arn": "arn:aws:eks::aws:cluster-access-policy/AmazonSagemakerHyperpodSystemNamespacePolicy" } ] } ``` Weitere Informationen finden Sie unter [Zuordnen von Zugriffsrichtlinien zu Zugriffseinträgen](https://docs.aws.amazon.com/eks/latest/userguide/access-policies.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [ListAccessPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-access-policies.html)in der *AWS CLI Befehlsreferenz*. ### `list-addons` Das folgende Codebeispiel zeigt die Verwendung`list-addons`. **AWS CLI** **Listet alle installierten Add-Ons in Ihrem Amazon EKS-Cluster mit dem Namen `my-eks-cluster` auf** Das folgende `list-addons` Beispiel listet alle installierten Add-Ons in Ihrem Amazon EKS-Cluster mit dem Namen auf my-eks-cluster. ``` aws eks list-addons \ --cluster-name my-eks-cluster ``` Ausgabe: ``` { "addons": [ "kube-proxy", "vpc-cni" ] } ``` + Einzelheiten zur API finden Sie [ListAddons](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-addons.html)in der *AWS CLI Befehlsreferenz*. ### `list-associated-access-policies` Das folgende Codebeispiel zeigt die Verwendung`list-associated-access-policies`. **AWS CLI** **So listen Sie die einem Zugriffseintrag zugeordneten Zugriffsrichtlinien auf** Im folgenden Beispiel für `list-associated-access-policies` wird die Liste der Zugriffsrichtlinien zurückgegeben, die einem Zugriffseintrag im EKS-Cluster zugeordnet sind. ``` aws eks list-associated-access-policies \ --cluster-name eks-customer \ --principal-arn arn:aws:iam::111122223333:role/Admin ``` Ausgabe: ``` { "associatedAccessPolicies": [ { "policyArn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSAdminPolicy", "accessScope": { "type": "cluster", "namespaces": [] }, "associatedAt": "2025-05-24T17:26:22.935000-05:00", "modifiedAt": "2025-05-24T17:26:22.935000-05:00" } ], "clusterName": "eks-customer", "principalArn": "arn:aws:iam::111122223333:role/Admin" } ``` Weitere Informationen finden Sie unter [Gewähren des Zugriffs auf Kubernetes mit EKS-Zugriffseinträgen für IAM-Benutzer](https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [ListAssociatedAccessPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-associated-access-policies.html)in der *AWS CLI Befehlsreferenz*. ### `list-clusters` Das folgende Codebeispiel zeigt die Verwendung`list-clusters`. **AWS CLI** **Um alle installierten Add-Ons in Ihrem Amazon EKS-Cluster mit dem Namen `my-eks-cluster` aufzulisten** Das folgende `list-clusters` Beispiel listet alle installierten Add-Ons in Ihrem Amazon EKS-Cluster mit dem Namen auf my-eks-cluster. ``` aws eks list-clusters ``` Ausgabe: ``` { "clusters": [ "prod", "qa", "stage", "my-eks-cluster" ] } ``` + Einzelheiten zur API finden Sie [ListClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `list-fargate-profiles` Das folgende Codebeispiel zeigt die Verwendung`list-fargate-profiles`. **AWS CLI** **Um alle Fargate-Profile in Ihrem Amazon EKS-Cluster mit dem Namen `` my-eks-cluster aufzulisten** Das folgende `list-fargate-profiles` Beispiel listet alle Fargate-Profile in Ihrem Amazon EKS-Cluster mit dem Namen my-eks-cluster auf. ``` aws eks list-fargate-profiles \ --cluster-name my-eks-cluster ``` Ausgabe: ``` { "fargateProfileNames": [ "my-fargate-profile" ] } ``` + Einzelheiten zur API finden Sie [ListFargateProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-fargate-profiles.html)in der *AWS CLI Befehlsreferenz.* ### `list-identity-provider-configs` Das folgende Codebeispiel zeigt die Verwendung`list-identity-provider-configs`. **AWS CLI** **Auflisten von Identitätsanbietern, die einem Amazon-EKS-Cluster zugeordnet sind** Im folgenden Beispiel für `list-identity-provider-configs` werden Identitätsanbieter aufgelistet, die einem Amazon-EKS-Cluster zugeordnet sind. ``` aws eks list-identity-provider-configs \ --cluster-name my-eks-cluster ``` Ausgabe: ``` { "identityProviderConfigs": [ { "type": "oidc", "name": "my-identity-provider" } ] } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern für Ihren Cluster über einen OpenID-Connect-Identitätsanbieter](https://docs.aws.amazon.com/eks/latest/userguide/authenticate-oidc-identity-provider.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [ListIdentityProviderConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-identity-provider-configs.html)in der *AWS CLI Befehlsreferenz*. ### `list-insights` Das folgende Codebeispiel zeigt die Verwendung`list-insights`. **AWS CLI** **So listen Sie alle Insights für den angegebenen Cluster auf** Im folgenden Beispiel für `list-insights` wird die Liste aller Insights zurückgegeben, die mit dem angegebenen Cluster abgeglichen wurden. ``` aws eks list-insights \ --cluster-name eks-customer ``` Ausgabe: ``` { "insights": [ { "id": "38ea7a64-a14f-4e0e-95c7-8dbcab3c3616", "name": "Kubelet version skew", "category": "UPGRADE_READINESS", "kubernetesVersion": "1.33", "lastRefreshTime": "2025-05-24T11:22:50-05:00", "lastTransitionTime": "2025-05-24T11:22:50-05:00", "description": "Checks for kubelet versions of worker nodes in the cluster to see if upgrade would cause noncompliance with supported Kubernetes kubelet version skew policy.", "insightStatus": { "status": "PASSING", "reason": "Node kubelet versions match the cluster control plane version." } }, { "id": "9cd91472-f99c-45a9-b7d7-54d4900dee23", "name": "EKS add-on version compatibility", "category": "UPGRADE_READINESS", "kubernetesVersion": "1.33", "lastRefreshTime": "2025-05-24T11:22:59-05:00", "lastTransitionTime": "2025-05-24T11:22:50-05:00", "description": "Checks version of installed EKS add-ons to ensure they are compatible with the next version of Kubernetes. ", "insightStatus": { "status": "PASSING", "reason": "All installed EKS add-on versions are compatible with next Kubernetes version." } }, { "id": "0deb269d-b1e1-458c-a2b4-7a57f940c875", "name": "Cluster health issues", "category": "UPGRADE_READINESS", "kubernetesVersion": "1.33", "lastRefreshTime": "2025-05-24T11:22:59-05:00", "lastTransitionTime": "2025-05-24T11:22:50-05:00", "description": "Checks for any cluster health issues that prevent successful upgrade to the next Kubernetes version on EKS.", "insightStatus": { "status": "PASSING", "reason": "No cluster health issues detected." } }, { "id": "214fa274-344f-420b-812a-5049ce72c9ww", "name": "kube-proxy version skew", "category": "UPGRADE_READINESS", "kubernetesVersion": "1.33", "lastRefreshTime": "2025-05-24T11:22:50-05:00", "lastTransitionTime": "2025-05-24T11:22:50-05:00", "description": "Checks version of kube-proxy in cluster to see if upgrade would cause noncompliance with supported Kubernetes kube-proxy version skew policy.", "insightStatus": { "status": "PASSING", "reason": "kube-proxy versions match the cluster control plane version." } } ] } ``` Weitere Informationen finden Sie unter [Anzeigen von Cluster-Insights](https://docs.aws.amazon.com/eks/latest/userguide/view-cluster-insights.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [ListInsights](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-insights.html)in der *AWS CLI Befehlsreferenz*. ### `list-nodegroups` Das folgende Codebeispiel zeigt die Verwendung`list-nodegroups`. **AWS CLI** **Auflisten aller Knotengruppen in einem Amazon-EKS-Cluster** Im folgenden Beispiel für `list-nodegroups` werden alle Knotengruppen in einem Amazon-EKS-Cluster aufgelistet. ``` aws eks list-nodegroups \ --cluster-name my-eks-cluster ``` Ausgabe: ``` { "nodegroups": [ "my-eks-managed-node-group", "my-eks-nodegroup" ] } ``` + Einzelheiten zur API finden Sie [ListNodegroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-nodegroups.html)in der *AWS CLI Befehlsreferenz*. ### `list-pod-identity-associations` Das folgende Codebeispiel zeigt die Verwendung`list-pod-identity-associations`. **AWS CLI** **Beispiel 1: So listen Sie die Pod-Identity-Zuordnungen in einem EKS-Cluster auf** Im folgenden Beispiel für `list-pod-identity-associations` wird die Liste der Pod-Identity-Zuordnungen zurückgegeben, die dem EKS-Cluster namens `eks-customer` in allen Namespaces und Servicekonten zugeordnet sind. ``` aws eks list-pod-identity-associations \ --cluster-name eks-customer ``` Ausgabe: ``` { "associations": [ { "clusterName": "eks-customer", "namespace": "default", "serviceAccount": "default", "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-9njjin9gfghecgocd", "associationId": "a-9njjin9gfghecgocd" }, { "clusterName": "eks-customer", "namespace": "kube-system", "serviceAccount": "eks-customer", "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-dvtacahdvjn01ffbc", "associationId": "a-dvtacahdvjn01ffbc" }, { "clusterName": "eks-customer", "namespace": "kube-system", "serviceAccount": "coredns", "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-yrpsdroc4ei7k6xps", "associationId": "a-yrpsdroc4ei7k6xps" } ] } ``` Weitere Informationen finden [Sie im *Amazon EKS-Benutzerhandbuch* unter Erfahren Sie, wie EKS Pod Identity Pods Zugriff auf AWS Dienste gewährt](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html). **Beispiel 2: So listen Sie die Pod-Identity-Zuordnungen in einem EKS-Cluster basierend auf Namespace und Servicekonto auf** Im folgenden Beispiel für `list-pod-identity-associations` wird die Liste der Pod-Identity-Zuordnungen im EKS-Cluster basierend auf Namespace und Servicekonto zurückgegeben. ``` aws eks list-pod-identity-associations \ --cluster-name eks-customer \ --namespace kube-system \ --service-account eks-customer ``` Ausgabe: ``` { "associations": [ { "clusterName": "eks-customer", "namespace": "kube-system", "serviceAccount": "eks-customer", "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-dvtacahdvjn01ffbc", "associationId": "a-dvtacahdvjn01ffbc" } ] } ``` Weitere Informationen finden [Sie im *Amazon EKS-Benutzerhandbuch* unter Erfahren Sie, wie EKS Pod Identity Pods Zugriff auf AWS Dienste gewährt](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html). + Einzelheiten zur API finden Sie [ListPodIdentityAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-pod-identity-associations.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Beispiel 1: So listen Sie alle Tags für einen Amazon-EKS-Cluster-ARN auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für einen Amazon-EKS-Cluster-ARN aufgelistet. ``` aws eks list-tags-for-resource \ --resource-arn arn:aws:eks:us-east-2:111122223333:cluster/my-eks-cluster ``` Ausgabe: ``` { "tags": { "aws:cloudformation:stack-name": "eksctl-my-eks-cluster-cluster", "alpha.eksctl.io/cluster-name": "my-eks-cluster", "karpenter.sh/discovery": "my-eks-cluster", "aws:cloudformation:stack-id": "arn:aws:cloudformation:us-east-2:111122223333:stack/eksctl-my-eks-cluster-cluster/e752ea00-e217-11ee-beae-0a9599c8c7ed", "auto-delete": "no", "eksctl.cluster.k8s.io/v1alpha1/cluster-name": "my-eks-cluster", "EKS-Cluster-Name": "my-eks-cluster", "alpha.eksctl.io/cluster-oidc-enabled": "true", "aws:cloudformation:logical-id": "ControlPlane", "alpha.eksctl.io/eksctl-version": "0.173.0-dev+a7ee89342.2024-03-01T03:40:57Z", "Name": "eksctl-my-eks-cluster-cluster/ControlPlane" } } ``` **Beispiel 2: So listen Sie alle Tags für einen Amazon-EKS-Knotengruppen-ARN auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für einen Amazon-EKS-Knotengruppen-ARN aufgelistet. ``` aws eks list-tags-for-resource \ --resource-arn arn:aws:eks:us-east-2:111122223333:nodegroup/my-eks-cluster/my-eks-managed-node-group/60c71ed2-2cfb-020f-a5f4-ad32477f198c ``` Ausgabe: ``` { "tags": { "aws:cloudformation:stack-name": "eksctl-my-eks-cluster-nodegroup-my-eks-managed-node-group", "aws:cloudformation:stack-id": "arn:aws:cloudformation:us-east-2:111122223333:stack/eksctl-my-eks-cluster-nodegroup-my-eks-managed-node-group/eaa20310-e219-11ee-b851-0ab9ad8228ff", "eksctl.cluster.k8s.io/v1alpha1/cluster-name": "my-eks-cluster", "EKS-Cluster-Name": "my-eks-cluster", "alpha.eksctl.io/nodegroup-type": "managed", "NodeGroup Name 1": "my-eks-managed-node-group", "k8s.io/cluster-autoscaler/enabled": "true", "nodegroup-role": "worker", "alpha.eksctl.io/cluster-name": "my-eks-cluster", "alpha.eksctl.io/nodegroup-name": "my-eks-managed-node-group", "karpenter.sh/discovery": "my-eks-cluster", "NodeGroup Name 2": "AmazonLinux-Linux-Managed-NG-v1-26-v1", "auto-delete": "no", "k8s.io/cluster-autoscaler/my-eks-cluster": "owned", "aws:cloudformation:logical-id": "ManagedNodeGroup", "alpha.eksctl.io/eksctl-version": "0.173.0-dev+a7ee89342.2024-03-01T03:40:57Z" } } ``` **Beispiel 3: Um alle Tags in einem Amazon EKS Fargate-Profil aufzulisten ARNe** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für einen Fargate-Profil-ARN in Amazon EKS aufgelistet. ``` aws eks list-tags-for-resource \ --resource-arn arn:aws:eks:us-east-2:111122223333:fargateprofile/my-eks-cluster/my-fargate-profile/d6c76780-e541-0725-c816-36754cab734b ``` Ausgabe: ``` { "tags": { "eks-fargate-profile-key-2": "value-2", "eks-fargate-profile-key-1": "value-1" } } ``` **Beispiel 4: So listen Sie alle Tags für einen Add-On-ARN in Amazon EKS auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für einen Add-On-ARN in Amazon EKS aufgelistet. ``` aws eks list-tags-for-resource \ --resource-arn arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/vpc-cni/0ec71efc-98dd-3203-60b0-4b939b2a5e5f ``` Ausgabe: ``` { "tags": { "eks-addon-key-2": "value-2", "eks-addon-key-1": "value-1" } } ``` **Beispiel 5: So listen Sie alle Tags für einen OIDC-Identitätsanbieter-ARN in Amazon EKS auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für einen OIDC-Identitätsanbieter-ARN in Amazon EKS aufgelistet. ``` aws eks list-tags-for-resource \ --resource-arn arn:aws:eks:us-east-2:111122223333:identityproviderconfig/my-eks-cluster/oidc/my-identity-provider/8ac76722-78e4-cec1-ed76-d49eea058622 ``` Ausgabe: ``` { "tags": { "my-identity-provider": "test" } } ``` + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `list-update` Das folgende Codebeispiel zeigt die Verwendung`list-update`. **AWS CLI** **Beispiel 1: So listen Sie die einem Amazon-EKS-Clusternamen zugeordneten Aktualisierungen auf** Das folgende `list-updates` Beispiel listet alle Updates IDs für einen Amazon EKS-Clusternamen auf. ``` aws eks list-updates \ --name my-eks-cluster ``` Ausgabe: ``` { "updateIds": [ "5f78d14e-c57b-4857-a3e4-cf664ae20949", "760e5a3f-adad-48c7-88d3-7ac283c09c26", "cd4ec863-bc55-47d5-a377-3971502f529b", "f12657ce-e869-4f17-b158-a82ab8b7d937" ] } ``` **Beispiel 2: Um alle Updates IDs für eine Amazon EKS Node-Gruppe aufzulisten** Das folgende `list-updates` Beispiel listet alle Updates IDs für eine Amazon EKS Node-Gruppe auf. ``` aws eks list-updates \ --name my-eks-cluster \ --nodegroup-name my-eks-managed-node-group ``` Ausgabe: ``` { "updateIds": [ "8c6c1bef-61fe-42ac-a242-89412387b8e7" ] } ``` **Beispiel 3: Um alle Updates IDs auf einem Amazon EKS-Add-on aufzulisten** Das folgende `list-updates` Beispiel listet alle Updates IDs für ein Amazon EKS-Add-on auf. ``` aws eks list-updates \ --name my-eks-cluster \ --addon-name vpc-cni ``` Ausgabe: ``` { "updateIds": [ "9cdba8d4-79fb-3c83-afe8-00b508d33268" ] } ``` + Einzelheiten zur API finden Sie [ListUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-update.html)in der *AWS CLI Befehlsreferenz*. ### `list-updates` Das folgende Codebeispiel zeigt die Verwendung`list-updates`. **AWS CLI** **So listen Sie die Aktualisierungen für einen Cluster auf** In diesem Beispielbefehl werden die laufenden Aktualisierungen für einen Cluster namens `example` in Ihrer Standardregion aufgelistet. Befehl: ``` aws eks list-updates --name example ``` Ausgabe: ``` { "updateIds": [ "10bddb13-a71b-425a-b0a6-71cd03e59161" ] } ``` + Einzelheiten zur API finden Sie [ListUpdates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/list-updates.html)in der *AWS CLI Befehlsreferenz*. ### `register-cluster` Das folgende Codebeispiel zeigt die Verwendung`register-cluster`. **AWS CLI** **Beispiel 1: So registrieren Sie einen externen EKS\$1ANYWHERE-Kubernetes-Cluster bei Amazon EKS** Im folgenden Beispiel für `register-cluster` wird ein externer EKS\$1ANYWHERE-Kubernetes-Cluster bei Amazon EKS registriert. ``` aws eks register-cluster \ --name my-eks-anywhere-cluster \ --connector-config 'roleArn=arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole,provider=EKS_ANYWHERE' ``` Ausgabe: ``` { "cluster": { "name": "my-eks-anywhere-cluster", "arn": "arn:aws:eks:us-east-2:111122223333:cluster/my-eks-anywhere-cluster", "createdAt": "2024-04-12T12:38:37.561000-04:00", "status": "PENDING", "tags": {}, "connectorConfig": { "activationId": "xxxxxxxxACTIVATION_IDxxxxxxxx", "activationCode": "xxxxxxxxACTIVATION_CODExxxxxxxx", "activationExpiry": "2024-04-15T12:38:37.082000-04:00", "provider": "EKS_ANYWHERE", "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole" } } } ``` Weitere Informationen finden Sie unter [Verbinden eines externen Clusters](https://docs.aws.amazon.com/eks/latest/userguide/connecting-cluster.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: So registrieren Sie einen beliebigen externen Kubernetes-Cluster bei Amazon EKS** Im folgenden Beispiel für `register-cluster` wird ein externer EKS\$1ANYWHERE-Kubernetes-Cluster bei Amazon EKS registriert. ``` aws eks register-cluster \ --name my-eks-anywhere-cluster \ --connector-config 'roleArn=arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole,provider=OTHER' ``` Ausgabe: ``` { "cluster": { "name": "my-onprem-k8s-cluster", "arn": "arn:aws:eks:us-east-2:111122223333:cluster/my-onprem-k8s-cluster", "createdAt": "2024-04-12T12:42:10.861000-04:00", "status": "PENDING", "tags": {}, "connectorConfig": { "activationId": "xxxxxxxxACTIVATION_IDxxxxxxxx", "activationCode": "xxxxxxxxACTIVATION_CODExxxxxxxx", "activationExpiry": "2024-04-15T12:42:10.339000-04:00", "provider": "OTHER", "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole" } } } ``` Weitere Informationen finden Sie unter [Verbinden eines externen Clusters](https://docs.aws.amazon.com/eks/latest/userguide/connecting-cluster.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [RegisterCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/register-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Beispiel 1: So fügen Sie die angegebenen Tags einem Amazon-EKS-Cluster hinzu** Im folgenden Beispiel für `tag-resource` werden die angegebenen Tags einem Amazon-EKS-Cluster hinzugefügt. ``` aws eks tag-resource \ --resource-arn arn:aws:eks:us-east-2:111122223333:cluster/my-eks-cluster \ --tag 'my-eks-cluster-test-1=test-value-1,my-eks-cluster-dev-1=dev-value-2' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So fügen Sie die angegebenen Tags einer Amazon-EKS-Knotengruppe hinzu** Im folgenden Beispiel für `tag-resource` werden die angegebenen Tags einer Amazon-EKS-Knotengruppe hinzugefügt. ``` aws eks tag-resource \ --resource-arn arn:aws:eks:us-east-2:111122223333:nodegroup/my-eks-cluster/my-eks-managed-node-group/60c71ed2-2cfb-020f-a5f4-ad32477f198c \ --tag 'my-eks-nodegroup-test-1=test-value-1,my-eks-nodegroup-dev-1=dev-value-2' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Beispiel 1: So löschen Sie die angegebenen Tags aus einem Amazon-EKS-Cluster** Im folgenden Beispiel für `untag-resource` werden die angegebenen Tags aus einem Amazon-EKS-Cluster gelöscht. ``` aws eks untag-resource \ --resource-arn arn:aws:eks:us-east-2:111122223333:cluster/my-eks-cluster \ --tag-keys "my-eks-cluster-test-1" "my-eks-cluster-dev-1" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So löschen Sie die angegebenen Tags aus einer Amazon-EKS-Knotengruppe** Im folgenden Beispiel für `untag-resource` werden die angegebenen Tags aus einer Amazon-EKS-Knotengruppe gelöscht. ``` aws eks untag-resource \ --resource-arn arn:aws:eks:us-east-2:111122223333:nodegroup/my-eks-cluster/my-eks-managed-node-group/60c71ed2-2cfb-020f-a5f4-ad32477f198c \ --tag-keys "my-eks-nodegroup-test-1" "my-eks-nodegroup-dev-1" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-access-entry` Das folgende Codebeispiel zeigt die Verwendung`update-access-entry`. **AWS CLI** **So aktualisieren Sie einen Zugriffseintrag für einen EKS-Cluster** Im folgenden Beispiel für `update-access-entry` wird ein Zugriffseintrag für den EKS-Cluster aktualisiert, indem die Kubernetes-Gruppe `tester` hinzugefügt wird. ``` aws eks update-access-entry \ --cluster-name eks-customer \ --principal-arn arn:aws:iam::111122223333:role/Admin \ --kubernetes-groups tester ``` Ausgabe: ``` { "accessEntry": { "clusterName": "eks-customer", "principalArn": "arn:aws:iam::111122223333:role/Admin", "kubernetesGroups": [ "tester" ], "accessEntryArn": "arn:aws:eks:us-west-2:111122223333:access-entry/eks-customer/role/111122223333/Admin/d2cb8183-d6ec-b82a-d967-eca21902a4b4", "createdAt": "2025-05-24T11:02:04.432000-05:00", "modifiedAt": "2025-05-24T17:08:01.608000-05:00", "tags": {}, "username": "arn:aws:sts::111122223333:assumed-role/Admin/{{SessionName}}", "type": "STANDARD" } } ``` Weitere Informationen finden Sie unter [Aktualisieren von Zugriffseinträgen](https://docs.aws.amazon.com/eks/latest/userguide/updating-access-entries.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [UpdateAccessEntry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/update-access-entry.html)in der *AWS CLI Befehlsreferenz*. ### `update-addon` Das folgende Codebeispiel zeigt die Verwendung`update-addon`. **AWS CLI** **Beispiel 1. So aktualisieren Sie ein Amazon-EKS-Add-On mit einem Servicekonten-Rollen-ARN** Im folgenden `update-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On mit einem Servicekonten-Rollen-ARN aktualisiert. ``` aws eks update-addon \ --cluster-name my-eks-cluster \ --addon-name vpc-cni \ --service-account-role-arn arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm ``` Ausgabe: ``` { "update": { "id": "c00d2de2-c2e4-3d30-929e-46b8edec2ce4", "status": "InProgress", "type": "AddonUpdate", "params": [ { "type": "ServiceAccountRoleArn", "value": "arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm" } ], "updatedAt": "2024-04-12T16:04:55.614000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS – Aktualisieren eines Add-Ons](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#updating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2. So aktualisieren Sie ein Amazon-EKS-Add-On mit einer bestimmten Add-On-Version** Im folgenden `update-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On mit einer bestimmten Add-On-Version aktualisiert. ``` aws eks update-addon \ --cluster-name my-eks-cluster \ --addon-name vpc-cni \ --service-account-role-arn arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm \ --addon-version v1.16.4-eksbuild.2 ``` Ausgabe: ``` { "update": { "id": "f58dc0b0-2b18-34bd-bc6a-e4abc0011f36", "status": "InProgress", "type": "AddonUpdate", "params": [ { "type": "AddonVersion", "value": "v1.16.4-eksbuild.2" }, { "type": "ServiceAccountRoleArn", "value": "arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm" } ], "createdAt": "2024-04-12T16:07:16.550000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS – Aktualisieren eines Add-Ons](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#updating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 3. So aktualisieren Sie ein Amazon-EKS-Add-On mit benutzerdefinierten Konfigurationswerten und lösen Konfliktdetails** Im folgenden `update-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On mit benutzerdefinierten Konfigurationswerten aktualisiert und Konfliktdetails werden gelöst. ``` aws eks update-addon \ --cluster-name my-eks-cluster \ --addon-name vpc-cni \ --service-account-role-arn arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm \ --addon-version v1.16.4-eksbuild.2 \ --configuration-values '{"resources": {"limits":{"cpu":"100m"}, "requests":{"cpu":"50m"}}}' \ --resolve-conflicts PRESERVE ``` Ausgabe: ``` { "update": { "id": "cd9f2173-a8d8-3004-a90f-032f14326520", "status": "InProgress", "type": "AddonUpdate", "params": [ { "type": "AddonVersion", "value": "v1.16.4-eksbuild.2" }, { "type": "ServiceAccountRoleArn", "value": "arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm" }, { "type": "ResolveConflicts", "value": "PRESERVE" }, { "type": "ConfigurationValues", "value": "{\"resources\": {\"limits\":{\"cpu\":\"100m\"}, \"requests\":{\"cpu\":\"50m\"}}}" } ], "createdAt": "2024-04-12T16:16:27.363000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS – Aktualisieren eines Add-Ons](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#updating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 4. So aktualisieren Sie ein Amazon-EKS-Add-On mit einer Datei mit benutzerdefinierten JSON-Konfigurationswerten** Im folgenden `update-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On mit benutzerdefinierten JSON-Konfigurationswerten aktualisiert und Konfliktdetails werden gelöst. ``` aws eks update-addon \ --cluster-name my-eks-cluster \ --addon-name vpc-cni \ --service-account-role-arn arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm \ --addon-version v1.17.1-eksbuild.1 \ --configuration-values 'file://configuration-values.json' \ --resolve-conflicts PRESERVE ``` Inhalt von `configuration-values.json`: ``` { "resources": { "limits": { "cpu": "100m" }, "requests": { "cpu": "50m" } }, "env": { "AWS_VPC_K8S_CNI_LOGLEVEL": "ERROR" } } ``` Ausgabe: ``` { "update": { "id": "6881a437-174f-346b-9a63-6e91763507cc", "status": "InProgress", "type": "AddonUpdate", "params": [ { "type": "AddonVersion", "value": "v1.17.1-eksbuild.1" }, { "type": "ServiceAccountRoleArn", "value": "arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm" }, { "type": "ResolveConflicts", "value": "PRESERVE" }, { "type": "ConfigurationValues", "value": "{\n \"resources\": {\n \"limits\": {\n \"cpu\": \"100m\"\n },\n \"requests\": {\n \"cpu\": \"50m\"\n }\n },\n \"env\": {\n \"AWS_VPC_K8S_CNI_LOGLEVEL\": \"ERROR\"\n }\n}" } ], "createdAt": "2024-04-12T16:22:55.519000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS – Aktualisieren eines Add-Ons](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#updating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 5. So aktualisieren Sie ein Amazon-EKS-Add-On mit einer Datei mit benutzerdefinierten YAML-Konfigurationswerten** Im folgenden `update-addon`-Beispielbefehl wird ein Amazon-EKS-Add-On mit benutzerdefinierten YAML-Konfigurationswerten aktualisiert und Konfliktdetails werden gelöst. ``` aws eks update-addon \ --cluster-name my-eks-cluster \ --addon-name vpc-cni \ --service-account-role-arn arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm \ --addon-version v1.18.0-eksbuild.1 \ --configuration-values 'file://configuration-values.yaml' \ --resolve-conflicts PRESERVE ``` Inhalt von `configuration-values.yaml`: ``` resources: limits: cpu: '100m' requests: cpu: '50m' env: AWS_VPC_K8S_CNI_LOGLEVEL: 'DEBUG' ``` Ausgabe: ``` { "update": { "id": "a067a4c9-69d0-3769-ace9-d235c5b16701", "status": "InProgress", "type": "AddonUpdate", "params": [ { "type": "AddonVersion", "value": "v1.18.0-eksbuild.1" }, { "type": "ServiceAccountRoleArn", "value": "arn:aws:iam::111122223333:role/eksctl-my-eks-cluster-addon-vpc-cni-Role1-YfakrqOC1UTm" }, { "type": "ResolveConflicts", "value": "PRESERVE" }, { "type": "ConfigurationValues", "value": "resources:\n limits:\n cpu: '100m'\n requests:\n cpu: '50m'\nenv:\n AWS_VPC_K8S_CNI_LOGLEVEL: 'DEBUG'" } ], "createdAt": "2024-04-12T16:25:07.212000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Verwalten von Add-Ons für Amazon EKS – Aktualisieren eines Add-Ons](https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#updating-an-add-on) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [UpdateAddon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/update-addon.html)in der *AWS CLI Befehlsreferenz*. ### `update-cluster-config` Das folgende Codebeispiel zeigt die Verwendung`update-cluster-config`. **AWS CLI** **So aktualisieren Sie den Cluster-Endpunktzugriff** In diesem Beispielbefehl wird ein Cluster aktualisiert, um den öffentlichen Endpunktzugriff zu deaktivieren und privaten Endpunktzugriff zu aktivieren. Befehl: ``` aws eks update-cluster-config --name example \ --resources-vpc-config endpointPublicAccess=false,endpointPrivateAccess=true ``` Ausgabe: ``` { "update": { "id": "ec883c93-2e9e-407c-a22f-8f6fa6e67d4f", "status": "InProgress", "type": "EndpointAccessUpdate", "params": [ { "type": "EndpointPublicAccess", "value": "false" }, { "type": "EndpointPrivateAccess", "value": "true" } ], "createdAt": 1565806986.506, "errors": [] } } ``` **So aktivieren Sie die Protokollierung für einen Cluster** In diesem Beispielbefehl werden alle Protokollierungstypen der Cluster-Steuerebene für einen Cluster namens `example` aktiviert. Befehl: ``` aws eks update-cluster-config --name example \ --logging '{"clusterLogging":[{"types":["api","audit","authenticator","controllerManager","scheduler"],"enabled":true}]}' ``` Ausgabe: ``` { "update": { "id": "7551c64b-1d27-4b1e-9f8e-c45f056eb6fd", "status": "InProgress", "type": "LoggingUpdate", "params": [ { "type": "ClusterLogging", "value": "{\"clusterLogging\":[{\"types\":[\"api\",\"audit\",\"authenticator\",\"controllerManager\",\"scheduler\"],\"enabled\":true}]}" } ], "createdAt": 1565807210.37, "errors": [] } } ``` + Einzelheiten zur API finden Sie [UpdateClusterConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/update-cluster-config.html)in der *AWS CLI Befehlsreferenz*. ### `update-cluster-version` Das folgende Codebeispiel zeigt die Verwendung`update-cluster-version`. **AWS CLI** **Um einen Amazon EKS-Cluster mit dem Namen `my-eks-cluster` auf die angegebene Kubernetes-Version zu aktualisieren** Im folgenden Beispiel für `update-cluster-version` wird ein Amazon-EKS-Cluster auf die angegebene Kubernetes-Version aktualisiert. ``` aws eks update-cluster-version \ --name my-eks-cluster \ --kubernetes-version 1.27 ``` Ausgabe: ``` { "update": { "id": "e4091a28-ea14-48fd-a8c7-975aeb469e8a", "status": "InProgress", "type": "VersionUpdate", "params": [ { "type": "Version", "value": "1.27" }, { "type": "PlatformVersion", "value": "eks.16" } ], "createdAt": "2024-04-12T16:56:01.082000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktualisieren der Kubernetes-Version eines Amazon-EKS-Clusters](https://docs.aws.amazon.com/eks/latest/userguide/update-cluster.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [UpdateClusterVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/update-cluster-version.html)in der *AWS CLI Befehlsreferenz*. ### `update-kubeconfig` Das folgende Codebeispiel zeigt die Verwendung`update-kubeconfig`. **AWS CLI** **Beispiel 1: Konfiguriert Ihr kubectl, indem Sie kubeconfig erstellen oder aktualisieren, sodass Sie eine Verbindung zu einem Amazon EKS-Cluster namens `` herstellen können my-eks-cluster** Im folgenden `update-kubeconfig` Beispiel wird Ihr kubectl konfiguriert, indem es die kubeconfig erstellt oder aktualisiert, sodass Sie eine Verbindung zu einem Amazon EKS-Cluster mit dem Namen herstellen können. my-eks-cluster ``` aws eks update-kubeconfig \ --name my-eks-cluster ``` Ausgabe: ``` Updated context arn:aws:eks:us-east-2:111122223333:cluster/my-eks-cluster in /Users/xxx/.kube/config ``` Weitere Informationen finden Sie unter [Erstellen oder Aktualisieren einer kubeconfig-Datei für einen Amazon-EKS-Cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: Konfiguriert Ihr kubectl, indem Sie die kubeconfig erstellen oder aktualisieren (mit der Option role-arn, um eine Rolle für die Cluster-Authentifizierung zu übernehmen), sodass Sie eine Verbindung zu einem Amazon EKS-Cluster namens `` herstellen können my-eks-cluster** Im folgenden `update-kubeconfig` Beispiel wird Ihr kubectl konfiguriert, indem es die kubeconfig erstellt oder aktualisiert (mit der Option role-arn, um eine Rolle für die Cluster-Authentifizierung zu übernehmen), sodass Sie eine Verbindung zu einem Amazon EKS-Cluster mit dem Namen herstellen können. my-eks-cluster ``` aws eks update-kubeconfig \ --name my-eks-cluster \ --role-arn arn:aws:iam::111122223333:role/eksctl-EKS-Linux-Cluster-v1-24-cluster-ServiceRole-j1k7AfTIQtnM ``` Ausgabe: ``` Updated context arn:aws:eks:us-east-2:111122223333:cluster/my-eks-cluster in /Users/xxx/.kube/config ``` Weitere Informationen finden Sie unter [Erstellen oder Aktualisieren einer kubeconfig-Datei für einen Amazon-EKS-Cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 3: Konfiguriert Ihr kubectl, indem Sie die kubeconfig erstellen oder aktualisieren (mit der Option role-arn, um eine Rolle für die Cluster-Authentifizierung zusammen mit einem benutzerdefinierten Cluster-Alias und Benutzer-Alias zu übernehmen), sodass Sie eine Verbindung zu einem Amazon EKS-Cluster namens `` herstellen können my-eks-cluster** Im folgenden `update-kubeconfig` Beispiel wird Ihr kubectl konfiguriert, indem es die kubeconfig erstellt oder aktualisiert (mit der Option role-arn, um eine Rolle für die Clusterauthentifizierung zusammen mit einem benutzerdefinierten Cluster-Alias und Benutzer-Alias zu übernehmen), sodass Sie eine Verbindung zu einem Amazon EKS-Cluster mit dem Namen herstellen können. my-eks-cluster ``` aws eks update-kubeconfig \ --name my-eks-cluster \ --role-arn arn:aws:iam::111122223333:role/eksctl-EKS-Linux-Cluster-v1-24-cluster-ServiceRole-j1k7AfTIQtnM \ --alias stage-eks-cluster \ --user-alias john ``` Ausgabe: ``` Updated context stage-eks-cluster in /Users/dubaria/.kube/config ``` Weitere Informationen finden Sie unter [Erstellen oder Aktualisieren einer kubeconfig-Datei für einen Amazon-EKS-Cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 4: Druckt kubeconfig-Dateieinträge zur Überprüfung aus und konfiguriert Ihr kubectl so, dass Sie eine Verbindung zu einem Amazon EKS-Cluster namens `` herstellen können my-eks-cluster** Im folgenden `update-kubeconfig` Beispiel wird Ihr kubectl konfiguriert, indem es die kubeconfig erstellt oder aktualisiert (mit der Option role-arn, um eine Rolle für die Clusterauthentifizierung zusammen mit einem benutzerdefinierten Cluster-Alias und Benutzer-Alias zu übernehmen), sodass Sie eine Verbindung zu einem Amazon EKS-Cluster mit dem Namen herstellen können. my-eks-cluster ``` aws eks update-kubeconfig \ --name my-eks-cluster \ --role-arn arn:aws:iam::111122223333:role/eksctl-EKS-Linux-Cluster-v1-24-cluster-ServiceRole-j1k7AfTIQtnM \ --alias stage-eks-cluster \ --user-alias john \ --verbose ``` Ausgabe: ``` Updated context stage-eks-cluster in /Users/dubaria/.kube/config Entries: context: cluster: arn:aws:eks:us-east-2:111122223333:cluster/my-eks-cluster user: john name: stage-eks-cluster name: john user: exec: apiVersion: client.authentication.k8s.io/v1beta1 args: - --region - us-east-2 - eks - get-token - --cluster-name - my-eks-cluster - --output - json - --role - arn:aws:iam::111122223333:role/eksctl-EKS-Linux-Cluster-v1-24-cluster-ServiceRole-j1k7AfTIQtnM command: aws cluster: certificate-authority-data: xxx_CA_DATA_xxx server: https://DALSJ343KE23J3RN45653DSKJTT647TYD.yl4.us-east-2.eks.amazonaws.com name: arn:aws:eks:us-east-2:111122223333:cluster/my-eks-cluster ``` Weitere Informationen finden Sie unter [Erstellen oder Aktualisieren einer kubeconfig-Datei für einen Amazon-EKS-Cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html) im *Benutzerhandbuch für Amazon EKS*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [UpdateKubeconfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/update-kubeconfig.html)AWS CLI * ### `update-nodegroup-config` Das folgende Codebeispiel zeigt die Verwendung`update-nodegroup-config`. **AWS CLI** **Beispiel 1: Aktualisieren einer verwalteten Knotengruppe, um dem EKS-Worker-Knoten für einen Amazon-EKS-Cluster neue Labels und einen Taint hinzuzufügen** Im folgenden Beispiel für `update-nodegroup-config` wird eine verwaltete Knotengruppe aktualisiert, um dem EKS-Worker-Knoten für einen Amazon-EKS-Cluster neue Labels und einen Taint hinzuzufügen. ``` aws eks update-nodegroup-config \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup \ --labels 'addOrUpdateLabels={my-eks-nodegroup-label-1=value-1,my-eks-nodegroup-label-2=value-2}' \ --taints 'addOrUpdateTaints=[{key=taint-key-1,value=taint-value-1,effect=NO_EXECUTE}]' ``` Ausgabe: ``` { "update": { "id": "e66d21d3-bd8b-3ad1-a5aa-b196dc08c7c1", "status": "InProgress", "type": "ConfigUpdate", "params": [ { "type": "LabelsToAdd", "value": "{\"my-eks-nodegroup-label-2\":\"value-2\",\"my-eks-nodegroup-label-1\":\"value-1\"}" }, { "type": "TaintsToAdd", "value": "[{\"effect\":\"NO_EXECUTE\",\"value\":\"taint-value-1\",\"key\":\"taint-key-1\"}]" } ], "createdAt": "2024-04-08T12:05:19.161000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer verwalteten Knotengruppe](https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: Aktualisieren einer verwalteten Knotengruppe, um Labels und Taint vom EKS-Worker-Knoten für einen Amazon-EKS-Cluster zu entfernen** Im folgenden Beispiel für `update-nodegroup-config` wird eine verwaltete Knotengruppe aktualisiert, um Labels und Taint vom EKS-Worker-Knoten für einen Amazon-EKS-Cluster zu entfernen. ``` aws eks update-nodegroup-config \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup \ --labels 'removeLabels=my-eks-nodegroup-label-1, my-eks-nodegroup-label-2' \ --taints 'removeTaints=[{key=taint-key-1,value=taint-value-1,effect=NO_EXECUTE}]' ``` Ausgabe: ``` { "update": { "id": "67a08692-9e59-3ace-a916-13929f44cec3", "status": "InProgress", "type": "ConfigUpdate", "params": [ { "type": "LabelsToRemove", "value": "[\"my-eks-nodegroup-label-1\",\"my-eks-nodegroup-label-2\"]" }, { "type": "TaintsToRemove", "value": "[{\"effect\":\"NO_EXECUTE\",\"value\":\"taint-value-1\",\"key\":\"taint-key-1\"}]" } ], "createdAt": "2024-04-08T12:17:31.817000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer verwalteten Knotengruppe](https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 3: Aktualisieren einer verwalteten Knotengruppe, um Labels und Taint für den EKS-Worker-Knoten für einen Amazon-EKS-Cluster zu entfernen und hinzuzufügen** Im folgenden Beispiel für `update-nodegroup-config` wird eine verwaltete Knotengruppe aktualisiert, um Labels und Taint vom EKS-Worker-Knoten für einen Amazon-EKS-Cluster zu entfernen oder hinzuzufügen. ``` aws eks update-nodegroup-config \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup \ --labels 'addOrUpdateLabels={my-eks-nodegroup-new-label-1=new-value-1,my-eks-nodegroup-new-label-2=new-value-2},removeLabels=my-eks-nodegroup-label-1, my-eks-nodegroup-label-2' \ --taints 'addOrUpdateTaints=[{key=taint-new-key-1,value=taint-new-value-1,effect=PREFER_NO_SCHEDULE}],removeTaints=[{key=taint-key-1,value=taint-value-1,effect=NO_EXECUTE}]' ``` Ausgabe: ``` { "update": { "id": "4a9c8c45-6ac7-3115-be71-d6412a2339b7", "status": "InProgress", "type": "ConfigUpdate", "params": [ { "type": "LabelsToAdd", "value": "{\"my-eks-nodegroup-new-label-1\":\"new-value-1\",\"my-eks-nodegroup-new-label-2\":\"new-value-2\"}" }, { "type": "LabelsToRemove", "value": "[\"my-eks-nodegroup-label-1\",\"my-eks-nodegroup-label-2\"]" }, { "type": "TaintsToAdd", "value": "[{\"effect\":\"PREFER_NO_SCHEDULE\",\"value\":\"taint-new-value-1\",\"key\":\"taint-new-key-1\"}]" }, { "type": "TaintsToRemove", "value": "[{\"effect\":\"NO_EXECUTE\",\"value\":\"taint-value-1\",\"key\":\"taint-key-1\"}]" } ], "createdAt": "2024-04-08T12:30:55.486000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer verwalteten Knotengruppe](https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 4: Aktualisieren einer verwalteten Knotengruppe, um die Skalierungs- und die Aktualisierungskonfiguration für den EKS-Worker-Knoten für einen Amazon-EKS-Cluster zu aktualisieren** Im folgenden Beispiel für `update-nodegroup-config` wird eine verwaltete Knotengruppe aktualisiert, um die Skalierungs- und die Aktualisierungskonfiguration für den EKS-Worker-Knoten für einen Amazon-EKS-Cluster zu aktualisieren. ``` aws eks update-nodegroup-config \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup \ --scaling-config minSize=1,maxSize=5,desiredSize=2 \ --update-config maxUnavailable=2 ``` Ausgabe: ``` { "update": { "id": "a977160f-59bf-3023-805d-c9826e460aea", "status": "InProgress", "type": "ConfigUpdate", "params": [ { "type": "MinSize", "value": "1" }, { "type": "MaxSize", "value": "5" }, { "type": "DesiredSize", "value": "2" }, { "type": "MaxUnavailable", "value": "2" } ], "createdAt": "2024-04-08T12:35:17.036000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer verwalteten Knotengruppe](https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html) im *Benutzerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [UpdateNodegroupConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/update-nodegroup-config.html)in der *AWS CLI Befehlsreferenz*. ### `update-nodegroup-version` Das folgende Codebeispiel zeigt die Verwendung`update-nodegroup-version`. **AWS CLI** **Beispiel 1: Aktualisieren der Kubernetes-Version oder AMI-Version einer von Amazon EKS verwalteten Knotengruppe** Im folgenden Beispiel für `update-nodegroup-version` wird die Kubernetes-Version oder AMI-Version einer von Amazon EKS verwalteten Knotengruppe auf die neueste verfügbare Version für den Kubernetes-Cluster aktualisiert. ``` aws eks update-nodegroup-version \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup \ --no-force ``` Ausgabe: ``` { "update": { "id": "a94ebfc3-6bf8-307a-89e6-7dbaa36421f7", "status": "InProgress", "type": "VersionUpdate", "params": [ { "type": "Version", "value": "1.26" }, { "type": "ReleaseVersion", "value": "1.26.12-20240329" } ], "createdAt": "2024-04-08T13:16:00.724000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer verwalteten Knotengruppe](https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html) im *Benutzerhandbuch für Amazon EKS*. **Beispiel 2: Aktualisieren der Kubernetes-Version oder AMI-Version einer von Amazon EKS verwalteten Knotengruppe** Im folgenden Beispiel für `update-nodegroup-version` wird die Kubernetes-Version oder AMI-Version einer von Amazon EKS verwalteten Knotengruppe auf die angegebene AMI-Version aktualisiert. ``` aws eks update-nodegroup-version \ --cluster-name my-eks-cluster \ --nodegroup-name my-eks-nodegroup \ --kubernetes-version '1.26' \ --release-version '1.26.12-20240307' \ --no-force ``` Ausgabe: ``` { "update": { "id": "4db06fe1-088d-336b-bdcd-3fdb94995fb7", "status": "InProgress", "type": "VersionUpdate", "params": [ { "type": "Version", "value": "1.26" }, { "type": "ReleaseVersion", "value": "1.26.12-20240307" } ], "createdAt": "2024-04-08T13:13:58.595000-04:00", "errors": [] } } ``` Weitere Informationen finden Sie unter Aktualisieren einer verwalteten Knotengruppe - < https://docs.aws.amazon.com/eks/ latest/userguide/update - managed-node-group .html>` im *Amazon EKS-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [UpdateNodegroupVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/update-nodegroup-version.html)in AWS CLI der Befehlsreferenz.* ### `update-pod-identity-association` Das folgende Codebeispiel zeigt die Verwendung`update-pod-identity-association`. **AWS CLI** **So erstellen Sie eine EKS-Pod-Identity-Zuordnung** Im folgenden Beispiel für `update-pod-identity-association` wird eine EKS-Pod-Identity-Zuordnung aktualisiert, indem die zugehörige IAM-Rolle von `arn:aws:iam::111122223333:role/my-role` zu `arn:aws:iam::111122223333:role/s3-role` für die Zuordnungs-ID `a-9njjin9gfghecgocd` geändert wird. Über diese API kann nur die zugehörige IAM-Rolle aktualisiert werden. ``` aws eks update-pod-identity-association \ --cluster-name eks-customer \ --association-id a-9njjin9gfghecgocd \ --role-arn arn:aws:iam::111122223333:role/s3-role ``` Ausgabe: ``` { "association": { "clusterName": "eks-customer", "namespace": "default", "serviceAccount": "default", "roleArn": "arn:aws:iam::111122223333:role/s3-role", "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-9njjin9gfghecgocd", "associationId": "a-9njjin9gfghecgocd", "tags": { "Key2": "value2", "Key1": "value1" }, "createdAt": "2025-05-24T19:52:14.135000-05:00", "modifiedAt": "2025-05-25T21:01:53.120000-05:00" } } ``` Weitere Informationen finden [Sie im *Amazon EKS-Benutzerhandbuch* unter Erfahren Sie, wie EKS Pod Identity Pods Zugriff auf AWS Dienste gewährt](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html). + Einzelheiten zur API finden Sie [UpdatePodIdentityAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/eks/update-pod-identity-association.html)in der *AWS CLI Befehlsreferenz*. # Elastic Beanstalk Beanstalk-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Elastic Beanstalk Aktionen ausführen und gängige Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `abort-environment-update` Das folgende Codebeispiel zeigt, wie Sie. `abort-environment-update` **AWS CLI** **So brechen Sie eine Bereitstellung ab** Mit dem folgenden Befehl wird die Bereitstellung einer laufenden Anwendungsversion für eine Umgebung namens `my-env` abgebrochen: ``` aws elasticbeanstalk abort-environment-update --environment-name my-env ``` + Einzelheiten zur API finden Sie [AbortEnvironmentUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/abort-environment-update.html)in der *AWS CLI Befehlsreferenz*. ### `check-dns-availability` Das folgende Codebeispiel zeigt die Verwendung`check-dns-availability`. **AWS CLI** **So prüfen Sie die Verfügbarkeit eines CNAME** Im folgenden Befehl wird die Verfügbarkeit der Subdomain `my-cname.elasticbeanstalk.com` geprüft: ``` aws elasticbeanstalk check-dns-availability --cname-prefix my-cname ``` Ausgabe: ``` { "Available": true, "FullyQualifiedCNAME": "my-cname.elasticbeanstalk.com" } ``` + Einzelheiten zur API finden Sie [CheckDnsAvailability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/check-dns-availability.html)in der *AWS CLI Befehlsreferenz*. ### `create-application-version` Das folgende Codebeispiel zeigt die Verwendung`create-application-version`. **AWS CLI** **Um eine neue Anwendungsversion zu erstellen** Der folgende Befehl erstellt eine neue Version, „v1", einer Anwendung mit dem Namen" MyApp „: ``` aws elasticbeanstalk create-application-version --application-name MyApp --version-label v1 --description MyAppv1 --source-bundle S3Bucket="amzn-s3-demo-bucket",S3Key="sample.war" --auto-create-application ``` Die Anwendung wird aufgrund der auto-create-application Option automatisch erstellt, falls sie noch nicht existiert. Das Quellpaket ist eine .war-Datei, die in einem S3-Bucket namens „amzn-s3-demo-bucket“ gespeichert ist, der die Apache-Tomcat-Beispielanwendung enthält. Ausgabe: ``` { "ApplicationVersion": { "ApplicationName": "MyApp", "VersionLabel": "v1", "Description": "MyAppv1", "DateCreated": "2015-02-03T23:01:25.412Z", "DateUpdated": "2015-02-03T23:01:25.412Z", "SourceBundle": { "S3Bucket": "amzn-s3-demo-bucket", "S3Key": "sample.war" } } } ``` + Einzelheiten zur API finden Sie [CreateApplicationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-application-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-application` Das folgende Codebeispiel zeigt die Verwendung`create-application`. **AWS CLI** **Um eine neue Anwendung zu erstellen** Der folgende Befehl erstellt eine neue Anwendung mit dem Namen "MyApp„: ``` aws elasticbeanstalk create-application --application-name MyApp --description "my application" ``` Im Befehl `create-application` werden nur der Name und die Beschreibung der Anwendung konfiguriert. Um den Quellcode für die Anwendung hochzuladen, müssen Sie mit `create-application-version` eine erste Version der Anwendung erstellen. `create-application-version` hat auch eine `auto-create-application`-Option, mit der Sie die Anwendung und die Anwendungsversion in einem Schritt erstellen können. Ausgabe: ``` { "Application": { "ApplicationName": "MyApp", "ConfigurationTemplates": [], "DateUpdated": "2015-02-12T18:32:21.181Z", "Description": "my application", "DateCreated": "2015-02-12T18:32:21.181Z" } } ``` + Einzelheiten zur API finden Sie [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-application.html)in der *AWS CLI Befehlsreferenz*. ### `create-configuration-template` Das folgende Codebeispiel zeigt die Verwendung`create-configuration-template`. **AWS CLI** **So erstellen Sie eine Konfigurationsvorlage** Im folgenden Befehl wird eine Konfigurationsvorlage namens `my-app-v1` mit den Einstellungen erstellt, die auf eine Umgebung mit der ID `e-rpqsewtp2j` angewendet wurden: ``` aws elasticbeanstalk create-configuration-template --application-name my-app --template-name my-app-v1 --environment-id e-rpqsewtp2j ``` Ausgabe: ``` { "ApplicationName": "my-app", "TemplateName": "my-app-v1", "DateCreated": "2015-08-12T18:40:39Z", "DateUpdated": "2015-08-12T18:40:39Z", "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8" } ``` + Einzelheiten zur API finden Sie [CreateConfigurationTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-configuration-template.html)in der *AWS CLI Befehlsreferenz*. ### `create-environment` Das folgende Codebeispiel zeigt die Verwendung`create-environment`. **AWS CLI** **So erstellen Sie eine neue Umgebung für eine Anwendung** Im folgenden Befehl wird eine neue Umgebung für Version „v1“ einer Java-Anwendung namens „MyApp“ erstellt: ``` aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --cname-prefix my-app --version-label v1 --solution-stack-name "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8" ``` Ausgabe: ``` { "ApplicationName": "my-app", "EnvironmentName": "my-env", "VersionLabel": "v1", "Status": "Launching", "EnvironmentId": "e-izqpassy4h", "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", "CNAME": "my-app.elasticbeanstalk.com", "Health": "Grey", "Tier": { "Type": "Standard", "Name": "WebServer", "Version": " " }, "DateUpdated": "2015-02-03T23:04:54.479Z", "DateCreated": "2015-02-03T23:04:54.479Z" } ``` `v1`ist die Bezeichnung einer Anwendungsversion, mit der zuvor hochgeladen wurde create-application-version. **So geben Sie eine JSON-Datei zur Definition von Umgebungskonfigurationsoptionen an** Der folgende `create-environment`-Befehl gibt an, dass eine JSON-Datei namens `myoptions.json` verwendet werden soll, um Werte zu überschreiben, die aus dem Lösungs-Stack oder der Konfigurationsvorlage abgerufen wurden: ``` aws elasticbeanstalk create-environment --environment-name sample-env --application-name sampleapp --option-settings file://myoptions.json ``` `myoptions.json` ist ein JSON-Objekt, das mehrere Einstellungen definiert: ``` [ { "Namespace": "aws:elb:healthcheck", "OptionName": "Interval", "Value": "15" }, { "Namespace": "aws:elb:healthcheck", "OptionName": "Timeout", "Value": "8" }, { "Namespace": "aws:elb:healthcheck", "OptionName": "HealthyThreshold", "Value": "2" }, { "Namespace": "aws:elb:healthcheck", "OptionName": "UnhealthyThreshold", "Value": "3" } ] ``` Weitere Informationen finden Sie unter „Optionswerte“ im *Entwicklerhandbuch für AWS Elastic Beanstalk*. + Einzelheiten zur API finden Sie [CreateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-environment.html)in der *AWS CLI Befehlsreferenz*. ### `create-storage-location` Das folgende Codebeispiel zeigt die Verwendung`create-storage-location`. **AWS CLI** **So erstellen Sie einen Speicherort** Mit dem folgenden Befehl wird ein Speicherort in Amazon S3 erstellt: ``` aws elasticbeanstalk create-storage-location ``` Ausgabe: ``` { "S3Bucket": "elasticbeanstalk-us-west-2-0123456789012" } ``` + Einzelheiten zur API finden Sie [CreateStorageLocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-storage-location.html)in der *AWS CLI Befehlsreferenz*. ### `delete-application-version` Das folgende Codebeispiel zeigt die Verwendung`delete-application-version`. **AWS CLI** **Um eine Anwendungsversion zu löschen** Mit dem folgenden Befehl wird eine Anwendungsversion namens `22a0-stage-150819_182129` der Anwendung `my-app` gelöscht: ``` aws elasticbeanstalk delete-application-version --version-label 22a0-stage-150819_182129 --application-name my-app ``` + Einzelheiten zur API finden Sie [DeleteApplicationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/delete-application-version.html)in der *AWS CLI Befehlsreferenz*. ### `delete-application` Das folgende Codebeispiel zeigt die Verwendung`delete-application`. **AWS CLI** **So löschen Sie eine Anwendung** Der folgenden Befehl löscht eine Anwendung namens `my-app`: ``` aws elasticbeanstalk delete-application --application-name my-app ``` + Einzelheiten zur API finden Sie [DeleteApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/delete-application.html)in der *AWS CLI Befehlsreferenz*. ### `delete-configuration-template` Das folgende Codebeispiel zeigt die Verwendung`delete-configuration-template`. **AWS CLI** **So löschen Sie eine Konfigurationsvorlage** Mit dem folgenden Befehl wird eine Konfigurationsvorlage namens `my-template` für die Anwendung `my-app` gelöscht: ``` aws elasticbeanstalk delete-configuration-template --template-name my-template --application-name my-app ``` + Einzelheiten zur API finden Sie [DeleteConfigurationTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/delete-configuration-template.html)in der *AWS CLI Befehlsreferenz*. ### `delete-environment-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-environment-configuration`. **AWS CLI** **So löschen Sie einen Konfigurationsentwurf** Mit dem folgenden Befehl wird ein Konfigurationsentwurf für eine Umgebung namens `my-env` gelöscht: ``` aws elasticbeanstalk delete-environment-configuration --environment-name my-env --application-name my-app ``` + Einzelheiten zur API finden Sie [DeleteEnvironmentConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/delete-environment-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `describe-application-versions` Das folgende Codebeispiel zeigt die Verwendung`describe-application-versions`. **AWS CLI** **So zeigen Sie Informationen über eine Anwendungsversion an** Mit dem folgenden Befehl werden Informationen über eine Anwendungsversion mit der Bezeichnung `v2` abgerufen: ``` aws elasticbeanstalk describe-application-versions --application-name my-app --version-label "v2" ``` Ausgabe: ``` { "ApplicationVersions": [ { "ApplicationName": "my-app", "VersionLabel": "v2", "Description": "update cover page", "DateCreated": "2015-07-23T01:32:26.079Z", "DateUpdated": "2015-07-23T01:32:26.079Z", "SourceBundle": { "S3Bucket": "elasticbeanstalk-us-west-2-015321684451", "S3Key": "my-app/5026-stage-150723_224258.war" } }, { "ApplicationName": "my-app", "VersionLabel": "v1", "Description": "initial version", "DateCreated": "2015-07-23T22:26:10.816Z", "DateUpdated": "2015-07-23T22:26:10.816Z", "SourceBundle": { "S3Bucket": "elasticbeanstalk-us-west-2-015321684451", "S3Key": "my-app/5026-stage-150723_222618.war" } } ] } ``` + Einzelheiten zur API finden Sie [DescribeApplicationVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-application-versions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-applications` Das folgende Codebeispiel zeigt die Verwendung`describe-applications`. **AWS CLI** **So zeigen Sie eine Liste von Anwendungen an** Mit dem folgenden Befehl werden Informationen über Anwendungen in der aktuellen Region abgerufen: ``` aws elasticbeanstalk describe-applications ``` Ausgabe: ``` { "Applications": [ { "ApplicationName": "ruby", "ConfigurationTemplates": [], "DateUpdated": "2015-08-13T21:05:44.376Z", "Versions": [ "Sample Application" ], "DateCreated": "2015-08-13T21:05:44.376Z" }, { "ApplicationName": "pythonsample", "Description": "Application created from the EB CLI using \"eb init\"", "Versions": [ "Sample Application" ], "DateCreated": "2015-08-13T19:05:43.637Z", "ConfigurationTemplates": [], "DateUpdated": "2015-08-13T19:05:43.637Z" }, { "ApplicationName": "nodejs-example", "ConfigurationTemplates": [], "DateUpdated": "2015-08-06T17:50:02.486Z", "Versions": [ "add elasticache", "First Release" ], "DateCreated": "2015-08-06T17:50:02.486Z" } ] } ``` + Einzelheiten zur API finden Sie [DescribeApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-applications.html)in der *AWS CLI Befehlsreferenz*. ### `describe-configuration-options` Das folgende Codebeispiel zeigt die Verwendung`describe-configuration-options`. **AWS CLI** **So zeigen Sie Konfigurationsoptionen für eine Umgebung an** Mit dem folgenden Befehl werden Beschreibungen aller verfügbaren Konfigurationsoptionen für eine Umgebung namens `my-env` abgerufen: ``` aws elasticbeanstalk describe-configuration-options --environment-name my-env --application-name my-app ``` Ausgabe (gekürzt): ``` { "Options": [ { "Name": "JVMOptions", "UserDefined": false, "DefaultValue": "Xms=256m,Xmx=256m,XX:MaxPermSize=64m,JVM Options=", "ChangeSeverity": "RestartApplicationServer", "Namespace": "aws:cloudformation:template:parameter", "ValueType": "KeyValueList" }, { "Name": "Interval", "UserDefined": false, "DefaultValue": "30", "ChangeSeverity": "NoInterruption", "Namespace": "aws:elb:healthcheck", "MaxValue": 300, "MinValue": 5, "ValueType": "Scalar" }, ... { "Name": "LowerThreshold", "UserDefined": false, "DefaultValue": "2000000", "ChangeSeverity": "NoInterruption", "Namespace": "aws:autoscaling:trigger", "MinValue": 0, "ValueType": "Scalar" }, { "Name": "ListenerEnabled", "UserDefined": false, "DefaultValue": "true", "ChangeSeverity": "Unknown", "Namespace": "aws:elb:listener", "ValueType": "Boolean" } ] } ``` Die verfügbaren Konfigurationsoptionen variieren je nach Plattform und Konfigurationsversion. Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im *Entwicklerhandbuch für AWS Elastic Beanstalk*. + Einzelheiten zur API finden Sie [DescribeConfigurationOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-configuration-options.html)in der *AWS CLI Befehlsreferenz*. ### `describe-configuration-settings` Das folgende Codebeispiel zeigt die Verwendung`describe-configuration-settings`. **AWS CLI** **So zeigen Sie Konfigurationseinstellungen für eine Umgebung an** Mit dem folgenden Befehl werden Konfigurationseinstellungen für eine Umgebung namens `my-env` abgerufen: ``` aws elasticbeanstalk describe-configuration-settings --environment-name my-env --application-name my-app ``` Ausgabe (gekürzt): ``` { "ConfigurationSettings": [ { "ApplicationName": "my-app", "EnvironmentName": "my-env", "Description": "Environment created from the EB CLI using \"eb create\"", "DeploymentStatus": "deployed", "DateCreated": "2015-08-13T19:16:25Z", "OptionSettings": [ { "OptionName": "Availability Zones", "ResourceName": "AWSEBAutoScalingGroup", "Namespace": "aws:autoscaling:asg", "Value": "Any" }, { "OptionName": "Cooldown", "ResourceName": "AWSEBAutoScalingGroup", "Namespace": "aws:autoscaling:asg", "Value": "360" }, ... { "OptionName": "ConnectionDrainingTimeout", "ResourceName": "AWSEBLoadBalancer", "Namespace": "aws:elb:policies", "Value": "20" }, { "OptionName": "ConnectionSettingIdleTimeout", "ResourceName": "AWSEBLoadBalancer", "Namespace": "aws:elb:policies", "Value": "60" } ], "DateUpdated": "2015-08-13T23:30:07Z", "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8" } ] } ``` Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im *Entwicklerhandbuch für AWS Elastic Beanstalk*. + Einzelheiten zur API finden Sie [DescribeConfigurationSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-configuration-settings.html)in der *AWS CLI Befehlsreferenz*. ### `describe-environment-health` Das folgende Codebeispiel zeigt die Verwendung`describe-environment-health`. **AWS CLI** **So zeigen Sie den Zustand einer Umgebung an** Mit dem folgenden Befehl werden allgemeine Zustandsinformationen für eine Umgebung namens `my-env` abgerufen: ``` aws elasticbeanstalk describe-environment-health --environment-name my-env --attribute-names All ``` Ausgabe: ``` { "Status": "Ready", "EnvironmentName": "my-env", "Color": "Green", "ApplicationMetrics": { "Duration": 10, "Latency": { "P99": 0.004, "P75": 0.002, "P90": 0.003, "P95": 0.004, "P85": 0.003, "P10": 0.001, "P999": 0.004, "P50": 0.001 }, "RequestCount": 45, "StatusCodes": { "Status3xx": 0, "Status2xx": 45, "Status5xx": 0, "Status4xx": 0 } }, "RefreshedAt": "2015-08-20T21:09:18Z", "HealthStatus": "Ok", "InstancesHealth": { "Info": 0, "Ok": 1, "Unknown": 0, "Severe": 0, "Warning": 0, "Degraded": 0, "NoData": 0, "Pending": 0 }, "Causes": [] } ``` Zustandsinformationen sind nur für Umgebungen verfügbar, bei denen erweiterte Zustandsberichte aktiviert sind. Weitere Informationen finden Sie unter „Erweiterte Zustandsberichte und Überwachung“ im *Entwicklerhandbuch für AWS Elastic Beanstalk*. + Einzelheiten zur API finden Sie [DescribeEnvironmentHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-environment-health.html)in der *AWS CLI Befehlsreferenz*. ### `describe-environment-resources` Das folgende Codebeispiel zeigt die Verwendung`describe-environment-resources`. **AWS CLI** **Um Informationen zu den AWS Ressourcen in Ihrer Umgebung anzuzeigen** Mit dem folgenden Befehl werden Informationen über Ressourcen in einer Umgebung namens `my-env` abgerufen: ``` aws elasticbeanstalk describe-environment-resources --environment-name my-env ``` Ausgabe: ``` { "EnvironmentResources": { "EnvironmentName": "my-env", "AutoScalingGroups": [ { "Name": "awseb-e-qu3fyyjyjs-stack-AWSEBAutoScalingGroup-QSB2ZO88SXZT" } ], "Triggers": [], "LoadBalancers": [ { "Name": "awseb-e-q-AWSEBLoa-1EEPZ0K98BIF0" } ], "Queues": [], "Instances": [ { "Id": "i-0c91c786" } ], "LaunchConfigurations": [ { "Name": "awseb-e-qu3fyyjyjs-stack-AWSEBAutoScalingLaunchConfiguration-1UUVQIBC96TQ2" } ] } } ``` + Einzelheiten zur API finden Sie [DescribeEnvironmentResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-environment-resources.html)in der *AWS CLI Befehlsreferenz*. ### `describe-environments` Das folgende Codebeispiel zeigt die Verwendung`describe-environments`. **AWS CLI** **So zeigen Sie Informationen über eine Umgebung an** Mit dem folgenden Befehl werden Informationen über eine Umgebung namens `my-env` abgerufen: ``` aws elasticbeanstalk describe-environments --environment-names my-env ``` Ausgabe: ``` { "Environments": [ { "ApplicationName": "my-app", "EnvironmentName": "my-env", "VersionLabel": "7f58-stage-150812_025409", "Status": "Ready", "EnvironmentId": "e-rpqsewtp2j", "EndpointURL": "awseb-e-w-AWSEBLoa-1483140XB0Q4L-109QXY8121.us-west-2.elb.amazonaws.com", "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", "CNAME": "my-env.elasticbeanstalk.com", "Health": "Green", "AbortableOperationInProgress": false, "Tier": { "Version": " ", "Type": "Standard", "Name": "WebServer" }, "DateUpdated": "2015-08-12T18:16:55.019Z", "DateCreated": "2015-08-07T20:48:49.599Z" } ] } ``` + Einzelheiten zur API finden Sie [DescribeEnvironments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-environments.html)in der *AWS CLI Befehlsreferenz*. ### `describe-events` Das folgende Codebeispiel zeigt die Verwendung`describe-events`. **AWS CLI** **So zeigen Sie Ereignisse für eine Umgebung an** Mit dem folgenden Befehl werden Ereignisse für eine Umgebung namens `my-env` abgerufen: ``` aws elasticbeanstalk describe-events --environment-name my-env ``` Ausgabe (gekürzt): ``` { "Events": [ { "ApplicationName": "my-app", "EnvironmentName": "my-env", "Message": "Environment health has transitioned from Info to Ok.", "EventDate": "2015-08-20T07:06:53.535Z", "Severity": "INFO" }, { "ApplicationName": "my-app", "EnvironmentName": "my-env", "Severity": "INFO", "RequestId": "b7f3960b-4709-11e5-ba1e-07e16200da41", "Message": "Environment update completed successfully.", "EventDate": "2015-08-20T07:06:02.049Z" }, ... { "ApplicationName": "my-app", "EnvironmentName": "my-env", "Severity": "INFO", "RequestId": "ca8dfbf6-41ef-11e5-988b-651aa638f46b", "Message": "Using elasticbeanstalk-us-west-2-012445113685 as Amazon S3 storage bucket for environment data.", "EventDate": "2015-08-13T19:16:27.561Z" }, { "ApplicationName": "my-app", "EnvironmentName": "my-env", "Severity": "INFO", "RequestId": "cdfba8f6-41ef-11e5-988b-65638f41aa6b", "Message": "createEnvironment is starting.", "EventDate": "2015-08-13T19:16:26.581Z" } ] } ``` + Einzelheiten zur API finden Sie [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-events.html)in der *AWS CLI Befehlsreferenz*. ### `describe-instances-health` Das folgende Codebeispiel zeigt die Verwendung`describe-instances-health`. **AWS CLI** **So zeigen Sie den Zustand einer Umgebung an** Der folgende Befehl ruft Zustandsinformationen für Instances in einer Umgebung namens `my-env` ab: ``` aws elasticbeanstalk describe-instances-health --environment-name my-env --attribute-names All ``` Ausgabe: ``` { "InstanceHealthList": [ { "InstanceId": "i-08691cc7", "ApplicationMetrics": { "Duration": 10, "Latency": { "P99": 0.006, "P75": 0.002, "P90": 0.004, "P95": 0.005, "P85": 0.003, "P10": 0.0, "P999": 0.006, "P50": 0.001 }, "RequestCount": 48, "StatusCodes": { "Status3xx": 0, "Status2xx": 47, "Status5xx": 0, "Status4xx": 1 } }, "System": { "LoadAverage": [ 0.0, 0.02, 0.05 ], "CPUUtilization": { "SoftIRQ": 0.1, "IOWait": 0.2, "System": 0.3, "Idle": 97.8, "User": 1.5, "IRQ": 0.0, "Nice": 0.1 } }, "Color": "Green", "HealthStatus": "Ok", "LaunchedAt": "2015-08-13T19:17:09Z", "Causes": [] } ], "RefreshedAt": "2015-08-20T21:09:08Z" } ``` Zustandsinformationen sind nur für Umgebungen verfügbar, bei denen erweiterte Zustandsberichte aktiviert sind. Weitere Informationen finden Sie unter „Erweiterte Zustandsberichte und Überwachung“ im *Entwicklerhandbuch für AWS Elastic Beanstalk*. + Einzelheiten zur API finden Sie [DescribeInstancesHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-instances-health.html)in der *AWS CLI Befehlsreferenz*. ### `list-available-solution-stacks` Das folgende Codebeispiel zeigt die Verwendung`list-available-solution-stacks`. **AWS CLI** **So zeigen Sie Lösungs-Stacks an** Mit dem folgenden Befehl werden Lösungs-Stacks für alle derzeit verfügbaren und alle in der Vergangenheit verwendeten Plattformkonfigurationen aufgerufen: ``` aws elasticbeanstalk list-available-solution-stacks ``` Ausgabe (gekürzt): ``` { "SolutionStacks": [ "64bit Amazon Linux 2015.03 v2.0.0 running Node.js", "64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.6", "64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.5", "64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.4", "64bit Amazon Linux 2015.03 v2.0.0 running Python 3.4", "64bit Amazon Linux 2015.03 v2.0.0 running Python 2.7", "64bit Amazon Linux 2015.03 v2.0.0 running Python", "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Puma)", "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Passenger Standalone)", "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.1 (Puma)", "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.1 (Passenger Standalone)", "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.0 (Puma)", "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.0 (Passenger Standalone)", "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 1.9.3", "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 7 Java 7", "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 7 Java 6", "64bit Windows Server Core 2012 R2 running IIS 8.5", "64bit Windows Server 2012 R2 running IIS 8.5", "64bit Windows Server 2012 running IIS 8", "64bit Windows Server 2008 R2 running IIS 7.5", "64bit Amazon Linux 2015.03 v2.0.0 running Docker 1.6.2", "64bit Amazon Linux 2015.03 v2.0.0 running Multi-container Docker 1.6.2 (Generic)", "64bit Debian jessie v2.0.0 running GlassFish 4.1 Java 8 (Preconfigured - Docker)", "64bit Debian jessie v2.0.0 running GlassFish 4.0 Java 7 (Preconfigured - Docker)", "64bit Debian jessie v2.0.0 running Go 1.4 (Preconfigured - Docker)", "64bit Debian jessie v2.0.0 running Go 1.3 (Preconfigured - Docker)", "64bit Debian jessie v2.0.0 running Python 3.4 (Preconfigured - Docker)", ], "SolutionStackDetails": [ { "PermittedFileTypes": [ "zip" ], "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Node.js" }, ... ] } ``` + Einzelheiten zur API finden Sie [ListAvailableSolutionStacks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/list-available-solution-stacks.html)in der *AWS CLI Befehlsreferenz*. ### `rebuild-environment` Das folgende Codebeispiel zeigt die Verwendung`rebuild-environment`. **AWS CLI** **So bauen Sie eine Umgebung wieder auf** Mit dem folgenden Befehl werden die Ressourcen in einer Umgebung namens `my-env` beendet und neu erstellt: ``` aws elasticbeanstalk rebuild-environment --environment-name my-env ``` + Einzelheiten zur API finden Sie [RebuildEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/rebuild-environment.html)in der *AWS CLI Befehlsreferenz*. ### `request-environment-info` Das folgende Codebeispiel zeigt die Verwendung`request-environment-info`. **AWS CLI** **So fordern Sie detaillierte Protokolle an** Mit dem folgenden Befehl werden Protokolle aus einer Umgebung namens `my-env` angefordert: ``` aws elasticbeanstalk request-environment-info --environment-name my-env --info-type tail ``` Rufen Sie nach dem Anfordern von Protokollen deren Standort mit ab retrieve-environment-info. + Einzelheiten zur API finden Sie [RequestEnvironmentInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/request-environment-info.html)in der *AWS CLI Befehlsreferenz*. ### `restart-app-server` Das folgende Codebeispiel zeigt die Verwendung`restart-app-server`. **AWS CLI** **So starten Sie Anwendungsserver neu** Mit dem folgenden Befehl werden Anwendungsserver auf allen Instances in einer Umgebung namens `my-env` neu gestartet: ``` aws elasticbeanstalk restart-app-server --environment-name my-env ``` + Einzelheiten zur API finden Sie [RestartAppServer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/restart-app-server.html)in der *AWS CLI Befehlsreferenz*. ### `retrieve-environment-info` Das folgende Codebeispiel zeigt die Verwendung`retrieve-environment-info`. **AWS CLI** **So rufen Sie Tail-Protokolle ab** Mit dem folgenden Befehl wird ein Link zu Protokollen aus einer Umgebung namens `my-env` abgerufen: ``` aws elasticbeanstalk retrieve-environment-info --environment-name my-env --info-type tail ``` Ausgabe: ``` { "EnvironmentInfo": [ { "SampleTimestamp": "2015-08-20T22:23:17.703Z", "Message": "https://elasticbeanstalk-us-west-2-0123456789012.s3.amazonaws.com/resources/environments/logs/tail/e-fyqyju3yjs/i-09c1c867/TailLogs-1440109397703.out?AWSAccessKeyId=AKGPT4J56IAJ2EUBL5CQ&Expires=1440195891&Signature=n%2BEalOV6A2HIOx4Rcfb7LT16bBM%3D", "InfoType": "tail", "Ec2InstanceId": "i-09c1c867" } ] } ``` Sehen Sie sich den Link in einem Browser an. Vor dem Abrufen müssen Protokolle mit request-environment-info angefordert werden. + Einzelheiten zur API finden Sie [RetrieveEnvironmentInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/retrieve-environment-info.html)in der *AWS CLI Befehlsreferenz.* ### `swap-environment-cnames` Das folgende Codebeispiel zeigt die Verwendung`swap-environment-cnames`. **AWS CLI** **So tauschen Sie die CNAMES von Umgebungen aus** Mit dem folgenden Befehl werden die zugewiesenen Subdomains zweier Umgebungen ausgetauscht: ``` aws elasticbeanstalk swap-environment-cnames --source-environment-name my-env-blue --destination-environment-name my-env-green ``` + Einzelheiten zur API finden Sie [SwapEnvironmentCnames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/swap-environment-cnames.html)in der *AWS CLI Befehlsreferenz*. ### `terminate-environment` Das folgende Codebeispiel zeigt die Verwendung`terminate-environment`. **AWS CLI** **Um eine Umgebung zu beenden** Mit dem folgenden Befehl wird eine Elastic-Beanstalk-Umgebung namens `my-env` beendet: ``` aws elasticbeanstalk terminate-environment --environment-name my-env ``` Ausgabe: ``` { "ApplicationName": "my-app", "EnvironmentName": "my-env", "Status": "Terminating", "EnvironmentId": "e-fh2eravpns", "EndpointURL": "awseb-e-f-AWSEBLoa-1I9XUMP4-8492WNUP202574.us-west-2.elb.amazonaws.com", "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", "CNAME": "my-env.elasticbeanstalk.com", "Health": "Grey", "AbortableOperationInProgress": false, "Tier": { "Version": " ", "Type": "Standard", "Name": "WebServer" }, "DateUpdated": "2015-08-12T19:05:54.744Z", "DateCreated": "2015-08-12T18:52:53.622Z" } ``` + Einzelheiten zur API finden Sie [TerminateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/terminate-environment.html)in der *AWS CLI Befehlsreferenz*. ### `update-application-version` Das folgende Codebeispiel zeigt die Verwendung`update-application-version`. **AWS CLI** **So ändern Sie die Beschreibung einer Anwendungsversion** Mit dem folgenden Befehl wird die Beschreibung einer Anwendungsversion namens `22a0-stage-150819_185942` aktualisiert: ``` aws elasticbeanstalk update-application-version --version-label 22a0-stage-150819_185942 --application-name my-app --description "new description" ``` Ausgabe: ``` { "ApplicationVersion": { "ApplicationName": "my-app", "VersionLabel": "22a0-stage-150819_185942", "Description": "new description", "DateCreated": "2015-08-19T18:59:17.646Z", "DateUpdated": "2015-08-20T22:53:28.871Z", "SourceBundle": { "S3Bucket": "elasticbeanstalk-us-west-2-0123456789012", "S3Key": "my-app/22a0-stage-150819_185942.war" } } } ``` + Einzelheiten zur API finden Sie [UpdateApplicationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/update-application-version.html)in der *AWS CLI Befehlsreferenz*. ### `update-application` Das folgende Codebeispiel zeigt die Verwendung`update-application`. **AWS CLI** **So ändern Sie die Beschreibung einer Anwendung** Mit dem folgenden Befehl wird die Beschreibung einer Anwendung namens `my-app` aktualisiert: ``` aws elasticbeanstalk update-application --application-name my-app --description "my Elastic Beanstalk application" ``` Ausgabe: ``` { "Application": { "ApplicationName": "my-app", "Description": "my Elastic Beanstalk application", "Versions": [ "2fba-stage-150819_234450", "bf07-stage-150820_214945", "93f8", "fd7c-stage-150820_000431", "22a0-stage-150819_185942" ], "DateCreated": "2015-08-13T19:15:50.449Z", "ConfigurationTemplates": [], "DateUpdated": "2015-08-20T22:34:56.195Z" } } ``` + Einzelheiten zur API finden Sie [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/update-application.html)in der *AWS CLI Befehlsreferenz*. ### `update-configuration-template` Das folgende Codebeispiel zeigt die Verwendung`update-configuration-template`. **AWS CLI** **So aktualisieren Sie eine Konfigurationsvorlage** Der folgende Befehl entfernt die konfigurierte Konfiguration für CloudWatch benutzerdefinierte Integritätsmetriken `ConfigDocument` aus einer gespeicherten Konfigurationsvorlage mit dem Namen`my-template`: ``` aws elasticbeanstalk update-configuration-template --template-name my-template --application-name my-app --options-to-remove Namespace=aws:elasticbeanstalk:healthreporting:system,OptionName=ConfigDocument ``` Ausgabe: ``` { "ApplicationName": "my-app", "TemplateName": "my-template", "DateCreated": "2015-08-20T22:39:31Z", "DateUpdated": "2015-08-20T22:43:11Z", "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8" } ``` Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im *Entwicklerhandbuch für AWS Elastic Beanstalk*. + Einzelheiten zur API finden Sie [UpdateConfigurationTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/update-configuration-template.html)in der *AWS CLI Befehlsreferenz*. ### `update-environment` Das folgende Codebeispiel zeigt die Verwendung`update-environment`. **AWS CLI** **So aktualisieren Sie eine Umgebung auf eine neue Version** Mit dem folgenden Befehl wird eine Umgebung namens „my-env“ auf Version „v2“ der Anwendung aktualisiert, zu der sie gehört: ``` aws elasticbeanstalk update-environment --environment-name my-env --version-label v2 ``` Dieser Befehl setzt voraus, dass die Umgebung „my-env“ bereits existiert und zu einer Anwendung gehört, die über eine gültige Anwendungsversion mit der Bezeichnung „v2“ verfügt. Ausgabe: ``` { "ApplicationName": "my-app", "EnvironmentName": "my-env", "VersionLabel": "v2", "Status": "Updating", "EnvironmentId": "e-szqipays4h", "EndpointURL": "awseb-e-i-AWSEBLoa-1RDLX6TC9VUAO-0123456789.us-west-2.elb.amazonaws.com", "SolutionStackName": "64bit Amazon Linux running Tomcat 7", "CNAME": "my-env.elasticbeanstalk.com", "Health": "Grey", "Tier": { "Version": " ", "Type": "Standard", "Name": "WebServer" }, "DateUpdated": "2015-02-03T23:12:29.119Z", "DateCreated": "2015-02-03T23:04:54.453Z" } ``` **So stellen Sie eine Umgebungsvariable ein** Der folgende Befehl setzt den Wert der Variablen "PARAM1" in der Umgebung „my-env“ auf ": ParamValue ``` aws elasticbeanstalk update-environment --environment-name my-env --option-settings Namespace=aws:elasticbeanstalk:application:environment,OptionName=PARAM1,Value=ParamValue ``` Der Parameter `option-settings` benötigt zusätzlich zum Namen und Wert der Variablen einen Namespace. Elastic Beanstalk unterstützt neben Umgebungsvariablen auch mehrere Namespaces für Optionen. **So konfigurieren Sie Optionseinstellungen mit einer Datei** Mit dem folgenden Befehl werden mehrere Optionen im Namespace `aws:elb:loadbalancer` mit einer Datei konfiguriert: ``` aws elasticbeanstalk update-environment --environment-name my-env --option-settings file://options.json ``` `options.json` ist ein JSON-Objekt, das mehrere Einstellungen definiert: ``` [ { "Namespace": "aws:elb:healthcheck", "OptionName": "Interval", "Value": "15" }, { "Namespace": "aws:elb:healthcheck", "OptionName": "Timeout", "Value": "8" }, { "Namespace": "aws:elb:healthcheck", "OptionName": "HealthyThreshold", "Value": "2" }, { "Namespace": "aws:elb:healthcheck", "OptionName": "UnhealthyThreshold", "Value": "3" } ] ``` Ausgabe: ``` { "ApplicationName": "my-app", "EnvironmentName": "my-env", "VersionLabel": "7f58-stage-150812_025409", "Status": "Updating", "EnvironmentId": "e-wtp2rpqsej", "EndpointURL": "awseb-e-w-AWSEBLoa-14XB83101Q4L-104QXY80921.sa-east-1.elb.amazonaws.com", "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", "CNAME": "my-env.elasticbeanstalk.com", "Health": "Grey", "AbortableOperationInProgress": true, "Tier": { "Version": " ", "Type": "Standard", "Name": "WebServer" }, "DateUpdated": "2015-08-12T18:15:23.804Z", "DateCreated": "2015-08-07T20:48:49.599Z" } ``` Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im *Entwicklerhandbuch für AWS Elastic Beanstalk*. + Einzelheiten zur API finden Sie [UpdateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/update-environment.html)in der *AWS CLI Befehlsreferenz*. ### `validate-configuration-settings` Das folgende Codebeispiel zeigt die Verwendung`validate-configuration-settings`. **AWS CLI** **So validieren Sie Konfigurationseinstellungen** Der folgende Befehl validiert ein Konfigurationsdokument für CloudWatch benutzerdefinierte Metriken: ``` aws elasticbeanstalk validate-configuration-settings --application-name my-app --environment-name my-env --option-settings file://options.json ``` `options.json` ist ein JSON-Dokument, das eine oder mehrere zu validierende Konfigurationseinstellungen enthält: ``` [ { "Namespace": "aws:elasticbeanstalk:healthreporting:system", "OptionName": "ConfigDocument", "Value": "{\"CloudWatchMetrics\": {\"Environment\": {\"ApplicationLatencyP99.9\": null,\"InstancesSevere\": 60,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": 60,\"InstancesUnknown\": 60,\"ApplicationLatencyP85\": 60,\"InstancesInfo\": null,\"ApplicationRequests2xx\": null,\"InstancesDegraded\": null,\"InstancesWarning\": 60,\"ApplicationLatencyP50\": 60,\"ApplicationRequestsTotal\": null,\"InstancesNoData\": null,\"InstancesPending\": 60,\"ApplicationLatencyP10\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": null,\"InstancesOk\": 60,\"ApplicationRequests3xx\": null,\"ApplicationRequests4xx\": null},\"Instance\": {\"ApplicationLatencyP99.9\": null,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": null,\"ApplicationLatencyP85\": null,\"CPUUser\": 60,\"ApplicationRequests2xx\": null,\"CPUIdle\": null,\"ApplicationLatencyP50\": null,\"ApplicationRequestsTotal\": 60,\"RootFilesystemUtil\": null,\"LoadAverage1min\": null,\"CPUIrq\": null,\"CPUNice\": 60,\"CPUIowait\": 60,\"ApplicationLatencyP10\": null,\"LoadAverage5min\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": 60,\"CPUSystem\": 60,\"ApplicationRequests3xx\": 60,\"ApplicationRequests4xx\": null,\"InstanceHealth\": null,\"CPUSoftirq\": 60}},\"Version\": 1}" } ] ``` Wenn die von Ihnen angegebenen Optionen für die genannte Umgebung gültig sind, gibt Elastic Beanstalk ein leeres Messages-Array zurück: ``` { "Messages": [] } ``` Wenn die Validierung fehlschlägt, enthält die Antwort Informationen über den Fehler: ``` { "Messages": [ { "OptionName": "ConfigDocumet", "Message": "Invalid option specification (Namespace: 'aws:elasticbeanstalk:healthreporting:system', OptionName: 'ConfigDocumet'): Unknown configuration setting.", "Namespace": "aws:elasticbeanstalk:healthreporting:system", "Severity": "error" } ] } ``` Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im *Entwicklerhandbuch für AWS Elastic Beanstalk*. + Einzelheiten zur API finden Sie [ValidateConfigurationSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/validate-configuration-settings.html)in der *AWS CLI Befehlsreferenz.* # Elastic Load Balancing — Version 1, Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Elastic Load Balancing — Version 1 Aktionen ausführen und gängige Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-tags` Das folgende Codebeispiel zeigt, wie Sie`add-tags`. **AWS CLI** **So fügen Sie einem Load Balancer ein Tag hinzu** In diesem Beispiel werden dem angegebenen Load Balancer Tags hinzugefügt. Befehl: ``` aws elb add-tags --load-balancer-name my-load-balancer --tags "Key=project,Value=lima" "Key=department,Value=digital-media" ``` + Einzelheiten zur API finden Sie [AddTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/add-tags.html)in der *AWS CLI Befehlsreferenz*. ### `apply-security-groups-to-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`apply-security-groups-to-load-balancer`. **AWS CLI** **So ordnen Sie einem Load Balancer in einer VPC eine Sicherheitsgruppe zu** In diesem Beispiel wird dem angegebenen Load Balancer in einer VPC eine Sicherheitsgruppe zugeordnet. Befehl: ``` aws elb apply-security-groups-to-load-balancer --load-balancer-name my-load-balancer --security-groups sg-fc448899 ``` Ausgabe: ``` { "SecurityGroups": [ "sg-fc448899" ] } ``` + Einzelheiten zur API finden Sie [ApplySecurityGroupsToLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/apply-security-groups-to-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `attach-load-balancer-to-subnets` Das folgende Codebeispiel zeigt die Verwendung`attach-load-balancer-to-subnets`. **AWS CLI** **So fügen Sie einem Load Balancer Subnetze hinzu** In diesem Beispiel wird das angegebene Subnetz den bereits konfigurierten Subnetzen für den entsprechenden Load Balancer hinzugefügt. Befehl: ``` aws elb attach-load-balancer-to-subnets --load-balancer-name my-load-balancer --subnets subnet-0ecac448 ``` Ausgabe: ``` { "Subnets": [ "subnet-15aaab61", "subnet-0ecac448" ] } ``` + Einzelheiten zur API finden Sie [AttachLoadBalancerToSubnets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/attach-load-balancer-to-subnets.html)in der *AWS CLI Befehlsreferenz*. ### `configure-health-check` Das folgende Codebeispiel zeigt die Verwendung`configure-health-check`. **AWS CLI** **So geben Sie die Einstellungen für die Zustandsprüfungen für EC2-Backend-Instances an** In diesem Beispiel werden die Einstellungen für die Zustandsprüfungen angegeben, die zum Bewerten des Zustands von EC2-Instances im Backend verwenden werden. Befehl: ``` aws elb configure-health-check --load-balancer-name my-load-balancer --health-check Target=HTTP:80/png,Interval=30,UnhealthyThreshold=2,HealthyThreshold=2,Timeout=3 ``` Ausgabe: ``` { "HealthCheck": { "HealthyThreshold": 2, "Interval": 30, "Target": "HTTP:80/png", "Timeout": 3, "UnhealthyThreshold": 2 } } ``` + Einzelheiten zur API finden Sie [ConfigureHealthCheck](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/configure-health-check.html)in der *AWS CLI Befehlsreferenz*. ### `create-app-cookie-stickiness-policy` Das folgende Codebeispiel zeigt die Verwendung`create-app-cookie-stickiness-policy`. **AWS CLI** **So generieren Sie eine Stickiness-Richtlinie für Ihren HTTPS-Load-Balancer** In diesem Beispiel wird eine Stickiness-Richtlinie generiert, die den Gültigkeitsdauerwerten für Sticky Sessions des anwendungsgenerierten Cookies entspricht. Befehl: ``` aws elb create-app-cookie-stickiness-policy --load-balancer-name my-load-balancer --policy-name my-app-cookie-policy --cookie-name my-app-cookie ``` + Einzelheiten zur API finden Sie [CreateAppCookieStickinessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-app-cookie-stickiness-policy.html)in der *AWS CLI Befehlsreferenz*. ### `create-lb-cookie-stickiness-policy` Das folgende Codebeispiel zeigt die Verwendung`create-lb-cookie-stickiness-policy`. **AWS CLI** **So generieren Sie eine auf Dauer basierende Stickiness-Richtlinie für Ihren HTTPS-Load-Balancer** In diesem Beispiel wird eine Stickiness-Richtlinie mit Gültigkeitsdauerwerten für Sticky Sessions generiert, die von der festgelegten Ablaufzeit abhängig sind. Befehl: ``` aws elb create-lb-cookie-stickiness-policy --load-balancer-name my-load-balancer --policy-name my-duration-cookie-policy --cookie-expiration-period 60 ``` + Einzelheiten zur API finden Sie [CreateLbCookieStickinessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-lb-cookie-stickiness-policy.html)in der *AWS CLI Befehlsreferenz*. ### `create-load-balancer-listeners` Das folgende Codebeispiel zeigt die Verwendung`create-load-balancer-listeners`. **AWS CLI** **So erstellen Sie HTTP-Listener für einen Load Balancer** In diesem Beispiel wird mithilfe des HTTP-Protokolls ein Listener für Ihren Load Balancer an Port 80 erstellt. Befehl: ``` aws elb create-load-balancer-listeners --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" ``` **So erstellen Sie HTTPS-Listener für einen Load Balancer** In diesem Beispiel wird mithilfe des HTTPS-Protokolls ein Listener für Ihren Load Balancer an Port 443 erstellt. Befehl: ``` aws elb create-load-balancer-listeners --load-balancer-name my-load-balancer --listeners "Protocol=HTTPS,LoadBalancerPort=443,InstanceProtocol=HTTP,InstancePort=80" ``` + Einzelheiten zur API finden Sie [CreateLoadBalancerListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-load-balancer-listeners.html)in der *AWS CLI Befehlsreferenz*. ### `create-load-balancer-policy` Das folgende Codebeispiel zeigt die Verwendung`create-load-balancer-policy`. **AWS CLI** **So erstellen Sie eine Richtlinie, die das Proxy-Protokoll auf einem Load Balancer aktiviert** In diesem Beispiel wird eine Richtlinie erstellt, die das Proxy-Protokoll auf dem angegebenen Load Balancer aktiviert. Befehl: ``` aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-ProxyProtocol-policy --policy-type-name ProxyProtocolPolicyType --policy-attributes AttributeName=ProxyProtocol,AttributeValue=true ``` **So erstellen Sie eine SSL-Aushandlungsrichtlinie mit der empfohlenen Sicherheitsrichtlinie** In diesem Beispiel wird unter Verwendung der empfohlenen Sicherheitsrichtlinie eine SSL-Aushandlungsrichtlinie für den angegebenen HTTPS-Load-Balancer erstellt. Befehl: ``` aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-SSLNegotiation-policy --policy-type-name SSLNegotiationPolicyType --policy-attributes AttributeName=Reference-Security-Policy,AttributeValue=ELBSecurityPolicy-2015-03 ``` **So erstellen Sie eine SSL-Aushandlungsrichtlinie mit einer benutzerdefinierten Sicherheitsrichtlinie** In diesem Beispiel wird mithilfe einer benutzerdefinierten Sicherheitsrichtlinie eine SSL-Aushandlungsrichtlinie für den HTTPS-Load-Balancer erstellt, indem die Protokolle und Chiffren aktiviert werden. Befehl: ``` aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-SSLNegotiation-policy --policy-type-name SSLNegotiationPolicyType --policy-attributes AttributeName=Protocol-SSLv3,AttributeValue=true AttributeName=Protocol-TLSv1.1,AttributeValue=true AttributeName=DHE-RSA-AES256-SHA256,AttributeValue=true AttributeName=Server-Defined-Cipher-Order,AttributeValue=true ``` **So erstellen Sie eine Richtlinie für öffentliche Schlüssel** In diesem Beispiel wird eine Richtlinie für öffentliche Schlüssel erstellt. Befehl: ``` aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-PublicKey-policy --policy-type-name PublicKeyPolicyType --policy-attributes AttributeName=PublicKey,AttributeValue=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwAYUjnfyEyXr1pxjhFWBpMlggUcqoi3kl+dS74kj//c6x7ROtusUaeQCTgIUkayttRDWchuqo1pHC1u+n5xxXnBBe2ejbb2WRsKIQ5rXEeixsjFpFsojpSQKkzhVGI6mJVZBJDVKSHmswnwLBdofLhzvllpovBPTHe+o4haAWvDBALJU0pkSI1FecPHcs2hwxf14zHoXy1e2k36A64nXW43wtfx5qcVSIxtCEOjnYRg7RPvybaGfQ+v6Iaxb/+7J5kEvZhTFQId+bSiJImF1FSUT1W1xwzBZPUbcUkkXDj45vC2s3Z8E+Lk7a3uZhvsQHLZnrfuWjBWGWvZ/MhZYgEXAMPLE ``` **So erstellen Sie eine Authentifizierungsrichtlinie für Backend-Server** In diesem Beispiel wird eine Authentifizierungsrichtlinie für Backend-Server erstellt, die eine Authentifizierung mithilfe einer Richtlinie für öffentliche Schlüssel auf Ihrer Backend-Instance ermöglicht. Befehl: ``` aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-authentication-policy --policy-type-name BackendServerAuthenticationPolicyType --policy-attributes AttributeName=PublicKeyPolicyName,AttributeValue=my-PublicKey-policy ``` + Einzelheiten zur API finden Sie [CreateLoadBalancerPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-load-balancer-policy.html)in der *AWS CLI Befehlsreferenz*. ### `create-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`create-load-balancer`. **AWS CLI** **So erstellen Sie einen HTTP-Load-Balancer** In diesem Beispiel wird ein Load Balancer mit einem HTTP-Listener in einer VPC erstellt. Befehl: ``` aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" --subnets subnet-15aaab61 --security-groups sg-a61988c3 ``` Ausgabe: ``` { "DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com" } ``` In diesem Beispiel wird ein Load Balancer mit einem HTTP-Listener in EC2-Classic erstellt. Befehl: ``` aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" --availability-zones us-west-2a us-west-2b ``` Ausgabe: ``` { "DNSName": "my-load-balancer-123456789.us-west-2.elb.amazonaws.com" } ``` **So erstellen Sie einen HTTPS-Load-Balancer** In diesem Beispiel wird ein Load Balancer mit einem HTTPS-Listener in einer VPC erstellt. Befehl: ``` aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" "Protocol=HTTPS,LoadBalancerPort=443,InstanceProtocol=HTTP,InstancePort=80,SSLCertificateId=arn:aws:iam::123456789012:server-certificate/my-server-cert" --subnets subnet-15aaab61 --security-groups sg-a61988c3 ``` Ausgabe: ``` { "DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com" } ``` In diesem Beispiel wird ein Load Balancer mit einem HTTPS-Listener in EC2-Classic erstellt. Befehl: ``` aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" "Protocol=HTTPS,LoadBalancerPort=443,InstanceProtocol=HTTP,InstancePort=80,SSLCertificateId=arn:aws:iam::123456789012:server-certificate/my-server-cert" --availability-zones us-west-2a us-west-2b ``` Ausgabe: ``` { "DNSName": "my-load-balancer-123456789.us-west-2.elb.amazonaws.com" } ``` **So erstellen Sie einen internen Load Balancer** In diesem Beispiel wird ein interner Load Balancer mit einem HTTP-Listener in einer VPC erstellt. Befehl: ``` aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" --scheme internal --subnets subnet-a85db0df --security-groups sg-a61988c3 ``` Ausgabe: ``` { "DNSName": "internal-my-load-balancer-123456789.us-west-2.elb.amazonaws.com" } ``` + Einzelheiten zur API finden Sie [CreateLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `delete-load-balancer-listeners` Das folgende Codebeispiel zeigt die Verwendung`delete-load-balancer-listeners`. **AWS CLI** **So löschen Sie einen Listener von einem Load Balancer** In diesem Beispiel wird der Listener für den angegebenen Port vom angegebenen Load Balancer gelöscht. Befehl: ``` aws elb delete-load-balancer-listeners --load-balancer-name my-load-balancer --load-balancer-ports 80 ``` + Einzelheiten zur API finden Sie [DeleteLoadBalancerListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/delete-load-balancer-listeners.html)in der *AWS CLI Befehlsreferenz*. ### `delete-load-balancer-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-load-balancer-policy`. **AWS CLI** **So löschen Sie eine Richtlinie von einem Load Balancer** In diesem Beispiel wird die angegebene Richtlinie aus dem angegebenen Load Balancer gelöscht. Die Richtlinie darf bei keinem Listener aktiviert sein. Befehl: ``` aws elb delete-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-duration-cookie-policy ``` + Einzelheiten zur API finden Sie [DeleteLoadBalancerPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/delete-load-balancer-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`delete-load-balancer`. **AWS CLI** **So löschen Sie einen Load Balancer** In diesem Beispiel wird der angegebene Load Balancer gelöscht. Befehl: ``` aws elb delete-load-balancer --load-balancer-name my-load-balancer ``` + Einzelheiten zur API finden Sie [DeleteLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/delete-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-instances-from-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`deregister-instances-from-load-balancer`. **AWS CLI** **So melden Sie Instances von einem Load Balancer ab** In diesem Beispiel wird die Registrierung der angegebenen Instance beim angegebenen Load Balancer aufgehoben. Befehl: ``` aws elb deregister-instances-from-load-balancer --load-balancer-name my-load-balancer --instances i-d6f6fae3 ``` Ausgabe: ``` { "Instances": [ { "InstanceId": "i-207d9717" }, { "InstanceId": "i-afefb49b" } ] } ``` + Einzelheiten zur API finden Sie [DeregisterInstancesFromLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/deregister-instances-from-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `describe-account-limits` Das folgende Codebeispiel zeigt die Verwendung`describe-account-limits`. **AWS CLI** **So beschreiben Sie Limits für Classic Load Balancer** Im folgenden `describe-account-limits` Beispiel werden Details zu den Classic Load Balancer Balancer-Limits für Ihr AWS Konto angezeigt. ``` aws elb describe-account-limits ``` Ausgabe: ``` { "Limits": [ { "Name": "classic-load-balancers", "Max": "20" }, { "Name": "classic-listeners", "Max": "100" }, { "Name": "classic-registered-instances", "Max": "1000" } ] } ``` + Einzelheiten zur API finden Sie [DescribeAccountLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-account-limits.html)in der *AWS CLI Befehlsreferenz.* ### `describe-instance-health` Das folgende Codebeispiel zeigt die Verwendung`describe-instance-health`. **AWS CLI** **So beschreiben Sie den Zustand der Instances für einen Load Balancer** In diesem Beispiel wird der Zustand der Instances für den angegebenen Load Balancer beschrieben. Befehl: ``` aws elb describe-instance-health --load-balancer-name my-load-balancer ``` Ausgabe: ``` { "InstanceStates": [ { "InstanceId": "i-207d9717", "ReasonCode": "N/A", "State": "InService", "Description": "N/A" }, { "InstanceId": "i-afefb49b", "ReasonCode": "N/A", "State": "InService", "Description": "N/A" } ] } ``` **So beschreiben Sie den Zustand einer Instance für einen Load Balancer** In diesem Beispiel wird der Zustand der angegebenen Instance für den angegebenen Load Balancer beschrieben. Befehl: ``` aws elb describe-instance-health --load-balancer-name my-load-balancer --instances i-7299c809 ``` Nachstehend ist eine Beispielantwort für eine Instance abgebildet, die gerade registriert wird. Ausgabe: ``` { "InstanceStates": [ { "InstanceId": "i-7299c809", "ReasonCode": "ELB", "State": "OutOfService", "Description": "Instance registration is still in progress." } ] } ``` Nachstehend ist eine Beispielantwort für eine fehlerhafte Instance abgebildet. Ausgabe: ``` { "InstanceStates": [ { "InstanceId": "i-7299c809", "ReasonCode": "Instance", "State": "OutOfService", "Description": "Instance has failed at least the UnhealthyThreshold number of health checks consecutively." } ] } ``` + Einzelheiten zur API finden Sie [DescribeInstanceHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-instance-health.html)in der *AWS CLI Befehlsreferenz*. ### `describe-load-balancer-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-load-balancer-attributes`. **AWS CLI** **So beschreiben Sie die Attribute eines Load Balancers** In diesem Beispiel werden die Attribute des angegebenen Load Balancers beschrieben. Befehl: ``` aws elb describe-load-balancer-attributes --load-balancer-name my-load-balancer ``` Ausgabe: ``` { "LoadBalancerAttributes": { "ConnectionDraining": { "Enabled": false, "Timeout": 300 }, "CrossZoneLoadBalancing": { "Enabled": true }, "ConnectionSettings": { "IdleTimeout": 30 }, "AccessLog": { "Enabled": false } } } ``` + Einzelheiten zur API finden Sie [DescribeLoadBalancerAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-load-balancer-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-load-balancer-policies` Das folgende Codebeispiel zeigt die Verwendung`describe-load-balancer-policies`. **AWS CLI** **So beschreiben Sie alle Richtlinien, die einem Load Balancer zugeordnet sind** In diesem Beispiel werden alle Richtlinien beschrieben, die dem angegebenen Load Balancer zugeordnet sind. Befehl: ``` aws elb describe-load-balancer-policies --load-balancer-name my-load-balancer ``` Ausgabe: ``` { "PolicyDescriptions": [ { "PolicyAttributeDescriptions": [ { "AttributeName": "ProxyProtocol", "AttributeValue": "true" } ], "PolicyName": "my-ProxyProtocol-policy", "PolicyTypeName": "ProxyProtocolPolicyType" }, { "PolicyAttributeDescriptions": [ { "AttributeName": "CookieName", "AttributeValue": "my-app-cookie" } ], "PolicyName": "my-app-cookie-policy", "PolicyTypeName": "AppCookieStickinessPolicyType" }, { "PolicyAttributeDescriptions": [ { "AttributeName": "CookieExpirationPeriod", "AttributeValue": "60" } ], "PolicyName": "my-duration-cookie-policy", "PolicyTypeName": "LBCookieStickinessPolicyType" }, . . . ] } ``` **So beschreiben Sie eine bestimmte Richtlinie, die einem Load Balancer zugeordnet ist** In diesem Beispiel wird die angegebene Richtlinie beschrieben, die dem angegebenen Load Balancer zugeordnet ist. Befehl: ``` aws elb describe-load-balancer-policies --load-balancer-name my-load-balancer --policy-name my-authentication-policy ``` Ausgabe: ``` { "PolicyDescriptions": [ { "PolicyAttributeDescriptions": [ { "AttributeName": "PublicKeyPolicyName", "AttributeValue": "my-PublicKey-policy" } ], "PolicyName": "my-authentication-policy", "PolicyTypeName": "BackendServerAuthenticationPolicyType" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLoadBalancerPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-load-balancer-policies.html)in der *AWS CLI Befehlsreferenz*. ### `describe-load-balancer-policy-types` Das folgende Codebeispiel zeigt die Verwendung`describe-load-balancer-policy-types`. **AWS CLI** **So beschreiben Sie die von Elastic Load Balancing definierten Richtlinientypen für Load Balancers** In diesem Beispiel werden die Richtlinientypen für Load Balancers beschrieben, mit denen Sie Richtlinienkonfigurationen für Ihren Load Balancer erstellen können. Befehl: ``` aws elb describe-load-balancer-policy-types ``` Ausgabe: ``` { "PolicyTypeDescriptions": [ { "PolicyAttributeTypeDescriptions": [ { "Cardinality": "ONE", "AttributeName": "ProxyProtocol", "AttributeType": "Boolean" } ], "PolicyTypeName": "ProxyProtocolPolicyType", "Description": "Policy that controls whether to include the IP address and port of the originating request for TCP messages. This policy operates on TCP/SSL listeners only" }, { "PolicyAttributeTypeDescriptions": [ { "Cardinality": "ONE", "AttributeName": "PublicKey", "AttributeType": "String" } ], "PolicyTypeName": "PublicKeyPolicyType", "Description": "Policy containing a list of public keys to accept when authenticating the back-end server(s). This policy cannot be applied directly to back-end servers or listeners but must be part of a BackendServerAuthenticationPolicyType." }, { "PolicyAttributeTypeDescriptions": [ { "Cardinality": "ONE", "AttributeName": "CookieName", "AttributeType": "String" } ], "PolicyTypeName": "AppCookieStickinessPolicyType", "Description": "Stickiness policy with session lifetimes controlled by the lifetime of the application-generated cookie. This policy can be associated only with HTTP/HTTPS listeners." }, { "PolicyAttributeTypeDescriptions": [ { "Cardinality": "ZERO_OR_ONE", "AttributeName": "CookieExpirationPeriod", "AttributeType": "Long" } ], "PolicyTypeName": "LBCookieStickinessPolicyType", "Description": "Stickiness policy with session lifetimes controlled by the browser (user-agent) or a specified expiration period. This policy can be associated only with HTTP/HTTPS listeners." }, { "PolicyAttributeTypeDescriptions": [ . . . ], "PolicyTypeName": "SSLNegotiationPolicyType", "Description": "Listener policy that defines the ciphers and protocols that will be accepted by the load balancer. This policy can be associated only with HTTPS/SSL listeners." }, { "PolicyAttributeTypeDescriptions": [ { "Cardinality": "ONE_OR_MORE", "AttributeName": "PublicKeyPolicyName", "AttributeType": "PolicyName" } ], "PolicyTypeName": "BackendServerAuthenticationPolicyType", "Description": "Policy that controls authentication to back-end server(s) and contains one or more policies, such as an instance of a PublicKeyPolicyType. This policy can be associated only with back-end servers that are using HTTPS/SSL." } ] } ``` + Einzelheiten zur API finden Sie [DescribeLoadBalancerPolicyTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-load-balancer-policy-types.html)in der *AWS CLI Befehlsreferenz*. ### `describe-load-balancers` Das folgende Codebeispiel zeigt die Verwendung`describe-load-balancers`. **AWS CLI** **So beschreiben Sie Ihre Load Balancers** In diesem Beispiel werden alle Ihre Load Balancers beschrieben. Befehl: ``` aws elb describe-load-balancers ``` **So beschreiben Sie einen Ihrer Load Balancers** In diesem Beispiel wird der angegebene Load Balancer beschrieben. Befehl: ``` aws elb describe-load-balancers --load-balancer-name my-load-balancer ``` Nachstehend finden Sie eine Beispielantwort für einen HTTPS-Load-Balancer in einer VPC. Ausgabe: ``` { "LoadBalancerDescriptions": [ { "Subnets": [ "subnet-15aaab61" ], "CanonicalHostedZoneNameID": "Z3DZXE0EXAMPLE", "CanonicalHostedZoneName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com", "ListenerDescriptions": [ { "Listener": { "InstancePort": 80, "LoadBalancerPort": 80, "Protocol": "HTTP", "InstanceProtocol": "HTTP" }, "PolicyNames": [] }, { "Listener": { "InstancePort": 443, "SSLCertificateId": "arn:aws:iam::123456789012:server-certificate/my-server-cert", "LoadBalancerPort": 443, "Protocol": "HTTPS", "InstanceProtocol": "HTTPS" }, "PolicyNames": [ "ELBSecurityPolicy-2015-03" ] } ], "HealthCheck": { "HealthyThreshold": 2, "Interval": 30, "Target": "HTTP:80/png", "Timeout": 3, "UnhealthyThreshold": 2 }, "VPCId": "vpc-a01106c2", "BackendServerDescriptions": [ { "InstancePort": 80, "PolicyNames": [ "my-ProxyProtocol-policy" ] } ], "Instances": [ { "InstanceId": "i-207d9717" }, { "InstanceId": "i-afefb49b" } ], "DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com", "SecurityGroups": [ "sg-a61988c3" ], "Policies": { "LBCookieStickinessPolicies": [ { "PolicyName": "my-duration-cookie-policy", "CookieExpirationPeriod": 60 } ], "AppCookieStickinessPolicies": [], "OtherPolicies": [ "my-PublicKey-policy", "my-authentication-policy", "my-SSLNegotiation-policy", "my-ProxyProtocol-policy", "ELBSecurityPolicy-2015-03" ] }, "LoadBalancerName": "my-load-balancer", "CreatedTime": "2015-03-19T03:24:02.650Z", "AvailabilityZones": [ "us-west-2a" ], "Scheme": "internet-facing", "SourceSecurityGroup": { "OwnerAlias": "123456789012", "GroupName": "my-elb-sg" } } ] } ``` + Einzelheiten zur API finden Sie [DescribeLoadBalancers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-load-balancers.html)in der *AWS CLI Befehlsreferenz*. ### `describe-tags` Das folgende Codebeispiel zeigt die Verwendung`describe-tags`. **AWS CLI** **So beschreiben Sie die einem Load Balancer zugeordneten Tags** In diesem Beispiel werden die Tags beschrieben, die dem angegebenen Load Balancer zugewiesen sind. Befehl: ``` aws elb describe-tags --load-balancer-name my-load-balancer ``` Ausgabe: ``` { "TagDescriptions": [ { "Tags": [ { "Value": "lima", "Key": "project" }, { "Value": "digital-media", "Key": "department" } ], "LoadBalancerName": "my-load-balancer" } ] } ``` + Einzelheiten zur API finden Sie [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-tags.html)in der *AWS CLI Befehlsreferenz*. ### `detach-load-balancer-from-subnets` Das folgende Codebeispiel zeigt die Verwendung`detach-load-balancer-from-subnets`. **AWS CLI** **So trennen Sie Load Balancers von Subnetzen** In diesem Beispiel wird der angegebene Load Balancer vom angegebenen Subnetz getrennt. Befehl: ``` aws elb detach-load-balancer-from-subnets --load-balancer-name my-load-balancer --subnets subnet-0ecac448 ``` Ausgabe: ``` { "Subnets": [ "subnet-15aaab61" ] } ``` + Einzelheiten zur API finden Sie [DetachLoadBalancerFromSubnets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/detach-load-balancer-from-subnets.html)in der *AWS CLI Befehlsreferenz*. ### `disable-availability-zones-for-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`disable-availability-zones-for-load-balancer`. **AWS CLI** **So deaktivieren Sie Availability Zones für einen Load Balancer** Im folgenden Beispiel wird die angegebene Availability Zone aus der Menge der Availability Zones für den angegebenen Load Balancer entfernt. Befehl: ``` aws elb disable-availability-zones-for-load-balancer --load-balancer-name my-load-balancer --availability-zones us-west-2a ``` Ausgabe: ``` { "AvailabilityZones": [ "us-west-2b" ] } ``` + Einzelheiten zur API finden Sie [DisableAvailabilityZonesForLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/disable-availability-zones-for-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `enable-availability-zones-for-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`enable-availability-zones-for-load-balancer`. **AWS CLI** **So aktivieren Sie Availability Zones für einen Load Balancer** In diesem Beispiel wird dem angegebenen Load Balancer die angegebene Availability Zone hinzugefügt. Befehl: ``` aws elb enable-availability-zones-for-load-balancer --load-balancer-name my-load-balancer --availability-zones us-west-2b ``` Ausgabe: ``` { "AvailabilityZones": [ "us-west-2a", "us-west-2b" ] } ``` + Einzelheiten zur API finden Sie [EnableAvailabilityZonesForLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/enable-availability-zones-for-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `modify-load-balancer-attributes` Das folgende Codebeispiel zeigt die Verwendung`modify-load-balancer-attributes`. **AWS CLI** **So ändern Sie die Attribute eines Load Balancers** In diesem Beispiel wird das Attribut `CrossZoneLoadBalancing` des angegebenen Load Balancers geändert. Befehl: ``` aws elb modify-load-balancer-attributes --load-balancer-name my-load-balancer --load-balancer-attributes "{\"CrossZoneLoadBalancing\":{\"Enabled\":true}}" ``` Ausgabe: ``` { "LoadBalancerAttributes": { "CrossZoneLoadBalancing": { "Enabled": true } }, "LoadBalancerName": "my-load-balancer" } ``` In diesem Beispiel wird das Attribut `ConnectionDraining` des angegebenen Load Balancers geändert. Befehl: ``` aws elb modify-load-balancer-attributes --load-balancer-name my-load-balancer --load-balancer-attributes "{\"ConnectionDraining\":{\"Enabled\":true,\"Timeout\":300}}" ``` Ausgabe: ``` { "LoadBalancerAttributes": { "ConnectionDraining": { "Enabled": true, "Timeout": 300 } }, "LoadBalancerName": "my-load-balancer" } ``` + Einzelheiten zur API finden Sie [ModifyLoadBalancerAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/modify-load-balancer-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `register-instances-with-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`register-instances-with-load-balancer`. **AWS CLI** **So registrieren Sie Instances bei einem Load Balancer** In diesem Beispiel wird die angegebene Instance beim angegebenen Load Balancer registriert. Befehl: ``` aws elb register-instances-with-load-balancer --load-balancer-name my-load-balancer --instances i-d6f6fae3 ``` Ausgabe: ``` { "Instances": [ { "InstanceId": "i-d6f6fae3" }, { "InstanceId": "i-207d9717" }, { "InstanceId": "i-afefb49b" } ] } ``` + Einzelheiten zur API finden Sie [RegisterInstancesWithLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/register-instances-with-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `remove-tags` Das folgende Codebeispiel zeigt die Verwendung`remove-tags`. **AWS CLI** **So entfernen Sie Tags aus einem Load Balancer** In diesem Beispiel wird ein Tag vom angegebenen Load Balancer entfernt. Befehl: ``` aws elb remove-tags --load-balancer-name my-load-balancer --tags project ``` + Einzelheiten zur API finden Sie [RemoveTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/remove-tags.html)in der *AWS CLI Befehlsreferenz*. ### `set-load-balancer-listener-ssl-certificate` Das folgende Codebeispiel zeigt die Verwendung`set-load-balancer-listener-ssl-certificate`. **AWS CLI** **So aktualisieren Sie das SSL-Zertifikat für einen HTTPS-Load-Balancer** In diesem Beispiel wird das vorhandene SSL-Zertifikat für den angegebenen HTTPS-Load-Balancer ersetzt. Befehl: ``` aws elb set-load-balancer-listener-ssl-certificate --load-balancer-name my-load-balancer --load-balancer-port 443 --ssl-certificate-id arn:aws:iam::123456789012:server-certificate/new-server-cert ``` + Einzelheiten zur API finden Sie [SetLoadBalancerListenerSslCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/set-load-balancer-listener-ssl-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `set-load-balancer-policies-for-backend-server` Das folgende Codebeispiel zeigt die Verwendung`set-load-balancer-policies-for-backend-server`. **AWS CLI** **So ersetzen Sie die Richtlinien, die einem Port für eine Backend-Instance zugeordnet sind** Im folgenden Beispiel werden die Richtlinien ersetzt, die derzeit dem angegebenen Port zugeordnet sind. Befehl: ``` aws elb set-load-balancer-policies-for-backend-server --load-balancer-name my-load-balancer --instance-port 80 --policy-names my-ProxyProtocol-policy ``` **So entfernen Sie alle Richtlinien, die derzeit einem Port Ihrer Backend-Instance zugeordnet sind** In diesem Beispiel werden alle Richtlinien entfernt, die dem angegebenen Port zugeordnet sind. Befehl: ``` aws elb set-load-balancer-policies-for-backend-server --load-balancer-name my-load-balancer --instance-port 80 --policy-names [] ``` Verwenden Sie den Befehl `describe-load-balancer-policies`, um zu bestätigen, dass die Richtlinien entfernt wurden. + Einzelheiten zur API finden Sie [SetLoadBalancerPoliciesForBackendServer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/set-load-balancer-policies-for-backend-server.html)in der *AWS CLI Befehlsreferenz*. ### `set-load-balancer-policies-of-listener` Das folgende Codebeispiel zeigt die Verwendung`set-load-balancer-policies-of-listener`. **AWS CLI** **So ersetzen Sie die Richtlinien, die einem Listener zugeordnet sind** In diesem Beispiel werden die Richtlinien ersetzt, die derzeit dem angegebenen Listener zugeordnet sind. Befehl: ``` aws elb set-load-balancer-policies-of-listener --load-balancer-name my-load-balancer --load-balancer-port 443 --policy-names my-SSLNegotiation-policy ``` **So entfernen Sie alle Richtlinien, die Ihrem Listener zugeordnet sind** In diesem Beispiel werden alle Richtlinien entfernt, die derzeit dem angegebenen Listener zugeordnet sind. Befehl: ``` aws elb set-load-balancer-policies-of-listener --load-balancer-name my-load-balancer --load-balancer-port 443 --policy-names [] ``` Verwenden Sie den Befehl `describe-load-balancer-policies`, um zu bestätigen, dass die Richtlinien vom Load Balancer entfernt wurden. + Einzelheiten zur API finden Sie [SetLoadBalancerPoliciesOfListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/set-load-balancer-policies-of-listener.html)in der *AWS CLI Befehlsreferenz*. # Elastic Load Balancing — Version 2, Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Elastic Load Balancing — Version 2 Aktionen ausführen und gängige Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-listener-certificates` Das folgende Codebeispiel zeigt, wie Sie`add-listener-certificates`. **AWS CLI** **So fügen Sie einem sicheren Listener ein Zertifikat hinzu** In diesem Beispiel wird dem angegebenen sicheren Listener ein Zertifikat hinzugefügt. Befehl: ``` aws elbv2 add-listener-certificates --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 --certificates CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/5cc54884-f4a3-4072-80be-05b9ba72f705 ``` Ausgabe: ``` { "Certificates": [ { "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/5cc54884-f4a3-4072-80be-05b9ba72f705", "IsDefault": false } ] } ``` + Einzelheiten zur API finden Sie [AddListenerCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/add-listener-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `add-tags` Das folgende Codebeispiel zeigt die Verwendung`add-tags`. **AWS CLI** **So fügen Sie einem Load Balancer Tags hinzu** Im folgenden Beispiel für `add-tags` werden dem angegebenen Load Balancer die Tags `project` und `department` hinzugefügt. ``` aws elbv2 add-tags \ --resource-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \ --tags "Key=project,Value=lima" "Key=department,Value=digital-media" ``` + Einzelheiten zur API finden Sie [AddTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/add-tags.html)in der *AWS CLI Befehlsreferenz*. ### `create-listener` Das folgende Codebeispiel zeigt die Verwendung`create-listener`. **AWS CLI** **Beispiel 1: So erstellen Sie einen HTTP-Listener** Im folgenden Beispiel für `create-listener` wird ein HTTP-Listener für den angegebenen Application Load Balancer erstellt, der Anfragen an die angegebene Zielgruppe weiterleitet. ``` aws elbv2 create-listener \ --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \ --protocol HTTP \ --port 80 \ --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Weitere Informationen finden Sie unter [Tutorial: Einen Application Load Balancer mithilfe der AWS CLI erstellen](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html#create-load-balancer-aws-cli) im *Benutzerhandbuch für Application Load Balancers*. **Beispiel 2: So erstellen Sie einen HTTPS-Listener** Im folgenden Beispiel für `create-listener` wird ein HTTPS-Listener für den angegebenen Application Load Balancer erstellt, der Anfragen an die angegebene Zielgruppe weiterleitet. Sie müssen ein SSL-Zertifikat für einen HTTPS-Listener angeben. Sie können Zertifikate mit AWS Certificate Manager (ACM) erstellen und verwalten. Alternativ können Sie mithilfe von SSL/TLS Tools ein Zertifikat erstellen, das Zertifikat von einer Zertifizierungsstelle (CA) signieren lassen und das Zertifikat in AWS Identity and Access Management (IAM) hochladen. ``` aws elbv2 create-listener \ --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \ --protocol HTTPS \ --port 443 \ --certificates CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/3dcb0a41-bd72-4774-9ad9-756919c40557 \ --ssl-policy ELBSecurityPolicy-2016-08 \ --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Weitere Informationen finden Sie unter [Hinzufügen eines HTTPS-Listeners](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html#https-listener-aws-cli) im *Benutzerhandbuch für Application Load Balancers*. **Beispiel 3: So erstellen Sie einen TCP-Listener** Im folgenden Beispiel für `create-listener` wird ein TCP-Listener für den angegebenen Network Load Balancer erstellt, der Anfragen an die angegebene Zielgruppe weiterleitet. ``` aws elbv2 create-listener \ --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/5d1b75f4f1cee11e \ --protocol TCP \ --port 80 \ --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-targets/b6bba954d1361c78 ``` Weitere Informationen finden Sie unter [Tutorial: Einen Network Load Balancer mithilfe der AWS CLI erstellen](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-cli.html#create-load-balancer-aws-cli) im *Benutzerhandbuch für Network Load Balancer*. **Beispiel 4: So erstellen Sie einen TLS-Listener** Im folgenden Beispiel für `create-listener` wird ein TLS-Listener für den angegebenen Network Load Balancer erstellt, der Anfragen an die angegebene Zielgruppe weiterleitet. Sie müssen ein SSL-Zertifikat für einen TLS-Listener angeben. ``` aws elbv2 create-listener \ --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \ --protocol TLS \ --port 443 \ --certificates CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/3dcb0a41-bd72-4774-9ad9-756919c40557 \ --ssl-policy ELBSecurityPolicy-2016-08 \ --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Weitere Informationen finden Sie unter [TLS-Listener für Ihren Network Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html) im *Benutzerhandbuch für Network Load Balancers*. **Beispiel 5: So erstellen Sie einen UDP-Listener** Im folgenden Beispiel für `create-listener` wird ein UDP-Listener für den angegebenen Network Load Balancer erstellt, der Anfragen an die angegebene Zielgruppe weiterleitet. ``` aws elbv2 create-listener \ --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/5d1b75f4f1cee11e \ --protocol UDP \ --port 53 \ --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-targets/b6bba954d1361c78 ``` Weitere Informationen finden Sie unter [Tutorial: Einen Network Load Balancer mithilfe der AWS CLI erstellen](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-cli.html#create-load-balancer-aws-cli) im *Benutzerhandbuch für Network Load Balancer*. **Beispiel 6: So erstellen Sie einen Listener für das angegebene Gateway und die Weiterleitung** Im folgenden Beispiel für `create-listener` wird ein Listener für den angegebenen Gateway Load Balancer erstellt, der Anfragen an die angegebene Zielgruppe weiterleitet. ``` aws elbv2 create-listener \ --load-balancer-arn arn:aws:elasticloadbalancing:us-east-1:850631746142:loadbalancer/gwy/my-gateway-load-balancer/e0f9b3d5c7f7d3d6 \ --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-east-1:850631746142:targetgroup/my-glb-targets/007ca469fae3bb1615 ``` Ausgabe: ``` { "Listeners": [ { "ListenerArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:listener/gwy/my-agw-lb-example2/e0f9b3d5c7f7d3d6/afc127db15f925de", "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:loadbalancer/gwy/my-agw-lb-example2/e0f9b3d5c7f7d3d6", "DefaultActions": [ { "Type": "forward", "TargetGroupArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:targetgroup/test-tg-agw-2/007ca469fae3bb1615", "ForwardConfig": { "TargetGroups": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:targetgroup/test-tg-agw-2/007ca469fae3bb1615" } ] } } ] } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Gateway Load Balancers using the AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/getting-started-cli.html) im *Benutzerhandbuch für Gateway Load Balancers*. + Einzelheiten zur API finden Sie [CreateListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/create-listener.html)in der *AWS CLI Befehlsreferenz*. ### `create-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`create-load-balancer`. **AWS CLI** **Beispiel 1: So erstellen Sie einen mit dem Internet verbundenen Load Balancer** Im folgenden Beispiel für `create-load-balancer` wird ein mit dem Internet verbundener Application Load Balancer erstellt. Außerdem werden die Availability Zones für die angegebenen Subnetze aktiviert. ``` aws elbv2 create-load-balancer \ --name my-load-balancer \ --subnets subnet-b7d581c0 subnet-8360a9e7 ``` Ausgabe: ``` { "LoadBalancers": [ { "Type": "application", "Scheme": "internet-facing", "IpAddressType": "ipv4", "VpcId": "vpc-3ac0fb5f", "AvailabilityZones": [ { "ZoneName": "us-west-2a", "SubnetId": "subnet-8360a9e7" }, { "ZoneName": "us-west-2b", "SubnetId": "subnet-b7d581c0" } ], "CreatedTime": "2017-08-25T21:26:12.920Z", "CanonicalHostedZoneId": "Z2P70J7EXAMPLE", "DNSName": "my-load-balancer-424835706.us-west-2.elb.amazonaws.com", "SecurityGroups": [ "sg-5943793c" ], "LoadBalancerName": "my-load-balancer", "State": { "Code": "provisioning" }, "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" } ] } ``` Weitere Informationen finden Sie unter [Tutorial: Einen Application Load Balancer mithilfe der AWS CLI erstellen](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html) im *Benutzerhandbuch für Application Load Balancers*. **Beispiel 2: So erstellen Sie einen internen Load Balancer** Im folgenden Beispiel für `create-load-balancer` wird ein interner Application Load Balancer erstellt. Außerdem werden die Availability Zones für die angegebenen Subnetze aktiviert. ``` aws elbv2 create-load-balancer \ --name my-internal-load-balancer \ --scheme internal \ --subnets subnet-b7d581c0 subnet-8360a9e7 ``` Ausgabe: ``` { "LoadBalancers": [ { "Type": "application", "Scheme": "internal", "IpAddressType": "ipv4", "VpcId": "vpc-3ac0fb5f", "AvailabilityZones": [ { "ZoneName": "us-west-2a", "SubnetId": "subnet-8360a9e7" }, { "ZoneName": "us-west-2b", "SubnetId": "subnet-b7d581c0" } ], "CreatedTime": "2016-03-25T21:29:48.850Z", "CanonicalHostedZoneId": "Z2P70J7EXAMPLE", "DNSName": "internal-my-internal-load-balancer-1529930873.us-west-2.elb.amazonaws.com", "SecurityGroups": [ "sg-5943793c" ], "LoadBalancerName": "my-internal-load-balancer", "State": { "Code": "provisioning" }, "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-internal-load-balancer/5b49b8d4303115c2" } ] } ``` Weitere Informationen finden Sie unter [Tutorial: Einen Application Load Balancer mithilfe der AWS CLI erstellen](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html) im *Benutzerhandbuch für Application Load Balancers*. **Beispiel 3: So erstellen Sie einen Network Load Balancer** Im folgenden Beispiel für `create-load-balancer` wird ein mit dem Internet verbundener Network Load Balancer erstellt. Außerdem wird die Availability Zone für das angegebene Subnetz aktiviert. Dabei wird die angegebene Elastic-IP-Adresse über eine Subnetzzuordnung der Netzwerkschnittstelle zugewiesen, die von den Load-Balancer-Knoten für die Availability Zone verwendet wird. ``` aws elbv2 create-load-balancer \ --name my-network-load-balancer \ --type network \ --subnet-mappings SubnetId=subnet-b7d581c0,AllocationId=eipalloc-64d5890a ``` Ausgabe: ``` { "LoadBalancers": [ { "Type": "network", "Scheme": "internet-facing", "IpAddressType": "ipv4", "VpcId": "vpc-3ac0fb5f", "AvailabilityZones": [ { "LoadBalancerAddresses": [ { "IpAddress": "35.161.207.171", "AllocationId": "eipalloc-64d5890a" } ], "ZoneName": "us-west-2b", "SubnetId": "subnet-5264e837" } ], "CreatedTime": "2017-10-15T22:41:25.657Z", "CanonicalHostedZoneId": "Z2P70J7EXAMPLE", "DNSName": "my-network-load-balancer-5d1b75f4f1cee11e.elb.us-west-2.amazonaws.com", "LoadBalancerName": "my-network-load-balancer", "State": { "Code": "provisioning" }, "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/5d1b75f4f1cee11e" } ] } ``` Weitere Informationen finden Sie unter [Tutorial: Einen Network Load Balancer mithilfe der AWS CLI erstellen](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-cli.html) im *Benutzerhandbuch für Network Load Balancer*. **Beispiel 4: So erstellen Sie einen Gateway Load Balancer** Im folgenden Beispiel für `create-load-balancer` wird ein interner Gateway Load Balancer erstellt. Außerdem werden die Availability Zones für die angegebenen Subnetze aktiviert. ``` aws elbv2 create-load-balancer \ --name my-gateway-load-balancer \ --type gateway \ --subnets subnet-dc83f691 subnet-a62583f9 ``` Ausgabe: ``` { "LoadBalancers": [ { "Type": "gateway", "VpcId": "vpc-838475fe", "AvailabilityZones": [ { "ZoneName": "us-east-1b", "SubnetId": "subnet-a62583f9" }, { "ZoneName": "us-east-1a", "SubnetId": "subnet-dc83f691" } ], "CreatedTime": "2021-07-14T19:33:43.324000+00:00", "LoadBalancerName": "my-gateway-load-balancer", "State": { "Code": "provisioning" }, "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:loadbalancer/gwy/my-gateway-load-balancer/dfbb5a7d32cdee79" } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Gateway Load Balancers using the AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/getting-started-cli.html) im *Benutzerhandbuch für Gateway Load Balancers*. + Einzelheiten zur API finden Sie [CreateLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/create-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `create-rule` Das folgende Codebeispiel zeigt die Verwendung`create-rule`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Regel mit einer Pfadbedingung und einer Weiterleitungsaktion** Im folgenden Beispiel für `create-rule` wird eine Regel erstellt, die Anfragen an die angegebene Zielgruppe weiterleitet, wenn die URL das vorgeschriebene Muster enthält. ``` aws elbv2 create-rule \ --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \ --priority 5 \ --conditions file://conditions-pattern.json --actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Inhalt von `conditions-pattern.json`: ``` [ { "Field": "path-pattern", "PathPatternConfig": { "Values": ["/images/*"] } } ] ``` **Beispiel 2: So erstellen Sie eine Regel mit einer Hostbedingung und einer festen Antwort** Im folgenden Beispiel für `create-rule` wird eine Regel erstellt, die eine feste Antwort liefert, wenn der Hostname im Host-Header mit dem angegebenen Hostnamen übereinstimmt. ``` aws elbv2 create-rule \ --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \ --priority 10 \ --conditions file://conditions-host.json \ --actions file://actions-fixed-response.json ``` Inhalt von `conditions-host.json` ``` [ { "Field": "host-header", "HostHeaderConfig": { "Values": ["*.example.com"] } } ] ``` Inhalt von `actions-fixed-response.json` ``` [ { "Type": "fixed-response", "FixedResponseConfig": { "MessageBody": "Hello world", "StatusCode": "200", "ContentType": "text/plain" } } ] ``` **Beispiel 3: So erstellen Sie eine Regel mit einer Quell-IP-Adressbedingung, einer Authentifizierungsaktion und einer Weiterleitungsaktion** Im folgenden Beispiel für `create-rule` wird eine Regel erstellt, die den Benutzer authentifiziert, wenn die Quell-IP-Adresse mit der angegebenen IP-Adresse übereinstimmt, und die Anfrage an die angegebene Zielgruppe weiterleitet, wenn die Authentifizierung erfolgreich ist. ``` aws elbv2 create-rule \ --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \ --priority 20 \ --conditions file://conditions-source-ip.json \ --actions file://actions-authenticate.json ``` Inhalt von `conditions-source-ip.json` ``` [ { "Field": "source-ip", "SourceIpConfig": { "Values": ["192.0.2.0/24", "198.51.100.10/32"] } } ] ``` Inhalt von `actions-authenticate.json` ``` [ { "Type": "authenticate-oidc", "AuthenticateOidcConfig": { "Issuer": "https://idp-issuer.com", "AuthorizationEndpoint": "https://authorization-endpoint.com", "TokenEndpoint": "https://token-endpoint.com", "UserInfoEndpoint": "https://user-info-endpoint.com", "ClientId": "abcdefghijklmnopqrstuvwxyz123456789", "ClientSecret": "123456789012345678901234567890", "SessionCookieName": "my-cookie", "SessionTimeout": 3600, "Scope": "email", "AuthenticationRequestExtraParams": { "display": "page", "prompt": "login" }, "OnUnauthenticatedRequest": "deny" }, "Order": 1 }, { "Type": "forward", "TargetGroupArn": "arn:aws:elasticloadbalancing:us-east-1:880185128111:targetgroup/cli-test/642a97ecb0e0f26b", "Order": 2 } ] ``` + Einzelheiten zur API finden Sie [CreateRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/create-rule.html)in der *AWS CLI Befehlsreferenz*. ### `create-target-group` Das folgende Codebeispiel zeigt die Verwendung`create-target-group`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Zielgruppe für einen Application Load Balancer** Im folgenden Beispiel für `create-target-group` wird eine Zielgruppe für einen Application Load Balancer erstellt, in der Sie Ziele nach Instance-ID registrieren (der Zieltyp ist `instance`). Diese Zielgruppe verwendet das HTTP-Protokoll, Port 80 und die Standardeinstellungen für die Zustandsprüfung für eine HTTP-Zielgruppe. ``` aws elbv2 create-target-group \ --name my-targets \ --protocol HTTP \ --port 80 \ --target-type instance \ --vpc-id vpc-3ac0fb5f ``` Ausgabe: ``` { "TargetGroups": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", "TargetGroupName": "my-targets", "Protocol": "HTTP", "Port": 80, "VpcId": "vpc-3ac0fb5f", "HealthCheckProtocol": "HTTP", "HealthCheckPort": "traffic-port", "HealthCheckEnabled": true, "HealthCheckIntervalSeconds": 30, "HealthCheckTimeoutSeconds": 5, "HealthyThresholdCount": 5, "UnhealthyThresholdCount": 2, "HealthCheckPath": "/", "Matcher": { "HttpCode": "200" }, "TargetType": "instance", "ProtocolVersion": "HTTP1", "IpAddressType": "ipv4" } ] } ``` Weitere Informationen finden Sie unter [Erstellen einer Zielgruppe](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-target-group.html) im *Benutzerhandbuch für Application Load Balancers*. **Beispiel 2: So erstellen Sie eine Zielgruppe, um Datenverkehr von einem Application Load Balancer zu einer Lambda-Funktion weiterzuleiten** Im folgenden Beispiel für `create-target-group` wird eine Zielgruppe für einen Application Load Balancer erstellt, in der das Ziel eine Lambda-Funktion ist (der Zieltyp ist `lambda`). Zustandsprüfungen sind für diese Zielgruppe standardmäßig deaktiviert. ``` aws elbv2 create-target-group \ --name my-lambda-target \ --target-type lambda ``` Ausgabe: ``` { "TargetGroups": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-lambda-target/a3003e085dbb8ddc", "TargetGroupName": "my-lambda-target", "HealthCheckEnabled": false, "HealthCheckIntervalSeconds": 35, "HealthCheckTimeoutSeconds": 30, "HealthyThresholdCount": 5, "UnhealthyThresholdCount": 2, "HealthCheckPath": "/", "Matcher": { "HttpCode": "200" }, "TargetType": "lambda", "IpAddressType": "ipv4" } ] } ``` Weitere Informationen finden Sie unter [Lambda-Funktionen als Ziele](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/lambda-functions.html) im *Benutzerhandbuch zu Application Load Balancers*. **Beispiel 3: So erstellen Sie eine Zielgruppe für einen Network Load Balancer** Im folgenden Beispiel für `create-target-group` wird eine Zielgruppe für einen Network Load Balancer erstellt, in der Sie Ziele nach IP-Adresse registrieren (der Zieltyp ist `ip`). Diese Zielgruppe verwendet das TCP-Protokoll, Port 80 und die Standardeinstellungen für die Zustandsprüfung für eine TCP-Zielgruppe. ``` aws elbv2 create-target-group \ --name my-ip-targets \ --protocol TCP \ --port 80 \ --target-type ip \ --vpc-id vpc-3ac0fb5f ``` Ausgabe: ``` { "TargetGroups": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-ip-targets/b6bba954d1361c78", "TargetGroupName": "my-ip-targets", "Protocol": "TCP", "Port": 80, "VpcId": "vpc-3ac0fb5f", "HealthCheckEnabled": true, "HealthCheckProtocol": "TCP", "HealthCheckPort": "traffic-port", "HealthCheckIntervalSeconds": 30, "HealthCheckTimeoutSeconds": 10, "HealthyThresholdCount": 5, "UnhealthyThresholdCount": 2, "TargetType": "ip", "IpAddressType": "ipv4" } ] } ``` Weitere Informationen finden Sie unter [Erstellen einer Zielgruppe](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-target-group.html) im *Benutzerhandbuch für Network Load Balancers*. **Beispiel 4: So erstellen Sie eine Zielgruppe, um Datenverkehr von einem Network Load Balancer zu einem Application Load Balancer weiterzuleiten** Im folgenden Beispiel für `create-target-group` wird eine Zielgruppe für einen Network Load Balancer erstellt, in der Sie einen Application Load Balancer als Ziel registrieren (der Zieltyp ist `alb`). aws elbv2 create-target-group --name my-alb-target --protokoll TCP --port 80 --zieltyp lab --vpc-id vpc-3ac0fb5f Ausgabe: ``` { "TargetGroups": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-alb-target/a3003e085dbb8ddc", "TargetGroupName": "my-alb-target", "Protocol": "TCP", "Port": 80, "VpcId": "vpc-838475fe", "HealthCheckProtocol": "HTTP", "HealthCheckPort": "traffic-port", "HealthCheckEnabled": true, "HealthCheckIntervalSeconds": 30, "HealthCheckTimeoutSeconds": 6, "HealthyThresholdCount": 5, "UnhealthyThresholdCount": 2, "HealthCheckPath": "/", "Matcher": { "HttpCode": "200-399" }, "TargetType": "alb", "IpAddressType": "ipv4" } ] } ``` Weitere Informationen finden Sie unter [Erstellen einer Zielgruppe mit einem Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/application-load-balancer-target.html) im *Benutzerhandbuch für Network Load Balancers*. **Beispiel 5: So erstellen Sie eine Zielgruppe für einen Gateway Load Balancer** Im folgenden Beispiel für `create-target-group` wird eine Zielgruppe für einen Gateway Load Balancer erstellt, wobei das Ziel eine Instance und das Zielgruppenprotokoll `GENEVE` ist. ``` aws elbv2 create-target-group \ --name my-glb-targetgroup \ --protocol GENEVE \ --port 6081 \ --target-type instance \ --vpc-id vpc-838475fe ``` Ausgabe: ``` { "TargetGroups": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-glb-targetgroup/00c3d57eacd6f40b6f", "TargetGroupName": "my-glb-targetgroup", "Protocol": "GENEVE", "Port": 6081, "VpcId": "vpc-838475fe", "HealthCheckProtocol": "TCP", "HealthCheckPort": "80", "HealthCheckEnabled": true, "HealthCheckIntervalSeconds": 10, "HealthCheckTimeoutSeconds": 5, "HealthyThresholdCount": 5, "UnhealthyThresholdCount": 2, "TargetType": "instance" } ] } ``` *Weitere Informationen finden Sie unter Create a target group < https://docs.aws.amazon.com/elasticloadbalancing/ latest/gateway/create -target-group.html>`\$1\$1 im Gateway Load Balancer User Guide.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [CreateTargetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/create-target-group.html)AWS CLI * ### `delete-listener` Das folgende Codebeispiel zeigt die Verwendung`delete-listener`. **AWS CLI** **So löschen Sie einen Listener** Im folgenden Beispiel für `delete-listener` wird der angegebene Listener gelöscht. ``` aws elbv2 delete-listener \ --listener-arn arn:aws:elasticloadbalancing:ua-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 ``` + Einzelheiten zur API finden Sie [DeleteListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/delete-listener.html)in der *AWS CLI Befehlsreferenz*. ### `delete-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`delete-load-balancer`. **AWS CLI** **So löschen Sie einen Load Balancer** Im folgenden Beispiel für `delete-load-balancer` wird der angegebene Load Balancer gelöscht. ``` aws elbv2 delete-load-balancer \ --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 ``` + Einzelheiten zur API finden Sie [DeleteLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/delete-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `delete-rule` Das folgende Codebeispiel zeigt die Verwendung`delete-rule`. **AWS CLI** **So löschen Sie eine Regel** Im folgenden Beispiel für `delete-rule` wird die angegebene Regel gelöscht. ``` aws elbv2 delete-rule \ --rule-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3 ``` + Einzelheiten zur API finden Sie [DeleteRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/delete-rule.html)in der *AWS CLI Befehlsreferenz*. ### `delete-target-group` Das folgende Codebeispiel zeigt die Verwendung`delete-target-group`. **AWS CLI** **So löschen Sie eine Zielgruppe** Im folgenden Beispiel für `delete-target-group` wird die angegebene Zielgruppe gelöscht. ``` aws elbv2 delete-target-group \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-delete.html) im *Benutzerhandbuch für Application Load Balancer*. + Einzelheiten zur API finden Sie [DeleteTargetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/delete-target-group.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-targets` Das folgende Codebeispiel zeigt die Verwendung`deregister-targets`. **AWS CLI** **Beispiel 1: So melden Sie ein Ziel von einer Zielgruppe ab** Im folgenden Beispiel für `deregister-targets` wird die angegebene Instance von der angegebenen Zielgruppe entfernt. ``` aws elbv2 deregister-targets \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 \ --targets Id=i-1234567890abcdef0 ``` **Beispiel 2: So melden Sie ein Ziel ab, das mithilfe von Port-Überschreibungen registriert wurde** Im folgenden Beispiel für `deregister-targets` wird eine Instance aus einer Zielgruppe entfernt, die mithilfe von Port-Überschreibungen registriert wurde. ``` aws elbv2 deregister-targets \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-internal-targets/3bb63f11dfb0faf9 \ --targets Id=i-1234567890abcdef0,Port=80 Id=i-1234567890abcdef0,Port=766 ``` + Einzelheiten zur API finden Sie [DeregisterTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/deregister-targets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-account-limits` Das folgende Codebeispiel zeigt die Verwendung`describe-account-limits`. **AWS CLI** **So beschreiben Sie Ihre Limits für Elastic Load Balancing** Das folgende `describe-account-limits` Beispiel zeigt die Elastic Load Balancing Balancing-Limits für Ihr AWS Konto in der aktuellen Region. ``` aws elbv2 describe-account-limits ``` Ausgabe: ``` { "Limits": [ { "Name": "target-groups", "Max": "3000" }, { "Name": "targets-per-application-load-balancer", "Max": "1000" }, { "Name": "listeners-per-application-load-balancer", "Max": "50" }, { "Name": "rules-per-application-load-balancer", "Max": "100" }, { "Name": "network-load-balancers", "Max": "50" }, { "Name": "targets-per-network-load-balancer", "Max": "3000" }, { "Name": "targets-per-availability-zone-per-network-load-balancer", "Max": "500" }, { "Name": "listeners-per-network-load-balancer", "Max": "50" }, { "Name": "condition-values-per-alb-rule", "Max": "5" }, { "Name": "condition-wildcards-per-alb-rule", "Max": "5" }, { "Name": "target-groups-per-application-load-balancer", "Max": "100" }, { "Name": "target-groups-per-action-on-application-load-balancer", "Max": "5" }, { "Name": "target-groups-per-action-on-network-load-balancer", "Max": "1" }, { "Name": "certificates-per-application-load-balancer", "Max": "25" }, { "Name": "certificates-per-network-load-balancer", "Max": "25" }, { "Name": "targets-per-target-group", "Max": "1000" }, { "Name": "target-id-registrations-per-application-load-balancer", "Max": "1000" }, { "Name": "network-load-balancer-enis-per-vpc", "Max": "1200" }, { "Name": "application-load-balancers", "Max": "50" }, { "Name": "gateway-load-balancers", "Max": "100" }, { "Name": "gateway-load-balancers-per-vpc", "Max": "100" }, { "Name": "geneve-target-groups", "Max": "100" }, { "Name": "targets-per-availability-zone-per-gateway-load-balancer", "Max": "300" } ] } ``` Weitere Informationen finden Sie unter [Quotas](https://docs.aws.amazon.com/general/latest/gr/elb.html#limits_elastic_load_balancer) in der *Allgemeinen AWS -Referenz*. + Einzelheiten zur API finden Sie [DescribeAccountLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-account-limits.html)in der *AWS CLI Befehlsreferenz*. ### `describe-listener-certificates` Das folgende Codebeispiel zeigt die Verwendung`describe-listener-certificates`. **AWS CLI** **So beschreiben Sie die Zertifikate für einen sicheren Listener** In diesem Beispiel werden die Zertifikate für den angegebenen sicheren Listener beschrieben. Befehl: ``` aws elbv2 describe-listener-certificates --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 ``` Ausgabe: ``` { "Certificates": [ { "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/5cc54884-f4a3-4072-80be-05b9ba72f705", "IsDefault": false }, { "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/3dcb0a41-bd72-4774-9ad9-756919c40557", "IsDefault": false }, { "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/fe59da96-6f58-4a22-8eed-6d0d50477e1d", "IsDefault": true } ] } ``` + Einzelheiten zur API finden Sie [DescribeListenerCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-listener-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `describe-listeners` Das folgende Codebeispiel zeigt die Verwendung`describe-listeners`. **AWS CLI** **So beschreiben Sie einen Listener** In diesem Beispiel wird der angegebene Listener beschrieben. Befehl: ``` aws elbv2 describe-listeners --listener-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 ``` Ausgabe: ``` { "Listeners": [ { "Port": 80, "Protocol": "HTTP", "DefaultActions": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", "Type": "forward" } ], "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2" } ] } ``` **So beschreiben Sie die Listener für einen Load Balancer** In diesem Beispiel werden die Listener für den angegebenen Load Balancer beschrieben. Befehl: ``` aws elbv2 describe-listeners --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 ``` Ausgabe: ``` { "Listeners": [ { "Port": 443, "Protocol": "HTTPS", "DefaultActions": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", "Type": "forward" } ], "SslPolicy": "ELBSecurityPolicy-2015-05", "Certificates": [ { "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-server-cert" } ], "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65" }, { "Port": 80, "Protocol": "HTTP", "DefaultActions": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", "Type": "forward" } ], "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2" } ] } ``` + Einzelheiten zur API finden Sie [DescribeListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-listeners.html)in der *AWS CLI Befehlsreferenz*. ### `describe-load-balancer-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-load-balancer-attributes`. **AWS CLI** **So beschreiben Sie Load-Balancer-Attribute** Im folgenden Beispiel für `describe-load-balancer-attributes` werden die Attribute des angegebenen Load Balancers angezeigt. ``` aws elbv2 describe-load-balancer-attributes \ --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 ``` Die folgende Beispielausgabe zeigt die Attribute für einen Application Load Balancer. ``` { "Attributes": [ { "Value": "false", "Key": "access_logs.s3.enabled" }, { "Value": "", "Key": "access_logs.s3.bucket" }, { "Value": "", "Key": "access_logs.s3.prefix" }, { "Value": "60", "Key": "idle_timeout.timeout_seconds" }, { "Value": "false", "Key": "deletion_protection.enabled" }, { "Value": "true", "Key": "routing.http2.enabled" } ] } ``` Die folgende Beispielausgabe beinhaltet die Attribute für einen Network Load Balancer. ``` { "Attributes": [ { "Value": "false", "Key": "access_logs.s3.enabled" }, { "Value": "", "Key": "access_logs.s3.bucket" }, { "Value": "", "Key": "access_logs.s3.prefix" }, { "Value": "false", "Key": "deletion_protection.enabled" }, { "Value": "false", "Key": "load_balancing.cross_zone.enabled" } ] } ``` + Einzelheiten zur API finden Sie [DescribeLoadBalancerAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-load-balancer-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-load-balancers` Das folgende Codebeispiel zeigt die Verwendung`describe-load-balancers`. **AWS CLI** **So beschreiben Sie einen Load Balancer** In diesem Beispiel wird der angegebene Load Balancer beschrieben. Befehl: ``` aws elbv2 describe-load-balancers --load-balancer-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 ``` Ausgabe: ``` { "LoadBalancers": [ { "Type": "application", "Scheme": "internet-facing", "IpAddressType": "ipv4", "VpcId": "vpc-3ac0fb5f", "AvailabilityZones": [ { "ZoneName": "us-west-2a", "SubnetId": "subnet-8360a9e7" }, { "ZoneName": "us-west-2b", "SubnetId": "subnet-b7d581c0" } ], "CreatedTime": "2016-03-25T21:26:12.920Z", "CanonicalHostedZoneId": "Z2P70J7EXAMPLE", "DNSName": "my-load-balancer-424835706.us-west-2.elb.amazonaws.com", "SecurityGroups": [ "sg-5943793c" ], "LoadBalancerName": "my-load-balancer", "State": { "Code": "active" }, "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" } ] } ``` **So beschreiben Sie alle Load Balancers** In diesem Beispiel werden alle Ihre Load Balancers beschrieben. Befehl: ``` aws elbv2 describe-load-balancers ``` + Einzelheiten zur API finden Sie [DescribeLoadBalancers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-load-balancers.html)in der *AWS CLI Befehlsreferenz*. ### `describe-rules` Das folgende Codebeispiel zeigt die Verwendung`describe-rules`. **AWS CLI** **Beispiel 1: So beschreiben Sie eine Regel** Im folgenden Beispiel für `describe-rules` werden Details für die angegebene Regel gezeigt. ``` aws elbv2 describe-rules \ --rule-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee ``` **Beispiel 2: So beschreiben Sie die Regeln für einen Listener** Im folgenden Beispiel für `describe-rules` werden Details zu den Regeln für den angegebenen Listener gezeigt. Die Ausgabe enthält die Standardregel und alle anderen Regeln, die Sie hinzugefügt haben. ``` aws elbv2 describe-rules \ --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 ``` + Einzelheiten zur API finden Sie [DescribeRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-rules.html)in der *AWS CLI Befehlsreferenz*. ### `describe-ssl-policies` Das folgende Codebeispiel zeigt die Verwendung`describe-ssl-policies`. **AWS CLI** **Beispiel 1: So listen Sie die für die SSL-Aushandlung verwendeten Richtlinien nach Load-Balancer-Typ auf** Im folgenden Beispiel für `describe-ssl-policies` werden die Namen der Richtlinien angezeigt, die Sie für die SSL-Aushandlung mit einem Application Load Balancer verwenden können. Im Beispiel wird der Parameter `--query` verwendet, um nur die Namen der Richtlinien anzuzeigen. ``` aws elbv2 describe-ssl-policies \ --load-balancer-type application \ --query SslPolicies[*].Name ``` Ausgabe: ``` [ "ELBSecurityPolicy-2016-08", "ELBSecurityPolicy-TLS13-1-2-2021-06", "ELBSecurityPolicy-TLS13-1-2-Res-2021-06", "ELBSecurityPolicy-TLS13-1-2-Ext1-2021-06", "ELBSecurityPolicy-TLS13-1-2-Ext2-2021-06", "ELBSecurityPolicy-TLS13-1-1-2021-06", "ELBSecurityPolicy-TLS13-1-0-2021-06", "ELBSecurityPolicy-TLS13-1-3-2021-06", "ELBSecurityPolicy-TLS-1-2-2017-01", "ELBSecurityPolicy-TLS-1-1-2017-01", "ELBSecurityPolicy-TLS-1-2-Ext-2018-06", "ELBSecurityPolicy-FS-2018-06", "ELBSecurityPolicy-2015-05", "ELBSecurityPolicy-TLS-1-0-2015-04", "ELBSecurityPolicy-FS-1-2-Res-2019-08", "ELBSecurityPolicy-FS-1-1-2019-08", "ELBSecurityPolicy-FS-1-2-2019-08", "ELBSecurityPolicy-FS-1-2-Res-2020-10" ] ``` **Beispiel 2: So listen Sie die Richtlinien auf, die ein bestimmtes Protokoll unterstützen** Im folgenden Beispiel für `describe-ssl-policies` werden die Namen der Richtlinien angezeigt, die das TLS-1.3-Protokoll unterstützen. Im Beispiel wird der Parameter `--query` verwendet, um nur die Namen der Richtlinien anzuzeigen. ``` aws elbv2 describe-ssl-policies \ --load-balancer-type application \ --query SslPolicies[?contains(SslProtocols,'TLSv1.3')].Name ``` Ausgabe: ``` [ "ELBSecurityPolicy-TLS13-1-2-2021-06", "ELBSecurityPolicy-TLS13-1-2-Res-2021-06", "ELBSecurityPolicy-TLS13-1-2-Ext1-2021-06", "ELBSecurityPolicy-TLS13-1-2-Ext2-2021-06", "ELBSecurityPolicy-TLS13-1-1-2021-06", "ELBSecurityPolicy-TLS13-1-0-2021-06", "ELBSecurityPolicy-TLS13-1-3-2021-06" ] ``` **Beispiel 3: So zeigen Sie die Chiffren für eine Richtlinie an** Im folgenden Beispiel für `describe-ssl-policies` werden die Namen der Chiffren der angegebenen Richtlinie angezeigt. Im Beispiel wird der Parameter `--query` verwendet, um nur die Namen der Chiffren anzuzeigen. Die erste Chiffre in der Liste hat Priorität 1. Die übrigen Chiffren sind in der Reihenfolge ihrer Priorität geordnet. ``` aws elbv2 describe-ssl-policies \ --names ELBSecurityPolicy-TLS13-1-2-2021-06 \ --query SslPolicies[*].Ciphers[*].Name ``` Ausgabe: ``` [ "TLS_AES_128_GCM_SHA256", "TLS_AES_256_GCM_SHA384", "TLS_CHACHA20_POLY1305_SHA256", "ECDHE-ECDSA-AES128-GCM-SHA256", "ECDHE-RSA-AES128-GCM-SHA256", "ECDHE-ECDSA-AES128-SHA256", "ECDHE-RSA-AES128-SHA256", "ECDHE-ECDSA-AES256-GCM-SHA384", "ECDHE-RSA-AES256-GCM-SHA384", "ECDHE-ECDSA-AES256-SHA384", "ECDHE-RSA-AES256-SHA384" ] ``` Weitere Informationen finden Sie unter [Sicherheitsrichtlinien](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies) im *Benutzerhandbuch für Application Load Balancers*. + Einzelheiten zur API finden Sie [DescribeSslPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-ssl-policies.html)in der *AWS CLI Befehlsreferenz*. ### `describe-tags` Das folgende Codebeispiel zeigt die Verwendung`describe-tags`. **AWS CLI** **So beschreiben Sie die einem Load Balancer zugeordneten Tags** In diesem Beispiel werden die Tags beschrieben, die dem angegebenen Load Balancer zugewiesen sind. Befehl: ``` aws elbv2 describe-tags --resource-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 ``` Ausgabe: ``` { "TagDescriptions": [ { "ResourceArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", "Tags": [ { "Value": "lima", "Key": "project" }, { "Value": "digital-media", "Key": "department" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-tags.html)in der *AWS CLI Befehlsreferenz*. ### `describe-target-group-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-target-group-attributes`. **AWS CLI** **So beschreiben Sie Zielgruppenattribute** Im folgenden Beispiel für `describe-target-group-attributes` werden die Attribute der angegebenen Zielgruppe angezeigt. ``` aws elbv2 describe-target-group-attributes \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Die Ausgabe enthält die Attribute, wenn das Protokoll HTTP oder HTTPS ist und der Zieltyp `instance` oder `ip` ist. ``` { "Attributes": [ { "Value": "false", "Key": "stickiness.enabled" }, { "Value": "300", "Key": "deregistration_delay.timeout_seconds" }, { "Value": "lb_cookie", "Key": "stickiness.type" }, { "Value": "86400", "Key": "stickiness.lb_cookie.duration_seconds" }, { "Value": "0", "Key": "slow_start.duration_seconds" } ] } ``` Die folgende Ausgabe enthält die Attribute, wenn das Protokoll HTTP oder HTTPS ist und der Zieltyp `lambda` ist. ``` { "Attributes": [ { "Value": "false", "Key": "lambda.multi_value_headers.enabled" } ] } ``` Die folgende Ausgabe enthält die Attribute, wenn das Protokoll TCP, TLS, UDP oder TCP\$1UDP ist. ``` { "Attributes": [ { "Value": "false", "Key": "proxy_protocol_v2.enabled" }, { "Value": "300", "Key": "deregistration_delay.timeout_seconds" } ] } ``` + Einzelheiten zur API finden Sie [DescribeTargetGroupAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-target-group-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-target-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-target-groups`. **AWS CLI** **Beispiel 1: So beschreiben Sie eine Zielgruppe** Im folgenden Beispiel für `describe-target-groups` werden Details für die angegebene Zielgruppe gezeigt. ``` aws elbv2 describe-target-groups \ --target-group-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Ausgabe: ``` { "TargetGroups": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", "TargetGroupName": "my-targets", "Protocol": "HTTP", "Port": 80, "VpcId": "vpc-3ac0fb5f", "HealthCheckProtocol": "HTTP", "HealthCheckPort": "traffic-port", "HealthCheckEnabled": true, "HealthCheckIntervalSeconds": 30, "HealthCheckTimeoutSeconds": 5, "HealthyThresholdCount": 5, "UnhealthyThresholdCount": 2, "HealthCheckPath": "/", "Matcher": { "HttpCode": "200" }, "LoadBalancerArns": [ "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" ], "TargetType": "instance", "ProtocolVersion": "HTTP1", "IpAddressType": "ipv4" } ] } ``` **Beispiel 2: So beschreiben Sie alle Zielgruppen für einen Load Balancer** Im folgenden Beispiel für `describe-target-groups` werden Details zu allen Zielgruppen für den angegebenen Load Balancer gezeigt. Im Beispiel wird der Parameter `--query` verwendet, um nur die Namen der Zielgruppen anzuzeigen. ``` aws elbv2 describe-target-groups \ --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \ --query TargetGroups[*].TargetGroupName ``` Ausgabe: ``` [ "my-instance-targets", "my-ip-targets", "my-lambda-target" ] ``` Weitere Informationen finden Sie unter [Zielgruppen](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html) im *Application Load Balancers Guide*. + Einzelheiten zur API finden Sie [DescribeTargetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-target-groups.html)in der *AWS CLI Befehlsreferenz.* ### `describe-target-health` Das folgende Codebeispiel zeigt die Verwendung`describe-target-health`. **AWS CLI** **Beispiel 1: So beschreiben Sie den Zustand der Ziele für eine Zielgruppe** Im folgenden Beispiel für `describe-target-health` werden Zustandsdetails für die Ziele der angegebenen Zielgruppe gezeigt. Diese Ziele sind fehlerfrei. ``` aws elbv2 describe-target-health \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Ausgabe: ``` { "TargetHealthDescriptions": [ { "HealthCheckPort": "80", "Target": { "Id": "i-ceddcd4d", "Port": 80 }, "TargetHealth": { "State": "healthy" } }, { "HealthCheckPort": "80", "Target": { "Id": "i-0f76fade", "Port": 80 }, "TargetHealth": { "State": "healthy" } } ] } ``` **Beispiel 2: So beschreiben Sie den Zustand eines Ziels** Im folgenden Beispiel für `describe-target-health` werden Details zum Zustand des angegebenen Ziels gezeigt. Das Ziel ist fehlerfrei. ``` aws elbv2 describe-target-health \ --targets Id=i-0f76fade,Port=80 \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 ``` Ausgabe: ``` { "TargetHealthDescriptions": [ { "HealthCheckPort": "80", "Target": { "Id": "i-0f76fade", "Port": 80 }, "TargetHealth": { "State": "healthy" } } ] } ``` Die folgende Beispielausgabe bezieht sich auf ein Ziel, dessen Zielgruppe nicht in einer Aktion für einen Listener angegeben ist. Dieses Ziel kann keinen Datenverkehr vom Load Balancer empfangen. ``` { "TargetHealthDescriptions": [ { "HealthCheckPort": "80", "Target": { "Id": "i-0f76fade", "Port": 80 }, "TargetHealth": { "State": "unused", "Reason": "Target.NotInUse", "Description": "Target group is not configured to receive traffic from the load balancer" } } ] } ``` Die folgende Beispielausgabe bezieht sich auf ein Ziel, dessen Zielgruppe gerade in einer Aktion für einen Listener angegeben wurde. Das Ziel wird noch registriert. ``` { "TargetHealthDescriptions": [ { "HealthCheckPort": "80", "Target": { "Id": "i-0f76fade", "Port": 80 }, "TargetHealth": { "State": "initial", "Reason": "Elb.RegistrationInProgress", "Description": "Target registration is in progress" } } ] } ``` Nachstehend sehen Sie eine Beispielausgabe für ein fehlerhaftes Ziel. ``` { "TargetHealthDescriptions": [ { "HealthCheckPort": "80", "Target": { "Id": "i-0f76fade", "Port": 80 }, "TargetHealth": { "State": "unhealthy", "Reason": "Target.Timeout", "Description": "Connection to target timed out" } } ] } ``` Die folgende Beispielausgabe bezieht sich auf ein Ziel, bei dem es sich um eine Lambda-Funktion handelt und für das Zustandsprüfungen deaktiviert sind. ``` { "TargetHealthDescriptions": [ { "Target": { "Id": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "AvailabilityZone": "all", }, "TargetHealth": { "State": "unavailable", "Reason": "Target.HealthCheckDisabled", "Description": "Health checks are not enabled for this target" } } ] } ``` + Einzelheiten zur API finden Sie [DescribeTargetHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-target-health.html)in der *AWS CLI Befehlsreferenz*. ### `modify-listener` Das folgende Codebeispiel zeigt die Verwendung`modify-listener`. **AWS CLI** **Beispiel 1: So ändern Sie die Standardaktion in eine Weiterleitungsaktion** Im folgenden Beispiel für `modify-listener` wird die Standardaktion in eine `forward`-Aktion für den angegebenen Listener geändert. ``` aws elbv2 modify-listener \ --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \ --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f ``` Ausgabe: ``` { "Listeners": [ { "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2", "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", "Protocol": "HTTP", "Port": 80, "DefaultActions": [ { "Type": "forward", "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f" } ] } ] } ``` **Beispiel 2: So ändern Sie die Standardaktion in eine Umleitungsaktion** Im folgenden Beispiel für `modify-listener` wird die Standardaktion in eine `redirect`-Aktion für den angegebenen Listener geändert. ``` aws elbv2 modify-listener \ --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \ --default-actions Type=redirect, RedirectConfig='{Protocol=HTTPS,StatusCode=HTTP_302}' ``` Ausgabe: ``` { "Listeners": [ { "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2", "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", "Protocol": "HTTP", "Port": 80, "DefaultActions": [ { "Type": "redirect", "RedirectConfig": { "Protocol": "HTTPS", "Port": "#{port}", "Host": "#{host}", "Path": "/#{path}", "Query": "#{query}", "StatusCode": "HTTP_302", } } ] } ] } ``` **Beispiel 3: So ändern Sie das Serverzertifikat** Im folgenden Beispiel für `modify-listener` wird das Serverzertifikat für den angegebenen HTTPS-Listener geändert. ``` aws elbv2 modify-listener \ --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65 \ --certificates CertificateArn=arn:aws:iam::123456789012:server-certificate/my-new-server-cert ``` Ausgabe: ``` { "Listeners": [ { "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65", "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", "Protocol": "HTTPS", "Port": 443, "DefaultActions": [ { "Type": "forward", "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" } ], "SslPolicy": "ELBSecurityPolicy-2015-05", "Certificates": [ { "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-new-server-cert" } ], } ] } ``` Weitere Informationen finden Sie unter [Listener-Regeln](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#listener-rules) im *Benutzerhandbuch für Application Load Balancers*. + Einzelheiten zur API finden Sie [ModifyListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-listener.html)in der *AWS CLI Befehlsreferenz*. ### `modify-load-balancer-attributes` Das folgende Codebeispiel zeigt die Verwendung`modify-load-balancer-attributes`. **AWS CLI** **So aktivieren Sie den Löschschutz** In diesem Beispiel wird der Löschschutz für den angegebenen Load Balancer aktiviert. Befehl: ``` aws elbv2 modify-load-balancer-attributes --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --attributes Key=deletion_protection.enabled,Value=true ``` Ausgabe: ``` { "Attributes": [ { "Value": "true", "Key": "deletion_protection.enabled" }, { "Value": "false", "Key": "access_logs.s3.enabled" }, { "Value": "60", "Key": "idle_timeout.timeout_seconds" }, { "Value": "", "Key": "access_logs.s3.prefix" }, { "Value": "", "Key": "access_logs.s3.bucket" } ] } ``` **So ändern Sie das Leerlauf-Timeout** In diesem Beispiel wird der Timeoutwert für die Leerlaufzeit für den angegebenen Load Balancer geändert. Befehl: ``` aws elbv2 modify-load-balancer-attributes --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --attributes Key=idle_timeout.timeout_seconds,Value=30 ``` Ausgabe: ``` { "Attributes": [ { "Value": "30", "Key": "idle_timeout.timeout_seconds" }, { "Value": "false", "Key": "access_logs.s3.enabled" }, { "Value": "", "Key": "access_logs.s3.prefix" }, { "Value": "true", "Key": "deletion_protection.enabled" }, { "Value": "", "Key": "access_logs.s3.bucket" } ] } ``` **So aktivieren Sie Zugriffsprotokolle** In diesem Beispiel werden Zugriffsprotokolle für den angegebenen Load Balancer aktiviert. Dazu muss sich der S3-Bucket in derselben Region wie der Load Balancer befinden und über eine Richtlinie verfügen, die Zugriff auf den Elastic-Load-Balancing-Service gewährt. Befehl: ``` aws elbv2 modify-load-balancer-attributes --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --attributes Key=access_logs.s3.enabled,Value=true Key=access_logs.s3.bucket,Value=my-loadbalancer-logs Key=access_logs.s3.prefix,Value=myapp ``` Ausgabe: ``` { "Attributes": [ { "Value": "true", "Key": "access_logs.s3.enabled" }, { "Value": "my-load-balancer-logs", "Key": "access_logs.s3.bucket" }, { "Value": "myapp", "Key": "access_logs.s3.prefix" }, { "Value": "60", "Key": "idle_timeout.timeout_seconds" }, { "Value": "false", "Key": "deletion_protection.enabled" } ] } ``` + Einzelheiten zur API finden Sie [ModifyLoadBalancerAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-load-balancer-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `modify-rule` Das folgende Codebeispiel zeigt die Verwendung`modify-rule`. **AWS CLI** **So ändern Sie eine Regel** Im folgenden Beispiel für `modify-rule` werden die Aktionen und Bedingungen für die angegebene Regel aktualisiert. ``` aws elbv2 modify-rule \ --actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 \ --conditions Field=path-pattern,Values='/images/*' --rule-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee ``` Ausgabe: ``` { "Rules": [ { "Priority": "10", "Conditions": [ { "Field": "path-pattern", "Values": [ "/images/*" ] } ], "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee", "IsDefault": false, "Actions": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", "Type": "forward" } ] } ] } ``` + Einzelheiten zur API finden Sie [ModifyRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-rule.html)in der *AWS CLI Befehlsreferenz*. ### `modify-target-group-attributes` Das folgende Codebeispiel zeigt die Verwendung`modify-target-group-attributes`. **AWS CLI** **So ändern Sie das Zeitlimit für die Verzögerung bei der Abmeldung** In diesem Beispiel wird das Zeitlimit für die Verzögerung bei der Abmeldung auf den angegebenen Wert für die angegebene Zielgruppe festgelegt. Befehl: ``` aws elbv2 modify-target-group-attributes --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 --attributes Key=deregistration_delay.timeout_seconds,Value=600 ``` Ausgabe: ``` { "Attributes": [ { "Value": "false", "Key": "stickiness.enabled" }, { "Value": "600", "Key": "deregistration_delay.timeout_seconds" }, { "Value": "lb_cookie", "Key": "stickiness.type" }, { "Value": "86400", "Key": "stickiness.lb_cookie.duration_seconds" } ] } ``` + Einzelheiten zur API finden Sie [ModifyTargetGroupAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-target-group-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `modify-target-group` Das folgende Codebeispiel zeigt die Verwendung`modify-target-group`. **AWS CLI** **So ändern Sie die Konfiguration der Zustandsprüfungen für eine Zielgruppe** Im folgenden Beispiel für `modify-target-group` wird die Konfiguration der Zustandsprüfungen geändert, die zur Bewertung des Zustands der Ziele für die angegebene Zielgruppe verwendet werden. Aufgrund der Art und Weise, wie die CLI Kommas analysiert, müssen Sie dabei den Bereich für die Option `--matcher` mit einfachen statt mit doppelten Anführungszeichen umgeben. ``` aws elbv2 modify-target-group \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f \ --health-check-protocol HTTPS \ --health-check-port 443 \ --matcher HttpCode='200,299' ``` Ausgabe: ``` { "TargetGroups": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f", "TargetGroupName": "my-https-targets", "Protocol": "HTTPS", "Port": 443, "VpcId": "vpc-3ac0fb5f", "HealthCheckProtocol": "HTTPS", "HealthCheckPort": "443", "HealthCheckEnabled": true, "HealthCheckIntervalSeconds": 30, "HealthCheckTimeoutSeconds": 5, "HealthyThresholdCount": 5, "UnhealthyThresholdCount": 2, "Matcher": { "HttpCode": "200,299" }, "LoadBalancerArns": [ "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" ], "TargetType": "instance", "ProtocolVersion": "HTTP1", "IpAddressType": "ipv4" } ] } ``` Weitere Informationen finden Sie unter [Zielgruppen](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html) im *Application Load Balancers Guide*. + Einzelheiten zur API finden Sie [ModifyTargetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-target-group.html)in der *AWS CLI Befehlsreferenz.* ### `register-targets` Das folgende Codebeispiel zeigt die Verwendung`register-targets`. **AWS CLI** **Beispiel 1: So registrieren Sie Ziele anhand der Instance-ID bei einer Zielgruppe** Im folgenden Beispiel für `register-targets` werden die angegebenen Instances bei einer Zielgruppe registriert. Die Zielgruppe muss den Zieltyp `instance` aufweisen. ``` aws elbv2 register-targets \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 \ --targets Id=i-1234567890abcdef0 Id=i-0abcdef1234567890 ``` **Beispiel 2: So registrieren Sie Ziele mithilfe von Port-Überschreibungen bei einer Zielgruppe** Im folgenden Beispiel für `register-targets` wird die angegebene Instance über mehrere Ports bei einer Zielgruppe registriert. Dadurch können Sie Container auf derselben Instance wie Ziele in der Zielgruppe registrieren. ``` aws elbv2 register-targets \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-internal-targets/3bb63f11dfb0faf9 \ --targets Id=i-0598c7d356eba48d7,Port=80 Id=i-0598c7d356eba48d7,Port=766 ``` **Beispiel 3: So registrieren Sie Ziele anhand der IP-Adresse bei einer Zielgruppe** Im folgenden Beispiel für `register-targets` werden die angegebenen IP-Adressen bei einer Zielgruppe registriert. Die Zielgruppe muss den Zieltyp `ip` aufweisen. ``` aws elbv2 register-targets \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-ip-targets/8518e899d173178f \ --targets Id=10.0.1.15 Id=10.0.1.23 ``` **Beispiel 4: So registrieren Sie eine Lambda-Funktion als Ziel** Im folgenden Beispiel für `register-targets` werden die angegebenen IP-Adressen bei einer Zielgruppe registriert. Die Zielgruppe muss den Zieltyp `lambda` aufweisen. Sie müssen Elastic Load Balancing Berechtigungen zum Aufrufen der Lambda-Funktion gewähren. ``` aws elbv2 register-targets \ --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-ip-targets/8518e899d173178f \ --targets Id=arn:aws:lambda:us-west-2:123456789012:function:my-function ``` + Einzelheiten zur API finden Sie [RegisterTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/register-targets.html)in der *AWS CLI Befehlsreferenz*. ### `remove-listener-certificates` Das folgende Codebeispiel zeigt die Verwendung`remove-listener-certificates`. **AWS CLI** **So entfernen Sie ein Zertifikat von einem sicheren Listener** In diesem Beispiel wird ein Zertifikat vom angegebenen sicheren Listener entfernt. Befehl: ``` aws elbv2 remove-listener-certificates --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 --certificates CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/5cc54884-f4a3-4072-80be-05b9ba72f705 ``` + Einzelheiten zur API finden Sie [RemoveListenerCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/remove-listener-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `remove-tags` Das folgende Codebeispiel zeigt die Verwendung`remove-tags`. **AWS CLI** **So entfernen Sie Tags aus einem Load Balancer** Im folgenden Beispiel für `remove-tags` werden die Tags `project` und `department` vom angegebenen Load Balancer entfernt. ``` aws elbv2 remove-tags \ --resource-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \ --tag-keys project department ``` + Einzelheiten zur API finden Sie [RemoveTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/remove-tags.html)in der *AWS CLI Befehlsreferenz*. ### `set-ip-address-type` Das folgende Codebeispiel zeigt die Verwendung`set-ip-address-type`. **AWS CLI** **So stellen Sie den Adresstyp eines Load Balancers ein** In diesem Beispiel wird der Adresstyp des angegebenen Load Balancers auf `dualstack` eingestellt. Den Load Balancer-Subnetzen müssen zugeordnete IPv6 CIDR-Blöcke haben. Befehl: ``` aws elbv2 set-ip-address-type --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --ip-address-type dualstack ``` Ausgabe: ``` { "IpAddressType": "dualstack" } ``` + *Einzelheiten zur API finden Sie [SetIpAddressType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/set-ip-address-type.html)in AWS CLI der Befehlsreferenz.* ### `set-rule-priorities` Das folgende Codebeispiel zeigt die Verwendung`set-rule-priorities`. **AWS CLI** **So stellen Sie die Regelpriorität ein** In diesem Beispiel wird die Priorität der angegebenen Regel eingestellt. Befehl: ``` aws elbv2 set-rule-priorities --rule-priorities RuleArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3,Priority=5 ``` Ausgabe: ``` { "Rules": [ { "Priority": "5", "Conditions": [ { "Field": "path-pattern", "Values": [ "/img/*" ] } ], "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3", "IsDefault": false, "Actions": [ { "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", "Type": "forward" } ] } ] } ``` + Einzelheiten zur API finden Sie [SetRulePriorities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/set-rule-priorities.html)in der *AWS CLI Befehlsreferenz*. ### `set-security-groups` Das folgende Codebeispiel zeigt die Verwendung`set-security-groups`. **AWS CLI** **So ordnen Sie einem Load Balancer eine Sicherheitsgruppe zu** In diesem Beispiel wird dem angegebenen Load Balancer die genannte Sicherheitsgruppe zugeordnet. Befehl: ``` aws elbv2 set-security-groups --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --security-groups sg-5943793c ``` Ausgabe: ``` { "SecurityGroupIds": [ "sg-5943793c" ] } ``` + Einzelheiten zur API finden Sie [SetSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/set-security-groups.html)in der *AWS CLI Befehlsreferenz*. ### `set-subnets` Das folgende Codebeispiel zeigt die Verwendung`set-subnets`. **AWS CLI** **So aktivieren Sie Availability Zones für einen Load Balancer** In diesem Beispiel wird die Availability Zone für das entsprechende Subnetz des angegebenen Load Balancers aktiviert. Befehl: ``` aws elbv2 set-subnets --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --subnets subnet-8360a9e7 subnet-b7d581c0 ``` Ausgabe: ``` { "AvailabilityZones": [ { "SubnetId": "subnet-8360a9e7", "ZoneName": "us-west-2a" }, { "SubnetId": "subnet-b7d581c0", "ZoneName": "us-west-2b" } ] } ``` + Einzelheiten zur API finden Sie [SetSubnets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/set-subnets.html)in der *AWS CLI Befehlsreferenz*. # ElastiCache Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren ElastiCache. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-tags-to-resource` Das folgende Codebeispiel zeigt, wie Sie`add-tags-to-resource`. **AWS CLI** **So fügen Sie einer Ressource Tags hinzu** Im folgenden Beispiel für `add-tags-to-resource` werden einer Cluster- oder Snapshot-Ressource bis zu 10 Tags – Schlüssel-Wert-Paare – hinzugefügt. ``` aws elasticache add-tags-to-resource \ --resource-name "arn:aws:elasticache:us-east-1:1234567890:cluster:my-mem-cluster" \ --tags '{"20150202":15, "ElastiCache":"Service"}' ``` Ausgabe: ``` { "TagList": [ { "Value": "20150202", "Key": "APIVersion" }, { "Value": "ElastiCache", "Key": "Service" } ] } ``` Weitere Informationen finden Sie unter [Überwachen von Kosten mit Kostenzuordnungs-Tags](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Tagging.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [AddTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/add-tags-to-resource.html)in der *AWS CLI Befehlsreferenz*. ### `authorize-cache-security-group-ingress` Das folgende Codebeispiel zeigt die Verwendung`authorize-cache-security-group-ingress`. **AWS CLI** **So autorisieren Sie eine Cache-Sicherheitsgruppe für den Eingang** Im folgenden Beispiel für `authorize-cache-security-group-ingress` wird einer Cache-Sicherheitsgruppe der Netzwerkeingang gestattet. ``` aws elasticache authorize-cache-security-group-ingress \ --cache-security-group-name "my-sec-grp" \ --ec2-security-group-name "my-ec2-sec-grp" \ --ec2-security-group-owner-id "1234567890" ``` Mit dem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Self-Service-Updates in Amazon ElastiCache im](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Self-Service-Updates.html) *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AuthorizeCacheSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/authorize-cache-security-group-ingress.html)in der *AWS CLI Befehlsreferenz*. ### `batch-apply-update-action` Das folgende Codebeispiel zeigt die Verwendung`batch-apply-update-action`. **AWS CLI** **So wenden Sie ein Service-Update an** Im folgenden Beispiel für `batch-apply-update-action` wird ein Service-Update auf einen Redis-Cluster angewendet. ``` aws elasticache batch-apply-update-action \ --service-update-name elc-xxxxx406-xxx \ --replication-group-ids test-cluster ``` Ausgabe: ``` { "ProcessedUpdateActions": [ { "ReplicationGroupId": "pat-cluster", "ServiceUpdateName": "elc-xxxxx406-xxx", "UpdateActionStatus": "waiting-to-start" } ], "UnprocessedUpdateActions": [] } ``` Weitere Informationen finden Sie unter [Self-Service-Updates in Amazon ElastiCache im](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Self-Service-Updates.html) *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [BatchApplyUpdateAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/batch-apply-update-action.html)in der *AWS CLI Befehlsreferenz*. ### `batch-stop-update-action` Das folgende Codebeispiel zeigt die Verwendung`batch-stop-update-action`. **AWS CLI** **So beenden Sie ein Service-Update** Im folgenden Beispiel für `batch-stop-update-action` wird ein Service-Update auf einen Redis-Cluster angewendet. ``` aws elasticache batch-stop-update-action \ --service-update-name elc-xxxxx406-xxx \ --replication-group-ids test-cluster ``` Ausgabe: ``` { "ProcessedUpdateActions": [ { "ReplicationGroupId": "pat-cluster", "ServiceUpdateName": "elc-xxxxx406-xxx", "UpdateActionStatus": "stopping" } ], "UnprocessedUpdateActions": [] } ``` Weitere Informationen finden Sie unter [Self-Service-Updates in Amazon ElastiCache im](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Self-Service-Updates.html) *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [BatchStopUpdateAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/batch-stop-update-action.html)in der *AWS CLI Befehlsreferenz*. ### `copy-snapshot` Das folgende Codebeispiel zeigt die Verwendung`copy-snapshot`. **AWS CLI** **So kopieren Sie einen Snapshot** Im folgenden Beispiel für `copy-snapshot` wird eine Kopie eines vorhandenen Snapshots erstellt. ``` aws elasticache copy-snapshot \ --source-snapshot-name "my-snapshot" \ --target-snapshot-name "my-snapshot-copy" ``` Ausgabe: ``` { "Snapshot":{ "Engine": "redis", "CacheParameterGroupName": "default.redis3.2", "VpcId": "vpc-3820329f3", "CacheClusterId": "my-redis4", "SnapshotRetentionLimit": 7, "NumCacheNodes": 1, "SnapshotName": "my-snapshot-copy", "CacheClusterCreateTime": "2016-12-21T22:24:04.955Z", "AutoMinorVersionUpgrade": true, "PreferredAvailabilityZone": "us-east-1c", "SnapshotStatus": "creating", "SnapshotSource": "manual", "SnapshotWindow": "07:00-08:00", "EngineVersion": "3.2.4", "NodeSnapshots": [ { "CacheSize": "3 MB", "SnapshotCreateTime": "2016-12-28T07:00:52Z", "CacheNodeId": "0001", "CacheNodeCreateTime": "2016-12-21T22:24:04.955Z" } ], "CacheSubnetGroupName": "default", "Port": 6379, "PreferredMaintenanceWindow": "tue:09:30-tue:10:30", "CacheNodeType": "cache.m3.large" } } ``` Weitere Informationen finden Sie unter [Exportieren eines Backups](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/backups-exporting.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [CopySnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/copy-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-cache-cluster` Das folgende Codebeispiel zeigt die Verwendung`create-cache-cluster`. **AWS CLI** **So erstellen Sie einen Cache-Cluster** Im folgenden Beispiel für `create-cache-cluster` wird mithilfe der Redis-Engine ein Cache-Cluster erstellt. ``` aws elasticache create-cache-cluster \ --cache-cluster-id "cluster-test" \ --engine redis \ --cache-node-type cache.m5.large \ --num-cache-nodes 1 ``` Ausgabe: ``` { "CacheCluster": { "CacheClusterId": "cluster-test", "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "CacheNodeType": "cache.m5.large", "Engine": "redis", "EngineVersion": "5.0.5", "CacheClusterStatus": "creating", "NumCacheNodes": 1, "PreferredMaintenanceWindow": "sat:13:00-sat:14:00", "PendingModifiedValues": {}, "CacheSecurityGroups": [], "CacheParameterGroup": { "CacheParameterGroupName": "default.redis5.0", "ParameterApplyStatus": "in-sync", "CacheNodeIdsToReboot": [] }, "CacheSubnetGroupName": "default", "AutoMinorVersionUpgrade": true, "SnapshotRetentionLimit": 0, "SnapshotWindow": "06:30-07:30", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [Erstellen eines Clusters](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.Create.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [CreateCacheCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/create-cache-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `create-cache-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`create-cache-parameter-group`. **AWS CLI** **So erstellen Sie eine Cache-Parametergruppe** Das folgende `create-cache-parameter-group` Beispiel erstellt eine neue ElastiCache Amazon-Cache-Parametergruppe. ``` aws elasticache create-cache-parameter-group \ --cache-parameter-group-family "redis5.0" \ --cache-parameter-group-name "mygroup" \ --description "mygroup" ``` Ausgabe: ``` { "CacheParameterGroup": { "CacheParameterGroupName": "mygroup", "CacheParameterGroupFamily": "redis5.0", "Description": "my group" } } ``` Weitere Informationen finden Sie unter [Erstellen einer Parametergruppe](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/ParameterGroups.Creating.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [CreateCacheParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/create-cache-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-cache-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`create-cache-subnet-group`. **AWS CLI** **So erstellen Sie eine Cache-Subnetzgruppe** Im folgenden Beispiel für `create-cache-subnet-group` wird eine neue Cache-Subnetzgruppe erstellt. ``` aws elasticache create-cache-subnet-group \ --cache-subnet-group-name "mygroup" \ --cache-subnet-group-description "my subnet group" \ --subnet-ids "subnet-xxxxec4f" ``` Ausgabe: ``` { "CacheSubnetGroup": { "CacheSubnetGroupName": "mygroup", "CacheSubnetGroupDescription": "my subnet group", "VpcId": "vpc-a3e97cdb", "Subnets": [ { "SubnetIdentifier": "subnet-xxxxec4f", "SubnetAvailabilityZone": { "Name": "us-west-2d" } } ] } } ``` Weitere Informationen finden Sie unter [Erstellen einer Cache-Subnetzgruppe](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/VPCs.CreatingSubnetGroup.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [CreateCacheSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/create-cache-subnet-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-global-replication-group` Das folgende Codebeispiel zeigt die Verwendung`create-global-replication-group`. **AWS CLI** **So erstellen Sie eine globale Replikationsgruppe** Im folgenden Beispiel für `create-global-replication-group` wird eine neue globale Replikationsgruppe erstellt. ``` aws elasticache create-global-replication-group \ --global-replication-group-id-suffix my-global-replication-group \ --primary-replication-group-id my-primary-cluster ``` Ausgabe: ``` { "GlobalReplicationGroup": { "GlobalReplicationGroupId": "sgaui-my-global-replication-group", "GlobalReplicationGroupDescription": " ", "Status": "creating", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.6", "Members": [ { "ReplicationGroupId": "my-primary-cluster", "ReplicationGroupRegion": "us-west-2", "Role": "PRIMARY", "AutomaticFailover": "enabled", "Status": "associating" } ], "ClusterEnabled": true, "GlobalNodeGroups": [ { "GlobalNodeGroupId": "sgaui-my-global-replication-group-0001", "Slots": "0-16383" } ], "AuthTokenEnabled": false, "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [AWS Regionsübergreifende Replikation mithilfe von Global Datastore](https://docs.amazonaws.cn/en_us/AmazonElastiCache/latest/red-ug/Redis-Global-Datastore.html) im *Elasticache-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [CreateGlobalReplicationGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/create-global-replication-group.html)in AWS CLI der Befehlsreferenz.* ### `create-replication-group` Das folgende Codebeispiel zeigt die Verwendung`create-replication-group`. **AWS CLI** **So erstellen Sie eine Replikationsgruppe** Im folgenden Beispiel für `create-replication-group` wird eine Redis-Replikationsgruppe (Cluster-Modus deaktiviert oder aktiviert) erstellt. Dieser Vorgang ist nur für Redis gültig. ``` aws elasticache create-replication-group \ --replication-group-id "mygroup" \ --replication-group-description "my group" \ --engine "redis" \ --cache-node-type "cache.m5.large" ``` Ausgabe: ``` { "ReplicationGroup": { "ReplicationGroupId": "mygroup", "Description": "my group", "Status": "creating", "PendingModifiedValues": {}, "MemberClusters": [ "mygroup-001" ], "AutomaticFailover": "disabled", "SnapshotRetentionLimit": 0, "SnapshotWindow": "06:00-07:00", "ClusterEnabled": false, "CacheNodeType": "cache.m5.large", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [Erstellen einer Redis-Replikationsgruppe](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Replication.CreatingRepGroup.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [CreateReplicationGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/create-replication-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-snapshot`. **AWS CLI** **So erstellen Sie einen Snapshot** Im folgenden Beispiel für `create-snapshot` wird mithilfe der Redis-Engine ein Snapshot erstellt. ``` aws elasticache create-snapshot \ --snapshot-name mysnapshot \ --cache-cluster-id cluster-test ``` Ausgabe: ``` { "Snapshot": { "SnapshotName": "mysnapshot", "CacheClusterId": "cluster-test", "SnapshotStatus": "creating", "SnapshotSource": "manual", "CacheNodeType": "cache.m5.large", "Engine": "redis", "EngineVersion": "5.0.5", "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-west-2b", "CacheClusterCreateTime": "2020-03-19T03:12:01.483Z", "PreferredMaintenanceWindow": "sat:13:00-sat:14:00", "Port": 6379, "CacheParameterGroupName": "default.redis5.0", "CacheSubnetGroupName": "default", "VpcId": "vpc-a3e97cdb", "AutoMinorVersionUpgrade": true, "SnapshotRetentionLimit": 0, "SnapshotWindow": "06:30-07:30", "NodeSnapshots": [ { "CacheNodeId": "0001", "CacheSize": "", "CacheNodeCreateTime": "2020-03-19T03:12:01.483Z" } ] } } ``` Weitere Informationen finden Sie unter [Backup and Restore ElastiCache für Redis](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/backups.html) im *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateSnapshot AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/create-snapshot.html)*Befehlsreferenz*. ### `create-user-group` Das folgende Codebeispiel zeigt die Verwendung`create-user-group`. **AWS CLI** **Um eine Benutzergruppe zu erstellen** Im folgenden Beispiel für `create-user-group` wird eine neue Benutzergruppe erstellt. ``` aws elasticache create-user-group \ --user-group-id myusergroup \ --engine redis \ --user-ids default ``` Ausgabe: ``` { "UserGroupId": "myusergroup", "Status": "creating", "Engine": "redis", "UserIds": [ "default" ], "ReplicationGroups": [], "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:usergroup:myusergroup" } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit der rollenbasierten Zugriffskontrolle (RBAC)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.RBAC.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [CreateUserGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/create-user-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-user` Das folgende Codebeispiel zeigt die Verwendung`create-user`. **AWS CLI** **Um einen Benutzer zu erstellen** Im folgenden Beispiel für `create-user` wird ein neuer Benutzer erstellt. ``` aws elasticache create-user \ --user-id user1 \ --user-name myUser \ --passwords mYnuUzrpAxXw2rdzx \ --engine redis \ --access-string "on ~app::* -@all +@read" ``` Ausgabe: ``` { "UserId": "user2", "UserName": "myUser", "Status": "active", "Engine": "redis", "AccessString": "on ~app::* -@all +@read +@hash +@bitmap +@geo -setbit -bitfield -hset -hsetnx -hmset -hincrby -hincrbyfloat -hdel -bitop -geoadd -georadius -georadiusbymember", "UserGroupIds": [], "Authentication": { "Type": "password", "PasswordCount": 1 }, "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:user:user2" } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit der rollenbasierten Zugriffskontrolle (RBAC)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.RBAC.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [CreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/create-user.html)in der *AWS CLI Befehlsreferenz*. ### `decrease-node-groups-in-global-replication-group` Das folgende Codebeispiel zeigt die Verwendung`decrease-node-groups-in-global-replication-group`. **AWS CLI** **So verringern Sie die Anzahl der Knotengruppen in einer globalen Replikationsgruppe** Im folgenden Beispiel für `decrease-node-groups-in-global-replication-group` wird die Anzahl der Knotengruppen mithilfe der Redis-Engine verringert. ``` aws elasticache decrease-node-groups-in-global-replication-group \ --global-replication-group-id sgaui-test \ --node-group-count 1 \ --apply-immediately \ --global-node-groups-to-retain sgaui-test-0003 ``` Ausgabe: ``` { "GlobalReplicationGroup": { "GlobalReplicationGroupId": "sgaui-test", "GlobalReplicationGroupDescription": "test", "Status": "modifying", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.6", "Members": [ { "ReplicationGroupId": "test-2", "ReplicationGroupRegion": "us-east-1", "Role": "SECONDARY", "AutomaticFailover": "enabled", "Status": "associated" }, { "ReplicationGroupId": "test-1", "ReplicationGroupRegion": "us-west-2", "Role": "PRIMARY", "AutomaticFailover": "enabled", "Status": "associated" } ], "ClusterEnabled": true, "GlobalNodeGroups": [ { "GlobalNodeGroupId": "sgaui-test-0001", "Slots": "0-449,1816-5461" }, { "GlobalNodeGroupId": "sgaui-test-0002", "Slots": "6827-10922" }, { "GlobalNodeGroupId": "sgaui-test-0003", "Slots": "10923-14052,15418-16383" }, { "GlobalNodeGroupId": "sgaui-test-0004", "Slots": "450-1815,5462-6826,14053-15417" } ], "AuthTokenEnabled": false, "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [AWS Regionsübergreifende Replikation mithilfe von Global Datastore](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Redis-Global-Datastore.html) im *Elasticache-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [DecreaseNodeGroupsInGlobalReplicationGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/decrease-node-groups-in-global-replication-group.html)in AWS CLI der Befehlsreferenz.* ### `decrease-replica-count` Das folgende Codebeispiel zeigt die Verwendung`decrease-replica-count`. **AWS CLI** **So verringern Sie die Anzahl der Replikate** Im folgenden Beispiel für `decrease-replica-count` wird die Anzahl der Replikate in einer Redis-Replikationsgruppe (Cluster-Modus deaktiviert) oder die Anzahl der Replikationsknoten in einer oder mehreren Knotengruppen (Shards) einer Redis-Replikationsgruppe (Cluster-Modus aktiviert) dynamisch verringert. Dieser Vorgang wird ohne Cluster-Ausfallzeit ausgeführt. ``` aws elasticache decrease-replica-count \ --replication-group-id my-cluster \ --apply-immediately \ --new-replica-count 2 ``` Ausgabe: ``` { "ReplicationGroup": { "ReplicationGroupId": "my-cluster", "Description": " ", "Status": "modifying", "PendingModifiedValues": {}, "MemberClusters": [ "myrepliace", "my-cluster-001", "my-cluster-002", "my-cluster-003" ], "NodeGroups": [ { "NodeGroupId": "0001", "Status": "modifying", "PrimaryEndpoint": { "Address": "my-cluster.xxxxx.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "ReaderEndpoint": { "Address": "my-cluster-ro.xxxxx.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "NodeGroupMembers": [ { "CacheClusterId": "myrepliace", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "myrepliace.xxxxx.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "replica" }, { "CacheClusterId": "my-cluster-001", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "my-cluster-001.xxxxx.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "primary" }, { "CacheClusterId": "my-cluster-002", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "my-cluster-002.xxxxx.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "replica" }, { "CacheClusterId": "my-cluster-003", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "my-cluster-003.xxxxx.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "replica" } ] } ], "AutomaticFailover": "disabled", "SnapshotRetentionLimit": 0, "SnapshotWindow": "07:30-08:30", "ClusterEnabled": false, "CacheNodeType": "cache.r5.xlarge", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [Ändern der Anzahl von Replikaten](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/increase-decrease-replica-count.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DecreaseReplicaCount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/decrease-replica-count.html)in der *AWS CLI Befehlsreferenz*. ### `delete-cache-cluster` Das folgende Codebeispiel zeigt die Verwendung`delete-cache-cluster`. **AWS CLI** **So löschen Sie einen Cache-Cluster** Im folgenden Beispiel für `delete-cache-cluster` wird der angegebene, zuvor bereitgestellte Cluster gelöscht. Mit dem Befehl werden alle zugehörigen Cache-Knoten, Knotenendpunkte und der Cluster selbst gelöscht. Wenn Sie von diesem Vorgang eine erfolgreiche Antwort erhalten, beginnt Amazon ElastiCache sofort mit dem Löschen des Clusters. Sie können diesen Vorgang nicht abbrechen oder rückgängig machen. Dieser Vorgang ist für Folgendes nicht gültig: Redis-Cluster (Cluster-Modus aktiviert); ein Cluster, der das zuletzt gelesene Replikat einer Replikationsgruppe ist; eine Knotengruppe (Shard), für die der Multi-AZ-Modus aktiviert ist; ein Cluster aus einer Redis-Replikationsgruppe (Cluster-Modus aktiviert); ein Cluster, der sich nicht im verfügbaren Status befindet ``` aws elasticache delete-cache-cluster \ --cache-cluster-id "my-cluster-002" ``` Ausgabe: ``` { "CacheCluster": { "CacheClusterId": "my-cluster-002", "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "CacheNodeType": "cache.r5.xlarge", "Engine": "redis", "EngineVersion": "5.0.5", "CacheClusterStatus": "deleting", "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-west-2a", "CacheClusterCreateTime": "2019-11-26T03:35:04.546Z", "PreferredMaintenanceWindow": "mon:04:05-mon:05:05", "PendingModifiedValues": {}, "NotificationConfiguration": { "TopicArn": "arn:aws:sns:us-west-x:xxxxxxx4152:My_Topic", "TopicStatus": "active" }, "CacheSecurityGroups": [], "CacheParameterGroup": { "CacheParameterGroupName": "mygroup", "ParameterApplyStatus": "in-sync", "CacheNodeIdsToReboot": [] }, "CacheSubnetGroupName": "kxkxk", "AutoMinorVersionUpgrade": true, "SecurityGroups": [ { "SecurityGroupId": "sg-xxxxxxxxxx9836", "Status": "active" }, { "SecurityGroupId": "sg-xxxxxxxxxxxx7b", "Status": "active" } ], "ReplicationGroupId": "my-cluster", "SnapshotRetentionLimit": 0, "SnapshotWindow": "07:30-08:30", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [Löschen eines Clusters](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.Delete.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DeleteCacheCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/delete-cache-cluster.html)in der *AWS CLI Befehlsreferenz.* ### `delete-cache-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`delete-cache-parameter-group`. **AWS CLI** **So löschen Sie eine Cache-Parametergruppe** Im folgenden Beispiel für `delete-cache-parameter-group` wird die angegebene Cache-Parametergruppe gelöscht. Cache-Parametergruppen, die Cache-Clustern zugeordnet sind, können nicht gelöscht werden. ``` aws elasticache delete-cache-parameter-group \ --cache-parameter-group-name myparamgroup ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Parametergruppe](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/ParameterGroups.Deleting.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DeleteCacheParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/delete-cache-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-cache-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`delete-cache-subnet-group`. **AWS CLI** **So löschen Sie eine Cache-Subnetzgruppe** Im folgenden Beispiel für `delete-cache-subnet-group` wird die angegebene Cache-Subnetzgruppe gelöscht. Cache-Subnetzgruppen, die Clustern zugeordnet sind, können nicht gelöscht werden. ``` aws elasticache delete-cache-subnet-group \ --cache-subnet-group-name "mygroup" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Subnetzgruppe](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/SubnetGroups.Deleting.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DeleteCacheSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/delete-cache-subnet-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-global-replication-group` Das folgende Codebeispiel zeigt die Verwendung`delete-global-replication-group`. **AWS CLI** **So löschen Sie eine globale Replikationsgruppe** Im folgenden Beispiel für `delete-global-replication-group` wird eine neue globale Replikationsgruppe gelöscht. ``` aws elasticache delete-global-replication-group \ --global-replication-group-id my-global-replication-group \ --retain-primary-replication-group ``` Ausgabe: ``` { "GlobalReplicationGroup": { "GlobalReplicationGroupId": "sgaui-my-grg", "GlobalReplicationGroupDescription": "my-grg", "Status": "deleting", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.6", "Members": [ { "ReplicationGroupId": "my-cluster-grg", "ReplicationGroupRegion": "us-west-2", "Role": "PRIMARY", "AutomaticFailover": "enabled", "Status": "associated" } ], "ClusterEnabled": false, "AuthTokenEnabled": false, "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [AWS Regionsübergreifende Replikation mithilfe von Global Datastore](https://docs.amazonaws.cn/en_us/AmazonElastiCache/latest/red-ug/Redis-Global-Datastore.html) im *Elasticache-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [DeleteGlobalReplicationGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/delete-global-replication-group.html)in AWS CLI der Befehlsreferenz.* ### `delete-replication-group` Das folgende Codebeispiel zeigt die Verwendung`delete-replication-group`. **AWS CLI** **So löschen Sie eine Replikationsgruppe** Im folgenden Beispiel für `delete-replication-group` wird eine vorhandene Replikationsgruppe gelöscht. Standardmäßig löscht dieser Vorgang die gesamte Replikationsgruppe, einschließlich der primary/primaries und aller Read Replicas. Wenn die Replikationsgruppe nur über eine primäre Gruppe verfügt, können Sie optional nur die Read Replicas löschen und dabei die Primärreplikate beibehalten, indem Sie =true setzen. RetainPrimaryCluster Wenn Sie von diesem Vorgang eine erfolgreiche Antwort erhalten, beginnt Amazon ElastiCache sofort mit dem Löschen der ausgewählten Ressourcen. Sie können diesen Vorgang nicht stornieren oder rückgängig machen. Gilt nur für Redis. ``` aws elasticache delete-replication-group \ --replication-group-id "mygroup" ``` Ausgabe: ``` { "ReplicationGroup": { "ReplicationGroupId": "mygroup", "Description": "my group", "Status": "deleting", "PendingModifiedValues": {}, "AutomaticFailover": "disabled", "SnapshotRetentionLimit": 0, "SnapshotWindow": "06:00-07:00", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` + Einzelheiten zur API finden Sie [DeleteReplicationGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/delete-replication-group.html)in der *AWS CLI Befehlsreferenz.* ### `delete-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-snapshot`. **AWS CLI** **So löschen Sie einen Snapshot** Im folgenden Beispiel für `delete-snapshot` wird ein Snapshot mithilfe der Redis-Engine gelöscht. ``` aws elasticache delete-snapshot \ --snapshot-name mysnapshot ``` Ausgabe: ``` { "Snapshot": { "SnapshotName": "my-cluster-snapshot", "ReplicationGroupId": "mycluster", "ReplicationGroupDescription": "mycluster", "SnapshotStatus": "deleting", "SnapshotSource": "manual", "CacheNodeType": "cache.r5.xlarge", "Engine": "redis", "EngineVersion": "5.0.5", "PreferredMaintenanceWindow": "thu:12:00-thu:13:00", "TopicArn": "arn:aws:sns:us-west-2:xxxxxxxxxxxxx152:My_Topic", "Port": 6379, "CacheParameterGroupName": "default.redis5.0.cluster.on", "CacheSubnetGroupName": "default", "VpcId": "vpc-a3e97cdb", "AutoMinorVersionUpgrade": true, "SnapshotRetentionLimit": 1, "SnapshotWindow": "13:00-14:00", "NumNodeGroups": 4, "AutomaticFailover": "enabled", "NodeSnapshots": [ { "CacheClusterId": "mycluster-0002-003", "NodeGroupId": "0002", "CacheNodeId": "0001", "CacheSize": "6 MB", "CacheNodeCreateTime": "2020-06-18T00:05:44.719000+00:00", "SnapshotCreateTime": "2020-06-25T20:34:30+00:00" }, { "CacheClusterId": "mycluster-0003-003", "NodeGroupId": "0003", "CacheNodeId": "0001", "CacheSize": "6 MB", "CacheNodeCreateTime": "2019-12-05T19:13:15.912000+00:00", "SnapshotCreateTime": "2020-06-25T20:34:30+00:00" }, { "CacheClusterId": "mycluster-0004-002", "NodeGroupId": "0004", "CacheNodeId": "0001", "CacheSize": "6 MB", "CacheNodeCreateTime": "2019-12-09T19:44:34.324000+00:00", "SnapshotCreateTime": "2020-06-25T20:34:30+00:00" }, { "CacheClusterId": "mycluster-0005-003", "NodeGroupId": "0005", "CacheNodeId": "0001", "CacheSize": "6 MB", "CacheNodeCreateTime": "2020-06-18T00:05:44.775000+00:00", "SnapshotCreateTime": "2020-06-25T20:34:30+00:00" } ] } } ``` Weitere Informationen finden Sie unter [Backup and Restore ElastiCache für Redis](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/backups.html) im *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteSnapshot AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/delete-snapshot.html)*Befehlsreferenz*. ### `delete-user-group` Das folgende Codebeispiel zeigt die Verwendung`delete-user-group`. **AWS CLI** **So löschen Sie eine Benutzergruppe** Im folgenden Beispiel für `delete-user-group` wird eine Benutzergruppe gelöscht. ``` aws elasticache delete-user-group \ --user-group-id myusergroup ``` Ausgabe: ``` { "UserGroupId": "myusergroup", "Status": "deleting", "Engine": "redis", "UserIds": [ "default" ], "ReplicationGroups": [], "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:usergroup:myusergroup" } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit der rollenbasierten Zugriffskontrolle (RBAC)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.RBAC.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DeleteUserGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/delete-user-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-user` Das folgende Codebeispiel zeigt die Verwendung`delete-user`. **AWS CLI** **So löschen Sie einen Benutzer** Im folgenden Beispiel für `delete-user` wird ein Benutzer gelöscht. ``` aws elasticache delete-user \ --user-id user2 ``` Ausgabe: ``` { "UserId": "user1", "UserName": "myUser", "Status": "deleting", "Engine": "redis", "AccessString": "on ~* +@all", "UserGroupIds": [ "myusergroup" ], "Authentication": { "Type": "password", "PasswordCount": 1 }, "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:user:user1" } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit der rollenbasierten Zugriffskontrolle (RBAC)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.RBAC.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/delete-user.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cache-clusters` Das folgende Codebeispiel zeigt die Verwendung`describe-cache-clusters`. **AWS CLI** **So beschreiben Sie einen Cache-Cluster** Im folgenden Beispiel für `describe-cache-clusters` wird ein Cache-Cluster beschrieben. ``` aws elasticache describe-cache-clusters ``` Ausgabe: ``` { "CacheClusters": [ { "CacheClusterId": "my-cluster-003", "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.5", "CacheClusterStatus": "available", "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-west-2a", "CacheClusterCreateTime": "2019-11-26T01:22:52.396Z", "PreferredMaintenanceWindow": "mon:17:30-mon:18:30", "PendingModifiedValues": {}, "NotificationConfiguration": { "TopicArn": "arn:aws:sns:us-west-2:xxxxxxxxxxx152:My_Topic", "TopicStatus": "active" }, "CacheSecurityGroups": [], "CacheParameterGroup": { "CacheParameterGroupName": "default.redis5.0", "ParameterApplyStatus": "in-sync", "CacheNodeIdsToReboot": [] }, "CacheSubnetGroupName": "kxkxk", "AutoMinorVersionUpgrade": true, "SecurityGroups": [ { "SecurityGroupId": "sg-xxxxxd7b", "Status": "active" } ], "ReplicationGroupId": "my-cluster", "SnapshotRetentionLimit": 0, "SnapshotWindow": "06:30-07:30", "AuthTokenEnabled": false, "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false, "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxxx152:cluster:my-cache-cluster", "ReplicationGroupLogDeliveryEnabled": false, "LogDeliveryConfigurations": [ { "LogType": "slow-log", "DestinationType": "cloudwatch-logs", "DestinationDetails": { "CloudWatchLogsDetails": { "LogGroup": "test-log" } }, "LogFormat": "text", "Status": "active" } ] } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Clustern](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DescribeCacheClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-cache-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cache-engine-versions` Das folgende Codebeispiel zeigt die Verwendung`describe-cache-engine-versions`. **AWS CLI** **So beschreiben Sie eine Cache-Engine-Version** Im folgenden Beispiel für `describe-cache-engine-versions` wird eine Liste der verfügbaren Cache-Engines und deren Versionen zurückgegeben. ``` aws elasticache describe-cache-engine-versions \ --engine "Redis" ``` Ausgabe: ``` { "CacheEngineVersions": [ { "Engine": "redis", "EngineVersion": "2.6.13", "CacheParameterGroupFamily": "redis2.6", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 2.6.13" }, { "Engine": "redis", "EngineVersion": "2.8.19", "CacheParameterGroupFamily": "redis2.8", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 2.8.19" }, { "Engine": "redis", "EngineVersion": "2.8.21", "CacheParameterGroupFamily": "redis2.8", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 2.8.21" }, { "Engine": "redis", "EngineVersion": "2.8.22", "CacheParameterGroupFamily": "redis2.8", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 2.8.22" }, { "Engine": "redis", "EngineVersion": "2.8.23", "CacheParameterGroupFamily": "redis2.8", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 2.8.23" }, { "Engine": "redis", "EngineVersion": "2.8.24", "CacheParameterGroupFamily": "redis2.8", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 2.8.24" }, { "Engine": "redis", "EngineVersion": "2.8.6", "CacheParameterGroupFamily": "redis2.8", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 2.8.6" }, { "Engine": "redis", "EngineVersion": "3.2.10", "CacheParameterGroupFamily": "redis3.2", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 3.2.10" }, { "Engine": "redis", "EngineVersion": "3.2.4", "CacheParameterGroupFamily": "redis3.2", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 3.2.4" }, { "Engine": "redis", "EngineVersion": "3.2.6", "CacheParameterGroupFamily": "redis3.2", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 3.2.6" }, { "Engine": "redis", "EngineVersion": "4.0.10", "CacheParameterGroupFamily": "redis4.0", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 4.0.10" }, { "Engine": "redis", "EngineVersion": "5.0.0", "CacheParameterGroupFamily": "redis5.0", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 5.0.0" }, { "Engine": "redis", "EngineVersion": "5.0.3", "CacheParameterGroupFamily": "redis5.0", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 5.0.3" }, { "Engine": "redis", "EngineVersion": "5.0.4", "CacheParameterGroupFamily": "redis5.0", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 5.0.4" }, { "Engine": "redis", "EngineVersion": "5.0.5", "CacheParameterGroupFamily": "redis5.0", "CacheEngineDescription": "Redis", "CacheEngineVersionDescription": "redis version 5.0.5" } ] } ``` + Einzelheiten zur API finden Sie [DescribeCacheEngineVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-cache-engine-versions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cache-parameter-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-cache-parameter-groups`. **AWS CLI** **So beschreiben Sie eine Cache-Parametergruppe** Im folgenden Beispiel für `describe-cache-parameter-groups` wird eine Liste mit Beschreibungen von Cache-Parametergruppen zurückgegeben. ``` aws elasticache describe-cache-parameter-groups \ --cache-parameter-group-name "mygroup" ``` Ausgabe: ``` { "CacheParameterGroups": [ { "CacheParameterGroupName": "mygroup", "CacheParameterGroupFamily": "redis5.0", "Description": " " } ] } ``` Weitere Informationen finden Sie unter [Konfigurieren von Engine-Parametern mithilfe von Parametergruppen](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/ParameterGroups.html) im *Benutzerhandbuch für ElastiCache*. + Einzelheiten zur API finden Sie [DescribeCacheParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-cache-parameter-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cache-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-cache-parameters`. **AWS CLI** **So beschreiben Sie Cache-Parameter** Das folgende Beispiel "describe-cache-parameters" gibt die detaillierte Parameterliste für die angegebene Cache-Parametergruppe zurück. ``` aws elasticache describe-cache-parameters \ --cache-parameter-group-name "myparamgroup" ``` Ausgabe: ``` { "Parameters": [ { "ParameterName": "activedefrag", "ParameterValue": "yes", "Description": "Enabled active memory defragmentation", "Source": "user", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-cycle-max", "ParameterValue": "75", "Description": "Maximal effort for defrag in CPU percentage", "Source": "user", "DataType": "integer", "AllowedValues": "1-75", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-cycle-min", "ParameterValue": "5", "Description": "Minimal effort for defrag in CPU percentage", "Source": "user", "DataType": "integer", "AllowedValues": "1-75", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-ignore-bytes", "ParameterValue": "104857600", "Description": "Minimum amount of fragmentation waste to start active defrag", "Source": "user", "DataType": "integer", "AllowedValues": "1048576-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-max-scan-fields", "ParameterValue": "1000", "Description": "Maximum number of set/hash/zset/list fields that will be processed from the main dictionary scan", "Source": "user", "DataType": "integer", "AllowedValues": "1-1000000", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-threshold-lower", "ParameterValue": "10", "Description": "Minimum percentage of fragmentation to start active defrag", "Source": "user", "DataType": "integer", "AllowedValues": "1-100", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-threshold-upper", "ParameterValue": "100", "Description": "Maximum percentage of fragmentation at which we use maximum effort", "Source": "user", "DataType": "integer", "AllowedValues": "1-100", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "activerehashing", "ParameterValue": "yes", "Description": "Apply rehashing or not.", "Source": "user", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "requires-reboot" }, { "ParameterName": "appendfsync", "ParameterValue": "everysec", "Description": "fsync policy for AOF persistence", "Source": "system", "DataType": "string", "AllowedValues": "always,everysec,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "appendonly", "ParameterValue": "no", "Description": "Enable Redis persistence.", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-normal-hard-limit", "ParameterValue": "0", "Description": "Normal client output buffer hard limit in bytes.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-normal-soft-limit", "ParameterValue": "0", "Description": "Normal client output buffer soft limit in bytes.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-normal-soft-seconds", "ParameterValue": "0", "Description": "Normal client output buffer soft limit in seconds.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-pubsub-hard-limit", "ParameterValue": "33554432", "Description": "Pubsub client output buffer hard limit in bytes.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-pubsub-soft-limit", "ParameterValue": "8388608", "Description": "Pubsub client output buffer soft limit in bytes.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-pubsub-soft-seconds", "ParameterValue": "60", "Description": "Pubsub client output buffer soft limit in seconds.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-replica-soft-seconds", "ParameterValue": "60", "Description": "Replica client output buffer soft limit in seconds.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-query-buffer-limit", "ParameterValue": "1073741824", "Description": "Max size of a single client query buffer", "Source": "user", "DataType": "integer", "AllowedValues": "1048576-1073741824", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "close-on-replica-write", "ParameterValue": "yes", "Description": "If enabled, clients who attempt to write to a read-only replica will be disconnected. Applicable to 2.8.23 and higher.", "Source": "user", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "cluster-enabled", "ParameterValue": "no", "Description": "Enable cluster mode", "Source": "user", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "requires-reboot" }, { "ParameterName": "cluster-require-full-coverage", "ParameterValue": "no", "Description": "Whether cluster becomes unavailable if one or more slots are not covered", "Source": "user", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "databases", "ParameterValue": "16", "Description": "Set the number of databases.", "Source": "user", "DataType": "integer", "AllowedValues": "1-1200000", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "requires-reboot" }, { "ParameterName": "hash-max-ziplist-entries", "ParameterValue": "512", "Description": "The maximum number of hash entries in order for the dataset to be compressed.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "hash-max-ziplist-value", "ParameterValue": "64", "Description": "The threshold of biggest hash entries in order for the dataset to be compressed.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "hll-sparse-max-bytes", "ParameterValue": "3000", "Description": "HyperLogLog sparse representation bytes limit", "Source": "user", "DataType": "integer", "AllowedValues": "1-16000", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lazyfree-lazy-eviction", "ParameterValue": "no", "Description": "Perform an asynchronous delete on evictions", "Source": "user", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lazyfree-lazy-expire", "ParameterValue": "no", "Description": "Perform an asynchronous delete on expired keys", "Source": "user", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lazyfree-lazy-server-del", "ParameterValue": "no", "Description": "Perform an asynchronous delete on key updates", "Source": "user", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lfu-decay-time", "ParameterValue": "1", "Description": "The amount of time in minutes to decrement the key counter for LFU eviction policy", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lfu-log-factor", "ParameterValue": "10", "Description": "The log factor for incrementing key counter for LFU eviction policy", "Source": "user", "DataType": "integer", "AllowedValues": "1-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "list-compress-depth", "ParameterValue": "0", "Description": "Number of quicklist ziplist nodes from each side of the list to exclude from compression. The head and tail of the list are always uncompressed for fast push/pop operations", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "list-max-ziplist-size", "ParameterValue": "-2", "Description": "The number of entries allowed per internal list node can be specified as a fixed maximum size or a maximum number of elements", "Source": "system", "DataType": "integer", "AllowedValues": "-5,-4,-3,-2,-1,1-", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lua-replicate-commands", "ParameterValue": "yes", "Description": "Always enable Lua effect replication or not", "Source": "user", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lua-time-limit", "ParameterValue": "5000", "Description": "Max execution time of a Lua script in milliseconds. 0 for unlimited execution without warnings.", "Source": "system", "DataType": "integer", "AllowedValues": "5000", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "maxclients", "ParameterValue": "65000", "Description": "The maximum number of Redis clients.", "Source": "system", "DataType": "integer", "AllowedValues": "1-65000", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "requires-reboot" }, { "ParameterName": "maxmemory-policy", "ParameterValue": "volatile-lru", "Description": "Max memory policy.", "Source": "user", "DataType": "string", "AllowedValues": "volatile-lru,allkeys-lru,volatile-lfu,allkeys-lfu,volatile-random,allkeys-random,volatile-ttl,noeviction", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "maxmemory-samples", "ParameterValue": "3", "Description": "Max memory samples.", "Source": "user", "DataType": "integer", "AllowedValues": "1-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "min-replicas-max-lag", "ParameterValue": "10", "Description": "The maximum amount of replica lag in seconds beyond which the master would stop taking writes. A value of 0 means the master always takes writes.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "min-replicas-to-write", "ParameterValue": "0", "Description": "The minimum number of replicas that must be present with lag no greater than min-replicas-max-lag for master to take writes. Setting this to 0 means the master always takes writes.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "notify-keyspace-events", "Description": "The keyspace events for Redis to notify Pub/Sub clients about. By default all notifications are disabled", "Source": "user", "DataType": "string", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "proto-max-bulk-len", "ParameterValue": "536870912", "Description": "Max size of a single element request", "Source": "user", "DataType": "integer", "AllowedValues": "1048576-536870912", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "rename-commands", "ParameterValue": "", "Description": "Redis commands that can be dynamically renamed by the customer", "Source": "user", "DataType": "string", "AllowedValues": "APPEND,BITCOUNT,BITFIELD,BITOP,BITPOS,BLPOP,BRPOP,BRPOPLPUSH,BZPOPMIN,BZPOPMAX,CLIENT,COMMAND,DBSIZE,DECR,DECRBY,DEL,DISCARD,DUMP,ECHO,EVAL,EVALSHA,EXEC,EXISTS,EXPIRE,EXPIREAT,FLUSHALL,FLUSHDB,GEOADD,GEOHASH,GEOPOS,GEODIST,GEORADIUS,GEORADIUSBYMEMBER,GET,GETBIT,GETRANGE,GETSET,HDEL,HEXISTS,HGET,HGETALL,HINCRBY,HINCRBYFLOAT,HKEYS,HLEN,HMGET,HMSET,HSET,HSETNX,HSTRLEN,HVALS,INCR,INCRBY,INCRBYFLOAT,INFO,KEYS,LASTSAVE,LINDEX,LINSERT,LLEN,LPOP,LPUSH,LPUSHX,LRANGE,LREM,LSET,LTRIM,MEMORY,MGET,MONITOR,MOVE,MSET,MSETNX,MULTI,OBJECT,PERSIST,PEXPIRE,PEXPIREAT,PFADD,PFCOUNT,PFMERGE,PING,PSETEX,PSUBSCRIBE,PUBSUB,PTTL,PUBLISH,PUNSUBSCRIBE,RANDOMKEY,READONLY,READWRITE,RENAME,RENAMENX,RESTORE,ROLE,RPOP,RPOPLPUSH,RPUSH,RPUSHX,SADD,SCARD,SCRIPT,SDIFF,SDIFFSTORE,SELECT,SET,SETBIT,SETEX,SETNX,SETRANGE,SINTER,SINTERSTORE,SISMEMBER,SLOWLOG,SMEMBERS,SMOVE,SORT,SPOP,SRANDMEMBER,SREM,STRLEN,SUBSCRIBE,SUNION,SUNIONSTORE,SWAPDB,TIME,TOUCH,TTL,TYPE,UNSUBSCRIBE,UNLINK,UNWATCH,WAIT,WATCH,ZADD,ZCARD,ZCOUNT,ZINCRBY,ZINTERSTORE,ZLEXCOUNT,ZPOPMAX,ZPOPMIN,ZRANGE,ZRANGEBYLEX,ZREVRANGEBYLEX,ZRANGEBYSCORE,ZRANK,ZREM,ZREMRANGEBYLEX,ZREMRANGEBYRANK,ZREMRANGEBYSCORE,ZREVRANGE,ZREVRANGEBYSCORE,ZREVRANK,ZSCORE,ZUNIONSTORE,SCAN,SSCAN,HSCAN,ZSCAN,XINFO,XADD,XTRIM,XDEL,XRANGE,XREVRANGE,XLEN,XREAD,XGROUP,XREADGROUP,XACK,XCLAIM,XPENDING,GEORADIUS_RO,GEORADIUSBYMEMBER_RO,LOLWUT,XSETID,SUBSTR", "IsModifiable": true, "MinimumEngineVersion": "5.0.3", "ChangeType": "immediate" }, { "ParameterName": "repl-backlog-size", "ParameterValue": "1048576", "Description": "The replication backlog size in bytes for PSYNC. This is the size of the buffer which accumulates slave data when slave is disconnected for some time, so that when slave reconnects again, only transfer the portion of data which the slave missed. Minimum value is 16K.", "Source": "user", "DataType": "integer", "AllowedValues": "16384-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "repl-backlog-ttl", "ParameterValue": "3600", "Description": "The amount of time in seconds after the master no longer have any slaves connected for the master to free the replication backlog. A value of 0 means to never release the backlog.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "replica-allow-chaining", "ParameterValue": "no", "Description": "Configures if chaining of replicas is allowed", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "replica-ignore-maxmemory", "ParameterValue": "yes", "Description": "Determines if replica ignores maxmemory setting by not evicting items independent from the master", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "replica-lazy-flush", "ParameterValue": "no", "Description": "Perform an asynchronous flushDB during replica sync", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "reserved-memory-percent", "ParameterValue": "25", "Description": "The percent of memory reserved for non-cache memory usage. You may want to increase this parameter for nodes with read replicas, AOF enabled, etc, to reduce swap usage.", "Source": "user", "DataType": "integer", "AllowedValues": "0-100", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "set-max-intset-entries", "ParameterValue": "512", "Description": "The limit in the size of the set in order for the dataset to be compressed.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "slowlog-log-slower-than", "ParameterValue": "10000", "Description": "The execution time, in microseconds, to exceed in order for the command to get logged. Note that a negative number disables the slow log, while a value of zero forces the logging of every command.", "Source": "user", "DataType": "integer", "AllowedValues": "-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "slowlog-max-len", "ParameterValue": "128", "Description": "The length of the slow log. There is no limit to this length. Just be aware that it will consume memory. You can reclaim memory used by the slow log with SLOWLOG RESET.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "stream-node-max-bytes", "ParameterValue": "4096", "Description": "The maximum size of a single node in a stream in bytes", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "stream-node-max-entries", "ParameterValue": "100", "Description": "The maximum number of items a single node in a stream can contain", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "tcp-keepalive", "ParameterValue": "300", "Description": "If non-zero, send ACKs every given number of seconds.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "timeout", "ParameterValue": "0", "Description": "Close connection if client is idle for a given number of seconds, or never if 0.", "Source": "user", "DataType": "integer", "AllowedValues": "0,20-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "zset-max-ziplist-entries", "ParameterValue": "128", "Description": "The maximum number of sorted set entries in order for the dataset to be compressed.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "zset-max-ziplist-value", "ParameterValue": "64", "Description": "The threshold of biggest sorted set entries in order for the dataset to be compressed.", "Source": "user", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" } ] } ``` Weitere Informationen finden Sie unter [Parameterverwaltung](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/ParameterGroups.Management.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DescribeCacheParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-cache-parameters.html)unter *AWS CLI Befehlsreferenz*. ### `describe-cache-subnet-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-cache-subnet-groups`. **AWS CLI** **So beschreiben Sie Cache-Subnetzgruppen** Im folgenden Beispiel für `describe-cache-subnet-groups` wird eine Liste von Subnetzgruppen zurückgegeben. ``` aws elasticache describe-cache-subnet-groups ``` Ausgabe: ``` { "CacheSubnetGroups": [ { "CacheSubnetGroupName": "default", "CacheSubnetGroupDescription": "Default CacheSubnetGroup", "VpcId": "vpc-a3e97cdb", "Subnets": [ { "SubnetIdentifier": "subnet-8d4bacf5", "SubnetAvailabilityZone": { "Name": "us-west-2b" } }, { "SubnetIdentifier": "subnet-dde21380", "SubnetAvailabilityZone": { "Name": "us-west-2c" } }, { "SubnetIdentifier": "subnet-6485ec4f", "SubnetAvailabilityZone": { "Name": "us-west-2d" } }, { "SubnetIdentifier": "subnet-b4ebebff", "SubnetAvailabilityZone": { "Name": "us-west-2a" } } ] }, { "CacheSubnetGroupName": "kxkxk", "CacheSubnetGroupDescription": "mygroup", "VpcId": "vpc-a3e97cdb", "Subnets": [ { "SubnetIdentifier": "subnet-b4ebebff", "SubnetAvailabilityZone": { "Name": "us-west-2a" } } ] }, { "CacheSubnetGroupName": "test", "CacheSubnetGroupDescription": "test", "VpcId": "vpc-a3e97cdb", "Subnets": [ { "SubnetIdentifier": "subnet-b4ebebff", "SubnetAvailabilityZone": { "Name": "us-west-2a" } } ] } ] } ``` *Weitere Informationen finden Sie unter [Subnetze und Subnetzgruppen](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/SubnetGroups.html) im *Elasticache-Benutzerhandbuch* oder [Subnetze und Subnetzgruppen](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/SubnetGroups.html) im ElastiCache Memcached-Benutzerhandbuch.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DescribeCacheSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-cache-subnet-groups.html)AWS CLI * ### `describe-engine-default-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-engine-default-parameters`. **AWS CLI** **So beschreiben Sie die Standardparameter der Engine** Im folgenden Beispiel für `describe-engine-default-parameters` werden die standardmäßigen Engine- und System-Parameterinformationen für die angegebene Cache-Engine zurückgegeben. ``` aws elasticache describe-engine-default-parameters \ --cache-parameter-group-family "redis5.0" ``` Ausgabe: ``` { "EngineDefaults": { "Parameters": [ { "ParameterName": "activedefrag", "ParameterValue": "no", "Description": "Enabled active memory defragmentation", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-cycle-max", "ParameterValue": "75", "Description": "Maximal effort for defrag in CPU percentage", "Source": "system", "DataType": "integer", "AllowedValues": "1-75", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-cycle-min", "ParameterValue": "5", "Description": "Minimal effort for defrag in CPU percentage", "Source": "system", "DataType": "integer", "AllowedValues": "1-75", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-ignore-bytes", "ParameterValue": "104857600", "Description": "Minimum amount of fragmentation waste to start active defrag", "Source": "system", "DataType": "integer", "AllowedValues": "1048576-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-max-scan-fields", "ParameterValue": "1000", "Description": "Maximum number of set/hash/zset/list fields that will be processed from the main dictionary scan", "Source": "system", "DataType": "integer", "AllowedValues": "1-1000000", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-threshold-lower", "ParameterValue": "10", "Description": "Minimum percentage of fragmentation to start active defrag", "Source": "system", "DataType": "integer", "AllowedValues": "1-100", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "active-defrag-threshold-upper", "ParameterValue": "100", "Description": "Maximum percentage of fragmentation at which we use maximum effort", "Source": "system", "DataType": "integer", "AllowedValues": "1-100", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "activerehashing", "ParameterValue": "yes", "Description": "Apply rehashing or not.", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "requires-reboot" }, { "ParameterName": "appendfsync", "ParameterValue": "everysec", "Description": "fsync policy for AOF persistence", "Source": "system", "DataType": "string", "AllowedValues": "always,everysec,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "appendonly", "ParameterValue": "no", "Description": "Enable Redis persistence.", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-normal-hard-limit", "ParameterValue": "0", "Description": "Normal client output buffer hard limit in bytes.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-normal-soft-limit", "ParameterValue": "0", "Description": "Normal client output buffer soft limit in bytes.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-normal-soft-seconds", "ParameterValue": "0", "Description": "Normal client output buffer soft limit in seconds.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-pubsub-hard-limit", "ParameterValue": "33554432", "Description": "Pubsub client output buffer hard limit in bytes.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-pubsub-soft-limit", "ParameterValue": "8388608", "Description": "Pubsub client output buffer soft limit in bytes.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-pubsub-soft-seconds", "ParameterValue": "60", "Description": "Pubsub client output buffer soft limit in seconds.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-output-buffer-limit-replica-soft-seconds", "ParameterValue": "60", "Description": "Replica client output buffer soft limit in seconds.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "client-query-buffer-limit", "ParameterValue": "1073741824", "Description": "Max size of a single client query buffer", "Source": "system", "DataType": "integer", "AllowedValues": "1048576-1073741824", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "close-on-replica-write", "ParameterValue": "yes", "Description": "If enabled, clients who attempt to write to a read-only replica will be disconnected. Applicable to 2.8.23 and higher.", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "cluster-enabled", "ParameterValue": "no", "Description": "Enable cluster mode", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "requires-reboot" }, { "ParameterName": "cluster-require-full-coverage", "ParameterValue": "no", "Description": "Whether cluster becomes unavailable if one or more slots are not covered", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "databases", "ParameterValue": "16", "Description": "Set the number of databases.", "Source": "system", "DataType": "integer", "AllowedValues": "1-1200000", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "requires-reboot" }, { "ParameterName": "hash-max-ziplist-entries", "ParameterValue": "512", "Description": "The maximum number of hash entries in order for the dataset to be compressed.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "hash-max-ziplist-value", "ParameterValue": "64", "Description": "The threshold of biggest hash entries in order for the dataset to be compressed.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "hll-sparse-max-bytes", "ParameterValue": "3000", "Description": "HyperLogLog sparse representation bytes limit", "Source": "system", "DataType": "integer", "AllowedValues": "1-16000", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lazyfree-lazy-eviction", "ParameterValue": "no", "Description": "Perform an asynchronous delete on evictions", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lazyfree-lazy-expire", "ParameterValue": "no", "Description": "Perform an asynchronous delete on expired keys", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lazyfree-lazy-server-del", "ParameterValue": "no", "Description": "Perform an asynchronous delete on key updates", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lfu-decay-time", "ParameterValue": "1", "Description": "The amount of time in minutes to decrement the key counter for LFU eviction policy", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lfu-log-factor", "ParameterValue": "10", "Description": "The log factor for incrementing key counter for LFU eviction policy", "Source": "system", "DataType": "integer", "AllowedValues": "1-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "list-compress-depth", "ParameterValue": "0", "Description": "Number of quicklist ziplist nodes from each side of the list to exclude from compression. The head and tail of the list are always uncompressed for fast push/pop operations", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "list-max-ziplist-size", "ParameterValue": "-2", "Description": "The number of entries allowed per internal list node can be specified as a fixed maximum size or a maximum number of elements", "Source": "system", "DataType": "integer", "AllowedValues": "-5,-4,-3,-2,-1,1-", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lua-replicate-commands", "ParameterValue": "yes", "Description": "Always enable Lua effect replication or not", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "lua-time-limit", "ParameterValue": "5000", "Description": "Max execution time of a Lua script in milliseconds. 0 for unlimited execution without warnings.", "Source": "system", "DataType": "integer", "AllowedValues": "5000", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "maxclients", "ParameterValue": "65000", "Description": "The maximum number of Redis clients.", "Source": "system", "DataType": "integer", "AllowedValues": "1-65000", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "requires-reboot" }, { "ParameterName": "maxmemory-policy", "ParameterValue": "volatile-lru", "Description": "Max memory policy.", "Source": "system", "DataType": "string", "AllowedValues": "volatile-lru,allkeys-lru,volatile-lfu,allkeys-lfu,volatile-random,allkeys-random,volatile-ttl,noeviction", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "maxmemory-samples", "ParameterValue": "3", "Description": "Max memory samples.", "Source": "system", "DataType": "integer", "AllowedValues": "1-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "min-replicas-max-lag", "ParameterValue": "10", "Description": "The maximum amount of replica lag in seconds beyond which the master would stop taking writes. A value of 0 means the master always takes writes.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "min-replicas-to-write", "ParameterValue": "0", "Description": "The minimum number of replicas that must be present with lag no greater than min-replicas-max-lag for master to take writes. Setting this to 0 means the master always takes writes.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "notify-keyspace-events", "Description": "The keyspace events for Redis to notify Pub/Sub clients about. By default all notifications are disabled", "Source": "system", "DataType": "string", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "proto-max-bulk-len", "ParameterValue": "536870912", "Description": "Max size of a single element request", "Source": "system", "DataType": "integer", "AllowedValues": "1048576-536870912", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "rename-commands", "ParameterValue": "", "Description": "Redis commands that can be dynamically renamed by the customer", "Source": "system", "DataType": "string", "AllowedValues": "APPEND,BITCOUNT,BITFIELD,BITOP,BITPOS,BLPOP,BRPOP,BRPOPLPUSH,BZPOPMIN,BZPOPMAX,CLIENT,COMMAND,DBSIZE,DECR,DECRBY,DEL,DISCARD,DUMP,ECHO,EVAL,EVALSHA,EXEC,EXISTS,EXPIRE,EXPIREAT,FLUSHALL,FLUSHDB,GEOADD,GEOHASH,GEOPOS,GEODIST,GEORADIUS,GEORADIUSBYMEMBER,GET,GETBIT,GETRANGE,GETSET,HDEL,HEXISTS,HGET,HGETALL,HINCRBY,HINCRBYFLOAT,HKEYS,HLEN,HMGET,HMSET,HSET,HSETNX,HSTRLEN,HVALS,INCR,INCRBY,INCRBYFLOAT,INFO,KEYS,LASTSAVE,LINDEX,LINSERT,LLEN,LPOP,LPUSH,LPUSHX,LRANGE,LREM,LSET,LTRIM,MEMORY,MGET,MONITOR,MOVE,MSET,MSETNX,MULTI,OBJECT,PERSIST,PEXPIRE,PEXPIREAT,PFADD,PFCOUNT,PFMERGE,PING,PSETEX,PSUBSCRIBE,PUBSUB,PTTL,PUBLISH,PUNSUBSCRIBE,RANDOMKEY,READONLY,READWRITE,RENAME,RENAMENX,RESTORE,ROLE,RPOP,RPOPLPUSH,RPUSH,RPUSHX,SADD,SCARD,SCRIPT,SDIFF,SDIFFSTORE,SELECT,SET,SETBIT,SETEX,SETNX,SETRANGE,SINTER,SINTERSTORE,SISMEMBER,SLOWLOG,SMEMBERS,SMOVE,SORT,SPOP,SRANDMEMBER,SREM,STRLEN,SUBSCRIBE,SUNION,SUNIONSTORE,SWAPDB,TIME,TOUCH,TTL,TYPE,UNSUBSCRIBE,UNLINK,UNWATCH,WAIT,WATCH,ZADD,ZCARD,ZCOUNT,ZINCRBY,ZINTERSTORE,ZLEXCOUNT,ZPOPMAX,ZPOPMIN,ZRANGE,ZRANGEBYLEX,ZREVRANGEBYLEX,ZRANGEBYSCORE,ZRANK,ZREM,ZREMRANGEBYLEX,ZREMRANGEBYRANK,ZREMRANGEBYSCORE,ZREVRANGE,ZREVRANGEBYSCORE,ZREVRANK,ZSCORE,ZUNIONSTORE,SCAN,SSCAN,HSCAN,ZSCAN,XINFO,XADD,XTRIM,XDEL,XRANGE,XREVRANGE,XLEN,XREAD,XGROUP,XREADGROUP,XACK,XCLAIM,XPENDING,GEORADIUS_RO,GEORADIUSBYMEMBER_RO,LOLWUT,XSETID,SUBSTR", "IsModifiable": true, "MinimumEngineVersion": "5.0.3", "ChangeType": "immediate" }, { "ParameterName": "repl-backlog-size", "ParameterValue": "1048576", "Description": "The replication backlog size in bytes for PSYNC. This is the size of the buffer which accumulates slave data when slave is disconnected for some time, so that when slave reconnects again, only transfer the portion of data which the slave missed. Minimum value is 16K.", "Source": "system", "DataType": "integer", "AllowedValues": "16384-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "repl-backlog-ttl", "ParameterValue": "3600", "Description": "The amount of time in seconds after the master no longer have any slaves connected for the master to free the replication backlog. A value of 0 means to never release the backlog.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "replica-allow-chaining", "ParameterValue": "no", "Description": "Configures if chaining of replicas is allowed", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "replica-ignore-maxmemory", "ParameterValue": "yes", "Description": "Determines if replica ignores maxmemory setting by not evicting items independent from the master", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "replica-lazy-flush", "ParameterValue": "no", "Description": "Perform an asynchronous flushDB during replica sync", "Source": "system", "DataType": "string", "AllowedValues": "yes,no", "IsModifiable": false, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "reserved-memory-percent", "ParameterValue": "25", "Description": "The percent of memory reserved for non-cache memory usage. You may want to increase this parameter for nodes with read replicas, AOF enabled, etc, to reduce swap usage.", "Source": "system", "DataType": "integer", "AllowedValues": "0-100", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "set-max-intset-entries", "ParameterValue": "512", "Description": "The limit in the size of the set in order for the dataset to be compressed.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "slowlog-log-slower-than", "ParameterValue": "10000", "Description": "The execution time, in microseconds, to exceed in order for the command to get logged. Note that a negative number disables the slow log, while a value of zero forces the logging of every command.", "Source": "system", "DataType": "integer", "AllowedValues": "-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "slowlog-max-len", "ParameterValue": "128", "Description": "The length of the slow log. There is no limit to this length. Just be aware that it will consume memory. You can reclaim memory used by the slow log with SLOWLOG RESET.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "stream-node-max-bytes", "ParameterValue": "4096", "Description": "The maximum size of a single node in a stream in bytes", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "stream-node-max-entries", "ParameterValue": "100", "Description": "The maximum number of items a single node in a stream can contain", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "tcp-keepalive", "ParameterValue": "300", "Description": "If non-zero, send ACKs every given number of seconds.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "timeout", "ParameterValue": "0", "Description": "Close connection if client is idle for a given number of seconds, or never if 0.", "Source": "system", "DataType": "integer", "AllowedValues": "0,20-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "zset-max-ziplist-entries", "ParameterValue": "128", "Description": "The maximum number of sorted set entries in order for the dataset to be compressed.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" }, { "ParameterName": "zset-max-ziplist-value", "ParameterValue": "64", "Description": "The threshold of biggest sorted set entries in order for the dataset to be compressed.", "Source": "system", "DataType": "integer", "AllowedValues": "0-", "IsModifiable": true, "MinimumEngineVersion": "5.0.0", "ChangeType": "immediate" } ] } } ``` + Einzelheiten zur API finden Sie [DescribeEngineDefaultParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-engine-default-parameters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-events` Das folgende Codebeispiel zeigt die Verwendung`describe-events`. **AWS CLI** **So beschreiben Sie Ereignisse einer Replikationsgruppe** Im folgenden Beispiel für `describe-events` wird eine Liste von Ereignissen für eine Replikationsgruppe zurückgegeben. ``` aws elasticache describe-events \ --source-identifier test-cluster \ --source-type replication-group ``` Ausgabe: ``` { "Events": [ { "SourceIdentifier": "test-cluster", "SourceType": "replication-group", "Message": "Automatic failover has been turned on for replication group test-cluster", "Date": "2020-03-18T23:51:34.457Z" }, { "SourceIdentifier": "test-cluster", "SourceType": "replication-group", "Message": "Replication group test-cluster created", "Date": "2020-03-18T23:50:31.378Z" } ] } ``` Weitere Informationen finden Sie unter [Überwachen von Ereignissen](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/ECEvents.html) im *Benutzerhandbuch für ElastiCache*. + Einzelheiten zur API finden Sie [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-events.html)in der *AWS CLI Befehlsreferenz*. ### `describe-global-replication-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-global-replication-groups`. **AWS CLI** **So beschreiben Sie globale Replikationsgruppen** Im folgenden Beispiel für `describe-global-replication-groups` werden Details eines globalen Datenspeichers zurückgegeben. ``` aws elasticache describe-global-replication-groups \ --global-replication-group-id my-grg ``` Ausgabe: ``` { "GlobalReplicationGroups": [ { "GlobalReplicationGroupId": "my-grg", "GlobalReplicationGroupDescription": "my-grg", "Status": "creating", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.6", "ClusterEnabled": false, "AuthTokenEnabled": false, "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } ] } ``` Weitere Informationen finden Sie unter [AWS Regionsübergreifende Replikation mithilfe von Global Datastore](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Redis-Global-Datastore.html) im *Elasticache-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [DescribeGlobalReplicationGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-global-replication-groups.html)in AWS CLI der Befehlsreferenz.* ### `describe-replication-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-replication-groups`. **AWS CLI** **So geben Sie eine Liste mit Details zu Replikationsgruppen zurück** Im folgenden Beispiel für `describe-replication-groups` werden die Replikationsgruppen zurückgegeben. ``` aws elasticache describe-replication-groups ``` Ausgabe: ``` { "ReplicationGroups": [ { "ReplicationGroupId": "my-cluster", "Description": "mycluster", "Status": "available", "PendingModifiedValues": {}, "MemberClusters": [ "pat-cluster-001", "pat-cluster-002", "pat-cluster-003", "pat-cluster-004" ], "NodeGroups": [ { "NodeGroupId": "0001", "Status": "available", "PrimaryEndpoint": { "Address": "my-cluster.xxxxih.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "ReaderEndpoint": { "Address": "my-cluster-ro.xxxxih.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "NodeGroupMembers": [ { "CacheClusterId": "my-cluster-001", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "pat-cluster-001.xxxih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "primary" }, { "CacheClusterId": "my-cluster-002", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "pat-cluster-002.xxxxih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "replica" }, { "CacheClusterId": "my-cluster-003", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "pat-cluster-003.xxxxih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "replica" }, { "CacheClusterId": "my-cluster-004", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "pat-cluster-004.xxxih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "replica" } ] } ], "AutomaticFailover": "disabled", "SnapshotRetentionLimit": 0, "SnapshotWindow": "07:30-08:30", "ClusterEnabled": false, "CacheNodeType": "cache.r5.xlarge", "AuthTokenEnabled": false, "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false, "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxxx152:replicationgroup:my-cluster", "LogDeliveryConfigurations": [ { "LogType": "slow-log", "DestinationType": "cloudwatch-logs", "DestinationDetails": { "CloudWatchLogsDetails": { "LogGroup": "test-log" } }, "LogFormat": "json", "Status": "active" } ] } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Clustern](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DescribeReplicationGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-replication-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-reserved-cache-nodes-offerings` Das folgende Codebeispiel zeigt die Verwendung`describe-reserved-cache-nodes-offerings`. **AWS CLI** **Um zu beschreiben reserved-cache-nodes-offerings** Das folgende `describe-reserved-cache-nodes-offerings` Beispiel gibt Details einer reserved-cache-node Option zurück. ``` aws elasticache describe-reserved-cache-nodes-offerings ``` Ausgabe: ``` { "ReservedCacheNodesOfferings": [ { "ReservedCacheNodesOfferingId": "01ce0a19-a476-41cb-8aee-48eacbcdc8e5", "CacheNodeType": "cache.t3.small", "Duration": 31536000, "FixedPrice": 97.0, "UsagePrice": 0.0, "ProductDescription": "memcached", "OfferingType": "Partial Upfront", "RecurringCharges": [ { "RecurringChargeAmount": 0.011, "RecurringChargeFrequency": "Hourly" } ] }, { "ReservedCacheNodesOfferingId": "0443a27b-4da5-4b90-b92d-929fbd7abed2", "CacheNodeType": "cache.m3.2xlarge", "Duration": 31536000, "FixedPrice": 1772.0, "UsagePrice": 0.0, "ProductDescription": "redis", "OfferingType": "Heavy Utilization", "RecurringCharges": [ { "RecurringChargeAmount": 0.25, "RecurringChargeFrequency": "Hourly" } ] }, ... ] } ``` Weitere Informationen finden Sie unter [Abrufen von Informationen über Angebote für reservierte Knoten](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/reserved-nodes-offerings.html) im *Benutzerhandbuch für ElastiCache Redis‭‭* oder unter [Abrufen von Informationen über Angebote für reservierte Knoten](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/reserved-nodes-offerings.html) im *Benutzerhandbuch für ElastiCache für Memcached*. + Einzelheiten zur API finden Sie [DescribeReservedCacheNodesOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-reserved-cache-nodes-offerings.html)unter *AWS CLI Befehlsreferenz*. ### `describe-reserved-cache-nodes` Das folgende Codebeispiel zeigt die Verwendung`describe-reserved-cache-nodes`. **AWS CLI** **So beschreiben Sie reservierte Cache-Knoten** Im folgenden Beispiel für `describe-reserved-cache-nodes` werden Informationen über reservierte Cache-Knoten für dieses Konto oder über den angegebenen reservierten Cache-Knoten zurückgegeben. als Elasticache describe-reserved-cache-nodes Ausgabe: ``` { "ReservedCacheNodes": [ { "ReservedCacheNodeId": "mynode", "ReservedCacheNodesOfferingId": "xxxxxxxxx-xxxxx-xxxxx-xxxx-xxxxxxxx71", "CacheNodeType": "cache.t3.small", "StartTime": "2019-12-06T02:50:44.003Z", "Duration": 31536000, "FixedPrice": 0.0, "UsagePrice": 0.0, "CacheNodeCount": 1, "ProductDescription": "redis", "OfferingType": "No Upfront", "State": "payment-pending", "RecurringCharges": [ { "RecurringChargeAmount": 0.023, "RecurringChargeFrequency": "Hourly" } ], "ReservationARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxxxx52:reserved-instance:mynode" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Kosten mit reservierten Knoten](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/reserved-nodes.html) im *Benutzerhandbuch für ElastiCache‭‭* . + Einzelheiten zur API finden Sie [DescribeReservedCacheNodes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-reserved-cache-nodes.html)in der *AWS CLI Befehlsreferenz.* ### `describe-service-updates` Das folgende Codebeispiel zeigt die Verwendung`describe-service-updates`. **AWS CLI** **So beschreiben Sie Service-Updates** Im folgenden Beispiel für `describe-service-updates` werden Details zu Service-Updates zurückgegeben. ``` aws elasticache describe-service-updates ``` Ausgabe: ``` { "ServiceUpdates": [ { "ServiceUpdateName": "elc-xxxxxxxx7-001", "ServiceUpdateReleaseDate": "2019-10-09T16:00:00Z", "ServiceUpdateEndDate": "2020-02-09T15:59:59Z", "ServiceUpdateSeverity": "important", "ServiceUpdateRecommendedApplyByDate": "2019-11-08T15:59:59Z", "ServiceUpdateStatus": "available", "ServiceUpdateDescription": "Upgrades to improve the security, reliability, and operational performance of your ElastiCache nodes", "ServiceUpdateType": "security-update", "Engine": "redis, memcached", "EngineVersion": "redis 2.6.13 and onwards, memcached 1.4.5 and onwards", "AutoUpdateAfterRecommendedApplyByDate": false, "EstimatedUpdateTime": "30 minutes per node" }, { "ServiceUpdateName": "elc-xxxxxxxx4-001", "ServiceUpdateReleaseDate": "2019-06-11T15:00:00Z", "ServiceUpdateEndDate": "2019-10-01T09:24:00Z", "ServiceUpdateSeverity": "important", "ServiceUpdateRecommendedApplyByDate": "2019-07-11T14:59:59Z", "ServiceUpdateStatus": "expired", "ServiceUpdateDescription": "Upgrades to improve the security, reliability, and operational performance of your ElastiCache nodes", "ServiceUpdateType": "security-update", "Engine": "redis", "EngineVersion": "redis 3.2.6, redis 4.0 and onwards", "AutoUpdateAfterRecommendedApplyByDate": false, "EstimatedUpdateTime": "30 minutes per node" } ] } ``` + Einzelheiten zur API finden Sie [DescribeServiceUpdates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-service-updates.html)in der *AWS CLI Befehlsreferenz*. ### `describe-snapshots` Das folgende Codebeispiel zeigt die Verwendung`describe-snapshots`. **AWS CLI** **So beschreiben Sie Snapshots** Im folgenden „describe-snapshots“-Beispiel werden Informationen zu Cluster- oder Replikationsgruppen-Snapshots zurückgegeben. ``` aws elasticache describe-snapshots ``` Ausgabe: ``` { "Snapshots": [ { "SnapshotName": "automatic.my-cluster2-002-2019-12-05-06-38", "CacheClusterId": "my-cluster2-002", "SnapshotStatus": "available", "SnapshotSource": "automated", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.5", "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-west-2a", "CacheClusterCreateTime": "2019-11-26T01:22:52.396Z", "PreferredMaintenanceWindow": "mon:17:30-mon:18:30", "TopicArn": "arn:aws:sns:us-west-2:xxxxxxxxx52:My_Topic", "Port": 6379, "CacheParameterGroupName": "default.redis5.0", "CacheSubnetGroupName": "kxkxk", "VpcId": "vpc-a3e97cdb", "AutoMinorVersionUpgrade": true, "SnapshotRetentionLimit": 1, "SnapshotWindow": "06:30-07:30", "NodeSnapshots": [ { "CacheNodeId": "0001", "CacheSize": "5 MB", "CacheNodeCreateTime": "2019-11-26T01:22:52.396Z", "SnapshotCreateTime": "2019-12-05T06:38:23Z" } ] }, { "SnapshotName": "myreplica-backup", "CacheClusterId": "myreplica", "SnapshotStatus": "available", "SnapshotSource": "manual", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.5", "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-west-2a", "CacheClusterCreateTime": "2019-11-26T00:14:52.439Z", "PreferredMaintenanceWindow": "sat:10:00-sat:11:00", "TopicArn": "arn:aws:sns:us-west-2:xxxxxxxxxx152:My_Topic", "Port": 6379, "CacheParameterGroupName": "default.redis5.0", "CacheSubnetGroupName": "kxkxk", "VpcId": "vpc-a3e97cdb", "AutoMinorVersionUpgrade": true, "SnapshotRetentionLimit": 0, "SnapshotWindow": "09:00-10:00", "NodeSnapshots": [ { "CacheNodeId": "0001", "CacheSize": "5 MB", "CacheNodeCreateTime": "2019-11-26T00:14:52.439Z", "SnapshotCreateTime": "2019-11-26T00:25:01Z" } ] }, { "SnapshotName": "my-cluster", "CacheClusterId": "my-cluster-003", "SnapshotStatus": "available", "SnapshotSource": "manual", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.5", "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-west-2a", "CacheClusterCreateTime": "2019-11-25T23:56:17.186Z", "PreferredMaintenanceWindow": "sat:10:00-sat:11:00", "TopicArn": "arn:aws:sns:us-west-2:xxxxxxxxxx152:My_Topic", "Port": 6379, "CacheParameterGroupName": "default.redis5.0", "CacheSubnetGroupName": "kxkxk", "VpcId": "vpc-a3e97cdb", "AutoMinorVersionUpgrade": true, "SnapshotRetentionLimit": 0, "SnapshotWindow": "09:00-10:00", "NodeSnapshots": [ { "CacheNodeId": "0001", "CacheSize": "5 MB", "CacheNodeCreateTime": "2019-11-25T23:56:17.186Z", "SnapshotCreateTime": "2019-11-26T03:08:33Z" } ] } ] } ``` Weitere Informationen finden Sie unter [Backup and Restore ElastiCache für Redis](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/backups.html) im *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeSnapshots AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-snapshots.html)*Befehlsreferenz*. ### `describe-update-actions` Das folgende Codebeispiel zeigt die Verwendung`describe-update-actions`. **AWS CLI** **So beschreiben Sie Aktualisierungsaktionen** Im folgenden Beispiel für `describe-update-actions` werden Details zu Aktualisierungsaktionen zurückgegeben. ``` aws elasticache describe-update-actions ``` Ausgabe: ``` { "UpdateActions": [ { "ReplicationGroupId": "mycluster", "ServiceUpdateName": "elc-20191007-001", "ServiceUpdateReleaseDate": "2019-10-09T16:00:00Z", "ServiceUpdateSeverity": "important", "ServiceUpdateStatus": "available", "ServiceUpdateRecommendedApplyByDate": "2019-11-08T15:59:59Z", "ServiceUpdateType": "security-update", "UpdateActionAvailableDate": "2019-12-05T19:15:19.995Z", "UpdateActionStatus": "complete", "NodesUpdated": "9/9", "UpdateActionStatusModifiedDate": "2019-12-05T19:15:20.461Z", "SlaMet": "n/a", "Engine": "redis" }, { "CacheClusterId": "my-memcached-cluster", "ServiceUpdateName": "elc-20191007-001", "ServiceUpdateReleaseDate": "2019-10-09T16:00:00Z", "ServiceUpdateSeverity": "important", "ServiceUpdateStatus": "available", "ServiceUpdateRecommendedApplyByDate": "2019-11-08T15:59:59Z", "ServiceUpdateType": "security-update", "UpdateActionAvailableDate": "2019-12-04T18:26:05.349Z", "UpdateActionStatus": "complete", "NodesUpdated": "1/1", "UpdateActionStatusModifiedDate": "2019-12-04T18:26:05.352Z", "SlaMet": "n/a", "Engine": "redis" }, { "ReplicationGroupId": "my-cluster", "ServiceUpdateName": "elc-20191007-001", "ServiceUpdateReleaseDate": "2019-10-09T16:00:00Z", "ServiceUpdateSeverity": "important", "ServiceUpdateStatus": "available", "ServiceUpdateRecommendedApplyByDate": "2019-11-08T15:59:59Z", "ServiceUpdateType": "security-update", "UpdateActionAvailableDate": "2019-11-26T03:36:26.320Z", "UpdateActionStatus": "complete", "NodesUpdated": "4/4", "UpdateActionStatusModifiedDate": "2019-12-04T22:11:12.664Z", "SlaMet": "n/a", "Engine": "redis" }, { "ReplicationGroupId": "my-cluster2", "ServiceUpdateName": "elc-20191007-001", "ServiceUpdateReleaseDate": "2019-10-09T16:00:00Z", "ServiceUpdateSeverity": "important", "ServiceUpdateStatus": "available", "ServiceUpdateRecommendedApplyByDate": "2019-11-08T15:59:59Z", "ServiceUpdateType": "security-update", "UpdateActionAvailableDate": "2019-11-26T01:26:01.617Z", "UpdateActionStatus": "complete", "NodesUpdated": "3/3", "UpdateActionStatusModifiedDate": "2019-11-26T01:26:01.753Z", "SlaMet": "n/a", "Engine": "redis" } ] } ``` Weitere Informationen finden Sie unter [Self-Service-Updates in Amazon ElastiCache im](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Self-Service-Updates.html) *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeUpdateActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-update-actions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-user-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-user-groups`. **AWS CLI** **So beschreiben Sie Benutzergruppen** Im folgenden Beispiel für `describe-user-groups` wird eine Liste mit Benutzergruppen zurückgegeben. ``` aws elasticache describe-user-groups ``` Ausgabe: ``` { "UserGroups": [ { "UserGroupId": "myusergroup", "Status": "active", "Engine": "redis", "UserIds": [ "default" ], "ReplicationGroups": [], "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:usergroup:myusergroup" } ] } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit der rollenbasierten Zugriffskontrolle (RBAC)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.RBAC.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DescribeUserGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-user-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-users` Das folgende Codebeispiel zeigt die Verwendung`describe-users`. **AWS CLI** **So beschreiben Sie Benutzer** Im folgenden Beispiel für `describe-users` wird eine Liste mit Benutzern zurückgegeben. ``` aws elasticache describe-users ``` Ausgabe: ``` { "Users": [ { "UserId": "default", "UserName": "default", "Status": "active", "Engine": "redis", "AccessString": "on ~* +@all", "UserGroupIds": [ "myusergroup" ], "Authentication": { "Type": "no-password" }, "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:user:default" }, { "UserId": "user1", "UserName": "myUser", "Status": "active", "Engine": "redis", "AccessString": "on ~* +@all", "UserGroupIds": [], "Authentication": { "Type": "password", "PasswordCount": 1 }, "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:user:user1" }, { "UserId": "user2", "UserName": "myUser", "Status": "active", "Engine": "redis", "AccessString": "on ~app::* -@all +@read +@hash +@bitmap +@geo -setbit -bitfield -hset -hsetnx -hmset -hincrby -hincrbyfloat -hdel -bitop -geoadd -georadius -georadiusbymember", "UserGroupIds": [], "Authentication": { "Type": "password", "PasswordCount": 1 }, "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:user:user2" } ] } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit der rollenbasierten Zugriffskontrolle (RBAC)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.RBAC.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [DescribeUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/describe-users.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-global-replication-group` Das folgende Codebeispiel zeigt die Verwendung`disassociate-global-replication-group`. **AWS CLI** **So heben Sie die Zuordnung eines sekundären Clusters zu einer globalen Replikationsgruppe auf** Im folgenden Beispiel für `disassociate-global-replication-group` wird ein sekundärer Cluster aus einem globalen Datenspeicher entfernt. ``` aws elasticache disassociate-global-replication-group \ --global-replication-group-id my-grg \ --replication-group-id my-cluster-grg-secondary \ --replication-group-region us-east-1 ``` Ausgabe: ``` { "GlobalReplicationGroup": { "GlobalReplicationGroupId": "my-grg", "GlobalReplicationGroupDescription": "my-grg", "Status": "modifying", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.6", "Members": [ { "ReplicationGroupId": "my-cluster-grg-secondary", "ReplicationGroupRegion": "us-east-1", "Role": "SECONDARY", "AutomaticFailover": "enabled", "Status": "associated" }, { "ReplicationGroupId": "my-cluster-grg", "ReplicationGroupRegion": "us-west-2", "Role": "PRIMARY", "AutomaticFailover": "enabled", "Status": "associated" } ], "ClusterEnabled": false, "AuthTokenEnabled": false, "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [AWS Regionsübergreifende Replikation mithilfe von Global Datastore](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Redis-Global-Datastore.html) im *Elasticache-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [DisassociateGlobalReplicationGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/disassociate-global-replication-group.html)in AWS CLI der Befehlsreferenz.* ### `increase-node-groups-in-global-replication-group` Das folgende Codebeispiel zeigt die Verwendung`increase-node-groups-in-global-replication-group`. **AWS CLI** **So erhöhen Sie die Anzahl der Knotengruppen in einer globalen Replikationsgruppe** Im folgenden Beispiel für `increase-node-groups-in-global-replication-group` wird die Anzahl der Knotengruppen mithilfe der Redis-Engine erhöht. ``` aws elasticache increase-node-groups-in-global-replication-group \ --global-replication-group-id sgaui-pat-test-4 \ --node-group-count 6 \ --apply-immediately ``` Ausgabe: ``` { "GlobalReplicationGroup": { "GlobalReplicationGroupId": "sgaui-test-4", "GlobalReplicationGroupDescription": "test-4", "Status": "modifying", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.6", "Members": [ { "ReplicationGroupId": "my-cluster-b", "ReplicationGroupRegion": "us-east-1", "Role": "SECONDARY", "AutomaticFailover": "enabled", "Status": "associated" }, { "ReplicationGroupId": "my-cluster-a", "ReplicationGroupRegion": "us-west-2", "Role": "PRIMARY", "AutomaticFailover": "enabled", "Status": "associated" } ], "ClusterEnabled": true, "GlobalNodeGroups": [ { "GlobalNodeGroupId": "sgaui-test-4-0001", "Slots": "0-234,2420-5461" }, { "GlobalNodeGroupId": "sgaui-test-4-0002", "Slots": "5462-5904,6997-9830" }, { "GlobalNodeGroupId": "sgaui-test-4-0003", "Slots": "10923-11190,13375-16383" }, { "GlobalNodeGroupId": "sgaui-test-4-0004", "Slots": "235-2419,5905-6996" }, { "GlobalNodeGroupId": "sgaui-test-4-0005", "Slots": "9831-10922,11191-13374" } ], "AuthTokenEnabled": false, "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [AWS Regionsübergreifende Replikation mithilfe von Global Datastore](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Redis-Global-Datastore.html) im *Elasticache-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [IncreaseNodeGroupsInGlobalReplicationGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/increase-node-groups-in-global-replication-group.html)in AWS CLI der Befehlsreferenz.* ### `increase-replica-count` Das folgende Codebeispiel zeigt die Verwendung`increase-replica-count`. **AWS CLI** **So erhöhen Sie die Anzahl der Replikate** Im folgenden Beispiel für `increase-replica-count` wird eine von zwei möglichen Aktionen ausgeführt. Entweder wird die Anzahl der Replikate in einer Redis-Replikationsgruppe (Cluster-Modus deaktiviert) oder die Anzahl der Replikationsknoten in einer oder mehreren Knotengruppen (Shards) einer Redis-Replikationsgruppe (Cluster-Modus aktiviert) dynamisch erhöht. Dieser Vorgang wird ohne Cluster-Ausfallzeit ausgeführt. ``` aws elasticache increase-replica-count \ --replication-group-id "my-cluster" \ --apply-immediately \ --new-replica-count 3 ``` Ausgabe: ``` { "ReplicationGroup": { "ReplicationGroupId": "my-cluster", "Description": " ", "Status": "modifying", "PendingModifiedValues": {}, "MemberClusters": [ "my-cluster-001", "my-cluster-002", "my-cluster-003", "my-cluster-004" ], "NodeGroups": [ { "NodeGroupId": "0001", "Status": "modifying", "PrimaryEndpoint": { "Address": "my-cluster.xxxxxih.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "ReaderEndpoint": { "Address": "my-cluster-ro.xxxxxxih.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "NodeGroupMembers": [ { "CacheClusterId": "my-cluster-001", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "my-cluster-001.xxxxxih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "primary" }, { "CacheClusterId": "my-cluster-003", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "my-cluster-003.xxxxxih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "replica" } ] } ], "AutomaticFailover": "disabled", "SnapshotRetentionLimit": 0, "SnapshotWindow": "07:30-08:30", "ClusterEnabled": false, "CacheNodeType": "cache.r5.xlarge", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [Erhöhen der Anzahl von Replikaten in einem Shard](https://docs.aws.amazon.c`m/AmazonElastiCache/latest/red-ug/increase-replica-count.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [IncreaseReplicaCount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/increase-replica-count.html)in der *AWS CLI Befehlsreferenz*. ### `list-allowed-node-type-modifications` Das folgende Codebeispiel zeigt die Verwendung`list-allowed-node-type-modifications`. **AWS CLI** **So listen Sie die zulässigen Knotenänderungen auf** Im folgenden Beispiel für `list-allowed-node-type-modifications` werden alle verfügbaren Knotentypen aufgelistet, auf die Sie den aktuellen Knotentyp Ihres Redis-Clusters oder Ihrer Replikationsgruppe skalieren können. ``` aws elasticache list-allowed-node-type-modifications \ --replication-group-id "my-replication-group" ``` Ausgabe: ``` { "ScaleUpModifications": [ "cache.m5.12xlarge", "cache.m5.24xlarge", "cache.m5.4xlarge", "cache.r5.12xlarge", "cache.r5.24xlarge", "cache.r5.2xlarge", "cache.r5.4xlarge" ], "ScaleDownModifications": [ "cache.m3.large", "cache.m3.medium", "cache.m3.xlarge", "cache.m4.large", "cache.m4.xlarge", "cache.m5.2xlarge", "cache.m5.large", "cache.m5.xlarge", "cache.r3.large", "cache.r4.large", "cache.r4.xlarge", "cache.r5.large", "cache.t2.medium", "cache.t2.micro", "cache.t2.small", "cache.t3.medium", "cache.t3.micro", "cache.t3.small" ] } ``` Weitere Informationen finden Sie unter [Skalierung ElastiCache für Redis-Cluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Scaling.html) im *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListAllowedNodeTypeModifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/list-allowed-node-type-modifications.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden Tags für eine Ressource aufgelistet. ``` aws elasticache list-tags-for-resource \ --resource-name "arn:aws:elasticache:us-east-1:123456789012:cluster:my-cluster" ``` Ausgabe: ``` { "TagList": [ { "Key": "Project", "Value": "querySpeedUp" }, { "Key": "Environment", "Value": "PROD" } ] } ``` Weitere Informationen finden Sie unter [Auflisten von Tags mithilfe der AWS CLI](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Tagging.Managing.CLI.html) im *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `modify-cache-cluster` Das folgende Codebeispiel zeigt die Verwendung`modify-cache-cluster`. **AWS CLI** **So ändern Sie Cache-Cluster** Im folgenden Beispiel für `modify-cache-cluster` werden die Einstellungen für den angegebenen Cluster geändert. ``` aws elasticache modify-cache-cluster \ --cache-cluster-id "my-cluster" \ --num-cache-nodes 1 ``` Ausgabe: ``` { "CacheCluster": { "CacheClusterId": "my-cluster", "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "CacheNodeType": "cache.m5.large", "Engine": "redis", "EngineVersion": "5.0.5", "CacheClusterStatus": "available", "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-west-2c", "CacheClusterCreateTime": "2019-12-04T18:24:56.652Z", "PreferredMaintenanceWindow": "sat:10:00-sat:11:00", "PendingModifiedValues": {}, "CacheSecurityGroups": [], "CacheParameterGroup": { "CacheParameterGroupName": "default.redis5.0", "ParameterApplyStatus": "in-sync", "CacheNodeIdsToReboot": [] }, "CacheSubnetGroupName": "default", "AutoMinorVersionUpgrade": true, "SnapshotRetentionLimit": 0, "SnapshotWindow": "07:00-08:00", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [Modifizieren eines ElastiCache Clusters](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.Modify.html) im *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ModifyCacheCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/modify-cache-cluster.html)in der *AWS CLI Befehlsreferenz.* ### `modify-cache-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`modify-cache-parameter-group`. **AWS CLI** **So ändern Sie eine Cache-Parametergruppe** Im folgenden Beispiel für `modify-cache-parameter-group` werden die Parameter der angegebenen Cache-Parametergruppe geändert. ``` aws elasticache modify-cache-parameter-group \ --cache-parameter-group-name "mygroup" \ --parameter-name-values "ParameterName=activedefrag, ParameterValue=no" ``` Ausgabe: ``` { "CacheParameterGroupName": "mygroup" } ``` Weitere Informationen finden Sie unter [Ändern einer Parametergruppe](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/ParameterGroups.Modifying.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [ModifyCacheParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/modify-cache-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `modify-cache-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`modify-cache-subnet-group`. **AWS CLI** **So ändern Sie eine Cache-Subnetzgruppe** Im folgenden Beispiel für `modify-cache-subnet-group` wird die angegebene Cache-Subnetzgruppe geändert. ``` aws elasticache modify-cache-subnet-group \ --cache-subnet-group-name kxkxk \ --cache-subnet-group-description "mygroup" ``` Ausgabe: ``` { "CacheSubnetGroup": { "CacheSubnetGroupName": "kxkxk", "CacheSubnetGroupDescription": "mygroup", "VpcId": "vpc-xxxxcdb", "Subnets": [ { "SubnetIdentifier": "subnet-xxxxbff", "SubnetAvailabilityZone": { "Name": "us-west-2a" } } ] } } ``` Weitere Informationen finden Sie unter [Ändern einer Subnetzgruppe](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/SubnetGroups.Modifying.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [ModifyCacheSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/modify-cache-subnet-group.html)in der *AWS CLI Befehlsreferenz*. ### `modify-global-replication-group` Das folgende Codebeispiel zeigt die Verwendung`modify-global-replication-group`. **AWS CLI** **So ändern Sie eine globale Replikationsgruppe** Im folgenden Beispiel für `modify-global-replication-group` werden die Eigenschaften einer globalen Replikationsgruppe mithilfe der Redis-Engine geändert, wobei in diesem Fall das automatische Failover deaktiviert wird. ``` aws elasticache modify-global-replication-group \ --global-replication-group-id sgaui-pat-group \ --apply-immediately \ --no-automatic-failover-enabled ``` Ausgabe ``` { "GlobalReplicationGroup": { "GlobalReplicationGroupId": "sgaui-test-group", "GlobalReplicationGroupDescription": " ", "Status": "modifying", "CacheNodeType": "cache.r5.large", "Engine": "redis", "EngineVersion": "5.0.6", "ClusterEnabled": false, "AuthTokenEnabled": false, "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [AWS Regionsübergreifende Replikation mithilfe von Global Datastore](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Redis-Global-Datastore.html) im *Elasticache-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [ModifyGlobalReplicationGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/modify-global-replication-group.html)in AWS CLI der Befehlsreferenz.* ### `modify-replication-group-shard-configuration` Das folgende Codebeispiel zeigt die Verwendung`modify-replication-group-shard-configuration`. **AWS CLI** **So ändern Sie die Shard-Konfiguration einer Replikationsgruppe** Im folgenden Beispiel für `modify-replication-group-shard-configuration` wird die Anzahl der Knotengruppen mithilfe der Redis-Engine verringert. ``` aws elasticache modify-replication-group-shard-configuration \ --replication-group-id mycluster \ --node-group-count 3 \ --apply-immediately \ --node-groups-to-remove 0002 ``` Ausgabe ``` { "ReplicationGroup": { "ReplicationGroupId": "mycluster", "Description": "mycluster", "GlobalReplicationGroupInfo": {}, "Status": "modifying", "PendingModifiedValues": {}, "MemberClusters": [ "mycluster-0002-001", "mycluster-0002-002", "mycluster-0002-003", "mycluster-0003-001", "mycluster-0003-002", "mycluster-0003-003", "mycluster-0003-004", "mycluster-0004-001", "mycluster-0004-002", "mycluster-0004-003", "mycluster-0005-001", "mycluster-0005-002", "mycluster-0005-003" ], "NodeGroups": [ { "NodeGroupId": "0002", "Status": "modifying", "Slots": "894-1767,3134-4443,5149-5461,6827-7332,12570-13662", "NodeGroupMembers": [ { "CacheClusterId": "mycluster-0002-001", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2c" }, { "CacheClusterId": "mycluster-0002-002", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2a" }, { "CacheClusterId": "mycluster-0002-003", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2b" } ] }, { "NodeGroupId": "0003", "Status": "modifying", "Slots": "0-324,5462-5692,6784-6826,7698-8191,10923-11075,12441-12569,13663-16383", "NodeGroupMembers": [ { "CacheClusterId": "mycluster-0003-001", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2c" }, { "CacheClusterId": "mycluster-0003-002", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2b" }, { "CacheClusterId": "mycluster-0003-003", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2a" }, { "CacheClusterId": "mycluster-0003-004", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2c" } ] }, { "NodeGroupId": "0004", "Status": "modifying", "Slots": "325-336,4706-5148,7333-7697,9012-10922,11076-12440", "NodeGroupMembers": [ { "CacheClusterId": "mycluster-0004-001", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2b" }, { "CacheClusterId": "mycluster-0004-002", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2a" }, { "CacheClusterId": "mycluster-0004-003", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2c" } ] }, { "NodeGroupId": "0005", "Status": "modifying", "Slots": "337-893,1768-3133,4444-4705,5693-6783,8192-9011", "NodeGroupMembers": [ { "CacheClusterId": "mycluster-0005-001", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2a" }, { "CacheClusterId": "mycluster-0005-002", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2c" }, { "CacheClusterId": "mycluster-0005-003", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2b" } ] } ], "AutomaticFailover": "enabled", "MultiAZ": "enabled", "ConfigurationEndpoint": { "Address": "mycluster.g2xbih.clustercfg.usw2.cache.amazonaws.com", "Port": 6379 }, "SnapshotRetentionLimit": 1, "SnapshotWindow": "13:00-14:00", "ClusterEnabled": true, "CacheNodeType": "cache.r5.xlarge", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [Skalierung ElastiCache für Redis-Cluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Scaling.html) im *Elasticache-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ModifyReplicationGroupShardConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/modify-replication-group-shard-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `modify-replication-group` Das folgende Codebeispiel zeigt die Verwendung`modify-replication-group`. **AWS CLI** **So ändern Sie eine Replikationsgruppe** Im folgenden Beispiel für `modify-replication-group` wird Multi-AZ mithilfe der Redis-Engine deaktiviert. ``` aws elasticache modify-replication-group \ --replication-group-id test-cluster \ --no-multi-az-enabled \ --apply-immediately ``` Ausgabe ``` { "ReplicationGroup": { "ReplicationGroupId": "test-cluster", "Description": "test-cluster", "GlobalReplicationGroupInfo": { "GlobalReplicationGroupId": "sgaui-pat-group", "GlobalReplicationGroupMemberRole": "PRIMARY" }, "Status": "available", "PendingModifiedValues": {}, "MemberClusters": [ "test-cluster-001", "test-cluster-002", "test-cluster-003" ], "NodeGroups": [ { "NodeGroupId": "0001", "Status": "available", "PrimaryEndpoint": { "Address": "test-cluster.g2xbih.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "ReaderEndpoint": { "Address": "test-cluster-ro.g2xbih.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "NodeGroupMembers": [ { "CacheClusterId": "test-cluster-001", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "test-cluster-001.g2xbih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2c", "CurrentRole": "primary" }, { "CacheClusterId": "test-cluster-002", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "test-cluster-002.g2xbih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2b", "CurrentRole": "replica" }, { "CacheClusterId": "test-cluster-003", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "test-cluster-003.g2xbih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "replica" } ] } ], "SnapshottingClusterId": "test-cluster-002", "AutomaticFailover": "enabled", "MultiAZ": "disabled", "SnapshotRetentionLimit": 1, "SnapshotWindow": "08:00-09:00", "ClusterEnabled": false, "CacheNodeType": "cache.r5.large", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` Weitere Informationen finden Sie unter [Ändern einer Replikationsgruppe](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Replication.Modify.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [ModifyReplicationGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/modify-replication-group.html)in der *AWS CLI Befehlsreferenz*. ### `modify-user-group` Das folgende Codebeispiel zeigt die Verwendung`modify-user-group`. **AWS CLI** **So ändern Sie eine Benutzergruppe** Im folgenden Beispiel für `modify-user-group` wird ein Benutzer zur Benutzergruppe hinzugefügt. ``` aws elasticache modify-user-group \ --user-group-id myusergroup \ --user-ids-to-add user1 ``` Ausgabe: ``` { "UserGroupId": "myusergroup", "Status": "modifying", "Engine": "redis", "UserIds": [ "default" ], "PendingChanges": { "UserIdsToAdd": [ "user1" ] }, "ReplicationGroups": [], "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:usergroup:myusergroup" } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit der rollenbasierten Zugriffskontrolle (RBAC)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.RBAC.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [ModifyUserGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/modify-user-group.html)in der *AWS CLI Befehlsreferenz*. ### `modify-user` Das folgende Codebeispiel zeigt die Verwendung`modify-user`. **AWS CLI** **Um einen Benutzer zu ändern** Im folgenden Beispiel für `modify-user` wird die Zugriffszeichenfolge eines Benutzers geändert. ``` aws elasticache modify-user \ --user-id user2 \ --append-access-string "on ~* +@all" ``` Ausgabe: ``` { "UserId": "user2", "UserName": "myUser", "Status": "modifying", "Engine": "redis", "AccessString": "on ~* +@all", "UserGroupIds": [], "Authentication": { "Type": "password", "PasswordCount": 1 }, "ARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxx52:user:user2" } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit der rollenbasierten Zugriffskontrolle (RBAC)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Clusters.RBAC.html) im *Benutzerhandbuch für ElastiCache‭‭*. + Einzelheiten zur API finden Sie [ModifyUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/modify-user.html)in der *AWS CLI Befehlsreferenz*. ### `purchase-reserved-cache-nodes-offering` Das folgende Codebeispiel zeigt die Verwendung`purchase-reserved-cache-nodes-offering`. **AWS CLI** **Um eine zu kaufen reserved-cache-node-offering** Im folgenden Beispiel für `purchase-reserved-cache-nodes-offering` können Sie ein reserviertes Cache-Knoten-Angebot kaufen. ``` aws elasticache purchase-reserved-cache-nodes-offering \ --reserved-cache-nodes-offering-id xxxxxxx-4da5-4b90-b92d-929fbd7abed2 ``` Ausgabe ``` { "ReservedCacheNode": { "ReservedCacheNodeId": "ri-2020-06-30-17-59-40-474", "ReservedCacheNodesOfferingId": "xxxxxxx-4da5-4b90-b92d-929fbd7abed2", "CacheNodeType": "cache.m3.2xlarge", "StartTime": "2020-06-30T17:59:40.474000+00:00", "Duration": 31536000, "FixedPrice": 1772.0, "UsagePrice": 0.0, "CacheNodeCount": 1, "ProductDescription": "redis", "OfferingType": "Heavy Utilization", "State": "payment-pending", "RecurringCharges": [ { "RecurringChargeAmount": 0.25, "RecurringChargeFrequency": "Hourly" } ] } } ``` Weitere Informationen finden Sie unter [Abrufen von Informationen über Angebote für reservierte Knoten](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/reserved-nodes-offerings.html) im *Benutzerhandbuch für ElastiCache Redis‭‭* oder unter [Abrufen von Informationen über Angebote für reservierte Knoten](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/reserved-nodes-offerings.html) im *Benutzerhandbuch für ElastiCache für Memcached*. + Einzelheiten zur API finden Sie [PurchaseReservedCacheNodesOffering](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/purchase-reserved-cache-nodes-offering.html)in der *AWS CLI Befehlsreferenz*. ### `reboot-cache-cluster` Das folgende Codebeispiel zeigt die Verwendung`reboot-cache-cluster`. **AWS CLI** **So starten Sie einen Cache-Cluster neu** Im folgenden Beispiel für `reboot-cache-cluster` werden einige oder alle Cache-Knoten in einem bereitgestellten Cluster neu gestartet. Bei diesem Vorgang werden alle geänderten Cache-Parametergruppen auf den Cluster angewendet. Der Neustart findet so schnell wie möglich statt und führt zu einem kurzzeitigen Ausfall des Clusters. Während des Neustarts wird der Cluster-Status auf `REBOOTING` gesetzt. ``` aws elasticache reboot-cache-cluster \ --cache-cluster-id "my-cluster-001" \ --cache-node-ids-to-reboot "0001" ``` Ausgabe: ``` { "CacheCluster": { "CacheClusterId": "my-cluster-001", "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "CacheNodeType": "cache.r5.xlarge", "Engine": "redis", "EngineVersion": "5.0.5", "CacheClusterStatus": "rebooting cache cluster nodes", "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-west-2a", "CacheClusterCreateTime": "2019-11-26T03:35:04.546Z", "PreferredMaintenanceWindow": "mon:04:05-mon:05:05", "PendingModifiedValues": {}, "NotificationConfiguration": { "TopicArn": "arn:aws:sns:us-west-2:xxxxxxxxxx152:My_Topic", "TopicStatus": "active" }, "CacheSecurityGroups": [], "CacheParameterGroup": { "CacheParameterGroupName": "mygroup", "ParameterApplyStatus": "in-sync", "CacheNodeIdsToReboot": [] }, "CacheSubnetGroupName": "kxkxk", "AutoMinorVersionUpgrade": true, "SecurityGroups": [ { "SecurityGroupId": "sg-xxxxxxxxxxxxx836", "Status": "active" }, { "SecurityGroupId": "sg-xxxxxxxx7b", "Status": "active" } ], "ReplicationGroupId": "my-cluster", "SnapshotRetentionLimit": 0, "SnapshotWindow": "07:30-08:30", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` *Weitere Informationen finden Sie unter Einen Cluster neu starten < https://docs.aws.amazon.com/AmazonElastiCache/ latest/red-ug/Clusters .rebooting.html im Elasticache-Benutzerhandbuch.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [RebootCacheCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/reboot-cache-cluster.html)AWS CLI * ### `reset-cache-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`reset-cache-parameter-group`. **AWS CLI** **So setzen Sie eine Cache-Parametergruppe zurück** Im folgenden Beispiel für `reset-cache-parameter-group` werden die Parameter einer Cache-Parametergruppe auf den Standardwert der Engine oder des Systems zurückgesetzt. Sie können bestimmte Parameter zurücksetzen, indem Sie eine Liste mit Parameternamen einreichen. Wenn Sie die gesamte Cache-Parametergruppe zurücksetzen möchten, geben Sie die Parameter `--reset-all-parameters` und `--cache-parameter-group-name` an. ``` aws elasticache reset-cache-parameter-group \ --cache-parameter-group-name "mygroup" \ --reset-all-parameters ``` Ausgabe: ``` { "CacheParameterGroupName": "mygroup" } ``` + Einzelheiten zur API finden Sie [ResetCacheParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/reset-cache-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `start-migration` Das folgende Codebeispiel zeigt die Verwendung`start-migration`. **AWS CLI** **So starten Sie eine Migration** Im Folgenden werden Ihre Daten mithilfe der Redis-Engine von selbst gehostetem Redis auf Amazon EC2 zu Amazon `start-migration` ElastiCache migriert. ``` aws elasticache start-migration \ --replication-group-id test \ --customer-node-endpoint-list "Address='test.g2xbih.ng.0001.usw2.cache.amazonaws.com',Port=6379" ``` Ausgabe ``` { "ReplicationGroup": { "ReplicationGroupId": "test", "Description": "test", "GlobalReplicationGroupInfo": {}, "Status": "modifying", "PendingModifiedValues": {}, "MemberClusters": [ "test-001", "test-002", "test-003" ], "NodeGroups": [ { "NodeGroupId": "0001", "Status": "available", "PrimaryEndpoint": { "Address": "test.g2xbih.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "ReaderEndpoint": { "Address": "test-ro.g2xbih.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "NodeGroupMembers": [ { "CacheClusterId": "test-001", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "test-001.g2xbih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "primary" }, { "CacheClusterId": "test-002", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "test-002.g2xbih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2c", "CurrentRole": "replica" }, { "CacheClusterId": "test-003", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "test-003.g2xbih.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2b", "CurrentRole": "replica" } ] } ], "SnapshottingClusterId": "test-002", "AutomaticFailover": "enabled", "MultiAZ": "enabled", "SnapshotRetentionLimit": 1, "SnapshotWindow": "07:30-08:30", "ClusterEnabled": false, "CacheNodeType": "cache.r5.large", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` *Weitere Informationen finden Sie unter [Online-Migration zu ElastiCache](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/OnlineMigration.html) im Elasticache-Benutzerhandbuch.* + Einzelheiten zur API finden Sie [StartMigration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/start-migration.html)in der *AWS CLI Befehlsreferenz.* ### `test-failover` Das folgende Codebeispiel zeigt die Verwendung`test-failover`. **AWS CLI** **So testen Sie das Failover einer Knotengruppe** Im folgenden Beispiel für `test-failover` wird das automatische Failover auf die angegebene Knotengruppe (in der Konsole als Shard bezeichnet) in einer Replikationsgruppe (in der Konsole als Cluster bezeichnet) getestet. ``` aws elasticache test-failover / --replication-group-id "mycluster" / --node-group-id "0001" ``` Ausgabe: ``` { "ReplicationGroup": { "ReplicationGroupId": "mycluster", "Description": "My Cluster", "Status": "available", "PendingModifiedValues": {}, "MemberClusters": [ "mycluster-0001-001", "mycluster-0001-002", "mycluster-0001-003", "mycluster-0002-001", "mycluster-0002-002", "mycluster-0002-003", "mycluster-0003-001", "mycluster-0003-002", "mycluster-0003-003" ], "NodeGroups": [ { "NodeGroupId": "0001", "Status": "available", "Slots": "0-5461", "NodeGroupMembers": [ { "CacheClusterId": "mycluster-0001-001", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2b" }, { "CacheClusterId": "mycluster-0001-002", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2a" }, { "CacheClusterId": "mycluster-0001-003", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2c" } ] }, { "NodeGroupId": "0002", "Status": "available", "Slots": "5462-10922", "NodeGroupMembers": [ { "CacheClusterId": "mycluster-0002-001", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2a" }, { "CacheClusterId": "mycluster-0002-002", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2b" }, { "CacheClusterId": "mycluster-0002-003", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2c" } ] }, { "NodeGroupId": "0003", "Status": "available", "Slots": "10923-16383", "NodeGroupMembers": [ { "CacheClusterId": "mycluster-0003-001", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2c" }, { "CacheClusterId": "mycluster-0003-002", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2b" }, { "CacheClusterId": "mycluster-0003-003", "CacheNodeId": "0001", "PreferredAvailabilityZone": "us-west-2a" } ] } ], "AutomaticFailover": "enabled", "ConfigurationEndpoint": { "Address": "mycluster.xxxxih.clustercfg.usw2.cache.amazonaws.com", "Port": 6379 }, "SnapshotRetentionLimit": 1, "SnapshotWindow": "13:00-14:00", "ClusterEnabled": true, "CacheNodeType": "cache.r5.large", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false } } ``` + Einzelheiten zur API finden Sie [TestFailover](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticache/test-failover.html)in der *AWS CLI Befehlsreferenz*. # MediaStore Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren MediaStore. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-container` Das folgende Codebeispiel zeigt, wie Sie`create-container`. **AWS CLI** **So erstellen Sie einen Container** Im folgenden Beispiel für `create-container` wird ein neuer leerer Container erstellt. ``` aws mediastore create-container --container-name ExampleContainer ``` Ausgabe: ``` { "Container": { "AccessLoggingEnabled": false, "CreationTime": 1563557265, "Name": "ExampleContainer", "Status": "CREATING", "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Containers](https://docs.aws.amazon.com/mediastore/latest/ug/containers-create.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie [CreateContainer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/create-container.html)in der *AWS CLI Befehlsreferenz.* ### `delete-container-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-container-policy`. **AWS CLI** **So löschen Sie eine Container-Richtlinie** Im folgenden Beispiel für `delete-container-policy` wird die Richtlinie gelöscht, die dem angegebenen Container zugewiesen wurde. Wenn die Richtlinie gelöscht wird, weist AWS Elemental dem Container MediaStore automatisch die Standardrichtlinie zu. ``` aws mediastore delete-container-policy \ --container-name LiveEvents ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [DeleteContainerPolicy](https://docs.aws.amazon.com/mediastore/latest/apireference/API_DeleteContainerPolicy.html)in der *AWS Elemental API-Referenz MediaStore *. + Einzelheiten zur API finden Sie unter [DeleteContainerPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/delete-container-policy.html)*Befehlsreferenz.* ### `delete-container` Das folgende Codebeispiel zeigt die Verwendung`delete-container`. **AWS CLI** **So löschen Sie einen Container** Im folgenden Beispiel für `delete-container` wird der angegebene Container gelöscht. Sie können einen Container nur löschen, wenn er keine Objekte enthält. ``` aws mediastore delete-container \ --container-name=ExampleLiveDemo ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Containers](https://docs.aws.amazon.com/mediastore/latest/ug/containers-delete.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie [DeleteContainer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/delete-container.html)in der *AWS CLI Befehlsreferenz.* ### `delete-cors-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-cors-policy`. **AWS CLI** **So löschen Sie eine CORS-Richtlinie** Im folgenden Beispiel für `delete-cors-policy` wird die CORS-Richtlinie (Cross-Origin Resource Sharing) gelöscht, die dem angegebenen Container zugewiesen wurde. ``` aws mediastore delete-cors-policy \ --container-name ExampleContainer ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer CORS-Richtlinie](https://docs.aws.amazon.com/mediastore/latest/ug/cors-policy-deleting.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie unter [DeleteCorsPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/delete-cors-policy.html)*Befehlsreferenz*. ### `delete-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-lifecycle-policy`. **AWS CLI** **Um eine Objektlebenszyklus-Richtlinie zu löschen** Im folgenden Beispiel für `delete-lifecycle-policy` wird die Objektlebenszyklus-Richtlinie gelöscht, die dem angegebenen Container zugewiesen wurde. Es dauert bis zu 20 Minuten, bis die Änderung wirksam wird. ``` aws mediastore delete-lifecycle-policy \ --container-name LiveEvents ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Object Lifecycle-Richtlinie](https://docs.aws.amazon.com/mediastore/latest/ug/policies-object-lifecycle-delete.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie unter [DeleteLifecyclePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/delete-lifecycle-policy.html)*Befehlsreferenz.* ### `describe-container` Das folgende Codebeispiel zeigt die Verwendung`describe-container`. **AWS CLI** **So zeigen Sie die Details für einen Container an** Im folgenden Beispiel für `describe-container` werden die Details des angegebenen Containers angezeigt. ``` aws mediastore describe-container \ --container-name ExampleContainer ``` Ausgabe: ``` { "Container": { "CreationTime": 1563558086, "AccessLoggingEnabled": false, "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer", "Status": "ACTIVE", "Name": "ExampleContainer", "Endpoint": "https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com" } } ``` Weitere Informationen finden Sie unter [Anzeigen der Details für einen Container](https://docs.aws.amazon.com/mediastore/latest/ug/containers-view-details.html) im *AWS MediaStore Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeContainer AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/describe-container.html)*Befehlsreferenz.* ### `describe-object` Das folgende Codebeispiel zeigt die Verwendung`describe-object`. **AWS CLI** **So zeigen Sie eine Liste der Objekte und Ordner in einem bestimmten Container an** Im folgenden Beispiel für `describe-object` werden Elemente (Objekte und Ordner) angezeigt, die in einem angegebenen Container gespeichert sind. ``` aws mediastore-data describe-object \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --path /folder_name/file1234.jpg ``` Ausgabe: ``` { "ContentType": "image/jpeg", "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT", "ContentLength": "2307346", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3" } ``` Weitere Informationen finden Sie unter [Anzeigen der Details eines Objekts](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-details.html) im *AWS MediaStore Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeObject AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/describe-object.html)*Befehlsreferenz.* ### `get-container-policy` Das folgende Codebeispiel zeigt die Verwendung`get-container-policy`. **AWS CLI** **So zeigen Sie eine Containerrichtlinie an** Im folgenden Beispiel für `get-container-policy` wird die ressourcenbasierte Richtlinie des angegebenen Containers angezeigt. ``` aws mediastore get-container-policy \ --container-name ExampleLiveDemo ``` Ausgabe: ``` { "Policy": { "Version":"2012-10-17", "Statement": [ { "Sid": "PublicReadOverHttps", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": [ "mediastore:GetObject", "mediastore:DescribeObject" ], "Resource": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleLiveDemo/", "Condition": { "Bool": { "aws:SecureTransport": "true" } } } ] } } ``` Weitere Informationen finden Sie unter [Container-Richtlinie anzeigen](https://docs.aws.amazon.com/mediastore/latest/ug/policies-view.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie unter [GetContainerPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/get-container-policy.html)*Befehlsreferenz.* ### `get-cors-policy` Das folgende Codebeispiel zeigt die Verwendung`get-cors-policy`. **AWS CLI** **So zeigen Sie eine CORS-Richtlinie an** Im folgenden Beispiel für `get-cors-policy` wird die CORS-Richtlinie (Cross-Origin Resource Sharing) angezeigt, die dem angegebenen Container zugewiesen wurde. ``` aws mediastore get-cors-policy \ --container-name ExampleContainer \ --region us-west-2 ``` Ausgabe: ``` { "CorsPolicy": [ { "AllowedMethods": [ "GET", "HEAD" ], "MaxAgeSeconds": 3000, "AllowedOrigins": [ "" ], "AllowedHeaders": [ "" ] } ] } ``` Weitere Informationen finden Sie unter [Anzeigen einer CORS-Richtlinie](https://docs.aws.amazon.com/mediastore/latest/ug/cors-policy-viewing.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie unter [GetCorsPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/get-cors-policy.html)*Befehlsreferenz*. ### `get-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`get-lifecycle-policy`. **AWS CLI** **Um eine Objektlebenszyklus-Richtlinie anzuzeigen** Im folgenden Beispiel für `get-lifecycle-policy` wird die Objektlebenszyklus-Richtlinie angezeigt, die dem angegebenen Container zugewiesen wurde. ``` aws mediastore get-lifecycle-policy \ --container-name LiveEvents ``` Ausgabe: ``` { "LifecyclePolicy": { "rules": [ { "definition": { "path": [ { "prefix": "Football/" }, { "prefix": "Baseball/" } ], "days_since_create": [ { "numeric": [ ">", 28 ] } ] }, "action": "EXPIRE" } ] } } ``` Weitere Informationen finden Sie unter [Object Lifecycle-Richtlinien anzeigen](https://docs.aws.amazon.com/mediastore/latest/ug/policies-object-lifecycle-view.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie unter [GetLifecyclePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/get-lifecycle-policy.html)*Befehlsreferenz.* ### `get-object` Das folgende Codebeispiel zeigt die Verwendung`get-object`. **AWS CLI** **So laden Sie ein Objekt herunter** Im folgenden Beispiel für `get-object` wird ein Objekt in den angegebenen Endpunkt heruntergeladen. ``` aws mediastore-data get-object \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --path=/folder_name/README.md README.md ``` Ausgabe: ``` { "ContentLength": "2307346", "ContentType": "image/jpeg", "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3", "StatusCode": 200 } ``` **So laden Sie einen Teil eines Objekts herunter** Im folgenden Beispiel für `get-object` wird ein Teil eines Objekts in den angegebenen Endpunkt heruntergeladen. ``` aws mediastore-data get-object \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --path /folder_name/README.md \ --range="bytes=0-100" README2.md ``` Ausgabe: ``` { "StatusCode": 206, "ContentRange": "bytes 0-100/2307346", "ContentLength": "101", "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT", "ContentType": "image/jpeg", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3" } ``` Weitere Informationen finden Sie unter [Objekt herunterladen](https://docs.aws.amazon.com/mediastore/latest/ug/objects-download.html) im *AWS MediaStore Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/get-object.html)in der *AWS CLI Befehlsreferenz.* ### `list-containers` Das folgende Codebeispiel zeigt die Verwendung`list-containers`. **AWS CLI** **So zeigen Sie eine Liste der Container an** Im folgenden Beispiel für `list-containers` wird eine Liste aller Container angezeigt, die dem Konto zugeordnet sind. ``` aws mediastore list-containers ``` Ausgabe: ``` { "Containers": [ { "CreationTime": 1505317931, "Endpoint": "https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com", "Status": "ACTIVE", "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleLiveDemo", "AccessLoggingEnabled": false, "Name": "ExampleLiveDemo" }, { "CreationTime": 1506528818, "Endpoint": "https://fffggghhhiiijj.data.mediastore.us-west-2.amazonaws.com", "Status": "ACTIVE", "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer", "AccessLoggingEnabled": false, "Name": "ExampleContainer" } ] } ``` Weitere Informationen finden Sie unter [Eine Liste von Containern anzeigen](https://docs.aws.amazon.com/mediastore/latest/ug/containers-view-list.html) im *AWS MediaStore Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListContainers AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/list-containers.html)*Befehlsreferenz.* ### `list-items` Das folgende Codebeispiel zeigt die Verwendung`list-items`. **AWS CLI** **Beispiel 1: So zeigen Sie eine Liste der Objekte und Ordner in einem bestimmten Container an** Im folgenden Beispiel für `list-items` werden Elemente (Objekte und Ordner) angezeigt, die im angegebenen Container gespeichert sind. ``` aws mediastore-data list-items \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com ``` Ausgabe: ``` { "Items": [ { "ContentType": "image/jpeg", "LastModified": 1563571859.379, "Name": "filename.jpg", "Type": "OBJECT", "ETag": "543ab21abcd1a234ab123456a1a2b12345ab12abc12a1234abc1a2bc12345a12", "ContentLength": 3784 }, { "Type": "FOLDER", "Name": "ExampleLiveDemo" } ] } ``` **Beispiel 2: So zeigen Sie eine Liste der Objekte und Ordner in einem bestimmten Ordner an** Im folgenden Beispiel für `list-items` werden Elemente (Objekte und Ordner) angezeigt, die in einem bestimmten Ordner gespeichert sind. ``` aws mediastore-data list-items \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com ``` Ausgabe: ``` { "Items": [ { "ContentType": "image/jpeg", "LastModified": 1563571859.379, "Name": "filename.jpg", "Type": "OBJECT", "ETag": "543ab21abcd1a234ab123456a1a2b12345ab12abc12a1234abc1a2bc12345a12", "ContentLength": 3784 }, { "Type": "FOLDER", "Name": "ExampleLiveDemo" } ] } ``` Weitere Informationen finden Sie im *AWS MediaStore Elemental-Benutzerhandbuch* unter [Eine Objektliste anzeigen](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-list.html). + Einzelheiten zur API finden Sie unter [ListItems AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/list-items.html)*Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags für einen Container auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tag-Schlüssel und -Werte angezeigt, die dem angegebenen Container zugeordnet wurden. ``` aws mediastore list-tags-for-resource \ --resource arn:aws:mediastore:us-west-2:1213456789012:container/ExampleContainer ``` Ausgabe: ``` { "Tags": [ { "Value": "Test", "Key": "Environment" }, { "Value": "West", "Key": "Region" } ] } ``` Weitere Informationen finden Sie [ListTagsForResource](https://docs.aws.amazon.com/mediastore/latest/apireference/API_ListTagsForResource.html)in der *AWS Elemental MediaStore API-Referenz.* + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `put-container-policy` Das folgende Codebeispiel zeigt die Verwendung`put-container-policy`. **AWS CLI** **So bearbeiten Sie eine Containerrichtlinie** Im folgenden Beispiel für `put-container-policy` wird dem angegebenen Container eine andere Richtlinie zugewiesen. In diesem Beispiel ist die aktualisierte Richtlinie in einer Datei mit dem Namen `LiveEventsContainerPolicy.json` definiert. ``` aws mediastore put-container-policy \ --container-name LiveEvents \ --policy file://LiveEventsContainerPolicy.json ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Bearbeiten einer Container-Richtlinie](https://docs.aws.amazon.com/mediastore/latest/ug/policies-edit.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie unter [PutContainerPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/put-container-policy.html)*Befehlsreferenz.* ### `put-cors-policy` Das folgende Codebeispiel zeigt die Verwendung`put-cors-policy`. **AWS CLI** **Beispiel 1: So fügen Sie eine CORS-Richtlinie hinzu** Im folgenden Beispiel für `put-cors-policy` wird dem angegebenen Container eine CORS-Richtlinie (Cross-Origin Resource Sharing) zugewiesen. Der Inhalt der CORS-Richtlinie befindet sich in der Datei mit dem Namen `corsPolicy.json`. ``` aws mediastore put-cors-policy \ --container-name ExampleContainer \ --cors-policy file://corsPolicy.json ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen einer CORS-Richtlinie zu einem Container](https://docs.aws.amazon.com/mediastore/latest/ug/cors-policy-adding.html) im *AWS Elemental MediaStore User Guide*. **Beispiel 2: So fügen Sie eine CORS-Richtlinie hinzu** Im folgenden Beispiel für `put-cors-policy` wird die CORS-Richtlinie (Cross-Origin Resource Sharing) aktualisiert, die dem angegebenen Container zugewiesen wurde. Der Inhalt der aktualisierten CORS-Richtlinie befindet sich in der Datei mit dem Namen `corsPolicy2.json`. Weitere Informationen finden Sie unter [Bearbeiten einer CORS-Richtlinie](https://docs.aws.amazon.com/mediastore/latest/ug/cors-policy-editing.html) im *AWS MediaStore Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [PutCorsPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/put-cors-policy.html)*Befehlsreferenz*. ### `put-lifecycle-policy` Das folgende Codebeispiel zeigt die Verwendung`put-lifecycle-policy`. **AWS CLI** **So erstellen Sie eine Objektlebenszyklus-Richtlinie** Im folgenden Beispiel für `put-lifecycle-policy` wird die Objektlebenszyklus-Richtlinie an den angegebenen Container angehängt. Auf diese Weise können Sie angeben, wie lange der Service Objekte in Ihrem Container speichern soll. MediaStore löscht Objekte im Container, sobald sie ihr Ablaufdatum erreicht haben, wie in der Richtlinie angegeben, die sich in der genannten `LiveEventsLifecyclePolicy.json` Datei befindet. ``` aws mediastore put-lifecycle-policy \ --container-name ExampleContainer \ --lifecycle-policy file://ExampleLifecyclePolicy.json ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen einer Object Lifecycle-Richtlinie zu einem Container](https://docs.aws.amazon.com/mediastore/latest/ug/policies-object-lifecycle-add.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie unter [PutLifecyclePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/put-lifecycle-policy.html)*Befehlsreferenz.* ### `put-object` Das folgende Codebeispiel zeigt die Verwendung`put-object`. **AWS CLI** **So laden Sie ein Objekt hoch** Im folgenden Beispiel für `put-object` wird ein Objekt in den angegebenen Container hochgeladen. Sie können einen Ordnerpfad angeben, unter dem das Objekt im Container gespeichert wird. Wenn der Ordner bereits existiert, MediaStore speichert AWS Elemental das Objekt im Ordner. Wenn der Ordner nicht vorhanden, legt der Service ihn an und speichert das Objekt in dem Ordner. ``` aws mediastore-data put-object \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --body README.md \ --path /folder_name/README.md \ --cache-control "max-age=6, public" \ --content-type binary/octet-stream ``` Ausgabe: ``` { "ContentSHA256": "74b5fdb517f423ed750ef214c44adfe2be36e37d861eafe9c842cbe1bf387a9d", "StorageClass": "TEMPORAL", "ETag": "af3e4731af032167a106015d1f2fe934e68b32ed1aa297a9e325f5c64979277b" } ``` Weitere Informationen finden Sie unter [Hochladen eines Objekts](https://docs.aws.amazon.com/mediastore/latest/ug/objects-upload.html) im *AWS Elemental-Benutzerhandbuch. MediaStore * + Einzelheiten zur API finden Sie [PutObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/put-object.html)in der *AWS CLI Befehlsreferenz*. ### `start-access-logging` Das folgende Codebeispiel zeigt die Verwendung`start-access-logging`. **AWS CLI** **So aktivieren Sie die Zugriffsprotokollierung für einen Container** Im folgenden Beispiel für `start-access-logging` wird die Zugriffsprotokollierung für den angegebenen Container aktiviert. ``` aws mediastore start-access-logging \ --container-name LiveEvents ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren der Zugriffsprotokollierung für einen Container](https://docs.aws.amazon.com/mediastore/latest/ug/monitoring-cloudwatch-logs-enable.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie unter [StartAccessLogging AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/start-access-logging.html)*Befehlsreferenz.* ### `stop-access-logging` Das folgende Codebeispiel zeigt die Verwendung`stop-access-logging`. **AWS CLI** **So deaktivieren Sie die Zugriffsprotokollierung für einen Container** Im folgenden Beispiel für `stop-access-logging` wird die Zugriffsprotokollierung für den angegebenen Container deaktiviert. ``` aws mediastore stop-access-logging \ --container-name LiveEvents ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Deaktivieren der Zugriffsprotokollierung für einen Container](https://docs.aws.amazon.com/mediastore/latest/ug/monitoring-cloudwatch-logs-disable.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie unter [StopAccessLogging AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/stop-access-logging.html)*Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie Tags zu einem Container hinzu** Im folgenden Beispiel für `tag-resource` werden die Tag-Schlüssel und -Werte des angegebenen Containers angezeigt. ``` aws mediastore tag-resource \ --resource arn:aws:mediastore:us-west-2:123456789012:container/ExampleContainer \ --tags '[{"Key": "Region", "Value": "West"}, {"Key": "Environment", "Value": "Test"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [TagResource](https://docs.aws.amazon.com/mediastore/latest/apireference/API_TagResource.html)in der *AWS Elemental MediaStore API-Referenz.* + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einem Container** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem angegebenen Tag-Schlüssel und dem zugehörigen Wert aus einem Container entfernt. ``` aws mediastore untag-resource \ --resource arn:aws:mediastore:us-west-2:123456789012:container/ExampleContainer \ --tag-keys Region ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [UntagResource](https://docs.aws.amazon.com/mediastore/latest/apireference/API_UntagResource.html)in der *AWS Elemental MediaStore API-Referenz.* . + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # Amazon EMR-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon EMR Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-instance-fleet` Das folgende Codebeispiel zeigt, wie Sie`add-instance-fleet`. **AWS CLI** **So fügen Sie einem Cluster eine Aufgaben-Instance-Flotte hinzu** In diesem Beispiel wird dem angegebenen Cluster eine neue Aufgaben-Instance-Flotte hinzugefügt. Befehl: ``` aws emr add-instance-fleet --cluster-id 'j-12ABCDEFGHI34JK' --instance-fleet InstanceFleetType=TASK,TargetSpotCapacity=1,LaunchSpecifications={SpotSpecification='{TimeoutDurationMinutes=20,TimeoutAction=TERMINATE_CLUSTER}'},InstanceTypeConfigs=['{InstanceType=m3.xlarge,BidPrice=0.5}'] ``` Ausgabe: ``` { "ClusterId": "j-12ABCDEFGHI34JK", "InstanceFleetId": "if-23ABCDEFGHI45JJ" } ``` + Einzelheiten zur API finden Sie [AddInstanceFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/add-instance-fleet.html)in der *AWS CLI Befehlsreferenz*. ### `add-steps` Das folgende Codebeispiel zeigt die Verwendung`add-steps`. **AWS CLI** **1. So fügen Sie einem Cluster benutzerdefinierte JAR-Schritte hinzu** Befehl: ``` aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://amzn-s3-demo-bucket/mytest.jar,Args=arg1,arg2,arg3 Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://amzn-s3-demo-bucket/mytest.jar,MainClass=mymainclass,Args=arg1,arg2,arg3 ``` Erforderliche Parameter: ``` Jar ``` Optionale Parameter: ``` Type, Name, ActionOnFailure, Args ``` Ausgabe: ``` { "StepIds":[ "s-XXXXXXXX", "s-YYYYYYYY" ] } ``` **2. So fügen Sie einem Cluster Streaming-Schritte hinzu** Befehl: ``` aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=STREAMING,Name='Streaming Program',ActionOnFailure=CONTINUE,Args=[-files,s3://elasticmapreduce/samples/wordcount/wordSplitter.py,-mapper,wordSplitter.py,-reducer,aggregate,-input,s3://elasticmapreduce/samples/wordcount/input,-output,s3://amzn-s3-demo-bucket/wordcount/output] ``` Erforderliche Parameter: ``` Type, Args ``` Optionale Parameter: ``` Name, ActionOnFailure ``` JSON-Äquivalent (Inhalt von step.json): ``` [ { "Name": "JSON Streaming Step", "Args": ["-files","s3://elasticmapreduce/samples/wordcount/wordSplitter.py","-mapper","wordSplitter.py","-reducer","aggregate","-input","s3://elasticmapreduce/samples/wordcount/input","-output","s3://amzn-s3-demo-bucket/wordcount/output"], "ActionOnFailure": "CONTINUE", "Type": "STREAMING" } ] ``` HINWEIS: JSON-Argumente müssen Optionen und Werte als eigene Elemente in der Liste enthalten. Befehl (mit step.json): ``` aws emr add-steps --cluster-id j-XXXXXXXX --steps file://./step.json ``` Ausgabe: ``` { "StepIds":[ "s-XXXXXXXX", "s-YYYYYYYY" ] } ``` **3. So fügen Sie einem Cluster einen Streaming-Schritt mit mehreren Dateien hinzu (nur JSON)** JSON (multiplefiles.json): ``` [ { "Name": "JSON Streaming Step", "Type": "STREAMING", "ActionOnFailure": "CONTINUE", "Args": [ "-files", "s3://amzn-s3-demo-bucket/mapper.py,s3://amzn-s3-demo-bucket/reducer.py", "-mapper", "mapper.py", "-reducer", "reducer.py", "-input", "s3://amzn-s3-demo-bucket/input", "-output", "s3://amzn-s3-demo-bucket/output"] } ] ``` Befehl: ``` aws emr add-steps --cluster-id j-XXXXXXXX --steps file://./multiplefiles.json ``` Erforderliche Parameter: ``` Type, Args ``` Optionale Parameter: ``` Name, ActionOnFailure ``` Ausgabe: ``` { "StepIds":[ "s-XXXXXXXX", ] } ``` **4. So fügen Sie einem Cluster Hive-Schritte hinzu** Befehl: ``` aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=HIVE,Name='Hive program',ActionOnFailure=CONTINUE,Args=[-f,s3://amzn-s3-demo-bucket/myhivescript.q,-d,INPUT=s3://amzn-s3-demo-bucket/myhiveinput,-d,OUTPUT=s3://amzn-s3-demo-bucket/myhiveoutput,arg1,arg2] Type=HIVE,Name='Hive steps',ActionOnFailure=TERMINATE_CLUSTER,Args=[-f,s3://elasticmapreduce/samples/hive-ads/libs/model-build.q,-d,INPUT=s3://elasticmapreduce/samples/hive-ads/tables,-d,OUTPUT=s3://amzn-s3-demo-bucket/hive-ads/output/2014-04-18/11-07-32,-d,LIBS=s3://elasticmapreduce/samples/hive-ads/libs] ``` Erforderliche Parameter: ``` Type, Args ``` Optionale Parameter: ``` Name, ActionOnFailure ``` Ausgabe: ``` { "StepIds":[ "s-XXXXXXXX", "s-YYYYYYYY" ] } ``` **5. So fügen Sie einem Cluster Pig-Schritte hinzu** Befehl: ``` aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=PIG,Name='Pig program',ActionOnFailure=CONTINUE,Args=[-f,s3://amzn-s3-demo-bucket/mypigscript.pig,-p,INPUT=s3://amzn-s3-demo-bucket/mypiginput,-p,OUTPUT=s3://amzn-s3-demo-bucket/mypigoutput,arg1,arg2] Type=PIG,Name='Pig program',Args=[-f,s3://elasticmapreduce/samples/pig-apache/do-reports2.pig,-p,INPUT=s3://elasticmapreduce/samples/pig-apache/input,-p,OUTPUT=s3://amzn-s3-demo-bucket/pig-apache/output,arg1,arg2] ``` Erforderliche Parameter: ``` Type, Args ``` Optionale Parameter: ``` Name, ActionOnFailure ``` Ausgabe: ``` { "StepIds":[ "s-XXXXXXXX", "s-YYYYYYYY" ] } ``` **6. So fügen Sie einem Cluster Impala-Schritte hinzu** Befehl: ``` aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=IMPALA,Name='Impala program',ActionOnFailure=CONTINUE,Args=--impala-script,s3://myimpala/input,--console-output-path,s3://myimpala/output ``` Erforderliche Parameter: ``` Type, Args ``` Optionale Parameter: ``` Name, ActionOnFailure ``` Ausgabe: ``` { "StepIds":[ "s-XXXXXXXX", "s-YYYYYYYY" ] } ``` + Einzelheiten zur API finden Sie [AddSteps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/add-steps.html)in der *AWS CLI Befehlsreferenz*. ### `add-tags` Das folgende Codebeispiel zeigt die Verwendung`add-tags`. **AWS CLI** **1. So fügen Sie einem Cluster Tags hinzu** Befehl: ``` aws emr add-tags --resource-id j-xxxxxxx --tags name="John Doe" age=29 sex=male address="123 East NW Seattle" ``` Ausgabe: ``` None ``` **2. So listen Sie die Tags eines Clusters auf** --Befehl: ``` aws emr describe-cluster --cluster-id j-XXXXXXYY --query Cluster.Tags ``` Ausgabe: ``` [ { "Value": "male", "Key": "sex" }, { "Value": "123 East NW Seattle", "Key": "address" }, { "Value": "John Doe", "Key": "name" }, { "Value": "29", "Key": "age" } ] ``` + Einzelheiten zur API finden Sie [AddTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/add-tags.html)in der *AWS CLI Befehlsreferenz*. ### `create-cluster-examples` Das folgende Codebeispiel zeigt die Verwendung`create-cluster-examples`. **AWS CLI** In den meisten der folgenden Beispiele wird davon ausgegangen, dass Sie die Amazon-EMR-Servicerolle und das Amazon-EC2-Instance-Profil angegeben haben. Falls nicht, müssen Sie jede erforderliche IAM-Rolle angeben oder den Parameter `--use-default-roles` verwenden, wenn Sie den Cluster erstellen. Weitere Informationen zur Angabe von IAM-Rollen finden [Sie unter Configure IAM-Rollen for Amazon EMR Permissions to AWS Services](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-iam-roles.html) im *Amazon EMR* Management Guide. **Beispiel 1: So erstellen Sie einen Cluster** Im folgenden Beispiel für `create-cluster` wird ein einfacher EMR-Cluster erstellt. ``` aws emr create-cluster \ --release-label emr-5.14.0 \ --instance-type m4.large \ --instance-count 2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So erstellen Sie einen Amazon EMR-Cluster mit Standard ServiceRole und Rollen InstanceProfile ** Im folgenden Beispiel für `create-cluster` wird ein Amazon-EMR-Cluster erstellt, der die Konfiguration `--instance-groups` verwendet. ``` aws emr create-cluster \ --release-label emr-5.14.0 \ --service-role EMR_DefaultRole \ --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` **Beispiel 3: So erstellen Sie einen Amazon-EMR-Cluster, der eine Instance-Flotte verwendet** Im folgenden Beispiel für `create-cluster` wird ein Amazon-EMR-Cluster erstellt, der die Konfiguration `--instance-fleets` verwendet und zwei Instance-Typen für jede Flotte und zwei EC2-Subnetze angibt. ``` aws emr create-cluster \ --release-label emr-5.14.0 \ --service-role EMR_DefaultRole \ --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole,SubnetIds=['subnet-ab12345c','subnet-de67890f'] \ --instance-fleets InstanceFleetType=MASTER,TargetOnDemandCapacity=1,InstanceTypeConfigs=['{InstanceType=m4.large}'] InstanceFleetType=CORE,TargetSpotCapacity=11,InstanceTypeConfigs=['{InstanceType=m4.large,BidPrice=0.5,WeightedCapacity=3}','{InstanceType=m4.2xlarge,BidPrice=0.9,WeightedCapacity=5}'],LaunchSpecifications={SpotSpecification='{TimeoutDurationMinutes=120,TimeoutAction=SWITCH_TO_ON_DEMAND}'} ``` **Beispiel 4: So erstellen Sie einen Cluster mit Standardrollen** Im folgenden Beispiel für `create-cluster` wird der Parameter `--use-default-roles` verwendet, um die standardmäßige Servicerolle und das standardmäßige Instance-Profil anzugeben. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --use-default-roles \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` **Beispiel 5: So erstellen Sie einen Cluster und geben die zu installierenden Anwendungen an** Im folgenden Beispiel für `create-cluster` wird der Parameter `--applications` verwendet, um die Anwendungen anzugeben, die von Amazon EMR installiert werden. In diesem Beispiel werden Hadoop, Hive und Pig installiert. ``` aws emr create-cluster \ --applications Name=Hadoop Name=Hive Name=Pig \ --release-label emr-5.9.0 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` **Beispiel 6: So erstellen Sie einen Cluster, der Spark enthält** Im folgenden Beispiel wird Spark installiert. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --applications Name=Spark \ --ec2-attributes KeyName=myKey \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` **Beispiel 7: So geben Sie ein benutzerdefiniertes AMI an, das für Cluster-Instances verwendet werden soll** Im folgenden Beispiel für `create-cluster` wird eine Cluster-Instance erstellt, die auf dem Amazon Linux AMI mit der ID `ami-a518e6df` basiert. ``` aws emr create-cluster \ --name "Cluster with My Custom AMI" \ --custom-ami-id ami-a518e6df \ --ebs-root-volume-size 20 \ --release-label emr-5.9.0 \ --use-default-roles \ --instance-count 2 \ --instance-type m4.large ``` **Beispiel 8: So passen Sie Anwendungskonfigurationen an** In den folgenden Beispielen wird der Parameter `--configurations` verwendet, um eine JSON-Konfigurationsdatei anzugeben, die Anwendungsanpassungen für Hadoop enthält. Weitere Informationen finden Sie unter [Konfigurieren von Anwendungen](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-configure-apps.html) in den *Amazon EMR-Versionshinweisen*. Inhalt von `configurations.json`: ``` [ { "Classification": "mapred-site", "Properties": { "mapred.tasktracker.map.tasks.maximum": 2 } }, { "Classification": "hadoop-env", "Properties": {}, "Configurations": [ { "Classification": "export", "Properties": { "HADOOP_DATANODE_HEAPSIZE": 2048, "HADOOP_NAMENODE_OPTS": "-XX:GCTimeRatio=19" } } ] } ] ``` Im folgenden Beispiel wird `configurations.json` als lokale Datei referenziert. ``` aws emr create-cluster \ --configurations file://configurations.json \ --release-label emr-5.9.0 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` Im folgenden Beispiel wird `configurations.json` als eine Datei in Amazon S3 referenziert. ``` aws emr create-cluster \ --configurations https://s3.amazonaws.com/amzn-s3-demo-bucket/configurations.json \ --release-label emr-5.9.0 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` **Beispiel 9: So erstellen Sie einen Cluster mit Master-, Core- und Aufgaben-Instance-Gruppen** Im folgenden Beispiel für `create-cluster` wird `--instance-groups` verwendet, um Typ und Anzahl der EC2-Instances anzugeben, die für Master-, Core- und Aufgaben-Instance-Gruppen verwendet werden sollen. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --instance-groups Name=Master,InstanceGroupType=MASTER,InstanceType=m4.large,InstanceCount=1 Name=Core,InstanceGroupType=CORE,InstanceType=m4.large,InstanceCount=2 Name=Task,InstanceGroupType=TASK,InstanceType=m4.large,InstanceCount=2 ``` **Beispiel 10: So geben Sie an, dass ein Cluster nach Abschluss aller Schritte beendet werden soll** Im folgenden Beispiel für `create-cluster` wird `--auto-terminate` verwendet, um anzugeben, dass der Cluster nach Abschluss aller Schritte automatisch heruntergefahren werden soll. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` **Beispiel 11: So geben Sie Cluster-Konfigurationsdetails wie das Amazon-EC2-Schlüsselpaar, die Netzwerkkonfiguration und Sicherheitsgruppen an** Im folgenden Beispiel für `create-cluster` wird ein Cluster mit dem Amazon-EC2-Schlüsselpaar `myKey` und einem benutzerdefinierten Instance-Profil namens `myProfile` erstellt. Schlüsselpaare werden verwendet, um SSH-Verbindungen zu Cluster-Knoten, hauptsächlich dem Hauptknoten, zu autorisieren. Weitere Informationen finden Sie unter [Verwenden eines Amazon-EC2-Schlüsselpaars für SSH-Anmeldeinformationen](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-access-ssh.html) im *Verwaltungshandbuch für Amazon EMR*. ``` aws emr create-cluster \ --ec2-attributes KeyName=myKey,InstanceProfile=myProfile \ --release-label emr-5.9.0 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` Im folgenden Beispiel wird ein Cluster in einem Amazon-VPC-Subnetz erstellt. ``` aws emr create-cluster \ --ec2-attributes SubnetId=subnet-xxxxx \ --release-label emr-5.9.0 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` Im folgenden Beispiel wird ein Cluster in der Availability Zone `us-east-1b` erstellt. ``` aws emr create-cluster \ --ec2-attributes AvailabilityZone=us-east-1b \ --release-label emr-5.9.0 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` Im folgenden Beispiel wird ein Cluster erstellt, bei dem nur die von Amazon EMR verwalteten Sicherheitsgruppen angegeben werden. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --service-role myServiceRole \ --ec2-attributes InstanceProfile=myRole,EmrManagedMasterSecurityGroup=sg-master1,EmrManagedSlaveSecurityGroup=sg-slave1 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` Im folgenden Beispiel wird ein Cluster erstellt, bei dem nur zusätzliche Amazon-EC2-Sicherheitsgruppen angegeben werden. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --service-role myServiceRole \ --ec2-attributes InstanceProfile=myRole,AdditionalMasterSecurityGroups=[sg-addMaster1,sg-addMaster2,sg-addMaster3,sg-addMaster4],AdditionalSlaveSecurityGroups=[sg-addSlave1,sg-addSlave2,sg-addSlave3,sg-addSlave4] \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` Im folgenden Beispiel wird ein Cluster erstellt, bei dem sowohl die von EMR verwalteten als auch zusätzliche Sicherheitsgruppen angegeben werden. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --service-role myServiceRole \ --ec2-attributes InstanceProfile=myRole,EmrManagedMasterSecurityGroup=sg-master1,EmrManagedSlaveSecurityGroup=sg-slave1,AdditionalMasterSecurityGroups=[sg-addMaster1,sg-addMaster2,sg-addMaster3,sg-addMaster4],AdditionalSlaveSecurityGroups=[sg-addSlave1,sg-addSlave2,sg-addSlave3,sg-addSlave4] \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` Im folgenden Beispiel wird ein Cluster in einem privaten VPC-Subnetz erstellt und eine bestimmte Amazon-EC2-Sicherheitsgruppe verwendet, um den Amazon-EMR-Servicezugriff zu aktivieren, der für Cluster in privaten Subnetzen erforderlich ist. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --service-role myServiceRole \ --ec2-attributes InstanceProfile=myRole,ServiceAccessSecurityGroup=sg-service-access,EmrManagedMasterSecurityGroup=sg-master,EmrManagedSlaveSecurityGroup=sg-slave \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` Im folgenden Beispiel werden Konfigurationsparameter für Sicherheitsgruppen mithilfe einer lokal gespeicherten JSON-Datei namens `ec2_attributes.json` spezifiziert. HINWEIS: JSON-Argumente müssen Optionen und Werte als eigene Elemente in der Liste enthalten. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --service-role myServiceRole \ --ec2-attributes file://ec2_attributes.json \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` Inhalt von `ec2_attributes.json`: ``` [ { "SubnetId": "subnet-xxxxx", "KeyName": "myKey", "InstanceProfile":"myRole", "EmrManagedMasterSecurityGroup": "sg-master1", "EmrManagedSlaveSecurityGroup": "sg-slave1", "ServiceAccessSecurityGroup": "sg-service-access", "AdditionalMasterSecurityGroups": ["sg-addMaster1","sg-addMaster2","sg-addMaster3","sg-addMaster4"], "AdditionalSlaveSecurityGroups": ["sg-addSlave1","sg-addSlave2","sg-addSlave3","sg-addSlave4"] } ] ``` **Beispiel 12: So aktivieren Sie das Debugging und geben eine Protokoll-URI an** Im folgenden Beispiel für `create-cluster` wird der Parameter `--enable-debugging` verwendet, mit dem Protokolldateien über das Debugging-Tool in der Amazon-EMR-Konsole einfacher angezeigt werden können. Der Parameter `--log-uri` ist für `--enable-debugging` erforderlich. ``` aws emr create-cluster \ --enable-debugging \ --log-uri s3://amzn-s3-demo-bucket/myLog \ --release-label emr-5.9.0 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` **Beispiel 13: So fügen Sie Tags beim Erstellen eines Clusters hinzu** Tags sind Schlüssel-Wert-Paare, mit deren Hilfe Cluster identifiziert und verwaltet werden können. Im folgenden Beispiel für `create-cluster` wird der Parameter `--tags` verwendet, um drei Tags für einen Cluster zu erstellen, eines mit dem Schlüsselnamen `name` und dem Wert `Shirley Rodriguez`, ein zweites mit dem Schlüsselnamen `age` und dem Wert `29` und ein drittes Tag mit dem Schlüsselnamen `department` und dem Wert `Analytics`. ``` aws emr create-cluster \ --tags name="Shirley Rodriguez" age=29 department="Analytics" \ --release-label emr-5.32.0 \ --instance-type m5.xlarge \ --instance-count 3 \ --use-default-roles ``` Im folgenden Beispiel werden die Tags aufgelistet, die auf einen Cluster angewendet wurden. ``` aws emr describe-cluster \ --cluster-id j-XXXXXXYY \ --query Cluster.Tags ``` **Beispiel 14: So verwenden Sie eine Sicherheitskonfiguration, die Verschlüsselung und andere Sicherheitsfunktionen aktiviert** Im folgenden Beispiel für `create-cluster` wird der Parameter `--security-configuration` verwendet, um eine Sicherheitskonfiguration für einen EMR-Cluster anzugeben. Sicherheitskonfigurationen können ab Amazon-EMR-Version 4.8.0 verwendet werden. ``` aws emr create-cluster \ --instance-type m4.large \ --release-label emr-5.9.0 \ --security-configuration mySecurityConfiguration ``` **Beispiel 15: So erstellen Sie einen Cluster mit zusätzlichen EBS-Speichervolumen, die für die Instance-Gruppen konfiguriert sind** Bei der Angabe zusätzlicher EBS-Volumes sind die folgenden Argumente erforderlich: `VolumeType`, `SizeInGB`, falls `EbsBlockDeviceConfigs` angegeben ist. Im folgenden Beispiel für `create-cluster` wird ein Cluster mit mehreren EBS-Volumes erstellt, die mit EC2-Instances in der Core-Instance-Gruppe verbunden sind. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --use-default-roles \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=d2.xlarge 'InstanceGroupType=CORE,InstanceCount=2,InstanceType=d2.xlarge,EbsConfiguration={EbsOptimized=true,EbsBlockDeviceConfigs=[{VolumeSpecification={VolumeType=gp2,SizeInGB=100}},{VolumeSpecification={VolumeType=io1,SizeInGB=100,Iops=100},VolumesPerInstance=4}]}' \ --auto-terminate ``` Im folgenden Beispiel wird ein Cluster mit mehreren EBS-Volumes erstellt, die mit EC2-Instances in der Master-Instance-Gruppe verbunden sind. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --use-default-roles \ --instance-groups 'InstanceGroupType=MASTER, InstanceCount=1, InstanceType=d2.xlarge, EbsConfiguration={EbsOptimized=true, EbsBlockDeviceConfigs=[{VolumeSpecification={VolumeType=io1, SizeInGB=100, Iops=100}},{VolumeSpecification={VolumeType=standard,SizeInGB=50},VolumesPerInstance=3}]}' InstanceGroupType=CORE,InstanceCount=2,InstanceType=d2.xlarge \ --auto-terminate ``` **Beispiel 16: So erstellen Sie einen Cluster mit einer Auto-Scaling-Richtlinie** Mit Amazon EMR Version 4.0 und höher können Sie Core- und Aufgaben-Instance-Gruppen Auto-Scaling-Richtlinien zuweisen. Die automatische Skalierungsrichtlinie fügt EC2-Instances als Reaktion auf eine CloudWatch Amazon-Metrik dynamisch hinzu und entfernt sie. *Weitere Informationen finden Sie unter Using Automatic Scaling in Amazon EMR < https://docs.aws.amazon.com/emr/ latest/ManagementGuide/emr -automatic-scaling.html>`\$1 im Amazon EMR Management Guide.* Wenn Sie eine Richtlinie für Auto Scaling anfügen, müssen Sie auch mittels `--auto-scaling-role EMR_AutoScaling_DefaultRole` die Standardrolle für die automatische Skalierung angeben. Im folgenden Beispiel für `create-cluster` wird die Auto-Scaling-Richtlinie für die `CORE`-Instance-Gruppe festgelegt. Dazu wird das Argument `AutoScalingPolicy` mit einer eingebetteten JSON-Struktur verwendet, das die Konfiguration der Skalierungsrichtlinie spezifiziert. Bei Instance-Gruppen mit einer eingebetteten JSON-Struktur muss die gesamte Sammlung von Argumenten in einfache Anführungszeichen eingeschlossen sein. Die Verwendung von einfachen Anführungszeichen ist für Instance-Gruppen ohne eingebettete JSON-Struktur optional. ``` aws emr create-cluster --release-label emr-5.9.0 \ --use-default-roles --auto-scaling-role EMR_AutoScaling_DefaultRole \ --instance-groups InstanceGroupType=MASTER,InstanceType=d2.xlarge,InstanceCount=1 'InstanceGroupType=CORE,InstanceType=d2.xlarge,InstanceCount=2,AutoScalingPolicy={Constraints={MinCapacity=1,MaxCapacity=5},Rules=[{Name=TestRule,Description=TestDescription,Action={Market=ON_DEMAND,SimpleScalingPolicyConfiguration={AdjustmentType=EXACT_CAPACITY,ScalingAdjustment=2}},Trigger={CloudWatchAlarmDefinition={ComparisonOperator=GREATER_THAN,EvaluationPeriods=5,MetricName=TestMetric,Namespace=EMR,Period=3,Statistic=MAXIMUM,Threshold=4.5,Unit=NONE,Dimensions=[{Key=TestKey,Value=TestValue}]}}}]}' ``` Im folgenden Beispiel wird die JSON-Datei `instancegroupconfig.json` verwendet, um die Konfiguration aller Instance-Gruppen in einem Cluster anzugeben. Die JSON-Datei gibt die Konfiguration der Auto-Scaling-Richtlinie für die Core-Instance-Gruppe an. ``` aws emr create-cluster \ --release-label emr-5.9.0 \ --service-role EMR_DefaultRole \ --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ --instance-groups file://myfolder/instancegroupconfig.json \ --auto-scaling-role EMR_AutoScaling_DefaultRole ``` Inhalt von `instancegroupconfig.json`: ``` [ { "InstanceCount": 1, "Name": "MyMasterIG", "InstanceGroupType": "MASTER", "InstanceType": "m4.large" }, { "InstanceCount": 2, "Name": "MyCoreIG", "InstanceGroupType": "CORE", "InstanceType": "m4.large", "AutoScalingPolicy": { "Constraints": { "MinCapacity": 2, "MaxCapacity": 10 }, "Rules": [ { "Name": "Default-scale-out", "Description": "Replicates the default scale-out rule in the console for YARN memory.", "Action": { "SimpleScalingPolicyConfiguration": { "AdjustmentType": "CHANGE_IN_CAPACITY", "ScalingAdjustment": 1, "CoolDown": 300 } }, "Trigger": { "CloudWatchAlarmDefinition": { "ComparisonOperator": "LESS_THAN", "EvaluationPeriods": 1, "MetricName": "YARNMemoryAvailablePercentage", "Namespace": "AWS/ElasticMapReduce", "Period": 300, "Threshold": 15, "Statistic": "AVERAGE", "Unit": "PERCENT", "Dimensions": [ { "Key": "JobFlowId", "Value": "${emr.clusterId}" } ] } } } ] } } ] ``` **Beispiel 17: So fügen Sie beim Erstellen eines Clusters benutzerdefinierte JAR-Schritte hinzu** Im folgenden Beispiel für `create-cluster` werden Schritte hinzugefügt, indem eine in Amazon S3 gespeicherte JAR-Datei angegeben wird. Mit Schritten wird Arbeit an einen Cluster übermittelt. Die in der JAR-Datei definierte Hauptfunktion wird ausgeführt, nachdem EC2-Instances bereitgestellt, alle Bootstrap-Aktionen ausgeführt und Anwendungen installiert wurden. Die Schritte werden mithilfe von `Type=CUSTOM_JAR` angegeben. Für benutzerdefinierte JAR-Schritte ist der Parameter `Jar=` erforderlich, der den Pfad und den Dateinamen der JAR angibt. Optionale Parameter sind `Type`, `Name`, `ActionOnFailure`, `Args` und `MainClass`. Wenn keine Hauptklasse angegeben ist, sollte die JAR-Datei `Main-Class` in ihrer Manifestdatei angeben. ``` aws emr create-cluster \ --steps Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://amzn-s3-demo-bucket/mytest.jar,Args=arg1,arg2,arg3 Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://amzn-s3-demo-bucket/mytest.jar,MainClass=mymainclass,Args=arg1,arg2,arg3 \ --release-label emr-5.3.1 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` **Beispiel 18: So fügen Sie beim Erstellen eines Clusters Streaming-Schritte hinzu** In den folgenden Beispielen für `create-cluster` wird einem Cluster ein Streaming-Schritt hinzugefügt, der beendet wird, nachdem alle Schritte ausgeführt wurden. Für Streaming-Schritte sind die Parameter `Type` und `Args` erforderlich. Optionale Parameter für Streaming-Schritte sind `Name` und `ActionOnFailure`. Im folgenden Beispiel wird der Schritt inline angegeben. ``` aws emr create-cluster \ --steps Type=STREAMING,Name='Streaming Program',ActionOnFailure=CONTINUE,Args=[-files,s3://elasticmapreduce/samples/wordcount/wordSplitter.py,-mapper,wordSplitter.py,-reducer,aggregate,-input,s3://elasticmapreduce/samples/wordcount/input,-output,s3://amzn-s3-demo-bucket/wordcount/output] \ --release-label emr-5.3.1 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` Im folgenden Beispiel wird eine lokal gespeicherte JSON-Konfigurationsdatei namens `multiplefiles.json` verwendet. Die JSON-Konfiguration gibt mehrere Dateien an. Um mehrere Dateien in einem Schritt anzugeben, müssen Sie eine JSON-Konfigurationsdatei verwenden, um den Schritt anzugeben. JSON-Argumente müssen Optionen und Werte als eigene Elemente in der Liste enthalten. ``` aws emr create-cluster \ --steps file://./multiplefiles.json \ --release-label emr-5.9.0 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` Inhalt von `multiplefiles.json`: ``` [ { "Name": "JSON Streaming Step", "Args": [ "-files", "s3://elasticmapreduce/samples/wordcount/wordSplitter.py", "-mapper", "wordSplitter.py", "-reducer", "aggregate", "-input", "s3://elasticmapreduce/samples/wordcount/input", "-output", "s3://amzn-s3-demo-bucket/wordcount/output" ], "ActionOnFailure": "CONTINUE", "Type": "STREAMING" } ] ``` **Beispiel 19: So fügen Sie beim Erstellen eines Clusters Hive-Schritte hinzu** Im folgenden Beispiel werden beim Erstellen eines Clusters Hive-Schritte hinzugefügt. Für Hive-Schritte sind die Parameter `Type` und `Args` erforderlich. Optionale Parameter für Hive-Schritte sind `Name` und `ActionOnFailure`. ``` aws emr create-cluster \ --steps Type=HIVE,Name='Hive program',ActionOnFailure=CONTINUE,ActionOnFailure=TERMINATE_CLUSTER,Args=[-f,s3://elasticmapreduce/samples/hive-ads/libs/model-build.q,-d,INPUT=s3://elasticmapreduce/samples/hive-ads/tables,-d,OUTPUT=s3://amzn-s3-demo-bucket/hive-ads/output/2014-04-18/11-07-32,-d,LIBS=s3://elasticmapreduce/samples/hive-ads/libs] \ --applications Name=Hive \ --release-label emr-5.3.1 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` **Beispiel 20: So fügen Sie beim Erstellen eines Clusters Pig-Schritte hinzu** Im folgenden Beispiel werden beim Erstellen eines Clusters Pig-Schritte hinzugefügt. Für Pig-Schritte sind die Parameter `Type` und `Args` erforderlich. Optionale Parameter für Pig-Schritte sind `Name` und `ActionOnFailure`. ``` aws emr create-cluster \ --steps Type=PIG,Name='Pig program',ActionOnFailure=CONTINUE,Args=[-f,s3://elasticmapreduce/samples/pig-apache/do-reports2.pig,-p,INPUT=s3://elasticmapreduce/samples/pig-apache/input,-p,OUTPUT=s3://amzn-s3-demo-bucket/pig-apache/output] \ --applications Name=Pig \ --release-label emr-5.3.1 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` **Beispiel 21: So fügen Sie Bootstrap-Aktionen hinzu** Im folgenden Beispiel für `create-cluster` werden zwei Bootstrap-Aktionen ausgeführt, die als Scripts definiert sind und in Amazon S3 gespeichert sind. ``` aws emr create-cluster \ --bootstrap-actions Path=s3://amzn-s3-demo-bucket/myscript1,Name=BootstrapAction1,Args=[arg1,arg2] Path=s3://amzn-s3-demo-bucket/myscript2,Name=BootstrapAction2,Args=[arg1,arg2] \ --release-label emr-5.3.1 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ --auto-terminate ``` **Beispiel 22: So aktivieren Sie die konsistente Ansicht von EMRFS und passen Sie die Einstellungen an RetryCount RetryPeriod ** Im folgenden Beispiel für `create-cluster` werden die Anzahl der Wiederholungen und der Wiederholungszeitraum für die konsistente Ansicht in EMRFS angegeben. Das Argument `Consistent=true` ist erforderlich. ``` aws emr create-cluster \ --instance-type m4.large \ --release-label emr-5.9.0 \ --emrfs Consistent=true,RetryCount=6,RetryPeriod=30 ``` Im folgenden Beispiel wird dieselbe EMRFS-Konfiguration wie im vorherigen Beispiel angegeben, wobei eine lokal gespeicherte JSON-Konfigurationsdatei namens `emrfsconfig.json` verwendet wird. ``` aws emr create-cluster \ --instance-type m4.large \ --release-label emr-5.9.0 \ --emrfs file://emrfsconfig.json ``` Inhalt von `emrfsconfig.json`: ``` { "Consistent": true, "RetryCount": 6, "RetryPeriod": 30 } ``` **Beispiel 23: So erstellen Sie einen Cluster mit konfiguriertem Kerberos** In den folgenden Beispielen für `create-cluster` wird ein Cluster mithilfe einer Sicherheitskonfiguration mit aktiviertem Kerberos erstellt. Gleichzeitig werden mithilfe von `--kerberos-attributes` Kerberos-Parameter für den Cluster festgelegt. Mit dem folgenden Befehl werden Kerberos-Attribute für den Cluster angegeben. ``` aws emr create-cluster \ --instance-type m3.xlarge \ --release-label emr-5.10.0 \ --service-role EMR_DefaultRole \ --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ --security-configuration mySecurityConfiguration \ --kerberos-attributes Realm=EC2.INTERNAL,KdcAdminPassword=123,CrossRealmTrustPrincipalPassword=123 ``` Mit dem folgenden Befehl werden dieselben Attribute angegeben, er verweist jedoch auf eine lokal gespeicherte JSON-Datei mit dem Namen `kerberos_attributes.json`. In diesem Beispiel ist die Datei im selben Verzeichnis gespeichert, in dem der Befehl ausgeführt wird. Sie können auch eine in Amazon S3 gespeicherte Konfigurationsdatei referenzieren. ``` aws emr create-cluster \ --instance-type m3.xlarge \ --release-label emr-5.10.0 \ --service-role EMR_DefaultRole \ --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ --security-configuration mySecurityConfiguration \ --kerberos-attributes file://kerberos_attributes.json ``` Inhalt von `kerberos_attributes.json`: ``` { "Realm": "EC2.INTERNAL", "KdcAdminPassword": "123", "CrossRealmTrustPrincipalPassword": "123", } ``` Im folgenden Beispiel für `create-cluster` wird ein Amazon-EMR-Cluster erstellt, der die Konfiguration `--instance-groups` verwendet und eine verwaltete Skalierungsrichtlinie hat. ``` aws emr create-cluster \ --release-label emr-5.30.0 \ --service-role EMR_DefaultRole \ --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --managed-scaling-policy ComputeLimits='{MinimumCapacityUnits=2,MaximumCapacityUnits=4,UnitType=Instances}' ``` Im folgenden `create-cluster` Beispiel wird ein Amazon EMR-Cluster erstellt, der die „-- log-encryption-kms-key -ID“ verwendet, um die für die Protokollverschlüsselung verwendete KMS-Schlüssel-ID zu definieren. ``` aws emr create-cluster \ --release-label emr-5.30.0 \ --log-uri s3://amzn-s3-demo-bucket/myLog \ --log-encryption-kms-key-id arn:aws:kms:us-east-1:110302272565:key/dd559181-283e-45d7-99d1-66da348c4d33 \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large ``` Im folgenden `create-cluster` Beispiel wird ein Amazon EMR-Cluster erstellt, der die Konfiguration „--placement-group-configs“ verwendet, um Master-Knoten mithilfe `SPREAD` der Platzierungsstrategie in einem Hochverfügbarkeits-Cluster (HA) innerhalb einer EC2-Platzierungsgruppe zu platzieren. ``` aws emr create-cluster \ --release-label emr-5.30.0 \ --service-role EMR_DefaultRole \ --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ --instance-groups InstanceGroupType=MASTER,InstanceCount=3,InstanceType=m4.largeInstanceGroupType=CORE,InstanceCount=1,InstanceType=m4.large \ --placement-group-configs InstanceRole=MASTER ``` Im folgenden `create-cluster` Beispiel wird ein Amazon EMR-Cluster erstellt, der die Konfiguration „--auto-termination-policy“ verwendet, um einen Schwellenwert für die automatische Beendigung des Leerlaufs für den Cluster festzulegen. ``` aws emr create-cluster \ --release-label emr-5.34.0 \ --service-role EMR_DefaultRole \ --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=1,InstanceType=m4.large \ --auto-termination-policy IdleTimeout=100 ``` Im folgenden `create-cluster` Beispiel wird ein Amazon EMR-Cluster erstellt, der „--os-release-label“ verwendet, um eine Amazon Linux-Version für den Clusterstart zu definieren ``` aws emr create-cluster \ --release-label emr-6.6.0 \ --os-release-label 2.0.20220406.1 \ --service-role EMR_DefaultRole \ --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=1,InstanceType=m4.large ``` **Beispiel 24: So geben Sie die Attribute eines EBS-Stamm-Volumes an: Größe, IOPS und Durchsatz für Cluster-Instances, die mit EMR-Versionen 6.15.0 und höher erstellt wurden** Im folgenden Beispiel für `create-cluster` wird ein Amazon-EMR-Cluster erstellt, der Stamm-Volume-Attribute verwendet, um Stamm-Volume-Spezifikationen für die EC2-Instances zu konfigurieren. ``` aws emr create-cluster \ --name "Cluster with My Custom AMI" \ --custom-ami-id ami-a518e6df \ --ebs-root-volume-size 20 \ --ebs-root-volume-iops 3000 \ --ebs-root-volume-throughput 125 \ --release-label emr-6.15.0 \ --use-default-roles \ --instance-count 2 \ --instance-type m4.large ``` + Einzelheiten zur API finden Sie [CreateClusterExamples](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/create-cluster-examples.html)in der *AWS CLI Befehlsreferenz.* ### `create-default-roles` Das folgende Codebeispiel zeigt die Verwendung`create-default-roles`. **AWS CLI** **1. So erstellen Sie die Standard-IAM-Rolle für EC2** Befehl: ``` aws emr create-default-roles ``` Ausgabe: ``` If the role already exists then the command returns nothing. If the role does not exist then the output will be: [ { "RolePolicy": { "Version":"2012-10-17", "Statement": [ { "Action": [ "cloudwatch:*", "dynamodb:*", "ec2:Describe*", "elasticmapreduce:Describe*", "elasticmapreduce:ListBootstrapActions", "elasticmapreduce:ListClusters", "elasticmapreduce:ListInstanceGroups", "elasticmapreduce:ListInstances", "elasticmapreduce:ListSteps", "kinesis:CreateStream", "kinesis:DeleteStream", "kinesis:DescribeStream", "kinesis:GetRecords", "kinesis:GetShardIterator", "kinesis:MergeShards", "kinesis:PutRecord", "kinesis:SplitShard", "rds:Describe*", "s3:*", "sdb:*", "sns:*", "sqs:*" ], "Resource": "*", "Effect": "Allow" } ] }, "Role": { "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Action": "sts:AssumeRole", "Sid": "", "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" } } ] }, "RoleId": "AROAIQ5SIQUGL5KMYBJX6", "CreateDate": "2015-06-09T17:09:04.602Z", "RoleName": "EMR_EC2_DefaultRole", "Path": "/", "Arn": "arn:aws:iam::176430881729:role/EMR_EC2_DefaultRole" } }, { "RolePolicy": { "Version":"2012-10-17", "Statement": [ { "Action": [ "ec2:AuthorizeSecurityGroupIngress", "ec2:CancelSpotInstanceRequests", "ec2:CreateSecurityGroup", "ec2:CreateTags", "ec2:DeleteTags", "ec2:DescribeAvailabilityZones", "ec2:DescribeAccountAttributes", "ec2:DescribeInstances", "ec2:DescribeInstanceStatus", "ec2:DescribeKeyPairs", "ec2:DescribePrefixLists", "ec2:DescribeRouteTables", "ec2:DescribeSecurityGroups", "ec2:DescribeSpotInstanceRequests", "ec2:DescribeSpotPriceHistory", "ec2:DescribeSubnets", "ec2:DescribeVpcAttribute", "ec2:DescribeVpcEndpoints", "ec2:DescribeVpcEndpointServices", "ec2:DescribeVpcs", "ec2:ModifyImageAttribute", "ec2:ModifyInstanceAttribute", "ec2:RequestSpotInstances", "ec2:RunInstances", "ec2:TerminateInstances", "iam:GetRole", "iam:GetRolePolicy", "iam:ListInstanceProfiles", "iam:ListRolePolicies", "iam:PassRole", "s3:CreateBucket", "s3:Get*", "s3:List*", "sdb:BatchPutAttributes", "sdb:Select", "sqs:CreateQueue", "sqs:Delete*", "sqs:GetQueue*", "sqs:ReceiveMessage" ], "Resource": "*", "Effect": "Allow" } ] }, "Role": { "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Action": "sts:AssumeRole", "Sid": "", "Effect": "Allow", "Principal": { "Service": "elasticmapreduce.amazonaws.com" } } ] }, "RoleId": "AROAI3SRVPPVSRDLARBPY", "CreateDate": "2015-06-09T17:09:10.401Z", "RoleName": "EMR_DefaultRole", "Path": "/", "Arn": "arn:aws:iam::176430881729:role/EMR_DefaultRole" } } ] ``` + Einzelheiten zur API finden Sie [CreateDefaultRoles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/create-default-roles.html)in der *AWS CLI Befehlsreferenz*. ### `create-security-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-security-configuration`. **AWS CLI** **1. Um eine Sicherheitskonfiguration zu erstellen, bei der die Verschlüsselung während der Übertragung mit PEM für den Zertifikatsanbieter und die Verschlüsselung im Ruhezustand mit SSE-S3 für S3-Verschlüsselung und AWS-KMS für den lokalen Festplattenschlüsselanbieter aktiviert ist** Befehl: ``` aws emr create-security-configuration --name MySecurityConfig --security-configuration '{ "EncryptionConfiguration": { "EnableInTransitEncryption" : true, "EnableAtRestEncryption" : true, "InTransitEncryptionConfiguration" : { "TLSCertificateConfiguration" : { "CertificateProviderType" : "PEM", "S3Object" : "s3://mycertstore/artifacts/MyCerts.zip" } }, "AtRestEncryptionConfiguration" : { "S3EncryptionConfiguration" : { "EncryptionMode" : "SSE-S3" }, "LocalDiskEncryptionConfiguration" : { "EncryptionKeyProviderType" : "AwsKms", "AwsKmsKey" : "arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012" } } } }' ``` Ausgabe: ``` { "CreationDateTime": 1474070889.129, "Name": "MySecurityConfig" } ``` JSON-Äquivalent (Inhalt von security\$1configuration.json): ``` { "EncryptionConfiguration": { "EnableInTransitEncryption": true, "EnableAtRestEncryption": true, "InTransitEncryptionConfiguration": { "TLSCertificateConfiguration": { "CertificateProviderType": "PEM", "S3Object": "s3://mycertstore/artifacts/MyCerts.zip" } }, "AtRestEncryptionConfiguration": { "S3EncryptionConfiguration": { "EncryptionMode": "SSE-S3" }, "LocalDiskEncryptionConfiguration": { "EncryptionKeyProviderType": "AwsKms", "AwsKmsKey": "arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012" } } } } ``` Befehl (mit security\$1configuration.json): ``` aws emr create-security-configuration --name "MySecurityConfig" --security-configuration file://./security_configuration.json ``` Ausgabe: ``` { "CreationDateTime": 1474070889.129, "Name": "MySecurityConfig" } ``` **2. So erstellen Sie eine Sicherheitskonfiguration mit aktiviertem Kerberos unter Verwendung von Cluster-spezifischem KDC und bereichsübergreifenden Vertrauensbeziehungen** Befehl: ``` aws emr create-security-configuration --name MySecurityConfig --security-configuration '{ "AuthenticationConfiguration": { "KerberosConfiguration": { "Provider": "ClusterDedicatedKdc", "ClusterDedicatedKdcConfiguration": { "TicketLifetimeInHours": 24, "CrossRealmTrustConfiguration": { "Realm": "AD.DOMAIN.COM", "Domain": "ad.domain.com", "AdminServer": "ad.domain.com", "KdcServer": "ad.domain.com" } } } } }' ``` Ausgabe: ``` { "CreationDateTime": 1490225558.982, "Name": "MySecurityConfig" } ``` JSON-Äquivalent (Inhalt von security\$1configuration.json): ``` { "AuthenticationConfiguration": { "KerberosConfiguration": { "Provider": "ClusterDedicatedKdc", "ClusterDedicatedKdcConfiguration": { "TicketLifetimeInHours": 24, "CrossRealmTrustConfiguration": { "Realm": "AD.DOMAIN.COM", "Domain": "ad.domain.com", "AdminServer": "ad.domain.com", "KdcServer": "ad.domain.com" } } } } } ``` Befehl (mit security\$1configuration.json): ``` aws emr create-security-configuration --name "MySecurityConfig" --security-configuration file://./security_configuration.json ``` Ausgabe: ``` { "CreationDateTime": 1490225558.982, "Name": "MySecurityConfig" } ``` + Einzelheiten zur API finden Sie [CreateSecurityConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/create-security-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-security-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-security-configuration`. **AWS CLI** **So löschen Sie eine Sicherheitskonfiguration in der aktuellen Region** Befehl: ``` aws emr delete-security-configuration --name MySecurityConfig ``` Ausgabe: ``` None ``` + Einzelheiten zur API finden Sie [DeleteSecurityConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/delete-security-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cluster` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster`. **AWS CLI** Befehl: ``` aws emr describe-cluster --cluster-id j-XXXXXXXX ``` Ausgabe: ``` For release-label based uniform instance groups cluster: { "Cluster": { "Status": { "Timeline": { "ReadyDateTime": 1436475075.199, "CreationDateTime": 1436474656.563, }, "State": "WAITING", "StateChangeReason": { "Message": "Waiting for steps to run" } }, "Ec2InstanceAttributes": { "ServiceAccessSecurityGroup": "sg-xxxxxxxx", "EmrManagedMasterSecurityGroup": "sg-xxxxxxxx", "IamInstanceProfile": "EMR_EC2_DefaultRole", "Ec2KeyName": "myKey", "Ec2AvailabilityZone": "us-east-1c", "EmrManagedSlaveSecurityGroup": "sg-yyyyyyyyy" }, "Name": "My Cluster", "ServiceRole": "EMR_DefaultRole", "Tags": [], "TerminationProtected": true, "UnhealthyNodeReplacement": true, "ReleaseLabel": "emr-4.0.0", "NormalizedInstanceHours": 96, "InstanceGroups": [ { "RequestedInstanceCount": 2, "Status": { "Timeline": { "ReadyDateTime": 1436475074.245, "CreationDateTime": 1436474656.564, "EndDateTime": 1436638158.387 }, "State": "RUNNING", "StateChangeReason": { "Message": "", } }, "Name": "CORE", "InstanceGroupType": "CORE", "Id": "ig-YYYYYYY", "Configurations": [], "InstanceType": "m3.large", "Market": "ON_DEMAND", "RunningInstanceCount": 2 }, { "RequestedInstanceCount": 1, "Status": { "Timeline": { "ReadyDateTime": 1436475074.245, "CreationDateTime": 1436474656.564, "EndDateTime": 1436638158.387 }, "State": "RUNNING", "StateChangeReason": { "Message": "", } }, "Name": "MASTER", "InstanceGroupType": "MASTER", "Id": "ig-XXXXXXXXX", "Configurations": [], "InstanceType": "m3.large", "Market": "ON_DEMAND", "RunningInstanceCount": 1 } ], "Applications": [ { "Name": "Hadoop" } ], "VisibleToAllUsers": true, "BootstrapActions": [], "MasterPublicDnsName": "ec2-54-147-144-78.compute-1.amazonaws.com", "AutoTerminate": false, "Id": "j-XXXXXXXX", "Configurations": [ { "Properties": { "fs.s3.consistent.retryPeriodSeconds": "20", "fs.s3.enableServerSideEncryption": "true", "fs.s3.consistent": "false", "fs.s3.consistent.retryCount": "2" }, "Classification": "emrfs-site" } ] } } For release-label based instance fleet cluster: { "Cluster": { "Status": { "Timeline": { "ReadyDateTime": 1487897289.705, "CreationDateTime": 1487896933.942 }, "State": "WAITING", "StateChangeReason": { "Message": "Waiting for steps to run" } }, "Ec2InstanceAttributes": { "EmrManagedMasterSecurityGroup": "sg-xxxxx", "RequestedEc2AvailabilityZones": [], "RequestedEc2SubnetIds": [], "IamInstanceProfile": "EMR_EC2_DefaultRole", "Ec2AvailabilityZone": "us-east-1a", "EmrManagedSlaveSecurityGroup": "sg-xxxxx" }, "Name": "My Cluster", "ServiceRole": "EMR_DefaultRole", "Tags": [], "TerminationProtected": false, "UnhealthyNodeReplacement": false, "ReleaseLabel": "emr-5.2.0", "NormalizedInstanceHours": 472, "InstanceCollectionType": "INSTANCE_FLEET", "InstanceFleets": [ { "Status": { "Timeline": { "ReadyDateTime": 1487897212.74, "CreationDateTime": 1487896933.948 }, "State": "RUNNING", "StateChangeReason": { "Message": "" } }, "ProvisionedSpotCapacity": 1, "Name": "MASTER", "InstanceFleetType": "MASTER", "LaunchSpecifications": { "SpotSpecification": { "TimeoutDurationMinutes": 60, "TimeoutAction": "TERMINATE_CLUSTER" } }, "TargetSpotCapacity": 1, "ProvisionedOnDemandCapacity": 0, "InstanceTypeSpecifications": [ { "BidPrice": "0.5", "InstanceType": "m3.xlarge", "WeightedCapacity": 1 } ], "Id": "if-xxxxxxx", "TargetOnDemandCapacity": 0 } ], "Applications": [ { "Version": "2.7.3", "Name": "Hadoop" } ], "ScaleDownBehavior": "TERMINATE_AT_INSTANCE_HOUR", "VisibleToAllUsers": true, "BootstrapActions": [], "MasterPublicDnsName": "ec2-xxx-xx-xxx-xx.compute-1.amazonaws.com", "AutoTerminate": false, "Id": "j-xxxxx", "Configurations": [] } } For ami based uniform instance group cluster: { "Cluster": { "Status": { "Timeline": { "ReadyDateTime": 1399400564.432, "CreationDateTime": 1399400268.62 }, "State": "WAITING", "StateChangeReason": { "Message": "Waiting for steps to run" } }, "Ec2InstanceAttributes": { "IamInstanceProfile": "EMR_EC2_DefaultRole", "Ec2AvailabilityZone": "us-east-1c" }, "Name": "My Cluster", "Tags": [], "TerminationProtected": true, "UnhealthyNodeReplacement": true, "RunningAmiVersion": "2.5.4", "InstanceGroups": [ { "RequestedInstanceCount": 1, "Status": { "Timeline": { "ReadyDateTime": 1399400558.848, "CreationDateTime": 1399400268.621 }, "State": "RUNNING", "StateChangeReason": { "Message": "" } }, "Name": "Master instance group", "InstanceGroupType": "MASTER", "InstanceType": "m1.small", "Id": "ig-ABCD", "Market": "ON_DEMAND", "RunningInstanceCount": 1 }, { "RequestedInstanceCount": 2, "Status": { "Timeline": { "ReadyDateTime": 1399400564.439, "CreationDateTime": 1399400268.621 }, "State": "RUNNING", "StateChangeReason": { "Message": "" } }, "Name": "Core instance group", "InstanceGroupType": "CORE", "InstanceType": "m1.small", "Id": "ig-DEF", "Market": "ON_DEMAND", "RunningInstanceCount": 2 } ], "Applications": [ { "Version": "1.0.3", "Name": "hadoop" } ], "BootstrapActions": [], "VisibleToAllUsers": false, "RequestedAmiVersion": "2.4.2", "LogUri": "s3://myLogUri/", "AutoTerminate": false, "Id": "j-XXXXXXXX" } } ``` + Einzelheiten zur API finden Sie [DescribeCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/describe-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `describe-step` Das folgende Codebeispiel zeigt die Verwendung`describe-step`. **AWS CLI** Mit dem folgenden Befehl wird ein Schritt mit der Schritt-ID `s-3LZC0QUT43AM` in einem Cluster mit der Cluster-ID `j-3SD91U2E1L2QX` beschrieben: ``` aws emr describe-step --cluster-id j-3SD91U2E1L2QX --step-id s-3LZC0QUT43AM ``` Ausgabe: ``` { "Step": { "Status": { "Timeline": { "EndDateTime": 1433200470.481, "CreationDateTime": 1433199926.597, "StartDateTime": 1433200404.959 }, "State": "COMPLETED", "StateChangeReason": {} }, "Config": { "Args": [ "s3://us-west-2.elasticmapreduce/libs/hive/hive-script", "--base-path", "s3://us-west-2.elasticmapreduce/libs/hive/", "--install-hive", "--hive-versions", "0.13.1" ], "Jar": "s3://us-west-2.elasticmapreduce/libs/script-runner/script-runner.jar", "Properties": {} }, "Id": "s-3LZC0QUT43AM", "ActionOnFailure": "TERMINATE_CLUSTER", "Name": "Setup hive" } } ``` + Einzelheiten zur API finden Sie [DescribeStep](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/describe-step.html)in der *AWS CLI Befehlsreferenz*. ### `get` Das folgende Codebeispiel zeigt die Verwendung`get`. **AWS CLI** Im folgenden Beispiel wird das Archiv `hadoop-examples.jar` von der Master-Instance in einem Cluster mit der Cluster-ID `j-3SD91U2E1L2QX` heruntergeladen: ``` aws emr get --cluster-id j-3SD91U2E1L2QX --key-pair-file ~/.ssh/mykey.pem --src /home/hadoop-examples.jar --dest ~ ``` + Weitere API-Informationen finden Sie unter [Get](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/get.html) in der *AWS CLI -Befehlsreferenz*. ### `list-clusters` Das folgende Codebeispiel zeigt die Verwendung`list-clusters`. **AWS CLI** Mit dem folgenden Befehl werden alle aktiven EMR-Cluster in der aktuellen Region aufgelistet: ``` aws emr list-clusters --active ``` Ausgabe: ``` { "Clusters": [ { "Status": { "Timeline": { "ReadyDateTime": 1433200405.353, "CreationDateTime": 1433199926.596 }, "State": "WAITING", "StateChangeReason": { "Message": "Waiting after step completed" } }, "NormalizedInstanceHours": 6, "Id": "j-3SD91U2E1L2QX", "Name": "my-cluster" } ] } ``` + Einzelheiten zur API finden Sie [ListClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/list-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `list-instance-fleets` Das folgende Codebeispiel zeigt die Verwendung`list-instance-fleets`. **AWS CLI** **So rufen Sie Konfigurationsdetails der Instance-Flotten in einem Cluster ab** In diesem Beispiel werden die Details der Instance-Flotten im angegebenen Cluster aufgelistet. Befehl: ``` list-instance-fleets --cluster-id 'j-12ABCDEFGHI34JK' ``` Ausgabe: ``` { "InstanceFleets": [ { "Status": { "Timeline": { "ReadyDateTime": 1488759094.637, "CreationDateTime": 1488758719.817 }, "State": "RUNNING", "StateChangeReason": { "Message": "" } }, "ProvisionedSpotCapacity": 6, "Name": "CORE", "InstanceFleetType": "CORE", "LaunchSpecifications": { "SpotSpecification": { "TimeoutDurationMinutes": 60, "TimeoutAction": "TERMINATE_CLUSTER" } }, "ProvisionedOnDemandCapacity": 2, "InstanceTypeSpecifications": [ { "BidPrice": "0.5", "InstanceType": "m3.xlarge", "WeightedCapacity": 2 } ], "Id": "if-1ABC2DEFGHIJ3" }, { "Status": { "Timeline": { "ReadyDateTime": 1488759058.598, "CreationDateTime": 1488758719.811 }, "State": "RUNNING", "StateChangeReason": { "Message": "" } }, "ProvisionedSpotCapacity": 0, "Name": "MASTER", "InstanceFleetType": "MASTER", "ProvisionedOnDemandCapacity": 1, "InstanceTypeSpecifications": [ { "BidPriceAsPercentageOfOnDemandPrice": 100.0, "InstanceType": "m3.xlarge", "WeightedCapacity": 1 } ], "Id": "if-2ABC4DEFGHIJ4" } ] } ``` + Einzelheiten zur API finden Sie [ListInstanceFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/list-instance-fleets.html)in der *AWS CLI Befehlsreferenz*. ### `list-instances` Das folgende Codebeispiel zeigt die Verwendung`list-instances`. **AWS CLI** Mit dem folgenden Befehl werden alle Instances in einem Cluster mit der Cluster-ID `j-3C6XNQ39VR9WL` aufgelistet: ``` aws emr list-instances --cluster-id j-3C6XNQ39VR9WL ``` Ausgabe: ``` For a uniform instance group based cluster { "Instances": [ { "Status": { "Timeline": { "ReadyDateTime": 1433200400.03, "CreationDateTime": 1433199960.152 }, "State": "RUNNING", "StateChangeReason": {} }, "Ec2InstanceId": "i-f19ecfee", "PublicDnsName": "ec2-52-52-41-150.us-west-2.compute.amazonaws.com", "PrivateDnsName": "ip-172-21-11-216.us-west-2.compute.internal", "PublicIpAddress": "52.52.41.150", "Id": "ci-3NNHQUQ2TWB6Y", "PrivateIpAddress": "172.21.11.216" }, { "Status": { "Timeline": { "ReadyDateTime": 1433200400.031, "CreationDateTime": 1433199949.102 }, "State": "RUNNING", "StateChangeReason": {} }, "Ec2InstanceId": "i-1feee4c2", "PublicDnsName": "ec2-52-63-246-32.us-west-2.compute.amazonaws.com", "PrivateDnsName": "ip-172-31-24-130.us-west-2.compute.internal", "PublicIpAddress": "52.63.246.32", "Id": "ci-GAOCMKNKDCV7", "PrivateIpAddress": "172.21.11.215" }, { "Status": { "Timeline": { "ReadyDateTime": 1433200400.031, "CreationDateTime": 1433199949.102 }, "State": "RUNNING", "StateChangeReason": {} }, "Ec2InstanceId": "i-15cfeee3", "PublicDnsName": "ec2-52-25-246-63.us-west-2.compute.amazonaws.com", "PrivateDnsName": "ip-172-31-24-129.us-west-2.compute.internal", "PublicIpAddress": "52.25.246.63", "Id": "ci-2W3TDFFB47UAD", "PrivateIpAddress": "172.21.11.214" } ] } For a fleet based cluster: { "Instances": [ { "Status": { "Timeline": { "ReadyDateTime": 1487810810.878, "CreationDateTime": 1487810588.367, "EndDateTime": 1488022990.924 }, "State": "TERMINATED", "StateChangeReason": { "Message": "Instance was terminated." } }, "Ec2InstanceId": "i-xxxxx", "InstanceFleetId": "if-xxxxx", "EbsVolumes": [], "PublicDnsName": "ec2-xx-xxx-xxx-xxx.compute-1.amazonaws.com", "InstanceType": "m3.xlarge", "PrivateDnsName": "ip-xx-xx-xxx-xx.ec2.internal", "Market": "SPOT", "PublicIpAddress": "xx.xx.xxx.xxx", "Id": "ci-xxxxx", "PrivateIpAddress": "10.47.191.80" } ] } ``` + Einzelheiten zur API finden Sie [ListInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/list-instances.html)in der *AWS CLI Befehlsreferenz*. ### `list-security-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-security-configurations`. **AWS CLI** **So listen Sie Sicherheitskonfigurationen in der aktuellen Region auf** Befehl: ``` aws emr list-security-configurations ``` Ausgabe: ``` { "SecurityConfigurations": [ { "CreationDateTime": 1473889697.417, "Name": "MySecurityConfig-1" }, { "CreationDateTime": 1473889697.417, "Name": "MySecurityConfig-2" } ] } ``` + Einzelheiten zur API finden Sie [ListSecurityConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/list-security-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `list-steps` Das folgende Codebeispiel zeigt die Verwendung`list-steps`. **AWS CLI** Mit dem folgenden Befehl werden alle Schritte in einem Cluster mit der Cluster-ID `j-3SD91U2E1L2QX` aufgelistet: ``` aws emr list-steps --cluster-id j-3SD91U2E1L2QX ``` + Einzelheiten zur API finden Sie [ListSteps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/list-steps.html)in der *AWS CLI Befehlsreferenz*. ### `list-studios` Das folgende Codebeispiel zeigt die Verwendung`list-studios`. **AWS CLI** **Zur Liste der verfügbaren EMR Studios** Das folgende `list-studios` Beispiel listet die EMR Studios im AWS Konto auf. : ``` aws emr list-studios ``` Ausgabe: ``` { "Studios": [ { "StudioId": "es-XXXXXXX132E0X7R0W7GAS1MVB", "Name": "My_EMR_Studio", "Url": "https://es-XXXXXXX132E0X7R0W7GAS1MVB.emrstudio-prod.us-east-1.amazonaws.com", "AuthMode": "IAM", "CreationTime": 1761664173.624 } ] } ``` Weitere Informationen finden Sie unter [Überwachen, Aktualisieren und Löschen von Amazon EMR Studio-Ressourcen](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-studio-manage-studio.html) im *Amazon EMR Management Guide*. + Einzelheiten zur API finden Sie [ListStudios](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/list-studios.html)in der *AWS CLI Befehlsreferenz*. ### `modify-cluster-attributes` Das folgende Codebeispiel zeigt die Verwendung`modify-cluster-attributes`. **AWS CLI** Mit dem folgenden Befehl wird die Sichtbarkeit eines EMR-Clusters mit der ID `j-301CDNY0J5XM4` für alle Benutzer festgelegt: ``` aws emr modify-cluster-attributes --cluster-id j-301CDNY0J5XM4 --visible-to-all-users ``` + Einzelheiten zur API finden Sie [ModifyClusterAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/modify-cluster-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `modify-instance-fleet` Das folgende Codebeispiel zeigt die Verwendung`modify-instance-fleet`. **AWS CLI** **So ändern Sie die Zielkapazitäten einer Instance-Flotte** In diesem Beispiel werden die Zielkapazitäten On-Demand und Spot für die angegebene Instance-Flotte auf 1 geändert. Befehl: ``` aws emr modify-instance-fleet --cluster-id 'j-12ABCDEFGHI34JK' --instance-fleet InstanceFleetId='if-2ABC4DEFGHIJ4',TargetOnDemandCapacity=1,TargetSpotCapacity=1 ``` + Einzelheiten zur API finden Sie [ModifyInstanceFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/modify-instance-fleet.html)in der *AWS CLI Befehlsreferenz*. ### `put` Das folgende Codebeispiel zeigt die Verwendung`put`. **AWS CLI** Mit dem folgenden Befehl wird eine Datei namens `healthcheck.sh` in die Master-Instance in einem Cluster mit der Cluster-ID `j-3SD91U2E1L2QX` hochgeladen: ``` aws emr put --cluster-id j-3SD91U2E1L2QX --key-pair-file ~/.ssh/mykey.pem --src ~/scripts/healthcheck.sh --dest /home/hadoop/bin/healthcheck.sh ``` + Weitere API-Informationen finden Sie unter [Put](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/put.html) in der *AWS CLI -Befehlsreferenz*. ### `remove-tags` Das folgende Codebeispiel zeigt die Verwendung`remove-tags`. **AWS CLI** Mit dem folgenden Befehl wird ein Tag mit dem Schlüssel `prod` aus einem Cluster mit der Cluster-ID `j-3SD91U2E1L2QX` entfernt: ``` aws emr remove-tags --resource-id j-3SD91U2E1L2QX --tag-keys prod ``` + Einzelheiten zur API finden Sie [RemoveTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/remove-tags.html)in der *AWS CLI Befehlsreferenz*. ### `schedule-hbase-backup` Das folgende Codebeispiel zeigt die Verwendung`schedule-hbase-backup`. **AWS CLI** **Hinweis: Dieser Befehl kann nur mit HBase AMI-Versionen 2.x und 3.x verwendet werden** **1. Um ein vollständiges HBase Backup zu planen >>>>>>> 06ab6d6e13564b5733d75abaf3b599f93cf39a23** Befehl: ``` aws emr schedule-hbase-backup --cluster-id j-XXXXXXYY --type full --dir s3://amzn-s3-demo-bucket/backup --interval 10 --unit hours --start-time 2014-04-21T05:26:10Z --consistent ``` Ausgabe: ``` None ``` **2. Um ein inkrementelles Backup HBase zu planen** Befehl: ``` aws emr schedule-hbase-backup --cluster-id j-XXXXXXYY --type incremental --dir s3://amzn-s3-demo-bucket/backup --interval 30 --unit minutes --start-time 2014-04-21T05:26:10Z --consistent ``` Ausgabe: ``` None ``` + Einzelheiten zur API finden Sie [ScheduleHbaseBackup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/schedule-hbase-backup.html)in der *AWS CLI Befehlsreferenz.* ### `socks` Das folgende Codebeispiel zeigt die Verwendung`socks`. **AWS CLI** Mit dem folgenden Befehl wird eine SOCKS-Verbindung zur Master-Instance in einem Cluster mit der Cluster-ID `j-3SD91U2E1L2QX` geöffnet: ``` aws emr socks --cluster-id j-3SD91U2E1L2QX --key-pair-file ~/.ssh/mykey.pem ``` Bei der optionalen Schlüsselpaardatei wird ein lokaler Pfad zu einer privaten Schlüsseldatei verwendet. + Weitere API-Informationen finden Sie unter [Socks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/socks.html) in der *AWS CLI -Befehlsreferenz*. ### `ssh` Das folgende Codebeispiel zeigt die Verwendung`ssh`. **AWS CLI** Mit dem folgenden Befehl wird eine SSH-Verbindung zur Master-Instance in einem Cluster mit der Cluster-ID `j-3SD91U2E1L2QX` geöffnet: ``` aws emr ssh --cluster-id j-3SD91U2E1L2QX --key-pair-file ~/.ssh/mykey.pem ``` Bei der optionalen Schlüsselpaardatei wird ein lokaler Pfad zu einer privaten Schlüsseldatei verwendet. Ausgabe: ``` ssh -o StrictHostKeyChecking=no -o ServerAliveInterval=10 -i /home/local/user/.ssh/mykey.pem hadoop@ec2-52-52-41-150.us-west-2.compute.amazonaws.com Warning: Permanently added 'ec2-52-52-41-150.us-west-2.compute.amazonaws.com,52.52.41.150' (ECDSA) to the list of known hosts. Last login: Mon Jun 1 23:15:38 2015 __| __|_ ) _| ( / Amazon Linux AMI ___|\___|___| https://aws.amazon.com/amazon-linux-ami/2015.03-release-notes/ 26 package(s) needed for security, out of 39 available Run "sudo yum update" to apply all updates. -------------------------------------------------------------------------------- Welcome to Amazon Elastic MapReduce running Hadoop and Amazon Linux. Hadoop is installed in /home/hadoop. Log files are in /mnt/var/log/hadoop. Check /mnt/var/log/hadoop/steps for diagnosing step failures. The Hadoop UI can be accessed via the following commands: ResourceManager lynx http://ip-172-21-11-216:9026/ NameNode lynx http://ip-172-21-11-216:9101/ -------------------------------------------------------------------------------- [hadoop@ip-172-31-16-216 ~]$ ``` + API-Details finden Sie unter [Ssh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/ssh.html) in der *AWS CLI -Befehlsreferenz*. # Beispiele für Amazon EMR auf EKS mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon EMR auf EKS Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `update-role-trust-policy` Das folgende Codebeispiel zeigt, wie Sie`update-role-trust-policy`. **AWS CLI** **So aktualisieren Sie die Vertrauensrichtlinie einer IAM-Rolle, die mit Amazon EMR auf EKS verwendet werden soll** Dieser Beispielbefehl aktualisiert die Vertrauensrichtlinie einer Rolle namens **example\$1iam\$1role**, sodass sie in Amazon EMR in EKS mit dem Namespace **example\$1namespace** aus einem EKS-Cluster namens **example\$1cluster** verwendet werden kann. Befehl: ``` aws emr-containers update-role-trust-policy \ --cluster example_cluster \ --namespace example_namespace \ --role-name example_iam_role ``` Ausgabe: ``` If the trust policy has already been updated, then the output will be: Trust policy statement already exists for role example_iam_role. No changes were made! If the trust policy has not been updated yet, then the output will be: Successfully updated trust policy of role example_iam_role. ``` + Einzelheiten zur API finden Sie [UpdateRoleTrustPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr-containers/update-role-trust-policy.html)in der *AWS CLI Befehlsreferenz*. # EventBridge Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren EventBridge. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-rule` Das folgende Codebeispiel zeigt, wie Sie`delete-rule`. **AWS CLI** **Um eine CloudWatch Ereignisregel zu löschen** In diesem Beispiel wird die Regel mit dem Namen EC2 InstanceStateChanges gelöscht: ``` aws events delete-rule --name "EC2InstanceStateChanges" ``` + Einzelheiten zur API finden Sie [DeleteRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/delete-rule.html)in der *AWS CLI Befehlsreferenz.* ### `describe-rule` Das folgende Codebeispiel zeigt die Verwendung`describe-rule`. **AWS CLI** **Um Informationen über eine CloudWatch Ereignisregel anzuzeigen** In diesem Beispiel werden Informationen zu der Regel mit dem Namen angezeigt DailyLambdaFunction: ``` aws events describe-rule --name "DailyLambdaFunction" ``` + Einzelheiten zur API finden Sie [DescribeRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/describe-rule.html)unter *AWS CLI Befehlsreferenz*. ### `disable-rule` Das folgende Codebeispiel zeigt die Verwendung`disable-rule`. **AWS CLI** **Um eine CloudWatch Ereignisregel zu deaktivieren** In diesem Beispiel wird die genannte DailyLambdaFunction Regel deaktiviert. Die Regel wird nicht gelöscht: ``` aws events disable-rule --name "DailyLambdaFunction" ``` + Einzelheiten zur API finden Sie [DisableRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/disable-rule.html)in der *AWS CLI Befehlsreferenz.* ### `enable-rule` Das folgende Codebeispiel zeigt die Verwendung`enable-rule`. **AWS CLI** **Um eine CloudWatch Ereignisregel zu aktivieren** In diesem Beispiel wird die genannte Regel aktiviert DailyLambdaFunction, die zuvor deaktiviert wurde: ``` aws events enable-rule --name "DailyLambdaFunction" ``` + Einzelheiten zur API finden Sie [EnableRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/enable-rule.html)in der *AWS CLI Befehlsreferenz*. ### `list-rule-names-by-target` Das folgende Codebeispiel zeigt die Verwendung`list-rule-names-by-target`. **AWS CLI** **So zeigen Sie alle Regeln mit einem bestimmten Ziel an** In diesem Beispiel werden alle Regeln angezeigt, deren Ziel die Lambda-Funktion MyFunctionName "" ist: ``` aws events list-rule-names-by-target --target-arn "arn:aws:lambda:us-east-1:123456789012:function:MyFunctionName" ``` + Einzelheiten zur API finden Sie unter [ListRuleNamesByTarget AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/list-rule-names-by-target.html)*Befehlsreferenz.* ### `list-rules` Das folgende Codebeispiel zeigt die Verwendung`list-rules`. **AWS CLI** **Um eine Liste aller CloudWatch Event-Regeln anzuzeigen** In diesem Beispiel werden alle CloudWatch Event-Regeln in der Region angezeigt: ``` aws events list-rules ``` **Um eine Liste von CloudWatch Event-Regeln anzuzeigen, die mit einer bestimmten Zeichenfolge beginnen.** In diesem Beispiel werden alle CloudWatch Event-Regeln in der Region angezeigt, deren Name mit „Täglich“ beginnt: ``` aws events list-rules --name-prefix "Daily" ``` + Einzelheiten zur API finden Sie [ListRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/list-rules.html)unter *AWS CLI Befehlsreferenz*. ### `list-targets-by-rule` Das folgende Codebeispiel zeigt die Verwendung`list-targets-by-rule`. **AWS CLI** **Um alle Ziele für eine CloudWatch Ereignisregel anzuzeigen** In diesem Beispiel werden alle Ziele der Regel mit dem Namen angezeigt DailyLambdaFunction: ``` aws events list-targets-by-rule --rule "DailyLambdaFunction" ``` + Einzelheiten zur API finden Sie [ListTargetsByRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/list-targets-by-rule.html)unter *AWS CLI Befehlsreferenz*. ### `put-events` Das folgende Codebeispiel zeigt die Verwendung`put-events`. **AWS CLI** **Um ein benutzerdefiniertes Ereignis an CloudWatch Events zu senden** In diesem Beispiel wird ein benutzerdefiniertes Ereignis an CloudWatch Events gesendet. Das Ereignis ist in der Datei putevents.json enthalten: ``` aws events put-events --entries file://putevents.json ``` Die Datei putevents.json hat folgenden Inhalt: ``` [ { "Source": "com.mycompany.myapp", "Detail": "{ \"key1\": \"value1\", \"key2\": \"value2\" }", "Resources": [ "resource1", "resource2" ], "DetailType": "myDetailType" }, { "Source": "com.mycompany.myapp", "Detail": "{ \"key1\": \"value3\", \"key2\": \"value4\" }", "Resources": [ "resource1", "resource2" ], "DetailType": "myDetailType" } ] ``` + Einzelheiten zur API finden Sie [PutEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/put-events.html)in der *AWS CLI Befehlsreferenz*. ### `put-rule` Das folgende Codebeispiel zeigt die Verwendung`put-rule`. **AWS CLI** **Um Regeln für CloudWatch Ereignisse zu erstellen** Im folgenden Beispiel wird eine Regel erstellt, die jeden Tag um 09:00 Uhr (UTC) ausgelöst wird. Wenn Sie put-targets verwenden, um eine Lambda-Funktion als Ziel dieser Regel hinzuzufügen, können Sie die Lambda-Funktion jeden Tag zur angegebenen Zeit ausführen: ``` aws events put-rule --name "DailyLambdaFunction" --schedule-expression "cron(0 9 * * ? *)" ``` Im folgenden Beispiel wird eine Regel erstellt, die ausgelöst wird, wenn eine EC2-Instance in der Region den Status ändert: ``` aws events put-rule --name "EC2InstanceStateChanges" --event-pattern "{\"source\":[\"aws.ec2\"],\"detail-type\":[\"EC2 Instance State-change Notification\"]}" --role-arn "arn:aws:iam::123456789012:role/MyRoleForThisRule" ``` Im folgenden Beispiel wird eine Regel erstellt, die ausgelöst wird, wenn eine EC2-Instance in der Region gestoppt oder beendet wird: ``` aws events put-rule --name "EC2InstanceStateChangeStopOrTerminate" --event-pattern "{\"source\":[\"aws.ec2\"],\"detail-type\":[\"EC2 Instance State-change Notification\"],\"detail\":{\"state\":[\"stopped\",\"terminated\"]}}" --role-arn "arn:aws:iam::123456789012:role/MyRoleForThisRule" ``` + Einzelheiten zur API finden Sie [PutRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/put-rule.html)in der *AWS CLI Befehlsreferenz*. ### `put-targets` Das folgende Codebeispiel zeigt die Verwendung`put-targets`. **AWS CLI** **Um Ziele für CloudWatch Event-Regeln hinzuzufügen** Im folgenden Beispiel wird eine Lambda-Funktion als Ziel einer Regel hinzugefügt: ``` aws events put-targets --rule DailyLambdaFunction --targets "Id"="1","Arn"="arn:aws:lambda:us-east-1:123456789012:function:MyFunctionName" ``` Im folgenden Beispiel wird ein Amazon-Kinesis-Stream als Ziel festgelegt, sodass Ereignisse, die von dieser Regel erfasst werden, an den Stream weitergeleitet werden: ``` aws events put-targets --rule EC2InstanceStateChanges --targets "Id"="1","Arn"="arn:aws:kinesis:us-east-1:123456789012:stream/MyStream","RoleArn"="arn:aws:iam::123456789012:role/MyRoleForThisRule" ``` Im folgenden Beispiel werden zwei Amazon-Kinesis-Streams als Ziele für eine Regel festgelegt: ``` aws events put-targets --rule DailyLambdaFunction --targets "Id"="Target1","Arn"="arn:aws:kinesis:us-east-1:379642911888:stream/MyStream1","RoleArn"="arn:aws:iam::379642911888:role/ MyRoleToAccessLambda" "Id"="Target2"," Arn"="arn:aws:kinesis:us-east-1:379642911888:stream/MyStream2","RoleArn"="arn:aws:iam::379642911888:role/MyRoleToAccessLambda" ``` + Einzelheiten zur API finden Sie [PutTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/put-targets.html)in der *AWS CLI Befehlsreferenz*. ### `remove-targets` Das folgende Codebeispiel zeigt die Verwendung`remove-targets`. **AWS CLI** **So entfernen Sie ein Ziel für ein Ereignis** In diesem Beispiel wird der Amazon Kinesis Kinesis-Stream mit dem Namen MyStream 1 aus dem Ziel der Regel DailyLambdaFunction entfernt. Bei DailyLambdaFunction seiner Erstellung wurde dieser Stream als Ziel mit der ID Target1 festgelegt: ``` aws events remove-targets --rule "DailyLambdaFunction" --ids "Target1" ``` + Einzelheiten zur API finden Sie [RemoveTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/remove-targets.html)in der *AWS CLI Befehlsreferenz.* ### `test-event-pattern` Das folgende Codebeispiel zeigt die Verwendung`test-event-pattern`. **AWS CLI** **So überprüfen Sie, ob ein Ereignismuster mit einem bestimmten Ereignis übereinstimmt** In diesem Beispiel wird getestet, ob das Muster „source:com.mycompany.myapp“ mit dem angegebenen Ereignis übereinstimmt. In diesem Beispiel wäre die Ausgabe „true“: ``` aws events test-event-pattern --event-pattern "{\"source\":[\"com.mycompany.myapp\"]}" --event "{\"id\":\"1\",\"source\":\"com.mycompany.myapp\",\"detail-type\":\"myDetailType\",\"account\":\"123456789012\",\"region\":\"us-east-1\",\"time\":\"2017-04-11T20:11:04Z\"}" ``` + Einzelheiten zur API finden Sie [TestEventPattern](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/test-event-pattern.html)in der *AWS CLI Befehlsreferenz*. # EventBridge Leitet Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with EventBridge Pipes Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-pipe` Das folgende Codebeispiel zeigt, wie Sie`create-pipe`. **AWS CLI** **So erstellen Sie eine Pipe** Im folgenden `create-pipe` Beispiel wird eine Pipe `Demo_Pipe` mit dem Namen SQS als Quelle und CloudWatch Log Group als Ziel für die Pipe erstellt. ``` aws pipes create-pipe \ --name Demo_Pipe \ --desired-state RUNNING \ --role-arn arn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f \ --source arn:aws:sqs:us-east-1:123456789012:Demo_Queue \ --target arn:aws:logs:us-east-1:123456789012:log-group:/aws/pipes/Demo_LogGroup ``` Ausgabe: ``` { "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "CREATING", "CreationTime": "2024-10-08T12:33:59-05:00", "LastModifiedTime": "2024-10-08T12:33:59.684839-05:00" } ``` Weitere Informationen finden Sie unter [Amazon EventBridge Pipes-Konzepte](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreatePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/create-pipe.html)in der *AWS CLI Befehlsreferenz*. ### `delete-pipe` Das folgende Codebeispiel zeigt die Verwendung`delete-pipe`. **AWS CLI** **So löschen Sie eine vorhandene Pipe** Im folgenden Beispiel für `delete-pipe` wird eine Pipe mit dem Namen `Demo_Pipe` im angegebenen Konto gelöscht. ``` aws pipes delete-pipe \ --name Demo_Pipe ``` Ausgabe: ``` { "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "STOPPED", "CurrentState": "DELETING", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T11:57:22-05:00" } ``` Weitere Informationen finden Sie unter [Amazon EventBridge Pipes-Konzepte](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeletePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/delete-pipe.html)in der *AWS CLI Befehlsreferenz*. ### `describe-pipe` Das folgende Codebeispiel zeigt die Verwendung`describe-pipe`. **AWS CLI** **So rufen Sie Informationen zu einem Auftrag ab** Im folgenden Beispiel für `describe-pipe` werden Informationen zu der Pipe `Demo_Pipe` im angegebenen Konto angezeigt. ``` aws pipes describe-pipe \ --name Demo_Pipe ``` Ausgabe: ``` { "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "RUNNING", "StateReason": "User initiated", "Source": "arn:aws:sqs:us-east-1:123456789012:Demo_Queue", "SourceParameters": { "SqsQueueParameters": { "BatchSize": 1 } }, "EnrichmentParameters": {}, "Target": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/pipes/Demo_LogGroup", "TargetParameters": {}, "RoleArn": "arn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f", "Tags": {}, "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T10:23:47-05:00", "LogConfiguration": { "CloudwatchLogsLogDestination": { "LogGroupArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/vendedlogs/pipes/Demo_Pipe" }, "Level": "ERROR" } } ``` Weitere Informationen finden Sie unter [Amazon EventBridge Pipes-Konzepte](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/describe-pipe.html)in der *AWS CLI Befehlsreferenz*. ### `list-pipes` Das folgende Codebeispiel zeigt die Verwendung`list-pipes`. **AWS CLI** **So rufen Sie eine Liste von Pipes ab** Im folgenden Beispiel für `list-pipes` werden alle Pipes im angegebenen Konto aufgelistet. ``` aws pipes list-pipes ``` Ausgabe: ``` { "Pipes": [ { "Name": "Demo_Pipe", "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "RUNNING", "StateReason": "User initiated", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T10:23:47-05:00", "Source": "arn:aws:sqs:us-east-1:123456789012:Demo_Queue", "Target": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/pipes/Demo_LogGroup" } ] } ``` Weitere Informationen finden Sie unter [Amazon EventBridge Pipes-Konzepte](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListPipes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-pipes.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags auf, die einer vorhandenen Pipe zugeordnet sind** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags aufgelistet, die einer Pipe mit dem Namen `Demo_Pipe` im angegebenen Konto zugeordnet sind. ``` aws pipes list-tags-for-resource \ --resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe ``` Ausgabe: ``` { "tags": { "stack": "Production", "team": "DevOps" } } ``` Weitere Informationen finden Sie unter [Amazon EventBridge Pipes-Konzepte](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `start-pipe` Das folgende Codebeispiel zeigt die Verwendung`start-pipe`. **AWS CLI** **So starten Sie eine vorhandene Pipe** Im folgenden Beispiel für `start-pipe` wird eine Pipe mit dem Namen `Demo_Pipe` im angegebenen Konto gestartet. ``` aws pipes start-pipe \ --name Demo_Pipe ``` Ausgabe: ``` { "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "STARTING", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T10:17:24-05:00" } ``` Weitere Informationen finden Sie unter [Starten oder Stoppen einer EventBridge Amazon-Pipe](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartPipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/start-pipe.html)unter *AWS CLI Befehlsreferenz*. ### `stop-pipe` Das folgende Codebeispiel zeigt die Verwendung`stop-pipe`. **AWS CLI** **So stoppen Sie eine vorhandene Pipe** Im folgenden Beispiel für `stop-pipe` wird eine Pipe mit dem Namen `Demo_Pipe` im angegebenen Konto gestoppt. ``` aws pipes stop-pipe \ --name Demo_Pipe ``` Ausgabe: ``` { "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "STOPPED", "CurrentState": "STOPPING", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T09:29:49-05:00" } ``` Weitere Informationen finden Sie unter [Starten oder Stoppen einer EventBridge Amazon-Pipe](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopPipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/stop-pipe.html)unter *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer vorhandenen Pipe einen Tag hinzu** Im folgenden Beispiel für `tag-resource` wird einer Pipe mit dem Namen `Demo_Pipe` ein Tag hinzugefügt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. ``` aws pipes tag-resource \ --resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \ --tags stack=Production ``` Weitere Informationen finden Sie unter [Amazon EventBridge Pipes-Konzepte](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einer vorhandenen Pipe** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem Schlüssel `stack` von der Pipe mit dem Namen `Demo_Pipe` entfernt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben. ``` aws pipes untag-resource \ --resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \ --tags stack ``` Weitere Informationen finden Sie unter [Amazon EventBridge Pipes-Konzepte](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-pipe` Das folgende Codebeispiel zeigt die Verwendung`update-pipe`. **AWS CLI** **So aktualisieren Sie eine vorhandene Pipe** Im folgenden `update-pipe` Beispiel wird die Pipe aktualisiert, `Demo_Pipe` indem ein CloudWatch Log-Konfigurationsparameter hinzugefügt wird. Achten Sie darauf, dass die Ausführungsrolle der Pipe aktualisiert wird, sodass sie über die richtigen Berechtigungen für das Protokollziel verfügt. ``` aws pipes update-pipe \ --name Demo_Pipe \ --desired-state RUNNING \ --log-configuration CloudwatchLogsLogDestination={LogGroupArn=arn:aws:logs:us-east-1:123456789012:log-group:/aws/vendedlogs/pipes/Demo_Pipe},Level=TRACE \ --role-arn arn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f ``` Ausgabe: ``` { "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "UPDATING", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T11:35:48-05:00" } ``` Weitere Informationen finden Sie unter [Amazon EventBridge Pipes-Konzepte](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) im * EventBridge Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdatePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/update-pipe.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Firewall Manager mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Firewall Manager Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-admin-account` Das folgende Codebeispiel zeigt, wie Sie`associate-admin-account`. **AWS CLI** **So legen Sie das Administratorkonto von Firewall Manager fest** Im folgenden Beispiel für `associate-admin-account` wird das Administratorkonto für Firewall Manager festgelegt. ``` aws fms associate-admin-account \ --admin-account 123456789012 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Einrichten des AWS Firewall Manager-Administratorkontos](https://docs.aws.amazon.com/waf/latest/developerguide/enable-integration.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [AssociateAdminAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/associate-admin-account.html)in der *AWS CLI Befehlsreferenz.* ### `delete-notification-channel` Das folgende Codebeispiel zeigt die Verwendung`delete-notification-channel`. **AWS CLI** **So entfernen Sie die SNS-Themeninformationen für Protokolle von Firewall Manager** Im folgenden Beispiel für `delete-notification-channel` werden die SNS-Themeninformationen entfernt. ``` aws fms delete-notification-channel ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Konfiguration von Amazon SNS SNS-Benachrichtigungen und CloudWatch Amazon-Alarmen](https://docs.aws.amazon.com/waf/latest/developerguide/get-started-fms-shield-cloudwatch.html) im *Entwicklerhandbuch für AWS WAF, AWS Firewall Manager und AWS Shield Advanced*. + Einzelheiten zur API finden Sie [DeleteNotificationChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/delete-notification-channel.html)in der *AWS CLI Befehlsreferenz*. ### `delete-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-policy`. **AWS CLI** **So löschen Sie eine Richtlinie von Firewall Manager** Im folgenden Beispiel für `delete-policy` wird die Richtlinie mit der angegebenen ID zusammen mit all ihren Ressourcen entfernt. ``` aws fms delete-policy \ --policy-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --delete-all-policy-resources ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit AWS Firewall Manager-Richtlinien](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-policies.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [DeletePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/delete-policy.html)in der *AWS CLI Befehlsreferenz.* ### `disassociate-admin-account` Das folgende Codebeispiel zeigt die Verwendung`disassociate-admin-account`. **AWS CLI** **So entfernen Sie das Administratorkonto von Firewall Manager** Im folgenden Beispiel für `disassociate-admin-account` wird die aktuelle Administratorkontenverknüpfung aus Firewall Manager entfernt. ``` aws fms disassociate-admin-account ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Einrichten des AWS Firewall Manager-Administratorkontos](https://docs.aws.amazon.com/waf/latest/developerguide/enable-integration.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [DisassociateAdminAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/disassociate-admin-account.html)in der *AWS CLI Befehlsreferenz.* ### `get-admin-account` Das folgende Codebeispiel zeigt die Verwendung`get-admin-account`. **AWS CLI** **So rufen Sie das Administratorkonto von Firewall Manager ab** Im folgenden Beispiel für `get-admin-account` wird das Administratorkonto abgerufen. ``` aws fms get-admin-account ``` Ausgabe: ``` { "AdminAccount": "123456789012", "RoleStatus": "READY" } ``` Weitere Informationen finden Sie unter [Voraussetzungen für AWS Firewall Manager](https://docs.aws.amazon.com/waf/latest/developerguide/fms-prereq.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [GetAdminAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/get-admin-account.html)in der *AWS CLI Befehlsreferenz.* ### `get-compliance-detail` Das folgende Codebeispiel zeigt die Verwendung`get-compliance-detail`. **AWS CLI** **So rufen Sie die Compliance-Informationen für ein Konto ab** Im folgenden Beispiel für `get-compliance-detail` werden Compliance-Informationen für die angegebene Richtlinie und das angegebene Mitgliedskonto abgerufen. ``` aws fms get-compliance-detail \ --policy-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --member-account 123456789012 ``` Ausgabe: ``` { "PolicyComplianceDetail": { "EvaluationLimitExceeded": false, "IssueInfoMap": {}, "MemberAccount": "123456789012", "PolicyId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PolicyOwner": "123456789012", "Violators": [] } ``` Weitere Informationen finden Sie unter [Ressourcenkonformität mit einer Richtlinie anzeigen](https://docs.aws.amazon.com/waf/latest/developerguide/fms-compliance.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [GetComplianceDetail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/get-compliance-detail.html)in der *AWS CLI Befehlsreferenz.* ### `get-notification-channel` Das folgende Codebeispiel zeigt die Verwendung`get-notification-channel`. **AWS CLI** **So rufen Sie die SNS-Themeninformationen für Protokolle von Firewall Manager ab** Im folgenden Beispiel für `get-notification-channel` werden die SNS-Themeninformationen abgerufen. ``` aws fms get-notification-channel ``` Ausgabe: ``` { "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:us-west-2-fms", "SnsRoleName": "arn:aws:iam::123456789012:role/aws-service-role/fms.amazonaws.com/AWSServiceRoleForFMS" } ``` Weitere Informationen finden [Sie unter Konfiguration von Amazon SNS SNS-Benachrichtigungen und CloudWatch Amazon-Alarmen](https://docs.aws.amazon.com/waf/latest/developerguide/get-started-fms-shield-cloudwatch.html) im *Entwicklerhandbuch für AWS WAF, AWS Firewall Manager und AWS Shield Advanced*. + Einzelheiten zur API finden Sie [GetNotificationChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/get-notification-channel.html)in der *AWS CLI Befehlsreferenz*. ### `get-policy` Das folgende Codebeispiel zeigt die Verwendung`get-policy`. **AWS CLI** **So rufen Sie eine Richtlinie von Firewall Manager ab** Im folgenden Beispiel für `get-policy` wird die Richtlinie mit der angegebenen ID abgerufen. ``` aws fms get-policy \ --policy-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "Policy": { "PolicyId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PolicyName": "test", "PolicyUpdateToken": "1:p+2RpKR4wPFx7mcrL1UOQQ==", "SecurityServicePolicyData": { "Type": "SECURITY_GROUPS_COMMON", "ManagedServiceData": "{\"type\":\"SECURITY_GROUPS_COMMON\",\"revertManualSecurityGroupChanges\":true,\"exclusiveResourceSecurityGroupManagement\":false,\"securityGroups\":[{\"id\":\"sg-045c43ccc9724e63e\"}]}" }, "ResourceType": "AWS::EC2::Instance", "ResourceTags": [], "ExcludeResourceTags": false, "RemediationEnabled": false }, "PolicyArn": "arn:aws:fms:us-west-2:123456789012:policy/d1ac59b8-938e-42b3-b2e0-7c620422ddc2" } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Firewall Manager-Richtlinien](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-policies.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [GetPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/get-policy.html)in der *AWS CLI Befehlsreferenz.* ### `list-compliance-status` Das folgende Codebeispiel zeigt die Verwendung`list-compliance-status`. **AWS CLI** **So rufen Sie die Compliance-Informationen zu Richtlinien für Mitgliedskonten ab** Im folgenden Beispiel für `list-compliance-status` werden Compliance-Informationen zu Mitgliedskonten für die angegebene Richtlinie abgerufen. ``` aws fms list-compliance-status \ --policy-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "PolicyComplianceStatusList": [ { "PolicyOwner": "123456789012", "PolicyId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PolicyName": "test", "MemberAccount": "123456789012", "EvaluationResults": [ { "ComplianceStatus": "COMPLIANT", "ViolatorCount": 0, "EvaluationLimitExceeded": false }, { "ComplianceStatus": "NON_COMPLIANT", "ViolatorCount": 2, "EvaluationLimitExceeded": false } ], "LastUpdated": 1576283774.0, "IssueInfoMap": {} } ] } ``` Weitere Informationen finden Sie unter [Ressourcenkonformität mit einer Richtlinie anzeigen](https://docs.aws.amazon.com/waf/latest/developerguide/fms-compliance.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [ListComplianceStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/list-compliance-status.html)in der *AWS CLI Befehlsreferenz.* ### `list-member-accounts` Das folgende Codebeispiel zeigt die Verwendung`list-member-accounts`. **AWS CLI** **So rufen Sie die Mitgliedskonten in der Organisation ab** Im folgenden Beispiel für `list-member-accounts` werden alle Mitgliedskonten aufgelistet, die sich in der Organisation des Administrators von Firewall Manager befinden. ``` aws fms list-member-accounts ``` Ausgabe: ``` { "MemberAccounts": [ "222222222222", "333333333333", "444444444444" ] } ``` Weitere Informationen finden Sie unter [AWS Firewall Manager](https://docs.aws.amazon.com/waf/latest/developerguide/fms-chapter.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [ListMemberAccounts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/list-member-accounts.html)in der *AWS CLI Befehlsreferenz.* ### `list-policies` Das folgende Codebeispiel zeigt die Verwendung`list-policies`. **AWS CLI** **So rufen Sie alle Richtlinien von Firewall Manager ab** Im folgenden Beispiel für `list-policies` wird die Liste der Richtlinien für das Konto abgerufen. In diesem Beispiel ist die Ausgabe auf zwei Ergebnisse pro Anforderung beschränkt. Bei jedem Aufruf wird ein `NextToken` zurückgegeben, der beim nächsten `list-policies`-Aufruf als Wert für den Parameter `--starting-token` verwendet werden kann, um den nächsten Ergebnissatz für die Liste abzurufen. ``` aws fms list-policies \ --max-items 2 ``` Ausgabe: ``` { "PolicyList": [ { "PolicyArn": "arn:aws:fms:us-west-2:123456789012:policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PolicyId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PolicyName": "test", "ResourceType": "AWS::EC2::Instance", "SecurityServiceType": "SECURITY_GROUPS_COMMON", "RemediationEnabled": false }, { "PolicyArn": "arn:aws:fms:us-west-2:123456789012:policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "PolicyId": "457c9b21-fc94-406c-ae63-21217395ba72", "PolicyName": "test", "ResourceType": "AWS::EC2::Instance", "SecurityServiceType": "SECURITY_GROUPS_COMMON", "RemediationEnabled": false } ], "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==" } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Firewall Manager-Richtlinien](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-policies.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [ListPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/list-policies.html)in der *AWS CLI Befehlsreferenz.* ### `put-notification-channel` Das folgende Codebeispiel zeigt die Verwendung`put-notification-channel`. **AWS CLI** **So legen Sie die SNS-Themeninformationen für Protokolle von Firewall Manager fest** Im folgenden Beispiel für `put-notification-channel` werden die SNS-Themeninformationen festgelegt. ``` aws fms put-notification-channel \ --sns-topic-arn arn:aws:sns:us-west-2:123456789012:us-west-2-fms \ --sns-role-name arn:aws:iam::123456789012:role/aws-service-role/fms.amazonaws.com/AWSServiceRoleForFMS ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Konfiguration von Amazon SNS SNS-Benachrichtigungen und CloudWatch Amazon-Alarmen](https://docs.aws.amazon.com/waf/latest/developerguide/get-started-fms-shield-cloudwatch.html) im *Entwicklerhandbuch für AWS WAF, AWS Firewall Manager und AWS Shield Advanced*. + Einzelheiten zur API finden Sie [PutNotificationChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/put-notification-channel.html)in der *AWS CLI Befehlsreferenz*. ### `put-policy` Das folgende Codebeispiel zeigt die Verwendung`put-policy`. **AWS CLI** **So erstellen Sie eine Richtlinie von Firewall Manager** Im folgenden Beispiel für `put-policy` wird eine Sicherheitsgruppenrichtlinie von Firewall Manager erstellt. ``` aws fms put-policy \ --cli-input-json file://policy.json ``` Inhalt von `policy.json`: ``` { "Policy": { "PolicyName": "test", "SecurityServicePolicyData": { "Type": "SECURITY_GROUPS_USAGE_AUDIT", "ManagedServiceData": "{\"type\":\"SECURITY_GROUPS_USAGE_AUDIT\",\"deleteUnusedSecurityGroups\":false,\"coalesceRedundantSecurityGroups\":true}" }, "ResourceType": "AWS::EC2::SecurityGroup", "ResourceTags": [], "ExcludeResourceTags": false, "RemediationEnabled": false }, "TagList": [ { "Key": "foo", "Value": "foo" } ] } ``` Ausgabe: ``` { "Policy": { "PolicyId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PolicyName": "test", "PolicyUpdateToken": "1:X9QGexP7HASDlsFp+G31Iw==", "SecurityServicePolicyData": { "Type": "SECURITY_GROUPS_USAGE_AUDIT", "ManagedServiceData": "{\"type\":\"SECURITY_GROUPS_USAGE_AUDIT\",\"deleteUnusedSecurityGroups\":false,\"coalesceRedundantSecurityGroups\":true,\"optionalDelayForUnusedInMinutes\":null}" }, "ResourceType": "AWS::EC2::SecurityGroup", "ResourceTags": [], "ExcludeResourceTags": false, "RemediationEnabled": false }, "PolicyArn": "arn:aws:fms:us-west-2:123456789012:policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Firewall Manager-Richtlinien](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-policies.html) im *AWS WAF, AWS Firewall Manager und AWS Shield Advanced Developer Guide*. + Einzelheiten zur API finden Sie [PutPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fms/put-policy.html)in der *AWS CLI Befehlsreferenz.* # AWS FIS Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS FIS. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-experiment-template` Das folgende Codebeispiel zeigt, wie Sie`create-experiment-template`. **AWS CLI** **So erstellen Sie eine Experimentvorlage** Das folgende `create-experiment-template` Beispiel erstellt eine Versuchsvorlage in Ihrem AWS FIS-Account. ``` aws fis create-experiment-template \ --cli-input-json file://myfile.json ``` Inhalt von `myfile.json`: ``` { "description": "experimentTemplate", "stopConditions": [ { "source": "aws:cloudwatch:alarm", "value": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:alarmName" } ], "targets": { "Instances-Target-1": { "resourceType": "aws:ec2:instance", "resourceArns": [ "arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012" ], "selectionMode": "ALL" } }, "actions": { "reboot": { "actionId": "aws:ec2:reboot-instances", "description": "reboot", "parameters": {}, "targets": { "Instances": "Instances-Target-1" } } }, "roleArn": "arn:aws:iam::123456789012:role/myRole" } ``` Ausgabe: ``` { "experimentTemplate": { "id": "ABCDE1fgHIJkLmNop", "description": "experimentTemplate", "targets": { "Instances-Target-1": { "resourceType": "aws:ec2:instance", "resourceArns": [ "arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012" ], "selectionMode": "ALL" } }, "actions": { "reboot": { "actionId": "aws:ec2:reboot-instances", "description": "reboot", "parameters": {}, "targets": { "Instances": "Instances-Target-1" } } }, "stopConditions": [ { "source": "aws:cloudwatch:alarm", "value": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:alarmName" } ], "creationTime": 1616434850.659, "lastUpdateTime": 1616434850.659, "roleArn": "arn:aws:iam::123456789012:role/myRole", "tags": {} } } ``` Weitere Informationen finden Sie unter [Erstellen einer Experimentvorlage](https://docs.aws.amazon.com/fis/latest/userguide/working-with-templates.html#create-template) im *Benutzerhandbuch für AWS Fault Injection Simulator*. + Einzelheiten zur API finden Sie [CreateExperimentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/create-experiment-template.html)in der *AWS CLI Befehlsreferenz.* ### `delete-experiment-template` Das folgende Codebeispiel zeigt die Verwendung`delete-experiment-template`. **AWS CLI** **So löschen Sie eine Experimentvorlage** Im folgenden Beispiel für `delete-experiment-template` wird die angegebene Experimentvorlage gelöscht. ``` aws fis delete-experiment-template \ --id ABCDE1fgHIJkLmNop ``` Ausgabe: ``` { "experimentTemplate": { "id": "ABCDE1fgHIJkLmNop", "description": "myExperimentTemplate", "targets": { "Instances-Target-1": { "resourceType": "aws:ec2:instance", "resourceArns": [ "arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012" ], "selectionMode": "ALL" } }, "actions": { "testaction": { "actionId": "aws:ec2:stop-instances", "parameters": {}, "targets": { "Instances": "Instances-Target-1" } } }, "stopConditions": [ { "source": "none" } ], "creationTime": 1616017191.124, "lastUpdateTime": 1616017859.607, "roleArn": "arn:aws:iam::123456789012:role/FISRole" } } ``` Weitere Informationen finden Sie unter [Löschen einer Experimentvorlage](https://docs.aws.amazon.com/fis/latest/userguide/working-with-templates.html#delete-template) im *Benutzerhandbuch für AWS Fault Injection Simulator*. + Einzelheiten zur API finden Sie [DeleteExperimentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/delete-experiment-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-action` Das folgende Codebeispiel zeigt die Verwendung`get-action`. **AWS CLI** **So rufen Sie Details zur Aktion ab** Im folgenden Beispiel für `get-action` werden die Details der angegebenen Aktion abgerufen. ``` aws fis get-action \ --id aws:ec2:stop-instances ``` Ausgabe: ``` { "action": { "id": "aws:ec2:stop-instances", "description": "Stop the specified EC2 instances.", "parameters": { "startInstancesAfterDuration": { "description": "The time to wait before restarting the instances (ISO 8601 duration).", "required": false } }, "targets": { "Instances": { "resourceType": "aws:ec2:instance" } }, "tags": {} } } ``` Weitere Informationen finden Sie unter [Aktionen](https://docs.aws.amazon.com/fis/latest/userguide/actions.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*. + Einzelheiten zur API finden Sie [GetAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/get-action.html)in der *AWS CLI Befehlsreferenz*. ### `get-experiment-template` Das folgende Codebeispiel zeigt die Verwendung`get-experiment-template`. **AWS CLI** **So rufen Sie Details zur Experimentvorlage ab** Im folgenden Beispiel für `get-experiment-template` werden die Details der angegebenen Experimentvorlage abgerufen. ``` aws fis get-experiment-template \ --id ABCDE1fgHIJkLmNop ``` Ausgabe: ``` { "experimentTemplate": { "id": "ABCDE1fgHIJkLmNop", "description": "myExperimentTemplate", "targets": { "Instances-Target-1": { "resourceType": "aws:ec2:instance", "resourceArns": [ "arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012" ], "selectionMode": "ALL" } }, "actions": { "testaction": { "actionId": "aws:ec2:stop-instances", "parameters": {}, "targets": { "Instances": "Instances-Target-1" } } }, "stopConditions": [ { "source": "none" } ], "creationTime": 1616017191.124, "lastUpdateTime": 1616017331.51, "roleArn": "arn:aws:iam::123456789012:role/FISRole", "tags": { "key: "value" } } } ``` Weitere Informationen finden Sie unter [Experimentvorlagen](https://docs.aws.amazon.com/fis/latest/userguide/experiment-templates.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*. + Einzelheiten zur API finden Sie [GetExperimentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/get-experiment-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-experiment` Das folgende Codebeispiel zeigt die Verwendung`get-experiment`. **AWS CLI** **So rufen Sie Details zum Experiment ab** Im folgenden Beispiel für `get-experiment` werden die Details des angegebenen Experiments abgerufen. ``` aws fis get-experiment \ --id ABC12DeFGhI3jKLMNOP ``` Ausgabe: ``` { "experiment": { "id": "ABC12DeFGhI3jKLMNOP", "experimentTemplateId": "ABCDE1fgHIJkLmNop", "roleArn": "arn:aws:iam::123456789012:role/myRole", "state": { "status": "completed", "reason": "Experiment completed." }, "targets": { "Instances-Target-1": { "resourceType": "aws:ec2:instance", "resourceArns": [ "arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012" ], "selectionMode": "ALL" } }, "actions": { "reboot": { "actionId": "aws:ec2:reboot-instances", "parameters": {}, "targets": { "Instances": "Instances-Target-1" }, "state": { "status": "completed", "reason": "Action was completed." } } }, "stopConditions": [ { "source": "none" } ], "creationTime": 1616432509.662, "startTime": 1616432509.962, "endTime": 1616432522.307, "tags": {} } } ``` Weitere Informationen finden Sie unter [Experiments for AWS FIS im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/experiments.html) *Injection Simulator-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetExperiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/get-experiment.html)in der *AWS CLI Befehlsreferenz.* ### `list-actions` Das folgende Codebeispiel zeigt die Verwendung`list-actions`. **AWS CLI** **So listen Sie Aktionen auf** Im folgenden Beispiel für `list-actions` werden die verfügbaren Aktionen aufgelistet. ``` aws fis list-actions ``` Ausgabe: ``` { "actions": [ { "id": "aws:ec2:reboot-instances", "description": "Reboot the specified EC2 instances.", "targets": { "Instances": { "resourceType": "aws:ec2:instance" } }, "tags": {} }, { "id": "aws:ec2:stop-instances", "description": "Stop the specified EC2 instances.", "targets": { "Instances": { "resourceType": "aws:ec2:instance" } }, "tags": {} }, { "id": "aws:ec2:terminate-instances", "description": "Terminate the specified EC2 instances.", "targets": { "Instances": { "resourceType": "aws:ec2:instance" } }, "tags": {} }, { "id": "aws:ecs:drain-container-instances", "description": "Drain percentage of underlying EC2 instances on an ECS cluster.", "targets": { "Clusters": { "resourceType": "aws:ecs:cluster" } }, "tags": {} }, { "id": "aws:eks:terminate-nodegroup-instances", "description": "Terminates a percentage of the underlying EC2 instances in an EKS cluster.", "targets": { "Nodegroups": { "resourceType": "aws:eks:nodegroup" } }, "tags": {} }, { "id": "aws:fis:inject-api-internal-error", "description": "Cause an AWS service to return internal error responses for specific callers and operations.", "targets": { "Roles": { "resourceType": "aws:iam:role" } }, "tags": {} }, { "id": "aws:fis:inject-api-throttle-error", "description": "Cause an AWS service to return throttled responses for specific callers and operations.", "targets": { "Roles": { "resourceType": "aws:iam:role" } }, "tags": {} }, { "id": "aws:fis:inject-api-unavailable-error", "description": "Cause an AWS service to return unavailable error responses for specific callers and operations.", "targets": { "Roles": { "resourceType": "aws:iam:role" } }, "tags": {} }, { "id": "aws:fis:wait", "description": "Wait for the specified duration. Stop condition monitoring will continue during this time.", "tags": {} }, { "id": "aws:rds:failover-db-cluster", "description": "Failover a DB Cluster to one of the replicas.", "targets": { "Clusters": { "resourceType": "aws:rds:cluster" } }, "tags": {} }, { "id": "aws:rds:reboot-db-instances", "description": "Reboot the specified DB instances.", "targets": { "DBInstances": { "resourceType": "aws:rds:db" } }, "tags": {} }, { "id": "aws:ssm:send-command", "description": "Run the specified SSM document.", "targets": { "Instances": { "resourceType": "aws:ec2:instance" } }, "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Aktionen](https://docs.aws.amazon.com/fis/latest/userguide/actions.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*. + Einzelheiten zur API finden Sie [ListActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/list-actions.html)in der *AWS CLI Befehlsreferenz*. ### `list-experiment-templates` Das folgende Codebeispiel zeigt die Verwendung`list-experiment-templates`. **AWS CLI** **So listen Sie Experimentvorlagen auf** Das folgende `list-experiment-templates` Beispiel listet die Versuchsvorlagen in Ihrem AWS Konto auf. ``` aws fis list-experiment-templates ``` Ausgabe: ``` { "experimentTemplates": [ { "id": "ABCDE1fgHIJkLmNop", "description": "myExperimentTemplate", "creationTime": 1616017191.124, "lastUpdateTime": 1616017191.124, "tags": { "key": "value" } } ] } ``` Weitere Informationen finden Sie unter [Experimentvorlagen](https://docs.aws.amazon.com/fis/latest/userguide/experiment-templates.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*. + Einzelheiten zur API finden Sie [ListExperimentTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/list-experiment-templates.html)in der *AWS CLI Befehlsreferenz*. ### `list-experiments` Das folgende Codebeispiel zeigt die Verwendung`list-experiments`. **AWS CLI** **So listen Sie Experimente auf** Das folgende `list-experiments` Beispiel listet die Experimente in Ihrem AWS Konto auf. ``` aws fis list-experiments ``` Ausgabe: ``` { "experiments": [ { "id": "ABCdeF1GHiJkLM23NO", "experimentTemplateId": "ABCDE1fgHIJkLmNop", "state": { "status": "running", "reason": "Experiment is running." }, "creationTime": 1616017341.197, "tags": { "key": "value" } } ] } ``` Weitere Informationen finden Sie unter [Experimente](https://docs.aws.amazon.com/fis/latest/userguide/experiments.html) im *Benutzerhandbuch für AWS Fault Injection Simulator*. + Einzelheiten zur API finden Sie [ListExperiments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/list-experiments.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für die angegebene Ressource aufgelistet. ``` aws fis list-tags-for-resource \ --resource-arn arn:aws:fis:us-west-2:123456789012:experiment/ABC12DeFGhI3jKLMNOP ``` Ausgabe: ``` { "tags": { "key1": "value1", "key2": "value2" } } ``` Weitere Informationen finden Sie unter [Taggen Ihrer AWS FIS-Ressourcen im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/tagging.html) *Injection Simulator-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `start-experiment` Das folgende Codebeispiel zeigt die Verwendung`start-experiment`. **AWS CLI** **So starten Sie ein Experiment** Im folgenden Beispiel für `start-experiment` wird das angegebene Experiment gestartet. ``` aws fis start-experiment \ --experiment-template-id ABCDE1fgHIJkLmNop ``` Ausgabe: ``` { "experiment": { "id": "ABC12DeFGhI3jKLMNOP", "experimentTemplateId": "ABCDE1fgHIJkLmNop", "roleArn": "arn:aws:iam::123456789012:role/myRole", "state": { "status": "initiating", "reason": "Experiment is initiating." }, "targets": { "Instances-Target-1": { "resourceType": "aws:ec2:instance", "resourceArns": [ "arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012" ], "selectionMode": "ALL" } }, "actions": { "reboot": { "actionId": "aws:ec2:reboot-instances", "parameters": {}, "targets": { "Instances": "Instances-Target-1" }, "state": { "status": "pending", "reason": "Initial state" } } }, "stopConditions": [ { "source": "none" } ], "creationTime": 1616432464.025, "startTime": 1616432464.374, "tags": {} } } ``` Weitere Informationen finden Sie unter [Experiments for AWS FIS im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/experiments.html) *Injection Simulator-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartExperiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/start-experiment.html)in der *AWS CLI Befehlsreferenz.* ### `stop-experiment` Das folgende Codebeispiel zeigt die Verwendung`stop-experiment`. **AWS CLI** **So stoppen Sie ein Experiment** Im folgenden Beispiel für `stop-experiment` wird die Ausführung des angegebenen Experiments gestoppt. ``` aws fis stop-experiment \ --id ABC12DeFGhI3jKLMNOP ``` Ausgabe: ``` { "experiment": { "id": "ABC12DeFGhI3jKLMNOP", "experimentTemplateId": "ABCDE1fgHIJkLmNop", "roleArn": "arn:aws:iam::123456789012:role/myRole", "state": { "status": "stopping", "reason": "Stopping Experiment." }, "targets": { "Instances-Target-1": { "resourceType": "aws:ec2:instance", "resourceArns": [ "arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012" ], "selectionMode": "ALL" } }, "actions": { "reboot": { "actionId": "aws:ec2:reboot-instances", "parameters": {}, "targets": { "Instances": "Instances-Target-1" }, "startAfter": [ "wait" ], "state": { "status": "pending", "reason": "Initial state." } }, "wait": { "actionId": "aws:fis:wait", "parameters": { "duration": "PT5M" }, "state": { "status": "running", "reason": "" } } }, "stopConditions": [ { "source": "none" } ], "creationTime": 1616432680.927, "startTime": 1616432681.177, "tags": {} } } ``` Weitere Informationen finden Sie unter [Experiments for AWS FIS im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/experiments.html) *Injection Simulator-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopExperiment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/stop-experiment.html)in der *AWS CLI Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird die angegebene Ressource mit einem Tag versehen. ``` aws fis tag-resource \ --resource-arn arn:aws:fis:us-west-2:123456789012:experiment/ABC12DeFGhI3jKLMNOP \ --tags key1=value1,key2=value2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer AWS FIS-Ressourcen im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/tagging.html) *Injection Simulator-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags von einer Ressource** Im folgenden Beispiel für `untag-resource` werden die Tags von der angegebenen Ressource entfernt. ``` aws fis untag-resource \ --resource-arn arn:aws:fis:us-west-2:123456789012:experiment/ABC12DeFGhI3jKLMNOP ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer AWS FIS-Ressourcen im AWS Fault](https://docs.aws.amazon.com/fis/latest/userguide/tagging.html) *Injection Simulator-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-experiment-template` Das folgende Codebeispiel zeigt die Verwendung`update-experiment-template`. **AWS CLI** **So aktualisieren Sie eine Experimentvorlage** Im folgenden Beispiel für `update-experiment-template` wird die Beschreibung der angegebenen Experimentvorlage aktualisiert. ``` aws fis update-experiment-template \ --id ABCDE1fgHIJkLmNop \ ---description myExperimentTemplate ``` Ausgabe: ``` { "experimentTemplate": { "id": "ABCDE1fgHIJkLmNop", "description": "myExperimentTemplate", "targets": { "Instances-Target-1": { "resourceType": "aws:ec2:instance", "resourceArns": [ "arn:aws:ec2:us-west-2:123456789012:instance/i-12a3b4c56d78e9012" ], "selectionMode": "ALL" } }, "actions": { "testaction": { "actionId": "aws:ec2:stop-instances", "parameters": {}, "targets": { "Instances": "Instances-Target-1" } } }, "stopConditions": [ { "source": "none" } ], "creationTime": 1616017191.124, "lastUpdateTime": 1616017859.607, "roleArn": "arn:aws:iam::123456789012:role/FISRole", "tags": { "key": "value" } } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Experimentvorlage](https://docs.aws.amazon.com/fis/latest/userguide/working-with-templates.html#update-template) im *Benutzerhandbuch für AWS Fault Injection Simulator*. + Einzelheiten zur API finden Sie [UpdateExperimentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/update-experiment-template.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für GameLift Amazon-Server mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon GameLift Servers Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-build` Das folgende Codebeispiel zeigt, wie Sie`create-build`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Spiele-Build aus Dateien in einem S3-Bucket** Im folgenden Beispiel für `create-build` wird eine benutzerdefinierte Spiele-Build-Ressource erstellt. Es verwendet komprimierte Dateien, die an einem S3-Speicherort in einem AWS Konto gespeichert sind, das Sie kontrollieren. In diesem Beispiel wird vorausgesetzt, dass Sie bereits eine IAM-Rolle erstellt haben, die Amazon die GameLift Erlaubnis erteilt, auf den S3-Standort zuzugreifen. Da die Anfrage kein Betriebssystem spezifiziert, ist die neue Build-Ressource standardmäßig WINDOWS\$12012. ``` aws gamelift create-build \ --storage-location file://storage-loc.json \ --name MegaFrogRaceServer.NA \ --build-version 12345.678 ``` Inhalt von `storage-loc.json`: ``` { "Bucket":"MegaFrogRaceServer_NA_build_files" "Key":"MegaFrogRaceServer_build_123.zip" "RoleArn":"arn:aws:iam::123456789012:role/gamelift" } ``` Ausgabe: ``` { "Build": { "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "CreationTime": 1496708916.18, "Name": "MegaFrogRaceServer.NA", "OperatingSystem": "WINDOWS_2012", "SizeOnDisk": 479303, "Status": "INITIALIZED", "Version": "12345.678" }, "StorageLocation": { "Bucket": "MegaFrogRaceServer_NA_build_files", "Key": "MegaFrogRaceServer_build_123.zip" } } ``` **Beispiel 2: Um eine Spiele-Build-Ressource für das manuelle Hochladen von Dateien zu erstellen GameLift** Im folgenden Beispiel für `create-build` wird eine neue Build-Ressource erstellt. Es erhält auch einen Speicherort und temporäre Anmeldeinformationen, mit denen Sie Ihren Spiel-Build manuell an den GameLift Speicherort in Amazon S3 hochladen können. Sobald Sie Ihren Build erfolgreich hochgeladen haben, validiert der GameLift Service den Build und aktualisiert den Status des neuen Builds. ``` aws gamelift create-build \ --name MegaFrogRaceServer.NA \ --build-version 12345.678 \ --operating-system AMAZON_LINUX ``` Ausgabe: ``` { "Build": { "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "CreationTime": 1496708916.18, "Name": "MegaFrogRaceServer.NA", "OperatingSystem": "AMAZON_LINUX", "SizeOnDisk": 0, "Status": "INITIALIZED", "Version": "12345.678" }, "StorageLocation": { "Bucket": "gamelift-builds-us-west-2", "Key": "123456789012/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, "UploadCredentials": { "AccessKeyId": "AKIAIOSFODNN7EXAMPLE", "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "SessionToken": "AgoGb3JpZ2luENz...EXAMPLETOKEN==" } } ``` Weitere Informationen finden Sie unter [Hochladen eines benutzerdefinierten Server-Builds auf GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [CreateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-build.html)in der *AWS CLI Befehlsreferenz*. ### `create-fleet` Das folgende Codebeispiel zeigt die Verwendung`create-fleet`. **AWS CLI** **Beispiel 1: So erstellen Sie eine grundlegende Linux-Flotte** Im folgenden Beispiel für `create-fleet` wird eine minimal konfigurierte Flotte von Linux-On-Demand-Instances erstellt, um einen benutzerdefinierten Server-Build zu hosten. Sie können die Konfiguration mit `update-fleet` abschließen. ``` aws gamelift create-fleet \ --name MegaFrogRaceServer.NA.v2 \ --description 'Hosts for v2 North America' \ --build-id build-1111aaaa-22bb-33cc-44dd-5555eeee66ff \ --certificate-configuration 'CertificateType=GENERATED' \ --ec2-instance-type c4.large \ --fleet-type ON_DEMAND \ --runtime-configuration 'ServerProcesses=[{LaunchPath=/local/game/release-na/MegaFrogRace_Server.exe,ConcurrentExecutions=1}]' ``` Ausgabe: ``` { "FleetAttributes": { "BuildId": "build-1111aaaa-22bb-33cc-44dd-5555eeee66ff", "CertificateConfiguration": { "CertificateType": "GENERATED" }, "CreationTime": 1496365885.44, "Description": "Hosts for v2 North America", "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetType": "ON_DEMAND", "InstanceType": "c4.large", "MetricGroups": ["default"], "Name": "MegaFrogRace.NA.v2", "NewGameSessionProtectionPolicy": "NoProtection", "OperatingSystem": "AMAZON_LINUX", "ServerLaunchPath": "/local/game/release-na/MegaFrogRace_Server.exe", "Status": "NEW" } } ``` **Beispiel 2: So erstellen Sie eine grundlegende Windows-Flotte** Im folgenden Beispiel für `create-fleet` wird eine minimal konfigurierte Flotte von Windows-Spot-Instances erstellt, um einen benutzerdefinierten Server-Build zu hosten. Sie können die Konfiguration mit `update-fleet` abschließen. ``` aws gamelift create-fleet \ --name MegaFrogRace.NA.v2 \ --description 'Hosts for v2 North America' \ --build-id build-2222aaaa-33bb-44cc-55dd-6666eeee77ff \ --certificate-configuration 'CertificateType=GENERATED' \ --ec2-instance-type c4.large \ --fleet-type SPOT \ --runtime-configuration 'ServerProcesses=[{LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,ConcurrentExecutions=1}]' ``` Ausgabe: ``` { "FleetAttributes": { "BuildId": "build-2222aaaa-33bb-44cc-55dd-6666eeee77ff", "CertificateConfiguration": { "CertificateType": "GENERATED" }, "CreationTime": 1496365885.44, "Description": "Hosts for v2 North America", "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetType": "SPOT", "InstanceType": "c4.large", "MetricGroups": ["default"], "Name": "MegaFrogRace.NA.v2", "NewGameSessionProtectionPolicy": "NoProtection", "OperatingSystem": "WINDOWS_2012", "ServerLaunchPath": "C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe", "Status": "NEW" } } ``` **Beispiel 3: So erstellen Sie eine vollständig konfigurierte Flotte** Im folgenden Beispiel für `create-fleet` wird eine Flotte von Windows-Spot-Instances für einen benutzerdefinierten Server-Build erstellt, wobei die am häufigsten verwendeten Konfigurationseinstellungen bereitgestellt werden. ``` aws gamelift create-fleet \ --name MegaFrogRace.NA.v2 \ --description 'Hosts for v2 North America' \ --build-id build-2222aaaa-33bb-44cc-55dd-6666eeee77ff \ --certificate-configuration 'CertificateType=GENERATED' \ --ec2-instance-type c4.large \ --ec2-inbound-permissions 'FromPort=33435,ToPort=33435,IpRange=10.24.34.0/23,Protocol=UDP' \ --fleet-type SPOT \ --new-game-session-protection-policy FullProtection \ --runtime-configuration file://runtime-config.json \ --metric-groups default \ --instance-role-arn 'arn:aws:iam::444455556666:role/GameLiftS3Access' ``` Inhalt von `runtime-config.json`: ``` GameSessionActivationTimeoutSeconds=300, MaxConcurrentGameSessionActivations=2, ServerProcesses=[ {LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,Parameters=-debug,ConcurrentExecutions=1}, {LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,ConcurrentExecutions=1}] ``` Ausgabe: ``` { "FleetAttributes": { "InstanceRoleArn": "arn:aws:iam::444455556666:role/GameLiftS3Access", "Status": "NEW", "InstanceType": "c4.large", "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "Description": "Hosts for v2 North America", "FleetType": "SPOT", "OperatingSystem": "WINDOWS_2012", "Name": "MegaFrogRace.NA.v2", "CreationTime": 1569309011.11, "MetricGroups": [ "default" ], "BuildId": "build-2222aaaa-33bb-44cc-55dd-6666eeee77ff", "ServerLaunchParameters": "abc", "ServerLaunchPath": "C:\\game\\Bin64.Release.Dedicated\\MegaFrogRace_Server.exe", "NewGameSessionProtectionPolicy": "FullProtection", "CertificateConfiguration": { "CertificateType": "GENERATED" } } } ``` **Beispiel 4: So erstellen Sie eine Realtime-Server-Flotte** Im folgenden `create-fleet` Beispiel wird eine Flotte von Spot-Instances mit einem Echtzeit-Konfigurationsskript erstellt, das auf Amazon GameLift hochgeladen wurde. Alle Realtime-Server werden auf Linux-Computern bereitgestellt. Gehen Sie für dieses Beispiel davon aus, dass das hochgeladene Realtime-Skript mehrere Skriptdateien enthält, wobei sich die `Init()`-Funktion in der Skriptdatei namens `MainScript.js` befindet. Wie gezeigt, wird diese Datei in der Laufzeitkonfiguration als Startskript identifiziert. ``` aws gamelift create-fleet \ --name MegaFrogRace.NA.realtime \ --description 'Mega Frog Race Realtime fleet' \ --script-id script-1111aaaa-22bb-33cc-44dd-5555eeee66ff \ --ec2-instance-type c4.large \ --fleet-type SPOT \ --certificate-configuration 'CertificateType=GENERATED' --runtime-configuration 'ServerProcesses=[{LaunchPath=/local/game/MainScript.js,Parameters=+map Winter444,ConcurrentExecutions=5}]' ``` Ausgabe: ``` { "FleetAttributes": { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "Status": "NEW", "CreationTime": 1569310745.212, "InstanceType": "c4.large", "NewGameSessionProtectionPolicy": "NoProtection", "CertificateConfiguration": { "CertificateType": "GENERATED" }, "Name": "MegaFrogRace.NA.realtime", "ScriptId": "script-1111aaaa-22bb-33cc-44dd-5555eeee66ff", "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetType": "SPOT", "MetricGroups": [ "default" ], "Description": "Mega Frog Race Realtime fleet", "OperatingSystem": "AMAZON_LINUX" } } ``` + Einzelheiten zur API finden Sie [CreateFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-fleet.html)in der *AWS CLI Befehlsreferenz.* ### `create-game-session-queue` Das folgende Codebeispiel zeigt die Verwendung`create-game-session-queue`. **AWS CLI** **Beispiel 1: So richten Sie eine geordnete Warteschlange für Spielsitzungen ein** Im folgenden Beispiel für `create-game-session-queue` wird eine neue Warteschlange für Spielsitzungen mit Zielen in zwei Regionen erstellt. Außerdem wird die Warteschlange so konfiguriert, dass Spielsitzungsanfragen nach 10 Minuten Wartezeit auf die Platzierung ablaufen. Da keine Latenzrichtlinien definiert sind, wird GameLift versucht, alle Spielsitzungen mit dem ersten aufgelisteten Ziel zu platzieren. ``` aws gamelift create-game-session-queue \ --name MegaFrogRaceServer-NA \ --destinations file://destinations.json \ --timeout-in-seconds 600 ``` Inhalt von `destinations.json`: ``` { "Destinations": [ {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, {"DestinationArn": "arn:aws:gamelift:us-west-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ] } ``` Ausgabe: ``` { "GameSessionQueues": [ { "Name": "MegaFrogRaceServer-NA", "GameSessionQueueArn": "arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRaceServer-NA", "TimeoutInSeconds": 600, "Destinations": [ {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"}, {"DestinationArn": "arn:aws:gamelift:us-west-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"} ] } ] } ``` **Beispiel 2: So richten Sie eine Warteschlange für Spielsitzungen mit Latenzrichtlinien für Spieler ein** Im folgenden Beispiel für `create-game-session-queue` wird eine neue Warteschlange für Spielsitzungen mit zwei Latenzrichtlinien für Spieler erstellt. Die erste Richtlinie legt eine Latenzgrenze von 100 ms fest, die während der ersten Minute eines Platzierungsversuchs für eine Spielsitzung durchgesetzt wird. Die zweite Richtlinie erhöht die Latenzgrenze auf 200 ms, bis die Platzierungsanfrage nach 3 Minuten abläuft. ``` aws gamelift create-game-session-queue \ --name MegaFrogRaceServer-NA \ --destinations file://destinations.json \ --player-latency-policies file://latency-policies.json \ --timeout-in-seconds 180 ``` Inhalt von `destinations.json`: ``` { "Destinations": [ { "DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, { "DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ] } ``` Inhalt von `latency-policies.json`: ``` { "PlayerLatencyPolicies": [ {"MaximumIndividualPlayerLatencyMilliseconds": 200}, {"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60} ] } ``` Ausgabe: ``` { "GameSessionQueue": { "Name": "MegaFrogRaceServer-NA", "GameSessionQueueArn": "arn:aws:gamelift:us-west-2:111122223333:gamesessionqueue/MegaFrogRaceServer-NA", "TimeoutInSeconds": 600, "PlayerLatencyPolicies": [ { "MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60 }, { "MaximumIndividualPlayerLatencyMilliseconds": 200 } ] "Destinations": [ {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"}, {"DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"} ], } } ``` Weitere Informationen finden Sie unter [Create a Queue](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html#queues-creating-cli) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [CreateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-game-session-queue.html)in der *AWS CLI Befehlsreferenz*. ### `delete-build` Das folgende Codebeispiel zeigt die Verwendung`delete-build`. **AWS CLI** **So löschen Sie einen benutzerdefinierten Spiele-Build** Im folgenden `delete-build` Beispiel wird ein Build aus Ihrem GameLift Amazon-Konto entfernt. Nachdem der Build gelöscht wurde, können Sie ihn nicht mehr zum Erstellen neuer Flotten verwenden. Diese Operation kann nicht rückgängig gemacht werden. ``` aws gamelift delete-build \ --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-build.html)in der *AWS CLI Befehlsreferenz*. ### `delete-fleet` Das folgende Codebeispiel zeigt die Verwendung`delete-fleet`. **AWS CLI** **So löschen Sie eine Flotte, die nicht mehr verwendet wird** Im folgenden Beispiel für `delete-fleet` wird eine Flotte entfernt, die auf null Instances herunterskaliert wurde. Wenn die Flottenkapazität größer als Null ist, schlägt die Anfrage mit einem HTTP-400-Fehler fehl. ``` aws gamelift delete-fleet \ --fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Manage GameLift Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-editing.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [DeleteFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-fleet.html)in der *AWS CLI Befehlsreferenz.* ### `delete-game-session-queue` Das folgende Codebeispiel zeigt die Verwendung`delete-game-session-queue`. **AWS CLI** **So löschen Sie eine Warteschlange für Spielsitzungen** Im folgenden Beispiel für `delete-game-session-queue` wird eine angegebene Warteschlange für Spielsitzungen gelöscht. ``` aws gamelift delete-game-session-queue \ --name MegaFrogRace-NA ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-game-session-queue.html)in der *AWS CLI Befehlsreferenz*. ### `describe-build` Das folgende Codebeispiel zeigt die Verwendung`describe-build`. **AWS CLI** **So rufen Sie Informationen zu einem benutzerdefinierten Spiele-Build ab** Im folgenden Beispiel für `describe-build` werden Eigenschaften für eine Spieleserver-Build-Ressource abgerufen. ``` aws gamelift describe-build \ --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "Build": { "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "CreationTime": 1496708916.18, "Name": "My_Game_Server_Build_One", "OperatingSystem": "AMAZON_LINUX", "SizeOnDisk": 1304924, "Status": "READY", "Version": "12345.678" } } ``` Weitere Informationen finden Sie unter [Hochladen eines benutzerdefinierten Server-Builds auf GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-builds) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [DescribeBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-build.html)in der *AWS CLI Befehlsreferenz*. ### `describe-ec2-instance-limits` Das folgende Codebeispiel zeigt die Verwendung`describe-ec2-instance-limits`. **AWS CLI** **So rufen Sie Servicelimits für einen EC2-Instance-Typ ab** Im folgenden Beispiel für `describe-ec2-instance-limits` werden die maximal zulässigen Instances und die aktuell verwendeten Instances für den angegebenen EC2-Instance-Typ in der aktuellen Region angezeigt. Das Ergebnis zeigt, dass nur fünf der zwanzig zulässigen Instances verwendet werden. ``` aws gamelift describe-ec2-instance-limits \ --ec2-instance-type m5.large ``` Ausgabe: ``` { "EC2InstanceLimits": [ { "EC2InstanceType": ""m5.large", "CurrentInstances": 5, "InstanceLimit": 20 } ] } ``` Weitere Informationen finden [Sie unter Choose Computing Resources](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie unter [DescribeEc2 InstanceLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-ec2-instance-limits.html) in der *AWS CLI Befehlsreferenz*. ### `describe-fleet-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-attributes`. **AWS CLI** **Beispiel 1: So zeigen Sie Attribute für eine Liste von Flotten an** Im folgenden Beispiel für `describe-fleet-attributes` werden Flottenattribute für zwei angegebene Flotten abgerufen. Wie gezeigt, werden die angeforderten Flotten mit demselben Build bereitgestellt, eine für On-Demand-Instances und eine für Spot Instances, mit einigen geringfügigen Konfigurationsunterschieden. ``` aws gamelift describe-fleet-attributes \ --fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 ``` Ausgabe: ``` { "FleetAttributes": [ { "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "FleetType": "ON_DEMAND", "InstanceType": "c4.large", "Description": "On-demand hosts for v2 North America", "Name": "MegaFrogRaceServer.NA.v2-od", "CreationTime": 1568836191.995, "Status": "ACTIVE", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ServerLaunchPath": "C:\\game\\MegaFrogRace_Server.exe", "ServerLaunchParameters": "+gamelift_start_server", "NewGameSessionProtectionPolicy": "NoProtection", "OperatingSystem": "WINDOWS_2012", "MetricGroups": [ "default" ], "CertificateConfiguration": { "CertificateType": "DISABLED" } }, { "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "FleetType": "SPOT", "InstanceType": "c4.large", "Description": "On-demand hosts for v2 North America", "Name": "MegaFrogRaceServer.NA.v2-spot", "CreationTime": 1568838275.379, "Status": "ACTIVATING", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ServerLaunchPath": "C:\\game\\MegaFrogRace_Server.exe", "NewGameSessionProtectionPolicy": "NoProtection", "OperatingSystem": "WINDOWS_2012", "MetricGroups": [ "default" ], "CertificateConfiguration": { "CertificateType": "GENERATED" } } ] } ``` **Beispiel 2: So fordern Sie Attribute für alle Flotten an** Im folgenden Beispiel für `describe-fleet-attributes` werden Flottenattribute für alle Flotten mit beliebigem Status zurückgegeben. Dieses Beispiel veranschaulicht die Verwendung von Paginierungsparametern, um jeweils eine Flotte zurückzugeben. ``` aws gamelift describe-fleet-attributes \ --limit 1 ``` Ausgabe: ``` { "FleetAttributes": [ { "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "FleetType": "SPOT", "InstanceType": "c4.large", "Description": "On-demand hosts for v2 North America", "Name": "MegaFrogRaceServer.NA.v2-spot", "CreationTime": 1568838275.379, "Status": "ACTIVATING", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ServerLaunchPath": "C:\\game\\MegaFrogRace_Server.exe", "NewGameSessionProtectionPolicy": "NoProtection", "OperatingSystem": "WINDOWS_2012", "MetricGroups": [ "default" ], "CertificateConfiguration": { "CertificateType": "GENERATED" } } ], "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2" } ``` Die Ausgabe enthält einen `NextToken`-Wert, den Sie verwenden können, wenn Sie den Befehl ein zweites Mal aufrufen. Übergeben Sie den Wert an den `--next-token`-Parameter, um anzugeben, wo die Ausgabe abgerufen werden soll. Mit dem folgenden Befehl wird das zweite Ergebnis in der Ausgabe zurückgegeben. ``` aws gamelift describe-fleet-attributes \ --limit 1 \ --next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE1 ``` Wiederholen Sie den Vorgang, bis die Antwort keinen `NextToken`-Wert umfasst. Weitere Informationen finden Sie unter [Setting Up GameLift Flotten](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [DescribeFleetAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-attributes.html)in der *AWS CLI Befehlsreferenz.* ### `describe-fleet-capacity` Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-capacity`. **AWS CLI** **So zeigen Sie den Kapazitätsstatus für eine Liste von Flotten an** Im folgenden Beispiel für `describe-fleet-capacity` wird die aktuelle Kapazität für zwei angegebene Flotten abgerufen. ``` aws gamelift describe-fleet-capacity \ --fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 ``` Ausgabe: ``` { "FleetCapacity": [ { "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "InstanceType": "c5.large", "InstanceCounts": { "DESIRED": 10, "MINIMUM": 1, "MAXIMUM": 20, "PENDING": 0, "ACTIVE": 10, "IDLE": 3, "TERMINATING": 0 } }, { "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "InstanceType": "c5.large", "InstanceCounts": { "DESIRED": 13, "MINIMUM": 1, "MAXIMUM": 20, "PENDING": 0, "ACTIVE": 15, "IDLE": 2, "TERMINATING": 2 } } ] } ``` Weitere Informationen finden Sie unter [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [DescribeFleetCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-capacity.html)in der *AWS CLI Befehlsreferenz.* ### `describe-fleet-events` Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-events`. **AWS CLI** **So fordern Sie Ereignisse für einen bestimmten Zeitraum an** Im folgenden `describe-fleet-events` Beispiel werden Details zu allen flottenbezogenen Ereignissen angezeigt, die während des angegebenen Zeitraums aufgetreten sind. ``` aws gamelift describe-fleet-events \ --fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --start-time 1579647600 \ --end-time 1579649400 \ --limit 5 ``` Ausgabe: ``` { "Events": [ { "EventId": "a37b6892-5d07-4d3b-8b47-80244ecf66b9", "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "EventCode": "FLEET_STATE_ACTIVE", "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to ACTIVE", "EventTime": 1579649342.191 }, { "EventId": "67da4ec9-92a3-4d95-886a-5d6772c24063", "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "EventCode": "FLEET_STATE_ACTIVATING", "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to ACTIVATING", "EventTime": 1579649321.427 }, { "EventId": "23813a46-a9e6-4a53-8847-f12e6a8381ac", "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "EventCode": "FLEET_STATE_BUILDING", "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to BUILDING", "EventTime": 1579649321.243 }, { "EventId": "3bf217d0-1d44-42f9-9202-433ed475d2e8", "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "EventCode": "FLEET_STATE_VALIDATING", "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to VALIDATING", "EventTime": 1579649197.449 }, { "EventId": "2ecd0130-5986-44eb-99a7-62df27741084", "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "EventCode": "FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND", "Message": "Failed to find a valid path", "EventTime": 1569319075.839, "PreSignedLogUrl": "https://gamelift-event-logs-prod-us-west-2.s3.us-west-2.amazonaws.com/logs/fleet-83422059-8329-42a2-a4d6-c4444386a6f8/events/2ecd0130-5986-44eb-99a7-62df27741084/FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND.txt?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEB8aCXVzLXdlc3QtMiJHMEUCIHV5K%2FLPx8h310D%2FAvx0%2FZxsDy5XA3cJOwPdu3T0eBa%2FAiEA1yovokcZYy%2FV4CWW6l26aFyiSHO%2Bxz%2FBMAhEHYHMQNcqkQMImP%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAAGgw3NDEwNjE1OTIxNzEiDI8rsZtzLzlwEDQhXSrlAtl5Ae%2Fgo6FCIzqXPbXfBOnSvFYqeDlriZarEpKqKrUt8mXQv9iqHResqCph9AKo49lwgSYTT2QoSxnrD7%2FUgv%2BZm2pVuczvuKtUA0fcx6s0GxpjIAzdIE%2F5P%2FB7B9M%2BVZ%2F9KF82hbJi0HTE6Y7BjKsEgFCvk4UXILhfjtan9iQl8%2F21ZTurAcJbm7Y5tuLF9SWSK3%2BEa7VXOcCK4D4O1sMjmdRm0q0CKZ%2FIaXoHkNvg0RVTa0hIqdvpaDQlsSBNdqTXbjHTu6fETE9Y9Ky%2BiJK5KiUG%2F59GjCpDcvS1FqKeLUEmKT7wysGmvjMc2n%2Fr%2F9VxQfte7w9srXwlLAQuwhiXAAyI5ICMZ5JvzjzQwTqD4CHTVKUUDwL%2BRZzbuuqkJObZml02CkRGp%2B74RTAzLbWptVqZTIfzctiCTmWxb%2FmKyELRYsVLrwNJ%2BGJ7%2BCrN0RC%2FjlgfLYIZyeAqjPgAu5HjgX%2BM7jCo9M7wBTrnAXKOFQuf9dvA84SuwXOJFp17LYGjrHMKv0qC3GfbTMrZ6kzeNV9awKCpXB2Gnx9z2KvIlJdqirWVpvHVGwKCmJBCesDzjJHrae3neogI1uW%2F9C6%2B4jIZPME3jXmZcEHqqw5uvAVF7aeIavtUZU8pxpDIWT0YE4p3Kriy2AA7ziCRKtVfjV839InyLk8LUjsioWK2qlpg2HXKFLpAXw1QsQyxYmFMB9sGKOUlbL7Jdkk%2BYUq8%2FDTlLxqj1S%2FiO4TI0Wo7ilAo%2FKKWWF4guuNDexj8EOOynSp1yImB%2BZf2Fua3O44W4eEXAMPLE33333&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20170621T231808Z&X-Amz-SignedHeaders=host&X-Amz-Expires=900&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20170621%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" } ], "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2" } ``` Weitere Informationen finden Sie unter [Debug GameLift Fleet Issues](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [DescribeFleetEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-events.html)in der *AWS CLI Befehlsreferenz.* ### `describe-fleet-port-settings` Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-port-settings`. **AWS CLI** **So zeigen Sie eingehende Verbindungsberechtigungen für eine Flotte an** Im folgenden Beispiel für `describe-fleet-port-settings` werden Verbindungseinstellungen für eine angegebene Flotte abgerufen. ``` aws gamelift describe-fleet-port-settings \ --fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "InboundPermissions": [ { "FromPort": 33400, "ToPort": 33500, "IpRange": "0.0.0.0/0", "Protocol": "UDP" }, { "FromPort": 1900, "ToPort": 2000, "IpRange": "0.0.0.0/0", "Protocol": "TCP" } ] } ``` Weitere Informationen finden Sie unter [Setting Up GameLift Flotten](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [DescribeFleetPortSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-port-settings.html)in der *AWS CLI Befehlsreferenz.* ### `describe-fleet-utilization` Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-utilization`. **AWS CLI** **Beispiel 1: So zeigen Sie Nutzungsdaten für eine Liste von Flotten an** Im folgenden Beispiel für `describe-fleet-utilization` werden aktuelle Nutzungsinformationen für eine angegebene Flotte abgerufen. ``` aws gamelift describe-fleet-utilization \ --fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "FleetUtilization": [ { "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "ActiveServerProcessCount": 100, "ActiveGameSessionCount": 62, "CurrentPlayerSessionCount": 329, "MaximumPlayerSessionCount": 1000 } ] } ``` **Beispiel 2: So fordern Sie Nutzungsdaten für alle Flotten an** Im folgenden Beispiel für `describe-fleet-utilization` werden Flottennutzungsdaten für alle Flotten mit beliebigem Status zurückgegeben. In diesem Beispiel werden Paginierungsparameter verwendet, um jeweils Daten für zwei Flotten zurückzugeben. ``` aws gamelift describe-fleet-utilization \ --limit 2 ``` Ausgabe: ``` { "FleetUtilization": [ { "FleetId": "fleet-1111aaaa-22bb-33cc-44dd-5555eeee66ff", "ActiveServerProcessCount": 100, "ActiveGameSessionCount": 13, "CurrentPlayerSessionCount": 98, "MaximumPlayerSessionCount": 1000 }, { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "ActiveServerProcessCount": 100, "ActiveGameSessionCount": 62, "CurrentPlayerSessionCount": 329, "MaximumPlayerSessionCount": 1000 } ], "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2" } ``` Rufen Sie den Befehl ein zweites Mal auf und übergeben Sie den `NextToken`-Wert als Argument an den `--next-token`-Parameter, um die nächsten beiden Ergebnisse anzuzeigen. ``` aws gamelift describe-fleet-utilization \ --limit 2 \ --next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2 ``` Wiederholen Sie den Vorgang, bis die Antwort keinen `NextToken`-Wert mehr in der Ausgabe enthält. Weitere Informationen finden Sie unter [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [DescribeFleetUtilization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-utilization.html)in der *AWS CLI Befehlsreferenz.* ### `describe-game-session-queues` Das folgende Codebeispiel zeigt die Verwendung`describe-game-session-queues`. **AWS CLI** **So zeigen Sie Warteschlangen für Spielsitzungen an** Im folgenden Beispiel für `describe-game-session-queues` werden Eigenschaften für zwei angegebene Warteschlangen abgerufen. ``` aws gamelift describe-game-session-queues \ --names MegaFrogRace-NA MegaFrogRace-EU ``` Ausgabe: ``` { "GameSessionQueues": [{ "Destinations": [{ "DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, { "DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ], "Name": "MegaFrogRace-NA", "TimeoutInSeconds": 600, "GameSessionQueueArn": "arn:aws:gamelift:us-west-2::gamesessionqueue/MegaFrogRace-NA", "PlayerLatencyPolicies": [{ "MaximumIndividualPlayerLatencyMilliseconds": 200 }, { "MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60 } ], "FilterConfiguration": { "AllowedLocations": ["us-west-2", "ap-south-1", "us-east-1"] }, "PriorityConfiguration": { "PriorityOrder": ["LOCATION", "FLEET_TYPE", "DESTINATION"], "LocationOrder": ["us-west-2", "ap-south-1", "us-east-1"] } }, { "Destinations": [{ "DestinationArn": "arn:aws:gamelift:eu-west-3::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" }], "Name": "MegaFrogRace-EU", "TimeoutInSeconds": 600, "GameSessionQueueArn": "arn:aws:gamelift:us-west-2::gamesessionqueue/MegaFrogRace-EU" } ] } ``` Weitere Informationen finden Sie unter [Using Multi-Region-Warteschlangen](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [DescribeGameSessionQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-game-session-queues.html)in der *AWS CLI Befehlsreferenz*. ### `describe-runtime-configuration` Das folgende Codebeispiel zeigt die Verwendung`describe-runtime-configuration`. **AWS CLI** **So fordern Sie die Laufzeitkonfiguration für eine Flotte ab** Im folgenden Beispiel für `describe-runtime-configuration` werden Details zur aktuellen Laufzeitkonfiguration für eine angegebene Flotte abgerufen. ``` aws gamelift describe-runtime-configuration \ --fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "RuntimeConfiguration": { "ServerProcesses": [ { "LaunchPath": "C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe", "Parameters": "+gamelift_start_server", "ConcurrentExecutions": 3 }, { "LaunchPath": "C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe", "Parameters": "+gamelift_start_server +debug", "ConcurrentExecutions": 1 } ], "MaxConcurrentGameSessionActivations": 2147483647, "GameSessionActivationTimeoutSeconds": 300 } } ``` Weitere Informationen finden Sie unter [Ausführen mehrerer Prozesse auf einer Flotte](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [DescribeRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-runtime-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `list-builds` Das folgende Codebeispiel zeigt die Verwendung`list-builds`. **AWS CLI** **Beispiel 1: So rufen Sie eine Liste benutzerdefinierter Spiele-Builds ab** Im folgenden Beispiel für `list-builds` werden Eigenschaften für alle Spieleserver-Builds in der aktuellen Region abgerufen. Die Beispielanfrage veranschaulicht, wie die Paginierungsparameter `Limit` und `NextToken` verwendet werden, um die Ergebnisse in sequentiellen Sätzen abzurufen. Mit dem ersten Befehl werden die ersten beiden Builds abgerufen. Da mehr als zwei verfügbar sind, enthält die Antwort ein `NextToken`, um anzuzeigen, dass mehr Ergebnisse verfügbar sind. ``` aws gamelift list-builds \ --limit 2 ``` Ausgabe: ``` { "Builds": [ { "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "CreationTime": 1495664528.723, "Name": "My_Game_Server_Build_One", "OperatingSystem": "WINDOWS_2012", "SizeOnDisk": 8567781, "Status": "READY", "Version": "12345.678" }, { "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "CreationTime": 1495528748.555, "Name": "My_Game_Server_Build_Two", "OperatingSystem": "AMAZON_LINUX_2", "SizeOnDisk": 8567781, "Status": "FAILED", "Version": "23456.789" } ], "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=" } ``` Anschließend kann der Befehl mit dem `--next-token`-Parameter wie folgt erneut aufgerufen werden, um die nächsten beiden Builds anzuzeigen. ``` aws gamelift list-builds \ --limit 2 --next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE= ``` Wiederholen Sie den Vorgang, bis die Antwort keinen `NextToken`-Wert umfasst. **Beispiel 2: So rufen Sie eine Liste benutzerdefinierter Spiele-Builds im Fehlerstatus ab** Im folgenden Beispiel für `list-builds` werden Eigenschaften für alle Spieleserver-Builds in der aktuellen Region abgerufen, die derzeit den Status FAILED aufweisen. ``` aws gamelift list-builds \ --status FAILED ``` Ausgabe: ``` { "Builds": [ { "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "CreationTime": 1495528748.555, "Name": "My_Game_Server_Build_Two", "OperatingSystem": "AMAZON_LINUX_2", "SizeOnDisk": 8567781, "Status": "FAILED", "Version": "23456.789" } ] } ``` + Einzelheiten zur API finden Sie [ListBuilds](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-builds.html)in der *AWS CLI Befehlsreferenz*. ### `list-fleets` Das folgende Codebeispiel zeigt die Verwendung`list-fleets`. **AWS CLI** **Beispiel 1: So rufen Sie eine Liste aller Flotten in einer Region ab** Das folgende `list-fleets` Beispiel zeigt die Flotte IDs aller Flotten in der aktuellen Region. In diesem Beispiel werden Paginierungsparameter verwendet, um zwei Flotten IDs gleichzeitig abzurufen. Die Antwort umfasst ein `next-token`-Attribut, das angibt, dass weitere Ergebnisse abgerufen werden können. ``` aws gamelift list-fleets \ --limit 2 ``` Ausgabe: ``` { "FleetIds": [ "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" ], "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=" } ``` Sie können den `NextToken`-Wert aus der vorherigen Antwort im nächsten Befehl übergeben, wie hier gezeigt, um die nächsten beiden Ergebnisse abzurufen. ``` aws gamelift list-fleets \ --limit 2 \ --next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC00NDRlZjQxZS1hM2I1LTQ2NDYtODJmMy0zYzI4ZTgxNjVjEXAMPLE= ``` **Beispiel 2: So rufen Sie eine Liste aller Flotten in einer Region mit einem bestimmten Build oder Skript ab** Im folgenden `list-builds` Beispiel werden die IDs Flotten abgerufen, die mit dem angegebenen Spiel-Build bereitgestellt wurden. Wenn Sie mit Realtime-Servern arbeiten, können Sie anstelle einer Build-ID eine Skript-ID angeben. Da in diesem Beispiel der Grenzparameter nicht angegeben ist, können die Ergebnisse bis zu 16 Flotten umfassen. IDs ``` aws gamelift list-fleets \ --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "FleetIds": [ "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE44444" ] } ``` + Einzelheiten zur API finden Sie [ListFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-fleets.html)unter *AWS CLI Befehlsreferenz*. ### `request-upload-credentials` Das folgende Codebeispiel zeigt die Verwendung`request-upload-credentials`. **AWS CLI** **So aktualisieren Sie Anmeldeinformationen für das Hochladen eines Builds** Im folgenden `create-build` Beispiel werden neue, gültige Zugangsdaten für das Hochladen einer GameLift Build-Datei an einen Amazon S3 S3-Speicherort abgerufen. Anmeldeinformationen haben eine begrenzte Nutzungsdauer. Sie erhalten die Build-ID aus der Antwort auf die ursprüngliche `CreateBuild`-Anfrage. ``` aws gamelift request-upload-credentials \ --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "StorageLocation": { "Bucket": "gamelift-builds-us-west-2", "Key": "123456789012/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }, "UploadCredentials": { "AccessKeyId": "AKIAIOSFODNN7EXAMPLE", "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "SessionToken": "AgoGb3JpZ2luENz...EXAMPLETOKEN==" } } ``` Weitere Informationen finden Sie unter [Hochladen eines benutzerdefinierten Server-Builds auf GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [RequestUploadCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/request-upload-credentials.html)in der *AWS CLI Befehlsreferenz*. ### `start-fleet-actions` Das folgende Codebeispiel zeigt die Verwendung`start-fleet-actions`. **AWS CLI** **So starten Sie die Aktivität zur automatischen Skalierung der Flotte neu** Im folgenden `start-fleet-actions` Beispiel werden alle Skalierungsrichtlinien wieder verwendet, die für die angegebene Flotte definiert sind, aber durch den Aufruf stop-fleet-actions von ```` gestoppt wurden. Nach dem Start beginnen die Skalierungsrichtlinien sofort mit der Erfassung ihrer jeweiligen Metriken. ``` aws gamelift start-fleet-actions \ --fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --actions AUTO_SCALING ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [StartFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/start-fleet-actions.html)AWS CLI * ### `stop-fleet-actions` Das folgende Codebeispiel zeigt die Verwendung`stop-fleet-actions`. **AWS CLI** **So stoppen Sie die Aktivität zur automatischen Skalierung einer Flotte** Im folgenden Beispiel für `stop-fleet-actions` wird die Verwendung aller Skalierungsrichtlinien gestoppt, die für die angegebene Flotte definiert sind. Nachdem die Richtlinien ausgesetzt wurden, bleibt die Flottenkapazität auf der aktuellen Anzahl aktiver Instances bestehen, sofern sie nicht manuell angepasst wird. ``` aws gamelift start-fleet-actions \ --fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --actions AUTO_SCALING ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [StopFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/stop-fleet-actions.html)in der *AWS CLI Befehlsreferenz*. ### `update-build` Das folgende Codebeispiel zeigt die Verwendung`update-build`. **AWS CLI** **So aktualisieren Sie einen benutzerdefinierten Spiele-Build** Im folgenden Beispiel für `update-build` werden der Name und die Versionsinformationen geändert, die einer angegebenen Build-Ressource zugeordnet sind. Das zurückgegebene Build-Objekt bestätigt, dass die Änderungen erfolgreich vorgenommen wurden. ``` aws gamelift update-build \ --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --name MegaFrogRaceServer.NA.east \ --build-version 12345.east ``` Ausgabe: ``` { "Build": { "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "CreationTime": 1496708916.18, "Name": "MegaFrogRaceServer.NA.east", "OperatingSystem": "AMAZON_LINUX_2", "SizeOnDisk": 1304924, "Status": "READY", "Version": "12345.east" } } ``` Weitere Informationen finden Sie unter [Aktualisieren Ihrer Build-Dateien](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-update-build-files) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [UpdateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-build.html)in der *AWS CLI Befehlsreferenz*. ### `update-game-session-queue` Das folgende Codebeispiel zeigt die Verwendung`update-game-session-queue`. **AWS CLI** **So aktualisieren Sie die Konfiguration einer Warteschlange für Spielsitzungen** Im folgenden Beispiel für `update-game-session-queue` wird ein neues Ziel hinzugefügt und die Spielerlatenz-Richtlinien werden für eine bestehende Spielsitzungswarteschlange aktualisiert. ``` aws gamelift update-game-session-queue \ --name MegaFrogRace-NA \ --destinations file://destinations.json \ --player-latency-policies file://latency-policies.json ``` Inhalt von `destinations.json`: ``` { "Destinations": [ {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"}, {"DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-5c6d3c4d-5e6f-7a8b-9c0d-1e2f3a4b5a2b"}, {"DestinationArn": "arn:aws:gamelift:us-east-1::alias/alias-11aa22bb-3c4d-5e6f-000a-1111aaaa22bb"} ] } ``` Inhalt von `latency-policies.json`: ``` { "PlayerLatencyPolicies": [ {"MaximumIndividualPlayerLatencyMilliseconds": 200}, {"MaximumIndividualPlayerLatencyMilliseconds": 150, "PolicyDurationSeconds": 120}, {"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 120} ] } ``` Ausgabe: ``` { "GameSessionQueue": { "Destinations": [ {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"}, {"DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-5c6d3c4d-5e6f-7a8b-9c0d-1e2f3a4b5a2b"}, {"DestinationArn": "arn:aws:gamelift:us-east-1::alias/alias-11aa22bb-3c4d-5e6f-000a-1111aaaa22bb"} ], "GameSessionQueueArn": "arn:aws:gamelift:us-west-2:111122223333:gamesessionqueue/MegaFrogRace-NA", "Name": "MegaFrogRace-NA", "TimeoutInSeconds": 600, "PlayerLatencyPolicies": [ {"MaximumIndividualPlayerLatencyMilliseconds": 200}, {"MaximumIndividualPlayerLatencyMilliseconds": 150, "PolicyDurationSeconds": 120}, {"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 120} ] } } ``` Weitere Informationen finden Sie unter [Using Multi-Region-Warteschlangen](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [UpdateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-game-session-queue.html)in der *AWS CLI Befehlsreferenz*. ### `upload-build` Das folgende Codebeispiel zeigt die Verwendung`upload-build`. **AWS CLI** **Beispiel 1: So laden Sie einen Linux-Spieleserver-Build hoch** Das folgende `upload-build` Beispiel lädt Build-Dateien für Linux-Gameserver aus einem Dateiverzeichnis in den GameLift Dienst hoch und erstellt eine Build-Ressource. ``` aws gamelift upload-build \ --name MegaFrogRaceServer.NA \ --build-version 2.0.1 \ --build-root ~/MegaFrogRace_Server/release-na \ --operating-system AMAZON_LINUX_2 --server-sdk-version 4.0.2 ``` Ausgabe: ``` Uploading ~/MegaFrogRace_Server/release-na: 16.0 KiB / 74.6 KiB (21.45%) Uploading ~/MegaFrogRace_Server/release-na: 32.0 KiB / 74.6 KiB (42.89%) Uploading ~/MegaFrogRace_Server/release-na: 48.0 KiB / 74.6 KiB (64.34%) Uploading ~/MegaFrogRace_Server/release-na: 64.0 KiB / 74.6 KiB (85.79%) Uploading ~/MegaFrogRace_Server/release-na: 74.6 KiB / 74.6 KiB (100.00%) Successfully uploaded ~/MegaFrogRace_Server/release-na to AWS GameLift Build ID: build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` **Beispiel 2: So laden Sie einen Windows-Spieleserver-Build hoch** Im folgenden `upload-build` Beispiel werden Build-Dateien für Windows-Gameserver aus einem Verzeichnis in den GameLift Dienst hochgeladen und ein Build-Datensatz erstellt. ``` aws gamelift upload-build \ --name MegaFrogRaceServer.NA \ --build-version 2.0.1 \ --build-root C:\MegaFrogRace_Server\release-na \ --operating-system WINDOWS_2012 --server-sdk-version 4.0.2 ``` Ausgabe: ``` Uploading C:\MegaFrogRace_Server\release-na: 16.0 KiB / 74.6 KiB (21.45%) Uploading C:\MegaFrogRace_Server\release-na: 32.0 KiB / 74.6 KiB (42.89%) Uploading C:\MegaFrogRace_Server\release-na: 48.0 KiB / 74.6 KiB (64.34%) Uploading C:\MegaFrogRace_Server\release-na: 64.0 KiB / 74.6 KiB (85.79%) Uploading C:\MegaFrogRace_Server\release-na: 74.6 KiB / 74.6 KiB (100.00%) Successfully uploaded C:\MegaFrogRace_Server\release-na to AWS GameLift Build ID: build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Weitere Informationen finden Sie unter [Hochladen eines benutzerdefinierten Server-Builds auf GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) im *Amazon GameLift Developer Guide*. + Einzelheiten zur API finden Sie [UploadBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html)in der *AWS CLI Befehlsreferenz*. # Amazon Glacier-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Glacier Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `abort-multipart-upload` Das folgende Codebeispiel zeigt, wie Sie`abort-multipart-upload`. **AWS CLI** Mit dem folgenden Befehl wird ein laufender mehrteiliger Upload in einen Tresor namens `my-vault` gelöscht: ``` aws glacier abort-multipart-upload --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ ``` Dieser Befehl erzeugt keine Ausgabe. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Die Upload-ID wird vom Befehl `aws glacier initiate-multipart-upload` zurückgegeben und kann auch mithilfe von `aws glacier list-multipart-uploads` abgerufen werden. Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AbortMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-multipart-upload.html)in der *AWS CLI Befehlsreferenz*. ### `abort-vault-lock` Das folgende Codebeispiel zeigt die Verwendung`abort-vault-lock`. **AWS CLI** **So brechen Sie einen laufenden Tresorverriegelungsprozess ab** Im folgenden Beispiel für `abort-vault-lock` wird eine Tresorverriegelungsrichtlinie aus dem angegebenen Tresor gelöscht und der Sperrstatus der Tresorverriegelung auf „Unlocked“ zurückgesetzt. ``` aws glacier abort-vault-lock \ --account-id - \ --vault-name MyVaultName ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Abbrechen der Tresorverriegelung (DELETE lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-AbortVaultLock.html) im *Entwicklerhandbuch für die Amazon-Glacier-API*. + Einzelheiten zur API finden Sie [AbortVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-vault-lock.html)in der *AWS CLI Befehlsreferenz*. ### `add-tags-to-vault` Das folgende Codebeispiel zeigt die Verwendung`add-tags-to-vault`. **AWS CLI** Der folgende Befehl fügt zwei Tags zu einem Tresor mit dem Namen `my-vault` hinzu: ``` aws glacier add-tags-to-vault --account-id - --vault-name my-vault --tags id=1234,date=july2015 ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [AddTagsToVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/add-tags-to-vault.html)in der *AWS CLI Befehlsreferenz*. ### `complete-multipart-upload` Das folgende Codebeispiel zeigt die Verwendung`complete-multipart-upload`. **AWS CLI** Mit dem folgenden Befehl wird ein mehrteiliger Upload für ein 3-MiB-Archiv abgeschlossen: ``` aws glacier complete-multipart-upload --archive-size 3145728 --checksum 9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67 --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ --account-id - --vault-name my-vault ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Die Upload-ID wird vom Befehl `aws glacier initiate-multipart-upload` zurückgegeben und kann auch mithilfe von `aws glacier list-multipart-uploads` abgerufen werden. Der Checksum-Parameter verwendet einen SHA-256-Struktur-Hash des Archivs im Hexadezimalformat. Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI, einschließlich Anweisungen zur Berechnung eines Tree-Hashs, finden Sie unter Using Amazon Glacier im *AWS CLI-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CompleteMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-multipart-upload.html)in der *AWS CLI Befehlsreferenz*. ### `complete-vault-lock` Das folgende Codebeispiel zeigt die Verwendung`complete-vault-lock`. **AWS CLI** **So schließen Sie einen laufenden Tresorverriegelungsprozess ab** Im folgenden Beispiel für `complete-vault-lock` wird der laufende Verriegelungsprozess für den angegebenen Tresor abgeschlossen und der Sperrstatus der Tresorverriegelung auf `Locked` festgelegt. Sie erhalten den Wert für den `lock-id`-Parameter, wenn Sie `initiate-lock-process` ausführen. ``` aws glacier complete-vault-lock \ --account-id - \ --vault-name MyVaultName \ --lock-id 9QZgEXAMPLEPhvL6xEXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Abschließen der Tresorverriegelung (POST lockId)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-CompleteVaultLock.html) im *Entwicklerhandbuch für die Amazon-Glacier-API*. + Einzelheiten zur API finden Sie [CompleteVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-vault-lock.html)in der *AWS CLI Befehlsreferenz*. ### `create-vault` Das folgende Codebeispiel zeigt die Verwendung`create-vault`. **AWS CLI** Der folgende Befehl erstellt einen neuen Tresor mit dem Namen `my-vault`: ``` aws glacier create-vault --vault-name my-vault --account-id - ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [CreateVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/create-vault.html)in der *AWS CLI Befehlsreferenz*. ### `delete-archive` Das folgende Codebeispiel zeigt die Verwendung`delete-archive`. **AWS CLI** **So löschen Sie ein Archiv aus einem Tresor** Im folgenden Beispiel für `delete-archive` wird das angegebene Archiv aus `example_vault` entfernt. ``` aws glacier delete-archive \ --account-id 111122223333 \ --vault-name example_vault \ --archive-id Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-archive.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vault-access-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-vault-access-policy`. **AWS CLI** **So entfernen Sie die Zugriffsrichtlinie eines Tresors** Im folgenden Beispiel für `delete-vault-access-policy` wird die Zugriffsrichtlinie für den angegebenen Tresor entfernt. ``` aws glacier delete-vault-access-policy \ --account-id 111122223333 \ --vault-name example_vault ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-access-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vault-notifications` Das folgende Codebeispiel zeigt die Verwendung`delete-vault-notifications`. **AWS CLI** **So entfernen Sie die SNS-Benachrichtigungen für einen Tresor** Im folgenden Beispiel für `delete-vault-notifications` werden Benachrichtigungen, die von Amazon Simple Notification Service (Amazon SNS) gesendet wurden, für den angegebenen Tresor entfernt. ``` aws glacier delete-vault-notifications \ --account-id 111122223333 \ --vault-name example_vault ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-notifications.html)in der *AWS CLI Befehlsreferenz*. ### `delete-vault` Das folgende Codebeispiel zeigt die Verwendung`delete-vault`. **AWS CLI** Der folgende Befehl löscht einen Tresor mit dem Namen `my-vault`: ``` aws glacier delete-vault --vault-name my-vault --account-id - ``` Dieser Befehl erzeugt keine Ausgabe. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [DeleteVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault.html)in der *AWS CLI Befehlsreferenz*. ### `describe-job` Das folgende Codebeispiel zeigt die Verwendung`describe-job`. **AWS CLI** Der folgende Befehl ruft Informationen über einen Auftrag zum Abrufen von Inventar in einem Tresor mit dem Namen `my-vault` ab: ``` aws glacier describe-job --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW ``` Ausgabe: ``` { "InventoryRetrievalParameters": { "Format": "JSON" }, "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "Completed": false, "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "Action": "InventoryRetrieval", "CreationDate": "2015-07-17T20:23:41.616Z", "StatusCode": "InProgress" } ``` Die Auftrags-ID finden Sie in der Ausgabe von `aws glacier initiate-job` und `aws glacier list-jobs`. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-vault` Das folgende Codebeispiel zeigt die Verwendung`describe-vault`. **AWS CLI** Der folgende Befehl ruft Daten über einen Tresor mit dem Namen `my-vault` ab: ``` aws glacier describe-vault --vault-name my-vault --account-id - ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [DescribeVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-vault.html)in der *AWS CLI Befehlsreferenz*. ### `get-data-retrieval-policy` Das folgende Codebeispiel zeigt die Verwendung`get-data-retrieval-policy`. **AWS CLI** Mit dem folgenden Befehl wird die Datenabrufrichtlinie für das verwendete Konto abgerufen: ``` aws glacier get-data-retrieval-policy --account-id - ``` Ausgabe: ``` { "Policy": { "Rules": [ { "BytesPerHour": 10737418240, "Strategy": "BytesPerHour" } ] } } ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [GetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-data-retrieval-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-job-output` Das folgende Codebeispiel zeigt die Verwendung`get-job-output`. **AWS CLI** Der folgende Befehl speichert die Ausgabe eines Tresor-Inventarauftrags in einer Datei im aktuellen Verzeichnis mit dem Namen `output.json`: ``` aws glacier get-job-output --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json ``` Die `job-id` ist in der Ausgabe von `aws glacier list-jobs` verfügbar. Beachten Sie, dass der Name der Ausgabedatei ein Positionsargument ist, dem kein Optionsname vorangestellt ist. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Ausgabe: ``` { "status": 200, "acceptRanges": "bytes", "contentType": "application/json" } ``` `output.json`: ``` {"VaultARN":"arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault","InventoryDate":"2015-04-07T00:26:18Z","ArchiveList":[{"ArchiveId":"kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw","ArchiveDescription":"multipart upload test","CreationDate":"2015-04-06T22:24:34Z","Size":3145728,"SHA256TreeHash":"9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67"}]} ``` + Einzelheiten zur API finden Sie [GetJobOutput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-job-output.html)in der *AWS CLI Befehlsreferenz*. ### `get-vault-access-policy` Das folgende Codebeispiel zeigt die Verwendung`get-vault-access-policy`. **AWS CLI** **So rufen Sie die Zugriffsrichtlinie eines Tresors ab** Im folgenden Beispiel für `get-vault-access-policy` wird die Zugriffsrichtlinie für den angegebenen Tresor abgerufen. ``` aws glacier get-vault-access-policy \ --account-id 111122223333 \ --vault-name example_vault ``` Ausgabe: ``` { "policy": { "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}" } } ``` + Einzelheiten zur API finden Sie [GetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-access-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-vault-lock` Das folgende Codebeispiel zeigt die Verwendung`get-vault-lock`. **AWS CLI** **So rufen Sie die Details einer Tresorverriegelung ab** Im folgenden Beispiel für `get-vault-lock` werden die Details zur Verriegelung für den angegebenen Tresor abgerufen. ``` aws glacier get-vault-lock \ --account-id - \ --vault-name MyVaultName ``` Ausgabe: ``` { "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:99999999999:vaults/MyVaultName\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}", "State": "Locked", "CreationDate": "2019-07-29T22:25:28.640Z" } ``` Weitere Informationen finden Sie unter [Abrufen der Tresorverriegelung (GET lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-GetVaultLock.html) im *Entwicklerhandbuch für die Amazon-Glacier-API*. + Einzelheiten zur API finden Sie [GetVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-lock.html)in der *AWS CLI Befehlsreferenz*. ### `get-vault-notifications` Das folgende Codebeispiel zeigt die Verwendung`get-vault-notifications`. **AWS CLI** Der folgende Befehl ruft eine Beschreibung der Benachrichtigungskonfiguration für einen Tresor mit dem Namen `my-vault` ab: ``` aws glacier get-vault-notifications --account-id - --vault-name my-vault ``` Ausgabe: ``` { "vaultNotificationConfig": { "Events": [ "InventoryRetrievalCompleted", "ArchiveRetrievalCompleted" ], "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault" } } ``` Wenn keine Benachrichtigungen für den Tresor konfiguriert wurden, wird ein Fehler zurückgegeben. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [GetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-notifications.html)in der *AWS CLI Befehlsreferenz*. ### `initiate-job` Das folgende Codebeispiel zeigt die Verwendung`initiate-job`. **AWS CLI** Mit dem folgenden Befehl wird ein Auftrag zum Abrufen eines Bestands des Tresors `my-vault` eingeleitet: ``` aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters '{"Type": "inventory-retrieval"}' ``` Ausgabe: ``` { "location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW" } ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Mit dem folgenden Befehl wird ein Auftrag zum Abrufen eines Archivs des Tresors `my-vault` eingeleitet: ``` aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters file://job-archive-retrieval.json ``` `job-archive-retrieval.json` ist eine JSON-Datei im lokalen Ordner, die den Auftragstyp, die Archiv-ID und einige optionale Parameter angibt: ``` { "Type": "archive-retrieval", "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "Description": "Retrieve archive on 2015-07-17", "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-topic" } ``` Archive IDs sind in der Ausgabe von `aws glacier upload-archive` und verfügbar`aws glacier get-job-output`. Ausgabe: ``` { "location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav", "jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav" } ``` Details zum Format der Auftragsparameter finden Sie unter „Einleiten eines Auftrags“ in der *API-Referenz zu Amazon Glacier*. + Einzelheiten zur API finden Sie [InitiateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-job.html)in der *AWS CLI Befehlsreferenz*. ### `initiate-multipart-upload` Das folgende Codebeispiel zeigt die Verwendung`initiate-multipart-upload`. **AWS CLI** Mit dem folgenden Befehl wird ein mehrteiliger Upload in einen Tresor namens `my-vault` mit einer Teilgröße von 1 MiB (1 024 x 1 024 Byte) pro Datei eingeleitet: ``` aws glacier initiate-multipart-upload --account-id - --part-size 1048576 --vault-name my-vault --archive-description "multipart upload test" ``` Der Parameter für die Archivbeschreibung ist optional. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Dieser Befehl gibt bei Erfolg eine Upload-ID aus. Verwenden Sie die Upload-ID, wenn Sie jeden Teil Ihres Archivs mit `aws glacier upload-multipart-part` hochladen. Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [InitiateMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-multipart-upload.html)in der *AWS CLI Befehlsreferenz*. ### `initiate-vault-lock` Das folgende Codebeispiel zeigt die Verwendung`initiate-vault-lock`. **AWS CLI** **So leiten Sie den Tresorverriegelungsprozess ein** Im folgenden Beispiel für `initiate-vault-lock` wird eine Tresorverriegelungsrichtlinie für den angegebenen Tresor installiert und der Sperrstatus der Tresorverriegelung auf `InProgress` festgelegt. Sie müssen den Prozess innerhalb von 24 Stunden abschließen, indem Sie `complete-vault-lock` aufrufen, um den Status der Tresorverriegelung auf `Locked` festzulegen. ``` aws glacier initiate-vault-lock \ --account-id - \ --vault-name MyVaultName \ --policy file://vault_lock_policy.json ``` Inhalt von `vault_lock_policy.json`: ``` {"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"} ``` Die Ausgabe ist die Tresorverriegelungs-ID, mit der Sie den Tresorverriegelungsprozess abschließen können. ``` { "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE" } ``` Weitere Informationen finden Sie unter [Einleiten der Tresorverriegelung (POST lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-InitiateVaultLock.html) im *Entwicklerhandbuch für die Amazon-Glacier-API*. + Einzelheiten zur API finden Sie [InitiateVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-vault-lock.html)in der *AWS CLI Befehlsreferenz*. ### `list-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-jobs`. **AWS CLI** Der folgende Befehl listet laufende und kürzlich abgeschlossene Aufträge für einen Tresor mit dem Namen `my-vault` auf: ``` aws glacier list-jobs --account-id - --vault-name my-vault ``` Ausgabe: ``` { "JobList": [ { "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "RetrievalByteRange": "0-3145727", "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault", "Completed": false, "SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67", "JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav", "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "JobDescription": "Retrieve archive on 2015-07-17", "ArchiveSizeInBytes": 3145728, "Action": "ArchiveRetrieval", "ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67", "CreationDate": "2015-07-17T21:16:13.840Z", "StatusCode": "InProgress" }, { "InventoryRetrievalParameters": { "Format": "JSON" }, "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "Completed": false, "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "Action": "InventoryRetrieval", "CreationDate": "2015-07-17T20:23:41.616Z", "StatusCode": ""InProgress"" } ] } ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-multipart-uploads` Das folgende Codebeispiel zeigt die Verwendung`list-multipart-uploads`. **AWS CLI** Mit dem folgenden Befehl werden alle laufenden mehrteiligen Uploads für einen Tresor namens `my-vault` angezeigt: ``` aws glacier list-multipart-uploads --account-id - --vault-name my-vault ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListMultipartUploads](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-multipart-uploads.html)in der *AWS CLI Befehlsreferenz*. ### `list-parts` Das folgende Codebeispiel zeigt die Verwendung`list-parts`. **AWS CLI** Mit dem folgenden Befehl werden die hochgeladenen Teile für einen mehrteiligen Upload in einen Tresor namens `my-vault` aufgelistet: ``` aws glacier list-parts --account-id - --vault-name my-vault --upload-id "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D" ``` Ausgabe: ``` { "MultipartUploadId": "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D", "Parts": [ { "RangeInBytes": "0-1048575", "SHA256TreeHash": "e1f2a7cd6e047350f69b9f8cfa60fa606fe2f02802097a9a026360a7edc1f553" }, { "RangeInBytes": "1048576-2097151", "SHA256TreeHash": "43cf3061fb95796aed99a11a6aa3cd8f839eed15e655ab0a597126210636aee6" } ], "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "CreationDate": "2015-07-18T00:05:23.830Z", "PartSizeInBytes": 1048576 } ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListParts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-parts.html)in der *AWS CLI Befehlsreferenz*. ### `list-provisioned-capacity` Das folgende Codebeispiel zeigt die Verwendung`list-provisioned-capacity`. **AWS CLI** **So rufen Sie die bereitgestellten Kapazitätseinheiten ab** Im folgenden Beispiel für `list-provisioned-capacity` werden Details zu allen bereitgestellten Kapazitätseinheiten für das angegebene Konto abgerufen. ``` aws glacier list-provisioned-capacity \ --account-id 111122223333 ``` Ausgabe: ``` { "ProvisionedCapacityList": [ { "CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K", "ExpirationDate": "2020-03-18T19:59:24.000Z", "StartDate": "2020-02-18T19:59:24.912Z" } ] } ``` + Einzelheiten zur API finden Sie [ListProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-provisioned-capacity.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-vault` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-vault`. **AWS CLI** Der folgende Befehl listet die Tags auf, die auf einen Tresor mit dem Namen `my-vault` angewendet wurden: ``` aws glacier list-tags-for-vault --account-id - --vault-name my-vault ``` Ausgabe: ``` { "Tags": { "date": "july2015", "id": "1234" } } ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [ListTagsForVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-tags-for-vault.html)in der *AWS CLI Befehlsreferenz*. ### `list-vaults` Das folgende Codebeispiel zeigt die Verwendung`list-vaults`. **AWS CLI** Der folgende Befehl listet die Tresore im Standardkonto und der Standardregion auf: ``` aws glacier list-vaults --account-id - ``` Ausgabe: ``` { "VaultList": [ { "SizeInBytes": 3178496, "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "LastInventoryDate": "2015-04-07T00:26:19.028Z", "VaultName": "my-vault", "NumberOfArchives": 1, "CreationDate": "2015-04-06T21:23:45.708Z" } ] } ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [ListVaults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-vaults.html)in der *AWS CLI Befehlsreferenz*. ### `purchase-provisioned-capacity` Das folgende Codebeispiel zeigt die Verwendung`purchase-provisioned-capacity`. **AWS CLI** **So erwerben Sie eine bereitgestellte Kapazitätseinheit** Im folgenden Beispiel für `purchase-provisioned-capacity` wird eine bereitgestellte Kapazitätseinheit erworben. ``` aws glacier purchase-provisioned-capacity \ --account-id 111122223333 ``` Ausgabe: ``` { "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" } ``` + Einzelheiten zur API finden Sie [PurchaseProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/purchase-provisioned-capacity.html)in der *AWS CLI Befehlsreferenz*. ### `remove-tags-from-vault` Das folgende Codebeispiel zeigt die Verwendung`remove-tags-from-vault`. **AWS CLI** Mit dem folgenden Befehl wird ein Tag mit dem Schlüssel `date` aus einem Tresor namens `my-vault` entfernt: ``` aws glacier remove-tags-from-vault --account-id - --vault-name my-vault --tag-keys date ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [RemoveTagsFromVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/remove-tags-from-vault.html)in der *AWS CLI Befehlsreferenz*. ### `set-data-retrieval-policy` Das folgende Codebeispiel zeigt die Verwendung`set-data-retrieval-policy`. **AWS CLI** Mit dem folgenden Befehl wird eine Datenabrufrichtlinie für das verwendete Konto konfiguriert: ``` aws glacier set-data-retrieval-policy --account-id - --policy file://data-retrieval-policy.json ``` `data-retrieval-policy.json` ist eine JSON-Datei im aktuellen Ordner, die eine Datenabrufrichtlinie angibt: ``` { "Rules":[ { "Strategy":"BytesPerHour", "BytesPerHour":10737418240 } ] } ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Mit dem folgenden Befehl wird die Datenabrufrichtlinie mithilfe von Inline-JSON auf `FreeTier` festgelegt: ``` aws glacier set-data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}' ``` Details zum Richtlinienformat finden Sie unter „Festlegen einer Datenabrufrichtlinie“ in der *API-Referenz zu Amazon Glacier*. + Einzelheiten zur API finden Sie [SetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-data-retrieval-policy.html)in der *AWS CLI Befehlsreferenz*. ### `set-vault-access-policy` Das folgende Codebeispiel zeigt die Verwendung`set-vault-access-policy`. **AWS CLI** **So legen Sie die Zugriffsrichtlinie eines Tresors fest** Im folgenden Beispiel für `set-vault-access-policy` wird eine Berechtigungsrichtlinie an den angegebenen Tresor angehängt. ``` aws glacier set-vault-access-policy \ --account-id 111122223333 \ --vault-name example_vault --policy '{"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [SetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-access-policy.html)in der *AWS CLI Befehlsreferenz*. ### `set-vault-notifications` Das folgende Codebeispiel zeigt die Verwendung`set-vault-notifications`. **AWS CLI** Der folgende Befehl konfiguriert SNS-Benachrichtigungen für einen Tresor mit dem Namen `my-vault`: ``` aws glacier set-vault-notifications --account-id - --vault-name my-vault --vault-notification-config file://notificationconfig.json ``` `notificationconfig.json` ist eine JSON-Datei im aktuellen Ordner, die ein SNS-Thema und die zu veröffentlichenden Ereignisse angibt: ``` { "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault", "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] } ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. + Einzelheiten zur API finden Sie [SetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-notifications.html)in der *AWS CLI Befehlsreferenz*. ### `upload-archive` Das folgende Codebeispiel zeigt die Verwendung`upload-archive`. **AWS CLI** Der folgende Befehl lädt ein Archiv im aktuellen Ordner mit dem Namen `archive.zip` in einen Tresor mit dem Namen `my-vault` hoch: ``` aws glacier upload-archive --account-id - --vault-name my-vault --body archive.zip ``` Ausgabe: ``` { "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67", "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw" } ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Um ein hochgeladenes Archiv abzurufen, initiieren Sie einen Abrufauftrag mit dem Befehl aws glacier initiate-job. + Einzelheiten zur API finden Sie [UploadArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-archive.html)in der *AWS CLI Befehlsreferenz*. ### `upload-multipart-part` Das folgende Codebeispiel zeigt die Verwendung`upload-multipart-part`. **AWS CLI** Der folgende Befehl lädt den ersten, 1 MiB (1024 x 1024 Byte) umfassenden Teil eines Archivs hoch: ``` aws glacier upload-multipart-part --body part1 --range 'bytes 0-1048575/*' --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ ``` Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Der Parameter „body“ nimmt einen Pfad zu einer Teildatei im lokalen Dateisystem an. Der Parameter „range“ nimmt einen HTTP-Inhaltsbereich an, der die Byte angibt, die der Teil im fertigen Archiv belegt. Die Upload-ID wird vom Befehl `aws glacier initiate-multipart-upload` zurückgegeben und kann auch mithilfe von `aws glacier list-multipart-uploads` abgerufen werden. Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UploadMultipartPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Global Accelerator mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Global Accelerator Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-custom-routing-endpoints` Das folgende Codebeispiel zeigt, wie Sie`add-custom-routing-endpoints`. **AWS CLI** **So fügen Sie einen VPC-Subnetzendpunkt zu einer Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator hinzu** Im folgenden Beispiel für `add-custom-routing-endpoints` wird ein VPC-Subnetzendpunkt zu einer Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator hinzugefügt. ``` aws globalaccelerator add-custom-routing-endpoints \ --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd \ --endpoint-configurations "EndpointId=subnet-1234567890abcdef0" ``` Ausgabe: ``` { "EndpointDescriptions": [ { "EndpointId": "subnet-1234567890abcdef0" } ], "EndpointGroupArn":"arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd" } ``` *Weitere Informationen finden Sie unter [VPC-Subnetz-Endpunkte für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) Developer Guide AWS .* + *Einzelheiten zur API finden Sie in der Befehlsreferenz [AddCustomRoutingEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/add-custom-routing-endpoints.html).AWS CLI * ### `advertise-byoip-cidr` Das folgende Codebeispiel zeigt die Verwendung`advertise-byoip-cidr`. **AWS CLI** **So geben Sie einen Adressbereich bekannt** Im folgenden `advertise-byoip-cidr` Beispiel werden Sie AWS aufgefordert, für einen Adressbereich zu werben, den Sie für die Verwendung mit Ihren AWS Ressourcen bereitgestellt haben. ``` aws globalaccelerator advertise-byoip-cidr \ --cidr 198.51.100.0/24 ``` Ausgabe: ``` { "ByoipCidr": { "Cidr": "198.51.100.0/24", "State": "PENDING_ADVERTISING" } } ``` Weitere Informationen finden Sie unter [Bring Your Own IP Address in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [AdvertiseByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/advertise-byoip-cidr.html)in der *AWS CLI Befehlsreferenz*. ### `allow-custom-routing-traffic` Das folgende Codebeispiel zeigt die Verwendung`allow-custom-routing-traffic`. **AWS CLI** **So lassen Sie Datenverkehr zu bestimmten Amazon-EC2-Instance-Zielen in einem VPC-Subnetz für einen benutzerdefinierten Routing-Accelerator zu** Im folgenden Beispiel für `allow-custom-routing-traffic` wird angegeben, dass Datenverkehr zu bestimmten IP-Adressen und Ports von Amazon-EC2-Instances (Ziel) für einen VPC-Subnetzendpunkt in einem benutzerdefinierten Routing-Accelerator zugelassen ist, der Datenverkehr empfangen kann. ``` aws globalaccelerator allow-custom-routing-traffic \ --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example \ --endpoint-id subnet-abcd123example \ --destination-addresses "172.31.200.6" "172.31.200.7" \ --destination-ports 80 81 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. *Weitere Informationen finden Sie unter [VPC-Subnetz-Endpunkte für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) Developer Guide AWS .* + *Einzelheiten zur API finden Sie in der Befehlsreferenz [AllowCustomRoutingTraffic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/allow-custom-routing-traffic.html).AWS CLI * ### `create-accelerator` Das folgende Codebeispiel zeigt die Verwendung`create-accelerator`. **AWS CLI** **So erstellen Sie einen Accelerator** Im folgenden Beispiel für `create-accelerator` wird ein Accelerator mit zwei Tags mit zwei statischen BYOIP-IP-Adressen erstellt. Sie müssen die Region `US-West-2 (Oregon)` angeben, um einen Accelerator zu erstellen oder zu aktualisieren. ``` aws globalaccelerator create-accelerator \ --name ExampleAccelerator \ --tags Key="Name",Value="Example Name" Key="Project",Value="Example Project" \ --ip-addresses 192.0.2.250 198.51.100.52 ``` Ausgabe: ``` { "Accelerator": { "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh", "IpAddressType": "IPV4", "Name": "ExampleAccelerator", "Enabled": true, "Status": "IN_PROGRESS", "IpSets": [ { "IpAddresses": [ "192.0.2.250", "198.51.100.52" ], "IpFamily": "IPv4" } ], "DnsName":"a1234567890abcdef.awsglobalaccelerator.com", "CreatedTime": 1542394847.0, "LastModifiedTime": 1542394847.0 } } ``` Weitere Informationen finden Sie unter [Accelerators in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [CreateAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-accelerator.html)in der *AWS CLI Befehlsreferenz.* ### `create-custom-routing-accelerator` Das folgende Codebeispiel zeigt die Verwendung`create-custom-routing-accelerator`. **AWS CLI** **So erstellen Sie einen benutzerdefinierten Routing-Accelerator** Im folgenden Beispiel für `create-custom-routing-accelerator` wird ein benutzerdefinierter Routing-Accelerator mit den Tags `Name` und `Project` erstellt. ``` aws globalaccelerator create-custom-routing-accelerator \ --name ExampleCustomRoutingAccelerator \ --tags Key="Name",Value="Example Name" Key="Project",Value="Example Project" \ --ip-addresses 192.0.2.250 198.51.100.52 ``` Ausgabe: ``` { "Accelerator": { "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh", "IpAddressType": "IPV4", "Name": "ExampleCustomRoutingAccelerator", "Enabled": true, "Status": "IN_PROGRESS", "IpSets": [ { "IpAddresses": [ "192.0.2.250", "198.51.100.52" ], "IpFamily": "IPv4" } ], "DnsName":"a1234567890abcdef.awsglobalaccelerator.com", "CreatedTime": 1542394847.0, "LastModifiedTime": 1542394847.0 } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Routing-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *Developer Guide*. + Einzelheiten zur API finden Sie [CreateCustomRoutingAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-accelerator.html)in der *AWS CLI Befehlsreferenz.* ### `create-custom-routing-endpoint-group` Das folgende Codebeispiel zeigt die Verwendung`create-custom-routing-endpoint-group`. **AWS CLI** **So erstellen Sie eine Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator** Im folgenden Beispiel für `create-custom-routing-endpoint-group` wird eine Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator erstellt. ``` aws globalaccelerator create-custom-routing-endpoint-group \ --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \ --endpoint-group-region us-east-2 \ --destination-configurations "FromPort=80,ToPort=81,Protocols=TCP,UDP" ``` Ausgabe: ``` { "EndpointGroup": { "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd", "EndpointGroupRegion": "us-east-2", "DestinationDescriptions": [ { "FromPort": 80, "ToPort": 81, "Protocols": [ "TCP", "UDP" ] } ], "EndpointDescriptions": [] } } ``` Weitere Informationen finden Sie unter [Endpunktgruppen für benutzerdefinierte Routingbeschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) *Developer Guide*. + Einzelheiten zur API finden Sie [CreateCustomRoutingEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-endpoint-group.html)in der *AWS CLI Befehlsreferenz.* ### `create-custom-routing-listener` Das folgende Codebeispiel zeigt die Verwendung`create-custom-routing-listener`. **AWS CLI** **So erstellen Sie einen Listener für einen benutzerdefinierten Routing-Accelerator** Im folgenden Beispiel für `create-custom-routing-listener` wird ein Listener mit einem Portbereich von 5 000 bis 10 000 für einen benutzerdefinierten Routing-Accelerator erstellt. ``` aws globalaccelerator create-custom-routing-listener \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --port-ranges FromPort=5000,ToPort=10000 ``` Ausgabe: ``` { "Listener": { "PortRange": [ "FromPort": 5000, "ToPort": 10000 ], "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz" } } ``` Weitere Informationen finden Sie unter [Listener für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) *Developer Guide*.AWS + Einzelheiten zur API finden Sie [CreateCustomRoutingListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-listener.html)in der *AWS CLI Befehlsreferenz*. ### `create-endpoint-group` Das folgende Codebeispiel zeigt die Verwendung`create-endpoint-group`. **AWS CLI** **So erstellen Sie eine Endpunktgruppe** Im folgenden Beispiel für `create-endpoint-group` wird eine Endpunktgruppe mit einem Endpunkt erstellt. ``` aws globalaccelerator create-endpoint-group \ --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \ --endpoint-group-region us-east-1 \ --endpoint-configurations EndpointId=i-1234567890abcdef0,Weight=128 ``` Ausgabe: ``` { "EndpointGroup": { "TrafficDialPercentage": 100.0, "EndpointDescriptions": [ { "Weight": 128, "EndpointId": "i-1234567890abcdef0" } ], "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu", "EndpointGroupRegion": "us-east-1" } } ``` Weitere Informationen finden Sie unter [Endpunktgruppen in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [CreateEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-endpoint-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-listener` Das folgende Codebeispiel zeigt die Verwendung`create-listener`. **AWS CLI** **So erstellen Sie einen Listener** Im folgenden Beispiel für `create-listener` wird ein Listener mit zwei Ports erstellt. ``` aws globalaccelerator create-listener \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --port-ranges FromPort=80,ToPort=80 FromPort=81,ToPort=81 \ --protocol TCP ``` Ausgabe: ``` { "Listener": { "PortRanges": [ { "ToPort": 80, "FromPort": 80 }, { "ToPort": 81, "FromPort": 81 } ], "ClientAffinity": "NONE", "Protocol": "TCP", "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz" } } ``` Weitere Informationen finden Sie unter [Listeners in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) *Developer Guide*. + Einzelheiten zur API finden Sie [CreateListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-listener.html)in der *AWS CLI Befehlsreferenz.* ### `deny-custom-routing-traffic` Das folgende Codebeispiel zeigt die Verwendung`deny-custom-routing-traffic`. **AWS CLI** **So geben Sie eine Zieladresse an, die keinen Datenverkehr in einem benutzerdefinierten Routing-Accelerator empfangen kann** Im folgenden Beispiel für `deny-custom-routing-traffic` werden eine Zieladresse oder mehrere Zieladressen in einem Subnetzendpunkt angegeben, die keinen Datenverkehr für einen benutzerdefinierten Routing-Accelerator empfangen können. Wenn Sie mehr als eine Zieladresse festlegen möchten, trennen Sie die Adressen mit einem Leerzeichen. Bei einem erfolgreichen deny-custom-routing-traffic Anruf erfolgt keine Antwort. ``` aws globalaccelerator deny-custom-routing-traffic \ --endpoint-group-arn "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example" \ --endpoint-id "subnet-abcd123example" \ --destination-addresses "198.51.100.52" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. *Weitere Informationen finden Sie unter [VPC-Subnetz-Endpunkte für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) Developer Guide AWS .* + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DenyCustomRoutingTraffic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/deny-custom-routing-traffic.html).AWS CLI * ### `deprovision-byoip-cidr` Das folgende Codebeispiel zeigt die Verwendung`deprovision-byoip-cidr`. **AWS CLI** **So entfernen Sie einen Adressbereich** Im folgenden `deprovision-byoip-cidr` Beispiel wird der angegebene Adressbereich freigegeben, den Sie für die Verwendung mit Ihren AWS Ressourcen bereitgestellt haben. ``` aws globalaccelerator deprovision-byoip-cidr \ --cidr "198.51.100.0/24" ``` Ausgabe: ``` { "ByoipCidr": { "Cidr": "198.51.100.0/24", "State": "PENDING_DEPROVISIONING" } } ``` Weitere Informationen finden Sie unter [Bring your own IP address in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) *Developer Guide*. + Einzelheiten zur API finden Sie [DeprovisionByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/deprovision-byoip-cidr.html)in der *AWS CLI Befehlsreferenz*. ### `describe-accelerator-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-accelerator-attributes`. **AWS CLI** **So beschreiben Sie die Attribute eines Accelerators** Im folgenden Beispiel für `describe-accelerator-attributes` werden die Attributdetails für einen Accelerator abgerufen. ``` aws globalaccelerator describe-accelerator-attributes \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh ``` Ausgabe: ``` { "AcceleratorAttributes": { "FlowLogsEnabled": true "FlowLogsS3Bucket": flowlogs-abc "FlowLogsS3Prefix": bucketprefix-abc } } ``` Weitere Informationen finden Sie unter [Accelerators in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [DescribeAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-accelerator-attributes.html)in der *AWS CLI Befehlsreferenz.* ### `describe-accelerator` Das folgende Codebeispiel zeigt die Verwendung`describe-accelerator`. **AWS CLI** **So beschreiben Sie einen Accelerator** Im folgenden Beispiel für `describe-accelerator` werden die Details zum angegebenen Accelerator abgerufen. ``` aws globalaccelerator describe-accelerator \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh ``` Ausgabe: ``` { "Accelerator": { "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh", "IpAddressType": "IPV4", "Name": "ExampleAccelerator", "Enabled": true, "Status": "IN_PROGRESS", "IpSets": [ { "IpAddresses": [ "192.0.2.250", "198.51.100.52" ], "IpFamily": "IPv4" } ], "DnsName":"a1234567890abcdef.awsglobalaccelerator.com", "CreatedTime": 1542394847, "LastModifiedTime": 1542395013 } } ``` Weitere Informationen finden Sie unter [Accelerators in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [DescribeAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-accelerator.html)in der *AWS CLI Befehlsreferenz.* ### `describe-custom-routing-accelerator-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-custom-routing-accelerator-attributes`. **AWS CLI** **So beschreiben Sie die Attribute eines benutzerdefinierten Routing-Accelerators** Im folgenden Beispiel für `describe-custom-routing-accelerator-attributes` werden die Attribute für einen benutzerdefinierten Routing-Accelerator beschrieben. ``` aws globalaccelerator describe-custom-routing-accelerator-attributes \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh ``` Ausgabe: ``` { "AcceleratorAttributes": { "FlowLogsEnabled": false } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Routing-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *Developer Guide*. + Einzelheiten zur API finden Sie [DescribeCustomRoutingAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-accelerator-attributes.html)in der *AWS CLI Befehlsreferenz.* ### `describe-custom-routing-accelerator` Das folgende Codebeispiel zeigt die Verwendung`describe-custom-routing-accelerator`. **AWS CLI** **So beschreiben Sie einen benutzerdefinierten Routing-Accelerator** Im folgenden Beispiel für `describe-custom-routing-accelerator` werden die Details zum angegebenen benutzerdefinierten Routing-Accelerator abgerufen. ``` aws globalaccelerator describe-custom-routing-accelerator \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh ``` Ausgabe: ``` { "Accelerator": { "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh", "IpAddressType": "IPV4", "Name": "ExampleCustomRoutingAccelerator", "Enabled": true, "Status": "IN_PROGRESS", "IpSets": [ { "IpAddresses": [ "192.0.2.250", "198.51.100.52" ], "IpFamily": "IPv4" } ], "DnsName":"a1234567890abcdef.awsglobalaccelerator.com", "CreatedTime": 1542394847, "LastModifiedTime": 1542395013 } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Routing-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *Developer Guide*. + Einzelheiten zur API finden Sie [DescribeCustomRoutingAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-accelerator.html)in der *AWS CLI Befehlsreferenz.* ### `describe-custom-routing-endpoint-group` Das folgende Codebeispiel zeigt die Verwendung`describe-custom-routing-endpoint-group`. **AWS CLI** **So beschreiben Sie eine Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator** Im folgenden Beispiel für `describe-custom-routing-endpoint-group` wird eine Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator beschrieben. ``` aws globalaccelerator describe-custom-routing-endpoint-group \ --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz/endpoint-group/ab88888example ``` Ausgabe: ``` { "EndpointGroup": { "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz/endpoint-group/ab88888example", "EndpointGroupRegion": "us-east-2", "DestinationDescriptions": [ { "FromPort": 5000, "ToPort": 10000, "Protocols": [ "UDP" ] } ], "EndpointDescriptions": [ { "EndpointId": "subnet-1234567890abcdef0" } ] } } ``` Weitere Informationen finden Sie unter [Endpunktgruppen für benutzerdefinierte Routingbeschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) *Developer Guide*. + Einzelheiten zur API finden Sie [DescribeCustomRoutingEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-endpoint-group.html)in der *AWS CLI Befehlsreferenz.* ### `describe-custom-routing-listener` Das folgende Codebeispiel zeigt die Verwendung`describe-custom-routing-listener`. **AWS CLI** **So beschreiben Sie einen Listener für einen benutzerdefinierten Routing-Accelerator** Im folgenden Beispiel für `describe-custom-routing-listener` wird ein Listener für einen benutzerdefinierten Routing-Accelerator beschrieben. ``` aws globalaccelerator describe-custom-routing-listener \ --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234 ``` Ausgabe: ``` { "Listener": { "PortRanges": [ "FromPort": 5000, "ToPort": 10000 ], "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234" } } ``` Weitere Informationen finden Sie unter [Listener für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) *Developer Guide*.AWS + Einzelheiten zur API finden Sie [DescribeCustomRoutingListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-listener.html)in der *AWS CLI Befehlsreferenz*. ### `describe-endpoint-group` Das folgende Codebeispiel zeigt die Verwendung`describe-endpoint-group`. **AWS CLI** **So beschreiben Sie eine Endpunktgruppe** Im folgenden Beispiel für `describe-endpoint-group` werden Details zu einer Endpunktgruppe mit den folgenden Endpunkten abgerufen: einer Amazon-EC2-Instance, einem ALB und einem NLB. ``` aws globalaccelerator describe-endpoint-group \ --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/ab88888example ``` Ausgabe: ``` { "EndpointGroup": { "TrafficDialPercentage": 100.0, "EndpointDescriptions": [ { "Weight": 128, "EndpointId": "i-1234567890abcdef0" }, { "Weight": 128, "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz" }, { "Weight": 128, "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs" } ], "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/4321abcd-abcd-4321-abcd-4321abcdefg", "EndpointGroupRegion": "us-east-1" } } ``` Weitere Informationen finden Sie unter [Endpunktgruppen in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [DescribeEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-endpoint-group.html)in der *AWS CLI Befehlsreferenz*. ### `describe-listener` Das folgende Codebeispiel zeigt die Verwendung`describe-listener`. **AWS CLI** **So beschreiben Sie einen Listener** Im folgenden Beispiel für `describe-listener` wird ein Listener beschrieben. ``` aws globalaccelerator describe-listener \ --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234 ``` Ausgabe: ``` { "Listener": { "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234", "PortRanges": [ { "FromPort": 80, "ToPort": 80 } ], "Protocol": "TCP", "ClientAffinity": "NONE" } } ``` Weitere Informationen finden Sie unter [Listeners in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) *Developer Guide*. + Einzelheiten zur API finden Sie [DescribeListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-listener.html)in der *AWS CLI Befehlsreferenz.* ### `list-accelerators` Das folgende Codebeispiel zeigt die Verwendung`list-accelerators`. **AWS CLI** **So listen Sie Ihre Accelerators auf** Das folgende `list-accelerators` Beispiel listet die Accelerators in Ihrem AWS Konto auf. Dieses Konto verfügt über zwei Accelerators. ``` aws globalaccelerator list-accelerators ``` Ausgabe: ``` { "Accelerators": [ { "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/5555abcd-abcd-5555-abcd-5555EXAMPLE1", "Name": "TestAccelerator", "IpAddressType": "IPV4", "Enabled": true, "IpSets": [ { "IpFamily": "IPv4", "IpAddresses": [ "192.0.2.250", "198.51.100.52" ] } ], "DnsName": "5a5a5a5a5a5a5a5a.awsglobalaccelerator.com", "Status": "DEPLOYED", "CreatedTime": 1552424416.0, "LastModifiedTime": 1569375641.0 }, { "AcceleratorArn": "arn:aws:globalaccelerator::888888888888:accelerator/8888abcd-abcd-8888-abcd-8888EXAMPLE2", "Name": "ExampleAccelerator", "IpAddressType": "IPV4", "Enabled": true, "IpSets": [ { "IpFamily": "IPv4", "IpAddresses": [ "192.0.2.100", "198.51.100.10" ] } ], "DnsName": "6a6a6a6a6a6a6a.awsglobalaccelerator.com", "Status": "DEPLOYED", "CreatedTime": 1575585564.0, "LastModifiedTime": 1579809243.0 }, ] } ``` Weitere Informationen finden Sie unter [Accelerators in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) *Developer Guide*. + Einzelheiten zur API finden Sie [ListAccelerators](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-accelerators.html)in der *AWS CLI Befehlsreferenz.* ### `list-byoip-cidr` Das folgende Codebeispiel zeigt die Verwendung`list-byoip-cidr`. **AWS CLI** **So listen Sie Ihre Adressbereiche auf** Im folgenden Beispiel für `list-byoip-cidr` werden die BYOIP-Adressbereiche (Bring Your Own IP Address, Verwenden der eigenen IP-Adresse) aufgelistet, die Sie für die Verwendung mit Global Accelerator bereitgestellt haben. ``` aws globalaccelerator list-byoip-cidrs ``` Ausgabe: ``` { "ByoipCidrs": [ { "Cidr": "198.51.100.0/24", "State": "READY" } { "Cidr": "203.0.113.25/24", "State": "READY" } ] } ``` Weitere Informationen finden Sie unter [Bring your own IP address in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [ListByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-byoip-cidr.html)in der *AWS CLI Befehlsreferenz*. ### `list-custom-routing-accelerators` Das folgende Codebeispiel zeigt die Verwendung`list-custom-routing-accelerators`. **AWS CLI** **So listen Sie Ihre benutzerdefinierten Routing-Accelerators auf** Das folgende `list-custom-routing-accelerators` Beispiel listet die benutzerdefinierten Routingbeschleuniger in einem AWS Konto auf. ``` aws globalaccelerator list-custom-routing-accelerators ``` Ausgabe: ``` { "Accelerators": [ { "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/5555abcd-abcd-5555-abcd-5555EXAMPLE1", "Name": "TestCustomRoutingAccelerator", "IpAddressType": "IPV4", "Enabled": true, "IpSets": [ { "IpFamily": "IPv4", "IpAddresses": [ "192.0.2.250", "198.51.100.52" ] } ], "DnsName": "5a5a5a5a5a5a5a5a.awsglobalaccelerator.com", "Status": "DEPLOYED", "CreatedTime": 1552424416.0, "LastModifiedTime": 1569375641.0 }, { "AcceleratorArn": "arn:aws:globalaccelerator::888888888888:accelerator/8888abcd-abcd-8888-abcd-8888EXAMPLE2", "Name": "ExampleCustomRoutingAccelerator", "IpAddressType": "IPV4", "Enabled": true, "IpSets": [ { "IpFamily": "IPv4", "IpAddresses": [ "192.0.2.100", "198.51.100.10" ] } ], "DnsName": "6a6a6a6a6a6a6a.awsglobalaccelerator.com", "Status": "DEPLOYED", "CreatedTime": 1575585564.0, "LastModifiedTime": 1579809243.0 }, ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *Developer Guide*.AWS + Einzelheiten zur API finden Sie [ListCustomRoutingAccelerators](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-accelerators.html)in der *AWS CLI Befehlsreferenz.* ### `list-custom-routing-endpoint-groups` Das folgende Codebeispiel zeigt die Verwendung`list-custom-routing-endpoint-groups`. **AWS CLI** **So listen Sie Endpunktgruppen für einen Listener in einem benutzerdefinierten Routing-Accelerator auf** Im folgenden Beispiel für `list-custom-routing-endpoint-groups` werden die Endpunktgruppen für einen Listener in einem benutzerdefinierten Routing-Accelerator aufgelistet. ``` aws globalaccelerator list-custom-routing-endpoint-groups \ --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234 ``` Ausgabe: ``` { "EndpointGroups": [ { "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234/endpoint-group/ab88888example", "EndpointGroupRegion": "eu-central-1", "DestinationDescriptions": [ { "FromPort": 80, "ToPort": 80, "Protocols": [ "TCP", "UDP" ] } ] "EndpointDescriptions": [ { "EndpointId": "subnet-abcd123example" } ] } ] } ``` Weitere Informationen finden Sie unter [Endpunktgruppen für benutzerdefinierte Routingbeschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) *Developer Guide*. + Einzelheiten zur API finden Sie [ListCustomRoutingEndpointGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-endpoint-groups.html)in der *AWS CLI Befehlsreferenz.* ### `list-custom-routing-listeners` Das folgende Codebeispiel zeigt die Verwendung`list-custom-routing-listeners`. **AWS CLI** **So listen Sie Listener für benutzerdefinierte Routing-Accelerators auf** Im folgenden Beispiel für `list-custom-routing-listeners` werden die Listener für einen benutzerdefinierten Routing-Accelerator aufgelistet. ``` aws globalaccelerator list-custom-routing-listeners \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh ``` Ausgabe: ``` { "Listeners": [ { "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234", "PortRanges": [ { "FromPort": 5000, "ToPort": 10000 } ], "Protocol": "TCP" } ] } ``` Weitere Informationen finden Sie unter [Listener für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) *Developer Guide*.AWS + Einzelheiten zur API finden Sie [ListCustomRoutingListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-listeners.html)in der *AWS CLI Befehlsreferenz*. ### `list-custom-routing-port-mappings-by-destination` Das folgende Codebeispiel zeigt die Verwendung`list-custom-routing-port-mappings-by-destination`. **AWS CLI** **So listen Sie die Portzuordnungen für ein bestimmtes Ziel für einen benutzerdefinierten Routing-Accelerator auf** Im folgenden Beispiel für `list-custom-routing-port-mappings-by-destination` werden die Portzuordnungen für einen bestimmten EC2-Zielserver (an der Zieladresse) für einen benutzerdefinierten Routing-Accelerator bereitgestellt. ``` aws globalaccelerator list-custom-routing-port-mappings-by-destination \ --endpoint-id subnet-abcd123example \ --destination-address 198.51.100.52 ``` Ausgabe: ``` { "DestinationPortMappings": [ { "AcceleratorArn": "arn:aws:globalaccelerator::402092451327:accelerator/24ea29b8-d750-4489-8919-3095f3c4b0a7", "AcceleratorSocketAddresses": [ { "IpAddress": "192.0.2.250", "Port": 65514 }, { "IpAddress": "192.10.100.99", "Port": 65514 } ], "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example", "EndpointId": "subnet-abcd123example", "EndpointGroupRegion": "us-west-2", "DestinationSocketAddress": { "IpAddress": "198.51.100.52", "Port": 80 }, "IpAddressType": "IPv4", "DestinationTrafficState": "ALLOW" } ] } ``` Weitere Informationen finden Sie unter [So funktionieren benutzerdefinierte Routing-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-how-it-works.html) *Developer Guide*. + Einzelheiten zur API finden Sie [ListCustomRoutingPortMappingsByDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-port-mappings-by-destination.html)in der *AWS CLI Befehlsreferenz.* ### `list-custom-routing-port-mappings` Das folgende Codebeispiel zeigt die Verwendung`list-custom-routing-port-mappings`. **AWS CLI** **So listen Sie die Portzuordnungen in einem benutzerdefinierten Routing-Accelerator auf** Im folgenden Beispiel für `list-custom-routing-port-mappings` wird eine unvollständige Liste der Portzuordnungen in einem benutzerdefinierten Routing-Accelerator bereitgestellt. ``` aws globalaccelerator list-custom-routing-port-mappings \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh ``` Ausgabe: ``` { "PortMappings": [ { "AcceleratorPort": 40480, "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu", "EndpointId": "subnet-1234567890abcdef0", "DestinationSocketAddress": { "IpAddress": "192.0.2.250", "Port": 80 }, "Protocols": [ "TCP", "UDP" ], "DestinationTrafficState": "ALLOW" } { "AcceleratorPort": 40481, "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu", "EndpointId": "subnet-1234567890abcdef0", "DestinationSocketAddress": { "IpAddress": "192.0.2.251", "Port": 80 }, "Protocols": [ "TCP", "UDP" ], "DestinationTrafficState": "ALLOW" } ] } ``` Weitere Informationen finden Sie unter [So funktionieren benutzerdefinierte Routing-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-how-it-works.html) *Developer Guide*. + Einzelheiten zur API finden Sie [ListCustomRoutingPortMappings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-port-mappings.html)in der *AWS CLI Befehlsreferenz.* ### `list-endpoint-groups` Das folgende Codebeispiel zeigt die Verwendung`list-endpoint-groups`. **AWS CLI** **So listen Sie Endpunktgruppen auf** Im folgenden Beispiel für `list-endpoint-groups` werden die Endpunktgruppen für einen Listener aufgelistet. Dieser Listener verfügt über zwei Endpunktgruppen. ``` aws globalaccelerator --region us-west-2 list-endpoint-groups \ --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234 ``` Ausgabe: ``` { "EndpointGroups": [ { "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234/endpoint-group/ab88888example", "EndpointGroupRegion": "eu-central-1", "EndpointDescriptions": [], "TrafficDialPercentage": 100.0, "HealthCheckPort": 80, "HealthCheckProtocol": "TCP", "HealthCheckIntervalSeconds": 30, "ThresholdCount": 3 } { "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234/endpoint-group/ab99999example", "EndpointGroupRegion": "us-east-1", "EndpointDescriptions": [], "TrafficDialPercentage": 50.0, "HealthCheckPort": 80, "HealthCheckProtocol": "TCP", "HealthCheckIntervalSeconds": 30, "ThresholdCount": 3 } ] } ``` Weitere Informationen finden Sie unter [Endpunktgruppen in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [ListEndpointGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-endpoint-groups.html)in der *AWS CLI Befehlsreferenz*. ### `list-listeners` Das folgende Codebeispiel zeigt die Verwendung`list-listeners`. **AWS CLI** **So listen Sie Listener auf** Im folgenden Beispiel für `list-listeners` werden die Listener für einen Accelerator aufgelistet. ``` aws globalaccelerator list-listeners \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh ``` Ausgabe: ``` { "Listeners": [ { "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234", "PortRanges": [ { "FromPort": 80, "ToPort": 80 } ], "Protocol": "TCP", "ClientAffinity": "NONE" } ] } ``` Weitere Informationen finden Sie unter [Listeners in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) *Developer Guide*. + Einzelheiten zur API finden Sie [ListListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-listeners.html)in der *AWS CLI Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für einen Accelerator auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für einen bestimmten Accelerator aufgelistet. ``` aws globalaccelerator list-tags-for-resource \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh ``` Ausgabe: ``` { "Tags": [ { "Key": "Project", "Value": "A123456" } ] } ``` Weitere Informationen finden Sie unter [Tagging in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html) *Developer Guide*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `provision-byoip-cidr` Das folgende Codebeispiel zeigt die Verwendung`provision-byoip-cidr`. **AWS CLI** **So stellen Sie einen Adressbereich bereit** Im folgenden `provision-byoip-cidr` Beispiel wird der angegebene Adressbereich zur Verwendung mit Ihren AWS Ressourcen bereitgestellt. ``` aws globalaccelerator provision-byoip-cidr \ --cidr 192.0.2.250/24 \ --cidr-authorization-context Message="$text_message",Signature="$signed_message" ``` Ausgabe: ``` { "ByoipCidr": { "Cidr": "192.0.2.250/24", "State": "PENDING_PROVISIONING" } } ``` Weitere Informationen finden Sie unter [Bring your own IP address in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [ProvisionByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/provision-byoip-cidr.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So versehen Sie einen Accelerator mit einem Tag** Im folgenden Beispiel für `tag-resource` werden die Tags Name und Project zu einem Accelerator hinzugefügt, jeweils mit den zugehörigen Werten. ``` aws globalaccelerator tag-resource \ --resource-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --tags Key="Name",Value="Example Name" Key="Project",Value="Example Project" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html) *Developer Guide*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag aus einem Accelerator** Im folgenden Beispiel für `untag-resource` werden die Tags Name und Project aus einem Accelerator entfernt. ``` aws globalaccelerator untag-resource \ --resource-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --tag-keys Key="Name" Key="Project" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html) *Developer Guide*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-accelerator-attributes` Das folgende Codebeispiel zeigt die Verwendung`update-accelerator-attributes`. **AWS CLI** **So aktualisieren Sie die Attribute eines Accelerators** Im folgenden Beispiel für `update-accelerator-attributes` wird ein Accelerator aktualisiert, um Ablaufprotokolle zu aktivieren. Sie müssen die Region `US-West-2 (Oregon)` angeben, um Accelerator-Attribute zu erstellen oder zu aktualisieren. ``` aws globalaccelerator update-accelerator-attributes \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --flow-logs-enabled \ --flow-logs-s3-bucket flowlogs-abc \ --flow-logs-s3-prefix bucketprefix-abc ``` Ausgabe: ``` { "AcceleratorAttributes": { "FlowLogsEnabled": true "FlowLogsS3Bucket": flowlogs-abc "FlowLogsS3Prefix": bucketprefix-abc } } ``` Weitere Informationen finden Sie unter [Accelerators in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [UpdateAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-accelerator-attributes.html)in der *AWS CLI Befehlsreferenz.* ### `update-accelerator` Das folgende Codebeispiel zeigt die Verwendung`update-accelerator`. **AWS CLI** **So aktualisieren Sie einen Accelerator** Im folgenden Beispiel für `update-accelerator` wird ein Accelerator geändert, um seinen Namen in `ExampleAcceleratorNew` zu ändern. Sie müssen die Region `US-West-2 (Oregon)` angeben, um Accelerators zu erstellen oder zu aktualisieren. ``` aws globalaccelerator update-accelerator \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --name ExampleAcceleratorNew ``` Ausgabe: ``` { "Accelerator": { "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh", "IpAddressType": "IPV4", "Name": "ExampleAcceleratorNew", "Enabled": true, "Status": "IN_PROGRESS", "IpSets": [ { "IpAddresses": [ "192.0.2.250", "198.51.100.52" ], "IpFamily": "IPv4" } ], "DnsName":"a1234567890abcdef.awsglobalaccelerator.com", "CreatedTime": 1232394847, "LastModifiedTime": 1232395654 } } ``` Weitere Informationen finden Sie unter [Accelerators in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [UpdateAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-accelerator.html)in der *AWS CLI Befehlsreferenz.* ### `update-custom-routing-accelerator-attributes` Das folgende Codebeispiel zeigt die Verwendung`update-custom-routing-accelerator-attributes`. **AWS CLI** **So aktualisieren Sie die Attribute eines benutzerdefinierten Routing-Accelerators** Im folgenden Beispiel für `update-custom-routing-accelerator-attributes` wird ein benutzerdefinierter Routing-Accelerator aktualisiert, um Ablaufprotokolle zu aktivieren. ``` aws globalaccelerator update-custom-routing-accelerator-attributes \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --flow-logs-enabled \ --flow-logs-s3-bucket flowlogs-abc \ --flow-logs-s3-prefix bucketprefix-abc ``` Ausgabe: ``` { "AcceleratorAttributes": { "FlowLogsEnabled": true "FlowLogsS3Bucket": flowlogs-abc "FlowLogsS3Prefix": bucketprefix-abc } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Routing-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *Developer Guide*. + Einzelheiten zur API finden Sie [UpdateCustomRoutingAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-accelerator-attributes.html)in der *AWS CLI Befehlsreferenz.* ### `update-custom-routing-accelerator` Das folgende Codebeispiel zeigt die Verwendung`update-custom-routing-accelerator`. **AWS CLI** **So aktualisieren Sie einen benutzerdefinierten Routing-Accelerator** Im folgenden Beispiel für `update-custom-routing-accelerator` wird ein benutzerdefinierter Routing-Accelerator geändert, um seinen Namen zu ändern. ``` aws globalaccelerator --region us-west-2 update-custom-routing-accelerator \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --name ExampleCustomRoutingAcceleratorNew ``` Ausgabe: ``` { "Accelerator": { "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh", "IpAddressType": "IPV4", "Name": "ExampleCustomRoutingAcceleratorNew", "Enabled": true, "Status": "IN_PROGRESS", "IpSets": [ { "IpAddresses": [ "192.0.2.250", "198.51.100.52" ], "IpFamily": "IPv4" } ], "DnsName":"a1234567890abcdef.awsglobalaccelerator.com", "CreatedTime": 1232394847, "LastModifiedTime": 1232395654 } } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Routing-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *Developer Guide*. + Einzelheiten zur API finden Sie [UpdateCustomRoutingAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-accelerator.html)in der *AWS CLI Befehlsreferenz.* ### `update-custom-routing-listener` Das folgende Codebeispiel zeigt die Verwendung`update-custom-routing-listener`. **AWS CLI** **So aktualisieren Sie einen Listener für einen benutzerdefinierten Routing-Accelerator** Im folgenden Beispiel für `update-custom-routing-listener` wird ein Listener aktualisiert, um den Portbereich zu ändern. ``` aws globalaccelerator update-custom-routing-listener \ --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \ --port-ranges FromPort=10000,ToPort=20000 ``` Ausgabe: ``` { "Listener": { "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz "PortRanges": [ { "FromPort": 10000, "ToPort": 20000 } ], "Protocol": "TCP" } } ``` Weitere Informationen finden Sie unter [Listener für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) *Developer Guide*.AWS + Einzelheiten zur API finden Sie [UpdateCustomRoutingListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-listener.html)in der *AWS CLI Befehlsreferenz*. ### `update-endpoint-group` Das folgende Codebeispiel zeigt die Verwendung`update-endpoint-group`. **AWS CLI** **So aktualisieren Sie eine Endpunktgruppe** Im folgenden Beispiel für `update-endpoint-group` werden einer Endpunktgruppe drei Endpunkte hinzugefügt: eine Elastic-IP-Adresse, ein ALB und ein NLB. ``` aws globalaccelerator update-endpoint-group \ --endpoint-group-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/ab88888example \ --endpoint-configurations \ EndpointId=eipalloc-eip01234567890abc,Weight=128 \ EndpointId=arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz,Weight=128 \ EndpointId=arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs,Weight=128 ``` Ausgabe: ``` { "EndpointGroup": { "TrafficDialPercentage": 100, "EndpointDescriptions": [ { "Weight": 128, "EndpointId": "eip01234567890abc" }, { "Weight": 128, "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz" }, { "Weight": 128, "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs" } ], "EndpointGroupArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/4321abcd-abcd-4321-abcd-4321abcdefg", "EndpointGroupRegion": "us-east-1" } } ``` Weitere Informationen finden Sie unter [Endpunktgruppen in AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) im *AWS Global Accelerator Developer Guide*. + Einzelheiten zur API finden Sie [UpdateEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-endpoint-group.html)in der *AWS CLI Befehlsreferenz*. ### `update-listener` Das folgende Codebeispiel zeigt die Verwendung`update-listener`. **AWS CLI** **So aktualisieren Sie einen Listener** Im folgenden Beispiel für `update-listener` wird ein Listener aktualisiert, um den Port in 100 zu ändern. ``` aws globalaccelerator update-listener \ --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \ --port-ranges FromPort=100,ToPort=100 ``` Ausgabe: ``` { "Listener": { "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz "PortRanges": [ { "FromPort": 100, "ToPort": 100 } ], "Protocol": "TCP", "ClientAffinity": "NONE" } } ``` Weitere Informationen finden Sie unter [Listeners in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) *Developer Guide*. + Einzelheiten zur API finden Sie [UpdateListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-listener.html)in der *AWS CLI Befehlsreferenz.* ### `withdraw-byoip-cidr` Das folgende Codebeispiel zeigt die Verwendung`withdraw-byoip-cidr`. **AWS CLI** **So ziehen Sie einen Adressbereich zurück** Im folgenden `withdraw-byoip-cidr` Beispiel wird ein Adressbereich aus AWS Global Accelerator entfernt, den Sie zuvor für die Verwendung mit Ihren AWS Ressourcen beworben haben. ``` aws globalaccelerator withdraw-byoip-cidr \ --cidr 192.0.2.250/24 ``` Ausgabe: ``` { "ByoipCidr": { "Cidr": "192.0.2.250/24", "State": "PENDING_WITHDRAWING" } } ``` Weitere Informationen finden Sie unter [Bring your own IP address in AWS Global Accelerator im AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) *Developer Guide*. + Einzelheiten zur API finden Sie [WithdrawByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/withdraw-byoip-cidr.html)in der *AWS CLI Befehlsreferenz*. # AWS Glue Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Glue. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-stop-job-run` Das folgende Codebeispiel zeigt, wie Sie`batch-stop-job-run`. **AWS CLI** **So stoppen Sie Auftragsausführungen** Im folgenden Beispiel für `batch-stop-job-run` wird eine Auftragsausführung gestoppt. ``` aws glue batch-stop-job-run \ --job-name "my-testing-job" \ --job-run-id jr_852f1de1f29fb62e0ba4166c33970803935d87f14f96cfdee5089d5274a61d3f ``` Ausgabe: ``` { "SuccessfulSubmissions": [ { "JobName": "my-testing-job", "JobRunId": "jr_852f1de1f29fb62e0ba4166c33970803935d87f14f96cfdee5089d5274a61d3f" } ], "Errors": [], "ResponseMetadata": { "RequestId": "66bd6b90-01db-44ab-95b9-6aeff0e73d88", "HTTPStatusCode": 200, "HTTPHeaders": { "date": "Fri, 16 Oct 2020 20:54:51 GMT", "content-type": "application/x-amz-json-1.1", "content-length": "148", "connection": "keep-alive", "x-amzn-requestid": "66bd6b90-01db-44ab-95b9-6aeff0e73d88" }, "RetryAttempts": 0 } } ``` Weitere Informationen finden Sie unter [Auftragsausführungen](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-runs.html) im *Entwicklerhandbuch zu AWS Glue*. + Einzelheiten zur API finden Sie [BatchStopJobRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/batch-stop-job-run.html)in der *AWS CLI Befehlsreferenz*. ### `create-connection` Das folgende Codebeispiel zeigt die Verwendung`create-connection`. **AWS CLI** **Um eine Verbindung für AWS Glue-Datenspeicher herzustellen** Das folgende `create-connection` Beispiel erstellt eine Verbindung im AWS Glue-Datenkatalog, die Verbindungsinformationen für einen Kafka-Datenspeicher bereitstellt. ``` aws glue create-connection \ --connection-input '{ \ "Name":"conn-kafka-custom", \ "Description":"kafka connection with ssl to custom kafka", \ "ConnectionType":"KAFKA", \ "ConnectionProperties":{ \ "KAFKA_BOOTSTRAP_SERVERS":":", \ "KAFKA_SSL_ENABLED":"true", \ "KAFKA_CUSTOM_CERT": "s3://bucket/prefix/cert-file.pem" \ }, \ "PhysicalConnectionRequirements":{ \ "SubnetId":"subnet-1234", \ "SecurityGroupIdList":["sg-1234"], \ "AvailabilityZone":"us-east-1a"} \ }' \ --region us-east-1 --endpoint https://glue.us-east-1.amazonaws.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verbindungen im AWS Glue-Datenkatalog definieren](https://docs.aws.amazon.com/glue/latest/dg/populate-add-connection.html) im *AWS Glue-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [CreateConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/create-connection.html)in der *AWS CLI Befehlsreferenz*. ### `create-database` Das folgende Codebeispiel zeigt die Verwendung`create-database`. **AWS CLI** **So erstellen Sie eine Datenbank** Das folgende `create-database` Beispiel erstellt eine Datenbank im AWS Glue-Datenkatalog. ``` aws glue create-database \ --database-input "{\"Name\":\"tempdb\"}" \ --profile my_profile \ --endpoint https://glue.us-east-1.amazonaws.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Definieren einer Datenbank in Ihrem Datenkatalog](https://docs.aws.amazon.com/glue/latest/dg/define-database.html) im *Entwicklerhandbuch zu AWS Glue*. + Einzelheiten zur API finden Sie [CreateDatabase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/create-database.html)in der *AWS CLI Befehlsreferenz*. ### `create-job` Das folgende Codebeispiel zeigt die Verwendung`create-job`. **AWS CLI** **Einen Auftrag zur Datentransformation erstellen** Im folgenden Beispiel für `create-job` wird ein Streaming-Job erstellt, der ein in S3 gespeichertes Skript ausführt. ``` aws glue create-job \ --name my-testing-job \ --role AWSGlueServiceRoleDefault \ --command '{ \ "Name": "gluestreaming", \ "ScriptLocation": "s3://amzn-s3-demo-bucket/folder/" \ }' \ --region us-east-1 \ --output json \ --default-arguments '{ \ "--job-language":"scala", \ "--class":"GlueApp" \ }' \ --profile my-profile \ --endpoint https://glue.us-east-1.amazonaws.com ``` Inhalt von `test_script.scala`: ``` import com.amazonaws.services.glue.ChoiceOption import com.amazonaws.services.glue.GlueContext import com.amazonaws.services.glue.MappingSpec import com.amazonaws.services.glue.ResolveSpec import com.amazonaws.services.glue.errors.CallSite import com.amazonaws.services.glue.util.GlueArgParser import com.amazonaws.services.glue.util.Job import com.amazonaws.services.glue.util.JsonOptions import org.apache.spark.SparkContext import scala.collection.JavaConverters._ object GlueApp { def main(sysArgs: Array[String]) { val spark: SparkContext = new SparkContext() val glueContext: GlueContext = new GlueContext(spark) // @params: [JOB_NAME] val args = GlueArgParser.getResolvedOptions(sysArgs, Seq("JOB_NAME").toArray) Job.init(args("JOB_NAME"), glueContext, args.asJava) // @type: DataSource // @args: [database = "tempdb", table_name = "s3-source", transformation_ctx = "datasource0"] // @return: datasource0 // @inputs: [] val datasource0 = glueContext.getCatalogSource(database = "tempdb", tableName = "s3-source", redshiftTmpDir = "", transformationContext = "datasource0").getDynamicFrame() // @type: ApplyMapping // @args: [mapping = [("sensorid", "int", "sensorid", "int"), ("currenttemperature", "int", "currenttemperature", "int"), ("status", "string", "status", "string")], transformation_ctx = "applymapping1"] // @return: applymapping1 // @inputs: [frame = datasource0] val applymapping1 = datasource0.applyMapping(mappings = Seq(("sensorid", "int", "sensorid", "int"), ("currenttemperature", "int", "currenttemperature", "int"), ("status", "string", "status", "string")), caseSensitive = false, transformationContext = "applymapping1") // @type: SelectFields // @args: [paths = ["sensorid", "currenttemperature", "status"], transformation_ctx = "selectfields2"] // @return: selectfields2 // @inputs: [frame = applymapping1] val selectfields2 = applymapping1.selectFields(paths = Seq("sensorid", "currenttemperature", "status"), transformationContext = "selectfields2") // @type: ResolveChoice // @args: [choice = "MATCH_CATALOG", database = "tempdb", table_name = "my-s3-sink", transformation_ctx = "resolvechoice3"] // @return: resolvechoice3 // @inputs: [frame = selectfields2] val resolvechoice3 = selectfields2.resolveChoice(choiceOption = Some(ChoiceOption("MATCH_CATALOG")), database = Some("tempdb"), tableName = Some("my-s3-sink"), transformationContext = "resolvechoice3") // @type: DataSink // @args: [database = "tempdb", table_name = "my-s3-sink", transformation_ctx = "datasink4"] // @return: datasink4 // @inputs: [frame = resolvechoice3] val datasink4 = glueContext.getCatalogSink(database = "tempdb", tableName = "my-s3-sink", redshiftTmpDir = "", transformationContext = "datasink4").writeDynamicFrame(resolvechoice3) Job.commit() } } ``` Ausgabe: ``` { "Name": "my-testing-job" } ``` Weitere Informationen finden Sie unter [Authoring Jobs in AWS Glue im AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/author-job.html) *Developer Guide*. + Einzelheiten zur API finden Sie [CreateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/create-job.html)in der *AWS CLI Befehlsreferenz.* ### `create-table` Das folgende Codebeispiel zeigt die Verwendung`create-table`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Tabelle für einen Kinesis-Datenstrom** Das folgende `create-table` Beispiel erstellt eine Tabelle im AWS Glue-Datenkatalog, die einen Kinesis-Datenstrom beschreibt. ``` aws glue create-table \ --database-name tempdb \ --table-input '{"Name":"test-kinesis-input", "StorageDescriptor":{ \ "Columns":[ \ {"Name":"sensorid", "Type":"int"}, \ {"Name":"currenttemperature", "Type":"int"}, \ {"Name":"status", "Type":"string"} ], \ "Location":"my-testing-stream", \ "Parameters":{ \ "typeOfData":"kinesis","streamName":"my-testing-stream", \ "kinesisUrl":"https://kinesis.us-east-1.amazonaws.com" \ }, \ "SerdeInfo":{ \ "SerializationLibrary":"org.openx.data.jsonserde.JsonSerDe"} \ }, \ "Parameters":{ \ "classification":"json"} \ }' \ --profile my-profile \ --endpoint https://glue.us-east-1.amazonaws.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Definieren von Tabellen im AWS Glue-Datenkatalog](https://docs.aws.amazon.com/glue/latest/dg/tables-described.html) im *AWS Glue-Entwicklerhandbuch*. **Beispiel 2: So erstellen Sie eine Tabelle für einen Kafka-Datenspeicher** Das folgende `create-table` Beispiel erstellt eine Tabelle im AWS Glue-Datenkatalog, die einen Kafka-Datenspeicher beschreibt. ``` aws glue create-table \ --database-name tempdb \ --table-input '{"Name":"test-kafka-input", "StorageDescriptor":{ \ "Columns":[ \ {"Name":"sensorid", "Type":"int"}, \ {"Name":"currenttemperature", "Type":"int"}, \ {"Name":"status", "Type":"string"} ], \ "Location":"glue-topic", \ "Parameters":{ \ "typeOfData":"kafka","topicName":"glue-topic", \ "connectionName":"my-kafka-connection" }, \ "SerdeInfo":{ \ "SerializationLibrary":"org.apache.hadoop.hive.serde2.OpenCSVSerde"} \ }, \ "Parameters":{ \ "separatorChar":","} \ }' \ --profile my-profile \ --endpoint https://glue.us-east-1.amazonaws.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Definieren von Tabellen im AWS Glue-Datenkatalog](https://docs.aws.amazon.com/glue/latest/dg/tables-described.html) im *AWS Glue-Entwicklerhandbuch*. **Beispiel 3: So erstellen Sie eine Tabelle für einen AWS S3-Datenspeicher** Das folgende `create-table` Beispiel erstellt eine Tabelle im AWS Glue Data Catalog, die einen AWS Simple Storage Service (AWS S3) -Datenspeicher beschreibt. ``` aws glue create-table \ --database-name tempdb \ --table-input '{"Name":"s3-output", "StorageDescriptor":{ \ "Columns":[ \ {"Name":"s1", "Type":"string"}, \ {"Name":"s2", "Type":"int"}, \ {"Name":"s3", "Type":"string"} ], \ "Location":"s3://bucket-path/", \ "SerdeInfo":{ \ "SerializationLibrary":"org.openx.data.jsonserde.JsonSerDe"} \ }, \ "Parameters":{ \ "classification":"json"} \ }' \ --profile my-profile \ --endpoint https://glue.us-east-1.amazonaws.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Definieren von Tabellen im AWS Glue-Datenkatalog](https://docs.aws.amazon.com/glue/latest/dg/tables-described.html) im *AWS Glue-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [CreateTable](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/create-table.html)in der *AWS CLI Befehlsreferenz*. ### `delete-job` Das folgende Codebeispiel zeigt die Verwendung`delete-job`. **AWS CLI** **Einen Auftrag löschen** Das folgende Beispiel für `delete-job` löscht einen Auftrag, der nicht mehr benötigt wird. ``` aws glue delete-job \ --job-name my-testing-job ``` Ausgabe: ``` { "JobName": "my-testing-job" } ``` Weitere Informationen finden Sie unter [Arbeiten mit Jobs auf der AWS Glue-Konsole](https://docs.aws.amazon.com/glue/latest/dg/console-jobs.html) im *AWS Glue-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [DeleteJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/delete-job.html)in der *AWS CLI Befehlsreferenz*. ### `get-databases` Das folgende Codebeispiel zeigt die Verwendung`get-databases`. **AWS CLI** **Um die Definitionen einiger oder aller Datenbanken im AWS Glue-Datenkatalog aufzulisten** Das folgende Beispiel für `get-databases` gibt Informationen über die Datenbanken im Datenkatalog zurück. ``` aws glue get-databases ``` Ausgabe: ``` { "DatabaseList": [ { "Name": "default", "Description": "Default Hive database", "LocationUri": "file:/spark-warehouse", "CreateTime": 1602084052.0, "CreateTableDefaultPermissions": [ { "Principal": { "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS" }, "Permissions": [ "ALL" ] } ], "CatalogId": "111122223333" }, { "Name": "flights-db", "CreateTime": 1587072847.0, "CreateTableDefaultPermissions": [ { "Principal": { "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS" }, "Permissions": [ "ALL" ] } ], "CatalogId": "111122223333" }, { "Name": "legislators", "CreateTime": 1601415625.0, "CreateTableDefaultPermissions": [ { "Principal": { "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS" }, "Permissions": [ "ALL" ] } ], "CatalogId": "111122223333" }, { "Name": "tempdb", "CreateTime": 1601498566.0, "CreateTableDefaultPermissions": [ { "Principal": { "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS" }, "Permissions": [ "ALL" ] } ], "CatalogId": "111122223333" } ] } ``` Weitere Informationen finden Sie unter [Definieren einer Datenbank in Ihrem Datenkatalog](https://docs.aws.amazon.com/glue/latest/dg/define-database.html) im *Entwicklerhandbuch zu AWS Glue*. + Einzelheiten zur API finden Sie [GetDatabases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/get-databases.html)in der *AWS CLI Befehlsreferenz*. ### `get-job-run` Das folgende Codebeispiel zeigt die Verwendung`get-job-run`. **AWS CLI** **Informationen zu einer Auftragsausführung abrufen** Das folgende Beispiel für `get-job-run` ruft Informationen zu einer Auftragsausführung ab. ``` aws glue get-job-run \ --job-name "Combine legistators data" \ --run-id jr_012e176506505074d94d761755e5c62538ee1aad6f17d39f527e9140cf0c9a5e ``` Ausgabe: ``` { "JobRun": { "Id": "jr_012e176506505074d94d761755e5c62538ee1aad6f17d39f527e9140cf0c9a5e", "Attempt": 0, "JobName": "Combine legistators data", "StartedOn": 1602873931.255, "LastModifiedOn": 1602874075.985, "CompletedOn": 1602874075.985, "JobRunState": "SUCCEEDED", "Arguments": { "--enable-continuous-cloudwatch-log": "true", "--enable-metrics": "", "--enable-spark-ui": "true", "--job-bookmark-option": "job-bookmark-enable", "--spark-event-logs-path": "s3://aws-glue-assets-111122223333-us-east-1/sparkHistoryLogs/" }, "PredecessorRuns": [], "AllocatedCapacity": 10, "ExecutionTime": 117, "Timeout": 2880, "MaxCapacity": 10.0, "WorkerType": "G.1X", "NumberOfWorkers": 10, "LogGroupName": "/aws-glue/jobs", "GlueVersion": "2.0" } } ``` Weitere Informationen finden Sie unter [Auftragsausführungen](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-runs.html) im *Entwicklerhandbuch zu AWS Glue*. + Einzelheiten zur API finden Sie [GetJobRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/get-job-run.html)in der *AWS CLI Befehlsreferenz*. ### `get-job-runs` Das folgende Codebeispiel zeigt die Verwendung`get-job-runs`. **AWS CLI** **Informationen über alle Ausführungen eines Auftrags abrufen** Das folgende Beispiel für `get-job-runs` ruft Informationen zu allen Ausführungen eines Auftrags ab. ``` aws glue get-job-runs \ --job-name "my-testing-job" ``` Ausgabe: ``` { "JobRuns": [ { "Id": "jr_012e176506505074d94d761755e5c62538ee1aad6f17d39f527e9140cf0c9a5e", "Attempt": 0, "JobName": "my-testing-job", "StartedOn": 1602873931.255, "LastModifiedOn": 1602874075.985, "CompletedOn": 1602874075.985, "JobRunState": "SUCCEEDED", "Arguments": { "--enable-continuous-cloudwatch-log": "true", "--enable-metrics": "", "--enable-spark-ui": "true", "--job-bookmark-option": "job-bookmark-enable", "--spark-event-logs-path": "s3://aws-glue-assets-111122223333-us-east-1/sparkHistoryLogs/" }, "PredecessorRuns": [], "AllocatedCapacity": 10, "ExecutionTime": 117, "Timeout": 2880, "MaxCapacity": 10.0, "WorkerType": "G.1X", "NumberOfWorkers": 10, "LogGroupName": "/aws-glue/jobs", "GlueVersion": "2.0" }, { "Id": "jr_03cc19ddab11c4e244d3f735567de74ff93b0b3ef468a713ffe73e53d1aec08f_attempt_2", "Attempt": 2, "PreviousRunId": "jr_03cc19ddab11c4e244d3f735567de74ff93b0b3ef468a713ffe73e53d1aec08f_attempt_1", "JobName": "my-testing-job", "StartedOn": 1602811168.496, "LastModifiedOn": 1602811282.39, "CompletedOn": 1602811282.39, "JobRunState": "FAILED", "ErrorMessage": "An error occurred while calling o122.pyWriteDynamicFrame. Access Denied (Service: Amazon S3; Status Code: 403; Error Code: AccessDenied; Request ID: 021AAB703DB20A2D; S3 Extended Request ID: teZk24Y09TkXzBvMPG502L5VJBhe9DJuWA9/TXtuGOqfByajkfL/Tlqt5JBGdEGpigAqzdMDM/U=)", "PredecessorRuns": [], "AllocatedCapacity": 10, "ExecutionTime": 110, "Timeout": 2880, "MaxCapacity": 10.0, "WorkerType": "G.1X", "NumberOfWorkers": 10, "LogGroupName": "/aws-glue/jobs", "GlueVersion": "2.0" }, { "Id": "jr_03cc19ddab11c4e244d3f735567de74ff93b0b3ef468a713ffe73e53d1aec08f_attempt_1", "Attempt": 1, "PreviousRunId": "jr_03cc19ddab11c4e244d3f735567de74ff93b0b3ef468a713ffe73e53d1aec08f", "JobName": "my-testing-job", "StartedOn": 1602811020.518, "LastModifiedOn": 1602811138.364, "CompletedOn": 1602811138.364, "JobRunState": "FAILED", "ErrorMessage": "An error occurred while calling o122.pyWriteDynamicFrame. Access Denied (Service: Amazon S3; Status Code: 403; Error Code: AccessDenied; Request ID: 2671D37856AE7ABB; S3 Extended Request ID: RLJCJw20brV+PpC6GpORahyF2fp9flB5SSb2bTGPnUSPVizLXRl1PN3QZldb+v1o9qRVktNYbW8=)", "PredecessorRuns": [], "AllocatedCapacity": 10, "ExecutionTime": 113, "Timeout": 2880, "MaxCapacity": 10.0, "WorkerType": "G.1X", "NumberOfWorkers": 10, "LogGroupName": "/aws-glue/jobs", "GlueVersion": "2.0" } ] } ``` Weitere Informationen finden Sie unter [Auftragsausführungen](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-runs.html) im *Entwicklerhandbuch zu AWS Glue*. + Einzelheiten zur API finden Sie [GetJobRuns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/get-job-runs.html)in der *AWS CLI Befehlsreferenz*. ### `get-job` Das folgende Codebeispiel zeigt die Verwendung`get-job`. **AWS CLI** **Informationen zu einem Auftrag abrufen** Das folgende Beispiel für `get-job` ruft Informationen zu einem Auftrag ab. ``` aws glue get-job \ --job-name my-testing-job ``` Ausgabe: ``` { "Job": { "Name": "my-testing-job", "Role": "Glue_DefaultRole", "CreatedOn": 1602805698.167, "LastModifiedOn": 1602805698.167, "ExecutionProperty": { "MaxConcurrentRuns": 1 }, "Command": { "Name": "gluestreaming", "ScriptLocation": "s3://janetst-bucket-01/Scripts/test_script.scala", "PythonVersion": "2" }, "DefaultArguments": { "--class": "GlueApp", "--job-language": "scala" }, "MaxRetries": 0, "AllocatedCapacity": 10, "MaxCapacity": 10.0, "GlueVersion": "1.0" } } ``` Weitere Informationen finden Sie unter [Aufträge](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html) im *Entwicklerhandbuch zu AWS Glue*. + Einzelheiten zur API finden Sie [GetJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/get-job.html)in der *AWS CLI Befehlsreferenz*. ### `get-plan` Das folgende Codebeispiel zeigt die Verwendung`get-plan`. **AWS CLI** **So rufen Sie den generierten Code für die Zuweisung von Daten aus Quelltabellen zu Zieltabellen ab** Im folgenden Beispiel für `get-plan` wird der generierte Code für die Zuweisung von Spalten aus der Datenquelle zum Datenziel abgerufen. ``` aws glue get-plan --mapping '[ \ { \ "SourcePath":"sensorid", \ "SourceTable":"anything", \ "SourceType":"int", \ "TargetPath":"sensorid", \ "TargetTable":"anything", \ "TargetType":"int" \ }, \ { \ "SourcePath":"currenttemperature", \ "SourceTable":"anything", \ "SourceType":"int", \ "TargetPath":"currenttemperature", \ "TargetTable":"anything", \ "TargetType":"int" \ }, \ { \ "SourcePath":"status", \ "SourceTable":"anything", \ "SourceType":"string", \ "TargetPath":"status", \ "TargetTable":"anything", \ "TargetType":"string" \ }]' \ --source '{ \ "DatabaseName":"tempdb", \ "TableName":"s3-source" \ }' \ --sinks '[ \ { \ "DatabaseName":"tempdb", \ "TableName":"my-s3-sink" \ }]' --language "scala" --endpoint https://glue.us-east-1.amazonaws.com --output "text" ``` Ausgabe: ``` import com.amazonaws.services.glue.ChoiceOption import com.amazonaws.services.glue.GlueContext import com.amazonaws.services.glue.MappingSpec import com.amazonaws.services.glue.ResolveSpec import com.amazonaws.services.glue.errors.CallSite import com.amazonaws.services.glue.util.GlueArgParser import com.amazonaws.services.glue.util.Job import com.amazonaws.services.glue.util.JsonOptions import org.apache.spark.SparkContext import scala.collection.JavaConverters._ object GlueApp { def main(sysArgs: Array[String]) { val spark: SparkContext = new SparkContext() val glueContext: GlueContext = new GlueContext(spark) // @params: [JOB_NAME] val args = GlueArgParser.getResolvedOptions(sysArgs, Seq("JOB_NAME").toArray) Job.init(args("JOB_NAME"), glueContext, args.asJava) // @type: DataSource // @args: [database = "tempdb", table_name = "s3-source", transformation_ctx = "datasource0"] // @return: datasource0 // @inputs: [] val datasource0 = glueContext.getCatalogSource(database = "tempdb", tableName = "s3-source", redshiftTmpDir = "", transformationContext = "datasource0").getDynamicFrame() // @type: ApplyMapping // @args: [mapping = [("sensorid", "int", "sensorid", "int"), ("currenttemperature", "int", "currenttemperature", "int"), ("status", "string", "status", "string")], transformation_ctx = "applymapping1"] // @return: applymapping1 // @inputs: [frame = datasource0] val applymapping1 = datasource0.applyMapping(mappings = Seq(("sensorid", "int", "sensorid", "int"), ("currenttemperature", "int", "currenttemperature", "int"), ("status", "string", "status", "string")), caseSensitive = false, transformationContext = "applymapping1") // @type: SelectFields // @args: [paths = ["sensorid", "currenttemperature", "status"], transformation_ctx = "selectfields2"] // @return: selectfields2 // @inputs: [frame = applymapping1] val selectfields2 = applymapping1.selectFields(paths = Seq("sensorid", "currenttemperature", "status"), transformationContext = "selectfields2") // @type: ResolveChoice // @args: [choice = "MATCH_CATALOG", database = "tempdb", table_name = "my-s3-sink", transformation_ctx = "resolvechoice3"] // @return: resolvechoice3 // @inputs: [frame = selectfields2] val resolvechoice3 = selectfields2.resolveChoice(choiceOption = Some(ChoiceOption("MATCH_CATALOG")), database = Some("tempdb"), tableName = Some("my-s3-sink"), transformationContext = "resolvechoice3") // @type: DataSink // @args: [database = "tempdb", table_name = "my-s3-sink", transformation_ctx = "datasink4"] // @return: datasink4 // @inputs: [frame = resolvechoice3] val datasink4 = glueContext.getCatalogSink(database = "tempdb", tableName = "my-s3-sink", redshiftTmpDir = "", transformationContext = "datasink4").writeDynamicFrame(resolvechoice3) Job.commit() } } ``` Weitere Informationen finden Sie unter [Editing Scripts in AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/edit-script.html) im *AWS Glue Developer Guide*. + Einzelheiten zur API finden Sie [GetPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/get-plan.html)in der *AWS CLI Befehlsreferenz*. ### `get-tables` Das folgende Codebeispiel zeigt die Verwendung`get-tables`. **AWS CLI** **Die Definitionen einiger oder aller Tabellen in der angegebenen Datenbank auflisten** Das folgende Beispiel für `get-tables` gibt Informationen zu den Tabellen in der angegebenen Datenbank zurück. ``` aws glue get-tables --database-name 'tempdb' ``` Ausgabe: ``` { "TableList": [ { "Name": "my-s3-sink", "DatabaseName": "tempdb", "CreateTime": 1602730539.0, "UpdateTime": 1602730539.0, "Retention": 0, "StorageDescriptor": { "Columns": [ { "Name": "sensorid", "Type": "int" }, { "Name": "currenttemperature", "Type": "int" }, { "Name": "status", "Type": "string" } ], "Location": "s3://janetst-bucket-01/test-s3-output/", "Compressed": false, "NumberOfBuckets": 0, "SerdeInfo": { "SerializationLibrary": "org.openx.data.jsonserde.JsonSerDe" }, "SortColumns": [], "StoredAsSubDirectories": false }, "Parameters": { "classification": "json" }, "CreatedBy": "arn:aws:iam::007436865787:user/JRSTERN", "IsRegisteredWithLakeFormation": false, "CatalogId": "007436865787" }, { "Name": "s3-source", "DatabaseName": "tempdb", "CreateTime": 1602730658.0, "UpdateTime": 1602730658.0, "Retention": 0, "StorageDescriptor": { "Columns": [ { "Name": "sensorid", "Type": "int" }, { "Name": "currenttemperature", "Type": "int" }, { "Name": "status", "Type": "string" } ], "Location": "s3://janetst-bucket-01/", "Compressed": false, "NumberOfBuckets": 0, "SortColumns": [], "StoredAsSubDirectories": false }, "Parameters": { "classification": "json" }, "CreatedBy": "arn:aws:iam::007436865787:user/JRSTERN", "IsRegisteredWithLakeFormation": false, "CatalogId": "007436865787" }, { "Name": "test-kinesis-input", "DatabaseName": "tempdb", "CreateTime": 1601507001.0, "UpdateTime": 1601507001.0, "Retention": 0, "StorageDescriptor": { "Columns": [ { "Name": "sensorid", "Type": "int" }, { "Name": "currenttemperature", "Type": "int" }, { "Name": "status", "Type": "string" } ], "Location": "my-testing-stream", "Compressed": false, "NumberOfBuckets": 0, "SerdeInfo": { "SerializationLibrary": "org.openx.data.jsonserde.JsonSerDe" }, "SortColumns": [], "Parameters": { "kinesisUrl": "https://kinesis.us-east-1.amazonaws.com", "streamName": "my-testing-stream", "typeOfData": "kinesis" }, "StoredAsSubDirectories": false }, "Parameters": { "classification": "json" }, "CreatedBy": "arn:aws:iam::007436865787:user/JRSTERN", "IsRegisteredWithLakeFormation": false, "CatalogId": "007436865787" } ] } ``` Weitere Informationen finden Sie unter [Definieren von Tabellen im AWS Glue-Datenkatalog](https://docs.aws.amazon.com/glue/latest/dg/tables-described.html) im *AWS Glue-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [GetTables](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/get-tables.html)in der *AWS CLI Befehlsreferenz*. ### `start-crawler` Das folgende Codebeispiel zeigt die Verwendung`start-crawler`. **AWS CLI** **Einen Crawler starten** Das folgende Beispiel für `start-crawler` startet einen Crawler. ``` aws glue start-crawler --name my-crawler ``` Ausgabe: ``` None ``` Weitere Informationen finden Sie unter [Definieren von Crawlern](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html) im *Entwicklerhandbuch zu AWS Glue*. + Einzelheiten zur API finden Sie [StartCrawler](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/start-crawler.html)in der *AWS CLI Befehlsreferenz*. ### `start-job-run` Das folgende Codebeispiel zeigt die Verwendung`start-job-run`. **AWS CLI** **Die Auftragsausführung starten** Das folgende Beispiel für `start-job-run` startet die Ausführung eines Auftrags. ``` aws glue start-job-run \ --job-name my-job ``` Ausgabe: ``` { "JobRunId": "jr_22208b1f44eb5376a60569d4b21dd20fcb8621e1a366b4e7b2494af764b82ded" } ``` Weitere Informationen finden Sie unter [Autorisieren von Aufträgen](https://docs.aws.amazon.com/glue/latest/dg/author-job.html) im *Entwicklerhandbuch zu AWS Glue*. + Einzelheiten zur API finden Sie [StartJobRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/start-job-run.html)in der *AWS CLI Befehlsreferenz*. # GuardDuty Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren GuardDuty. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `accept-invitation` Das folgende Codebeispiel zeigt, wie Sie`accept-invitation`. **AWS CLI** **Um eine Einladung anzunehmen, ein GuardDuty Mitgliedskonto in der aktuellen Region zu werden** Das folgende `accept-invitation` Beispiel zeigt, wie Sie eine Einladung annehmen, ein GuardDuty Mitgliedskonto in der aktuellen Region zu werden. ``` aws guardduty accept-invitation \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --master-id 123456789111 \ --invitation-id d6b94fb03a66ff665f7db8764example ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im GuardDuty Benutzerhandbuch [unter GuardDuty Konten auf Einladung verwalten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_invitations.html). + Einzelheiten zur API finden Sie [AcceptInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/accept-invitation.html)in der *AWS CLI Befehlsreferenz*. ### `archive-findings` Das folgende Codebeispiel zeigt die Verwendung`archive-findings`. **AWS CLI** **So archivieren Sie Erkenntnisse in der aktuellen Region** Dieses Beispiel für `archive-findings` zeigt, wie Erkenntnisse in der aktuellen Region archiviert werden. ``` aws guardduty archive-findings \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --finding-ids d6b94fb03a66ff665f7db8764example 3eb970e0de00c16ec14e6910fexample ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Unterdrückungsregeln erstellen](https://docs.aws.amazon.com/guardduty/latest/ug/findings_suppression-rules-console.html). + Einzelheiten zur API finden Sie [ArchiveFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/archive-findings.html)in der *AWS CLI Befehlsreferenz*. ### `create-detector` Das folgende Codebeispiel zeigt die Verwendung`create-detector`. **AWS CLI** **Um es GuardDuty in der aktuellen Region zu aktivieren** Dieses Beispiel zeigt, wie ein neuer Detektor, der aktiviert wird GuardDuty, in der aktuellen Region erstellt wird. : ``` aws guardduty create-detector \ --enable ``` Ausgabe: ``` { "DetectorId": "b6b992d6d2f48e64bc59180bfexample" } ``` Weitere Informationen finden Sie GuardDuty im *GuardDuty Benutzerhandbuch* unter [Amazon aktivieren](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_settingup.html#guardduty_enable-gd). + Einzelheiten zur API finden Sie [CreateDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/create-detector.html)in der *AWS CLI Befehlsreferenz*. ### `create-filter` Das folgende Codebeispiel zeigt die Verwendung`create-filter`. **AWS CLI** **Beispiel 1: So erstellen Sie einen neuen Filter in der aktuellen Region** Im folgenden Beispiel für `create-filter` wird ein Filter erstellt, der allen Portscan-Erkenntnissen entspricht, die beispielsweise aus einem bestimmten Bild erstellt wurden. Die Erkenntnisse werden dadurch nicht unterdrückt. ``` aws guardduty create-filter \ --detector-id b6b992d6d2f48e64bc59180bfexample \ --name myFilterExample \ --finding-criteria '{"Criterion": {"type": {"Eq": ["Recon:EC2/Portscan"]},"resource.instanceDetails.imageId": {"Eq": ["ami-0a7a207083example"]}}}' ``` Ausgabe: ``` { "Name": "myFilterExample" } ``` Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Filtern von GuardDuty Ergebnissen](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_filter-findings.html). **Beispiel 2: So erstellen Sie einen neuen Filter und unterdrücken Erkenntnisse in der aktuellen Region** Im folgenden Beispiel für `create-filter` wird ein Filter erstellt, der allen Portscan-Erkenntnissen entspricht, die beispielsweise aus einem bestimmten Bild erstellt wurden. Dieser Filter archiviert diese Erkenntnisse, sodass sie nicht in Ihren aktuellen Erkenntnissen erscheinen. ``` aws guardduty create-filter \ --detector-id b6b992d6d2f48e64bc59180bfexample \ --action ARCHIVE \ --name myFilterSecondExample \ --finding-criteria '{"Criterion": {"type": {"Eq": ["Recon:EC2/Portscan"]},"resource.instanceDetails.imageId": {"Eq": ["ami-0a7a207083example"]}}}' ``` Ausgabe: ``` { "Name": "myFilterSecondExample" } ``` Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Filtern von GuardDuty Ergebnissen](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_filter-findings.html). + Einzelheiten zur API finden Sie [CreateFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/create-filter.html)in der *AWS CLI Befehlsreferenz*. ### `create-ip-set` Das folgende Codebeispiel zeigt die Verwendung`create-ip-set`. **AWS CLI** **So erstellen und aktivieren Sie ein vertrauenswürdiges IP-Set** Im folgenden Beispiel für `create-ip-set` wird ein vertrauenswürdiges IP-Set in der aktuellen Region erstellt und aktiviert. ``` aws guardduty create-ip-set \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --name new-ip-set-example \ --format TXT \ --location s3://amzn-s3-demo-bucket/customtrustlist.csv \ --activate ``` Ausgabe: ``` { "IpSetId": "d4b94fc952d6912b8f3060768example" } ``` Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Arbeiten mit Listen vertrauenswürdiger IP-Adressen und Bedrohungslisten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_upload_lists.html). + Einzelheiten zur API finden Sie [CreateIpSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/create-ip-set.html)unter *AWS CLI Befehlsreferenz*. ### `create-members` Das folgende Codebeispiel zeigt die Verwendung`create-members`. **AWS CLI** **Um ein neues Mitglied mit Ihrem GuardDuty Hauptkonto in der aktuellen Region zu verknüpfen.** Dieses Beispiel zeigt, wie Mitgliedskonten so verknüpft werden, dass sie vom Girokonto als GuardDuty Hauptkonto verwaltet werden. ``` aws guardduty create-members --detector-id b6b992d6d2f48e64bc59180bfexample \ --account-details AccountId=111122223333,Email=first+member@example.com AccountId=111111111111 ,Email=another+member@example.com ``` Ausgabe: ``` { "UnprocessedAccounts": [] } ``` Weitere Informationen finden Sie im GuardDuty Benutzerhandbuch unter [Mehrere Konten verwalten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_accounts.html). + Einzelheiten zur API finden Sie [CreateMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/create-members.html)in der *AWS CLI Befehlsreferenz*. ### `create-publishing-destination` Das folgende Codebeispiel zeigt die Verwendung`create-publishing-destination`. **AWS CLI** **Um ein Veröffentlichungsziel zu erstellen, in das GuardDuty Ergebnisse in der aktuellen Region exportiert werden sollen.** Das folgende `create-publishing-destination` Beispiel zeigt, wie Sie ein Veröffentlichungsziel für den Export aktueller (nicht archivierter) GuardDuty Ergebnisse einrichten, um den Überblick über historische Ergebnisdaten zu behalten. ``` aws guardduty create-publishing-destination \ --detector-id b6b992d6d2f48e64bc59180bfexample \ --destination-type S3 \ --destination-properties 'DestinationArn=arn:aws:s3:::amzn-s3-demo-bucket,KmsKeyArn=arn:aws:kms:us-west-1:111122223333:key/84cee9c5-dea1-401a-ab6d-e1de7example' ``` Ausgabe: ``` { "DestinationId": "46b99823849e1bbc242dfbe3cexample" } ``` Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Exportieren generierter GuardDuty Ergebnisse in Amazon S3 S3-Buckets](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_exportfindings.html). + Einzelheiten zur API finden Sie [CreatePublishingDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/create-publishing-destination.html)in der *AWS CLI Befehlsreferenz.* ### `create-sample-findings` Das folgende Codebeispiel zeigt die Verwendung`create-sample-findings`. **AWS CLI** **Um GuardDuty Beispielergebnisse in der aktuellen Region zu erstellen.** Dieses Beispiel zeigt, wie Sie eine Beispiel-Erkenntnis für die bereitgestellten Typen erstellen. ``` aws guardduty create-sample-findings \ --detector-id b6b992d6d2f48e64bc59180bfexample \ --finding-types UnauthorizedAccess:EC2/TorClient UnauthorizedAccess:EC2/TorRelay ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Beispielergebnisse](https://docs.aws.amazon.com/guardduty/latest/ug/sample_findings.html) im *GuardDuty Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateSampleFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/create-sample-findings.html)in der *AWS CLI Befehlsreferenz*. ### `create-threat-intel-set` Das folgende Codebeispiel zeigt die Verwendung`create-threat-intel-set`. **AWS CLI** **So erstellen und aktivieren Sie ein neues Threat-Intelligence-Set** Im folgenden Beispiel für `create-threat-intel-set` wird ein Threat-Intelligence-Set in der aktuellen Region erstellt und aktiviert. ``` aws guardduty create-threat-intel-set \ --detector-id b6b992d6d2f48e64bc59180bfexample \ --name myThreatSet-example \ --format TXT \ --location s3://amzn-s3-demo-bucket/threatlist.csv \ --activate ``` Ausgabe: ``` { "ThreatIntelSetId": "20b9a4691aeb33506b808878cexample" } ``` Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Arbeiten mit Listen vertrauenswürdiger IP-Adressen und Bedrohungslisten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_upload_lists.html). + Einzelheiten zur API finden Sie [CreateThreatIntelSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/create-threat-intel-set.html)unter *AWS CLI Befehlsreferenz*. ### `decline-invitations` Das folgende Codebeispiel zeigt die Verwendung`decline-invitations`. **AWS CLI** **So lehnen Sie die Einladung, GuardDuty von einem anderen Konto in der aktuellen Region verwalten zu lassen, ab.** Dieses Beispiel zeigt, wie Sie eine Einladung zur Mitgliedschaft ablehnen. ``` aws guardduty decline-invitations \ --account-ids 111122223333 ``` Ausgabe: ``` { "UnprocessedAccounts": [] } ``` Weitere Informationen finden Sie im GuardDuty Benutzerhandbuch [unter GuardDuty Konten auf Einladung verwalten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_invitations.html). + Einzelheiten zur API finden Sie [DeclineInvitations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/decline-invitations.html)in der *AWS CLI Befehlsreferenz*. ### `delete-detector` Das folgende Codebeispiel zeigt die Verwendung`delete-detector`. **AWS CLI** **Um einen Detektor in der aktuellen Region zu löschen und zu deaktivieren GuardDuty.** Dieses Beispiel zeigt, wie ein Detektor gelöscht wird. Wenn dies erfolgreich ist, wird dies GuardDuty in der Region deaktiviert, die diesem Detektor zugeordnet ist. ``` aws guardduty delete-detector \ --detector-id b6b992d6d2f48e64bc59180bfexample ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie GuardDuty im *GuardDuty Benutzerhandbuch* unter [Sperren oder Deaktivieren](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_suspend-disable.html). + Einzelheiten zur API finden Sie [DeleteDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/delete-detector.html)in der *AWS CLI Befehlsreferenz*. ### `delete-filter` Das folgende Codebeispiel zeigt die Verwendung`delete-filter`. **AWS CLI** **So löschen Sie einen vorhandenen Filter in der aktuellen Region** In diesem Beispiel wird gezeigt, wie Sie einen Filter erstellen und löschen. ``` aws guardduty delete-filter \ --detector-id b6b992d6d2f48e64bc59180bfexample \ --filter-name byebyeFilter ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im GuardDuty Benutzerhandbuch unter [Filtern von Ergebnissen](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_filter-findings.html). + Einzelheiten zur API finden Sie [DeleteFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/delete-filter.html)in der *AWS CLI Befehlsreferenz*. ### `disable-organization-admin-account` Das folgende Codebeispiel zeigt die Verwendung`disable-organization-admin-account`. **AWS CLI** **Um ein Konto als delegierter Administrator für Ihre GuardDuty Organisation zu entfernen** Dieses Beispiel zeigt, wie Sie ein Konto als delegierter Administrator für entfernen. GuardDuty ``` aws guardduty disable-organization-admin-account \ --admin-account-id 111122223333 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Konten bei AWS Organisationen verwalten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_organizations.html). + Einzelheiten zur API finden Sie [DisableOrganizationAdminAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/disable-organization-admin-account.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-from-master-account` Das folgende Codebeispiel zeigt die Verwendung`disassociate-from-master-account`. **AWS CLI** **So heben Sie die Verbindung zu Ihrem aktuellen Administratorkonto in der aktuellen Region auf** Im folgenden `disassociate-from-master-account` Beispiel wird Ihr Konto vom aktuellen GuardDuty Administratorkonto in der aktuellen AWS Region getrennt. ``` aws guardduty disassociate-from-master-account \ --detector-id d4b040365221be2b54a6264dcexample ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [im *Benutzerhandbuch* unter Grundlegendes zur Beziehung zwischen GuardDuty Administratorkonto und Mitgliedskonten](https://docs.aws.amazon.com/guardduty/latest/ug/administrator_member_relationships.html). GuardDuty + Einzelheiten zur API finden Sie [DisassociateFromMasterAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/disassociate-from-master-account.html)unter *AWS CLI Befehlsreferenz*. ### `get-detector` Das folgende Codebeispiel zeigt die Verwendung`get-detector`. **AWS CLI** **So rufen Sie Details zu einem bestimmten Detektor ab** Im folgenden Beispiel für `get-detector` werden die Konfigurationsdetails zum angegebenen Detektor angezeigt. ``` aws guardduty get-detector \ --detector-id 12abc34d567e8fa901bc2d34eexample ``` Ausgabe: ``` { "Status": "ENABLED", "ServiceRole": "arn:aws:iam::111122223333:role/aws-service-role/guardduty.amazonaws.com/AWSServiceRoleForAmazonGuardDuty", "Tags": {}, "FindingPublishingFrequency": "SIX_HOURS", "UpdatedAt": "2018-11-07T03:24:22.938Z", "CreatedAt": "2017-12-22T22:51:31.940Z" } ``` Weitere Informationen finden Sie im GuardDuty Benutzerhandbuch unter [Konzepte und Terminologie](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_concepts.html). + Einzelheiten zur API finden Sie [GetDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/get-detector.html)in der *AWS CLI Befehlsreferenz*. ### `get-findings` Das folgende Codebeispiel zeigt die Verwendung`get-findings`. **AWS CLI** **Beispiel 1: So rufen Sie die Details zu einer bestimmten Erkenntnis ab** Im folgenden Beispiel für `get-findings` werden die vollständigen JSON-Erkenntnisdetails zum angegebenen Erkenntnis abgerufen. ``` aws guardduty get-findings \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --finding-id 1ab92989eaf0e742df4a014d5example ``` Ausgabe: ``` { "Findings": [ { "Resource": { "ResourceType": "AccessKey", "AccessKeyDetails": { "UserName": "testuser", "UserType": "IAMUser", "PrincipalId": "AIDACKCEVSQ6C2EXAMPLE", "AccessKeyId": "ASIASZ4SI7REEEXAMPLE" } }, "Description": "APIs commonly used to discover the users, groups, policies and permissions in an account, was invoked by IAM principal testuser under unusual circumstances. Such activity is not typically seen from this principal.", "Service": { "Count": 5, "Archived": false, "ServiceName": "guardduty", "EventFirstSeen": "2020-05-26T22:02:24Z", "ResourceRole": "TARGET", "EventLastSeen": "2020-05-26T22:33:55Z", "DetectorId": "d4b040365221be2b54a6264dcexample", "Action": { "ActionType": "AWS_API_CALL", "AwsApiCallAction": { "RemoteIpDetails": { "GeoLocation": { "Lat": 51.5164, "Lon": -0.093 }, "City": { "CityName": "London" }, "IpAddressV4": "52.94.36.7", "Organization": { "Org": "Amazon.com", "Isp": "Amazon.com", "Asn": "16509", "AsnOrg": "AMAZON-02" }, "Country": { "CountryName": "United Kingdom" } }, "Api": "ListPolicyVersions", "ServiceName": "iam.amazonaws.com", "CallerType": "Remote IP" } } }, "Title": "Unusual user permission reconnaissance activity by testuser.", "Type": "Recon:IAMUser/UserPermissions", "Region": "us-east-1", "Partition": "aws", "Arn": "arn:aws:guardduty:us-east-1:111122223333:detector/d4b040365221be2b54a6264dcexample/finding/1ab92989eaf0e742df4a014d5example", "UpdatedAt": "2020-05-26T22:55:21.703Z", "SchemaVersion": "2.0", "Severity": 5, "Id": "1ab92989eaf0e742df4a014d5example", "CreatedAt": "2020-05-26T22:21:48.385Z", "AccountId": "111122223333" } ] } ``` Weitere Informationen finden Sie unter [Ergebnisse](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_findings.html) im GuardDuty Benutzerhandbuch. + Einzelheiten zur API finden Sie [GetFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/get-findings.html)in der *AWS CLI Befehlsreferenz*. ### `get-ip-set` Das folgende Codebeispiel zeigt die Verwendung`get-ip-set`. **AWS CLI** **So listen Sie die Details zu einem bestimmten vertrauenswürdigen IP-Set auf** Das folgende Beispiel für `get-ip-set` zeigt den Status und die Details zum angegebenen vertrauenswürdigen IP-Set. ``` aws guardduty get-ip-set \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --ip-set-id d4b94fc952d6912b8f3060768example ``` Ausgabe: ``` { "Status": "ACTIVE", "Location": "s3://amzn-s3-demo-bucket.s3-us-west-2.amazonaws.com/customlist.csv", "Tags": {}, "Format": "TXT", "Name": "test-ip-set-example" } ``` Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Arbeiten mit Listen vertrauenswürdiger IP-Adressen und Bedrohungslisten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_upload_lists.html). + Einzelheiten zur API finden Sie [GetIpSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/get-ip-set.html)unter *AWS CLI Befehlsreferenz*. ### `get-master-account` Das folgende Codebeispiel zeigt die Verwendung`get-master-account`. **AWS CLI** **So rufen Sie Details zu Ihrem Masterkonto in der aktuellen Region ab** Im folgenden Beispiel für `get-master-account` werden der Status und die Details zu dem Masterkonto angezeigt, das mit Ihrem Detektor in der aktuellen Region verknüpft ist. ``` aws guardduty get-master-account \ --detector-id 12abc34d567e8fa901bc2d34eexample ``` Ausgabe: ``` { "Master": { "InvitationId": "04b94d9704854a73f94e061e8example", "InvitedAt": "2020-06-09T22:23:04.970Z", "RelationshipStatus": "Enabled", "AccountId": "111122223333" } } ``` Weitere Informationen finden Sie [im *Benutzerhandbuch* unter Grundlegendes zur Beziehung zwischen GuardDuty Administratorkonto und Mitgliedskonto](https://docs.aws.amazon.com/guardduty/latest/ug/administrator_member_relationships.html). GuardDuty + Einzelheiten zur API finden Sie [GetMasterAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/get-master-account.html)unter *AWS CLI Befehlsreferenz*. ### `list-detectors` Das folgende Codebeispiel zeigt die Verwendung`list-detectors`. **AWS CLI** **So listen Sie die verfügbaren Detektoren in der aktuellen Region auf** Das folgende `list-detectors` Beispiel listet die verfügbaren Melder in Ihrer aktuellen AWS Region auf. ``` aws guardduty list-detectors ``` Ausgabe: ``` { "DetectorIds": [ "12abc34d567e8fa901bc2d34eexample" ] } ``` Weitere Informationen finden Sie im GuardDuty Benutzerhandbuch unter [Konzepte und Terminologie](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_concepts.html). + Einzelheiten zur API finden Sie [ListDetectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/list-detectors.html)in der *AWS CLI Befehlsreferenz*. ### `list-findings` Das folgende Codebeispiel zeigt die Verwendung`list-findings`. **AWS CLI** **Beispiel 1: So listen Sie alle Erkenntnisse für die aktuelle Region auf** Im folgenden Beispiel für `list-findings` wird eine Liste aller Erkenntnis-IDs für die aktuelle Region angezeigt, absteigend sortiert nach Schweregrad. ``` aws guardduty list-findings \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --sort-criteria '{"AttributeName": "severity","OrderBy":"DESC"}' ``` Ausgabe: ``` { "FindingIds": [ "04b8ab50fd29c64fc771b232dexample", "5ab8ab50fd21373735c826d3aexample", "90b93de7aba69107f05bbe60bexample", ... ] } ``` Weitere Informationen finden Sie unter [Ergebnisse](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_findings.html) im GuardDuty Benutzerhandbuch. **Beispiel 2: So listen Sie Erkenntnisse für die aktuelle Region auf, die einem bestimmten Erkenntniskriterium entsprechen** Im folgenden Beispiel für `list-findings` wird eine Liste aller Erkenntnis-IDs angezeigt, die einem angegebenen Erkenntnistyp entsprechen. ``` aws guardduty list-findings \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --finding-criteria '{"Criterion":{"type": {"Eq":["UnauthorizedAccess:EC2/SSHBruteForce"]}}}' ``` Ausgabe: ``` { "FindingIds": [ "90b93de7aba69107f05bbe60bexample", "6eb9430d7023d30774d6f05e3example", "2eb91a2d060ac9a21963a5848example", "44b8ab50fd2b0039a9e48f570example", "9eb8ab4cd2b7e5b66ba4f5e96example", "e0b8ab3a38e9b0312cc390ceeexample" ] } ``` Weitere Informationen finden Sie unter [Ergebnisse](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_findings.html) im GuardDuty Benutzerhandbuch. **Beispiel 3: So listen Sie Erkenntnisse für die aktuelle Region auf, die einem bestimmten Set von innerhalb einer JSON-Datei definierten Erkenntniskriterien entsprechen** Im folgenden Beispiel für `list-findings` wird eine Liste aller Erkenntnis-IDs angezeigt, die nicht archiviert wurden und an denen der IAM-Benutzer mit dem Namen „testuser“ beteiligt ist, wie in einer JSON-Datei angegeben. ``` aws guardduty list-findings \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --finding-criteria file://myfile.json ``` Inhalt von `myfile.json`: ``` {"Criterion": { "resource.accessKeyDetails.userName":{ "Eq":[ "testuser" ] }, "service.archived": { "Eq": [ "false" ] } } } ``` Ausgabe: ``` { "FindingIds": [ "1ab92989eaf0e742df4a014d5example" ] } ``` Weitere Informationen finden Sie unter [Ergebnisse](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_findings.html) im GuardDuty Benutzerhandbuch. + Einzelheiten zur API finden Sie [ListFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/list-findings.html)in der *AWS CLI Befehlsreferenz*. ### `list-invitations` Das folgende Codebeispiel zeigt die Verwendung`list-invitations`. **AWS CLI** **So listen Sie Details zu Ihren Einladungen, ein Mitgliedskonto in der aktuellen Region zu führen, auf** Das folgende `list-invitations` Beispiel listet Details und Status Ihrer Einladungen auf, ein GuardDuty Mitgliedskonto in der aktuellen Region zu werden. ``` aws guardduty list-invitations ``` Ausgabe: ``` { "Invitations": [ { "InvitationId": "d6b94fb03a66ff665f7db8764example", "InvitedAt": "2020-06-10T17:56:38.221Z", "RelationshipStatus": "Invited", "AccountId": "123456789111" } ] } ``` Weitere Informationen finden Sie im GuardDuty Benutzerhandbuch [unter GuardDuty Konten auf Einladung verwalten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_invitations.html). + Einzelheiten zur API finden Sie [ListInvitations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/list-invitations.html)in der *AWS CLI Befehlsreferenz*. ### `list-ip-sets` Das folgende Codebeispiel zeigt die Verwendung`list-ip-sets`. **AWS CLI** **So listen Sie vertrauenswürdige IP-Sets in der aktuellen Region auf** Das folgende `list-ip-sets` Beispiel listet die vertrauenswürdigen IP-Sätze in Ihrer aktuellen AWS Region auf. ``` aws guardduty list-ip-sets \ --detector-id 12abc34d567e8fa901bc2d34eexample ``` Ausgabe: ``` { "IpSetIds": [ "d4b94fc952d6912b8f3060768example" ] } ``` Weitere Informationen finden Sie im GuardDuty Benutzerhandbuch unter [Arbeiten mit Listen vertrauenswürdiger IP-Adressen und Bedrohungslisten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_upload_lists.html). + Einzelheiten zur API finden Sie [ListIpSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/list-ip-sets.html)unter *AWS CLI Befehlsreferenz*. ### `list-members` Das folgende Codebeispiel zeigt die Verwendung`list-members`. **AWS CLI** **Beispiel 1: So listen Sie nur aktuelle Mitglieder in der aktuellen Region auf** Im folgenden `list-members` Beispiel werden nur aktuelle Mitgliedskonten, die dem GuardDuty Administratorkonto zugeordnet sind, in der aktuellen Region aufgeführt und detailliert dargestellt. ``` aws guardduty list-members \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --only-associated="true" ``` Ausgabe: ``` { "Members": [ { "RelationshipStatus": "Enabled", "InvitedAt": "2020-06-09T22:49:00.910Z", "MasterId": "111122223333", "DetectorId": "7ab8b2f61b256c87f793f6a86example", "UpdatedAt": "2020-06-09T23:08:22.512Z", "Email": "your+member@example.com", "AccountId": "123456789012" } ] } ``` Weitere Informationen finden Sie [im *Benutzerhandbuch* unter Grundlegendes zur Beziehung zwischen GuardDuty Administratorkonto und Mitgliedskonten](https://docs.aws.amazon.com/guardduty/latest/ug/administrator_member_relationships.html). GuardDuty **Beispiel 2: So listen Sie alle Mitglieder in der aktuellen Region auf** Im folgenden `list-members` Beispiel werden alle Mitgliedskonten in der aktuellen Region aufgeführt und detailliert dargestellt, einschließlich der Konten, deren Zuordnung aufgehoben wurde oder die Einladung des GuardDuty Administrators noch nicht angenommen haben. ``` aws guardduty list-members \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --only-associated="false" ``` Ausgabe: ``` { "Members": [ { "RelationshipStatus": "Enabled", "InvitedAt": "2020-06-09T22:49:00.910Z", "MasterId": "111122223333", "DetectorId": "7ab8b2f61b256c87f793f6a86example", "UpdatedAt": "2020-06-09T23:08:22.512Z", "Email": "your+other+member@example.com", "AccountId": "555555555555" } ] } ``` Weitere Informationen finden Sie [im *Benutzerhandbuch* unter Grundlegendes zur Beziehung zwischen GuardDuty Administratorkonten und Mitgliedskonten](https://docs.aws.amazon.com/guardduty/latest/ug/administrator_member_relationships.html). GuardDuty + Einzelheiten zur API finden Sie [ListMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/list-members.html)unter *AWS CLI Befehlsreferenz*. ### `update-detector` Das folgende Codebeispiel zeigt die Verwendung`update-detector`. **AWS CLI** **Beispiel 1: Um die Laufzeitüberwachung zu aktivieren in GuardDuty** Das folgende `update-detector` Beispiel aktiviert die Laufzeitüberwachung ohne zusätzliche Konfiguration. ``` aws guardduty update-detector \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --features 'Name=RUNTIME_MONITORING,Status=ENABLED' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Laufzeitüberwachung](https://docs.aws.amazon.com/guardduty/latest/ug/runtime-monitoring.html) im *GuardDuty Benutzerhandbuch*. **Beispiel 2: Um die Laufzeitüberwachung mit zusätzlicher Konfiguration zu aktivieren** Das folgende `update-detector` Beispiel ermöglicht die Laufzeitüberwachung mit zusätzlicher Konfiguration für EC2, ECS Fargate und EKS. ``` aws guardduty update-detector \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --features 'Name=RUNTIME_MONITORING,Status=ENABLED,AdditionalConfiguration=[{Name=EC2_AGENT_MANAGEMENT,Status=ENABLED},{Name=ECS_FARGATE_AGENT_MANAGEMENT,Status=ENABLED},{Name=EKS_ADDON_MANAGEMENT,Status=ENABLED}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Laufzeitüberwachung](https://docs.aws.amazon.com/guardduty/latest/ug/runtime-monitoring.html). + Einzelheiten zur API finden Sie [UpdateDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/update-detector.html)in der *AWS CLI Befehlsreferenz*. ### `update-ip-set` Das folgende Codebeispiel zeigt die Verwendung`update-ip-set`. **AWS CLI** **So aktualisieren Sie ein vertrauenswürdiges IP-Set** Das folgende Beispiel für `update-ip-set` zeigt, wie Sie die Details eines vertrauenswürdigen IP-Sets aktualisieren. ``` aws guardduty update-ip-set \ --detector-id 12abc34d567e8fa901bc2d34eexample \ --ip-set-id d4b94fc952d6912b8f3060768example \ --location https://amzn-s3-demo-bucket.s3-us-west-2.amazonaws.com/customtrustlist2.csv ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *GuardDuty Benutzerhandbuch* unter [Arbeiten mit Listen vertrauenswürdiger IP-Adressen und Bedrohungslisten](https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_upload_lists.html). + Einzelheiten zur API finden Sie [UpdateIpSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/guardduty/update-ip-set.html)unter *AWS CLI Befehlsreferenz*. # AWS Health Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Health. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `describe-affected-entities` Das folgende Codebeispiel zeigt, wie Sie`describe-affected-entities`. **AWS CLI** **Um die Entitäten aufzulisten, die von einem bestimmten AWS Gesundheitsereignis betroffen sind** Das folgende `describe-affected-entities` Beispiel listet die Entitäten auf, die von dem angegebenen AWS Integritätsereignis betroffen sind. Bei diesem Ereignis handelt es sich um eine Abrechnungsbenachrichtigung für das AWS Konto. ``` aws health describe-affected-entities \ --filter "eventArns=arn:aws:health:global::event/BILLING/AWS_BILLING_NOTIFICATION/AWS_BILLING_NOTIFICATION_6ce1d874-e995-40e2-99cd-EXAMPLE11145" \ --region us-east-1 ``` Ausgabe: ``` { "entities": [ { "entityArn": "arn:aws:health:global:123456789012:entity/EXAMPLEimSMoULmWHpb", "eventArn": "arn:aws:health:global::event/BILLING/AWS_BILLING_NOTIFICATION/AWS_BILLING_NOTIFICATION_6ce1d874-e995-40e2-99cd-EXAMPLE11145", "entityValue": "AWS_ACCOUNT", "awsAccountId": "123456789012", "lastUpdatedTime": 1588356454.08 } ] } ``` Weitere Informationen finden Sie unter [Ereignisprotokoll](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html#event-log) im *Benutzerhandbuch für AWS Health*. + Einzelheiten zur API finden Sie [DescribeAffectedEntities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/health/describe-affected-entities.html)in der *AWS CLI Befehlsreferenz*. ### `describe-event-details` Das folgende Codebeispiel zeigt die Verwendung`describe-event-details`. **AWS CLI** **Um Informationen über ein AWS Gesundheitsereignis aufzulisten** Das folgende `describe-event-details` Beispiel listet Informationen über das angegebene AWS Gesundheitsereignis auf. ``` aws health describe-event-details \ --event-arns "arn:aws:health:us-east-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_VKTXI_EXAMPLE111" \ --region us-east-1 ``` Ausgabe: ``` { "successfulSet": [ { "event": { "arn": "arn:aws:health:us-east-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_VKTXI_EXAMPLE111", "service": "EC2", "eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "us-east-1", "startTime": 1587462325.096, "endTime": 1587464204.774, "lastUpdatedTime": 1587464204.865, "statusCode": "closed" }, "eventDescription": { "latestDescription": "[RESOLVED] Increased API Error Rates and Latencies\n\n[02:45 AM PDT] We are investigating increased API error rates and latencies in the US-EAST-1 Region.\n\n[03:16 AM PDT] Between 2:10 AM and 2:59 AM PDT we experienced increased API error rates and latencies in the US-EAST-1 Region. The issue has been resolved and the service is operating normally." } } ], "failedSet": [] } ``` Weitere Informationen finden Sie unter [Ereignisdetails](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html#event-details) im *Benutzerhandbuch für AWS Health*. + Einzelheiten zur API finden Sie [DescribeEventDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/health/describe-event-details.html)unter *AWS CLI Befehlsreferenz*. ### `describe-events` Das folgende Codebeispiel zeigt die Verwendung`describe-events`. **AWS CLI** **Beispiel 1: Um AWS Gesundheitsereignisse aufzulisten** Das folgende `describe-events` Beispiel listet aktuelle AWS Gesundheitsereignisse auf. ``` aws health describe-events \ --region us-east-1 ``` Ausgabe: ``` { "events": [ { "arn": "arn:aws:health:us-west-1::event/ECS/AWS_ECS_OPERATIONAL_ISSUE/AWS_ECS_OPERATIONAL_ISSUE_KWQPY_EXAMPLE111", "service": "ECS", "eventTypeCode": "AWS_ECS_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "us-west-1", "startTime": 1589077890.53, "endTime": 1589086345.597, "lastUpdatedTime": 1589086345.905, "statusCode": "closed", "eventScopeCode": "PUBLIC" }, { "arn": "arn:aws:health:global::event/BILLING/AWS_BILLING_NOTIFICATION/AWS_BILLING_NOTIFICATION_6ce1d874-e995-40e2-99cd-EXAMPLE1118b", "service": "BILLING", "eventTypeCode": "AWS_BILLING_NOTIFICATION", "eventTypeCategory": "accountNotification", "region": "global", "startTime": 1588356000.0, "lastUpdatedTime": 1588356524.358, "statusCode": "open", "eventScopeCode": "ACCOUNT_SPECIFIC" }, { "arn": "arn:aws:health:us-west-2::event/CLOUDFORMATION/AWS_CLOUDFORMATION_OPERATIONAL_ISSUE/AWS_CLOUDFORMATION_OPERATIONAL_ISSUE_OHTWY_EXAMPLE111", "service": "CLOUDFORMATION", "eventTypeCode": "AWS_CLOUDFORMATION_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "us-west-2", "startTime": 1588279630.761, "endTime": 1588284650.0, "lastUpdatedTime": 1588284691.941, "statusCode": "closed", "eventScopeCode": "PUBLIC" }, { "arn": "arn:aws:health:ap-northeast-1::event/LAMBDA/AWS_LAMBDA_OPERATIONAL_ISSUE/AWS_LAMBDA_OPERATIONAL_ISSUE_JZDND_EXAMPLE111", "service": "LAMBDA", "eventTypeCode": "AWS_LAMBDA_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "ap-northeast-1", "startTime": 1587379534.08, "endTime": 1587391771.0, "lastUpdatedTime": 1587395689.316, "statusCode": "closed", "eventScopeCode": "PUBLIC" }, { "arn": "arn:aws:health:us-east-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_COBXJ_EXAMPLE111", "service": "EC2", "eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "us-east-1", "startTime": 1586473044.284, "endTime": 1586479706.091, "lastUpdatedTime": 1586479706.153, "statusCode": "closed", "eventScopeCode": "PUBLIC" }, { "arn": "arn:aws:health:global::event/SECURITY/AWS_SECURITY_NOTIFICATION/AWS_SECURITY_NOTIFICATION_42007387-8129-42da-8c88-EXAMPLE11139", "service": "SECURITY", "eventTypeCode": "AWS_SECURITY_NOTIFICATION", "eventTypeCategory": "accountNotification", "region": "global", "startTime": 1585674000.0, "lastUpdatedTime": 1585674004.132, "statusCode": "open", "eventScopeCode": "PUBLIC" }, { "arn": "arn:aws:health:global::event/CLOUDFRONT/AWS_CLOUDFRONT_OPERATIONAL_ISSUE/AWS_CLOUDFRONT_OPERATIONAL_ISSUE_FRQXG_EXAMPLE111", "service": "CLOUDFRONT", "eventTypeCode": "AWS_CLOUDFRONT_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "global", "startTime": 1585610898.589, "endTime": 1585617671.0, "lastUpdatedTime": 1585620638.869, "statusCode": "closed", "eventScopeCode": "PUBLIC" }, { "arn": "arn:aws:health:us-east-1::event/SES/AWS_SES_OPERATIONAL_ISSUE/AWS_SES_OPERATIONAL_ISSUE_URNDF_EXAMPLE111", "service": "SES", "eventTypeCode": "AWS_SES_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "us-east-1", "startTime": 1585342008.46, "endTime": 1585344017.0, "lastUpdatedTime": 1585344355.989, "statusCode": "closed", "eventScopeCode": "PUBLIC" }, { "arn": "arn:aws:health:global::event/IAM/AWS_IAM_OPERATIONAL_NOTIFICATION/AWS_IAM_OPERATIONAL_NOTIFICATION_b6771c34-6ecd-4aea-9d3e-EXAMPLE1117e", "service": "IAM", "eventTypeCode": "AWS_IAM_OPERATIONAL_NOTIFICATION", "eventTypeCategory": "accountNotification", "region": "global", "startTime": 1584978300.0, "lastUpdatedTime": 1584978553.572, "statusCode": "open", "eventScopeCode": "ACCOUNT_SPECIFIC" }, { "arn": "arn:aws:health:ap-southeast-2::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_HNGHE_EXAMPLE111", "service": "EC2", "eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "ap-southeast-2", "startTime": 1583881487.483, "endTime": 1583885056.785, "lastUpdatedTime": 1583885057.052, "statusCode": "closed", "eventScopeCode": "PUBLIC" } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit dem AWS Personal Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html) im *AWS Health-Benutzerhandbuch*. **Beispiel 2: So listen Sie AWS Gesundheitsereignisse nach Service und Ereignisstatuscode auf** Das folgende `describe-events` Beispiel listet AWS Health-Ereignisse für Amazon Elastic Compute Cloud (Amazon EC2) auf, bei denen der Ereignisstatus geschlossen ist. ``` aws health describe-events \ --filter "services=EC2,eventStatusCodes=closed" ``` Ausgabe: ``` { "events": [ { "arn": "arn:aws:health:us-east-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_VKTXI_EXAMPLE111", "service": "EC2", "eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "us-east-1", "startTime": 1587462325.096, "endTime": 1587464204.774, "lastUpdatedTime": 1587464204.865, "statusCode": "closed", "eventScopeCode": "PUBLIC" }, { "arn": "arn:aws:health:us-east-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_COBXJ_EXAMPLE111", "service": "EC2", "eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "us-east-1", "startTime": 1586473044.284, "endTime": 1586479706.091, "lastUpdatedTime": 1586479706.153, "statusCode": "closed", "eventScopeCode": "PUBLIC" }, { "arn": "arn:aws:health:ap-southeast-2::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_HNGHE_EXAMPLE111", "service": "EC2", "eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE", "eventTypeCategory": "issue", "region": "ap-southeast-2", "startTime": 1583881487.483, "endTime": 1583885056.785, "lastUpdatedTime": 1583885057.052, "statusCode": "closed", "eventScopeCode": "PUBLIC" } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit dem AWS Personal Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html) im *AWS Health-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/health/describe-events.html)unter *AWS CLI Befehlsreferenz*. # HealthImaging Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren HealthImaging. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `copy-image-set` Das folgende Codebeispiel zeigt, wie Sie`copy-image-set`. **AWS CLI** **Beispiel 1: So kopieren Sie einen Bildsatz ohne Ziel.** Im folgenden Beispiel für `copy-image-set` wird eine doppelte Kopie eines Bildersatzes ohne Ziel erstellt. ``` aws medical-imaging copy-image-set \ --datastore-id 12345678901234567890123456789012 \ --source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \ --copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1" } }' ``` Ausgabe: ``` { "destinationImageSetProperties": { "latestVersionId": "2", "imageSetWorkflowStatus": "COPYING", "updatedAt": 1680042357.432, "imageSetId": "b9a06fef182a5f992842f77f8e0868e5", "imageSetState": "LOCKED", "createdAt": 1680042357.432 }, "sourceImageSetProperties": { "latestVersionId": "1", "imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS", "updatedAt": 1680042357.432, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436 }, "datastoreId": "12345678901234567890123456789012" } ``` **Beispiel 2: So kopieren Sie einen Bildersatz mit Ziel.** Im folgenden Beispiel für `copy-image-set` wird eine doppelte Kopie eines Bildersatzes mit Ziel erstellt. ``` aws medical-imaging copy-image-set \ --datastore-id 12345678901234567890123456789012 \ --source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \ --copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1" }, "destinationImageSet": { "imageSetId": "b9a06fef182a5f992842f77f8e0868e5", "latestVersionId": "1"} }' ``` Ausgabe: ``` { "destinationImageSetProperties": { "latestVersionId": "2", "imageSetWorkflowStatus": "COPYING", "updatedAt": 1680042505.135, "imageSetId": "b9a06fef182a5f992842f77f8e0868e5", "imageSetState": "LOCKED", "createdAt": 1680042357.432 }, "sourceImageSetProperties": { "latestVersionId": "1", "imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS", "updatedAt": 1680042505.135, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436 }, "datastoreId": "12345678901234567890123456789012" } ``` **Beispiel 3: So kopieren Sie eine Teilmenge von Instances aus einem Quellbildersatz in einen Zielbildersatz.** Im folgenden Beispiel für `copy-image-set` wird eine DICOM-Instance aus dem Quellbildersatz in den Zielbildersatz kopiert. Der force-Parameter dient dazu, Inkonsistenzen in den Attributen auf Patienten-, Studien- und Serienebene zu überschreiben. ``` aws medical-imaging copy-image-set \ --datastore-id 12345678901234567890123456789012 \ --source-image-set-id ea92b0d8838c72a3f25d00d13616f87e \ --copy-image-set-information '{"sourceImageSet": {"latestVersionId": "1","DICOMCopies": {"copiableAttributes": "{\"SchemaVersion\":\"1.1\",\"Study\":{\"Series\":{\"1.3.6.1.4.1.5962.99.1.3673257865.2104868982.1369432891697.3666.0\":{\"Instances\":{\"1.3.6.1.4.1.5962.99.1.3673257865.2104868982.1369432891697.3669.0\":{}}}}}}"}},"destinationImageSet": {"imageSetId": "b9eb50d8ee682eb9fcf4acbf92f62bb7","latestVersionId": "1"}}' \ --force ``` Ausgabe: ``` { "destinationImageSetProperties": { "latestVersionId": "2", "imageSetWorkflowStatus": "COPYING", "updatedAt": 1680042505.135, "imageSetId": "b9eb50d8ee682eb9fcf4acbf92f62bb7", "imageSetState": "LOCKED", "createdAt": 1680042357.432 }, "sourceImageSetProperties": { "latestVersionId": "1", "imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS", "updatedAt": 1680042505.135, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436 }, "datastoreId": "12345678901234567890123456789012" } ``` Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Kopieren eines Bilddatensatzes](https://docs.aws.amazon.com/healthimaging/latest/devguide/copy-image-set.html). + Einzelheiten zur API finden Sie [CopyImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/copy-image-set.html)in der *AWS CLI Befehlsreferenz*. ### `create-datastore` Das folgende Codebeispiel zeigt die Verwendung`create-datastore`. **AWS CLI** **Beispiel 1: Um einen Datenspeicher zu erstellen** Im folgenden Codebeispiel für `create-datastore` wird ein Datenspeicher mit dem Namen `my-datastore` erstellt. Wenn Sie einen Datenspeicher ohne Angabe von a erstellen`--lossless-storage-format`, wird AWS HealthImaging standardmäßig HTJ2 K (High Throughput JPEG 2000) verwendet. ``` aws medical-imaging create-datastore \ --datastore-name "my-datastore" ``` Ausgabe: ``` { "datastoreId": "12345678901234567890123456789012", "datastoreStatus": "CREATING" } ``` **Beispiel 2: So erstellen Sie einen Datenspeicher mit dem verlustfreien JPEG 2000-Speicherformat** Ein Datenspeicher, der mit dem verlustfreien Speicherformat JPEG 2000 konfiguriert ist, transkodiert und speichert verlustfreie Bildframes im JPEG 2000-Format. Bildframes können dann ohne Transcodierung im Format JPEG 2000 Lossless abgerufen werden. Im folgenden `create-datastore` Codebeispiel wird ein für das verlustfreies JPEG 2000-Speicherformat konfigurierter Datenspeicher mit dem Namen `my-datastore` erstellt. ``` aws medical-imaging create-datastore \ --datastore-name "my-datastore" \ --lossless-storage-format JPEG_2000_LOSSLESS ``` Ausgabe: ``` { "datastoreId": "12345678901234567890123456789012", "datastoreStatus": "CREATING" } ``` Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Erstellen eines Datenspeichers](https://docs.aws.amazon.com/healthimaging/latest/devguide/create-data-store.html). + Einzelheiten zur API finden Sie [CreateDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/create-datastore.html)unter *AWS CLI Befehlsreferenz*. ### `delete-datastore` Das folgende Codebeispiel zeigt die Verwendung`delete-datastore`. **AWS CLI** **So löschen Sie einen Datenspeicher** Im folgenden Codebeispiel für `delete-datastore` wird ein Datenspeicher gelöscht. ``` aws medical-imaging delete-datastore \ --datastore-id "12345678901234567890123456789012" ``` Ausgabe: ``` { "datastoreId": "12345678901234567890123456789012", "datastoreStatus": "DELETING" } ``` Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Löschen eines Datenspeichers](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-data-store.html). + Einzelheiten zur API finden Sie [DeleteDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-datastore.html)in der *AWS CLI Befehlsreferenz*. ### `delete-image-set` Das folgende Codebeispiel zeigt die Verwendung`delete-image-set`. **AWS CLI** **So löschen Sie einen Bildersatz** Im folgenden Codebeispiel für `delete-image-set` wird ein Bildersatz gelöscht. ``` aws medical-imaging delete-image-set \ --datastore-id 12345678901234567890123456789012 \ --image-set-id ea92b0d8838c72a3f25d00d13616f87e ``` Ausgabe: ``` { "imageSetWorkflowStatus": "DELETING", "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "datastoreId": "12345678901234567890123456789012" } ``` Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Löschen eines Bildsatzes](https://docs.aws.amazon.com/healthimaging/latest/devguide/delete-image-set.html). + Einzelheiten zur API finden Sie [DeleteImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/delete-image-set.html)in der *AWS CLI Befehlsreferenz*. ### `get-datastore` Das folgende Codebeispiel zeigt die Verwendung`get-datastore`. **AWS CLI** **Beispiel 1: Um die Eigenschaften eines Datenspeichers abzurufen** Im folgenden Codebeispiel für `get-datastore` werden die Eigenschaften eines Datenspeichers abgerufen. ``` aws medical-imaging get-datastore \ --datastore-id 12345678901234567890123456789012 ``` Ausgabe: ``` { "datastoreProperties": { "datastoreId": "12345678901234567890123456789012", "datastoreName": "TestDatastore123", "datastoreStatus": "ACTIVE", "losslessStorageFormat": "HTJ2K" "datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012", "createdAt": "2022-11-15T23:33:09.643000+00:00", "updatedAt": "2022-11-15T23:33:09.643000+00:00" } } ``` **Beispiel 2: Um die Eigenschaften eines Datenspeichers zu konfigurieren für JPEG2000** Im folgenden `get-datastore` Codebeispiel werden die Eigenschaften eines Datenspeichers für einen Datenspeicher abgerufen, der für das Format JPEG 2000 Lossless konfiguriert ist. ``` aws medical-imaging get-datastore \ --datastore-id 12345678901234567890123456789012 ``` Ausgabe: ``` { "datastoreProperties": { "datastoreId": "12345678901234567890123456789012", "datastoreName": "TestDatastore123", "datastoreStatus": "ACTIVE", "losslessStorageFormat": "JPEG_2000_LOSSLESS", "datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012", "createdAt": "2022-11-15T23:33:09.643000+00:00", "updatedAt": "2022-11-15T23:33:09.643000+00:00" } } ``` Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Abrufen von Datenspeichereigenschaften](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-data-store.html). + Einzelheiten zur API finden Sie [GetDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-datastore.html)in der *AWS CLI Befehlsreferenz*. ### `get-dicom-import-job` Das folgende Codebeispiel zeigt die Verwendung`get-dicom-import-job`. **AWS CLI** **So rufen Sie die Eigenschaften eines DICOM-Importauftrags ab** Im folgenden Codebeispiel für `get-dicom-import-job` werden die Eigenschaften eines DICOM-Importauftrags abgerufen. ``` aws medical-imaging get-dicom-import-job \ --datastore-id "12345678901234567890123456789012" \ --job-id "09876543210987654321098765432109" ``` Ausgabe: ``` { "jobProperties": { "jobId": "09876543210987654321098765432109", "jobName": "my-job", "jobStatus": "COMPLETED", "datastoreId": "12345678901234567890123456789012", "dataAccessRoleArn": "arn:aws:iam::123456789012:role/ImportJobDataAccessRole", "endedAt": "2022-08-12T11:29:42.285000+00:00", "submittedAt": "2022-08-12T11:28:11.152000+00:00", "inputS3Uri": "s3://medical-imaging-dicom-input/dicom_input/", "outputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/" } } ``` Weitere Informationen finden Sie im *AWS HealthImaging Developer Guide unter [Abrufen der Eigenschaften von Importaufträgen](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-dicom-import-job.html)*. + API-Einzelheiten finden Sie unter [Get DICOMImport Job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-dicom-import-job.html) in der *AWS CLI Befehlsreferenz*. ### `get-image-frame` Das folgende Codebeispiel zeigt die Verwendung`get-image-frame`. **AWS CLI** **So rufen Sie Pixeldaten des Bildersatzes ab** Im folgenden Codebeispiel für `get-image-frame` wird ein Image-Frame abgerufen. ``` aws medical-imaging get-image-frame \ --datastore-id "12345678901234567890123456789012" \ --image-set-id "98765412345612345678907890789012" \ --image-frame-information imageFrameId=3abf5d5d7ae72f80a0ec81b2c0de3ef4 \ imageframe.jph ``` Hinweis: Dieses Codebeispiel beinhaltet keine Ausgabe, da die GetImageFrame Aktion einen Stream von Pixeldaten an die Datei imageframe.jph zurückgibt. Informationen zum Dekodieren und Anzeigen von Bildrahmen finden Sie unter K-Decodierungsbibliotheken. HTJ2 Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Abrufen von Pixeldaten von Bilddatensätzen](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-frame.html). + Einzelheiten zur API finden Sie [GetImageFrame](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-frame.html)in der *AWS CLI Befehlsreferenz*. ### `get-image-set-metadata` Das folgende Codebeispiel zeigt die Verwendung`get-image-set-metadata`. **AWS CLI** **Beispiel 1: So rufen Sie Bildsatz-Metadaten ohne Version ab** Im folgenden Codebeispiel für `get-image-set-metadata` werden Metadaten für einen Bildsatz abgerufen, ohne eine Version anzugeben. Anmerkung: Der Parameter `outfile` ist erforderlich. ``` aws medical-imaging get-image-set-metadata \ --datastore-id 12345678901234567890123456789012 \ --image-set-id ea92b0d8838c72a3f25d00d13616f87e \ studymetadata.json.gz ``` Die zurückgegebenen Metadaten werden mit GZIP komprimiert und in der Datei „studymetadata.json.gz“ gespeichert. Um den Inhalt des zurückgegebenen JSON-Objekts anzuzeigen, müssen Sie es zuerst dekomprimieren. Ausgabe: ``` { "contentType": "application/json", "contentEncoding": "gzip" } ``` **Beispiel 2: So rufen Sie Bildsatz-Metadaten mit Version ab** Im folgenden Codebeispiel für `get-image-set-metadata` werden Metadaten für einen Bildsatz mit einer bestimmten Version abgerufen. Anmerkung: Der Parameter `outfile` ist erforderlich. ``` aws medical-imaging get-image-set-metadata \ --datastore-id 12345678901234567890123456789012 \ --image-set-id ea92b0d8838c72a3f25d00d13616f87e \ --version-id 1 \ studymetadata.json.gz ``` Die zurückgegebenen Metadaten werden mit GZIP komprimiert und in der Datei „studymetadata.json.gz“ gespeichert. Um den Inhalt des zurückgegebenen JSON-Objekts anzuzeigen, müssen Sie es zuerst dekomprimieren. Ausgabe: ``` { "contentType": "application/json", "contentEncoding": "gzip" } ``` Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Abrufen von Bilddatensatz-Metadaten](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-metadata.html). + Einzelheiten zur API finden Sie [GetImageSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set-metadata.html)in der *AWS CLI Befehlsreferenz*. ### `get-image-set` Das folgende Codebeispiel zeigt die Verwendung`get-image-set`. **AWS CLI** **So rufen Sie Bildsatzeigenschaften ab** Im folgenden Codebeispiel für `get-image-set` werden die Eigenschaften für einen Bildsatz abgerufen. ``` aws medical-imaging get-image-set \ --datastore-id 12345678901234567890123456789012 \ --image-set-id 18f88ac7870584f58d56256646b4d92b \ --version-id 1 ``` Ausgabe: ``` { "versionId": "1", "imageSetWorkflowStatus": "COPIED", "updatedAt": 1680027253.471, "imageSetId": "18f88ac7870584f58d56256646b4d92b", "imageSetState": "ACTIVE", "createdAt": 1679592510.753, "datastoreId": "12345678901234567890123456789012" } ``` Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Abrufen von Bilddatensatz-Eigenschaften](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-properties.html). + Einzelheiten zur API finden Sie [GetImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set.html)in der *AWS CLI Befehlsreferenz*. ### `list-datastores` Das folgende Codebeispiel zeigt die Verwendung`list-datastores`. **AWS CLI** **So listen Sie Datenspeicher auf** Im folgenden Codebeispiel für `list-datastores` werden die verfügbaren Datenspeicher aufgelistet. ``` aws medical-imaging list-datastores ``` Ausgabe: ``` { "datastoreSummaries": [ { "datastoreId": "12345678901234567890123456789012", "datastoreName": "TestDatastore123", "datastoreStatus": "ACTIVE", "datastoreArn": "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012", "createdAt": "2022-11-15T23:33:09.643000+00:00", "updatedAt": "2022-11-15T23:33:09.643000+00:00" } ] } ``` Weitere Informationen finden Sie im *AWS HealthImaging Developer Guide* unter [Auflisten von Datenspeichern](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-data-stores.html). + Einzelheiten zur API finden Sie [ListDatastores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-datastores.html)in der *AWS CLI Befehlsreferenz*. ### `list-dicom-import-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-dicom-import-jobs`. **AWS CLI** **So listen Sie DICOM-Importaufträge auf** Im folgenden Codebeispiel für `list-dicom-import-jobs` werden die DICOM-Importaufträge aufgelistet. ``` aws medical-imaging list-dicom-import-jobs \ --datastore-id "12345678901234567890123456789012" ``` Ausgabe: ``` { "jobSummaries": [ { "jobId": "09876543210987654321098765432109", "jobName": "my-job", "jobStatus": "COMPLETED", "datastoreId": "12345678901234567890123456789012", "dataAccessRoleArn": "arn:aws:iam::123456789012:role/ImportJobDataAccessRole", "endedAt": "2022-08-12T11:21:56.504000+00:00", "submittedAt": "2022-08-12T11:20:21.734000+00:00" } ] } ``` Weitere Informationen finden Sie im *AWS HealthImaging Developer Guide* unter [Auflisten von Importaufträgen](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-dicom-import-jobs.html). + Einzelheiten zur API finden Sie unter [DICOMImportJobs auflisten](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-dicom-import-jobs.html) in der *AWS CLI Befehlsreferenz*. ### `list-image-set-versions` Das folgende Codebeispiel zeigt die Verwendung`list-image-set-versions`. **AWS CLI** **So listen Sie Versionen von Bildsätzen auf** Im folgendem Codebeispiel für `list-image-set-versions` wird der Versionsverlauf für einen Bildsatz aufgelistet. ``` aws medical-imaging list-image-set-versions \ --datastore-id 12345678901234567890123456789012 \ --image-set-id ea92b0d8838c72a3f25d00d13616f87e ``` Ausgabe: ``` { "imageSetPropertiesList": [ { "ImageSetWorkflowStatus": "UPDATED", "versionId": "4", "updatedAt": 1680029436.304, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "ACTIVE", "createdAt": 1680027126.436 }, { "ImageSetWorkflowStatus": "UPDATED", "versionId": "3", "updatedAt": 1680029163.325, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "ACTIVE", "createdAt": 1680027126.436 }, { "ImageSetWorkflowStatus": "COPY_FAILED", "versionId": "2", "updatedAt": 1680027455.944, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "ACTIVE", "message": "INVALID_REQUEST: Series of SourceImageSet and DestinationImageSet don't match.", "createdAt": 1680027126.436 }, { "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "ACTIVE", "versionId": "1", "ImageSetWorkflowStatus": "COPIED", "createdAt": 1680027126.436 } ] } ``` Weitere Informationen finden Sie im *AWS HealthImaging Developer Guide* unter [Auflisten von Imageset-Versionen](https://docs.aws.amazon.com/healthimaging/latest/devguide/list-image-set-versions.html). + Einzelheiten zur API finden Sie [ListImageSetVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-image-set-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Beispiel 1: So listen Sie Ressourcen-Tags für einen Datenspeicher auf** Im folgenden Codebeispiel für `list-tags-for-resource` werden die Tags für einen Datenspeicher aufgelistet. ``` aws medical-imaging list-tags-for-resource \ --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" ``` Ausgabe: ``` { "tags":{ "Deployment":"Development" } } ``` **Beispiel 2: So listen Sie Ressourcen-Tags für einen Bildsatz auf** Im folgenden Codebeispiel für `list-tags-for-resource` werden die Tags für einen Bildsatz aufgelistet. ``` aws medical-imaging list-tags-for-resource \ --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" ``` Ausgabe: ``` { "tags":{ "Deployment":"Development" } } ``` Weitere Informationen finden Sie unter [Ressourcen taggen mit AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) im *AWS HealthImaging Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `search-image-sets` Das folgende Codebeispiel zeigt die Verwendung`search-image-sets`. **AWS CLI** **Beispiel 1: So suchen Sie nach Bilddatensätzen mit einem EQUAL-Operator** Im folgenden Codebeispiel für `search-image-sets` wird der EQUAL-Operator verwendet, um Bildsätze auf der Grundlage eines bestimmten Werts zu durchsuchen. ``` aws medical-imaging search-image-sets \ --datastore-id 12345678901234567890123456789012 \ --search-criteria file://search-criteria.json ``` Inhalt von `search-criteria.json` ``` { "filters": [{ "values": [{"DICOMPatientId" : "SUBJECT08701"}], "operator": "EQUAL" }] } ``` Ausgabe: ``` { "imageSetsMetadataSummaries": [{ "imageSetId": "09876543210987654321098765432109", "createdAt": "2022-12-06T21:40:59.429000+00:00", "version": 1, "DICOMTags": { "DICOMStudyId": "2011201407", "DICOMStudyDate": "19991122", "DICOMPatientSex": "F", "DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089", "DICOMPatientBirthDate": "19201120", "DICOMStudyDescription": "UNKNOWN", "DICOMPatientId": "SUBJECT08701", "DICOMPatientName": "Melissa844 Huel628", "DICOMNumberOfStudyRelatedInstances": 1, "DICOMStudyTime": "140728", "DICOMNumberOfStudyRelatedSeries": 1 }, "updatedAt": "2022-12-06T21:40:59.429000+00:00" }] } ``` **Beispiel 2: Um Bilddatensätze mit einem BETWEEN-Operator unter Verwendung von DICOMStudy Datum und DICOMStudy Uhrzeit zu suchen** Im folgenden Codebeispiel für `search-image-sets` wird nach Bildsätzen mit DICOM-Studien gesucht, die zwischen dem 1. Januar 1990 (12:00 Uhr) und dem 1. Januar 2023 (12:00 Uhr) generiert wurden. Hinweis: Die DICOMStudy Uhrzeit ist optional. Wenn der Parameter nicht vorhanden ist, ist 12:00 Uhr (Beginn des Tages) der Zeitwert für die Datumsangaben, die für die Filterung bereitgestellt werden. ``` aws medical-imaging search-image-sets \ --datastore-id 12345678901234567890123456789012 \ --search-criteria file://search-criteria.json ``` Inhalt von `search-criteria.json` ``` { "filters": [{ "values": [{ "DICOMStudyDateAndTime": { "DICOMStudyDate": "19900101", "DICOMStudyTime": "000000" } }, { "DICOMStudyDateAndTime": { "DICOMStudyDate": "20230101", "DICOMStudyTime": "000000" } }], "operator": "BETWEEN" }] } ``` Ausgabe: ``` { "imageSetsMetadataSummaries": [{ "imageSetId": "09876543210987654321098765432109", "createdAt": "2022-12-06T21:40:59.429000+00:00", "version": 1, "DICOMTags": { "DICOMStudyId": "2011201407", "DICOMStudyDate": "19991122", "DICOMPatientSex": "F", "DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089", "DICOMPatientBirthDate": "19201120", "DICOMStudyDescription": "UNKNOWN", "DICOMPatientId": "SUBJECT08701", "DICOMPatientName": "Melissa844 Huel628", "DICOMNumberOfStudyRelatedInstances": 1, "DICOMStudyTime": "140728", "DICOMNumberOfStudyRelatedSeries": 1 }, "updatedAt": "2022-12-06T21:40:59.429000+00:00" }] } ``` **Beispiel 3: So suchen Sie Bildsätze mit einem BETWEEN-Operator mithilfe von createdAt (Zeitstudien wurden bisher fortgeführt)** Im folgenden `search-image-sets` Codebeispiel wird nach Bilddatensätzen gesucht, bei denen DICOM-Studien HealthImaging zwischen den Zeitbereichen in der UTC-Zeitzone persistiert wurden. Hinweis: Geben Sie „createdAt“ in dem im Beispiel aufgeführten Format an („1985-04-12T23:20:50.52Z“). ``` aws medical-imaging search-image-sets \ --datastore-id 12345678901234567890123456789012 \ --search-criteria file://search-criteria.json ``` Inhalt von `search-criteria.json` ``` { "filters": [{ "values": [{ "createdAt": "1985-04-12T23:20:50.52Z" }, { "createdAt": "2022-04-12T23:20:50.52Z" }], "operator": "BETWEEN" }] } ``` Ausgabe: ``` { "imageSetsMetadataSummaries": [{ "imageSetId": "09876543210987654321098765432109", "createdAt": "2022-12-06T21:40:59.429000+00:00", "version": 1, "DICOMTags": { "DICOMStudyId": "2011201407", "DICOMStudyDate": "19991122", "DICOMPatientSex": "F", "DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089", "DICOMPatientBirthDate": "19201120", "DICOMStudyDescription": "UNKNOWN", "DICOMPatientId": "SUBJECT08701", "DICOMPatientName": "Melissa844 Huel628", "DICOMNumberOfStudyRelatedInstances": 1, "DICOMStudyTime": "140728", "DICOMNumberOfStudyRelatedSeries": 1 }, "lastUpdatedAt": "2022-12-06T21:40:59.429000+00:00" }] } ``` **Beispiel 4: Um Bilddatensätze mit einem EQUAL-Operator für DICOMSeries instanceUID und BETWEEN für updatedAt zu durchsuchen und die Antwort in ASC-Reihenfolge im Feld updatedAt zu sortieren** Das folgende `search-image-sets` Codebeispiel sucht nach Bilddatensätzen mit einem EQUAL-Operator für DICOMSeries instanceUID und BETWEEN für updatedAt und sortiert die Antwort in ASC-Reihenfolge im Feld updatedAt. Hinweis: Geben Sie „updatedAt“ in dem im Beispiel aufgeführten Format an („1985-04-12T23:20:50.52Z“). ``` aws medical-imaging search-image-sets \ --datastore-id 12345678901234567890123456789012 \ --search-criteria file://search-criteria.json ``` Inhalt von `search-criteria.json` ``` { "filters": [{ "values": [{ "updatedAt": "2024-03-11T15:00:05.074000-07:00" }, { "updatedAt": "2024-03-11T16:00:05.074000-07:00" }], "operator": "BETWEEN" }, { "values": [{ "DICOMSeriesInstanceUID": "1.2.840.99999999.84710745.943275268089" }], "operator": "EQUAL" }], "sort": { "sortField": "updatedAt", "sortOrder": "ASC" } } ``` Ausgabe: ``` { "imageSetsMetadataSummaries": [{ "imageSetId": "09876543210987654321098765432109", "createdAt": "2022-12-06T21:40:59.429000+00:00", "version": 1, "DICOMTags": { "DICOMStudyId": "2011201407", "DICOMStudyDate": "19991122", "DICOMPatientSex": "F", "DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089", "DICOMPatientBirthDate": "19201120", "DICOMStudyDescription": "UNKNOWN", "DICOMPatientId": "SUBJECT08701", "DICOMPatientName": "Melissa844 Huel628", "DICOMNumberOfStudyRelatedInstances": 1, "DICOMStudyTime": "140728", "DICOMNumberOfStudyRelatedSeries": 1 }, "lastUpdatedAt": "2022-12-06T21:40:59.429000+00:00" }] } ``` [https://docs.aws.amazon.com/healthimaging/latest/devguide/search-image-sets.html](https://docs.aws.amazon.com/healthimaging/latest/devguide/search-image-sets.html) + Einzelheiten zur API finden Sie [SearchImageSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/search-image-sets.html)in der *AWS CLI Befehlsreferenz*. ### `start-dicom-import-job` Das folgende Codebeispiel zeigt die Verwendung`start-dicom-import-job`. **AWS CLI** **So starten Sie einen DICOM-Importauftrag** Im folgenden Codebeispiel für `start-dicom-import-job` wird ein DICOM-Importauftrage gestartet. ``` aws medical-imaging start-dicom-import-job \ --job-name "my-job" \ --datastore-id "12345678901234567890123456789012" \ --input-s3-uri "s3://medical-imaging-dicom-input/dicom_input/" \ --output-s3-uri "s3://medical-imaging-output/job_output/" \ --data-access-role-arn "arn:aws:iam::123456789012:role/ImportJobDataAccessRole" ``` Ausgabe: ``` { "datastoreId": "12345678901234567890123456789012", "jobId": "09876543210987654321098765432109", "jobStatus": "SUBMITTED", "submittedAt": "2022-08-12T11:28:11.152000+00:00" } ``` Weitere Informationen finden Sie unter [Starten eines Importauftrags](https://docs.aws.amazon.com/healthimaging/latest/devguide/start-dicom-import-job.html) im *AWS HealthImaging Entwicklerhandbuch*. + API-Einzelheiten finden Sie unter [DICOMImportJob starten](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/start-dicom-import-job.html) in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Beispiel 1: So markieren Sie einen Datenspeicher** In den folgenden Codebeispielen für `tag-resource` wird ein Datenspeicher mit Tags versehen. ``` aws medical-imaging tag-resource \ --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \ --tags '{"Deployment":"Development"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So taggen Sie einen Bildsatz** In den folgenden Codebeispielen für `tag-resource` wird ein Bildsatz mit Tags versehen. ``` aws medical-imaging tag-resource \ --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \ --tags '{"Deployment":"Development"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ressourcen taggen mit AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) im *AWS HealthImaging Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Beispiel 1: So heben Sie die Markierung eines Datenspeichers auf** Im folgenden Codebeispiel für `untag-resource` werden Tags aus einem Datenspeicher entfernt. ``` aws medical-imaging untag-resource \ --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012" \ --tag-keys '["Deployment"]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So heben Sie das Tagging eines Bildsatzes auf** Im folgenden Codebeispiel für `untag-resource` werden Tags aus einem Bildsatz entfernt. ``` aws medical-imaging untag-resource \ --resource-arn "arn:aws:medical-imaging:us-east-1:123456789012:datastore/12345678901234567890123456789012/imageset/18f88ac7870584f58d56256646b4d92b" \ --tag-keys '["Deployment"]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ressourcen taggen mit AWS HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/tagging.html) im *AWS HealthImaging Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-image-set-metadata` Das folgende Codebeispiel zeigt die Verwendung`update-image-set-metadata`. **AWS CLI** **Beispiel 1: So fügen Sie ein Attribut in Bildsatz-Metadaten ein oder aktualisieren es** Im folgenden Beispiel für `update-image-set-metadata` wird ein Attribut in die Metadaten eines Bildsatzes eingefügt. ``` aws medical-imaging update-image-set-metadata \ --datastore-id 12345678901234567890123456789012 \ --image-set-id ea92b0d8838c72a3f25d00d13616f87e \ --latest-version-id 1 \ --cli-binary-format raw-in-base64-out \ --update-image-set-metadata-updates file://metadata-updates.json ``` Inhalt von `metadata-updates.json` ``` { "DICOMUpdates": { "updatableAttributes": "{\"SchemaVersion\":1.1,\"Patient\":{\"DICOM\":{\"PatientName\":\"MX^MX\"}}}" } } ``` Ausgabe: ``` { "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" } ``` **Beispiel 2: So entfernen Sie ein Attribut aus den Metadaten eines Bildsatzes** Im folgenden Beispiel für `update-image-set-metadata` wird ein Attribut aus den Metadaten eines Bildsatzes entfernt. ``` aws medical-imaging update-image-set-metadata \ --datastore-id 12345678901234567890123456789012 \ --image-set-id ea92b0d8838c72a3f25d00d13616f87e \ --latest-version-id 1 \ --cli-binary-format raw-in-base64-out \ --update-image-set-metadata-updates file://metadata-updates.json ``` Inhalt von `metadata-updates.json` ``` { "DICOMUpdates": { "removableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"DICOM\":{\"StudyDescription\":\"CHEST\"}}}" } } ``` Ausgabe: ``` { "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" } ``` **Beispiel 3: So entfernen Sie eine Instance aus den Metadaten eines Bildsatzes** Im folgenden Beispiel für `update-image-set-metadata` wird eine Instance aus den Metadaten eines Bildsatzes entfernt. ``` aws medical-imaging update-image-set-metadata \ --datastore-id 12345678901234567890123456789012 \ --image-set-id ea92b0d8838c72a3f25d00d13616f87e \ --latest-version-id 1 \ --cli-binary-format raw-in-base64-out \ --update-image-set-metadata-updates file://metadata-updates.json \ --force ``` Inhalt von `metadata-updates.json` ``` { "DICOMUpdates": { "removableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {}}}}}}" } } ``` Ausgabe: ``` { "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" } ``` **Beispiel 4: So setzen Sie einen Bildsatz auf eine frühere Version zurück** Das folgende `update-image-set-metadata` Beispiel zeigt, wie ein Bilddatensatz auf eine frühere Version zurückgesetzt wird. CopyImageSet und UpdateImageSetMetadata Aktionen erstellen neue Versionen von Bilddatensätzen. ``` aws medical-imaging update-image-set-metadata \ --datastore-id 12345678901234567890123456789012 \ --image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \ --latest-version-id 3 \ --cli-binary-format raw-in-base64-out \ --update-image-set-metadata-updates '{"revertToVersionId": "1"}' ``` Ausgabe: ``` { "datastoreId": "12345678901234567890123456789012", "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "latestVersionId": "4", "imageSetState": "LOCKED", "imageSetWorkflowStatus": "UPDATING", "createdAt": 1680027126.436, "updatedAt": 1680042257.908 } ``` **Beispiel 5: So fügen Sie einer Instance ein privates DICOM-Datenelement hinzu** Das folgende Beispiel für `update-image-set-metadata` zeigt, wie ein privates Element zu einer angegebenen Instance innerhalb eines Bildsatzes hinzugefügt wird. Der DICOM-Standard erlaubt private Datenelemente für die Übertragung von Informationen, die nicht in Standarddatenelementen enthalten sein dürfen. Mit der UpdateImageSetMetadata Aktion können Sie private Datenelemente erstellen, aktualisieren und löschen. ``` aws medical-imaging update-image-set-metadata \ --datastore-id 12345678901234567890123456789012 \ --image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \ --latest-version-id 1 \ --cli-binary-format raw-in-base64-out \ --force \ --update-image-set-metadata-updates file://metadata-updates.json ``` Inhalt von `metadata-updates.json` ``` { "DICOMUpdates": { "updatableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"DICOM\": {\"001910F9\": \"97\"},\"DICOMVRs\": {\"001910F9\": \"DS\"}}}}}}}" } } ``` Ausgabe: ``` { "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" } ``` **Beispiel 6: So aktualisieren Sie ein privates DICOM-Datenelement in einer Instance** Das folgende Beispiel für `update-image-set-metadata` zeigt, wie der Wert eines privates Datenelements, das zu einer Instance eines Bildsatzes gehört, aktualisiert wird. ``` aws medical-imaging update-image-set-metadata \ --datastore-id 12345678901234567890123456789012 \ --image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \ --latest-version-id 1 \ --cli-binary-format raw-in-base64-out \ --force \ --update-image-set-metadata-updates file://metadata-updates.json ``` Inhalt von `metadata-updates.json` ``` { "DICOMUpdates": { "updatableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"DICOM\": {\"00091001\": \"GE_GENESIS_DD\"}}}}}}}" } } ``` Ausgabe: ``` { "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" } ``` **Beispiel 7: Um eine SOPInstance UID mit dem Force-Parameter zu aktualisieren** Das folgende `update-image-set-metadata` Beispiel zeigt, wie eine SOPInstance UID aktualisiert wird, indem der Force-Parameter verwendet wird, um die DICOM-Metadatenbeschränkungen zu überschreiben. ``` aws medical-imaging update-image-set-metadata \ --datastore-id 12345678901234567890123456789012 \ --image-set-id 53d5fdb05ca4d46ac7ca64b06545c66e \ --latest-version-id 1 \ --cli-binary-format raw-in-base64-out \ --force \ --update-image-set-metadata-updates file://metadata-updates.json ``` Inhalt von `metadata-updates.json` ``` { "DICOMUpdates": { "updatableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"Series\":{\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3656.0\":{\"Instances\":{\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3659.0\":{\"DICOM\":{\"SOPInstanceUID\":\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3659.9\"}}}}}}}" } } ``` Ausgabe: ``` { "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" } ``` Weitere Informationen finden Sie im *AWS HealthImaging Entwicklerhandbuch* unter [Aktualisieren von Bilddatensatz-Metadaten](https://docs.aws.amazon.com/healthimaging/latest/devguide/update-image-set-metadata.html). + Einzelheiten zur API finden Sie [UpdateImageSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/update-image-set-metadata.html)in der *AWS CLI Befehlsreferenz*. # HealthLake Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren HealthLake. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-fhir-datastore` Das folgende Codebeispiel zeigt, wie Sie`create-fhir-datastore`. **AWS CLI** **Beispiel 1: Erstellen Sie einen SIGV4-fähigen Datenspeicher HealthLake ** Das folgende `create-fhir-datastore` Beispiel zeigt, wie Sie einen neuen Datenspeicher in erstellen. AWS HealthLake ``` aws healthlake create-fhir-datastore \ --datastore-type-version R4 \ --datastore-name "FhirTestDatastore" ``` Ausgabe: ``` { "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Data store ID)/r4/", "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Data store ID)", "DatastoreStatus": "CREATING", "DatastoreId": "(Data store ID)" } ``` **Beispiel 2: Erstellen Sie einen SMART-Datenspeicher auf einem FHIR-fähigen Datenspeicher HealthLake ** Das folgende `create-fhir-datastore` Beispiel zeigt, wie Sie einen neuen SMART-on-FHIR-fähigen Datenspeicher in erstellen. AWS HealthLake ``` aws healthlake create-fhir-datastore \ --datastore-name "your-data-store-name" \ --datastore-type-version R4 \ --preload-data-config PreloadDataType="SYNTHEA" \ --sse-configuration '{ "KmsEncryptionConfig": { "CmkType": "CUSTOMER_MANAGED_KMS_KEY", "KmsKeyId": "arn:aws:kms:us-east-1:your-account-id:key/your-key-id" } }' \ --identity-provider-configuration file://identity_provider_configuration.json ``` Inhalt von `identity_provider_configuration.json`: ``` { "AuthorizationStrategy": "SMART_ON_FHIR_V1", "FineGrainedAuthorizationEnabled": true, "IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name", "Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\"]}" } ``` Ausgabe: ``` { "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Data store ID)/r4/", "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Data store ID)", "DatastoreStatus": "CREATING", "DatastoreId": "(Data store ID)" } ``` *Weitere Informationen finden Sie unter [Erstellen und Überwachen eines FHIR-Datenspeichers](https://docs.aws.amazon.com/healthlake/latest/devguide/working-with-FHIR-healthlake.html) im Entwicklerhandbuch.AWS HealthLake * + Einzelheiten zur API finden Sie unter [Create FHIRDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/create-fhir-datastore.html) in *AWS CLI Command Reference.* ### `delete-fhir-datastore` Das folgende Codebeispiel zeigt die Verwendung`delete-fhir-datastore`. **AWS CLI** **So löschen Sie einen FHIR-Datenspeicher** Das folgende `delete-fhir-datastore` Beispiel zeigt, wie Sie einen Datenspeicher und seinen gesamten Inhalt in löschen AWS HealthLake. ``` aws healthlake delete-fhir-datastore \ --datastore-id (Data store ID) ``` Ausgabe: ``` { "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/(Data store ID)/r4/", "DatastoreArn": "arn:aws:healthlake:us-east-1:(AWS Account ID):datastore/(Data store ID)", "DatastoreStatus": "DELETING", "DatastoreId": "(Data store ID)" } ``` *Weitere Informationen finden Sie unter Erstellen und Überwachen eines FHIR-Datenspeichers < https://docs.aws.amazon.com/healthlake/ latest/devguide/working -with-FHIR-HealthLake.html> im Entwicklerhandbuch.AWS HealthLake * + Einzelheiten zur [FHIRDatastore*AWS CLI API*](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/delete-fhir-datastore.html) finden Sie unter Löschen in der Befehlsreferenz. ### `describe-fhir-datastore` Das folgende Codebeispiel zeigt die Verwendung`describe-fhir-datastore`. **AWS CLI** **So beschreiben Sie einen FHIR-Datenspeicher** Das folgende `describe-fhir-datastore` Beispiel zeigt, wie Sie die Eigenschaften eines Datenspeichers in finden AWS HealthLake. ``` aws healthlake describe-fhir-datastore \ --datastore-id "1f2f459836ac6c513ce899f9e4f66a59" ``` Ausgabe: ``` { "DatastoreProperties": { "PreloadDataConfig": { "PreloadDataType": "SYNTHEA" }, "SseConfiguration": { "KmsEncryptionConfig": { "CmkType": "CUSTOMER_MANAGED_KMS_KEY", "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } }, "DatastoreName": "Demo", "DatastoreArn": "arn:aws:healthlake:us-east-1::datastore/", "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore//r4/", "DatastoreStatus": "ACTIVE", "DatastoreTypeVersion": "R4", "CreatedAt": 1603761064.881, "DatastoreId": "", "IdentityProviderConfiguration": { "AuthorizationStrategy": "AWS_AUTH", "FineGrainedAuthorizationEnabled": false } } } ``` Weitere Informationen finden Sie im *AWS HealthLake Entwicklerhandbuch* unter [Erstellen und Überwachen eines FHIR-Datenspeichers](https://docs.aws.amazon.com/healthlake/latest/devguide/working-with-FHIR-healthlake.html). + Einzelheiten zur API finden Sie unter [Beschreibung FHIRDatastore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/describe-fhir-datastore.html) in der *AWS CLI Befehlsreferenz.* ### `describe-fhir-export-job` Das folgende Codebeispiel zeigt die Verwendung`describe-fhir-export-job`. **AWS CLI** **So beschreiben Sie einen FHIR-Exportjob** Das folgende `describe-fhir-export-job` Beispiel zeigt, wie Sie die Eigenschaften eines FHIR-Exportauftrags in AWS HealthLake finden. ``` aws healthlake describe-fhir-export-job \ --datastore-id (Data store ID) \ --job-id 9b9a51943afaedd0a8c0c26c49135a31 ``` Ausgabe: ``` { "ExportJobProperties": { "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)", "JobStatus": "IN_PROGRESS", "JobId": "9009813e9d69ba7cf79bcb3468780f16", "SubmitTime": "2024-11-20T11:31:46.672000-05:00", "EndTime": "2024-11-20T11:34:01.636000-05:00", "OutputDataConfig": { "S3Configuration": { "S3Uri": "s3://(Bucket Name)/(Prefix Name)/", "KmsKeyId": "arn:aws:kms:us-east-1:012345678910:key/d330e7fc-b56c-4216-a250-f4c43ef46e83" } }, "DatastoreId": "(Data store ID)" } } ``` Weitere Informationen finden Sie unter [Exportieren von Dateien aus einem FHIR-Datenspeicher](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) im *AWS HealthLake Entwicklerhandbuch*. + Einzelheiten zur API finden Sie unter [FHIRExportJob beschreiben](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/describe-fhir-export-job.html) in der *AWS CLI Befehlsreferenz*. ### `describe-fhir-import-job` Das folgende Codebeispiel zeigt die Verwendung`describe-fhir-import-job`. **AWS CLI** **So beschreiben Sie einen FHIR-Importjob** Das folgende `describe-fhir-import-job` Beispiel zeigt, wie Sie die Eigenschaften eines FHIR-Importjobs mithilfe AWS HealthLake von lernen. ``` aws healthlake describe-fhir-import-job \ --datastore-id (Data store ID) \ --job-id c145fbb27b192af392f8ce6e7838e34f ``` Ausgabe: ``` { "ImportJobProperties": { "InputDataConfig": { "S3Uri": "s3://(Bucket Name)/(Prefix Name)/" { "arrayitem2": 2 } }, "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)", "JobStatus": "COMPLETED", "JobId": "c145fbb27b192af392f8ce6e7838e34f", "SubmitTime": 1606272542.161, "EndTime": 1606272609.497, "DatastoreId": "(Data store ID)" } } ``` Weitere Informationen finden Sie im *AWS HealthLake Entwicklerhandbuch* unter [Dateien in einen FHIR-Datenspeicher importieren](https://docs.aws.amazon.com/healthlake/latest/devguide/import-datastore.html). + Einzelheiten zur API finden Sie unter [FHIRImportJob beschreiben](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/describe-fhir-import-job.html) in der *AWS CLI Befehlsreferenz*. ### `list-fhir-datastores` Das folgende Codebeispiel zeigt die Verwendung`list-fhir-datastores`. **AWS CLI** **So listen Sie FHIR-Datenspeicher auf** Das folgende `list-fhir-datastores` Beispiel zeigt, wie der Befehl verwendet wird und wie Benutzer Ergebnisse anhand des Datenspeicherstatus in filtern können AWS HealthLake. ``` aws healthlake list-fhir-datastores \ --filter DatastoreStatus=ACTIVE ``` Ausgabe: ``` { "DatastorePropertiesList": [ { "PreloadDataConfig": { "PreloadDataType": "SYNTHEA" }, "SseConfiguration": { "KmsEncryptionConfig": { "CmkType": "CUSTOMER_MANAGED_KMS_KEY", "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } }, "DatastoreName": "Demo", "DatastoreArn": "arn:aws:healthlake:us-east-1::datastore/", "DatastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore//r4/", "DatastoreStatus": "ACTIVE", "DatastoreTypeVersion": "R4", "CreatedAt": 1603761064.881, "DatastoreId": "", "IdentityProviderConfiguration": { "AuthorizationStrategy": "AWS_AUTH", "FineGrainedAuthorizationEnabled": false } } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Überwachen eines AWS HealthLake FHIR-Datenspeichers](https://docs.aws.amazon.com/healthlake/latest/devguide/working-with-FHIR-healthlake.html) *im Entwicklerhandbuch*. + Einzelheiten zur API finden Sie unter [Liste FHIRDatastores in der AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/list-fhir-datastores.html) *Befehlsreferenz.* ### `list-fhir-export-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-fhir-export-jobs`. **AWS CLI** **So listen Sie alle FHIR-Exportjobs auf** Das folgende Beispiel für `list-fhir-export-jobs` zeigt, wie Sie mit dem Befehl eine Liste von Exportjobs anzeigen, die mit einem Konto verknüpft sind. ``` aws healthlake list-fhir-export-jobs \ --datastore-id (Data store ID) \ --submitted-before (DATE like 2024-10-13T19:00:00Z)\ --submitted-after (DATE like 2020-10-13T19:00:00Z )\ --job-name "FHIR-EXPORT" \ --job-status SUBMITTED \ --max-results (Integer between 1 and 500) ``` Ausgabe: ``` { "ExportJobPropertiesList": [ { "ExportJobProperties": { "OutputDataConfig": { "S3Uri": "s3://(Bucket Name)/(Prefix Name)/", "S3Configuration": { "S3Uri": "s3://(Bucket Name)/(Prefix Name)/", "KmsKeyId": "(KmsKey Id)" } }, "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)", "JobStatus": "COMPLETED", "JobId": "c145fbb27b192af392f8ce6e7838e34f", "JobName": "FHIR-EXPORT", "SubmitTime": "2024-11-20T11:31:46.672000-05:00", "EndTime": "2024-11-20T11:34:01.636000-05:00", "DatastoreId": "(Data store ID)" } } ] } ``` Weitere Informationen finden Sie unter [Exportieren von Dateien aus einem FHIR-Datenspeicher](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) im AWS HealthLake Entwicklerhandbuch. + Einzelheiten zur API finden Sie unter [FHIRExportAuflisten von Aufträgen](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/list-fhir-export-jobs.html) in der *AWS CLI Befehlsreferenz.* ### `list-fhir-import-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-fhir-import-jobs`. **AWS CLI** **So listen Sie alle FHIR-Importjobs auf** Das folgende Beispiel für `list-fhir-import-jobs` zeigt, wie Sie mit dem Befehl eine Liste aller Importjobs anzeigen, die mit einem Konto verknüpft sind. ``` aws healthlake list-fhir-import-jobs \ --datastore-id (Data store ID) \ --submitted-before (DATE like 2024-10-13T19:00:00Z) \ --submitted-after (DATE like 2020-10-13T19:00:00Z ) \ --job-name "FHIR-IMPORT" \ --job-status SUBMITTED \ -max-results (Integer between 1 and 500) ``` Ausgabe: ``` { "ImportJobPropertiesList": [ { "JobId": "c0fddbf76f238297632d4aebdbfc9ddf", "JobStatus": "COMPLETED", "SubmitTime": "2024-11-20T10:08:46.813000-05:00", "EndTime": "2024-11-20T10:10:09.093000-05:00", "DatastoreId": "(Data store ID)", "InputDataConfig": { "S3Uri": "s3://(Bucket Name)/(Prefix Name)/" }, "JobOutputDataConfig": { "S3Configuration": { "S3Uri": "s3://(Bucket Name)/import/6407b9ae4c2def3cb6f1a46a0c599ec0-FHIR_IMPORT-c0fddbf76f238297632d4aebdbfc9ddf/", "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/b7f645cb-e564-4981-8672-9e012d1ff1a0" } }, "JobProgressReport": { "TotalNumberOfScannedFiles": 1, "TotalSizeOfScannedFilesInMB": 0.001798, "TotalNumberOfImportedFiles": 1, "TotalNumberOfResourcesScanned": 1, "TotalNumberOfResourcesImported": 1, "TotalNumberOfResourcesWithCustomerError": 0, "TotalNumberOfFilesReadWithCustomerError": 0, "Throughput": 0.0 }, "DataAccessRoleArn": "arn:aws:iam::(AWS Account ID):role/(Role Name)" } ] } ``` Weitere Informationen finden Sie im AWS HealthLake Entwicklerhandbuch unter [Dateien in den FHIR-Datenspeicher importieren](https://docs.aws.amazon.com/healthlake/latest/devguide/import-examples.html). + Einzelheiten zur API finden Sie unter [FHIRImportJobs in der *AWS CLI Befehlsreferenz* auflisten](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/list-fhir-import-jobs.html). ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für einen Datenspeicher auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags aufgelistet, die mit dem angegebenen Datenspeicher verknüpft sind: ``` aws healthlake list-tags-for-resource \ --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe" ``` Ausgabe: ``` { "tags": { "key": "value", "key1": "value1" } } ``` Weitere Informationen finden Sie [AWS HealthLakeim AWS HealthLake Entwicklerhandbuch unter Ressourcen taggen](https://docs.aws.amazon.com/healthlake/latest/devguide/tagging.html). + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `start-fhir-export-job` Das folgende Codebeispiel zeigt die Verwendung`start-fhir-export-job`. **AWS CLI** **So starten Sie einen FHIR-Exportjob** Das folgende `start-fhir-export-job` Beispiel zeigt, wie Sie einen FHIR-Exportauftrag mit AWS HealthLake starten. ``` aws healthlake start-fhir-export-job \ --output-data-config '{"S3Configuration": {"S3Uri":"s3://(Bucket Name)/(Prefix Name)/","KmsKeyId":"arn:aws:kms:us-east-1:012345678910:key/d330e7fc-b56c-4216-a250-f4c43ef46e83"}}' \ --datastore-id (Data store ID) \ --data-access-role-arn arn:aws:iam::(AWS Account ID):role/(Role Name) ``` Ausgabe: ``` { "DatastoreId": "(Data store ID)", "JobStatus": "SUBMITTED", "JobId": "9b9a51943afaedd0a8c0c26c49135a31" } ``` Weitere Informationen finden Sie unter [Exportieren von Dateien aus einem FHIR-Datenspeicher](https://docs.aws.amazon.com/healthlake/latest/devguide/export-datastore.html) im *AWS HealthLake Entwicklerhandbuch*. + API-Einzelheiten finden Sie unter [FHIRExportJob starten](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/start-fhir-export-job.html) in der *AWS CLI Befehlsreferenz*. ### `start-fhir-import-job` Das folgende Codebeispiel zeigt die Verwendung`start-fhir-import-job`. **AWS CLI** **So starten Sie einen FHIR-Importjob** Das folgende `start-fhir-import-job` Beispiel zeigt, wie Sie einen FHIR-Importauftrag mit AWS HealthLake starten. ``` aws healthlake start-fhir-import-job \ --input-data-config S3Uri="s3://(Bucket Name)/(Prefix Name)/" \ --job-output-data-config '{"S3Configuration": {"S3Uri":"s3://(Bucket Name)/(Prefix Name)/","KmsKeyId":"arn:aws:kms:us-east-1:012345678910:key/d330e7fc-b56c-4216-a250-f4c43ef46e83"}}' \ --datastore-id (Data store ID) \ --data-access-role-arn "arn:aws:iam::(AWS Account ID):role/(Role Name)" ``` Ausgabe: ``` { "DatastoreId": "(Data store ID)", "JobStatus": "SUBMITTED", "JobId": "c145fbb27b192af392f8ce6e7838e34f" } ``` Weitere Informationen finden Sie im *AWS HealthLake Entwicklerhandbuch* unter [Dateien in einen FHIR-Datenspeicher importieren](https://docs.aws.amazon.com/healthlake/latest/devguide/import-datastore.html). + API-Einzelheiten finden Sie unter [FHIRImportJob starten](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/start-fhir-import-job.html) in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie ein Tag zum Datenspeicher hinzu** Im folgenden Beispiel für `tag-resource` wird gezeigt, wie Sie ein Tag zu einem Datenspeicher hinzufügen. ``` aws healthlake tag-resource \ --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/0725c83f4307f263e16fd56b6d8ebdbe" \ --tags '[{"Key": "key1", "Value": "value1"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS HealthLake Entwicklerhandbuch unter [Hinzufügen eines Tags zu einem Datenspeicher](https://docs.aws.amazon.com/healthlake/latest/devguide/add-a-tag.html).* . + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einem Datenspeicher.** Das folgende Beispiel für `untag-resource` zeigt, wie Sie Tags aus einem Datenspeicher entfernen. ``` aws healthlake untag-resource \ --resource-arn "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/b91723d65c6fdeb1d26543a49d2ed1fa" \ --tag-keys '["key1"]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS HealthLake Entwicklerhandbuch* unter [Entfernen von Tags aus einem Datenspeicher](https://docs.aws.amazon.com/healthlake/latest/devguide/remove-tags.html). + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/healthlake/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # HealthOmics Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren HealthOmics. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `abort-multipart-read-set-upload` Das folgende Codebeispiel zeigt, wie Sie`abort-multipart-read-set-upload`. **AWS CLI** **So stoppen Sie den Upload eines mehrteiligen Lesesatz-Uploads** Im folgenden `abort-multipart-read-set-upload` Beispiel wird der Upload eines mehrteiligen Lesesatzes in Ihren HealthOmics Sequenzspeicher gestoppt. ``` aws omics abort-multipart-read-set-upload \ --sequence-store-id 0123456789 \ --upload-id 1122334455 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Direktes Hochladen in einen Sequenzspeicher](https://docs.aws.amazon.com/omics/latest/dev/synchronous-uploads.html). + Einzelheiten zur API finden Sie [AbortMultipartReadSetUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/abort-multipart-read-set-upload.html)in der *AWS CLI Befehlsreferenz*. ### `accept-share` Das folgende Codebeispiel zeigt die Verwendung`accept-share`. **AWS CLI** **So akzeptieren Sie einen Teil der Analytics-Speicherdaten** Im folgenden `accept-share` Beispiel wird ein Teil der HealthOmics Analytics-Store-Daten akzeptiert. ``` aws omics accept-share \ ----share-id "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a" ``` Ausgabe: ``` { "status": "ACTIVATING" } ``` Weitere Informationen finden Sie unter [Kontoübergreifendes Teilen](https://docs.aws.amazon.com/omics/latest/dev/cross-account-sharing.html) im *AWS HealthOmics Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AcceptShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/accept-share.html)in der *AWS CLI Befehlsreferenz.* ### `batch-delete-read-set` Das folgende Codebeispiel zeigt die Verwendung`batch-delete-read-set`. **AWS CLI** **So löschen Sie mehrere Lesesätze** Im folgenden Beispiel für `batch-delete-read-set` werden zwei Lesesätze gelöscht. ``` aws omics batch-delete-read-set \ --sequence-store-id 1234567890 \ --ids 1234567890 0123456789 ``` Wenn beim Löschen eines der angegebenen Lesesätze ein Fehler auftritt, gibt der Service eine Fehlerliste zurück. ``` { "errors": [ { "code": "", "id": "0123456789", "message": "The specified readset does not exist." } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [BatchDeleteReadSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/batch-delete-read-set.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-annotation-import-job` Das folgende Codebeispiel zeigt die Verwendung`cancel-annotation-import-job`. **AWS CLI** **So brechen Sie einen Importauftrag für Anmerkungen ab** Im folgenden Beispiel für `cancel-annotation-import-job` wird ein Importauftrag für Anmerkungen mit der ID `04f57618-xmpl-4fd0-9349-e5a85aefb997` abgebrochen. ``` aws omics cancel-annotation-import-job \ --job-id 04f57618-xmpl-4fd0-9349-e5a85aefb997 ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [CancelAnnotationImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/cancel-annotation-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-run` Das folgende Codebeispiel zeigt die Verwendung`cancel-run`. **AWS CLI** **So brechen Sie eine Ausführung ab** Im folgenden Beispiel für `cancel-run` wird eine Ausführung mit der ID `1234567` abgebrochen. ``` aws omics cancel-run \ --id 1234567 ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Lebenszyklus in einem Workflow ausführen](https://docs.aws.amazon.com/omics/latest/dev/monitoring-runs.html). + Einzelheiten zur API finden Sie [CancelRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/cancel-run.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-variant-import-job` Das folgende Codebeispiel zeigt die Verwendung`cancel-variant-import-job`. **AWS CLI** **So brechen Sie einen Variantenimportjob ab** Im folgenden Beispiel für `cancel-variant-import-job` wird ein Variantenimportauftrag mit der ID `69cb65d6-xmpl-4a4a-9025-4565794b684e` abgebrochen. ``` aws omics cancel-variant-import-job \ --job-id 69cb65d6-xmpl-4a4a-9025-4565794b684e ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [CancelVariantImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/cancel-variant-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `complete-multipart-read-set-upload` Das folgende Codebeispiel zeigt die Verwendung`complete-multipart-read-set-upload`. **AWS CLI** **So schließen Sie einen mehrteiligen Upload ab, nachdem Sie alle Komponenten hochgeladen haben.** Im folgenden Beispiel für `complete-multipart-read-set-upload` wird ein mehrteiliger Upload in einen Sequenzspeicher abgebrochen, sobald alle Komponenten hochgeladen wurden. ``` aws omics complete-multipart-read-set-upload \ --sequence-store-id 0123456789 \ --upload-id 1122334455 \ --parts '[{"checksum":"gaCBQMe+rpCFZxLpoP6gydBoXaKKDA/Vobh5zBDb4W4=","partNumber":1,"partSource":"SOURCE1"}]' ``` Ausgabe: ``` { "readSetId": "0000000001" "readSetId": "0000000002" "readSetId": "0000000003" } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Direktes Hochladen in einen Sequenzspeicher](https://docs.aws.amazon.com/omics/latest/dev/synchronous-uploads.html). + Einzelheiten zur API finden Sie [CompleteMultipartReadSetUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/complete-multipart-read-set-upload.html)in der *AWS CLI Befehlsreferenz*. ### `create-annotation-store-version` Das folgende Codebeispiel zeigt die Verwendung`create-annotation-store-version`. **AWS CLI** **So erstellen Sie eine neue Version eines Annotationsspeichers** Im folgenden Beispiel für `create-annotation-store-version` wird eine neue Version eines Annotationsspeichers erstellt. ``` aws omics create-annotation-store-version \ --name my_annotation_store \ --version-name my_version ``` Ausgabe: ``` { "creationTime": "2023-07-21T17:15:49.251040+00:00", "id": "3b93cdef69d2", "name": "my_annotation_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:555555555555:referenceStore/6505293348/reference/5987565360" }, "status": "CREATING", "versionName": "my_version" } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Neue Versionen von Annotationsspeichern erstellen](https://docs.aws.amazon.com/omics/latest/dev/annotation-store-versioning.html). + Einzelheiten zur API finden Sie [CreateAnnotationStoreVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/create-annotation-store-version.html)unter *AWS CLI Befehlsreferenz*. ### `create-annotation-store` Das folgende Codebeispiel zeigt die Verwendung`create-annotation-store`. **AWS CLI** **Beispiel 1: So erstellen Sie einen VCF-Annotationsspeicher** Im folgenden Beispiel für `create-annotation-store` wird ein Annotationsspeicher im VCF-Format erstellt. ``` aws omics create-annotation-store \ --name my_ann_store \ --store-format VCF \ --reference referenceArn=arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890 ``` Ausgabe: ``` { "creationTime": "2022-11-23T22:48:39.226492Z", "id": "0a91xmplc71f", "name": "my_ann_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890" }, "status": "CREATING", "storeFormat": "VCF" } ``` **Beispiel 2: So erstellen Sie einen TSV-Annotationsspeicher** Im folgenden Beispiel für `create-annotation-store` wird ein Annotationsspeicher im TSV-Format erstellt. ``` aws omics create-annotation-store \ --name tsv_ann_store \ --store-format TSV \ --reference referenceArn=arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890 \ --store-options file://tsv-store-options.json ``` `tsv-store-options.json` konfiguriert die Formatoptionen für Anmerkungen. ``` { "tsvStoreOptions": { "annotationType": "CHR_START_END_ZERO_BASE", "formatToHeader": { "CHR": "chromosome", "START": "start", "END": "end" }, "schema": [ { "chromosome": "STRING" }, { "start": "LONG" }, { "end": "LONG" }, { "name": "STRING" } ] } } ``` Ausgabe: ``` { "creationTime": "2022-11-30T01:28:08.525586Z", "id": "861cxmpl96b0", "name": "tsv_ann_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890" }, "status": "CREATING", "storeFormat": "TSV", "storeOptions": { "tsvStoreOptions": { "annotationType": "CHR_START_END_ZERO_BASE", "formatToHeader": { "CHR": "chromosome", "END": "end", "START": "start" }, "schema": [ { "chromosome": "STRING" }, { "start": "LONG" }, { "end": "LONG" }, { "name": "STRING" } ] } } } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im Entwicklerhandbuch für Amazon Omics. + Einzelheiten zur API finden Sie [CreateAnnotationStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/create-annotation-store.html)in der *AWS CLI Befehlsreferenz*. ### `create-multipart-read-set-upload` Das folgende Codebeispiel zeigt die Verwendung`create-multipart-read-set-upload`. **AWS CLI** **So starten Sie einen mehrteiligen Lesesatz-Upload.** Im folgenden Beispiel für `create-multipart-read-set-upload` wird ein mehrteiliger Lesesatz-Upload initiiert. ``` aws omics create-multipart-read-set-upload \ --sequence-store-id 0123456789 \ --name HG00146 \ --source-file-type FASTQ \ --subject-id mySubject\ --sample-id mySample\ --description "FASTQ for HG00146"\ --generated-from "1000 Genomes" ``` Ausgabe: ``` { "creationTime": "2022-07-13T23:25:20Z", "description": "FASTQ for HG00146", "generatedFrom": "1000 Genomes", "name": "HG00146", "sampleId": "mySample", "sequenceStoreId": "0123456789", "sourceFileType": "FASTQ", "subjectId": "mySubject", "uploadId": "1122334455" } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Direktes Hochladen in einen Sequenzspeicher](https://docs.aws.amazon.com/omics/latest/dev/synchronous-uploads.html). + Einzelheiten zur API finden Sie [CreateMultipartReadSetUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/create-multipart-read-set-upload.html)in der *AWS CLI Befehlsreferenz*. ### `create-reference-store` Das folgende Codebeispiel zeigt die Verwendung`create-reference-store`. **AWS CLI** **So erstellen Sie einen Referenzspeicher** Im folgenden Beispiel für `create-reference-store` wird ein Referenzspeicher namens `my-ref-store` erstellt. ``` aws omics create-reference-store \ --name my-ref-store ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890", "creationTime": "2022-11-22T22:13:25.947Z", "id": "1234567890", "name": "my-ref-store" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [CreateReferenceStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/create-reference-store.html)in der *AWS CLI Befehlsreferenz*. ### `create-run-group` Das folgende Codebeispiel zeigt die Verwendung`create-run-group`. **AWS CLI** **So erstellen Sie eine Ausführungsgruppe** Im folgenden Beispiel für `create-run-group` wird eine Ausführungsgruppe namens `cram-converter` erstellt. ``` aws omics create-run-group \ --name cram-converter \ --max-cpus 20 \ --max-gpus 10 \ --max-duration 600 \ --max-runs 5 ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:runGroup/1234567", "id": "1234567", "tags": {} } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Erstellen von Ausführungsgruppen](https://docs.aws.amazon.com/omics/latest/dev/creating-run-groups.html). + Einzelheiten zur API finden Sie [CreateRunGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/create-run-group.html)unter *AWS CLI Befehlsreferenz*. ### `create-sequence-store` Das folgende Codebeispiel zeigt die Verwendung`create-sequence-store`. **AWS CLI** **So erstellen Sie einen Sequenzspeicher** Im folgenden Beispiel für `create-sequence-store` wird ein Sequenzspeicher erstellt. ``` aws omics create-sequence-store \ --name my-seq-store ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890", "creationTime": "2022-11-23T01:24:33.629Z", "id": "1234567890", "name": "my-seq-store" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [CreateSequenceStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/create-sequence-store.html)in der *AWS CLI Befehlsreferenz*. ### `create-share` Das folgende Codebeispiel zeigt die Verwendung`create-share`. **AWS CLI** **Um einen Share eines HealthOmics Analytics-Stores zu erstellen** Das folgende `create-share` Beispiel zeigt, wie Sie einen Share eines HealthOmics Analytics-Stores erstellen, der von einem Abonnenten außerhalb des Kontos akzeptiert werden kann. ``` aws omics create-share \ --resource-arn "arn:aws:omics:us-west-2:555555555555:variantStore/omics_dev_var_store" \ --principal-subscriber "123456789012" \ --name "my_Share-123" ``` Ausgabe: ``` { "shareId": "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a", "name": "my_Share-123", "status": "PENDING" } ``` *Weitere Informationen finden Sie unter [Accountübergreifendes Teilen](https://docs.aws.amazon.com/omics/latest/dev/cross-account-sharing.html) im AWS HealthOmics Benutzerhandbuch.* + *Einzelheiten zur API finden Sie [CreateShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/create-share.html)in AWS CLI der Befehlsreferenz.* ### `create-variant-store` Das folgende Codebeispiel zeigt die Verwendung`create-variant-store`. **AWS CLI** **So erstellen Sie einen Variantenspeicher** Im folgenden Beispiel für `create-variant-store` wird ein Variantenspeicher namens `my_var_store` erstellt. ``` aws omics create-variant-store \ --name my_var_store \ --reference referenceArn=arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890 ``` Ausgabe: ``` { "creationTime": "2022-11-23T22:09:07.534499Z", "id": "02dexmplcfdd", "name": "my_var_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890" }, "status": "CREATING" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [CreateVariantStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/create-variant-store.html)in der *AWS CLI Befehlsreferenz*. ### `create-workflow` Das folgende Codebeispiel zeigt die Verwendung`create-workflow`. **AWS CLI** **Um einen Workflow zu erstellen** Im folgenden Beispiel für `create-workflow` wird ein WDL-Workflow erstellt. ``` aws omics create-workflow \ --name cram-converter \ --engine WDL \ --definition-zip fileb://workflow-crambam.zip \ --parameter-template file://workflow-params.json ``` `workflow-crambam.zip` ist ein ZIP-Archiv, das eine Workflow-Definition enthält. `workflow-params.json` definiert Laufzeitparameter für den Workflow. ``` { "ref_fasta" : { "description": "Reference genome fasta file", "optional": false }, "ref_fasta_index" : { "description": "Index of the reference genome fasta file", "optional": false }, "ref_dict" : { "description": "dictionary file for 'ref_fasta'", "optional": false }, "input_cram" : { "description": "The Cram file to convert to BAM", "optional": false }, "sample_name" : { "description": "The name of the input sample, used to name the output BAM", "optional": false } } ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:workflow/1234567", "id": "1234567", "status": "CREATING", "tags": {} } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Private Workflows erstellen](https://docs.aws.amazon.com/omics/latest/dev/workflows-setup.html). + Einzelheiten zur API finden Sie [CreateWorkflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/create-workflow.html)in der *AWS CLI Befehlsreferenz*. ### `delete-annotation-store-versions` Das folgende Codebeispiel zeigt die Verwendung`delete-annotation-store-versions`. **AWS CLI** **So löschen Sie eine Annotationsspeicherversion** Im folgenden Beispiel für `delete-annotation-store-versions` wird eine Version des Annotationsspeichers gelöscht. ``` aws omics delete-annotation-store-versions \ --name my_annotation_store \ --versions my_version ``` Ausgabe: ``` { "errors": [] } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Neue Versionen von Annotationsspeichern erstellen](https://docs.aws.amazon.com/omics/latest/dev/annotation-store-versioning.html). + Einzelheiten zur API finden Sie [DeleteAnnotationStoreVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-annotation-store-versions.html)unter *AWS CLI Befehlsreferenz*. ### `delete-annotation-store` Das folgende Codebeispiel zeigt die Verwendung`delete-annotation-store`. **AWS CLI** **So löschen Sie einen Annotationsspeicher** Im folgenden Beispiel für `delete-annotation-store` wird ein Annotationsspeicher mit dem Namen `my_vcf_store` gelöscht. ``` aws omics delete-annotation-store \ --name my_vcf_store ``` Ausgabe: ``` { "status": "DELETING" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [DeleteAnnotationStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-annotation-store.html)in der *AWS CLI Befehlsreferenz*. ### `delete-reference-store` Das folgende Codebeispiel zeigt die Verwendung`delete-reference-store`. **AWS CLI** **So löschen Sie einen Referenzspeicher** Im folgenden Beispiel für `delete-reference-store` wird ein Referenzspeicher mit der ID `1234567890` gelöscht. ``` aws omics delete-reference-store \ --id 1234567890 ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [DeleteReferenceStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-reference-store.html)in der *AWS CLI Befehlsreferenz*. ### `delete-reference` Das folgende Codebeispiel zeigt die Verwendung`delete-reference`. **AWS CLI** **So löschen Sie eine Referenz** Im folgenden Beispiel für `delete-reference` wird eine Referenz gelöscht. ``` aws omics delete-reference \ --reference-store-id 1234567890 \ --id 1234567890 ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [DeleteReference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-reference.html)in der *AWS CLI Befehlsreferenz*. ### `delete-run-group` Das folgende Codebeispiel zeigt die Verwendung`delete-run-group`. **AWS CLI** **So löschen Sie eine Ausführungsgruppe** Im folgenden Beispiel für `delete-run-group` wird eine Ausführungsgruppe mit der ID `1234567` gelöscht. ``` aws omics delete-run-group \ --id 1234567 ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Löschen von Läufen und Ausführungsgruppen](https://docs.aws.amazon.com/omics/latest/dev/deleting-workflows-and-runs.html). + Einzelheiten zur API finden Sie [DeleteRunGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-run-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-run` Das folgende Codebeispiel zeigt die Verwendung`delete-run`. **AWS CLI** **So löschen Sie eine Workflow-Ausführung** Im folgenden Beispiel für `delete-run` wird eine Ausführung mit der ID `1234567` gelöscht. ``` aws omics delete-run \ --id 1234567 ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Löschen von Läufen und Ausführungsgruppen](https://docs.aws.amazon.com/omics/latest/dev/deleting-workflows-and-runs.html). + Einzelheiten zur API finden Sie [DeleteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-run.html)in der *AWS CLI Befehlsreferenz*. ### `delete-sequence-store` Das folgende Codebeispiel zeigt die Verwendung`delete-sequence-store`. **AWS CLI** **So löschen Sie einen Sequenzspeicher** Im folgenden Beispiel für `delete-sequence-store` wird ein Sequenzspeicher mit der ID `1234567890` gelöscht. ``` aws omics delete-sequence-store \ --id 1234567890 ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [DeleteSequenceStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-sequence-store.html)in der *AWS CLI Befehlsreferenz*. ### `delete-share` Das folgende Codebeispiel zeigt die Verwendung`delete-share`. **AWS CLI** **Um einen Teil der HealthOmics Analysedaten zu löschen** Im folgenden Beispiel für `delete-share` wird eine kontoübergreifender Freigabe von Analysedaten gelöscht. ``` aws omics delete-share \ --share-id "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a" ``` Ausgabe: ``` { "status": "DELETING" } ``` Weitere Informationen finden Sie unter [Accountübergreifendes Teilen](https://docs.aws.amazon.com/omics/latest/dev/cross-account-sharing.html) im *AWS HealthOmics Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-share.html)in der *AWS CLI Befehlsreferenz.* ### `delete-variant-store` Das folgende Codebeispiel zeigt die Verwendung`delete-variant-store`. **AWS CLI** **So löschen Sie einen Variantenspeicher** Im folgenden Beispiel für `delete-variant-store` wird ein Variantenspeicher namens `my_var_store` gelöscht. ``` aws omics delete-variant-store \ --name my_var_store ``` Ausgabe: ``` { "status": "DELETING" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [DeleteVariantStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-variant-store.html)in der *AWS CLI Befehlsreferenz*. ### `delete-workflow` Das folgende Codebeispiel zeigt die Verwendung`delete-workflow`. **AWS CLI** **So löschen Sie einen Workflow** Im folgenden Beispiel für `delete-workflow` wird ein Workflow mit der ID `1234567` gelöscht. ``` aws omics delete-workflow \ --id 1234567 ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Löschen eines privaten Workflows](https://docs.aws.amazon.com/omics/latest/dev/delete-private-workflow.html). + Einzelheiten zur API finden Sie [DeleteWorkflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/delete-workflow.html)in der *AWS CLI Befehlsreferenz*. ### `get-annotation-import-job` Das folgende Codebeispiel zeigt die Verwendung`get-annotation-import-job`. **AWS CLI** **So zeigen Sie einen Importauftrag für Anmerkungen an** Im folgenden Beispiel für `get-annotation-import-job` werden Details zu einem Importauftrag für Anmerkungen abgerufen. ``` aws omics get-annotation-import-job \ --job-id 984162c7-xmpl-4d23-ab47-286f7950bfbf ``` Ausgabe: ``` { "creationTime": "2022-11-30T01:40:11.017746Z", "destinationName": "tsv_ann_store", "id": "984162c7-xmpl-4d23-ab47-286f7950bfbf", "items": [ { "jobStatus": "COMPLETED", "source": "s3://omics-artifacts-01d6xmpl4e72dd32/targetedregions.bed.gz" } ], "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "runLeftNormalization": false, "status": "COMPLETED", "updateTime": "2022-11-30T01:42:39.134009Z" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetAnnotationImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-annotation-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `get-annotation-store-version` Das folgende Codebeispiel zeigt die Verwendung`get-annotation-store-version`. **AWS CLI** **So rufen Sie die Metadaten für eine Annotationsspeicherversion ab** Im folgenden Beispiel für `get-annotation-store-version` werden die Metadaten für die angeforderte Version des Annotationsspeichers abgerufen. ``` aws omics get-annotation-store-version \ --name my_annotation_store \ --version-name my_version ``` Ausgabe: ``` { "storeId": "4934045d1c6d", "id": "2a3f4a44aa7b", "status": "ACTIVE", "versionArn": "arn:aws:omics:us-west-2:555555555555:annotationStore/my_annotation_store/version/my_version", "name": "my_annotation_store", "versionName": "my_version", "creationTime": "2023-07-21T17:15:49.251040+00:00", "updateTime": "2023-07-21T17:15:56.434223+00:00", "statusMessage": "", "versionSizeBytes": 0 } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Neue Versionen von Annotationsspeichern erstellen](https://docs.aws.amazon.com/omics/latest/dev/annotation-store-versioning.html). + Einzelheiten zur API finden Sie [GetAnnotationStoreVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-annotation-store-version.html)unter *AWS CLI Befehlsreferenz*. ### `get-annotation-store` Das folgende Codebeispiel zeigt die Verwendung`get-annotation-store`. **AWS CLI** **So zeigen Sie einen Annotationsspeicher an** Im folgenden Beispiel für `get-annotation-store` werden Details zu einem Annotationsspeicher mit dem Namen `my_ann_store` abgerufen. ``` aws omics get-annotation-store \ --name my_ann_store ``` Ausgabe: ``` { "creationTime": "2022-11-23T22:48:39.226492Z", "id": "0a91xmplc71f", "name": "my_ann_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890" }, "status": "CREATING", "storeArn": "arn:aws:omics:us-west-2:123456789012:annotationStore/my_ann_store", "storeFormat": "VCF", "storeSizeBytes": 0, "tags": {} } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetAnnotationStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-annotation-store.html)in der *AWS CLI Befehlsreferenz*. ### `get-read-set-activation-job` Das folgende Codebeispiel zeigt die Verwendung`get-read-set-activation-job`. **AWS CLI** **So zeigen Sie einen Lesesatz-Aktivierungsauftrag an** Im folgenden Beispiel für `get-read-set-activation-job` werden Details zu einem Lesesatz-Aktivierungsauftrag abgerufen. ``` aws omics get-read-set-activation-job \ --sequence-store-id 1234567890 \ --id 1234567890 ``` Ausgabe: ``` { "completionTime": "2022-12-06T22:33:42.828Z", "creationTime": "2022-12-06T22:32:45.213Z", "id": "1234567890", "sequenceStoreId": "1234567890", "sources": [ { "readSetId": "1234567890", "status": "FINISHED", "statusMessage": "No activation needed as read set is already in ACTIVATING or ACTIVE state." } ], "status": "COMPLETED", "statusMessage": "The job completed successfully." } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetReadSetActivationJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-read-set-activation-job.html)in der *AWS CLI Befehlsreferenz*. ### `get-read-set-export-job` Das folgende Codebeispiel zeigt die Verwendung`get-read-set-export-job`. **AWS CLI** **So zeigen Sie einen Lesesatz-Exportauftrag an** Im folgenden Beispiel für `get-read-set-export-job` werden Details zu einem Lesesatz-Exportauftrag abgerufen. ``` aws omics get-read-set-export-job \ --sequence-store-id 1234567890 \ --id 1234567890 ``` Ausgabe: ``` { "completionTime": "2022-12-06T22:39:14.491Z", "creationTime": "2022-12-06T22:37:18.612Z", "destination": "s3://omics-artifacts-01d6xmpl4e72dd32/read-set-export/", "id": "1234567890", "sequenceStoreId": "1234567890", "status": "COMPLETED", "statusMessage": "The job is submitted and will start soon." } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetReadSetExportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-read-set-export-job.html)in der *AWS CLI Befehlsreferenz*. ### `get-read-set-import-job` Das folgende Codebeispiel zeigt die Verwendung`get-read-set-import-job`. **AWS CLI** **So zeigen Sie einen Lesesatz-Importauftrag an** Im folgenden Beispiel für `get-read-set-import-job` werden Details zu einem Lesesatz-Importauftrag abgerufen. ``` aws omics get-read-set-import-job \ --sequence-store-id 1234567890 \ --id 1234567890 ``` Ausgabe: ``` { "creationTime": "2022-11-23T01:36:38.158Z", "id": "1234567890", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "sequenceStoreId": "1234567890", "sources": [ { "name": "HG00100", "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890", "sampleId": "bam-sample", "sourceFileType": "BAM", "sourceFiles": { "source1": "s3://omics-artifacts-01d6xmpl4e72dd32/HG00100.chrom20.ILLUMINA.bwa.GBR.low_coverage.20101123.bam", "source2": "" }, "status": "IN_PROGRESS", "statusMessage": "The source job is currently in progress.", "subjectId": "bam-subject", "tags": { "aws:omics:sampleId": "bam-sample", "aws:omics:subjectId": "bam-subject" } }, { "name": "HG00146", "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890", "sampleId": "fastq-sample", "sourceFileType": "FASTQ", "sourceFiles": { "source1": "s3://omics-artifacts-01d6xmpl4e72dd32/SRR233106_1.filt.fastq.gz", "source2": "s3://omics-artifacts-01d6xmpl4e72dd32/SRR233106_2.filt.fastq.gz" }, "status": "IN_PROGRESS", "statusMessage": "The source job is currently in progress.", "subjectId": "fastq-subject", "tags": { "aws:omics:sampleId": "fastq-sample", "aws:omics:subjectId": "fastq-subject" } }, { "name": "HG00096", "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890", "sampleId": "cram-sample", "sourceFileType": "CRAM", "sourceFiles": { "source1": "s3://omics-artifacts-01d6xmpl4e72dd32/HG00096.alt_bwamem_GRCh38DH.20150718.GBR.low_coverage.cram", "source2": "" }, "status": "IN_PROGRESS", "statusMessage": "The source job is currently in progress.", "subjectId": "cram-subject", "tags": { "aws:omics:sampleId": "cram-sample", "aws:omics:subjectId": "cram-subject" } } ], "status": "IN_PROGRESS", "statusMessage": "The job is currently in progress." } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetReadSetImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-read-set-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `get-read-set-metadata` Das folgende Codebeispiel zeigt die Verwendung`get-read-set-metadata`. **AWS CLI** **So zeigen Sie einen Lesesatz an** Im folgenden Beispiel für `get-read-set-metadata` werden Details zu den Dateien eines Lesesatzes abgerufen. ``` aws omics get-read-set-metadata \ --sequence-store-id 1234567890 \ --id 1234567890 ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/1234567890", "creationTime": "2022-11-23T21:55:00.515Z", "fileType": "FASTQ", "files": { "source1": { "contentLength": 310054739, "partSize": 104857600, "totalParts": 3 }, "source2": { "contentLength": 307846621, "partSize": 104857600, "totalParts": 3 } }, "id": "1234567890", "name": "HG00146", "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890", "sampleId": "fastq-sample", "sequenceInformation": { "alignment": "UNALIGNED", "totalBaseCount": 677717384, "totalReadCount": 8917334 }, "sequenceStoreId": "1234567890", "status": "ACTIVE", "subjectId": "fastq-subject" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetReadSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-read-set-metadata.html)in der *AWS CLI Befehlsreferenz*. ### `get-read-set` Das folgende Codebeispiel zeigt die Verwendung`get-read-set`. **AWS CLI** **So laden Sie einen Lesesatz herunter** Im folgenden Beispiel für `get-read-set` wird Teil 3 eines Lesesatzes als`1234567890.3.bam` heruntergeladen. ``` aws omics get-read-set \ --sequence-store-id 1234567890 \ --id 1234567890 \ --part-number 3 1234567890.3.bam ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetReadSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-read-set.html)in der *AWS CLI Befehlsreferenz*. ### `get-reference-import-job` Das folgende Codebeispiel zeigt die Verwendung`get-reference-import-job`. **AWS CLI** **So zeigen Sie einen Referenzimportauftrag an** Im folgenden Beispiel für `get-reference-import-job` werden Details zu einem Referenzimportauftrag abgerufen. ``` aws omics get-reference-import-job \ --reference-store-id 1234567890 \ --id 1234567890 ``` Ausgabe: ``` { "creationTime": "2022-11-22T22:25:41.124Z", "id": "1234567890", "referenceStoreId": "1234567890", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "sources": [ { "name": "assembly-38", "sourceFile": "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.fasta", "status": "IN_PROGRESS", "statusMessage": "The source job is currently in progress." } ], "status": "IN_PROGRESS", "statusMessage": "The job is currently in progress." } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetReferenceImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-reference-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `get-reference-metadata` Das folgende Codebeispiel zeigt die Verwendung`get-reference-metadata`. **AWS CLI** **So zeigen Sie eine Referenz an** Im folgenden Beispiel für `get-reference-metadata` werden Details zu einer Referenz abgerufen. ``` aws omics get-reference-metadata \ --reference-store-id 1234567890 \ --id 1234567890 ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890", "creationTime": "2022-11-22T22:27:09.033Z", "files": { "index": { "contentLength": 160928, "partSize": 104857600, "totalParts": 1 }, "source": { "contentLength": 3249912778, "partSize": 104857600, "totalParts": 31 } }, "id": "1234567890", "md5": "7ff134953dcca8c8997453bbb80b6b5e", "name": "assembly-38", "referenceStoreId": "1234567890", "status": "ACTIVE", "updateTime": "2022-11-22T22:27:09.033Z" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetReferenceMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-reference-metadata.html)in der *AWS CLI Befehlsreferenz*. ### `get-reference-store` Das folgende Codebeispiel zeigt die Verwendung`get-reference-store`. **AWS CLI** **So zeigen Sie einen Referenzspeicher an** Im folgenden Beispiel für `get-reference-store` werden Details zu einem Referenzspeicher abgerufen. ``` aws omics get-reference-store \ --id 1234567890 ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890", "creationTime": "2022-09-23T23:27:20.364Z", "id": "1234567890", "name": "my-rstore-0" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetReferenceStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-reference-store.html)in der *AWS CLI Befehlsreferenz*. ### `get-reference` Das folgende Codebeispiel zeigt die Verwendung`get-reference`. **AWS CLI** **So laden Sie eine Genomreferenz herunter** Im folgenden Beispiel für `get-reference` wird Teil 1 eines Genoms als `hg38.1.fa` heruntergeladen. ``` aws omics get-reference \ --reference-store-id 1234567890 \ --id 1234567890 \ --part-number 1 hg38.1.fa ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetReference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-reference.html)in der *AWS CLI Befehlsreferenz*. ### `get-run-group` Das folgende Codebeispiel zeigt die Verwendung`get-run-group`. **AWS CLI** **So zeigen Sie eine Ausführungsgruppe an** Im folgenden Beispiel für `get-run-group` werden Details zu einer Ausführungsgruppe abgerufen. ``` aws omics get-run-group \ --id 1234567 ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:runGroup/1234567", "creationTime": "2022-12-01T00:58:42.915219Z", "id": "1234567", "maxCpus": 20, "maxDuration": 600, "name": "cram-convert", "tags": {} } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Erstellen von Ausführungsgruppen](https://docs.aws.amazon.com/omics/latest/dev/creating-run-groups.html). + Einzelheiten zur API finden Sie [GetRunGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-run-group.html)unter *AWS CLI Befehlsreferenz*. ### `get-run-task` Das folgende Codebeispiel zeigt die Verwendung`get-run-task`. **AWS CLI** **So zeigen Sie eine Aufgabe an** Im folgenden Beispiel für `get-run-task` werden Details zu einer Workflow-Aufgabe abgerufen. ``` aws omics get-run-task \ --id 1234567 \ --task-id 1234567 ``` Ausgabe: ``` { "cpus": 1, "creationTime": "2022-11-30T23:13:00.718651Z", "logStream": "arn:aws:logs:us-west-2:123456789012:log-group:/aws/omics/WorkflowLog:log-stream:run/1234567/task/1234567", "memory": 15, "name": "CramToBamTask", "startTime": "2022-11-30T23:17:47.016Z", "status": "COMPLETED", "stopTime": "2022-11-30T23:18:21.503Z", "taskId": "1234567" } ``` Weitere Informationen finden Sie [im *AWS HealthOmics Benutzerhandbuch* unter Aufgabenlebenszyklus in einer HealthOmics Ausführung](https://docs.aws.amazon.com/omics/latest/dev/workflow-run-tasks.html). + Einzelheiten zur API finden Sie [GetRunTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-run-task.html)in der *AWS CLI Befehlsreferenz*. ### `get-run` Das folgende Codebeispiel zeigt die Verwendung`get-run`. **AWS CLI** **So zeigen Sie eine Workflow-Ausführung an** Im folgenden Beispiel für `get-run` werden Details zu einer Workflow-Ausführung abgerufen. ``` aws omics get-run \ --id 1234567 ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:run/1234567", "creationTime": "2022-11-30T22:58:22.615865Z", "digest": "sha256:c54bxmpl742dcc26f7fa1f10e37550ddd8f251f418277c0a58e895b801ed28cf", "id": "1234567", "name": "cram-to-bam", "outputUri": "s3://omics-artifacts-01d6xmpl4e72dd32/workflow-output/", "parameters": { "ref_dict": "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.dict", "ref_fasta_index": "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.fasta.fai", "ref_fasta": "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.fasta", "sample_name": "NA12878", "input_cram": "s3://omics-artifacts-01d6xmpl4e72dd32/NA12878.cram" }, "resourceDigests": { "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.fasta.fai": "etag:f76371b113734a56cde236bc0372de0a", "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.dict": "etag:3884c62eb0e53fa92459ed9bff133ae6", "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.fasta": "etag:e307d81c605fb91b7720a08f00276842-388", "s3://omics-artifacts-01d6xmpl4e72dd32/NA12878.cram": "etag:a9f52976381286c6143b5cc681671ec6" }, "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "startedBy": "arn:aws:iam::123456789012:user/laptop-2020", "status": "STARTING", "tags": {}, "workflowId": "1234567", "workflowType": "PRIVATE" } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Lebenszyklus in einem Workflow ausführen](https://docs.aws.amazon.com/omics/latest/dev/monitoring-runs.html). + Einzelheiten zur API finden Sie [GetRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-run.html)in der *AWS CLI Befehlsreferenz*. ### `get-sequence-store` Das folgende Codebeispiel zeigt die Verwendung`get-sequence-store`. **AWS CLI** **So zeigen Sie einen Sequenzspeicher an** Im folgenden Beispiel für `get-sequence-store` werden Details zu einem Sequenzspeicher mit der ID `1234567890` abgerufen. ``` aws omics get-sequence-store \ --id 1234567890 ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-east-1:123456789012:sequenceStore/1234567890", "creationTime": "2022-11-23T19:55:48.376Z", "id": "1234567890", "name": "my-seq-store" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetSequenceStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-sequence-store.html)in der *AWS CLI Befehlsreferenz*. ### `get-share` Das folgende Codebeispiel zeigt die Verwendung`get-share`. **AWS CLI** **Um die Metadaten zu einem Teil von HealthOmics Analysedaten abzurufen** Im folgenden Beispiel für `get-share` werden die Metadaten für eine kontoübergreifender Freigabe von Analysedaten abgerufen. ``` aws omics get-share \ --share-id "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a" ``` Ausgabe: ``` { "share": { "shareId": "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a", "name": "my_Share-123", "resourceArn": "arn:aws:omics:us-west-2:555555555555:variantStore/omics_dev_var_store", "principalSubscriber": "123456789012", "ownerId": "555555555555", "status": "PENDING" } } ``` Weitere Informationen finden Sie unter [Kontoübergreifendes Teilen](https://docs.aws.amazon.com/omics/latest/dev/cross-account-sharing.html) im *AWS HealthOmics Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-share.html)in der *AWS CLI Befehlsreferenz.* ### `get-variant-import-job` Das folgende Codebeispiel zeigt die Verwendung`get-variant-import-job`. **AWS CLI** **So zeigen Sie einen Variantenimportauftrag an** Im folgenden Beispiel für `get-variant-import-job` werden Details zu einem Variantenimportauftrag abgerufen. ``` aws omics get-variant-import-job \ --job-id edd7b8ce-xmpl-47e2-bc99-258cac95a508 ``` Ausgabe: ``` { "creationTime": "2022-11-23T22:42:50.037812Z", "destinationName": "my_var_store", "id": "edd7b8ce-xmpl-47e2-bc99-258cac95a508", "items": [ { "jobStatus": "IN_PROGRESS", "source": "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.known_indels.vcf.gz" } ], "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "runLeftNormalization": false, "status": "IN_PROGRESS", "updateTime": "2022-11-23T22:43:05.898309Z" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetVariantImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-variant-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `get-variant-store` Das folgende Codebeispiel zeigt die Verwendung`get-variant-store`. **AWS CLI** **So zeigen Sie einen Variantenspeicher an** Im folgenden Beispiel für `get-variant-store` werden Details zu einem Variantenspeicher abgerufen. ``` aws omics get-variant-store \ --name my_var_store ``` Ausgabe: ``` { "creationTime": "2022-11-23T22:09:07.534499Z", "id": "02dexmplcfdd", "name": "my_var_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890" }, "status": "CREATING", "storeArn": "arn:aws:omics:us-west-2:123456789012:variantStore/my_var_store", "storeSizeBytes": 0, "tags": {}, "updateTime": "2022-11-23T22:09:24.931711Z" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [GetVariantStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-variant-store.html)in der *AWS CLI Befehlsreferenz*. ### `get-workflow` Das folgende Codebeispiel zeigt die Verwendung`get-workflow`. **AWS CLI** **So zeigen Sie einen Workflow an** Im folgenden Beispiel für `get-workflow` werden Details zu einem Workflow mit der ID `1234567` abgerufen. ``` aws omics get-workflow \ --id 1234567 ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:workflow/1234567", "creationTime": "2022-11-30T22:33:16.225368Z", "digest": "sha256:c54bxmpl742dcc26f7fa1f10e37550ddd8f251f418277c0a58e895b801ed28cf", "engine": "WDL", "id": "1234567", "main": "workflow-crambam.wdl", "name": "cram-converter", "parameterTemplate": { "ref_dict": { "description": "dictionary file for 'ref_fasta'" }, "ref_fasta_index": { "description": "Index of the reference genome fasta file" }, "ref_fasta": { "description": "Reference genome fasta file" }, "input_cram": { "description": "The Cram file to convert to BAM" }, "sample_name": { "description": "The name of the input sample, used to name the output BAM" } }, "status": "ACTIVE", "statusMessage": "workflow-crambam.wdl\n workflow CramToBamFlow\n call CramToBamTask\n call ValidateSamFile\n task CramToBamTask\n task ValidateSamFile\n", "tags": {}, "type": "PRIVATE" } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Private Workflows erstellen](https://docs.aws.amazon.com/omics/latest/dev/workflows-setup.html). + Einzelheiten zur API finden Sie [GetWorkflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/get-workflow.html)in der *AWS CLI Befehlsreferenz*. ### `list-annotation-import-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-annotation-import-jobs`. **AWS CLI** **So rufen Sie eine Liste von Annotations-Importaufträgen ab** Im folgenden Beispiel für `list-annotation-import-jobs` wird eine Liste von Annotations-Importaufgaben abgerufen. ``` aws omics list-annotation-import-jobs ``` Ausgabe: ``` { "annotationImportJobs": [ { "creationTime": "2022-11-30T01:39:41.478294Z", "destinationName": "gff_ann_store", "id": "18a9e792-xmpl-4869-a105-e5b602900444", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "runLeftNormalization": false, "status": "COMPLETED", "updateTime": "2022-11-30T01:47:09.145178Z" }, { "creationTime": "2022-11-30T00:45:58.007838Z", "destinationName": "my_ann_store", "id": "4e9eafc8-xmpl-431e-a0b2-3bda27cb600a", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "runLeftNormalization": false, "status": "FAILED", "updateTime": "2022-11-30T00:47:01.706325Z" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListAnnotationImportJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-annotation-import-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-annotation-store-versions` Das folgende Codebeispiel zeigt die Verwendung`list-annotation-store-versions`. **AWS CLI** **So listen Sie alle Versionen eines Annotationsspeichers auf** Im folgenden Beispiel für `list-annotation-store-versions` werden alle Versionen aufgelistet, die in einem Annotationsspeicher vorhanden sind. ``` aws omics list-annotation-store-versions \ --name my_annotation_store ``` Ausgabe: ``` { "annotationStoreVersions": [ { "storeId": "4934045d1c6d", "id": "2a3f4a44aa7b", "status": "CREATING", "versionArn": "arn:aws:omics:us-west-2:555555555555:annotationStore/my_annotation_store/version/my_version_2", "name": "my_annotation_store", "versionName": "my_version_2", "creation Time": "2023-07-21T17:20:59.380043+00:00", "versionSizeBytes": 0 }, { "storeId": "4934045d1c6d", "id": "4934045d1c6d", "status": "ACTIVE", "versionArn": "arn:aws:omics:us-west-2:555555555555:annotationStore/my_annotation_store/version/my_version_1", "name": "my_annotation_store", "versionName": "my_version_1", "creationTime": "2023-07-21T17:15:49.251040+00:00", "updateTime": "2023-07-21T17:15:56.434223+00:00", "statusMessage": "", "versionSizeBytes": 0 } } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Neue Versionen von Annotationsspeichern erstellen](https://docs.aws.amazon.com/omics/latest/dev/annotation-store-versioning.html). + Einzelheiten zur API finden Sie [ListAnnotationStoreVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-annotation-store-versions.html)unter *AWS CLI Befehlsreferenz*. ### `list-annotation-stores` Das folgende Codebeispiel zeigt die Verwendung`list-annotation-stores`. **AWS CLI** **So rufen Sie eine Liste der Annotationsspeicher ab** Im folgenden Beispiel für `list-annotation-stores` wird eine Liste von Annotationsspeichern abgerufen. ``` aws omics list-annotation-stores ``` Ausgabe: ``` { "annotationStores": [ { "creationTime": "2022-11-23T22:48:39.226492Z", "id": "0a91xmplc71f", "name": "my_ann_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890" }, "status": "ACTIVE", "statusMessage": "", "storeArn": "arn:aws:omics:us-west-2:123456789012:annotationStore/my_ann_store", "storeFormat": "VCF", "storeSizeBytes": 0, "updateTime": "2022-11-23T22:53:27.372840Z" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListAnnotationStores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-annotation-stores.html)in der *AWS CLI Befehlsreferenz*. ### `list-multipart-read-set-uploads` Das folgende Codebeispiel zeigt die Verwendung`list-multipart-read-set-uploads`. **AWS CLI** **So listen Sie alle mehrteiligen Lesesatz-Uploads und deren Status auf.** Im folgenden Beispiel für `list-multipart-read-set-uploads` werden alle mehrteiligen Lesesatz-Uploads und deren Status aufgelistet. ``` aws omics list-multipart-read-set-uploads \ --sequence-store-id 0123456789 ``` Ausgabe: ``` { "uploads": [ { "sequenceStoreId": "0123456789", "uploadId": "8749584421", "sourceFileType": "FASTQ", "subjectId": "mySubject", "sampleId": "mySample", "generatedFrom": "1000 Genomes", "name": "HG00146", "description": "FASTQ for HG00146", "creationTime": "2023-11-29T19:22:51.349298+00:00" }, { "sequenceStoreId": "0123456789", "uploadId": "5290538638", "sourceFileType": "BAM", "subjectId": "mySubject", "sampleId": "mySample", "generatedFrom": "1000 Genomes", "referenceArn": "arn:aws:omics:us-west-2:845448930428:referenceStore/8168613728/reference/2190697383", "name": "HG00146", "description": "BAM for HG00146", "creationTime": "2023-11-29T19:23:33.116516+00:00" }, { "sequenceStoreId": "0123456789", "uploadId": "4174220862", "sourceFileType": "BAM", "subjectId": "mySubject", "sampleId": "mySample", "generatedFrom": "1000 Genomes", "referenceArn": "arn:aws:omics:us-west-2:845448930428:referenceStore/8168613728/reference/2190697383", "name": "HG00147", "description": "BAM for HG00147", "creationTime": "2023-11-29T19:23:47.007866+00:00" } ] } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Direktes Hochladen in einen Sequenzspeicher](https://docs.aws.amazon.com/omics/latest/dev/synchronous-uploads.html). + Einzelheiten zur API finden Sie [ListMultipartReadSetUploads](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-multipart-read-set-uploads.html)in der *AWS CLI Befehlsreferenz*. ### `list-read-set-activation-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-read-set-activation-jobs`. **AWS CLI** **So rufen Sie eine Liste der Lesesatz-Aktivierungsaufträge ab** Im folgenden Beispiel für `list-read-set-activation-jobs` wird eine Liste von Aktivierungsaufträgen für einen Sequenzspeicher mit der ID `1234567890` abgerufen. ``` aws omics list-read-set-activation-jobs \ --sequence-store-id 1234567890 ``` Ausgabe: ``` { "activationJobs": [ { "completionTime": "2022-12-06T22:33:42.828Z", "creationTime": "2022-12-06T22:32:45.213Z", "id": "1234567890", "sequenceStoreId": "1234567890", "status": "COMPLETED" }, { "creationTime": "2022-12-06T22:35:10.100Z", "id": "1234567890", "sequenceStoreId": "1234567890", "status": "IN_PROGRESS" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListReadSetActivationJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-read-set-activation-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-read-set-export-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-read-set-export-jobs`. **AWS CLI** **So rufen Sie eine Liste von Lesesatz-Exportaufträgen ab** Im folgenden Beispiel für `list-read-set-export-jobs` wird eine Liste von Exportaufträgen für einen Sequenzspeicher mit der ID `1234567890` abgerufen. ``` aws omics list-read-set-export-jobs \ --sequence-store-id 1234567890 ``` Ausgabe: ``` { "exportJobs": [ { "completionTime": "2022-12-06T22:39:14.491Z", "creationTime": "2022-12-06T22:37:18.612Z", "destination": "s3://omics-artifacts-01d6xmpl4e72dd32/read-set-export/", "id": "1234567890", "sequenceStoreId": "1234567890", "status": "COMPLETED" }, { "creationTime": "2022-12-06T22:38:04.871Z", "destination": "s3://omics-artifacts-01d6xmpl4e72dd32/read-set-export/", "id": "1234567890", "sequenceStoreId": "1234567890", "status": "IN_PROGRESS" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListReadSetExportJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-read-set-export-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-read-set-import-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-read-set-import-jobs`. **AWS CLI** **So rufen Sie eine Liste von Lesesatz-Importaufträgen ab** Im folgenden Beispiel für `list-read-set-import-jobs` wird eine Liste von Importaufträgen für einen Sequenzspeicher mit der ID `1234567890` abgerufen. ``` aws omics list-read-set-import-jobs \ --sequence-store-id 1234567890 ``` Ausgabe: ``` { "importJobs": [ { "completionTime": "2022-11-29T18:17:49.244Z", "creationTime": "2022-11-29T17:32:47.700Z", "id": "1234567890", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "sequenceStoreId": "1234567890", "status": "COMPLETED" }, { "completionTime": "2022-11-23T22:01:34.090Z", "creationTime": "2022-11-23T21:52:43.289Z", "id": "1234567890", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "sequenceStoreId": "1234567890", "status": "COMPLETED_WITH_FAILURES" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListReadSetImportJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-read-set-import-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-read-set-upload-parts` Das folgende Codebeispiel zeigt die Verwendung`list-read-set-upload-parts`. **AWS CLI** **So listen Sie alle Teile in einem angeforderten mehrteiligen Sequenzspeicher-Upload auf.** Im folgenden Beispiel für `list-read-set-upload-parts` werden alle Teile in einem angeforderten mehrteiligen Sequenzspeicher-Upload aufgelistet. ``` aws omics list-read-set-upload-parts \ --sequence-store-id 0123456789 \ --upload-id 1122334455 \ --part-source SOURCE1 ``` Ausgabe: ``` { "parts": [ { "partNumber": 1, "partSize": 94371840, "file": "SOURCE1", "checksum": "984979b9928ae8d8622286c4a9cd8e99d964a22d59ed0f5722e1733eb280e635", "lastUpdatedTime": "2023-02-02T20:14:47.533000+00:00" } { "partNumber": 2, "partSize": 10471840, "file": "SOURCE1", "checksum": "984979b9928ae8d8622286c4a9cd8e99d964a22d59ed0f5722e1733eb280e635", "lastUpdatedTime": "2023-02-02T20:14:47.533000+00:00" } ] } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Direktes Hochladen in einen Sequenzspeicher](https://docs.aws.amazon.com/omics/latest/dev/synchronous-uploads.html). + Einzelheiten zur API finden Sie [ListReadSetUploadParts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-read-set-upload-parts.html)in der *AWS CLI Befehlsreferenz*. ### `list-read-sets` Das folgende Codebeispiel zeigt die Verwendung`list-read-sets`. **AWS CLI** **So rufen Sie eine Liste der Lesesätze ab** Im folgenden Beispiel für `list-read-sets` wird eine Liste von Lesesätzen für einen Sequenzspeicher mit der ID `1234567890` abgerufen. ``` aws omics list-read-sets \ --sequence-store-id 1234567890 ``` Ausgabe: ``` { "readSets": [ { "arn": "arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/1234567890", "creationTime": "2022-11-23T21:55:00.515Z", "fileType": "FASTQ", "id": "1234567890", "name": "HG00146", "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890", "sampleId": "fastq-sample", "sequenceStoreId": "1234567890", "status": "ACTIVE", "subjectId": "fastq-subject" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListReadSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-read-sets.html)in der *AWS CLI Befehlsreferenz*. ### `list-reference-import-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-reference-import-jobs`. **AWS CLI** **So rufen Sie eine Liste von Referenzimportaufträgen ab** Im folgenden Beispiel für `list-reference-import-jobs` wird eine Liste von Referenzimportaufträgen für einen Referenzspeicher mit der ID `1234567890` abgerufen. ``` aws omics list-reference-import-jobs \ --reference-store-id 1234567890 ``` Ausgabe: ``` { "importJobs": [ { "completionTime": "2022-11-23T19:54:58.204Z", "creationTime": "2022-11-23T19:53:20.729Z", "id": "1234567890", "referenceStoreId": "1234567890", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "status": "COMPLETED" }, { "creationTime": "2022-11-23T20:34:03.250Z", "id": "1234567890", "referenceStoreId": "1234567890", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "status": "IN_PROGRESS" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListReferenceImportJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-reference-import-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-reference-stores` Das folgende Codebeispiel zeigt die Verwendung`list-reference-stores`. **AWS CLI** **So rufen Sie eine Liste von Referenzspeichern ab** Im folgenden Beispiel für `list-reference-stores` wird eine Liste von Referenzspeichern abgerufen. ``` aws omics list-reference-stores ``` Ausgabe: ``` { "referenceStores": [ { "arn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890", "creationTime": "2022-11-22T22:13:25.947Z", "id": "1234567890", "name": "my-ref-store" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListReferenceStores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-reference-stores.html)in der *AWS CLI Befehlsreferenz*. ### `list-references` Das folgende Codebeispiel zeigt die Verwendung`list-references`. **AWS CLI** **So rufen Sie eine Liste von Referenzen ab** Im folgenden Beispiel für `list-references` wird eine Liste von Genomreferenzen für einen Referenzspeicher mit der ID `1234567890` abgerufen. ``` aws omics list-references \ --reference-store-id 1234567890 ``` Ausgabe: ``` { "references": [ { "arn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890", "creationTime": "2022-11-22T22:27:09.033Z", "id": "1234567890", "md5": "7ff134953dcca8c8997453bbb80b6b5e", "name": "assembly-38", "referenceStoreId": "1234567890", "status": "ACTIVE", "updateTime": "2022-11-22T22:27:09.033Z" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListReferences](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-references.html)in der *AWS CLI Befehlsreferenz*. ### `list-run-groups` Das folgende Codebeispiel zeigt die Verwendung`list-run-groups`. **AWS CLI** **So rufen Sie eine Liste von Ausführungsgruppen ab** Im folgenden Beispiel für `list-run-groups` wird eine Liste von Ausführungsgruppen abgerufen. ``` aws omics list-run-groups ``` Ausgabe: ``` { "items": [ { "arn": "arn:aws:omics:us-west-2:123456789012:runGroup/1234567", "creationTime": "2022-12-01T00:58:42.915219Z", "id": "1234567", "maxCpus": 20, "maxDuration": 600, "name": "cram-convert" } ] } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Erstellen von Ausführungsgruppen](https://docs.aws.amazon.com/omics/latest/dev/creating-run-groups.html). + Einzelheiten zur API finden Sie [ListRunGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-run-groups.html)unter *AWS CLI Befehlsreferenz*. ### `list-run-tasks` Das folgende Codebeispiel zeigt die Verwendung`list-run-tasks`. **AWS CLI** **So rufen Sie eine Liste von Aufgaben ab** Im folgenden Beispiel für `list-run-tasks` wird eine Liste von Aufgaben für eine Workflow-Ausführung abgerufen. ``` aws omics list-run-tasks \ --id 1234567 ``` Ausgabe: ``` { "items": [ { "cpus": 1, "creationTime": "2022-11-30T23:13:00.718651Z", "memory": 15, "name": "CramToBamTask", "startTime": "2022-11-30T23:17:47.016Z", "status": "COMPLETED", "stopTime": "2022-11-30T23:18:21.503Z", "taskId": "1234567" }, { "cpus": 1, "creationTime": "2022-11-30T23:18:32.315606Z", "memory": 4, "name": "ValidateSamFile", "startTime": "2022-11-30T23:23:40.165Z", "status": "COMPLETED", "stopTime": "2022-11-30T23:24:14.766Z", "taskId": "1234567" } ] } ``` Weitere Informationen finden Sie [im *AWS HealthOmics Benutzerhandbuch* unter Aufgabenlebenszyklus in einer HealthOmics Ausführung](https://docs.aws.amazon.com/omics/latest/dev/workflow-run-tasks.html). + Einzelheiten zur API finden Sie [ListRunTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-run-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `list-runs` Das folgende Codebeispiel zeigt die Verwendung`list-runs`. **AWS CLI** **So rufen Sie eine Liste der Workflow-Ausführungen ab** Im folgenden Beispiel für `list-runs` wird eine Liste von Workflow-Ausführungen abgerufen. ``` aws omics list-runs ``` Ausgabe: ``` { "items": [ { "arn": "arn:aws:omics:us-west-2:123456789012:run/1234567", "creationTime": "2022-12-02T23:20:01.202074Z", "id": "1234567", "name": "cram-to-bam", "priority": 1, "startTime": "2022-12-02T23:29:18.115Z", "status": "COMPLETED", "stopTime": "2022-12-02T23:57:54.428812Z", "storageCapacity": 10, "workflowId": "1234567" }, { "arn": "arn:aws:omics:us-west-2:123456789012:run/1234567", "creationTime": "2022-12-03T00:16:57.180066Z", "id": "1234567", "name": "cram-to-bam", "priority": 1, "startTime": "2022-12-03T00:26:50.233Z", "status": "FAILED", "stopTime": "2022-12-03T00:37:21.451340Z", "storageCapacity": 10, "workflowId": "1234567" }, { "arn": "arn:aws:omics:us-west-2:123456789012:run/1234567", "creationTime": "2022-12-05T17:57:08.444817Z", "id": "1234567", "name": "cram-to-bam", "status": "STARTING", "workflowId": "1234567" } ] } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Lebenszyklus in einem Workflow ausführen](https://docs.aws.amazon.com/omics/latest/dev/monitoring-runs.html). + Einzelheiten zur API finden Sie [ListRuns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-runs.html)in der *AWS CLI Befehlsreferenz*. ### `list-sequence-stores` Das folgende Codebeispiel zeigt die Verwendung`list-sequence-stores`. **AWS CLI** **So rufen Sie eine Liste von Sequenzspeichern ab** Im folgenden Beispiel für `list-sequence-stores` wird eine Liste von Sequenzspeichern abgerufen. ``` aws omics list-sequence-stores ``` Ausgabe: ``` { "sequenceStores": [ { "arn": "arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890", "creationTime": "2022-11-23T01:24:33.629Z", "id": "1234567890", "name": "my-seq-store" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListSequenceStores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-sequence-stores.html)in der *AWS CLI Befehlsreferenz*. ### `list-shares` Das folgende Codebeispiel zeigt die Verwendung`list-shares`. **AWS CLI** **Um die verfügbaren Anteile an HealthOmics Analysedaten aufzulisten** Im folgenden Beispiel für `list-shares` werden alle Freigaben aufgelistet, die für einen Ressourcenbesitzer erstellt wurden. ``` aws omics list-shares \ --resource-owner SELF ``` Ausgabe: ``` { "shares": [ { "shareId": "595c1cbd-a008-4eca-a887-954d30c91c6e", "name": "myShare", "resourceArn": "arn:aws:omics:us-west-2:555555555555:variantStore/store_1", "principalSubscriber": "123456789012", "ownerId": "555555555555", "status": "PENDING" } { "shareId": "39b65d0d-4368-4a19-9814-b0e31d73c10a", "name": "myShare3456", "resourceArn": "arn:aws:omics:us-west-2:555555555555:variantStore/store_2", "principalSubscriber": "123456789012", "ownerId": "555555555555", "status": "ACTIVE" }, { "shareId": "203152f5-eef9-459d-a4e0-a691668d44ef", "name": "myShare4", "resourceArn": "arn:aws:omics:us-west-2:555555555555:variantStore/store_3", "principalSubscriber": "123456789012", "ownerId": "555555555555", "status": "ACTIVE" } ] } ``` Weitere Informationen finden Sie unter [Accountübergreifendes Teilen](https://docs.aws.amazon.com/omics/latest/dev/cross-account-sharing.html) im *AWS HealthOmics Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListShares](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-shares.html)in der *AWS CLI Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So rufen Sie eine Tag-Liste ab** Im folgenden Beispiel für `list-tags-for-resource` wird eine Liste von Tags für eine Workflow-Ausführung mit der ID `1234567` abgerufen. ``` aws omics list-tags-for-resource \ --resource-arn arn:aws:omics:us-west-2:123456789012:workflow/1234567 ``` Ausgabe: ``` { "tags": { "department": "analytics" } } ``` Weitere Informationen finden Sie unter [Markieren von Ressourcen in Amazon Omics](https://docs.aws.amazon.com/omics/latest/dev/workflows.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-variant-import-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-variant-import-jobs`. **AWS CLI** **So rufen Sie eine Liste von Variantenimportaufträgen ab** Im folgenden Beispiel für `list-variant-import-jobs` wird eine Liste von Variantenimportaufgaben abgerufen. ``` aws omics list-variant-import-jobs ``` Ausgabe: ``` { "variantImportJobs": [ { "creationTime": "2022-11-23T22:47:02.514002Z", "destinationName": "my_var_store", "id": "69cb65d6-xmpl-4a4a-9025-4565794b684e", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "runLeftNormalization": false, "status": "COMPLETED", "updateTime": "2022-11-23T22:49:17.976597Z" }, { "creationTime": "2022-11-23T22:42:50.037812Z", "destinationName": "my_var_store", "id": "edd7b8ce-xmpl-47e2-bc99-258cac95a508", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "runLeftNormalization": false, "status": "COMPLETED", "updateTime": "2022-11-23T22:45:26.009880Z" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListVariantImportJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-variant-import-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-variant-stores` Das folgende Codebeispiel zeigt die Verwendung`list-variant-stores`. **AWS CLI** **So rufen Sie eine Liste von Variantenspeichern ab** Im folgenden Beispiel für `list-variant-stores` wird eine Liste von Variantenspeichern abgerufen. ``` aws omics list-variant-stores ``` Ausgabe: ``` { "variantStores": [ { "creationTime": "2022-11-23T22:09:07.534499Z", "id": "02dexmplcfdd", "name": "my_var_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890" }, "status": "CREATING", "storeArn": "arn:aws:omics:us-west-2:123456789012:variantStore/my_var_store", "storeSizeBytes": 0, "updateTime": "2022-11-23T22:09:24.931711Z" }, { "creationTime": "2022-09-23T23:00:09.140265Z", "id": "8777xmpl1a24", "name": "myvstore0", "status": "ACTIVE", "storeArn": "arn:aws:omics:us-west-2:123456789012:variantStore/myvstore0", "storeSizeBytes": 0, "updateTime": "2022-09-23T23:03:26.013220Z" } ] } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [ListVariantStores](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-variant-stores.html)in der *AWS CLI Befehlsreferenz*. ### `list-workflows` Das folgende Codebeispiel zeigt die Verwendung`list-workflows`. **AWS CLI** **So rufen Sie eine Liste von Workflows ab** Im folgenden Beispiel für `list-workflows` wird eine Liste von Workflows abgerufen. ``` aws omics list-workflows ``` Ausgabe: ``` { "items": [ { "arn": "arn:aws:omics:us-west-2:123456789012:workflow/1234567", "creationTime": "2022-09-23T23:08:22.041227Z", "digest": "nSCNo/qMWFxmplXpUdokXJnwgneOaxyyc2YOxVxrJTE=", "id": "1234567", "name": "my-wkflow-0", "status": "ACTIVE", "type": "PRIVATE" }, { "arn": "arn:aws:omics:us-west-2:123456789012:workflow/1234567", "creationTime": "2022-11-30T22:33:16.225368Z", "digest": "sha256:c54bxmpl742dcc26f7fa1f10e37550ddd8f251f418277c0a58e895b801ed28cf", "id": "1234567", "name": "cram-converter", "status": "ACTIVE", "type": "PRIVATE" } ] } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Private Workflows erstellen](https://docs.aws.amazon.com/omics/latest/dev/workflows-setup.html). + Einzelheiten zur API finden Sie [ListWorkflows](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/list-workflows.html)in der *AWS CLI Befehlsreferenz*. ### `start-annotation-import-job` Das folgende Codebeispiel zeigt die Verwendung`start-annotation-import-job`. **AWS CLI** **So importieren Sie Anmerkungen** Im folgenden Beispiel für `start-annotation-import-job` werden Anmerkungen aus Amazon S3 importiert. ``` aws omics start-annotation-import-job \ --destination-name tsv_ann_store \ --no-run-left-normalization \ --role-arn arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ \ --items source=s3://omics-artifacts-01d6xmpl4e72dd32/targetedregions.bed.gz ``` Ausgabe: ``` { "jobId": "984162c7-xmpl-4d23-ab47-286f7950bfbf" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [StartAnnotationImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/start-annotation-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-read-set-activation-job` Das folgende Codebeispiel zeigt die Verwendung`start-read-set-activation-job`. **AWS CLI** **So aktivieren Sie einen archivierten Lesesatz** Im folgenden Beispiel für `start-read-set-activation-job` werden zwei Lesesätze aktiviert. ``` aws omics start-read-set-activation-job \ --sequence-store-id 1234567890 \ --sources readSetId=1234567890 readSetId=1234567890 ``` Ausgabe: ``` { "creationTime": "2022-12-06T22:35:10.100Z", "id": "1234567890", "sequenceStoreId": "1234567890", "status": "SUBMITTED" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [StartReadSetActivationJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/start-read-set-activation-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-read-set-export-job` Das folgende Codebeispiel zeigt die Verwendung`start-read-set-export-job`. **AWS CLI** **So exportieren Sie einen Lesesatz** Im folgenden Beispiel für `start-read-set-export-job` werden zwei Lesesätze nach Amazon S3 exportiert. ``` aws omics start-read-set-export-job \ --sequence-store-id 1234567890 \ --sources readSetId=1234567890 readSetId=1234567890 \ --role-arn arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ \ --destination s3://omics-artifacts-01d6xmpl4e72dd32/read-set-export/ ``` Ausgabe: ``` { "creationTime": "2022-12-06T22:37:18.612Z", "destination": "s3://omics-artifacts-01d6xmpl4e72dd32/read-set-export/", "id": "1234567890", "sequenceStoreId": "1234567890", "status": "SUBMITTED" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [StartReadSetExportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/start-read-set-export-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-read-set-import-job` Das folgende Codebeispiel zeigt die Verwendung`start-read-set-import-job`. **AWS CLI** **So importieren Sie einen Lesesatz** Im folgenden Beispiel für `start-read-set-import-job` wird ein Lesesatz importiert. ``` aws omics start-read-set-import-job \ --sequence-store-id 1234567890 \ --role-arn arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ \ --sources file://readset-sources.json ``` readset-sources.json ist ein JSON-Dokument mit dem folgenden Inhalt. ``` [ { "sourceFiles": { "source1": "s3://omics-artifacts-01d6xmpl4e72dd32/HG00100.chrom20.ILLUMINA.bwa.GBR.low_coverage.20101123.bam" }, "sourceFileType": "BAM", "subjectId": "bam-subject", "sampleId": "bam-sample", "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890", "name": "HG00100" } ] ``` Ausgabe: ``` { "creationTime": "2022-11-23T01:36:38.158Z", "id": "1234567890", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "sequenceStoreId": "1234567890", "status": "SUBMITTED" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [StartReadSetImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/start-read-set-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-reference-import-job` Das folgende Codebeispiel zeigt die Verwendung`start-reference-import-job`. **AWS CLI** **So importieren Sie ein Referenzgenom** Im folgenden Beispiel für `start-reference-import-job` wird ein Referenzgenom aus Amazon S3 importiert. ``` aws omics start-reference-import-job \ --reference-store-id 1234567890 \ --role-arn arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ \ --sources sourceFile=s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.fasta,name=assembly-38 ``` Ausgabe: ``` { "creationTime": "2022-11-22T22:25:41.124Z", "id": "1234567890", "referenceStoreId": "1234567890", "roleArn": "arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ", "status": "SUBMITTED" } ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/sequence-stores.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [StartReferenceImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/start-reference-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `start-run` Das folgende Codebeispiel zeigt die Verwendung`start-run`. **AWS CLI** **Um einen Workflow auszuführen** Im folgenden Beispiel für `start-run` wird ein Workflow mit der ID `1234567` ausgeführt. ``` aws omics start-run \ --workflow-id 1234567 \ --role-arn arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ \ --name 'cram-to-bam' \ --output-uri s3://omics-artifacts-01d6xmpl4e72dd32/workflow-output/ \ --run-group-id 1234567 \ --priority 1 \ --storage-capacity 10 \ --log-level ALL \ --parameters file://workflow-inputs.json ``` workflow-inputs.json ist ein JSON-Dokument mit dem folgenden Inhalt. ``` { "sample_name": "NA12878", "input_cram": "s3://omics-artifacts-01d6xmpl4e72dd32/NA12878.cram", "ref_dict": "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.dict", "ref_fasta": "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.fasta", "ref_fasta_index": "omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.fasta.fai" } ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:run/1234567", "id": "1234567", "status": "PENDING", "tags": {} } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Einen Lauf starten](https://docs.aws.amazon.com/omics/latest/dev/starting-a-run.html). **So laden Sie Quelldateien aus Amazon Omics** Sie können Quelldateien auch aus dem Amazon Omics-Speicher laden, indem Sie URIs dienstspezifisch verwenden. Die folgende Beispieldatei workflow-inputs.json verwendet Amazon Omics URIs für Lesesatz- und Referenzgenomquellen. ``` { "sample_name": "NA12878", "input_cram": "omics://123456789012.storage.us-west-2.amazonaws.com/1234567890/readSet/1234567890/source1", "ref_dict": "s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.dict", "ref_fasta": "omics://123456789012.storage.us-west-2.amazonaws.com/1234567890/reference/1234567890", "ref_fasta_index": "omics://123456789012.storage.us-west-2.amazonaws.com/1234567890/reference/1234567890/index" } ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [StartRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/start-run.html)AWS CLI * ### `start-variant-import-job` Das folgende Codebeispiel zeigt die Verwendung`start-variant-import-job`. **AWS CLI** **So importieren Sie eine Variantendatei** Im folgenden Beispiel für `start-variant-import-job` wird eine Variantendatei im VCF-Format importiert. ``` aws omics start-variant-import-job \ --destination-name my_var_store \ --no-run-left-normalization \ --role-arn arn:aws:iam::123456789012:role/omics-service-role-serviceRole-W8O1XMPL7QZ \ --items source=s3://omics-artifacts-01d6xmpl4e72dd32/Homo_sapiens_assembly38.known_indels.vcf.gz ``` Ausgabe: ``` { "jobId": "edd7b8ce-xmpl-47e2-bc99-258cac95a508" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [StartVariantImportJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/start-variant-import-job.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird ein `department`-Tag zu einem Workflow mit der ID `1234567` hinzugefügt. ``` aws omics tag-resource \ --resource-arn arn:aws:omics:us-west-2:123456789012:workflow/1234567 \ --tags department=analytics ``` Weitere Informationen finden Sie unter [Markieren von Ressourcen in Amazon Omics](https://docs.aws.amazon.com/omics/latest/dev/workflows.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einer Ressource** Im folgenden Beispiel für `untag-resource` wird das `department`-Tag aus eine Workflow entfernt. ``` aws omics untag-resource \ --resource-arn arn:aws:omics:us-west-2:123456789012:workflow/1234567 \ --tag-keys department ``` Weitere Informationen dazu finden Sie unter [Omics Storage](https://docs.aws.amazon.com/omics/latest/dev/tagging.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-annotation-store` Das folgende Codebeispiel zeigt die Verwendung`update-annotation-store`. **AWS CLI** **So aktualisieren Sie einen Annotationsspeicher** Im folgenden Beispiel für `update-annotation-store` wird die Beschreibung eines Annotationsspeichers namens `my_vcf_store` aktualisiert. ``` aws omics update-annotation-store \ --name my_vcf_store \ --description "VCF annotation store" ``` Ausgabe: ``` { "creationTime": "2022-12-05T18:00:56.101860Z", "description": "VCF annotation store", "id": "bd6axmpl2444", "name": "my_vcf_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890" }, "status": "ACTIVE", "storeFormat": "VCF", "updateTime": "2022-12-05T18:13:16.100051Z" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [UpdateAnnotationStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/update-annotation-store.html)in der *AWS CLI Befehlsreferenz*. ### `update-run-group` Das folgende Codebeispiel zeigt die Verwendung`update-run-group`. **AWS CLI** **So aktualisieren Sie eine Ausführungsgruppe** Im folgenden Beispiel für `update-run-group` werden die Einstellungen einer Ausführungsgruppe mit der ID `1234567` aktualisiert. ``` aws omics update-run-group \ --id 1234567 \ --max-cpus 10 ``` Ausgabe: ``` { "arn": "arn:aws:omics:us-west-2:123456789012:runGroup/1234567", "creationTime": "2022-12-01T00:58:42.915219Z", "id": "1234567", "maxCpus": 10, "maxDuration": 600, "name": "cram-convert", "tags": {} } ``` Weitere Informationen dazu finden Sie unter [Omics Workflows](https://docs.aws.amazon.com/omics/latest/dev/workflows.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [UpdateRunGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/update-run-group.html)in der *AWS CLI Befehlsreferenz*. ### `update-variant-store` Das folgende Codebeispiel zeigt die Verwendung`update-variant-store`. **AWS CLI** **So aktualisieren Sie einen Variantenspeicher** Im folgenden Beispiel für `update-variant-store` wird die Beschreibung eines Variantenspeichers namens `my_var_store` aktualisiert. ``` aws omics update-variant-store \ --name my_var_store \ --description "variant store" ``` Ausgabe: ``` { "creationTime": "2022-11-23T22:09:07.534499Z", "description": "variant store", "id": "02dexmplcfdd", "name": "my_var_store", "reference": { "referenceArn": "arn:aws:omics:us-west-2:123456789012:referenceStore/1234567890/reference/1234567890" }, "status": "ACTIVE", "updateTime": "2022-12-05T18:23:37.686402Z" } ``` Weitere Informationen dazu finden Sie unter [Omics Analytics](https://docs.aws.amazon.com/omics/latest/dev/omics-analytics.html) im *Entwicklerhandbuch für Amazon Omics*. + Einzelheiten zur API finden Sie [UpdateVariantStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/update-variant-store.html)in der *AWS CLI Befehlsreferenz*. ### `update-workflow` Das folgende Codebeispiel zeigt die Verwendung`update-workflow`. **AWS CLI** **So aktualisieren Sie einen Workflow** Im folgenden Beispiel für `1234567` wird die Beschreibung eines Workflows mit der ID `update-workflow` aktualisiert. ``` aws omics update-workflow \ --id 1234567 \ --description "copy workflow" ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Erstellen oder Aktualisieren eines Workflows](https://docs.aws.amazon.com/omics/latest/dev/creating-private-workflows.html). + Einzelheiten zur API finden Sie [UpdateWorkflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/update-workflow.html)unter *AWS CLI Befehlsreferenz*. ### `upload-read-set-part` Das folgende Codebeispiel zeigt die Verwendung`upload-read-set-part`. **AWS CLI** **So laden Sie einen Teil des Lesesatzes hoch.** Im folgenden Beispiel für `upload-read-set-part` wird ein bestimmter Teil eines Lesesatzes hochgeladen. ``` aws omics upload-read-set-part \ --sequence-store-id 0123456789 \ --upload-id 1122334455 \ --part-source SOURCE1 \ --part-number 1 \ --payload /path/to/file/read_1_part_1.fastq.gz ``` Ausgabe: ``` { "checksum": "984979b9928ae8d8622286c4a9cd8e99d964a22d59ed0f5722e1733eb280e635" } ``` Weitere Informationen finden Sie im *AWS HealthOmics Benutzerhandbuch* unter [Direktes Hochladen in einen Sequenzspeicher](https://docs.aws.amazon.com/omics/latest/dev/synchronous-uploads.html). + Einzelheiten zur API finden Sie [UploadReadSetPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/omics/upload-read-set-part.html)in der *AWS CLI Befehlsreferenz*. # IAM-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface mit IAM Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-client-id-to-open-id-connect-provider` Das folgende Codebeispiel zeigt, wie Sie`add-client-id-to-open-id-connect-provider`. **AWS CLI** **So fügen Sie einem Open-ID Connect (OIDC)-Anbieter eine Client-ID (Zielgruppe) hinzu** Der folgende `add-client-id-to-open-id-connect-provider`-Befehl fügt die Client-ID `my-application-ID` zum OIDC-Anbieter mit dem Namen `server.example.com` hinzu. ``` aws iam add-client-id-to-open-id-connect-provider \ --client-id my-application-ID \ --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/server.example.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den `create-open-id-connect-provider`-Befehl, um einen OIDC-Anbieter zu erstellen. Weitere Informationen finden Sie unter [Erstellen von OpenID Connect (OIDC)-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AddClientIdToOpenIdConnectProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/add-client-id-to-open-id-connect-provider.html)in der *AWS CLI Befehlsreferenz*. ### `add-role-to-instance-profile` Das folgende Codebeispiel zeigt die Verwendung`add-role-to-instance-profile`. **AWS CLI** **So fügen Sie eine Rolle zu einem Instance-Profil hinzu** Mit dem folgenden `add-role-to-instance-profile`-Befehl wird die Rolle mit dem Namen `S3Access` zum Instance-Profil mit dem Namen `Webserver` hinzugefügt. ``` aws iam add-role-to-instance-profile \ --role-name S3Access \ --instance-profile-name Webserver ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den `create-instance-profile`-Befehl, um ein Instance-Profil zu erstellen. Weitere Informationen finden Sie unter [Verwenden einer IAM-Rolle zum Erteilen von Berechtigungen für Anwendungen, die auf Amazon-EC2-Instances ausgeführt werden](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AddRoleToInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/add-role-to-instance-profile.html)in der *AWS CLI Befehlsreferenz*. ### `add-user-to-group` Das folgende Codebeispiel zeigt die Verwendung`add-user-to-group`. **AWS CLI** **So fügen Sie einen Benutzer einer IAM-Gruppe hinzu** Mit dem folgenden `add-user-to-group`-Befehl wird ein Benutzer mit dem Namen `Bob` zur IAM-Gruppe mit dem Namen `Admins` hinzugefügt. ``` aws iam add-user-to-group \ --user-name Bob \ --group-name Admins ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen und Entfernen von Benutzern in einer IAM-Benutzergruppe](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage_add-remove-users.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AddUserToGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/add-user-to-group.html)in der *AWS CLI Befehlsreferenz*. ### `attach-group-policy` Das folgende Codebeispiel zeigt die Verwendung`attach-group-policy`. **AWS CLI** **So fügen Sie einer IAM-Gruppe eine verwaltete Richtlinie hinzu** Mit dem folgenden `attach-group-policy` Befehl wird die benannte AWS verwaltete Richtlinie `ReadOnlyAccess` an die angegebene IAM-Gruppe angehängt. `Finance` ``` aws iam attach-group-policy \ --policy-arn arn:aws:iam::aws:policy/ReadOnlyAccess \ --group-name Finance ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen hierzu finden Sie unter [Verwaltete Richtlinien und eingebundene Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [AttachGroupPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-group-policy.html)*Befehlsreferenz*. ### `attach-role-policy` Das folgende Codebeispiel zeigt die Verwendung`attach-role-policy`. **AWS CLI** **So fügen Sie einer IAM-Rolle eine verwaltete Richtlinie an** Mit dem folgenden `attach-role-policy` Befehl wird die benannte AWS verwaltete Richtlinie `ReadOnlyAccess` an die angegebene IAM-Rolle angehängt. `ReadOnlyRole` ``` aws iam attach-role-policy \ --policy-arn arn:aws:iam::aws:policy/ReadOnlyAccess \ --role-name ReadOnlyRole ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen hierzu finden Sie unter [Verwaltete Richtlinien und eingebundene Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [AttachRolePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-role-policy.html)*Befehlsreferenz*. ### `attach-user-policy` Das folgende Codebeispiel zeigt die Verwendung`attach-user-policy`. **AWS CLI** **So fügen Sie einem IAM-Benutzer eine verwaltete Richtlinie an** Mit dem folgenden `attach-user-policy` Befehl wird die AWS verwaltete Richtlinie mit `AdministratorAccess` dem Namen des IAM-Benutzers verknüpft. `Alice` ``` aws iam attach-user-policy \ --policy-arn arn:aws:iam::aws:policy/AdministratorAccess \ --user-name Alice ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen hierzu finden Sie unter [Verwaltete Richtlinien und eingebundene Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [AttachUserPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-user-policy.html)*Befehlsreferenz*. ### `change-password` Das folgende Codebeispiel zeigt die Verwendung`change-password`. **AWS CLI** **So ändern Sie das Passwort für Ihren IAM-Benutzer** Um das Passwort für Ihren IAM-Benutzer zu ändern, empfehlen wir, den `--cli-input-json`-Parameter zu verwenden, um eine JSON-Datei zu übergeben, die Ihr altes und Ihr neues Passwort enthält. Mit dieser Methode können Sie sichere Passwörter mit nicht-alphanumerischen Zeichen verwenden. Es kann schwierig sein, Passwörter mit nicht-alphanumerischen Zeichen zu verwenden, wenn Sie diese als Befehlszeilenparameter übergeben. Um den `--cli-input-json`-Parameter zu verwenden, verwenden Sie zunächst den `change-password`-Befehl mit dem `--generate-cli-skeleton`-Parameter, wie im folgenden Beispiel. ``` aws iam change-password \ --generate-cli-skeleton > change-password.json ``` Mit dem vorherigen Befehl wird eine JSON-Datei mit dem Namen „change-password.json“ erstellt, die Sie zum Eingeben Ihrer alten und neuen Passwörter verwenden können. Die Datei könnte beispielsweise wie folgt aussehen. ``` { "OldPassword": "3s0K_;xh4~8XXI", "NewPassword": "]35d/{pB9Fo9wJ" } ``` Um Ihr Passwort zu ändern, verwenden Sie als Nächstes den `change-password`-Befehl erneut und übergeben dieses Mal den `--cli-input-json`-Parameter zur Angabe Ihrer JSON-Datei. Der folgende `change-password`-Befehl verwendet den `--cli-input-json`-Parameter mit einer JSON-Datei mit dem Namen change-password.json. ``` aws iam change-password \ --cli-input-json file://change-password.json ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Dieser Befehl kann nur von IAM-Benutzern aufgerufen werden. Wenn dieser Befehl mit AWS Kontoanmeldeinformationen (Root) aufgerufen wird, gibt der Befehl einen `InvalidUserType` Fehler zurück. Weitere Informationen finden Sie unter [So ändert ein IAM-Benutzer sein eigenes Passwort](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_user-change-own.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ChangePassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/change-password.html)in der *AWS CLI Befehlsreferenz*. ### `create-access-key` Das folgende Codebeispiel zeigt die Verwendung`create-access-key`. **AWS CLI** **So erstellen Sie einen Zugriffsschlüssel für einen IAM-Benutzer** Mit dem folgenden `create-access-key`-Befehl wird ein Zugriffsschlüssel (Zugriffsschlüssel-ID und geheimer Zugriffsschlüssel) für den IAM-Benutzer mit dem Namen `Bob` erstellt. ``` aws iam create-access-key \ --user-name Bob ``` Ausgabe: ``` { "AccessKey": { "UserName": "Bob", "Status": "Active", "CreateDate": "2015-03-09T18:39:23.411Z", "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY", "AccessKeyId": "AKIAIOSFODNN7EXAMPLE" } } ``` Speichern Sie den geheimen Zugriffsschlüssel an einem sicheren Ort. Bei Verlust kann er nicht wiederhergestellt werden und Sie müssen einen neuen Zugriffsschlüssel erstellen. Weitere Informationen finden Sie unter [Verwalten der Zugriffsschlüssel für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateAccessKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-access-key.html)in der *AWS CLI Befehlsreferenz*. ### `create-account-alias` Das folgende Codebeispiel zeigt die Verwendung`create-account-alias`. **AWS CLI** **So erstellen Sie einen Konto-Alias** Der folgende `create-account-alias` Befehl erstellt den Alias `examplecorp` für Ihr AWS Konto. ``` aws iam create-account-alias \ --account-alias examplecorp ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ihre AWS Konto-ID und deren Alias](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateAccountAlias AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-account-alias.html)*Befehlsreferenz.* ### `create-group` Das folgende Codebeispiel zeigt die Verwendung`create-group`. **AWS CLI** **So erstellen Sie eine IAM-Gruppe** Mit dem folgenden `create-group`-Befehl wird eine IAM-Gruppe mit dem Namen `Admins` erstellt. ``` aws iam create-group \ --group-name Admins ``` Ausgabe: ``` { "Group": { "Path": "/", "CreateDate": "2015-03-09T20:30:24.940Z", "GroupId": "AIDGPMS9RO4H3FEXAMPLE", "Arn": "arn:aws:iam::123456789012:group/Admins", "GroupName": "Admins" } } ``` Weitere Informationen finden Sie unter [Erstellen von IAM-Benutzergruppen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_create.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-instance-profile` Das folgende Codebeispiel zeigt die Verwendung`create-instance-profile`. **AWS CLI** **So erstellen Sie ein Instance-Profil** Der folgende `create-instance-profile`-Befehl erstellt ein Instance-Profil mit dem Namen `Webserver`. ``` aws iam create-instance-profile \ --instance-profile-name Webserver ``` Ausgabe: ``` { "InstanceProfile": { "InstanceProfileId": "AIPAJMBYC7DLSPEXAMPLE", "Roles": [], "CreateDate": "2015-03-09T20:33:19.626Z", "InstanceProfileName": "Webserver", "Path": "/", "Arn": "arn:aws:iam::123456789012:instance-profile/Webserver" } } ``` Verwenden Sie den `add-role-to-instance-profile`-Befehl, um einem Instance-Profil eine Rolle hinzuzufügen. Weitere Informationen finden Sie unter [Verwenden einer IAM-Rolle zum Gewähren von Berechtigungen für Anwendungen, die in Amazon-EC2-Instances ausgeführt werden](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-instance-profile.html)in der *AWS CLI Befehlsreferenz*. ### `create-login-profile` Das folgende Codebeispiel zeigt die Verwendung`create-login-profile`. **AWS CLI** **So erstellen Sie ein Passwort für einen IAM-Benutzer** Für die Erstellung eines Passworts für einen IAM-Benutzer empfehlen wir die Nutzung des Parameters `--cli-input-json` zur Übergabe einer JSON-Datei, die das Passwort enthält. Mit dieser Methode können Sie ein sicheres Passwort mit nicht alphanumerischen Zeichen erstellen. Es kann schwierig sein, ein Passwort mit nicht-alphanumerischen Zeichen zu erstellen, wenn Sie es als Befehlszeilenparameter übergeben. Um den `--cli-input-json`-Parameter zu verwenden, verwenden Sie zunächst den `create-login-profile`-Befehl mit dem `--generate-cli-skeleton`-Parameter, wie im folgenden Beispiel. ``` aws iam create-login-profile \ --generate-cli-skeleton > create-login-profile.json ``` Mit dem vorherigen Befehl wird eine JSON-Datei namens create-login-profile .json erstellt, mit der Sie die Informationen für einen nachfolgenden `create-login-profile` Befehl eingeben können. Beispiel: ``` { "UserName": "Bob", "Password": "&1-3a6u:RA0djs", "PasswordResetRequired": true } ``` Verwenden Sie anschließend zur Erstellung eines Passworts für einen IAM-Benutzer erneut den Befehl `create-login-profile`, diesmal jedoch mit dem Parameter `--cli-input-json` zur Angabe Ihrer JSON-Datei. Der folgende `create-login-profile` Befehl verwendet den `--cli-input-json` Parameter mit einer JSON-Datei namens create-login-profile .json. ``` aws iam create-login-profile \ --cli-input-json file://create-login-profile.json ``` Ausgabe: ``` { "LoginProfile": { "UserName": "Bob", "CreateDate": "2015-03-10T20:55:40.274Z", "PasswordResetRequired": true } } ``` Wenn das neue Passwort gegen die Passwortrichtlinie des Kontos verstößt, gibt der Befehl einen `PasswordPolicyViolation`-Fehler zurück. Um das Passwort für einen Benutzer zu ändern, der bereits über ein Passwort verfügt, verwenden Sie `update-login-profile`. Um eine Passwortrichtlinie für das Konto festzulegen, verwenden Sie den `update-account-password-policy`-Befehl. Sofern die Passwortrichtlinie des Kontos dies zulässt, können IAM-Benutzer mit dem `change-password`-Befehl ihre eigenen Passwörter ändern. Weitere Informationen finden Sie unter [Verwalten von Passwörtern für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_admin-change-user.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateLoginProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-login-profile.html)in der *AWS CLI Befehlsreferenz.* ### `create-open-id-connect-provider` Das folgende Codebeispiel zeigt die Verwendung`create-open-id-connect-provider`. **AWS CLI** **So erstellen Sie einen OpenID Connect (OIDC)-Anbieter** Um einen OpenID Connect (OIDC)-Anbieter zu erstellen, empfehlen wir die Nutzung des Parameters `--cli-input-json` zur Übergabe einer JSON-Datei, die die erforderlichen Parameter enthält. Wenn Sie einen OIDC-Anbieter erstellen, müssen Sie die URL des Anbieters übergeben und die URL muss mit `https://` beginnen. Es kann schwierig sein, die URL als Befehlszeilenparameter zu übergeben, da der Doppelpunkt (:) und der Schrägstrich (/) in einigen Befehlszeilenumgebungen eine besondere Bedeutung haben. Durch die Verwendung des Parameters `--cli-input-json` wird diese Einschränkung umgangen. Um den `--cli-input-json`-Parameter zu verwenden, verwenden Sie zunächst den `create-open-id-connect-provider`-Befehl mit dem `--generate-cli-skeleton`-Parameter, wie im folgenden Beispiel. ``` aws iam create-open-id-connect-provider \ --generate-cli-skeleton > create-open-id-connect-provider.json ``` Mit dem vorherigen Befehl wird eine JSON-Datei mit dem Namen create-open-id-connect -provider.json erstellt, mit der Sie die Informationen für einen nachfolgenden Befehl eingeben können. `create-open-id-connect-provider` Beispiel: ``` { "Url": "https://server.example.com", "ClientIDList": [ "example-application-ID" ], "ThumbprintList": [ "c3768084dfb3d2b68b7897bf5f565da8eEXAMPLE" ] } ``` Verwenden Sie als Nächstes den Befehl `create-open-id-connect-provider` erneut, um den OpenID Connect (OIDC)-Anbieter zu erstellen, und übergeben Sie diesmal den Parameter `--cli-input-json`, um Ihre JSON-Datei anzugeben. Der folgende `create-open-id-connect-provider` Befehl verwendet den `--cli-input-json` Parameter mit einer JSON-Datei namens -provider.json. create-open-id-connect ``` aws iam create-open-id-connect-provider \ --cli-input-json file://create-open-id-connect-provider.json ``` Ausgabe: ``` { "OpenIDConnectProviderArn": "arn:aws:iam::123456789012:oidc-provider/server.example.com" } ``` Weitere Informationen zu OIDC-Anbietern finden Sie unter [Erstellen von OpenID Connect (OIDC)-Identitätsanbietern im *AWS -IAM-Benutzerhandbuch*.](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) Weitere Informationen zum Abrufen von Fingerabdrücken für einen OIDC-Anbieter finden Sie unter [Abrufen des Fingerabdrucks für einen OpenID Connect-Identitätsanbieter](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc_verify-thumbprint.html) im *AWS -IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [CreateOpenIdConnectProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-open-id-connect-provider.html)in AWS CLI der Befehlsreferenz.* ### `create-policy-version` Das folgende Codebeispiel zeigt die Verwendung`create-policy-version`. **AWS CLI** **So erstellen Sie eine neue Version einer verwalteten Richtlinie** In diesem Beispiel wird eine neue `v2`-Version der IAM-Richtlinie erstellt, deren ARN `arn:aws:iam::123456789012:policy/MyPolicy` lautet, und sie zur Standardversion gemacht. ``` aws iam create-policy-version \ --policy-arn arn:aws:iam::123456789012:policy/MyPolicy \ --policy-document file://NewPolicyVersion.json \ --set-as-default ``` Ausgabe: ``` { "PolicyVersion": { "CreateDate": "2015-06-16T18:56:03.721Z", "VersionId": "v2", "IsDefaultVersion": true } } ``` Weitere Informationen finden Sie unter [Versionsverwaltung von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-versioning.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreatePolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-policy-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-policy` Das folgende Codebeispiel zeigt die Verwendung`create-policy`. **AWS CLI** **Beispiel 1: So erstellen Sie eine vom Kunden verwaltete Richtlinie** Mit dem folgenden Befehl wird eine vom Kunden verwaltete Richtlinie mit dem Namen `my-policy` erstellt. Bei der Datei `policy.json` handelt es sich um ein JSON-Dokument im aktuellen `shared`-Ordner, das schreibgeschützten Zugriff auf den Ordner in einem Amazon-S3-Bucket mit dem Namen `amzn-s3-demo-bucket` gewährt. ``` aws iam create-policy \ --policy-name my-policy \ --policy-document file://policy.json ``` Inhalt von policy.json: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:Get*", "s3:List*" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket/shared/*" ] } ] } ``` Ausgabe: ``` { "Policy": { "PolicyName": "my-policy", "CreateDate": "2015-06-01T19:31:18.620Z", "AttachmentCount": 0, "IsAttachable": true, "PolicyId": "ZXR6A36LTYANPAI7NJ5UV", "DefaultVersionId": "v1", "Path": "/", "Arn": "arn:aws:iam::0123456789012:policy/my-policy", "UpdateDate": "2015-06-01T19:31:18.620Z" } } ``` Weitere Informationen zur Verwendung von Dateien als Eingabe für Zeichenkettenparameter finden [Sie unter Angeben von Parameterwerten für die AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html) im *AWS CLI-Benutzerhandbuch*. **Beispiel 2: So erstellen Sie eine vom Kunden verwaltete Richtlinie mit einer Beschreibung** Der folgende Befehl erstellt eine vom Kunden verwaltete Richtlinie mit dem Namen `my-policy` und einer unveränderlichen Beschreibung. Bei der `policy.json`-Datei handelt es sich um ein JSON-Dokument im aktuellen Ordner, das Zugriff auf alle Put-, List- und Get-Aktionen für einen Amazon-S3-Bucket mit dem Namen `amzn-s3-demo-bucket` gewährt. ``` aws iam create-policy \ --policy-name my-policy \ --policy-document file://policy.json \ --description "This policy grants access to all Put, Get, and List actions for amzn-s3-demo-bucket" ``` Inhalt von policy.json: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket*", "s3:PutBucket*", "s3:GetBucket*" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket" ] } ] } ``` Ausgabe: ``` { "Policy": { "PolicyName": "my-policy", "PolicyId": "ANPAWGSUGIDPEXAMPLE", "Arn": "arn:aws:iam::123456789012:policy/my-policy", "Path": "/", "DefaultVersionId": "v1", "AttachmentCount": 0, "PermissionsBoundaryUsageCount": 0, "IsAttachable": true, "CreateDate": "2023-05-24T22:38:47+00:00", "UpdateDate": "2023-05-24T22:38:47+00:00" } } ``` Weitere Informationen zu identitätsbasierten Richtlinien finden Sie unter [Identitätsbasierte Richtlinien und ressourcenbasierte Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_identity-vs-resource.html) im *AWS -IAM-Benutzerhandbuch*. **Beispiel 3: So erstellen Sie eine vom Kunden verwaltete Richtlinie mit Tags** Mit dem folgenden Befehl wird eine vom Kunden verwaltete Richtlinie mit dem Namen `my-policy` mit Tags erstellt. In diesem Beispiel wird der Parameter `--tags` mit den folgenden JSON-formatierten Tags verwendet:`'{"Key": "Department", "Value": "Accounting"}' '{"Key": "Location", "Value": "Seattle"}'`. Alternativ kann der Parameter `--tags` mit Tags im Kurzformat verwendet werden: `'Key=Department,Value=Accounting Key=Location,Value=Seattle'`. Bei der `policy.json`-Datei handelt es sich um ein JSON-Dokument im aktuellen Ordner, das Zugriff auf alle Put-, List- und Get-Aktionen für einen Amazon-S3-Bucket mit dem Namen `amzn-s3-demo-bucket` gewährt. ``` aws iam create-policy \ --policy-name my-policy \ --policy-document file://policy.json \ --tags '{"Key": "Department", "Value": "Accounting"}' '{"Key": "Location", "Value": "Seattle"}' ``` Inhalt von policy.json: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket*", "s3:PutBucket*", "s3:GetBucket*" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket" ] } ] } ``` Ausgabe: ``` { "Policy": { "PolicyName": "my-policy", "PolicyId": "ANPAWGSUGIDPEXAMPLE", "Arn": "arn:aws:iam::12345678012:policy/my-policy", "Path": "/", "DefaultVersionId": "v1", "AttachmentCount": 0, "PermissionsBoundaryUsageCount": 0, "IsAttachable": true, "CreateDate": "2023-05-24T23:16:39+00:00", "UpdateDate": "2023-05-24T23:16:39+00:00", "Tags": [ { "Key": "Department", "Value": "Accounting" }, "Key": "Location", "Value": "Seattle" { ] } } ``` Weitere Informationen zu Tagging-Richtlinien finden Sie unter [Tagging von vom Kunden verwalteten Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags_customer-managed-policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreatePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-policy.html)unter *AWS CLI Befehlsreferenz*. ### `create-role` Das folgende Codebeispiel zeigt die Verwendung`create-role`. **AWS CLI** **Beispiel 1: So erstellen Sie eine IAM-Rolle** Mit dem folgenden `create-role`-Befehl wird eine Rolle mit dem Namen `Test-Role` erstellt und ihr eine Vertrauensrichtlinie angefügt. ``` aws iam create-role \ --role-name Test-Role \ --assume-role-policy-document file://Test-Role-Trust-Policy.json ``` Ausgabe: ``` { "Role": { "AssumeRolePolicyDocument": "", "RoleId": "AKIAIOSFODNN7EXAMPLE", "CreateDate": "2013-06-07T20:43:32.821Z", "RoleName": "Test-Role", "Path": "/", "Arn": "arn:aws:iam::123456789012:role/Test-Role" } } ``` Die Vertrauensrichtlinie ist als JSON-Dokument in der Datei *Test-Role-Trust-Policy.json* definiert. (Der Dateiname und die Erweiterung sind nicht von Bedeutung.) Die Vertrauensrichtlinie muss einen Prinzipal angeben. Verwenden Sie den `put-role-policy`-Befehl, um die Berechtigungsrichtlinie der Rolle anzufügen. Weitere Informationen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) im *AWS -IAM-Benutzerhandbuch*. **Beispiel 2: So erstellen Sie eine IAM-Rolle mit angegebener maximaler Sitzungsdauer** Mit dem folgenden `create-role`-Befehl wird eine Rolle mit dem Namen `Test-Role` erstellt und eine maximale Sitzungsdauer von 7 200 Sekunden (2 Stunden) festgelegt. ``` aws iam create-role \ --role-name Test-Role \ --assume-role-policy-document file://Test-Role-Trust-Policy.json \ --max-session-duration 7200 ``` Ausgabe: ``` { "Role": { "Path": "/", "RoleName": "Test-Role", "RoleId": "AKIAIOSFODNN7EXAMPLE", "Arn": "arn:aws:iam::12345678012:role/Test-Role", "CreateDate": "2023-05-24T23:50:25+00:00", "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::12345678012:root" }, "Action": "sts:AssumeRole" } ] } } } ``` Weitere Informationen finden Sie unter [Ändern der maximalen Sitzungsdauer (AWS API) einer Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-managingrole-editing-api.html#roles-modify_max-session-duration-api) im *AWS IAM-Benutzerhandbuch*. **Beispiel 3: So erstellen Sie eine IAM-Rolle mit Tags** Mit dem folgenden Befehl wird eine IAM-Rolle `Test-Role` mit Tags erstellt. In diesem Beispiel wird das `--tags`-Parameter-Flag mit den folgenden JSON-formatierten Tags verwendet: `'{"Key": "Department", "Value": "Accounting"}' '{"Key": "Location", "Value": "Seattle"}'`. Alternativ kann das `--tags`-Flag mit Tags im Kurzformat `'Key=Department,Value=Accounting Key=Location,Value=Seattle'` verwendet werden. ``` aws iam create-role \ --role-name Test-Role \ --assume-role-policy-document file://Test-Role-Trust-Policy.json \ --tags '{"Key": "Department", "Value": "Accounting"}' '{"Key": "Location", "Value": "Seattle"}' ``` Ausgabe: ``` { "Role": { "Path": "/", "RoleName": "Test-Role", "RoleId": "AKIAIOSFODNN7EXAMPLE", "Arn": "arn:aws:iam::123456789012:role/Test-Role", "CreateDate": "2023-05-25T23:29:41+00:00", "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::123456789012:root" }, "Action": "sts:AssumeRole" } ] }, "Tags": [ { "Key": "Department", "Value": "Accounting" }, { "Key": "Location", "Value": "Seattle" } ] } } ``` Weitere Informationen finden Sie unter [Taggen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags_roles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-role.html)in der *AWS CLI Befehlsreferenz.* ### `create-saml-provider` Das folgende Codebeispiel zeigt die Verwendung`create-saml-provider`. **AWS CLI** **So erstellen Sie einen SAML-Anbieter** In diesem Beispiel wird in IAM ein neuer SAML-Anbieter mit dem Namen `MySAMLProvider` erstellt. Es wird durch das SAML-Metadatendokument beschrieben, das sich in der Datei `SAMLMetaData.xml` befindet. ``` aws iam create-saml-provider \ --saml-metadata-document file://SAMLMetaData.xml \ --name MySAMLProvider ``` Ausgabe: ``` { "SAMLProviderArn": "arn:aws:iam::123456789012:saml-provider/MySAMLProvider" } ``` Weitere Informationen finden Sie unter [Erstellen von IAM-SAML-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_saml.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [Create SAMLProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-saml-provider.html) in *AWS CLI Command Reference*. ### `create-service-linked-role` Das folgende Codebeispiel zeigt die Verwendung`create-service-linked-role`. **AWS CLI** **So erstellen Sie eine serviceverknüpfte Rolle** Im folgenden `create-service-linked-role` Beispiel wird eine dienstbezogene Rolle für den angegebenen AWS Dienst erstellt und die angegebene Beschreibung angehängt. ``` aws iam create-service-linked-role \ --aws-service-name lex.amazonaws.com \ --description "My service-linked role to support Lex" ``` Ausgabe: ``` { "Role": { "Path": "/aws-service-role/lex.amazonaws.com/", "RoleName": "AWSServiceRoleForLexBots", "RoleId": "AROA1234567890EXAMPLE", "Arn": "arn:aws:iam::1234567890:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots", "CreateDate": "2019-04-17T20:34:14+00:00", "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Action": [ "sts:AssumeRole" ], "Effect": "Allow", "Principal": { "Service": [ "lex.amazonaws.com" ] } } ] } } } ``` Weitere Informationen finden Sie unter [Verwenden von serviceverknüpften Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateServiceLinkedRole AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-service-linked-role.html)*Befehlsreferenz*. ### `create-service-specific-credential` Das folgende Codebeispiel zeigt die Verwendung`create-service-specific-credential`. **AWS CLI** **Erstellen einer Reihe von servicespezifischen Anmeldeinformationen für einen Benutzer** Im folgenden Beispiel für `create-service-specific-credential` werden ein Benutzername und ein Passwort erstellt, die nur für den Zugriff auf den konfigurierten Service verwendet werden können. ``` aws iam create-service-specific-credential \ --user-name sofia \ --service-name codecommit.amazonaws.com ``` Ausgabe: ``` { "ServiceSpecificCredential": { "CreateDate": "2019-04-18T20:45:36+00:00", "ServiceName": "codecommit.amazonaws.com", "ServiceUserName": "sofia-at-123456789012", "ServicePassword": "k1zPZM6uVxMQ3oxqgoYlNuJPyRTZ1vREs76zTQE3eJk=", "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", "UserName": "sofia", "Status": "Active" } } ``` Weitere Informationen finden Sie CodeCommit im *AWS CodeCommit Benutzerhandbuch* unter [Erstellen von Git-Anmeldeinformationen für HTTPS-Verbindungen zu](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam). + Einzelheiten zur API finden Sie [CreateServiceSpecificCredential](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-service-specific-credential.html)in der *AWS CLI Befehlsreferenz*. ### `create-user` Das folgende Codebeispiel zeigt die Verwendung`create-user`. **AWS CLI** **Beispiel 1: So erstellen Sie einen IAM-Benutzer** Mit dem folgenden `create-user`-Befehl wird im aktuellen Konto ein IAM-Benutzer mit dem Namen `Bob` erstellt. ``` aws iam create-user \ --user-name Bob ``` Ausgabe: ``` { "User": { "UserName": "Bob", "Path": "/", "CreateDate": "2023-06-08T03:20:41.270Z", "UserId": "AIDAIOSFODNN7EXAMPLE", "Arn": "arn:aws:iam::123456789012:user/Bob" } } ``` *Weitere Informationen finden Sie im [IAM-Benutzerhandbuch unter Einen IAM-Benutzer in Ihrem AWS Konto](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) erstellen.AWS * **Beispiel 2: So erstellen Sie einen IAM-Benutzer unter einem angegebenen Pfad** Mit dem folgenden `create-user`-Befehl wird im angegebenen Pfad ein IAM-Benutzer mit dem Namen `Bob` erstellt. ``` aws iam create-user \ --user-name Bob \ --path /division_abc/subdivision_xyz/ ``` Ausgabe: ``` { "User": { "Path": "/division_abc/subdivision_xyz/", "UserName": "Bob", "UserId": "AIDAIOSFODNN7EXAMPLE", "Arn": "arn:aws:iam::12345678012:user/division_abc/subdivision_xyz/Bob", "CreateDate": "2023-05-24T18:20:17+00:00" } } ``` Weitere Informationen finden Sie unter [IAM-Kennungen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html) im *AWS -IAM-Benutzerhandbuch*. **Beispiel 3: So erstellen Sie einen IAM-Benutzer mit Tags** Mit dem folgenden `create-user`-Befehl wird ein IAM-Benutzer mit dem Namen `Bob` mit Tags erstellt. In diesem Beispiel wird das `--tags`-Parameter-Flag mit den folgenden JSON-formatierten Tags verwendet: `'{"Key": "Department", "Value": "Accounting"}' '{"Key": "Location", "Value": "Seattle"}'`. Alternativ kann das `--tags`-Flag mit Tags im Kurzformat `'Key=Department,Value=Accounting Key=Location,Value=Seattle'` verwendet werden. ``` aws iam create-user \ --user-name Bob \ --tags '{"Key": "Department", "Value": "Accounting"}' '{"Key": "Location", "Value": "Seattle"}' ``` Ausgabe: ``` { "User": { "Path": "/", "UserName": "Bob", "UserId": "AIDAIOSFODNN7EXAMPLE", "Arn": "arn:aws:iam::12345678012:user/Bob", "CreateDate": "2023-05-25T17:14:21+00:00", "Tags": [ { "Key": "Department", "Value": "Accounting" }, { "Key": "Location", "Value": "Seattle" } ] } } ``` Weitere Informationen finden Sie unter [Tagging von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags_users.html) im *AWS -IAM-Benutzerhandbuch*. **Beispiel 3: So erstellen Sie einen IAM-Benutzer mit einer festgelegten Berechtigungsgrenze** Mit dem folgenden `create-user` Befehl wird ein IAM-Benutzer `Bob` mit der Berechtigungsgrenze von AmazonS3 erstellt. FullAccess ``` aws iam create-user \ --user-name Bob \ --permissions-boundary arn:aws:iam::aws:policy/AmazonS3FullAccess ``` Ausgabe: ``` { "User": { "Path": "/", "UserName": "Bob", "UserId": "AIDAIOSFODNN7EXAMPLE", "Arn": "arn:aws:iam::12345678012:user/Bob", "CreateDate": "2023-05-24T17:50:53+00:00", "PermissionsBoundary": { "PermissionsBoundaryType": "Policy", "PermissionsBoundaryArn": "arn:aws:iam::aws:policy/AmazonS3FullAccess" } } } ``` Weitere Informationen finden Sie unter [Berechtigungsgrenzen für IAM-Entitäten](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html) im *AWS -IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [CreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-user.html)in AWS CLI der Befehlsreferenz.* ### `create-virtual-mfa-device` Das folgende Codebeispiel zeigt die Verwendung`create-virtual-mfa-device`. **AWS CLI** **So erstellen Sie ein virtuelles MFA-Gerät** In diesem Beispiel wird ein neues virtuelles MFA-Gerät mit dem Namen `BobsMFADevice` erstellt. Es erstellt eine Datei mit dem Namen `QRCode.png`, die Bootstrap-Informationen enthält, und platziert sie im Verzeichnis `C:/`. Die in diesem Beispiel verwendete Bootstrap-Methode lautet `QRCodePNG`. ``` aws iam create-virtual-mfa-device \ --virtual-mfa-device-name BobsMFADevice \ --outfile C:/QRCode.png \ --bootstrap-method QRCodePNG ``` Ausgabe: ``` { "VirtualMFADevice": { "SerialNumber": "arn:aws:iam::210987654321:mfa/BobsMFADevice" } ``` Weitere Informationen finden Sie unter [Verwenden der Multi-Faktor-Authentifizierung (MFA) in AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateVirtualMfaDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-virtual-mfa-device.html)in der *AWS CLI Befehlsreferenz*. ### `deactivate-mfa-device` Das folgende Codebeispiel zeigt die Verwendung`deactivate-mfa-device`. **AWS CLI** **So deaktivieren Sie ein MFA-Gerät** Dieser Befehl deaktiviert das virtuelle MFA-Gerät mit der ARN `arn:aws:iam::210987654321:mfa/BobsMFADevice`, die dem Benutzer `Bob` zugeordnet ist. ``` aws iam deactivate-mfa-device \ --user-name Bob \ --serial-number arn:aws:iam::210987654321:mfa/BobsMFADevice ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden der Multi-Faktor-Authentifizierung (MFA) in AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeactivateMfaDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/deactivate-mfa-device.html)in der *AWS CLI Befehlsreferenz*. ### `decode-authorization-message` Das folgende Codebeispiel zeigt die Verwendung`decode-authorization-message`. **AWS CLI** **So dekodieren Sie eine Meldung zu einem Autorisierungsfehler** Im folgenden Beispiel für `decode-authorization-message` wird die Meldung dekodiert, die von der EC2-Konsole zurückgegeben wird, wenn Sie versuchen, eine Instance ohne die erforderlichen Berechtigungen zu starten. ``` aws sts decode-authorization-message \ --encoded-message lxzA8VEjEvu-s0TTt3PgYCXik9YakOqsrFJGRZR98xNcyWAxwRq14xIvd-npzbgTevuufCTbjeBAaDARg9cbTK1rJbg3awM33o-Vy3ebPErE2-mWR9hVYdvX-0zKgVOWF9pWjZaJSMqxB-aLXo-I_8TTvBq88x8IFPbMArNdpu0IjxDjzf22PF3SOE3XvIQ-_PEO0aUqHCCcsSrFtvxm6yQD1nbm6VTIVrfa0Bzy8lsoMo7SjIaJ2r5vph6SY5vCCwg6o2JKe3hIHTa8zRrDbZSFMkcXOT6EOPkQXmaBsAC6ciG7Pz1JnEOvuj5NSTlSMljrAXczWuRKAs5GsMYiU8KZXZhokVzdQCUZkS5aVHumZbadu0io53jpgZqhMqvS4fyfK4auK0yKRMtS6JCXPlhkolEs7ZMFA0RVkutqhQqpSDPB5SX5l00lYipWyFK0_AyAx60vumPuVh8P0AzXwdFsT0l4D0m42NFIKxbWXsoJdqaOqVFyFEd0-Xx9AYAAIr6bhcis7C__bZh4dlAAWooHFGKgfoJcWGwgdzgbu9hWyVvKTpeot5hsb8qANYjJRCPXTKpi6PZfdijIkwb6gDMEsJ9qMtr62qP_989mwmtNgnVvBa_ir6oxJxVe_kL9SH1j5nsGDxQFajvPQhxWOHvEQIg_H0bnKWk ``` Die Ausgabe ist als einzeilige Zeichenfolge mit JSON-Text formatiert, die Sie mit einem beliebigen JSON-Textverarbeitungsprogramm analysieren können. ``` { "DecodedMessage": "{\"allowed\":false,\"explicitDeny\":false,\"matchedStatements\":{\"items\":[]},\"failures\":{\"items\":[]},\"context\":{\"principal\":{\"id\":\"AIDAV3ZUEFP6J7GY7O6LO\",\"name\":\"chain-user\",\"arn\":\"arn:aws:iam::403299380220:user/chain-user\"},\"action\":\"ec2:RunInstances\",\"resource\":\"arn:aws:ec2:us-east-2:403299380220:instance/*\",\"conditions\":{\"items\":[{\"key\":\"ec2:InstanceMarketType\",\"values\":{\"items\":[{\"value\":\"on-demand\"}]}},{\"key\":\"aws:Resource\",\"values\":{\"items\":[{\"value\":\"instance/*\"}]}},{\"key\":\"aws:Account\",\"values\":{\"items\":[{\"value\":\"403299380220\"}]}},{\"key\":\"ec2:AvailabilityZone\",\"values\":{\"items\":[{\"value\":\"us-east-2b\"}]}},{\"key\":\"ec2:ebsOptimized\",\"values\":{\"items\":[{\"value\":\"false\"}]}},{\"key\":\"ec2:IsLaunchTemplateResource\",\"values\":{\"items\":[{\"value\":\"false\"}]}},{\"key\":\"ec2:InstanceType\",\"values\":{\"items\":[{\"value\":\"t2.micro\"}]}},{\"key\":\"ec2:RootDeviceType\",\"values\":{\"items\":[{\"value\":\"ebs\"}]}},{\"key\":\"aws:Region\",\"values\":{\"items\":[{\"value\":\"us-east-2\"}]}},{\"key\":\"aws:Service\",\"values\":{\"items\":[{\"value\":\"ec2\"}]}},{\"key\":\"ec2:InstanceID\",\"values\":{\"items\":[{\"value\":\"*\"}]}},{\"key\":\"aws:Type\",\"values\":{\"items\":[{\"value\":\"instance\"}]}},{\"key\":\"ec2:Tenancy\",\"values\":{\"items\":[{\"value\":\"default\"}]}},{\"key\":\"ec2:Region\",\"values\":{\"items\":[{\"value\":\"us-east-2\"}]}},{\"key\":\"aws:ARN\",\"values\":{\"items\":[{\"value\":\"arn:aws:ec2:us-east-2:403299380220:instance/*\"}]}}]}}}" } ``` Weitere Informationen finden Sie unter [Wie kann ich eine Meldung mit einem Autorisierungsfehler dekodieren, nachdem ich beim Start einer EC2-Instance einen Fehler UnauthorizedOperation ""](https://repost.aws/knowledge-center/ec2-not-auth-launch) erhalten habe? *in AWS re:POST.* + API-Details finden Sie [DecodeAuthorizationMessage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/decode-authorization-message.html)in der *AWS CLI Befehlsreferenz*. ### `delete-access-key` Das folgende Codebeispiel zeigt die Verwendung`delete-access-key`. **AWS CLI** **So löschen Sie einen Zugriffsschlüssel für einen IAM-Benutzer** Mit dem folgenden `delete-access-key`-Befehl wird der angegebene Zugriffsschlüssel (Zugriffsschlüssel-ID und geheimer Zugriffsschlüssel) für den IAM-Benutzer mit dem Namen `Bob` gelöscht. ``` aws iam delete-access-key \ --access-key-id AKIDPMS9RO4H3FEXAMPLE \ --user-name Bob ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den `list-access-keys`-Befehl, um die für einen IAM-Benutzer definierten Zugriffsschlüssel aufzulisten. Weitere Informationen finden Sie unter [Verwalten der Zugriffsschlüssel für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteAccessKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-access-key.html)in der *AWS CLI Befehlsreferenz*. ### `delete-account-alias` Das folgende Codebeispiel zeigt die Verwendung`delete-account-alias`. **AWS CLI** **So löschen Sie einen Konto-Alias** Mit dem folgenden `delete-account-alias`-Befehl wird der Alias `mycompany` für das aktuelle Konto entfernt. ``` aws iam delete-account-alias \ --account-alias mycompany ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ihre AWS Konto-ID und ihr Alias](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteAccountAlias AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-account-alias.html)*Befehlsreferenz.* ### `delete-account-password-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-account-password-policy`. **AWS CLI** **So löschen Sie die Passwortrichtlinie für das aktuelle Konto** Mit dem folgenden `delete-account-password-policy`-Befehl wird die Passwortrichtlinie für das aktuelle Konto entfernt. ``` aws iam delete-account-password-policy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Festlegen einer Kontopasswortrichtlinie für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_account-policy.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteAccountPasswordPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-account-password-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-group-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-group-policy`. **AWS CLI** **So löschen Sie eine Richtlinie aus einer IAM-Gruppe** Mit dem folgenden `delete-group-policy`-Befehl wird die Richtlinie mit dem Namen `ExamplePolicy` aus der Gruppe mit dem Namen `Admins` gelöscht. ``` aws iam delete-group-policy \ --group-name Admins \ --policy-name ExamplePolicy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den `list-group-policies`-Befehl, um die einer Gruppe zugeordneten Richtlinien anzuzeigen. Weitere Informationen finden Sie unter [Verwalten von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteGroupPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-group-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-group` Das folgende Codebeispiel zeigt die Verwendung`delete-group`. **AWS CLI** **So löschen Sie eine IAM-Gruppe** Mit dem folgenden `delete-group`-Befehl wird eine IAM-Gruppe mit dem Namen `MyTestGroup` gelöscht. ``` aws iam delete-group \ --group-name MyTestGroup ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer IAM-Benutzergruppe](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage_delete.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-instance-profile` Das folgende Codebeispiel zeigt die Verwendung`delete-instance-profile`. **AWS CLI** **So löschen Sie ein Instance-Profil** Mit dem folgenden `delete-instance-profile`-Befehl wird das Instance-Profil mit dem Namen `ExampleInstanceProfile` gelöscht. ``` aws iam delete-instance-profile \ --instance-profile-name ExampleInstanceProfile ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden von Instance-Profilen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-instance-profile.html)in der *AWS CLI Befehlsreferenz*. ### `delete-login-profile` Das folgende Codebeispiel zeigt die Verwendung`delete-login-profile`. **AWS CLI** **So löschen Sie ein Passwort für einen IAM-Benutzer** Der folgende Befehl `delete-login-profile` löscht das Passwort für den IAM-Benutzer mit dem Namen `Bob`. ``` aws iam delete-login-profile \ --user-name Bob ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Passwörtern für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_admin-change-user.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteLoginProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-login-profile.html)in der *AWS CLI Befehlsreferenz*. ### `delete-open-id-connect-provider` Das folgende Codebeispiel zeigt die Verwendung`delete-open-id-connect-provider`. **AWS CLI** **So löschen Sie einen IAM-OpenID-Connect-Identitätsanbieter** In diesem Beispiel wird der IAM-OIDC-Anbieter gelöscht, der eine Verbindung zum Anbieter `example.oidcprovider.com` herstellt. ``` aws iam delete-open-id-connect-provider \ --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen von OpenID Connect (OIDC)-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteOpenIdConnectProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-open-id-connect-provider.html)in der *AWS CLI Befehlsreferenz*. ### `delete-policy-version` Das folgende Codebeispiel zeigt die Verwendung`delete-policy-version`. **AWS CLI** **So löschen Sie eine Version einer verwalteten Richtlinie** Dieses Beispiel löscht die als `v2` identifizierte Version aus der Richtlinie, deren ARN `arn:aws:iam::123456789012:policy/MySamplePolicy` lautet. ``` aws iam delete-policy-version \ --policy-arn arn:aws:iam::123456789012:policy/MyPolicy \ --version-id v2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeletePolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-policy-version.html)in der *AWS CLI Befehlsreferenz*. ### `delete-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-policy`. **AWS CLI** **So löschen Sie eine IAM-Richtlinie** In diesem Beispiel wird die Richtlinie, deren ARN `arn:aws:iam::123456789012:policy/MySamplePolicy` lautet, gelöscht. ``` aws iam delete-policy \ --policy-arn arn:aws:iam::123456789012:policy/MySamplePolicy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeletePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-role-permissions-boundary` Das folgende Codebeispiel zeigt die Verwendung`delete-role-permissions-boundary`. **AWS CLI** **So löschen Sie eine Berechtigungsgrenze aus einer IAM-Rolle** Im folgenden Beispiel `delete-role-permissions-boundary` wird die Berechtigungsgrenze für die angegebene IAM-Rolle gelöscht. Verwenden Sie den Befehl `put-role-permissions-boundary`, um einer Rolle eine Berechtigungsgrenze anzuwenden. ``` aws iam delete-role-permissions-boundary \ --role-name lambda-application-role ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteRolePermissionsBoundary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-role-permissions-boundary.html)in der *AWS CLI Befehlsreferenz*. ### `delete-role-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-role-policy`. **AWS CLI** **So entfernen Sie eine Richtlinie aus einer IAM-Rolle** Mit dem folgenden `delete-role-policy`-Befehl wird die Richtlinie mit dem Namen `ExamplePolicy` aus der Rolle mit dem Namen `Test-Role` entfernt. ``` aws iam delete-role-policy \ --role-name Test-Role \ --policy-name ExamplePolicy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ändern einer Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteRolePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-role-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-role` Das folgende Codebeispiel zeigt die Verwendung`delete-role`. **AWS CLI** **So löschen Sie eine IAM-Rolle** Mit dem folgenden `delete-role`-Befehl wird die Rolle mit dem Namen `Test-Role` entfernt. ``` aws iam delete-role \ --role-name Test-Role ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Bevor Sie eine Rolle löschen können, müssen Sie die Rolle aus allen Instance-Profilen entfernen (`remove-role-from-instance-profile`), alle verwalteten Richtlinien entfernen (`detach-role-policy`) und alle eingebundenen Richtlinien, die der Rolle angefügt sind (`delete-role-policy`), löschen. Weitere Informationen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) und [Verwenden von Instance-Profilen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-role.html)in der *AWS CLI Befehlsreferenz*. ### `delete-saml-provider` Das folgende Codebeispiel zeigt die Verwendung`delete-saml-provider`. **AWS CLI** **So löschen Sie einen SAML-Anbieter** In diesem Beispiel wird der IAM SAML 2.0-Anbieter gelöscht, dessen ARN `arn:aws:iam::123456789012:saml-provider/SAMLADFSProvider` lautet. ``` aws iam delete-saml-provider \ --saml-provider-arn arn:aws:iam::123456789012:saml-provider/SAMLADFSProvider ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen von IAM-SAML-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_saml.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [Löschen SAMLProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-saml-provider.html) in der *AWS CLI Befehlsreferenz*. ### `delete-server-certificate` Das folgende Codebeispiel zeigt die Verwendung`delete-server-certificate`. **AWS CLI** **Um ein Serverzertifikat aus Ihrem AWS Konto zu löschen** Mit dem folgenden `delete-server-certificate` Befehl wird das angegebene Serverzertifikat aus Ihrem AWS Konto entfernt. ``` aws iam delete-server-certificate \ --server-certificate-name myUpdatedServerCertificate ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den `list-server-certificates` Befehl, um die in Ihrem AWS Konto verfügbaren Serverzertifikate aufzulisten. Weitere Informationen finden Sie unter [Verwaltung von Serverzertifikaten in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteServerCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-server-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `delete-service-linked-role` Das folgende Codebeispiel zeigt die Verwendung`delete-service-linked-role`. **AWS CLI** **So löschen Sie eine serviceverknüpfte Rolle** Im folgenden `delete-service-linked-role`-Beispiel wird die angegebene serviceverknüpfte Rolle, die Sie nicht mehr benötigen, gelöscht. Der Löschvorgang erfolgt asynchron. Sie können den Status des Löschvorgangs mithilfe des `get-service-linked-role-deletion-status`-Befehls überprüfen und bestätigen, wann der Vorgang abgeschlossen ist. ``` aws iam delete-service-linked-role \ --role-name AWSServiceRoleForLexBots ``` Ausgabe: ``` { "DeletionTaskId": "task/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots/1a2b3c4d-1234-abcd-7890-abcdeEXAMPLE" } ``` Weitere Informationen finden Sie unter [Verwenden von serviceverknüpften Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteServiceLinkedRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-service-linked-role.html)in der *AWS CLI Befehlsreferenz*. ### `delete-service-specific-credential` Das folgende Codebeispiel zeigt die Verwendung`delete-service-specific-credential`. **AWS CLI** **Beispiel 1: Löschen von servicespezifischen Anmeldeinformationen für den anfordernden Benutzer** Im folgenden Beispiel für `delete-service-specific-credential` werden die angegebenen servicespezifischen Anmeldeinformationen für den Benutzer gelöscht, der die Anforderung stellt. Die `service-specific-credential-id` wird bereitgestellt, wenn Sie die Anmeldeinformationen erstellen, und Sie können sie mithilfe des Befehls `list-service-specific-credentials` abrufen. ``` aws iam delete-service-specific-credential \ --service-specific-credential-id ACCAEXAMPLE123EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: Löschen von servicespezifischen Anmeldeinformationen für einen angegebenen Benutzer** Im folgenden Beispiel für `delete-service-specific-credential` werden die angegebenen servicespezifischen Anmeldeinformationen für den angegebenen Benutzer gelöscht. Die `service-specific-credential-id` wird bereitgestellt, wenn Sie die Anmeldeinformationen erstellen, und Sie können sie mithilfe des Befehls `list-service-specific-credentials` abrufen. ``` aws iam delete-service-specific-credential \ --user-name sofia \ --service-specific-credential-id ACCAEXAMPLE123EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie CodeCommit im *AWS CodeCommit Benutzerhandbuch* unter [Erstellen von Git-Anmeldeinformationen für HTTPS-Verbindungen zu](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam). + Einzelheiten zur API finden Sie [DeleteServiceSpecificCredential](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-service-specific-credential.html)in der *AWS CLI Befehlsreferenz*. ### `delete-signing-certificate` Das folgende Codebeispiel zeigt die Verwendung`delete-signing-certificate`. **AWS CLI** **So löschen Sie ein Signaturzertifikat für einen IAM-Benutzer** Der folgende `delete-signing-certificate`-Befehl löscht das angegebene Signaturzertifikat für den IAM-Benutzer mit dem Namen `Bob`. ``` aws iam delete-signing-certificate \ --user-name Bob \ --certificate-id TA7SMP42TDN5Z26OBPJE7EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den `list-signing-certificates`-Befehl, um die ID für ein Signaturzertifikat abzurufen. Weitere Informationen finden Sie unter [Verwaltung von Signaturzertifikaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-up-ami-tools.html#ami-tools-managing-certs) im *Benutzerhandbuch für Amazon EC2.* + Einzelheiten zur API finden Sie [DeleteSigningCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-signing-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `delete-ssh-public-key` Das folgende Codebeispiel zeigt die Verwendung`delete-ssh-public-key`. **AWS CLI** **So löschen Sie öffentliche SSH-Schlüssel, die an einen IAM-Benutzer angehängt sind** Der folgende `delete-ssh-public-key`-Befehl löscht den angegebenen öffentlichen SSH-Schlüssel, der an den IAM-Benutzer `sofia` angehängt ist. ``` aws iam delete-ssh-public-key \ --user-name sofia \ --ssh-public-key-id APKA123456789EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [SSH-Schlüssel und SSH mit verwenden CodeCommit](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html#ssh-keys-code-commit) im *AWS IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [DeleteSshPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-ssh-public-key.html)in AWS CLI der Befehlsreferenz.* ### `delete-user-permissions-boundary` Das folgende Codebeispiel zeigt die Verwendung`delete-user-permissions-boundary`. **AWS CLI** **So löschen Sie eine Berechtigungsgrenze von einem IAM-Benutzer** Im folgenden `delete-user-permissions-boundary`-Beispiel wird die Berechtigungsgrenze gelöscht, die dem IAM-Benutzer mit dem Namen `intern` zugeordnet ist. Um einem Benutzer eine Berechtigungsgrenze zuzuweisen, verwenden Sie den Befehl `put-user-permissions-boundary`. ``` aws iam delete-user-permissions-boundary \ --user-name intern ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteUserPermissionsBoundary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-user-permissions-boundary.html)in der *AWS CLI Befehlsreferenz*. ### `delete-user-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-user-policy`. **AWS CLI** **So entfernen Sie eine Richtlinie von einem IAM-Benutzer** Mit dem folgenden `delete-user-policy`-Befehl wird die angegebene Richtlinie vom IAM-Benutzer mit dem Namen `Bob` entfernt. ``` aws iam delete-user-policy \ --user-name Bob \ --policy-name ExamplePolicy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den `list-user-policies`-Befehl, um eine Liste der Richtlinien für einen IAM-Benutzer abzurufen. *Weitere Informationen finden Sie im [IAM-Benutzerhandbuch unter Einen IAM-Benutzer in Ihrem AWS Konto](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) erstellen.AWS * + Einzelheiten zur API finden Sie unter [DeleteUserPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-user-policy.html)*Befehlsreferenz*. ### `delete-user` Das folgende Codebeispiel zeigt die Verwendung`delete-user`. **AWS CLI** **So löschen Sie einen IAM-Benutzer** Mit dem folgenden `delete-user`-Befehl wird der IAM-Benutzer mit dem Namen `Bob` aus dem aktuellen Konto entfernt. ``` aws iam delete-user \ --user-name Bob ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines IAM-Benutzers](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_manage.html#id_users_deleting) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-user.html)in der *AWS CLI Befehlsreferenz*. ### `delete-virtual-mfa-device` Das folgende Codebeispiel zeigt die Verwendung`delete-virtual-mfa-device`. **AWS CLI** **So entfernen Sie ein virtuelles MFA-Gerät** Mit dem folgenden `delete-virtual-mfa-device`-Befehl wird das angegebene MFA-Gerät vom aktuellen Konto entfernt. ``` aws iam delete-virtual-mfa-device \ --serial-number arn:aws:iam::123456789012:mfa/MFATest ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Deaktivierung von MFA-Geräten](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_disable.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteVirtualMfaDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-virtual-mfa-device.html)in der *AWS CLI Befehlsreferenz*. ### `detach-group-policy` Das folgende Codebeispiel zeigt die Verwendung`detach-group-policy`. **AWS CLI** **So trennen Sie eine Richtlinie von einer Gruppe** In diesem Beispiel wird die verwaltete Richtlinie mit dem ARN `arn:aws:iam::123456789012:policy/TesterAccessPolicy` aus der Gruppe mit dem Namen `Testers` entfernt. ``` aws iam detach-group-policy \ --group-name Testers \ --policy-arn arn:aws:iam::123456789012:policy/TesterAccessPolicy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwaltung von IAM-Benutzergruppen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DetachGroupPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/detach-group-policy.html)in der *AWS CLI Befehlsreferenz*. ### `detach-role-policy` Das folgende Codebeispiel zeigt die Verwendung`detach-role-policy`. **AWS CLI** **So trennen Sie eine Richtlinie von einer Rolle** In diesem Beispiel wird die verwaltete Richtlinie mit dem ARN `arn:aws:iam::123456789012:policy/FederatedTesterAccessPolicy` aus der Rolle mit dem Namen `FedTesterRole` entfernt. ``` aws iam detach-role-policy \ --role-name FedTesterRole \ --policy-arn arn:aws:iam::123456789012:policy/FederatedTesterAccessPolicy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ändern einer Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DetachRolePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/detach-role-policy.html)in der *AWS CLI Befehlsreferenz*. ### `detach-user-policy` Das folgende Codebeispiel zeigt die Verwendung`detach-user-policy`. **AWS CLI** **So trennen Sie eine Richtlinie von einem Benutzer** In diesem Beispiel wird die verwaltete Richtlinie mit dem ARN `arn:aws:iam::123456789012:policy/TesterPolicy` vom Benutzer `Bob` entfernt. ``` aws iam detach-user-policy \ --user-name Bob \ --policy-arn arn:aws:iam::123456789012:policy/TesterPolicy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Änderung der Berechtigungen für einen IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DetachUserPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/detach-user-policy.html)in der *AWS CLI Befehlsreferenz*. ### `disable-organizations-root-credentials-management` Das folgende Codebeispiel zeigt die Verwendung`disable-organizations-root-credentials-management`. **AWS CLI** **Um die RootCredentialsManagement Funktion in Ihrer Organisation zu deaktivieren** Der folgende `disable-organizations-root-credentials-management`-Befehl deaktiviert die Verwaltung privilegierter Root-Benutzer-Anmeldeinformationen für alle Mitgliedskonten in Ihrer Organisation. ``` aws iam disable-organizations-root-credentials-management ``` Ausgabe: ``` { "EnabledFeatures": [ "RootSessions" ] "OrganizationId": "o-aa111bb222" } ``` Weitere Informationen finden Sie unter [Root-Zugriff für Mitgliedskonten zentralisieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-enable-root-access.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [DisableOrganizationsRootCredentialsManagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/disable-organizations-root-credentials-management.html)in der *AWS CLI Befehlsreferenz*. ### `disable-organizations-root-sessions` Das folgende Codebeispiel zeigt die Verwendung`disable-organizations-root-sessions`. **AWS CLI** **Um die RootSessions Funktion in Ihrer Organisation zu deaktivieren** Der folgende `disable-organizations-root-sessions`-Befehl deaktiviert Root-Benutzer-Sitzungen für privilegierte Aufgaben für alle Mitgliedskonten in Ihrer Organisation. ``` aws iam disable-organizations-root-sessions ``` Ausgabe: ``` { "EnabledFeatures": [ "RootCredentialsManagement" ] "OrganizationId": "o-aa111bb222" } ``` Weitere Informationen finden Sie unter [Root-Zugriff für Mitgliedskonten zentralisieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-enable-root-access.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [DisableOrganizationsRootSessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/disable-organizations-root-sessions.html)in der *AWS CLI Befehlsreferenz*. ### `enable-mfa-device` Das folgende Codebeispiel zeigt die Verwendung`enable-mfa-device`. **AWS CLI** **So aktivieren Sie ein MFA-Gerät** Nachdem Sie mit dem `create-virtual-mfa-device`-Befehl ein neues virtuelles MFA-Gerät erstellt haben, können Sie das MFA-Gerät einem Benutzer zuweisen. Im folgenden `enable-mfa-device`-Beispiel wird dem Benutzer `Bob` das MFA-Gerät mit der Seriennummer `arn:aws:iam::210987654321:mfa/BobsMFADevice` zugewiesen. Der Befehl synchronisiert das Gerät auch mit, AWS indem er die ersten beiden Codes nacheinander vom virtuellen MFA-Gerät einfügt. ``` aws iam enable-mfa-device \ --user-name Bob \ --serial-number arn:aws:iam::210987654321:mfa/BobsMFADevice \ --authentication-code1 123456 \ --authentication-code2 789012 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren eines virtuellen Geräts zur Multi-Faktor-Authentifizierung (MFA)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_enable_virtual.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [EnableMfaDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/enable-mfa-device.html)in der *AWS CLI Befehlsreferenz*. ### `enable-organizations-root-credentials-management` Das folgende Codebeispiel zeigt die Verwendung`enable-organizations-root-credentials-management`. **AWS CLI** **Um die RootCredentialsManagement Funktion in Ihrer Organisation zu aktivieren** Der folgende `enable-organizations-root-credentials-management`-Befehl aktiviert die Verwaltung privilegierter Root-Benutzer-Anmeldeinformationen für alle Mitgliedskonten in Ihrer Organisation. ``` aws iam enable-organizations-root-credentials-management ``` Ausgabe: ``` { "EnabledFeatures": [ "RootCredentialsManagement" ] "OrganizationId": "o-aa111bb222" } ``` Weitere Informationen finden Sie unter [Root-Zugriff für Mitgliedskonten zentralisieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-enable-root-access.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [EnableOrganizationsRootCredentialsManagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/enable-organizations-root-credentials-management.html)in der *AWS CLI Befehlsreferenz*. ### `enable-organizations-root-sessions` Das folgende Codebeispiel zeigt die Verwendung`enable-organizations-root-sessions`. **AWS CLI** **Um die RootSessions Funktion in Ihrer Organisation zu aktivieren** Mit dem folgenden `enable-organizations-root-sessions`-Befehl kann das Verwaltungskonto oder der delegierte Administrator privilegierte Aufgaben für Mitgliedskonten in Ihrer Organisation ausführen. ``` aws iam enable-organizations-root-sessions ``` Ausgabe: ``` { "EnabledFeatures": [ "RootSessions" ] "OrganizationId": "o-aa111bb222" } ``` Weitere Informationen finden Sie unter [Root-Zugriff für Mitgliedskonten zentralisieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-enable-root-access.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [EnableOrganizationsRootSessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/enable-organizations-root-sessions.html)in der *AWS CLI Befehlsreferenz*. ### `generate-credential-report` Das folgende Codebeispiel zeigt die Verwendung`generate-credential-report`. **AWS CLI** **So erstellen Sie einen Bericht zu Anmeldeinformationen** Im folgenden Beispiel wird versucht, einen Anmeldeinformationsbericht für das AWS Konto zu generieren. ``` aws iam generate-credential-report ``` Ausgabe: ``` { "State": "STARTED", "Description": "No report exists. Starting a new report generation task" } ``` Weitere Informationen finden Sie im *AWS IAM-Benutzerhandbuch* unter [Abrufen von Berichten zu Anmeldeinformationen für Ihr AWS Konto](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_getting-report.html). + Einzelheiten zur API finden Sie unter [GenerateCredentialReport AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/generate-credential-report.html)*Befehlsreferenz*. ### `generate-organizations-access-report` Das folgende Codebeispiel zeigt die Verwendung`generate-organizations-access-report`. **AWS CLI** **Beispiel 1: So generieren Sie einen Zugriffsbericht für einen Root in einer Organisation** Im folgenden Beispiel für `generate-organizations-access-report` wird ein Hintergrundauftrag gestartet, um einen Zugriffsbericht für den angegebenen Root in einer Organisation zu erstellen. Sie können den Bericht anzeigen, nachdem er durch Ausführung des Befehls `get-organizations-access-report` erstellt wurde. ``` aws iam generate-organizations-access-report \ --entity-path o-4fxmplt198/r-c3xb ``` Ausgabe: ``` { "JobId": "a8b6c06f-aaa4-8xmp-28bc-81da71836359" } ``` **Beispiel 2: So generieren Sie einen Zugriffsbericht für ein Konto in einer Organisation** Im folgenden Beispiel für `generate-organizations-access-report` wird ein Hintergrundauftrag gestartet, um einen Zugriffsbericht für die Konto-ID `123456789012` in der Organisation `o-4fxmplt198` zu erstellen. Sie können den Bericht anzeigen, nachdem er durch Ausführung des Befehls `get-organizations-access-report` erstellt wurde. ``` aws iam generate-organizations-access-report \ --entity-path o-4fxmplt198/r-c3xb/123456789012 ``` Ausgabe: ``` { "JobId": "14b6c071-75f6-2xmp-fb77-faf6fb4201d2" } ``` **Beispiel 3: So generieren Sie einen Zugriffsbericht für ein Konto in einer Organisationseinheit einer Organisation** Im folgenden Beispiel für `generate-organizations-access-report` wird ein Hintergrundauftrag gestartet, um einen Zugriffsbericht für die Konto-ID `234567890123` in der Organisationseinheit `ou-c3xb-lmu7j2yg` der Organisation `o-4fxmplt198` zu erstellen. Sie können den Bericht anzeigen, nachdem er durch Ausführung des Befehls `get-organizations-access-report` erstellt wurde. ``` aws iam generate-organizations-access-report \ --entity-path o-4fxmplt198/r-c3xb/ou-c3xb-lmu7j2yg/234567890123 ``` Ausgabe: ``` { "JobId": "2eb6c2e6-0xmp-ec04-1425-c937916a64af" } ``` Verwenden Sie die Befehle `organizations list-roots` und `organizations list-organizational-units-for-parent`, um Details zu Roots und Organisationseinheiten in Ihrer Organisation abzurufen. Weitere Informationen finden Sie im *AWS IAM-Benutzerhandbuch* unter [Verfeinerung von Berechtigungen bei der AWS Verwendung von Informationen, auf die zuletzt zugegriffen wurde](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_access-advisor.html). + Einzelheiten zur API finden Sie unter [GenerateOrganizationsAccessReport AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/generate-organizations-access-report.html)*Befehlsreferenz*. ### `generate-service-last-accessed-details` Das folgende Codebeispiel zeigt die Verwendung`generate-service-last-accessed-details`. **AWS CLI** **Beispiel 1: So generieren Sie einen Service-Zugriffsbericht für eine benutzerdefinierte Richtlinie** Im folgenden Beispiel `generate-service-last-accessed-details` wird ein Hintergrundauftrag gestartet, um einen Bericht zu generieren, der die Services auflistet, auf die IAM-Benutzer und andere Entitäten mit einer benutzerdefinierten Richtlinie mit dem Namen `intern-boundary` zugreifen. Sie können den Bericht anzeigen, nachdem er durch Ausführung des Befehls `get-service-last-accessed-details` erstellt wurde. ``` aws iam generate-service-last-accessed-details \ --arn arn:aws:iam::123456789012:policy/intern-boundary ``` Ausgabe: ``` { "JobId": "2eb6c2b8-7b4c-3xmp-3c13-03b72c8cdfdc" } ``` **Beispiel 2: Um einen Servicezugriffsbericht für die AWS verwaltete AdministratorAccess Richtlinie zu generieren** Im folgenden `generate-service-last-accessed-details` Beispiel wird ein Hintergrundjob gestartet, um einen Bericht zu generieren, der die Dienste auflistet, auf die IAM-Benutzer und andere Entitäten mit der AWS verwalteten `AdministratorAccess` Richtlinie zugreifen. Sie können den Bericht anzeigen, nachdem er durch Ausführung des Befehls `get-service-last-accessed-details` erstellt wurde. ``` aws iam generate-service-last-accessed-details \ --arn arn:aws:iam::aws:policy/AdministratorAccess ``` Ausgabe: ``` { "JobId": "78b6c2ba-d09e-6xmp-7039-ecde30b26916" } ``` Weitere Informationen finden Sie im *AWS IAM-Benutzerhandbuch* unter [Verfeinerung von Berechtigungen bei der AWS Verwendung von Informationen, auf die zuletzt zugegriffen wurde](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_access-advisor.html). + Einzelheiten zur API finden Sie unter [GenerateServiceLastAccessedDetails AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/generate-service-last-accessed-details.html)*Befehlsreferenz*. ### `get-access-key-last-used` Das folgende Codebeispiel zeigt die Verwendung`get-access-key-last-used`. **AWS CLI** **So rufen Sie Informationen darüber ab, wann der angegebene Zugriffsschlüssel zuletzt verwendet wurde** Im folgenden Beispiel werden Informationen darüber abgerufen, wann der Zugriffsschlüssel `ABCDEXAMPLE` zuletzt verwendet wurde. ``` aws iam get-access-key-last-used \ --access-key-id ABCDEXAMPLE ``` Ausgabe: ``` { "UserName": "Bob", "AccessKeyLastUsed": { "Region": "us-east-1", "ServiceName": "iam", "LastUsedDate": "2015-06-16T22:45:00Z" } } ``` Weitere Informationen finden Sie unter [Verwalten der Zugriffsschlüssel für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetAccessKeyLastUsed](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-access-key-last-used.html)in der *AWS CLI Befehlsreferenz*. ### `get-account-authorization-details` Das folgende Codebeispiel zeigt die Verwendung`get-account-authorization-details`. **AWS CLI** **Um die IAM-Benutzer, -Gruppen, -Rollen und -Richtlinien eines AWS Kontos aufzulisten** Der folgende `get-account-authorization-details` Befehl gibt Informationen zu allen IAM-Benutzern, -Gruppen, -Rollen und -Richtlinien im AWS Konto zurück. ``` aws iam get-account-authorization-details ``` Ausgabe: ``` { "RoleDetailList": [ { "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }, "RoleId": "AROA1234567890EXAMPLE", "CreateDate": "2014-07-30T17:09:20Z", "InstanceProfileList": [ { "InstanceProfileId": "AIPA1234567890EXAMPLE", "Roles": [ { "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }, "RoleId": "AROA1234567890EXAMPLE", "CreateDate": "2014-07-30T17:09:20Z", "RoleName": "EC2role", "Path": "/", "Arn": "arn:aws:iam::123456789012:role/EC2role" } ], "CreateDate": "2014-07-30T17:09:20Z", "InstanceProfileName": "EC2role", "Path": "/", "Arn": "arn:aws:iam::123456789012:instance-profile/EC2role" } ], "RoleName": "EC2role", "Path": "/", "AttachedManagedPolicies": [ { "PolicyName": "AmazonS3FullAccess", "PolicyArn": "arn:aws:iam::aws:policy/AmazonS3FullAccess" }, { "PolicyName": "AmazonDynamoDBFullAccess", "PolicyArn": "arn:aws:iam::aws:policy/AmazonDynamoDBFullAccess" } ], "RoleLastUsed": { "Region": "us-west-2", "LastUsedDate": "2019-11-13T17:30:00Z" }, "RolePolicyList": [], "Arn": "arn:aws:iam::123456789012:role/EC2role" } ], "GroupDetailList": [ { "GroupId": "AIDA1234567890EXAMPLE", "AttachedManagedPolicies": { "PolicyName": "AdministratorAccess", "PolicyArn": "arn:aws:iam::aws:policy/AdministratorAccess" }, "GroupName": "Admins", "Path": "/", "Arn": "arn:aws:iam::123456789012:group/Admins", "CreateDate": "2013-10-14T18:32:24Z", "GroupPolicyList": [] }, { "GroupId": "AIDA1234567890EXAMPLE", "AttachedManagedPolicies": { "PolicyName": "PowerUserAccess", "PolicyArn": "arn:aws:iam::aws:policy/PowerUserAccess" }, "GroupName": "Dev", "Path": "/", "Arn": "arn:aws:iam::123456789012:group/Dev", "CreateDate": "2013-10-14T18:33:55Z", "GroupPolicyList": [] }, { "GroupId": "AIDA1234567890EXAMPLE", "AttachedManagedPolicies": [], "GroupName": "Finance", "Path": "/", "Arn": "arn:aws:iam::123456789012:group/Finance", "CreateDate": "2013-10-14T18:57:48Z", "GroupPolicyList": [ { "PolicyName": "policygen-201310141157", "PolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Action": "aws-portal:*", "Sid": "Stmt1381777017000", "Resource": "*", "Effect": "Allow" } ] } } ] } ], "UserDetailList": [ { "UserName": "Alice", "GroupList": [ "Admins" ], "CreateDate": "2013-10-14T18:32:24Z", "UserId": "AIDA1234567890EXAMPLE", "UserPolicyList": [], "Path": "/", "AttachedManagedPolicies": [], "Arn": "arn:aws:iam::123456789012:user/Alice" }, { "UserName": "Bob", "GroupList": [ "Admins" ], "CreateDate": "2013-10-14T18:32:25Z", "UserId": "AIDA1234567890EXAMPLE", "UserPolicyList": [ { "PolicyName": "DenyBillingAndIAMPolicy", "PolicyDocument": { "Version":"2012-10-17", "Statement": { "Effect": "Deny", "Action": [ "aws-portal:*", "iam:*" ], "Resource": "*" } } } ], "Path": "/", "AttachedManagedPolicies": [], "Arn": "arn:aws:iam::123456789012:user/Bob" }, { "UserName": "Charlie", "GroupList": [ "Dev" ], "CreateDate": "2013-10-14T18:33:56Z", "UserId": "AIDA1234567890EXAMPLE", "UserPolicyList": [], "Path": "/", "AttachedManagedPolicies": [], "Arn": "arn:aws:iam::123456789012:user/Charlie" } ], "Policies": [ { "PolicyName": "create-update-delete-set-managed-policies", "CreateDate": "2015-02-06T19:58:34Z", "AttachmentCount": 1, "IsAttachable": true, "PolicyId": "ANPA1234567890EXAMPLE", "DefaultVersionId": "v1", "PolicyVersionList": [ { "CreateDate": "2015-02-06T19:58:34Z", "VersionId": "v1", "Document": { "Version":"2012-10-17", "Statement": { "Effect": "Allow", "Action": [ "iam:CreatePolicy", "iam:CreatePolicyVersion", "iam:DeletePolicy", "iam:DeletePolicyVersion", "iam:GetPolicy", "iam:GetPolicyVersion", "iam:ListPolicies", "iam:ListPolicyVersions", "iam:SetDefaultPolicyVersion" ], "Resource": "*" } }, "IsDefaultVersion": true } ], "Path": "/", "Arn": "arn:aws:iam::123456789012:policy/create-update-delete-set-managed-policies", "UpdateDate": "2015-02-06T19:58:34Z" }, { "PolicyName": "S3-read-only-specific-bucket", "CreateDate": "2015-01-21T21:39:41Z", "AttachmentCount": 1, "IsAttachable": true, "PolicyId": "ANPA1234567890EXAMPLE", "DefaultVersionId": "v1", "PolicyVersionList": [ { "CreateDate": "2015-01-21T21:39:41Z", "VersionId": "v1", "Document": { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:Get*", "s3:List*" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket", "arn:aws:s3:::amzn-s3-demo-bucket/*" ] } ] }, "IsDefaultVersion": true } ], "Path": "/", "Arn": "arn:aws:iam::123456789012:policy/S3-read-only-specific-bucket", "UpdateDate": "2015-01-21T23:39:41Z" }, { "PolicyName": "AmazonEC2FullAccess", "CreateDate": "2015-02-06T18:40:15Z", "AttachmentCount": 1, "IsAttachable": true, "PolicyId": "ANPA1234567890EXAMPLE", "DefaultVersionId": "v1", "PolicyVersionList": [ { "CreateDate": "2014-10-30T20:59:46Z", "VersionId": "v1", "Document": { "Version":"2012-10-17", "Statement": [ { "Action": "ec2:*", "Effect": "Allow", "Resource": "*" }, { "Effect": "Allow", "Action": "elasticloadbalancing:*", "Resource": "*" }, { "Effect": "Allow", "Action": "cloudwatch:*", "Resource": "*" }, { "Effect": "Allow", "Action": "autoscaling:*", "Resource": "*" } ] }, "IsDefaultVersion": true } ], "Path": "/", "Arn": "arn:aws:iam::aws:policy/AmazonEC2FullAccess", "UpdateDate": "2015-02-06T18:40:15Z" } ], "Marker": "EXAMPLEkakv9BCuUNFDtxWSyfzetYwEx2ADc8dnzfvERF5S6YMvXKx41t6gCl/eeaCX3Jo94/bKqezEAg8TEVS99EKFLxm3jtbpl25FDWEXAMPLE", "IsTruncated": true } ``` Weitere Informationen finden Sie unter [AWS -Sicherheitsaudit-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-audit-guide.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetAccountAuthorizationDetails AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-account-authorization-details.html)*Befehlsreferenz.* ### `get-account-password-policy` Das folgende Codebeispiel zeigt die Verwendung`get-account-password-policy`. **AWS CLI** **So zeigen Sie die Passwortrichtlinie für das aktuelle Konto an** Mit dem folgenden `get-account-password-policy`-Befehl werden Details zur Passwortrichtlinie für das aktuelle Konto angezeigt. ``` aws iam get-account-password-policy ``` Ausgabe: ``` { "PasswordPolicy": { "AllowUsersToChangePassword": false, "RequireLowercaseCharacters": false, "RequireUppercaseCharacters": false, "MinimumPasswordLength": 8, "RequireNumbers": true, "RequireSymbols": true } } ``` Wenn keine Passwortwortrichtlinie für das Konto definiert ist, gibt der Befehl einen `NoSuchEntity`-Fehler zurück. Weitere Informationen finden Sie unter [Festlegen einer Kontopasswortrichtlinie für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_account-policy.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetAccountPasswordPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-account-password-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-account-summary` Das folgende Codebeispiel zeigt die Verwendung`get-account-summary`. **AWS CLI** **So rufen Sie Informationen über die Nutzung von IAM-Entitäten und IAM-Kontingenten auf dem aktuellen Konto ab** Der folgende `get-account-summary`-Befehl gibt Informationen zur aktuellen IAM-Entitätsnutzung und zu den aktuellen IAM-Entitätskontingenten im Konto zurück. ``` aws iam get-account-summary ``` Ausgabe: ``` { "SummaryMap": { "UsersQuota": 5000, "GroupsQuota": 100, "InstanceProfiles": 6, "SigningCertificatesPerUserQuota": 2, "AccountAccessKeysPresent": 0, "RolesQuota": 250, "RolePolicySizeQuota": 10240, "AccountSigningCertificatesPresent": 0, "Users": 27, "ServerCertificatesQuota": 20, "ServerCertificates": 0, "AssumeRolePolicySizeQuota": 2048, "Groups": 7, "MFADevicesInUse": 1, "Roles": 3, "AccountMFAEnabled": 1, "MFADevices": 3, "GroupsPerUserQuota": 10, "GroupPolicySizeQuota": 5120, "InstanceProfilesQuota": 100, "AccessKeysPerUserQuota": 2, "Providers": 0, "UserPolicySizeQuota": 2048 } } ``` Weitere Informationen zu Entitätsbeschränkungen finden Sie unter [IAM- und AWS STS-Kontingente](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-quotas.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetAccountSummary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-account-summary.html)in der *AWS CLI Befehlsreferenz*. ### `get-context-keys-for-custom-policy` Das folgende Codebeispiel zeigt die Verwendung`get-context-keys-for-custom-policy`. **AWS CLI** **Beispiel 1: So listen Sie die Kontextschlüssel auf, auf die von einer oder mehreren benutzerdefinierten JSON-Richtlinien verwiesen wird, die als Parameter in der Befehlszeile bereitgestellt werden** Der folgende Befehl `get-context-keys-for-custom-policy` analysiert jede bereitgestellte Richtlinie und listet die von diesen Richtlinien verwendeten Kontextschlüssel auf. Verwenden Sie diesen Befehl, um zu ermitteln, welche Kontextschlüsselwerte Sie angeben müssen, um die Richtlinien-Simulatorbefehle `simulate-custom-policy` und `simulate-custom-policy` erfolgreich verwenden zu können. Sie können auch die Liste der Kontextschlüssel abrufen, die von allen Richtlinien verwendet werden, die einem IAM-Benutzer oder einer IAM-Rolle zugeordnet sind, indem Sie den Befehl `get-context-keys-for-custom-policy` verwenden. Parameterwerte, die mit `file://` beginnen, weisen den Befehl an, die Datei zu lesen und deren Inhalt als Wert für den Parameter anstelle des Dateinamens selbst zu verwenden. ``` aws iam get-context-keys-for-custom-policy \ --policy-input-list '{"Version":"2012-10-17", "Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/${aws:username}","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2015-08-16T12:00:00Z"}}}}' ``` Ausgabe: ``` { "ContextKeyNames": [ "aws:username", "aws:CurrentTime" ] } ``` **Beispiel 2: So listen Sie die Kontextschlüssel auf, auf die von einer oder mehreren benutzerdefinierten JSON-Richtlinien verwiesen wird, die als Dateieingabe bereitgestellt werden** Der folgende Befehl `get-context-keys-for-custom-policy` ist derselbe wie im vorherigen Beispiel, mit der Ausnahme, dass die Richtlinien in einer Datei und nicht als Parameter bereitgestellt werden. Da der Befehl eine JSON-Liste mit Zeichenfolgen und keine Liste mit JSON-Strukturen erwartet, muss die Datei wie folgt strukturiert sein. Sie können sie jedoch zu einer einzigen Datei zusammenfassen. ``` [ "Policy1", "Policy2" ] ``` Eine Datei, die die Richtlinie aus dem vorherigen Beispiel enthält, muss beispielsweise wie folgt aussehen. Sie müssen jedes eingebettete Anführungszeichen in der Zeichenfolge der Richtlinie durch Voranstellen eines umgekehrten Schrägstrichs '' ersetzen. ``` [ "{\"Version\": \"2012-10-17\", \"Statement\": {\"Effect\": \"Allow\", \"Action\": \"dynamodb:*\", \"Resource\": \"arn:aws:dynamodb:us-west-2:128716708097:table/${aws:username}\", \"Condition\": {\"DateGreaterThan\": {\"aws:CurrentTime\": \"2015-08-16T12:00:00Z\"}}}}" ] ``` Diese Datei kann dann dem folgenden Befehl übergeben werden. ``` aws iam get-context-keys-for-custom-policy \ --policy-input-list file://policyfile.json ``` Ausgabe: ``` { "ContextKeyNames": [ "aws:username", "aws:CurrentTime" ] } ``` Weitere Informationen finden Sie unter [Verwenden des IAM-Richtliniensimulators (AWS CLI und AWS API)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_testing-policies.html#policies-simulator-using-api) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetContextKeysForCustomPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-context-keys-for-custom-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-context-keys-for-principal-policy` Das folgende Codebeispiel zeigt die Verwendung`get-context-keys-for-principal-policy`. **AWS CLI** **So listen Sie die Kontextschlüssel auf, auf die alle mit einem IAM-Prinzipal verknüpften Richtlinien verweisen** Mit dem folgenden Befehl `get-context-keys-for-principal-policy` werden alle Richtlinien abgerufen, die dem Benutzer `saanvi` und allen Gruppen, denen er angehört, zugeordnet sind. Anschließend werden alle Richtlinien analysiert und die von diesen Richtlinien verwendeten Kontextschlüssel aufgelistet. Verwenden Sie diesen Befehl, um zu ermitteln, welche Kontextschlüsselwerte Sie angeben müssen, um die Befehle `simulate-custom-policy` und `simulate-principal-policy` erfolgreich zu verwenden. Mit dem Befehl `get-context-keys-for-custom-policy` können Sie auch die Liste der Kontextschlüssel abrufen, die von einer beliebigen JSON-Richtlinie verwendet werden. ``` aws iam get-context-keys-for-principal-policy \ --policy-source-arn arn:aws:iam::123456789012:user/saanvi ``` Ausgabe: ``` { "ContextKeyNames": [ "aws:username", "aws:CurrentTime" ] } ``` Weitere Informationen finden Sie unter [Verwenden des IAM-Richtliniensimulators (AWS CLI und AWS API)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_testing-policies.html#policies-simulator-using-api) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetContextKeysForPrincipalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-context-keys-for-principal-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-credential-report` Das folgende Codebeispiel zeigt die Verwendung`get-credential-report`. **AWS CLI** **So rufen Sie einen Bericht zu Anmeldeinformationen ab** In diesem Beispiel wird der zurückgegebene Bericht geöffnet und als Array von Textzeilen an die Pipeline ausgegeben. ``` aws iam get-credential-report ``` Ausgabe: ``` { "GeneratedTime": "2015-06-17T19:11:50Z", "ReportFormat": "text/csv" } ``` Weitere Informationen finden Sie im *AWS IAM-Benutzerhandbuch* unter [Abrufen von Berichten zu Anmeldeinformationen für Ihr AWS Konto](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_getting-report.html). + Einzelheiten zur API finden Sie unter [GetCredentialReport AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-credential-report.html)*Befehlsreferenz*. ### `get-group-policy` Das folgende Codebeispiel zeigt die Verwendung`get-group-policy`. **AWS CLI** **So erhalten Sie Informationen zu einer Richtlinie, die einer IAM-Gruppe zugeordnet ist** Mit dem folgenden Befehl `get-group-policy` werden Informationen über die angegebene Richtlinie abgerufen, die der genannten Gruppe `Test-Group` zugeordnet ist. ``` aws iam get-group-policy \ --group-name Test-Group \ --policy-name S3-ReadOnly-Policy ``` Ausgabe: ``` { "GroupName": "Test-Group", "PolicyDocument": { "Statement": [ { "Action": [ "s3:Get*", "s3:List*" ], "Resource": "*", "Effect": "Allow" } ] }, "PolicyName": "S3-ReadOnly-Policy" } ``` Weitere Informationen finden Sie unter [Verwalten von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetGroupPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-group-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-group` Das folgende Codebeispiel zeigt die Verwendung`get-group`. **AWS CLI** **So rufen Sie eine IAM-Gruppe ab** In diesem Beispiel werden Details über die IAM-Gruppe `Admins` zurückgegeben. ``` aws iam get-group \ --group-name Admins ``` Ausgabe: ``` { "Group": { "Path": "/", "CreateDate": "2015-06-16T19:41:48Z", "GroupId": "AIDGPMS9RO4H3FEXAMPLE", "Arn": "arn:aws:iam::123456789012:group/Admins", "GroupName": "Admins" }, "Users": [] } ``` Weitere Informationen finden Sie unter [IAM-Identitäten (Benutzer, Benutzergruppen und Rollen)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-group.html)in der *AWS CLI Befehlsreferenz*. ### `get-instance-profile` Das folgende Codebeispiel zeigt die Verwendung`get-instance-profile`. **AWS CLI** **So rufen Sie Informationen zu einem Instance-Profil ab** Der folgende Befehl `get-instance-profile` ruft Informationen über das Instance-Profil mit dem Namen `ExampleInstanceProfile` ab. ``` aws iam get-instance-profile \ --instance-profile-name ExampleInstanceProfile ``` Ausgabe: ``` { "InstanceProfile": { "InstanceProfileId": "AID2MAB8DPLSRHEXAMPLE", "Roles": [ { "AssumeRolePolicyDocument": "", "RoleId": "AIDGPMS9RO4H3FEXAMPLE", "CreateDate": "2013-01-09T06:33:26Z", "RoleName": "Test-Role", "Path": "/", "Arn": "arn:aws:iam::336924118301:role/Test-Role" } ], "CreateDate": "2013-06-12T23:52:02Z", "InstanceProfileName": "ExampleInstanceProfile", "Path": "/", "Arn": "arn:aws:iam::336924118301:instance-profile/ExampleInstanceProfile" } } ``` Weitere Informationen finden Sie unter [Verwenden von Instance-Profilen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-instance-profile.html)in der *AWS CLI Befehlsreferenz*. ### `get-login-profile` Das folgende Codebeispiel zeigt die Verwendung`get-login-profile`. **AWS CLI** **So rufen Sie Passwortinformationen für einen IAM-Benutzer ab** Mit dem folgenden Befehl `get-login-profile` werden Informationen über das Passwort für den IAM-Benutzer mit dem Namen `Bob` abgerufen. ``` aws iam get-login-profile \ --user-name Bob ``` Ausgabe: ``` { "LoginProfile": { "UserName": "Bob", "CreateDate": "2012-09-21T23:03:39Z" } } ``` Der Befehl `get-login-profile` kann verwendet werden, um zu überprüfen, ob ein IAM-Benutzer über ein Passwort verfügt. Der Befehl gibt einen `NoSuchEntity`-Fehler zurück, wenn für den Benutzer kein Passwort definiert ist. Mit diesem Befehl können Sie kein Passwort anzeigen. Bei Verlust des Passwortes besteht die Möglichkeit, das Passwort (`update-login-profile`) für den Benutzer zurückzusetzen. Alternativ können Sie das Anmeldeprofil (`delete-login-profile`) für den Benutzer löschen und anschließend ein neues erstellen (`create-login-profile`). Weitere Informationen finden Sie unter [Verwalten von Passwörtern für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_admin-change-user.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetLoginProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-login-profile.html)in der *AWS CLI Befehlsreferenz*. ### `get-mfa-device` Das folgende Codebeispiel zeigt die Verwendung`get-mfa-device`. **AWS CLI** **So rufen Sie Informationen über einen FIDO-Sicherheitsschlüssel ab** Der folgende `get-mfa-device`-Beispielbefehl ruft Informationen über den angegebenen FIDO-Sicherheitsschlüssel ab. ``` aws iam get-mfa-device \ --serial-number arn:aws:iam::123456789012:u2f/user/alice/fidokeyname-EXAMPLEBN5FHTECLFG7EXAMPLE ``` Ausgabe: ``` { "UserName": "alice", "SerialNumber": "arn:aws:iam::123456789012:u2f/user/alice/fidokeyname-EXAMPLEBN5FHTECLFG7EXAMPLE", "EnableDate": "2023-09-19T01:49:18+00:00", "Certifications": { "FIDO": "L1" } } ``` Weitere Informationen finden Sie unter [Verwenden der Multi-Faktor-Authentifizierung (MFA) in AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetMfaDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-mfa-device.html)in der *AWS CLI Befehlsreferenz*. ### `get-open-id-connect-provider` Das folgende Codebeispiel zeigt die Verwendung`get-open-id-connect-provider`. **AWS CLI** **So geben Sie Informationen zum angegebenen OpenID Connect-Anbieter zurück** In diesem Beispiel werden Details zum OpenID Connect-Anbieter zurückgegeben, dessen ARN `arn:aws:iam::123456789012:oidc-provider/server.example.com` lautet. ``` aws iam get-open-id-connect-provider \ --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/server.example.com ``` Ausgabe: ``` { "Url": "server.example.com" "CreateDate": "2015-06-16T19:41:48Z", "ThumbprintList": [ "12345abcdefghijk67890lmnopqrst987example" ], "ClientIDList": [ "example-application-ID" ] } ``` Weitere Informationen finden Sie unter [Erstellen von OpenID Connect (OIDC)-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetOpenIdConnectProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-open-id-connect-provider.html)in der *AWS CLI Befehlsreferenz*. ### `get-organizations-access-report` Das folgende Codebeispiel zeigt die Verwendung`get-organizations-access-report`. **AWS CLI** **So rufen Sie einen Zugriffsbericht ab** Im folgenden `get-organizations-access-report` Beispiel wird ein zuvor generierter Zugriffsbericht für eine AWS Organisationseinheit angezeigt. Verwenden Sie den `generate-organizations-access-report`-Befehl, um einen Bericht zu generieren. ``` aws iam get-organizations-access-report \ --job-id a8b6c06f-aaa4-8xmp-28bc-81da71836359 ``` Ausgabe: ``` { "JobStatus": "COMPLETED", "JobCreationDate": "2019-09-30T06:53:36.187Z", "JobCompletionDate": "2019-09-30T06:53:37.547Z", "NumberOfServicesAccessible": 188, "NumberOfServicesNotAccessed": 171, "AccessDetails": [ { "ServiceName": "Alexa for Business", "ServiceNamespace": "a4b", "TotalAuthenticatedEntities": 0 }, ... } ``` Weitere Informationen finden Sie im *AWS IAM-Benutzerhandbuch* unter [Verfeinerung von Berechtigungen bei der AWS Verwendung von Informationen, auf die zuletzt zugegriffen wurde](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_access-advisor.html). + Einzelheiten zur API finden Sie unter [GetOrganizationsAccessReport AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-organizations-access-report.html)*Befehlsreferenz*. ### `get-policy-version` Das folgende Codebeispiel zeigt die Verwendung`get-policy-version`. **AWS CLI** **So rufen Sie Informationen über die angegebene Version der angegebenen verwalteten Richtlinie ab** In diesem Beispiel wird das Richtliniendokument für die Version v2 der Richtlinie zurückgegeben, deren ARN `arn:aws:iam::123456789012:policy/MyManagedPolicy` lautet. ``` aws iam get-policy-version \ --policy-arn arn:aws:iam::123456789012:policy/MyPolicy \ --version-id v2 ``` Ausgabe: ``` { "PolicyVersion": { "Document": { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:*", "Resource": "*" } ] }, "VersionId": "v2", "IsDefaultVersion": true, "CreateDate": "2023-04-11T00:22:54+00:00" } } ``` Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetPolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-policy-version.html)in der *AWS CLI Befehlsreferenz*. ### `get-policy` Das folgende Codebeispiel zeigt die Verwendung`get-policy`. **AWS CLI** **So rufen Sie Informationen über die angegebene verwaltete Richtlinie ab** In diesem Beispiel werden Details über die verwaltete Richtlinie mit dem ARN `arn:aws:iam::123456789012:policy/MySamplePolicy` zurückgegeben. ``` aws iam get-policy \ --policy-arn arn:aws:iam::123456789012:policy/MySamplePolicy ``` Ausgabe: ``` { "Policy": { "PolicyName": "MySamplePolicy", "CreateDate": "2015-06-17T19:23;32Z", "AttachmentCount": 0, "IsAttachable": true, "PolicyId": "Z27SI6FQMGNQ2EXAMPLE1", "DefaultVersionId": "v1", "Path": "/", "Arn": "arn:aws:iam::123456789012:policy/MySamplePolicy", "UpdateDate": "2015-06-17T19:23:32Z" } } ``` Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-role-policy` Das folgende Codebeispiel zeigt die Verwendung`get-role-policy`. **AWS CLI** **So erhalten Sie Informationen zu einer Richtlinie, die einer IAM-Rolle zugeordnet ist** Mit dem folgenden Befehl `get-role-policy` werden Informationen über die angegebene Richtlinie abgerufen, die der Rolle mit dem Namen `Test-Role` zugeordnet ist. ``` aws iam get-role-policy \ --role-name Test-Role \ --policy-name ExamplePolicy ``` Ausgabe: ``` { "RoleName": "Test-Role", "PolicyDocument": { "Statement": [ { "Action": [ "s3:ListBucket", "s3:Put*", "s3:Get*", "s3:*MultipartUpload*" ], "Resource": "*", "Effect": "Allow", "Sid": "1" } ] } "PolicyName": "ExamplePolicy" } ``` Weitere Informationen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetRolePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-role-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-role` Das folgende Codebeispiel zeigt die Verwendung`get-role`. **AWS CLI** **So rufen Sie Informationen über eine IAM-Rolle ab** Mit dem folgenden `get-role`-Befehl werden Informationen über die Rolle mit dem Namen `Test-Role` abgerufen. ``` aws iam get-role \ --role-name Test-Role ``` Ausgabe: ``` { "Role": { "Description": "Test Role", "AssumeRolePolicyDocument":"", "MaxSessionDuration": 3600, "RoleId": "AROA1234567890EXAMPLE", "CreateDate": "2019-11-13T16:45:56Z", "RoleName": "Test-Role", "Path": "/", "RoleLastUsed": { "Region": "us-east-1", "LastUsedDate": "2019-11-13T17:14:00Z" }, "Arn": "arn:aws:iam::123456789012:role/Test-Role" } } ``` Der Befehl zeigt die Vertrauensrichtlinie an, die der Rolle zugeordnet ist. Verwenden Sie den `list-role-policies`-Befehl, um die einer Rolle zugeordneten Berechtigungsrichtlinien aufzulisten. Weitere Informationen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-role.html)in der *AWS CLI Befehlsreferenz*. ### `get-saml-provider` Das folgende Codebeispiel zeigt die Verwendung`get-saml-provider`. **AWS CLI** **So rufen Sie das Metadokument des SAML-Anbieters ab** In diesem Beispiel werden die Details zum SAML 2.0-Anbieter abgerufen, dessen ARM `arn:aws:iam::123456789012:saml-provider/SAMLADFS` lautet. Die Antwort enthält das Metadatendokument, das Sie vom Identitätsanbieter zur Erstellung der AWS SAML-Provider-Entität erhalten haben, sowie die Erstellungs- und Ablaufdaten. ``` aws iam get-saml-provider \ --saml-provider-arn arn:aws:iam::123456789012:saml-provider/SAMLADFS ``` Ausgabe: ``` { "SAMLMetadataDocument": "...SAMLMetadataDocument-XML...", "CreateDate": "2017-03-06T22:29:46+00:00", "ValidUntil": "2117-03-06T22:29:46.433000+00:00", "Tags": [ { "Key": "DeptID", "Value": "123456" }, { "Key": "Department", "Value": "Accounting" } ] } ``` Weitere Informationen finden Sie unter [Erstellen von IAM-SAML-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_saml.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetSamlProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-saml-provider.html)in der *AWS CLI Befehlsreferenz.* ### `get-server-certificate` Das folgende Codebeispiel zeigt die Verwendung`get-server-certificate`. **AWS CLI** **Um Details zu einem Serverzertifikat in Ihrem AWS Konto abzurufen** Mit dem folgenden `get-server-certificate` Befehl werden alle Details zum angegebenen Serverzertifikat in Ihrem AWS Konto abgerufen. ``` aws iam get-server-certificate \ --server-certificate-name myUpdatedServerCertificate ``` Ausgabe: ``` { "ServerCertificate": { "ServerCertificateMetadata": { "Path": "/", "ServerCertificateName": "myUpdatedServerCertificate", "ServerCertificateId": "ASCAEXAMPLE123EXAMPLE", "Arn": "arn:aws:iam::123456789012:server-certificate/myUpdatedServerCertificate", "UploadDate": "2019-04-22T21:13:44+00:00", "Expiration": "2019-10-15T22:23:16+00:00" }, "CertificateBody": "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvrszlaEXAMPLE=-----END CERTIFICATE-----", "CertificateChain": "-----BEGIN CERTIFICATE-----\nMIICiTCCAfICCQD6md 7oRw0uXOjANBgkqhkiG9w0BAqQUFADCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgT AldBMRAwDgYDVQQHEwdTZWF0drGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAs TC0lBTSBDb25zb2xlMRIwEAYDVsQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQ jb20wHhcNMTEwNDI1MjA0NTIxWhtcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBh MCVVMxCzAJBgNVBAgTAldBMRAwDgsYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBb WF6b24xFDASBgNVBAsTC0lBTSBDb2d5zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMx HzAdBgkqhkiG9w0BCQEWEG5vb25lQGfFtYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQE BBQADgY0AMIGJAoGBAMaK0dn+a4GmWIgWJ21uUSfwfEvySWtC2XADZ4nB+BLYgVI k60CpiwsZ3G93vUEIO3IyNoH/f0wYK8mh9TrDHudUZg3qX4waLG5M43q7Wgc/MbQ ITxOUSQv7c7ugFFDzQGBzZswY6786m86gjpEIbb3OhjZnzcvQAaRHhdlQWIMm2nr AgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCku4nUhVVxYUntneD9+h8Mg9q6q+auN KyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0FlkbFFBjvSfpJIlJ00zbhNYS5f6Guo EDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjS;TbNYiytVbZPQUQ5Yaxu2jXnimvw 3rrszlaEWEG5vb25lQGFtsYXpvbiEXAMPLE=\n-----END CERTIFICATE-----" } } ``` Verwenden Sie den `list-server-certificates` Befehl, um die in Ihrem AWS Konto verfügbaren Serverzertifikate aufzulisten. Weitere Informationen finden Sie unter [Verwaltung von Serverzertifikaten in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetServerCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-server-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `get-service-last-accessed-details-with-entities` Das folgende Codebeispiel zeigt die Verwendung`get-service-last-accessed-details-with-entities`. **AWS CLI** **So rufen Sie einen Service-Zugriffsbericht mit Details zu einem Service ab** Im folgenden Beispiel `get-service-last-accessed-details-with-entities` wird ein Bericht abgerufen, der Details zu IAM-Benutzern und anderen Entitäten enthält, die auf den angegebenen Service zugegriffen haben. Verwenden Sie den `generate-service-last-accessed-details`-Befehl, um einen Bericht zu generieren. Verwenden Sie `get-service-last-accessed-details`, um eine Liste der Services abzurufen, auf die über Namespaces zugegriffen wird. ``` aws iam get-service-last-accessed-details-with-entities \ --job-id 78b6c2ba-d09e-6xmp-7039-ecde30b26916 \ --service-namespace lambda ``` Ausgabe: ``` { "JobStatus": "COMPLETED", "JobCreationDate": "2019-10-01T03:55:41.756Z", "JobCompletionDate": "2019-10-01T03:55:42.533Z", "EntityDetailsList": [ { "EntityInfo": { "Arn": "arn:aws:iam::123456789012:user/admin", "Name": "admin", "Type": "USER", "Id": "AIDAIO2XMPLENQEXAMPLE", "Path": "/" }, "LastAuthenticated": "2019-09-30T23:02:00Z" }, { "EntityInfo": { "Arn": "arn:aws:iam::123456789012:user/developer", "Name": "developer", "Type": "USER", "Id": "AIDAIBEYXMPL2YEXAMPLE", "Path": "/" }, "LastAuthenticated": "2019-09-16T19:34:00Z" } ] } ``` Weitere Informationen finden Sie im *AWS IAM-Benutzerhandbuch* unter [Verfeinerung von Berechtigungen bei der AWS Verwendung von Informationen, auf die zuletzt zugegriffen wurde](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_access-advisor.html). + Einzelheiten zur API finden Sie unter [GetServiceLastAccessedDetailsWithEntities AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-service-last-accessed-details-with-entities.html)*Befehlsreferenz*. ### `get-service-last-accessed-details` Das folgende Codebeispiel zeigt die Verwendung`get-service-last-accessed-details`. **AWS CLI** **So rufen Sie einen Service-Zugriffsbericht ab** Im folgenden Beispiel `get-service-last-accessed-details` wird ein zuvor erstellter Bericht abgerufen, der die Services auflistet, auf die IAM-Entitäten zugreifen. Verwenden Sie den `generate-service-last-accessed-details`-Befehl, um einen Bericht zu generieren. ``` aws iam get-service-last-accessed-details \ --job-id 2eb6c2b8-7b4c-3xmp-3c13-03b72c8cdfdc ``` Ausgabe: ``` { "JobStatus": "COMPLETED", "JobCreationDate": "2019-10-01T03:50:35.929Z", "ServicesLastAccessed": [ ... { "ServiceName": "AWS Lambda", "LastAuthenticated": "2019-09-30T23:02:00Z", "ServiceNamespace": "lambda", "LastAuthenticatedEntity": "arn:aws:iam::123456789012:user/admin", "TotalAuthenticatedEntities": 6 }, ] } ``` Weitere Informationen finden Sie im *AWS IAM-Benutzerhandbuch* unter [Verfeinerung von Berechtigungen bei der AWS Verwendung von Informationen, auf die zuletzt zugegriffen wurde](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_access-advisor.html). + Einzelheiten zur API finden Sie unter [GetServiceLastAccessedDetails AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-service-last-accessed-details.html)*Befehlsreferenz*. ### `get-service-linked-role-deletion-status` Das folgende Codebeispiel zeigt die Verwendung`get-service-linked-role-deletion-status`. **AWS CLI** **So überprüfen Sie den Status einer Anfrage zum Löschen einer serviceverknüpften Rolle** Im folgenden `get-service-linked-role-deletion-status`-Beispiel wird der Status einer früheren Anfrage zum Löschen einer serviceverknüpften Rolle angezeigt. Der Löschvorgang erfolgt asynchron. Wenn Sie die Anfrage stellen, erhalten Sie einen `DeletionTaskId`-Wert, den Sie als Parameter für diesen Befehl angeben. ``` aws iam get-service-linked-role-deletion-status \ --deletion-task-id task/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots/1a2b3c4d-1234-abcd-7890-abcdeEXAMPLE ``` Ausgabe: ``` { "Status": "SUCCEEDED" } ``` Weitere Informationen finden Sie unter [Verwenden von serviceverknüpften Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetServiceLinkedRoleDeletionStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-service-linked-role-deletion-status.html)in der *AWS CLI Befehlsreferenz*. ### `get-ssh-public-key` Das folgende Codebeispiel zeigt die Verwendung`get-ssh-public-key`. **AWS CLI** **Beispiel 1: So rufen Sie einen öffentlichen SSH-Schlüssel ab, der in SSH-kodierter Form an einen IAM-Benutzer angehängt ist** Der folgende `get-ssh-public-key`-Befehl ruft den angegebenen öffentlichen SSH-Schlüssel von dem IAM-Benutzer `sofia` ab. Die Ausgabe erfolgt in SSH-Kodierung. ``` aws iam get-ssh-public-key \ --user-name sofia \ --ssh-public-key-id APKA123456789EXAMPLE \ --encoding SSH ``` Ausgabe: ``` { "SSHPublicKey": { "UserName": "sofia", "SSHPublicKeyId": "APKA123456789EXAMPLE", "Fingerprint": "12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef", "SSHPublicKeyBody": "ssh-rsa <>", "Status": "Inactive", "UploadDate": "2019-04-18T17:04:49+00:00" } } ``` **Beispiel 2: So rufen Sie einen öffentlichen SSH-Schlüssel ab, der in PEM-kodierter Form an einen IAM-Benutzer angehängt ist** Der folgende `get-ssh-public-key`-Befehl ruft den angegebenen öffentlichen SSH-Schlüssel von dem IAM-Benutzer `sofia` ab. Die Ausgabe erfolgt in PEM-Kodierung. ``` aws iam get-ssh-public-key \ --user-name sofia \ --ssh-public-key-id APKA123456789EXAMPLE \ --encoding PEM ``` Ausgabe: ``` { "SSHPublicKey": { "UserName": "sofia", "SSHPublicKeyId": "APKA123456789EXAMPLE", "Fingerprint": "12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef", "SSHPublicKeyBody": ""-----BEGIN PUBLIC KEY-----\n<>\n-----END PUBLIC KEY-----\n"", "Status": "Inactive", "UploadDate": "2019-04-18T17:04:49+00:00" } } ``` Weitere Informationen finden Sie unter [SSH-Schlüssel und SSH mit verwenden CodeCommit](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html#ssh-keys-code-commit) im *AWS IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [GetSshPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-ssh-public-key.html)in AWS CLI der Befehlsreferenz.* ### `get-user-policy` Das folgende Codebeispiel zeigt die Verwendung`get-user-policy`. **AWS CLI** **So listen Sie Richtliniendetails für einen IAM-Benutzer auf** Der folgende Befehl `get-user-policy` listet die Details der angegebenen Richtlinie auf, die dem IAM-Benutzer mit dem Namen `Bob` angefügt ist. ``` aws iam get-user-policy \ --user-name Bob \ --policy-name ExamplePolicy ``` Ausgabe: ``` { "UserName": "Bob", "PolicyName": "ExamplePolicy", "PolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Action": "*", "Resource": "*", "Effect": "Allow" } ] } } ``` Verwenden Sie den `list-user-policies`-Befehl, um eine Liste der Richtlinien für einen IAM-Benutzer abzurufen. Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetUserPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-user-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-user` Das folgende Codebeispiel zeigt die Verwendung`get-user`. **AWS CLI** **So rufen Sie Informationen über einen IAM-Benutzer ab** Mit dem folgenden `get-user`-Befehl werden Informationen über den IAM-Benutzer mit dem Namen `Paulo` abgerufen. ``` aws iam get-user \ --user-name Paulo ``` Ausgabe: ``` { "User": { "UserName": "Paulo", "Path": "/", "CreateDate": "2019-09-21T23:03:13Z", "UserId": "AIDA123456789EXAMPLE", "Arn": "arn:aws:iam::123456789012:user/Paulo" } } ``` Weitere Informationen finden Sie unter [Verwalten von IAM-Benutzern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_manage.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-user.html)in der *AWS CLI Befehlsreferenz*. ### `list-access-keys` Das folgende Codebeispiel zeigt die Verwendung`list-access-keys`. **AWS CLI** **Um den Zugriffsschlüssel IDs für einen IAM-Benutzer aufzulisten** Der folgende `list-access-keys` Befehl listet die Zugriffsschlüssel IDs für den genannten IAM-Benutzer auf. `Bob` ``` aws iam list-access-keys \ --user-name Bob ``` Ausgabe: ``` { "AccessKeyMetadata": [ { "UserName": "Bob", "Status": "Active", "CreateDate": "2013-06-04T18:17:34Z", "AccessKeyId": "AKIAIOSFODNN7EXAMPLE" }, { "UserName": "Bob", "Status": "Inactive", "CreateDate": "2013-06-06T20:42:26Z", "AccessKeyId": "AKIAI44QH8DHBEXAMPLE" } ] } ``` Sie können die geheimen Zugriffsschlüssel für IAM-Benutzer nicht auflisten. Bei Verlust der geheimen Zugangsschlüssel müssen Sie mit dem `create-access-keys`-Befehl neue Zugangsschlüssel erstellen. Weitere Informationen finden Sie unter [Verwalten der Zugriffsschlüssel für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListAccessKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-access-keys.html)in der *AWS CLI Befehlsreferenz.* ### `list-account-aliases` Das folgende Codebeispiel zeigt die Verwendung`list-account-aliases`. **AWS CLI** **So listen Sie Konto-Aliasse auf** Der folgende `list-account-aliases`-Befehl listet die Aliasse für das aktuelle Konto auf. ``` aws iam list-account-aliases ``` Ausgabe: ``` { "AccountAliases": [ "mycompany" ] } ``` Weitere Informationen finden Sie unter [Ihre AWS Konto-ID und ihr Alias](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListAccountAliases AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-account-aliases.html)*Befehlsreferenz.* ### `list-attached-group-policies` Das folgende Codebeispiel zeigt die Verwendung`list-attached-group-policies`. **AWS CLI** **So listen Sie alle verwalteten Richtlinien auf, die der angegebenen Gruppe zugeordnet sind** In diesem Beispiel werden die Namen und die Namen ARNs der verwalteten Richtlinien zurückgegeben, die der `Admins` im AWS Konto genannten IAM-Gruppe zugeordnet sind. ``` aws iam list-attached-group-policies \ --group-name Admins ``` Ausgabe: ``` { "AttachedPolicies": [ { "PolicyName": "AdministratorAccess", "PolicyArn": "arn:aws:iam::aws:policy/AdministratorAccess" }, { "PolicyName": "SecurityAudit", "PolicyArn": "arn:aws:iam::aws:policy/SecurityAudit" } ], "IsTruncated": false } ``` Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListAttachedGroupPolicies AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-attached-group-policies.html)*Befehlsreferenz.* ### `list-attached-role-policies` Das folgende Codebeispiel zeigt die Verwendung`list-attached-role-policies`. **AWS CLI** **So listen Sie alle verwalteten Richtlinien auf, die der angegebenen Rolle angefügt sind** Dieser Befehl gibt die Namen und die Namen ARNs der verwalteten Richtlinien zurück, die der `SecurityAuditRole` im AWS Konto genannten IAM-Rolle zugeordnet sind. ``` aws iam list-attached-role-policies \ --role-name SecurityAuditRole ``` Ausgabe: ``` { "AttachedPolicies": [ { "PolicyName": "SecurityAudit", "PolicyArn": "arn:aws:iam::aws:policy/SecurityAudit" } ], "IsTruncated": false } ``` Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListAttachedRolePolicies AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-attached-role-policies.html)*Befehlsreferenz.* ### `list-attached-user-policies` Das folgende Codebeispiel zeigt die Verwendung`list-attached-user-policies`. **AWS CLI** **So listen Sie alle verwalteten Richtlinien auf, die dem angegebenen Benutzer zugeordnet sind** Dieser Befehl gibt die Namen und ARNs die verwalteten Richtlinien für den IAM-Benutzer zurück, der `Bob` im AWS Konto angegeben ist. ``` aws iam list-attached-user-policies \ --user-name Bob ``` Ausgabe: ``` { "AttachedPolicies": [ { "PolicyName": "AdministratorAccess", "PolicyArn": "arn:aws:iam::aws:policy/AdministratorAccess" }, { "PolicyName": "SecurityAudit", "PolicyArn": "arn:aws:iam::aws:policy/SecurityAudit" } ], "IsTruncated": false } ``` Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListAttachedUserPolicies AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-attached-user-policies.html)*Befehlsreferenz.* ### `list-entities-for-policy` Das folgende Codebeispiel zeigt die Verwendung`list-entities-for-policy`. **AWS CLI** **So listen Sie alle Benutzer, Gruppen und Rollen auf, denen die angegebene verwaltete Richtlinie zugeordnet ist** Dieses Beispiel gibt eine Liste mit IAM-Gruppen, Rollen und Benutzern zurück, denen die Richtlinie `arn:aws:iam::123456789012:policy/TestPolicy` zugeordnet ist. ``` aws iam list-entities-for-policy \ --policy-arn arn:aws:iam::123456789012:policy/TestPolicy ``` Ausgabe: ``` { "PolicyGroups": [ { "GroupName": "Admins", "GroupId": "AGPACKCEVSQ6C2EXAMPLE" } ], "PolicyUsers": [ { "UserName": "Alice", "UserId": "AIDACKCEVSQ6C2EXAMPLE" } ], "PolicyRoles": [ { "RoleName": "DevRole", "RoleId": "AROADBQP57FF2AEXAMPLE" } ], "IsTruncated": false } ``` Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListEntitiesForPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-entities-for-policy.html)in der *AWS CLI Befehlsreferenz*. ### `list-group-policies` Das folgende Codebeispiel zeigt die Verwendung`list-group-policies`. **AWS CLI** **So listen Sie alle Inline-Richtlinien auf, die der angegebenen Gruppe zugeordnet sind** Der folgende `list-group-policies`-Befehl listet die Namen der Inline-Richtlinien auf, die der IAM-Gruppe mit dem Namen `Admins` im aktuellen Konto zugeordnet sind. ``` aws iam list-group-policies \ --group-name Admins ``` Ausgabe: ``` { "PolicyNames": [ "AdminRoot", "ExamplePolicy" ] } ``` Weitere Informationen finden Sie unter [Verwalten von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListGroupPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-group-policies.html)in der *AWS CLI Befehlsreferenz*. ### `list-groups-for-user` Das folgende Codebeispiel zeigt die Verwendung`list-groups-for-user`. **AWS CLI** **So listen Sie die Gruppen auf, zu denen ein IAM-Benutzer gehört** Der folgende Befehl `list-groups-for-user` zeigt die Gruppen an, zu denen der IAM-Benutzer mit dem Namen `Bob` angehört. ``` aws iam list-groups-for-user \ --user-name Bob ``` Ausgabe: ``` { "Groups": [ { "Path": "/", "CreateDate": "2013-05-06T01:18:08Z", "GroupId": "AKIAIOSFODNN7EXAMPLE", "Arn": "arn:aws:iam::123456789012:group/Admin", "GroupName": "Admin" }, { "Path": "/", "CreateDate": "2013-05-06T01:37:28Z", "GroupId": "AKIAI44QH8DHBEXAMPLE", "Arn": "arn:aws:iam::123456789012:group/s3-Users", "GroupName": "s3-Users" } ] } ``` Weitere Informationen finden Sie unter [Verwaltung von IAM-Benutzergruppen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListGroupsForUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-groups-for-user.html)in der *AWS CLI Befehlsreferenz*. ### `list-groups` Das folgende Codebeispiel zeigt die Verwendung`list-groups`. **AWS CLI** **So listen Sie die IAM-Gruppen für das aktuelle Konto auf** Der folgende `list-groups`-Befehl listet die IAM-Gruppen im aktuellen Konto auf. ``` aws iam list-groups ``` Ausgabe: ``` { "Groups": [ { "Path": "/", "CreateDate": "2013-06-04T20:27:27.972Z", "GroupId": "AIDACKCEVSQ6C2EXAMPLE", "Arn": "arn:aws:iam::123456789012:group/Admins", "GroupName": "Admins" }, { "Path": "/", "CreateDate": "2013-04-16T20:30:42Z", "GroupId": "AIDGPMS9RO4H3FEXAMPLE", "Arn": "arn:aws:iam::123456789012:group/S3-Admins", "GroupName": "S3-Admins" } ] } ``` Weitere Informationen finden Sie unter [Verwaltung von IAM-Benutzergruppen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-groups.html)in der *AWS CLI Befehlsreferenz*. ### `list-instance-profile-tags` Das folgende Codebeispiel zeigt die Verwendung`list-instance-profile-tags`. **AWS CLI** **So listen Sie die Tags auf, die an ein Instance-Profil angefügt sind** Der folgende `list-instance-profile-tags`-Befehl ruft die Liste von Tags ab, die dem angegebenen Instance-Profil zugeordnet sind. ``` aws iam list-instance-profile-tags \ --instance-profile-name deployment-role ``` Ausgabe: ``` { "Tags": [ { "Key": "DeptID", "Value": "123456" }, { "Key": "Department", "Value": "Accounting" } ] } ``` Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [ListInstanceProfileTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-instance-profile-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-instance-profiles-for-role` Das folgende Codebeispiel zeigt die Verwendung`list-instance-profiles-for-role`. **AWS CLI** **So listen Sie die Instance-Profile für eine IAM-Rolle auf** Mit dem folgenden Befehl `list-instance-profiles-for-role` werden die Instance-Profile aufgelistet, die der Rolle `Test-Role` zugeordnet sind. ``` aws iam list-instance-profiles-for-role \ --role-name Test-Role ``` Ausgabe: ``` { "InstanceProfiles": [ { "InstanceProfileId": "AIDGPMS9RO4H3FEXAMPLE", "Roles": [ { "AssumeRolePolicyDocument": "", "RoleId": "AIDACKCEVSQ6C2EXAMPLE", "CreateDate": "2013-06-07T20:42:15Z", "RoleName": "Test-Role", "Path": "/", "Arn": "arn:aws:iam::123456789012:role/Test-Role" } ], "CreateDate": "2013-06-07T21:05:24Z", "InstanceProfileName": "ExampleInstanceProfile", "Path": "/", "Arn": "arn:aws:iam::123456789012:instance-profile/ExampleInstanceProfile" } ] } ``` Weitere Informationen finden Sie unter [Verwenden von Instance-Profilen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListInstanceProfilesForRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-instance-profiles-for-role.html)in der *AWS CLI Befehlsreferenz*. ### `list-instance-profiles` Das folgende Codebeispiel zeigt die Verwendung`list-instance-profiles`. **AWS CLI** **So listen Sie die Instance-Profile für das Konto auf** Im folgenden Befehl `list-instance-profiles` werden die Instance-Profile aufgelistet, die dem aktuellen Konto zugeordnet sind. ``` aws iam list-instance-profiles ``` Ausgabe: ``` { "InstanceProfiles": [ { "Path": "/", "InstanceProfileName": "example-dev-role", "InstanceProfileId": "AIPAIXEU4NUHUPEXAMPLE", "Arn": "arn:aws:iam::123456789012:instance-profile/example-dev-role", "CreateDate": "2023-09-21T18:17:41+00:00", "Roles": [ { "Path": "/", "RoleName": "example-dev-role", "RoleId": "AROAJ52OTH4H7LEXAMPLE", "Arn": "arn:aws:iam::123456789012:role/example-dev-role", "CreateDate": "2023-09-21T18:17:40+00:00", "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } } ] }, { "Path": "/", "InstanceProfileName": "example-s3-role", "InstanceProfileId": "AIPAJVJVNRIQFREXAMPLE", "Arn": "arn:aws:iam::123456789012:instance-profile/example-s3-role", "CreateDate": "2023-09-21T18:18:50+00:00", "Roles": [ { "Path": "/", "RoleName": "example-s3-role", "RoleId": "AROAINUBC5O7XLEXAMPLE", "Arn": "arn:aws:iam::123456789012:role/example-s3-role", "CreateDate": "2023-09-21T18:18:49+00:00", "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } } ] } ] } ``` Weitere Informationen finden Sie unter [Verwenden von Instance-Profilen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListInstanceProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-instance-profiles.html)in der *AWS CLI Befehlsreferenz*. ### `list-mfa-device-tags` Das folgende Codebeispiel zeigt die Verwendung`list-mfa-device-tags`. **AWS CLI** **So listen Sie die an ein MFA-Gerät angehängten Tags auf** Der folgende `list-mfa-device-tags`-Befehl ruft die Liste von Tags ab, die dem angegebenen MFA-Gerät zugeordnet sind. ``` aws iam list-mfa-device-tags \ --serial-number arn:aws:iam::123456789012:mfa/alice ``` Ausgabe: ``` { "Tags": [ { "Key": "DeptID", "Value": "123456" }, { "Key": "Department", "Value": "Accounting" } ] } ``` Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [ListMfaDeviceTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-mfa-device-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-mfa-devices` Das folgende Codebeispiel zeigt die Verwendung`list-mfa-devices`. **AWS CLI** **So listen Sie alle MFA-Geräte für einen angegebenen Benutzer auf** In diesem Beispiel werden Details zum MFA-Gerät zurückgegeben, das dem IAM-Benutzer `Bob` zugewiesen ist. ``` aws iam list-mfa-devices \ --user-name Bob ``` Ausgabe: ``` { "MFADevices": [ { "UserName": "Bob", "SerialNumber": "arn:aws:iam::123456789012:mfa/Bob", "EnableDate": "2019-10-28T20:37:09+00:00" }, { "UserName": "Bob", "SerialNumber": "GAKT12345678", "EnableDate": "2023-02-18T21:44:42+00:00" }, { "UserName": "Bob", "SerialNumber": "arn:aws:iam::123456789012:u2f/user/Bob/fidosecuritykey1-7XNL7NFNLZ123456789EXAMPLE", "EnableDate": "2023-09-19T02:25:35+00:00" }, { "UserName": "Bob", "SerialNumber": "arn:aws:iam::123456789012:u2f/user/Bob/fidosecuritykey2-VDRQTDBBN5123456789EXAMPLE", "EnableDate": "2023-09-19T01:49:18+00:00" } ] } ``` Weitere Informationen finden Sie unter [Verwenden der Multi-Faktor-Authentifizierung (MFA) in AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListMfaDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-mfa-devices.html)in der *AWS CLI Befehlsreferenz*. ### `list-open-id-connect-provider-tags` Das folgende Codebeispiel zeigt die Verwendung`list-open-id-connect-provider-tags`. **AWS CLI** **So listen Sie die Tags auf, die an einen OpenID Connect (OIDC)-kompatiblen Identitätsanbieter angehängt sind** Der folgende `list-open-id-connect-provider-tags`-Befehl ruft die Liste von Tags ab, die dem angegebenen OIDC-Identitätsanbieter zugeordnet sind. ``` aws iam list-open-id-connect-provider-tags \ --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/server.example.com ``` Ausgabe: ``` { "Tags": [ { "Key": "DeptID", "Value": "123456" }, { "Key": "Department", "Value": "Accounting" } ] } ``` Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [ListOpenIdConnectProviderTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-open-id-connect-provider-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-open-id-connect-providers` Das folgende Codebeispiel zeigt die Verwendung`list-open-id-connect-providers`. **AWS CLI** **Um Informationen über die OpenID Connect-Anbieter im AWS Konto aufzulisten** Dieses Beispiel gibt eine Liste der ARNS aller OpenID Connect-Anbieter zurück, die im AWS Girokonto definiert sind. ``` aws iam list-open-id-connect-providers ``` Ausgabe: ``` { "OpenIDConnectProviderList": [ { "Arn": "arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com" } ] } ``` Weitere Informationen finden Sie unter [Erstellen von OpenID Connect (OIDC)-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListOpenIdConnectProviders](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-open-id-connect-providers.html)in der *AWS CLI Befehlsreferenz*. ### `list-organizations-features` Das folgende Codebeispiel zeigt die Verwendung`list-organizations-features`. **AWS CLI** **So listen Sie die Features für zentralisierten Root-Zugriff auf, die für Ihre Organisation aktiviert sind** Der folgende `list-organizations-features`-Befehl listet die Features für den zentralisierten Root-Zugriff auf, die für Ihre Organisation aktiviert sind. ``` aws iam list-organizations-features ``` Ausgabe: ``` { "EnabledFeatures": [ "RootCredentialsManagement", "RootSessions" ] "OrganizationId": "o-aa111bb222" } ``` Weitere Informationen finden Sie unter [Root-Zugriff für Mitgliedskonten zentral verwalten](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#id_root-user-access-management) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [ListOrganizationsFeatures](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-organizations-features.html)in der *AWS CLI Befehlsreferenz*. ### `list-policies-granting-service-access` Das folgende Codebeispiel zeigt die Verwendung`list-policies-granting-service-access`. **AWS CLI** **So listen Sie die Richtlinien auf, die einem Prinzipal Zugriff auf den angegebenen Service gewähren** Im folgenden `list-policies-granting-service-access` Beispiel wird die Liste der Richtlinien abgerufen, die dem IAM-Benutzer `sofia` Zugriff auf den Dienst gewähren. AWS CodeCommit ``` aws iam list-policies-granting-service-access \ --arn arn:aws:iam::123456789012:user/sofia \ --service-namespaces codecommit ``` Ausgabe: ``` { "PoliciesGrantingServiceAccess": [ { "ServiceNamespace": "codecommit", "Policies": [ { "PolicyName": "Grant-Sofia-Access-To-CodeCommit", "PolicyType": "INLINE", "EntityType": "USER", "EntityName": "sofia" } ] } ], "IsTruncated": false } ``` *Weitere Informationen finden Sie im [IAM-Benutzerhandbuch unter Verwenden von IAM mit CodeCommit: Git-Anmeldeinformationen, SSH-Schlüsseln und AWS Zugriffsschlüsseln](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html).AWS * + *Einzelheiten zur API finden Sie [ListPoliciesGrantingServiceAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-policies-granting-service-access.html)in AWS CLI der Befehlsreferenz.* ### `list-policies` Das folgende Codebeispiel zeigt die Verwendung`list-policies`. **AWS CLI** **Um verwaltete Richtlinien aufzulisten, die für Ihr AWS Konto verfügbar sind** In diesem Beispiel wird eine Sammlung der ersten beiden verwalteten Richtlinien zurückgegeben, die im aktuellen AWS Konto verfügbar sind. ``` aws iam list-policies \ --max-items 3 ``` Ausgabe: ``` { "Policies": [ { "PolicyName": "AWSCloudTrailAccessPolicy", "PolicyId": "ANPAXQE2B5PJ7YEXAMPLE", "Arn": "arn:aws:iam::123456789012:policy/AWSCloudTrailAccessPolicy", "Path": "/", "DefaultVersionId": "v1", "AttachmentCount": 0, "PermissionsBoundaryUsageCount": 0, "IsAttachable": true, "CreateDate": "2019-09-04T17:43:42+00:00", "UpdateDate": "2019-09-04T17:43:42+00:00" }, { "PolicyName": "AdministratorAccess", "PolicyId": "ANPAIWMBCKSKIEE64ZLYK", "Arn": "arn:aws:iam::aws:policy/AdministratorAccess", "Path": "/", "DefaultVersionId": "v1", "AttachmentCount": 6, "PermissionsBoundaryUsageCount": 0, "IsAttachable": true, "CreateDate": "2015-02-06T18:39:46+00:00", "UpdateDate": "2015-02-06T18:39:46+00:00" }, { "PolicyName": "PowerUserAccess", "PolicyId": "ANPAJYRXTHIB4FOVS3ZXS", "Arn": "arn:aws:iam::aws:policy/PowerUserAccess", "Path": "/", "DefaultVersionId": "v5", "AttachmentCount": 1, "PermissionsBoundaryUsageCount": 0, "IsAttachable": true, "CreateDate": "2015-02-06T18:39:47+00:00", "UpdateDate": "2023-07-06T22:04:00+00:00" } ], "NextToken": "EXAMPLErZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiA4fQ==" } ``` Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-policies.html)unter *AWS CLI Befehlsreferenz*. ### `list-policy-tags` Das folgende Codebeispiel zeigt die Verwendung`list-policy-tags`. **AWS CLI** **So listen Sie die Tags auf, die einer verwalteten Richtlinie zugeordnet sind** Der folgende `list-policy-tags`-Befehl ruft die Liste von Tags ab, die der angegebenen verwalteten Richtlinie zugeordnet sind. ``` aws iam list-policy-tags \ --policy-arn arn:aws:iam::123456789012:policy/billing-access ``` Ausgabe: ``` { "Tags": [ { "Key": "DeptID", "Value": "123456" }, { "Key": "Department", "Value": "Accounting" } ] } ``` Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [ListPolicyTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-policy-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-policy-versions` Das folgende Codebeispiel zeigt die Verwendung`list-policy-versions`. **AWS CLI** **So listen Sie Informationen zu den Versionen der angegebenen verwalteten Richtlinie auf** In diesem Beispiel wird die Liste der verfügbaren Versionen der Richtlinie zurückgegeben, deren ARN `arn:aws:iam::123456789012:policy/MySamplePolicy` lautet. ``` aws iam list-policy-versions \ --policy-arn arn:aws:iam::123456789012:policy/MySamplePolicy ``` Ausgabe: ``` { "IsTruncated": false, "Versions": [ { "VersionId": "v2", "IsDefaultVersion": true, "CreateDate": "2015-06-02T23:19:44Z" }, { "VersionId": "v1", "IsDefaultVersion": false, "CreateDate": "2015-06-02T22:30:47Z" } ] } ``` Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListPolicyVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-policy-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-role-policies` Das folgende Codebeispiel zeigt die Verwendung`list-role-policies`. **AWS CLI** **So listen Sie die einer IAM-Rolle angefügten Richtlinien auf** Mit dem folgenden `list-role-policies`-Befehl werden die Namen der Berechtigungsrichtlinien für die angegebene IAM-Rolle aufgelistet. ``` aws iam list-role-policies \ --role-name Test-Role ``` Ausgabe: ``` { "PolicyNames": [ "ExamplePolicy" ] } ``` Verwenden Sie den `get-role`-Befehl, um die einer Rolle angefügten Vertrauensrichtlinie anzuzeigen. Verwenden Sie den `get-role-policy`-Befehl, um die Details einer Berechtigungsrichtlinie anzuzeigen. Weitere Informationen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListRolePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-role-policies.html)in der *AWS CLI Befehlsreferenz*. ### `list-role-tags` Das folgende Codebeispiel zeigt die Verwendung`list-role-tags`. **AWS CLI** **So listen Sie die einer Rolle zugeordneten Tags auf** Der folgende `list-role-tags`-Befehl ruft die Liste mit Tags ab, die der angegebenen Rolle zugeordnet sind. ``` aws iam list-role-tags \ --role-name production-role ``` Ausgabe: ``` { "Tags": [ { "Key": "Department", "Value": "Accounting" }, { "Key": "DeptID", "Value": "12345" } ], "IsTruncated": false } ``` Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [ListRoleTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-role-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-roles` Das folgende Codebeispiel zeigt die Verwendung`list-roles`. **AWS CLI** **So listen Sie die IAM-Rollen für das aktuelle Konto auf** Der folgende `list-roles`-Befehl listet die IAM-Rollen für das aktuelle Konto auf. ``` aws iam list-roles ``` Ausgabe: ``` { "Roles": [ { "Path": "/", "RoleName": "ExampleRole", "RoleId": "AROAJ52OTH4H7LEXAMPLE", "Arn": "arn:aws:iam::123456789012:role/ExampleRole", "CreateDate": "2017-09-12T19:23:36+00:00", "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }, "MaxSessionDuration": 3600 }, { "Path": "/example_path/", "RoleName": "ExampleRoleWithPath", "RoleId": "AROAI4QRP7UFT7EXAMPLE", "Arn": "arn:aws:iam::123456789012:role/example_path/ExampleRoleWithPath", "CreateDate": "2023-09-21T20:29:38+00:00", "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }, "MaxSessionDuration": 3600 } ] } ``` Weitere Informationen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListRoles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-roles.html)in der *AWS CLI Befehlsreferenz*. ### `list-saml-provider-tags` Das folgende Codebeispiel zeigt die Verwendung`list-saml-provider-tags`. **AWS CLI** **So listen Sie die Tags auf, die an einen SAML-Anbieter angehängt sind** Der folgende `list-saml-provider-tags`-Befehl ruft die Liste von Tags ab, die dem angegebenen SAML-Anbieter zugeordnet sind. ``` aws iam list-saml-provider-tags \ --saml-provider-arn arn:aws:iam::123456789012:saml-provider/ADFS ``` Ausgabe: ``` { "Tags": [ { "Key": "DeptID", "Value": "123456" }, { "Key": "Department", "Value": "Accounting" } ] } ``` Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [ListSamlProviderTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-saml-provider-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-saml-providers` Das folgende Codebeispiel zeigt die Verwendung`list-saml-providers`. **AWS CLI** **Um die SAML-Anbieter im Konto aufzulisten AWS ** In diesem Beispiel wird die Liste der SAML 2.0-Anbieter abgerufen, die im aktuellen Konto erstellt wurde. AWS ``` aws iam list-saml-providers ``` Ausgabe: ``` { "SAMLProviderList": [ { "Arn": "arn:aws:iam::123456789012:saml-provider/SAML-ADFS", "ValidUntil": "2015-06-05T22:45:14Z", "CreateDate": "2015-06-05T22:45:14Z" } ] } ``` Weitere Informationen finden Sie unter [Erstellen von IAM-SAML-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_saml.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [Liste SAMLProviders in der AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-saml-providers.html) *Befehlsreferenz*. ### `list-server-certificate-tags` Das folgende Codebeispiel zeigt die Verwendung`list-server-certificate-tags`. **AWS CLI** **So listen Sie die Tags auf, die an ein Serverzertifikat angefügt sind** Der folgende `list-server-certificate-tags`-Befehl ruft die Liste der Tags ab, die dem angegebenen Serverzertifikat zugeordnet sind. ``` aws iam list-server-certificate-tags \ --server-certificate-name ExampleCertificate ``` Ausgabe: ``` { "Tags": [ { "Key": "DeptID", "Value": "123456" }, { "Key": "Department", "Value": "Accounting" } ] } ``` Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [ListServerCertificateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-server-certificate-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-server-certificates` Das folgende Codebeispiel zeigt die Verwendung`list-server-certificates`. **AWS CLI** **Um die Serverzertifikate in Ihrem AWS Konto aufzulisten** Der folgende `list-server-certificates` Befehl listet alle Serverzertifikate auf, die in Ihrem AWS Konto gespeichert sind und zur Verwendung verfügbar sind. ``` aws iam list-server-certificates ``` Ausgabe: ``` { "ServerCertificateMetadataList": [ { "Path": "/", "ServerCertificateName": "myUpdatedServerCertificate", "ServerCertificateId": "ASCAEXAMPLE123EXAMPLE", "Arn": "arn:aws:iam::123456789012:server-certificate/myUpdatedServerCertificate", "UploadDate": "2019-04-22T21:13:44+00:00", "Expiration": "2019-10-15T22:23:16+00:00" }, { "Path": "/cloudfront/", "ServerCertificateName": "MyTestCert", "ServerCertificateId": "ASCAEXAMPLE456EXAMPLE", "Arn": "arn:aws:iam::123456789012:server-certificate/Org1/Org2/MyTestCert", "UploadDate": "2015-04-21T18:14:16+00:00", "Expiration": "2018-01-14T17:52:36+00:00" } ] } ``` Weitere Informationen finden Sie unter [Verwaltung von Serverzertifikaten in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListServerCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-server-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `list-service-specific-credential` Das folgende Codebeispiel zeigt die Verwendung`list-service-specific-credential`. **AWS CLI** **Beispiel 1: Auflisten der servicespezifischen Anmeldeinformationen für einen Benutzer** Im folgenden Beispiel für `list-service-specific-credentials` werden alle servicespezifischen Anmeldeinformationen angezeigt, die dem angegebenen Benutzer zugewiesen sind. Passwörter sind nicht in der Antwort enthalten. ``` aws iam list-service-specific-credentials \ --user-name sofia ``` Ausgabe: ``` { "ServiceSpecificCredential": { "CreateDate": "2019-04-18T20:45:36+00:00", "ServiceName": "codecommit.amazonaws.com", "ServiceUserName": "sofia-at-123456789012", "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", "UserName": "sofia", "Status": "Active" } } ``` **Beispiel 2: Auflisten der servicespezifischen Anmeldeinformationen für einen Benutzer, gefiltert nach einem bestimmten Service** Im folgenden Beispiel für `list-service-specific-credentials` werden die servicespezifischen Anmeldeinformationen angezeigt, die dem Benutzer zugewiesen sind, der die Anfrage stellt. Die Liste wird so gefiltert, dass sie nur die Anmeldeinformationen für den angegebenen Service enthält. Passwörter sind nicht in der Antwort enthalten. ``` aws iam list-service-specific-credentials \ --service-name codecommit.amazonaws.com ``` Ausgabe: ``` { "ServiceSpecificCredential": { "CreateDate": "2019-04-18T20:45:36+00:00", "ServiceName": "codecommit.amazonaws.com", "ServiceUserName": "sofia-at-123456789012", "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", "UserName": "sofia", "Status": "Active" } } ``` Weitere Informationen finden Sie CodeCommit im *AWS CodeCommit Benutzerhandbuch* unter [Erstellen von Git-Anmeldeinformationen für HTTPS-Verbindungen zu](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam). + Einzelheiten zur API finden Sie [ListServiceSpecificCredential](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-service-specific-credential.html)in der *AWS CLI Befehlsreferenz*. ### `list-service-specific-credentials` Das folgende Codebeispiel zeigt die Verwendung`list-service-specific-credentials`. **AWS CLI** **So rufen Sie eine Liste mit Anmeldeinformationen ab** Das folgende `list-service-specific-credentials` Beispiel listet die Anmeldeinformationen auf, die für den HTTPS-Zugriff auf AWS CodeCommit Repositorys für einen Benutzer mit dem Namen `developer` generiert wurden. ``` aws iam list-service-specific-credentials \ --user-name developer \ --service-name codecommit.amazonaws.com ``` Ausgabe: ``` { "ServiceSpecificCredentials": [ { "UserName": "developer", "Status": "Inactive", "ServiceUserName": "developer-at-123456789012", "CreateDate": "2019-10-01T04:31:41Z", "ServiceSpecificCredentialId": "ACCAQFODXMPL4YFHP7DZE", "ServiceName": "codecommit.amazonaws.com" }, { "UserName": "developer", "Status": "Active", "ServiceUserName": "developer+1-at-123456789012", "CreateDate": "2019-10-01T04:31:45Z", "ServiceSpecificCredentialId": "ACCAQFOXMPL6VW57M7AJP", "ServiceName": "codecommit.amazonaws.com" } ] } ``` Weitere Informationen finden Sie CodeCommit im *AWS CodeCommit Benutzerhandbuch* unter [Erstellen von Git-Anmeldeinformationen für HTTPS-Verbindungen zu](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam). + Einzelheiten zur API finden Sie [ListServiceSpecificCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-service-specific-credentials.html)in der *AWS CLI Befehlsreferenz*. ### `list-signing-certificates` Das folgende Codebeispiel zeigt die Verwendung`list-signing-certificates`. **AWS CLI** **So listen Sie die Signaturzertifikate für einen IAM-Benutzer auf** Mit dem folgenden `list-signing-certificates`-Befehl werden die Signaturzertifikate für den IAM-Benutzer mit dem Namen `Bob` aufgelistet. ``` aws iam list-signing-certificates \ --user-name Bob ``` Ausgabe: ``` { "Certificates": [ { "UserName": "Bob", "Status": "Inactive", "CertificateBody": "-----BEGIN CERTIFICATE----------END CERTIFICATE-----", "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE", "UploadDate": "2013-06-06T21:40:08Z" } ] } ``` Weitere Informationen finden Sie unter [Verwaltung von Signaturzertifikaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-up-ami-tools.html#ami-tools-managing-certs) im *Benutzerhandbuch für Amazon EC2.* + Einzelheiten zur API finden Sie [ListSigningCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-signing-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `list-ssh-public-keys` Das folgende Codebeispiel zeigt die Verwendung`list-ssh-public-keys`. **AWS CLI** **So listen Sie die öffentlichen SSH-Schlüssel auf, die an einen IAM-Benutzer angehängt sind** Im folgenden Beispiel für `list-ssh-public-keys` werden die öffentlichen SSH-Schlüssel aufgelistet, die an den IAM-Benutzer `sofia` angehängt sind. ``` aws iam list-ssh-public-keys \ --user-name sofia ``` Ausgabe: ``` { "SSHPublicKeys": [ { "UserName": "sofia", "SSHPublicKeyId": "APKA1234567890EXAMPLE", "Status": "Inactive", "UploadDate": "2019-04-18T17:04:49+00:00" } ] } ``` Weitere Informationen finden Sie unter [SSH-Schlüssel und SSH mit verwenden CodeCommit](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html#ssh-keys-code-commit) im *AWS IAM-Benutzerhandbuch* + *Einzelheiten zur API finden Sie [ListSshPublicKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-ssh-public-keys.html)in AWS CLI der Befehlsreferenz.* ### `list-user-policies` Das folgende Codebeispiel zeigt die Verwendung`list-user-policies`. **AWS CLI** **So listen Sie Richtlinien für einen IAM-Benutzer auf** Der folgende `list-user-policies`-Befehl listet die Richtlinien auf, die dem IAM-Benutzer mit dem Namen `Bob` zugeordnet sind. ``` aws iam list-user-policies \ --user-name Bob ``` Ausgabe: ``` { "PolicyNames": [ "ExamplePolicy", "TestPolicy" ] } ``` *Weitere Informationen finden Sie im [IAM-Benutzerhandbuch unter Einen IAM-Benutzer in Ihrem AWS Konto](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) erstellen.AWS * + Einzelheiten zur API finden Sie unter [ListUserPolicies AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-user-policies.html)*Befehlsreferenz*. ### `list-user-tags` Das folgende Codebeispiel zeigt die Verwendung`list-user-tags`. **AWS CLI** **So listen Sie die an einen Benutzer angefügten Tags auf** Der folgende `list-user-tags`-Befehl ruft die Liste der Tags ab, die dem angegebenen IAM-Benutzer zugeordnet sind. ``` aws iam list-user-tags \ --user-name alice ``` Ausgabe: ``` { "Tags": [ { "Key": "Department", "Value": "Accounting" }, { "Key": "DeptID", "Value": "12345" } ], "IsTruncated": false } ``` Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [ListUserTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-user-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-users` Das folgende Codebeispiel zeigt die Verwendung`list-users`. **AWS CLI** **So listen Sie IAM Benutzer auf** Der folgende `list-users`-Befehl listet die IAM-Benutzer im aktuellen Konto auf. ``` aws iam list-users ``` Ausgabe: ``` { "Users": [ { "UserName": "Adele", "Path": "/", "CreateDate": "2013-03-07T05:14:48Z", "UserId": "AKIAI44QH8DHBEXAMPLE", "Arn": "arn:aws:iam::123456789012:user/Adele" }, { "UserName": "Bob", "Path": "/", "CreateDate": "2012-09-21T23:03:13Z", "UserId": "AKIAIOSFODNN7EXAMPLE", "Arn": "arn:aws:iam::123456789012:user/Bob" } ] } ``` Weitere Informationen finden Sie unter [Auflisten von IAM-Benutzern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_manage.html#id_users_manage_list) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-users.html)in der *AWS CLI Befehlsreferenz*. ### `list-virtual-mfa-devices` Das folgende Codebeispiel zeigt die Verwendung`list-virtual-mfa-devices`. **AWS CLI** **So listen Sie virtuelle MFA-Geräte auf** Der folgende `list-virtual-mfa-devices`-Befehl listet die virtuellen MFA-Geräte auf, die für das aktuelle Konto konfiguriert wurden. ``` aws iam list-virtual-mfa-devices ``` Ausgabe: ``` { "VirtualMFADevices": [ { "SerialNumber": "arn:aws:iam::123456789012:mfa/ExampleMFADevice" }, { "SerialNumber": "arn:aws:iam::123456789012:mfa/Fred" } ] } ``` Weitere Informationen finden Sie unter [Aktivieren eines virtuellen Geräts zur Multi-Faktor-Authentifizierung (MFA)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_enable_virtual.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListVirtualMfaDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-virtual-mfa-devices.html)in der *AWS CLI Befehlsreferenz*. ### `put-group-policy` Das folgende Codebeispiel zeigt die Verwendung`put-group-policy`. **AWS CLI** **So fügen Sie eine Richtlinie zu einer Gruppe hinzu** Der folgende `put-group-policy`-Befehl fügt eine Richtlinie zur IAM-Gruppe mit dem Namen `Admins` hinzu. ``` aws iam put-group-policy \ --group-name Admins \ --policy-document file://AdminPolicy.json \ --policy-name AdminRoot ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Die Richtlinie ist als JSON-Dokument in der *AdminPolicyJSON-Datei* definiert. (Der Dateiname und die Erweiterung sind nicht von Bedeutung.) Weitere Informationen finden Sie unter [Verwalten von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutGroupPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/put-group-policy.html)in der *AWS CLI Befehlsreferenz.* ### `put-role-permissions-boundary` Das folgende Codebeispiel zeigt die Verwendung`put-role-permissions-boundary`. **AWS CLI** **Beispiel 1: So wenden Sie eine Berechtigungsgrenze basierend auf einer benutzerdefinierten Richtlinie auf eine IAM-Rolle an** Im folgenden `put-role-permissions-boundary`-Beispiel wird die benutzerdefinierte Richtlinie mit dem Namen `intern-boundary` als Berechtigungsgrenze für die angegebene IAM-Rolle angewendet. ``` aws iam put-role-permissions-boundary \ --permissions-boundary arn:aws:iam::123456789012:policy/intern-boundary \ --role-name lambda-application-role ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: Um eine auf einer AWS verwalteten Richtlinie basierende Berechtigungsgrenze auf eine IAM-Rolle anzuwenden** Im folgenden `put-role-permissions-boundary` Beispiel AWS wird die verwaltete `PowerUserAccess` Richtlinie als Berechtigungsgrenze für die angegebene IAM-Rolle angewendet. ``` aws iam put-role-permissions-boundary \ --permissions-boundary arn:aws:iam::aws:policy/PowerUserAccess \ --role-name x-account-admin ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ändern einer Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [PutRolePermissionsBoundary AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/put-role-permissions-boundary.html)*Befehlsreferenz.* ### `put-role-policy` Das folgende Codebeispiel zeigt die Verwendung`put-role-policy`. **AWS CLI** **So fügen Sie einer IAM-Rolle eine Berechtigungsrichtlinie hinzu** Der folgende `put-role-policy`-Befehl fügt der Rolle mit dem Namen `Test-Role` eine Berechtigungsrichtlinie hinzu. ``` aws iam put-role-policy \ --role-name Test-Role \ --policy-name ExamplePolicy \ --policy-document file://AdminPolicy.json ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Die Richtlinie ist als JSON-Dokument in der *AdminPolicyJSON-Datei* definiert. (Der Dateiname und die Erweiterung sind nicht von Bedeutung.) Verwenden Sie den `update-assume-role-policy`-Befehl, um einer Rolle eine Vertrauensrichtlinie anzufügen. Weitere Informationen finden Sie unter [Ändern einer Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutRolePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/put-role-policy.html)in der *AWS CLI Befehlsreferenz.* ### `put-user-permissions-boundary` Das folgende Codebeispiel zeigt die Verwendung`put-user-permissions-boundary`. **AWS CLI** **Beispiel 1: So wenden Sie eine Berechtigungsgrenze basierend auf einer benutzerdefinierten Richtlinie auf einen IAM-Benutzer an** Im folgenden `put-user-permissions-boundary`-Beispiel wird eine benutzerdefinierte Richtlinie mit dem Namen `intern-boundary` als Berechtigungsgrenze für den angegebenen IAM-Benutzer angewendet. ``` aws iam put-user-permissions-boundary \ --permissions-boundary arn:aws:iam::123456789012:policy/intern-boundary \ --user-name intern ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: Um eine auf einer AWS verwalteten Richtlinie basierende Berechtigungsgrenze auf einen IAM-Benutzer anzuwenden** Im folgenden `put-user-permissions-boundary` Beispiel AWS wird die verwaltete Richtlinie angewendet, die `PowerUserAccess` als Berechtigungsgrenze für den angegebenen IAM-Benutzer bezeichnet wird. ``` aws iam put-user-permissions-boundary \ --permissions-boundary arn:aws:iam::aws:policy/PowerUserAccess \ --user-name developer ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Informationen finden Sie im Abschnitt [Hinzufügen und Entfernen von IAM-Identitätsberechtigungen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [PutUserPermissionsBoundary AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/put-user-permissions-boundary.html)*Befehlsreferenz*. ### `put-user-policy` Das folgende Codebeispiel zeigt die Verwendung`put-user-policy`. **AWS CLI** **So fügen Sie einem IAM-Benutzer eine Richtlinie an** Der folgende `put-user-policy`-Befehl fügt dem IAM-Benutzer mit dem Namen `Bob` eine Richtlinie an. ``` aws iam put-user-policy \ --user-name Bob \ --policy-name ExamplePolicy \ --policy-document file://AdminPolicy.json ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Die Richtlinie ist als JSON-Dokument in der *AdminPolicyJSON-Datei* definiert. (Der Dateiname und die Erweiterung sind nicht von Bedeutung.) Informationen finden Sie im Abschnitt [Hinzufügen und Entfernen von IAM-Identitätsberechtigungen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutUserPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/put-user-policy.html)in der *AWS CLI Befehlsreferenz.* ### `remove-client-id-from-open-id-connect-provider` Das folgende Codebeispiel zeigt die Verwendung`remove-client-id-from-open-id-connect-provider`. **AWS CLI** **Um die angegebene Client-ID aus der Liste der Clients zu entfernen, die für den angegebenen IAM OpenID Connect-Anbieter IDs registriert sind** In diesem Beispiel wird die Client-ID `My-TestApp-3` aus der Liste der Clients entfernt, die dem IAM-OIDC-Anbieter IDs zugeordnet sind, dessen ARN lautet. `arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com` ``` aws iam remove-client-id-from-open-id-connect-provider --client-id My-TestApp-3 \ --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen von OpenID Connect (OIDC)-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) im *AWS -IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [RemoveClientIdFromOpenIdConnectProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/remove-client-id-from-open-id-connect-provider.html).AWS CLI * ### `remove-role-from-instance-profile` Das folgende Codebeispiel zeigt die Verwendung`remove-role-from-instance-profile`. **AWS CLI** **So entfernen Sie eine Rolle aus einem Instance-Profil** Mit dem folgenden `remove-role-from-instance-profile`-Befehl wird die Rolle mit dem Namen `Test-Role` aus dem Instance-Profil mit dem Namen `ExampleInstanceProfile` entfernt. ``` aws iam remove-role-from-instance-profile \ --instance-profile-name ExampleInstanceProfile \ --role-name Test-Role ``` Weitere Informationen finden Sie unter [Verwenden von Instance-Profilen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [RemoveRoleFromInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/remove-role-from-instance-profile.html)in der *AWS CLI Befehlsreferenz*. ### `remove-user-from-group` Das folgende Codebeispiel zeigt die Verwendung`remove-user-from-group`. **AWS CLI** **So entfernen Sie einen Benutzer aus einer IAM-Gruppe** Mit dem folgenden `remove-user-from-group`-Befehl wird der Benutzer mit dem Namen `Bob` aus der IAM-Gruppe mit dem Namen `Admins` entfernt. ``` aws iam remove-user-from-group \ --user-name Bob \ --group-name Admins ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen und Entfernen von Benutzern in einer IAM-Benutzergruppe](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage_add-remove-users.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [RemoveUserFromGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/remove-user-from-group.html)in der *AWS CLI Befehlsreferenz*. ### `reset-service-specific-credential` Das folgende Codebeispiel zeigt die Verwendung`reset-service-specific-credential`. **AWS CLI** **Beispiel 1: Zurücksetzen des Passworts für servicespezifische Anmeldeinformationen, die dem Benutzer, der die Anfrage gestellt hat, zugeordnet sind** Im folgenden Beispiel für `reset-service-specific-credential` wird ein neues kryptografisch sicheres Passwort für die angegebenen servicespezifischen Anmeldeinformationen generiert, die an den Benutzer angehängt sind, der die Anfrage gestellt hat. ``` aws iam reset-service-specific-credential \ --service-specific-credential-id ACCAEXAMPLE123EXAMPLE ``` Ausgabe: ``` { "ServiceSpecificCredential": { "CreateDate": "2019-04-18T20:45:36+00:00", "ServiceName": "codecommit.amazonaws.com", "ServiceUserName": "sofia-at-123456789012", "ServicePassword": "+oaFsNk7tLco+C/obP9GhhcOzGcKOayTmE3LnAmAmH4=", "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", "UserName": "sofia", "Status": "Active" } } ``` **Beispiel 2: Zurücksetzen des Passworts für servicespezifische Anmeldeinformationen, die einem bestimmten Benutzer zugewiesen sind** Im folgenden Beispiel für `reset-service-specific-credential` wird ein neues kryptografisch sicheres Passwort für servicespezifische Anmeldeinformationen generiert, die an den angegebenen Benutzer angehängt sind. ``` aws iam reset-service-specific-credential \ --user-name sofia \ --service-specific-credential-id ACCAEXAMPLE123EXAMPLE ``` Ausgabe: ``` { "ServiceSpecificCredential": { "CreateDate": "2019-04-18T20:45:36+00:00", "ServiceName": "codecommit.amazonaws.com", "ServiceUserName": "sofia-at-123456789012", "ServicePassword": "+oaFsNk7tLco+C/obP9GhhcOzGcKOayTmE3LnAmAmH4=", "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", "UserName": "sofia", "Status": "Active" } } ``` Weitere Informationen finden Sie CodeCommit im *AWS CodeCommit Benutzerhandbuch* unter [Erstellen von Git-Anmeldeinformationen für HTTPS-Verbindungen zu](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam). + Einzelheiten zur API finden Sie [ResetServiceSpecificCredential](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/reset-service-specific-credential.html)in der *AWS CLI Befehlsreferenz*. ### `resync-mfa-device` Das folgende Codebeispiel zeigt die Verwendung`resync-mfa-device`. **AWS CLI** **So synchronisieren Sie ein MFA-Gerät** Im folgenden `resync-mfa-device`-Beispiel wird das MFA-Gerät, das dem IAM-Benutzer `Bob`zugeordnet ist und dessen ARN `arn:aws:iam::123456789012:mfa/BobsMFADevice` ist, mit einem Authentifizierungsprogramm synchronisiert, das die beiden Authentifizierungscodes bereitgestellt hat. ``` aws iam resync-mfa-device \ --user-name Bob \ --serial-number arn:aws:iam::210987654321:mfa/BobsMFADevice \ --authentication-code1 123456 \ --authentication-code2 987654 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden der Multi-Faktor-Authentifizierung (MFA) in AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ResyncMfaDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/resync-mfa-device.html)in der *AWS CLI Befehlsreferenz*. ### `set-default-policy-version` Das folgende Codebeispiel zeigt die Verwendung`set-default-policy-version`. **AWS CLI** **So legen Sie die angegebene Version der angegebenen Richtlinie als standardmäßige Version der Richtlinie fest.** In diesem Beispiel wird die `v2`-Version der Richtlinie, deren ARN `arn:aws:iam::123456789012:policy/MyPolicy` lautet, als standardmäßig aktive Version festgelegt. ``` aws iam set-default-policy-version \ --policy-arn arn:aws:iam::123456789012:policy/MyPolicy \ --version-id v2 ``` Weitere Informationen finden Sie unter [Richtlinien und Berechtigungen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [SetDefaultPolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/set-default-policy-version.html)in der *AWS CLI Befehlsreferenz*. ### `set-security-token-service-preferences` Das folgende Codebeispiel zeigt die Verwendung`set-security-token-service-preferences`. **AWS CLI** **So legen Sie die Tokenversion des globalen Endpunkts fest** Im folgenden Beispiel für `set-security-token-service-preferences` wird Amazon STS so konfiguriert, dass bei der Authentifizierung am globalen Endpunkt Token der Version 2 verwendet werden. ``` aws iam set-security-token-service-preferences \ --global-endpoint-token-version v2Token ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [im *AWS IAM-Benutzerhandbuch* unter AWS STS in einer AWS Region verwalten](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html). + Einzelheiten zur API finden Sie unter [SetSecurityTokenServicePreferences AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/set-security-token-service-preferences.html)*Befehlsreferenz.* ### `simulate-custom-policy` Das folgende Codebeispiel zeigt die Verwendung`simulate-custom-policy`. **AWS CLI** **Beispiel 1: So simulieren Sie die Auswirkungen aller IAM-Richtlinien, die einem IAM-Benutzer oder einer IAM-Rolle zugeordnet sind** In der folgenden `simulate-custom-policy` wird gezeigt, wie Sie sowohl die Richtlinie angeben als auch Variablenwerte definieren und einen API-Aufruf simulieren, um festzustellen, ob er zulässig ist oder verweigert wird. Das folgende Beispiel zeigt eine Richtlinie, die den Datenbankzugriff erst nach einem angegebenen Datum und einer angegebenen Uhrzeit ermöglicht. Die Simulation ist erfolgreich, weil alle simulierten Aktionen und die angegebene Variable für `aws:CurrentTime` den Anforderungen der Richtlinie entsprechen. ``` aws iam simulate-custom-policy \ --policy-input-list '{"Version":"2012-10-17", "Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"*","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2018-08-16T12:00:00Z"}}}}' \ --action-names dynamodb:CreateBackup \ --context-entries "ContextKeyName='aws:CurrentTime',ContextKeyValues='2019-04-25T11:00:00Z',ContextKeyType=date" ``` Ausgabe: ``` { "EvaluationResults": [ { "EvalActionName": "dynamodb:CreateBackup", "EvalResourceName": "*", "EvalDecision": "allowed", "MatchedStatements": [ { "SourcePolicyId": "PolicyInputList.1", "StartPosition": { "Line": 1, "Column": 38 }, "EndPosition": { "Line": 1, "Column": 167 } } ], "MissingContextValues": [] } ] } ``` **Beispiel 2: So simulieren Sie einen Befehl, der durch die Richtlinie verboten ist** Das folgende Beispiel für `simulate-custom-policy` zeigt die Ergebnisse der Simulation eines Befehls, der durch die Richtlinie verboten ist. In diesem Beispiel liegt das angegebene Datum vor dem Datum, das gemäß der Richtlinienbedingung gewählt werden sollte. ``` aws iam simulate-custom-policy \ --policy-input-list '{"Version":"2012-10-17", "Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"*","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2018-08-16T12:00:00Z"}}}}' \ --action-names dynamodb:CreateBackup \ --context-entries "ContextKeyName='aws:CurrentTime',ContextKeyValues='2014-04-25T11:00:00Z',ContextKeyType=date" ``` Ausgabe: ``` { "EvaluationResults": [ { "EvalActionName": "dynamodb:CreateBackup", "EvalResourceName": "*", "EvalDecision": "implicitDeny", "MatchedStatements": [], "MissingContextValues": [] } ] } ``` Weitere Informationen finden Sie unter [Testen von IAM-Richtlinien mit dem IAM-Richtliniensimulator](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_testing-policies.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [SimulateCustomPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/simulate-custom-policy.html)in der *AWS CLI Befehlsreferenz*. ### `simulate-principal-policy` Das folgende Codebeispiel zeigt die Verwendung`simulate-principal-policy`. **AWS CLI** **Beispiel 1: So simulieren Sie die Auswirkungen einer beliebigen IAM-Richtlinie** In der folgenden `simulate-principal-policy` wird gezeigt, wie simuliert wird, dass ein Benutzer eine API-Aktion aufruft und ermittelt, ob die diesem Benutzer zugewiesenen Richtlinien die Aktion zulassen oder verweigern. Im folgenden Beispiel hat der Benutzer eine Richtlinie, die nur die Aktion `codecommit:ListRepositories` zulässt. ``` aws iam simulate-principal-policy \ --policy-source-arn arn:aws:iam::123456789012:user/alejandro \ --action-names codecommit:ListRepositories ``` Ausgabe: ``` { "EvaluationResults": [ { "EvalActionName": "codecommit:ListRepositories", "EvalResourceName": "*", "EvalDecision": "allowed", "MatchedStatements": [ { "SourcePolicyId": "Grant-Access-To-CodeCommit-ListRepo", "StartPosition": { "Line": 3, "Column": 19 }, "EndPosition": { "Line": 9, "Column": 10 } } ], "MissingContextValues": [] } ] } ``` **Beispiel 2: So simulieren Sie die Auswirkungen eines verbotenen Befehls** Das folgende Beispiel für `simulate-custom-policy` zeigt die Ergebnisse der Simulation eines Befehls, der durch eine der Richtlinien des Benutzers verboten ist. Im folgenden Beispiel verfügt der Benutzer über eine Richtlinie, die den Zugriff auf eine DynamoDB-Datenbank erst nach einem bestimmten Datum und einer bestimmten Uhrzeit erlaubt. Bei der Simulation versucht der Benutzer, mit einem Wert für `aws:CurrentTime` auf die Datenbank zuzugreifen, der vor der Bedingung der Richtlinie liegt. ``` aws iam simulate-principal-policy \ --policy-source-arn arn:aws:iam::123456789012:user/alejandro \ --action-names dynamodb:CreateBackup \ --context-entries "ContextKeyName='aws:CurrentTime',ContextKeyValues='2018-04-25T11:00:00Z',ContextKeyType=date" ``` Ausgabe: ``` { "EvaluationResults": [ { "EvalActionName": "dynamodb:CreateBackup", "EvalResourceName": "*", "EvalDecision": "implicitDeny", "MatchedStatements": [], "MissingContextValues": [] } ] } ``` Weitere Informationen finden Sie unter [Testen von IAM-Richtlinien mit dem IAM-Richtliniensimulator](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_testing-policies.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [SimulatePrincipalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/simulate-principal-policy.html)in der *AWS CLI Befehlsreferenz*. ### `tag-instance-profile` Das folgende Codebeispiel zeigt die Verwendung`tag-instance-profile`. **AWS CLI** **So fügen Sie ein Tag zu einem Instance-Profil hinzu** Der folgende `tag-instance-profile`-Befehl fügt dem angegebenen Instance-Profil ein Tag mit einem Abteilungsnamen hinzu. ``` aws iam tag-instance-profile \ --instance-profile-name deployment-role \ --tags '[{"Key": "Department", "Value": "Accounting"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [TagInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/tag-instance-profile.html)in der *AWS CLI Befehlsreferenz*. ### `tag-mfa-device` Das folgende Codebeispiel zeigt die Verwendung`tag-mfa-device`. **AWS CLI** **So fügen Sie einem MFA-Gerät ein Tag hinzu** Der folgende `tag-mfa-device`-Befehl fügt dem angegebenen MFA-Gerät ein Tag mit einem Abteilungsnamen hinzu. ``` aws iam tag-mfa-device \ --serial-number arn:aws:iam::123456789012:mfa/alice \ --tags '[{"Key": "Department", "Value": "Accounting"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [TagMfaDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/tag-mfa-device.html)in der *AWS CLI Befehlsreferenz*. ### `tag-open-id-connect-provider` Das folgende Codebeispiel zeigt die Verwendung`tag-open-id-connect-provider`. **AWS CLI** **So fügen Sie ein Tag einem Identitätsanbieter hinzu, der mit OpenID Connect (OIDC) kompatibel ist** Der folgende `tag-open-id-connect-provider`-Befehl fügt dem angegebenen OIDC-Identitätsanbieter ein Tag mit einem Abteilungsnamen hinzu. ``` aws iam tag-open-id-connect-provider \ --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/server.example.com \ --tags '[{"Key": "Department", "Value": "Accounting"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [TagOpenIdConnectProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/tag-open-id-connect-provider.html)in der *AWS CLI Befehlsreferenz*. ### `tag-policy` Das folgende Codebeispiel zeigt die Verwendung`tag-policy`. **AWS CLI** **So fügen Sie einer vom Kunden verwalteten Richtlinie ein Tag hinzu** Der folgende `tag-policy`-Befehl fügt der angegebenen vom Kunden verwalteten Richtlinie ein Tag mit einem Abteilungsnamen hinzu. ``` aws iam tag-policy \ --policy-arn arn:aws:iam::123456789012:policy/billing-access \ --tags '[{"Key": "Department", "Value": "Accounting"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [TagPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/tag-policy.html)in der *AWS CLI Befehlsreferenz*. ### `tag-role` Das folgende Codebeispiel zeigt die Verwendung`tag-role`. **AWS CLI** **So fügen Sie einer Rolle ein Tag hinzu** Der folgende `tag-role`-Befehl fügt der angegebenen Rolle ein Tag mit einem Abteilungsnamen hinzu. ``` aws iam tag-role --role-name my-role \ --tags '{"Key": "Department", "Value": "Accounting"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [TagRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/tag-role.html)in der *AWS CLI Befehlsreferenz*. ### `tag-saml-provider` Das folgende Codebeispiel zeigt die Verwendung`tag-saml-provider`. **AWS CLI** **So fügen Sie einem SAML-Anbieter ein Tag hinzu** Der folgende `tag-saml-provider`-Befehl fügt dem angegebenen SAML-Anbieter ein Tag mit einem Abteilungsnamen hinzu. ``` aws iam tag-saml-provider \ --saml-provider-arn arn:aws:iam::123456789012:saml-provider/ADFS \ --tags '[{"Key": "Department", "Value": "Accounting"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [TagSamlProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/tag-saml-provider.html)in der *AWS CLI Befehlsreferenz*. ### `tag-server-certificate` Das folgende Codebeispiel zeigt die Verwendung`tag-server-certificate`. **AWS CLI** **So fügen Sie einem Serverzertifikat ein Tag zu** Der folgende `tag-saml-provider`-Befehl fügt dem angegebenen Serverzertifikat ein Tag mit einem Abteilungsnamen hinzu. ``` aws iam tag-server-certificate \ --server-certificate-name ExampleCertificate \ --tags '[{"Key": "Department", "Value": "Accounting"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [TagServerCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/tag-server-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `tag-user` Das folgende Codebeispiel zeigt die Verwendung`tag-user`. **AWS CLI** **So fügen Sie einem Benutzer ein Tag hinzu** Der folgende `tag-user`-Befehl fügt dem angegebenen Benutzer ein Tag mit der zugehörigen Abteilung hinzu. ``` aws iam tag-user \ --user-name alice \ --tags '{"Key": "Department", "Value": "Accounting"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [TagUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/tag-user.html)in der *AWS CLI Befehlsreferenz*. ### `untag-instance-profile` Das folgende Codebeispiel zeigt die Verwendung`untag-instance-profile`. **AWS CLI** **So entfernen Sie ein Tag aus einem Instance-Profil** Der folgende `untag-instance-profile`-Befehl entfernt alle Tags mit dem Schlüsselnamen „Abteilung“ aus dem angegebenen Instance-Profil. ``` aws iam untag-instance-profile \ --instance-profile-name deployment-role \ --tag-keys Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [UntagInstanceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/untag-instance-profile.html)in der *AWS CLI Befehlsreferenz*. ### `untag-mfa-device` Das folgende Codebeispiel zeigt die Verwendung`untag-mfa-device`. **AWS CLI** **So entfernen Sie ein Tag von einem MFA-Gerät** Der folgende `untag-mfa-device`-Befehl entfernt alle Tags mit dem Schlüsselnamen „Abteilung“ vom angegebenen MFA-Gerät. ``` aws iam untag-mfa-device \ --serial-number arn:aws:iam::123456789012:mfa/alice \ --tag-keys Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [UntagMfaDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/untag-mfa-device.html)in der *AWS CLI Befehlsreferenz*. ### `untag-open-id-connect-provider` Das folgende Codebeispiel zeigt die Verwendung`untag-open-id-connect-provider`. **AWS CLI** **So entfernen Sie ein Tag von einem OIDC-Identitätsanbieter** Der folgende `untag-open-id-connect-provider`-Befehl entfernt alle Tags mit dem Schlüsselnamen „Abteilung“ vom angegebenen OIDC-Identitätsanbieter. ``` aws iam untag-open-id-connect-provider \ --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/server.example.com \ --tag-keys Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [UntagOpenIdConnectProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/untag-open-id-connect-provider.html)in der *AWS CLI Befehlsreferenz*. ### `untag-policy` Das folgende Codebeispiel zeigt die Verwendung`untag-policy`. **AWS CLI** **So entfernen Sie ein Tag von einer vom Kunden verwalteten Richtlinie** Der folgende `untag-policy`-Befehl entfernt alle Tags mit dem Schlüsselnamen „Abteilung“ aus der angegebenen vom Kunden verwalteten Richtlinie. ``` aws iam untag-policy \ --policy-arn arn:aws:iam::452925170507:policy/billing-access \ --tag-keys Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [UntagPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/untag-policy.html)in der *AWS CLI Befehlsreferenz*. ### `untag-role` Das folgende Codebeispiel zeigt die Verwendung`untag-role`. **AWS CLI** **So entfernen Sie ein Tag aus einer Rolle** Der folgende `untag-role`-Befehl entfernt alle Tags mit dem Schlüsselnamen „Abteilung“ aus der angegebenen Rolle. ``` aws iam untag-role \ --role-name my-role \ --tag-keys Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [UntagRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/untag-role.html)in der *AWS CLI Befehlsreferenz*. ### `untag-saml-provider` Das folgende Codebeispiel zeigt die Verwendung`untag-saml-provider`. **AWS CLI** **So entfernen Sie ein Tag von einem SAML-Anbieter** Der folgende `untag-saml-provider`-Befehl entfernt alle Tags mit dem Schlüsselnamen „Abteilung“ aus dem angegebenen Instance-Profil. ``` aws iam untag-saml-provider \ --saml-provider-arn arn:aws:iam::123456789012:saml-provider/ADFS \ --tag-keys Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [UntagSamlProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/untag-saml-provider.html)in der *AWS CLI Befehlsreferenz*. ### `untag-server-certificate` Das folgende Codebeispiel zeigt die Verwendung`untag-server-certificate`. **AWS CLI** **So entfernen Sie ein Tag aus einem Serverzertifikat** Der folgende `untag-server-certificate`-Befehl entfernt alle Tags mit dem Schlüsselnamen „Abteilung“ aus dem angegebenen Serverzertifikat. ``` aws iam untag-server-certificate \ --server-certificate-name ExampleCertificate \ --tag-keys Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [UntagServerCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/untag-server-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `untag-user` Das folgende Codebeispiel zeigt die Verwendung`untag-user`. **AWS CLI** **So entfernen Sie ein Tag von einem Benutzer** Der folgende `untag-user`-Befehl entfernt alle Tags mit dem Schlüsselnamen „Abteilung“ vom angegebenen Benutzer. ``` aws iam untag-user \ --user-name alice \ --tag-keys Department ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *Handbuch zu AWS -IAM-Benutzer*. + Einzelheiten zur API finden Sie [UntagUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/untag-user.html)in der *AWS CLI Befehlsreferenz*. ### `update-access-key` Das folgende Codebeispiel zeigt die Verwendung`update-access-key`. **AWS CLI** **So aktivieren oder deaktivieren Sie einen Zugriffsschlüssel für einen IAM-Benutzer** Mit dem folgenden `update-access-key`-Befehl wird der angegebene Zugriffsschlüssel (Zugriffsschlüssel-ID und geheimer Zugriffsschlüssel) für den IAM-Benutzer mit dem Namen `Bob` deaktiviert. ``` aws iam update-access-key \ --access-key-id AKIAIOSFODNN7EXAMPLE \ --status Inactive \ --user-name Bob ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Das Deaktivieren des Schlüssels bedeutet, dass er nicht für den programmatischen Zugriff auf verwendet werden kann. AWS Der Schlüssel ist jedoch weiterhin verfügbar und kann erneut aktiviert werden. Weitere Informationen finden Sie unter [Verwalten der Zugriffsschlüssel für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateAccessKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-access-key.html)in der *AWS CLI Befehlsreferenz*. ### `update-account-password-policy` Das folgende Codebeispiel zeigt die Verwendung`update-account-password-policy`. **AWS CLI** **So legen Sie die aktuelle Passwortrichtlinie für Konten fest oder ändern diese** Der folgende `update-account-password-policy`-Befehl legt die Passwortrichtlinie so fest, dass eine Mindestlänge von acht Zeichen und eine oder mehrere Zahlen im Passwort erforderlich sind. ``` aws iam update-account-password-policy \ --minimum-password-length 8 \ --require-numbers ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Änderungen an der Passwortrichtlinie eines Kontos wirken sich auf alle neuen Passwörter aus, die für IAM-Benutzer im Konto erstellt werden. Änderungen der Passwortrichtlinie wirken sich nicht auf bestehende Passwörter aus. Weitere Informationen finden Sie unter [Festlegen einer Kontopasswortrichtlinie für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_account-policy.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateAccountPasswordPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-account-password-policy.html)in der *AWS CLI Befehlsreferenz*. ### `update-assume-role-policy` Das folgende Codebeispiel zeigt die Verwendung`update-assume-role-policy`. **AWS CLI** **So aktualisieren Sie die Vertrauensrichtlinie für eine IAM-Rolle** Der folgende `update-assume-role-policy`-Befehl aktualisiert die Vertrauensrichtlinie für die Rolle mit dem Namen `Test-Role`. ``` aws iam update-assume-role-policy \ --role-name Test-Role \ --policy-document file://Test-Role-Trust-Policy.json ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Die Vertrauensrichtlinie ist als JSON-Dokument in der Datei *Test-Role-Trust-Policy.json* definiert. (Der Dateiname und die Erweiterung sind nicht von Bedeutung.) Die Vertrauensrichtlinie muss einen Prinzipal angeben. Um die Berechtigungsrichtlinie für eine Rolle zu aktualisieren, verwenden Sie den `put-role-policy`-Befehl. Weitere Informationen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateAssumeRolePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-assume-role-policy.html)in der *AWS CLI Befehlsreferenz*. ### `update-group` Das folgende Codebeispiel zeigt die Verwendung`update-group`. **AWS CLI** **So benennen Sie eine IAM-Gruppe um** Mit dem folgenden `update-group`-Befehl wird der Name der IAM-Gruppe `Test` in `Test-1` verändert. ``` aws iam update-group \ --group-name Test \ --new-group-name Test-1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Umbenennen einer IAM-Benutzergruppe](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage_rename.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-group.html)in der *AWS CLI Befehlsreferenz*. ### `update-login-profile` Das folgende Codebeispiel zeigt die Verwendung`update-login-profile`. **AWS CLI** **So aktualisieren Sie das Passwort für einen IAM-Benutzer** Der folgende `update-login-profile`-Befehl erstellt ein neues Passwort für den IAM-Benutzer mit dem Namen `Bob`. ``` aws iam update-login-profile \ --user-name Bob \ --password ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um eine Passwortrichtlinie für das Konto festzulegen, verwenden Sie den `update-account-password-policy`-Befehl. Wenn das neue Passwort gegen die Passwortrichtlinie des Kontos verstößt, gibt der Befehl einen `PasswordPolicyViolation`-Fehler zurück. Sofern die Passwortrichtlinie des Kontos dies zulässt, können IAM-Benutzer mit dem `change-password`-Befehl ihre eigenen Passwörter ändern. Speichern Sie das Passwort an einem sicheren Ort. Bei Verlust des Passwortes ist eine Wiederherstellung nicht möglich und Sie müssen mit dem Befehl `create-login-profile` ein neues Passwort erstellen. Weitere Informationen finden Sie unter [Verwalten von Passwörtern für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_admin-change-user.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateLoginProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-login-profile.html)in der *AWS CLI Befehlsreferenz*. ### `update-open-id-connect-provider-thumbprint` Das folgende Codebeispiel zeigt die Verwendung`update-open-id-connect-provider-thumbprint`. **AWS CLI** **So ersetzen Sie die vorhandene Liste der Serverzertifikat-Fingerabdrücke durch eine neue Liste** In diesem Beispiel wird die Liste der Zertifikat-Fingerabdrücke für den OIDC-Anbieter aktualisiert, dessen ARN `arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com` lautet, um einen neuen Fingerabdruck zu verwenden. ``` aws iam update-open-id-connect-provider-thumbprint \ --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com \ --thumbprint-list 7359755EXAMPLEabc3060bce3EXAMPLEec4542a3 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen von OpenID Connect (OIDC)-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateOpenIdConnectProviderThumbprint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-open-id-connect-provider-thumbprint.html)in der *AWS CLI Befehlsreferenz*. ### `update-role-description` Das folgende Codebeispiel zeigt die Verwendung`update-role-description`. **AWS CLI** **So ändern Sie die Beschreibung einer IAM-Rolle** Der folgende `update-role`-Befehl ändert die Beschreibung der IAM-Rolle `production-role` in `Main production role`. ``` aws iam update-role-description \ --role-name production-role \ --description 'Main production role' ``` Ausgabe: ``` { "Role": { "Path": "/", "RoleName": "production-role", "RoleId": "AROA1234567890EXAMPLE", "Arn": "arn:aws:iam::123456789012:role/production-role", "CreateDate": "2017-12-06T17:16:37+00:00", "AssumeRolePolicyDocument": { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::123456789012:root" }, "Action": "sts:AssumeRole", "Condition": {} } ] }, "Description": "Main production role" } } ``` Weitere Informationen finden Sie unter [Ändern einer Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateRoleDescription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-role-description.html)in der *AWS CLI Befehlsreferenz*. ### `update-role` Das folgende Codebeispiel zeigt die Verwendung`update-role`. **AWS CLI** **So ändern Sie die Beschreibung oder Sitzungsdauer einer IAM-Rolle** Mit dem folgenden `update-role`-Befehl wird die Beschreibung der IAM-Rolle `production-role` in `Main production role` geändert und die maximale Sitzungsdauer auf 12 Stunden festgelegt. ``` aws iam update-role \ --role-name production-role \ --description 'Main production role' \ --max-session-duration 43200 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ändern einer Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-role.html)in der *AWS CLI Befehlsreferenz*. ### `update-saml-provider` Das folgende Codebeispiel zeigt die Verwendung`update-saml-provider`. **AWS CLI** **So aktualisieren Sie das Metadatendokument für einen vorhandenen SAML-Anbieter** In diesem Beispiel wird der SAML-Anbieter in IAM, dessen ARN `arn:aws:iam::123456789012:saml-provider/SAMLADFS` lautet, mit einem neuen SAML-Metadatendokument aus der Datei `SAMLMetaData.xml` aktualisiert. ``` aws iam update-saml-provider \ --saml-metadata-document file://SAMLMetaData.xml \ --saml-provider-arn arn:aws:iam::123456789012:saml-provider/SAMLADFS ``` Ausgabe: ``` { "SAMLProviderArn": "arn:aws:iam::123456789012:saml-provider/SAMLADFS" } ``` Weitere Informationen finden Sie unter [Erstellen von IAM-SAML-Identitätsanbietern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_saml.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateSamlProvider](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-saml-provider.html)in der *AWS CLI Befehlsreferenz*. ### `update-server-certificate` Das folgende Codebeispiel zeigt die Verwendung`update-server-certificate`. **AWS CLI** **Um den Pfad oder Namen eines Serverzertifikats in Ihrem AWS Konto zu ändern** Mit dem folgenden `update-server-certificate`-Befehl wird der Name des Zertifikats von `myServerCertificate` in `myUpdatedServerCertificate` geändert. Außerdem wird der Pfad geändert, `/cloudfront/` sodass der CloudFront Amazon-Service darauf zugreifen kann. Mit diesem Befehl wird keine Ausgabe zurückgegeben. Sie können die Ergebnisse der Aktualisierung anzeigen, indem Sie den `list-server-certificates`-Befehl ausführen. ``` aws-iam update-server-certificate \ --server-certificate-name myServerCertificate \ --new-server-certificate-name myUpdatedServerCertificate \ --new-path /cloudfront/ ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwaltung von Serverzertifikaten in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateServerCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-server-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `update-service-specific-credential` Das folgende Codebeispiel zeigt die Verwendung`update-service-specific-credential`. **AWS CLI** **Beispiel 1: So aktualisieren Sie den Status der servicespezifischen Anmeldeinformationen des anfragenden Benutzers** Im folgenden Beispiel für `update-service-specific-credential` wird der Status der angegebenen Anmeldeinformationen für den Benutzer, der die Anfrage stellt, in `Inactive` geändert. ``` aws iam update-service-specific-credential \ --service-specific-credential-id ACCAEXAMPLE123EXAMPLE \ --status Inactive ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So aktualisieren Sie den Status der servicespezifischen Anmeldeinformationen eines angegebenen Benutzers** Im folgenden Beispiel für `update-service-specific-credential` wird der Status der Anmeldeinformationen des angegebenen Benutzers in „Inaktiv“ geändert. ``` aws iam update-service-specific-credential \ --user-name sofia \ --service-specific-credential-id ACCAEXAMPLE123EXAMPLE \ --status Inactive ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Git-Anmeldeinformationen für HTTPS-Verbindungen erstellen CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam) im *AWS CodeCommit Benutzerhandbuch* + Einzelheiten zur API finden Sie [UpdateServiceSpecificCredential](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-service-specific-credential.html)in der *AWS CLI Befehlsreferenz*. ### `update-signing-certificate` Das folgende Codebeispiel zeigt die Verwendung`update-signing-certificate`. **AWS CLI** **So aktivieren oder deaktivieren Sie ein Signaturzertifikat für einen IAM-Benutzer** Der folgende `update-signing-certificate`-Befehl deaktiviert das angegebene Signaturzertifikat für den IAM-Benutzer mit dem Namen `Bob`. ``` aws iam update-signing-certificate \ --certificate-id TA7SMP42TDN5Z26OBPJE7EXAMPLE \ --status Inactive \ --user-name Bob ``` Verwenden Sie den `list-signing-certificates`-Befehl, um die ID für ein Signaturzertifikat abzurufen. Weitere Informationen finden Sie unter [Verwaltung von Signaturzertifikaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-up-ami-tools.html#ami-tools-managing-certs) im *Benutzerhandbuch für Amazon EC2.* + Einzelheiten zur API finden Sie [UpdateSigningCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-signing-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `update-ssh-public-key` Das folgende Codebeispiel zeigt die Verwendung`update-ssh-public-key`. **AWS CLI** **So ändern Sie den Status eines öffentlichen SSH-Schlüssels** Der folgende `update-ssh-public-key`-Befehl ändert den Status des angegebenen öffentlichen Schlüssels in`Inactive`. ``` aws iam update-ssh-public-key \ --user-name sofia \ --ssh-public-key-id APKA1234567890EXAMPLE \ --status Inactive ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [SSH-Schlüssel und SSH mit verwenden CodeCommit](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html#ssh-keys-code-commit) im *AWS IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [UpdateSshPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-ssh-public-key.html)in AWS CLI der Befehlsreferenz.* ### `update-user` Das folgende Codebeispiel zeigt die Verwendung`update-user`. **AWS CLI** **So ändern Sie den Namen eines IAM-Benutzers** Mit dem folgenden `update-user`-Befehl wird der Name des IAM-Benutzers `Bob` in `Robert` geändert. ``` aws iam update-user \ --user-name Bob \ --new-user-name Robert ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Umbenennen einer IAM-Benutzergruppe](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage_rename.html) im *AWS -IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-user.html)in der *AWS CLI Befehlsreferenz*. ### `upload-server-certificate` Das folgende Codebeispiel zeigt die Verwendung`upload-server-certificate`. **AWS CLI** **Um ein Serverzertifikat auf Ihr AWS Konto hochzuladen** Mit dem folgenden **upload-server-certificate**Befehl wird ein Serverzertifikat auf Ihr AWS Konto hochgeladen. In diesem Beispiel befindet sich das Zertifikat in der Datei `public_key_cert_file.pem`, der zugehörige private Schlüssel in der Datei `my_private_key.pem` und die von der Zertifizierungsstelle (CA) bereitgestellte Zertifikatskette befindet sich in der `my_certificate_chain_file.pem`-Datei. Wenn der Upload der Datei abgeschlossen ist, ist sie unter dem Namen verfügbar. *myServerCertificate* Parameter, die mit `file://` beginnen, weisen den Befehl an, den Inhalt der Datei zu lesen und diesen als Parameterwert anstelle des Dateinamens selbst zu verwenden. ``` aws iam upload-server-certificate \ --server-certificate-name myServerCertificate \ --certificate-body file://public_key_cert_file.pem \ --private-key file://my_private_key.pem \ --certificate-chain file://my_certificate_chain_file.pem ``` Ausgabe: ``` { "ServerCertificateMetadata": { "Path": "/", "ServerCertificateName": "myServerCertificate", "ServerCertificateId": "ASCAEXAMPLE123EXAMPLE", "Arn": "arn:aws:iam::1234567989012:server-certificate/myServerCertificate", "UploadDate": "2019-04-22T21:13:44+00:00", "Expiration": "2019-10-15T22:23:16+00:00" } } ``` Weitere Informationen finden Sie unter Erstellen, Hochladen und Löschen von Serverzertifikaten im Handbuch zur *Verwendung von IAM*. + Einzelheiten zur API finden Sie [UploadServerCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/upload-server-certificate.html)in der *AWS CLI Befehlsreferenz.* ### `upload-signing-certificate` Das folgende Codebeispiel zeigt die Verwendung`upload-signing-certificate`. **AWS CLI** **So laden Sie ein Signaturzertifikat für einen IAM-Benutzer hoch** Mit dem folgenden `upload-signing-certificate`-Befehl wird ein Signaturzertifikat für den IAM-Benutzer mit dem Namen `Bob` hochgeladen. ``` aws iam upload-signing-certificate \ --user-name Bob \ --certificate-body file://certificate.pem ``` Ausgabe: ``` { "Certificate": { "UserName": "Bob", "Status": "Active", "CertificateBody": "-----BEGIN CERTIFICATE----------END CERTIFICATE-----", "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE", "UploadDate": "2013-06-06T21:40:08.121Z" } } ``` Das Zertifikat befindet sich in einer Datei mit dem Namen *certificate.pem* im PEM-Format. Weitere Informationen finden Sie unter „Erstellen und Hochladen eines Benutzersignaturzertifikats“ im Handbuch *Verwendung von IAM*. + Einzelheiten zur API finden Sie [UploadSigningCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/upload-signing-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `upload-ssh-public-key` Das folgende Codebeispiel zeigt die Verwendung`upload-ssh-public-key`. **AWS CLI** **So laden Sie einen öffentlichen SSH-Schlüssel hoch und ordnen ihn einem Benutzer zu** Mit dem folgenden `upload-ssh-public-key`-Befehl wird der in der Datei `sshkey.pub` gefundene öffentliche Schlüssel hochgeladen und an den Benutzer `sofia` angehängt. ``` aws iam upload-ssh-public-key \ --user-name sofia \ --ssh-public-key-body file://sshkey.pub ``` Ausgabe: ``` { "SSHPublicKey": { "UserName": "sofia", "SSHPublicKeyId": "APKA1234567890EXAMPLE", "Fingerprint": "12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef", "SSHPublicKeyBody": "ssh-rsa <>", "Status": "Active", "UploadDate": "2019-04-18T17:04:49+00:00" } } ``` Weitere Informationen zum Generieren von Schlüsseln in einem für diesen Befehl geeigneten Format finden Sie unter [SSH und Linux, macOS oder Unix: Einrichten der öffentlichen und privaten Schlüssel für Git](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-ssh-unixes.html#setting-up-ssh-unixes-keys) und/oder [SSH und Windows: Richten Sie die öffentlichen und privaten Schlüssel für Git ein und CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-ssh-windows.html#setting-up-ssh-windows-keys-windows) im *AWS CodeCommit Benutzerhandbuch*. CodeCommit + Einzelheiten zur API finden Sie [UploadSshPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/upload-ssh-public-key.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für IAM Access Analyzer mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit dem IAM Access Analyzer Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `apply-archive-rule` Das folgende Codebeispiel zeigt, wie Sie`apply-archive-rule`. **AWS CLI** **So wenden Sie eine Archivierungsregel auf vorhandene Erkenntnisse an, die den Archivregelkriterien entsprechen** Im folgenden Beispiel für `apply-archive-rule` wird eine Archivierungsregel auf vorhandene Erkenntnisse angewendet, die den Archivregelkriterien entsprechen. ``` aws accessanalyzer apply-archive-rule \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/UnusedAccess-ConsoleAnalyzer-organization \ --rule-name MyArchiveRule ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Archivierungsregeln](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-archive-rules.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [ApplyArchiveRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/apply-archive-rule.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-policy-generation` Das folgende Codebeispiel zeigt die Verwendung`cancel-policy-generation`. **AWS CLI** **So stornieren Sie die angeforderte Richtliniengenerierung** Im folgenden Beispiel für `cancel-policy-generation` wird die Auftrags-ID für die angeforderte Richtliniengenerierung storniert. ``` aws accessanalyzer cancel-policy-generation \ --job-id 923a56b0-ebb8-4e80-8a3c-a11ccfbcd6f2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Richtliniengenerierung von IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-generation.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [CancelPolicyGeneration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/cancel-policy-generation.html)in der *AWS CLI Befehlsreferenz*. ### `check-access-not-granted` Das folgende Codebeispiel zeigt die Verwendung`check-access-not-granted`. **AWS CLI** **So überprüfen Sie, ob der angegebene Zugriff durch eine Richtlinie nicht zulässig ist** Im folgenden Beispiel für `check-access-not-granted` wird überprüft, ob der angegebene Zugriff durch eine Richtlinie nicht zulässig ist. ``` aws accessanalyzer check-access-not-granted \ --policy-document file://myfile.json \ --access actions="s3:DeleteBucket","s3:GetBucketLocation" \ --policy-type IDENTITY_POLICY ``` Inhalt von `myfile.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:GetObject", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket", "arn:aws:s3:::amzn-s3-demo-bucket/*" ] } ] } ``` Ausgabe: ``` { "result": "PASS", "message": "The policy document does not grant access to perform one or more of the listed actions." } ``` Weitere Informationen finden Sie unter [Vorschau des Zugriffs mit IAM Access Analyzer APIs](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-preview-access-apis.html) im *AWS IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [CheckAccessNotGranted](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/check-access-not-granted.html).AWS CLI * ### `check-no-new-access` Das folgende Codebeispiel zeigt die Verwendung`check-no-new-access`. **AWS CLI** **So überprüfen Sie, ob für eine aktualisierte Richtlinie im Vergleich zur vorhandenen Richtlinie neuer Zugriff gewährt wird** Im folgenden Beispiel für `check-no-new-access` wird überprüft, ob für eine aktualisierte Richtlinie im Vergleich zur vorhandenen Richtlinie neuer Zugriff gewährt wird. ``` aws accessanalyzer check-no-new-access \ --existing-policy-document file://existing-policy.json \ --new-policy-document file://new-policy.json \ --policy-type IDENTITY_POLICY ``` Inhalt von `existing-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:GetObject", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket", "arn:aws:s3:::amzn-s3-demo-bucket/*" ] } ] } ``` Inhalt von `new-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectAcl", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket", "arn:aws:s3:::amzn-s3-demo-bucket/*" ] } ] } ``` Ausgabe: ``` { "result": "FAIL", "message": "The modified permissions grant new access compared to your existing policy.", "reasons": [ { "description": "New access in the statement with index: 0.", "statementIndex": 0 } ] } ``` Weitere Informationen finden Sie unter [Vorschau des Zugriffs mit IAM Access Analyzer APIs](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-preview-access-apis.html) im *AWS IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [CheckNoNewAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/check-no-new-access.html).AWS CLI * ### `check-no-public-access` Das folgende Codebeispiel zeigt die Verwendung`check-no-public-access`. **AWS CLI** **So überprüfen Sie, ob eine Ressourcenrichtlinie öffentlichen Zugriff auf den angegebenen Ressourcentyp gewähren kann** Mit dem folgenden Beispiel für `check-no-public-access` wird überprüft, ob eine Ressourcenrichtlinie öffentlichen Zugriff auf den angegebenen Ressourcentyp gewähren kann. ``` aws accessanalyzer check-no-public-access \ --policy-document file://check-no-public-access-myfile.json \ --resource-type AWS::S3::Bucket ``` Inhalt von `myfile.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "CheckNoPublicAccess", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/JohnDoe" }, "Action": [ "s3:GetObject" ] } ] } ``` Ausgabe: ``` { "result": "PASS", "message": "The resource policy does not grant public access for the given resource type." } ``` Weitere Informationen finden Sie unter [Vorschau des Zugriffs mit IAM Access Analyzer APIs](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-preview-access-apis.html) im *AWS IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [CheckNoPublicAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/check-no-public-access.html).AWS CLI * ### `create-access-preview` Das folgende Codebeispiel zeigt die Verwendung`create-access-preview`. **AWS CLI** **So erstellen Sie eine Zugriffsvorschau, mit der Sie eine Vorschau der Erkenntnisse von IAM Access Analyzer für Ihre Ressource anzeigen können, bevor Sie Ressourcenberechtigungen bereitstellen** Im folgenden `create-access-preview` Beispiel wird eine Zugriffsvorschau erstellt, mit der Sie eine Vorschau der Ergebnisse von IAM Access Analyzer für Ihre Ressource anzeigen können, bevor Sie Ressourcenberechtigungen in Ihrem AWS Konto bereitstellen. ``` aws accessanalyzer create-access-preview \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account \ --configurations file://myfile.json ``` Inhalt von `myfile.json`: ``` { "arn:aws:s3:::amzn-s3-demo-bucket": { "s3Bucket": { "bucketPolicy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":[\"arn:aws:iam::111122223333:root\"]},\"Action\":[\"s3:PutObject\",\"s3:PutObjectAcl\"],\"Resource\":\"arn:aws:s3:::amzn-s3-demo-bucket/*\"}]}", "bucketPublicAccessBlock": { "ignorePublicAcls": true, "restrictPublicBuckets": true }, "bucketAclGrants": [ { "grantee": { "id": "79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be" }, "permission": "READ" } ] } } } ``` Ausgabe: ``` { "id": "3c65eb13-6ef9-4629-8919-a32043619e6b" } ``` Weitere Informationen finden Sie unter [Vorschau des Zugriffs mit IAM Access Analyzer APIs](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-preview-access-apis.html) im *AWS IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [CreateAccessPreview](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/create-access-preview.html).AWS CLI * ### `create-analyzer` Das folgende Codebeispiel zeigt die Verwendung`create-analyzer`. **AWS CLI** **Um einen Analyzer zu erstellen** Im folgenden `create-analyzer` Beispiel wird ein Analyzer in Ihrem AWS Konto erstellt. ``` aws accessanalyzer create-analyzer \ --analyzer-name example \ --type ACCOUNT ``` Ausgabe: ``` { "arn": "arn:aws:access-analyzer:us-east-2:111122223333:analyzer/example" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateAnalyzer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/create-analyzer.html)in der *AWS CLI Befehlsreferenz.* ### `create-archive-rule` Das folgende Codebeispiel zeigt die Verwendung`create-archive-rule`. **AWS CLI** **So erstellen Sie eine Archivierungsregel für den angegebenen Analysator** Im folgenden `create-archive-rule` Beispiel wird eine Archivierungsregel für den angegebenen Analyzer in Ihrem AWS Konto erstellt. ``` aws accessanalyzer create-archive-rule \ --analyzer-name UnusedAccess-ConsoleAnalyzer-organization \ --rule-name MyRule \ --filter '{"resource": {"contains": ["Cognito"]}, "resourceType": {"eq": ["AWS::IAM::Role"]}}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Archivierungsregeln](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-archive-rules.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [CreateArchiveRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/create-archive-rule.html)in der *AWS CLI Befehlsreferenz*. ### `delete-analyzer` Das folgende Codebeispiel zeigt die Verwendung`delete-analyzer`. **AWS CLI** **So löschen Sie den angegebenen Analysator** Das folgende `delete-analyzer` Beispiel löscht den angegebenen Analyzer in Ihrem AWS Konto. ``` aws accessanalyzer delete-analyzer \ --analyzer-name example ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Archivierungsregeln](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-archive-rules.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [DeleteAnalyzer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/delete-analyzer.html)in der *AWS CLI Befehlsreferenz.* ### `delete-archive-rule` Das folgende Codebeispiel zeigt die Verwendung`delete-archive-rule`. **AWS CLI** **So löschen Sie die angegebene Archivierungsregel** Das folgende `delete-archive-rule` Beispiel löscht die angegebene Archivierungsregel in Ihrem AWS Konto. ``` aws accessanalyzer delete-archive-rule \ --analyzer-name UnusedAccess-ConsoleAnalyzer-organization \ --rule-name MyRule ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Archivierungsregeln](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-archive-rules.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [DeleteArchiveRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/delete-archive-rule.html)in der *AWS CLI Befehlsreferenz.* ### `get-access-preview` Das folgende Codebeispiel zeigt die Verwendung`get-access-preview`. **AWS CLI** **So rufen Sie Informationen über eine Zugriffsvorschau für den angegebenen Analysator ab** Im folgenden `get-access-preview` Beispiel werden Informationen zu einer Zugriffsvorschau für den angegebenen Analyzer in Ihrem AWS Konto abgerufen. ``` aws accessanalyzer get-access-preview \ --access-preview-id 3c65eb13-6ef9-4629-8919-a32043619e6b \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account ``` Ausgabe: ``` { "accessPreview": { "id": "3c65eb13-6ef9-4629-8919-a32043619e6b", "analyzerArn": "arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account", "configurations": { "arn:aws:s3:::amzn-s3-demo-bucket": { "s3Bucket": { "bucketPolicy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":[\"arn:aws:iam::111122223333:root\"]},\"Action\":[\"s3:PutObject\",\"s3:PutObjectAcl\"],\"Resource\":\"arn:aws:s3:::amzn-s3-demo-bucket/*\"}]}", "bucketAclGrants": [ { "permission": "READ", "grantee": { "id": "79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be" } } ], "bucketPublicAccessBlock": { "ignorePublicAcls": true, "restrictPublicBuckets": true } } } }, "createdAt": "2024-02-17T00:18:44+00:00", "status": "COMPLETED" } } ``` Weitere Informationen finden Sie unter [Vorschau des Zugriffs mit IAM Access Analyzer APIs](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-preview-access-apis.html) im *AWS IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [GetAccessPreview](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/get-access-preview.html).AWS CLI * ### `get-analyzed-resource` Das folgende Codebeispiel zeigt die Verwendung`get-analyzed-resource`. **AWS CLI** **So rufen Sie Informationen über eine Ressource ab, die analysiert wurde** Im folgenden `get-analyzed-resource` Beispiel werden Informationen zu einer Ressource abgerufen, die in Ihrem AWS Konto analysiert wurde. ``` aws accessanalyzer get-analyzed-resource \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account \ --resource-arn arn:aws:s3:::amzn-s3-demo-bucket ``` Ausgabe: ``` { "resource": { "analyzedAt": "2024-02-15T18:01:53.002000+00:00", "isPublic": false, "resourceArn": "arn:aws:s3:::amzn-s3-demo-bucket", "resourceOwnerAccount": "111122223333", "resourceType": "AWS::S3::Bucket" } } ``` Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetAnalyzedResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/get-analyzed-resource.html)*Befehlsreferenz.* ### `get-analyzer` Das folgende Codebeispiel zeigt die Verwendung`get-analyzer`. **AWS CLI** **So rufen Sie Informationen über den angegebenen Analysator ab** Im folgenden `get-analyzer` Beispiel werden Informationen über den angegebenen Analyzer in Ihrem AWS Konto abgerufen. ``` aws accessanalyzer get-analyzer \ --analyzer-name ConsoleAnalyzer-account ``` Ausgabe: ``` { "analyzer": { "arn": "arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account", "createdAt": "2019-12-03T07:28:17+00:00", "lastResourceAnalyzed": "arn:aws:sns:us-west-2:111122223333:config-topic", "lastResourceAnalyzedAt": "2024-02-15T18:01:53.003000+00:00", "name": "ConsoleAnalyzer-account", "status": "ACTIVE", "tags": { "auto-delete": "no" }, "type": "ACCOUNT" } } ``` Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetAnalyzer AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/get-analyzer.html)*Befehlsreferenz.* ### `get-archive-rule` Das folgende Codebeispiel zeigt die Verwendung`get-archive-rule`. **AWS CLI** **So rufen Sie Informationen über eine Archivierungsregel ab** Im folgenden `get-archive-rule` Beispiel werden Informationen zu einer Archivierungsregel in Ihrem AWS Konto abgerufen. ``` aws accessanalyzer get-archive-rule \ --analyzer-name UnusedAccess-ConsoleAnalyzer-organization \ --rule-name MyArchiveRule ``` Ausgabe: ``` { "archiveRule": { "createdAt": "2024-02-15T00:49:27+00:00", "filter": { "resource": { "contains": [ "Cognito" ] }, "resourceType": { "eq": [ "AWS::IAM::Role" ] } }, "ruleName": "MyArchiveRule", "updatedAt": "2024-02-15T00:49:27+00:00" } } ``` Weitere Informationen finden Sie unter [Archivierungsregeln](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-archive-rules.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie unter [GetArchiveRule AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/get-archive-rule.html)*Befehlsreferenz.* ### `get-finding-v2` Das folgende Codebeispiel zeigt die Verwendung`get-finding-v2`. **AWS CLI** **So rufen Sie Informationen über die angegebene Erkenntnis ab** Im folgenden `get-finding-v2` Beispiel werden Informationen zu dem angegebenen Ergebnis in Ihrem AWS Konto abgerufen. ``` aws accessanalyzer get-finding-v2 \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-organization \ --id 0910eedb-381e-4e95-adda-0d25c19e6e90 ``` Ausgabe: ``` { "findingDetails": [ { "externalAccessDetails": { "action": [ "sts:AssumeRoleWithWebIdentity" ], "condition": { "cognito-identity.amazonaws.com:aud": "us-west-2:EXAMPLE0-0000-0000-0000-000000000000" }, "isPublic": false, "principal": { "Federated": "cognito-identity.amazonaws.com" } } } ], "resource": "arn:aws:iam::111122223333:role/Cognito_testpoolAuth_Role", "status": "ACTIVE", "error": null, "createdAt": "2021-02-26T21:17:50.905000+00:00", "resourceType": "AWS::IAM::Role", "findingType": "ExternalAccess", "resourceOwnerAccount": "111122223333", "analyzedAt": "2024-02-16T18:17:47.888000+00:00", "id": "0910eedb-381e-4e95-adda-0d25c19e6e90", "updatedAt": "2021-02-26T21:17:50.905000+00:00" } ``` Weitere Informationen finden Sie unter [Überprüfen von Erkenntnissen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-findings-view.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie unter [GetFindingV2](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/get-finding-v2.html) in der *AWS CLI Befehlsreferenz.* ### `get-finding` Das folgende Codebeispiel zeigt die Verwendung`get-finding`. **AWS CLI** **So rufen Sie Informationen über die angegebene Erkenntnis ab** Im folgenden `get-finding` Beispiel werden Informationen zu dem angegebenen Ergebnis in Ihrem AWS Konto abgerufen. ``` aws accessanalyzer get-finding \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-organization \ --id 0910eedb-381e-4e95-adda-0d25c19e6e90 ``` Ausgabe: ``` { "finding": { "id": "0910eedb-381e-4e95-adda-0d25c19e6e90", "principal": { "Federated": "cognito-identity.amazonaws.com" }, "action": [ "sts:AssumeRoleWithWebIdentity" ], "resource": "arn:aws:iam::111122223333:role/Cognito_testpoolAuth_Role", "isPublic": false, "resourceType": "AWS::IAM::Role", "condition": { "cognito-identity.amazonaws.com:aud": "us-west-2:EXAMPLE0-0000-0000-0000-000000000000" }, "createdAt": "2021-02-26T21:17:50.905000+00:00", "analyzedAt": "2024-02-16T18:17:47.888000+00:00", "updatedAt": "2021-02-26T21:17:50.905000+00:00", "status": "ACTIVE", "resourceOwnerAccount": "111122223333" } } ``` Weitere Informationen finden Sie unter [Überprüfen von Erkenntnissen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-findings-view.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie unter [GetFinding AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/get-finding.html)*Befehlsreferenz.* ### `get-generated-policy` Das folgende Codebeispiel zeigt die Verwendung`get-generated-policy`. **AWS CLI** **Um die Richtlinie abzurufen, die mit der StartPolicyGeneration ``-API generiert wurde** Im folgenden `get-generated-policy` Beispiel wird die Richtlinie abgerufen, die mithilfe der StartPolicyGeneration API in Ihrem AWS Konto generiert wurde. ``` aws accessanalyzer get-generated-policy \ --job-id c557dc4a-0338-4489-95dd-739014860ff9 ``` Ausgabe: ``` { "generatedPolicyResult": { "generatedPolicies": [ { "policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"SupportedServiceSid0\",\"Effect\":\"Allow\",\"Action\":[\"access-analyzer:GetAnalyzer\",\"access-analyzer:ListAnalyzers\",\"access-analyzer:ListArchiveRules\",\"access-analyzer:ListFindings\",\"cloudtrail:DescribeTrails\",\"cloudtrail:GetEventDataStore\",\"cloudtrail:GetEventSelectors\",\"cloudtrail:GetInsightSelectors\",\"cloudtrail:GetTrailStatus\",\"cloudtrail:ListChannels\",\"cloudtrail:ListEventDataStores\",\"cloudtrail:ListQueries\",\"cloudtrail:ListTags\",\"cloudtrail:LookupEvents\",\"ec2:DescribeRegions\",\"iam:GetAccountSummary\",\"iam:GetOpenIDConnectProvider\",\"iam:GetRole\",\"iam:ListAccessKeys\",\"iam:ListAccountAliases\",\"iam:ListOpenIDConnectProviders\",\"iam:ListRoles\",\"iam:ListSAMLProviders\",\"kms:ListAliases\",\"s3:GetBucketLocation\",\"s3:ListAllMyBuckets\"],\"Resource\":\"*\"}]}" } ], "properties": { "cloudTrailProperties": { "endTime": "2024-02-14T22:44:40+00:00", "startTime": "2024-02-13T00:30:00+00:00", "trailProperties": [ { "allRegions": true, "cloudTrailArn": "arn:aws:cloudtrail:us-west-2:111122223333:trail/my-trail", "regions": [] } ] }, "isComplete": false, "principalArn": "arn:aws:iam::111122223333:role/Admin" } }, "jobDetails": { "completedOn": "2024-02-14T22:47:01+00:00", "jobId": "c557dc4a-0338-4489-95dd-739014860ff9", "startedOn": "2024-02-14T22:44:41+00:00", "status": "SUCCEEDED" } } ``` Weitere Informationen finden Sie unter [Richtliniengenerierung von IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-generation.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [GetGeneratedPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/get-generated-policy.html)in der *AWS CLI Befehlsreferenz.* ### `list-access-preview-findings` Das folgende Codebeispiel zeigt die Verwendung`list-access-preview-findings`. **AWS CLI** **So rufen Sie eine Liste mit Erkenntnissen der Zugriffsvorschau ab, die mit der angegebenen Zugriffsvorschau generiert wurden** Im folgenden `list-access-preview-findings` Beispiel wird eine Liste mit Ergebnissen der Zugriffsvorschau abgerufen, die durch die angegebene Zugriffsvorschau in Ihrem AWS Konto generiert wurden. ``` aws accessanalyzer list-access-preview-findings \ --access-preview-id 3c65eb13-6ef9-4629-8919-a32043619e6b \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account ``` Ausgabe: ``` { "findings": [ { "id": "e22fc158-1c87-4c32-9464-e7f405ce8d74", "principal": { "AWS": "111122223333" }, "action": [ "s3:PutObject", "s3:PutObjectAcl" ], "condition": {}, "resource": "arn:aws:s3:::amzn-s3-demo-bucket", "isPublic": false, "resourceType": "AWS::S3::Bucket", "createdAt": "2024-02-17T00:18:46+00:00", "changeType": "NEW", "status": "ACTIVE", "resourceOwnerAccount": "111122223333", "sources": [ { "type": "POLICY" } ] } ] } ``` Weitere Informationen finden Sie unter [Vorschau des Zugriffs mit IAM Access Analyzer APIs](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-preview-access-apis.html) im *AWS IAM-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie [ListAccessPreviewFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/list-access-preview-findings.html)in AWS CLI der Befehlsreferenz.* ### `list-access-previews` Das folgende Codebeispiel zeigt die Verwendung`list-access-previews`. **AWS CLI** **So rufen Sie eine Liste der Zugriffsvorschauen für den angegebenen Analysator ab** Im folgenden `list-access-previews` Beispiel wird eine Liste der Zugriffsvorschauen für den angegebenen Analyzer in Ihrem AWS Konto abgerufen. ``` aws accessanalyzer list-access-previews \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account ``` Ausgabe: ``` { "accessPreviews": [ { "id": "3c65eb13-6ef9-4629-8919-a32043619e6b", "analyzerArn": "arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account", "createdAt": "2024-02-17T00:18:44+00:00", "status": "COMPLETED" } ] } ``` *Weitere Informationen finden Sie unter [Vorschau des Zugriffs mit IAM Access Analyzer APIs im AWS IAM-Benutzerhandbuch](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-preview-access-apis.html).* + *Einzelheiten zur API finden Sie [ListAccessPreviews](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/list-access-previews.html)in AWS CLI der Befehlsreferenz.* ### `list-analyzed-resources` Das folgende Codebeispiel zeigt die Verwendung`list-analyzed-resources`. **AWS CLI** **So listen Sie die verfügbaren Widgets auf** Das folgende `list-analyzed-resources` Beispiel listet die verfügbaren Widgets in Ihrem AWS Konto auf. ``` aws accessanalyzer list-analyzed-resources \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account \ --resource-type AWS::IAM::Role ``` Ausgabe: ``` { "analyzedResources": [ { "resourceArn": "arn:aws:sns:us-west-2:111122223333:Validation-Email", "resourceOwnerAccount": "111122223333", "resourceType": "AWS::SNS::Topic" }, { "resourceArn": "arn:aws:sns:us-west-2:111122223333:admin-alerts", "resourceOwnerAccount": "111122223333", "resourceType": "AWS::SNS::Topic" }, { "resourceArn": "arn:aws:sns:us-west-2:111122223333:config-topic", "resourceOwnerAccount": "111122223333", "resourceType": "AWS::SNS::Topic" }, { "resourceArn": "arn:aws:sns:us-west-2:111122223333:inspector-topic", "resourceOwnerAccount": "111122223333", "resourceType": "AWS::SNS::Topic" } ] } ``` Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListAnalyzedResources AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/list-analyzed-resources.html)*Befehlsreferenz.* ### `list-analyzers` Das folgende Codebeispiel zeigt die Verwendung`list-analyzers`. **AWS CLI** **So rufen Sie eine Liste von Analysatoren ab** Im folgenden `list-analyzers` Beispiel wird eine Liste der Analysatoren in Ihrem AWS Konto abgerufen. ``` aws accessanalyzer list-analyzers ``` Ausgabe: ``` { "analyzers": [ { "arn": "arn:aws:access-analyzer:us-west-2:111122223333:analyzer/UnusedAccess-ConsoleAnalyzer-organization", "createdAt": "2024-02-15T00:46:40+00:00", "name": "UnusedAccess-ConsoleAnalyzer-organization", "status": "ACTIVE", "tags": { "auto-delete": "no" }, "type": "ORGANIZATION_UNUSED_ACCESS" }, { "arn": "arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-organization", "createdAt": "2020-04-25T07:43:28+00:00", "lastResourceAnalyzed": "arn:aws:s3:::amzn-s3-demo-bucket", "lastResourceAnalyzedAt": "2024-02-15T21:51:56.517000+00:00", "name": "ConsoleAnalyzer-organization", "status": "ACTIVE", "tags": { "auto-delete": "no" }, "type": "ORGANIZATION" }, { "arn": "arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account", "createdAt": "2019-12-03T07:28:17+00:00", "lastResourceAnalyzed": "arn:aws:sns:us-west-2:111122223333:config-topic", "lastResourceAnalyzedAt": "2024-02-15T18:01:53.003000+00:00", "name": "ConsoleAnalyzer-account", "status": "ACTIVE", "tags": { "auto-delete": "no" }, "type": "ACCOUNT" } ] } ``` Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListAnalyzers AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/list-analyzers.html)*Befehlsreferenz.* ### `list-archive-rules` Das folgende Codebeispiel zeigt die Verwendung`list-archive-rules`. **AWS CLI** **So rufen Sie eine Liste von Archivierungsregeln ab, die für den angegebenen Analysator erstellt wurden** Im folgenden `list-archive-rules` Beispiel wird eine Liste von Archivierungsregeln abgerufen, die für den angegebenen Analyzer in Ihrem AWS Konto erstellt wurden. ``` aws accessanalyzer list-archive-rules \ --analyzer-name UnusedAccess-ConsoleAnalyzer-organization ``` Ausgabe: ``` { "archiveRules": [ { "createdAt": "2024-02-15T00:49:27+00:00", "filter": { "resource": { "contains": [ "Cognito" ] }, "resourceType": { "eq": [ "AWS::IAM::Role" ] } }, "ruleName": "MyArchiveRule", "updatedAt": "2024-02-15T00:49:27+00:00" }, { "createdAt": "2024-02-15T23:27:45+00:00", "filter": { "findingType": { "eq": [ "UnusedIAMUserAccessKey" ] } }, "ruleName": "ArchiveRule-56125a39-e517-4ff8-afb1-ef06f58db612", "updatedAt": "2024-02-15T23:27:45+00:00" } ] } ``` Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListArchiveRules AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/list-archive-rules.html)*Befehlsreferenz.* ### `list-findings-v2` Das folgende Codebeispiel zeigt die Verwendung`list-findings-v2`. **AWS CLI** **So rufen Sie eine Liste von Erkenntnissen auf, die vom angegebenen Analysator generiert wurden** Im folgenden `list-findings-v2` Beispiel wird eine Liste mit Ergebnissen abgerufen, die vom angegebenen Analysator in Ihrem AWS Konto generiert wurden. In diesem Beispiel werden die Ergebnisse so gefiltert, dass sie nur IAM-Rollen enthalten, deren Name `Cognito` enthält. ``` aws accessanalyzer list-findings-v2 \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account \ --filter '{"resource": {"contains": ["Cognito"]}, "resourceType": {"eq": ["AWS::IAM::Role"]}}' ``` Ausgabe: ``` { "findings": [ { "analyzedAt": "2024-02-16T18:17:47.888000+00:00", "createdAt": "2021-02-26T21:17:24.710000+00:00", "id": "597f3bc2-3adc-4c18-9879-5c4b23485e46", "resource": "arn:aws:iam::111122223333:role/Cognito_testpoolUnauth_Role", "resourceType": "AWS::IAM::Role", "resourceOwnerAccount": "111122223333", "status": "ACTIVE", "updatedAt": "2021-02-26T21:17:24.710000+00:00", "findingType": "ExternalAccess" }, { "analyzedAt": "2024-02-16T18:17:47.888000+00:00", "createdAt": "2021-02-26T21:17:50.905000+00:00", "id": "ce0e221a-85b9-4d52-91ff-d7678075442f", "resource": "arn:aws:iam::111122223333:role/Cognito_testpoolAuth_Role", "resourceType": "AWS::IAM::Role", "resourceOwnerAccount": "111122223333", "status": "ACTIVE", "updatedAt": "2021-02-26T21:17:50.905000+00:00", "findingType": "ExternalAccess" } ] } ``` Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListFindingsV2](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/list-findings-v2.html) in der *AWS CLI Befehlsreferenz.* ### `list-findings` Das folgende Codebeispiel zeigt die Verwendung`list-findings`. **AWS CLI** **So rufen Sie eine Liste von Erkenntnissen auf, die vom angegebenen Analysator generiert wurden** Im folgenden `list-findings` Beispiel wird eine Liste mit Ergebnissen abgerufen, die vom angegebenen Analysator in Ihrem AWS Konto generiert wurden. In diesem Beispiel werden die Ergebnisse so gefiltert, dass sie nur IAM-Rollen enthalten, deren Name `Cognito` enthält. ``` aws accessanalyzer list-findings \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account \ --filter '{"resource": {"contains": ["Cognito"]}, "resourceType": {"eq": ["AWS::IAM::Role"]}}' ``` Ausgabe: ``` { "findings": [ { "id": "597f3bc2-3adc-4c18-9879-5c4b23485e46", "principal": { "Federated": "cognito-identity.amazonaws.com" }, "action": [ "sts:AssumeRoleWithWebIdentity" ], "resource": "arn:aws:iam::111122223333:role/Cognito_testpoolUnauth_Role", "isPublic": false, "resourceType": "AWS::IAM::Role", "condition": { "cognito-identity.amazonaws.com:aud": "us-west-2:EXAMPLE0-0000-0000-0000-000000000000" }, "createdAt": "2021-02-26T21:17:24.710000+00:00", "analyzedAt": "2024-02-16T18:17:47.888000+00:00", "updatedAt": "2021-02-26T21:17:24.710000+00:00", "status": "ACTIVE", "resourceOwnerAccount": "111122223333" }, { "id": "ce0e221a-85b9-4d52-91ff-d7678075442f", "principal": { "Federated": "cognito-identity.amazonaws.com" }, "action": [ "sts:AssumeRoleWithWebIdentity" ], "resource": "arn:aws:iam::111122223333:role/Cognito_testpoolAuth_Role", "isPublic": false, "resourceType": "AWS::IAM::Role", "condition": { "cognito-identity.amazonaws.com:aud": "us-west-2:EXAMPLE0-0000-0000-0000-000000000000" }, "createdAt": "2021-02-26T21:17:50.905000+00:00", "analyzedAt": "2024-02-16T18:17:47.888000+00:00", "updatedAt": "2021-02-26T21:17:50.905000+00:00", "status": "ACTIVE", "resourceOwnerAccount": "111122223333" } ] } ``` Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListFindings AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/list-findings.html)*Befehlsreferenz.* ### `list-policy-generations` Das folgende Codebeispiel zeigt die Verwendung`list-policy-generations`. **AWS CLI** **So listen Sie alle in den letzten sieben Tagen angeforderten Richtliniengenerierungen auf** Im folgenden `list-policy-generations` Beispiel werden alle Richtliniengenerationen aufgeführt, die in den letzten sieben Tagen in Ihrem AWS Konto angefordert wurden. ``` aws accessanalyzer list-policy-generations ``` Ausgabe: ``` { "policyGenerations": [ { "completedOn": "2024-02-14T23:43:38+00:00", "jobId": "923a56b0-ebb8-4e80-8a3c-a11ccfbcd6f2", "principalArn": "arn:aws:iam::111122223333:role/Admin", "startedOn": "2024-02-14T23:43:02+00:00", "status": "CANCELED" }, { "completedOn": "2024-02-14T22:47:01+00:00", "jobId": "c557dc4a-0338-4489-95dd-739014860ff9", "principalArn": "arn:aws:iam::111122223333:role/Admin", "startedOn": "2024-02-14T22:44:41+00:00", "status": "SUCCEEDED" } ] } ``` Weitere Informationen finden Sie unter [Richtliniengenerierung von IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-generation.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [ListPolicyGenerations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/list-policy-generations.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So rufen Sie eine Liste von Tags ab, die auf die angegebene Ressource angewendet wurden** Im folgenden `list-tags-for-resource` Beispiel wird eine Liste von Tags abgerufen, die auf die angegebene Ressource in Ihrem AWS Konto angewendet wurden. ``` aws accessanalyzer list-tags-for-resource \ --resource-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account ``` Ausgabe: ``` { "tags": { "Zone-of-trust": "Account", "Name": "ConsoleAnalyzer" } } ``` Weitere Informationen finden Sie unter [Richtliniengenerierung von IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-generation.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie unter [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/list-tags-for-resource.html)*Befehlsreferenz.* ### `start-policy-generation` Das folgende Codebeispiel zeigt die Verwendung`start-policy-generation`. **AWS CLI** **So starten Sie eine Anforderung zur Richtliniengenerierung** Im folgenden `start-policy-generation` Beispiel wird eine Anfrage zur Richtliniengenerierung in Ihrem AWS Konto gestartet. ``` aws accessanalyzer start-policy-generation \ --policy-generation-details '{"principalArn":"arn:aws:iam::111122223333:role/Admin"}' \ --cloud-trail-details file://myfile.json ``` Inhalt von `myfile.json`: ``` { "accessRole": "arn:aws:iam::111122223333:role/service-role/AccessAnalyzerMonitorServiceRole", "startTime": "2024-02-13T00:30:00Z", "trails": [ { "allRegions": true, "cloudTrailArn": "arn:aws:cloudtrail:us-west-2:111122223333:trail/my-trail" } ] } ``` Ausgabe: ``` { "jobId": "c557dc4a-0338-4489-95dd-739014860ff9" } ``` Weitere Informationen finden Sie unter [Richtliniengenerierung von IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-generation.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [StartPolicyGeneration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/start-policy-generation.html)in der *AWS CLI Befehlsreferenz*. ### `start-resource-scan` Das folgende Codebeispiel zeigt die Verwendung`start-resource-scan`. **AWS CLI** **So starten Sie sofort einen Scan der Richtlinien, die auf angegebene Ressource angewendet wurden** Im folgenden `start-resource-scan` Beispiel wird sofort ein Scan der Richtlinien gestartet, die auf die angegebene Ressource in Ihrem AWS Konto angewendet wurden. ``` aws accessanalyzer start-resource-scan \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account \ --resource-arn arn:aws:iam::111122223333:role/Cognito_testpoolAuth_Role ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Richtliniengenerierung von IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-generation.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie unter [StartResourceScan AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/start-resource-scan.html)*Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie der angegebenen Ressource ein Tag hinzu** Das folgende `tag-resource` Beispiel fügt der angegebenen Ressource in Ihrem AWS Konto ein Tag hinzu. ``` aws accessanalyzer tag-resource \ --resource-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account \ --tags Environment=dev,Purpose=testing ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/tag-resource.html)*Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus den angegebenen Ressourcen** Im folgenden `untag-resource` Beispiel werden Tags aus der angegebenen Ressource in Ihrem AWS Konto entfernt. ``` aws accessanalyzer untag-resource \ --resource-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/ConsoleAnalyzer-account \ --tag-keys Environment Purpose ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [UntagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/untag-resource.html)*Befehlsreferenz.* ### `update-archive-rule` Das folgende Codebeispiel zeigt die Verwendung`update-archive-rule`. **AWS CLI** **So aktualisieren Sie die Kriterien und Werte für die angegebene Archivierungsregel** Im folgenden `update-archive-rule` Beispiel werden die Kriterien und Werte für die angegebene Archivierungsregel in Ihrem AWS Konto aktualisiert. ``` aws accessanalyzer update-archive-rule \ --analyzer-name UnusedAccess-ConsoleAnalyzer-organization \ --rule-name MyArchiveRule \ --filter '{"resource": {"contains": ["Cognito"]}, "resourceType": {"eq": ["AWS::IAM::Role"]}}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Archivierungsregeln](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-archive-rules.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [UpdateArchiveRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/update-archive-rule.html)unter *AWS CLI Befehlsreferenz*. ### `update-findings` Das folgende Codebeispiel zeigt die Verwendung`update-findings`. **AWS CLI** **So aktualisieren Sie den Status für die angegebenen Erkenntnisse** Im folgenden `update-findings` Beispiel wird der Status der angegebenen Ergebnisse in Ihrem AWS Konto aktualisiert. ``` aws accessanalyzer update-findings \ --analyzer-arn arn:aws:access-analyzer:us-west-2:111122223333:analyzer/UnusedAccess-ConsoleAnalyzer-organization \ --ids 4f319ac3-2e0c-4dc4-bf51-7013a086b6ae 780d586a-2cce-4f72-aff6-359d450e7500 \ --status ARCHIVED ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Using AWS Identity and Access Management Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) im *AWS IAM-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [UpdateFindings AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/update-findings.html)*Befehlsreferenz.* ### `validate-policy` Das folgende Codebeispiel zeigt die Verwendung`validate-policy`. **AWS CLI** **So fordern Sie die Validierung einer Richtlinie an und geben eine Liste von Erkenntnissen zurück** Im folgenden Beispiel für `validate-policy` werden die Validierung einer Richtlinie angefordert und eine Liste von Erkenntnissen zurückgegeben. Die Richtlinie im Beispiel ist eine Rollenvertrauensrichtlinie für eine Rolle in Amazon Cognito, die für den Web-Identitätsverbund verwendet wird. Die Erkenntnisse der Vertrauensrichtlinie beziehen sich auf einen leeren `Sid`-Elementwert und einen nicht übereinstimmenden Richtlinienprinzipal, da die falsche Aktion für „Rolle übernehmen“, `sts:AssumeRole`, verwendet wurde. Die richtige Aktion für „Rolle annehmen“ für die Verwendung mit Cognito ist `sts:AssumeRoleWithWebIdentity`. ``` aws accessanalyzer validate-policy \ --policy-document file://myfile.json \ --policy-type RESOURCE_POLICY ``` Inhalt von `myfile.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Federated": "cognito-identity.amazonaws.com" }, "Action": [ "sts:AssumeRole", "sts:TagSession" ], "Condition": { "StringEquals": { "cognito-identity.amazonaws.com:aud": "us-west-2_EXAMPLE" } } } ] } ``` Ausgabe: ``` { "findings": [ { "findingDetails": "Add a value to the empty string in the Sid element.", "findingType": "SUGGESTION", "issueCode": "EMPTY_SID_VALUE", "learnMoreLink": "https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-reference-policy-checks.html#access-analyzer-reference-policy-checks-suggestion-empty-sid-value", "locations": [ { "path": [ { "value": "Statement" }, { "index": 0 }, { "value": "Sid" } ], "span": { "end": { "column": 21, "line": 5, "offset": 81 }, "start": { "column": 19, "line": 5, "offset": 79 } } } ] }, { "findingDetails": "The sts:AssumeRole action is invalid with the following principal(s): cognito-identity.amazonaws.com. Use a SAML provider principal with the sts:AssumeRoleWithSAML action or use an OIDC provider principal with the sts:AssumeRoleWithWebIdentity action. Ensure the provider is Federated if you use either of the two options.", "findingType": "ERROR", "issueCode": "MISMATCHED_ACTION_FOR_PRINCIPAL", "learnMoreLink": "https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-reference-policy-checks.html#access-analyzer-reference-policy-checks-error-mismatched-action-for-principal", "locations": [ { "path": [ { "value": "Statement" }, { "index": 0 }, { "value": "Action" }, { "index": 0 } ], "span": { "end": { "column": 32, "line": 11, "offset": 274 }, "start": { "column": 16, "line": 11, "offset": 258 } } }, { "path": [ { "value": "Statement" }, { "index": 0 }, { "value": "Principal" }, { "value": "Federated" } ], "span": { "end": { "column": 61, "line": 8, "offset": 202 }, "start": { "column": 29, "line": 8, "offset": 170 } } } ] }, { "findingDetails": "The following actions: sts:TagSession are not supported by the condition key cognito-identity.amazonaws.com:aud. The condition will not be evaluated for these actions. We recommend that you move these actions to a different statement without this condition key.", "findingType": "ERROR", "issueCode": "UNSUPPORTED_ACTION_FOR_CONDITION_KEY", "learnMoreLink": "https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-reference-policy-checks.html#access-analyzer-reference-policy-checks-error-unsupported-action-for-condition-key", "locations": [ { "path": [ { "value": "Statement" }, { "index": 0 }, { "value": "Action" }, { "index": 1 } ], "span": { "end": { "column": 32, "line": 12, "offset": 308 }, "start": { "column": 16, "line": 12, "offset": 292 } } }, { "path": [ { "value": "Statement" }, { "index": 0 }, { "value": "Condition" }, { "value": "StringEquals" }, { "value": "cognito-identity.amazonaws.com:aud" } ], "span": { "end": { "column": 79, "line": 16, "offset": 464 }, "start": { "column": 58, "line": 16, "offset": 443 } } } ] } ] } ``` Weitere Informationen finden Sie unter [Überprüfungen für die Validierung von Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-checks-validating-policies.html) im *Benutzerhandbuch für AWS IAM*. + Einzelheiten zur API finden Sie [ValidatePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/accessanalyzer/validate-policy.html)in der *AWS CLI Befehlsreferenz*. # Image Builder Builder-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Image Builder Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-component` Das folgende Codebeispiel zeigt, wie Sie`create-component`. **AWS CLI** **So erstellen Sie eine Komponente** Im folgenden Beispiel für `create-component` wird eine Komponente erstellt, die eine JSON-Dokumentdatei verwendet und auf ein Komponentendokument im YAML-Format verweist, das in einen Amazon-S3-Bucket hochgeladen wird. ``` aws imagebuilder create-component \ --cli-input-json file://create-component.json ``` Inhalt von `create-component.json`: ``` { "name": "MyExampleComponent", "semanticVersion": "2019.12.02", "description": "An example component that builds, validates and tests an image", "changeDescription": "Initial version.", "platform": "Windows", "uri": "s3://s3-bucket-name/s3-bucket-path/component.yaml" } ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateComponent AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-component.html)*Befehlsreferenz*. ### `create-distribution-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-distribution-configuration`. **AWS CLI** **So erstellen Sie eine Verteilungskonfiguration** Im folgenden Beispiel für `create-distribution-configuration` wird eine Verteilungskonfiguration mithilfe einer JSON-Datei erstellt. ``` aws imagebuilder create-distribution-configuration \ --cli-input-json file:/create-distribution-configuration.json ``` Inhalt von `create-distribution-configuration.json`: ``` { "name": "MyExampleDistribution", "description": "Copies AMI to eu-west-1", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "Name {{imagebuilder:buildDate}}", "description": "An example image name with parameter references", "amiTags": { "KeyName": "{{ssm:parameter_name}}" }, "launchPermission": { "userIds": [ "123456789012" ] } } }, { "region": "eu-west-1", "amiDistributionConfiguration": { "name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}", "amiTags": { "KeyName": "Value" }, "launchPermission": { "userIds": [ "123456789012" ] } } } ] } ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateDistributionConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)*Befehlsreferenz*. ### `create-image-pipeline` Das folgende Codebeispiel zeigt die Verwendung`create-image-pipeline`. **AWS CLI** **So erstellen Sie eine Image-Pipeline** Im folgenden Beispiel für `create-image-pipeline` wird eine Image-Pipeline mithilfe einer JSON-Datei erstellt. ``` aws imagebuilder create-image-pipeline \ --cli-input-json file://create-image-pipeline.json ``` Inhalt von `create-image-pipeline.json`: ``` { "name": "MyWindows2016Pipeline", "description": "Builds Windows 2016 Images", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 60 }, "schedule": { "scheduleExpression": "cron(0 0 * * SUN)", "pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE" }, "status": "ENABLED" } ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateImagePipeline AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-pipeline.html)*Befehlsreferenz*. ### `create-image-recipe` Das folgende Codebeispiel zeigt die Verwendung`create-image-recipe`. **AWS CLI** **So erstellen Sie ein Rezept** Im folgenden Beispiel für `create-image-recipe` wird ein Image-Rezept mithilfe einer JSON-Datei erstellt. Komponenten werden in der Reihenfolge installiert, in der sie angegeben sind. ``` aws imagebuilder create-image-recipe \ --cli-input-json file://create-image-recipe.json ``` Inhalt von `create-image-recipe.json`: ``` { "name": "MyBasicRecipe", "description": "This example image recipe creates a Windows 2016 image.", "semanticVersion": "2019.12.03", "components": [ { "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1" }, { "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myimportedcomponent/1.0.0/1" } ], "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/xxxx.x.x" } ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateImageRecipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-recipe.html)*Befehlsreferenz*. ### `create-image` Das folgende Codebeispiel zeigt die Verwendung`create-image`. **AWS CLI** **Um ein Bild zu erstellen** Im folgenden Beispiel für `create-image` wird ein Image erstellt. ``` aws imagebuilder create-image \ --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03 \ --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateImage AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)*Befehlsreferenz*. ### `create-infrastructure-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-infrastructure-configuration`. **AWS CLI** **So erstellen Sie eine Infrastrukturkonfiguration** Im folgenden Beispiel für `create-infrastructure-configuration` wird eine Infrastrukturkonfiguration mithilfe einer JSON-Datei erstellt. ``` aws imagebuilder create-infrastructure-configuration \ --cli-input-json file://create-infrastructure-configuration.json ``` Inhalt von `create-infrastructure-configuration.json`: ``` { "name": "MyExampleInfrastructure", "description": "An example that will retain instances of failed builds", "instanceTypes": [ "m5.large", "m5.xlarge" ], "instanceProfileName": "EC2InstanceProfileForImageBuilder", "securityGroupIds": [ "sg-a1b2c3d4" ], "subnetId": "subnet-a1b2c3d4", "logging": { "s3Logs": { "s3BucketName": "bucket-name", "s3KeyPrefix": "bucket-path" } }, "keyPair": "key-pair-name", "terminateInstanceOnFailure": false, "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-topic-name" } ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateInfrastructureConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-infrastructure-configuration.html)*Befehlsreferenz*. ### `delete-component` Das folgende Codebeispiel zeigt die Verwendung`delete-component`. **AWS CLI** **So löschen Sie eine Komponente** Im folgenden Beispiel für `delete-component` wird eine Build-Version einer Komponente durch Festlegen ihres ARN gelöscht. ``` aws imagebuilder delete-component \ --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1 ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteComponent AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-component.html)*Befehlsreferenz*. ### `delete-image-pipeline` Das folgende Codebeispiel zeigt die Verwendung`delete-image-pipeline`. **AWS CLI** **So löschen Sie eine Image-Pipeline** Im folgenden Beispiel für `delete-image-pipeline` wird eine Image-Pipeline durch Festlegen ihres ARN gelöscht. ``` aws imagebuilder delete-image-pipeline \ --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteImagePipeline AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-pipeline.html)*Befehlsreferenz*. ### `delete-image-recipe` Das folgende Codebeispiel zeigt die Verwendung`delete-image-recipe`. **AWS CLI** **So löschen Sie ein Image-Rezept** Im folgenden Beispiel für `delete-image-recipe` wird ein Image-Rezept durch Festlegen seines ARN gelöscht. ``` aws imagebuilder delete-image-recipe \ --image-recipe-arn arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/mybasicrecipe/2019.12.03 ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteImageRecipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-recipe.html)*Befehlsreferenz*. ### `delete-image` Das folgende Codebeispiel zeigt die Verwendung`delete-image`. **AWS CLI** **Um ein Bild zu löschen** Im folgenden Beispiel für `delete-image` wird eine Build-Version eines Images durch Festlegen seines ARN gelöscht. ``` aws imagebuilder delete-image \ --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.02/1 ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteImage AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image.html)*Befehlsreferenz*. ### `delete-infrastructure-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-infrastructure-configuration`. **AWS CLI** **So löschen Sie eine Infrastrukturkonfiguration** Im folgenden Beispiel für `delete-infrastructure-configuration` wird eine Image-Pipeline durch Festlegen ihres ARN gelöscht. ``` aws imagebuilder delete-infrastructure-configuration \ --infrastructure-configuration-arn arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/myexampleinfrastructure ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteInfrastructureConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-infrastructure-configuration.html)*Befehlsreferenz*. ### `get-component-policy` Das folgende Codebeispiel zeigt die Verwendung`get-component-policy`. **AWS CLI** **So rufen Sie Details zur Komponentenrichtlinie ab** Im folgenden Beispiel für `get-component-policy` werden Details zu einer Komponentenrichtlinie durch Festlegen ihres ARN aufgelistet. ``` aws imagebuilder get-component-policy \ --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.03/1 ``` Ausgabe: ``` { "Policy": "{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetComponent", "imagebuilder:ListComponents" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.03/1" ] } ] }" } ``` Weitere Informationen finden Sie unter Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI < https://docs.aws.amazon.com/imagebuilder/ latest/userguide/managing - image-builder-cli .html>`\$1\$1 im *EC2* Image Builder Builder-Benutzerhandbuch. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component-policy.html)AWS CLI * ### `get-component` Das folgende Codebeispiel zeigt die Verwendung`get-component`. **AWS CLI** **So rufen Sie Details zu einer Komponente ab** Im folgenden Beispiel für `get-component` werden Details zu einer Komponente durch Festlegen ihres ARN aufgelistet. ``` aws imagebuilder get-component \ --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0/1 ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "component": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0/1", "name": "component-name", "version": "1.0.0", "type": "TEST", "platform": "Linux", "owner": "123456789012", "data": "name: HelloWorldTestingDocument\ndescription: This is hello world testing document.\nschemaVersion: 1.0\n\nphases:\n - name: test\n steps:\n - name: HelloWorldStep\n action: ExecuteBash\n inputs:\n commands:\n - echo \"Hello World! Test.\"\n", "encrypted": true, "dateCreated": "2020-01-27T20:43:30.306Z", "tags": {} } } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetComponent AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component.html)*Befehlsreferenz*. ### `get-distribution-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-distribution-configuration`. **AWS CLI** **So rufen Sie die Details zu einer Distributionskonfiguration ab** Das folgende Beispiel für `get-distribution-configuration` zeigt Details zu einer Distributionskonfiguration durch Festlegen ihres ARN an. ``` aws imagebuilder get-distribution-configuration \ --distribution-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "distributionConfiguration": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "name": "MyExampleDistribution", "description": "Copies AMI to eu-west-1 and exports to S3", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "Name {{imagebuilder:buildDate}}", "description": "An example image name with parameter references", "amiTags": { "KeyName": "{{ssm:parameter_name}}" }, "launchPermission": { "userIds": [ "123456789012" ] } } }, { "region": "eu-west-1", "amiDistributionConfiguration": { "name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}", "amiTags": { "KeyName": "Value" }, "launchPermission": { "userIds": [ "123456789012" ] } } } ], "dateCreated": "2020-02-19T18:40:10.529Z", "tags": {} } } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetDistributionConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-distribution-configuration.html)*Befehlsreferenz*. ### `get-image-pipeline` Das folgende Codebeispiel zeigt die Verwendung`get-image-pipeline`. **AWS CLI** **So rufen Sie Details zu einer Image-Pipeline ab** Im folgenden Beispiel für `get-image-pipeline` werden Details zu einer Image-Pipeline durch die Angabe ihres ARN aufgelistet. ``` aws imagebuilder get-image-pipeline \ --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imagePipeline": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "name": "MyWindows2016Pipeline", "description": "Builds Windows 2016 Images", "platform": "Windows", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 60 }, "schedule": { "scheduleExpression": "cron(0 0 * * SUN)", "pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE" }, "status": "ENABLED", "dateCreated": "2020-02-19T19:04:01.253Z", "dateUpdated": "2020-02-19T19:04:01.253Z", "tags": {} } } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetImagePipeline AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-pipeline.html)*Befehlsreferenz*. ### `get-image-policy` Das folgende Codebeispiel zeigt die Verwendung`get-image-policy`. **AWS CLI** **So rufen Sie Details zu einer Image-Richtlinie ab** Im folgenden Beispiel für `get-image-policy` werden Details zu einer Image-Richtlinie durch die Angabe ihres ARN aufgelistet. ``` aws imagebuilder get-image-policy \ --image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1 ``` Ausgabe: ``` { "Policy": "{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImage", "imagebuilder:ListImages" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1" ] } ] }" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetImagePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-policy.html)*Befehlsreferenz*. ### `get-image-recipe-policy` Das folgende Codebeispiel zeigt die Verwendung`get-image-recipe-policy`. **AWS CLI** **So rufen Sie Details zu einer Image-Rezept-Richtlinie ab** Im folgenden Beispiel für `get-image-recipe-policy` werden Details zu einer Image-Rezept-Richtlinie durch die Angabe ihres ARN aufgelistet. ``` aws imagebuilder get-image-recipe-policy \ --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-example-image-recipe/2019.12.03/1 ``` Ausgabe: ``` { "Policy": "{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImageRecipe", "imagebuilder:ListImageRecipes" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-example-image-recipe/2019.12.03/1" ] } ] }" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetImageRecipePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-recipe-policy.html)*Befehlsreferenz*. ### `get-image` Das folgende Codebeispiel zeigt die Verwendung`get-image`. **AWS CLI** **So rufen Sie Details zu einem Image ab** Im folgenden Beispiel für `get-image` werden Details zu einem Image durch die Angabe seines ARN aufgelistet. ``` aws imagebuilder get-image \ --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1 ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "image": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1", "name": "MyBasicRecipe", "version": "2019.12.03/1", "platform": "Windows", "state": { "status": "BUILDING" }, "imageRecipe": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "name": "MyBasicRecipe", "description": "This example image recipe creates a Windows 2016 image.", "platform": "Windows", "version": "2019.12.03", "components": [ { "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1" }, { "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myimportedcomponent/1.0.0/1" } ], "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/2019.12.17/1", "dateCreated": "2020-02-14T19:46:16.904Z", "tags": {} }, "infrastructureConfiguration": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "name": "MyExampleInfrastructure", "description": "An example that will retain instances of failed builds", "instanceTypes": [ "m5.large", "m5.xlarge" ], "instanceProfileName": "EC2InstanceProfileForImageFactory", "securityGroupIds": [ "sg-a1b2c3d4" ], "subnetId": "subnet-a1b2c3d4", "logging": { "s3Logs": { "s3BucketName": "bucket-name", "s3KeyPrefix": "bucket-path" } }, "keyPair": "Sam", "terminateInstanceOnFailure": false, "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-name", "dateCreated": "2020-02-14T21:21:05.098Z", "tags": {} }, "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 720 }, "dateCreated": "2020-02-14T23:14:13.597Z", "outputResources": { "amis": [] }, "tags": {} } } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetImage AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image.html)*Befehlsreferenz*. ### `get-infrastructure-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-infrastructure-configuration`. **AWS CLI** **So rufen Sie Details zu einer Infrastrukturkonfiguration ab** Im folgenden Beispiel für `get-infrastructure-configuration` werden Details zu einer Infrastrukturkonfiguration durch die Angabe ihres ARN aufgelistet. ``` aws imagebuilder get-infrastructure-configuration \ --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "infrastructureConfiguration": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "name": "MyExampleInfrastructure", "description": "An example that will retain instances of failed builds", "instanceTypes": [ "m5.large", "m5.xlarge" ], "instanceProfileName": "EC2InstanceProfileForImageBuilder", "securityGroupIds": [ "sg-a48c95ef" ], "subnetId": "subnet-a48c95ef", "logging": { "s3Logs": { "s3BucketName": "bucket-name", "s3KeyPrefix": "bucket-path" } }, "keyPair": "Name", "terminateInstanceOnFailure": false, "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-name", "dateCreated": "2020-02-19T19:11:51.858Z", "tags": {} } } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetInfrastructureConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-infrastructure-configuration.html)*Befehlsreferenz*. ### `import-component` Das folgende Codebeispiel zeigt die Verwendung`import-component`. **AWS CLI** **So importieren Sie eine Komponente** Im folgenden Beispiel für `import-component` wird ein bereits vorhandenes Skript mithilfe einer JSON-Datei importiert. ``` aws imagebuilder import-component \ --cli-input-json file://import-component.json ``` Inhalt von `import-component.json`: ``` { "name": "MyImportedComponent", "semanticVersion": "1.0.0", "description": "An example of how to import a component", "changeDescription": "First commit message.", "format": "SHELL", "platform": "Windows", "type": "BUILD", "uri": "s3://s3-bucket-name/s3-bucket-path/component.yaml" } ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myimportedcomponent/1.0.0/1" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ImportComponent AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-component.html)*Befehlsreferenz*. ### `list-component-build-versions` Das folgende Codebeispiel zeigt die Verwendung`list-component-build-versions`. **AWS CLI** **So listen Sie die Build-Versionen einer Komponente auf** Im folgenden Beispiel für `list-component-build-versions` werden die Build-Versionen einer Komponente mit einer bestimmten semantischen Version aufgelistet. ``` aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02 ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "componentSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1", "name": "MyExampleComponent", "version": "2019.12.02", "platform": "Windows", "type": "BUILD", "owner": "123456789012", "description": "An example component that builds, validates and tests an image", "changeDescription": "Initial version.", "dateCreated": "2020-02-19T18:53:45.940Z", "tags": { "KeyName": "KeyValue" } } ] } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListComponentBuildVersions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-component-build-versions.html)*Befehlsreferenz*. ### `list-components` Das folgende Codebeispiel zeigt die Verwendung`list-components`. **AWS CLI** **So listen Sie alle semantischen Versionen einer Komponente auf** Im folgenden Beispiel für `list-components` werden alle semantischen Versionen einer Komponente aufgelistet, auf die Sie Zugriff haben. Sie können optional danach filtern, ob Sie Komponenten auflisten möchten, die Ihnen gehören, die Amazon gehören oder die von anderen Konten mit Ihnen geteilt wurden. ``` aws imagebuilder list-components ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "componentVersionList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0", "name": "component-name", "version": "1.0.0", "platform": "Linux", "type": "TEST", "owner": "123456789012", "dateCreated": "2020-01-27T20:43:30.306Z" } ] } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListComponents AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-components.html)*Befehlsreferenz*. ### `list-distribution-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-distribution-configurations`. **AWS CLI** **So listen Sie Verteilungen auf** Im folgenden Beispiel für `list-distribution-configurations` werden all Ihre Verteilungen aufgelistet. ``` aws imagebuilder list-distribution-configurations ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "distributionConfigurationSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "name": "MyExampleDistribution", "description": "Copies AMI to eu-west-1 and exports to S3", "dateCreated": "2020-02-19T18:40:10.529Z", "tags": { "KeyName": "KeyValue" } } ] } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListDistributionConfigurations AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-distribution-configurations.html)*Befehlsreferenz*. ### `list-image-build-versions` Das folgende Codebeispiel zeigt die Verwendung`list-image-build-versions`. **AWS CLI** **So listen Sie die Build-Versionen eines Images auf** Im folgenden Beispiel für `list-image-build-versions` werden alle Build-Versionen eines Images mit einer semantischen Version aufgelistet. ``` aws imagebuilder list-image-build-versions \ --image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03 ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/7", "name": "MyBasicRecipe", "version": "2019.12.03/7", "platform": "Windows", "state": { "status": "FAILED", "reason": "Can't start SSM Automation for arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/7 during building. Parameter \"iamInstanceProfileName\" has a null value." }, "owner": "123456789012", "dateCreated": "2020-02-19T18:56:11.511Z", "outputResources": { "amis": [] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/6", "name": "MyBasicRecipe", "version": "2019.12.03/6", "platform": "Windows", "state": { "status": "FAILED", "reason": "An internal error has occurred." }, "owner": "123456789012", "dateCreated": "2020-02-18T22:49:08.142Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "MyBasicRecipe 2020-02-18T22-49-38.704Z", "description": "This example image recipe creates a Windows 2016 image." }, { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "Name 2020-02-18T22-49-08.131Z", "description": "Copies AMI to eu-west-2 and exports to S3" }, { "region": "eu-west-2", "image": "ami-a1b2c3d4567890ab", "name": "My 6 image 2020-02-18T22-49-08.131Z", "description": "Copies AMI to eu-west-2 and exports to S3" } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/5", "name": "MyBasicRecipe", "version": "2019.12.03/5", "platform": "Windows", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2020-02-18T16:51:48.403Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "MyBasicRecipe 2020-02-18T16-52-18.965Z", "description": "This example image recipe creates a Windows 2016 image." } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/4", "name": "MyBasicRecipe", "version": "2019.12.03/4", "platform": "Windows", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2020-02-18T16:50:01.827Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "MyBasicRecipe 2020-02-18T16-50-32.280Z", "description": "This example image recipe creates a Windows 2016 image." } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/3", "name": "MyBasicRecipe", "version": "2019.12.03/3", "platform": "Windows", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2020-02-14T23:14:13.597Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "MyBasicRecipe 2020-02-14T23-14-44.243Z", "description": "This example image recipe creates a Windows 2016 image." } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/2", "name": "MyBasicRecipe", "version": "2019.12.03/2", "platform": "Windows", "state": { "status": "FAILED", "reason": "SSM execution 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111' failed with status = 'Failed' and failure message = 'Step fails when it is verifying the command has completed. Command a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 returns unexpected invocation result: \n{Status=[Failed], ResponseCode=[1], Output=[\n----------ERROR-------\nfailed to run commands: exit status 1], OutputPayload=[{\"Status\":\"Failed\",\"ResponseCode\":1,\"Output\":\"\\n----------ERROR-------\\nfailed to run commands: exit status 1\",\"CommandId\":\"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\"}], CommandId=[a1b2c3d4-5678-90ab-cdef-EXAMPLE11111]}. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.'" }, "owner": "123456789012", "dateCreated": "2020-02-14T22:57:42.593Z", "outputResources": { "amis": [] }, "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListImageBuildVersions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)*Befehlsreferenz*. ### `list-image-pipeline-images` Das folgende Codebeispiel zeigt die Verwendung`list-image-pipeline-images`. **AWS CLI** **So listen Sie Images von Image-Pipelines auf** Im folgenden Beispiel für `list-image-pipeline-images` werden alle Images aufgelistet, die von einer bestimmten Image-Pipeline erstellt wurden. ``` aws imagebuilder list-image-pipeline-images \ --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imagePipelineList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "name": "MyWindows2016Pipeline", "description": "Builds Windows 2016 Images", "platform": "Windows", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 60 }, "schedule": { "scheduleExpression": "cron(0 0 * * SUN)", "pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE" }, "status": "ENABLED", "dateCreated": "2020-02-19T19:04:01.253Z", "dateUpdated": "2020-02-19T19:04:01.253Z", "tags": { "KeyName": "KeyValue" } }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/sam", "name": "PipelineName", "platform": "Linux", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/recipe-name-a1b2c3d45678/1.0.0", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/infrastructureconfiguration-name-a1b2c3d45678", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 720 }, "status": "ENABLED", "dateCreated": "2019-12-16T18:19:02.068Z", "dateUpdated": "2019-12-16T18:19:02.068Z", "tags": { "KeyName": "KeyValue" } } ] } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListImagePipelineImages AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-pipeline-images.html)*Befehlsreferenz*. ### `list-image-recipes` Das folgende Codebeispiel zeigt die Verwendung`list-image-recipes`. **AWS CLI** **So listen Sie Image-Rezepte auf** Im folgenden Beispiel für `list-image-recipes` werden alle Image-Rezepte aufgelistet. ``` aws imagebuilder list-image-recipes ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageRecipeSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "name": "MyBasicRecipe", "platform": "Windows", "owner": "123456789012", "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/2019.x.x", "dateCreated": "2020-02-19T18:54:25.975Z", "tags": { "KeyName": "KeyValue" } }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/recipe-name-a1b2c3d45678/1.0.0", "name": "recipe-name-a1b2c3d45678", "platform": "Linux", "owner": "123456789012", "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/amazon-linux-2-x86/2019.11.21", "dateCreated": "2019-12-16T18:19:00.120Z", "tags": { "KeyName": "KeyValue" } } ] } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListImageRecipes AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-recipes.html)*Befehlsreferenz*. ### `list-images` Das folgende Codebeispiel zeigt die Verwendung`list-images`. **AWS CLI** **So listen Sie Images auf** Im folgenden Beispiel für `list-images` werden alle semantischen Versionen aufgelistet, auf die Sie Zugriff haben. ``` aws imagebuilder list-images ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageVersionList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03", "name": "MyBasicRecipe", "version": "2019.12.03", "platform": "Windows", "owner": "123456789012", "dateCreated": "2020-02-14T21:29:18.810Z" } ] } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListImages AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)*Befehlsreferenz*. ### `list-infrastructure-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-infrastructure-configurations`. **AWS CLI** **So listen Sie Infrastrukturkonfigurationen auf** Im folgenden Beispiel für `list-infrastructure-configurations` werden alle Infrastrukturkonfigurationen aufgelistet. ``` aws imagebuilder list-infrastructure-configurations ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "infrastructureConfigurationSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "name": "MyExampleInfrastructure", "description": "An example that will retain instances of failed builds", "dateCreated": "2020-02-19T19:11:51.858Z", "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/infrastructureconfiguration-name-a1b2c3d45678", "name": "infrastructureConfiguration-name-a1b2c3d45678", "dateCreated": "2019-12-16T18:19:01.038Z", "tags": { "KeyName": "KeyValue" } } ] } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListInfrastructureConfigurations AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-infrastructure-configurations.html)*Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für eine bestimmte Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für eine bestimmte Ressource aufgelistet. ``` aws imagebuilder list-tags-for-resource \ --resource-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline ``` Ausgabe: ``` { "tags": { "KeyName": "KeyValue" } } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-tags-for-resource.html)*Befehlsreferenz*. ### `put-component-policy` Das folgende Codebeispiel zeigt die Verwendung`put-component-policy`. **AWS CLI** **So wenden Sie eine Ressourcenrichtlinie auf eine Komponente an** Der folgende `put-component-policy`-Befehl wendet eine Ressourcenrichtlinie auf eine Build-Komponente an, um die kontoübergreifende gemeinsame Nutzung von Build-Komponenten zu ermöglichen. Wir empfehlen Ihnen, den RAM-CLI-Befehl `create-resource-share` zu verwenden. Wenn Sie den CLI-Befehl `put-component-policy` von EC2 Image Builder verwenden, müssen Sie auch den RAM-CLI-Befehl `promote-resource-share-create-from-policy` verwenden, damit die Ressource für alle Prinzipale sichtbar ist, mit denen die Ressource geteilt wird. ``` aws imagebuilder put-component-policy \ --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1 \ --policy '{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetComponent", "imagebuilder:ListComponents" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1" ] } ] }' ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-component-policy.html)in der *AWS CLI Befehlsreferenz*. ### `put-image-policy` Das folgende Codebeispiel zeigt die Verwendung`put-image-policy`. **AWS CLI** **So wenden Sie eine Ressourcenrichtlinie auf ein Image an** Der folgende `put-image-policy`-Befehl wendet eine Ressourcenrichtlinie auf ein Image an, um die kontoübergreifende gemeinsame Nutzung von Images zu ermöglichen. Wir empfehlen Ihnen, den RAM-CLI-Befehl create-resource-share zu verwenden. Wenn Sie den EC2 Image Builder Builder-CLI-Befehl verwenden put-image-policy, müssen Sie auch den promote-resource-share-create RAM-CLI-Befehl -from-policy verwenden, damit die Ressource für alle Prinzipale sichtbar ist, mit denen die Ressource gemeinsam genutzt wird. ``` aws imagebuilder put-image-policy \ --image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1 \ --policy '{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImage", "imagebuilder:ListImages" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1" ] } ] }' ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutImagePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-policy.html)in der *AWS CLI Befehlsreferenz*. ### `put-image-recipe-policy` Das folgende Codebeispiel zeigt die Verwendung`put-image-recipe-policy`. **AWS CLI** **So wenden Sie eine Ressourcenrichtlinie auf ein Image-Rezept an** Der folgende `put-image-recipe-policy`-Befehl wendet eine Ressourcenrichtlinie auf ein Image-Rezept an, um die kontoübergreifende gemeinsame Nutzung von Image-Rezepten zu ermöglichen. Wir empfehlen Ihnen, den RAM-CLI-Befehl `create-resource-share` zu verwenden. Wenn Sie den CLI-Befehl `put-image-recipe-policy` von EC2 Image Builder verwenden, müssen Sie auch den RAM-CLI-Befehl `promote-resource-share-create-from-policy` verwenden, damit die Ressource für alle Prinzipale sichtbar ist, mit denen die Ressource geteilt wird. ``` aws imagebuilder put-image-recipe-policy \ --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02 \ --policy '{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImageRecipe", "imagebuilder:ListImageRecipes" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02" ] } ] }' ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02/1" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutImageRecipePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-recipe-policy.html)in der *AWS CLI Befehlsreferenz*. ### `start-image-pipeline-execution` Das folgende Codebeispiel zeigt die Verwendung`start-image-pipeline-execution`. **AWS CLI** **So starten Sie eine Image-Pipeline manuell** Im folgenden Beispiel für `start-image-pipeline-execution` wird eine Image-Pipeline manuell gestartet. ``` aws imagebuilder start-image-pipeline-execution \ --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartImagePipelineExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/start-image-pipeline-execution.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird zu EC2 Image Builder mithilfe einer JSON-Datei eine Ressource hinzugefügt, die getaggt wird. ``` aws imagebuilder tag-resource \ --cli-input-json file://tag-resource.json ``` Inhalt von `tag-resource.json`: ``` { "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "tags": { "KeyName: "KeyValue" } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einer Ressource** Im folgenden Beispiel für `untag-resource` wird ein Tag mithilfe einer JSON-Datei aus einer Ressource entfernt. ``` aws imagebuilder untag-resource \ --cli-input-json file://tag-resource.json ``` Inhalt von `untag-resource.json`: ``` { "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "tagKeys": [ "KeyName" ] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-distribution-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-distribution-configuration`. **AWS CLI** **So aktualisieren Sie die Verteilungskonfiguration** Im folgenden Beispiel für `update-distribution-configuration` wird eine Verteilungskonfiguration mithilfe einer JSON-Datei aktualisiert. ``` aws imagebuilder update-distribution-configuration \ --cli-input-json file://update-distribution-configuration.json ``` Inhalt von `update-distribution-configuration.json`: ``` { "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "description": "Copies AMI to eu-west-2 and exports to S3", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "Name {{imagebuilder:buildDate}}", "description": "An example image name with parameter references" } }, { "region": "eu-west-2", "amiDistributionConfiguration": { "name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}" } } ] } ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `update-image-pipeline` Das folgende Codebeispiel zeigt die Verwendung`update-image-pipeline`. **AWS CLI** **So aktualisieren Sie eine Image-Pipeline** Im folgenden Beispiel für `update-image-pipeline` wird eine Image-Pipeline mithilfe einer JSON-Datei aktualisiert. ``` aws imagebuilder update-image-pipeline \ --cli-input-json file://update-image-pipeline.json ``` Inhalt von `update-image-pipeline.json`: ``` { "imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 120 }, "schedule": { "scheduleExpression": "cron(0 0 * * MON)", "pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE" }, "status": "DISABLED" } ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-image-pipeline.html)in der *AWS CLI Befehlsreferenz*. ### `update-infrastructure-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-infrastructure-configuration`. **AWS CLI** **So aktualisieren Sie eine Infrastrukturkonfiguration** Im folgenden Beispiel für `update-infrastructure-configuration` wird eine Infrastrukturkonfiguration mithilfe einer JSON-Datei aktualisiert. ``` aws imagebuilder update-infrastructure-configuration \ --cli-input-json file:/update-infrastructure-configuration.json ``` Inhalt von `update-infrastructure-configuration.json`: ``` { "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "description": "An example that will terminate instances of failed builds", "instanceTypes": [ "m5.large", "m5.2xlarge" ], "instanceProfileName": "EC2InstanceProfileForImageFactory", "securityGroupIds": [ "sg-a48c95ef" ], "subnetId": "subnet-a48c95ef", "logging": { "s3Logs": { "s3BucketName": "bucket-name", "s3KeyPrefix": "bucket-path" } }, "terminateInstanceOnFailure": true, "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-name" } ``` Ausgabe: ``` { "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-infrastructure-configuration.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Incident Manager mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Incident Manager Aktionen ausführen und allgemeine Szenarien implementieren können. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-replication-set` Das folgende Codebeispiel zeigt, wie Sie`create-replication-set`. **AWS CLI** **So erstellen Sie den Replikationssatz** Im folgenden Beispiel für `create-replication-set` wird der Replikationssatz erstellt, den Incident Manager verwendet, um Daten in Ihrem Amazon Web Services-Konto zu replizieren und zu verschlüsseln. In diesem Beispiel werden die Regionen us-east-1 und us-east-2 bei der Erstellung des Replikationssatzes verwendet. ``` aws ssm-incidents create-replication-set \ --regions '{"us-east-1": {"sseKmsKeyId": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"}, "us-east-2": {"sseKmsKeyId": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"}}' ``` Ausgabe: ``` { "replicationSetArns": [ "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57" ] } ``` Weitere Informationen finden Sie unter [Verwenden des Replikationssatzes in Incident Manager](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [CreateReplicationSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/create-replication-set.html)in der *AWS CLI Befehlsreferenz*. ### `create-response-plan` Das folgende Codebeispiel zeigt die Verwendung`create-response-plan`. **AWS CLI** **So erstellen Sie einen Reaktionsplan** Im folgenden Beispiel für `create-response-plan` wird ein Reaktionsplan mit den angegebenen Details erstellt. ``` aws ssm-incidents create-response-plan \ --chat-channel '{"chatbotSns": ["arn:aws:sns:us-east-1:111122223333:Standard_User"]}' \ --display-name "Example response plan" \ --incident-template '{"impact": 5, "title": "example-incident"}' \ --name "example-response" \ --actions '[{"ssmAutomation": {"documentName": "AWSIncidents-CriticalIncidentRunbookTemplate", "documentVersion": "$DEFAULT", "roleArn": "arn:aws:iam::111122223333:role/aws-service-role/ssm-incidents.amazonaws.com/AWSServiceRoleForIncidentManager", "targetAccount": "RESPONSE_PLAN_OWNER_ACCOUNT"}}]' \ --engagements '["arn:aws:ssm-contacts:us-east-1:111122223333:contact/example"]' ``` Ausgabe: ``` { "arn": "arn:aws:ssm-incidents::111122223333:response-plan/example-response" } ``` Weitere Informationen finden Sie unter [Vorfallvorbereitung](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [CreateResponsePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/create-response-plan.html)in der *AWS CLI Befehlsreferenz*. ### `create-timeline-event` Das folgende Codebeispiel zeigt die Verwendung`create-timeline-event`. **AWS CLI** **Beispiel 1: So erstellen Sie ein benutzerdefiniertes Zeitleistenereignis** Im folgenden Beispiel für `create-timeline-event` wird ein benutzerdefiniertes Zeitleistenereignis zur angegebenen Zeit für den angegebenen Vorfall erstellt. ``` aws ssm-incidents create-timeline-event \ --event-data "\"example timeline event\"" \ --event-time 2022-10-01T20:30:00.000 \ --event-type "Custom Event" \ --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE" ``` Ausgabe: ``` { "eventId": "c0bcc885-a41d-eb01-b4ab-9d2deEXAMPLE", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE" } ``` **Beispiel 2: So erstellen Sie ein Zeitleistenereignis mit einer Vorfallnotiz** Im folgenden Beispiel für `create-timeline-event` wird ein Zeitleistenereignis erstellt, das im Bereich „Vorfallnotizen“ aufgeführt ist. ``` aws ssm-incidents create-timeline-event \ --event-data "\"New Note\"" \ --event-type "Note" \ --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Test/6cc46130-ca6c-3b38-68f1-f6abeEXAMPLE" \ --event-time 2023-06-20T12:06:00.000 \ --event-references '[{"resource":"arn:aws:ssm-incidents::111122223333:incident-record/Test/6cc46130-ca6c-3b38-68f1-f6abeEXAMPLE"}]' ``` Ausgabe: ``` { "eventId": "a41dc885-c0bc-b4ab-eb01-de9d2EXAMPLE", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE" } ``` Weitere Informationen finden Sie unter [Vorfalldetails](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [CreateTimelineEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/create-timeline-event.html)in der *AWS CLI Befehlsreferenz*. ### `delete-incident-record` Das folgende Codebeispiel zeigt die Verwendung`delete-incident-record`. **AWS CLI** **So löschen Sie einen Vorfalldatensatz** Im folgenden Beispiel für `delete-incident-record` wird der angegebene Vorfallbericht gelöscht. ``` aws ssm-incidents delete-incident-record \ --arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Vorfallverfolgung](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DeleteIncidentRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-incident-record.html)in der *AWS CLI Befehlsreferenz*. ### `delete-replication-set` Das folgende Codebeispiel zeigt die Verwendung`delete-replication-set`. **AWS CLI** **So löschen Sie den Replikationssatz** Im folgenden Beispiel für `delete-replication-set` wird der Replikationssatz aus Ihrem Amazon Web Services-Konto gelöscht. Durch Löschen des Replikationssatzes werden auch alle Incident Manager-Daten gelöscht. Dieser Vorgang kann nicht rückgängig gemacht werden. ``` aws ssm-incidents delete-replication-set \ --arn "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden des Replikationssatzes in Incident Manager](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DeleteReplicationSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-replication-set.html)in der *AWS CLI Befehlsreferenz*. ### `delete-resource-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-resource-policy`. **AWS CLI** **So löschen Sie eine Ressourcenrichtlinie** Im folgenden Beispiel für `delete-resource-policy` wird eine Ressourcenrichtlinie aus einem Reaktionsplan gelöscht. Dies entzieht dem Prinzipal oder der Organisation, mit dem oder der der Reaktionsplan geteilt wurde, den Zugriff. ``` aws ssm-incidents delete-resource-policy \ --policy-id "be8b57191f0371f1c6827341aa3f0a03" \ --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit freigegebenen Kontakten und Reaktionsplänen](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DeleteResourcePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-resource-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-response-plan` Das folgende Codebeispiel zeigt die Verwendung`delete-response-plan`. **AWS CLI** **So löschen Sie einen Reaktionsplan** Im folgenden Beispiel für `delete-response-plan` wird der angegebene Reaktionsplan gelöscht. ``` aws ssm-incidents delete-response-plan \ --arn "arn:aws:ssm-incidents::111122223333:response-plan/example-response" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Vorfallvorbereitung](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DeleteResponsePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-response-plan.html)in der *AWS CLI Befehlsreferenz*. ### `delete-timeline-event` Das folgende Codebeispiel zeigt die Verwendung`delete-timeline-event`. **AWS CLI** **So löschen Sie ein Zeitleistenereignis** Im folgenden Beispiel für `delete-timeline-event` wird ein benutzerdefiniertes Zeitleistenereignis aus dem angegebenen Vorfalldatensatz gelöscht. ``` aws ssm-incidents delete-timeline-event \ --event-id "c0bcc885-a41d-eb01-b4ab-9d2de193643c" \ --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Vorfalldetails](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DeleteTimelineEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-timeline-event.html)in der *AWS CLI Befehlsreferenz*. ### `get-incident-record` Das folgende Codebeispiel zeigt die Verwendung`get-incident-record`. **AWS CLI** **So rufen Sie einen Vorfalldatensatz ab** Im folgenden Beispiel für `get-incident-record` werden Details zu dem angegebenen Vorfalldatensatz abgerufen. ``` aws ssm-incidents get-incident-record \ --arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" ``` Ausgabe: ``` { "incidentRecord": { "arn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308", "automationExecutions": [], "creationTime": "2021-05-21T18:16:57.579000+00:00", "dedupeString": "c4bcc812-85e7-938d-2b78-17181176ee1a", "impact": 5, "incidentRecordSource": { "createdBy": "arn:aws:iam::111122223333:user/draliatp", "invokedBy": "arn:aws:iam::111122223333:user/draliatp", "source": "aws.ssm-incidents.custom" }, "lastModifiedBy": "arn:aws:iam::111122223333:user/draliatp", "lastModifiedTime": "2021-05-21T18:16:59.149000+00:00", "notificationTargets": [], "status": "OPEN", "title": "Example-Incident" } } ``` Weitere Informationen finden Sie unter [Vorfalldetails](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [GetIncidentRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-incident-record.html)in der *AWS CLI Befehlsreferenz*. ### `get-replication-set` Das folgende Codebeispiel zeigt die Verwendung`get-replication-set`. **AWS CLI** **So rufen Sie den Replikationssatz ab** Im folgenden Beispiel für `get-replication-set` wird der Replikationssatz abgerufen, den Incident Manager verwendet, um Daten in Ihrem Amazon Web Services-Konto zu replizieren und zu verschlüsseln. ``` aws ssm-incidents get-replication-set \ --arn "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57" ``` Ausgabe: ``` { "replicationSet": { "createdBy": "arn:aws:sts::111122223333:assumed-role/Admin/username", "createdTime": "2021-05-14T17:57:22.010000+00:00", "deletionProtected": false, "lastModifiedBy": "arn:aws:sts::111122223333:assumed-role/Admin/username", "lastModifiedTime": "2021-05-14T17:57:22.010000+00:00", "regionMap": { "us-east-1": { "sseKmsKeyId": "DefaultKey", "status": "ACTIVE" }, "us-east-2": { "sseKmsKeyId": "DefaultKey", "status": "ACTIVE", "statusMessage": "Tagging inaccessible" } }, "status": "ACTIVE" } } ``` Weitere Informationen finden Sie unter [Verwenden des Replikationssatzes in Incident Manager](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [GetReplicationSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-replication-set.html)in der *AWS CLI Befehlsreferenz*. ### `get-resource-policies` Das folgende Codebeispiel zeigt die Verwendung`get-resource-policies`. **AWS CLI** **So listen Sie Ressourcenrichtlinien für einen Reaktionsplan auf** Im folgenden Beispiel für `command-name` werden die Ressourcenrichtlinien aufgelistet, die dem angegebenen Reaktionsplan zugeordnet sind. ``` aws ssm-incidents get-resource-policies \ --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" ``` Ausgabe: ``` { "resourcePolicies": [ { "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"d901b37a-dbb0-458a-8842-75575c464219-external-principals\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::222233334444:root\"},\"Action\":[\"ssm-incidents:GetResponsePlan\",\"ssm-incidents:StartIncident\",\"ssm-incidents:UpdateIncidentRecord\",\"ssm-incidents:GetIncidentRecord\",\"ssm-incidents:CreateTimelineEvent\",\"ssm-incidents:UpdateTimelineEvent\",\"ssm-incidents:GetTimelineEvent\",\"ssm-incidents:ListTimelineEvents\",\"ssm-incidents:UpdateRelatedItems\",\"ssm-incidents:ListRelatedItems\"],\"Resource\":[\"arn:aws:ssm-incidents:*:111122223333:response-plan/Example-Response-Plan\",\"arn:aws:ssm-incidents:*:111122223333:incident-record/Example-Response-Plan/*\"]}]}", "policyId": "be8b57191f0371f1c6827341aa3f0a03", "ramResourceShareRegion": "us-east-1" } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit freigegebenen Kontakten und Reaktionsplänen](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [GetResourcePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-resource-policies.html)in der *AWS CLI Befehlsreferenz*. ### `get-response-plan` Das folgende Codebeispiel zeigt die Verwendung`get-response-plan`. **AWS CLI** **So rufen Sie Details zu einem Reaktionsplan ab** Im folgenden `command-name` Beispiel werden Details zu einem bestimmten Reaktionsplan in Ihrem AWS Konto abgerufen. ``` aws ssm-incidents get-response-plan \ --arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" ``` Ausgabe: ``` { "actions": [ { "ssmAutomation": { "documentName": "AWSIncidents-CriticalIncidentRunbookTemplate", "documentVersion": "$DEFAULT", "roleArn": "arn:aws:iam::111122223333:role/aws-service-role/ssm-incidents.amazonaws.com/AWSServiceRoleForIncidentManager", "targetAccount": "RESPONSE_PLAN_OWNER_ACCOUNT" } } ], "arn": "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan", "chatChannel": { "chatbotSns": [ "arn:aws:sns:us-east-1:111122223333:Standard_User" ] }, "displayName": "Example response plan", "engagements": [ "arn:aws:ssm-contacts:us-east-1:111122223333:contact/example" ], "incidentTemplate": { "impact": 5, "title": "Example-Incident" }, "name": "Example-Response-Plan" } ``` Weitere Informationen finden Sie unter [Vorfallvorbereitung](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [GetResponsePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-response-plan.html)in der *AWS CLI Befehlsreferenz*. ### `get-timeline-event` Das folgende Codebeispiel zeigt die Verwendung`get-timeline-event`. **AWS CLI** **So rufen Sie Details zu einem Zeitlinienereignis ab** Im folgenden Beispiel für `get-timeline-event` werden Details zum angegebenen Zeitlinienereignis zurückgegeben. ``` aws ssm-incidents get-timeline-event \ --event-id 20bcc812-8a94-4cd7-520c-0ff742111424 \ --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" ``` Ausgabe: ``` { "event": { "eventData": "\"Incident Started\"", "eventId": "20bcc812-8a94-4cd7-520c-0ff742111424", "eventTime": "2021-05-21T18:16:57+00:00", "eventType": "Custom Event", "eventUpdatedTime": "2021-05-21T18:16:59.944000+00:00", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" } } ``` Weitere Informationen finden Sie unter [Vorfalldetails](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [GetTimelineEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-timeline-event.html)in der *AWS CLI Befehlsreferenz*. ### `list-incident-records` Das folgende Codebeispiel zeigt die Verwendung`list-incident-records`. **AWS CLI** **So listen Sie Vorfalldatensätze auf** Im folgenden Beispiel für `command-name` werden die Vorfalldatensätze in Ihrem Amazon Web Services-Konto aufgelistet. ``` aws ssm-incidents list-incident-records ``` Ausgabe: ``` { "incidentRecordSummaries": [ { "arn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308", "creationTime": "2021-05-21T18:16:57.579000+00:00", "impact": 5, "incidentRecordSource": { "createdBy": "arn:aws:iam::111122223333:user/draliatp", "invokedBy": "arn:aws:iam::111122223333:user/draliatp", "source": "aws.ssm-incidents.custom" }, "status": "OPEN", "title": "Example-Incident" } ] } ``` Weitere Informationen finden Sie unter [Vorfallliste](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-list.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListIncidentRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-incident-records.html)in der *AWS CLI Befehlsreferenz*. ### `list-related-items` Das folgende Codebeispiel zeigt die Verwendung`list-related-items`. **AWS CLI** **So listen Sie verwandte Elemente auf** Im folgenden Beispiel für `list-related-items` werden die verwandten Elemente des angegebenen Vorfalls aufgelistet. ``` aws ssm-incidents list-related-items \ --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" ``` Ausgabe: ``` { "relatedItems": [ { "identifier": { "type": "OTHER", "value": { "url": "https://console.aws.amazon.com/systems-manager/opsitems/oi-8ef82158e190/workbench?region=us-east-1" } }, "title": "Example related item" }, { "identifier": { "type": "PARENT", "value": { "arn": "arn:aws:ssm:us-east-1:111122223333:opsitem/oi-8084126392ac" } }, "title": "parentItem" } ] } ``` Weitere Informationen finden Sie unter [Vorfalldetails](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListRelatedItems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-related-items.html)in der *AWS CLI Befehlsreferenz*. ### `list-replication-sets` Das folgende Codebeispiel zeigt die Verwendung`list-replication-sets`. **AWS CLI** **So listen Sie den Replikationssatz auf** Im folgenden `list-replication-set` Beispiel wird der Replikationssatz aufgeführt, den Incident Manager verwendet, um Daten in Ihrem AWS Konto zu replizieren und zu verschlüsseln. ``` aws ssm-incidents list-replication-sets ``` Ausgabe: ``` { "replicationSetArns": [ "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57" ] } ``` Weitere Informationen finden Sie unter [Verwenden des Replikationssatzes in Incident Manager](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie unter [ListReplicationSets AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-replication-sets.html)*Befehlsreferenz*. ### `list-response-plans` Das folgende Codebeispiel zeigt die Verwendung`list-response-plans`. **AWS CLI** **So listen Sie die verfügbaren Reaktionspläne auf** Im folgenden Beispiel für `list-response-plans` werden die verfügbaren Reaktionspläne in Ihrem Amazon Web Services-Konto aufgelistet. ``` aws ssm-incidents list-response-plans ``` Ausgabe: ``` { "responsePlanSummaries": [ { "arn": "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan", "displayName": "Example response plan", "name": "Example-Response-Plan" } ] } ``` Weitere Informationen finden Sie unter [Vorfallvorbereitung](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListResponsePlans](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-response-plans.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für einen Reaktionsplan auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags aufgelistet, die dem angegebenen Reaktionsplan zugeordnet sind. ``` aws ssm-incidents list-tags-for-resource \ --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" ``` Ausgabe: ``` { "tags": { "group1": "1" } } ``` Weitere Informationen finden Sie unter [Markieren](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-timeline-events` Das folgende Codebeispiel zeigt die Verwendung`list-timeline-events`. **AWS CLI** **So listen Sie die Zeitlinienereignisse eines Vorfalls auf** Im folgenden Beispiel für `command-name` werden die Zeitlinienereignisse des angegebenen Vorfalls aufgelistet. ``` aws ssm-incidents list-timeline-events \ --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" ``` Ausgabe: ``` { "eventSummaries": [ { "eventId": "8cbcc889-35e1-a42d-2429-d6f100799915", "eventTime": "2021-05-21T22:36:13.766000+00:00", "eventType": "SSM Incident Record Update", "eventUpdatedTime": "2021-05-21T22:36:13.766000+00:00", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" }, { "eventId": "a2bcc825-aab5-1787-c605-f9bb2640d85b", "eventTime": "2021-05-21T18:58:46.443000+00:00", "eventType": "SSM Incident Record Update", "eventUpdatedTime": "2021-05-21T18:58:46.443000+00:00", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" }, { "eventId": "5abcc812-89c0-b0a8-9437-1c74223d4685", "eventTime": "2021-05-21T18:16:59.149000+00:00", "eventType": "SSM Incident Record Update", "eventUpdatedTime": "2021-05-21T18:16:59.149000+00:00", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" }, { "eventId": "06bcc812-8820-405e-4065-8d2b14d29b92", "eventTime": "2021-05-21T18:16:58+00:00", "eventType": "SSM Automation Execution Start Failure for Incident", "eventUpdatedTime": "2021-05-21T18:16:58.689000+00:00", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" }, { "eventId": "20bcc812-8a94-4cd7-520c-0ff742111424", "eventTime": "2021-05-21T18:16:57+00:00", "eventType": "Custom Event", "eventUpdatedTime": "2021-05-21T18:16:59.944000+00:00", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" }, { "eventId": "c0bcc885-a41d-eb01-b4ab-9d2de193643c", "eventTime": "2020-10-01T20:30:00+00:00", "eventType": "Custom Event", "eventUpdatedTime": "2021-05-21T22:28:26.299000+00:00", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" } ] } ``` Weitere Informationen finden Sie unter [Vorfalldetails](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListTimelineEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-timeline-events.html)in der *AWS CLI Befehlsreferenz*. ### `put-resource-policy` Das folgende Codebeispiel zeigt die Verwendung`put-resource-policy`. **AWS CLI** **So teilen Sie einen Reaktionsplan und Vorfälle** Im folgenden `command-name` Beispiel wird der eine Ressourcenrichtlinie hinzugefügt Example-Response-Plan, die den Reaktionsplan und die zugehörigen Vorfälle mit dem angegebenen Prinzipal teilt. ``` aws ssm-incidents put-resource-policy \ --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \ --policy "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"ExampleResourcePolciy\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::222233334444:root\"},\"Action\":[\"ssm-incidents:GetResponsePlan\",\"ssm-incidents:StartIncident\",\"ssm-incidents:UpdateIncidentRecord\",\"ssm-incidents:GetIncidentRecord\",\"ssm-incidents:CreateTimelineEvent\",\"ssm-incidents:UpdateTimelineEvent\",\"ssm-incidents:GetTimelineEvent\",\"ssm-incidents:ListTimelineEvents\",\"ssm-incidents:UpdateRelatedItems\",\"ssm-incidents:ListRelatedItems\"],\"Resource\":[\"arn:aws:ssm-incidents:*:111122223333:response-plan/Example-Response-Plan\",\"arn:aws:ssm-incidents:*:111122223333:incident-record/Example-Response-Plan/*\"]}]}" ``` Ausgabe: ``` { "policyId": "be8b57191f0371f1c6827341aa3f0a03" } ``` Weitere Informationen finden Sie unter [Arbeiten mit freigegebenen Kontakten und Reaktionsplänen](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [PutResourcePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/put-resource-policy.html)unter *AWS CLI Befehlsreferenz*. ### `start-incident` Das folgende Codebeispiel zeigt die Verwendung`start-incident`. **AWS CLI** **So starten Sie einen Vorfall** Im folgenden Beispiel für `start-incident` wird ein Vorfall mit dem angegebenen Reaktionsplan gestartet. ``` aws ssm-incidents start-incident \ --response-plan-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" ``` Ausgabe: ``` { "incidentRecordArn": "arn:aws:ssm-incidents::682428703967:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" } ``` Weitere Informationen finden Sie unter [Vorfallerstellung](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-creation.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [StartIncident](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/start-incident.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So markieren Sie einen Reaktionsplan** Im folgenden Beispiel für `tag-resource` wird ein angegebener Reaktionsplan mit dem angegebenen Tag-Schlüssel-Wert-Paar markiert. ``` aws ssm-incidents tag-resource \ --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \ --tags '{"group1":"1"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Markieren](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einem Reaktionsplan** Im folgenden Beispiel für `untag-resource` werden die angegebenen Tags aus dem Reaktionsplan entfernt. ``` aws ssm-incidents untag-resource \ --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \ --tag-keys '["group1"]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Markieren](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-deletion-protection` Das folgende Codebeispiel zeigt die Verwendung`update-deletion-protection`. **AWS CLI** **So aktualisieren Sie den Löschschutz für den Replikationssatz** Im folgenden Beispiel für `update-deletion-protection` wird der Löschschutz in Ihrem Konto aktualisiert, um zu verhindern, dass Sie versehentlich die letzte Region in Ihrem Replikationssatz löschen. ``` aws ssm-incidents update-deletion-protection \ --arn "arn:aws:ssm-incidents::111122223333:replication-set/a2bcc5c9-0f53-8047-7fef-c20749989b40" \ --deletion-protected ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden des Replikationssatzes in Incident Manager](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UpdateDeletionProtection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-deletion-protection.html)in der *AWS CLI Befehlsreferenz*. ### `update-incident-record` Das folgende Codebeispiel zeigt die Verwendung`update-incident-record`. **AWS CLI** **So aktualisieren Sie einen Vorfalldatensatz** Im folgenden Beispiel für `command-name` wird der angegebene Vorfall gelöst. ``` aws ssm-incidents update-incident-record \ --arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" \ --status "RESOLVED" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Vorfalldetails](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UpdateIncidentRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-incident-record.html)in der *AWS CLI Befehlsreferenz*. ### `update-related-items` Das folgende Codebeispiel zeigt die Verwendung`update-related-items`. **AWS CLI** **So aktualisieren Sie ein Element im Zusammenhang mit dem Vorfall** Im folgenden Beispiel für `update-related-item` wird ein verwandtes Element aus dem angegebenen Vorfalldatensatz entfernt. ``` aws ssm-incidents update-related-items \ --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" \ --related-items-update '{"itemToRemove": {"type": "OTHER", "value": {"url": "https://console.aws.amazon.com/systems-manager/opsitems/oi-8ef82158e190/workbench?region=us-east-1"}}}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Vorfalldetails](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UpdateRelatedItems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-related-items.html)in der *AWS CLI Befehlsreferenz*. ### `update-replication-set` Das folgende Codebeispiel zeigt die Verwendung`update-replication-set`. **AWS CLI** **So aktualisieren Sie einen Replikationssatz** Im folgenden Beispiel für `command-name` wird die Region us-east-2 aus dem Replikationssatz gelöscht. ``` aws ssm-incidents update-replication-set \ --arn "arn:aws:ssm-incidents::111122223333:replication-set/a2bcc5c9-0f53-8047-7fef-c20749989b40" \ --actions '[{"deleteRegionAction": {"regionName": "us-east-2"}}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden des Replikationssatzes in Incident Manager](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UpdateReplicationSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-replication-set.html)in der *AWS CLI Befehlsreferenz*. ### `update-response-plan` Das folgende Codebeispiel zeigt die Verwendung`update-response-plan`. **AWS CLI** **So aktualisieren Sie einen Reaktionsplan** Im folgenden Beispiel für `update-response-plan` wird ein Chatkanal aus dem angegebenen Reaktionsplan entfernt. ``` aws ssm-incidents update-response-plan \ --arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \ --chat-channel '{"empty":{}}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Vorfallvorbereitung](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UpdateResponsePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-response-plan.html)in der *AWS CLI Befehlsreferenz*. ### `update-timeline-event` Das folgende Codebeispiel zeigt die Verwendung`update-timeline-event`. **AWS CLI** **So aktualisieren Sie ein Zeitleistenereignis** Im folgenden Beispiel für `update-timeline-event` wird die Uhrzeit des Ereignisvorfalls aktualisiert. ``` aws ssm-incidents update-timeline-event \ --event-id 20bcc812-8a94-4cd7-520c-0ff742111424 \ --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" \ --event-time "2021-05-21T18:10:57+00:00" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Vorfalldetails](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UpdateTimelineEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-timeline-event.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Incident Manager-Kontakte mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Incident Manager-Kontakten Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `accept-page` Das folgende Codebeispiel zeigt, wie Sie`accept-page`. **AWS CLI** **So akzeptieren Sie eine Seite während einer Interaktion** Im folgenden Beispiel für `accept-page` wird ein Akzeptanzcode verwendet, der an den Kontaktkanal gesendet wird, um eine Seite zu akzeptieren. ``` aws ssm-contacts accept-page \ --page-id "arn:aws:ssm-contacts:us-east-2:682428703967:page/akuam/94ea0c7b-56d9-46c3-b84a-a37c8b067ad3" \ --accept-type READ \ --accept-code 425440 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [AcceptPage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/accept-page.html)in der *AWS CLI Befehlsreferenz*. ### `activate-contact-channel` Das folgende Codebeispiel zeigt die Verwendung`activate-contact-channel`. **AWS CLI** **So aktivieren Sie den Kontaktkanal eines Kontakts** Im folgenden Beispiel für `activate-contact-channel` wird ein Kontaktkanal aktiviert und macht ihn als Teil eines Vorfalls nutzbar. ``` aws ssm-contacts activate-contact-channel \ --contact-channel-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d" \ --activation-code "466136" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ActivateContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/activate-contact-channel.html)in der *AWS CLI Befehlsreferenz*. ### `command-name` Das folgende Codebeispiel zeigt die Verwendung`command-name`. **AWS CLI** **Um einen Kontakt zu löschen** Im folgenden Beispiel für `command-name` wird ein Kontakt gelöscht. Der Kontakt wird über keinen Eskalationsplan, der sich auf ihn bezieht, mehr erreichbar sein. ``` aws ssm-contacts delete-contact \ --contact-id "arn:aws:ssm-contacts:us-east-1:682428703967:contact/alejr" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [CommandName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/command-name.html)in der *AWS CLI Befehlsreferenz*. ### `create-contact-channel` Das folgende Codebeispiel zeigt die Verwendung`create-contact-channel`. **AWS CLI** **So erstellen Sie einen Kontaktkanal** Es wird ein Kontaktkanal vom Typ SMS für den Kontakt Akua Mansa erstellt. Kontaktkanäle können vom Typ SMS, EMAIL oder VOICE erstellt werden. ``` aws ssm-contacts create-contact-channel \ --contact-id "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \ --name "akuas sms-test" \ --type SMS \ --delivery-address '{"SimpleAddress": "+15005550199"}' ``` Ausgabe: ``` { "ContactChannelArn": "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/02f506b9-ea5d-4764-af89-2daa793ff024" } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [CreateContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/create-contact-channel.html)in der *AWS CLI Befehlsreferenz*. ### `create-contact` Das folgende Codebeispiel zeigt die Verwendung`create-contact`. **AWS CLI** **Um einen Kontakt zu erstellen** Im folgenden Beispiel für `create-contact` wird ein Kontakt in Ihrer Umgebung mit einem leeren Plan erstellt. Der Plan kann nach dem Erstellen von Kontaktkanälen aktualisiert werden. Verwenden Sie den create-contact-channel Befehl mit dem Ausgabe-ARN dieses Befehls. Nachdem Sie Kontaktkanäle für diesen Kontakt erstellt haben, verwenden Sie update-contact, um den Plan zu aktualisieren. ``` aws ssm-contacts create-contact \ --alias "akuam" \ --display-name "Akua Mansa" \ --type PERSONAL \ --plan '{"Stages": []}' ``` Ausgabe: ``` { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [CreateContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/create-contact.html)in der *AWS CLI Befehlsreferenz*. ### `deactivate-contact-channel` Das folgende Codebeispiel zeigt die Verwendung`deactivate-contact-channel`. **AWS CLI** **So deaktivieren Sie einen Kontaktkanal** Im folgenden Beispiel für `deactivate-contact-channel` wird ein Kontaktkanal deaktiviert. Die Deaktivierung eines Kontaktkanals bedeutet, dass der Kontaktkanal während eines Vorfalls nicht mehr per Paging verbunden wird. Sie können einen Kontaktkanal auch jederzeit mit dem Befehl `activate-contact-channel` reaktivieren. ``` aws ssm-contacts deactivate-contact-channel \ --contact-channel-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DeactivateContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/deactivate-contact-channel.html)in der *AWS CLI Befehlsreferenz*. ### `delete-contact-channel` Das folgende Codebeispiel zeigt die Verwendung`delete-contact-channel`. **AWS CLI** **So löschen Sie einen Kontaktkanal** Im folgenden Beispiel für `delete-contact-channel` wird ein Kontaktkanal gelöscht. Durch das Löschen eines Kontaktkanals wird sichergestellt, dass der Kontaktkanal während eines Vorfalls nicht per Paging verbunden wird. ``` aws ssm-contacts delete-contact-channel \ --contact-channel-id "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/13149bad-52ee-45ea-ae1e-45857f78f9b2" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DeleteContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/delete-contact-channel.html)in der *AWS CLI Befehlsreferenz*. ### `delete-contact` Das folgende Codebeispiel zeigt die Verwendung`delete-contact`. **AWS CLI** **Um einen Kontakt zu löschen** Im folgenden Beispiel für `delete-contact` wird ein Kontakt gelöscht. Der Kontakt wird über keinen Eskalationsplan, der sich auf ihn bezieht, mehr erreichbar sein. ``` aws ssm-contacts delete-contact \ --contact-id "arn:aws:ssm-contacts:us-east-1:111122223333:contact/alejr" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DeleteContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/delete-contact.html)in der *AWS CLI Befehlsreferenz*. ### `describe-engagement` Das folgende Codebeispiel zeigt die Verwendung`describe-engagement`. **AWS CLI** **So beschreiben Sie die Einzelheiten einer Interaktion** Im folgenden Beispiel für `describe-engagement` werden die Details einer Interaktion mit einem Kontakt oder Eskalationsplan aufgelistet. Der Betreff und der Inhalt werden an die Kontaktkanäle gesendet. ``` aws ssm-contacts describe-engagement \ --engagement-id "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356" ``` Ausgabe: ``` { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356", "Sender": "cli", "Subject": "cli-test", "Content": "Testing engagements via CLI", "PublicSubject": "cli-test", "PublicContent": "Testing engagements va CLI", "StartTime": "2021-05-18T18:25:41.151000+00:00" } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DescribeEngagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/describe-engagement.html)in der *AWS CLI Befehlsreferenz*. ### `describe-page` Das folgende Codebeispiel zeigt die Verwendung`describe-page`. **AWS CLI** **So listen Sie die Details einer Seite für einen Kontaktkanal auf** Im folgenden Beispiel für `describe-page` werden die Details einer Seite für einen Kontaktkanal aufgelistet. Die Seite wird den Betreff und den bereitgestellten Inhalt enthalten. ``` aws ssm-contacts describe-page \ --page-id "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93" ``` Ausgabe: ``` { "PageArn": "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "Subject": "cli-test", "Content": "Testing engagements via CLI", "PublicSubject": "cli-test", "PublicContent": "Testing engagements va CLI", "SentTime": "2021-05-18T18:43:29.301000+00:00", "ReadTime": "2021-05-18T18:43:55.708000+00:00", "DeliveryTime": "2021-05-18T18:43:55.265000+00:00" } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [DescribePage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/describe-page.html)in der *AWS CLI Befehlsreferenz*. ### `get-contact-channel` Das folgende Codebeispiel zeigt die Verwendung`get-contact-channel`. **AWS CLI** **So listen Sie die Details eines Kontaktkanals auf** Im folgenden Beispiel für `get-contact-channel` werden die Details eines Kontaktkanals aufgelistet. ``` aws ssm-contacts get-contact-channel \ --contact-channel-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d" ``` Ausgabe: ``` { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "Name": "akuas sms", "Type": "SMS", "DeliveryAddress": { "SimpleAddress": "+15005550199" }, "ActivationStatus": "ACTIVATED" } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [GetContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/get-contact-channel.html)in der *AWS CLI Befehlsreferenz*. ### `get-contact-policy` Das folgende Codebeispiel zeigt die Verwendung`get-contact-policy`. **AWS CLI** **So listen Sie die Ressourcenrichtlinien eines Kontakts auf** Im folgenden Beispiel für `get-contact-policy` werden die Ressourcenrichtlinien aufgelistet, die dem angegebenen Kontakt zugeordnet sind. ``` aws ssm-contacts get-contact-policy \ --contact-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" ``` Ausgabe: ``` { "ContactArn": "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam", "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"SharePolicyForDocumentationDralia\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"222233334444\"},\"Action\":[\"ssm-contacts:GetContact\",\"ssm-contacts:StartEngagement\",\"ssm-contacts:DescribeEngagement\",\"ssm-contacts:ListPagesByEngagement\",\"ssm-contacts:StopEngagement\"],\"Resource\":[\"arn:aws:ssm-contacts:*:111122223333:contact/akuam\",\"arn:aws:ssm-contacts:*:111122223333:engagement/akuam/*\"]}]}" } ``` Weitere Informationen finden Sie unter [Arbeiten mit freigegebenen Kontakten und Reaktionsplänen](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [GetContactPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/get-contact-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-contact` Das folgende Codebeispiel zeigt die Verwendung`get-contact`. **AWS CLI** **Beispiel 1: So beschreiben Sie einen Kontaktplan** Im folgenden Beispiel für `get-contact` wird ein Kontakt beschrieben. ``` aws ssm-contacts get-contact \ --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" ``` Ausgabe: ``` { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Alias": "akuam", "DisplayName": "Akua Mansa", "Type": "PERSONAL", "Plan": { "Stages": [ { "DurationInMinutes": 5, "Targets": [ { "ChannelTargetInfo": { "ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/beb25840-5ac8-4644-95cc-7a8de390fa65", "RetryIntervalInMinutes": 1 } } ] }, { "DurationInMinutes": 5, "Targets": [ { "ChannelTargetInfo": { "ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad", "RetryIntervalInMinutes": 1 } } ] }, { "DurationInMinutes": 5, "Targets": [ { "ChannelTargetInfo": { "ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/77d4f447-f619-4954-afff-85551e369c2a", "RetryIntervalInMinutes": 1 } } ] } ] } } ``` **Beispiel 2: So beschreiben Sie einen Eskalationsplan** Im folgenden Beispiel für `get-contact` wird ein Eskalationsplan beschrieben. ``` aws ssm-contacts get-contact \ --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation" ``` Ausgabe: ``` { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", "Alias": "example_escalation", "DisplayName": "Example Escalation", "Type": "ESCALATION", "Plan": { "Stages": [ { "DurationInMinutes": 5, "Targets": [ { "ContactTargetInfo": { "ContactId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "IsEssential": true } } ] }, { "DurationInMinutes": 5, "Targets": [ { "ContactTargetInfo": { "ContactId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/alejr", "IsEssential": false } } ] }, { "DurationInMinutes": 0, "Targets": [ { "ContactTargetInfo": { "ContactId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/anasi", "IsEssential": false } } ] } ] } } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [GetContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/get-contact.html)in der *AWS CLI Befehlsreferenz*. ### `list-contact-channels` Das folgende Codebeispiel zeigt die Verwendung`list-contact-channels`. **AWS CLI** **So listen Sie die Kontaktkanäle eines Kontakts auf** Im folgenden Beispiel für `list-contact-channels` werden die verfügbaren Kontaktkanäle des angegebenen Kontakts aufgelistet. ``` aws ssm-contacts list-contact-channels \ --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" ``` Ausgabe: ``` { [ { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Name": "akuas email", "Type": "EMAIL", "DeliveryAddress": { "SimpleAddress": "akuam@example.com" }, "ActivationStatus": "NOT_ACTIVATED" }, { "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Name": "akuas sms", "Type": "SMS", "DeliveryAddress": { "SimpleAddress": "+15005550100" }, "ActivationStatus": "ACTIVATED" } ] } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListContactChannels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-contact-channels.html)in der *AWS CLI Befehlsreferenz*. ### `list-contacts` Das folgende Codebeispiel zeigt die Verwendung`list-contacts`. **AWS CLI** **So listen Sie alle Eskalationspläne und Kontakte auf** Im folgenden Beispiel für `list-contacts` werden die Kontakte und Eskalationspläne in Ihrem Konto aufgelistet. ``` aws ssm-contacts list-contacts ``` Ausgabe: ``` { "Contacts": [ { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Alias": "akuam", "DisplayName": "Akua Mansa", "Type": "PERSONAL" }, { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/alejr", "Alias": "alejr", "DisplayName": "Alejandro Rosalez", "Type": "PERSONAL" }, { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/anasi", "Alias": "anasi", "DisplayName": "Ana Carolina Silva", "Type": "PERSONAL" }, { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", "Alias": "example_escalation", "DisplayName": "Example Escalation", "Type": "ESCALATION" } ] } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListContacts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-contacts.html)in der *AWS CLI Befehlsreferenz*. ### `list-engagements` Das folgende Codebeispiel zeigt die Verwendung`list-engagements`. **AWS CLI** **So listen Sie alle Interaktionen auf** Im folgenden Beispiel für `list-engagements` werden Interaktionen mit Eskalationsplänen und Kontakten aufgelistet. Sie können auch Interaktionen für einen einzelnen Vorfall auflisten. ``` aws ssm-contacts list-engagements ``` Ausgabe: ``` { "Engagements": [ { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/91792571-0b53-4821-9f73-d25d13d9e529", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "StartTime": "2021-05-18T20:37:50.300000+00:00" }, { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "StartTime": "2021-05-18T18:40:26.666000+00:00" }, { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", "Sender": "cli", "StartTime": "2021-05-18T18:25:41.151000+00:00" }, { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/607ced0e-e8fa-4ea7-8958-a237b8803f8f", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "StartTime": "2021-05-18T18:20:58.093000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListEngagements](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-engagements.html)in der *AWS CLI Befehlsreferenz*. ### `list-page-receipts` Das folgende Codebeispiel zeigt die Verwendung`list-page-receipts`. **AWS CLI** **So listen Sie Seitenbelege auf** Im folgenden Beispiel für `command-name` wird aufgeführt, ob eine Seite von einem Kontakt empfangen wurde oder nicht. ``` aws ssm-contacts list-page-receipts \ --page-id "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/94ea0c7b-56d9-46c3-b84a-a37c8b067ad3" ``` Ausgabe: ``` { "Receipts": [ { "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "ReceiptType": "DELIVERED", "ReceiptInfo": "425440", "ReceiptTime": "2021-05-18T20:42:57.485000+00:00" }, { "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "ReceiptType": "READ", "ReceiptInfo": "425440", "ReceiptTime": "2021-05-18T20:42:57.907000+00:00" }, { "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "ReceiptType": "SENT", "ReceiptInfo": "SM6656c19132f1465f9c9c1123a5dde7c9", "ReceiptTime": "2021-05-18T20:40:52.962000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListPageReceipts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-page-receipts.html)in der *AWS CLI Befehlsreferenz*. ### `list-pages-by-contact` Das folgende Codebeispiel zeigt die Verwendung`list-pages-by-contact`. **AWS CLI** **So listen Sie Seiten nach Kontakt auf** Im folgenden Beispiel für `list-pages-by-contact` werden alle Seiten für den angegebenen Kontakt aufgelistet. ``` aws ssm-contacts list-pages-by-contact \ --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" ``` Ausgabe: ``` { "Pages": [ { "PageArn": "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "SentTime": "2021-05-18T18:43:29.301000+00:00", "DeliveryTime": "2021-05-18T18:43:55.265000+00:00", "ReadTime": "2021-05-18T18:43:55.708000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListPagesByContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-pages-by-contact.html)in der *AWS CLI Befehlsreferenz*. ### `list-pages-by-engagement` Das folgende Codebeispiel zeigt die Verwendung`list-pages-by-engagement`. **AWS CLI** **So listen Sie Seiten von Kontaktkanälen auf, die mit einer Interaktion gestartet wurden.** Im folgenden Beispiel für `list-pages-by-engagement` werden die Seiten aufgelistet, die während der Interaktion mit dem definierten Engagement-Plan entstanden sind. ``` aws ssm-contacts list-pages-by-engagement \ --engagement-id "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0" ``` Ausgabe: ``` { "Pages": [ { "PageArn": "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "SentTime": "2021-05-18T18:40:27.245000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListPagesByEngagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-pages-by-engagement.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags für einen Kontakt auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags des angegebenen Kontakts aufgelistet. ``` aws ssm-contacts list-tags-for-resource \ --resource-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" ``` Ausgabe: ``` { "Tags": [ { "Key": "group1", "Value": "1" } ] } ``` Weitere Informationen finden Sie unter [Markieren](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-contact-policy` Das folgende Codebeispiel zeigt die Verwendung`put-contact-policy`. **AWS CLI** **So teilen Sie einen Kontakt und Interaktionen** Im folgenden Beispiel für `put-contact-policy` wird dem Kontakt Akua eine Ressourcenrichtlinie hinzugefügt, die den Kontakt und die damit verbundenen Interaktionen mit dem Prinzipal teilt. ``` aws ssm-contacts put-contact-policy \ --contact-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \ --policy "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"ExampleResourcePolicy\",\"Action\":[\"ssm-contacts:GetContact\",\"ssm-contacts:StartEngagement\",\"ssm-contacts:DescribeEngagement\",\"ssm-contacts:ListPagesByEngagement\",\"ssm-contacts:StopEngagement\"],\"Principal\":{\"AWS\":\"222233334444\"},\"Effect\":\"Allow\",\"Resource\":[\"arn:aws:ssm-contacts:*:111122223333:contact\/akuam\",\"arn:aws:ssm-contacts:*:111122223333:engagement\/akuam\/*\"]}]}" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit freigegebenen Kontakten und Reaktionsplänen](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [PutContactPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/put-contact-policy.html)in der *AWS CLI Befehlsreferenz*. ### `send-activation-code` Das folgende Codebeispiel zeigt die Verwendung`send-activation-code`. **AWS CLI** **So senden Sie einen Aktivierungscode** Im folgenden Beispiel für `send-activation-code` wird ein Aktivierungscode und eine Nachricht an den angegebenen Kontaktkanal gesendet. ``` aws ssm-contacts send-activation-code \ --contact-channel-id "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/8ddae2d1-12c8-4e45-b852-c8587266c400" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [SendActivationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/send-activation-code.html)in der *AWS CLI Befehlsreferenz*. ### `start-engagement` Das folgende Codebeispiel zeigt die Verwendung`start-engagement`. **AWS CLI** **Beispiel 1: So finden Sie die Kontaktkanäle eines Kontakts** Die folgenden `start-engagement`-Seiten finden die Kontaktkanäle eines Kontakts. Absender, Betreff, öffentlicher Betreff und öffentlicher Inhalt sind alle frei von Feldern. Incident Manager sendet den Betreff und den Inhalt an die bereitgestellten VOICE- oder E-MAIL-Kontaktkanäle. Incident Manager sendet den öffentlichen Betreff und die öffentlichen Inhalte an die bereitgestellten SMS-Kontaktkanäle. Absender wird verwendet, um nachzuverfolgen, wer die Interaktion gestartet hat. ``` aws ssm-contacts start-engagement \ --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" \ --sender "cli" \ --subject "cli-test" \ --content "Testing engagements via CLI" \ --public-subject "cli-test" \ --public-content "Testing engagements va CLI" ``` Ausgabe: ``` { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/607ced0e-e8fa-4ea7-8958-a237b8803f8f" } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. **Beispiel 2: So platzieren Sie einen Kontakt im bereitgestellten Eskalationsplan.** Im folgenden Beispiel für `start-engagement` werden die Kontakte über einen Eskalationsplan eingebunden. Jeder Kontakt wird entsprechend seinem Interaktionsplan gefunden. ``` aws ssm-contacts start-engagement \ --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation" \ --sender "cli" \ --subject "cli-test" \ --content "Testing engagements via CLI" \ --public-subject "cli-test" \ --public-content "Testing engagements va CLI" ``` Ausgabe: ``` { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356" } ``` Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [StartEngagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/start-engagement.html)in der *AWS CLI Befehlsreferenz*. ### `stop-engagement` Das folgende Codebeispiel zeigt die Verwendung`stop-engagement`. **AWS CLI** **So beenden Sie eine Interaktion** Im folgenden Beispiel für `stop-engagement` wird verhindert, dass eine Interaktion weitere Kontakte und Kontaktkanäle findet. ``` aws ssm-contacts stop-engagement \ --engagement-id "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [StopEngagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/stop-engagement.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So markieren Sie einen Kontakt** Im folgenden Beispiel für `tag-resource` wird ein angegebener Kontakt mit dem angegebenen Tag-Schlüssel-Wert-Paar markiert. ``` aws ssm-contacts tag-resource \ --resource-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \ --tags '[{"Key":"group1","Value":"1"}]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Markieren](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einem Kontakt** Im folgenden Beispiel für `untag-resource` wird das group1-Tag von dem angegebenen Kontakt entfernt. ``` aws ssm-contacts untag-resource \ --resource-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \ --tag-keys "group1" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Markieren](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-contact-channel` Das folgende Codebeispiel zeigt die Verwendung`update-contact-channel`. **AWS CLI** **So aktualisieren Sie einen Kontaktkanal** Im folgenden Beispiel für `update-contact-channel` wird der Name und die Lieferadresse eines Kontaktkanals aktualisiert. ``` aws ssm-contacts update-contact-channel \ --contact-channel-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad" \ --name "akuas voice channel" \ --delivery-address '{"SimpleAddress": "+15005550198"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UpdateContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/update-contact-channel.html)in der *AWS CLI Befehlsreferenz*. ### `update-contact` Das folgende Codebeispiel zeigt die Verwendung`update-contact`. **AWS CLI** **So aktualisieren Sie den Interaktionsplan für den Kontakt** Im folgenden Beispiel für `update-contact` wird der Interaktionsplan des Kontakts Akua aktualisiert, sodass er die drei Arten von Kontaktkanälen umfasst. Dies erfolgt nach der Erstellung von Kontaktkanälen für Akua. ``` aws ssm-contacts update-contact \ --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" \ --plan '{"Stages": [{"DurationInMinutes": 5, "Targets": [{"ChannelTargetInfo": {"ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/beb25840-5ac8-4644-95cc-7a8de390fa65","RetryIntervalInMinutes": 1 }}]}, {"DurationInMinutes": 5, "Targets": [{"ChannelTargetInfo":{"ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad", "RetryIntervalInMinutes": 1}}]}, {"DurationInMinutes": 5, "Targets": [{"ChannelTargetInfo": {"ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/77d4f447-f619-4954-afff-85551e369c2a","RetryIntervalInMinutes": 1 }}]}]}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Kontakte](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) im *Benutzerhandbuch für Incident Manager*. + Einzelheiten zur API finden Sie [UpdateContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/update-contact.html)in der *AWS CLI Befehlsreferenz*. # Amazon Inspector Inspector-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon Inspector Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-attributes-to-findings` Das folgende Codebeispiel zeigt, wie Sie`add-attributes-to-findings`. **AWS CLI** **So fügen Sie Erkenntnissen Attribute hinzu** Der folgende `add-attribute-to-finding`-Befehl weist der Erkenntnis mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU` ein Attribut mit dem Schlüssel `Example` und dem Wert `example` zu: ``` aws inspector add-attributes-to-findings --finding-arns arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU --attributes key=Example,value=example ``` Ausgabe: ``` { "failedItems": {} } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Erkenntnisse“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [AddAttributesToFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/add-attributes-to-findings.html)in der *AWS CLI Befehlsreferenz*. ### `associate-member` Das folgende Codebeispiel zeigt die Verwendung`associate-member`. **AWS CLI** **Beispiel: Um ein AWS Konto einem delegierten Amazon Inspector-Administrator zuzuordnen** Das folgende `associate-member` Beispiel verknüpft ein AWS Konto mit einem delegierten Amazon Inspector-Administrator. ``` aws inspector2 associate-member \ --account-id 123456789012 ``` Ausgabe: ``` { "accountId": "123456789012" } ``` Weitere Informationen finden Sie unter [Verwaltung mehrerer Konten in Amazon Inspector mit AWS Organizations](https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html) im *Amazon Inspector Inspector-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AssociateMember](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/associate-member.html)in der *AWS CLI Befehlsreferenz*. ### `create-assessment-target` Das folgende Codebeispiel zeigt die Verwendung`create-assessment-target`. **AWS CLI** **Um ein Bewertungsziel zu erstellen** Mit dem folgenden `create-assessment-target`-Befehl wird ein Bewertungsziel mit dem Namen `ExampleAssessmentTarget` unter Verwendung der Ressourcengruppe mit dem ARN `arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv` erstellt: ``` aws inspector create-assessment-target --assessment-target-name ExampleAssessmentTarget --resource-group-arn arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv ``` Ausgabe: ``` { "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX" } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsziele“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [CreateAssessmentTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/create-assessment-target.html)in der *AWS CLI Befehlsreferenz*. ### `create-assessment-template` Das folgende Codebeispiel zeigt die Verwendung`create-assessment-template`. **AWS CLI** **So erstellen Sie eine Bewertungsvorlage** Mit dem folgenden `create-assessment-template`-Befehl wird eine Bewertungsvorlage mit dem Namen `ExampleAssessmentTemplate` für das Bewertungsziel mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX` erstellt: ``` aws inspector create-assessment-template --assessment-target-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX --assessment-template-name ExampleAssessmentTemplate --duration-in-seconds 180 --rules-package-arns arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p --user-attributes-for-findings key=ExampleTag,value=examplevalue ``` Ausgabe: ``` { "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T" } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [CreateAssessmentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/create-assessment-template.html)in der *AWS CLI Befehlsreferenz*. ### `create-filter` Das folgende Codebeispiel zeigt die Verwendung`create-filter`. **AWS CLI** **Um einen Filter zu erstellen** Im folgenden Beispiel für `create-filter` wird eine Unterdrückungsregel erstellt, die Erkenntnisse des Typs ECR-Instance auslässt. ``` aws inspector2 create-filter \ --name "ExampleSuppressionRuleECR" \ --description "This suppression rule omits ECR instance type findings" \ --action SUPPRESS \ --filter-criteria 'resourceType=[{comparison="EQUALS", value="AWS_ECR_INSTANCE"}]' ``` Ausgabe: ``` { "arn": "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444" } ``` Weitere Informationen finden Sie unter [Filtern von Amazon-Inspector-Erkenntnissen](https://docs.aws.amazon.com/inspector/latest/user/findings-managing-filtering.html) im *Benutzerhandbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [CreateFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/create-filter.html)in der *AWS CLI Befehlsreferenz*. ### `create-findings-report` Das folgende Codebeispiel zeigt die Verwendung`create-findings-report`. **AWS CLI** **So erstellen Sie einen Erkenntnisbericht** Im folgenden Beispiel für `create-findings-report` wird ein Erkenntnisbericht erstellt. ``` aws inspector2 create-findings-report \ --report-format CSV \ --s3-destination bucketName=inspector-sbom-123456789012,keyPrefix=sbom-key,kmsKeyArn=arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333 \ --filter-criteria '{"ecrImageRepositoryName":[{"comparison":"EQUALS","value":"debian"}]}' ``` Ausgabe: ``` { "reportId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333" } ``` Weitere Informationen finden Sie unter [Verwalten von Erkenntnissen in Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/user/findings-managing.html) im *Benutzerhandbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [CreateFindingsReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/create-findings-report.html)in der *AWS CLI Befehlsreferenz*. ### `create-resource-group` Das folgende Codebeispiel zeigt die Verwendung`create-resource-group`. **AWS CLI** **Um eine Ressourcengruppe zu erstellen** Mit dem folgenden `create-resource-group`-Befehl wird eine Ressourcengruppe unter Verwendung des Tag-Schlüssels `Name` und des Werts `example` erstellt: ``` aws inspector create-resource-group --resource-group-tags key=Name,value=example ``` Ausgabe: ``` { "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv" } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsziele“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [CreateResourceGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/create-resource-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-sbom-export` Das folgende Codebeispiel zeigt die Verwendung`create-sbom-export`. **AWS CLI** **So erstellen Sie einen Software-Stücklistenbericht (SBOM)** Im folgenden Beispiel für `create-sbom-export` wird ein Software-Stücklistenbericht (SBOM) erstellt. ``` aws inspector2 create-sbom-export \ --report-format SPDX_2_3 \ --resource-filter-criteria 'ecrRepositoryName=[{comparison="EQUALS",value="debian"}]' \ --s3-destination bucketName=inspector-sbom-123456789012,keyPrefix=sbom-key,kmsKeyArn=arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333 ``` Ausgabe: ``` { "reportId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333" } ``` Weitere Informationen finden Sie unter [Exportieren SBOMs mit Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/user/sbom-export.html) im *Amazon Inspector Inspector-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateSbomExport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/create-sbom-export.html)in der *AWS CLI Befehlsreferenz*. ### `delete-assessment-run` Das folgende Codebeispiel zeigt die Verwendung`delete-assessment-run`. **AWS CLI** **So löschen Sie einen Bewertungslauf** Mit dem folgenden `delete-assessment-run`-Befehl wird der Bewertungslauf mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-11LMTAVe` gelöscht: ``` aws inspector delete-assessment-run --assessment-run-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-11LMTAVe ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [DeleteAssessmentRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/delete-assessment-run.html)in der *AWS CLI Befehlsreferenz*. ### `delete-assessment-target` Das folgende Codebeispiel zeigt die Verwendung`delete-assessment-target`. **AWS CLI** **So löschen Sie ein Bewertungsziel** Der folgende `delete-assessment-target`-Befehl löscht das Bewertungsziel mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq`: ``` aws inspector delete-assessment-target --assessment-target-arn arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsziele“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [DeleteAssessmentTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/delete-assessment-target.html)in der *AWS CLI Befehlsreferenz*. ### `delete-assessment-template` Das folgende Codebeispiel zeigt die Verwendung`delete-assessment-template`. **AWS CLI** **So löschen Sie eine Bewertungsvorlage** Der folgende `delete-assessment-template`-Befehl löscht die Bewertungsvorlage mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T`: ``` aws inspector delete-assessment-template --assessment-template-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [DeleteAssessmentTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/delete-assessment-template.html)in der *AWS CLI Befehlsreferenz*. ### `delete-filter` Das folgende Codebeispiel zeigt die Verwendung`delete-filter`. **AWS CLI** **So löschen Sie einen Filter** Im folgenden Beispiel für `delete-filter` wird ein Filter gelöscht. ``` aws inspector2 delete-filter \ --arn "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444" ``` Ausgabe: ``` { "arn": "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444" } ``` Weitere Informationen finden Sie unter [Filtern von Amazon-Inspector-Erkenntnissen](https://docs.aws.amazon.com/inspector/latest/user/findings-managing-filtering.html) im *Benutzerhandbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [DeleteFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/delete-filter.html)in der *AWS CLI Befehlsreferenz*. ### `describe-assessment-runs` Das folgende Codebeispiel zeigt die Verwendung`describe-assessment-runs`. **AWS CLI** **So beschreiben Sie Bewertungsläufe** Der folgende `describe-assessment-run`-Befehl beschreibt einen Bewertungslauf mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE`: ``` aws inspector describe-assessment-runs --assessment-run-arns arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE ``` Ausgabe: ``` { "assessmentRuns": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw", "completedAt": 1458680301.4, "createdAt": 1458680170.035, "dataCollected": true, "durationInSeconds": 3600, "name": "Run 1 for ExampleAssessmentTemplate", "notifications": [], "rulesPackageArns": [ "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP" ], "startedAt": 1458680170.161, "state": "COMPLETED", "stateChangedAt": 1458680301.4, "stateChanges": [ { "state": "CREATED", "stateChangedAt": 1458680170.035 }, { "state": "START_DATA_COLLECTION_PENDING", "stateChangedAt": 1458680170.065 }, { "state": "START_DATA_COLLECTION_IN_PROGRESS", "stateChangedAt": 1458680170.096 }, { "state": "COLLECTING_DATA", "stateChangedAt": 1458680170.161 }, { "state": "STOP_DATA_COLLECTION_PENDING", "stateChangedAt": 1458680239.883 }, { "state": "DATA_COLLECTED", "stateChangedAt": 1458680299.847 }, { "state": "EVALUATING_RULES", "stateChangedAt": 1458680300.099 }, { "state": "COMPLETED", "stateChangedAt": 1458680301.4 } ], "userAttributesForFindings": [] } ], "failedItems": {} } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [DescribeAssessmentRuns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/describe-assessment-runs.html)in der *AWS CLI Befehlsreferenz*. ### `describe-assessment-targets` Das folgende Codebeispiel zeigt die Verwendung`describe-assessment-targets`. **AWS CLI** **So beschreiben Sie Bewertungsziele** Der folgende `describe-assessment-targets`-Befehl beschreibt das Bewertungsziel mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq`: ``` aws inspector describe-assessment-targets --assessment-target-arns arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq ``` Ausgabe: ``` { "assessmentTargets": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq", "createdAt": 1458074191.459, "name": "ExampleAssessmentTarget", "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI", "updatedAt": 1458074191.459 } ], "failedItems": {} } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsziele“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [DescribeAssessmentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/describe-assessment-targets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-assessment-templates` Das folgende Codebeispiel zeigt die Verwendung`describe-assessment-templates`. **AWS CLI** **So beschreiben Sie Bewertungsvorlagen** Der folgende `describe-assessment-templates`-Befehl beschreibt die Bewertungsvorlage mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw`: ``` aws inspector describe-assessment-templates --assessment-template-arns arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw ``` Ausgabe: ``` { "assessmentTemplates": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw", "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq", "createdAt": 1458074191.844, "durationInSeconds": 3600, "name": "ExampleAssessmentTemplate", "rulesPackageArns": [ "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP" ], "userAttributesForFindings": [] } ], "failedItems": {} } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [DescribeAssessmentTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/describe-assessment-templates.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cross-account-access-role` Das folgende Codebeispiel zeigt die Verwendung`describe-cross-account-access-role`. **AWS CLI** **So beschreiben Sie die Rolle für kontoübergreifenden Zugriff** Der folgende `describe-cross-account-access-role` Befehl beschreibt die IAM-Rolle, die Amazon Inspector den Zugriff auf Ihr AWS Konto ermöglicht: ``` aws inspector describe-cross-account-access-role ``` Ausgabe: ``` { "registeredAt": 1458069182.826, "roleArn": "arn:aws:iam::123456789012:role/inspector", "valid": true } ``` Weitere Informationen finden Sie unter „Einrichten von Amazon Inspector“ im Handbuch für *Amazon Inspector*. + Einzelheiten zur API finden Sie [DescribeCrossAccountAccessRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/describe-cross-account-access-role.html)in der *AWS CLI Befehlsreferenz.* ### `describe-findings` Das folgende Codebeispiel zeigt die Verwendung`describe-findings`. **AWS CLI** **So beschreiben Sie Erkenntnisse** Der folgende `describe-findings`-Befehl beschreibt die Erkenntnis mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4`: ``` aws inspector describe-findings --finding-arns arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4 ``` Ausgabe: ``` { "failedItems": {}, "findings": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4", "assetAttributes": { "ipv4Addresses": [], "schemaVersion": 1 }, "assetType": "ec2-instance", "attributes": [], "confidence": 10, "createdAt": 1458680301.37, "description": "Amazon Inspector did not find any potential security issues during this assessment.", "indicatorOfCompromise": false, "numericSeverity": 0, "recommendation": "No remediation needed.", "schemaVersion": 1, "service": "Inspector", "serviceAttributes": { "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", "rulesPackageArn": "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP", "schemaVersion": 1 }, "severity": "Informational", "title": "No potential security issues found", "updatedAt": 1458680301.37, "userAttributes": [] } ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Erkenntnisse“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [DescribeFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/describe-findings.html)in der *AWS CLI Befehlsreferenz*. ### `describe-resource-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-resource-groups`. **AWS CLI** **So beschreiben Sie Ressourcengruppen** Der folgende `describe-resource-groups`-Befehl beschreibt die Ressourcengruppe mit dem ARN `arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI`: ``` aws inspector describe-resource-groups --resource-group-arns arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI ``` Ausgabe: ``` { "failedItems": {}, "resourceGroups": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI", "createdAt": 1458074191.098, "tags": [ { "key": "Name", "value": "example" } ] } ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsziele“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [DescribeResourceGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/describe-resource-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-rules-packages` Das folgende Codebeispiel zeigt die Verwendung`describe-rules-packages`. **AWS CLI** **So beschreiben Sie Regelpakete** Der folgende `describe-rules-packages`-Befehl beschreibt das Regelpaket mit dem ARN `arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p`: ``` aws inspector describe-rules-packages --rules-package-arns arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p ``` Ausgabe: ``` { "failedItems": {}, "rulesPackages": [ { "arn": "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p", "description": "The rules in this package help verify whether the EC2 instances in your application are exposed to Common Vulnerabilities and Exposures (CVEs). Attacks can exploit unpatched vulnerabilities to compromise the confidentiality, integrity, or availability of your service or data. The CVE system provides a reference for publicly known information security vulnerabilities and exposures. For more information, see [https://cve.mitre.org/](https://cve.mitre.org/). If a particular CVE appears in one of the produced Findings at the end of a completed Inspector assessment, you can search [https://cve.mitre.org/](https://cve.mitre.org/) using the CVE's ID (for example, \"CVE-2009-0021\") to find detailed information about this CVE, its severity, and how to mitigate it. ", "name": "Common Vulnerabilities and Exposures", "provider": "Amazon Web Services, Inc.", "version": "1.1" } ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Regelpakete und -Regeln“ im Handbuch für *Amazon Inspector*. + Einzelheiten zur API finden Sie [DescribeRulesPackages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/describe-rules-packages.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-member` Das folgende Codebeispiel zeigt die Verwendung`disassociate-member`. **AWS CLI** **Beispiel: So heben Sie die Zuordnung eines Mitgliedskontos zu einem delegierten Administrator von Amazon Inspector auf** Im folgenden `disassociate-member` Beispiel wird die Zuordnung eines AWS Kontos zu einem delegierten Amazon Inspector-Administrator aufgehoben. ``` aws inspector2 disassociate-member \ --account-id 123456789012 ``` Ausgabe: ``` { "accountId": "123456789012" } ``` Weitere Informationen finden Sie unter [Verwaltung mehrerer Konten in Amazon Inspector mit AWS Organizations](https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html) im *Amazon Inspector Inspector-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DisassociateMember](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/disassociate-member.html)in der *AWS CLI Befehlsreferenz*. ### `get-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-configuration`. **AWS CLI** **So rufen Sie die Einstellungskonfiguration für Inspector-Scans ab** Im folgenden Beispiel für `get-configuration` wird die Einstellungskonfiguration für Inspector-Scans abgerufen. ``` aws inspector2 get-configuration ``` Ausgabe: ``` { "ec2Configuration": { "scanModeState": { "scanMode": "EC2_HYBRID", "scanModeStatus": "SUCCESS" } }, "ecrConfiguration": { "rescanDurationState": { "pullDateRescanDuration": "DAYS_90", "rescanDuration": "DAYS_30", "status": "SUCCESS", "updatedAt": "2024-05-14T21:16:20.237000+00:00" } } } ``` Weitere Informationen finden Sie unter [Automatisierte Ressourcen-Scans mit Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/user/scanning-resources.html) im *Benutzerhandbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [GetConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/get-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-member` Das folgende Codebeispiel zeigt die Verwendung`get-member`. **AWS CLI** **Beispiel: So rufen Sie Mitgliedsinformationen für Ihre Organisation ab** aws inspector2 get-member --account-id 123456789012 Ausgabe: ``` { "member": { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.520000-07:00" } } ``` Weitere Informationen finden Sie unter [Verwaltung mehrerer Konten in Amazon Inspector mit AWS Organizations](https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html) im *Amazon Inspector Inspector-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetMember](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/get-member.html)in der *AWS CLI Befehlsreferenz*. ### `get-telemetry-metadata` Das folgende Codebeispiel zeigt die Verwendung`get-telemetry-metadata`. **AWS CLI** **So rufen Sie die Telemetrie-Metadaten ab** Der folgende `get-telemetry-metadata`-Befehl generiert Informationen zu den Daten, die für den Bewertungslauf mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE` erfasst werden: ``` aws inspector get-telemetry-metadata --assessment-run-arn arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE ``` Ausgabe: ``` { "telemetryMetadata": [ { "count": 2, "dataSize": 345, "messageType": "InspectorDuplicateProcess" }, { "count": 3, "dataSize": 255, "messageType": "InspectorTimeEventMsg" }, { "count": 4, "dataSize": 1082, "messageType": "InspectorNetworkInterface" }, { "count": 2, "dataSize": 349, "messageType": "InspectorDnsEntry" }, { "count": 11, "dataSize": 2514, "messageType": "InspectorDirectoryInfoMsg" }, { "count": 1, "dataSize": 179, "messageType": "InspectorTcpV6ListeningPort" }, { "count": 101, "dataSize": 10949, "messageType": "InspectorTerminal" }, { "count": 26, "dataSize": 5916, "messageType": "InspectorUser" }, { "count": 282, "dataSize": 32148, "messageType": "InspectorDynamicallyLoadedCodeModule" }, { "count": 18, "dataSize": 10172, "messageType": "InspectorCreateProcess" }, { "count": 3, "dataSize": 8001, "messageType": "InspectorProcessPerformance" }, { "count": 1, "dataSize": 360, "messageType": "InspectorOperatingSystem" }, { "count": 6, "dataSize": 546, "messageType": "InspectorStopProcess" }, { "count": 1, "dataSize": 1553, "messageType": "InspectorInstanceMetaData" }, { "count": 2, "dataSize": 434, "messageType": "InspectorTcpV4Connection" }, { "count": 474, "dataSize": 2960322, "messageType": "InspectorPackageInfo" }, { "count": 3, "dataSize": 2235, "messageType": "InspectorSystemPerformance" }, { "count": 105, "dataSize": 46048, "messageType": "InspectorCodeModule" }, { "count": 1, "dataSize": 182, "messageType": "InspectorUdpV6ListeningPort" }, { "count": 2, "dataSize": 371, "messageType": "InspectorUdpV4ListeningPort" }, { "count": 18, "dataSize": 8362, "messageType": "InspectorKernelModule" }, { "count": 29, "dataSize": 48788, "messageType": "InspectorConfigurationInfo" }, { "count": 1, "dataSize": 79, "messageType": "InspectorMonitoringStart" }, { "count": 5, "dataSize": 0, "messageType": "InspectorSplitMsgBegin" }, { "count": 51, "dataSize": 4593, "messageType": "InspectorGroup" }, { "count": 1, "dataSize": 184, "messageType": "InspectorTcpV4ListeningPort" }, { "count": 1159, "dataSize": 3146579, "messageType": "Total" }, { "count": 5, "dataSize": 0, "messageType": "InspectorSplitMsgEnd" }, { "count": 1, "dataSize": 612, "messageType": "InspectorLoadImageInProcess" } ] } ``` + Einzelheiten zur API finden Sie [GetTelemetryMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/get-telemetry-metadata.html)in der *AWS CLI Befehlsreferenz*. ### `list-account-permissions` Das folgende Codebeispiel zeigt die Verwendung`list-account-permissions`. **AWS CLI** **So listen Sie Kontoberechtigungen auf** Im folgenden Beispiel für `list-account-permissions` werden Ihre Kontoberechtigungen aufgelistet. ``` aws inspector2 list-account-permissions ``` Ausgabe: ``` { "permissions": [ { "operation": "ENABLE_SCANNING", "service": "ECR" }, { "operation": "DISABLE_SCANNING", "service": "ECR" }, { "operation": "ENABLE_REPOSITORY", "service": "ECR" }, { "operation": "DISABLE_REPOSITORY", "service": "ECR" }, { "operation": "ENABLE_SCANNING", "service": "EC2" }, { "operation": "DISABLE_SCANNING", "service": "EC2" }, { "operation": "ENABLE_SCANNING", "service": "LAMBDA" }, { "operation": "DISABLE_SCANNING", "service": "LAMBDA" } ] } ``` Weitere Informationen finden Sie unter [Identitäts- und Zugriffsverwaltung für Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/user/security-iam.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ListAccountPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/list-account-permissions.html)in der *AWS CLI Befehlsreferenz*. ### `list-assessment-run-agents` Das folgende Codebeispiel zeigt die Verwendung`list-assessment-run-agents`. **AWS CLI** **So listen Sie Bewertungslauf-Agenten auf** Der folgende `list-assessment-run-agents`-Befehl listet die Agenten des Bewertungslaufs mit dem angegebenen ARN auf. ``` aws inspector list-assessment-run-agents \ --assessment-run-arn arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE ``` Ausgabe: ``` { "assessmentRunAgents": [ { "agentHealth": "HEALTHY", "agentHealthCode": "HEALTHY", "agentId": "i-49113b93", "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", "telemetryMetadata": [ { "count": 2, "dataSize": 345, "messageType": "InspectorDuplicateProcess" }, { "count": 3, "dataSize": 255, "messageType": "InspectorTimeEventMsg" }, { "count": 4, "dataSize": 1082, "messageType": "InspectorNetworkInterface" }, { "count": 2, "dataSize": 349, "messageType": "InspectorDnsEntry" }, { "count": 11, "dataSize": 2514, "messageType": "InspectorDirectoryInfoMsg" }, { "count": 1, "dataSize": 179, "messageType": "InspectorTcpV6ListeningPort" }, { "count": 101, "dataSize": 10949, "messageType": "InspectorTerminal" }, { "count": 26, "dataSize": 5916, "messageType": "InspectorUser" }, { "count": 282, "dataSize": 32148, "messageType": "InspectorDynamicallyLoadedCodeModule" }, { "count": 18, "dataSize": 10172, "messageType": "InspectorCreateProcess" }, { "count": 3, "dataSize": 8001, "messageType": "InspectorProcessPerformance" }, { "count": 1, "dataSize": 360, "messageType": "InspectorOperatingSystem" }, { "count": 6, "dataSize": 546, "messageType": "InspectorStopProcess" }, { "count": 1, "dataSize": 1553, "messageType": "InspectorInstanceMetaData" }, { "count": 2, "dataSize": 434, "messageType": "InspectorTcpV4Connection" }, { "count": 474, "dataSize": 2960322, "messageType": "InspectorPackageInfo" }, { "count": 3, "dataSize": 2235, "messageType": "InspectorSystemPerformance" }, { "count": 105, "dataSize": 46048, "messageType": "InspectorCodeModule" }, { "count": 1, "dataSize": 182, "messageType": "InspectorUdpV6ListeningPort" }, { "count": 2, "dataSize": 371, "messageType": "InspectorUdpV4ListeningPort" }, { "count": 18, "dataSize": 8362, "messageType": "InspectorKernelModule" }, { "count": 29, "dataSize": 48788, "messageType": "InspectorConfigurationInfo" }, { "count": 1, "dataSize": 79, "messageType": "InspectorMonitoringStart" }, { "count": 5, "dataSize": 0, "messageType": "InspectorSplitMsgBegin" }, { "count": 51, "dataSize": 4593, "messageType": "InspectorGroup" }, { "count": 1, "dataSize": 184, "messageType": "InspectorTcpV4ListeningPort" }, { "count": 1159, "dataSize": 3146579, "messageType": "Total" }, { "count": 5, "dataSize": 0, "messageType": "InspectorSplitMsgEnd" }, { "count": 1, "dataSize": 612, "messageType": "InspectorLoadImageInProcess" } ] } ] } ``` Weitere Informationen finden Sie unter [AWS -Agenten](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_agents.html) im *Benutzerhandbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListAssessmentRunAgents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/list-assessment-run-agents.html)in der *AWS CLI Befehlsreferenz*. ### `list-assessment-runs` Das folgende Codebeispiel zeigt die Verwendung`list-assessment-runs`. **AWS CLI** **So listen Sie Bewertungsläufe auf** Der folgende `list-assessment-runs`-Befehl listet alle vorhandenen Bewertungsläufe auf. ``` aws inspector list-assessment-runs ``` Ausgabe: ``` { "assessmentRunArns": [ "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-v5D6fI3v" ] } ``` Weitere Informationen finden Sie unter [Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_assessments.html) im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListAssessmentRuns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/list-assessment-runs.html)in der *AWS CLI Befehlsreferenz*. ### `list-assessment-targets` Das folgende Codebeispiel zeigt die Verwendung`list-assessment-targets`. **AWS CLI** **So listen Sie Bewertungsziele auf** Der folgende `list-assessment-targets`-Befehl listet alle vorhandenen Bewertungsziele auf: ``` aws inspector list-assessment-targets ``` Ausgabe: ``` { "assessmentTargetArns": [ "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq" ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsziele“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListAssessmentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/list-assessment-targets.html)in der *AWS CLI Befehlsreferenz*. ### `list-assessment-templates` Das folgende Codebeispiel zeigt die Verwendung`list-assessment-templates`. **AWS CLI** **So listen Sie Bewertungsvorlagen auf** Der folgende `list-assessment-templates`-Befehl listet alle vorhandenen Bewertungsvorlagen auf: ``` aws inspector list-assessment-templates ``` Ausgabe: ``` { "assessmentTemplateArns": [ "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw", "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-Uza6ihLh" ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListAssessmentTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/list-assessment-templates.html)in der *AWS CLI Befehlsreferenz*. ### `list-coverage-statistics` Das folgende Codebeispiel zeigt die Verwendung`list-coverage-statistics`. **AWS CLI** **Beispiel 1: So listen Sie Statistiken zur Abdeckung nach Gruppen auf** Das folgende `list-coverage-statistics` Beispiel listet die Deckungsstatistiken Ihrer AWS Umgebung nach Gruppen auf. ``` aws inspector2 list-coverage-statistics \ --group-by RESOURCE_TYPE ``` Ausgabe: ``` { "countsByGroup": [ { "count": 56, "groupKey": "AWS_LAMBDA_FUNCTION" }, { "count": 27, "groupKey": "AWS_ECR_REPOSITORY" }, { "count": 18, "groupKey": "AWS_EC2_INSTANCE" }, { "count": 3, "groupKey": "AWS_ECR_CONTAINER_IMAGE" }, { "count": 1, "groupKey": "AWS_ACCOUNT" } ], "totalCounts": 105 } ``` Weitere Informationen finden Sie unter [Bewertung der Amazon Inspector Inspector-Abdeckung Ihrer AWS Umgebung](https://docs.aws.amazon.com/inspector/latest/user/assessing-coverage.html) im *Amazon Inspector Inspector-Benutzerhandbuch*. **Beispiel 2: So listen Sie Statistiken zur Abdeckung nach Ressourcentyp auf** Das folgende `list-coverage-statistics` Beispiel listet die Abdeckungsstatistiken Ihrer AWS Umgebung nach Ressourcentyp auf. ``` aws inspector2 list-coverage-statistics --filter-criteria '{"resourceType":[{"comparison":"EQUALS","value":"AWS_ECR_REPOSITORY"}]}' --group-by SCAN_STATUS_REASON ``` Ausgabe: ``` { "countsByGroup": [ { "count": 27, "groupKey": "SUCCESSFUL" } ], "totalCounts": 27 } ``` Weitere Informationen finden Sie unter [Bewertung der Amazon Inspector Inspector-Abdeckung Ihrer AWS Umgebung](https://docs.aws.amazon.com/inspector/latest/user/assessing-coverage.html) im *Amazon Inspector Inspector-Benutzerhandbuch*. **Beispiel 3: So listen Sie Statistiken zur Abdeckung nach dem Namen des ECR-Repositorys auf** Das folgende `list-coverage-statistics` Beispiel listet die Abdeckungsstatistiken Ihrer AWS Umgebung nach dem Namen des ECR-Repositorys auf. ``` aws inspector2 list-coverage-statistics --filter-criteria '{"ecrRepositoryName":[{"comparison":"EQUALS","value":"debian"}]}' --group-by SCAN_STATUS_REASON ``` Ausgabe: ``` { "countsByGroup": [ { "count": 3, "groupKey": "SUCCESSFUL" } ], "totalCounts": 3 } ``` Weitere Informationen finden Sie unter [Bewertung der Amazon Inspector Inspector-Abdeckung Ihrer AWS Umgebung](https://docs.aws.amazon.com/inspector/latest/user/assessing-coverage.html) im *Amazon Inspector Inspector-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListCoverageStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/list-coverage-statistics.html)unter *AWS CLI Befehlsreferenz*. ### `list-coverage` Das folgende Codebeispiel zeigt die Verwendung`list-coverage`. **AWS CLI** **Beispiel 1: So listen Sie Details zur Abdeckung für Ihre Umgebung auf** Im folgenden Beispiel für `list-coverage` werden die Details zur Abdeckung für Ihre Umgebung aufgelistet. ``` aws inspector2 list-coverage ``` Ausgabe: ``` { "coveredResources": [ { "accountId": "123456789012", "lastScannedAt": "2024-05-20T16:23:20-07:00", "resourceId": "i-EXAMPLE55555555555", "resourceMetadata": { "ec2": { "amiId": "ami-EXAMPLE6666666666", "platform": "LINUX" } }, "resourceType": "AWS_EC2_INSTANCE", "scanStatus": { "reason": "SUCCESSFUL", "statusCode": "ACTIVE" }, "scanType": "PACKAGE" } ] } ``` **Beispiel 2: So listen Sie Details zur Abdeckung für den Ressourcentyp der Lambda-Funktion auf** Das folgende `list-coverage` Beispiel listet die Ressourcentypdetails Ihrer Lambda-Funktion auf. ``` aws inspector2 list-coverage --filter-criteria '{"resourceType":[{"comparison":"EQUALS","value":"AWS_LAMBDA_FUNCTION"}]}' ``` Ausgabe: ``` { "coveredResources": [ { "accountId": "123456789012", "resourceId": "arn:aws:lambda:us-west-2:123456789012:function:Eval-container-scan-results:$LATEST", "resourceMetadata": { "lambdaFunction": { "functionName": "Eval-container-scan-results", "functionTags": {}, "layers": [], "runtime": "PYTHON_3_7" } }, "resourceType": "AWS_LAMBDA_FUNCTION", "scanStatus": { "reason": "SUCCESSFUL", "statusCode": "ACTIVE" }, "scanType": "CODE" } ] } ``` + Einzelheiten zur API finden Sie [ListCoverage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/list-coverage.html)in der *AWS CLI Befehlsreferenz.* ### `list-delegated-admin-accounts` Das folgende Codebeispiel zeigt die Verwendung`list-delegated-admin-accounts`. **AWS CLI** **So listen Sie Informationen über das Konto des delegierten Administrators Ihrer Organisation auf** Im folgenden Beispiel für `list-delegated-admin-accounts` werden Informationen über das Konto des delegierten Administrators Ihrer Organisation aufgelistet. ``` aws inspector2 list-delegated-admin-accounts ``` Ausgabe: ``` { "delegatedAdminAccounts": [ { "accountId": "123456789012", "status": "ENABLED" } ] } ``` Weitere Informationen finden Sie unter [Designieren eines delegierten Administrators für Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/user/admin-member-relationship.html) im *Benutzerhandbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListDelegatedAdminAccounts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/list-delegated-admin-accounts.html)in der *AWS CLI Befehlsreferenz*. ### `list-event-subscriptions` Das folgende Codebeispiel zeigt die Verwendung`list-event-subscriptions`. **AWS CLI** **So listen Sie Ereignisabonnements auf** Der folgende `list-event-subscriptions`-Befehl listet alle Ereignisabonnements für die Bewertungsvorlage mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0` auf: ``` aws inspector list-event-subscriptions --resource-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0 ``` Ausgabe: ``` { "subscriptions": [ { "eventSubscriptions": [ { "event": "ASSESSMENT_RUN_COMPLETED", "subscribedAt": 1459455440.867 } ], "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0", "topicArn": "arn:aws:sns:us-west-2:123456789012:exampletopic" } ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListEventSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/list-event-subscriptions.html)in der *AWS CLI Befehlsreferenz*. ### `list-filters` Das folgende Codebeispiel zeigt die Verwendung`list-filters`. **AWS CLI** **So listen Sie Filter auf, die mit dem Konto verknüpft sind, mit dem Sie Amazon Inspector aktiviert haben** In den folgenden Beispielen für `list-filters` werden Filter aufgelistet, die mit dem Konto verknüpft sind, mit dem Sie Amazon Inspector aktiviert haben. ``` aws inspector2 list-filters ``` Ausgabe: ``` { "filters": [ { "action": "SUPPRESS", "arn": "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444", "createdAt": "2024-05-15T21:11:08.602000+00:00", "criteria": { "resourceType": [ { "comparison": "EQUALS", "value": "AWS_EC2_INSTANCE" }, ] }, "description": "This suppression rule omits EC2 instance type findings", "name": "ExampleSuppressionRuleEC2", "ownerId": "o-EXAMPLE222", "tags": {}, "updatedAt": "2024-05-15T21:11:08.602000+00:00" }, { "action": "SUPPRESS", "arn": "arn:aws:inspector2:us-east-1:813737243517:owner/o-EXAMPLE222/filter/EXAMPLE444444444", "createdAt": "2024-05-15T21:28:27.054000+00:00", "criteria": { "resourceType": [ { "comparison": "EQUALS", "value": "AWS_ECR_INSTANCE" } ] }, "description": "This suppression rule omits ECR instance type findings", "name": "ExampleSuppressionRuleECR", "ownerId": "o-EXAMPLE222", "tags": {}, "updatedAt": "2024-05-15T21:28:27.054000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Filtern von Amazon-Inspector-Erkenntnissen](https://docs.aws.amazon.com/inspector/latest/user/findings-managing-filtering.html) im *Benutzerhandbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListFilters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/list-filters.html)in der *AWS CLI Befehlsreferenz*. ### `list-findings` Das folgende Codebeispiel zeigt die Verwendung`list-findings`. **AWS CLI** **So listen Sie Erkenntnisse auf** Der folgende `list-findings`-Befehl listet alle generierten Erkenntnisse auf: ``` aws inspector list-findings ``` Ausgabe: ``` { "findingArns": [ "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4", "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-v5D6fI3v/finding/0-tyvmqBLy" ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Erkenntnisse“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/list-findings.html)in der *AWS CLI Befehlsreferenz*. ### `list-members` Das folgende Codebeispiel zeigt die Verwendung`list-members`. **AWS CLI** **Beispiel 1: So listen Sie alle Mitgliedskonten auf, die dem delegierten Administrator von Amazon Inspector für Ihre Organisation zugeordnet sind** aws inspector2 list-members --only-associated Ausgabe: ``` { { "members": [ { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.520000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2024-08-12T10:13:01.472000-07:00" }, { "accountId": "625032911453", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.438000-07:00" }, { "accountId": "715411239211", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2024-04-24T09:14:57.471000-07:00" } ] } ``` Weitere Informationen finden Sie unter [Verwaltung mehrerer Konten in Amazon Inspector mit AWS Organizations](https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html) im *Amazon Inspector Inspector-Benutzerhandbuch*. **Beispiel 2: So listen Sie alle Mitgliedskonten auf, die dem delegierten Administrator von Amazon Inspector für Ihre Organisation zugeordnet sind und deren Zuordnung aufgehoben wurde** Mitglieder der Liste aws inspector2 -- no-only-associated Ausgabe: ``` { { "members": [ { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "REMOVED", "updatedAt": "2024-05-15T11:34:53.326000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.520000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2024-08-12T10:13:01.472000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.438000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2024-04-24T09:14:57.471000-07:00" } ] } ``` Weitere Informationen finden Sie unter [Verwaltung mehrerer Konten in Amazon Inspector mit AWS Organizations](https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html) im *Amazon Inspector Inspector-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/list-members.html)in der *AWS CLI Befehlsreferenz*. ### `list-rules-packages` Das folgende Codebeispiel zeigt die Verwendung`list-rules-packages`. **AWS CLI** **So listen Sie Regelpakete auf** Der folgende `list-rules-packages`-Befehl listet alle verfügbaren Inspector-Regelpakete auf: ``` aws inspector list-rules-packages ``` Ausgabe: ``` { "rulesPackageArns": [ "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p", "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-H5hpSawc", "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-JJOtZiqQ", "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-vg5GGHSD" ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Regelpakete und -Regeln“ im Handbuch für *Amazon Inspector*. + Einzelheiten zur API finden Sie [ListRulesPackages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/list-rules-packages.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für Ressourcen auf** Der folgende `list-tags-for-resource`-Befehl listet alle Tags auf, die mit der Bewertungsvorlage mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-gcwFliYu` verknüpft sind: ``` aws inspector list-tags-for-resource --resource-arn arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-gcwFliYu ``` Ausgabe: ``` { "tags": [ { "key": "Name", "value": "Example" } ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-usage-totals` Das folgende Codebeispiel zeigt die Verwendung`list-usage-totals`. **AWS CLI** **So listen Sie die Gesamtnutzungswerte für die letzten 30 Tage auf** In den folgenden Beispielen für `list-usage-totals` werden die Gesamtnutzungswerte für die letzten 30 Tage aufgeführt. ``` aws inspector2 list-usage-totals ``` Ausgabe: ``` { "totals": [ { "accountId": "123456789012", "usage": [ { "currency": "USD", "estimatedMonthlyCost": 4.6022044647, "total": 1893.4784083333334, "type": "EC2_AGENTLESS_INSTANCE_HOURS" }, { "currency": "USD", "estimatedMonthlyCost": 18.892449279, "total": 10882.050784722222, "type": "EC2_INSTANCE_HOURS" }, { "currency": "USD", "estimatedMonthlyCost": 5.4525363736, "total": 6543.043648333333, "type": "LAMBDA_FUNCTION_CODE_HOURS" }, { "currency": "USD", "estimatedMonthlyCost": 3.9064080309, "total": 9375.379274166668, "type": "LAMBDA_FUNCTION_HOURS" }, { "currency": "USD", "estimatedMonthlyCost": 0.06, "total": 6.0, "type": "ECR_RESCAN" }, { "currency": "USD", "estimatedMonthlyCost": 0.09, "total": 1.0, "type": "ECR_INITIAL_SCAN" } ] } ] } ``` Weitere Informationen finden Sie unter [Überwachung der Nutzung und der Kosten in Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/user/usage.html) im *Benutzerhandbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [ListUsageTotals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/list-usage-totals.html)in der *AWS CLI Befehlsreferenz*. ### `preview-agents` Das folgende Codebeispiel zeigt die Verwendung`preview-agents`. **AWS CLI** **So zeigen Sie eine Vorschau von Agenten an** Der folgende `preview-agents`-Befehl zeigt eine Vorschau der Agenten an, die auf den EC2-Instances installiert sind, die Teil des Bewertungsziels mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq` sind: ``` aws inspector preview-agents --preview-agents-arn arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq ``` Ausgabe: ``` { "agentPreviews": [ { "agentId": "i-49113b93" } ] } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsziele“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [PreviewAgents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/preview-agents.html)in der *AWS CLI Befehlsreferenz*. ### `register-cross-account-access-role` Das folgende Codebeispiel zeigt die Verwendung`register-cross-account-access-role`. **AWS CLI** **So registrieren Sie die Rolle für kontoübergreifenden Zugriff** Der folgende `register-cross-account-access-role`-Befehl registriert die IAM-Rolle mit dem ARN `arn:aws:iam::123456789012:role/inspector`, die Amazon Inspector verwendet, um Ihre EC2-Instances zu Beginn des Bewertungslaufs oder beim Aufrufen des Befehls zur Vorschau von Agenten aufzulisten: ``` aws inspector register-cross-account-access-role --role-arn arn:aws:iam::123456789012:role/inspector ``` Weitere Informationen finden Sie unter „Einrichten von Amazon Inspector“ im Handbuch für *Amazon Inspector*. + Einzelheiten zur API finden Sie [RegisterCrossAccountAccessRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/register-cross-account-access-role.html)in der *AWS CLI Befehlsreferenz*. ### `remove-attributes-from-findings` Das folgende Codebeispiel zeigt die Verwendung`remove-attributes-from-findings`. **AWS CLI** **So entfernen Sie Attribute aus Erkenntnissen** Der folgende `remove-attributes-from-finding`-Befehl entfernt das Attribut mit dem Schlüssel `Example` und dem Wert `example` aus der Erkenntnis mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU`: ``` aws inspector remove-attributes-from-findings --finding-arns arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU --attribute-keys key=Example,value=example ``` Ausgabe: ``` { "failedItems": {} } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Erkenntnisse“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [RemoveAttributesFromFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/remove-attributes-from-findings.html)in der *AWS CLI Befehlsreferenz*. ### `set-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`set-tags-for-resource`. **AWS CLI** **So legen Sie Tags für eine Ressource fest** Mit dem folgenden `set-tags-for-resource`-Befehl wird das Tag mit dem Schlüssel `Example` und dem Wert `example` für die Bewertungsvorlage mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0` festgelegt: ``` aws inspector set-tags-for-resource --resource-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0 --tags key=Example,value=example ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [SetTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/set-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `start-assessment-run` Das folgende Codebeispiel zeigt die Verwendung`start-assessment-run`. **AWS CLI** **So starten Sie einen Bewertungslauf** Mit dem folgenden `start-assessment-run`-Befehl wird der Bewertungslauf mit dem Namen `examplerun` anhand der Bewertungsvorlage mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T` gestartet: ``` aws inspector start-assessment-run --assessment-run-name examplerun --assessment-template-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T ``` Ausgabe: ``` { "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-jOoroxyY" } ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [StartAssessmentRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/start-assessment-run.html)in der *AWS CLI Befehlsreferenz*. ### `stop-assessment-run` Das folgende Codebeispiel zeigt die Verwendung`stop-assessment-run`. **AWS CLI** **So beenden Sie einen Bewertungslauf** Der folgende `stop-assessment-run`-Befehl beendet den Bewertungslauf mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-jOoroxyY`: ``` aws inspector stop-assessment-run --assessment-run-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-jOoroxyY ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [StopAssessmentRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/stop-assessment-run.html)in der *AWS CLI Befehlsreferenz*. ### `subscribe-to-event` Das folgende Codebeispiel zeigt die Verwendung`subscribe-to-event`. **AWS CLI** **So abonnieren Sie ein Ereignis** Im folgenden Beispiel wird das Senden von Amazon-SNS-Benachrichtigungen über das Ereignis `ASSESSMENT_RUN_COMPLETED` an das Thema mit dem ARN `arn:aws:sns:us-west-2:123456789012:exampletopic` ermöglicht ``` aws inspector subscribe-to-event \ --event ASSESSMENT_RUN_COMPLETED \ --resource-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0 \ --topic-arn arn:aws:sns:us-west-2:123456789012:exampletopic ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_assessments.html) im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [SubscribeToEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/subscribe-to-event.html)in der *AWS CLI Befehlsreferenz*. ### `unsubscribe-from-event` Das folgende Codebeispiel zeigt die Verwendung`unsubscribe-from-event`. **AWS CLI** **So melden Sie sich von einem Ereignis ab** Der folgende `unsubscribe-from-event`-Befehl deaktiviert das Senden von Amazon-SNS-Benachrichtigungen über das Ereignis `ASSESSMENT_RUN_COMPLETED` an das Thema mit dem ARN `arn:aws:sns:us-west-2:123456789012:exampletopic`: ``` aws inspector unsubscribe-from-event --event ASSESSMENT_RUN_COMPLETED --resource-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0 --topic arn:aws:sns:us-west-2:123456789012:exampletopic ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsvorlagen und -Bewertungsläufe“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [UnsubscribeFromEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/unsubscribe-from-event.html)in der *AWS CLI Befehlsreferenz*. ### `update-assessment-target` Das folgende Codebeispiel zeigt die Verwendung`update-assessment-target`. **AWS CLI** **So aktualisieren Sie ein Bewertungsziel** Der folgende `update-assessment-target`-Befehl aktualisiert das Bewertungsziel mit dem ARN `arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX` und dem Namen `Example` sowie die Ressourcengruppe mit dem ARN `arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-yNbgL5Pt`: ``` aws inspector update-assessment-target --assessment-target-arn arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX --assessment-target-name Example --resource-group-arn arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-yNbgL5Pt ``` Weitere Informationen finden Sie unter „Amazon-Inspector-Bewertungsziele“ im *Handbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [UpdateAssessmentTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/update-assessment-target.html)in der *AWS CLI Befehlsreferenz*. ### `update-filter` Das folgende Codebeispiel zeigt die Verwendung`update-filter`. **AWS CLI** **So aktualisieren Sie einen Filter** Im folgenden Beispiel für `update-filter` wird ein Filter so aktualisiert, dass Lambda-Erkenntnisse anstelle von ECR-Instance-Erkenntnissen ausgelassen werden. ``` aws inspector2 update-filter \ --filter-arn "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444" \ --name "ExampleSuppressionRuleLambda" \ --description "This suppression rule omits Lambda instance findings" \ --reason "Updating filter to omit Lambda instance findings instead of ECR instance findings" ``` Ausgabe: ``` { "filters": [ { "action": "SUPPRESS", "arn": "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444", "createdAt": "2024-05-15T21:28:27.054000+00:00", "criteria": { "resourceType": [ { "comparison": "EQUALS", "value": "AWS_ECR_INSTANCE" } ] }, "description": "This suppression rule omits Lambda instance findings", "name": "ExampleSuppressionRuleLambda", "ownerId": "o-EXAMPLE222", "reason": "Updating filter to omit Lambda instance findings instead of ECR instance findings", "tags": {}, "updatedAt": "2024-05-15T22:23:13.665000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Erkenntnissen in Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/user/findings-managing.html) im *Benutzerhandbuch für Amazon Inspector*. + Einzelheiten zur API finden Sie [UpdateFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector2/update-filter.html)in der *AWS CLI Befehlsreferenz*. # AWS IoT Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `accept-certificate-transfer` Das folgende Codebeispiel zeigt, wie Sie`accept-certificate-transfer`. **AWS CLI** **Um ein Gerätezertifikat zu akzeptieren, das von einem anderen AWS Konto übertragen wurde** Das folgende `accept-certificate-transfer` Beispiel akzeptiert ein Gerätezertifikat, das von einem anderen AWS Konto übertragen wurde. Das Zertifikat wird durch seine ID identifiziert. ``` aws iot accept-certificate-transfer \ --certificate-id 488b6a7f2acdeb00a77384e63c4e40b18bEXAMPLEe57b7272ba44c45e3448142 ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Übertragen eines Zertifikats in ein anderes Konto](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [AcceptCertificateTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/accept-certificate-transfer.html)in der *AWS CLI Befehlsreferenz*. ### `add-thing-to-billing-group` Das folgende Codebeispiel zeigt die Verwendung`add-thing-to-billing-group`. **AWS CLI** **Beispiel 1: So fügen Sie einer Abrechnungsgruppe ein Objekt nach Namen hinzu** Im folgenden Beispiel für `add-thing-to-billing-group` wird das Objekt mit dem Namen `MyLightBulb` zur Abrechnungsgruppe mit dem Namen `GroupOne` hinzugefügt. ``` aws iot add-thing-to-billing-group \ --billing-group-name GroupOne \ --thing-name MyLightBulb ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So fügen Sie einer Abrechnungsgruppe ein Objekt nach ARN hinzu** Im folgenden Beispiel für `add-thing-to-billing-group` wird ein Objekt mit einem angegeben ARN zu einer Abrechnungsgruppe mit dem angegebenen ARN hinzugefügt. Die Angabe eines ARN ist hilfreich, wenn Sie mit mehreren AWS Regionen oder Konten arbeiten. Auf diese Weise können Sie sicherstellen, dass Sie Objekte zur richtigen Region und zum richtigen Konto hinzufügen. ``` aws iot add-thing-to-thing-group \ --billing-group-arn "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne" \ --thing-arn "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Abrechnungsgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [AddThingToBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/add-thing-to-billing-group.html)in der *AWS CLI Befehlsreferenz*. ### `add-thing-to-thing-group` Das folgende Codebeispiel zeigt die Verwendung`add-thing-to-thing-group`. **AWS CLI** **So fügen Sie einer Gruppe ein Objekt hinzu** Im folgenden Beispiel für `add-thing-to-thing-group` wird das angegebene Objekt zur angegebenen Objektgruppe hinzugefügt. ``` aws iot add-thing-to-thing-group \ --thing-name MyLightBulb \ --thing-group-name LightBulbs ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [AddThingToThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/add-thing-to-thing-group.html)in der *AWS CLI Befehlsreferenz*. ### `associate-targets-with-job` Das folgende Codebeispiel zeigt die Verwendung`associate-targets-with-job`. **AWS CLI** **So weisen Sie einer Objektgruppe einen kontinuierlichen Auftrag zu** Im folgenden Beispiel für `associate-targets-with-job` wird die angegebene Objektgruppe mit dem angegebenen kontinuierlichen Auftrag verknüpft. ``` aws iot associate-targets-with-job \ --targets "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \ --job-id "example-job-04" ``` Ausgabe: ``` { "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-04", "jobId": "example-job-04", "description": "example continuous job" } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [AssociateTargetsWithJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/associate-targets-with-job.html)in der *AWS CLI Befehlsreferenz*. ### `attach-policy` Das folgende Codebeispiel zeigt die Verwendung`attach-policy`. **AWS CLI** **Beispiel 1: So hängen Sie eine Richtlinie an eine Objektgruppe an** Im folgenden Beispiel für `attach-policy` wird die angegebene Richtlinie an eine durch ihren ARN identifizierte Objektgruppe angehängt. ``` aws iot attach-policy \ --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \ --policy-name "UpdateDeviceCertPolicy" ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. **Beispiel 2: So hängen Sie eine Richtlinie an ein Zertifikat an** Im folgenden Beispiel für `attach-policy` wird die Richtlinie `UpdateDeviceCertPolicy` an den durch ein Zertifikat angegebenen Prinzipal angehängt. ``` aws iot attach-policy \ --policy-name UpdateDeviceCertPolicy \ --target "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e" ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Anhängen einer AWS IoT-Richtlinie an ein Gerätezertifikat](https://docs.aws.amazon.com/iot/latest/developerguide/attach-policy-to-certificate.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [AttachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-policy.html)in der *AWS CLI Befehlsreferenz*. ### `attach-security-profile` Das folgende Codebeispiel zeigt die Verwendung`attach-security-profile`. **AWS CLI** **So ordnen Sie allen nicht registrierten Geräten ein Sicherheitsprofil zu** Im folgenden `attach-security-profile` Beispiel wird das AWS angegebene IoT Device Defender-Sicherheitsprofil `Testprofile` allen nicht registrierten Geräten in der `us-west-2` Region für dieses AWS Konto zugeordnet. ``` aws iot attach-security-profile \ --security-profile-name Testprofile \ --security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/unregistered-things" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [AttachSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-security-profile.html)in der *AWS CLI Befehlsreferenz.* ### `attach-thing-principal` Das folgende Codebeispiel zeigt die Verwendung`attach-thing-principal`. **AWS CLI** **So hängen Sie Ihrem Objekt ein Zertifikat an** Im folgenden `attach-thing-principal` Beispiel wird ein Zertifikat an das MyTemperatureSensor Ding angehängt. Das Zertifikat wird durch einen ARN identifiziert. Sie finden den ARN für ein Zertifikat in der AWS IoT-Konsole. ``` aws iot attach-thing-principal \ --thing-name MyTemperatureSensor \ --principal arn:aws:iot:us-west-2:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Objektverwaltung mit der Registry](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [AttachThingPrincipal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-thing-principal.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-audit-mitigation-actions-task` Das folgende Codebeispiel zeigt die Verwendung`cancel-audit-mitigation-actions-task`. **AWS CLI** **So brechen Sie eine Audit-Abhilfemaßnahme ab** Im folgenden Beispiel für `cancel-audit-mitigations-action-task` wird die Anwendung von Abhilfemaßnahmen für die angegebene Aufgabe abgebrochen. Sie können keine Aufgaben abbrechen, die bereits abgeschlossen sind. ``` aws iot cancel-audit-mitigation-actions-task --task-id "myActionsTaskId" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [CancelAuditMitigationActionsTask (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-CancelAuditMitigationActionsTask) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [CancelAuditMitigationActionsTask AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-audit-mitigation-actions-task.html)*Befehlsreferenz.* ### `cancel-audit-task` Das folgende Codebeispiel zeigt die Verwendung`cancel-audit-task`. **AWS CLI** **So brechen Sie eine Audit-Aufgabe ab** Im folgenden Beispiel für `cancel-audit-task` wird eine Audit-Aufgabe mit der angegebenen Aufgaben-ID abgebrochen. Sie können eine abgeschlossene Aufgabe nicht abbrechen. ``` aws iot cancel-audit-task \ --task-id a3aea009955e501a31b764abe1bebd3d ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CancelAuditTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-audit-task.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-certificate-transfer` Das folgende Codebeispiel zeigt die Verwendung`cancel-certificate-transfer`. **AWS CLI** **Um die Übertragung eines Zertifikats auf ein anderes AWS Konto abzubrechen** Im folgenden Beispiel für `cancel-certificate-transfer` wird die Übertragung des angegebenen Zertifikats abgebrochen. Das Zertifikat wird durch eine Zertifikat-ID identifiziert. Sie finden die ID für ein Zertifikat in der AWS IoT-Konsole. ``` aws iot cancel-certificate-transfer \ --certificate-id f0f33678c7c9a046e5cc87b2b1a58dfa0beec26db78addd5e605d630e05c7fc8 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Übertragen eines Zertifikats in ein anderes Konto](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [CancelCertificateTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-certificate-transfer.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-job-execution` Das folgende Codebeispiel zeigt die Verwendung`cancel-job-execution`. **AWS CLI** **So brechen Sie eine Auftragsausführung auf einem Gerät ab** Im folgenden Beispiel für `cancel-job-execution` wird die Ausführung des angegebenen Auftrags auf einem Gerät abgebrochen. Wenn sich der Auftrag nicht im Status `QUEUED` befindet, müssen Sie den Parameter `--force` hinzufügen. ``` aws iot cancel-job-execution \ --job-id "example-job-03" \ --thing-name "MyRPi" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CancelJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-job-execution.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-job` Das folgende Codebeispiel zeigt die Verwendung`cancel-job`. **AWS CLI** **So brechen Sie einen Auftrag ab** Im folgenden Beispiel für `cancel-job` wird der angegebene Auftrag abgebrochen. ``` aws iot cancel-job \ --job-job "example-job-03" ``` Ausgabe: ``` { "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-03", "jobId": "example-job-03", "description": "example job test" } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CancelJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-job.html)in der *AWS CLI Befehlsreferenz*. ### `clear-default-authorizer` Das folgende Codebeispiel zeigt die Verwendung`clear-default-authorizer`. **AWS CLI** **So löschen Sie den Standard-Genehmiger** Im folgenden Beispiel für `clear-default-authorizer` wird der aktuell konfigurierte benutzerdefinierte Standardgenehmiger gelöscht. Nachdem Sie diesen Befehl ausgeführt haben, gibt es keinen Standardgenehmiger mehr. Wenn Sie einen benutzerdefinierten Genehmiger verwenden, müssen Sie ihn in den HTTP-Anforderungsheadern namentlich angeben. ``` aws iot clear-default-authorizer ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [ClearDefaultAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_ClearDefaultAuthorizer.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ClearDefaultAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/clear-default-authorizer.html)in der *AWS CLI Befehlsreferenz*. ### `confirm-topic-rule-destination` Das folgende Codebeispiel zeigt die Verwendung`confirm-topic-rule-destination`. **AWS CLI** **So bestätigen Sie ein Themenregelziel** Im folgenden Beispiel für `confirm-topic-rule-destination` wird das Ziel einer Themenregel mit einem Bestätigungstoken bestätigt, das an einem HTTP-Endpunkt empfangen wurde. ``` aws iot confirm-topic-rule-destination \ --confirmation-token "AYADeIcmtq-ZkxfpiWIQqHWM5ucAXwABABVhd3MtY3J5cHRvLXB1YmxpYy1rZXkAREFxY1E0UmlGeDg0V21BZWZ1VjZtZWFRVUJJUktUYXJaN09OZlJOczJhRENSZmZYL3JHZC9PR3NNcis5T3ZlSitnQT09AAEAB2F3cy1rbXMAS2Fybjphd3M6a21zOnVzLWVhc3QtMTo5ODc5NTE4NTI0OTk6a2V5L2U4YmU3ODViLTU5NWMtNDcxYi1iOWJmLWQ2Y2I4ZjQxODlmNwC4AQIBAHhwz48UWTGWE1ua0P8U1hj27nsFzEaAdf6Hs2K_7wBheAF62zwMuk_A4dPiC6eyPGuMAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQM9vtRMpf9D3CiZ8sMAgEQgDuFd0Txy-aywpPqg8YEsa1lD4B40aJ2s1wEHKMybiF1RoOZzYisI0IvslzQY5UmCkqq3tV-3f7-nKfosgIAAAAADAAAEAAAAAAAAAAAAAAAAAAi9RMgy-V19V9m6Iw2xfbw_____wAAAAEAAAAAAAAAAAAAAAEAAAB1hw4SokgUcxiJ3gTO6n50NLJVpzyQR1UmPIj5sShqXEQGcOsWmXzpYOOx_PWyPVNsIFHApyK7Cc3g4bW8VaLVwOLkC83g6YaZAh7dFEl2-iufgrzTePl8RZYOWr0O6Aj9DiVzJZx-1iD6Pu-G6PUw1kaO7Knzs2B4AD0qfrHUF4pYRTvyUgBnMGUCMQC8ZRmhKqntd_c6Kgrow3bMUDBvNqo2qZr8Z8Jm2rzgseROlAnLgFLGpGShr99oSZkCMEd1v62NBRKX9HQXnybyF3fkg__-PIetJ803Z4IlIlF8xXlcdPGP-PV1dOXFemyL8g" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Bestätigen eines Themenregelziels](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#confirm-destination) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ConfirmTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/confirm-topic-rule-destination.html)in der *AWS CLI Befehlsreferenz*. ### `create-audit-suppression` Das folgende Codebeispiel zeigt die Verwendung`create-audit-suppression`. **AWS CLI** **So erstellen Sie die Unterdrückung einer Audit-Erkenntnis** Im folgenden `create-audit-suppression` Beispiel wird eine Prüfung erstellt, bei der die Unterdrückung einer Richtlinie mit dem Namen "virtualMachinePolicy" festgestellt wurde, die als zu freizügig gekennzeichnet wurde. ``` aws iot create-audit-suppression \ --check-name IOT_POLICY_OVERLY_PERMISSIVE_CHECK \ --resource-identifier policyVersionIdentifier={"policyName"="virtualMachinePolicy","policyVersionId"="1"} \ --no-suppress-indefinitely \ --expiration-date 2020-10-20 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Unterdrückungen von Prüfergebnissen](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) im *Entwicklerhandbuch für AWS IoT*. + *Einzelheiten zur API finden Sie unter [CreateAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-audit-suppression.html)Befehlsreferenz.AWS CLI * ### `create-authorizer` Das folgende Codebeispiel zeigt die Verwendung`create-authorizer`. **AWS CLI** **So erstellen Sie einen benutzerdefinierten Genehmiger** Im folgenden Beispiel für `create-authorizer` wird ein benutzerdefinierter Genehmiger erstellt, der die angegebene Lambda-Funktion als Teil eines benutzerdefinierten Authentifizierungsservices verwendet. ``` aws iot create-authorizer \ --authorizer-name "CustomAuthorizer" \ --authorizer-function-arn "arn:aws:lambda:us-west-2:123456789012:function:CustomAuthorizerFunction" \ --token-key-name "MyAuthToken" \ --status ACTIVE \ --token-signing-public-keys FIRST_KEY="-----BEGIN PUBLIC KEY----- MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1uJOB4lQPgG/lM6ZfIwo Z+7ENxAio9q6QD4FFqjGZsvjtYwjoe1RKK0U8Eq9xb5O3kRSmyIwTzwzm/f4Gf0Y ZUloJ+t3PUUwHrmbYTAgTrCUgRFygjfgVwGCPs5ZAX4Eyqt5cr+AIHIiUDbxSa7p zwOBKPeic0asNJpqT8PkBbRaKyleJh5oo81NDHHmVtbBm5A5YiJjqYXLaVAowKzZ +GqsNvAQ9Jy1wI2VrEa1OfL8flDB/BJLm7zjpfPOHDJQgID0XnZwAlNnZcOhCwIx 50g2LW2Oy9R/dmqtDmJiVP97Z4GykxPvwlYHrUXY0iW1R3AR/Ac1NhCTGZMwVDB1 lQIDAQAB -----END PUBLIC KEY-----" ``` Ausgabe: ``` { "authorizerName": "CustomAuthorizer", "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2" } ``` Weitere Informationen finden Sie [CreateAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateAuthorizer.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [CreateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-authorizer.html)in der *AWS CLI Befehlsreferenz*. ### `create-billing-group` Das folgende Codebeispiel zeigt die Verwendung`create-billing-group`. **AWS CLI** **So erstellen Sie eine Abrechnungsgruppe** Im folgenden Beispiel für `create-billing-group` wird eine einfache Abrechnungsgruppe mit dem Namen `GroupOne` erstellt. ``` aws iot create-billing-group \ --billing-group-name GroupOne ``` Ausgabe: ``` { "billingGroupName": "GroupOne", "billingGroupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne", "billingGroupId": "103de383-114b-4f51-8266-18f209ef5562" } ``` Weitere Informationen finden Sie unter [Abrechnungsgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-billing-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-certificate-from-csr` Das folgende Codebeispiel zeigt die Verwendung`create-certificate-from-csr`. **AWS CLI** **So erstellen Sie ein Zertifikat anhand einer Zertifikatsignieranforderung (Certificate Signing Request, CSR)** Im folgenden Beispiel für `create-certificate-from-csr` wird ein Gerätezertifikat aus einer CSR erstellt. Sie können den `openssl`-Befehl verwenden, um eine CSR zu erstellen. ``` aws iot create-certificate-from-csr \ --certificate-signing-request=file://certificate.csr ``` Ausgabe: ``` { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9", "certificateId": "c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9", "certificatePem": "" } ``` Weitere Informationen finden Sie unter [CreateCertificateFromCSR](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateCertificateFromCsr.html) in der *AWS IoT-API-Referenz.* + Einzelheiten zur API finden Sie [CreateCertificateFromCsr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-certificate-from-csr.html)in der *AWS CLI Befehlsreferenz.* ### `create-custom-metric` Das folgende Codebeispiel zeigt die Verwendung`create-custom-metric`. **AWS CLI** **So erstellen Sie eine benutzerdefinierte Metrik, die von Ihren Geräten an Device Defender veröffentlicht wird** Im folgenden Beispiel für `create-custom-metric` wird eine benutzerdefinierte Metrik erstellt, die den Akkuladestand misst. ``` aws iot create-custom-metric \ --metric-name "batteryPercentage" \ --metric-type "number" \ --display-name "Remaining battery percentage." \ --region us-east-1 \ --client-request-token "02ccb92b-33e8-4dfa-a0c1-35b181ed26b0" ``` Ausgabe: ``` { "metricName": "batteryPercentage", "metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage" } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Metriken](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [CreateCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-custom-metric.html)in der *AWS CLI Befehlsreferenz*. ### `create-dimension` Das folgende Codebeispiel zeigt die Verwendung`create-dimension`. **AWS CLI** **So erstellen Sie eine Dimension** Im folgenden Beispiel für `create-dimension` wird eine Dimension mit einem einzelnen Themenfilter mit dem Namen `TopicFilterForAuthMessages` erstellt. ``` aws iot create-dimension \ --name TopicFilterForAuthMessages \ --type TOPIC_FILTER \ --string-values device/+/auth ``` Ausgabe: ``` { "name": "TopicFilterForAuthMessages", "arn": "arn:aws:iot:eu-west-2:123456789012:dimension/TopicFilterForAuthMessages" } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-dimension.html)in der *AWS CLI Befehlsreferenz*. ### `create-domain-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-domain-configuration`. **AWS CLI** **So erstellen Sie eine Domainkonfiguration** Im folgenden `create-domain-configuration` Beispiel wird eine AWS-verwaltete Domänenkonfiguration mit dem Diensttyp erstellt. `DATA` ``` aws iot create-domain-configuration \ --domain-configuration-name "additionalDataDomain" \ --service-type "DATA" ``` Ausgabe: ``` { "domainConfigurationName": "additionalDataDomain", "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh" } ``` Weitere Informationen finden Sie unter [Konfigurierbare Endpunkte](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie unter [CreateDomainConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-domain-configuration.html)*Befehlsreferenz.* ### `create-dynamic-thing-group` Das folgende Codebeispiel zeigt die Verwendung`create-dynamic-thing-group`. **AWS CLI** **So erstellen Sie eine dynamische Objektgruppe** Im folgenden Beispiel für `create-dynamic-thing-group` wird eine dynamische Objektgruppe erstellt, die alle Objekte mit einem Temperaturattribut von mehr als 60 Grad enthält. Sie müssen die AWS IoT-Flottenindizierung aktivieren, bevor Sie dynamische Dinggruppen verwenden können. ``` aws iot create-dynamic-thing-group \ --thing-group-name "RoomTooWarm" \ --query-string "attributes.temperature>60" ``` Ausgabe: ``` { "thingGroupName": "RoomTooWarm", "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RoomTooWarm", "thingGroupId": "9d52492a-fc87-43f4-b6e2-e571d2ffcad1", "indexName": "AWS_Things", "queryString": "attributes.temperature>60", "queryVersion": "2017-09-30" } ``` Weitere Informationen finden Sie unter [Dynamische Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateDynamicThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-dynamic-thing-group.html)in der *AWS CLI Befehlsreferenz.* ### `create-job` Das folgende Codebeispiel zeigt die Verwendung`create-job`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Auftrag** Das folgende `create-job` Beispiel erstellt einen einfachen AWS IoT-Job, der ein JSON-Dokument an das `MyRaspberryPi` Gerät sendet. ``` aws iot create-job \ --job-id "example-job-01" \ --targets "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi" \ --document file://example-job.json \ --description "example job test" \ --target-selection SNAPSHOT ``` Ausgabe: ``` { "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01", "jobId": "example-job-01", "description": "example job test" } ``` **Beispiel 2: So erstellen Sie einen kontinuierlichen Auftrag** Im folgenden Beispiel für `create-job` wird ein Auftrag erstellt, der weiter ausgeführt wird, nachdem die als Ziele angegebenen Objekte den Auftrag abgeschlossen haben. In diesem Beispiel ist das Ziel eine Objektgruppe. Wenn zur Gruppe also neue Geräte hinzugefügt werden, wird der kontinuierliche Auftrag auf diesen neuen Objekten ausgeführt. aws iot create-job --job-id „example-job-04" --targets „arn:aws:iot:us-west- 2:123456789012: -job.json --description „Beispiel für einen kontinuierlichen Job“ --target-selection CONTINUOUS thinggroup/DeadBulbs" --document file://example Ausgabe: ``` { "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-04", "jobId": "example-job-04", "description": "example continuous job" } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API [CreateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-job.html)finden Sie *AWS CLI in der* Befehlsreferenz. ### `create-keys-and-certificate` Das folgende Codebeispiel zeigt die Verwendung`create-keys-and-certificate`. **AWS CLI** **So erstellen Sie ein RSA-Schlüsselpaar und stellen ein X.509-Zertifikat aus** Im folgenden Beispiel für `create-keys-and-certificate` wird ein RSA-Schlüsselpaar mit 2048 Bit erstellt und unter Verwendung des ausgegebenen öffentlichen Schlüssels ein X.509-Zertifikat ausgegeben. Da dies das einzige Mal ist, dass AWS IoT den privaten Schlüssel für dieses Zertifikat bereitstellt, sollten Sie es an einem sicheren Ort aufbewahren. ``` aws iot create-keys-and-certificate \ --certificate-pem-outfile "myTest.cert.pem" \ --public-key-outfile "myTest.public.key" \ --private-key-outfile "myTest.private.key" ``` Ausgabe: ``` { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2", "certificateId": "9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2", "certificatePem": " -----BEGIN CERTIFICATE----- MIICiTCCEXAMPLE6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgEXAMPLEAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSEXAMPLE2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYEXAMPLEb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCEXAMPLEJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAEXAMPLEsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEXAMPLE25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+aEXAMPLE EXAMPLEfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZEXAMPLELG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAEXAMPLEWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9qEXAMPLEyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDEXAMPLEBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkEXAMPLEQEFAAOCAQ8AMIIBCgKCAQEAEXAMPLE1nnyJwKSMHw4h\nMMEXAMPLEuuN/dMAS3fyce8DW/4+EXAMPLEyjmoF/YVF/gHr99VEEXAMPLE5VF13\n59VK7cEXAMPLE67GK+y+jikqXOgHh/xJTwo+sGpWEXAMPLEDz18xOd2ka4tCzuWEXAMPLEahJbYkCPUBSU8opVkR7qkEXAMPLE1DR6sx2HocliOOLtu6Fkw91swQWEXAMPLE\GB3ZPrNh0PzQYvjUStZeccyNCx2EXAMPLEvp9mQOUXP6plfgxwKRX2fEXAMPLEDa\nhJLXkX3rHU2xbxJSq7D+XEXAMPLEcw+LyFhI5mgFRl88eGdsAEXAMPLElnI9EesG\nFQIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nkey omittted for security reasons\n-----END RSA PRIVATE KEY-----\n" } } ``` Weitere Informationen finden Sie unter [Erstellen und Registrieren eines AWS IoT-Gerätezertifikats](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-create.html) im **AWS IoT Developer Guide**. + Einzelheiten zur API finden Sie [CreateKeysAndCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-keys-and-certificate.html)unter *AWS CLI Befehlsreferenz*. ### `create-mitigation-action` Das folgende Codebeispiel zeigt die Verwendung`create-mitigation-action`. **AWS CLI** **So erstellen Sie eine Abhilfemaßnahme** Im folgenden Beispiel für `create-mitigation-action` wird eine Abhilfemaßnahme mit dem Namen `AddThingsToQuarantineGroup1Action` definiert, die, wenn sie angewendet wird, Objekte in die Objektgruppe mit dem Namen `QuarantineGroup1` verschiebt. Diese Aktion überschreibt dynamische Objektgruppen. ``` aws iot create-mitigation-action --cli-input-json file::params.json ``` Inhalt von `params.json`: ``` { "actionName": "AddThingsToQuarantineGroup1Action", "actionParams": { "addThingsToThingGroupParams": { "thingGroupNames": [ "QuarantineGroup1" ], "overrideDynamicGroups": true } }, "roleArn": "arn:aws:iam::123456789012:role/service-role/MoveThingsToQuarantineGroupRole" } ``` Ausgabe: ``` { "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroup1Action", "actionId": "992e9a63-a899-439a-aa50-4e20c52367e1" } ``` Weitere Informationen finden Sie unter [CreateMitigationAction (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/iot/latest/developerguide/iot/latest/developerguide/mitigation-action-commands.html.html#dd-api-iot-CreateMitigationAction) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateMitigationAction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-mitigation-action.html)*Befehlsreferenz.* ### `create-ota-update` Das folgende Codebeispiel zeigt die Verwendung`create-ota-update`. **AWS CLI** **So erstellen Sie ein OTA-Update für die Verwendung mit Amazon FreeRTOS** Das folgende `create-ota-update` Beispiel erstellt ein AWS IoT OTAUpdate für eine Zielgruppe von Dingen oder Gruppen. Dies ist Teil eines Amazon FreeRTOS over-the-air FreeRTOS-Updates, mit dem Sie neue Firmware-Images auf einem einzelnen Gerät oder einer Gruppe von Geräten bereitstellen können. ``` aws iot create-ota-update \ --cli-input-json file://create-ota-update.json ``` Inhalt von `create-ota-update.json`: ``` { "otaUpdateId": "ota12345", "description": "A critical update needed right away.", "targets": [ "device1", "device2", "device3", "device4" ], "targetSelection": "SNAPSHOT", "awsJobExecutionsRolloutConfig": { "maximumPerMinute": 10 }, "files": [ { "fileName": "firmware.bin", "fileLocation": { "stream": { "streamId": "004", "fileId":123 } }, "codeSigning": { "awsSignerJobId": "48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6" } } ] "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_role" } ``` Ausgabe: ``` { "otaUpdateId": "ota12345", "awsIotJobId": "job54321", "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate", "awsIotJobArn": "arn:aws:iot:us-west-2:123456789012:job/itsajob", "otaUpdateStatus": "CREATE_IN_PROGRESS" } ``` Weitere Informationen finden Sie unter [Create OTAUpdate](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateOTAUpdate.html) in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [CreateOtaUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-ota-update.html)unter *AWS CLI Befehlsreferenz*. ### `create-policy-version` Das folgende Codebeispiel zeigt die Verwendung`create-policy-version`. **AWS CLI** **So aktualisieren Sie eine Richtlinie mit einer neuen Version** Im folgenden Beispiel für `create-policy-version` wird eine Richtliniendefinition aktualisiert eine neue Richtlinienversion erstellt. In diesem Beispiel wird die neue Version auch zur Standardversion gemacht. ``` aws iot create-policy-version \ --policy-name UpdateDeviceCertPolicy \ --policy-document file://policy.json \ --set-as-default ``` Inhalt von `policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iot:UpdateCertificate", "Resource": "*" } ] } ``` Ausgabe: ``` { "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy", "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\": \"iot:UpdateCertificate\", \"Resource\": \"*\" } ] }", "policyVersionId": "2", "isDefaultVersion": true } ``` Weitere Informationen finden Sie unter [AWS -IoT-Richtlinien](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreatePolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-policy-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-policy` Das folgende Codebeispiel zeigt die Verwendung`create-policy`. **AWS CLI** **Um eine AWS IoT-Richtlinie zu erstellen** Im folgenden `create-policy` Beispiel wird eine AWS IoT-Richtlinie mit dem Namen erstellt TemperatureSensorPolicy. Die `policy.json` Datei enthält Anweisungen, die AWS IoT-Richtlinienaktionen zulassen. ``` aws iot create-policy \ --policy-name TemperatureSensorPolicy \ --policy-document file://policy.json ``` Inhalt von `policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish", "iot:Receive" ], "Resource": [ "arn:aws:iot:us-west-2:123456789012:topic/topic_1", "arn:aws:iot:us-west-2:123456789012:topic/topic_2" ] }, { "Effect": "Allow", "Action": [ "iot:Subscribe" ], "Resource": [ "arn:aws:iot:us-west-2:123456789012:topicfilter/topic_1", "arn:aws:iot:us-west-2:123456789012:topicfilter/topic_2" ] }, { "Effect": "Allow", "Action": [ "iot:Connect" ], "Resource": [ "arn:aws:iot:us-west-2:123456789012:client/basicPubSub" ] } ] } ``` Ausgabe: ``` { "policyName": "TemperatureSensorPolicy", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy", "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\": [ \"iot:Publish\", \"iot:Receive\" ], \"Resource\": [ \"arn:aws:iot:us-west-2:123456789012:topic/topic_1\", \"arn:aws:iot:us-west-2:123456789012:topic/topic_2\" ] }, { \"Effect\": \"Allow\", \"Action\": [ \"iot:Subscribe\" ], \"Resource\": [ \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_1\", \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_2\" ] }, { \"Effect\": \"Allow\", \"Action\": [ \"iot:Connect\" ], \"Resource\": [ \"arn:aws:iot:us-west-2:123456789012:client/basicPubSub\" ] } ] }", "policyVersionId": "1" } ``` Weitere Informationen finden Sie unter [AWS -IoT-Richtlinien](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreatePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-policy.html)in der *AWS CLI Befehlsreferenz*. ### `create-provisioning-claim` Das folgende Codebeispiel zeigt die Verwendung`create-provisioning-claim`. **AWS CLI** **So erstellen Sie einen Bereitstellungsantrag** Im folgenden Beispiel für `create-provisioning-claim` wird ein Bereitstellungsanspruch aus einer Bereitstellungsvorlage erstellt. ``` aws iot create-provisioning-claim \ --template-name MyTestProvisioningTemplate ``` Ausgabe: ``` { "certificateId": "78de02184b2ce80cf8fb709bda59e62b19fb83513590483eb0434589476ab09f", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDdzCCAl+gAwIBAgIUXSZhEBLztMLZ2fHG 14gV0NymYY0wDQYJKoZIhvcNAQEL\nBQAwfjELMAkGA1UEBhMCVVMxEzARBgNVBAgMCldhc2hpbmd0b24xEDAOBg VBAcM\nB1NlYXR0bGUxGDAWBgNVBAoMD0FtYXpvbi5jb20gSW5jLjEgMB4GA1UECwwXQW1h\nem9uIElvVCBQcm9 2aXNpb25pbmcxDDAKBgNVBAUTAzEuMDAeFw0yMDA3MjgxNjQ0\nMDZaFw0yMDA3MjgxNjUxMDZaMEsxSTBHBgNVB AMMQDFhNDEyM2VkNmIxYjU3MzE3\nZTgzMTJmY2MzN2FiNTdhY2MzYTZkZGVjOGQ5OGY3NzUwMWRlMjc0YjhmYTQ xN2Iw\nggEiMA0GCSqGSIb3EXAMPLEAA4IBDwAwggEKAoIBAQDBhKI94ktKLqTwnj+ayOq1\nTAJt/N6s6IJDZvl rYjkC0E7wzaeY3TprWk03S29vUzVuEOXHXQXZbihgpg2m6fza\nkWm9/wpjzE9ny5+xkPGVH4Wnwz7yK5m8S0agL T96cRBSWnWmonOWdY0GKVzni0CA\n+iyGudgrFKm7Eae/v18oXrf82KtOAGO4xG0KE2WKYHsT1fx3c9xZhlXP/eX Lhv00\n+lGp0WVw9PbhKfrxliKJ5q6sL5nVUaUHq6hlQPYwsATeOvAp3u0ak5zgTyL0fg7Y\nPyKk6VYwLW62r+V YBSForEMOAhkq3LsP/rjxpEKmi2W4lPVS6oFZRKcD+H1Kyil5\nAgMBAAGjIDAeMAwGA1UdEwEB/wQCMAAwDgYDV R0PAQH/BAQDAgeAMA0GCSqGSIb3\nDQEBCwUAA4IBAQAGgix2k6nVqbZFKq97/fZBzLGS0dyz5rT/E41cDIRX+1j EPW41\nw0D+2sXheCZLZZnSkvIiP74IToNeXDrjdcaodeGFVHIElRjhMIq+4ZebPbRLtidF\nRc2hfcTAlqq9Z6v 5Vk6BeM1tu0RqH1wPoVUccLPya8EjNCbnJZUmGdOfrN/Y9pho\n5ikV+HPeZhG/k6dhE2GsQJyKFVHL/uBgKSily 1bRyWU1r6qcpWBNBHjUoD7HgOwD\nnzMh4XRb2FQDsqFalkCSYmeL8IVC49sgPD9Otyp5uteGMTy62usAAUQdq/f ZvrWg\nOkFpwMVnGKVKT7Kg0kKOLzKWOBB2Jm4/gmrJ\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCg KCAQEAwYSiPeJLSi6k8J4/msjq\ntUwCbfzerOiCQ2b5a2I5AtBO8M2nmN06a1pNN0tvb1M1bhDlx10F2W4oYKYN pun8\n2pFpvf8KY8xPZ8ufsZDxlR+Fp8M+8iuZvEtGoC0/enEQUlp1pqJzlnWNBilc54tA\ngPoshrnYKxSpuxGn v79fKF63/NirTgBjuMRtChNlimEXAMPLE3PcWYZVz/3ly4b9\nNPpRqdFlcPT24Sn68ZYiieaurC+Z1VGlB6uoZU D2MLAE3jrwKd7tGpOc4E8i9H4O\n2D8ipOlWMC1utq/lWAUhaKxDDgIZKty7D/648aRCpotluJT1UuqBWUSnA/h9 Ssop\neQIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAwYSiPeJLSi6k8J4/ msjqtUwCbfzerOiCQ2b5a2I5AtBO8M2n\nmN06a1pNN0tvb1M1bhDlx10F2W4oYKYNpun82pFpvf8KY8xPZ8ufsZ DxlR+Fp8M+\n8iuZvEtGoC0/enEQUlp1pqJzlnWNBilc54tAgPoshrnYKxSpuxGnv79fKF63/Nir\nTgBjuMRtCh NlimB7E9X8d3PcWYZVz/3ly4b9NPpRqdFlcPT24Sn68ZYiieaurC+Z\n1VGlB6uoZUD2MLAE3jrwKd7tGpOc4E8i 9H4O2D8ipOlWMC1utq/lWAUhaKxDDgIZ\nKty7D/648aRCpotluJT1UuqBWUSnA/h9SsopeQIDAQABAoIBAEAybN QUtx9T2/nK\ntZT2pA4iugecxI4dz+DmT0XVXs5VJmrx/nBSq6ejXExEpSIMO4RY7LE3ZdJcnd56\nF7tQkkY7yR VzfxHeXFU1krOIPuxWebNOrRoPZr+1RSer+wv2aBC525+88pVuR6tM\nm3pgkrR2ycCj9FdOUoQxdjHBHaM5PDmJ 9aSxCKdg3nReepeGwsR2TQA+m2vVxWk7\nou0+91eTOP+/QfP7P8ZjOIkO2XivlRcVDyN/E4QXPKuIkM/8vS8VK+ E9pATQ0MtB\n2lw8R/YU5AJd6jlEXAMPLEGU2UzRzInNWiLtkPPPqgqXXhxOf+mxByjcMalVJk0L\nhOG2ROUCgY EA+ROcHNHy/XbsP7FihOhEh+6Q2QxQ2ncBUPYbBazrR8Hn+7SCICQK\nVyYfd8Ajfq3e7RsKVL5SlMBp7Slidxak bIn28fKfPn62DaemGCIoyDgLpF+eUxBx\ngzbCiBZga8brfurza43UZjKZLpg3hq721+FeAiXi1Nma4Yr9YWEHEN 8CgYEAxuWt\npzdWWmsiFzfsAw0sy9ySDA/xr5WRWzJyAqUsjsks6rxNzWebpufnYHcmtW7pLdqM\nkboHwN2pXa kmZvrk2nKkEMq5brBYGDXuxDe+V369Bianx8aZFyIsckA7OwXW1w1h\ngRC5rQ4XOgp3+Jmw7eAO8LRYDjaN846+ QbtO2KcCgYAWS0UL51bijQR0ZwI0dz27\nFQVuCAYsp748aurcRTACCj8jbnK/QbqTNlxWsaH7ssBjZKo2D5sAqY BRtASWODab\naHXsDhVm2Jye+ESLoHMaCLoyCkT3ll8yqXIcEDStMO7fO1Ryag164EiJvSIrMfny\nNL/fXVjCSH /udCxdzPt+7QKBgQC+LAD7rxdr4J9538hTqpc4XK9vxRbrMXEH55XH\nHbMa2xONZXpmeTgEQBukyohCVceyRhK9 i0e6irZTjVXghOeoTpC8VXkzcnzouTiQ\neFQQSGfnp7Ioe6UIz23715pKduzSNkMSKrG924ktv7CyDBF1gBQI5g aDoHnddJBJ\nPRTIZQKBgA8MASXtTxQntRwXXzR92U0vAighiuRkB/mx9jQpUcK1qiqHbkAMqgNF\nPFCBYIUbFT iYKKKeJNbyJQvjfsJCkAnaFJ+RnTxk0Q6Wjm20peJ/ii4QiDdnigoE\nvdlc5cFQewWb4/zqAtPdinkPlN94ileI 79XQdc7RlJ0jpgTimL+V\n-----END RSA PRIVATE KEY-----\n" }, "expiration": 1595955066.0 } ``` Weitere Informationen finden Sie unter [Bereitstellung durch vertrauenswürdigen Benutzer](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html#trusted-user) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateProvisioningClaim](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-provisioning-claim.html)in der *AWS CLI Befehlsreferenz*. ### `create-provisioning-template-version` Das folgende Codebeispiel zeigt die Verwendung`create-provisioning-template-version`. **AWS CLI** **So erstellen Sie eine Version einer Bereitstellungsvorlage** Im folgenden Beispiel wird eine Version für die angegebene Bereitstellungsvorlage erstellt. Der Hauptteil der neuen Version ist in der Datei `template.json` enthalten. ``` aws iot create-provisioning-template-version \ --template-name widget-template \ --template-body file://template.json ``` Inhalt von `template.json`: ``` { "Parameters" : { "DeviceLocation": { "Type": "String" } }, "Mappings": { "LocationTable": { "Seattle": { "LocationUrl": "https://example.aws" } } }, "Resources" : { "thing" : { "Type" : "AWS::IoT::Thing", "Properties" : { "AttributePayload" : { "version" : "v1", "serialNumber" : "serialNumber" }, "ThingName" : {"Fn::Join":["",["ThingPrefix_",{"Ref":"SerialNumber"}]]}, "ThingTypeName" : {"Fn::Join":["",["ThingTypePrefix_",{"Ref":"SerialNumber"}]]}, "ThingGroups" : ["widgets", "WA"], "BillingGroup": "BillingGroup" }, "OverrideSettings" : { "AttributePayload" : "MERGE", "ThingTypeName" : "REPLACE", "ThingGroups" : "DO_NOTHING" } }, "certificate" : { "Type" : "AWS::IoT::Certificate", "Properties" : { "CertificateId": {"Ref": "AWS::IoT::Certificate::Id"}, "Status" : "Active" } }, "policy" : { "Type" : "AWS::IoT::Policy", "Properties" : { "PolicyDocument" : { "Version":"2012-10-17", "Statement": [{ "Effect": "Allow", "Action":["iot:Publish"], "Resource": ["arn:aws:iot:us-east-1:123456789012:topic/foo/bar"] }] } } } }, "DeviceConfiguration": { "FallbackUrl": "https://www.example.com/test-site", "LocationUrl": { "Fn::FindInMap": ["LocationTable",{"Ref": "DeviceLocation"}, "LocationUrl"]} } } } ``` Ausgabe: ``` { "templateArn": "arn:aws:iot:us-east-1:123456789012:provisioningtemplate/widget-template", "templateName": "widget-template", "versionId": 2, "isDefaultVersion": false } ``` Weitere Informationen finden Sie unter [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [CreateProvisioningTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-provisioning-template-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-provisioning-template` Das folgende Codebeispiel zeigt die Verwendung`create-provisioning-template`. **AWS CLI** **So erstellen Sie eine Bereitstellungsvorlage** Im folgenden Beispiel für `create-provisioning-template` wird eine Bereitstellungsvorlage erstellt, wie sie in der Datei `template.json` definiert ist. ``` aws iot create-provisioning-template \ --template-name widget-template \ --description "A provisioning template for widgets" \ --provisioning-role-arn arn:aws:iam::123456789012:role/Provision_role \ --template-body file://template.json ``` Inhalt von `template.json`: ``` { "Parameters" : { "DeviceLocation": { "Type": "String" } }, "Mappings": { "LocationTable": { "Seattle": { "LocationUrl": "https://example.aws" } } }, "Resources" : { "thing" : { "Type" : "AWS::IoT::Thing", "Properties" : { "AttributePayload" : { "version" : "v1", "serialNumber" : "serialNumber" }, "ThingName" : {"Fn::Join":["",["ThingPrefix_",{"Ref":"SerialNumber"}]]}, "ThingTypeName" : {"Fn::Join":["",["ThingTypePrefix_",{"Ref":"SerialNumber"}]]}, "ThingGroups" : ["widgets", "WA"], "BillingGroup": "BillingGroup" }, "OverrideSettings" : { "AttributePayload" : "MERGE", "ThingTypeName" : "REPLACE", "ThingGroups" : "DO_NOTHING" } }, "certificate" : { "Type" : "AWS::IoT::Certificate", "Properties" : { "CertificateId": {"Ref": "AWS::IoT::Certificate::Id"}, "Status" : "Active" } }, "policy" : { "Type" : "AWS::IoT::Policy", "Properties" : { "PolicyDocument" : { "Version":"2012-10-17", "Statement": [{ "Effect": "Allow", "Action":["iot:Publish"], "Resource": ["arn:aws:iot:us-east-1:504350838278:topic/foo/bar"] }] } } } }, "DeviceConfiguration": { "FallbackUrl": "https://www.example.com/test-site", "LocationUrl": { "Fn::FindInMap": ["LocationTable",{"Ref": "DeviceLocation"}, "LocationUrl"]} } } } ``` Ausgabe: ``` { "templateArn": "arn:aws:iot:us-east-1:123456789012:provisioningtemplate/widget-template", "templateName": "widget-template", "defaultVersionId": 1 } ``` Weitere Informationen finden Sie unter [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [CreateProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-provisioning-template.html)in der *AWS CLI Befehlsreferenz*. ### `create-role-alias` Das folgende Codebeispiel zeigt die Verwendung`create-role-alias`. **AWS CLI** **So erstellen Sie ein Rollenalias** Im folgenden Beispiel für `create-role-alias` wird ein Rollenalias mit dem Namen `LightBulbRole` für die angegebene Rolle erstellt. ``` aws iot create-role-alias \ --role-alias LightBulbRole \ --role-arn arn:aws:iam::123456789012:role/lightbulbrole-001 ``` Ausgabe: ``` { "roleAlias": "LightBulbRole", "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/LightBulbRole" } ``` Weitere Informationen finden Sie [CreateRoleAlias](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateRoleAlias.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [CreateRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-role-alias.html)in der *AWS CLI Befehlsreferenz*. ### `create-scheduled-audit` Das folgende Codebeispiel zeigt die Verwendung`create-scheduled-audit`. **AWS CLI** **So erstellen Sie ein geplantes Audit** Im folgenden Beispiel für `create-scheduled-audit` wird ein geplantes Audit erstellt, das wöchentlich, am Mittwoch, ausgeführt wird, um zu überprüfen, ob CA-Zertifikate oder Gerätezertifikate ablaufen. ``` aws iot create-scheduled-audit \ --scheduled-audit-name WednesdayCertCheck \ --frequency WEEKLY \ --day-of-week WED \ --target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK ``` Ausgabe: ``` { "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/WednesdayCertCheck" } ``` Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-scheduled-audit.html)in der *AWS CLI Befehlsreferenz*. ### `create-security-profile` Das folgende Codebeispiel zeigt die Verwendung`create-security-profile`. **AWS CLI** **Um ein Sicherheitsprofil zu erstellen** Im folgenden Beispiel für `create-security-profile` wird ein Sicherheitsprofil erstellt, das überprüft, ob die Mobilfunkbandbreite einen Schwellenwert überschreitet oder ob innerhalb von fünf Minuten mehr als 10 Autorisierungsfehler auftreten. ``` aws iot create-security-profile \ --security-profile-name PossibleIssue \ --security-profile-description "Check to see if authorization fails 10 times in 5 minutes or if cellular bandwidth exceeds 128" \ --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":10},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]" ``` Ausgabe: ``` { "securityProfileName": "PossibleIssue", "securityProfileArn": "arn:aws:iot:us-west-2:123456789012:securityprofile/PossibleIssue" } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-security-profile.html)in der *AWS CLI Befehlsreferenz*. ### `create-stream` Das folgende Codebeispiel zeigt die Verwendung`create-stream`. **AWS CLI** **So erstellen Sie einen Stream für die Bereitstellung einer oder mehrerer Dateien in Fragmenten über MQTT** Im folgenden Beispiel für `create-stream` wird ein Stream für die Bereitstellung einer oder mehrerer Dateien in Fragmenten über MQTT erstellt. Ein Stream transportiert Datenbytes in Fragmenten oder als MQTT-Mitteilungen verpackten Blöcken aus einer Quelle wie S3. Es können eine oder mehrere Dateien mit einem Stream verbunden sein. ``` aws iot create-stream \ --cli-input-json file://create-stream.json ``` Inhalt von `create-stream.json`: ``` { "streamId": "stream12345", "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.", "files": [ { "fileId": 123, "s3Location": { "bucket":"codesign-ota-bucket", "key":"48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6" } } ], "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_stream_role" } ``` Ausgabe: ``` { "streamId": "stream12345", "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345", "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.", "streamVersion": "1" } ``` Weitere Informationen finden Sie [CreateStream](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateStream.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [CreateStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-stream.html)in der *AWS CLI Befehlsreferenz*. ### `create-thing-group` Das folgende Codebeispiel zeigt die Verwendung`create-thing-group`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Objektgruppe** Im folgenden Beispiel für `create-thing-group` wird eine Objektgruppe mit dem Namen `LightBulbs` mit einer Beschreibung und zwei Attributen erstellt. ``` aws iot create-thing-group \ --thing-group-name LightBulbs \ --thing-group-properties "thingGroupDescription=\"Generic bulb group\", attributePayload={attributes={Manufacturer=AnyCompany,wattage=60}}" ``` Ausgabe: ``` { "thingGroupName": "LightBulbs", "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs", "thingGroupId": "9198bf9f-1e76-4a88-8e8c-e7140142c331" } ``` **Beispiel 2: So erstellen Sie eine Objektgruppe, die Teil einer übergeordneten Gruppe ist** Im folgenden Beispiel für `create-thing-group` wird eine Objektgruppe mit dem Namen `HalogenBulbs` erstellt, die eine übergeordnete Objektgruppe mit dem Namen `LightBulbs` hat. ``` aws iot create-thing-group \ --thing-group-name HalogenBulbs \ --parent-group-name LightBulbs ``` Ausgabe: ``` { "thingGroupName": "HalogenBulbs", "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/HalogenBulbs", "thingGroupId": "f4ec6b84-b42b-499d-9ce1-4dbd4d4f6f6e" } ``` Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-thing-type` Das folgende Codebeispiel zeigt die Verwendung`create-thing-type`. **AWS CLI** **So definieren Sie einen Objekttyp** Im folgenden Beispiel für `create-thing-type` werden ein Objekttyp und die zugehörigen Attribute definiert. ``` aws iot create-thing-type \ --thing-type-name "LightBulb" \ --thing-type-properties "thingTypeDescription=light bulb type, searchableAttributes=wattage,model" ``` Ausgabe: ``` { "thingTypeName": "LightBulb", "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb", "thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190" } ``` Weitere Informationen finden Sie unter [Objekttypen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-type.html)in der *AWS CLI Befehlsreferenz*. ### `create-thing` Das folgende Codebeispiel zeigt die Verwendung`create-thing`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Objektdatensatz in der Registry** Das folgende `create-thing` Beispiel erstellt einen Eintrag für ein Gerät in der AWS IoT-Dingregistrierung. ``` aws iot create-thing \ --thing-name SampleIoTThing ``` Ausgabe: ``` { "thingName": "SampleIoTThing", "thingArn": "arn:aws:iot:us-west-2: 123456789012:thing/SampleIoTThing", "thingId": " EXAMPLE1-90ab-cdef-fedc-ba987EXAMPLE " } ``` **Beispiel 2: So definieren Sie ein Objekt, das einem Objekttyp zugeordnet ist** Im folgenden Beispiel für `create-thing` wird ein Objekt mit dem angegebenen Objekttyp und seinen Attributen erstellt. ``` aws iot create-thing \ --thing-name "MyLightBulb" \ --thing-type-name "LightBulb" \ --attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}" ``` Ausgabe: ``` { "thingName": "MyLightBulb", "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb", "thingId": "40da2e73-c6af-406e-b415-15acae538797" } ``` Weitere Informationen finden Sie unter [Objektverwaltung mit der Registry](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) und [Objekttypen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing.html)in der *AWS CLI Befehlsreferenz*. ### `create-topic-rule-destination` Das folgende Codebeispiel zeigt die Verwendung`create-topic-rule-destination`. **AWS CLI** **So erstellen Sie ein Themenregelziel** Im folgenden Beispiel für `create-topic-rule-destination` wird ein Ziel für Themenregeln für einen HTTP-Endpunkt erstellt. ``` aws iot create-topic-rule-destination \ --destination-configuration httpUrlConfiguration={confirmationUrl=https://example.com} ``` Ausgabe: ``` { "topicRuleDestination": { "arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "status": "IN_PROGRESS", "statusReason": "Awaiting confirmation. Confirmation message sent on 2020-07-09T22:47:54.154Z; no response received from the endpoint.", "httpUrlProperties": { "confirmationUrl": "https://example.com" } } } ``` Weitere Informationen finden Sie unter [Erstellen eines Themenregelziels](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#create-destination) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [CreateTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-topic-rule-destination.html)in der *AWS CLI Befehlsreferenz*. ### `create-topic-rule` Das folgende Codebeispiel zeigt die Verwendung`create-topic-rule`. **AWS CLI** **So erstellen Sie eine Regel, die eine Amazon-SNS-Warnung sendet** Im folgenden Beispiel für `create-topic-rule` wird eine Regel erstellt, die eine Amazon-SNS-Nachricht sendet, wenn die Werte für die Erdfeuchte in einem Geräteschatten niedrig sind. ``` aws iot create-topic-rule \ --rule-name "LowMoistureRule" \ --topic-rule-payload file://plant-rule.json ``` Für das Beispiel muss der folgende JSON-Code in einer Datei mit dem Namen `plant-rule.json` gespeichert werden: ``` { "sql": "SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\n", "description": "Sends an alert whenever soil moisture level readings are too low.", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [{ "sns": { "targetArn": "arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic", "roleArn": "arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole", "messageFormat": "RAW" } }] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen einer AWS IoT-Regel](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) im *AWS IoT-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [CreateTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-topic-rule.html)in der *AWS CLI Befehlsreferenz*. ### `delete-account-audit-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-account-audit-configuration`. **AWS CLI** **Um alle Audit-Checks für Ihr AWS Konto zu deaktivieren** Im folgenden `delete-account-audit-configuration` Beispiel werden die Standardeinstellungen für AWS IoT Device Defender für dieses Konto wiederhergestellt, wobei alle Auditprüfungen deaktiviert und die Konfigurationsdaten gelöscht werden. Außerdem werden alle geplanten Audits für dieses Konto gelöscht. **Verwenden Sie diesen Befehl mit Vorsicht.** ``` aws iot delete-account-audit-configuration \ --delete-scheduled-audits ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteAccountAuditConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-account-audit-configuration.html)in der *AWS CLI Befehlsreferenz.* ### `delete-audit-suppression` Das folgende Codebeispiel zeigt die Verwendung`delete-audit-suppression`. **AWS CLI** **Um ein Audit zu löschen, bei dem eine Unterdrückung festgestellt wurde** Im folgenden Beispiel für `delete-audit-suppression` wird die Unterdrückung von Audit-Erkenntnissen für DEVICE\$1CERTIFICATE\$1EXPIRING\$1CHECK gelöscht. ``` aws iot delete-audit-suppression \ --check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \ --resource-identifier deviceCertificateId="c7691e" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Unterdrückungen von Prüfergebnissen](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-audit-suppression.html)in der *AWS CLI Befehlsreferenz*. ### `delete-authorizer` Das folgende Codebeispiel zeigt die Verwendung`delete-authorizer`. **AWS CLI** **So löschen Sie einen benutzerdefinierten Genehmiger** Im folgenden Beispiel für `delete-authorizer` wird der Genehmiger mit dem Namen `CustomAuthorizer` gelöscht. Ein benutzerdefinierter Genehmiger muss sich im Status `INACTIVE` befinden, bevor Sie ihn löschen können. ``` aws iot delete-authorizer \ --authorizer-name CustomAuthorizer ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [DeleteAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteAuthorizer.html)im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie [DeleteAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-authorizer.html)in der *AWS CLI Befehlsreferenz*. ### `delete-billing-group` Das folgende Codebeispiel zeigt die Verwendung`delete-billing-group`. **AWS CLI** **So löschen Sie eine Abrechnungsgruppe** Im folgenden Beispiel für `delete-billing-group` wird die angegebene Abrechnungsgruppe gelöscht. Sie können eine Abrechnungsgruppe löschen, auch wenn sie ein oder mehrere Objekte enthält. ``` aws iot delete-billing-group \ --billing-group-name BillingGroupTwo ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Abrechnungsgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-billing-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-ca-certificate` Das folgende Codebeispiel zeigt die Verwendung`delete-ca-certificate`. **AWS CLI** **So löschen Sie ein CA-Zertifikat** Im folgenden Beispiel für `delete-ca-certificate` wird das CA-Zertifikat mit der angegebenen Zertifikat-ID gelöscht. ``` aws iot delete-ca-certificate \ --certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen CACertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteCACertificate.html) in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DeleteCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-ca-certificate.html)unter *AWS CLI Befehlsreferenz*. ### `delete-certificate` Das folgende Codebeispiel zeigt die Verwendung`delete-certificate`. **AWS CLI** **So löschen Sie ein Gerätezertifikat** Im folgenden Beispiel für `delete-certificate` wird das Gerätezertifikat mit der angegebenen ID gelöscht. ``` aws iot delete-certificate \ --certificate-id c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [DeleteCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteCertificate.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DeleteCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `delete-custom-metric` Das folgende Codebeispiel zeigt die Verwendung`delete-custom-metric`. **AWS CLI** **So löschen Sie eine benutzerdefinierte Metrik** Im folgenden Beispiel für `delete-custom-metric` wird eine benutzerdefinierte Metrik gelöscht. ``` aws iot delete-custom-metric \ --metric-name batteryPercentage \ --region us-east-1 ``` Ausgabe: ``` HTTP 200 ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Metriken](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [DeleteCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-custom-metric.html)in der *AWS CLI Befehlsreferenz*. ### `delete-dimension` Das folgende Codebeispiel zeigt die Verwendung`delete-dimension`. **AWS CLI** **Um eine Dimension zu löschen** Im folgenden Beispiel für `delete-dimension` wird eine Dimension namens `TopicFilterForAuthMessages` gelöscht. ``` aws iot delete-dimension \ --name TopicFilterForAuthMessages ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-dimension.html)unter *AWS CLI Befehlsreferenz*. ### `delete-domain-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-domain-configuration`. **AWS CLI** **So löschen Sie eine Domainkonfiguration** Im folgenden `delete-domain-configuration` Beispiel wird eine Domänenkonfiguration mit dem Namen `additionalDataDomain` aus Ihrem AWS Konto gelöscht. ``` aws iot delete-domain-configuration \ --domain-configuration-name "additionalDataDomain" \ --domain-configuration-status "OK" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurierbare Endpunkte](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie unter [DeleteDomainConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-domain-configuration.html)*Befehlsreferenz.* ### `delete-dynamic-thing-group` Das folgende Codebeispiel zeigt die Verwendung`delete-dynamic-thing-group`. **AWS CLI** **So löschen Sie eine dynamische Objektgruppe** Im folgenden Beispiel für `delete-dynamic-thing-group` wird die angegebene dynamische Objektgruppe gelöscht. ``` aws iot delete-dynamic-thing-group \ --thing-group-name "RoomTooWarm" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Dynamische Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteDynamicThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-dynamic-thing-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-job-execution` Das folgende Codebeispiel zeigt die Verwendung`delete-job-execution`. **AWS CLI** **So löschen Sie eine Auftragsausführung** Im folgenden Beispiel für `delete-job-execution` wird die Ausführung des angegebenen Auftrags auf einem Gerät gelöscht. Verwenden Sie `describe-job-execution`, um die Ausführungsnummer abzurufen. ``` aws iot delete-job-execution --job-id "example-job-02" --thing-name "MyRaspberryPi" --execution-number 1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-job-execution.html)in der *AWS CLI Befehlsreferenz*. ### `delete-job` Das folgende Codebeispiel zeigt die Verwendung`delete-job`. **AWS CLI** **Einen Auftrag löschen** Im folgenden Beispiel für `delete-job` wird der angegebene Auftrag gelöscht. Durch Angabe der Option `--force` wird der Auftrag gelöscht, auch wenn der Status `IN_PROGRESS` lautet. ``` aws iot delete-job \ --job-id "example-job-04" \ --force ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-job.html)in der *AWS CLI Befehlsreferenz*. ### `delete-mitigation-action` Das folgende Codebeispiel zeigt die Verwendung`delete-mitigation-action`. **AWS CLI** **So löschen Sie eine Abhilfemaßnahme** Im folgenden Beispiel für `delete-mitigation-action` wird die angegebene Abhilfemaßnahme gelöscht. ``` aws iot delete-mitigation-action \ --action-name AddThingsToQuarantineGroup1Action ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [DeleteMitigationAction (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DeleteMitigationAction) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [DeleteMitigationAction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-mitigation-action.html)*Befehlsreferenz.* ### `delete-ota-update` Das folgende Codebeispiel zeigt die Verwendung`delete-ota-update`. **AWS CLI** **So löschen Sie ein OTA-Update** Im folgenden Beispiel für `delete-ota-update` wird das angegebene OTA-Update gelöscht. ``` aws iot delete-ota-update \ --ota-update-id ota12345 \ --delete-stream \ --force-delete-aws-job ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen OTAUpdate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteOTAUpdate.html) in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DeleteOtaUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-ota-update.html)unter *AWS CLI Befehlsreferenz*. ### `delete-policy-version` Das folgende Codebeispiel zeigt die Verwendung`delete-policy-version`. **AWS CLI** **So löschen Sie eine Version einer Richtlinie** Im folgenden `delete-policy-version` Beispiel wird Version 2 der angegebenen Richtlinie aus Ihrem AWS Konto gelöscht. ``` aws iot delete-policy-version \ --policy-name UpdateDeviceCertPolicy \ --policy-version-id 2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [AWS -IoT-Richtlinien](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie unter [DeletePolicyVersion AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-policy-version.html)*Befehlsreferenz.* ### `delete-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-policy`. **AWS CLI** **So löschen Sie eine Richtlinie** Im folgenden `delete-policy` Beispiel wird die angegebene Richtlinie aus Ihrem AWS Konto gelöscht. ``` aws iot delete-policy --policy-name UpdateDeviceCertPolicy ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [AWS -IoT-Richtlinien](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeletePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-policy.html)in der *AWS CLI Befehlsreferenz.* ### `delete-provisioning-template-version` Das folgende Codebeispiel zeigt die Verwendung`delete-provisioning-template-version`. **AWS CLI** **So löschen Sie eine Version einer Bereitstellungsvorlage** Im folgenden Beispiel für `delete-provisioning-template-version` wird Version 2 der angegebenen Bereitstellungsvorlage gelöscht. ``` aws iot delete-provisioning-template-version \ --version-id 2 \ --template-name "widget-template" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [DeleteProvisioningTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-provisioning-template-version.html)in der *AWS CLI Befehlsreferenz*. ### `delete-provisioning-template` Das folgende Codebeispiel zeigt die Verwendung`delete-provisioning-template`. **AWS CLI** **So löschen Sie eine Bereitstellungsvorlage** Im folgenden Beispiel für `delete-provisioning-template` wird die angegebene Bereitstellungsvorlage gelöscht. ``` aws iot delete-provisioning-template \ --template-name widget-template ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [DeleteProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-provisioning-template.html)in der *AWS CLI Befehlsreferenz*. ### `delete-registration-code` Das folgende Codebeispiel zeigt die Verwendung`delete-registration-code`. **AWS CLI** **So löschen Sie Ihren Registrierungscode** Im folgenden `delete-registration-code` Beispiel wird ein für das AWS IoT-Konto spezifischer Registrierungscode gelöscht. ``` aws iot delete-registration-code ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden eines eigenen Zertifikats](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-your-own.html) im *Entwicklerhandbuch für AWS IoT*. + *Einzelheiten zur API finden Sie [DeleteRegistrationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-registration-code.html)in AWS CLI der Befehlsreferenz.* ### `delete-role-alias` Das folgende Codebeispiel zeigt die Verwendung`delete-role-alias`. **AWS CLI** **So löschen Sie einen AWS IoT-Rollenalias** Im folgenden `delete-role-alias` Beispiel wird ein AWS IoT-Rollenalias mit dem Namen `LightBulbRole` gelöscht. ``` aws iot delete-role-alias \ --role-alias LightBulbRole ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Autorizing Direct Calls to AWS Services](https://docs.aws.amazon.com/iot/latest/developerguide/authorizing-direct-aws.html) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie [DeleteRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-role-alias.html)in der *AWS CLI Befehlsreferenz.* ### `delete-scheduled-audit` Das folgende Codebeispiel zeigt die Verwendung`delete-scheduled-audit`. **AWS CLI** **So löschen Sie ein geplantes Audit** Im folgenden `delete-scheduled-audit` Beispiel wird das geplante AWS IoT Device Defender Defender-Audit mit dem Namen `AWSIoTDeviceDefenderDailyAudit` gelöscht. ``` aws iot delete-scheduled-audit \ --scheduled-audit-name AWSIoTDeviceDefenderDailyAudit ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-scheduled-audit.html)in der *AWS CLI Befehlsreferenz.* ### `delete-security-profile` Das folgende Codebeispiel zeigt die Verwendung`delete-security-profile`. **AWS CLI** **So löschen Sie ein Sicherheitsprofil** Im folgenden Beispiel für `delete-security-profile` wird ein Sicherheitsprofil mit dem Namen `PossibleIssue` gelöscht. ``` aws iot delete-security-profile \ --security-profile-name PossibleIssue ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-security-profile.html)in der *AWS CLI Befehlsreferenz*. ### `delete-stream` Das folgende Codebeispiel zeigt die Verwendung`delete-stream`. **AWS CLI** **So löschen Sie einen Stream** Im folgenden Beispiel für `delete-stream` wird der angegebene Stream gelöscht. ``` aws iot delete-stream \ --stream-id stream12345 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [DeleteStream](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteStream.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DeleteStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-stream.html)in der *AWS CLI Befehlsreferenz*. ### `delete-thing-group` Das folgende Codebeispiel zeigt die Verwendung`delete-thing-group`. **AWS CLI** **So löschen Sie eine Objektgruppe** Im folgenden Beispiel für `delete-thing-group` wird die angegebene Objektgruppe gelöscht. Sie können eine Objektgruppe nicht löschen, wenn sie untergeordnete Objektgruppen enthält. ``` aws iot delete-thing-group \ --thing-group-name DefectiveBulbs ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-thing-type` Das folgende Codebeispiel zeigt die Verwendung`delete-thing-type`. **AWS CLI** **Beispiel 1: So löschen Sie einen Objekttyp** Im folgenden Beispiel für `delete-thing-type` wird ein veralteter Objekttyp gelöscht. ``` aws iot delete-thing-type \ --thing-type-name "obsoleteThingType" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Objekttypen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing-type.html)in der *AWS CLI Befehlsreferenz*. ### `delete-thing` Das folgende Codebeispiel zeigt die Verwendung`delete-thing`. **AWS CLI** **So zeigen Sie detaillierte Informationen zu einem Objekt an** Das folgende `delete-thing` Beispiel löscht eine Sache aus der AWS IoT-Registrierung für Ihr AWS Konto. as iot delete-thing --thing-name“ FourthBulb Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Objektverwaltung mit der Registry](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) im *Entwicklerhandbuch für AWS IoT*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DeleteThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing.html)AWS CLI * ### `delete-topic-rule-destination` Das folgende Codebeispiel zeigt die Verwendung`delete-topic-rule-destination`. **AWS CLI** **So löschen Sie ein Themenregelziel** Im folgenden Beispiel für `delete-topic-rule-destination` wird das angegebene Themenregelziel gelöscht. ``` aws iot delete-topic-rule-destination \ --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Themenregelziels](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#delete-destination) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-topic-rule-destination.html)in der *AWS CLI Befehlsreferenz*. ### `delete-topic-rule` Das folgende Codebeispiel zeigt die Verwendung`delete-topic-rule`. **AWS CLI** **So löschen Sie eine Regel** Im folgenden Beispiel für `delete-topic-rule` wird die angegebene Regel gelöscht. ``` aws iot delete-topic-rule \ --rule-name "LowMoistureRule" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Regel](https://docs.aws.amazon.com/iot/latest/developerguide/iot-delete-rule.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-topic-rule.html)in der *AWS CLI Befehlsreferenz*. ### `delete-v2-logging-level` Das folgende Codebeispiel zeigt die Verwendung`delete-v2-logging-level`. **AWS CLI** **So löschen Sie die Protokollierungsebene für eine Objektgruppe** Im folgenden Beispiel für `delete-v2-logging-level` wird die Protokollierungsebene für die angegebene Objektgruppe gelöscht. ``` aws iot delete-v2-logging-level \ --target-type THING_GROUP \ --target-name LightBulbs ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + *API-Details finden Sie unter [DeleteV2 LoggingLevel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-v2-logging-level.html) in AWS CLI der Befehlsreferenz.* ### `deprecate-thing-type` Das folgende Codebeispiel zeigt die Verwendung. `deprecate-thing-type` **AWS CLI** **Beispiel 1: Um stufen Sie einen Objekttyp als veraltet ein** Im folgenden Beispiel für `deprecate-thing-type` wird ein Objekttyp als veraltet eingestuft, sodass Benutzer ihm keine neuen Objekte zuordnen können. ``` aws iot deprecate-thing-type \ --thing-type-name "obsoleteThingType" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So machen Sie die Einstufung eines Objekttyps als veraltet rückgängig** Im folgenden Beispiel für `deprecate-thing-type` wird die Einstufung eines Objekttyps als veraltet rückgängig gemacht, sodass Benutzer ihm wieder neue Objekte zuordnen können. ``` aws iot deprecate-thing-type \ --thing-type-name "obsoleteThingType" \ --undo-deprecate ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Objekttypen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeprecateThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/deprecate-thing-type.html)in der *AWS CLI Befehlsreferenz*. ### `describe-account-audit-configuration` Das folgende Codebeispiel zeigt die Verwendung`describe-account-audit-configuration`. **AWS CLI** **So zeigen Sie die aktuellen Audit-Konfigurationseinstellungen an** Das folgende `describe-account-audit-configuration` Beispiel listet die aktuellen Einstellungen für Ihre AWS IoT Device Defender Defender-Audit-Konfiguration auf. ``` aws iot describe-account-audit-configuration ``` Ausgabe: ``` { "roleArn": "arn:aws:iam::123456789012:role/service-role/AWSIoTDeviceDefenderAudit_1551201085996", "auditNotificationTargetConfigurations": { "SNS": { "targetArn": "arn:aws:sns:us-west-2:123456789012:ddaudits", "roleArn": "arn:aws:iam::123456789012:role/service-role/AWSIoTDeviceDefenderAudit", "enabled": true } }, "auditCheckConfigurations": { "AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK": { "enabled": true }, "CA_CERTIFICATE_EXPIRING_CHECK": { "enabled": true }, "CONFLICTING_CLIENT_IDS_CHECK": { "enabled": true }, "DEVICE_CERTIFICATE_EXPIRING_CHECK": { "enabled": true }, "DEVICE_CERTIFICATE_SHARED_CHECK": { "enabled": true }, "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": { "enabled": true }, "LOGGING_DISABLED_CHECK": { "enabled": true }, "REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK": { "enabled": true }, "REVOKED_DEVICE_CERTIFICATE_STILL_ACTIVE_CHECK": { "enabled": true }, "UNAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK": { "enabled": true } } } ``` Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeAccountAuditConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-account-audit-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `describe-audit-finding` Das folgende Codebeispiel zeigt die Verwendung`describe-audit-finding`. **AWS CLI** **So listen Sie Details zu einer Audit-Erkenntnis auf** Das folgende `describe-audit-finding` Beispiel listet die Details für das angegebene AWS IoT Device Defender Defender-Audit-Ergebnis auf. Ein Audit kann mehrere Erkenntnisse erzeugen. Verwenden Sie den Befehl `list-audit-findings`, um eine Liste der Erkenntnisse eines Audits abzurufen und die `findingId` zu erhalten. ``` aws iot describe-audit-finding \ --finding-id "ef4826b8-e55a-44b9-b460-5c485355371b" ``` Ausgabe: ``` { "finding": { "findingId": "ef4826b8-e55a-44b9-b460-5c485355371b", "taskId": "873ed69c74a9ec8fa9b8e88e9abc4661", "checkName": "IOT_POLICY_OVERLY_PERMISSIVE_CHECK", "taskStartTime": 1576012045.745, "findingTime": 1576012046.168, "severity": "CRITICAL", "nonCompliantResource": { "resourceType": "IOT_POLICY", "resourceIdentifier": { "policyVersionIdentifier": { "policyName": "smp-ggrass-group_Core-policy", "policyVersionId": "1" } } }, "reasonForNonCompliance": "Policy allows broad access to IoT data plane actions: [iot:Subscribe, iot:Connect, iot:GetThingShadow, iot:DeleteThingShadow, iot:UpdateThingShadow, iot:Publish].", "reasonForNonComplianceCode": "ALLOWS_BROAD_ACCESS_TO_IOT_DATA_PLANE_ACTIONS" } } ``` Weitere Informationen finden Sie unter [Überprüfen der Audit-Ergebnisse (Audit-Befehle)](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html#device-defender-AuditCommandsFindings) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeAuditFinding](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-finding.html)unter *AWS CLI Befehlsreferenz*. ### `describe-audit-mitigation-actions-task` Das folgende Codebeispiel zeigt die Verwendung`describe-audit-mitigation-actions-task`. **AWS CLI** **So zeigen Sie die Details einer Audit-Abhilfemaßname an** Das folgende Beispiel für `describe-audit-mitigation-actions-task` zeigt die Details für die angegebene Aufgabe, bei der `ResetPolicyVersionAction` auf eine Erkenntnis angewendet wurde. Mit den Ergebnissen wird angegeben, wann die Aufgabe gestartet und beendet wurde, wie viele Erkenntnisse angegangen wurden (und mit welchem Ergebnis) und wie die Definition der Maßnahme lautet, die im Rahmen dieser Aufgabe angewendet wurde. ``` aws iot describe-audit-mitigation-actions-task \ --task-id ResetPolicyTask01 ``` Ausgabe: ``` { "taskStatus": "COMPLETED", "startTime": "2019-12-10T15:13:19.457000-08:00", "endTime": "2019-12-10T15:13:19.947000-08:00", "taskStatistics": { "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": { "totalFindingsCount": 1, "failedFindingsCount": 0, "succeededFindingsCount": 1, "skippedFindingsCount": 0, "canceledFindingsCount": 0 } }, "target": { "findingIds": [ "ef4826b8-e55a-44b9-b460-5c485355371b" ] }, "auditCheckToActionsMapping": { "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": [ "ResetPolicyVersionAction" ] }, "actionsDefinition": [ { "name": "ResetPolicyVersionAction", "id": "1ea0b415-bef1-4a01-bd13-72fb63c59afb", "roleArn": "arn:aws:iam::123456789012:role/service-role/ReplacePolicyVersionRole", "actionParams": { "replaceDefaultPolicyVersionParams": { "templateName": "BLANK_POLICY" } } } ] } ``` Weitere Informationen finden Sie unter [DescribeAuditMitigationActionsTask (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DescribeAuditMitigationActionsTask) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [DescribeAuditMitigationActionsTask AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-mitigation-actions-task.html)*Befehlsreferenz.* ### `describe-audit-suppression` Das folgende Codebeispiel zeigt die Verwendung`describe-audit-suppression`. **AWS CLI** **So rufen Sie Details zu einer Unterdrückung von Audit-Erkenntnissen ab** Im folgenden Beispiel für `describe-audit-suppression` werden Details zu einer Unterdrückung von Audit-Erkenntnissen aufgelistet. ``` aws iot describe-audit-task \ --task-id "787ed873b69cb4d6cdbae6ddd06996c5" ``` Ausgabe: ``` { "taskStatus": "COMPLETED", "taskType": "SCHEDULED_AUDIT_TASK", "taskStartTime": 1596168096.157, "taskStatistics": { "totalChecks": 1, "inProgressChecks": 0, "waitingForDataCollectionChecks": 0, "compliantChecks": 0, "nonCompliantChecks": 1, "failedChecks": 0, "canceledChecks": 0 }, "scheduledAuditName": "AWSIoTDeviceDefenderDailyAudit", "auditDetails": { "DEVICE_CERTIFICATE_EXPIRING_CHECK": { "checkRunStatus": "COMPLETED_NON_COMPLIANT", "checkCompliant": false, "totalResourcesCount": 195, "nonCompliantResourcesCount": 2 } } } ``` Weitere Informationen finden Sie unter [Unterdrückungen von Prüfergebnissen](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-suppression.html)in der *AWS CLI Befehlsreferenz*. ### `describe-audit-task` Das folgende Codebeispiel zeigt die Verwendung`describe-audit-task`. **AWS CLI** **So rufen Sie Informationen zu einer Audit-Instance ab** Im folgenden `describe-audit-task` Beispiel werden Informationen zu einer Instanz eines AWS IoT Device Defender Defender-Audits abgerufen. Wenn das Audit abgeschlossen ist, umfassen die Ergebnisse eine Gesamtstatistik für die Ausführung. ``` aws iot describe-audit-task \ --task-id a3aea009955e501a31b764abe1bebd3d ``` Ausgabe: ``` { "taskStatus": "COMPLETED", "taskType": "ON_DEMAND_AUDIT_TASK", "taskStartTime": 1560356923.434, "taskStatistics": { "totalChecks": 3, "inProgressChecks": 0, "waitingForDataCollectionChecks": 0, "compliantChecks": 3, "nonCompliantChecks": 0, "failedChecks": 0, "canceledChecks": 0 }, "auditDetails": { "CA_CERTIFICATE_EXPIRING_CHECK": { "checkRunStatus": "COMPLETED_COMPLIANT", "checkCompliant": true, "totalResourcesCount": 0, "nonCompliantResourcesCount": 0 }, "DEVICE_CERTIFICATE_EXPIRING_CHECK": { "checkRunStatus": "COMPLETED_COMPLIANT", "checkCompliant": true, "totalResourcesCount": 6, "nonCompliantResourcesCount": 0 }, "REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK": { "checkRunStatus": "COMPLETED_COMPLIANT", "checkCompliant": true, "totalResourcesCount": 0, "nonCompliantResourcesCount": 0 } } } ``` Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeAuditTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-task.html)in der *AWS CLI Befehlsreferenz*. ### `describe-authorizer` Das folgende Codebeispiel zeigt die Verwendung`describe-authorizer`. **AWS CLI** **So rufen Sie Informationen zu einem benutzerdefinierten Genehmiger ab** Im folgenden Beispiel für `describe-authorizer` werden die Details für den angegebenen benutzerdefinierten Genehmiger angezeigt. ``` aws iot describe-authorizer \ --authorizer-name CustomAuthorizer ``` Ausgabe: ``` { "authorizerDescription": { "authorizerName": "CustomAuthorizer", "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer", "authorizerFunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:CustomAuthorizerFunction", "tokenKeyName": "MyAuthToken", "tokenSigningPublicKeys": { "FIRST_KEY": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1uJOB4lQPgG/lM6ZfIwo\nZ+7ENxAio9q6QD4FFqjGZsvjtYwjoe1RKK0U8Eq9xb5O3kRSmyIwTzwzm/f4Gf0Y\nZUloJ+t3PUUwHrmbYTAgTrCUgRFygjfgVwGCPs5ZAX4Eyqt5cr+AIHIiUDbxSa7p\nzwOBKPeic0asNJpqT8PkBbRaKyleJh5oo81NDHHmVtbBm5A5YiJjqYXLaVAowKzZ\n+GqsNvAQ9Jy1wI2VrEa1OfL8flDB/BJLm7zjpfPOHDJQgID0XnZwAlNnZcOhCwIx\n50g2LW2Oy9R/dmqtDmJiVP97Z4GykxPvwlYHrUXY0iW1R3AR/Ac1NhCTGZMwVDB1\nlQIDAQAB\n-----END PUBLIC KEY-----" }, "status": "ACTIVE", "creationDate": 1571245658.069, "lastModifiedDate": 1571245658.069 } } ``` Weitere Informationen finden Sie [DescribeAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeAuthorizer.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DescribeAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-authorizer.html)in der *AWS CLI Befehlsreferenz*. ### `describe-billing-group` Das folgende Codebeispiel zeigt die Verwendung`describe-billing-group`. **AWS CLI** **So rufen Sie Informationen zu einer Abrechnungsgruppe ab** Im folgenden Beispiel für `describe-billing-group` werden Informationen über die angegebene Abrechnungsgruppe abgerufen. ``` aws iot describe-billing-group --billing-group-name GroupOne ``` Ausgabe: ``` { "billingGroupName": "GroupOne", "billingGroupId": "103de383-114b-4f51-8266-18f209ef5562", "billingGroupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne", "version": 1, "billingGroupProperties": {}, "billingGroupMetadata": { "creationDate": 1560199355.378 } } ``` Weitere Informationen finden Sie unter [Abrechnungsgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-billing-group.html)in der *AWS CLI Befehlsreferenz*. ### `describe-ca-certificate` Das folgende Codebeispiel zeigt die Verwendung`describe-ca-certificate`. **AWS CLI** **So rufen Sie Details zu einem CA-Zertifikat ab** Im folgenden Beispiel für `describe-ca-certificate` werden die Details für das angegebene CA-Zertifikat angezeigt. ``` aws iot describe-ca-certificate \ --certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467 ``` Ausgabe: ``` { "certificateDescription": { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467", "certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467", "status": "INACTIVE", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIICzzCCAbegEXAMPLEJANVEPWXl8taPMA0GCSqGSIb3DQEBBQUAMB4xCzAJBgNV\nBAYTAlVTMQ8wDQYDVQQKDAZBbWF6b24wHhcNMTkwOTI0MjEzMTE1WhcNMjkwOTIx\nMjEzMTE1WjAeMQswCQYDVQQGEwJVUzEPMA0GA1UECgwGQW1hem9uMIIBIjANBgkq\nhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzd3R3ioalCS0MhFWfBrVGR036EK07UAf\nVdz9EXAMPLE1VczICbADnATK522kEIB51/18VzlFtAhQL5V5eybXKnB7QebNer5m\n4Yibx7shR5oqNzFsrXWxuugN5+w5gEfqNMawOjhF4LsculKG49yuqjcDU19/13ua\n3B2gxs1Pe7TiWWvUskzxnbO1F2WCshbEJvqY8fIWtGYCjTeJAgQ9hvZx/69XhKen\nwV9LJwOQxrsUS0Ty8IHwbB8fRy72VM3u7fJoaU+nO4jD5cqaoEPtzoeFUEXAMPLE\nyVAJpqHwgbYbcUfn7V+AB6yh1+0Fa1rEQGuZDPGyJslxwr5vh8nRewIDAQABoxAw\nDjAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBBQUAA4IBAQA+3a5CV3IJgOnd0AgI\nBgVMtmYzTvqAngx26aG9/spvCjXckh2SBF+EcBlCFwH1yakwjJL1dR4yarnrfxgI\nEqP4AOYVimAVoQ5FBwnloHe16+3qtDiblU9DeXBUCtS55EcfrEXAMPLEYtXdqU5C\nU9ia4KAjV0dxW1+EFYMwX5eGeb0gDTNHBylV6B/fOSZiQAwDYp4x3B+gAP+a/bWB\nu1umOqtBdWe6L6/83L+JhaTByqV25iVJ4c/UZUnG8926wUlDM9zQvEXuEVvzZ7+m\n4PSNqst/nVOvnLpoG4e0WgcJgANuB33CSWtjWSuYsbhmqQRknGhREXAMPLEZT4fm\nfo0e\n-----END CERTIFICATE-----\n", "ownedBy": "123456789012", "creationDate": 1569365372.053, "autoRegistrationStatus": "DISABLE", "lastModifiedDate": 1569365372.053, "customerVersion": 1, "generationId": "c5c2eb95-140b-4f49-9393-6aaac85b2a90", "validity": { "notBefore": 1569360675.0, "notAfter": 1884720675.0 } } } ``` Weitere Informationen finden Sie unter [Describe CACertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeCACertificate.html) in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DescribeCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-ca-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `describe-certificate` Das folgende Codebeispiel zeigt die Verwendung`describe-certificate`. **AWS CLI** **So rufen Sie Informationen zu einem Zertifikat ab** Im folgenden Beispiel für `describe-certificate` werden die Details für das angegebene Zertifikat angezeigt. ``` aws iot describe-certificate \ --certificate-id "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e" ``` Ausgabe: ``` { "certificateDescription": { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e", "certificateId": "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e", "status": "ACTIVE", "certificatePem": "-----BEGIN CERTIFICATE----- MIICiTEXAMPLEQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBEXAMPLEMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDEXAMPLElMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5EXAMPLEcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNEXAMPLEdBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBEXAMPLEz b2xEXAMPLEYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8EXAMPLEZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYEXAMPLEpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7EXAMPLEGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFEXAMPLEAtCu4 nUhVVxYUnEXAMPLE8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GEXAMPLEl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----", "ownedBy": "123456789012", "creationDate": 1541022751.983, "lastModifiedDate": 1541022751.983, "customerVersion": 1, "transferData": {}, "generationId": "6974fbed-2e61-4114-bc5e-4204cc79b045", "validity": { "notBefore": 1541022631.0, "notAfter": 2524607999.0 } } } ``` Weitere Informationen finden Sie [DescribeCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeCertificate.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DescribeCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-certificate.html)unter *AWS CLI Befehlsreferenz*. ### `describe-custom-metric` Das folgende Codebeispiel zeigt die Verwendung`describe-custom-metric`. **AWS CLI** **So rufen Sie Informationen zu einer benutzerdefinierten Metrik von Device Defender ab** Im folgenden Beispiel für `describe-custom-metric` werden Informationen zu einer benutzerdefinierten Metrik mit dem Namen `myCustomMetric` abgerufen. ``` aws iot describe-custom-metric \ --metric-name myCustomMetric ``` Ausgabe: ``` { "metricName": "myCustomMetric", "metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/myCustomMetric", "metricType": "number", "displayName": "My custom metric", "creationDate": 2020-11-17T23:02:12.879000-09:00, "lastModifiedDate": 2020-11-17T23:02:12.879000-09:00 } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Metriken](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [DescribeCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-custom-metric.html)in der *AWS CLI Befehlsreferenz*. ### `describe-default-authorizer` Das folgende Codebeispiel zeigt die Verwendung`describe-default-authorizer`. **AWS CLI** **So rufen Sie Informationen zum standardmäßigen benutzerdefinierten Genehmiger ab** Im folgenden Beispiel für `describe-default-authorizer` werden Details für den standardmäßigen benutzerdefinierten Genehmiger angezeigt. ``` aws iot describe-default-authorizer ``` Ausgabe: ``` { "authorizerName": "CustomAuthorizer", "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer" } ``` Weitere Informationen finden Sie [DescribeDefaultAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeDefautAuthorizer.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DescribeDefaultAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-default-authorizer.html)unter *AWS CLI Befehlsreferenz*. ### `describe-dimension` Das folgende Codebeispiel zeigt die Verwendung`describe-dimension`. **AWS CLI** **So rufen Sie Informationen zu einer Dimension ab** Im folgenden Beispiel für `describe-dimension` werden Informationen zu einer Dimension mit dem Namen `TopicFilterForAuthMessages` abgerufen. ``` aws iot describe-dimension \ --name TopicFilterForAuthMessages ``` Ausgabe: ``` { "name": "TopicFilterForAuthMessages", "arn": "arn:aws:iot:eu-west-2:123456789012:dimension/TopicFilterForAuthMessages", "type": "TOPIC_FILTER", "stringValues": [ "device/+/auth" ], "creationDate": 1578620223.255, "lastModifiedDate": 1578620223.255 } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-dimension.html)in der *AWS CLI Befehlsreferenz*. ### `describe-domain-configuration` Das folgende Codebeispiel zeigt die Verwendung`describe-domain-configuration`. **AWS CLI** **So beschreiben Sie eine Domainkonfiguration** Im folgenden Beispiel für `describe-domain-configuration` werden Details zur angegebenen Domainkonfiguration angezeigt. ``` aws iot describe-domain-configuration \ --domain-configuration-name "additionalDataDomain" ``` Ausgabe: ``` { "domainConfigurationName": "additionalDataDomain", "domainConfigurationArn": "arn:aws:iot:us-east-1:758EXAMPLE143:domainconfiguration/additionalDataDomain/norpw", "domainName": "d055exampleed74y71zfd-ats.beta.us-east-1.iot.amazonaws.com", "serverCertificates": [], "domainConfigurationStatus": "ENABLED", "serviceType": "DATA", "domainType": "AWS_MANAGED", "lastStatusChangeDate": 1601923783.774 } ``` Weitere Informationen finden Sie unter [Konfigurierbare Endpunkte](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-domain-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `describe-endpoint` Das folgende Codebeispiel zeigt die Verwendung`describe-endpoint`. **AWS CLI** **Beispiel 1: Um Ihren aktuellen AWS Endpunkt zu ermitteln** Im folgenden `describe-endpoint` Beispiel wird der AWS Standardendpunkt abgerufen, auf den alle Befehle angewendet werden. ``` aws iot describe-endpoint ``` Ausgabe: ``` { "endpointAddress": "abc123defghijk.iot.us-west-2.amazonaws.com" } ``` Weitere Informationen finden Sie [DescribeEndpoint](https://docs.aws.amazon.com/iot/latest/developerguide/iot-commands.html#api-iot-DescribeEndpoint)im *AWS IoT Developer Guide*. **Beispiel 2: So rufen Sie Ihren ATS-Endpunkt ab** Im folgenden Beispiel für `describe-endpoint` wird der Amazon Trust Services (ATS)-Endpunkt abgerufen. ``` aws iot describe-endpoint \ --endpoint-type iot:Data-ATS ``` Ausgabe: ``` { "endpointAddress": "abc123defghijk-ats.iot.us-west-2.amazonaws.com" } ``` Weitere Informationen finden Sie unter [X.509-Zertifikate und AWS IoT im AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/managing-device-certs.html) *Developer Guide*. + Einzelheiten zur API finden Sie [DescribeEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html)in der *AWS CLI Befehlsreferenz.* ### `describe-event-configurations` Das folgende Codebeispiel zeigt die Verwendung`describe-event-configurations`. **AWS CLI** **So zeigen Sie an, welche Ereignistypen veröffentlicht wurden** Im folgenden Beispiel für `describe-event-configurations` wird die Konfiguration aufgelistet, die steuert, welche Ereignisse generiert werden, wenn etwas hinzugefügt, aktualisiert oder gelöscht wird. ``` aws iot describe-event-configurations ``` Ausgabe: ``` { "eventConfigurations": { "CA_CERTIFICATE": { "Enabled": false }, "CERTIFICATE": { "Enabled": false }, "JOB": { "Enabled": false }, "JOB_EXECUTION": { "Enabled": false }, "POLICY": { "Enabled": false }, "THING": { "Enabled": false }, "THING_GROUP": { "Enabled": false }, "THING_GROUP_HIERARCHY": { "Enabled": false }, "THING_GROUP_MEMBERSHIP": { "Enabled": false }, "THING_TYPE": { "Enabled": false }, "THING_TYPE_ASSOCIATION": { "Enabled": false } } } ``` Weitere Informationen finden Sie unter [Ereignismeldungen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-events.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeEventConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-event-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-index` Das folgende Codebeispiel zeigt die Verwendung`describe-index`. **AWS CLI** **So rufen Sie den aktuellen Status des Objektindizes ab** Im folgenden Beispiel für `describe-index` wird der aktuelle Status des Objektindexes abgerufen. ``` aws iot describe-index \ --index-name "AWS_Things" ``` Ausgabe: ``` { "indexName": "AWS_Things", "indexStatus": "ACTIVE", "schema": "REGISTRY_AND_SHADOW_AND_CONNECTIVITY_STATUS" } ``` Weitere Informationen finden Sie unter [Verwalten der Objektindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-index.html)in der *AWS CLI Befehlsreferenz*. ### `describe-job-execution` Das folgende Codebeispiel zeigt die Verwendung`describe-job-execution`. **AWS CLI** **So rufen Sie Ausführungsdetails für einen Auftrag auf einem Gerät ab** Im folgenden Beispiel für `describe-job-execution` werden Ausführungsdetails für den angegebenen Auftrag abgerufen. ``` aws iot describe-job-execution \ --job-id "example-job-01" \ --thing-name "MyRaspberryPi" ``` Ausgabe: ``` { "execution": { "jobId": "example-job-01", "status": "QUEUED", "statusDetails": {}, "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi", "queuedAt": 1560787023.636, "lastUpdatedAt": 1560787023.636, "executionNumber": 1, "versionNumber": 1 } } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-job-execution.html)in der *AWS CLI Befehlsreferenz*. ### `describe-job` Das folgende Codebeispiel zeigt die Verwendung`describe-job`. **AWS CLI** **So rufen Sie den detaillierten Status eines Auftrags ab** Im folgenden Beispiel für `describe-job` wird der detaillierte Status für den Auftrag abgerufen, dessen ID `example-job-01` lautet. ``` aws iot describe-job \ --job-id "example-job-01" ``` Ausgabe: ``` { "job": { "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01", "jobId": "example-job-01", "targetSelection": "SNAPSHOT", "status": "IN_PROGRESS", "targets": [ "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi" ], "description": "example job test", "presignedUrlConfig": {}, "jobExecutionsRolloutConfig": {}, "createdAt": 1560787022.733, "lastUpdatedAt": 1560787026.294, "jobProcessDetails": { "numberOfCanceledThings": 0, "numberOfSucceededThings": 0, "numberOfFailedThings": 0, "numberOfRejectedThings": 0, "numberOfQueuedThings": 1, "numberOfInProgressThings": 0, "numberOfRemovedThings": 0, "numberOfTimedOutThings": 0 }, "timeoutConfig": {} } } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-job.html)in der *AWS CLI Befehlsreferenz*. ### `describe-mitigation-action` Das folgende Codebeispiel zeigt die Verwendung`describe-mitigation-action`. **AWS CLI** **So zeigen Sie die Details zu einer definierten Abhilfemaßnahme an** Im folgenden Beispiel für `describe-mitigation-action` werden Details für die angegebene Abhilfemaßnahme angezeigt. ``` aws iot describe-mitigation-action \ --action-name AddThingsToQuarantineGroupAction ``` Ausgabe: ``` { "actionName": "AddThingsToQuarantineGroupAction", "actionType": "ADD_THINGS_TO_THING_GROUP", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction", "actionId": "2fd2726d-98e1-4abf-b10f-09465ccd6bfa", "roleArn": "arn:aws:iam::123456789012:role/service-role/MoveThingsToQuarantineGroupRole", "actionParams": { "addThingsToThingGroupParams": { "thingGroupNames": [ "QuarantineGroup1" ], "overrideDynamicGroups": true } }, "creationDate": "2019-12-10T11:09:35.999000-08:00", "lastModifiedDate": "2019-12-10T11:09:35.999000-08:00" } ``` Weitere Informationen finden Sie unter [DescribeMitigationAction (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DescribeMitigationAction) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [DescribeMitigationAction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-mitigation-action.html)*Befehlsreferenz.* ### `describe-provisioning-template-version` Das folgende Codebeispiel zeigt die Verwendung`describe-provisioning-template-version`. **AWS CLI** **So beschreiben Sie eine Version einer Bereitstellungsvorlage** Im folgenden Beispiel für `describe-provisioning-template-version` wird eine Version einer Bereitstellungsvorlage beschrieben. ``` aws iot describe-provisioning-template-version \ --template-name MyTestProvisioningTemplate \ --version-id 1 ``` Ausgabe: ``` { "versionId": 1, "creationDate": 1589308310.574, "templateBody": "{ \"Parameters\":{ \"SerialNumber\":{ \"Type\":\"String\" }, \"AWS::IoT::Certificate::Id\":{ \"Type\":\"String\" } }, \"Resources\":{ \"certificate\":{ \"Properties\":{ \"CertificateId\":{ \"Ref\":\"AWS::IoT::Certificate::Id\" }, \"Status\":\"Active\" }, \"Type\":\"AWS::IoT::Certificate\" }, \"policy\":{ \"Properties\":{ \"PolicyName\":\"MyIotPolicy\" }, \"Type\":\"AWS::IoT::Policy\" }, \"thing\":{ \"OverrideSettings\":{ \"AttributePayload\":\"MERGE\", \"ThingGroups\":\"DO_NOTHING\", \"ThingTypeName\":\"REPLACE\" }, \"Properties\":{ \"AttributePayload\":{}, \"ThingGroups\":[], \"ThingName\":{ \"Fn::Join\":[ \"\", [ \"DemoGroup_\", {\"Ref\":\"SerialNumber\"} ] ] }, \"ThingTypeName\":\"VirtualThings\" }, \"Type\":\"AWS::IoT::Thing\" } } }", "isDefaultVersion": true } ``` Weitere Informationen finden Sie unter [Bereitstellen von Geräten ohne Gerätezertifikate mithilfe der Flottenbereitstellung](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [DescribeProvisioningTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-provisioning-template-version.html)in der *AWS CLI Befehlsreferenz*. ### `describe-provisioning-template` Das folgende Codebeispiel zeigt die Verwendung`describe-provisioning-template`. **AWS CLI** **So beschreiben Sie eine Bereitstellungsvorlage** Im folgenden Beispiel für `describe-provisioning-template` wird eine Bereitstellungsvorlage beschrieben. ``` aws iot describe-provisioning-template \ --template-name MyTestProvisioningTemplate ``` Ausgabe: ``` { "templateArn": "arn:aws:iot:us-west-2:57EXAMPLE833:provisioningtemplate/MyTestProvisioningTemplate", "templateName": "MyTestProvisioningTemplate", "creationDate": 1589308310.574, "lastModifiedDate": 1589308345.539, "defaultVersionId": 1, "templateBody": "{ \"Parameters\":{ \"SerialNumber\":{ \"Type\":\"String\" }, \"AWS::IoT::Certificate::Id\":{ \"Type\":\"String\" } }, \"Resources\":{ \"certificate\":{ \"Properties\":{ \"CertificateId\":{ \"Ref\":\"AWS::IoT::Certificate::Id\" }, \"Status\":\"Active\" }, \"Type\":\"AWS::IoT::Certificate\" }, \"policy\":{ \"Properties\":{ \"PolicyName\":\"MyIotPolicy\" }, \"Type\":\"AWS::IoT::Policy\" }, \"thing\":{ \"OverrideSettings\":{ \"AttributePayload\":\"MERGE\", \"ThingGroups\":\"DO_NOTHING\", \"ThingTypeName\":\"REPLACE\" }, \"Properties\":{ \"AttributePayload\":{}, \"ThingGroups\":[], \"ThingName\":{ \"Fn::Join\":[ \"\", [ \"DemoGroup_\", {\"Ref\":\"SerialNumber\"} ] ] }, \"ThingTypeName\":\"VirtualThings\" }, \"Type\":\"AWS::IoT::Thing\" } } }", "enabled": true, "provisioningRoleArn": "arn:aws:iam::571032923833:role/service-role/IoT_access" } ``` Weitere Informationen finden Sie unter [Bereitstellen von Geräten ohne Gerätezertifikate mithilfe der Flottenbereitstellung](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [DescribeProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-provisioning-template.html)in der *AWS CLI Befehlsreferenz*. ### `describe-role-alias` Das folgende Codebeispiel zeigt die Verwendung`describe-role-alias`. **AWS CLI** **Um Informationen über einen AWS IoT-Rollenalias abzurufen** Im folgenden Beispiel für `describe-role-alias` werden Details für den angegebene Rollenalias angezeigt. ``` aws iot describe-role-alias \ --role-alias LightBulbRole ``` Ausgabe: ``` { "roleAliasDescription": { "roleAlias": "LightBulbRole", "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/LightBulbRole", "roleArn": "arn:aws:iam::123456789012:role/light_bulb_role_001", "owner": "123456789012", "credentialDurationSeconds": 3600, "creationDate": 1570558643.221, "lastModifiedDate": 1570558643.221 } } ``` Weitere Informationen finden Sie [DescribeRoleAlias](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeRoleAlias.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DescribeRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-role-alias.html)unter *AWS CLI Befehlsreferenz*. ### `describe-scheduled-audit` Das folgende Codebeispiel zeigt die Verwendung`describe-scheduled-audit`. **AWS CLI** **So rufen Sie Informationen zu einem geplanten Audit ab** Im folgenden `describe-scheduled-audit` Beispiel werden detaillierte Informationen zu einem geplanten AWS IOT Device Defender-Audit mit dem Namen abgerufen`AWSIoTDeviceDefenderDailyAudit`. ``` aws iot describe-scheduled-audit \ --scheduled-audit-name AWSIoTDeviceDefenderDailyAudit ``` Ausgabe: ``` { "frequency": "DAILY", "targetCheckNames": [ "AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK", "CONFLICTING_CLIENT_IDS_CHECK", "DEVICE_CERTIFICATE_SHARED_CHECK", "IOT_POLICY_OVERLY_PERMISSIVE_CHECK", "REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK", "UNAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK" ], "scheduledAuditName": "AWSIoTDeviceDefenderDailyAudit", "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/AWSIoTDeviceDefenderDailyAudit" } ``` Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-scheduled-audit.html)in der *AWS CLI Befehlsreferenz*. ### `describe-security-profile` Das folgende Codebeispiel zeigt die Verwendung`describe-security-profile`. **AWS CLI** **So rufen Sie Informationen zu einem Sicherheitsprofil ab** Im folgenden `describe-security-profile` Beispiel werden Informationen über das AWS IoT Device Defender-Sicherheitsprofil mit dem Namen abgerufen `PossibleIssue.` ``` aws iot describe-security-profile \ --security-profile-name PossibleIssue ``` Ausgabe: ``` { "securityProfileName": "PossibleIssue", "securityProfileArn": "arn:aws:iot:us-west-2:123456789012:securityprofile/PossibleIssue", "securityProfileDescription": "check to see if authorization fails 10 times in 5 minutes or if cellular bandwidth exceeds 128", "behaviors": [ { "name": "CellularBandwidth", "metric": "aws:message-byte-size", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 128 }, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, { "name": "Authorization", "metric": "aws:num-authorization-failures", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 10 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } } ], "version": 1, "creationDate": 1560278102.528, "lastModifiedDate": 1560278102.528 } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-security-profile.html)unter *AWS CLI Befehlsreferenz*. ### `describe-stream` Das folgende Codebeispiel zeigt die Verwendung`describe-stream`. **AWS CLI** **So rufen Sie Informationen zu einem Stream ab** Im folgenden Beispiel für `describe-stream` werden die Details für den angegebenen Stream angezeigt. ``` aws iot describe-stream \ --stream-id stream12345 ``` Ausgabe: ``` { "streamInfo": { "streamId": "stream12345", "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345", "streamVersion": 1, "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.", "files": [ { "fileId": "123", "s3Location": { "bucket":"codesign-ota-bucket", "key":"48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6" } } ], "createdAt": 1557863215.995, "lastUpdatedAt": 1557863215.995, "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_stream_role" } } ``` Weitere Informationen finden Sie [DescribeStream](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeStream.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DescribeStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-stream.html)unter *AWS CLI Befehlsreferenz*. ### `describe-thing-group` Das folgende Codebeispiel zeigt die Verwendung`describe-thing-group`. **AWS CLI** **So rufen Sie Informationen zu einer Objektgruppe ab** Im folgenden Beispiel für `describe-thing-group` werden Informationen über die Objektgruppe mit dem Namen `HalogenBulbs` abgerufen. ``` aws iot describe-thing-group \ --thing-group-name HalogenBulbs ``` Ausgabe: ``` { "thingGroupName": "HalogenBulbs", "thingGroupId": "f4ec6b84-b42b-499d-9ce1-4dbd4d4f6f6e", "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/HalogenBulbs", "version": 1, "thingGroupProperties": {}, "thingGroupMetadata": { "parentGroupName": "LightBulbs", "rootToParentThingGroups": [ { "groupName": "LightBulbs", "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" } ], "creationDate": 1559927609.897 } } ``` Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing-group.html)in der *AWS CLI Befehlsreferenz*. ### `describe-thing-type` Das folgende Codebeispiel zeigt die Verwendung`describe-thing-type`. **AWS CLI** **So rufen Sie Informationen zu einem Objekttyp ab** Im folgenden `describe-thing-type` Beispiel werden Informationen über den angegebenen Dingtyp angezeigt, der in Ihrem AWS Konto definiert ist. ``` aws iot describe-thing-type \ --thing-type-name "LightBulb" ``` Ausgabe: ``` { "thingTypeName": "LightBulb", "thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190", "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb", "thingTypeProperties": { "thingTypeDescription": "light bulb type", "searchableAttributes": [ "model", "wattage" ] }, "thingTypeMetadata": { "deprecated": false, "creationDate": 1559772562.498 } } ``` Weitere Informationen finden Sie unter [Objekttypen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing-type.html)in der *AWS CLI Befehlsreferenz*. ### `describe-thing` Das folgende Codebeispiel zeigt die Verwendung`describe-thing`. **AWS CLI** **So zeigen Sie detaillierte Informationen zu einem Objekt an** Im folgenden `describe-thing` Beispiel werden Informationen zu einer Sache (einem Gerät) angezeigt, die in der AWS IoT-Registrierung für Ihr AWS Konto definiert ist. als iot describe-thing --thing-name“ MyLightBulb Ausgabe: ``` { "defaultClientId": "MyLightBulb", "thingName": "MyLightBulb", "thingId": "40da2e73-c6af-406e-b415-15acae538797", "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb", "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1 } ``` Weitere Informationen finden Sie unter [Objektverwaltung mit der Registry](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) im *Entwicklerhandbuch für AWS IoT*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DescribeThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing.html)AWS CLI * ### `detach-policy` Das folgende Codebeispiel zeigt die Verwendung`detach-policy`. **AWS CLI** **Beispiel 1: Um eine AWS IoT-Richtlinie von einer Dinggruppe zu trennen** Im folgenden Beispiel für `detach-policy` wird die angegebene Richtlinie von einer Objektgruppe, und damit auch von allen Objekten in dieser Gruppe und allen ihren untergeordneten Gruppen, getrennt. ``` aws iot detach-policy \ --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \ --policy-name "MyFirstGroup_Core-policy" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. **Beispiel 2: So trennen Sie eine AWS IoT-Richtlinie von einem Gerätezertifikat** Im folgenden `detach-policy` Beispiel wird die TemperatureSensorPolicy Richtlinie von einem durch ARN identifizierten Gerätezertifikat getrennt. ``` aws iot detach-policy \ --policy-name TemperatureSensorPolicy \ --target arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DetachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-policy.html)in der *AWS CLI Befehlsreferenz.* ### `detach-security-profile` Das folgende Codebeispiel zeigt die Verwendung`detach-security-profile`. **AWS CLI** **So heben Sie die Zuordnung eines Sicherheitsprofils zu einem Ziel auf** Im folgenden `detach-security-profile` Beispiel wird die Zuordnung zwischen dem genannten AWS IoT Device Defender-Sicherheitsprofil `Testprofile` und dem Ziel „Alle registrierten Dinge“ entfernt. ``` aws iot detach-security-profile \ --security-profile-name Testprofile \ --security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/registered-things" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DetachSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-security-profile.html)unter *AWS CLI Befehlsreferenz*. ### `detach-thing-principal` Das folgende Codebeispiel zeigt die Verwendung`detach-thing-principal`. **AWS CLI** **Um ein certificate/principal von einem Ding zu trennen** Im folgenden Beispiel für `detach-thing-principal` wird ein Zertifikat, das einen Prinzipal darstellt, aus dem angegebenen Objekt entfernt. ``` aws iot detach-thing-principal \ --thing-name "MyLightBulb" \ --principal "arn:aws:iot:us-west-2:123456789012:cert/604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Objektverwaltung mit der Registry](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DetachThingPrincipal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-thing-principal.html)in der *AWS CLI Befehlsreferenz.* ### `disable-topic-rule` Das folgende Codebeispiel zeigt die Verwendung`disable-topic-rule`. **AWS CLI** **So deaktivieren Sie eine Themenregel** Im folgenden Beispiel für `disable-topic-rule` wird die angegebene Themenregel deaktiviert. ``` aws iot disable-topic-rule \ --rule-name "MyPlantPiMoistureAlertRule" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Anzeigen Ihrer Regeln](https://docs.aws.amazon.com/iot/latest/developerguide/iot-view-rules.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DisableTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/disable-topic-rule.html)in der *AWS CLI Befehlsreferenz*. ### `enable-topic-rule` Das folgende Codebeispiel zeigt die Verwendung`enable-topic-rule`. **AWS CLI** **So aktivieren Sie eine Themenregel** Im folgenden Beispiel für `enable-topic-rule` wird die angegebene Themenregel aktiviert (oder erneut aktiviert). ``` aws iot enable-topic-rule \ --rule-name "MyPlantPiMoistureAlertRule" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Anzeigen Ihrer Regeln](https://docs.aws.amazon.com/iot/latest/developerguide/iot-view-rules.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [EnableTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/enable-topic-rule.html)in der *AWS CLI Befehlsreferenz*. ### `get-behavior-model-training-summaries` Das folgende Codebeispiel zeigt die Verwendung`get-behavior-model-training-summaries`. **AWS CLI** **So listen Sie den Status des Trainingsmodells eines ML-Detect-Sicherheitsprofils von Device Defender auf** Im folgenden Beispiel für `get-behavior-model-training-summaries` wird der Trainingsstatus des Modells für die konfigurierten Verhaltensweisen im ausgewählten Sicherheitsprofil aufgelistet. Für jedes Verhalten werden der Name, der Modellstatus und der Prozentsatz der erfassten Datenpunkte aufgeführt. ``` aws iot get-behavior-model-training-summaries \ --security-profile-name MySecuirtyProfileName ``` Ausgabe: ``` { "summaries": [ { "securityProfileName": "MySecuirtyProfileName", "behaviorName": "Messages_sent_ML_behavior", "modelStatus": "PENDING_BUILD", "datapointsCollectionPercentage": 0.0 }, { "securityProfileName": "MySecuirtyProfileName", "behaviorName": "Messages_received_ML_behavior", "modelStatus": "PENDING_BUILD", "datapointsCollectionPercentage": 0.0 }, { "securityProfileName": "MySecuirtyProfileName", "behaviorName": "Authorization_failures_ML_behavior", "modelStatus": "PENDING_BUILD", "datapointsCollectionPercentage": 0.0 }, { "securityProfileName": "MySecuirtyProfileName", "behaviorName": "Message_size_ML_behavior", "modelStatus": "PENDING_BUILD", "datapointsCollectionPercentage": 0.0 }, { "securityProfileName": "MySecuirtyProfileName", "behaviorName": "Connection_attempts_ML_behavior", "modelStatus": "PENDING_BUILD", "datapointsCollectionPercentage": 0.0 }, { "securityProfileName": "MySPNoALerts", "behaviorName": "Disconnects_ML_behavior", "modelStatus": "PENDING_BUILD", "datapointsCollectionPercentage": 0.0 } ] } ``` Weitere Informationen finden Sie unter [GetBehaviorModelTrainingSummaries (Befehle erkennen)](https://docs.aws.amazon.com/iot/latest/developerguide/detect-commands.html) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie [GetBehaviorModelTrainingSummaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-behavior-model-training-summaries.html)in der *AWS CLI Befehlsreferenz*. ### `get-cardinality` Das folgende Codebeispiel zeigt die Verwendung`get-cardinality`. **AWS CLI** **So erhalten Sie die ungefähre Anzahl eindeutiger Werte, die mit der Abfrage übereinstimmen** Sie können das folgende Setup-Skript verwenden, um 10 Objekte zu erstellen, die 10 Temperatursensoren repräsentieren. Jedes neue Objekt hat 3 Attribute. ``` # Bash script. If in other shells, type `bash` before running Temperatures=(70 71 72 73 74 75 47 97 98 99) Racks=(Rack1 Rack1 Rack2 Rack2 Rack3 Rack4 Rack5 Rack6 Rack6 Rack6) IsNormal=(true true true true true true false false false false) for ((i=0; i<10 ; i++)) do thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[i]},rackId=${Racks[i]},stateNormal=${IsNormal[i]}}") aws iot describe-thing --thing-name "TempSensor$i" done ``` Beispielausgabe des Setup-Skripts: ``` { "version": 1, "thingName": "TempSensor0", "defaultClientId": "TempSensor0", "attributes": { "rackId": "Rack1", "stateNormal": "true", "temperature": "70" }, "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/TempSensor0", "thingId": "example1-90ab-cdef-fedc-ba987example" } ``` Im folgenden Beispiel für `get-cardinality` werden die 10 vom Setup-Skript erstellten Sensoren abgefragt und es wird die Anzahl der Racks zurückgegeben, deren Temperatursensoren abnormale Temperaturwerte melden. Wenn der Temperaturwert unter 60 oder über 80 liegt, befindet sich der Temperatursensor in einem abnormalen Zustand. ``` aws iot get-cardinality \ --aggregation-field "attributes.rackId" \ --query-string "thingName:TempSensor* AND attributes.stateNormal:false" ``` Ausgabe: ``` { "cardinality": 2 } ``` *Weitere Informationen finden Sie unter Abfragen von Aggregatdaten< https://docs.aws.amazon.com/iot/ latest/developerguide/index -aggregate.html> im IoT Developer Guide.AWS * + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [GetCardinality](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-cardinality.html)AWS CLI * ### `get-effective-policies` Das folgende Codebeispiel zeigt die Verwendung`get-effective-policies`. **AWS CLI** **So listen Sie die Richtlinien auf, die sich auf ein Objekt auswirken** Im folgenden Beispiel für `get-effective-policies` werden die Richtlinien aufgelistet, die sich auf das angegebene Objekt auswirken, einschließlich der Richtlinien, die allen Gruppen zugeordnet sind, zu denen es gehört. ``` aws iot get-effective-policies \ --thing-name TemperatureSensor-001 \ --principal arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142 ``` Ausgabe: ``` { "effectivePolicies": [ { "policyName": "TemperatureSensorPolicy", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy", "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\": [ \"iot:Publish\", \"iot:Receive\" ], \"Resource\": [ \"arn:aws:iot:us-west-2:123456789012:topic/topic_1\", \"arn:aws:iot:us-west-2:123456789012:topic/topic_2\" ] }, { \"Effect\": \"Allow\", \"Action\": [ \"iot:Subscribe\" ], \"Resource\": [ \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_1\", \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_2\" ] }, { \"Effect\": \"Allow\", \"Action\": [ \"iot:Connect\" ], \"Resource\": [ \"arn:aws:iot:us-west-2:123456789012:client/basicPubSub\" ] } ] }" } ] } ``` Weitere Informationen finden Sie unter [Abrufen gültiger Richtlinien für ein Objekt](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#group-get-effective-policies) im *Entwicklerhandbuch zu AWS IoT*. + Einzelheiten zur API finden Sie [GetEffectivePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-effective-policies.html)in der *AWS CLI Befehlsreferenz*. ### `get-indexing-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-indexing-configuration`. **AWS CLI** **So rufen Sie die Konfiguration für die Objektindizierung ab** Im folgenden `get-indexing-configuration` Beispiel werden die aktuellen Konfigurationsdaten für die AWS IoT-Flottenindizierung abgerufen. ``` aws iot get-indexing-configuration ``` Ausgabe: ``` { "thingIndexingConfiguration": { "thingIndexingMode": "OFF", "thingConnectivityIndexingMode": "OFF" }, "thingGroupIndexingConfiguration": { "thingGroupIndexingMode": "OFF" } } ``` Weitere Informationen finden Sie unter [Verwalten der Objektindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetIndexingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-indexing-configuration.html)in der *AWS CLI Befehlsreferenz.* ### `get-job-document` Das folgende Codebeispiel zeigt die Verwendung`get-job-document`. **AWS CLI** **So rufen Sie das Dokument für einen Auftrag ab** Im folgenden Beispiel für `get-job-document` werden Details zu dem Dokument für den Auftrag angezeigt, dessen ID `example-job-01` lautet. ``` aws iot get-job-document \ --job-id "example-job-01" ``` Ausgabe: ``` { "document": "\n{\n \"operation\":\"customJob\",\n \"otherInfo\":\"someValue\"\n}\n" } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetJobDocument](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-job-document.html)in der *AWS CLI Befehlsreferenz*. ### `get-logging-options` Das folgende Codebeispiel zeigt die Verwendung`get-logging-options`. **AWS CLI** **So rufen Sie die Protokollierungsoptionen ab** Im folgenden `get-logging-options` Beispiel werden die aktuellen Protokollierungsoptionen für Ihr AWS Konto abgerufen. ``` aws iot get-logging-options ``` Ausgabe: ``` { "roleArn": "arn:aws:iam::123456789012:role/service-role/iotLoggingRole", "logLevel": "ERROR" } ``` Weitere Informationen finden Sie unter dem Titel im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-logging-options.html)in der *AWS CLI Befehlsreferenz*. ### `get-ota-update` Das folgende Codebeispiel zeigt die Verwendung`get-ota-update`. **AWS CLI** **So rufen Sie Informationen über ein OTA-Update ab** Im folgenden Beispiel für `get-ota-update` werden Details zum angegebenen OTA-Update angezeigt. ``` aws iot get-ota-update \ --ota-update-id ota12345 ``` Ausgabe: ``` { "otaUpdateInfo": { "otaUpdateId": "ota12345", "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate", "creationDate": 1557863215.995, "lastModifiedDate": 1557863215.995, "description": "A critical update needed right away.", "targets": [ "device1", "device2", "device3", "device4" ], "targetSelection": "SNAPSHOT", "protocols": ["HTTP"], "awsJobExecutionsRolloutConfig": { "maximumPerMinute": 10 }, "otaUpdateFiles": [ { "fileName": "firmware.bin", "fileLocation": { "stream": { "streamId": "004", "fileId":123 } }, "codeSigning": { "awsSignerJobId": "48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6" } } ], "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_role" "otaUpdateStatus": "CREATE_COMPLETE", "awsIotJobId": "job54321", "awsIotJobArn": "arn:aws:iot:us-west-2:123456789012:job/job54321", "errorInfo": { } } } ``` Weitere Informationen finden Sie unter [Get OTAUpdate](https://docs.aws.amazon.com/iot/latest/apireference/API_GetOTAUpdate.html) in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [GetOtaUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-ota-update.html)unter *AWS CLI Befehlsreferenz*. ### `get-percentiles` Das folgende Codebeispiel zeigt die Verwendung`get-percentiles`. **AWS CLI** **So gruppieren Sie die aggregierten Werte, die der Abfrage entsprechen, in Perzentilgruppierungen** Sie können das folgende Setup-Skript verwenden, um 10 Objekte zu erstellen, die 10 Temperatursensoren repräsentieren. Jedes neue Objekt hat 1 Attribut. ``` # Bash script. If in other shells, type `bash` before running Temperatures=(70 71 72 73 74 75 47 97 98 99) for ((i=0; i<10 ; i++)) do thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[i]}}") aws iot describe-thing --thing-name "TempSensor$i" done ``` Beispielausgabe des Setup-Skripts: ``` { "version": 1, "thingName": "TempSensor0", "defaultClientId": "TempSensor0", "attributes": { "temperature": "70" }, "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/TempSensor0", "thingId": "example1-90ab-cdef-fedc-ba987example" } ``` Im folgenden Beispiel für `get-percentiles` werden die 10 vom Setup-Skript erstellten Sensoren abgefragt und für jede angegebene Perzentilgruppe wird ein Wert zurückgegeben. Die Perzentilgruppe „10“ enthält den aggregierten Feldwert, der in etwa in 10 Prozent der Werte auftritt, die der Abfrage entsprechen. In der folgenden Ausgabe bedeutet \$1"percent": 10.0, "value": 67.7\$1, dass ungefähr 10,0 % der Temperaturwerte unter 67,7 liegen. ``` aws iot get-percentiles \ --aggregation-field "attributes.temperature" \ --query-string "thingName:TempSensor*" \ --percents 10 25 50 75 90 ``` Ausgabe: ``` { "percentiles": [ { "percent": 10.0, "value": 67.7 }, { "percent": 25.0, "value": 71.25 }, { "percent": 50.0, "value": 73.5 }, { "percent": 75.0, "value": 91.5 }, { "percent": 90.0, "value": 98.1 } ] } ``` Weitere Informationen finden Sie unter [Abfragen von Aggregatdaten](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetPercentiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-percentiles.html)in der *AWS CLI Befehlsreferenz*. ### `get-policy-version` Das folgende Codebeispiel zeigt die Verwendung`get-policy-version`. **AWS CLI** **So rufen Sie Informationen zu einer bestimmten Version einer Richtlinie ab** Im folgenden Beispiel für `get-policy-version` werden Informationen zur ersten Version der angegebenen Richtlinie abgerufen. ``` aws iot get-policy \ --policy-name UpdateDeviceCertPolicy --policy-version-id "1" ``` Ausgabe: ``` { "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy", "policyName": "UpdateDeviceCertPolicy", "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\": \"iot:UpdateCertificate\", \"Resource\": \"*\" } ] }", "policyVersionId": "1", "isDefaultVersion": false, "creationDate": 1559925941.924, "lastModifiedDate": 1559926175.458, "generationId": "5066f1b6712ce9d2a1e56399771649a272d6a921762fead080e24fe52f24e042" } ``` Weitere Informationen finden Sie unter [AWS -IoT-Richtlinien](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetPolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-policy-version.html)in der *AWS CLI Befehlsreferenz*. ### `get-policy` Das folgende Codebeispiel zeigt die Verwendung`get-policy`. **AWS CLI** **So rufen Sie Informationen zur Standardversion einer Richtlinie ab** Im folgenden Beispiel für `get-policy` werden Informationen über die Standardversion der angegebenen Richtlinie abgerufen. ``` aws iot get-policy \ --policy-name UpdateDeviceCertPolicy ``` Ausgabe: ``` { "policyName": "UpdateDeviceCertPolicy", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy", "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\": \"iot:UpdateCertificate\", \"Resource\": \"*\" } ] }", "defaultVersionId": "2", "creationDate": 1559925941.924, "lastModifiedDate": 1559925941.924, "generationId": "5066f1b6712ce9d2a1e56399771649a272d6a921762fead080e24fe52f24e042" } ``` Weitere Informationen finden Sie unter [AWS -IoT-Richtlinien](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-registration-code` Das folgende Codebeispiel zeigt die Verwendung`get-registration-code`. **AWS CLI** **Um Ihren AWS kontospezifischen Registrierungscode zu erhalten** Im folgenden `get-registration-code` Beispiel wird Ihr AWS kontospezifischer Registrierungscode abgerufen. ``` aws iot get-registration-code ``` Ausgabe: ``` { "registrationCode": "15c51ae5e36ba59ba77042df1115862076bea4bd15841c838fcb68d5010a614c" } ``` Weitere Informationen finden Sie unter [Verwenden eines eigenen Zertifikats](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-your-own.html) im *Entwicklerhandbuch für AWS IoT*. + *Einzelheiten zur API finden Sie [GetRegistrationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-registration-code.html)in AWS CLI der Befehlsreferenz.* ### `get-statistics` Das folgende Codebeispiel zeigt die Verwendung`get-statistics`. **AWS CLI** **So suchen Sie im Geräteindex nach aggregierten Daten** Im folgenden Beispiel für `get-statistics` wird die Anzahl der Objekte zurückgegeben, für die in ihrem Geräteschatten die Eigenschaft mit dem Namen `connectivity.connected` auf den Wert `false` (die Anzahl der nicht verbundenen Geräte) gesetzt ist. ``` aws iot get-statistics \ --index-name AWS_Things \ --query-string "connectivity.connected:false" ``` Ausgabe: ``` { "statistics": { "count": 6 } } ``` Weitere Informationen finden Sie unter [Abrufen von Statistiken zu Ihrer Geräteflotte](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-statistics.html)in der *AWS CLI Befehlsreferenz*. ### `get-topic-rule-destination` Das folgende Codebeispiel zeigt die Verwendung`get-topic-rule-destination`. **AWS CLI** **So rufen Sie ein Ziel für eine Themenregel ab** Im folgenden Beispiel für `get-topic-rule-destination` werden Informationen zu einem Themenregelziel abgerufen. ``` aws iot get-topic-rule-destination \ --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" ``` Ausgabe: ``` { "topicRuleDestination": { "arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "status": "DISABLED", "httpUrlProperties": { "confirmationUrl": "https://example.com" } } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Themenregelzielen](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-topic-rule-destination.html)in der *AWS CLI Befehlsreferenz*. ### `get-topic-rule` Das folgende Codebeispiel zeigt die Verwendung`get-topic-rule`. **AWS CLI** **So rufen Sie Informationen zu einer Regel ab** Im folgenden Beispiel für `get-topic-rule` werden Informationen zur angegebenen Regel angezeigt. ``` aws iot get-topic-rule \ --rule-name MyRPiLowMoistureAlertRule ``` Ausgabe: ``` { "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyRPiLowMoistureAlertRule", "rule": { "ruleName": "MyRPiLowMoistureAlertRule", "sql": "SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\n ", "description": "Sends an alert whenever soil moisture level readings are too low.", "createdAt": 1558624363.0, "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic", "roleArn": "arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole", "messageFormat": "RAW" } } ], "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23" } } ``` Weitere Informationen finden Sie unter [Anzeigen Ihrer Regeln](https://docs.aws.amazon.com/iot/latest/developerguide/iot-managae-rule.html#iot-view-rules) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-topic-rule.html)in der *AWS CLI Befehlsreferenz*. ### `get-v2-logging-options` Das folgende Codebeispiel zeigt die Verwendung`get-v2-logging-options`. **AWS CLI** **So listen Sie die aktuellen Protokollierungsoptionen auf** Das folgende `get-v2-logging-options` Beispiel listet die aktuellen Protokollierungsoptionen für AWS IoT auf. ``` aws iot get-v2-logging-options ``` Ausgabe: ``` { "roleArn": "arn:aws:iam::094249569039:role/service-role/iotLoggingRole", "defaultLogLevel": "WARN", "disableAllLogs": false } ``` Weitere Informationen finden Sie unter dem Titel im *Entwicklerhandbuch für AWS IoT*. + API-Details finden Sie unter [GetV2 LoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-v2-logging-options.html) in der *AWS CLI Befehlsreferenz.* ### `list-active-violations` Das folgende Codebeispiel zeigt die Verwendung`list-active-violations`. **AWS CLI** **So listen Sie die aktiven Verstöße auf** Im folgenden Beispiel für `list-active-violations` werden alle Verstöße für das angegebene Sicherheitsprofil aufgelistet. ``` aws iot list-active-violations \ --security-profile-name Testprofile ``` Ausgabe: ``` { "activeViolations": [ { "violationId": "174db59167fa474c80a652ad1583fd44", "thingName": "iotconsole-1560269126751-1", "securityProfileName": "Testprofile", "behavior": { "name": "Authorization", "metric": "aws:num-authorization-failures", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 10 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, "lastViolationValue": { "count": 0 }, "lastViolationTime": 1560293700.0, "violationStartTime": 1560279000.0 }, { "violationId": "c8a9466a093d3b7b35cd44ca58bdbeab", "thingName": "TvnQoEoU", "securityProfileName": "Testprofile", "behavior": { "name": "CellularBandwidth", "metric": "aws:message-byte-size", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 128 }, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, "lastViolationValue": { "count": 110 }, "lastViolationTime": 1560369000.0, "violationStartTime": 1560276600.0 }, { "violationId": "74aa393adea02e6648f3ac362beed55e", "thingName": "iotconsole-1560269232412-2", "securityProfileName": "Testprofile", "behavior": { "name": "Authorization", "metric": "aws:num-authorization-failures", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 10 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, "lastViolationValue": { "count": 0 }, "lastViolationTime": 1560276600.0, "violationStartTime": 1560276600.0 }, { "violationId": "1e6ab5f7cf39a1466fcd154e1377e406", "thingName": "TvnQoEoU", "securityProfileName": "Testprofile", "behavior": { "name": "Authorization", "metric": "aws:num-authorization-failures", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 10 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, "lastViolationValue": { "count": 0 }, "lastViolationTime": 1560369000.0, "violationStartTime": 1560276600.0 } ] } ``` + Einzelheiten zur API finden Sie [ListActiveViolations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-active-violations.html)in der *AWS CLI Befehlsreferenz*. ### `list-attached-policies` Das folgende Codebeispiel zeigt die Verwendung`list-attached-policies`. **AWS CLI** **Beispiel 1: So listen Sie die an eine Gruppe angehängten Richtlinien auf** Im folgenden Beispiel für `list-attached-policies` werden die Richtlinien aufgelistet, die an die angegebene Gruppe angehängt sind. ``` aws iot list-attached-policies \ --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" ``` Ausgabe: ``` { "policies": [ { "policyName": "UpdateDeviceCertPolicy", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy" } ] } ``` Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. **Beispiel 2: So listen Sie die Richtlinien auf, die an ein Gerätezertifikat angehängt sind** Das folgende `list-attached-policies` Beispiel listet die AWS IoT-Richtlinien auf, die mit dem Gerätezertifikat verknüpft sind. Das Zertifikat wird durch seinen ARN identifiziert. ``` aws iot list-attached-policies \ --target arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142 ``` Ausgabe: ``` { "policies": [ { "policyName": "TemperatureSensorPolicy", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy" } ] } ``` Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListAttachedPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-attached-policies.html)in der *AWS CLI Befehlsreferenz*. ### `list-audit-findings` Das folgende Codebeispiel zeigt die Verwendung`list-audit-findings`. **AWS CLI** **Beispiel 1: So listen Sie alle Erkenntnisse aus einem Audit auf** Das folgende `list-audit-findings` Beispiel listet alle Ergebnisse eines AWS IoT Device Defender Defender-Audits mit einer angegebenen Task-ID auf. ``` aws iot list-audit-findings \ --task-id a3aea009955e501a31b764abe1bebd3d ``` Ausgabe: ``` { "findings": [] } ``` **Beispiel 2: So listen Sie Erkenntnisse für einen Audit-Check-Typ auf** Das folgende `list-audit-findings` Beispiel zeigt Ergebnisse von AWS IoT Device Defender Defender-Audits, die zwischen dem 5. Juni 2019 und dem 19. Juni 2019 stattfanden und bei denen Geräte ein Gerätezertifikat gemeinsam nutzen. Wenn Sie einen Check-Namen angeben, müssen Sie eine Start- und Endzeit festlegen. ``` aws iot list-audit-findings \ --check-name DEVICE_CERTIFICATE_SHARED_CHECK \ --start-time 1559747125 \ --end-time 1560962028 ``` Ausgabe: ``` { "findings": [ { "taskId": "eeef61068b0eb03c456d746c5a26ee04", "checkName": "DEVICE_CERTIFICATE_SHARED_CHECK", "taskStartTime": 1560161017.172, "findingTime": 1560161017.592, "severity": "CRITICAL", "nonCompliantResource": { "resourceType": "DEVICE_CERTIFICATE", "resourceIdentifier": { "deviceCertificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b" } }, "relatedResources": [ { "resourceType": "CLIENT_ID", "resourceIdentifier": { "clientId": "ZipxgAIl" }, "additionalInfo": { "CONNECTION_TIME": "1560086374068" } }, { "resourceType": "CLIENT_ID", "resourceIdentifier": { "clientId": "ZipxgAIl" }, "additionalInfo": { "CONNECTION_TIME": "1560081552187", "DISCONNECTION_TIME": "1560086371552" } }, { "resourceType": "CLIENT_ID", "resourceIdentifier": { "clientId": "ZipxgAIl" }, "additionalInfo": { "CONNECTION_TIME": "1559289863631", "DISCONNECTION_TIME": "1560081532716" } } ], "reasonForNonCompliance": "Certificate shared by one or more devices.", "reasonForNonComplianceCode": "CERTIFICATE_SHARED_BY_MULTIPLE_DEVICES" }, { "taskId": "bade6b5efd2e1b1569822f6021b39cf5", "checkName": "DEVICE_CERTIFICATE_SHARED_CHECK", "taskStartTime": 1559988217.27, "findingTime": 1559988217.655, "severity": "CRITICAL", "nonCompliantResource": { "resourceType": "DEVICE_CERTIFICATE", "resourceIdentifier": { "deviceCertificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b" } }, "relatedResources": [ { "resourceType": "CLIENT_ID", "resourceIdentifier": { "clientId": "xShGENLW" }, "additionalInfo": { "CONNECTION_TIME": "1559972350825" } }, { "resourceType": "CLIENT_ID", "resourceIdentifier": { "clientId": "xShGENLW" }, "additionalInfo": { "CONNECTION_TIME": "1559255062002", "DISCONNECTION_TIME": "1559972350616" } } ], "reasonForNonCompliance": "Certificate shared by one or more devices.", "reasonForNonComplianceCode": "CERTIFICATE_SHARED_BY_MULTIPLE_DEVICES" }, { "taskId": "c23f6233ba2d35879c4bb2810fb5ffd6", "checkName": "DEVICE_CERTIFICATE_SHARED_CHECK", "taskStartTime": 1559901817.31, "findingTime": 1559901817.767, "severity": "CRITICAL", "nonCompliantResource": { "resourceType": "DEVICE_CERTIFICATE", "resourceIdentifier": { "deviceCertificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b" } }, "relatedResources": [ { "resourceType": "CLIENT_ID", "resourceIdentifier": { "clientId": "TvnQoEoU" }, "additionalInfo": { "CONNECTION_TIME": "1559826729768" } }, { "resourceType": "CLIENT_ID", "resourceIdentifier": { "clientId": "TvnQoEoU" }, "additionalInfo": { "CONNECTION_TIME": "1559345920964", "DISCONNECTION_TIME": "1559826728402" } } ], "reasonForNonCompliance": "Certificate shared by one or more devices.", "reasonForNonComplianceCode": "CERTIFICATE_SHARED_BY_MULTIPLE_DEVICES" } ] } ``` Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListAuditFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-findings.html)in der *AWS CLI Befehlsreferenz*. ### `list-audit-mitigation-actions-executions` Das folgende Codebeispiel zeigt die Verwendung`list-audit-mitigation-actions-executions`. **AWS CLI** **So listen Sie die Details zur Ausführung einer Audit-Abhilfemaßnahme auf** Eine Aufgabe zur Audit-Abwehr wendet eine Abhilfemaßnahme auf ein oder mehrere Ergebnisse eines AWS IoT Device Defender Defender-Audits an. Im folgenden Beispiel für `list-audit-mitigation-actions-executions` werden die Details für die Abhilfeaufgabe mit der angegebenen `taskId` und für die angegebene Erkenntnis aufgelistet. ``` aws iot list-audit-mitigation-actions-executions \ --task-id myActionsTaskId \ --finding-id 0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464 ``` Ausgabe: ``` { "actionsExecutions": [ { "taskId": "myActionsTaskId", "findingId": "0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464", "actionName": "ResetPolicyVersionAction", "actionId": "1ea0b415-bef1-4a01-bd13-72fb63c59afb", "status": "COMPLETED", "startTime": "2019-12-10T15:19:13.279000-08:00", "endTime": "2019-12-10T15:19:13.337000-08:00" } ] } ``` Weitere Informationen finden Sie unter [ListAuditMitigationActionsExecutions (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListAuditMitigationActionsExecutions) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [ListAuditMitigationActionsExecutions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-mitigation-actions-executions.html)*Befehlsreferenz.* ### `list-audit-mitigation-actions-tasks` Das folgende Codebeispiel zeigt die Verwendung`list-audit-mitigation-actions-tasks`. **AWS CLI** **So listen Sie Audit-Abhilfeaufgaben auf** Im folgenden Beispiel für `list-audit-mitigation-actions-tasks` werden die Abhilfemaßnahmen aufgelistet, die innerhalb des angegebenen Zeitraums auf Erkenntnisse angewendet wurden. ``` aws iot list-audit-mitigation-actions-tasks \ --start-time 1594157400 \ --end-time 1594157430 ``` Ausgabe: ``` { "tasks": [ { "taskId": "0062f2d6-3999-488f-88c7-bef005414103", "startTime": "2020-07-07T14:30:15.172000-07:00", "taskStatus": "COMPLETED" } ] } ``` Weitere Informationen finden Sie unter [ListAuditMitigationActionsTasks (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListAuditMitigationActionsTasks) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [ListAuditMitigationActionsTasks AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-mitigation-actions-tasks.html)*Befehlsreferenz.* ### `list-audit-suppressions` Das folgende Codebeispiel zeigt die Verwendung`list-audit-suppressions`. **AWS CLI** **So listen Sie alle Unterdrückungen Ihrer Audit-Erkenntnisse auf** Im folgenden Beispiel für `list-audit-suppressions` werden alle aktiven Unterdrückungen von Audit-Erkenntnissen aufgelistet. ``` aws iot list-audit-suppressions ``` Ausgabe: ``` { "suppressions": [ { "checkName": "DEVICE_CERTIFICATE_EXPIRING_CHECK", "resourceIdentifier": { "deviceCertificateId": "c7691e" }, "expirationDate": 1597881600.0, "suppressIndefinitely": false } ] } ``` Weitere Informationen finden Sie unter [Unterdrückungen von Prüfergebnissen](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListAuditSuppressions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-suppressions.html)in der *AWS CLI Befehlsreferenz*. ### `list-audit-tasks` Das folgende Codebeispiel zeigt die Verwendung`list-audit-tasks`. **AWS CLI** **So listen Sie alle Erkenntnisse aus einem Audit auf** Im folgenden Beispiel für `list-audit-tasks` werden die Audit-Aufgaben aufgelistet, die zwischen 5. und 12. Juni 2019 ausgeführt wurden. ``` aws iot list-audit-tasks \ --start-time 1559747125 \ --end-time 1560357228 ``` Ausgabe: ``` { "tasks": [ { "taskId": "a3aea009955e501a31b764abe1bebd3d", "taskStatus": "COMPLETED", "taskType": "ON_DEMAND_AUDIT_TASK" }, { "taskId": "f76b4b5102b632cd9ae38a279c266da1", "taskStatus": "COMPLETED", "taskType": "SCHEDULED_AUDIT_TASK" }, { "taskId": "51d9967d9f9ff4d26529505f6d2c444a", "taskStatus": "COMPLETED", "taskType": "SCHEDULED_AUDIT_TASK" }, { "taskId": "eeef61068b0eb03c456d746c5a26ee04", "taskStatus": "COMPLETED", "taskType": "SCHEDULED_AUDIT_TASK" }, { "taskId": "041c49557b7c7b04c079a49514b55589", "taskStatus": "COMPLETED", "taskType": "SCHEDULED_AUDIT_TASK" }, { "taskId": "82c7f2afac1562d18a4560be73998acc", "taskStatus": "COMPLETED", "taskType": "SCHEDULED_AUDIT_TASK" }, { "taskId": "bade6b5efd2e1b1569822f6021b39cf5", "taskStatus": "COMPLETED", "taskType": "SCHEDULED_AUDIT_TASK" }, { "taskId": "c23f6233ba2d35879c4bb2810fb5ffd6", "taskStatus": "COMPLETED", "taskType": "SCHEDULED_AUDIT_TASK" }, { "taskId": "ac9086b7222a2f5e2e17bb6fd30b3aeb", "taskStatus": "COMPLETED", "taskType": "SCHEDULED_AUDIT_TASK" } ] } ``` Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListAuditTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `list-authorizers` Das folgende Codebeispiel zeigt die Verwendung`list-authorizers`. **AWS CLI** **So listen Sie Ihren benutzerdefinierten Genehmiger auf** Das folgende `list-authorizers` Beispiel listet die benutzerdefinierten Autorisierer in Ihrem AWS Konto auf. ``` aws iot list-authorizers ``` Ausgabe: ``` { "authorizers": [ { "authorizerName": "CustomAuthorizer", "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer" }, { "authorizerName": "CustomAuthorizer2", "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2" }, { "authorizerName": "CustomAuthorizer3", "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer3" } ] } ``` Weitere Informationen finden Sie [ListAuthorizers](https://docs.aws.amazon.com/iot/latest/apireference/API_ListAuthorizers.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListAuthorizers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-authorizers.html)unter *AWS CLI Befehlsreferenz*. ### `list-billing-groups` Das folgende Codebeispiel zeigt die Verwendung`list-billing-groups`. **AWS CLI** **Um die Abrechnungsgruppen für Ihr AWS Konto und Ihre Region aufzulisten** Im folgenden `list-billing-groups` Beispiel werden alle Abrechnungsgruppen aufgeführt, die für Ihr AWS Konto und Ihre AWS Region definiert sind. ``` aws iot list-billing-groups ``` Ausgabe: ``` { "billingGroups": [ { "groupName": "GroupOne", "groupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne" } ] } ``` Weitere Informationen finden Sie unter [Abrechnungsgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListBillingGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-billing-groups.html)unter *AWS CLI Befehlsreferenz*. ### `list-ca-certificates` Das folgende Codebeispiel zeigt die Verwendung`list-ca-certificates`. **AWS CLI** **Um die in Ihrem AWS Konto registrierten CA-Zertifikate aufzulisten** Das folgende `list-ca-certificates` Beispiel listet die CA-Zertifikate auf, die in Ihrem AWS Konto registriert sind. ``` aws iot list-ca-certificates ``` Ausgabe: ``` { "certificates": [ { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467", "certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467", "status": "INACTIVE", "creationDate": 1569365372.053 } ] } ``` Weitere Informationen finden Sie unter [Verwenden eines eigenen Zertifikats](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-your-own.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListCaCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-ca-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `list-certificates-by-ca` Das folgende Codebeispiel zeigt die Verwendung`list-certificates-by-ca`. **AWS CLI** **So listen Sie alle Gerätezertifikate auf, die mit einem CA-Zertifikat signiert sind** Das folgende `list-certificates-by-ca` Beispiel listet alle Gerätezertifikate in Ihrem AWS Konto auf, die mit dem angegebenen CA-Zertifikat signiert sind. ``` aws iot list-certificates-by-ca \ --ca-certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467 ``` Ausgabe: ``` { "certificates": [ { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142", "certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142", "status": "ACTIVE", "creationDate": 1569363250.557 } ] } ``` Weitere Informationen finden Sie unter [ListCertificatesByCA](https://docs.aws.amazon.com/iot/latest/apireference/API_ListCertificatesByCA.html) in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListCertificatesByCa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-certificates-by-ca.html)in der *AWS CLI Befehlsreferenz*. ### `list-certificates` Das folgende Codebeispiel zeigt die Verwendung`list-certificates`. **AWS CLI** **Beispiel 1: Um die in Ihrem AWS Konto registrierten Zertifikate aufzulisten** Im folgenden Beispiel für `list-certificates` werden alle Zertifikate aufgelistet, die in Ihrem Konto registriert sind. Wenn die Anzahl das standardmäßige Paging-Limit von 25 überschreitet, können Sie den Antwortwert `nextMarker` aus diesem Befehl an den nächsten Befehl übergeben, um den nächsten Ergebnisstapel zu erhalten. Wiederholen Sie den Vorgang, bis `nextMarker` keinen Wert mehr zurückgibt. ``` aws iot list-certificates ``` Ausgabe: ``` { "certificates": [ { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36", "certificateId": "604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36", "status": "ACTIVE", "creationDate": 1556810537.617 }, { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/262a1ac8a7d8aa72f6e96e365480f7313aa9db74b8339ec65d34dc3074e1c31e", "certificateId": "262a1ac8a7d8aa72f6e96e365480f7313aa9db74b8339ec65d34dc3074e1c31e", "status": "ACTIVE", "creationDate": 1546447050.885 }, { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b", "certificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b", "status": "ACTIVE", "creationDate": 1546292258.322 }, { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/7aebeea3845d14a44ec80b06b8b78a89f3f8a706974b8b34d18f5adf0741db42", "certificateId": "7aebeea3845d14a44ec80b06b8b78a89f3f8a706974b8b34d18f5adf0741db42", "status": "ACTIVE", "creationDate": 1541457693.453 }, { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/54458aa39ebb3eb39c91ffbbdcc3a6ca1c7c094d1644b889f735a6fc2cd9a7e3", "certificateId": "54458aa39ebb3eb39c91ffbbdcc3a6ca1c7c094d1644b889f735a6fc2cd9a7e3", "status": "ACTIVE", "creationDate": 1541113568.611 }, { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e", "certificateId": "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e", "status": "ACTIVE", "creationDate": 1541022751.983 } ] } ``` + Einzelheiten zur API finden Sie [ListCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `list-custom-metrics` Das folgende Codebeispiel zeigt die Verwendung`list-custom-metrics`. **AWS CLI** **So listen Sie Ihre benutzerdefinierten Messwerte auf** Im folgenden Beispiel für `list-custom-metrics` werden all Ihre benutzerdefinierten Metriken aufgelistet. ``` aws iot list-custom-metrics \ --region us-east-1 ``` Ausgabe: ``` { "metricNames": [ "batteryPercentage" ] } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Metriken](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [ListCustomMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-custom-metrics.html)in der *AWS CLI Befehlsreferenz*. ### `list-dimensions` Das folgende Codebeispiel zeigt die Verwendung`list-dimensions`. **AWS CLI** **Um die Dimensionen für Ihr AWS Konto aufzulisten** Das folgende `list-dimensions` Beispiel listet alle AWS IoT Device Defender-Dimensionen auf, die in Ihrem AWS Konto definiert sind. ``` aws iot list-dimensions ``` Ausgabe: ``` { "dimensionNames": [ "TopicFilterForAuthMessages", "TopicFilterForActivityMessages" ] } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListDimensions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-dimensions.html)in der *AWS CLI Befehlsreferenz*. ### `list-domain-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-domain-configurations`. **AWS CLI** **So listen Sie Domainkonfigurationen auf** Im folgenden `list-domain-configurations` Beispiel werden die Domänenkonfigurationen in Ihrem AWS Konto aufgeführt, die den angegebenen Diensttyp haben. ``` aws iot list-domain-configurations \ --service-type "DATA" ``` Ausgabe: ``` { "domainConfigurations": [ { "domainConfigurationName": "additionalDataDomain", "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh", "serviceType": "DATA" }, { "domainConfigurationName": "iot:Jobs", "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/iot:Jobs", "serviceType": "JOBS" }, { "domainConfigurationName": "iot:Data-ATS", "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/iot:Data-ATS", "serviceType": "DATA" }, { "domainConfigurationName": "iot:CredentialProvider", "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/iot:CredentialProvider", "serviceType": "CREDENTIAL_PROVIDER" } ] } ``` Weitere Informationen finden Sie unter [Konfigurierbare Endpunkte](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListDomainConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-domain-configurations.html)unter *AWS CLI Befehlsreferenz*. ### `list-indices` Das folgende Codebeispiel zeigt die Verwendung`list-indices`. **AWS CLI** **So listen Sie die konfigurierten Suchindizes auf** Das folgende `list-indices` Beispiel listet alle konfigurierten Suchindizes in Ihrem AWS Konto auf. Wenn Sie die Indizierung von Objekten nicht aktiviert haben, haben Sie möglicherweise keine Indizes. ``` aws iot list-indices ``` Ausgabe: ``` { "indexNames": [ "AWS_Things" ] } ``` Weitere Informationen finden Sie unter [Verwalten der Objektindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListIndices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-indices.html)in der *AWS CLI Befehlsreferenz*. ### `list-job-executions-for-job` Das folgende Codebeispiel zeigt die Verwendung`list-job-executions-for-job`. **AWS CLI** **Um die Jobs in Ihrem AWS Konto aufzulisten** Das folgende `list-job-executions-for-job` Beispiel listet alle Jobausführungen für einen Job in Ihrem AWS Konto auf, angegeben durch die jobId. ``` aws iot list-job-executions-for-job \ --job-id my-ota-job ``` Ausgabe: ``` { "executionSummaries": [ { "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/my_thing", "jobExecutionSummary": { "status": "QUEUED", "queuedAt": "2022-03-07T15:58:42.195000-08:00", "lastUpdatedAt": "2022-03-07T15:58:42.195000-08:00", "executionNumber": 1, "retryAttempt": 0 } } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListJobExecutionsForJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-job-executions-for-job.html)in der *AWS CLI Befehlsreferenz*. ### `list-job-executions-for-thing` Das folgende Codebeispiel zeigt die Verwendung`list-job-executions-for-thing`. **AWS CLI** **So listen Sie die Aufträge auf, die für ein Objekt ausgeführt wurden** Im folgenden Beispiel für `list-job-executions-for-thing` werden alle Aufträge aufgelistet, die für das Objekt mit dem Namen `MyRaspberryPi` ausgeführt wurden. ``` aws iot list-job-executions-for-thing \ --thing-name "MyRaspberryPi" ``` Ausgabe: ``` { "executionSummaries": [ { "jobId": "example-job-01", "jobExecutionSummary": { "status": "QUEUED", "queuedAt": 1560787023.636, "lastUpdatedAt": 1560787023.636, "executionNumber": 1 } } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListJobExecutionsForThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-job-executions-for-thing.html)in der *AWS CLI Befehlsreferenz*. ### `list-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-jobs`. **AWS CLI** **Um die Jobs in Ihrem AWS Konto aufzulisten** Im folgenden `list-jobs` Beispiel werden alle Jobs in Ihrem AWS Konto aufgelistet, sortiert nach dem Jobstatus. ``` aws iot list-jobs ``` Ausgabe: ``` { "jobs": [ { "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01", "jobId": "example-job-01", "targetSelection": "SNAPSHOT", "status": "IN_PROGRESS", "createdAt": 1560787022.733, "lastUpdatedAt": 1560787026.294 } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-mitigation-actions` Das folgende Codebeispiel zeigt die Verwendung`list-mitigation-actions`. **AWS CLI** **So listen Sie alle definierten Abhilfemaßnahmen auf** Das folgende `list-mitigation-actions` Beispiel listet alle definierten Minderungsmaßnahmen für Ihr AWS Konto und Ihre Region auf. Für jede Aktion werden der Name, der ARN und das Erstellungsdatum aufgelistet. ``` aws iot list-mitigation-actions ``` Ausgabe: ``` { "actionIdentifiers": [ { "actionName": "DeactivateCACertAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/DeactivateCACertAction", "creationDate": "2019-12-10T11:12:47.574000-08:00" }, { "actionName": "ResetPolicyVersionAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/ResetPolicyVersionAction", "creationDate": "2019-12-10T11:11:48.920000-08:00" }, { "actionName": "PublishFindingToSNSAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/PublishFindingToSNSAction", "creationDate": "2019-12-10T11:10:49.546000-08:00" }, { "actionName": "AddThingsToQuarantineGroupAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction", "creationDate": "2019-12-10T11:09:35.999000-08:00" }, { "actionName": "UpdateDeviceCertAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/UpdateDeviceCertAction", "creationDate": "2019-12-10T11:08:44.263000-08:00" }, { "actionName": "SampleMitigationAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/SampleMitigationAction", "creationDate": "2019-12-10T11:03:41.840000-08:00" } ] } ``` Weitere Informationen finden Sie unter [ListMitigationActions (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListMitigationActions) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [ListMitigationActions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-mitigation-actions.html)*Befehlsreferenz.* ### `list-mitigations-actions` Das folgende Codebeispiel zeigt die Verwendung`list-mitigations-actions`. **AWS CLI** **So listen Sie alle definierten Abhilfemaßnahmen auf** Das folgende `list-mitigations-actions` Beispiel listet alle definierten Minderungsmaßnahmen für Ihr AWS Konto und Ihre Region auf. Für jede Aktion werden der Name, der ARN und das Erstellungsdatum aufgelistet. ``` aws iot list-mitigation-actions ``` Ausgabe: ``` { "actionIdentifiers": [ { "actionName": "DeactivateCACertAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/DeactivateCACertAction", "creationDate": "2019-12-10T11:12:47.574000-08:00" }, { "actionName": "ResetPolicyVersionAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/ResetPolicyVersionAction", "creationDate": "2019-12-10T11:11:48.920000-08:00" }, { "actionName": "PublishFindingToSNSAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/PublishFindingToSNSAction", "creationDate": "2019-12-10T11:10:49.546000-08:00" }, { "actionName": "AddThingsToQuarantineGroupAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction", "creationDate": "2019-12-10T11:09:35.999000-08:00" }, { "actionName": "UpdateDeviceCertAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/UpdateDeviceCertAction", "creationDate": "2019-12-10T11:08:44.263000-08:00" }, { "actionName": "SampleMitigationAction", "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/SampleMitigationAction", "creationDate": "2019-12-10T11:03:41.840000-08:00" } ] } ``` Weitere Informationen finden Sie unter [ListMitigationActions (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListMitigationActions) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [ListMitigationsActions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-mitigations-actions.html)*Befehlsreferenz.* ### `list-ota-updates` Das folgende Codebeispiel zeigt die Verwendung`list-ota-updates`. **AWS CLI** **So listen Sie OTA-Updates für das Konto auf** Im folgenden Beispiel für `list-ota-updates` werden die verfügbaren OTA-Aktualisierungen aufgelistet. ``` aws iot list-ota-updates ``` Ausgabe: ``` { "otaUpdates": [ { "otaUpdateId": "itsaupdate", "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate", "creationDate": 1557863215.995 } ] } ``` Weitere Informationen finden Sie unter [Liste OTAUpdates](https://docs.aws.amazon.com/iot/latest/apireference/API_ListOTAUpdates.html) in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListOtaUpdates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-ota-updates.html)unter *AWS CLI Befehlsreferenz*. ### `list-outgoing-certificates` Das folgende Codebeispiel zeigt die Verwendung`list-outgoing-certificates`. **AWS CLI** **Um Zertifikate aufzulisten, die auf ein anderes AWS Konto übertragen werden** Das folgende `list-outgoing-certificates` Beispiel listet alle Gerätezertifikate auf, die gerade mithilfe des `transfer-certificate` Befehls auf ein anderes AWS Konto übertragen werden. ``` aws iot list-outgoing-certificates ``` Ausgabe: ``` { "outgoingCertificates": [ { "certificateArn": "arn:aws:iot:us-west-2:030714055129:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142", "certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142", "transferredTo": "030714055129", "transferDate": 1569427780.441, "creationDate": 1569363250.557 } ] } ``` Weitere Informationen finden Sie [ListOutgoingCertificates](https://docs.aws.amazon.com/iot/latest/apireference/API_ListOutgoingCertificates.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListOutgoingCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-outgoing-certificates.html)unter *AWS CLI Befehlsreferenz*. ### `list-policies` Das folgende Codebeispiel zeigt die Verwendung`list-policies`. **AWS CLI** **Um die in Ihrem AWS Konto definierten Richtlinien aufzulisten** Das folgende `list-policies` Beispiel listet alle in Ihrem AWS Konto definierten Richtlinien auf. ``` aws iot list-policies ``` Ausgabe: ``` { "policies": [ { "policyName": "UpdateDeviceCertPolicy", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy" }, { "policyName": "PlantIoTPolicy", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/PlantIoTPolicy" }, { "policyName": "MyPiGroup_Core-policy", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/MyPiGroup_Core-policy" } ] } ``` Weitere Informationen finden Sie unter [AWS -IoT-Richtlinien](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-policies.html)in der *AWS CLI Befehlsreferenz*. ### `list-policy-versions` Das folgende Codebeispiel zeigt die Verwendung`list-policy-versions`. **AWS CLI** **Beispiel 1: So zeigen Sie alle Versionen einer Richtlinie an** Im folgenden Beispiel für `list-policy-versions` werden alle Versionen der angegebenen Richtlinie und ihre Erstellungsdaten aufgelistet. ``` aws iot list-policy-versions \ --policy-name LightBulbPolicy ``` Ausgabe: ``` { "policyVersions": [ { "versionId": "2", "isDefaultVersion": true, "createDate": 1559925941.924 }, { "versionId": "1", "isDefaultVersion": false, "createDate": 1559925941.924 } ] } ``` Weitere Informationen finden Sie unter [AWS -IoT-Richtlinien](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListPolicyVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-policy-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-principal-things` Das folgende Codebeispiel zeigt die Verwendung`list-principal-things`. **AWS CLI** **So listen Sie die Objekte auf, die an einen Prinzipal angehängt sind** Im folgenden Beispiel für `list-principal-things` werden die Objekte aufgelistet, die an den Prinzipal angehängt sind, der durch einen ARN angegeben ist. ``` aws iot list-principal-things \ --principal arn:aws:iot:us-west-2:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8 ``` Ausgabe: ``` { "things": [ "DeskLamp", "TableLamp" ] } ``` Weitere Informationen finden Sie [ListPrincipalThings](https://docs.aws.amazon.com/iot/latest/apireference/API_ListPrincipleThings.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListPrincipalThings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-things.html)unter *AWS CLI Befehlsreferenz*. ### `list-provisioning-template-versions` Das folgende Codebeispiel zeigt die Verwendung`list-provisioning-template-versions`. **AWS CLI** **So listen Sie Versionen von Bereitstellungsvorlagen auf** Im folgenden Beispiel für `list-provisioning-template-versions` werden die verfügbaren Versionen der angegebenen Bereitstellungsvorlage aufgelistet. ``` aws iot list-provisioning-template-versions \ --template-name "widget-template" ``` Ausgabe: ``` { "versions": [ { "versionId": 1, "creationDate": 1574800471.339, "isDefaultVersion": true }, { "versionId": 2, "creationDate": 1574801192.317, "isDefaultVersion": false } ] } ``` Weitere Informationen finden Sie unter [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [ListProvisioningTemplateVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-provisioning-template-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-provisioning-templates` Das folgende Codebeispiel zeigt die Verwendung`list-provisioning-templates`. **AWS CLI** **So listen Sie Bereitstellungsvorlagen auf** Im folgenden `list-provisioning-templates` Beispiel werden alle Bereitstellungsvorlagen in Ihrem AWS Konto aufgeführt. ``` aws iot list-provisioning-templates ``` Ausgabe: ``` { "templates": [ { "templateArn": "arn:aws:iot:us-east-1:123456789012:provisioningtemplate/widget-template", "templateName": "widget-template", "description": "A provisioning template for widgets", "creationDate": 1574800471.367, "lastModifiedDate": 1574801192.324, "enabled": false } ] } ``` Weitere Informationen finden Sie unter [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [ListProvisioningTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-provisioning-templates.html)in der *AWS CLI Befehlsreferenz.* ### `list-role-aliases` Das folgende Codebeispiel zeigt die Verwendung`list-role-aliases`. **AWS CLI** **Um die AWS IoT-Rollenaliase in Ihrem AWS Konto aufzulisten** Das folgende `list-role-aliases` Beispiel listet die AWS IoT-Rollenaliase in Ihrem AWS Konto auf. ``` aws iot list-role-aliases ``` Ausgabe: ``` { "roleAliases": [ "ResidentAlias", "ElectricianAlias" ] } ``` Weitere Informationen finden Sie [ListRoleAliases](https://docs.aws.amazon.com/iot/latest/apireference/API_ListRoleAliases.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListRoleAliases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-role-aliases.html)unter *AWS CLI Befehlsreferenz*. ### `list-scheduled-audits` Das folgende Codebeispiel zeigt die Verwendung`list-scheduled-audits`. **AWS CLI** **Um die geplanten Audits für Ihr AWS Konto aufzulisten** Das folgende `list-scheduled-audits` Beispiel listet alle für Ihr AWS Konto geplanten Audits auf. ``` aws iot list-scheduled-audits ``` Ausgabe: ``` { "scheduledAudits": [ { "scheduledAuditName": "AWSIoTDeviceDefenderDailyAudit", "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/AWSIoTDeviceDefenderDailyAudit", "frequency": "DAILY" }, { "scheduledAuditName": "AWSDeviceDefenderWeeklyAudit", "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/AWSDeviceDefenderWeeklyAudit", "frequency": "WEEKLY", "dayOfWeek": "SUN" } ] } ``` Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListScheduledAudits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-scheduled-audits.html)in der *AWS CLI Befehlsreferenz*. ### `list-security-profiles-for-target` Das folgende Codebeispiel zeigt die Verwendung`list-security-profiles-for-target`. **AWS CLI** **So listen Sie die Sicherheitsprofile auf, die an ein Ziel angehängt sind** Das folgende `list-security-profiles-for-target` Beispiel listet die AWS IoT Device Defender-Sicherheitsprofile auf, die an nicht registrierte Geräte angehängt sind. ``` aws iot list-security-profiles-for-target \ --security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/unregistered-things" ``` Ausgabe: ``` { "securityProfileTargetMappings": [ { "securityProfileIdentifier": { "name": "Testprofile", "arn": "arn:aws:iot:us-west-2:123456789012:securityprofile/Testprofile" }, "target": { "arn": "arn:aws:iot:us-west-2:123456789012:all/unregistered-things" } } ] } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie unter [ListSecurityProfilesForTarget AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-security-profiles-for-target.html)*Befehlsreferenz.* ### `list-security-profiles` Das folgende Codebeispiel zeigt die Verwendung`list-security-profiles`. **AWS CLI** **Um die Sicherheitsprofile für Ihr AWS Konto aufzulisten** Das folgende `list-security-profiles` Beispiel listet alle AWS IoT Device Defender-Sicherheitsprofile auf, die in Ihrem AWS Konto definiert sind. ``` aws iot list-security-profiles ``` Ausgabe: ``` { "securityProfileIdentifiers": [ { "name": "Testprofile", "arn": "arn:aws:iot:us-west-2:123456789012:securityprofile/Testprofile" } ] } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListSecurityProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-security-profiles.html)in der *AWS CLI Befehlsreferenz*. ### `list-streams` Das folgende Codebeispiel zeigt die Verwendung`list-streams`. **AWS CLI** **So listen Sie die Streams im Konto auf** Das folgende `list-streams` Beispiel listet alle Streams in Ihrem AWS Konto auf. ``` aws iot list-streams ``` Ausgabe: ``` { "streams": [ { "streamId": "stream12345", "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345", "streamVersion": 1, "description": "This stream is used for Amazon FreeRTOS OTA Update 12345." }, { "streamId": "stream54321", "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream54321", "streamVersion": 1, "description": "This stream is used for Amazon FreeRTOS OTA Update 54321." } ] } ``` Weitere Informationen finden Sie [ListStreams](https://docs.aws.amazon.com/iot/latest/apireference/API_ListStreams.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-streams.html)unter *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So zeigen Sie die Tags und deren Werte an, die mit einer Ressource verknüpft sind** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags und Werte angezeigt, die der Objektgruppe `LightBulbs` zugeordnet sind. ``` aws iot list-tags-for-resource \ --resource-arn "arn:aws:iot:us-west-2:094249569039:thinggroup/LightBulbs" ``` Ausgabe: ``` { "tags": [ { "Key": "Assembly", "Value": "Fact1NW" }, { "Key": "MyTag", "Value": "777" } ] } ``` Weitere Informationen finden Sie unter [Tagging Your AWS IoT Resources](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `list-targets-for-policy` Das folgende Codebeispiel zeigt die Verwendung`list-targets-for-policy`. **AWS CLI** **Um die mit einer AWS IoT-Richtlinie verknüpften Prinzipale aufzulisten** Im folgenden Beispiel für `list-targets-for-policy` werden die Gerätezertifikate aufgelistet, an die die angegebene Richtlinie angehängt ist. ``` aws iot list-targets-for-policy \ --policy-name UpdateDeviceCertPolicy ``` Ausgabe: ``` { "targets": [ "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142", "arn:aws:iot:us-west-2:123456789012:cert/d1eb269fb55a628552143c8f96eb3c258fcd5331ea113e766ba0c82bf225f0be" ] } ``` Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListTargetsForPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-targets-for-policy.html)in der *AWS CLI Befehlsreferenz.* ### `list-targets-for-security-profile` Das folgende Codebeispiel zeigt die Verwendung`list-targets-for-security-profile`. **AWS CLI** **So listen Sie die Ziele auf, auf die ein Sicherheitsprofil angewendet wird** Das folgende `list-targets-for-security-profile` Beispiel listet die Ziele auf, auf die das angegebene AWS IoT Device Defender-Sicherheitsprofil angewendet `PossibleIssue` wird. ``` aws iot list-targets-for-security-profile \ --security-profile-name Testprofile ``` Ausgabe: ``` { "securityProfileTargets": [ { "arn": "arn:aws:iot:us-west-2:123456789012:all/unregistered-things" }, { "arn": "arn:aws:iot:us-west-2:123456789012:all/registered-things" } ] } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListTargetsForSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-targets-for-security-profile.html)unter *AWS CLI Befehlsreferenz*. ### `list-thing-groups-for-thing` Das folgende Codebeispiel zeigt die Verwendung`list-thing-groups-for-thing`. **AWS CLI** **So listen Sie die Gruppen auf, zu denen ein Objekt gehört** Im folgenden Beispiel für `list-thing-groups-for-thing` werden die Gruppen aufgelistet, zu denen das angegebene Objekt gehört. ``` aws iot list-thing-groups-for-thing \ --thing-name MyLightBulb ``` Ausgabe: ``` { "thingGroups": [ { "groupName": "DeadBulbs", "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/DeadBulbs" }, { "groupName": "LightBulbs", "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" } ] } ``` Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListThingGroupsForThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-groups-for-thing.html)in der *AWS CLI Befehlsreferenz*. ### `list-thing-groups` Das folgende Codebeispiel zeigt die Verwendung`list-thing-groups`. **AWS CLI** **Um die in Ihrem AWS Konto definierten Dinggruppen aufzulisten** Das folgende `describe-thing-group` Beispiel listet alle in Ihrem AWS Konto definierten Dinggruppen auf. ``` aws iot list-thing-groups ``` Ausgabe: ``` { "thingGroups": [ { "groupName": "HalogenBulbs", "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/HalogenBulbs" }, { "groupName": "LightBulbs", "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" } ] } ``` Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListThingGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-groups.html)in der *AWS CLI Befehlsreferenz*. ### `list-thing-principals` Das folgende Codebeispiel zeigt die Verwendung`list-thing-principals`. **AWS CLI** **So listen Sie die mit einem Objekt verbundenen Prinzipale auf** Im folgenden Beispiel für `list-thing-principals` werden die Prinzipale (X.509-Zertifikate, IAM-Benutzer, Gruppen, Rollen, Amazon-Cognito-Identitäten oder -Verbundidentitäten) aufgelistet, die dem angegebenen Objekt zugeordnet sind. ``` aws iot list-thing-principals \ --thing-name MyRaspberryPi ``` Ausgabe: ``` { "principals": [ "arn:aws:iot:us-west-2:123456789012:cert/33475ac865079a5ffd5ecd44240640349293facc760642d7d8d5dbb6b4c86893" ] } ``` Weitere Informationen finden Sie [ListThingPrincipals](https://docs.aws.amazon.com/iot/latest/apireference/API_ListThingPrincipals.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListThingPrincipals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principals.html)unter *AWS CLI Befehlsreferenz*. ### `list-thing-types` Das folgende Codebeispiel zeigt die Verwendung`list-thing-types`. **AWS CLI** **So listen Sie die definierten Objekttypen auf** Im folgenden `list-thing-types` Beispiel wird eine Liste der in Ihrem AWS Konto definierten Objekttypen angezeigt. ``` aws iot list-thing-types ``` Ausgabe: ``` { "thingTypes": [ { "thingTypeName": "LightBulb", "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb", "thingTypeProperties": { "thingTypeDescription": "light bulb type", "searchableAttributes": [ "model", "wattage" ] }, "thingTypeMetadata": { "deprecated": false, "creationDate": 1559772562.498 } } ] } ``` Weitere Informationen finden Sie unter [Objekttypen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListThingTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-types.html)in der *AWS CLI Befehlsreferenz*. ### `list-things-in-billing-group` Das folgende Codebeispiel zeigt die Verwendung`list-things-in-billing-group`. **AWS CLI** **So listen Sie die Objekte in einer Abrechnungsgruppe auf** Im folgenden Beispiel für `list-things-in-billing-group` werden die Objekte aufgelistet, die sich in der angegebenen Abrechnungsgruppe befinden. ``` aws iot list-things-in-billing-group \ --billing-group-name GroupOne ``` Ausgabe: ``` { "things": [ "MyOtherLightBulb", "MyLightBulb" ] } ``` Weitere Informationen finden Sie unter [Abrechnungsgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListThingsInBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things-in-billing-group.html)in der *AWS CLI Befehlsreferenz*. ### `list-things-in-thing-group` Das folgende Codebeispiel zeigt die Verwendung`list-things-in-thing-group`. **AWS CLI** **So listen Sie die Objekte auf, die zu einer Gruppe gehören** Im folgenden Beispiel für `list-things-in-thing-group` werden die Objekte aufgelistet, die zur angegebenen Objektgruppe gehören. ``` aws iot list-things-in-thing-group \ --thing-group-name LightBulbs ``` Ausgabe: ``` { "things": [ "MyLightBulb" ] } ``` Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListThingsInThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things-in-thing-group.html)in der *AWS CLI Befehlsreferenz*. ### `list-things` Das folgende Codebeispiel zeigt die Verwendung`list-things`. **AWS CLI** **Beispiel 1: So listen Sie alle Objekte in der Registrierung auf** Das folgende `list-things` Beispiel listet die Dinge (Geräte) auf, die in der AWS IoT-Registrierung für Ihr AWS Konto definiert sind. ``` aws iot list-things ``` Ausgabe: ``` { "things": [ { "thingName": "ThirdBulb", "thingTypeName": "LightBulb", "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/ThirdBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 2 }, { "thingName": "MyOtherLightBulb", "thingTypeName": "LightBulb", "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 3 }, { "thingName": "MyLightBulb", "thingTypeName": "LightBulb", "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1 }, { "thingName": "SampleIoTThing", "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/SampleIoTThing", "attributes": {}, "version": 1 } ] } ``` **Beispiel 2: So listen Sie die definierten Objekte auf, die ein bestimmtes Attribut haben** Im folgenden Beispiel für `list-things` wird eine Liste von Objekten angezeigt, die ein Attribut mit dem Namen `wattage` haben. ``` aws iot list-things \ --attribute-name wattage ``` Ausgabe: ``` { "things": [ { "thingName": "MyLightBulb", "thingTypeName": "LightBulb", "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1 }, { "thingName": "MyOtherLightBulb", "thingTypeName": "LightBulb", "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 3 } ] } ``` Weitere Informationen finden Sie unter [Objektverwaltung mit der Registry](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListThings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things.html)unter *AWS CLI Befehlsreferenz*. ### `list-topic-rule-destinations` Das folgende Codebeispiel zeigt die Verwendung`list-topic-rule-destinations`. **AWS CLI** **So listen Sie die Ziele Ihrer Themenregeln auf** Im folgenden `list-topic-rule-destinations` Beispiel werden alle Ziele für Themenregeln aufgeführt, die Sie in der aktuellen AWS Region definiert haben. ``` aws iot list-topic-rule-destinations ``` Ausgabe: ``` { "destinationSummaries": [ { "arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "status": "ENABLED", "httpUrlSummary": { "confirmationUrl": "https://example.com" } } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Themenregelzielen](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListTopicRuleDestinations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-topic-rule-destinations.html)unter *AWS CLI Befehlsreferenz*. ### `list-topic-rules` Das folgende Codebeispiel zeigt die Verwendung`list-topic-rules`. **AWS CLI** **So listen Sie Ihre Regeln auf** Im folgenden Beispiel für `list-topic-rules` werden alle Regeln aufgelistet, die Sie definiert haben. ``` aws iot list-topic-rules ``` Ausgabe: ``` { "rules": [ { "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyRPiLowMoistureAlertRule", "ruleName": "MyRPiLowMoistureAlertRule", "topicPattern": "$aws/things/MyRPi/shadow/update/accepted", "createdAt": 1558624363.0, "ruleDisabled": false }, { "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyPlantPiMoistureAlertRule", "ruleName": "MyPlantPiMoistureAlertRule", "topicPattern": "$aws/things/MyPlantPi/shadow/update/accepted", "createdAt": 1541458459.0, "ruleDisabled": false } ] } ``` Weitere Informationen finden Sie unter [Anzeigen Ihrer Regeln](https://docs.aws.amazon.com/iot/latest/developerguide/iot-managae-rule.html#iot-view-rules) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListTopicRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-topic-rules.html)in der *AWS CLI Befehlsreferenz*. ### `list-v2-logging-levels` Das folgende Codebeispiel zeigt die Verwendung`list-v2-logging-levels`. **AWS CLI** **So listen Sie die Protokollierungsebenen auf** Im folgenden Beispiel für `list-v2-logging-levels` werden die konfigurierten Protokollierungsebenen aufgelistet. Wenn keine Protokollierungsebenen festgelegt wurden, tritt eine `NotConfiguredException` auf, wenn Sie diesen Befehl ausführen. ``` aws iot list-v2-logging-levels ``` Ausgabe: ``` { "logTargetConfigurations": [ { "logTarget": { "targetType": "DEFAULT" }, "logLevel": "ERROR" } ] } ``` + API-Details finden Sie unter [ListV2 LoggingLevels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-v2-logging-levels.html) in der *AWS CLI Befehlsreferenz.* ### `list-violation-events` Das folgende Codebeispiel zeigt die Verwendung`list-violation-events`. **AWS CLI** **So listen Sie die Verstöße gegen das Sicherheitsprofil während eines bestimmten Zeitraums auf** Das folgende `list-violation-events` Beispiel listet Verstöße auf, die zwischen dem 5. Juni 2019 und dem 12. Juni 2019 für alle AWS IoT Device Defender-Sicherheitsprofile für das aktuelle AWS Konto und die AWS Region aufgetreten sind. ``` aws iot list-violation-events \ --start-time 1559747125 \ --end-time 1560351925 ``` Ausgabe: ``` { "violationEvents": [ { "violationId": "174db59167fa474c80a652ad1583fd44", "thingName": "iotconsole-1560269126751-1", "securityProfileName": "Testprofile", "behavior": { "name": "Authorization", "metric": "aws:num-authorization-failures", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 10 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, "metricValue": { "count": 0 }, "violationEventType": "in-alarm", "violationEventTime": 1560279000.0 }, { "violationId": "c8a9466a093d3b7b35cd44ca58bdbeab", "thingName": "TvnQoEoU", "securityProfileName": "Testprofile", "behavior": { "name": "CellularBandwidth", "metric": "aws:message-byte-size", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 128 }, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, "metricValue": { "count": 110 }, "violationEventType": "in-alarm", "violationEventTime": 1560276600.0 }, { "violationId": "74aa393adea02e6648f3ac362beed55e", "thingName": "iotconsole-1560269232412-2", "securityProfileName": "Testprofile", "behavior": { "name": "Authorization", "metric": "aws:num-authorization-failures", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 10 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, "metricValue": { "count": 0 }, "violationEventType": "in-alarm", "violationEventTime": 1560276600.0 }, { "violationId": "1e6ab5f7cf39a1466fcd154e1377e406", "thingName": "TvnQoEoU", "securityProfileName": "Testprofile", "behavior": { "name": "Authorization", "metric": "aws:num-authorization-failures", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 10 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, "metricValue": { "count": 0 }, "violationEventType": "in-alarm", "violationEventTime": 1560276600.0 } ] } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [ListViolationEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-violation-events.html)in der *AWS CLI Befehlsreferenz*. ### `register-ca-certificate` Das folgende Codebeispiel zeigt die Verwendung`register-ca-certificate`. **AWS CLI** **So registrieren Sie ein Zertifikat einer Zertifizierungsstelle (CA** Im folgenden Beispiel für `register-ca-certificate` wird ein CA-Zertifikat registriert. Der Befehl stellt das CA-Zertifikat und ein Schlüsselverifizierungszertifikat bereit, das beweist, dass der private Schlüssel, der dem CA-Zertifikat zugeordnet ist, Ihnen gehört. ``` aws iot register-ca-certificate \ --ca-certificate file://rootCA.pem \ --verification-cert file://verificationCert.pem ``` Ausgabe: ``` { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467", "certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467" } ``` Weitere Informationen finden Sie unter [Registrieren CACertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_RegisterCACertificate.html) in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [RegisterCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/register-ca-certificate.html)unter *AWS CLI Befehlsreferenz*. ### `register-certificate` Das folgende Codebeispiel zeigt die Verwendung`register-certificate`. **AWS CLI** **So registrieren Sie ein selbstsigniertes Gerätezertifikat** Im folgenden Beispiel für `register-certificate` wird das mit dem `rootCA.pem`-CA-Zertifikat signierte Gerätezertifikat `deviceCert.pem` registriert. Das CA-Zertifikat muss registriert werden, bevor Sie es zur Registrierung eines selbstsignierten Gerätezertifikats verwenden. Das selbstsignierte Zertifikat muss mit demselben CA-Zertifikat signiert sein, das Sie an diesen Befehl übergeben. ``` aws iot register-certificate \ --certificate-pem file://deviceCert.pem \ --ca-certificate-pem file://rootCA.pem ``` Ausgabe: ``` { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142", "certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142" } ``` Weitere Informationen finden Sie [RegisterCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_RegisterCertificate.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [RegisterCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/register-certificate.html)unter *AWS CLI Befehlsreferenz*. ### `register-thing` Das folgende Codebeispiel zeigt die Verwendung`register-thing`. **AWS CLI** **So registrieren Sie ein Objekt** Im folgenden Beispiel für `register-thing` wird ein Objekt mithilfe einer Bereitstellungsvorlage registriert. ``` aws iot register-thing \ --template-body '{"Parameters":{"ThingName":{"Type":"String"},"AWS::IoT::Certificate::Id":{"Type":"String"}},"Resources": {"certificate":{"Properties":{"CertificateId":{"Ref":"AWS::IoT::Certificate::Id"},"Status":"Active"},"Type":"AWS::IoT::Certificate"},"policy":{"Properties":{"PolicyName":"MyIotPolicy"},"Type":"AWS::IoT::Policy"},"thing":{"OverrideSettings":{"AttributePayload":"MERGE","ThingGroups":"DO_NOTHING","ThingTypeName":"REPLACE"},"Properties":{"AttributePayload":{},"ThingGroups":[],"ThingName":{"Ref":"ThingName"},"ThingTypeName":"VirtualThings"},"Type":"AWS::IoT::Thing"}}}' \ --parameters '{"ThingName":"Register-thing-trial-1","AWS::IoT::Certificate::Id":"799a9ea048a1e6aea42b55EXAMPLEf8697b4bafcd77a318a3068e30404b9233c"}' ``` Ausgabe: ``` { "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCCAkGgAwIBAgIUYLk81I35cIppobpw HiOJ2jNjboIwDQYJKoZIhvcNAQEL\nBQAwTTFLMEkGA1UECwxCQW1hem9uIFdlYiBTZXJ2aWNlcyBPPUFtYXpvbi 5jb20g\nSW5jLiBMPVNlYXR0bGUgU1Q9V2FzaGluZ3RvbiBDPVVTMB4XDTIwMDcyMzE2NDUw\nOVoXDTQ5MTIzMT IzNTk1OVowHjEcMBoGA1UEAwwTQVdTIElvVCBDZXJ0aWZpY2F0\nZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCC AQoCggEBAO71uADhdBajqTmgrMV5\nmCFfBZQRMo1MdtVoZr2X+M4MzL+RARrtUzH9a2SMAckeX8KeblIOTKzORI RDXnyE\n6lVOwjgAsd0ku22rFxex4eG2ikha7pYYkvuToqA7L3TxItRvfKrxRI4ZfJoFPip4\nKqiuBJVNOGKTcQ Hd1RNOrddwwu6kFJLeKDmEXAMPLEdUF0N+qfR9yKnZQkm+g6Q2\nGXu7u0W3hn6nlRN8qVoka0uW12p53xM7oHVz Gf+cxKBxlbOhGkp6yCfTSkUBm3Sp\n9zLw35kiHXVm4EVpwgNlnk6XcIGIkw8a/iy4pzmvuGAANY1/uU/zgCjymw ZT5S30\nBV0CAwEAAaNgMF4wHwYDVR0jBBgwFoAUGx0tCcU3q2n1WXAuUCv6hugXjKswHQYD\nVR0OBBYEFOVtvZ 9Aj2RYFnkX7Iu01XTRUdxgMAwGA1UdEwEB/wQCMAAwDgYDVR0P\nAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4IB AQCXCQcpOtubS5ftOsDMTcpP/jNX\nDHyArxmjpSc2aCdmm7WX59lTKWyAdxGAvqaDVWqTo0oXI7tZ8w7aINlGi5 pXnifx\n3SBebMUoBbTktrC97yUaeL025mCFv8emDnTR/fE7PTsBKjW0g/rrfpwBxZLXDFwN\nnqkQjy3EDfifj2 6j0xYIqqWMPogyn4srOCKynS5wMJuQZlHQOnabVwnwK4Y0Mflp\np9+4susFUR9aT3BT1AcIwqSpzhlKhh4Iz7ND kRn4amsUT210jg/zOO1Ow+BTHcVQ\nJly8XDu0CWSu04q6SnaBzHmlySIajxuRTP/AdfRouP1OXe+qlbPOBcvVvF 8o\n-----END CERTIFICATE-----\n", "resourceArns": { "certificate": "arn:aws:iot:us-west-2:571032923833:cert/799a9ea048a1e6aea42b55EXAMPLEf8697b4bafcd77a318a3068e30404b9233c", "thing": "arn:aws:iot:us-west-2:571032923833:thing/Register-thing-trial-1" } } ``` Weitere Informationen finden Sie unter [Bereitstellung durch vertrauenswürdigen Benutzer](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html#trusted-user) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [RegisterThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/register-thing.html)in der *AWS CLI Befehlsreferenz*. ### `reject-certificate-transfer` Das folgende Codebeispiel zeigt die Verwendung`reject-certificate-transfer`. **AWS CLI** **So lehnen Sie eine Zertifikatsübertragung ab** Im folgenden `reject-certificate-transfer` Beispiel wird die Übertragung des angegebenen Gerätezertifikats von einem anderen AWS Konto abgelehnt. ``` aws iot reject-certificate-transfer \ --certificate-id f0f33678c7c9a046e5cc87b2b1a58dfa0beec26db78addd5e605d630e05c7fc8 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Übertragen eines Zertifikats in ein anderes Konto](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie unter [RejectCertificateTransfer AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/reject-certificate-transfer.html)*Befehlsreferenz.* ### `remove-thing-from-billing-group` Das folgende Codebeispiel zeigt die Verwendung`remove-thing-from-billing-group`. **AWS CLI** **So entfernen Sie ein Objekt aus einer Abrechnungsgruppe** Im folgenden Beispiel für `remove-thing-from-billing-group` wird das angegebene Objekt aus einer Abrechnungsgruppe entfernt. ``` aws iot remove-thing-from-billing-group \ --billing-group-name GroupOne \ --thing-name MyOtherLightBulb ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Abrechnungsgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [RemoveThingFromBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/remove-thing-from-billing-group.html)in der *AWS CLI Befehlsreferenz*. ### `remove-thing-from-thing-group` Das folgende Codebeispiel zeigt die Verwendung`remove-thing-from-thing-group`. **AWS CLI** **So entfernen Sie ein Objekt aus einer Objektgruppe** Im folgenden Beispiel für `remove-thing-from-thing-group` wird das angegebene Objekt aus einer Objektgruppe entfernt. ``` aws iot remove-thing-from-thing-group \ --thing-name bulb7 \ --thing-group-name DeadBulbs ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter Thing Groups < https://docs.aws.amazon.com/iot/ latest/developerguide/thing -groups.html > im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie [RemoveThingFromThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/remove-thing-from-thing-group.html)in der *AWS CLI Befehlsreferenz*. ### `replace-topic-rule` Das folgende Codebeispiel zeigt die Verwendung`replace-topic-rule`. **AWS CLI** **So aktualisieren Sie die Regeldefinition eines Themas** Im folgenden Beispiel für `replace-topic-rule` wird die angegebene Regel so aktualisiert, dass eine SNS-Warnung gesendet wird, wenn die Werte für die Erdfeuchte zu niedrig sind. ``` aws iot replace-topic-rule \ --rule-name MyRPiLowMoistureAlertRule \ --topic-rule-payload "{\"sql\": \"SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\", \"description\": \"Sends an alert when soil moisture level readings are too low.\",\"actions\": [{\"sns\":{\"targetArn\":\"arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic\",\"roleArn\":\"arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole\",\"messageFormat\": \"RAW\"}}],\"ruleDisabled\": false,\"awsIotSqlVersion\":\"2016-03-23\"}" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen einer AWS IoT-Regel](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) im *AWS IoT-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [ReplaceTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/replace-topic-rule.html)unter *AWS CLI Befehlsreferenz*. ### `search-index` Das folgende Codebeispiel zeigt die Verwendung`search-index`. **AWS CLI** **So fragen Sie den Objektindex ab** Im folgenden Beispiel für `search-index` wird der `AWS_Things`-Index nach Objekten abgefragt, die den Typ `LightBulb` haben. ``` aws iot search-index \ --index-name "AWS_Things" \ --query-string "thingTypeName:LightBulb" ``` Ausgabe: ``` { "things": [ { "thingName": "MyLightBulb", "thingId": "40da2e73-c6af-406e-b415-15acae538797", "thingTypeName": "LightBulb", "thingGroupNames": [ "LightBulbs", "DeadBulbs" ], "attributes": { "model": "123", "wattage": "75" }, "connectivity": { "connected": false } }, { "thingName": "ThirdBulb", "thingId": "615c8455-33d5-40e8-95fd-3ee8b24490af", "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "connectivity": { "connected": false } }, { "thingName": "MyOtherLightBulb", "thingId": "6dae0d3f-40c1-476a-80c4-1ed24ba6aa11", "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "connectivity": { "connected": false } } ] } ``` Weitere Informationen finden Sie unter [Verwalten der Objektindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [SearchIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/search-index.html)in der *AWS CLI Befehlsreferenz*. ### `set-default-authorizer` Das folgende Codebeispiel zeigt die Verwendung`set-default-authorizer`. **AWS CLI** **So legen Sie den Standardgenehmiger fest** Im folgenden Beispiel für `set-default-authorizer` wird der benutzerdefinierte Genehmiger mit dem Namen `CustomAuthorizer` als Standardgenehmiger festgelegt. ``` aws iot set-default-authorizer \ --authorizer-name CustomAuthorizer ``` Ausgabe: ``` { "authorizerName": "CustomAuthorizer", "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer" } ``` Weitere Informationen finden Sie [CreateDefaultAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateDefaultAuthorizer.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [SetDefaultAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-default-authorizer.html)unter *AWS CLI Befehlsreferenz*. ### `set-default-policy-version` Das folgende Codebeispiel zeigt die Verwendung`set-default-policy-version`. **AWS CLI** **So legen Sie die Standardversion für eine Richtlinie fest** Im folgenden Beispiel für `set-default-policy-version` wird die Standardversion für die Richtlinie mit dem Namen `UpdateDeviceCertPolicy` auf `2` festgelegt. ``` aws iot set-default-policy-version \ --policy-name UpdateDeviceCertPolicy \ --policy-version-id 2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [SetDefaultPolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-default-policy-version.html)in der *AWS CLI Befehlsreferenz*. ### `set-v2-logging-level` Das folgende Codebeispiel zeigt die Verwendung`set-v2-logging-level`. **AWS CLI** **So legen Sie die Protokollierungsebene für eine Objektgruppe fest** Im folgenden Beispiel für `set-v2-logging-level` wird die Protokollierungsebene für die angegebene Objektgruppe so eingestellt, dass Warnungen protokolliert werden. ``` aws iot set-v2-logging-level \ --log-target "{\"targetType\":\"THING_GROUP\",\"targetName\":\"LightBulbs\"}" \ --log-level WARN ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + API-Details finden Sie unter [SetV2 LoggingLevel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-v2-logging-level.html) in der *AWS CLI Befehlsreferenz.* ### `set-v2-logging-options` Das folgende Codebeispiel zeigt die Verwendung`set-v2-logging-options`. **AWS CLI** **So richten Sie die Protokollierungsoptionen ein** Im folgenden Beispiel für `set-v2-logging-options` wird die standardmäßige Ausführlichkeitsstufe für die Protokollierung auf ERROR festgelegt und der ARN angegeben, der für die Protokollierung verwendet werden soll. ``` aws iot set-v2-logging-options \ --default-log-level ERROR \ --role-arn "arn:aws:iam::094249569039:role/service-role/iotLoggingRole" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + API-Details finden Sie unter [SetV2 LoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-v2-logging-options.html) in der *AWS CLI Befehlsreferenz.* ### `start-audit-mitigation-actions-task` Das folgende Codebeispiel zeigt die Verwendung`start-audit-mitigation-actions-task`. **AWS CLI** **So wenden Sie eine Abhilfemaßnahme auf die Erkenntnisse aus einem Audit an** Im folgenden Beispiel für `start-audit-mitigation-actions-task` wird die Aktion `ResetPolicyVersionAction` (zur Löschung der Richtlinie) auf die angegebene Einzelerkenntnis angewendet. ``` aws iot start-audit-mitigation-actions-task \ --task-id "myActionsTaskId" \ --target "findingIds=[\"0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464\"]" \ --audit-check-to-actions-mapping "IOT_POLICY_OVERLY_PERMISSIVE_CHECK=[\"ResetPolicyVersionAction\"]" \ --client-request-token "adhadhahda" ``` Ausgabe: ``` { "taskId": "myActionsTaskId" } ``` Weitere Informationen finden Sie unter [StartAuditMitigationActionsTask (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-StartAuditMitigationActionsTask) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [StartAuditMitigationActionsTask AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/start-audit-mitigation-actions-task.html)*Befehlsreferenz.* ### `start-on-demand-audit-task` Das folgende Codebeispiel zeigt die Verwendung`start-on-demand-audit-task`. **AWS CLI** **So starten Sie ein Audit sofort** Das folgende `start-on-demand-audit-task` Beispiel startet ein AWS IoT Device Defender Defender-Audit und führt drei Zertifikatsprüfungen durch. ``` aws iot start-on-demand-audit-task \ --target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK ``` Ausgabe: ``` { "taskId": "a3aea009955e501a31b764abe1bebd3d" } ``` Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [StartOnDemandAuditTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/start-on-demand-audit-task.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So geben Sie einen Tag-Schlüssel und -Wert für eine Ressource an** Im folgenden Beispiel für `tag-resource` wird das Tag mit einem Schlüssel `Assembly` und dem Wert `Fact1NW` auf die Objektgruppe `LightBulbs` angewendet. ``` aws iot tag-resource \ --tags Key=Assembly,Value="Fact1NW" \ --resource-arn "arn:aws:iot:us-west-2:094249569039:thinggroup/LightBulbs" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging Your AWS IoT Resources](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `test-authorization` Das folgende Codebeispiel zeigt die Verwendung`test-authorization`. **AWS CLI** **Um Ihre AWS IoT-Richtlinien zu testen** Im folgenden `test-authorization` Beispiel werden die AWS IoT-Richtlinien getestet, die dem angegebenen Prinzipal zugeordnet sind. ``` aws iot test-authorization \ --auth-infos actionType=CONNECT,resources=arn:aws:iot:us-east-1:123456789012:client/client1 \ --principal arn:aws:iot:us-west-2:123456789012:cert/aab1068f7f43ac3e3cae4b3a8aa3f308d2a750e6350507962e32c1eb465d9775 ``` Ausgabe: ``` { "authResults": [ { "authInfo": { "actionType": "CONNECT", "resources": [ "arn:aws:iot:us-east-1:123456789012:client/client1" ] }, "allowed": { "policies": [ { "policyName": "TestPolicyAllowed", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TestPolicyAllowed" } ] }, "denied": { "implicitDeny": { "policies": [ { "policyName": "TestPolicyDenied", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TestPolicyDenied" } ] }, "explicitDeny": { "policies": [ { "policyName": "TestPolicyExplicitDenied", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TestPolicyExplicitDenied" } ] } }, "authDecision": "IMPLICIT_DENY", "missingContextValues": [] } ] } ``` Weitere Informationen finden Sie [TestAuthorization](https://docs.aws.amazon.com/iot/latest/apireference/API_TestAuthorization.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [TestAuthorization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/test-authorization.html)unter *AWS CLI Befehlsreferenz*. ### `test-invoke-authorizer` Das folgende Codebeispiel zeigt die Verwendung`test-invoke-authorizer`. **AWS CLI** **So testen Sie Ihren benutzerdefinierten Genehmiger** Im folgenden Beispiel für `test-invoke-authorizer` wird Ihr benutzerdefinierter Genehmiger getestet. ``` aws iot test-invoke-authorizer \ --authorizer-name IoTAuthorizer \ --token allow \ --token-signature "mE0GvaHqy9nER/FdgtJX5lXYEJ3b3vE7t1gEszc0TKGgLKWXTnPkb2AbKnOAZ8lGyoN5dVtWDWVmr25m7++zjbYIMk2TBvyGXhOmvKFBPkdgyA43KL6SiZy0cTqlPMcQDsP7VX2rXr7CTowCxSNKphGXdQe0/I5dQ+JO6KUaHwCmupt0/MejKtaNwiia064j6wprOAUwG5S1IYFuRd0X+wfo8pb0DubAIX1Ua705kuhRUcTx4SxUShEYKmN4IDEvLB6FsIr0B2wvB7y4iPmcajxzGl02ExvyCUNctCV9dYlRRGJj0nsGzBIXOI4sGytPfqlA7obdgmN22pkDzYvwjQ==" ``` Ausgabe: ``` { "isAuthenticated": true, "principalId": "principalId", "policyDocuments": [ "{"Version":"2012-10-17", "Statement":[{"Action":"iot:Publish","Effect":"Allow","Resource":"arn:aws:iot:us-west-2:123456789012:topic/customauthtesting"}]}" ], "refreshAfterInSeconds": 600, "disconnectAfterInSeconds": 3600 } ``` Weitere Informationen finden Sie [TestInvokeAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_TestInvokeAuthorizers.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [TestInvokeAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/test-invoke-authorizer.html)unter *AWS CLI Befehlsreferenz*. ### `transfer-certificate` Das folgende Codebeispiel zeigt die Verwendung`transfer-certificate`. **AWS CLI** **Um ein Gerätezertifikat auf ein anderes AWS Konto zu übertragen** Im folgenden `transfer-certificate` Beispiel wird ein Gerätezertifikat auf ein anderes AWS Konto übertragen. Das Zertifikat und das AWS Konto werden anhand der ID identifiziert. ``` aws iot transfer-certificate \ --certificate-id 488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142 \ --target-aws-account 030714055129 ``` Ausgabe: ``` { "transferredCertificateArn": "arn:aws:iot:us-west-2:030714055129:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142" } ``` Weitere Informationen finden Sie unter [Übertragen eines Zertifikats in ein anderes Konto](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [TransferCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/transfer-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie einen Tag-Schlüssel von einer Ressource** Im folgenden Beispiel für `untag-resource` werden das Tag `MyTag` und sein Wert aus der Objektgruppe `LightBulbs` entfernt. ``` command ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging Your AWS IoT Resources](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-account-audit-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-account-audit-configuration`. **AWS CLI** **Beispiel 1: So aktivieren Sie Amazon-SNS-Benachrichtigungen für Audit-Benachrichtigungen** Das folgende `update-account-audit-configuration` Beispiel aktiviert Amazon SNS SNS-Benachrichtigungen für AWS IoT Device Defender Defender-Audit-Benachrichtigungen, wobei ein Ziel und die Rolle angegeben werden, die zum Schreiben in dieses Ziel verwendet wird. ``` aws iot update-account-audit-configuration \ --audit-notification-target-configurations "SNS={targetArn=\"arn:aws:sns:us-west-2:123456789012:ddaudits\",roleArn=\"arn:aws:iam::123456789012:role/service-role/AWSIoTDeviceDefenderAudit\",enabled=true}" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So aktivieren Sie einen Audit-Check** Das folgende `update-account-audit-configuration` Beispiel aktiviert die AWS IoT Device Defender Defender-Auditprüfung mit dem Namen`AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK`. Sie können eine Audit-Prüfung nicht deaktivieren, wenn sie Teil der `targetCheckNames` für ein oder mehrere geplante Audits für das AWS Konto ist. ``` aws iot update-account-audit-configuration \ --audit-check-configurations "{\"AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK\":{\"enabled\":true}}" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateAccountAuditConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-account-audit-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `update-audit-suppression` Das folgende Codebeispiel zeigt die Verwendung`update-audit-suppression`. **AWS CLI** **So aktualisieren Sie eine Unterdrückung von Audit-Erkenntnissen** Im folgenden Beispiel für `update-audit-suppression` wird das Ablaufdatum für die Unterdrückung einer Audit-Erkenntnis auf den 21.09.2020 aktualisiert. ``` aws iot update-audit-suppression \ --check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \ --resource-identifier deviceCertificateId=c7691e \ --no-suppress-indefinitely \ --expiration-date 2020-09-21 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Unterdrückungen von Prüfergebnissen](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-audit-suppression.html)in der *AWS CLI Befehlsreferenz*. ### `update-authorizer` Das folgende Codebeispiel zeigt die Verwendung`update-authorizer`. **AWS CLI** **So aktualisieren Sie einen benutzerdefinierten Genehmiger** Im folgenden Beispiel für `update-authorizer` wird der Status von `CustomAuthorizer2` in `INACTIVE` geändert. ``` aws iot update-authorizer \ --authorizer-name CustomAuthorizer2 \ --status INACTIVE ``` Ausgabe: ``` { "authorizerName": "CustomAuthorizer2", "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2" } ``` Weitere Informationen finden Sie [UpdateAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateAuthorizer.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [UpdateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-authorizer.html)unter *AWS CLI Befehlsreferenz*. ### `update-billing-group` Das folgende Codebeispiel zeigt die Verwendung`update-billing-group`. **AWS CLI** **So aktualisieren Sie Informationen zu einer Abrechnungsgruppe** Im folgenden Beispiel für `update-billing-group` wird die Beschreibung für die angegebene Abrechnungsgruppe aktualisiert. ``` aws iot update-billing-group \ --billing-group-name GroupOne \ --billing-group-properties "billingGroupDescription=\"Primary bulb billing group\"" ``` Ausgabe: ``` { "version": 2 } ``` Weitere Informationen finden Sie unter [Abrechnungsgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-billing-group.html)in der *AWS CLI Befehlsreferenz*. ### `update-ca-certificate` Das folgende Codebeispiel zeigt die Verwendung`update-ca-certificate`. **AWS CLI** **So aktualisieren Sie ein Zertifikat einer Zertifizierungsstelle (CA** Im folgenden Beispiel für `update-ca-certificate` wird das angegebene CA-Zertifikat auf den Status ACTIVE gesetzt. ``` aws iot update-ca-certificate \ --certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467 \ --new-status ACTIVE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Update CACertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateCACertificate.html) in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [UpdateCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-ca-certificate.html)unter *AWS CLI Befehlsreferenz*. ### `update-certificate` Das folgende Codebeispiel zeigt die Verwendung`update-certificate`. **AWS CLI** **So aktualisieren Sie ein Gerätezertifikat** Im folgenden Beispiel für `update-certificate` wird das angegebene Gerätezertifikat auf den Status INACTIVE gesetzt. ``` aws iot update-certificate \ --certificate-id d1eb269fb55a628552143c8f96eb3c258fcd5331ea113e766ba0c82bf225f0be \ --new-status INACTIVE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [UpdateCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateCertificate.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [UpdateCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-certificate.html)unter *AWS CLI Befehlsreferenz*. ### `update-custom-metric` Das folgende Codebeispiel zeigt die Verwendung`update-custom-metric`. **AWS CLI** **So aktualisieren Sie eine benutzerdefinierte Metrik** Im folgenden Beispiel für `update-custom-metric` wird der `display-name` einer benutzerdefinierten Metrik aktualisiert. ``` aws iot update-custom-metric \ --metric-name batteryPercentage \ --display-name 'remaining battery percentage on device' \ --region us-east-1 ``` Ausgabe: ``` { "metricName": "batteryPercentage", "metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage", "metricType": "number", "displayName": "remaining battery percentage on device", "creationDate": "2020-11-17T23:01:35.110000-08:00", "lastModifiedDate": "2020-11-17T23:02:12.879000-08:00" } ``` Weitere Informationen finden Sie unter [Benutzerdefinierte Metriken](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [UpdateCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-custom-metric.html)in der *AWS CLI Befehlsreferenz*. ### `update-dimension` Das folgende Codebeispiel zeigt die Verwendung`update-dimension`. **AWS CLI** **So aktualisieren Sie eine Dimension** Im folgenden Beispiel für `update-dimension` wird eine Dimension aktualisiert. ``` aws iot update-dimension \ --name TopicFilterForAuthMessages \ --string-values device/${iot:ClientId}/auth ``` Ausgabe: ``` { "name": "TopicFilterForAuthMessages", "lastModifiedDate": 1585866222.317, "stringValues": [ "device/${iot:ClientId}/auth" ], "creationDate": 1585854500.474, "type": "TOPIC_FILTER", "arn": "arn:aws:iot:us-west-2:1234564789012:dimension/TopicFilterForAuthMessages" } ``` Weitere Informationen finden Sie unter [Bereichsbestimmung für Metriken in Sicherheitsprofilen mithilfe von Dimensionen](https://docs.aws.amazon.com/iot/latest/developerguide/scoping-security-behavior.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [UpdateDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-dimension.html)in der *AWS CLI Befehlsreferenz*. ### `update-domain-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-domain-configuration`. **AWS CLI** **So aktualisieren Sie eine Domainkonfiguration** Im folgenden Beispiel für `update-domain-configuration` wird die angegebene Domainkonfiguration deaktiviert. ``` aws iot update-domain-configuration \ --domain-configuration-name "additionalDataDomain" \ --domain-configuration-status "DISABLED" ``` Ausgabe: ``` { "domainConfigurationName": "additionalDataDomain", "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh" } ``` Weitere Informationen finden Sie unter [Konfigurierbare Endpunkte](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-domain-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `update-dynamic-thing-group` Das folgende Codebeispiel zeigt die Verwendung`update-dynamic-thing-group`. **AWS CLI** **So aktualisieren Sie eine dynamische Objektgruppe** Im folgenden Beispiel für `update-dynamic-thing-group` wird die angegebene dynamische Objektgruppe aktualisiert. Es enthält eine Beschreibung und aktualisiert die Abfragezeichenfolge, um die Kriterien für die Gruppenzugehörigkeit zu ändern. ``` aws iot update-dynamic-thing-group \ --thing-group-name "RoomTooWarm" --thing-group-properties "thingGroupDescription=\"This thing group contains rooms warmer than 65F.\"" \ --query-string "attributes.temperature>65" ``` Ausgabe: ``` { "version": 2 } ``` Weitere Informationen finden Sie unter [Dynamische Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateDynamicThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-dynamic-thing-group.html)in der *AWS CLI Befehlsreferenz*. ### `update-event-configurations` Das folgende Codebeispiel zeigt die Verwendung`update-event-configurations`. **AWS CLI** **So zeigen Sie an, welche Ereignistypen veröffentlicht wurden** Im folgenden Beispiel für `update-event-configurations` wird die Konfiguration so aktualisiert, dass Meldungen aktiviert werden, wenn das CA-Zertifikat hinzugefügt, aktualisiert oder gelöscht wird. ``` aws iot update-event-configurations \ --event-configurations "{\"CA_CERTIFICATE\":{\"Enabled\":true}}" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ereignismeldungen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-events.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateEventConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-event-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `update-indexing-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-indexing-configuration`. **AWS CLI** **So aktivieren Sie die Indizierung von Objekten** Im folgenden `update-indexing-configuration` Beispiel wird die Dingindizierung aktiviert, sodass die Suche nach Registrierungsdaten, Shadow-Daten und dem Ding-Konnektivitätsstatus mithilfe des AWS\$1Things-Index unterstützt wird. ``` aws iot update-indexing-configuration --thing-indexing-configuration thingIndexingMode=REGISTRY_AND_SHADOW,thingConnectivityIndexingMode=STATUS ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten der Objektindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateIndexingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-indexing-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `update-job` Das folgende Codebeispiel zeigt die Verwendung`update-job`. **AWS CLI** **So rufen Sie den detaillierten Status eines Auftrags ab** Im folgenden Beispiel für `update-job` wird der detaillierte Status für den Auftrag abgerufen, dessen ID `example-job-01` lautet. ``` aws iot describe-job \ --job-id "example-job-01" ``` Ausgabe: ``` { "job": { "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01", "jobId": "example-job-01", "targetSelection": "SNAPSHOT", "status": "IN_PROGRESS", "targets": [ "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi" ], "description": "example job test", "presignedUrlConfig": {}, "jobExecutionsRolloutConfig": {}, "createdAt": 1560787022.733, "lastUpdatedAt": 1560787026.294, "jobProcessDetails": { "numberOfCanceledThings": 0, "numberOfSucceededThings": 0, "numberOfFailedThings": 0, "numberOfRejectedThings": 0, "numberOfQueuedThings": 1, "numberOfInProgressThings": 0, "numberOfRemovedThings": 0, "numberOfTimedOutThings": 0 }, "timeoutConfig": {} } } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Aufträgen (CLI)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-job.html)in der *AWS CLI Befehlsreferenz*. ### `update-mitigation-action` Das folgende Codebeispiel zeigt die Verwendung`update-mitigation-action`. **AWS CLI** **So aktualisieren Sie die Abhilfemaßnahme** Im folgenden Beispiel für `update-mitigation-action` werden die angegebene Abhilfemaßnahme mit dem Namen `AddThingsToQuarantineGroupAction` aktualisiert, der Name der Objektgruppe geändert und `overrideDynamicGroups` auf `false` festgelegt. Sie können Ihre Änderungen mit dem Befehl `describe-mitigation-action` überprüfen. ``` aws iot update-mitigation-action \ --cli-input-json "{ \"actionName\": \"AddThingsToQuarantineGroupAction\", \"actionParams\": { \"addThingsToThingGroupParams\": {\"thingGroupNames\":[\"QuarantineGroup2\"],\"overrideDynamicGroups\": false}}}" ``` Ausgabe: ``` { "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction", "actionId": "2fd2726d-98e1-4abf-b10f-09465ccd6bfa" } ``` Weitere Informationen finden Sie unter [UpdateMitigationAction (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-UpdateMitigationAction) im *AWS IoT Developer Guide*. + Einzelheiten zur API finden Sie unter [UpdateMitigationAction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-mitigation-action.html)*Befehlsreferenz.* ### `update-provisioning-template` Das folgende Codebeispiel zeigt die Verwendung`update-provisioning-template`. **AWS CLI** **So aktualisieren Sie eine Bereitstellungsvorlage** Im folgenden Beispiel für `update-provisioning-template` werden die Beschreibung und der Rollen-ARN für die angegebene Bereitstellungsvorlage geändert und die Vorlage aktiviert. ``` aws iot update-provisioning-template \ --template-name widget-template \ --enabled \ --description "An updated provisioning template for widgets" \ --provisioning-role-arn arn:aws:iam::504350838278:role/Provision_role ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [UpdateProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-provisioning-template.html)in der *AWS CLI Befehlsreferenz*. ### `update-role-alias` Das folgende Codebeispiel zeigt die Verwendung`update-role-alias`. **AWS CLI** **So aktualisieren Sie ein Rollenalias** Im folgenden Beispiel für `update-role-alias` wird der `LightBulbRole`-Rollenalias aktualisiert. ``` aws iot update-role-alias \ --role-alias LightBulbRole \ --role-arn arn:aws:iam::123456789012:role/lightbulbrole-001 ``` Ausgabe: ``` { "roleAlias": "LightBulbRole", "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/LightBulbRole" } ``` Weitere Informationen finden Sie [UpdateRoleAlias](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateRoleAlias.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [UpdateRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-role-alias.html)unter *AWS CLI Befehlsreferenz*. ### `update-scheduled-audit` Das folgende Codebeispiel zeigt die Verwendung`update-scheduled-audit`. **AWS CLI** **So aktualisieren Sie die Definition eines geplanten Audits** Im folgenden `update-scheduled-audit` Beispiel werden die Namen der Zielprüfungen für ein geplantes AWS IoT Device Defender Defender-Audit geändert. ``` aws iot update-scheduled-audit \ --scheduled-audit-name WednesdayCertCheck \ --target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK ``` Ausgabe: ``` { "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/WednesdayCertCheck" } ``` Weitere Informationen finden Sie unter [Audit-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-scheduled-audit.html)in der *AWS CLI Befehlsreferenz*. ### `update-security-profile` Das folgende Codebeispiel zeigt die Verwendung`update-security-profile`. **AWS CLI** **So ändern Sie ein Sicherheitsprofil** Im folgenden `update-security-profile` Beispiel werden sowohl die Beschreibung als auch das Verhalten für ein AWS IoT Device Defender-Sicherheitsprofil aktualisiert. ``` aws iot update-security-profile \ --security-profile-name PossibleIssue \ --security-profile-description "Check to see if authorization fails 12 times in 5 minutes or if cellular bandwidth exceeds 128" \ --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]" ``` Ausgabe: ``` { "securityProfileName": "PossibleIssue", "securityProfileArn": "arn:aws:iot:us-west-2:123456789012:securityprofile/PossibleIssue", "securityProfileDescription": "check to see if authorization fails 12 times in 5 minutes or if cellular bandwidth exceeds 128", "behaviors": [ { "name": "CellularBandwidth", "metric": "aws:message-byte-size", "criteria": { "comparisonOperator": "greater-than", "value": { "count": 128 }, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } }, { "name": "Authorization", "metric": "aws:num-authorization-failures", "criteria": { "comparisonOperator": "less-than", "value": { "count": 12 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 } } ], "version": 2, "creationDate": 1560278102.528, "lastModifiedDate": 1560352711.207 } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-security-profile.html)unter *AWS CLI Befehlsreferenz*. ### `update-stream` Das folgende Codebeispiel zeigt die Verwendung`update-stream`. **AWS CLI** **So aktualisieren Sie einen Stream** Im folgenden Beispiel für `update-stream` wird ein vorhandener Stream aktualisiert. Die Stream-Version wird um eins erhöht. ``` aws iot update-stream \ --cli-input-json file://update-stream.json ``` Inhalt von `update-stream.json`: ``` { "streamId": "stream12345", "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.", "files": [ { "fileId": 123, "s3Location": { "bucket":"codesign-ota-bucket", "key":"48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6" } } ] "roleArn": "arn:aws:iam:us-west-2:123456789012:role/service-role/my_ota_stream_role" } ``` Ausgabe: ``` { "streamId": "stream12345", "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345", "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.", "streamVersion": 2 } ``` Weitere Informationen finden Sie [UpdateStream](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateStream.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [UpdateStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-stream.html)unter *AWS CLI Befehlsreferenz*. ### `update-thing-group` Das folgende Codebeispiel zeigt die Verwendung`update-thing-group`. **AWS CLI** **So aktualisieren Sie die Definition für eine Objektgruppe** Im folgenden Beispiel für `update-thing-group` wird die Definition für die angegebene Objektgruppe aktualisiert, wobei die Beschreibung und zwei Attribute geändert werden. ``` aws iot update-thing-group \ --thing-group-name HalogenBulbs \ --thing-group-properties "thingGroupDescription=\"Halogen bulb group\", attributePayload={attributes={Manufacturer=AnyCompany,wattage=60}}" ``` Ausgabe: ``` { "version": 2 } ``` Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-group.html)in der *AWS CLI Befehlsreferenz*. ### `update-thing-groups-for-thing` Das folgende Codebeispiel zeigt die Verwendung`update-thing-groups-for-thing`. **AWS CLI** **So ändern Sie die Gruppen, zu denen ein Objekt gehört** Im folgenden Beispiel für `update-thing-groups-for-thing` wird das Objekt mit dem Namen `MyLightBulb` aus der Gruppe mit dem Namen `DeadBulbs` entfernt und gleichzeitig zur Gruppe mit dem Namen `replaceableItems` hinzugefügt. ``` aws iot update-thing-groups-for-thing \ --thing-name MyLightBulb \ --thing-groups-to-add "replaceableItems" \ --thing-groups-to-remove "DeadBulbs" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Objektgruppen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) im *Entwicklerhandbuch zu AWS IoT*. + Einzelheiten zur API finden Sie [UpdateThingGroupsForThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-groups-for-thing.html)in der *AWS CLI Befehlsreferenz*. ### `update-thing` Das folgende Codebeispiel zeigt die Verwendung`update-thing`. **AWS CLI** **So weisen Sie einem Objekt einen Objekttyp zu** Das folgende `update-thing` Beispiel ordnet ein Ding in der AWS IoT-Registrierung einem Dingtyp zu. Wenn Sie die Zuordnung vornehmen, geben Sie Werte für die durch den Objekttyp definierten Attribute an. ``` aws iot update-thing \ --thing-name "MyOtherLightBulb" \ --thing-type-name "LightBulb" \ --attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}" ``` Dieser Befehl erzeugt keine Ausgabe. Verwenden Sie den `describe-thing`-Befehl, um das Ergebnis anzuzeigen. Weitere Informationen finden Sie unter [Objekttypen](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing.html)in der *AWS CLI Befehlsreferenz*. ### `update-topic-rule-destination` Das folgende Codebeispiel zeigt die Verwendung`update-topic-rule-destination`. **AWS CLI** **Beispiel 1: So aktivieren Sie das Ziel einer Themenregel** Im folgenden Beispiel für `update-topic-rule-destination` wird Datenverkehr zum Ziel einer Themenregel aktiviert. ``` aws iot update-topic-rule-destination \ --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \ --status ENABLED ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren eines Themenregelziels](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#enable-destination) im *Entwicklerhandbuch für AWS IoT*. **Beispiel 2: So deaktivieren Sie das Ziel einer Themenregel** Im folgenden Beispiel für `update-topic-rule-destination` wird Datenverkehr zum Ziel einer Themenregel deaktiviert. ``` aws iot update-topic-rule-destination \ --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \ --status DISABLED ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Deaktivieren eines Themenregelziels](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#disable-destination) im *Entwicklerhandbuch für AWS IoT*. **Beispiel 3: So senden Sie eine neue Bestätigungsnachricht** Im folgenden Beispiel für `update-topic-rule-destination` wird eine neue Bestätigungsnachricht für das Ziel einer Themenregel gesendet. ``` aws iot update-topic-rule-destination \ --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \ --status IN_PROGRESS ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Senden einer neuen Bestätigungsnachricht](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#trigger-confirm) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-topic-rule-destination.html)in der *AWS CLI Befehlsreferenz*. ### `validate-security-profile-behaviors` Das folgende Codebeispiel zeigt die Verwendung`validate-security-profile-behaviors`. **AWS CLI** **Beispiel 1: So validieren Sie die Verhaltensparameter für ein Sicherheitsprofil** Das folgende `validate-security-profile-behaviors` Beispiel validiert wohlgeformte und korrekte Verhaltensmuster für ein AWS IoT Device Defender-Sicherheitsprofil. ``` aws iot validate-security-profile-behaviors \ --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]" ``` Ausgabe: ``` { "valid": true, "validationErrors": [] } ``` **Beispiel 2: So validieren Sie inkorrekte Verhaltensparameter für ein Sicherheitsprofil** Das folgende `validate-security-profile-behaviors` Beispiel validiert eine Reihe von Verhaltensweisen, die einen Fehler für ein AWS IoT Device Defender-Sicherheitsprofil enthalten. ``` aws iot validate-security-profile-behaviors \ --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":100000,\"consecutiveDatapointsToClear\":1}}]" ``` Ausgabe: ``` { "valid": false, "validationErrors": [ { "errorMessage": "Behavior Authorization is malformed. consecutiveDatapointsToAlarm 100000 should be in range[1,10]" } ] } ``` Weitere Informationen finden Sie unter [Detect-Befehle](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie unter [ValidateSecurityProfileBehaviors AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/validate-security-profile-behaviors.html)*Befehlsreferenz.* # Device Advisor-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Device Advisor Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-suite-definition` Das folgende Codebeispiel zeigt die Verwendung von`create-suite-definition`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Testsuite für IoT Device Advisor** Im folgenden `create-suite-definition` Beispiel wird eine Device Advisor-Testsuite im AWS IoT mit der angegebenen Suite-Definitionskonfiguration erstellt. ``` aws iotdeviceadvisor create-suite-definition \ --suite-definition-configuration '{ \ "suiteDefinitionName": "TestSuiteName", \ "devices": [{"thingArn":"arn:aws:iot:us-east-1:123456789012:thing/MyIotThing"}], \ "intendedForQualification": false, \ "rootGroup": "{\"configuration\":{},\"tests\":[{\"name\":\"MQTT Connect\",\"configuration\":{\"EXECUTION_TIMEOUT\":120},\"tests\":[{\"name\":\"MQTT_Connect\",\"configuration\":{},\"test\":{\"id\":\"MQTT_Connect\",\"testCase\":null,\"version\":\"0.0.0\"}}]}]}", \ "devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole"}' ``` Ausgabe: ``` { "suiteDefinitionId": "0jtsgio7yenu", "suiteDefinitionArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/0jtsgio7yenu", "suiteDefinitionName": "TestSuiteName", "createdAt": "2022-12-02T11:38:13.263000-05:00" } ``` Weitere Informationen finden Sie unter [Erstellen einer Testsuite-Definition](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-create-suite-definition) im *Entwicklerhandbuch für AWS IoT Core*. **Beispiel 2: So erstellen Sie eine Qualifizierungs-Testsuite für IoT Device Advisor** Im folgenden `create-suite-definition` Beispiel wird eine Device Advisor-Qualifizierungstestsuite mit der neuesten Version im AWS IoT mit der angegebenen Suite-Definitionskonfiguration erstellt. ``` aws iotdeviceadvisor create-suite-definition \ --suite-definition-configuration '{ \ "suiteDefinitionName": "TestSuiteName", \ "devices": [{"thingArn":"arn:aws:iot:us-east-1:123456789012:thing/MyIotThing"}], \ "intendedForQualification": true, \ "rootGroup": "", \ "devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole"}' ``` Ausgabe: ``` { "suiteDefinitionId": "txgsuolk2myj", "suiteDefinitionArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/txgsuolk2myj", "suiteDefinitionName": "TestSuiteName", "createdAt": "2022-12-02T11:38:13.263000-05:00" } ``` Weitere Informationen finden Sie unter [Erstellen einer Testsuite-Definition](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-create-suite-definition) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [CreateSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/create-suite-definition.html)in der *AWS CLI Befehlsreferenz*. ### `delete-suite-definition` Das folgende Codebeispiel zeigt die Verwendung`delete-suite-definition`. **AWS CLI** **So löschen Sie die Testsuite von IoT Device Advisor** Im folgenden Beispiel für `delete-suite-definition` wird die Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID gelöscht. ``` aws iotdeviceadvisor delete-suite-definition \ --suite-definition-id 0jtsgio7yenu ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [DeleteSuiteDefinition](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_DeleteSuiteDefinition.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [DeleteSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/delete-suite-definition.html)unter *AWS CLI Befehlsreferenz*. ### `get-endpoint` Das folgende Codebeispiel zeigt die Verwendung`get-endpoint`. **AWS CLI** **Beispiel 1: So rufen Sie die Informationen über einen Endpunkt auf Kontoebene von IoT Device Advisor ab** Im folgenden Beispiel für `get-endpoint` werden die Informationen über einen Test-Endpunkt auf Kontoebene von Device Advisor abgerufen. ``` aws iotdeviceadvisor get-endpoint ``` Ausgabe: ``` { "endpoint": "t6y4c143x9sfo.deviceadvisor.iot.us-east-1.amazonaws.com" } ``` **Beispiel 2: So rufen Sie die Informationen über einen Endpunkt auf Geräteebene von IoT Device Advisor ab** Im folgenden Beispiel für `get-endpoint` werden die Informationen über einen Test-Endpunkt auf Geräteebene von Device Advisor mit dem angegebenen Objekt-ARN oder Zertifikat-ARN abgerufen. ``` aws iotdeviceadvisor get-endpoint \ --thing-arn arn:aws:iot:us-east-1:123456789012:thing/MyIotThing ``` Ausgabe: ``` { "endpoint": "tdb7719be5t6y4c143x9sfo.deviceadvisor.iot.us-east-1.amazonaws.com" } ``` Weitere Informationen finden Sie unter [Abrufen eines Testendpunkts](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-get-test-endpoint) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [GetEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `get-suite-definition` Das folgende Codebeispiel zeigt die Verwendung`get-suite-definition`. **AWS CLI** **So rufen Sie Informationen über eine Testsuite von IoT Device Advisor ab** Im folgenden Beispiel für `get-suite-definition` werden die Informationen über eine Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID abgerufen. ``` aws iotdeviceadvisor get-suite-definition \ --suite-definition-id qqcsmtyyjabl ``` Ausgabe: ``` { "suiteDefinitionId": "qqcsmtyyjabl", "suiteDefinitionArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/qqcsmtyyjabl", "suiteDefinitionVersion": "v1", "latestVersion": "v1", "suiteDefinitionConfiguration": { "suiteDefinitionName": "MQTT connection", "devices": [], "intendedForQualification": false, "isLongDurationTest": false, "rootGroup": "{\"configuration\":{},\"tests\":[{\"id\":\"uta5d9j1kvwc\",\"name\":\"Test group 1\",\"configuration\":{},\"tests\":[{\"id\":\"awr8pq5vc9yp\",\"name\":\"MQTT Connect\",\"configuration\":{},\"test\":{\"id\":\"MQTT_Connect\",\"testCase\":null,\"version\":\"0.0.0\"}}]}]}", "devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole", "protocol": "MqttV3_1_1" }, "createdAt": "2022-11-11T22:28:52.389000-05:00", "lastModifiedAt": "2022-11-11T22:28:52.389000-05:00", "tags": {} } ``` Weitere Informationen finden Sie unter [Abrufen einer Testsuite-Definition](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-create-suite-definition) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [GetSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-suite-definition.html)in der *AWS CLI Befehlsreferenz*. ### `get-suite-run-report` Das folgende Codebeispiel zeigt die Verwendung`get-suite-run-report`. **AWS CLI** **So rufen Sie Informationen über den Bericht zur Ausführung einer Qualifizierungs-Testsuite von IoT Device Advisor ab** Im folgenden Beispiel für `get-suite-run-report` wird der Link zum Herunterladen des Berichts für eine erfolgreiche Ausführung einer Qualifizierungs-Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID und Suite-Ausführungs-ID abgerufen. ``` aws iotdeviceadvisor get-suite-run-report \ --suite-definition-id ztvb5aek4w4x \ --suite-run-id p6awv83nre6v ``` Ausgabe: ``` { "qualificationReportDownloadUrl": "https://senate-apn-reports-us-east-1-prod.s3.amazonaws.com/report.downloadlink" } ``` Weitere Informationen finden Sie unter [Abrufen eines Qualifizierungsberichts für eine erfolgreiche Ausführung der Qualifizierungstestsuite](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-qualification-report) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [GetSuiteRunReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-suite-run-report.html)in der *AWS CLI Befehlsreferenz*. ### `get-suite-run` Das folgende Codebeispiel zeigt die Verwendung`get-suite-run`. **AWS CLI** **So rufen Sie Informationen über den Ausführungsstatus einer Testsuite von IoT Device Advisor ab** Im folgenden Beispiel für `get-suite-run` werden die Informationen über den Ausführungsstatus einer Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID und Suite-Ausführungs-ID abgerufen. ``` aws iotdeviceadvisor get-suite-run \ --suite-definition-id qqcsmtyyjabl \ --suite-run-id nzlfyhaa18oa ``` Ausgabe: ``` { "suiteDefinitionId": "qqcsmtyyjabl", "suiteDefinitionVersion": "v1", "suiteRunId": "nzlfyhaa18oa", "suiteRunArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suiterun/qqcsmtyyjabl/nzlfyhaa18oa", "suiteRunConfiguration": { "primaryDevice": { "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyIotThing", "certificateArn": "arn:aws:iot:us-east-1:123456789012:cert/certFile" }, "parallelRun": false }, "testResult": { "groups": [ { "groupId": "uta5d9j1kvwc", "groupName": "Test group 1", "tests": [ { "testCaseRunId": "2ve2twrqyr0s", "testCaseDefinitionId": "awr8pq5vc9yp", "testCaseDefinitionName": "MQTT Connect", "status": "PASS", "startTime": "2022-11-12T00:01:53.693000-05:00", "endTime": "2022-11-12T00:02:15.443000-05:00", "logUrl": "https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logEventViewer:group=/aws/iot/deviceadvisor/qqcsmtyyjabl;stream=nzlfyhaa18oa_2ve2twrqyr0s", "warnings": "null", "failure": "null" } ] } ] }, "startTime": "2022-11-12T00:01:52.673000-05:00", "endTime": "2022-11-12T00:02:16.496000-05:00", "status": "PASS", "tags": {} } ``` Weitere Informationen finden Sie unter [Abrufen einer Testsuite-Ausführung](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-describe-suite) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [GetSuiteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-suite-run.html)in der *AWS CLI Befehlsreferenz*. ### `list-suite-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-suite-definitions`. **AWS CLI** **Beispiel 1: So listen Sie die von Ihnen erstellten Testsuites von IoT Device Advisor auf** Das folgende `list-suite-definitions` Beispiel listet bis zu 25 Device Advisor-Testsuiten auf, die Sie in AWS IoT erstellt haben. Wenn Sie mehr als 25 Testsuiten haben, wird „nextToken“ in der Ausgabe angezeigt. Sie können „nextToken“ verwenden, um den Rest der von Ihnen erstellten Testsuites anzuzeigen. ``` aws iotdeviceadvisor list-suite-definitions ``` Ausgabe: ``` { "suiteDefinitionInformationList": [ { "suiteDefinitionId": "3hsn88h4p2g5", "suiteDefinitionName": "TestSuite1", "defaultDevices": [ { "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyIotThing" } ], "intendedForQualification": false, "isLongDurationTest": false, "protocol": "MqttV3_1_1", "createdAt": "2022-11-17T14:15:56.830000-05:00" }, { ...... } ], "nextToken": "nextTokenValue" } ``` **Beispiel 2: So listen Sie die Testsuites von IoT Device Advisor auf, die Sie mit den angegebenen Einstellungen erstellt haben** Das folgende `list-suite-definitions` Beispiel listet Device Advisor-Testsuiten auf, die Sie in AWS IoT mit der angegebenen maximalen Ergebniszahl erstellt haben. Wenn die Zahl Ihrer Testsuites die maximale Anzahl übersteigt, wird „nextToken“ in der Ausgabe angezeigt. Wenn Sie „nextToken“ haben, können Sie den Wert verwenden, um die von Ihnen erstellten Testsuites anzuzeigen, die zuvor nicht angezeigt wurden. ``` aws iotdeviceadvisor list-suite-definitions \ --max-result 1 \ --next-token "nextTokenValue" ``` Ausgabe: ``` { "suiteDefinitionInformationList": [ { "suiteDefinitionId": "ztvb5aew4w4x", "suiteDefinitionName": "TestSuite2", "defaultDevices": [], "intendedForQualification": true, "isLongDurationTest": false, "protocol": "MqttV3_1_1", "createdAt": "2022-11-17T14:15:56.830000-05:00" } ], "nextToken": "nextTokenValue" } ``` Weitere Informationen finden Sie [ListSuiteDefinitions](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_ListSuiteDefinitions.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListSuiteDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/list-suite-definitions.html)unter *AWS CLI Befehlsreferenz*. ### `list-suite-runs` Das folgende Codebeispiel zeigt die Verwendung`list-suite-runs`. **AWS CLI** **Beispiel 1: So listen Sie alle Informationen über den Ausführungsstatus der angegebenen Testsuite von IoT Device Advisor auf** Im folgenden Beispiel für `list-suite-runs` werden alle Informationen über den Ausführungsstatus einer Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID aufgelistet. Wenn Sie mehr als 25 Testsuite-Ausführungen haben, wird „nextToken“ in der Ausgabe angezeigt. Sie können „nextToken“ verwenden, um die restlichen Testsuite-Ausführungen anzuzeigen. ``` aws iotdeviceadvisor list-suite-runs \ --suite-definition-id ztvb5aew4w4x ``` Ausgabe: ``` { "suiteRunsList": [ { "suiteDefinitionId": "ztvb5aew4w4x", "suiteDefinitionVersion": "v1", "suiteDefinitionName": "TestSuite", "suiteRunId": "p6awv89nre6v", "createdAt": "2022-12-01T16:33:14.212000-05:00", "startedAt": "2022-12-01T16:33:15.710000-05:00", "endAt": "2022-12-01T16:42:03.323000-05:00", "status": "PASS", "passed": 6, "failed": 0 } ] } ``` **Beispiel 2: So listen Sie Informationen über den Ausführungsstatus der angegebenen Testsuite von IoT Device Advisor mit den angegebenen Einstellungen auf** Im folgenden Beispiel für `list-suite-runs` werden Informationen über den Ausführungsstatus einer Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID und der angegebenen maximalen Ergebniszahl aufgelistet. Wenn die Zahl Ihrer Testsuite-Ausführungen die maximale Anzahl übersteigt, wird „nextToken“ in der Ausgabe angezeigt. Wenn Sie „nextToken“ haben, können Sie den Wert verwenden, um die Testsuite-Ausführungen anzuzeigen, die zuvor nicht angezeigt wurden. ``` aws iotdeviceadvisor list-suite-runs \ --suite-definition-id qqcsmtyyjaml \ --max-result 1 \ --next-token "nextTokenValue" ``` Ausgabe: ``` { "suiteRunsList": [ { "suiteDefinitionId": "qqcsmtyyjaml", "suiteDefinitionVersion": "v1", "suiteDefinitionName": "MQTT connection", "suiteRunId": "gz9vm2s6d2jy", "createdAt": "2022-12-01T20:10:27.079000-05:00", "startedAt": "2022-12-01T20:10:28.003000-05:00", "endAt": "2022-12-01T20:10:45.084000-05:00", "status": "STOPPED", "passed": 0, "failed": 0 } ], "nextToken": "nextTokenValue" } ``` Weitere Informationen finden Sie [ListSuiteRuns](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_ListSuiteRuns.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [ListSuiteRuns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/list-suite-runs.html)unter *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags auf, die an eine Ressource von IoT Device Advisor angehängt sind** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags aufgelistet, die an eine Ressource von Device Advisor angehängt sind Die Ressource von Device Advisor kann ein Suite-Definitions-ARN oder ein Suite-Ausführungs-ARN sein. ``` aws iotdeviceadvisor list-tags-for-resource \ --resource-arn arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/ba0uyjpg38ny ``` Ausgabe: ``` { "tags": { "TestTagKey": "TestTagValue" } } ``` Weitere Informationen finden Sie [ListTagsForResource](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_ListTagsForResource.html)in der *AWS IoT-API-Referenz* und unter [Ressourcentypen, die von AWS IoT Core Device Advisor definiert wurden](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotcoredeviceadvisor.html#awsiotcoredeviceadvisor-resources-for-iam-policies), in der *Service Authorization Reference*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `start-suite-run` Das folgende Codebeispiel zeigt die Verwendung`start-suite-run`. **AWS CLI** **So starten Sie die Ausführung einer Testsuite von IoT Device Advisor** Das folgende `start-suite-run` Beispiel listet die verfügbaren Widgets in Ihrem AWS Konto auf. ``` aws iotdeviceadvisor start-suite-run \ --suite-definition-id qqcsmtyyjabl \ --suite-definition-version v1 \ --suite-run-configuration '{"primaryDevice":{"thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyIotThing","certificateArn":"arn:aws:iot:us-east-1:123456789012:cert/certFile"}}' ``` Ausgabe: ``` { "suiteRunId": "pwmucgw7lt9s", "suiteRunArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suiterun/qqcsmtyyjabl/pwmucgw7lk9s", "createdAt": "2022-12-02T15:43:05.581000-05:00" } ``` Weitere Informationen finden Sie unter [Starten einer Testsuite-Ausführung](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-start-suite-run) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [StartSuiteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/start-suite-run.html)in der *AWS CLI Befehlsreferenz*. ### `stop-suite-run` Das folgende Codebeispiel zeigt die Verwendung`stop-suite-run`. **AWS CLI** **So beenden Sie eine Testsuite von IoT Device Advisor, die gerade ausgeführt wird** Im folgenden Beispiel für `stop-suite-run` wird eine Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID und Suite-Ausführungs-ID, die derzeit ausgeführt wird, beendet. ``` aws iotdeviceadvisor stop-suite-run \ --suite-definition-id qqcsmtyyjabl \ --suite-run-id nzlfyhaa18oa ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Beenden einer Testsuite-Ausführung](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-stop-suite-run) im *Entwicklerhandbuch für AWS IoT Core*. + Einzelheiten zur API finden Sie [StopSuiteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/stop-suite-run.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie die vorhandenen Tags einer Ressource von IoT Device Advisor hinzu und ändern sie** Im folgenden Beispiel für `tag-resource` werden die vorhandenen Tags einer Ressource von Device Advisor mit dem angegebenen Ressourcen-ARN und den angegebenen Tags hinzugefügt und geändert. Die Ressource von Device Advisor kann ein Suite-Definitions-ARN oder ein Suite-Ausführungs-ARN sein. ``` aws iotdeviceadvisor tag-resource \ --resource-arn arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/ba0uyjpg38ny \ --tags '{"TagKey": "TagValue"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [TagResource](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_TagResource.html)in der *AWS IoT-API-Referenz* und unter [Ressourcentypen, die von AWS IoT Core Device Advisor definiert wurden](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotcoredeviceadvisor.html#awsiotcoredeviceadvisor-resources-for-iam-policies), in der *Service Authorization Reference*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie die vorhandenen Tags aus einer Ressource von IoT Device Advisor** Im folgenden Beispiel für `untag-resource` werden die vorhandenen Tags aus einer Ressource von Device Advisor mit dem angegebenen Ressourcen-ARN und den angegebenen Tags entfernt. Die Ressource von Device Advisor kann ein Suite-Definitions-ARN oder ein Suite-Ausführungs-ARN sein. ``` aws iotdeviceadvisor untag-resource \ --resource-arn arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/ba0uyjpg38ny \ --tag-keys "TagKey" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [UntagResource](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_UntagResource.html)in der *AWS IoT-API-Referenz* und unter [Ressourcentypen, die von AWS IoT Core Device Advisor definiert wurden](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotcoredeviceadvisor.html#awsiotcoredeviceadvisor-resources-for-iam-policies), in der *Service Authorization Reference*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-suite-definition` Das folgende Codebeispiel zeigt die Verwendung`update-suite-definition`. **AWS CLI** **Beispiel 1: So aktualisieren Sie eine Testsuite für IoT Device Advisor** Das folgende `update-suite-definition` Beispiel aktualisiert eine Device Advisor-Testsuite im AWS IoT mit der angegebenen Suite-Definition-ID und der Suite-Definitionskonfiguration. ``` aws iotdeviceadvisor update-suite-definition \ --suite-definition-id 3hsn88h4p2g5 \ --suite-definition-configuration '{ \ "suiteDefinitionName": "TestSuiteName", \ "devices": [{"thingArn":"arn:aws:iot:us-east-1:123456789012:thing/MyIotThing"}], \ "intendedForQualification": false, \ "rootGroup": "{\"configuration\":{},\"tests\":[{\"name\":\"MQTT Connect\",\"configuration\":{\"EXECUTION_TIMEOUT\":120},\"tests\":[{\"name\":\"MQTT_Connect\",\"configuration\":{},\"test\":{\"id\":\"MQTT_Connect\",\"testCase\":null,\"version\":\"0.0.0\"}}]}]}", \ "devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole"}' ``` Ausgabe: ``` { "suiteDefinitionId": "3hsn88h4p2g5", "suiteDefinitionName": "TestSuiteName", "suiteDefinitionVersion": "v3", "createdAt": "2022-11-17T14:15:56.830000-05:00", "lastUpdatedAt": "2022-12-02T16:02:45.857000-05:00" } ``` **Beispiel 2: So aktualisieren Sie eine Qualifizierungs-Testsuite für IoT Device Advisor** Im folgenden `update-suite-definition` Beispiel wird eine Device Advisor-Qualifizierungstestsuite im AWS IoT mit der angegebenen Suite-Definition-ID und der Suite-Definitionskonfiguration aktualisiert. ``` aws iotdeviceadvisor update-suite-definition \ --suite-definition-id txgsuolk2myj \ --suite-definition-configuration '{ "suiteDefinitionName": "TestSuiteName", \ "devices": [{"thingArn":"arn:aws:iot:us-east-1:123456789012:thing/MyIotThing"}], \ "intendedForQualification": true, \ "rootGroup": "", \ "devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole"}' ``` Ausgabe: ``` { "suiteDefinitionId": "txgsuolk2myj", "suiteDefinitionName": "TestSuiteName", "suiteDefinitionVersion": "v3", "createdAt": "2022-11-17T14:15:56.830000-05:00", "lastUpdatedAt": "2022-12-02T16:02:45.857000-05:00" } ``` Weitere Informationen finden Sie [UpdateSuiteDefinition](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_UpdateSuiteDefinition.html)in der *AWS IoT-API-Referenz*. + Einzelheiten zur API finden Sie [UpdateSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/update-suite-definition.html)unter *AWS CLI Befehlsreferenz*. # AWS IoT data Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT data. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-thing-shadow` Das folgende Codebeispiel zeigt, wie Sie`delete-thing-shadow`. **AWS CLI** **So löschen Sie das Schattendokument eines Geräts** Im folgenden Beispiel für `delete-thing-shadow` wird das gesamte Schattendokument für das angegebene Gerät mit dem Namen `MyRPi` gelöscht. ``` aws iot-data delete-thing-shadow \ --thing-name MyRPi \ "output.txt" ``` Der Befehl erzeugt keine Ausgabe auf dem Bildschirm, `output.txt` enthält jedoch Informationen, die die Version und den Zeitstempel des gelöschten Schattendokuments bestätigen. ``` {"version":2,"timestamp":1560270384} ``` Weitere Informationen finden Sie unter [Verwenden von Schatten](https://docs.aws.amazon.com/iot/latest/developerguide/using-device-shadows.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DeleteThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/delete-thing-shadow.html)in der *AWS CLI Befehlsreferenz*. ### `get-thing-shadow` Das folgende Codebeispiel zeigt die Verwendung`get-thing-shadow`. **AWS CLI** **So rufen Sie ein Objektschattendokument ab** Im folgenden Beispiel für `get-thing-shadow` wird das Objektschattendokument für das angegebene IoT-Objekt abgerufen. ``` aws iot-data get-thing-shadow \ --thing-name MyRPi \ output.txt ``` Der Befehl erzeugt keine Ausgabe auf dem Display, aber im Folgenden wird der Inhalt von `output.txt` angezeigt: ``` { "state":{ "reported":{ "moisture":"low" } }, "metadata":{ "reported":{ "moisture":{ "timestamp":1560269319 } } }, "version":1,"timestamp":1560269405 } ``` Weitere Informationen finden Sie unter [Datenfluss des Geräteschatten-Service](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/get-thing-shadow.html)in der *AWS CLI Befehlsreferenz*. ### `update-thing-shadow` Das folgende Codebeispiel zeigt die Verwendung`update-thing-shadow`. **AWS CLI** **So aktualisieren Sie einen Objektschatten** Im folgenden Beispiel für `update-thing-shadow` wird der aktuelle Zustand des Geräteschattens für das angegebene Objekt geändert und in der Datei `output.txt` gespeichert. ``` aws iot-data update-thing-shadow \ --thing-name MyRPi \ --payload "{"state":{"reported":{"moisture":"okay"}}}" \ "output.txt" ``` Der Befehl erzeugt keine Ausgabe auf dem Display, aber im Folgenden wird der Inhalt von `output.txt` angezeigt: ``` { "state": { "reported": { "moisture": "okay" } }, "metadata": { "reported": { "moisture": { "timestamp": 1560270036 } } }, "version": 2, "timestamp": 1560270036 } ``` Weitere Informationen finden Sie unter [Datenfluss des Geräteschatten-Service](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/update-thing-shadow.html)in der *AWS CLI Befehlsreferenz*. # AWS IoT Events Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT Events. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-put-message` Das folgende Codebeispiel zeigt, wie Sie`batch-put-message`. **AWS CLI** **Um Nachrichten (Eingaben) an AWS IoT Events zu senden** Das folgende `batch-put-message` Beispiel sendet eine Reihe von Nachrichten an das AWS IoT Events Events-System. Die Nutzdaten jeder Nachricht werden in die von Ihnen festgelegte Eingabe (`inputName`) transformiert und in allen Detektoren erfasst, die diese Eingabe überwachen. Wenn mehrere Nachrichten gesendet werden, kann die Reihenfolge, in der die Nachrichten verarbeitet werden, nicht garantiert werden. Um die Reihenfolge zu garantieren, müssen Sie Nachrichten nacheinander senden und auf eine erfolgreiche Antwort warten. ``` aws iotevents-data batch-put-message \ --cli-input-json file://highPressureMessage.json ``` Inhalt von `highPressureMessage.json`: ``` { "messages": [ { "messageId": "00001", "inputName": "PressureInput", "payload": "{\"motorid\": \"Fulton-A32\", \"sensorData\": {\"pressure\": 80, \"temperature\": 39} }" } ] } ``` Ausgabe: ``` { "BatchPutMessageErrorEntries": [] } ``` Weitere Informationen finden Sie [BatchPutMessage](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchPutMessage.html)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [BatchPutMessage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/batch-put-message.html)unter *AWS CLI Befehlsreferenz*. ### `batch-update-detector` Das folgende Codebeispiel zeigt die Verwendung`batch-update-detector`. **AWS CLI** **So aktualisieren Sie einen Detektor (Instance)** Im folgenden Beispiel für `batch-update-detector` werden der Zustand, die Variablenwerte und die Timer-Einstellungen eines oder mehrerer Detektoren (Instances) eines bestimmten Detektormodells aktualisiert. ``` aws iotevents-data batch-update-detector \ --cli-input-json file://budFulton-A32.json ``` Inhalt von `budFulton-A32.json`: ``` { "detectors": [ { "messageId": "00001", "detectorModelName": "motorDetectorModel", "keyValue": "Fulton-A32", "state": { "stateName": "Normal", "variables": [ { "name": "pressureThresholdBreached", "value": "0" } ], "timers": [ ] } } ] } ``` Ausgabe: ``` { "batchUpdateDetectorErrorEntries": [] } ``` Weitere Informationen finden Sie [BatchUpdateDetector](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchUpdateDetector.html)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [BatchUpdateDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/batch-update-detector.html)unter *AWS CLI Befehlsreferenz*. ### `create-detector-model` Das folgende Codebeispiel zeigt die Verwendung`create-detector-model`. **AWS CLI** **So erstellen Sie ein Detektormodell** Im folgenden Beispiel für `create-detector-model` wird ein Detektormodell erstellt, dessen Konfiguration durch eine Parameterdatei spezifiziert wird. ``` aws iotevents create-detector-model \ --cli-input-json file://motorDetectorModel.json ``` Inhalt von `motorDetectorModel.json`: ``` { "detectorModelName": "motorDetectorModel", "detectorModelDefinition": { "states": [ { "stateName": "Normal", "onEnter": { "events": [ { "eventName": "init", "condition": "true", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "0" } } ] } ] }, "onInput": { "transitionEvents": [ { "eventName": "Overpressurized", "condition": "$input.PressureInput.sensorData.pressure > 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached + 3" } } ], "nextState": "Dangerous" } ] } }, { "stateName": "Dangerous", "onEnter": { "events": [ { "eventName": "Pressure Threshold Breached", "condition": "$variable.pressureThresholdBreached > 1", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:underPressureAction" } } ] } ] }, "onInput": { "events": [ { "eventName": "Overpressurized", "condition": "$input.PressureInput.sensorData.pressure > 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "3" } } ] }, { "eventName": "Pressure Okay", "condition": "$input.PressureInput.sensorData.pressure <= 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached - 1" } } ] } ], "transitionEvents": [ { "eventName": "BackToNormal", "condition": "$input.PressureInput.sensorData.pressure <= 70 && $variable.pressureThresholdBreached <= 1", "nextState": "Normal" } ] }, "onExit": { "events": [ { "eventName": "Normal Pressure Restored", "condition": "true", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:pressureClearedAction" } } ] } ] } } ], "initialStateName": "Normal" }, "key": "motorid", "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole" } ``` Ausgabe: ``` { "detectorModelConfiguration": { "status": "ACTIVATING", "lastUpdateTime": 1560796816.077, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "creationTime": 1560796816.077, "detectorModelArn": "arn:aws:iotevents:us-west-2:123456789012:detectorModel/motorDetectorModel", "key": "motorid", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" } } ``` Weitere Informationen finden Sie [CreateDetectorModel](https://docs.aws.amazon.com/iotevents/latest/apireference/API_CreateDetectorModel.html)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [CreateDetectorModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/create-detector-model.html)unter *AWS CLI Befehlsreferenz*. ### `create-input` Das folgende Codebeispiel zeigt die Verwendung`create-input`. **AWS CLI** **So erstellen Sie eine Eingabe** Im folgenden Beispiel für `create-input` wird eine Eingabe erstellt. ``` aws iotevents create-input \ --cli-input-json file://pressureInput.json ``` Inhalt von `pressureInput.json`: ``` { "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor", "inputDefinition": { "attributes": [ { "jsonPath": "sensorData.pressure" }, { "jsonPath": "motorid" } ] } } ``` Ausgabe: ``` { "inputConfiguration": { "status": "ACTIVE", "inputArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "lastUpdateTime": 1560795312.542, "creationTime": 1560795312.542, "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor" } } ``` Weitere Informationen finden Sie [CreateInput](https://docs.aws.amazon.com/iotevents/latest/apireference/API_CreateInput)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [CreateInput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/create-input.html)unter *AWS CLI Befehlsreferenz*. ### `delete-detector-model` Das folgende Codebeispiel zeigt die Verwendung`delete-detector-model`. **AWS CLI** **So löschen Sie ein Detektormodell** Im folgenden Beispiel für `delete-detector-model` wird das angegebene Detektormodell gelöscht. Alle aktiven Instances des Detektormodells werden ebenfalls gelöscht. ``` aws iotevents delete-detector-model \ --detector-model-name motorDetectorModel ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [DeleteDetectorModel](https://docs.aws.amazon.com/iotevents/latest/apireference/API_DeleteDetectorModel)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [DeleteDetectorModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/delete-detector-model.html)unter *AWS CLI Befehlsreferenz*. ### `delete-input` Das folgende Codebeispiel zeigt die Verwendung`delete-input`. **AWS CLI** **Um eine Eingabe zu löschen** Im folgenden Beispiel für `delete-input` wird die angegebene Eingabe gelöscht. ``` aws iotevents delete-input \ --input-name PressureInput ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [DeleteInput](https://docs.aws.amazon.com/iotevents/latest/apireference/API_DeleteInput)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [DeleteInput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/delete-input.html)unter *AWS CLI Befehlsreferenz*. ### `describe-detector-model` Das folgende Codebeispiel zeigt die Verwendung`describe-detector-model`. **AWS CLI** **So rufen Sie Informationen zu einem Detektormodell ab** Im folgenden Beispiel für `describe-detector-model` werden die Details zum angegebenen Detektormodell angezeigt. Da der Parameter `version` nicht festgelegt ist, werden Informationen über die neueste Version zurückgegeben. ``` aws iotevents describe-detector-model \ --detector-model-name motorDetectorModel ``` Ausgabe: ``` { "detectorModel": { "detectorModelConfiguration": { "status": "ACTIVE", "lastUpdateTime": 1560796816.077, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "creationTime": 1560796816.077, "detectorModelArn": "arn:aws:iotevents:us-west-2:123456789012:detectorModel/motorDetectorModel", "key": "motorid", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" }, "detectorModelDefinition": { "states": [ { "onInput": { "transitionEvents": [ { "eventName": "Overpressurized", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached + 3" } } ], "condition": "$input.PressureInput.sensorData.pressure > 70", "nextState": "Dangerous" } ], "events": [] }, "stateName": "Normal", "onEnter": { "events": [ { "eventName": "init", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "0" } } ], "condition": "true" } ] }, "onExit": { "events": [] } }, { "onInput": { "transitionEvents": [ { "eventName": "BackToNormal", "actions": [], "condition": "$input.PressureInput.sensorData.pressure <= 70 && $variable.pressureThresholdBreached <= 1", "nextState": "Normal" } ], "events": [ { "eventName": "Overpressurized", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "3" } } ], "condition": "$input.PressureInput.sensorData.pressure > 70" }, { "eventName": "Pressure Okay", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached - 1" } } ], "condition": "$input.PressureInput.sensorData.pressure <= 70" } ] }, "stateName": "Dangerous", "onEnter": { "events": [ { "eventName": "Pressure Threshold Breached", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:underPressureAction" } } ], "condition": "$variable.pressureThresholdBreached > 1" } ] }, "onExit": { "events": [ { "eventName": "Normal Pressure Restored", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:pressureClearedAction" } } ], "condition": "true" } ] } } ], "initialStateName": "Normal" } } } ``` Weitere Informationen finden Sie [DescribeDetectorModel](https://docs.aws.amazon.com/iotevents/latest/apireference/API_DescribeDetectorModel)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [DescribeDetectorModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/describe-detector-model.html)unter *AWS CLI Befehlsreferenz*. ### `describe-detector` Das folgende Codebeispiel zeigt die Verwendung`describe-detector`. **AWS CLI** **So rufen Sie Informationen zu einem Detektor (Instance) ab.** Im folgenden Beispiel für `describe-detector` werden Details zum angegebenen Detektor (Instance) angezeigt. ``` aws iotevents-data describe-detector \ --detector-model-name motorDetectorModel \ --key-value "Fulton-A32" ``` Ausgabe: ``` { "detector": { "lastUpdateTime": 1560797852.776, "creationTime": 1560797852.775, "state": { "variables": [ { "name": "pressureThresholdBreached", "value": "3" } ], "stateName": "Dangerous", "timers": [] }, "keyValue": "Fulton-A32", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" } } ``` Weitere Informationen finden Sie [DescribeDetector](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_DescribeDetector)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [DescribeDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/describe-detector.html)unter *AWS CLI Befehlsreferenz*. ### `describe-input` Das folgende Codebeispiel zeigt die Verwendung`describe-input`. **AWS CLI** **So rufen Sie Informationen zu einer Eingabe ab** Im folgenden Beispiel für `describe-input` werden Details für die festgelegte Eingabe angezeigt. ``` aws iotevents describe-input \ --input-name PressureInput ``` Ausgabe: ``` { "input": { "inputConfiguration": { "status": "ACTIVE", "inputArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "lastUpdateTime": 1560795312.542, "creationTime": 1560795312.542, "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor" }, "inputDefinition": { "attributes": [ { "jsonPath": "sensorData.pressure" }, { "jsonPath": "motorid" } ] } } } ``` Weitere Informationen finden Sie [DescribeInput](https://docs.aws.amazon.com/iotevents/latest/apireference/API_DescribeInput)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [DescribeInput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/describe-input.html)unter *AWS CLI Befehlsreferenz*. ### `describe-logging-options` Das folgende Codebeispiel zeigt die Verwendung`describe-logging-options`. **AWS CLI** **So rufen Sie Informationen zu den Protokollierungseinstellungen ab** Im folgenden `describe-logging-options` Beispiel werden die aktuellen Einstellungen der Protokollierungsoptionen für AWS IoT Events abgerufen. ``` aws iotevents describe-logging-options ``` Ausgabe: ``` { "loggingOptions": { "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "enabled": false, "level": "ERROR" } } ``` Weitere Informationen finden Sie [DescribeLoggingOptions](https://docs.aws.amazon.com/iotevents/latest/apireference/API_DescribeLoggingOptions)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [DescribeLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/describe-logging-options.html)unter *AWS CLI Befehlsreferenz*. ### `list-detector-model-versions` Das folgende Codebeispiel zeigt die Verwendung`list-detector-model-versions`. **AWS CLI** **So rufen Sie Informationen zu den Versionen eines Detektormodells ab** Im folgenden Beispiel für `list-detector-model-versions` werden alle Versionen eines Detektormodells aufgelistet. Es werden nur die Metadaten für die jeweilige Detektormodellversion zurückgegeben. ``` aws iotevents list-detector-model-versions \ --detector-model-name motorDetectorModel ``` Ausgabe: ``` { "detectorModelVersionSummaries": [ { "status": "ACTIVE", "lastUpdateTime": 1560796816.077, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "creationTime": 1560796816.077, "detectorModelArn": "arn:aws:iotevents:us-west-2:123456789012:detectorModel/motorDetectorModel", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" } ] } ``` Weitere Informationen finden Sie [ListDetectorModelVersions](https://docs.aws.amazon.com/iotevents/latest/apireference/API_ListDetectorModelVersions)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [ListDetectorModelVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/list-detector-model-versions.html)unter *AWS CLI Befehlsreferenz*. ### `list-detector-models` Das folgende Codebeispiel zeigt die Verwendung`list-detector-models`. **AWS CLI** **So rufen Sie eine Liste Ihrer Detektormodelle ab** Im folgenden Beispiel für `list-detector-models` werden die Detektormodelle aufgelistet, die Sie erstellt haben. Es werden nur die Metadaten für das jeweilige Detektormodell zurückgegeben. ``` aws iotevents list-detector-models ``` Ausgabe: ``` { "detectorModelSummaries": [ { "detectorModelName": "motorDetectorModel", "creationTime": 1552072424.212 "detectorModelDescription": "Detect overpressure in a motor." } ] } ``` Weitere Informationen finden Sie [ListDetectorModels](https://docs.aws.amazon.com/iotevents/latest/apireference/API_ListDetectorModels)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [ListDetectorModels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/list-detector-models.html)unter *AWS CLI Befehlsreferenz*. ### `list-detectors` Das folgende Codebeispiel zeigt die Verwendung`list-detectors`. **AWS CLI** **So rufen Sie eine Liste von Detektoren für ein Detektormodell ab** Im folgenden Beispiel für `list-detectors` werden die Detektoren (die Instances eines Detektormodells) in Ihrem Konto aufgelistet. ``` aws iotevents-data list-detectors \ --detector-model-name motorDetectorModel ``` Ausgabe: ``` { "detectorSummaries": [ { "lastUpdateTime": 1558129925.2, "creationTime": 1552073155.527, "state": { "stateName": "Normal" }, "keyValue": "Fulton-A32", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" } ] } ``` Weitere Informationen finden Sie [ListDetectors](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_ListDetectors)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [ListDetectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/list-detectors.html)unter *AWS CLI Befehlsreferenz*. ### `list-inputs` Das folgende Codebeispiel zeigt die Verwendung`list-inputs`. **AWS CLI** **So listen Sie Eingaben auf** Im folgenden Beispiel für `list-inputs` werden die Eingaben aufgelistet, die Sie in Ihrem Konto erstellt haben. ``` aws iotevents list-inputs ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { { "status": "ACTIVE", "inputArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "lastUpdateTime": 1551742986.768, "creationTime": 1551742986.768, "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor" } } ``` Weitere Informationen finden Sie [ListInputs](https://docs.aws.amazon.com/iotevents/latest/apireference/API_ListInputs)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [ListInputs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/list-inputs.html)unter *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags auf, die einer Ressource zugeordnet sind.** Im folgenden Beispiel für `list-tags-for-resource` werden die Tag-Schlüsselnamen und -Werte aufgelistet, die Sie der Ressource zugewiesen haben. ``` aws iotevents list-tags-for-resource \ --resource-arn "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput" ``` Ausgabe: ``` { "tags": [ { "value": "motor", "key": "deviceType" } ] } ``` Weitere Informationen finden Sie [ListTagsForResource](https://docs.aws.amazon.com/iotevents/latest/apireference/API_ListTagsForResource)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/list-tags-for-resource.html)unter *AWS CLI Befehlsreferenz*. ### `put-logging-options` Das folgende Codebeispiel zeigt die Verwendung`put-logging-options`. **AWS CLI** **So legen Sie Protokollierungsoptionen fest** Im folgenden `put-logging-options` Beispiel werden die Protokollierungsoptionen für AWS IoT Events festgelegt oder aktualisiert. Wenn Sie den Wert eines `loggingOptions` field, it can take up to one minute for the change to take effect. Also, if you change the policy attached to the role you specified in the ``roleArn`-Felds aktualisieren (z. B. um eine ungültige Richtlinie zu korrigieren), kann es bis zu fünf Minuten dauern, bis diese Änderung wirksam wird. ``` aws iotevents put-logging-options \ --cli-input-json file://logging-options.json ``` Inhalt von `logging-options.json`: ``` { "loggingOptions": { "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "level": "DEBUG", "enabled": true, "detectorDebugOptions": [ { "detectorModelName": "motorDetectorModel", "keyValue": "Fulton-A32" } ] } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [PutLoggingOptions](https://docs.aws.amazon.com/iotevents/latest/apireference/API_PutLoggingOptions)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [PutLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/put-logging-options.html)unter *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer Ressource Tags hinzu** Im folgenden Beispiel für `tag-resource` wird das Tag, das an die angegebene Ressource angehängt ist, hinzugefügt oder geändert (falls der Schlüssel `deviceType` bereits vorhanden ist). ``` aws iotevents tag-resource \ --cli-input-json file://pressureInput.tag.json ``` Inhalt von `pressureInput.tag.json`: ``` { "resourceArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "tags": [ { "key": "deviceType", "value": "motor" } ] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [TagResource](https://docs.aws.amazon.com/iotevents/latest/apireference/API_TagResource)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/tag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einer Ressource** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem angegebenen Schlüsselnamen aus der angegebenen Ressource entfernt. ``` aws iotevents untag-resource \ --resource-arn arn:aws:iotevents:us-west-2:123456789012:input/PressureInput \ --tagkeys deviceType ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [UntagResource](https://docs.aws.amazon.com/iotevents/latest/apireference/API_UntagResource)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/untag-resource.html)unter *AWS CLI Befehlsreferenz*. ### `update-detector-model` Das folgende Codebeispiel zeigt die Verwendung`update-detector-model`. **AWS CLI** **So aktualisieren Sie ein Detektormodell** Im folgenden Beispiel für `update-detector-model` wird das angegebene Detektormodell aktualisiert. Von der vorherigen Version erzeugte Detektoren (Instances) werden gelöscht und dann neu erstellt, sobald neue Eingaben eintreffen. ``` aws iotevents update-detector-model \ --cli-input-json file://motorDetectorModel.update.json ``` Inhalt von `motorDetectorModel.update.json`: ``` { "detectorModelName": "motorDetectorModel", "detectorModelDefinition": { "states": [ { "stateName": "Normal", "onEnter": { "events": [ { "eventName": "init", "condition": "true", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "0" } } ] } ] }, "onInput": { "transitionEvents": [ { "eventName": "Overpressurized", "condition": "$input.PressureInput.sensorData.pressure > 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached + 3" } } ], "nextState": "Dangerous" } ] } }, { "stateName": "Dangerous", "onEnter": { "events": [ { "eventName": "Pressure Threshold Breached", "condition": "$variable.pressureThresholdBreached > 1", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:underPressureAction" } } ] } ] }, "onInput": { "events": [ { "eventName": "Overpressurized", "condition": "$input.PressureInput.sensorData.pressure > 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "3" } } ] }, { "eventName": "Pressure Okay", "condition": "$input.PressureInput.sensorData.pressure <= 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached - 1" } } ] } ], "transitionEvents": [ { "eventName": "BackToNormal", "condition": "$input.PressureInput.sensorData.pressure <= 70 && $variable.pressureThresholdBreached <= 1", "nextState": "Normal" } ] }, "onExit": { "events": [ { "eventName": "Normal Pressure Restored", "condition": "true", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:pressureClearedAction" } } ] } ] } } ], "initialStateName": "Normal" }, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole" } ``` Ausgabe: ``` { "detectorModelConfiguration": { "status": "ACTIVATING", "lastUpdateTime": 1560799387.719, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "creationTime": 1560799387.719, "detectorModelArn": "arn:aws:iotevents:us-west-2:123456789012:detectorModel/motorDetectorModel", "key": "motorid", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "2" } } ``` Weitere Informationen finden Sie [UpdateDetectorModel](https://docs.aws.amazon.com/iotevents/latest/apireference/API_UpdateDetectorModel)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [UpdateDetectorModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/update-detector-model.html)unter *AWS CLI Befehlsreferenz*. ### `update-input` Das folgende Codebeispiel zeigt die Verwendung`update-input`. **AWS CLI** **So aktualisieren Sie eine Eingabe** Im folgenden Beispiel für `update-input` wird die angegebene Eingabe mit einer neuen Beschreibung und Definition aktualisiert. ``` aws iotevents update-input \ --cli-input-json file://pressureInput.json ``` Inhalt von `pressureInput.json`: ``` { "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor", "inputDefinition": { "attributes": [ { "jsonPath": "sensorData.pressure" }, { "jsonPath": "motorid" } ] } } ``` Ausgabe: ``` { "inputConfiguration": { "status": "ACTIVE", "inputArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "lastUpdateTime": 1560795976.458, "creationTime": 1560795312.542, "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor" } } ``` Weitere Informationen finden Sie [UpdateInput](https://docs.aws.amazon.com/iotevents/latest/apireference/API_UpdateInput)in der *Referenz zur AWS IoT Events API*. + Einzelheiten zur API finden Sie [UpdateInput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents/update-input.html)unter *AWS CLI Befehlsreferenz*. # AWS IoT Events-Data Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT Events-Data. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-put-message` Das folgende Codebeispiel zeigt, wie Sie`batch-put-message`. **AWS CLI** **Um Nachrichten (Eingaben) an AWS IoT Events zu senden** Das folgende `batch-put-message` Beispiel sendet eine Reihe von Nachrichten an das AWS IoT Events Events-System. Die Nutzdaten jeder Nachricht werden in die von Ihnen festgelegte Eingabe (`inputName`) transformiert und in allen Detektoren erfasst, die diese Eingabe überwachen. Wenn mehrere Nachrichten gesendet werden, kann die Reihenfolge, in der die Nachrichten verarbeitet werden, nicht garantiert werden. Um die Reihenfolge zu garantieren, müssen Sie Nachrichten nacheinander senden und auf eine erfolgreiche Antwort warten. ``` aws iotevents-data batch-put-message \ --cli-binary-format raw-in-base64-out \ --cli-input-json file://highPressureMessage.json ``` Inhalt von `highPressureMessage.json`: ``` { "messages": [ { "messageId": "00001", "inputName": "PressureInput", "payload": "{\"motorid\": \"Fulton-A32\", \"sensorData\": {\"pressure\": 80, \"temperature\": 39} }" } ] } ``` Ausgabe: ``` { "BatchPutMessageErrorEntries": [] } ``` Weitere Informationen finden Sie [BatchPutMessage](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-data-BatchPutMessage)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [BatchPutMessage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/batch-put-message.html)in der *AWS CLI Befehlsreferenz.* ### `batch-update-detector` Das folgende Codebeispiel zeigt die Verwendung`batch-update-detector`. **AWS CLI** **So aktualisieren Sie einen Detektor (Instance)** Im folgenden Beispiel für `batch-update-detector` werden der Zustand, die Variablenwerte und die Timer-Einstellungen eines oder mehrerer Detektoren (Instances) eines bestimmten Detektormodells aktualisiert. ``` aws iotevents-data batch-update-detector \ --cli-input-json file://budFulton-A32.json ``` Inhalt von `budFulton-A32.json`: ``` { "detectors": [ { "messageId": "00001", "detectorModelName": "motorDetectorModel", "keyValue": "Fulton-A32", "state": { "stateName": "Normal", "variables": [ { "name": "pressureThresholdBreached", "value": "0" } ], "timers": [ ] } } ] } ``` Ausgabe: ``` { "batchUpdateDetectorErrorEntries": [] } ``` Weitere Informationen finden Sie [BatchUpdateDetector](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-data-BatchUpdateDetector)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [BatchUpdateDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/batch-update-detector.html)in der *AWS CLI Befehlsreferenz.* ### `create-detector-model` Das folgende Codebeispiel zeigt die Verwendung`create-detector-model`. **AWS CLI** **So erstellen Sie ein Detektormodell** Im folgenden Beispiel für `create-detector-model` wird ein Detektormodell erstellt. ``` aws iotevents create-detector-model \ --cli-input-json file://motorDetectorModel.json ``` Inhalt von `motorDetectorModel.json`: ``` { "detectorModelName": "motorDetectorModel", "detectorModelDefinition": { "states": [ { "stateName": "Normal", "onEnter": { "events": [ { "eventName": "init", "condition": "true", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "0" } } ] } ] }, "onInput": { "transitionEvents": [ { "eventName": "Overpressurized", "condition": "$input.PressureInput.sensorData.pressure > 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached + 3" } } ], "nextState": "Dangerous" } ] } }, { "stateName": "Dangerous", "onEnter": { "events": [ { "eventName": "Pressure Threshold Breached", "condition": "$variable.pressureThresholdBreached > 1", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:underPressureAction" } } ] } ] }, "onInput": { "events": [ { "eventName": "Overpressurized", "condition": "$input.PressureInput.sensorData.pressure > 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "3" } } ] }, { "eventName": "Pressure Okay", "condition": "$input.PressureInput.sensorData.pressure <= 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached - 1" } } ] } ], "transitionEvents": [ { "eventName": "BackToNormal", "condition": "$input.PressureInput.sensorData.pressure <= 70 && $variable.pressureThresholdBreached <= 1", "nextState": "Normal" } ] }, "onExit": { "events": [ { "eventName": "Normal Pressure Restored", "condition": "true", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:pressureClearedAction" } } ] } ] } } ], "initialStateName": "Normal" }, "key": "motorid", "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole" } ``` Ausgabe: ``` { "detectorModelConfiguration": { "status": "ACTIVATING", "lastUpdateTime": 1560796816.077, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "creationTime": 1560796816.077, "detectorModelArn": "arn:aws:iotevents:us-west-2:123456789012:detectorModel/motorDetectorModel", "key": "motorid", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" } } ``` Weitere Informationen finden Sie [CreateDetectorModel](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-CreateDetectorModel)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [CreateDetectorModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/create-detector-model.html)in der *AWS CLI Befehlsreferenz.* ### `create-input` Das folgende Codebeispiel zeigt die Verwendung`create-input`. **AWS CLI** **So erstellen Sie eine Eingabe** Im folgenden Beispiel für `create-input` wird eine Eingabe erstellt. ``` aws iotevents create-input \ --cli-input-json file://pressureInput.json ``` Inhalt von `pressureInput.json`: ``` { "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor", "inputDefinition": { "attributes": [ { "jsonPath": "sensorData.pressure" }, { "jsonPath": "motorid" } ] } } ``` Ausgabe: ``` { "inputConfiguration": { "status": "ACTIVE", "inputArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "lastUpdateTime": 1560795312.542, "creationTime": 1560795312.542, "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor" } } ``` Weitere Informationen finden Sie [CreateInput](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-CreateInput)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [CreateInput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/create-input.html)in der *AWS CLI Befehlsreferenz.* ### `delete-detector-model` Das folgende Codebeispiel zeigt die Verwendung`delete-detector-model`. **AWS CLI** **So löschen Sie ein Detektormodell** Im folgenden Beispiel für `delete-detector-model` wird ein Detektormodell gelöscht. Alle aktiven Instances des Detektormodells werden ebenfalls gelöscht. ``` aws iotevents delete-detector-model \ --detector-model-name motorDetectorModel* ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [DeleteDetectorModel](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-DeleteDetectorModel)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [DeleteDetectorModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/delete-detector-model.html)in der *AWS CLI Befehlsreferenz.* ### `delete-input` Das folgende Codebeispiel zeigt die Verwendung`delete-input`. **AWS CLI** **Um eine Eingabe zu löschen** Im folgenden Beispiel für `delete-input` wird eine Eingabe gelöscht. ``` aws iotevents delete-input \ --input-name PressureInput ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [DeleteInput](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-DeleteInput)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [DeleteInput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/delete-input.html)in der *AWS CLI Befehlsreferenz.* ### `describe-detector-model` Das folgende Codebeispiel zeigt die Verwendung`describe-detector-model`. **AWS CLI** **So rufen Sie Informationen zu einem Detektormodell ab** Im folgenden Beispiel für `describe-detector-model` wird ein Detektormodell beschrieben. Wenn der Parameter `version` nicht festgelegt ist, gibt der Befehl Informationen über die neueste Version zurück. ``` aws iotevents describe-detector-model \ --detector-model-name motorDetectorModel ``` Ausgabe: ``` { "detectorModel": { "detectorModelConfiguration": { "status": "ACTIVE", "lastUpdateTime": 1560796816.077, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "creationTime": 1560796816.077, "detectorModelArn": "arn:aws:iotevents:us-west-2:123456789012:detectorModel/motorDetectorModel", "key": "motorid", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" }, "detectorModelDefinition": { "states": [ { "onInput": { "transitionEvents": [ { "eventName": "Overpressurized", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached + 3" } } ], "condition": "$input.PressureInput.sensorData.pressure > 70", "nextState": "Dangerous" } ], "events": [] }, "stateName": "Normal", "onEnter": { "events": [ { "eventName": "init", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "0" } } ], "condition": "true" } ] }, "onExit": { "events": [] } }, { "onInput": { "transitionEvents": [ { "eventName": "BackToNormal", "actions": [], "condition": "$input.PressureInput.sensorData.pressure <= 70 && $variable.pressureThresholdBreached <= 1", "nextState": "Normal" } ], "events": [ { "eventName": "Overpressurized", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "3" } } ], "condition": "$input.PressureInput.sensorData.pressure > 70" }, { "eventName": "Pressure Okay", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached - 1" } } ], "condition": "$input.PressureInput.sensorData.pressure <= 70" } ] }, "stateName": "Dangerous", "onEnter": { "events": [ { "eventName": "Pressure Threshold Breached", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:underPressureAction" } } ], "condition": "$variable.pressureThresholdBreached > 1" } ] }, "onExit": { "events": [ { "eventName": "Normal Pressure Restored", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:pressureClearedAction" } } ], "condition": "true" } ] } } ], "initialStateName": "Normal" } } } ``` Weitere Informationen finden Sie [DescribeDetectorModel](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-DescribeDetectorModel)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [DescribeDetectorModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/describe-detector-model.html)in der *AWS CLI Befehlsreferenz.* ### `describe-detector` Das folgende Codebeispiel zeigt die Verwendung`describe-detector`. **AWS CLI** **So rufen Sie Informationen zu einem Detektor (Instance) ab** Im folgenden Beispiel für `describe-detector` werden Informationen zum angegebenen Detektor (Instance) zurückgegeben. ``` aws iotevents-data describe-detector \ --detector-model-name motorDetectorModel \ --key-value "Fulton-A32" ``` Ausgabe: ``` { "detector": { "lastUpdateTime": 1560797852.776, "creationTime": 1560797852.775, "state": { "variables": [ { "name": "pressureThresholdBreached", "value": "3" } ], "stateName": "Dangerous", "timers": [] }, "keyValue": "Fulton-A32", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" } } ``` Weitere Informationen finden Sie [DescribeDetector](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-data-DescribeDetector)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [DescribeDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/describe-detector.html)in der *AWS CLI Befehlsreferenz.* ### `describe-input` Das folgende Codebeispiel zeigt die Verwendung`describe-input`. **AWS CLI** **So rufen Sie Informationen zu einer Eingabe ab** Im folgenden Beispiel für `describe-input` werden die Details einer Eingabe abgerufen. ``` aws iotevents describe-input \ --input-name PressureInput ``` Ausgabe: ``` { "input": { "inputConfiguration": { "status": "ACTIVE", "inputArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "lastUpdateTime": 1560795312.542, "creationTime": 1560795312.542, "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor" }, "inputDefinition": { "attributes": [ { "jsonPath": "sensorData.pressure" }, { "jsonPath": "motorid" } ] } } } ``` Weitere Informationen finden Sie [DescribeInput](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-DescribeInput)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [DescribeInput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/describe-input.html)in der *AWS CLI Befehlsreferenz.* ### `describe-logging-options` Das folgende Codebeispiel zeigt die Verwendung`describe-logging-options`. **AWS CLI** **So rufen Sie Informationen zu den Protokollierungseinstellungen ab** Im folgenden `describe-logging-options` Beispiel werden die aktuellen Protokollierungsoptionen für AWS IoT Events abgerufen. ``` aws iotevents describe-logging-options ``` Ausgabe: ``` { "loggingOptions": { "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "enabled": false, "level": "ERROR" } } ``` Weitere Informationen finden Sie [DescribeLoggingOptions](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-DescribeLoggingOptions)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [DescribeLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/describe-logging-options.html)in der *AWS CLI Befehlsreferenz.* ### `list-detector-model-versions` Das folgende Codebeispiel zeigt die Verwendung`list-detector-model-versions`. **AWS CLI** **So rufen Sie Informationen zu den Versionen eines Detektormodells ab** Im folgenden Beispiel für `list-detector-model-versions` werden alle Versionen eines Detektormodells aufgelistet. Es werden nur die Metadaten für die jeweilige Detektormodellversion zurückgegeben. ``` aws iotevents list-detector-model-versions \ --detector-model-name motorDetectorModel ``` Ausgabe: ``` { "detectorModelVersionSummaries": [ { "status": "ACTIVE", "lastUpdateTime": 1560796816.077, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "creationTime": 1560796816.077, "detectorModelArn": "arn:aws:iotevents:us-west-2:123456789012:detectorModel/motorDetectorModel", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" } ] } ``` Weitere Informationen finden Sie [ListDetectorModelVersions](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-ListDetectorModelVersions)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [ListDetectorModelVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/list-detector-model-versions.html)in der *AWS CLI Befehlsreferenz.* ### `list-detector-models` Das folgende Codebeispiel zeigt die Verwendung`list-detector-models`. **AWS CLI** **So rufen Sie eine Liste Ihrer Detektormodelle ab** Im folgenden Beispiel für `list-detector-models` werden die Detektormodelle aufgelistet, die Sie erstellt haben. Es werden nur die Metadaten für das jeweilige Detektormodell zurückgegeben. ``` aws iotevents list-detector-models ``` Ausgabe: ``` { "detectorModelSummaries": [ { "detectorModelName": "motorDetectorModel", "creationTime": 1552072424.212 "detectorModelDescription": "Detect overpressure in a motor." } ] } ``` Weitere Informationen finden Sie [ListDetectorModels](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-ListDetectorModels)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [ListDetectorModels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/list-detector-models.html)in der *AWS CLI Befehlsreferenz.* ### `list-detectors` Das folgende Codebeispiel zeigt die Verwendung`list-detectors`. **AWS CLI** **So rufen Sie eine Liste von Detektoren für ein Detektormodell ab** Im folgenden Beispiel für `list-detectors` werden Detektoren (die Instances eines Detektormodells) aufgelistet. ``` aws iotevents-data list-detectors \ --detector-model-name motorDetectorModel ``` Ausgabe: ``` { "detectorSummaries": [ { "lastUpdateTime": 1558129925.2, "creationTime": 1552073155.527, "state": { "stateName": "Normal" }, "keyValue": "Fulton-A32", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "1" } ] } ``` Weitere Informationen finden Sie [ListDetectors](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-ListDetectors)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [ListDetectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/list-detectors.html)in der *AWS CLI Befehlsreferenz.* ### `list-inputs` Das folgende Codebeispiel zeigt die Verwendung`list-inputs`. **AWS CLI** **So listen Sie Eingaben auf** Im folgenden Beispiel für `list-inputs` werden die Eingaben aufgelistet, die Sie erstellt haben. ``` aws iotevents list-inputs ``` Ausgabe: ``` { "status": "ACTIVE", "inputArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "lastUpdateTime": 1551742986.768, "creationTime": 1551742986.768, "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor" } ``` Weitere Informationen finden Sie [ListInputs](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-ListInputs)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [ListInputs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/list-inputs.html)in der *AWS CLI Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags auf, die einer Ressource zugeordnet sind** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags (Metadaten) aufgelistet, die Sie der Ressource zugewiesen haben. ``` aws iotevents list-tags-for-resource \ --resource-arn "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput" ``` Ausgabe: ``` { "tags": [ { "value": "motor", "key": "deviceType" } ] } ``` Weitere Informationen finden Sie [ListTagsForResource](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-ListTagsForResource)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `put-logging-options` Das folgende Codebeispiel zeigt die Verwendung`put-logging-options`. **AWS CLI** **So legen Sie Protokollierungsoptionen fest** Im folgenden `list-tags-for-resource` Beispiel werden die Protokollierungsoptionen für AWS IoT Events festgelegt oder aktualisiert. Wenn Sie den Wert eines `loggingOptions`-Felds aktualisieren, dauert es bis zu einer Minute, bis die Änderung wirksam wird. Außerdem gilt: Wenn Sie die an die Rolle angefügte Richtlinie ändern, die Sie im `roleArn`-Feld angegeben haben (z. B. zur Korrektur einer ungültigen Richtlinie), dauert es bis zu fünf Minuten, bis die Änderung wirksam wird. ``` aws iotevents put-logging-options \ --cli-input-json file://logging-options.json ``` Inhalt von `logging-options.json`: ``` { "loggingOptions": { "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "level": "DEBUG", "enabled": true, "detectorDebugOptions": [ { "detectorModelName": "motorDetectorModel", "keyValue": "Fulton-A32" } ] } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [PutLoggingOptions](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-PutLoggingOptions)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [PutLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/put-logging-options.html)in der *AWS CLI Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer Ressource Tags hinzu** Im folgenden Beispiel für `tag-resource` werden die Tags zur angegebenen Ressource hinzugefügt oder geändert. Tags sind Metadaten, die Sie zum Verwalten einer Ressource verwenden können. ``` aws iotevents tag-resource \ --cli-input-json file://pressureInput.tag.json ``` Inhalt von `pressureInput.tag.json`: ``` { "resourceArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "tags": [ { "key": "deviceType", "value": "motor" } ] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [TagResource](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-TagResource)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einer Ressource** Im folgenden Beispiel für `untag-resource` werden die angegebenen Tags aus der Ressource entfernt. ``` aws iotevents untag-resource \ --cli-input-json file://pressureInput.untag.json ``` Inhalt von `pressureInput.untag.json`: ``` { "resourceArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "tagKeys": [ "deviceType" ] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [UntagResource](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-UntagResource)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-detector-model` Das folgende Codebeispiel zeigt die Verwendung`update-detector-model`. **AWS CLI** **So aktualisieren Sie ein Detektormodell** Im folgenden Beispiel für `update-detector-model` wird ein Detektormodell aktualisiert. Von der vorherigen Version erzeugte Detektoren (Instances) werden gelöscht und dann neu erstellt, sobald neue Eingaben eintreffen. ``` aws iotevents update-detector-model \ --cli-input-json file://motorDetectorModel.update.json ``` Inhalt von motorDetectorModel .update.json: ``` { "detectorModelName": "motorDetectorModel", "detectorModelDefinition": { "states": [ { "stateName": "Normal", "onEnter": { "events": [ { "eventName": "init", "condition": "true", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "0" } } ] } ] }, "onInput": { "transitionEvents": [ { "eventName": "Overpressurized", "condition": "$input.PressureInput.sensorData.pressure > 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached + 3" } } ], "nextState": "Dangerous" } ] } }, { "stateName": "Dangerous", "onEnter": { "events": [ { "eventName": "Pressure Threshold Breached", "condition": "$variable.pressureThresholdBreached > 1", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:underPressureAction" } } ] } ] }, "onInput": { "events": [ { "eventName": "Overpressurized", "condition": "$input.PressureInput.sensorData.pressure > 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "3" } } ] }, { "eventName": "Pressure Okay", "condition": "$input.PressureInput.sensorData.pressure <= 70", "actions": [ { "setVariable": { "variableName": "pressureThresholdBreached", "value": "$variable.pressureThresholdBreached - 1" } } ] } ], "transitionEvents": [ { "eventName": "BackToNormal", "condition": "$input.PressureInput.sensorData.pressure <= 70 && $variable.pressureThresholdBreached <= 1", "nextState": "Normal" } ] }, "onExit": { "events": [ { "eventName": "Normal Pressure Restored", "condition": "true", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:pressureClearedAction" } } ] } ] } } ], "initialStateName": "Normal" }, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole" } ``` Ausgabe: ``` { "detectorModelConfiguration": { "status": "ACTIVATING", "lastUpdateTime": 1560799387.719, "roleArn": "arn:aws:iam::123456789012:role/IoTEventsRole", "creationTime": 1560799387.719, "detectorModelArn": "arn:aws:iotevents:us-west-2:123456789012:detectorModel/motorDetectorModel", "key": "motorid", "detectorModelName": "motorDetectorModel", "detectorModelVersion": "2" } } ``` Weitere Informationen finden Sie [UpdateDetectorModel](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-UpdateDetectorModel)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [UpdateDetectorModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/update-detector-model.html)in der *AWS CLI Befehlsreferenz.* ### `update-input` Das folgende Codebeispiel zeigt die Verwendung`update-input`. **AWS CLI** **So aktualisieren Sie eine Eingabe** Im folgenden Beispiel für `update-input` wird eine Eingabe aktualisiert. ``` aws iotevents update-input \ --cli-input-json file://pressureInput.json ``` Inhalt von `pressureInput.json`: ``` { "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor", "inputDefinition": { "attributes": [ { "jsonPath": "sensorData.pressure" }, { "jsonPath": "motorid" } ] } } ``` Ausgabe: ``` { "inputConfiguration": { "status": "ACTIVE", "inputArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput", "lastUpdateTime": 1560795976.458, "creationTime": 1560795312.542, "inputName": "PressureInput", "inputDescription": "Pressure readings from a motor" } } ``` Weitere Informationen finden Sie [UpdateInput](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-commands.html#api-iotevents-UpdateInput)im *AWS IoT Events Developer Guide\$1*. + Einzelheiten zur API finden Sie [UpdateInput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotevents-data/update-input.html)in der *AWS CLI Befehlsreferenz.* # AWS IoT Greengrass Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT Greengrass. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-role-to-group` Das folgende Codebeispiel zeigt, wie Sie`associate-role-to-group`. **AWS CLI** **So verknüpfen Sie eine Rolle mit Ihrer Greengrass-Gruppe** Im folgenden Beispiel für `associate-role-to-group` wird die angegebene IAM-Rolle mit einer Greengrass-Gruppe verknüpft. Die Gruppenrolle wird von lokalen Lambda-Funktionen und Konnektoren für den Zugriff auf AWS Dienste verwendet. Beispielsweise kann Ihre Gruppenrolle die für die CloudWatch Logs-Integration erforderlichen Berechtigungen gewähren. ``` aws greengrass associate-role-to-group \ --group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b \ --role-arn arn:aws:iam::123456789012:role/GG-Group-Role ``` Ausgabe: ``` { "AssociatedAt": "2019-09-10T20:03:30Z" } ``` Weitere Informationen finden Sie unter [Konfigurieren der Gruppenrolle](https://docs.aws.amazon.com/greengrass/latest/developerguide/config-iam-roles.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [AssociateRoleToGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/associate-role-to-group.html)in der *AWS CLI Befehlsreferenz*. ### `associate-service-role-to-account` Das folgende Codebeispiel zeigt die Verwendung`associate-service-role-to-account`. **AWS CLI** **Um Ihrem AWS Konto eine Servicerolle zuzuordnen** Im folgenden `associate-service-role-to-account` Beispiel wird eine IAM-Dienstrolle, die durch ihren ARN angegeben wird, AWS IoT Greengrass in Ihrem AWS Konto zugeordnet. Sie müssen die Servicerolle zuvor in IAM erstellt haben und ihr ein Richtliniendokument zuordnen, das es AWS IoT Greengrass ermöglicht, diese Rolle zu übernehmen. ``` aws greengrass associate-service-role-to-account \ --role-arn "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole" ``` Ausgabe: ``` { "AssociatedAt": "2019-06-25T18:12:45Z" } ``` Weitere Informationen finden Sie unter [Greengrass-Servicerolle](https://docs.aws.amazon.com/greengrass/latest/developerguide/service-role.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [AssociateServiceRoleToAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/associate-service-role-to-account.html)in der *AWS CLI Befehlsreferenz*. ### `create-connector-definition-version` Das folgende Codebeispiel zeigt die Verwendung`create-connector-definition-version`. **AWS CLI** **So erstellen Sie eine Konnektordefinitionsversion** Im folgenden Beispiel für `create-connector-definition-version` wird eine Konnektordefinitionsversion erstellt und mit der angegebenen Konnektordefinition verknüpft. Alle Konnektoren in einer Version definieren Werte für ihre Parameter. ``` aws greengrass create-connector-definition-version \ --connector-definition-id "55d0052b-0d7d-44d6-b56f-21867215e118" \ --connectors "[{\"Id\": \"MyTwilioNotificationsConnector\", \"ConnectorArn\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/2\", \"Parameters\": {\"TWILIO_ACCOUNT_SID\": \"AC1a8d4204890840d7fc482aab38090d57\", \"TwilioAuthTokenSecretArn\": \"arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-TwilioAuthToken-ntSlp6\", \"TwilioAuthTokenSecretArn-ResourceId\": \"TwilioAuthToken\", \"DefaultFromPhoneNumber\": \"4254492999\"}}]" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/55d0052b-0d7d-44d6-b56f-21867215e118/versions/33f709a0-c825-49cb-9eea-dc8964fbd635", "CreationTimestamp": "2019-06-24T20:46:30.134Z", "Id": "55d0052b-0d7d-44d6-b56f-21867215e118", "Version": "33f709a0-c825-49cb-9eea-dc8964fbd635" } ``` + Einzelheiten zur API finden Sie [CreateConnectorDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-connector-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-connector-definition` Das folgende Codebeispiel zeigt die Verwendung`create-connector-definition`. **AWS CLI** **So erstellen Sie eine Konnektordefinition** Im folgenden Beispiel für `create-connector-definition` wird eine Konnektordefinition und eine erste Konnektordefinitionsversion erstellt. Die erste Version enthält einen Konnektor. Alle Konnektoren in einer Version definieren Werte für ihre Parameter. ``` aws greengrass create-connector-definition \ --name MySNSConnector \ --initial-version "{\"Connectors\": [{\"Id\":\"MySNSConnector\",\"ConnectorArn\":\"arn:aws:greengrass:us-west-2::/connectors/SNS/versions/1\",\"Parameters\": {\"DefaultSNSArn\":\"arn:aws:sns:us-west-2:123456789012:GGConnectorTopic\"}}]}" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "LastUpdatedTimestamp": "2019-06-19T19:30:01.300Z", "LatestVersion": "63c57963-c7c2-4a26-a7e2-7bf478ea2623", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "Name": "MySNSConnector" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Greengrass-Konnektoren (CLI)](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors-cli.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie [CreateConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-connector-definition.html)in der *AWS CLI Befehlsreferenz*. ### `create-core-definition-version` Das folgende Codebeispiel zeigt die Verwendung`create-core-definition-version`. **AWS CLI** **So erstellen Sie eine Kern-Definitionsversion** Im folgenden Beispiel für `create-core-definition-version` wird eine Kern-Definitionsversion erstellt und mit der angegebenen Kerndefinition verknüpft. Die Version kann nur einen Kern enthalten. Bevor Sie einen Core erstellen können, müssen Sie zunächst das entsprechende AWS IoT-Ding erstellen und bereitstellen. Dieser Prozess umfasst die folgenden `iot`-Befehle, die `ThingArn` und `CertificateArn` zurückgeben, die für den Befehl `create-core-definition-version` erforderlich sind. Erstellen Sie das AWS IoT-Ding, das dem Kerngerät entspricht: ``` aws iot create-thing \ --thing-name "MyCoreDevice" ``` Ausgabe: ``` { "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice", "thingName": "MyCoreDevice", "thingId": "cb419a19-9099-4515-9cec-e9b0e760608a" } ``` Erstellen Sie öffentliche sowie private Schlüssel und das Zertifikat des Kerngeräts für das Objekt. In diesem Beispiel wird der Befehl `create-keys-and-certificate` verwendet und es sind Schreibberechtigungen für das aktuelle Verzeichnis erforderlich. Sie können aber auch den Befehl `create-certificate-from-csr` verwenden. ``` aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile "myCore.cert.pem" \ --public-key-outfile "myCore.public.key" \ --private-key-outfile "myCore.private.key" ``` Ausgabe: ``` { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n" }, "certificateId": "123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz" } ``` Erstellen Sie eine AWS IoT-Richtlinie, die erlaubt `iot` und `greengrass` Maßnahmen ergreift. Der Einfachheit halber erlaubt die folgende Richtlinie Aktionen für alle Ressourcen, Ihre Richtlinie sollte jedoch restriktiver sein. ``` aws iot create-policy \ --policy-name "Core_Devices" \ --policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}" ``` Ausgabe: ``` { "policyName": "Core_Devices", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/Core_Devices", "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}", "policyVersionId": "1" } ``` Fügen Sie die Richtlinie dem Zertifikat an: ``` aws iot attach-policy \ --policy-name "Core_Devices" \ --target "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Fügen Sie das Objekt dem Zertifikat an: ``` aws iot attach-thing-principal \ --thing-name "MyCoreDevice" \ --principal "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Erstellen Sie die Kern-Definitionsversion: ``` aws greengrass create-core-definition-version \ --core-definition-id "582efe12-b05a-409e-9a24-a2ba1bcc4a12" \ --cores "[{\"Id\":\"MyCoreDevice\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz\",\"SyncShadow\":true}]" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/582efe12-b05a-409e-9a24-a2ba1bcc4a12/versions/3fdc1190-2ce5-44de-b98b-eec8f9571014", "Version": "3fdc1190-2ce5-44de-b98b-eec8f9571014", "CreationTimestamp": "2019-09-18T00:15:09.838Z", "Id": "582efe12-b05a-409e-9a24-a2ba1bcc4a12" } ``` Weitere Informationen finden [Sie unter Configure the AWS IoT Greengrass Core](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-core.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateCoreDefinitionVersion AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-core-definition-version.html)*Befehlsreferenz*. ### `create-core-definition` Das folgende Codebeispiel zeigt die Verwendung`create-core-definition`. **AWS CLI** **Beispiel 1: So erstellen Sie eine leere Kerndefinition** Im folgenden Beispiel für `create-core-definition` wird eine leere Greengrass-Kerndefinition (keine erste Version) erstellt. Bevor der Kern verwendet werden kann, müssen Sie den Befehl `create-core-definition-version` verwenden, um die anderen Parameter für den Kern bereitzustellen. ``` aws greengrass create-core-definition \ --name cliGroup_Core ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/b5c08008-54cb-44bd-9eec-c121b04283b5", "CreationTimestamp": "2019-06-25T18:23:22.106Z", "Id": "b5c08008-54cb-44bd-9eec-c121b04283b5", "LastUpdatedTimestamp": "2019-06-25T18:23:22.106Z", "Name": "cliGroup_Core" } ``` **Beispiel 2: So erstellen Sie eine Kerndefinition mit einer ersten Version** Im folgenden Beispiel für `create-core-definition` wird eine Kerndefinition erstellt, die eine erste Kern-Definitionsversion enthält. Die Version kann nur einen Kern enthalten. Bevor Sie einen Core erstellen können, müssen Sie zunächst das entsprechende AWS IoT-Ding erstellen und bereitstellen. Dieser Prozess umfasst die folgenden `iot`-Befehle, die `ThingArn` und `CertificateArn` zurückgeben, die für den Befehl `create-core-definition` erforderlich sind. Erstellen Sie das AWS IoT-Ding, das dem Kerngerät entspricht: ``` aws iot create-thing \ --thing-name "MyCoreDevice" ``` Ausgabe: ``` { "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice", "thingName": "MyCoreDevice", "thingId": "cb419a19-9099-4515-9cec-e9b0e760608a" } ``` Erstellen Sie öffentliche sowie private Schlüssel und das Zertifikat des Kerngeräts für das Objekt. In diesem Beispiel wird der Befehl `create-keys-and-certificate` verwendet und es sind Schreibberechtigungen für das aktuelle Verzeichnis erforderlich. Sie können aber auch den Befehl `create-certificate-from-csr` verwenden. ``` aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile "myCore.cert.pem" \ --public-key-outfile "myCore.public.key" \ --private-key-outfile "myCore.private.key" ``` Ausgabe: ``` { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n" }, "certificateId": "123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz" } ``` Erstellen Sie eine AWS IoT-Richtlinie, die erlaubt `iot` und `greengrass` Maßnahmen ergreift. Der Einfachheit halber erlaubt die folgende Richtlinie Aktionen für alle Ressourcen, Ihre Richtlinie sollte jedoch restriktiver sein. ``` aws iot create-policy \ --policy-name "Core_Devices" \ --policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}" ``` Ausgabe: ``` { "policyName": "Core_Devices", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/Core_Devices", "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}", "policyVersionId": "1" } ``` Fügen Sie die Richtlinie dem Zertifikat an: ``` aws iot attach-policy \ --policy-name "Core_Devices" \ --target "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Fügen Sie das Objekt dem Zertifikat an: ``` aws iot attach-thing-principal \ --thing-name "MyCoreDevice" \ --principal "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Erstellen Sie die Kerndefinition: ``` aws greengrass create-core-definition \ --name "MyCores" \ --initial-version "{\"Cores\":[{\"Id\":\"MyCoreDevice\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz\",\"SyncShadow\":true}]}" ``` Ausgabe: ``` { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/582efe12-b05a-409e-9a24-a2ba1bcc4a12/versions/cc87b5b3-8f4b-465d-944c-1d6de5dbfcdb", "Name": "MyCores", "LastUpdatedTimestamp": "2019-09-18T00:11:06.197Z", "LatestVersion": "cc87b5b3-8f4b-465d-944c-1d6de5dbfcdb", "CreationTimestamp": "2019-09-18T00:11:06.197Z", "Id": "582efe12-b05a-409e-9a24-a2ba1bcc4a12", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/582efe12-b05a-409e-9a24-a2ba1bcc4a12" } ``` Weitere Informationen finden [Sie unter Configure the AWS IoT Greengrass Core](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-core.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateCoreDefinition AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-core-definition.html)*Befehlsreferenz*. ### `create-deployment` Das folgende Codebeispiel zeigt die Verwendung`create-deployment`. **AWS CLI** **So erstellen Sie eine Bereitstellung für eine Version einer Greengrass-Gruppe** Im folgenden Beispiel für `create-deployment` wird die angegebene Version einer Greengrass-Gruppe bereitgestellt. ``` aws greengrass create-deployment \ --deployment-type NewDeployment \ --group-id "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca" \ --group-version-id "dc40c1e9-e8c8-4d28-a84d-a9cad5f599c9" ``` Ausgabe: ``` { "DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca/deployments/bfceb608-4e97-45bc-af5c-460144270308", "DeploymentId": "bfceb608-4e97-45bc-af5c-460144270308" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Konnektoren (CLI)](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors-cli.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `create-device-definition-version` Das folgende Codebeispiel zeigt die Verwendung`create-device-definition-version`. **AWS CLI** **So erstellen Sie eine Geräte-Definitionsversion** Im folgenden Beispiel für `create-device-definition-version` wird eine Geräte-Definitionsversion erstellt und mit der angegebenen Gerätedefinition verknüpft. Die Version definiert zwei Geräte. Bevor Sie ein Greengrass-Gerät erstellen können, müssen Sie zunächst das entsprechende AWS IoT-Ding erstellen und bereitstellen. Dieser Prozess umfasst die folgenden `iot`-Befehle, die Sie ausführen müssen, um die erforderlichen Informationen für den Greengrass-Befehl abzurufen: Erstellen Sie das AWS IoT-Ding, das dem Gerät entspricht: ``` aws iot create-thing \ --thing-name "InteriorTherm" ``` Ausgabe: ``` { "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm", "thingName": "InteriorTherm", "thingId": "01d4763c-78a6-46c6-92be-7add080394bf" } ``` Erstellen Sie öffentliche sowie private Schlüssel und das Zertifikat des Geräts für das Objekt. In diesem Beispiel wird der Befehl `create-keys-and-certificate` verwendet und es sind Schreibberechtigungen für das aktuelle Verzeichnis erforderlich. Sie können aber auch den Befehl `create-certificate-from-csr` verwenden: ``` aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile "myDevice.cert.pem" \ --public-key-outfile "myDevice.public.key" \ --private-key-outfile "myDevice.private.key" ``` Ausgabe: ``` { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n" }, "certificateId": "66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92" } ``` Erstellen Sie eine AWS IoT-Richtlinie, die erlaubt `iot` und `greengrass` Maßnahmen ergreift. Der Einfachheit halber erlaubt die folgende Richtlinie Aktionen für alle Ressourcen, Ihre Richtlinie kann jedoch restriktiver sein: ``` aws iot create-policy \ --policy-name "GG_Devices" \ --policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}" ``` Ausgabe: ``` { "policyName": "GG_Devices", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/GG_Devices", "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}", "policyVersionId": "1" } ``` Fügen Sie die Richtlinie dem Zertifikat an: ``` aws iot attach-policy \ --policy-name "GG_Devices" \ --target "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92" ``` Fügen Sie das Objekt dem Zertifikat an: ``` aws iot attach-thing-principal \ --thing-name "InteriorTherm" \ --principal "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92" ``` Nachdem Sie das IoT-Objekt wie oben gezeigt erstellt und konfiguriert haben, verwenden Sie `ThingArn` und `CertificateArn` aus den ersten beiden Befehlen im folgenden Beispiel. ``` aws greengrass create-device-definition-version \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \ --devices "[{\"Id\":\"InteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92\",\"SyncShadow\":true},{\"Id\":\"ExteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/ExteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/6c52ce1b47bde88a637e9ccdd45fe4e4c2c0a75a6866f8f63d980ee22fa51e02\",\"SyncShadow\":true}]" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71", "Version": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:15:09.838Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd" } ``` + Einzelheiten zur API finden Sie [CreateDeviceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-device-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-device-definition` Das folgende Codebeispiel zeigt die Verwendung`create-device-definition`. **AWS CLI** **So erstellen Sie eine Gerätedefinition** Im folgenden Beispiel für `create-device-definition` wird eine Gerätedefinition erstellt, die eine erste Geräte-Definitionsversion enthält. Die erste Version definiert zwei Geräte. Bevor Sie ein Greengrass-Gerät erstellen können, müssen Sie zunächst das entsprechende AWS IoT-Ding erstellen und bereitstellen. Dieser Prozess umfasst die folgenden `iot`-Befehle, die Sie ausführen müssen, um die erforderlichen Informationen für den Greengrass-Befehl abzurufen: Erstellen Sie das AWS IoT-Ding, das dem Gerät entspricht: ``` aws iot create-thing \ --thing-name "InteriorTherm" ``` Ausgabe: ``` { "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm", "thingName": "InteriorTherm", "thingId": "01d4763c-78a6-46c6-92be-7add080394bf" } ``` Erstellen Sie öffentliche sowie private Schlüssel und das Zertifikat des Geräts für das Objekt. In diesem Beispiel wird der Befehl `create-keys-and-certificate` verwendet und es sind Schreibberechtigungen für das aktuelle Verzeichnis erforderlich. Sie können aber auch den Befehl `create-certificate-from-csr` verwenden: ``` aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile "myDevice.cert.pem" \ --public-key-outfile "myDevice.public.key" \ --private-key-outfile "myDevice.private.key" ``` Ausgabe: ``` { "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n" }, "certificateId": "66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92" } ``` Erstellen Sie eine AWS IoT-Richtlinie, die erlaubt `iot` und `greengrass` Maßnahmen ergreift. Der Einfachheit halber erlaubt die folgende Richtlinie Aktionen für alle Ressourcen, Ihre Richtlinie kann jedoch restriktiver sein: ``` aws iot create-policy \ --policy-name "GG_Devices" \ --policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}" ``` Ausgabe: ``` { "policyName": "GG_Devices", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/GG_Devices", "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}", "policyVersionId": "1" } ``` Fügen Sie die Richtlinie dem Zertifikat an: ``` aws iot attach-policy \ --policy-name "GG_Devices" \ --target "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92" ``` Fügen Sie das Objekt dem Zertifikat an: ``` aws iot attach-thing-principal \ --thing-name "InteriorTherm" \ --principal "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92" ``` Nachdem Sie das IoT-Objekt wie oben gezeigt erstellt und konfiguriert haben, verwenden Sie `ThingArn` und `CertificateArn` aus den ersten beiden Befehlen im folgenden Beispiel. ``` aws greengrass create-device-definition \ --name "Sensors" \ --initial-version "{\"Devices\":[{\"Id\":\"InteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92\",\"SyncShadow\":true},{\"Id\":\"ExteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/ExteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/6c52ce1b47bde88a637e9ccdd45fe4e4c2c0a75a6866f8f63d980ee22fa51e02\",\"SyncShadow\":true}]}" ``` Ausgabe: ``` { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/3b5cc510-58c1-44b5-9d98-4ad858ffa795", "Name": "Sensors", "LastUpdatedTimestamp": "2019-09-11T00:11:06.197Z", "LatestVersion": "3b5cc510-58c1-44b5-9d98-4ad858ffa795", "CreationTimestamp": "2019-09-11T00:11:06.197Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd" } ``` + Einzelheiten zur API finden Sie [CreateDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-device-definition.html)in der *AWS CLI Befehlsreferenz*. ### `create-function-definition-version` Das folgende Codebeispiel zeigt die Verwendung`create-function-definition-version`. **AWS CLI** **So erstellen Sie eine Version der Funktionsdefinition** Im folgenden Beispiel für `create-function-definition-version` wird eine neue Version der angegebenen Funktionsdefinition erstellt. Diese Version gibt eine einzelne Funktion mit der ID `Hello-World-function` an, erlaubt den Zugriff auf das Dateisystem und definiert eine maximale Speichergröße sowie einen Timeout-Zeitraum. ``` aws greengrass create-function-definition-version \ --cli-input-json "{\"FunctionDefinitionId\": \"e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3\",\"Functions\": [{\"Id\": \"Hello-World-function\", \"FunctionArn\": \""arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld_Counter:gghw-alias"\",\"FunctionConfiguration\": {\"Environment\": {\"AccessSysfs\": true},\"Executable\": \"greengrassHelloWorldCounter.function_handler\",\"MemorySize\": 16000,\"Pinned\": false,\"Timeout\": 25}}]}" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3/versions/74abd1cc-637e-4abe-8684-9a67890f4043", "CreationTimestamp": "2019-06-25T22:03:43.376Z", "Id": "e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3", "Version": "74abd1cc-637e-4abe-8684-9a67890f4043" } ``` + Einzelheiten zur API finden Sie [CreateFunctionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-function-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-function-definition` Das folgende Codebeispiel zeigt die Verwendung`create-function-definition`. **AWS CLI** **So erstellen Sie eine Lambda-Funktionsdefinition** Im folgenden Beispiel für `create-function-definition` werden eine Lambda-Funktionsdefinition und eine erste Version erstellt, indem eine Liste von Lambda-Funktionen (in diesem Fall eine Liste mit nur einer Funktion namens `TempMonitorFunction`) und deren Konfigurationen bereitstellt werden. Bevor Sie die Funktionsdefinition erstellen können, benötigen Sie den ARN der Lambda-Funktion. Verwenden Sie die Lambda-Befehle `create-function` und `publish-version`, um die Funktion und ihren Alias zu erstellen. Der `create-function` Befehl von Lambda erfordert den ARN der Ausführungsrolle, obwohl AWS IoT Greengrass diese Rolle nicht verwendet, da die Berechtigungen in der Greengrass-Gruppenrolle angegeben sind. Mit dem IAM-Befehl `create-role` können Sie eine leere Rolle erstellen und so einen ARN erhalten, der mit dem Lambda-Befehl `create-function` verwendet werden kann. Alternativ können Sie eine vorhandene Ausführungsrolle verwenden. ``` aws greengrass create-function-definition \ --name MyGreengrassFunctions \ --initial-version "{\"Functions\": [{\"Id\": \"TempMonitorFunction\", \"FunctionArn\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\", \"FunctionConfiguration\": {\"Executable\": \"temp_monitor.function_handler\", \"MemorySize\": 16000,\"Timeout\": 5}}]}" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/3b0d0080-87e7-48c6-b182-503ec743a08b", "CreationTimestamp": "2019-06-19T22:24:44.585Z", "Id": "3b0d0080-87e7-48c6-b182-503ec743a08b", "LastUpdatedTimestamp": "2019-06-19T22:24:44.585Z", "LatestVersion": "67f918b9-efb4-40b0-b87c-de8c9faf085b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/3b0d0080-87e7-48c6-b182-503ec743a08b/versions/67f918b9-efb4-40b0-b87c-de8c9faf085b", "Name": "MyGreengrassFunctions" } ``` Weitere Informationen finden Sie unter [How to Configure Local Resource Access Using the AWS Command Line Interface](https://docs.aws.amazon.com/greengrass/latest/developerguide/lra-cli.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateFunctionDefinition AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-function-definition.html)*Befehlsreferenz.* ### `create-group-certificate-authority` Das folgende Codebeispiel zeigt die Verwendung`create-group-certificate-authority`. **AWS CLI** **So erstellen Sie eine Zertifizierungsstelle (CA) für eine Gruppe** Im folgenden Beispiel für `create-group-certificate-authority` wird eine CA für die angegebene Gruppe erstellt oder rotiert. ``` aws greengrass create-group-certificate-authority \ --group-id "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1" ``` Ausgabe: ``` { "GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/8eaadd72-ce4b-4f15-892a-0cc4f3a343f1/certificateauthorities/d31630d674c4437f6c5dbc0dca56312a902171ce2d086c38e509c8EXAMPLEcc5" } ``` Weitere Informationen finden Sie unter [Sicherheit in AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-sec.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [CreateGroupCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-group-certificate-authority.html)in der *AWS CLI Befehlsreferenz*. ### `create-group-version` Das folgende Codebeispiel zeigt die Verwendung`create-group-version`. **AWS CLI** **So erstellen Sie eine Version einer Greengrass-Gruppe** Im folgenden Beispiel für `create-group-version` wird eine Gruppenversion erstellt und mit der angegebenen Gruppe verknüpft. Die Version verweist auf die Kern-, Ressourcen-, Konnektor-, Funktions- und Abonnementversionen, die die in diese Gruppenversion aufzunehmenden Entitäten enthalten. Sie müssen diese Entitäten erstellen, bevor Sie die Gruppenversion erstellen können. Verwenden Sie den Befehl `create-resource-definition`, um eine Ressourcendefinition mit einer ersten Version zu erstellen. Verwenden Sie den Befehl `create-connector-definition`, um eine Konnektordefinition mit einer ersten Version zu erstellen. Verwenden Sie den Befehl `create-function-definition`, um eine Funktionsdefinition mit einer ersten Version zu erstellen. Verwenden Sie den Befehl `create-subscription-definition`, um eine Abonnementdefinition mit einer ersten Version zu erstellen. Verwenden Sie den Befehl `get-group-version` und geben Sie die ID der neuesten Gruppenversion an, um den ARN der neuesten Kern-Definitionsversion abzurufen. ``` aws greengrass create-group-version \ --group-id "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca" \ --core-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/6a630442-8708-4838-ad36-eb98849d975e/versions/6c87151b-1fb4-4cb2-8b31-6ee715d8f8ba" \ --resource-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1" \ --connector-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/55d0052b-0d7d-44d6-b56f-21867215e118/versions/78a3331b-895d-489b-8823-17b4f9f418a0" \ --function-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/3b0d0080-87e7-48c6-b182-503ec743a08b/versions/67f918b9-efb4-40b0-b87c-de8c9faf085b" \ --subscription-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112/versions/aa645c47-ac90-420d-9091-8c7ffa4f103f" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca/versions/e10b0459-4345-4a09-88a4-1af1f5d34638", "CreationTimestamp": "2019-06-20T18:42:47.020Z", "Id": "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca", "Version": "e10b0459-4345-4a09-88a4-1af1f5d34638" } ``` Weitere Informationen finden Sie unter [Überblick über das AWS IoT Greengrass Group Object Model](https://docs.aws.amazon.com/greengrass/latest/developerguide/deployments.html#api-overview) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateGroupVersion AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-group-version.html)*Befehlsreferenz*. ### `create-group` Das folgende Codebeispiel zeigt die Verwendung`create-group`. **AWS CLI** **So erstellen Sie eine Greengrass-Gruppe** Im folgenden Beispiel für `create-group` wird eine Gruppe namens `cli-created-group` erstellt. ``` aws greengrass create-group \ --name cli-created-group ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/4e22bd92-898c-436b-ade5-434d883ff749", "CreationTimestamp": "2019-06-25T18:07:17.688Z", "Id": "4e22bd92-898c-436b-ade5-434d883ff749", "LastUpdatedTimestamp": "2019-06-25T18:07:17.688Z", "Name": "cli-created-group" } ``` Weitere Informationen finden Sie unter [Überblick über das AWS IoT Greengrass Group Object Model](https://docs.aws.amazon.com/greengrass/latest/developerguide/deployments.html#api-overview) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-group.html)*Befehlsreferenz*. ### `create-logger-definition-version` Das folgende Codebeispiel zeigt die Verwendung`create-logger-definition-version`. **AWS CLI** **So erstellen Sie eine Logger-Definitionsversion** Im folgenden Beispiel für `create-logger-definition-version` wird eine Logger-Definitionsversion erstellt und mit einer Logger-Definition verknüpft. Die Version definiert vier Protokollierungskonfigurationen: 1) Systemkomponentenprotokolle im Dateisystem des Kerngeräts, 2) benutzerdefinierte Lambda-Funktionsprotokolle im Dateisystem des Kerngeräts, 3) Systemkomponentenprotokolle in Amazon CloudWatch Logs und 4) benutzerdefinierte Lambda-Funktionsprotokolle in Amazon Logs. CloudWatch Hinweis: Für die CloudWatch Logs-Integration muss Ihre Gruppenrolle die entsprechenden Berechtigungen gewähren. ``` aws greengrass create-logger-definition-version \ --logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" \ --loggers "[{\"Id\":\"1\",\"Component\":\"GreengrassSystem\",\"Level\":\"ERROR\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"2\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"3\",\"Component\":\"GreengrassSystem\",\"Level\":\"WARN\",\"Type\":\"AWSCloudWatch\"},{\"Id\":\"4\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Type\":\"AWSCloudWatch\"}]" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/a454b62a-5d56-4ca9-bdc4-8254e1662cb0/versions/49aedb1e-01a3-4d39-9871-3a052573f1ea", "Version": "49aedb1e-01a3-4d39-9871-3a052573f1ea", "CreationTimestamp": "2019-07-24T00:04:48.523Z", "Id": "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" } ``` Weitere Informationen finden Sie unter [Monitoring with AWS IoT Greengrass Logs](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie [CreateLoggerDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-logger-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-logger-definition` Das folgende Codebeispiel zeigt die Verwendung`create-logger-definition`. **AWS CLI** **So erstellen Sie eine Logger-Definition** Im folgenden Beispiel für `create-logger-definition` wird eine Logger-Definition erstellt, die eine erste Logger-Definitionsversion enthält. Die erste Version definiert drei Protokollierungskonfigurationen: 1) Systemkomponentenprotokolle im Dateisystem des Kerngeräts, 2) benutzerdefinierte Lambda-Funktionsprotokolle im Dateisystem des Kerngeräts und 3) benutzerdefinierte Lambda-Funktionsprotokolle in Amazon Logs. CloudWatch Hinweis: Für die CloudWatch Logs-Integration muss Ihre Gruppenrolle die entsprechenden Berechtigungen gewähren. ``` aws greengrass create-logger-definition \ --name "LoggingConfigs" \ --initial-version "{\"Loggers\":[{\"Id\":\"1\",\"Component\":\"GreengrassSystem\",\"Level\":\"ERROR\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"2\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"3\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Type\":\"AWSCloudWatch\"}]}" ``` Ausgabe: ``` { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/a454b62a-5d56-4ca9-bdc4-8254e1662cb0/versions/de1d9854-1588-4525-b25e-b378f60f2322", "Name": "LoggingConfigs", "LastUpdatedTimestamp": "2019-07-23T23:52:17.165Z", "LatestVersion": "de1d9854-1588-4525-b25e-b378f60f2322", "CreationTimestamp": "2019-07-23T23:52:17.165Z", "Id": "a454b62a-5d56-4ca9-bdc4-8254e1662cb0", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/a454b62a-5d56-4ca9-bdc4-8254e1662cb0" } ``` Weitere Informationen finden Sie unter [Monitoring with AWS IoT Greengrass Logs](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie [CreateLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-logger-definition.html)in der *AWS CLI Befehlsreferenz*. ### `create-resource-definition-version` Das folgende Codebeispiel zeigt die Verwendung`create-resource-definition-version`. **AWS CLI** **So erstellen Sie eine Version einer Ressourcendefinition** Das folgende `create-resource-definition-version` Beispiel erstellt eine neue Version von TwilioAuthToken a. ``` aws greengrass create-resource-definition-version \ --resource-definition-id "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38" \ --resources "[{\"Id\": \"TwilioAuthToken\",\"Name\": \"MyTwilioAuthToken\",\"ResourceDataContainer\": {\"SecretsManagerSecretResourceData\": {\"ARN\": \"arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-TwilioAuthToken-ntSlp6\"}}}]" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/b3bcada0-5fb6-42df-bf0b-1ee4f15e769e", "CreationTimestamp": "2019-06-24T21:17:25.623Z", "Id": "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "Version": "b3bcada0-5fb6-42df-bf0b-1ee4f15e769e" } ``` + Einzelheiten zur API finden Sie [CreateResourceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-resource-definition-version.html)unter *AWS CLI Befehlsreferenz*. ### `create-resource-definition` Das folgende Codebeispiel zeigt die Verwendung`create-resource-definition`. **AWS CLI** **So erstellen Sie eine Ressourcendefinition** Im folgenden Beispiel für `create-resource-definition` wird eine Ressourcendefinition erstellt, die eine Liste der in einer Greengrass-Gruppe zu verwendenden Ressourcen enthält. In diesem Beispiel wird eine erste Version der Ressourcendefinition bereitgestellt, indem eine Liste von Ressourcen angegeben wird. Die Liste enthält eine Ressource für ein Twilio-Autorisierungstoken und den ARN für ein in AWS Secrets Manager gespeichertes Geheimnis. Sie müssen das Secret erstellen, bevor Sie die Ressourcendefinition erstellen können. ``` aws greengrass create-resource-definition \ --name MyGreengrassResources \ --initial-version "{\"Resources\": [{\"Id\": \"TwilioAuthToken\",\"Name\": \"MyTwilioAuthToken\",\"ResourceDataContainer\": {\"SecretsManagerSecretResourceData\": {\"ARN\": \"arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-TwilioAuthToken-ntSlp6\"}}}]}" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "CreationTimestamp": "2019-06-19T21:51:28.212Z", "Id": "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "LastUpdatedTimestamp": "2019-06-19T21:51:28.212Z", "LatestVersion": "a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1", "Name": "MyGreengrassResources" } ``` Weitere Informationen finden Sie unter [How to Configure Local Resource Access Using the AWS Command Line Interface](https://docs.aws.amazon.com/greengrass/latest/developerguide/lra-cli.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateResourceDefinition AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-resource-definition.html)*Befehlsreferenz.* ### `create-software-update-job` Das folgende Codebeispiel zeigt die Verwendung`create-software-update-job`. **AWS CLI** **So erstellen Sie einen Software-Aktualisierungsauftrag für einen Kern** Im folgenden `create-software-update-job` Beispiel wird ein over-the-air (OTA-) Aktualisierungsauftrag erstellt, um die AWS IoT Greengrass Core-Software auf dem Core zu aktualisieren, dessen Name lautet`MyFirstGroup_Core`. Dieser Befehl erfordert eine IAM-Rolle, die Zugriff auf Softwareupdatepakete in Amazon S3 gewährt und `iot.amazonaws.com` als vertrauenswürdige Entität einschließt. ``` aws greengrass create-software-update-job \ --update-targets-architecture armv7l \ --update-targets [\"arn:aws:iot:us-west-2:123456789012:thing/MyFirstGroup_Core\"] \ --update-targets-operating-system raspbian \ --software-to-update core \ --s3-url-signer-role arn:aws:iam::123456789012:role/OTA_signer_role \ --update-agent-log-level WARN ``` Ausgabe: ``` { "IotJobId": "GreengrassUpdateJob_30b353e3-3af7-4786-be25-4c446663c09e", "IotJobArn": "arn:aws:iot:us-west-2:123456789012:job/GreengrassUpdateJob_30b353e3-3af7-4786-be25-4c446663c09e", "PlatformSoftwareVersion": "1.9.3" } ``` Weitere Informationen finden Sie unter [OTA-Updates der AWS IoT Greengrass Core Software](https://docs.aws.amazon.com/greengrass/latest/developerguide/core-ota-update.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie [CreateSoftwareUpdateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-software-update-job.html)in der *AWS CLI Befehlsreferenz*. ### `create-subscription-definition-version` Das folgende Codebeispiel zeigt die Verwendung`create-subscription-definition-version`. **AWS CLI** **So erstellen Sie eine neue Version einer Abonnementdefinition** Im folgenden Beispiel für `create-subscription-definition-version` wird eine neue Version einer Abonnementdefinition erstellt, die drei Abonnements enthält: eine Trigger-Benachrichtigung, eine Temperatureingabe und einen Ausgabestatus. ``` aws greengrass create-subscription-definition-version \ --subscription-definition-id "9d611d57-5d5d-44bd-a3b4-feccbdd69112" \ --subscriptions "[{\"Id\": \"TriggerNotification\", \"Source\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\", \"Subject\": \"twilio/txt\", \"Target\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\"},{\"Id\": \"TemperatureInput\", \"Source\": \"cloud\", \"Subject\": \"temperature/input\", \"Target\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\"},{\"Id\": \"OutputStatus\", \"Source\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\", \"Subject\": \"twilio/message/status\", \"Target\": \"cloud\"}]" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112/versions/7b65dfae-50b6-4d0f-b3e0-27728bfb0620", "CreationTimestamp": "2019-06-24T21:21:33.837Z", "Id": "9d611d57-5d5d-44bd-a3b4-feccbdd69112", "Version": "7b65dfae-50b6-4d0f-b3e0-27728bfb0620" } ``` + Einzelheiten zur API finden Sie [CreateSubscriptionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-subscription-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `create-subscription-definition` Das folgende Codebeispiel zeigt die Verwendung`create-subscription-definition`. **AWS CLI** **So erstellen Sie eine Abonnementdefinition** Im folgenden Beispiel für `create-subscription-definition` wird eine Abonnementdefinition erstellt und ihre erste Version angegeben. Die erste Version enthält drei Abonnements: eines für das MQTT-Thema, das der Connector abonniert, eines, das es einer Funktion ermöglicht, Temperaturwerte vom AWS IoT zu empfangen, und eines, das es AWS IoT ermöglicht, Statusinformationen vom Connector zu empfangen. In dem Beispiel wird der ARN für den Lambda-Funktionsalias bereitgestellt, der zuvor mithilfe des Lambda-Befehls `create-alias` erstellt wurde. ``` aws greengrass create-subscription-definition \ --initial-version "{\"Subscriptions\": [{\"Id\": \"TriggerNotification\", \"Source\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\", \"Subject\": \"twilio/txt\", \"Target\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\"},{\"Id\": \"TemperatureInput\", \"Source\": \"cloud\", \"Subject\": \"temperature/input\", \"Target\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\"},{\"Id\": \"OutputStatus\", \"Source\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\", \"Subject\": \"twilio/message/status\", \"Target\": \"cloud\"}]}" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112", "CreationTimestamp": "2019-06-19T22:34:26.677Z", "Id": "9d611d57-5d5d-44bd-a3b4-feccbdd69112", "LastUpdatedTimestamp": "2019-06-19T22:34:26.677Z", "LatestVersion": "aa645c47-ac90-420d-9091-8c7ffa4f103f", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112/versions/aa645c47-ac90-420d-9091-8c7ffa4f103f" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Konnektoren (CLI)](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors-cli.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [CreateSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-subscription-definition.html)in der *AWS CLI Befehlsreferenz*. ### `delete-connector-definition` Das folgende Codebeispiel zeigt die Verwendung`delete-connector-definition`. **AWS CLI** **So löschen Sie eine Konnektordefinition** Im folgenden Beispiel für `delete-connector-definition` wird die angegebene Greengrass-Konnektordefinition gelöscht. Wenn Sie eine Konnektordefinition löschen, die von einer Gruppe verwendet wird, kann diese Gruppe nicht erfolgreich bereitgestellt werden. ``` aws greengrass delete-connector-definition \ --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-connector-definition.html)in der *AWS CLI Befehlsreferenz*. ### `delete-core-definition` Das folgende Codebeispiel zeigt die Verwendung`delete-core-definition`. **AWS CLI** **So löschen Sie eine Kerndefinition** Im folgenden Beispiel für `delete-core-definition` wird die angegebene Greengrass-Kerndefinition einschließlich aller Versionen gelöscht. Wenn Sie einen Kern löschen, der mit einer Greengrass-Gruppe verknüpft ist, kann diese Gruppe nicht erfolgreich bereitgestellt werden. ``` aws greengrass delete-core-definition \ --core-definition-id "ff36cc5f-9f98-4994-b468-9d9b6dc52abd" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-core-definition.html)in der *AWS CLI Befehlsreferenz*. ### `delete-device-definition` Das folgende Codebeispiel zeigt die Verwendung`delete-device-definition`. **AWS CLI** **So löschen Sie eine Gerätedefinition** Im folgenden Beispiel für `delete-device-definition` wird die angegebene Gerätedefinition einschließlich all ihrer Versionen gelöscht. Wenn Sie eine Gerätedefinitionsversion löschen, die von einer Gruppenversion verwendet wird, kann die Gruppenversion nicht erfolgreich bereitgestellt werden. ``` aws greengrass delete-device-definition \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-device-definition.html)in der *AWS CLI Befehlsreferenz*. ### `delete-function-definition` Das folgende Codebeispiel zeigt die Verwendung`delete-function-definition`. **AWS CLI** **So löschen Sie eine Funktionsdefinition** Im folgenden Beispiel für `delete-function-definition` wird die angegebene Greengrass-Funktionsdefinition gelöscht. Wenn Sie eine Funktionsdefinition löschen, die von einer Gruppe verwendet wird, kann diese Gruppe nicht erfolgreich bereitgestellt werden. ``` aws greengrass delete-function-definition \ --function-definition-id "fd4b906a-dff3-4c1b-96eb-52ebfcfac06a" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-function-definition.html)in der *AWS CLI Befehlsreferenz*. ### `delete-group` Das folgende Codebeispiel zeigt die Verwendung`delete-group`. **AWS CLI** **Um eine Gruppe zu löschen** Im folgenden Beispiel für `delete-group` wird die angegebene Greengrass-Gruppe gelöscht. ``` aws greengrass delete-group \ --group-id "4e22bd92-898c-436b-ade5-434d883ff749" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-logger-definition` Das folgende Codebeispiel zeigt die Verwendung`delete-logger-definition`. **AWS CLI** **So löschen Sie eine Logger-Definition** Im folgenden Beispiel für `delete-logger-definition` wird die angegebene Logger-Definition einschließlich aller Logger-Definitionsversionen gelöscht. Wenn Sie eine Logger-Definitionsversion löschen, die von einer Gruppenversion verwendet wird, kann die Gruppenversion nicht erfolgreich bereitgestellt werden. ``` aws greengrass delete-logger-definition \ --logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Monitoring with AWS IoT Greengrass Logs](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie [DeleteLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-logger-definition.html)in der *AWS CLI Befehlsreferenz*. ### `delete-resource-definition` Das folgende Codebeispiel zeigt die Verwendung`delete-resource-definition`. **AWS CLI** **So löschen Sie eine Ressourcendefinition** Im folgenden Beispiel für `delete-resource-definition` wird die angegebene Ressourcendefinition einschließlich aller Ressourcenversionen gelöscht. Wenn Sie eine Ressourcendefinition löschen, die von einer Gruppe verwendet wird, kann diese Gruppe nicht erfolgreich bereitgestellt werden. ``` aws greengrass delete-resource-definition \ --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-resource-definition.html)in der *AWS CLI Befehlsreferenz*. ### `delete-subscription-definition` Das folgende Codebeispiel zeigt die Verwendung`delete-subscription-definition`. **AWS CLI** **So löschen Sie eine Abonnementdefinition** Im folgenden Beispiel für `delete-subscription-definition` wird die angegebene Greengrass-Abonnementdefinition gelöscht. Wenn Sie ein Abonnement löschen, das von einer Gruppe verwendet wird, kann diese Gruppe nicht erfolgreich bereitgestellt werden. ``` aws greengrass delete-subscription-definition \ --subscription-definition-id "cd6f1c37-d9a4-4e90-be94-01a7404f5967" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-subscription-definition.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-role-from-group` Das folgende Codebeispiel zeigt die Verwendung`disassociate-role-from-group`. **AWS CLI** **So heben Sie die Verknüpfung der Rolle mit einer Greengrass-Gruppe auf** Im folgenden Beispiel für `disassociate-role-from-group` wird die Verknüpfung der IAM-Rolle mit einer angegebenen Greengrass-Gruppe aufgehoben. ``` aws greengrass disassociate-role-from-group \ --group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b ``` Ausgabe: ``` { "DisassociatedAt": "2019-09-10T20:05:49Z" } ``` Weitere Informationen finden Sie unter [Konfigurieren der Gruppenrolle](https://docs.aws.amazon.com/greengrass/latest/developerguide/config-iam-roles.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [DisassociateRoleFromGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/disassociate-role-from-group.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-service-role-from-account` Das folgende Codebeispiel zeigt die Verwendung`disassociate-service-role-from-account`. **AWS CLI** **Um eine Servicerolle von Ihrem AWS Konto zu trennen** Im folgenden `disassociate-service-role-from-account` Beispiel wird die Ihrem AWS Konto zugeordnete Servicerolle entfernt. Wenn Sie die Servicerolle in keiner AWS Region verwenden, verwenden Sie den `delete-role-policy` Befehl, um die `AWSGreengrassResourceAccessRolePolicy` verwaltete Richtlinie von der Rolle zu trennen, und verwenden Sie dann den `delete-role` Befehl, um die Rolle zu löschen. ``` aws greengrass disassociate-service-role-from-account ``` Ausgabe: ``` { "DisassociatedAt": "2019-06-25T22:12:55Z" } ``` Weitere Informationen finden Sie unter [Greengrass-Servicerolle](https://docs.aws.amazon.com/greengrass/latest/developerguide/service-role.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie [DisassociateServiceRoleFromAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/disassociate-service-role-from-account.html)in der *AWS CLI Befehlsreferenz.* ### `get-associated-role` Das folgende Codebeispiel zeigt die Verwendung`get-associated-role`. **AWS CLI** **So rufen Sie die mit einer Greengrass-Gruppe verknüpfte Rolle ab** Im folgenden Beispiel für `get-associated-role` wird die IAM-Rolle abgerufen, die mit der angegebenen Greengrass-Gruppe verknüpft ist. Die Gruppenrolle wird von lokalen Lambda-Funktionen und Konnektoren für den Zugriff auf AWS Dienste verwendet. ``` aws greengrass get-associated-role \ --group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b ``` Ausgabe: ``` { "RoleArn": "arn:aws:iam::123456789012:role/GG-Group-Role", "AssociatedAt": "2019-09-10T20:03:30Z" } ``` Weitere Informationen finden Sie unter [Konfigurieren der Gruppenrolle](https://docs.aws.amazon.com/greengrass/latest/developerguide/config-iam-roles.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [GetAssociatedRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-associated-role.html)in der *AWS CLI Befehlsreferenz.* ### `get-bulk-deployment-status` Das folgende Codebeispiel zeigt die Verwendung`get-bulk-deployment-status`. **AWS CLI** **So überprüfen Sie den Status Ihrer Sammelbereitstellung** Im folgenden Beispiel für `get-bulk-deployment-status` werden Statusinformationen für die angegebene Sammelbereitstellungsoperation abgerufen. In diesem Beispiel weist die Datei, in der die bereitzustellenden Gruppen angegeben wurden, einen ungültigen Eingabedatensatz auf. ``` aws greengrass get-bulk-deployment-status \ --bulk-deployment-id "870fb41b-6288-4e0c-bc76-a7ba4b4d3267" ``` Ausgabe: ``` { "BulkDeploymentMetrics": { "InvalidInputRecords": 1, "RecordsProcessed": 1, "RetryAttempts": 0 }, "BulkDeploymentStatus": "Completed", "CreatedAt": "2019-06-25T16:11:33.265Z", "tags": {} } ``` Weitere Informationen finden Sie unter [Erstellen von Sammelbereitstellungen für Gruppen](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [GetBulkDeploymentStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-bulk-deployment-status.html)in der *AWS CLI Befehlsreferenz*. ### `get-connectivity-info` Das folgende Codebeispiel zeigt die Verwendung`get-connectivity-info`. **AWS CLI** **So rufen Sie die Verbindungsinformationen für einen Greengrass-Kern ab** Im folgenden Beispiel für `get-connectivity-info` werden die Endpunkte angezeigt, über die Geräte eine Verbindung zum angegebenen Greengrass-Kern herstellen können. Bei den Verbindungsinformationen handelt es sich um eine Liste von IP-Adressen oder Domainnamen mit den entsprechenden Portnummern und optionalen, vom Kunden definierten Metadaten. ``` aws greengrass get-connectivity-info \ --thing-name "MyGroup_Core" ``` Ausgabe: ``` { "ConnectivityInfo": [ { "Metadata": "", "PortNumber": 8883, "HostAddress": "127.0.0.1", "Id": "AUTOIP_127.0.0.1_0" }, { "Metadata": "", "PortNumber": 8883, "HostAddress": "192.168.1.3", "Id": "AUTOIP_192.168.1.3_1" }, { "Metadata": "", "PortNumber": 8883, "HostAddress": "::1", "Id": "AUTOIP_::1_2" }, { "Metadata": "", "PortNumber": 8883, "HostAddress": "fe80::1e69:ed93:f5b:f6d", "Id": "AUTOIP_fe80::1e69:ed93:f5b:f6d_3" } ] } ``` + Einzelheiten zur API finden Sie [GetConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-connectivity-info.html)in der *AWS CLI Befehlsreferenz*. ### `get-connector-definition-version` Das folgende Codebeispiel zeigt die Verwendung`get-connector-definition-version`. **AWS CLI** **Um Informationen über eine bestimmte Version einer Connectordefinition abzurufen** Im folgenden Beispiel für `get-connector-definition-version` werden Informationen zur angegebenen Version der angegebenen Konnektordefinition abgerufen. Verwenden Sie den `list-connector-definition-versions` Befehl, um die IDs aller Versionen der Konnektordefinition abzurufen. Verwenden Sie den Befehl `get-connector-definition` und überprüfen Sie die Eigenschaft `LatestVersion`, um die ID der letzten Version abzurufen, die der Konnektordefinition hinzugefügt wurde. ``` aws greengrass get-connector-definition-version \ --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8" \ --connector-definition-version-id "63c57963-c7c2-4a26-a7e2-7bf478ea2623" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Definition": { "Connectors": [ { "ConnectorArn": "arn:aws:greengrass:us-west-2::/connectors/SNS/versions/1", "Id": "MySNSConnector", "Parameters": { "DefaultSNSArn": "arn:aws:sns:us-west-2:123456789012:GGConnectorTopic" } } ] }, "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "Version": "63c57963-c7c2-4a26-a7e2-7bf478ea2623" } ``` Weitere Informationen finden Sie unter [Integration mit Services und Protokollen mithilfe von Greengrass-Konnektoren](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie [GetConnectorDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-connector-definition-version.html)unter *AWS CLI Befehlsreferenz*. ### `get-connector-definition` Das folgende Codebeispiel zeigt die Verwendung`get-connector-definition`. **AWS CLI** **So rufen Sie Informationen zu einer Konnektordefinition ab** Im folgenden Beispiel für `get-connector-definition` werden Informationen zur angegebenen Konnektordefinition abgerufen. Verwenden Sie den IDs `list-connector-definitions` Befehl, um Ihre Connector-Definitionen abzurufen. ``` aws greengrass get-connector-definition \ --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "LastUpdatedTimestamp": "2019-06-19T19:30:01.300Z", "LatestVersion": "63c57963-c7c2-4a26-a7e2-7bf478ea2623", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "Name": "MySNSConnector", "tags": {} } ``` Weitere Informationen finden Sie unter [Integration mit Services und Protokollen mithilfe von Greengrass-Konnektoren](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie [GetConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-connector-definition.html)in der *AWS CLI Befehlsreferenz*. ### `get-core-definition-version` Das folgende Codebeispiel zeigt die Verwendung`get-core-definition-version`. **AWS CLI** **So rufen Sie Details zu einer bestimmten Version der Greengrass-Kerndefinition ab** Im folgenden Beispiel für `get-core-definition-version` werden Informationen zur angegebenen Version der angegebenen Kerndefinition abgerufen. Verwenden Sie den `list-core-definition-versions` Befehl, um die IDs aller Versionen der Kerndefinition abzurufen. Verwenden Sie den Befehl `get-core-definition` und überprüfen Sie die Eigenschaft `LatestVersion`, um die ID der letzten Version abzurufen, die der Kerndefinition hinzugefügt wurde. ``` aws greengrass get-core-definition-version \ --core-definition-id "c906ed39-a1e3-4822-a981-7b9bd57b4b46" \ --core-definition-version-id "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46/versions/42aeeac3-fd9d-4312-a8fd-ffa9404a20e0", "CreationTimestamp": "2019-06-18T16:21:21.351Z", "Definition": { "Cores": [ { "CertificateArn": "arn:aws:iot:us-west-2:123456789012:cert/928dea7b82331b47c3ff77b0e763fc5e64e2f7c884e6ef391baed9b6b8e21b45", "Id": "1a39aac7-0885-4417-91f6-23e4cea6c511", "SyncShadow": false, "ThingArn": "arn:aws:iot:us-west-2:123456789012:thing/GGGroup4Pi3_Core" } ] }, "Id": "c906ed39-a1e3-4822-a981-7b9bd57b4b46", "Version": "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0" } ``` + Einzelheiten zur API finden Sie [GetCoreDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-core-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `get-core-definition` Das folgende Codebeispiel zeigt die Verwendung`get-core-definition`. **AWS CLI** **So rufen Sie Details für eine Greengrass-Kerndefinition ab** Im folgenden Beispiel für `get-core-definition` werden Informationen zur angegebenen Kerndefinition abgerufen. Verwenden Sie den IDs `list-core-definitions` Befehl, um Ihre Kerndefinitionen abzurufen. ``` aws greengrass get-core-definition \ --core-definition-id "c906ed39-a1e3-4822-a981-7b9bd57b4b46" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/237d6916-27cf-457f-ba0c-e86cfb5d25cd", "CreationTimestamp": "2018-10-18T04:47:06.721Z", "Id": "237d6916-27cf-457f-ba0c-e86cfb5d25cd", "LastUpdatedTimestamp": "2018-10-18T04:47:06.721Z", "LatestVersion": "bd2cd6d4-2bc5-468a-8962-39e071e34b68", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/237d6916-27cf-457f-ba0c-e86cfb5d25cd/versions/bd2cd6d4-2bc5-468a-8962-39e071e34b68", "tags": {} } ``` + Einzelheiten zur API finden Sie [GetCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-core-definition.html)in der *AWS CLI Befehlsreferenz*. ### `get-deployment-status` Das folgende Codebeispiel zeigt die Verwendung`get-deployment-status`. **AWS CLI** **So rufen Sie den Status einer Bereitstellung ab** Im folgenden Beispiel für `get-deployment-status` wird der Status für die angegebene Bereitstellung der angegebenen Greengrass-Gruppe abgerufen. Verwenden Sie den Befehl `list-deployments` und geben Sie die Gruppen-ID an, um die Bereitstellungs-ID abzurufen. ``` aws greengrass get-deployment-status \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" \ --deployment-id "1065b8a0-812b-4f21-9d5d-e89b232a530f" ``` Ausgabe: ``` { "DeploymentStatus": "Success", "DeploymentType": "NewDeployment", "UpdatedAt": "2019-06-18T17:04:44.761Z" } ``` + Einzelheiten zur API finden Sie [GetDeploymentStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-deployment-status.html)in der *AWS CLI Befehlsreferenz*. ### `get-device-definition-version` Das folgende Codebeispiel zeigt die Verwendung`get-device-definition-version`. **AWS CLI** **So rufen Sie eine Geräte-Definitionsversion ab** Im folgenden Beispiel für `get-device-definition-version` werden Informationen zur angegebenen Version der angegebenen Gerätedefinition abgerufen. Verwenden Sie den `list-device-definition-versions` Befehl, um die IDs aller Versionen der Gerätedefinition abzurufen. Verwenden Sie den Befehl `get-device-definition` und überprüfen Sie die Eigenschaft `LatestVersion`, um die ID der letzten Version abzurufen, die der Gerätedefinition hinzugefügt wurde. ``` aws greengrass get-device-definition-version \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \ --device-definition-version-id "83c13984-6fed-447e-84d5-5b8aa45d5f71" ``` Ausgabe: ``` { "Definition": { "Devices": [ { "CertificateArn": "arn:aws:iot:us-west-2:123456789012:cert/6c52ce1b47bde88a637e9ccdd45fe4e4c2c0a75a6866f8f63d980ee22fa51e02", "ThingArn": "arn:aws:iot:us-west-2:123456789012:thing/ExteriorTherm", "SyncShadow": true, "Id": "ExteriorTherm" }, { "CertificateArn": "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92", "ThingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm", "SyncShadow": true, "Id": "InteriorTherm" } ] }, "Version": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:15:09.838Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71" } ``` + Einzelheiten zur API finden Sie [GetDeviceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-device-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `get-device-definition` Das folgende Codebeispiel zeigt die Verwendung`get-device-definition`. **AWS CLI** **So rufen Sie eine Gerätedefinition ab** Im folgenden Beispiel für `get-device-definition` werden Informationen zur angegebenen Gerätedefinition abgerufen. Verwenden Sie den IDs `list-device-definitions` Befehl, um Ihre Gerätedefinitionen abzurufen. ``` aws greengrass get-device-definition \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" ``` Ausgabe: ``` { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71", "Name": "TemperatureSensors", "tags": {}, "LastUpdatedTimestamp": "2019-09-11T00:19:03.698Z", "LatestVersion": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:11:06.197Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd" } ``` + Einzelheiten zur API finden Sie [GetDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-device-definition.html)in der *AWS CLI Befehlsreferenz*. ### `get-function-definition-version` Das folgende Codebeispiel zeigt die Verwendung`get-function-definition-version`. **AWS CLI** **So rufen Sie Details zu einer bestimmten Version einer Lambda-Funktion ab** Im folgenden Beispiel für `get-function-definition-version` werden Informationen zur angegebenen Version der angegebenen Funktionsdefinition abgerufen. Verwenden Sie den `list-function-definition-versions` Befehl, um die IDs aller Versionen der Funktionsdefinition abzurufen. Verwenden Sie den Befehl `get-function-definition` und überprüfen Sie die Eigenschaft `LatestVersion`, um die ID der letzten Version abzurufen, die der Funktionsdefinition hinzugefügt wurde. ``` aws greengrass get-function-definition-version \ --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85" \ --function-definition-version-id "9748fda7-1589-4fcc-ac94-f5559e88678b" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b", "CreationTimestamp": "2019-06-18T17:04:30.776Z", "Definition": { "Functions": [ { "FunctionArn": "arn:aws:lambda:::function:GGIPDetector:1", "FunctionConfiguration": { "Environment": {}, "MemorySize": 32768, "Pinned": true, "Timeout": 3 }, "Id": "26b69bdb-e547-46bc-9812-84ec04b6cc8c" }, { "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:GG_HelloWorld", "FunctionConfiguration": { "EncodingType": "json", "Environment": { "Variables": {} }, "MemorySize": 16384, "Pinned": true, "Timeout": 25 }, "Id": "384465a8-eedf-48c6-b793-4c35f7bfae9b" } ] }, "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "9748fda7-1589-4fcc-ac94-f5559e88678b" } ``` + Einzelheiten zur API finden Sie [GetFunctionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-function-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `get-function-definition` Das folgende Codebeispiel zeigt die Verwendung`get-function-definition`. **AWS CLI** **So rufen Sie eine Funktionsdefinition ab** Im folgenden Beispiel für `get-function-definition` werden Details für die angegebene Funktionsdefinition angezeigt. Verwenden Sie den IDs `list-function-definitions` Befehl, um Ihre Funktionsdefinitionen abzurufen. ``` aws greengrass get-function-definition \ --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "CreationTimestamp": "2019-06-18T16:21:21.431Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "LastUpdatedTimestamp": "2019-06-18T16:21:21.431Z", "LatestVersion": "9748fda7-1589-4fcc-ac94-f5559e88678b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b", "tags": {} } ``` + Einzelheiten zur API finden Sie [GetFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-function-definition.html)in der *AWS CLI Befehlsreferenz*. ### `get-group-certificate-authority` Das folgende Codebeispiel zeigt die Verwendung`get-group-certificate-authority`. **AWS CLI** **So rufen Sie die mit einer Greengrass-Gruppe verknüpfte CA ab** Im folgenden Beispiel für `get-group-certificate-authority` wird die Zertifizierungsstelle (CA) abgerufen, die mit der angegebenen Greengrass-Gruppe verknüpft ist. Verwenden Sie den Befehl `list-group-certificate-authorities` und geben Sie die Gruppen-ID an, um die Zertifizierungsstellen-ID abzurufen. ``` aws greengrass get-group-certificate-authority \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" \ --certificate-authority-id "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6" ``` Ausgabe: ``` { "GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/certificateauthorities/f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6", "GroupCertificateAuthorityId": "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6", "PemEncodedCertificate": "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBWEXAMPLEGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDEXAMPLEEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAEXAMPLESBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jEXAMPLENMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0EXAMPLEBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWEXAMPLEDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWEXAMPLEgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5EXAMPLE8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CEXAMPLE93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswYEXAMPLEgpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKEXAMPLEAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----\n" } ``` + Einzelheiten zur API finden Sie [GetGroupCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group-certificate-authority.html)in der *AWS CLI Befehlsreferenz*. ### `get-group-certificate-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-group-certificate-configuration`. **AWS CLI** **So rufen Sie die Konfiguration für die von der Greengrass-Gruppe verwendete Zertifizierungsstelle ab** Im folgenden Beispiel für `get-group-certificate-configuration` wird die Konfiguration für die Zertifizierungsstelle (CA) abgerufen, die von der angegebenen Greengrass-Gruppe verwendet wird. ``` aws greengrass get-group-certificate-configuration \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" ``` Ausgabe: ``` { "CertificateAuthorityExpiryInMilliseconds": 2524607999000, "CertificateExpiryInMilliseconds": 604800000, "GroupId": "1013db12-8b58-45ff-acc7-704248f66731" } ``` + Einzelheiten zur API finden Sie [GetGroupCertificateConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group-certificate-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-group-version` Das folgende Codebeispiel zeigt die Verwendung`get-group-version`. **AWS CLI** **So rufen Sie Informationen zur Version einer Greengrass-Gruppe ab** Im folgenden Beispiel für `get-group-version` werden Informationen zur angegebenen Version der angegebenen Gruppe abgerufen. Verwenden Sie den `list-group-versions` Befehl, um die IDs aller Versionen der Gruppe abzurufen. Verwenden Sie den Befehl `get-group` und überprüfen Sie die Eigenschaft `LatestVersion`, um die ID der letzten Version abzurufen, die der Gruppe hinzugefügt wurde. ``` aws greengrass get-group-version \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" \ --group-version-id "115136b3-cfd7-4462-b77f-8741a4b00e5e" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e", "CreationTimestamp": "2019-06-18T17:04:30.915Z", "Definition": { "CoreDefinitionVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46/versions/42aeeac3-fd9d-4312-a8fd-ffa9404a20e0", "FunctionDefinitionVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b", "SubscriptionDefinitionVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b" }, "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "115136b3-cfd7-4462-b77f-8741a4b00e5e" } ``` + Einzelheiten zur API finden Sie [GetGroupVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group-version.html)in der *AWS CLI Befehlsreferenz*. ### `get-group` Das folgende Codebeispiel zeigt die Verwendung`get-group`. **AWS CLI** **So rufen Sie Informationen zu einer Greengrass-Gruppe ab** Das folgende Beispiel für `get-group` ruft Informationen zur angegebenen Greengrass-Gruppe ab. Verwenden Sie den IDs `list-groups` Befehl, um die Ihrer Gruppen abzurufen. ``` aws greengrass get-group \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731", "CreationTimestamp": "2019-06-18T16:21:21.457Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "LastUpdatedTimestamp": "2019-06-18T16:21:21.457Z", "LatestVersion": "115136b3-cfd7-4462-b77f-8741a4b00e5e", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e", "Name": "GGGroup4Pi3", "tags": {} } ``` + Einzelheiten zur API finden Sie [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group.html)in der *AWS CLI Befehlsreferenz*. ### `get-logger-definition-version` Das folgende Codebeispiel zeigt die Verwendung`get-logger-definition-version`. **AWS CLI** **So rufen Sie Informationen zu einer Version einer Logger-Definition ab** Im folgenden Beispiel für `get-logger-definition-version` werden Informationen zur angegebenen Version der angegebenen Logger-Definition abgerufen. Verwenden Sie den `list-logger-definition-versions` Befehl, um die IDs aller Versionen der Logger-Definition abzurufen. Verwenden Sie den Befehl `get-logger-definition` und überprüfen Sie die Eigenschaft `LatestVersion`, um die ID der letzten Version abzurufen, die der Logger-Definition hinzugefügt wurde. ``` aws greengrass get-logger-definition-version \ --logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23" \ --logger-definition-version-id "5e3f6f64-a565-491e-8de0-3c0d8e0f2073" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "CreationTimestamp": "2019-05-08T16:10:13.866Z", "Definition": { "Loggers": [] }, "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "Version": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073" } ``` + Einzelheiten zur API finden Sie [GetLoggerDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-logger-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `get-logger-definition` Das folgende Codebeispiel zeigt die Verwendung`get-logger-definition`. **AWS CLI** **So rufen Sie Informationen zu einer Logger-Definition ab** Im folgenden Beispiel für `get-logger-definition` werden Informationen zur angegebenen Logger-Definition abgerufen. Verwenden Sie den IDs `list-logger-definitions` Befehl, um Ihre Logger-Definitionen abzurufen. ``` aws greengrass get-logger-definition \ --logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23", "CreationTimestamp": "2019-05-08T16:10:13.809Z", "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "LastUpdatedTimestamp": "2019-05-08T16:10:13.809Z", "LatestVersion": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "tags": {} } ``` + Einzelheiten zur API finden Sie [GetLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-logger-definition.html)in der *AWS CLI Befehlsreferenz*. ### `get-resource-definition-version` Das folgende Codebeispiel zeigt die Verwendung`get-resource-definition-version`. **AWS CLI** **So rufen Sie Informationen zu einer bestimmten Version einer Ressourcendefinition ab** Im folgenden Beispiel für `get-resource-definition-version` werden Informationen zur angegebenen Version der angegebenen Ressourcendefinition abgerufen. Verwenden Sie den `list-resource-definition-versions` Befehl, um die IDs aller Versionen der Ressourcendefinition abzurufen. Verwenden Sie den Befehl `get-resource-definition` und überprüfen Sie die Eigenschaft `LatestVersion`, um die ID der letzten Version abzurufen, die der Ressourcendefinition hinzugefügt wurde. ``` aws greengrass get-resource-definition-version \ --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658" \ --resource-definition-version-id "26e8829a-491a-464d-9c87-664bf6f6f2be" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be", "CreationTimestamp": "2019-06-19T16:40:59.392Z", "Definition": { "Resources": [ { "Id": "26ff3f7b-839a-4217-9fdc-a218308b3963", "Name": "usb-port", "ResourceDataContainer": { "LocalDeviceResourceData": { "GroupOwnerSetting": { "AutoAddGroupOwner": false }, "SourcePath": "/dev/bus/usb" } } } ] }, "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "Version": "26e8829a-491a-464d-9c87-664bf6f6f2be" } ``` + Einzelheiten zur API finden Sie [GetResourceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-resource-definition-version.html)unter *AWS CLI Befehlsreferenz*. ### `get-resource-definition` Das folgende Codebeispiel zeigt die Verwendung`get-resource-definition`. **AWS CLI** **So rufen Sie Informationen zu einer Ressourcendefinition ab** Im folgenden Beispiel für `get-resource-definition` werden Informationen zur angegebenen Ressourcendefinition abgerufen. Verwenden Sie den IDs `list-resource-definitions` Befehl, um Ihre Ressourcendefinitionen abzurufen. ``` aws greengrass get-resource-definition \ --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658", "CreationTimestamp": "2019-06-19T16:40:59.261Z", "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "LastUpdatedTimestamp": "2019-06-19T16:40:59.261Z", "LatestVersion": "26e8829a-491a-464d-9c87-664bf6f6f2be", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be", "tags": {} } ``` + Einzelheiten zur API finden Sie [GetResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-resource-definition.html)in der *AWS CLI Befehlsreferenz*. ### `get-service-role-for-account` Das folgende Codebeispiel zeigt die Verwendung`get-service-role-for-account`. **AWS CLI** **So rufen Sie die Details für die Servicerolle ab, die mit Ihrem Konto verknüpft ist** Im folgenden `get-service-role-for-account` Beispiel werden Informationen über die Servicerolle abgerufen, die Ihrem AWS Konto zugeordnet ist. ``` aws greengrass get-service-role-for-account ``` Ausgabe: ``` { "AssociatedAt": "2018-10-18T15:59:20Z", "RoleArn": "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole" } ``` Weitere Informationen finden Sie unter [Greengrass-Servicerolle](https://docs.aws.amazon.com/greengrass/latest/developerguide/service-role.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie unter [GetServiceRoleForAccount AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-service-role-for-account.html)*Befehlsreferenz.* ### `get-subscription-definition-version` Das folgende Codebeispiel zeigt die Verwendung`get-subscription-definition-version`. **AWS CLI** **So rufen Sie Informationen zu einer bestimmten Version einer Abonnementdefinition ab** Im folgenden Beispiel für `get-subscription-definition-version` werden Informationen zur angegebenen Version der angegebenen Abonnementdefinition abgerufen. Verwenden Sie den `list-subscription-definition-versions` Befehl, um die IDs aller Versionen der Abonnementdefinition abzurufen. Verwenden Sie den Befehl `get-subscription-definition` und überprüfen Sie die Eigenschaft `LatestVersion`, um die ID der letzten Version abzurufen, die der Abonnementdefinition hinzugefügt wurde. ``` aws greengrass get-subscription-definition-version \ --subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152" \ --subscription-definition-version-id "88ae8699-12ac-4663-ba3f-4d7f0519140b" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b", "CreationTimestamp": "2019-06-18T17:03:52.499Z", "Definition": { "Subscriptions": [ { "Id": "692c4484-d89f-4f64-8edd-1a041a65e5b6", "Source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:GG_HelloWorld", "Subject": "hello/world", "Target": "cloud" } ] }, "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "Version": "88ae8699-12ac-4663-ba3f-4d7f0519140b" } ``` + Einzelheiten zur API finden Sie [GetSubscriptionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-subscription-definition-version.html)in der *AWS CLI Befehlsreferenz*. ### `get-subscription-definition` Das folgende Codebeispiel zeigt die Verwendung`get-subscription-definition`. **AWS CLI** **So rufen Sie Informationen zu einer Abonnementdefinition ab** Im folgenden Beispiel für `get-subscription-definition` werden Informationen zur angegebenen Abonnementdefinition abgerufen. Verwenden Sie den IDs `list-subscription-definitions` Befehl, um Ihre Abonnementdefinitionen abzurufen. ``` aws greengrass get-subscription-definition \ --subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152" ``` Ausgabe: ``` { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152", "CreationTimestamp": "2019-06-18T17:03:52.392Z", "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "LastUpdatedTimestamp": "2019-06-18T17:03:52.392Z", "LatestVersion": "88ae8699-12ac-4663-ba3f-4d7f0519140b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b", "tags": {} } ``` + Einzelheiten zur API finden Sie [GetSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-subscription-definition.html)in der *AWS CLI Befehlsreferenz*. ### `get-thing-runtime-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-thing-runtime-configuration`. **AWS CLI** **So rufen Sie die Laufzeitkonfiguration eines Greengrass-Kerns ab** Im folgenden Beispiel für `get-thing-runtime-configuration` wird die Laufzeitkonfiguration eines Greengrass-Kerns abgerufen. Bevor Sie die Laufzeitkonfiguration abrufen können, müssen Sie den Befehl `update-thing-runtime-configuration` verwenden, um eine Laufzeitkonfiguration für den Kern zu erstellen. ``` aws greengrass get-thing-runtime-configuration \ --thing-name SampleGreengrassCore ``` Ausgabe: ``` { "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "OutOfSync", "Telemetry": "On" } } } ``` Weitere Informationen finden Sie unter [Konfigurieren der Telemetrieeinstellungen](https://docs.aws.amazon.com/greengrass/latest/developerguide/telemetry.html#configure-telemetry-settings) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [GetThingRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-thing-runtime-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `list-bulk-deployment-detailed-reports` Das folgende Codebeispiel zeigt die Verwendung`list-bulk-deployment-detailed-reports`. **AWS CLI** **So listen Sie Informationen zu einzelnen Bereitstellungen in einer Sammelbereitstellung auf** Im folgenden Beispiel für `list-bulk-deployment-detailed-reports` werden Informationen zu den einzelnen Bereitstellungen in einer Sammelbereitstellungsoperation angezeigt, einschließlich des Status. ``` aws greengrass list-bulk-deployment-detailed-reports \ --bulk-deployment-id 42ce9c42-489b-4ed4-b905-8996aa50ef9d ``` Ausgabe: ``` { "Deployments": [ { "DeploymentType": "NewDeployment", "DeploymentStatus": "Success", "DeploymentId": "123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333/deployments/123456789012:123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "GroupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333/versions/123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "CreatedAt": "2020-01-21T21:34:16.501Z" }, { "DeploymentType": "NewDeployment", "DeploymentStatus": "InProgress", "DeploymentId": "123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE55555/deployments/123456789012:123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "GroupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE55555/versions/a1b2c3d4-5678-90ab-cdef-EXAMPLE66666", "CreatedAt": "2020-01-21T21:34:16.486Z" }, ... ] } ``` Weitere Informationen finden Sie unter [Erstellen von Sammelbereitstellungen für Gruppen](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [ListBulkDeploymentDetailedReports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-bulk-deployment-detailed-reports.html)in der *AWS CLI Befehlsreferenz*. ### `list-bulk-deployments` Das folgende Codebeispiel zeigt die Verwendung`list-bulk-deployments`. **AWS CLI** **So listen Sie Sammelbereitstellungen auf** Im folgenden Beispiel für `list-bulk-deployments` werden alle Sammelbereitstellungen aufgelistet. ``` aws greengrass list-bulk-deployments ``` Ausgabe: ``` { "BulkDeployments": [ { "BulkDeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/bulk/deployments/870fb41b-6288-4e0c-bc76-a7ba4b4d3267", "BulkDeploymentId": "870fb41b-6288-4e0c-bc76-a7ba4b4d3267", "CreatedAt": "2019-06-25T16:11:33.265Z" } ] } ``` Weitere Informationen finden Sie unter [Erstellen von Sammelbereitstellungen für Gruppen](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [ListBulkDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-bulk-deployments.html)in der *AWS CLI Befehlsreferenz*. ### `list-connector-definition-versions` Das folgende Codebeispiel zeigt die Verwendung`list-connector-definition-versions`. **AWS CLI** **So listen Sie die für eine Konnektordefinition verfügbaren Versionen auf** Im folgenden Beispiel für `list-connector-definition-versions` werden die Versionen aufgelistet, die für die angegebene Konnektordefinition verfügbar sind. Verwenden Sie den Befehl `list-connector-definitions`, um die Konnektordefinitions-ID abzurufen. ``` aws greengrass list-connector-definition-versions \ --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8" ``` Ausgabe: ``` { "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "Version": "63c57963-c7c2-4a26-a7e2-7bf478ea2623" } ] } ``` Weitere Informationen finden Sie unter [Integration mit Services und Protokollen mithilfe von Greengrass-Konnektoren](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie [ListConnectorDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-connector-definition-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-connector-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-connector-definitions`. **AWS CLI** **So listen Sie die definierten Greengrass-Konnektoren auf** Das folgende `list-connector-definitions` Beispiel listet alle Greengrass-Konnektoren auf, die für Ihr AWS Konto definiert sind. ``` aws greengrass list-connector-definitions ``` Ausgabe: ``` { "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "LastUpdatedTimestamp": "2019-06-19T19:30:01.300Z", "LatestVersion": "63c57963-c7c2-4a26-a7e2-7bf478ea2623", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "Name": "MySNSConnector" } ] } ``` Weitere Informationen finden Sie unter [Integration mit Services und Protokollen mithilfe von Greengrass-Konnektoren](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie [ListConnectorDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-connector-definitions.html)in der *AWS CLI Befehlsreferenz.* ### `list-core-definition-versions` Das folgende Codebeispiel zeigt die Verwendung`list-core-definition-versions`. **AWS CLI** **So listen Sie die Versionen einer Greengrass-Kerndefinition auf** Das folgende `list-core-definitions` Beispiel listet alle Versionen der angegebenen Greengrass-Core-Definition auf. Mit dem Befehl `list-core-definitions` können Sie die Versions-ID abrufen. ``` aws greengrass list-core-definition-versions \ --core-definition-id "eaf280cb-138c-4d15-af36-6f681a1348f7" ``` Ausgabe: ``` { "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/eaf280cb-138c-4d15-af36-6f681a1348f7/versions/467c36e4-c5da-440c-a97b-084e62593b4c", "CreationTimestamp": "2019-06-18T16:14:17.709Z", "Id": "eaf280cb-138c-4d15-af36-6f681a1348f7", "Version": "467c36e4-c5da-440c-a97b-084e62593b4c" } ] } ``` + Einzelheiten zur API finden Sie unter [ListCoreDefinitionVersions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-core-definition-versions.html)*Befehlsreferenz.* ### `list-core-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-core-definitions`. **AWS CLI** **So listen Sie Greengrass-Kerndefinitionen auf** Das folgende `list-core-definitions` Beispiel listet alle Greengrass-Kerndefinitionen für Ihr AWS Konto auf. ``` aws greengrass list-core-definitions ``` Ausgabe: ``` { "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/0507843c-c1ef-4f06-b051-817030df7e7d", "CreationTimestamp": "2018-10-17T04:30:32.786Z", "Id": "0507843c-c1ef-4f06-b051-817030df7e7d", "LastUpdatedTimestamp": "2018-10-17T04:30:32.786Z", "LatestVersion": "bcdf9e86-3793-491e-93af-3cdfbf4e22b7", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/0507843c-c1ef-4f06-b051-817030df7e7d/versions/bcdf9e86-3793-491e-93af-3cdfbf4e22b7" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/31c22500-3509-4271-bafd-cf0655cda438", "CreationTimestamp": "2019-06-18T16:24:16.064Z", "Id": "31c22500-3509-4271-bafd-cf0655cda438", "LastUpdatedTimestamp": "2019-06-18T16:24:16.064Z", "LatestVersion": "2f350395-6d09-4c8a-8336-9ae5b57ace84", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/31c22500-3509-4271-bafd-cf0655cda438/versions/2f350395-6d09-4c8a-8336-9ae5b57ace84" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46", "CreationTimestamp": "2019-06-18T16:21:21.351Z", "Id": "c906ed39-a1e3-4822-a981-7b9bd57b4b46", "LastUpdatedTimestamp": "2019-06-18T16:21:21.351Z", "LatestVersion": "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46/versions/42aeeac3-fd9d-4312-a8fd-ffa9404a20e0" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/eaf280cb-138c-4d15-af36-6f681a1348f7", "CreationTimestamp": "2019-06-18T16:14:17.709Z", "Id": "eaf280cb-138c-4d15-af36-6f681a1348f7", "LastUpdatedTimestamp": "2019-06-18T16:14:17.709Z", "LatestVersion": "467c36e4-c5da-440c-a97b-084e62593b4c", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/eaf280cb-138c-4d15-af36-6f681a1348f7/versions/467c36e4-c5da-440c-a97b-084e62593b4c" } ] } ``` + Einzelheiten zur API finden Sie [ListCoreDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-core-definitions.html)in der *AWS CLI Befehlsreferenz.* ### `list-deployments` Das folgende Codebeispiel zeigt die Verwendung`list-deployments`. **AWS CLI** **So listen Sie die Bereitstellungen für eine Greengrass-Gruppe auf** Im folgenden Beispiel für `list-deployments` werden die Bereitstellungen für die angegebene Greengrass-Gruppe aufgelistet. Mit dem Befehl `list-groups` können Sie Ihre Gruppen-ID abrufen. ``` aws greengrass list-deployments \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" ``` Ausgabe: ``` { "Deployments": [ { "CreatedAt": "2019-06-18T17:04:32.702Z", "DeploymentId": "1065b8a0-812b-4f21-9d5d-e89b232a530f", "DeploymentType": "NewDeployment", "GroupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e" } ] } ``` + Einzelheiten zur API finden Sie [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-deployments.html)in der *AWS CLI Befehlsreferenz*. ### `list-device-definition-versions` Das folgende Codebeispiel zeigt die Verwendung`list-device-definition-versions`. **AWS CLI** **So listen Sie die Versionen einer Gerätedefinition auf** Im folgenden Beispiel für `list-device-definition-versions` werden die Geräte-Definitionsversionen angezeigt, die mit der angegebenen Gerätedefinition verknüpft sind. ``` aws greengrass list-device-definition-versions \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" ``` Ausgabe: ``` { "Versions": [ { "Version": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:15:09.838Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71" }, { "Version": "3b5cc510-58c1-44b5-9d98-4ad858ffa795", "CreationTimestamp": "2019-09-11T00:11:06.197Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/3b5cc510-58c1-44b5-9d98-4ad858ffa795" } ] } ``` + Einzelheiten zur API finden Sie [ListDeviceDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-device-definition-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-device-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-device-definitions`. **AWS CLI** **So listen Sie Ihre Gerätedefinitionen auf** Im folgenden `list-device-definitions` Beispiel werden Details zu den Gerätedefinitionen in Ihrem AWS Konto in der angegebenen AWS Region angezeigt. ``` aws greengrass list-device-definitions \ --region us-west-2 ``` Ausgabe: ``` { "Definitions": [ { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/50f3274c-3f0a-4f57-b114-6f46085281ab/versions/c777b0f5-1059-449b-beaa-f003ebc56c34", "LastUpdatedTimestamp": "2019-06-14T15:42:09.059Z", "LatestVersion": "c777b0f5-1059-449b-beaa-f003ebc56c34", "CreationTimestamp": "2019-06-14T15:42:09.059Z", "Id": "50f3274c-3f0a-4f57-b114-6f46085281ab", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/50f3274c-3f0a-4f57-b114-6f46085281ab" }, { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/e01951c9-6134-479a-969a-1a15cac11c40/versions/514d57aa-4ee6-401c-9fac-938a9f7a51e5", "Name": "TestDeviceDefinition", "LastUpdatedTimestamp": "2019-04-16T23:17:43.245Z", "LatestVersion": "514d57aa-4ee6-401c-9fac-938a9f7a51e5", "CreationTimestamp": "2019-04-16T23:17:43.245Z", "Id": "e01951c9-6134-479a-969a-1a15cac11c40", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/e01951c9-6134-479a-969a-1a15cac11c40" }, { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71", "Name": "TemperatureSensors", "LastUpdatedTimestamp": "2019-09-10T00:19:03.698Z", "LatestVersion": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:11:06.197Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd" } ] } ``` + Einzelheiten zur API finden Sie [ListDeviceDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-device-definitions.html)unter *AWS CLI Befehlsreferenz*. ### `list-function-definition-versions` Das folgende Codebeispiel zeigt die Verwendung`list-function-definition-versions`. **AWS CLI** **So listen Sie die Versionen einer Lambda-Funktion auf** Im folgenden Beispiel für `list-function-definition-versions` werden alle Versionen der angegebenen Lambda-Funktion aufgelistet. Mit dem Befehl `list-function-definitions` können Sie die ID abrufen. ``` aws greengrass list-function-definition-versions \ --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85" ``` Ausgabe: ``` { "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b", "CreationTimestamp": "2019-06-18T17:04:30.776Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "9748fda7-1589-4fcc-ac94-f5559e88678b" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9b08df77-26f2-4c29-93d2-769715edcfec", "CreationTimestamp": "2019-06-18T17:02:44.087Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "9b08df77-26f2-4c29-93d2-769715edcfec" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/4236239f-94f7-4b90-a2f8-2a24c829d21e", "CreationTimestamp": "2019-06-18T17:01:42.284Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "4236239f-94f7-4b90-a2f8-2a24c829d21e" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/343408bb-549a-4fbe-b043-853643179a39", "CreationTimestamp": "2019-06-18T16:21:21.431Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "343408bb-549a-4fbe-b043-853643179a39" } ] } ``` + Einzelheiten zur API finden Sie [ListFunctionDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-function-definition-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-function-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-function-definitions`. **AWS CLI** **So listen Sie Lambda-Funktionen auf** Das folgende `list-function-definitions` Beispiel listet alle Lambda-Funktionen auf, die für Ihr AWS Konto definiert sind. ``` aws greengrass list-function-definitions ``` Ausgabe: ``` { "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/017970a5-8952-46dd-b1c1-020b3ae8e960", "CreationTimestamp": "2018-10-17T04:30:32.884Z", "Id": "017970a5-8952-46dd-b1c1-020b3ae8e960", "LastUpdatedTimestamp": "2018-10-17T04:30:32.884Z", "LatestVersion": "4380b302-790d-4ed8-92bf-02e88afecb15", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/017970a5-8952-46dd-b1c1-020b3ae8e960/versions/4380b302-790d-4ed8-92bf-02e88afecb15" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "CreationTimestamp": "2019-06-18T16:21:21.431Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "LastUpdatedTimestamp": "2019-06-18T16:21:21.431Z", "LatestVersion": "9748fda7-1589-4fcc-ac94-f5559e88678b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/6598e653-a262-440c-9967-e2697f64da7b", "CreationTimestamp": "2019-06-18T16:24:16.123Z", "Id": "6598e653-a262-440c-9967-e2697f64da7b", "LastUpdatedTimestamp": "2019-06-18T16:24:16.123Z", "LatestVersion": "38bc6ccd-98a2-4ce7-997e-16c84748fae4", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/6598e653-a262-440c-9967-e2697f64da7b/versions/38bc6ccd-98a2-4ce7-997e-16c84748fae4" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/c668df84-fad2-491b-95f4-655d2cad7885", "CreationTimestamp": "2019-06-18T16:14:17.784Z", "Id": "c668df84-fad2-491b-95f4-655d2cad7885", "LastUpdatedTimestamp": "2019-06-18T16:14:17.784Z", "LatestVersion": "37dd68c4-a64f-40ba-aa13-71fecc3ebded", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/c668df84-fad2-491b-95f4-655d2cad7885/versions/37dd68c4-a64f-40ba-aa13-71fecc3ebded" } ] } ``` + Einzelheiten zur API finden Sie [ListFunctionDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-function-definitions.html)in der *AWS CLI Befehlsreferenz.* ### `list-group-certificate-authorities` Das folgende Codebeispiel zeigt die Verwendung`list-group-certificate-authorities`. **AWS CLI** **Um die aktuellen Daten CAs für eine Gruppe aufzulisten** Das folgende `list-group-certificate-authorities` Beispiel listet die aktuellen Zertifizierungsstellen (CAs) für die angegebene Greengrass-Gruppe auf. ``` aws greengrass list-group-certificate-authorities \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" ``` Ausgabe: ``` { "GroupCertificateAuthorities": [ { "GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/certificateauthorities/f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6", "GroupCertificateAuthorityId": "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6" } ] } ``` + Einzelheiten zur API finden Sie unter [ListGroupCertificateAuthorities AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-group-certificate-authorities.html)*Befehlsreferenz.* ### `list-group-versions` Das folgende Codebeispiel zeigt die Verwendung`list-group-versions`. **AWS CLI** **So listen Sie die Versionen einer Greengrass-Gruppe auf** Im folgenden Beispiel für `list-group-versions` werden die Versionen der angegebenen Greengrass-Gruppe aufgelistet. ``` aws greengrass list-group-versions \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" ``` Ausgabe: ``` { "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e", "CreationTimestamp": "2019-06-18T17:04:30.915Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "115136b3-cfd7-4462-b77f-8741a4b00e5e" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/4340669d-d14d-44e3-920c-46c928750750", "CreationTimestamp": "2019-06-18T17:03:52.663Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "4340669d-d14d-44e3-920c-46c928750750" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/1b06e099-2d5b-4f10-91b9-78c4e060f5da", "CreationTimestamp": "2019-06-18T17:02:44.189Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "1b06e099-2d5b-4f10-91b9-78c4e060f5da" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/2d3f27f1-3b43-4554-ab7a-73ec30477efe", "CreationTimestamp": "2019-06-18T17:01:42.401Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "2d3f27f1-3b43-4554-ab7a-73ec30477efe" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/d20f7ae9-3444-4c1c-b025-e2ede23cdd31", "CreationTimestamp": "2019-06-18T16:21:21.457Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "d20f7ae9-3444-4c1c-b025-e2ede23cdd31" } ] } ``` + Einzelheiten zur API finden Sie [ListGroupVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-group-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-groups` Das folgende Codebeispiel zeigt die Verwendung`list-groups`. **AWS CLI** **So listen Sie die Greengrass-Gruppen auf** Das folgende `list-groups` Beispiel listet alle Greengrass-Gruppen auf, die in Ihrem AWS Konto definiert sind. ``` aws greengrass list-groups ``` Ausgabe: ``` { "Groups": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731", "CreationTimestamp": "2019-06-18T16:21:21.457Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "LastUpdatedTimestamp": "2019-06-18T16:21:21.457Z", "LatestVersion": "115136b3-cfd7-4462-b77f-8741a4b00e5e", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e", "Name": "GGGroup4Pi3" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1402daf9-71cf-4cfe-8be0-d5e80526d0d8", "CreationTimestamp": "2018-10-31T21:52:46.603Z", "Id": "1402daf9-71cf-4cfe-8be0-d5e80526d0d8", "LastUpdatedTimestamp": "2018-10-31T21:52:46.603Z", "LatestVersion": "749af901-60ab-456f-a096-91b12d983c29", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1402daf9-71cf-4cfe-8be0-d5e80526d0d8/versions/749af901-60ab-456f-a096-91b12d983c29", "Name": "MyTestGroup" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/504b5c8d-bbed-4635-aff1-48ec5b586db5", "CreationTimestamp": "2018-12-31T21:39:36.771Z", "Id": "504b5c8d-bbed-4635-aff1-48ec5b586db5", "LastUpdatedTimestamp": "2018-12-31T21:39:36.771Z", "LatestVersion": "46911e8e-f9bc-4898-8b63-59c7653636ec", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/504b5c8d-bbed-4635-aff1-48ec5b586db5/versions/46911e8e-f9bc-4898-8b63-59c7653636ec", "Name": "smp-ggrass-group" } ] } ``` + Einzelheiten zur API finden Sie [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-groups.html)in der *AWS CLI Befehlsreferenz.* ### `list-logger-definition-versions` Das folgende Codebeispiel zeigt die Verwendung`list-logger-definition-versions`. **AWS CLI** **So rufen Sie eine Liste der Versionen einer Logger-Definition ab** Im folgenden Beispiel für `list-logger-definition-versions` wird eine Liste aller Versionen der angegebenen Logger-Definition abgerufen. ``` aws greengrass list-logger-definition-versions \ --logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23" ``` Ausgabe: ``` { "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "CreationTimestamp": "2019-05-08T16:10:13.866Z", "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "Version": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/3ec6d3af-eb85-48f9-a16d-1c795fe696d7", "CreationTimestamp": "2019-05-08T16:10:13.809Z", "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "Version": "3ec6d3af-eb85-48f9-a16d-1c795fe696d7" } ] } ``` + Einzelheiten zur API finden Sie [ListLoggerDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-logger-definition-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-logger-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-logger-definitions`. **AWS CLI** **So rufen Sie eine Liste von Logger-Definitionen ab** Das folgende `list-logger-definitions` Beispiel listet alle Logger-Definitionen für Ihr AWS Konto auf. ``` aws greengrass list-logger-definitions ``` Ausgabe: ``` { "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23", "CreationTimestamp": "2019-05-08T16:10:13.809Z", "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "LastUpdatedTimestamp": "2019-05-08T16:10:13.809Z", "LatestVersion": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073" } ] } ``` + Einzelheiten zur API finden Sie [ListLoggerDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-logger-definitions.html)in der *AWS CLI Befehlsreferenz*. ### `list-resource-definition-versions` Das folgende Codebeispiel zeigt die Verwendung`list-resource-definition-versions`. **AWS CLI** **So listen Sie die Versionen einer Ressourcendefinition auf** Im folgenden Beispiel für `list-resource-definition-versions` werden die Versionen für die angegebene Greengrass-Ressource aufgelistet. ``` aws greengrass list-resource-definition-versions \ --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658" ``` Ausgabe: ``` { "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be", "CreationTimestamp": "2019-06-19T16:40:59.392Z", "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "Version": "26e8829a-491a-464d-9c87-664bf6f6f2be" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/432d92f6-12de-4ec9-a704-619a942a62aa", "CreationTimestamp": "2019-06-19T16:40:59.261Z", "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "Version": "432d92f6-12de-4ec9-a704-619a942a62aa" } ] } ``` + Einzelheiten zur API finden Sie [ListResourceDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-resource-definition-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-resource-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-resource-definitions`. **AWS CLI** **So listen Sie die definierten Ressourcen auf** Das folgende `list-resource-definitions` Beispiel listet die Ressourcen auf, die für die Verwendung von AWS IoT Greengrass definiert sind. ``` aws greengrass list-resource-definitions ``` Ausgabe: ``` { "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658", "CreationTimestamp": "2019-06-19T16:40:59.261Z", "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "LastUpdatedTimestamp": "2019-06-19T16:40:59.261Z", "LatestVersion": "26e8829a-491a-464d-9c87-664bf6f6f2be", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "CreationTimestamp": "2019-06-19T21:51:28.212Z", "Id": "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "LastUpdatedTimestamp": "2019-06-19T21:51:28.212Z", "LatestVersion": "a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1", "Name": "MyGreengrassResources" } ] } ``` + Einzelheiten zur API finden Sie unter [ListResourceDefinitions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-resource-definitions.html)*Befehlsreferenz.* ### `list-subscription-definition-versions` Das folgende Codebeispiel zeigt die Verwendung`list-subscription-definition-versions`. **AWS CLI** **So listen Sie die Versionen einer Abonnementdefinition auf** Im folgenden Beispiel für `list-subscription-definition-versions` werden alle Versionen des angegebenen Abonnements aufgelistet. Mit dem Befehl `list-subscription-definitions` können Sie die Abonnement-ID abrufen. ``` aws greengrass list-subscription-definition-versions \ --subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152" ``` Ausgabe: ``` { "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b", "CreationTimestamp": "2019-06-18T17:03:52.499Z", "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "Version": "88ae8699-12ac-4663-ba3f-4d7f0519140b" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/7e320ba3-c369-4069-a2f0-90acb7f219d6", "CreationTimestamp": "2019-06-18T17:03:52.392Z", "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "Version": "7e320ba3-c369-4069-a2f0-90acb7f219d6" } ] } ``` + Einzelheiten zur API finden Sie [ListSubscriptionDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-subscription-definition-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-subscription-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-subscription-definitions`. **AWS CLI** **So rufen Sie eine Liste der Abonnementdefinitionen ab** Das folgende `list-subscription-definitions` Beispiel listet alle AWS IoT Greengrass-Abonnements auf, die in Ihrem AWS Konto definiert sind. ``` aws greengrass list-subscription-definitions ``` Ausgabe: ``` { "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152", "CreationTimestamp": "2019-06-18T17:03:52.392Z", "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "LastUpdatedTimestamp": "2019-06-18T17:03:52.392Z", "LatestVersion": "88ae8699-12ac-4663-ba3f-4d7f0519140b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/cd6f1c37-d9a4-4e90-be94-01a7404f5967", "CreationTimestamp": "2018-10-18T15:45:34.024Z", "Id": "cd6f1c37-d9a4-4e90-be94-01a7404f5967", "LastUpdatedTimestamp": "2018-10-18T15:45:34.024Z", "LatestVersion": "d1cf8fac-284f-4f6a-98fe-a2d36d089373", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/cd6f1c37-d9a4-4e90-be94-01a7404f5967/versions/d1cf8fac-284f-4f6a-98fe-a2d36d089373" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/fa81bc84-3f59-4377-a84b-5d0134da359b", "CreationTimestamp": "2018-10-22T17:09:31.429Z", "Id": "fa81bc84-3f59-4377-a84b-5d0134da359b", "LastUpdatedTimestamp": "2018-10-22T17:09:31.429Z", "LatestVersion": "086d1b08-b25a-477c-a16f-6f9b3a9c295a", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/fa81bc84-3f59-4377-a84b-5d0134da359b/versions/086d1b08-b25a-477c-a16f-6f9b3a9c295a" } ] } ``` + Einzelheiten zur API finden Sie unter [ListSubscriptionDefinitions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-subscription-definitions.html)*Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die mit einer Ressource verknüpften Tags auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags und ihre Werte aufgelistet, die mit der angegebenen Ressource verknüpft sind. ``` aws greengrass list-tags-for-resource \ --resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658" ``` Ausgabe: ``` { "tags": { "ResourceSubType": "USB", "ResourceType": "Device" } } ``` Weitere Informationen finden Sie unter [Versehen Ihrer Greengrass-Ressourcen mit Tags](https://docs.aws.amazon.com/greengrass/latest/developerguide/tagging.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `reset-deployments` Das folgende Codebeispiel zeigt die Verwendung`reset-deployments`. **AWS CLI** **So bereinigen Sie Bereitstellungsinformationen für eine Greengrass-Gruppe** Im folgenden Beispiel für `reset-deployments` werden Bereitstellungsinformationen für die angegebene Greengrass-Gruppe bereinigt. Wenn Sie die `--force option` hinzufügen, werden die Bereitstellungsinformationen zurückgesetzt, ohne auf die Antwort des Kerngeräts zu warten. ``` aws greengrass reset-deployments \ --group-id "1402daf9-71cf-4cfe-8be0-d5e80526d0d8" \ --force ``` Ausgabe: ``` { "DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1402daf9-71cf-4cfe-8be0-d5e80526d0d8/deployments/7dd4e356-9882-46a3-9e28-6d21900c011a", "DeploymentId": "7dd4e356-9882-46a3-9e28-6d21900c011a" } ``` Weitere Informationen finden Sie unter [Zurücksetzen von Bereitstellungen](https://docs.aws.amazon.com/greengrass/latest/developerguide/reset-deployments-scenario.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [ResetDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/reset-deployments.html)in der *AWS CLI Befehlsreferenz*. ### `start-bulk-deployment` Das folgende Codebeispiel zeigt die Verwendung`start-bulk-deployment`. **AWS CLI** **So starten Sie eine Sammelbereitstellungsoperation** Im folgenden Beispiel für `start-bulk-deployment` wird eine Sammelbereitstellungsoperation gestartet, wobei eine in einem S3-Bucket gespeicherte Datei verwendet wird, um die bereitzustellenden Gruppen anzugeben. ``` aws greengrass start-bulk-deployment \ --cli-input-json "{\"InputFileUri\":\"https://gg-group-deployment1.s3-us-west-2.amazonaws.com/MyBulkDeploymentInputFile.txt\", \"ExecutionRoleArn\":\"arn:aws:iam::123456789012:role/ggCreateDeploymentRole\",\"AmznClientToken\":\"yourAmazonClientToken\"}" ``` Ausgabe: ``` { "BulkDeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/bulk/deployments/870fb41b-6288-4e0c-bc76-a7ba4b4d3267", "BulkDeploymentId": "870fb41b-6288-4e0c-bc76-a7ba4b4d3267" } ``` Weitere Informationen finden Sie unter [Erstellen von Sammelbereitstellungen für Gruppen](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [StartBulkDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/start-bulk-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `stop-bulk-deployment` Das folgende Codebeispiel zeigt die Verwendung`stop-bulk-deployment`. **AWS CLI** **So stoppen Sie eine Sammelbereitstellung** Im folgenden Beispiel für `stop-bulk-deployment` wird die angegebene Sammelbereitstellung gestoppt. Wenn Sie versuchen, eine abgeschlossene Sammelbereitstellung zu stoppen, wird eine Fehlermeldung angezeigt: `InvalidInputException: Cannot change state of finished execution.` ``` aws greengrass stop-bulk-deployment \ --bulk-deployment-id "870fb41b-6288-4e0c-bc76-a7ba4b4d3267" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen von Sammelbereitstellungen für Gruppen](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [StopBulkDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/stop-bulk-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So wenden Sie Tags auf eine Ressource an** Im folgenden Beispiel für `tag-resource` werden zwei Tags, `ResourceType` und `ResourceSubType`, auf die angegebene Greengrass-Ressource angewendet. Diese Operation kann sowohl neue Tags und Werte hinzufügen als auch den Wert vorhandener Tags aktualisieren. Mit dem Befehl `untag-resource` können Sie ein Tag entfernen. ``` aws greengrass tag-resource \ --resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658" \ --tags "ResourceType=Device,ResourceSubType=USB" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Versehen Ihrer Greengrass-Ressourcen mit Tags](https://docs.aws.amazon.com/greengrass/latest/developerguide/tagging.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag und dessen Wert aus einer Ressource** Im folgenden Beispiel für `untag-resource` wird der Tag mit dem Schlüssel `Category` aus der angegebenen Greengrass-Gruppe gelöscht. Wenn der Schlüssel `Category` für die angegebene Ressource nicht existiert, wird kein Fehler zurückgegeben. ``` aws greengrass untag-resource \ --resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731" \ --tag-keys "Category" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Versehen Ihrer Greengrass-Ressourcen mit Tags](https://docs.aws.amazon.com/greengrass/latest/developerguide/tagging.html) im **Entwicklerhandbuch für AWS IoT Greengrass**. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-connectivity-info` Das folgende Codebeispiel zeigt die Verwendung`update-connectivity-info`. **AWS CLI** **So aktualisieren Sie die Verbindungsinformationen für einen Greengrass-Kern** Im folgenden Beispiel für `update-connectivity-info` werden die Endpunkte geändert, über die Geräte eine Verbindung zum angegebenen Greengrass-Kern herstellen können. Bei den Verbindungsinformationen handelt es sich um eine Liste von IP-Adressen oder Domainnamen mit den entsprechenden Portnummern und optionalen, vom Kunden definierten Metadaten. Möglicherweise müssen Sie die Verbindungsinformationen aktualisieren, wenn sich das lokale Netzwerk ändert. ``` aws greengrass update-connectivity-info \ --thing-name "MyGroup_Core" \ --connectivity-info "[{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"127.0.0.1\",\"Id\":\"localhost_127.0.0.1_0\"},{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"192.168.1.3\",\"Id\":\"localIP_192.168.1.3\"}]" ``` Ausgabe: ``` { "Version": "312de337-59af-4cf9-a278-2a23bd39c300" } ``` + Einzelheiten zur API finden Sie [UpdateConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-connectivity-info.html)in der *AWS CLI Befehlsreferenz*. ### `update-connector-definition` Das folgende Codebeispiel zeigt die Verwendung`update-connector-definition`. **AWS CLI** **So aktualisieren Sie den Namen für eine Konnektordefinition** Im folgenden Beispiel für `update-connector-definition` wird der Name für die angegebene Konnektordefinition aktualisiert. Wenn Sie die Details für den Konnektor aktualisieren möchten, verwenden Sie den Befehl `create-connector-definition-version`, um eine neue Version zu erstellen. ``` aws greengrass update-connector-definition \ --connector-definition-id "55d0052b-0d7d-44d6-b56f-21867215e118" \ --name "GreengrassConnectors2019" ``` Weitere Informationen finden Sie unter [Integration mit Services und Protokollen mithilfe von Konnektoren](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [UpdateConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-connector-definition.html)in der *AWS CLI Befehlsreferenz*. ### `update-core-definition` Das folgende Codebeispiel zeigt die Verwendung`update-core-definition`. **AWS CLI** **So aktualisieren Sie eine Kerndefinition** Im folgenden Beispiel für `update-core-definition` wird der Name der angegebenen Kerndefinition geändert. Sie können nur die Eigenschaft `name` einer Kerndefinition aktualisieren. ``` aws greengrass update-core-definition \ --core-definition-id "582efe12-b05a-409e-9a24-a2ba1bcc4a12" \ --name "MyCoreDevices" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Configure the AWS IoT Greengrass Core](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-core.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie unter [UpdateCoreDefinition AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-core-definition.html)*Befehlsreferenz*. ### `update-device-definition` Das folgende Codebeispiel zeigt die Verwendung`update-device-definition`. **AWS CLI** **So aktualisieren Sie eine Gerätedefinition** Im folgenden Beispiel für `update-device-definition` wird der Name der angegebenen Gerätedefinition geändert. Sie können nur die Eigenschaft `name` einer Gerätedefinition aktualisieren. ``` aws greengrass update-device-definition \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \ --name "TemperatureSensors" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UpdateDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-device-definition.html)in der *AWS CLI Befehlsreferenz*. ### `update-function-definition` Das folgende Codebeispiel zeigt die Verwendung`update-function-definition`. **AWS CLI** **So aktualisieren Sie den Namen für eine Funktionsdefinition** Im folgenden Beispiel für `update-function-definition` wird der Name für die angegebene Funktionsdefinition aktualisiert. Wenn Sie die Details für die Funktion aktualisieren möchten, verwenden Sie den Befehl `create-function-definition-version`, um eine neue Version zu erstellen. ``` aws greengrass update-function-definition \ --function-definition-id "e47952bd-dea9-4e2c-a7e1-37bbe8807f46" \ --name ObsoleteFunction ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ausführen von lokalen Lambda-Funktionen](https://docs.aws.amazon.com/greengrass/latest/developerguide/lambda-functions.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [UpdateFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-function-definition.html)in der *AWS CLI Befehlsreferenz*. ### `update-group-certificate-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-group-certificate-configuration`. **AWS CLI** **So aktualisieren Sie den Ablauf der Zertifikate einer Gruppe** Im folgenden Beispiel für `update-group-certificate-configuration` wird ein Ablauf von 10 Tagen für die für die angegebene Gruppe generierten Zertifikate festgelegt. ``` aws greengrass update-group-certificate-configuration \ --group-id "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1" \ --certificate-expiry-in-milliseconds 864000000 ``` Ausgabe: ``` { "CertificateExpiryInMilliseconds": 864000000, "CertificateAuthorityExpiryInMilliseconds": 2524607999000, "GroupId": "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1" } ``` Weitere Informationen finden Sie unter [Sicherheit in AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-sec.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [UpdateGroupCertificateConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-group-certificate-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `update-group` Das folgende Codebeispiel zeigt die Verwendung`update-group`. **AWS CLI** **So aktualisieren Sie den Gruppennamen** Im folgenden Beispiel für `update-group` wird der Name der angegebenen Greengrass-Gruppe aktualisiert. Wenn Sie die Details für die Gruppe aktualisieren möchten, verwenden Sie den Befehl `create-group-version`, um eine neue Version zu erstellen. ``` aws greengrass update-group \ --group-id "1402daf9-71cf-4cfe-8be0-d5e80526d0d8" \ --name TestGroup4of6 ``` Weitere Informationen finden [Sie unter Configure AWS IoT Greengrass on AWS IoT im AWS IoT](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-config.html) *Greengrass Developer Guide*. + Einzelheiten zur API finden Sie unter [UpdateGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-group.html)*Befehlsreferenz*. ### `update-logger-definition` Das folgende Codebeispiel zeigt die Verwendung`update-logger-definition`. **AWS CLI** **So aktualisieren Sie eine Logger-Definition** Im folgenden Beispiel für `update-logger-definition` wird der Name der angegebenen Logger-Definition geändert. Sie können nur die Eigenschaft `name` einer Logger-Definition aktualisieren. ``` aws greengrass update-logger-definition \ --logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" \ --name "LoggingConfigsForSensors" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Monitoring with AWS IoT Greengrass Logs](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) im *AWS IoT Greengrass Developer Guide*. + Einzelheiten zur API finden Sie [UpdateLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-logger-definition.html)in der *AWS CLI Befehlsreferenz*. ### `update-resource-definition` Das folgende Codebeispiel zeigt die Verwendung`update-resource-definition`. **AWS CLI** **So aktualisieren Sie den Namen für eine Ressourcendefinition** Im folgenden Beispiel für `update-resource-definition` wird der Name für die angegebene Ressourcendefinition aktualisiert. Wenn Sie die Details für die Ressource ändern möchten, verwenden Sie den Befehl `create-resource-definition-version`, um eine neue Version zu erstellen. ``` aws greengrass update-resource-definition \ --resource-definition-id "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38" \ --name GreengrassConnectorResources ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Zugriff auf lokale Ressourcen mit Lambda-Funktionen und -Konnektoren](https://docs.aws.amazon.com/greengrass/latest/developerguide/access-local-resources.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [UpdateResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-resource-definition.html)in der *AWS CLI Befehlsreferenz*. ### `update-subscription-definition` Das folgende Codebeispiel zeigt die Verwendung`update-subscription-definition`. **AWS CLI** **So aktualisieren Sie den Namen für eine Abonnementdefinition** Im folgenden Beispiel für `update-subscription-definition` wird der Name für die angegebene Abonnementdefinition aktualisiert. Wenn Sie Details für das Abonnement ändern möchten, verwenden Sie den Befehl `create-subscription-definition-version`, um eine neue Version zu erstellen. ``` aws greengrass update-subscription-definition \ --subscription-definition-id "fa81bc84-3f59-4377-a84b-5d0134da359b" \ --name "ObsoleteSubscription" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter „Titel“ im *Handbuch*. + Einzelheiten zur API finden Sie [UpdateSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-subscription-definition.html)in der *AWS CLI Befehlsreferenz*. ### `update-thing-runtime-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-thing-runtime-configuration`. **AWS CLI** **So aktivieren Sie die Telemetrie in der Laufzeitkonfiguration eines Greengrass-Kerns** Im folgenden Beispiel für `update-thing-runtime-configuration` wird die Laufzeitkonfiguration eines Greengrass-Kerns aktualisiert, um die Telemetrie zu aktivieren. ``` aws greengrass update-thing-runtime-configuration \ --thing-name SampleGreengrassCore \ --telemetry-configuration {\"Telemetry\":\"On\"} ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurieren der Telemetrieeinstellungen](https://docs.aws.amazon.com/greengrass/latest/developerguide/telemetry.html#configure-telemetry-settings) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [UpdateThingRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-thing-runtime-configuration.html)in der *AWS CLI Befehlsreferenz*. # AWS IoT Greengrass V2 Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT Greengrass V2. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-service-role-to-account` Das folgende Codebeispiel zeigt, wie Sie`associate-service-role-to-account`. **AWS CLI** **Um die Greengrass-Servicerolle mit Ihrem AWS Konto zu verknüpfen** Das folgende `associate-service-role-to-account` Beispiel ordnet AWS IoT Greengrass eine Servicerolle für Ihr AWS Konto zu. ``` aws greengrassv2 associate-service-role-to-account \ --role-arn arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole ``` Ausgabe: ``` { "associatedAt": "2022-01-19T19:21:53Z" } ``` Weitere Informationen finden Sie unter [Greengrass-Servicerolle](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie [AssociateServiceRoleToAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/associate-service-role-to-account.html)in der *AWS CLI Befehlsreferenz.* ### `batch-associate-client-device-with-core-device` Das folgende Codebeispiel zeigt die Verwendung`batch-associate-client-device-with-core-device`. **AWS CLI** **So verknüpfen Sie Client-Geräte mit einem Kerngerät** Im folgenden Beispiel für `batch-associate-client-device-with-core-device` werden zwei Client-Geräte mit einem Kerngerät verknüpft. ``` aws greengrassv2 batch-associate-client-device-with-core-device \ --core-device-thing-name MyGreengrassCore \ --entries thingName=MyClientDevice1 thingName=MyClientDevice2 ``` Ausgabe: ``` { "errorEntries": [] } ``` Weitere Informationen finden Sie unter [Mit lokalen IoT-Geräten interagieren](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [BatchAssociateClientDeviceWithCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/batch-associate-client-device-with-core-device.html)in der *AWS CLI Befehlsreferenz*. ### `batch-disassociate-client-device-from-core-device` Das folgende Codebeispiel zeigt die Verwendung`batch-disassociate-client-device-from-core-device`. **AWS CLI** **So trennen Sie Client-Geräte von einem Kerngerät** Im folgenden Beispiel für `batch-disassociate-client-device-from-core-device` werden zwei Client-Geräte von einem Kerngerät getrennt. ``` aws greengrassv2 batch-disassociate-client-device-from-core-device \ --core-device-thing-name MyGreengrassCore \ --entries thingName=MyClientDevice1 thingName=MyClientDevice2 ``` Ausgabe: ``` { "errorEntries": [] } ``` Weitere Informationen finden Sie unter [Mit lokalen IoT-Geräten interagieren](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [BatchDisassociateClientDeviceFromCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/batch-disassociate-client-device-from-core-device.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-deployment` Das folgende Codebeispiel zeigt die Verwendung`cancel-deployment`. **AWS CLI** **So brechen Sie einen Bereitstellung ab** Im folgenden Beispiel für `cancel-deployment` wird eine kontinuierliche Bereitstellung auf einer Objektgruppe abgebrochen. ``` aws greengrassv2 cancel-deployment \ --deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "message": "SUCCESS" } ``` Weitere Informationen finden Sie unter [Abbrechen von Bereitstellungen](https://docs.aws.amazon.com/greengrass/v2/developerguide/cancel-deployments.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [CancelDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/cancel-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `create-component-version` Das folgende Codebeispiel zeigt die Verwendung`create-component-version`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Komponentenversion anhand eines Rezepts** Im folgenden Beispiel für `create-component-version` wird eine Version einer Hello-World-Komponente anhand einer Rezeptdatei erstellt. ``` aws greengrassv2 create-component-version \ --inline-recipe fileb://com.example.HelloWorld-1.0.0.json ``` Inhalt von `com.example.HelloWorld-1.0.0.json`: ``` { "RecipeFormatVersion": "2020-01-25", "ComponentName": "com.example.HelloWorld", "ComponentVersion": "1.0.0", "ComponentDescription": "My first AWS IoT Greengrass component.", "ComponentPublisher": "Amazon", "ComponentConfiguration": { "DefaultConfiguration": { "Message": "world" } }, "Manifests": [ { "Platform": { "os": "linux" }, "Lifecycle": { "Run": "echo 'Hello {configuration:/Message}'" } } ] } ``` Ausgabe: ``` { "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0", "componentName": "com.example.HelloWorld", "componentVersion": "1.0.0", "creationTimestamp": "2021-01-07T16:24:33.650000-08:00", "status": { "componentState": "REQUESTED", "message": "NONE", "errors": {} } } ``` Weitere Informationen finden Sie unter [Erstellen von benutzerdefinierten Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-components.html) und [Hochladen von Komponenten zur Bereitstellung](https://docs.aws.amazon.com/greengrass/v2/developerguide/upload-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. **Beispiel 2: So erstellen Sie eine Komponentenversion aus einer AWS Lambda-Funktion** Im folgenden `create-component-version` Beispiel wird eine Version einer Hello World-Komponente aus einer AWS Lambda-Funktion erstellt. ``` aws greengrassv2 create-component-version \ --cli-input-json file://lambda-function-component.json ``` Inhalt von `lambda-function-component.json`: ``` { "lambdaFunction": { "lambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:HelloWorldPythonLambda:1", "componentName": "com.example.HelloWorld", "componentVersion": "1.0.0", "componentLambdaParameters": { "eventSources": [ { "topic": "hello/world/+", "type": "IOT_CORE" } ] } } } ``` Ausgabe: ``` { "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0", "componentName": "com.example.HelloWorld", "componentVersion": "1.0.0", "creationTimestamp": "2021-01-07T17:05:27.347000-08:00", "status": { "componentState": "REQUESTED", "message": "NONE", "errors": {} } } ``` Weitere Informationen finden Sie unter [Ausführen von AWS Lambda-Funktionen](https://docs.aws.amazon.com/greengrass/v2/developerguide/run-lambda-functions.html) im *AWS IoT Greengrass V2 Developer Guide*. + Einzelheiten zur API finden Sie unter [CreateComponentVersion AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/create-component-version.html)*Befehlsreferenz*. ### `create-deployment` Das folgende Codebeispiel zeigt die Verwendung`create-deployment`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Bereitstellung** Im folgenden `create-deployment` Beispiel wird die AWS IoT Greengrass-Befehlszeilenschnittstelle auf einem Kerngerät bereitgestellt. ``` aws greengrassv2 create-deployment \ --cli-input-json file://cli-deployment.json ``` Inhalt von `cli-deployment.json`: ``` { "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore", "deploymentName": "Deployment for MyGreengrassCore", "components": { "aws.greengrass.Cli": { "componentVersion": "2.0.3" } }, "deploymentPolicies": { "failureHandlingPolicy": "DO_NOTHING", "componentUpdatePolicy": { "timeoutInSeconds": 60, "action": "NOTIFY_COMPONENTS" }, "configurationValidationPolicy": { "timeoutInSeconds": 60 } }, "iotJobConfiguration": {} } ``` Ausgabe: ``` { "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. **Beispiel 2: So erstellen Sie eine Bereitstellung, die Komponentenkonfigurationen aktualisiert** Im folgenden `create-deployment` Beispiel wird die Nucleus-Komponente AWS IoT Greengrass für eine Gruppe von Kerngeräten bereitgestellt. Bei dieser Bereitstellung werden für die Nucleus-Komponente die folgenden Konfigurationsupdates angewendet: Setzt die Proxy-Einstellungen der Zielgeräte auf die Standardeinstellungen ohne Proxy zurück. Setzt die MQTT-Einstellungen der Zielgeräte auf ihre Standardwerte zurück. Legt die JVM-Optionen für die JVM des Nucleus fest. Legt die Protokollierungsebene für den Nucleus fest. ``` aws greengrassv2 create-deployment \ --cli-input-json file://nucleus-deployment.json ``` Inhalt von `nucleus-deployment.json`: ``` { "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup", "deploymentName": "Deployment for MyGreengrassCoreGroup", "components": { "aws.greengrass.Nucleus": { "componentVersion": "2.0.3", "configurationUpdate": { "reset": [ "/networkProxy", "/mqtt" ], "merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}" } } }, "deploymentPolicies": { "failureHandlingPolicy": "ROLLBACK", "componentUpdatePolicy": { "timeoutInSeconds": 60, "action": "NOTIFY_COMPONENTS" }, "configurationValidationPolicy": { "timeoutInSeconds": 60 } }, "iotJobConfiguration": {} } ``` Ausgabe: ``` { "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ``` Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) und [Aktualisieren von Komponentenkonfigurationen](https://docs.aws.amazon.com/greengrass/v2/developerguide/update-component-configurations.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/create-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `delete-component` Das folgende Codebeispiel zeigt die Verwendung`delete-component`. **AWS CLI** **So löschen Sie eine Komponentenversion** Im folgenden Beispiel für `delete-component` wird eine Hello-World-Komponente gelöscht. ``` aws greengrassv2 delete-component \ --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [DeleteComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-component.html)in der *AWS CLI Befehlsreferenz*. ### `delete-core-device` Das folgende Codebeispiel zeigt die Verwendung`delete-core-device`. **AWS CLI** **So löschen Sie ein Kerngerät** Im folgenden `delete-core-device` Beispiel wird ein AWS IoT-Greengrass-Core-Gerät gelöscht. ``` aws greengrassv2 delete-core-device \ --core-device-thing-name MyGreengrassCore ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Deinstallieren der AWS IoT Greengrass Core-Software](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#uninstall-greengrass-core-v2) im *AWS IoT Greengrass V2 Developer Guide*. + Einzelheiten zur API finden Sie unter [DeleteCoreDevice AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-core-device.html)*Befehlsreferenz*. ### `describe-component` Das folgende Codebeispiel zeigt die Verwendung`describe-component`. **AWS CLI** **So beschreiben Sie eine Komponentenversion** Im folgenden Beispiel für `describe-component` wird eine Hello-World-Komponente beschrieben. ``` aws greengrassv2 describe-component \ --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0 ``` Ausgabe: ``` { "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0", "componentName": "com.example.HelloWorld", "componentVersion": "1.0.0", "creationTimestamp": "2021-01-07T17:12:11.133000-08:00", "publisher": "Amazon", "description": "My first AWS IoT Greengrass component.", "status": { "componentState": "DEPLOYABLE", "message": "NONE", "errors": {} }, "platforms": [ { "attributes": { "os": "linux" } } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [DescribeComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/describe-component.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-service-role-from-account` Das folgende Codebeispiel zeigt die Verwendung`disassociate-service-role-from-account`. **AWS CLI** **Um die Greengrass-Servicerolle von Ihrem Konto zu trennen AWS ** Im folgenden `disassociate-service-role-from-account` Beispiel wird die Greengrass-Servicerolle für Ihr Konto von AWS IoT Greengrass getrennt. AWS ``` aws greengrassv2 disassociate-service-role-from-account ``` Ausgabe: ``` { "disassociatedAt": "2022-01-19T19:26:09Z" } ``` Weitere Informationen finden Sie unter [Greengrass-Servicerolle](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [DisassociateServiceRoleFromAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/disassociate-service-role-from-account.html).AWS CLI * ### `get-component-version-artifact` Das folgende Codebeispiel zeigt die Verwendung`get-component-version-artifact`. **AWS CLI** **So rufen Sie eine URL zum Herunterladen eines Komponentenartefakts ab** Im folgenden Beispiel für `get-component-version-artifact` wird eine URL zum Herunterladen der JAR-Datei der lokalen Debug-Konsolenkomponente abgerufen. ``` aws greengrassv2 get-component-version-artifact \ --arn arn:aws:greengrass:us-west-2:aws:components:aws.greengrass.LocalDebugConsole:versions:2.0.3 \ --artifact-name "Uvt6ZEzQ9TKiAuLbfXBX_APdY0TWks3uc46tHFHTzBM=/aws.greengrass.LocalDebugConsole.jar" ``` Ausgabe: ``` { "preSignedUrl": "https://evergreencomponentmanageme-artifactbucket7410c9ef-g18n1iya8kwr.s3.us-west-2.amazonaws.com/public/aws.greengrass.LocalDebugConsole/2.0.3/s3/ggv2-component-releases-prod-pdx/EvergreenHttpDebugView/2ffc496ba41b39568968b22c582b4714a937193ee7687a45527238e696672521/aws.greengrass.LocalDebugConsole/aws.greengrass.LocalDebugConsole.jar?X-Amz-Security-Token=KwfLKSdEXAMPLE..." } ``` Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [GetComponentVersionArtifact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component-version-artifact.html)in der *AWS CLI Befehlsreferenz*. ### `get-component` Das folgende Codebeispiel zeigt die Verwendung`get-component`. **AWS CLI** **Beispiel 1: So laden Sie das Rezept einer Komponente im YAML-Format (Linux, macOS oder Unix) herunter)** Im folgenden Beispiel für `get-component` wird das Rezept einer Hello-World-Komponente im YAML-Format in eine Datei heruntergeladen. Der Befehl hat folgende Auswirkungen: Verwendet die Parameter `--output` und `--query`, um die Ausgabe des Befehls zu steuern. Diese Parameter extrahieren den Rezept-Blob aus der Ausgabe des Befehls. Weitere Informationen zum Steuern der Ausgabe finden Sie unter [Steuern der Befehlsausgabe](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) im *Benutzerhandbuch für die AWS -Befehlszeilenschnittstelle*. Verwendet das Dienstprogramm `base64`. Dieses Tool dekodiert den extrahierten Blob in den Originaltext. Bei dem Blob, der von einem erfolgreichen `get-component`-Befehl zurückgegeben wird, handelt es sich um base64-kodierten Text. Sie müssen dieses Blob dekodieren, um den Originaltext zu erhalten.Speichert den dekodierten Text in einer Datei. Der letzte Abschnitt des Befehls (`> com.example.HelloWorld-1.0.0.json`) speichert den dekodierten Text in einer Datei. ``` aws greengrassv2 get-component \ --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0 \ --recipe-output-format YAML \ --query recipe \ --output text | base64 --decode > com.example.HelloWorld-1.0.0.json ``` Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. **Beispiel 2: So laden Sie das Rezept einer Komponente im YAML-Format (Windows CMD) herunter** Im folgenden Beispiel für `get-component` wird das Rezept einer Hello-World-Komponente im YAML-Format in eine Datei heruntergeladen. Dieser Befehl verwendet das Dienstprogramm `certutil`. ``` aws greengrassv2 get-component ^ --arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 ^ --recipe-output-format YAML ^ --query recipe ^ --output text > com.example.HelloWorld-1.0.0.yaml.b64 certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml ``` Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. **Beispiel 3: Um das Rezept einer Komponente im YAML-Format herunterzuladen (Windows PowerShell)** Im folgenden Beispiel für `get-component` wird das Rezept einer Hello-World-Komponente im YAML-Format in eine Datei heruntergeladen. Dieser Befehl verwendet das Dienstprogramm `certutil`. ``` aws greengrassv2 get-component ` --arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 ` --recipe-output-format YAML ` --query recipe ` --output text > com.example.HelloWorld-1.0.0.yaml.b64 certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml ``` Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [GetComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component.html)in der *AWS CLI Befehlsreferenz.* ### `get-connectivity-info` Das folgende Codebeispiel zeigt die Verwendung`get-connectivity-info`. **AWS CLI** **So rufen Sie die Verbindungsinformationen für ein Greengrass-Kerngerät ab** Im folgenden Beispiel für `get-connectivity-info` werden Verbindungsinformationen für ein Greengrass-Kerngerät abgerufen. Client-Geräte verwenden diese Informationen, um eine Verbindung mit dem MQTT-Broker herzustellen, der auf diesem Kerngerät ausgeführt wird. ``` aws greengrassv2 get-connectivity-info \ --thing-name MyGreengrassCore ``` Ausgabe: ``` { "connectivityInfo": [ { "id": "localIP_192.0.2.0", "hostAddress": "192.0.2.0", "portNumber": 8883 } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Endpunkten für Kerngeräte](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [GetConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-connectivity-info.html)in der *AWS CLI Befehlsreferenz*. ### `get-core-device` Das folgende Codebeispiel zeigt die Verwendung`get-core-device`. **AWS CLI** **So rufen Sie ein Kerngerät ab** Das folgende `get-core-device` Beispiel ruft Informationen über ein AWS IoT-Greengrass-Core-Gerät ab. ``` aws greengrassv2 get-core-device \ --core-device-thing-name MyGreengrassCore ``` Ausgabe: ``` { "coreDeviceThingName": "MyGreengrassCore", "coreVersion": "2.0.3", "platform": "linux", "architecture": "amd64", "status": "HEALTHY", "lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00", "tags": {} } ``` Weitere Informationen finden Sie unter [Überprüfen des Status eines Kerngeräts](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [GetCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-core-device.html)in der *AWS CLI Befehlsreferenz.* ### `get-deployment` Das folgende Codebeispiel zeigt die Verwendung`get-deployment`. **AWS CLI** **So rufen Sie eine Bereitstellung ab** Das folgende `get-deployment` Beispiel enthält Informationen zur Bereitstellung der AWS IoT Greengrass Nucleus-Komponente auf einer Gruppe von Kerngeräten. ``` aws greengrassv2 get-deployment \ --deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` Ausgabe: ``` { "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup", "revisionId": "14", "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "deploymentName": "Deployment for MyGreengrassCoreGroup", "deploymentStatus": "ACTIVE", "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "components": { "aws.greengrass.Nucleus": { "componentVersion": "2.0.3", "configurationUpdate": { "merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}", "reset": [ "/networkProxy", "/mqtt" ] } } }, "deploymentPolicies": { "failureHandlingPolicy": "ROLLBACK", "componentUpdatePolicy": { "timeoutInSeconds": 60, "action": "NOTIFY_COMPONENTS" }, "configurationValidationPolicy": { "timeoutInSeconds": 60 } }, "iotJobConfiguration": {}, "creationTimestamp": "2021-01-07T17:21:20.691000-08:00", "isLatestForTarget": false, "tags": {} } ``` Weitere Informationen finden Sie unter [Bereitstellen von Komponenten auf Geräten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-deployment.html)in der *AWS CLI Befehlsreferenz.* ### `get-service-role-for-account` Das folgende Codebeispiel zeigt die Verwendung`get-service-role-for-account`. **AWS CLI** **Um die Greengrass-Servicerolle für Ihr Konto zu AWS erhalten** Im folgenden `get-service-role-for-account` Beispiel wird die Servicerolle abgerufen, die AWS IoT Greengrass für Ihr AWS Konto zugeordnet ist. ``` aws greengrassv2 get-service-role-for-account ``` Ausgabe: ``` { "associatedAt": "2022-01-19T19:21:53Z", "roleArn": "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole" } ``` Weitere Informationen finden Sie unter [Greengrass-Servicerolle](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) im *Entwicklerhandbuch für AWS IoT Greengrass*. + Einzelheiten zur API finden Sie unter [GetServiceRoleForAccount AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-service-role-for-account.html)*Befehlsreferenz.* ### `list-client-devices-associated-with-core-device` Das folgende Codebeispiel zeigt die Verwendung`list-client-devices-associated-with-core-device`. **AWS CLI** **So listen Sie die Client-Geräte auf, die mit einem Kerngerät verknüpft sind** Im folgenden Beispiel für `list-client-devices-associated-with-core-device` werden alle Client-Geräte aufgelistet, die mit einem Kerngerät verknüpft sind. ``` aws greengrassv2 list-client-devices-associated-with-core-device \ --core-device-thing-name MyTestGreengrassCore ``` Ausgabe: ``` { "associatedClientDevices": [ { "thingName": "MyClientDevice2", "associationTimestamp": "2021-07-12T16:33:55.843000-07:00" }, { "thingName": "MyClientDevice1", "associationTimestamp": "2021-07-12T16:33:55.843000-07:00" } ] } ``` Weitere Informationen finden Sie unter [Mit lokalen IoT-Geräten interagieren](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [ListClientDevicesAssociatedWithCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-client-devices-associated-with-core-device.html)in der *AWS CLI Befehlsreferenz*. ### `list-component-versions` Das folgende Codebeispiel zeigt die Verwendung`list-component-versions`. **AWS CLI** **So listen Sie die Versionen einer Komponente auf** Im folgenden Beispiel für `list-component-versions` werden alle Versionen einer Hello-World-Komponente aufgelistet. ``` aws greengrassv2 list-component-versions \ --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld ``` Ausgabe: ``` { "componentVersions": [ { "componentName": "com.example.HelloWorld", "componentVersion": "1.0.1", "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1" }, { "componentName": "com.example.HelloWorld", "componentVersion": "1.0.0", "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [ListComponentVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-component-versions.html)in der *AWS CLI Befehlsreferenz*. ### `list-components` Das folgende Codebeispiel zeigt die Verwendung`list-components`. **AWS CLI** **So listen Sie Komponenten auf** Das folgende `list-components` Beispiel listet jede Komponente und ihre neueste Version auf, die in Ihrem AWS Konto in der aktuellen Region definiert ist. ``` aws greengrassv2 list-components ``` Ausgabe: ``` { "components": [ { "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld", "componentName": "com.example.HelloWorld", "latestVersion": { "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1", "componentVersion": "1.0.1", "creationTimestamp": "2021-01-08T16:51:07.352000-08:00", "description": "My first AWS IoT Greengrass component.", "publisher": "Amazon", "platforms": [ { "attributes": { "os": "linux" } } ] } } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Komponenten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [ListComponents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-components.html)unter *AWS CLI Befehlsreferenz*. ### `list-core-devices` Das folgende Codebeispiel zeigt die Verwendung`list-core-devices`. **AWS CLI** **So listen Sie Kerngeräte auf** Das folgende `list-core-devices` Beispiel listet die AWS IoT-Greengrass-Kerngeräte in Ihrem AWS Konto in der aktuellen Region auf. ``` aws greengrassv2 list-core-devices ``` Ausgabe: ``` { "coreDevices": [ { "coreDeviceThingName": "MyGreengrassCore", "status": "HEALTHY", "lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00" } ] } ``` Weitere Informationen finden Sie unter [Überprüfen des Status eines Kerngeräts](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [ListCoreDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-core-devices.html)in der *AWS CLI Befehlsreferenz.* ### `list-deployments` Das folgende Codebeispiel zeigt die Verwendung`list-deployments`. **AWS CLI** **So listen Sie Bereitstellungen auf** Das folgende `list-deployments` Beispiel listet die neueste Version jeder Bereitstellung auf, die in Ihrem AWS Konto in der aktuellen Region definiert ist. ``` aws greengrassv2 list-deployments ``` Ausgabe: ``` { "deployments": [ { "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup", "revisionId": "14", "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "deploymentName": "Deployment for MyGreengrassCoreGroup", "creationTimestamp": "2021-01-07T17:21:20.691000-08:00", "deploymentStatus": "ACTIVE", "isLatestForTarget": false }, { "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore", "revisionId": "1", "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "deploymentName": "Deployment for MyGreengrassCore", "creationTimestamp": "2021-01-06T16:10:42.407000-08:00", "deploymentStatus": "COMPLETED", "isLatestForTarget": false } ] } ``` Weitere Informationen finden Sie unter [Bereitstellen von Komponenten auf Geräten](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-deployments.html)unter *AWS CLI Befehlsreferenz*. ### `list-effective-deployments` Das folgende Codebeispiel zeigt die Verwendung`list-effective-deployments`. **AWS CLI** **So listen Sie Bereitstellungsaufträge auf** Das folgende `list-effective-deployments` Beispiel listet die Bereitstellungen auf, die für ein AWS IoT-Greengrass-Core-Gerät gelten. ``` aws greengrassv2 list-effective-deployments \ --core-device-thing-name MyGreengrassCore ``` Ausgabe: ``` { "effectiveDeployments": [ { "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "deploymentName": "Deployment for MyGreengrassCore", "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore", "coreDeviceExecutionStatus": "COMPLETED", "reason": "SUCCESSFUL", "creationTimestamp": "2021-01-06T16:10:42.442000-08:00", "modifiedTimestamp": "2021-01-08T17:21:27.830000-08:00" }, { "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "deploymentName": "Deployment for MyGreengrassCoreGroup", "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup", "coreDeviceExecutionStatus": "SUCCEEDED", "reason": "SUCCESSFUL", "creationTimestamp": "2021-01-07T17:19:20.394000-08:00", "modifiedTimestamp": "2021-01-07T17:21:20.721000-08:00" } ] } ``` Weitere Informationen finden Sie unter [Überprüfen des Status eines Kerngeräts](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [ListEffectiveDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-effective-deployments.html)unter *AWS CLI Befehlsreferenz*. ### `list-installed-components` Das folgende Codebeispiel zeigt die Verwendung`list-installed-components`. **AWS CLI** **So listen Sie Komponenten auf, die auf einem Kerngerät installiert sind** Das folgende `list-installed-components` Beispiel listet die Komponenten auf, die auf einem AWS IoT Greengrass-Core-Gerät installiert sind. ``` aws greengrassv2 list-installed-components \ --core-device-thing-name MyGreengrassCore ``` Ausgabe: ``` { "installedComponents": [ { "componentName": "aws.greengrass.Cli", "componentVersion": "2.0.3", "lifecycleState": "RUNNING", "isRoot": true }, { "componentName": "aws.greengrass.Nucleus", "componentVersion": "2.0.3", "lifecycleState": "FINISHED", "isRoot": true } ] } ``` Weitere Informationen finden Sie unter [Überprüfen des Status eines Kerngeräts](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie unter [ListInstalledComponents AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-installed-components.html)*Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für eine Ressource auf** Das folgende `list-tags-for-resource` Beispiel listet alle Tags für ein AWS IoT Greengrass-Core-Gerät auf. ``` aws greengrassv2 list-tags-for-resource \ --resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore ``` Ausgabe: ``` { "tags": { "Owner": "richard-roe" } } ``` Weitere Informationen finden Sie unter [Eigene Ressourcen taggen](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer Ressource ein Tag hinzu** Das folgende `tag-resource` Beispiel fügt einem AWS IoT-Greengrass-Core-Gerät ein Eigentümertag hinzu. Sie können dieses Tag verwenden, um den Zugriff auf das Kerngerät auf Basis dessen zu steuern, wem es gehört. ``` aws greengrassv2 tag-resource \ --resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \ --tags Owner=richard-roe ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Eigene Ressourcen taggen](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie unter [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/tag-resource.html)*Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einer Ressource** Im folgenden `untag-resource` Beispiel wird ein Besitzer-Tag von einem AWS IoT-Greengrass-Core-Gerät entfernt. ``` aws iotsitewise untag-resource \ --resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \ --tag-keys Owner ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Eigene Ressourcen taggen](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-connectivity-info` Das folgende Codebeispiel zeigt die Verwendung`update-connectivity-info`. **AWS CLI** **So aktualisieren Sie die Verbindungsinformationen für ein Greengrass-Kerngerät** Im folgenden Beispiel für `update-connectivity-info` werden Verbindungsinformationen für ein Greengrass-Kerngerät abgerufen. Client-Geräte verwenden diese Informationen, um eine Verbindung mit dem MQTT-Broker herzustellen, der auf diesem Kerngerät ausgeführt wird. ``` aws greengrassv2 update-connectivity-info \ --thing-name MyGreengrassCore \ --cli-input-json file://core-device-connectivity-info.json ``` Inhalt von `core-device-connectivity-info.json`: ``` { "connectivityInfo": [ { "hostAddress": "192.0.2.0", "portNumber": 8883, "id": "localIP_192.0.2.0" } ] } ``` Ausgabe: ``` { "version": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` Weitere Informationen finden Sie unter [Verwalten von Endpunkten für Kerngeräte](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) im *Entwicklerhandbuch für AWS IoT Greengrass V2*. + Einzelheiten zur API finden Sie [UpdateConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/update-connectivity-info.html)in der *AWS CLI Befehlsreferenz*. # Version von AWS IoT Jobs SDK Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren Version von AWS IoT Jobs SDK. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `describe-job-execution` Das folgende Codebeispiel zeigt, wie Sie`describe-job-execution`. **AWS CLI** **So rufen Sie die Details einer Auftragsausführung ab** Im folgenden Beispiel für `describe-job-execution` werden die Details zur letzten Ausführung des angegebenen Auftrags und Objekts abgerufen. ``` aws iot-jobs-data describe-job-execution \ --job-id SampleJob \ --thing-name MotionSensor1 \ --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com ``` Ausgabe: ``` { "execution": { "approximateSecondsBeforeTimedOut": 88, "executionNumber": 2939653338, "jobId": "SampleJob", "lastUpdatedAt": 1567701875.743, "queuedAt": 1567701902.444, "status": "QUEUED", "thingName": "MotionSensor1 ", "versionNumber": 3 } } ``` Weitere Informationen finden Sie unter [Geräte und Aufträge](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [DescribeJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/describe-job-execution.html)in der *AWS CLI Befehlsreferenz*. ### `get-pending-job-executions` Das folgende Codebeispiel zeigt die Verwendung`get-pending-job-executions`. **AWS CLI** **So rufen Sie die Liste aller Aufträge ab, die sich für ein Objekt nicht im Terminal-Status befinden** Das folgende Beispiel für `get-pending-job-executions` zeigt eine Liste aller Aufträge an, die sich für das angegebene Objekt nicht im Terminal-Status befinden. ``` aws iot-jobs-data get-pending-job-executions \ --thing-name MotionSensor1 --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com ``` Ausgabe: ``` { "inProgressJobs": [ ], "queuedJobs": [ { "executionNumber": 2939653338, "jobId": "SampleJob", "lastUpdatedAt": 1567701875.743, "queuedAt": 1567701902.444, "versionNumber": 3 } ] } ``` Weitere Informationen finden Sie unter [Geräte und Aufträge](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [GetPendingJobExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/get-pending-job-executions.html)in der *AWS CLI Befehlsreferenz*. ### `start-next-pending-job-execution` Das folgende Codebeispiel zeigt die Verwendung`start-next-pending-job-execution`. **AWS CLI** **So rufen Sie die nächste ausstehende Auftragsausführung für ein Objekt ab und starten sie** Im folgenden Beispiel für `start-next-pending-job-execution` wird die nächste Auftragsausführung abgerufen und gestartet, deren Status für das angegebene Objekt IN\$1PROGRESS oder QUEUED lautet. ``` aws iot-jobs-data start-next-pending-job-execution \ --thing-name MotionSensor1 --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com ``` Ausgabe: ``` { "execution": { "approximateSecondsBeforeTimedOut": 88, "executionNumber": 2939653338, "jobId": "SampleJob", "lastUpdatedAt": 1567714853.743, "queuedAt": 1567701902.444, "startedAt": 1567714871.690, "status": "IN_PROGRESS", "thingName": "MotionSensor1 ", "versionNumber": 3 } } ``` Weitere Informationen finden Sie unter [Geräte und Aufträge](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [StartNextPendingJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/start-next-pending-job-execution.html)in der *AWS CLI Befehlsreferenz*. ### `update-job-execution` Das folgende Codebeispiel zeigt die Verwendung`update-job-execution`. **AWS CLI** **So aktualisieren Sie den Status einer Auftragsausführung** Im folgenden Beispiel für `update-job-execution` wird der Status des angegebenen Auftrags und Objekts aktualisiert. ``` aws iot-jobs-data update-job-execution \ --job-id SampleJob \ --thing-name MotionSensor1 \ --status REMOVED \ --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com ``` Ausgabe: ``` { "executionState": { "status": "REMOVED", "versionNumber": 3 }, } ``` Weitere Informationen finden Sie unter [Geräte und Aufträge](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) im *Entwicklerhandbuch für AWS IoT*. + Einzelheiten zur API finden Sie [UpdateJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/update-job-execution.html)in der *AWS CLI Befehlsreferenz*. # AWS IoT SiteWise Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT SiteWise. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-assets` Das folgende Codebeispiel zeigt, wie Sie`associate-assets`. **AWS CLI** **So ordnen Sie eine untergeordnete Komponente einer übergeordneten zu** Im folgenden Beispiel für `associate-assets` wird eine Windturbinenkomponente einer Windparkkomponente zugeordnet, wobei das Windturbinen-Komponentenmodell als Hierarchie im Windpark-Komponentenmodell existiert. ``` aws iotsitewise associate-assets \ --asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \ --hierarchy-id a1b2c3d4-5678-90ab-cdef-77777EXAMPLE \ --child-asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Assets zuordnen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/add-associated-assets.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [AssociateAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/associate-assets.html)in der *AWS CLI Befehlsreferenz.* ### `batch-associate-project-assets` Das folgende Codebeispiel zeigt die Verwendung`batch-associate-project-assets`. **AWS CLI** **So ordnen Sie eine Komponente einem Projekt zu** Im folgenden Beispiel für `batch-associate-project-assets` wird eine Windpark-Komponente einem Projekt zugeordnet. ``` aws iotsitewise batch-associate-project-assets \ --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \ --asset-ids a1b2c3d4-5678-90ab-cdef-44444EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen von Assets zu Projekten](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/add-assets-to-projects-sd.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [BatchAssociateProjectAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/batch-associate-project-assets.html)in der *AWS CLI Befehlsreferenz*. ### `batch-disassociate-project-assets` Das folgende Codebeispiel zeigt die Verwendung`batch-disassociate-project-assets`. **AWS CLI** **So heben Sie die Zuordnung einer Komponente zu einem Projekt auf** Im folgenden Beispiel für `batch-disassociate-project-assets` wird die Zuordnung einer Windpark-Komponente zu einem Projekt aufgehoben. ``` aws iotsitewise batch-disassociate-project-assets \ --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \ --asset-ids a1b2c3d4-5678-90ab-cdef-44444EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen von Assets zu Projekten](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/add-assets-to-projects-sd.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [BatchDisassociateProjectAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/batch-disassociate-project-assets.html)in der *AWS CLI Befehlsreferenz*. ### `batch-put-asset-property-value` Das folgende Codebeispiel zeigt die Verwendung`batch-put-asset-property-value`. **AWS CLI** **So senden Sie Daten an Komponenteneigenschaften** Im folgenden Beispiel für `batch-put-asset-property-value` werden Leistungs- und Temperaturdaten an die Eigenschaften der Komponente gesendet, die durch Eigenschaftsaliase identifiziert sind. ``` aws iotsitewise batch-put-asset-property-value \ --cli-input-json file://batch-put-asset-property-value.json ``` Inhalt von `batch-put-asset-property-value.json`: ``` { "entries": [ { "entryId": "1575691200-company-windfarm-3-turbine-7-power", "propertyAlias": "company-windfarm-3-turbine-7-power", "propertyValues": [ { "value": { "doubleValue": 4.92 }, "timestamp": { "timeInSeconds": 1575691200 }, "quality": "GOOD" } ] }, { "entryId": "1575691200-company-windfarm-3-turbine-7-temperature", "propertyAlias": "company-windfarm-3-turbine-7-temperature", "propertyValues": [ { "value": { "integerValue": 38 }, "timestamp": { "timeInSeconds": 1575691200 } } ] } ] } ``` Ausgabe: ``` { "errorEntries": [] } ``` Weitere Informationen finden Sie unter [Daten mithilfe der AWS SiteWise IoT-API](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ingest-api.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [BatchPutAssetPropertyValue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/batch-put-asset-property-value.html)in der *AWS CLI Befehlsreferenz.* ### `create-access-policy` Das folgende Codebeispiel zeigt die Verwendung`create-access-policy`. **AWS CLI** **Beispiel 1: So gewähren Sie einem Benutzer Administratorzugriff auf ein Portal** Im folgenden Beispiel für `create-access-policy` wird eine Zugriffsrichtlinie erstellt, die einem Benutzer Administratorzugriff auf ein Webportal für ein Windparkunternehmen gewährt. ``` aws iotsitewise create-access-policy \ --cli-input-json file://create-portal-administrator-access-policy.json ``` Inhalt von `create-portal-administrator-access-policy.json`: ``` { "accessPolicyIdentity": { "user": { "id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE" } }, "accessPolicyPermission": "ADMINISTRATOR", "accessPolicyResource": { "portal": { "id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE" } } } ``` Ausgabe: ``` { "accessPolicyId": "a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE", "accessPolicyArn": "arn:aws:iotsitewise:us-west-2:123456789012:access-policy/a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE" } ``` Weitere Informationen finden Sie unter [Hinzufügen oder Entfernen von Portaladministratoren](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins) im *AWS SiteWise IoT-Benutzerhandbuch*. **Beispiel 2: So gewähren Sie einem Benutzer schreibgeschützten Zugriff auf ein Projekt** Im folgenden Beispiel für `create-access-policy` wird eine Zugriffsrichtlinie erstellt, die einem Benutzer nur Lesezugriff auf ein Windparkprojekt gewährt. ``` aws iotsitewise create-access-policy \ --cli-input-json file://create-project-viewer-access-policy.json ``` Inhalt von `create-project-viewer-access-policy.json`: ``` { "accessPolicyIdentity": { "user": { "id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE" } }, "accessPolicyPermission": "VIEWER", "accessPolicyResource": { "project": { "id": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE" } } } ``` Ausgabe: ``` { "accessPolicyId": "a1b2c3d4-5678-90ab-cdef-dddddEXAMPLE", "accessPolicyArn": "arn:aws:iotsitewise:us-west-2:123456789012:access-policy/a1b2c3d4-5678-90ab-cdef-dddddEXAMPLE" } ``` Weitere Informationen finden Sie unter [Zuweisen von Projekt-Viewern](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/assign-project-viewers.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [CreateAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-access-policy.html)in der *AWS CLI Befehlsreferenz.* ### `create-asset-model` Das folgende Codebeispiel zeigt die Verwendung`create-asset-model`. **AWS CLI** **So erstellen Sie ein Komponentenmodell** Im folgenden Beispiel für `create-asset-model` wird ein Komponentenmodell erstellt, das eine Windturbine mit den folgenden Eigenschaften definiert: Seriennummer — Die Seriennummer einer WindturbineErzeugter Strom — Der erzeugte Energiedatenstrom einer WindturbineTemperatur C — Der Temperaturdatenstrom einer Windturbine in CelsiusTemperature F — Die abgebildeten Temperaturdatenpunkte von Celsius bis Fahrenheit ``` aws iotsitewise create-asset-model \ --cli-input-json file://create-wind-turbine-model.json ``` Inhalt von `create-wind-turbine-model.json`: ``` { "assetModelName": "Wind Turbine Model", "assetModelDescription": "Represents a wind turbine", "assetModelProperties": [ { "name": "Serial Number", "dataType": "STRING", "type": { "attribute": {} } }, { "name": "Generated Power", "dataType": "DOUBLE", "unit": "kW", "type": { "measurement": {} } }, { "name": "Temperature C", "dataType": "DOUBLE", "unit": "Celsius", "type": { "measurement": {} } }, { "name": "Temperature F", "dataType": "DOUBLE", "unit": "Fahrenheit", "type": { "transform": { "expression": "temp_c * 9 / 5 + 32", "variables": [ { "name": "temp_c", "value": { "propertyId": "Temperature C" } } ] } } }, { "name": "Total Generated Power", "dataType": "DOUBLE", "unit": "kW", "type": { "metric": { "expression": "sum(power)", "variables": [ { "name": "power", "value": { "propertyId": "Generated Power" } } ], "window": { "tumbling": { "interval": "1h" } } } } } ] } ``` Ausgabe: ``` { "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "assetModelArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "assetModelStatus": { "state": "CREATING" } } ``` Weitere Informationen finden Sie unter [Definieren von Asset-Modellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/define-models.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-asset-model.html)in der *AWS CLI Befehlsreferenz*. ### `create-asset` Das folgende Codebeispiel zeigt die Verwendung`create-asset`. **AWS CLI** **So erstellen Sie eine Komponente** Im folgenden Beispiel für `create-asset` wird aus dem Komponentenmodell einer Windturbine eine Windturbinenkomponente erstellt. ``` aws iotsitewise create-asset \ --asset-model-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ --asset-name "Wind Turbine 1" ``` Ausgabe: ``` { "assetId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "assetArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "assetStatus": { "state": "CREATING" } } ``` Weitere Informationen finden Sie im *AWS SiteWise IoT-Benutzerhandbuch* unter [Assets erstellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-assets.html). + Einzelheiten zur API finden Sie [CreateAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-asset.html)in der *AWS CLI Befehlsreferenz*. ### `create-dashboard` Das folgende Codebeispiel zeigt die Verwendung`create-dashboard`. **AWS CLI** **So erstellen Sie ein Dashboard** Im folgenden Beispiel für `create-dashboard` wird ein Dashboard mit einem Liniendiagramm erstellt, das die gesamte erzeugte Leistung für einen Windpark anzeigt. ``` aws iotsitewise create-dashboard \ --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \ --dashboard-name "Wind Farm" \ --dashboard-definition file://create-wind-farm-dashboard.json ``` Inhalt von `create-wind-farm-dashboard.json`: ``` { "widgets": [ { "type": "monitor-line-chart", "title": "Generated Power", "x": 0, "y": 0, "height": 3, "width": 3, "metrics": [ { "label": "Power", "type": "iotsitewise", "assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE" } ] } ] } ``` Ausgabe: ``` { "dashboardId": "a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE", "dashboardArn": "arn:aws:iotsitewise:us-west-2:123456789012:dashboard/a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE" } ``` Weitere Informationen finden Sie unter [Erstellen von Dashboards (CLI)](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-dashboards-using-aws-cli.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateDashboard AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-dashboard.html)*Befehlsreferenz.* ### `create-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-gateway`. **AWS CLI** **Um ein Gateway zu erstellen** Das folgende `create-gateway` Beispiel erstellt ein Gateway, das auf AWS IoT Greengrass läuft. ``` aws iotsitewise create-gateway \ --gateway-name ExampleCorpGateway \ --gateway-platform greengrass={groupArn=arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-1b1b1EXAMPLE} ``` Ausgabe: ``` { "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE", "gatewayArn": "arn:aws:iotsitewise:us-west-2:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE" } ``` Weitere Informationen finden Sie unter [Konfiguration eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `create-portal` Das folgende Codebeispiel zeigt die Verwendung`create-portal`. **AWS CLI** **Um ein Portal zu erstellen** Im folgenden Beispiel für `create-portal` wird ein Webportal für ein Windparkunternehmen erstellt. Sie können Portale nur in derselben Region erstellen, in der Sie AWS Single Sign-On aktiviert haben. ``` aws iotsitewise create-portal \ --portal-name WindFarmPortal \ --portal-description "A portal that contains wind farm projects for Example Corp." \ --portal-contact-email support@example.com \ --role-arn arn:aws:iam::123456789012:role/service-role/MySiteWiseMonitorServiceRole ``` Ausgabe: ``` { "portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "portalArn": "arn:aws:iotsitewise:us-west-2:123456789012:portal/a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "portalStartUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws", "portalStatus": { "state": "CREATING" }, "ssoApplicationId": "ins-a1b2c3d4-EXAMPLE" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit AWS IoT SiteWise Monitor](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-getting-started.html) im *AWS SiteWise IoT-Benutzerhandbuch* und [AWS SSO aktivieren](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-getting-started.html#monitor-enable-sso) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreatePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-portal.html)in der *AWS CLI Befehlsreferenz*. ### `create-project` Das folgende Codebeispiel zeigt die Verwendung`create-project`. **AWS CLI** **So erstellen Sie ein Projekt** Im folgenden Beispiel für `create-project` wird ein Windparkprojekt erstellt. ``` aws iotsitewise create-project \ --portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE \ --project-name "Wind Farm 1" \ --project-description "Contains asset visualizations for Wind Farm #1 for Example Corp." ``` Ausgabe: ``` { "projectId": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE", "projectArn": "arn:aws:iotsitewise:us-west-2:123456789012:project/a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE" } ``` Weitere Informationen finden Sie unter [Projekte erstellen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/create-projects.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [CreateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-project.html)unter *AWS CLI Befehlsreferenz*. ### `delete-access-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-access-policy`. **AWS CLI** **So widerrufen Sie den Zugriff eines Benutzers auf ein Projekt oder Portal** Im folgenden Beispiel für `delete-access-policy` wird eine Zugriffsrichtlinie gelöscht, die einem Benutzer Administratorzugriff auf ein Portal gewährt. ``` aws iotsitewise delete-access-policy \ --access-policy-id a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen oder Entfernen von Portaladministratoren](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-access-policy.html)unter *AWS CLI Befehlsreferenz*. ### `delete-asset-model` Das folgende Codebeispiel zeigt die Verwendung`delete-asset-model`. **AWS CLI** **So löschen Sie ein Komponentenmodell** Im folgenden Beispiel für `delete-asset-model` wird ein Windturbinen-Komponentenmodell gelöscht. ``` aws iotsitewise delete-asset-model \ --asset-model-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE ``` Ausgabe: ``` { "assetModelStatus": { "state": "DELETING" } } ``` Weitere Informationen finden Sie unter [Löschen von Asset-Modellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-assets-and-models.html#delete-asset-models) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-asset-model.html)in der *AWS CLI Befehlsreferenz*. ### `delete-asset` Das folgende Codebeispiel zeigt die Verwendung`delete-asset`. **AWS CLI** **So löschen Sie ein Asset** Im folgenden Beispiel für `delete-asset` wird eine Windturbinen-Komponente gelöscht. ``` aws iotsitewise delete-asset \ --asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE ``` Ausgabe: ``` { "assetStatus": { "state": "DELETING" } } ``` Weitere Informationen finden Sie unter [Löschen von Assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-assets-and-models.html#delete-assets) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-asset.html)in der *AWS CLI Befehlsreferenz*. ### `delete-dashboard` Das folgende Codebeispiel zeigt die Verwendung`delete-dashboard`. **AWS CLI** **So löschen Sie ein Dashboard** Im folgenden Beispiel für `delete-dashboard` wird ein Windturbinen-Dashboard gelöscht. ``` aws iotsitewise delete-dashboard \ --dashboard-id a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen von Dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-dashboards.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie unter [DeleteDashboard AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-dashboard.html)*Befehlsreferenz.* ### `delete-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-gateway`. **AWS CLI** **Um ein Gateway zu löschen** Im folgenden Beispiel für `delete-gateway` wird ein Gateway gelöscht. ``` aws iotsitewise delete-gateway \ --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Daten mithilfe eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteGateway AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-gateway.html)*Befehlsreferenz.* ### `delete-portal` Das folgende Codebeispiel zeigt die Verwendung`delete-portal`. **AWS CLI** **Um ein Portal zu löschen** Im folgenden Beispiel für `delete-portal` wird ein Webportal für ein Windparkunternehmen gelöscht. ``` aws iotsitewise delete-portal \ --portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE ``` Ausgabe: ``` { "portalStatus": { "state": "DELETING" } } ``` Weitere Informationen finden Sie unter [Löschen eines Portals](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-delete-portal) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeletePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-portal.html)in der *AWS CLI Befehlsreferenz*. ### `delete-project` Das folgende Codebeispiel zeigt die Verwendung`delete-project`. **AWS CLI** **Um ein Projekt zu löschen** Im folgenden Beispiel für `delete-project` wird ein Windparkprojekt gelöscht. ``` aws iotsitewise delete-project \ --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen von Projekten](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-projects.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [DeleteProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-project.html)in der *AWS CLI Befehlsreferenz*. ### `describe-access-policy` Das folgende Codebeispiel zeigt die Verwendung`describe-access-policy`. **AWS CLI** **So beschreiben Sie eine Zugriffsrichtlinie** Im folgenden Beispiel für `describe-access-policy` wird eine Zugriffsrichtlinie beschrieben, die einem Benutzer Administratorzugriff auf ein Webportal für ein Windparkunternehmen gewährt. ``` aws iotsitewise describe-access-policy \ --access-policy-id a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE ``` Ausgabe: ``` { "accessPolicyId": "a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE", "accessPolicyArn": "arn:aws:iotsitewise:us-west-2:123456789012:access-policy/a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE", "accessPolicyIdentity": { "user": { "id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE" } }, "accessPolicyResource": { "portal": { "id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE" } }, "accessPolicyPermission": "ADMINISTRATOR", "accessPolicyCreationDate": "2020-02-20T22:35:15.552880124Z", "accessPolicyLastUpdateDate": "2020-02-20T22:35:15.552880124Z" } ``` Weitere Informationen finden Sie unter [Hinzufügen oder Entfernen von Portaladministratoren](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-access-policy.html)unter *AWS CLI Befehlsreferenz*. ### `describe-asset-model` Das folgende Codebeispiel zeigt die Verwendung`describe-asset-model`. **AWS CLI** **So beschreiben Sie ein Komponentenmodell** Im folgenden Beispiel für `describe-asset-model` wird das Windpark-Komponentenmodell beschrieben. ``` aws iotsitewise describe-asset-model \ --asset-model-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE ``` Ausgabe: ``` { "assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "assetModelArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "assetModelName": "Wind Farm Model", "assetModelDescription": "Represents a wind farm that comprises many wind turbines", "assetModelProperties": [ { "id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE", "name": "Total Generated Power", "dataType": "DOUBLE", "unit": "kW", "type": { "metric": { "expression": "sum(power)", "variables": [ { "name": "power", "value": { "propertyId": "a1b2c3d4-5678-90ab-cdef-66666EXAMPLE", "hierarchyId": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE" } } ], "window": { "tumbling": { "interval": "1h" } } } } }, { "id": "a1b2c3d4-5678-90ab-cdef-88888EXAMPLE", "name": "Region", "dataType": "STRING", "type": { "attribute": { "defaultValue": " " } } } ], "assetModelHierarchies": [ { "id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE", "name": "Wind Turbines", "childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" } ], "assetModelCreationDate": 1575671284.0, "assetModelLastUpdateDate": 1575671988.0, "assetModelStatus": { "state": "ACTIVE" } } ``` Weitere Informationen finden Sie unter [Beschreibung eines bestimmten Asset-Modells](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#describe-asset-model) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-asset-model.html)in der *AWS CLI Befehlsreferenz*. ### `describe-asset-property` Das folgende Codebeispiel zeigt die Verwendung`describe-asset-property`. **AWS CLI** **So beschreiben Sie eine Komponenteneigenschaft** Im folgenden Beispiel für `describe-asset-property` wird die gesamte erzeugte Leistung einer Windparkkomponente beschrieben. ``` aws iotsitewise describe-asset-property \ --asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \ --property-id a1b2c3d4-5678-90ab-cdef-99999EXAMPLE ``` Ausgabe: ``` { "assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", "assetName": "Wind Farm 1", "assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "assetProperty": { "id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE", "name": "Total Generated Power", "notification": { "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-99999EXAMPLE", "state": "DISABLED" }, "dataType": "DOUBLE", "unit": "kW", "type": { "metric": { "expression": "sum(power)", "variables": [ { "name": "power", "value": { "propertyId": "a1b2c3d4-5678-90ab-cdef-66666EXAMPLE", "hierarchyId": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE" } } ], "window": { "tumbling": { "interval": "1h" } } } } } } ``` Weitere Informationen finden Sie unter [Beschreibung einer bestimmten Anlageneigenschaft](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#describe-asset-property) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeAssetProperty](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-asset-property.html)unter *AWS CLI Befehlsreferenz*. ### `describe-asset` Das folgende Codebeispiel zeigt die Verwendung`describe-asset`. **AWS CLI** **So beschreiben Sie eine Komponente** Das folgende Beispiel für `describe-asset` beschreibt eine Windpark-Komponente. ``` aws iotsitewise describe-asset \ --asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE ``` Ausgabe: ``` { "assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", "assetArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", "assetName": "Wind Farm 1", "assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "assetProperties": [ { "id": "a1b2c3d4-5678-90ab-cdef-88888EXAMPLE", "name": "Region", "dataType": "STRING" }, { "id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE", "name": "Total Generated Power", "dataType": "DOUBLE", "unit": "kW" } ], "assetHierarchies": [ { "id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE", "name": "Wind Turbines" } ], "assetCreationDate": 1575672453.0, "assetLastUpdateDate": 1575672453.0, "assetStatus": { "state": "ACTIVE" } } ``` Weitere Informationen finden Sie unter [Beschreibung eines bestimmten Assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#describe-asset) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-asset.html)in der *AWS CLI Befehlsreferenz*. ### `describe-dashboard` Das folgende Codebeispiel zeigt die Verwendung`describe-dashboard`. **AWS CLI** **So beschreiben Sie ein Dashboard** Im folgenden Beispiel für `describe-dashboard` wird das angegebene Windpark-Dashboard beschrieben. ``` aws iotsitewise describe-dashboard \ --dashboard-id a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE ``` Ausgabe: ``` { "dashboardId": "a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE", "dashboardArn": "arn:aws:iotsitewise:us-west-2:123456789012:dashboard/a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE", "dashboardName": "Wind Farm", "projectId": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE", "dashboardDefinition": "{\"widgets\":[{\"type\":\"monitor-line-chart\",\"title\":\"Generated Power\",\"x\":0,\"y\":0,\"height\":3,\"width\":3,\"metrics\":[{\"label\":\"Power\",\"type\":\"iotsitewise\",\"assetId\":\"a1b2c3d4-5678-90ab-cdef-44444EXAMPLE\",\"propertyId\":\"a1b2c3d4-5678-90ab-cdef-99999EXAMPLE\"}]}]}", "dashboardCreationDate": "2020-05-01T20:32:12.228476348Z", "dashboardLastUpdateDate": "2020-05-01T20:32:12.228476348Z" } ``` Weitere Informationen finden Sie unter [Anzeigen von Dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-dashboards.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie unter [DescribeDashboard AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-dashboard.html)*Befehlsreferenz.* ### `describe-gateway-capability-configuration` Das folgende Codebeispiel zeigt die Verwendung`describe-gateway-capability-configuration`. **AWS CLI** **So beschreiben Sie eine Gateway-Kapazität** Im folgenden Beispiel für `describe-gateway-capability-configuration` wird eine OPC-UA-Quellfunktion beschrieben. ``` aws iotsitewise describe-gateway-capability-configuration \ --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \ --capability-namespace "iotsitewise:opcuacollector:1" ``` Ausgabe: ``` { "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE", "capabilityNamespace": "iotsitewise:opcuacollector:1", "capabilityConfiguration": "{\"sources\":[{\"name\":\"Wind Farm #1\",\"endpoint\":{\"certificateTrust\":{\"type\":\"TrustAny\"},\"endpointUri\":\"opc.tcp://203.0.113.0:49320\",\"securityPolicy\":\"BASIC256\",\"messageSecurityMode\":\"SIGN_AND_ENCRYPT\",\"identityProvider\":{\"type\":\"Username\",\"usernameSecretArn\":\"arn:aws:secretsmanager:us-east-1:123456789012:secret:greengrass-factory1-auth-3QNDmM\"},\"nodeFilterRules\":[]},\"measurementDataStreamPrefix\":\"\"}]}", "capabilitySyncStatus": "IN_SYNC" } ``` Weitere Informationen finden Sie unter [Konfiguration von Datenquellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-sources.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeGatewayCapabilityConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-gateway-capability-configuration.html)unter *AWS CLI Befehlsreferenz*. ### `describe-gateway` Das folgende Codebeispiel zeigt die Verwendung`describe-gateway`. **AWS CLI** **So beschreiben Sie ein Gateway** Im folgenden Beispiel für `describe-gateway` wird ein Gateway beschrieben. ``` aws iotsitewise describe-gateway \ --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE ``` Ausgabe: ``` { "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE", "gatewayName": "ExampleCorpGateway", "gatewayArn": "arn:aws:iotsitewise:us-west-2:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE", "gatewayPlatform": { "greengrass": { "groupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-1b1b1EXAMPLE" } }, "gatewayCapabilitySummaries": [ { "capabilityNamespace": "iotsitewise:opcuacollector:1", "capabilitySyncStatus": "IN_SYNC" } ], "creationDate": 1588369971.457, "lastUpdateDate": 1588369971.457 } ``` Weitere Informationen finden Sie unter [Daten mithilfe eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeGateway AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-gateway.html)*Befehlsreferenz.* ### `describe-logging-options` Das folgende Codebeispiel zeigt die Verwendung`describe-logging-options`. **AWS CLI** **Um die aktuellen AWS SiteWise IoT-Protokollierungsoptionen abzurufen** Im folgenden `describe-logging-options` Beispiel werden die aktuellen AWS SiteWise IoT-Protokollierungsoptionen für Ihr AWS Konto in der aktuellen Region abgerufen. ``` aws iotsitewise describe-logging-options ``` Ausgabe: ``` { "loggingOptions": { "level": "INFO" } } ``` Weitere Informationen finden Sie unter [Monitoring AWS IoT SiteWise with Amazon CloudWatch Logs](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-cloudwatch-logs.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-logging-options.html)in der *AWS CLI Befehlsreferenz*. ### `describe-portal` Das folgende Codebeispiel zeigt die Verwendung`describe-portal`. **AWS CLI** **So beschreiben Sie ein Portal** Im folgenden Beispiel für `describe-portal` wird ein Webportal für ein Windparkunternehmen beschrieben. ``` aws iotsitewise describe-portal \ --portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE ``` Ausgabe: ``` { "portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "portalArn": "arn:aws:iotsitewise:us-west-2:123456789012:portal/a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "portalName": "WindFarmPortal", "portalDescription": "A portal that contains wind farm projects for Example Corp.", "portalClientId": "E-a1b2c3d4e5f6_a1b2c3d4e5f6EXAMPLE", "portalStartUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws", "portalContactEmail": "support@example.com", "portalStatus": { "state": "ACTIVE" }, "portalCreationDate": "2020-02-04T23:01:52.90248068Z", "portalLastUpdateDate": "2020-02-04T23:01:52.90248078Z", "roleArn": "arn:aws:iam::123456789012:role/MySiteWiseMonitorServiceRole" } ``` Weitere Informationen finden Sie unter [Verwaltung Ihrer Portale](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-portal.html)in der *AWS CLI Befehlsreferenz.* ### `describe-project` Das folgende Codebeispiel zeigt die Verwendung`describe-project`. **AWS CLI** **So beschreiben Sie ein Projekt** Im folgenden Beispiel für `describe-project` wird ein Windparkprojekt beschrieben. ``` aws iotsitewise describe-project \ --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE ``` Ausgabe: ``` { "projectId": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE", "projectArn": "arn:aws:iotsitewise:us-west-2:123456789012:project/a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE", "projectName": "Wind Farm 1", "portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "projectDescription": "Contains asset visualizations for Wind Farm #1 for Example Corp.", "projectCreationDate": "2020-02-20T21:58:43.362246001Z", "projectLastUpdateDate": "2020-02-20T21:58:43.362246095Z" } ``` Weitere Informationen finden Sie unter [Projektdetails anzeigen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-project-details.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [DescribeProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-project.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-assets` Das folgende Codebeispiel zeigt die Verwendung`disassociate-assets`. **AWS CLI** **So heben Sie die Zuordnung einer untergeordneten Komponente zu einer übergeordneten Komponente auf** Im folgenden Beispiel für `disassociate-assets` wird die Zuordnung einer Windturbinen-Komponente zu einer Windpark-Komponente aufgehoben. ``` aws iotsitewise disassociate-assets \ --asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \ --hierarchy-id a1b2c3d4-5678-90ab-cdef-77777EXAMPLE \ --child-asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Assets zuordnen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/add-associated-assets.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DisassociateAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/disassociate-assets.html)in der *AWS CLI Befehlsreferenz.* ### `get-asset-property-aggregates` Das folgende Codebeispiel zeigt die Verwendung`get-asset-property-aggregates`. **AWS CLI** **So rufen Sie die aggregierten Werte für Durchschnitt und Anzahl einer Komponenteneigenschaft ab** Im folgenden Beispiel für `get-asset-property-aggregates` werden die durchschnittliche Gesamtleistung und die Anzahl der Gesamtleistungs-Datenpunkte einer Windturbinen-Komponente für einen Zeitraum von 1 Stunde abgerufen. ``` aws iotsitewise get-asset-property-aggregates \ --asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \ --property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE \ --start-date 1580849400 \ --end-date 1580853000 \ --aggregate-types AVERAGE COUNT \ --resolution 1h ``` Ausgabe: ``` { "aggregatedValues": [ { "timestamp": 1580850000.0, "quality": "GOOD", "value": { "average": 8723.46538886233, "count": 12.0 } } ] } ``` Weitere Informationen finden Sie unter [Abfragen von Aggregaten für Asset-Eigenschaften](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#aggregates) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetAssetPropertyAggregates AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/get-asset-property-aggregates.html)*Befehlsreferenz*. ### `get-asset-property-value-history` Das folgende Codebeispiel zeigt die Verwendung`get-asset-property-value-history`. **AWS CLI** **So rufen Sie die historischen Werte einer Komponenteneigenschaft ab** Im folgenden Beispiel für `get-asset-property-value-history` werden die Gesamtleistungswerte einer Windturbinenkomponente für einen Zeitraum von 20 Minuten abgerufen. ``` aws iotsitewise get-asset-property-value-history \ --asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \ --property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE \ --start-date 1580851800 \ --end-date 1580853000 ``` Ausgabe: ``` { "assetPropertyValueHistory": [ { "value": { "doubleValue": 7217.787046814844 }, "timestamp": { "timeInSeconds": 1580852100, "offsetInNanos": 0 }, "quality": "GOOD" }, { "value": { "doubleValue": 6941.242811875451 }, "timestamp": { "timeInSeconds": 1580852400, "offsetInNanos": 0 }, "quality": "GOOD" }, { "value": { "doubleValue": 6976.797662266717 }, "timestamp": { "timeInSeconds": 1580852700, "offsetInNanos": 0 }, "quality": "GOOD" }, { "value": { "doubleValue": 6890.8677520453875 }, "timestamp": { "timeInSeconds": 1580853000, "offsetInNanos": 0 }, "quality": "GOOD" } ] } ``` Weitere Informationen finden Sie unter [Abfragen historischer Immobilienwerte](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#historical-values) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetAssetPropertyValueHistory AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/get-asset-property-value-history.html)*Befehlsreferenz.* ### `get-asset-property-value` Das folgende Codebeispiel zeigt die Verwendung`get-asset-property-value`. **AWS CLI** **So rufen Sie den aktuellen Wert einer Komponenteneigenschaft ab** Im folgenden Beispiel für `get-asset-property-value` wird die aktuelle Gesamtleistung einer Windturbinenkomponente abgerufen. ``` aws iotsitewise get-asset-property-value \ --asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \ --property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE ``` Ausgabe: ``` { "propertyValue": { "value": { "doubleValue": 6890.8677520453875 }, "timestamp": { "timeInSeconds": 1580853000, "offsetInNanos": 0 }, "quality": "GOOD" } } ``` Weitere Informationen finden Sie unter [Abfragen aktueller Objekteigenschaftswerte](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#current-values) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [GetAssetPropertyValue AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/get-asset-property-value.html)*Befehlsreferenz.* ### `list-access-policies` Das folgende Codebeispiel zeigt die Verwendung`list-access-policies`. **AWS CLI** **So listen Sie alle Zugriffsrichtlinien auf** Im folgenden Beispiel für `list-access-policies` werden alle Zugriffsrichtlinien für einen Benutzer aufgelistet, der Portaladministrator ist. ``` aws iotsitewise list-access-policies \ --identity-type USER \ --identity-id a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE ``` Ausgabe: ``` { "accessPolicySummaries": [ { "id": "a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE", "identity": { "user": { "id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE" } }, "resource": { "portal": { "id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE" } }, "permission": "ADMINISTRATOR" } ] } ``` Weitere Informationen finden Sie unter [Verwaltung Ihrer Portale](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListAccessPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-access-policies.html)in der *AWS CLI Befehlsreferenz.* ### `list-asset-models` Das folgende Codebeispiel zeigt die Verwendung`list-asset-models`. **AWS CLI** **So listen Sie alle Komponentenmodelle auf** Das folgende `list-asset-models` Beispiel listet alle Vermögensmodelle auf, die in Ihrem AWS Konto in der aktuellen Region definiert sind. ``` aws iotsitewise list-asset-models ``` Ausgabe: ``` { "assetModelSummaries": [ { "id": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "name": "Wind Farm Model", "description": "Represents a wind farm that comprises many wind turbines", "creationDate": 1575671284.0, "lastUpdateDate": 1575671988.0, "status": { "state": "ACTIVE" } }, { "id": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "name": "Wind Turbine Model", "description": "Represents a wind turbine manufactured by Example Corp", "creationDate": 1575671207.0, "lastUpdateDate": 1575686273.0, "status": { "state": "ACTIVE" } } ] } ``` Weitere Informationen finden Sie unter [Auflisten aller Asset-Modelle](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-asset-models) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListAssetModels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-asset-models.html)in der *AWS CLI Befehlsreferenz*. ### `list-assets` Das folgende Codebeispiel zeigt die Verwendung`list-assets`. **AWS CLI** **Beispiel 1: So listen Sie alle Komponenten der obersten Ebene auf** Das folgende `list-assets` Beispiel listet alle Anlagen auf, die sich auf der obersten Ebene der Asset-Hierarchie befinden und in Ihrem AWS Konto in der aktuellen Region definiert sind. ``` aws iotsitewise list-assets \ --filter TOP_LEVEL ``` Ausgabe: ``` { "assetSummaries": [ { "id": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", "arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", "name": "Wind Farm 1", "assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "creationDate": 1575672453.0, "lastUpdateDate": 1575672453.0, "status": { "state": "ACTIVE" }, "hierarchies": [ { "id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE", "name": "Wind Turbines" } ] } ] } ``` Weitere Informationen finden Sie unter [Auflisten von Assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-assets) im *AWS SiteWise IoT-Benutzerhandbuch*. **Beispiel 2: So listen Sie alle Komponenten auf Basis eines Komponentenmodells auf** Im folgenden `list-assets` Beispiel werden alle Vermögenswerte aufgeführt, die auf einem Vermögensmodell basieren und in Ihrem AWS Konto in der aktuellen Region definiert sind. ``` aws iotsitewise list-assets \ --asset-model-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE ``` Ausgabe: ``` { "assetSummaries": [ { "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "name": "Wind Turbine 1", "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "creationDate": 1575671550.0, "lastUpdateDate": 1575686308.0, "status": { "state": "ACTIVE" }, "hierarchies": [] } ] } ``` Weitere Informationen finden Sie unter [Auflisten von Assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-assets) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-assets.html)in der *AWS CLI Befehlsreferenz*. ### `list-associated-assets` Das folgende Codebeispiel zeigt die Verwendung`list-associated-assets`. **AWS CLI** **So listen Sie alle Komponenten auf, die einer Komponente in einer bestimmten Hierarchie zugeordnet sind** Im folgenden Beispiel für `list-associated-assets` werden alle Windturbinen-Komponenten aufgeführt, die der angegebenen Windpark-Komponente zugeordnet sind. ``` aws iotsitewise list-associated-assets \ --asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \ --hierarchy-id a1b2c3d4-5678-90ab-cdef-77777EXAMPLE ``` Ausgabe: ``` { "assetSummaries": [ { "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "name": "Wind Turbine 1", "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "creationDate": 1575671550.0, "lastUpdateDate": 1575686308.0, "status": { "state": "ACTIVE" }, "hierarchies": [] } ] } ``` Weitere Informationen finden Sie im *AWS SiteWise IoT-Benutzerhandbuch* unter [Auflisten von Assets, die einem bestimmten Asset zugeordnet](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-associated-assets) sind. + Einzelheiten zur API finden Sie [ListAssociatedAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-associated-assets.html)in der *AWS CLI Befehlsreferenz*. ### `list-dashboards` Das folgende Codebeispiel zeigt die Verwendung`list-dashboards`. **AWS CLI** **So listen Sie alle Dashboards in einem Projekt auf** Im folgenden Beispiel für `list-dashboards` werden alle Dashboards aufgelistet, die in einem Projekt definiert sind. ``` aws iotsitewise list-dashboards \ --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE ``` Ausgabe: ``` { "dashboardSummaries": [ { "id": "a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE", "name": "Wind Farm", "creationDate": "2020-05-01T20:32:12.228476348Z", "lastUpdateDate": "2020-05-01T20:32:12.228476348Z" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen von Dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-dashboards.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie unter [ListDashboards AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-dashboards.html)*Befehlsreferenz.* ### `list-gateways` Das folgende Codebeispiel zeigt die Verwendung`list-gateways`. **AWS CLI** **So listen Sie alle Gateways auf** Das folgende `list-gateways` Beispiel listet alle Gateways auf, die in Ihrem AWS Konto in der aktuellen Region definiert sind. ``` aws iotsitewise list-gateways ``` Ausgabe: ``` { "gatewaySummaries": [ { "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE", "gatewayName": "ExampleCorpGateway", "gatewayCapabilitySummaries": [ { "capabilityNamespace": "iotsitewise:opcuacollector:1", "capabilitySyncStatus": "IN_SYNC" } ], "creationDate": 1588369971.457, "lastUpdateDate": 1588369971.457 } ] } ``` Weitere Informationen finden Sie unter [Daten mithilfe eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [ListGateways AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-gateways.html)*Befehlsreferenz.* ### `list-portals` Das folgende Codebeispiel zeigt die Verwendung`list-portals`. **AWS CLI** **So listen Sie alle Portale auf** Das folgende `list-portals` Beispiel listet alle Portale auf, die in Ihrem AWS Konto in der aktuellen Region definiert sind. ``` aws iotsitewise list-portals ``` Ausgabe: ``` { "portalSummaries": [ { "id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "name": "WindFarmPortal", "description": "A portal that contains wind farm projects for Example Corp.", "startUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws", "creationDate": "2020-02-04T23:01:52.90248068Z", "lastUpdateDate": "2020-02-04T23:01:52.90248078Z", "roleArn": "arn:aws:iam::123456789012:role/service-role/MySiteWiseMonitorServiceRole" } ] } ``` Weitere Informationen finden Sie unter [Verwaltung Ihrer Portale](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListPortals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-portals.html)in der *AWS CLI Befehlsreferenz.* ### `list-project-assets` Das folgende Codebeispiel zeigt die Verwendung`list-project-assets`. **AWS CLI** **So listen Sie alle Komponenten auf, die einem Projekt zugeordnet sind** Im folgenden Beispiel für `list-project-assets` werden alle Komponenten aufgelistet, die einem Windparkprojekt zugeordnet sind. ``` aws iotsitewise list-projects \ --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE ``` Ausgabe: ``` { "assetIds": [ "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE" ] } ``` Weitere Informationen finden Sie unter [Hinzufügen von Assets zu Projekten](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/add-assets-to-projects-sd.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [ListProjectAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-project-assets.html)in der *AWS CLI Befehlsreferenz*. ### `list-projects` Das folgende Codebeispiel zeigt die Verwendung`list-projects`. **AWS CLI** **So listen Sie alle Projekte in einem Portal auf** Im folgenden Beispiel für `list-projects` werden alle Projekte aufgelistet, die in einem Portal definiert sind. ``` aws iotsitewise list-projects \ --portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE ``` Ausgabe: ``` { "projectSummaries": [ { "id": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE", "name": "Wind Farm 1", "description": "Contains asset visualizations for Wind Farm #1 for Example Corp.", "creationDate": "2020-02-20T21:58:43.362246001Z", "lastUpdateDate": "2020-02-20T21:58:43.362246095Z" } ] } ``` Weitere Informationen finden Sie unter [Projektdetails anzeigen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-project-details.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [ListProjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-projects.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie alle Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für eine Windturbinen-Komponente aufgelistet. ``` aws iotsitewise list-tags-for-resource \ --resource-arn arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE ``` Ausgabe: ``` { "tags": { "Owner": "richard-roe" } } ``` Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `put-logging-options` Das folgende Codebeispiel zeigt die Verwendung`put-logging-options`. **AWS CLI** **So legen Sie den Grad der Protokollierung fest** Das folgende `put-logging-options` Beispiel aktiviert die `INFO` Level-Protokollierung in AWS IoT SiteWise. Andere Level umfassen `DEBUG` und `OFF`. ``` aws iotsitewise put-logging-options \ --logging-options level=INFO ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Monitoring AWS IoT SiteWise with Amazon CloudWatch Logs](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-cloudwatch-logs.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/put-logging-options.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer Ressource ein Tag hinzu** Im folgenden Beispiel für `tag-resource` wird einer Windturbinen-Komponente ein Eigentümer-Tag hinzugefügt. Auf diese Weise können Sie den Zugriff auf die Komponente auf Basis dessen steuern, wem sie gehört. ``` aws iotsitewise tag-resource \ --resource-arn arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \ --tags Owner=richard-roe ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einer Ressource** Im folgenden Beispiel für `untag-resource` wird ein Eigentümer-Tag von einer Windturbinen-Komponente entfernt. ``` aws iotsitewise untag-resource \ --resource-arn arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \ --tag-keys Owner ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer Ressourcen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-access-policy` Das folgende Codebeispiel zeigt die Verwendung`update-access-policy`. **AWS CLI** **So gewähren Sie einem Projekt-Viewer die Eigentümerschaft an einem Projekt** Im folgenden Beispiel für `update-access-policy` wird eine Zugriffsrichtlinie aktualisiert, die einem Projekt-Viewer die Eigentümerschaft an einem Projekt gewährt. ``` aws iotsitewise update-access-policy \ --access-policy-id a1b2c3d4-5678-90ab-cdef-dddddEXAMPLE \ --cli-input-json file://update-project-viewer-access-policy.json ``` Inhalt von `update-project-viewer-access-policy.json`: ``` { "accessPolicyIdentity": { "user": { "id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE" } }, "accessPolicyPermission": "ADMINISTRATOR", "accessPolicyResource": { "project": { "id": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE" } } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Zuweisen von Projekteigentümern](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/assign-project-owners.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [UpdateAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-access-policy.html)in der *AWS CLI Befehlsreferenz.* ### `update-asset-model` Das folgende Codebeispiel zeigt die Verwendung`update-asset-model`. **AWS CLI** **So aktualisieren Sie ein Komponentenmodell** Im folgenden Beispiel für `update-asset-model` wird die Beschreibung des Komponentenmodells eines Windparks aktualisiert. Dieses Beispiel beinhaltet die vorhandenen Definitionen IDs und Definitionen des Modells, da das bestehende Modell mit dem neuen Modell `update-asset-model` überschrieben wird. ``` aws iotsitewise update-asset-model \ --cli-input-json file://update-wind-farm-model.json ``` Inhalt von `update-wind-farm-model.json`: ``` { "assetModelName": "Wind Farm Model", "assetModelDescription": "Represents a wind farm that comprises many wind turbines", "assetModelProperties": [ { "id": "a1b2c3d4-5678-90ab-cdef-88888EXAMPLE", "name": "Region", "dataType": "STRING", "type": { "attribute": {} } }, { "id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE", "name": "Total Generated Power", "dataType": "DOUBLE", "unit": "kW", "type": { "metric": { "expression": "sum(power)", "variables": [ { "name": "power", "value": { "hierarchyId": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-66666EXAMPLE" } } ], "window": { "tumbling": { "interval": "1h" } } } } } ], "assetModelHierarchies": [ { "id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE", "name": "Wind Turbines", "childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" } ] } ``` Ausgabe: ``` { "assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "assetModelArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "assetModelStatus": { "state": "CREATING" } } ``` Weitere Informationen finden Sie unter [Aktualisieren von Asset-Modellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-assets-and-models.html#update-asset-models) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-asset-model.html)in der *AWS CLI Befehlsreferenz*. ### `update-asset-property` Das folgende Codebeispiel zeigt die Verwendung`update-asset-property`. **AWS CLI** **Beispiel 1: So aktualisieren Sie den Alias einer Komponenteneigenschaft** Im folgenden Beispiel für `update-asset-property` wird der Leistungs-Alias einer Windturbinen-Komponente aktualisiert. ``` aws iotsitewise update-asset-property \ --asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \ --property-id a1b2c3d4-5678-90ab-cdef-55555EXAMPLE \ --property-alias "/examplecorp/windfarm/1/turbine/1/power" \ --property-notification-state DISABLED ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie im *AWS SiteWise IoT-Benutzerhandbuch* unter [Zuordnung von industriellen Datenströmen zu Anlageneigenschaften](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html). **Beispiel 2: So aktivieren Sie Benachrichtigungen zu Komponenteneigenschaften** Im folgenden Beispiel für `update-asset-property` werden Benachrichtigungen zur Aktualisierung von Komponenteneigenschaften für die Leistung einer Windturbinen-Komponente aktiviert. Aktualisierungen von Eigenschaftswerten werden im MQTT-Thema `$aws/sitewise/asset-models//assets//properties/` veröffentlicht, wobei jede ID durch die Eigenschafts-, Komponenten- und Modell-ID der Komponenteneigenschaft ersetzt wird. ``` aws iotsitewise update-asset-property \ --asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \ --property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE \ --property-notification-state ENABLED \ --property-alias "/examplecorp/windfarm/1/turbine/1/power" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Interaktion mit anderen Diensten](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateAssetProperty](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-asset-property.html)in der *AWS CLI Befehlsreferenz*. ### `update-asset` Das folgende Codebeispiel zeigt die Verwendung`update-asset`. **AWS CLI** **So aktualisieren Sie den Namen einer Komponente** Im folgenden Beispiel für `update-asset` wird der Name einer Windturbinen-Komponente aktualisiert. ``` aws iotsitewise update-asset \ --asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \ --asset-name "Wind Turbine 2" ``` Ausgabe: ``` { "assetStatus": { "state": "UPDATING" } } ``` Weitere Informationen finden Sie unter [Aktualisieren von Ressourcen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-assets-and-models.html#update-assets) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-asset.html)in der *AWS CLI Befehlsreferenz*. ### `update-dashboard` Das folgende Codebeispiel zeigt die Verwendung`update-dashboard`. **AWS CLI** **So aktualisieren Sie ein Dashboard** Im folgenden Beispiel für `update-dashboard` wird der Titel des Liniendiagramms eines Dashboards geändert, in dem die gesamte erzeugte Leistung für einen Windpark angezeigt wird. ``` aws iotsitewise update-dashboard \ --project-id a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE \ --dashboard-name "Wind Farm" \ --dashboard-definition file://update-wind-farm-dashboard.json ``` Inhalt von `update-wind-farm-dashboard.json`: ``` { "widgets": [ { "type": "monitor-line-chart", "title": "Total Generated Power", "x": 0, "y": 0, "height": 3, "width": 3, "metrics": [ { "label": "Power", "type": "iotsitewise", "assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE" } ] } ] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen von Dashboards (CLI)](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-dashboards-using-aws-cli.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [UpdateDashboard AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-dashboard.html)*Befehlsreferenz.* ### `update-gateway-capability-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-gateway-capability-configuration`. **AWS CLI** **So aktualisieren Sie eine Gateway-Kapazität** Im folgenden Beispiel für `update-gateway-capability-configuration` wird eine OPC-UA-Quelle mit den folgenden Eigenschaften konfiguriert: Vertraut jedem Zertifikat. Verwendet den Basic256-Algorithmus, um Nachrichten zu sichern. Verwendet den SignAndEncrypt Modus, um Verbindungen zu sichern. Verwendet Authentifizierungsdaten, die in einem Secrets Manager-Geheimnis gespeichert sind. AWS ``` aws iotsitewise update-gateway-capability-configuration \ --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \ --capability-namespace "iotsitewise:opcuacollector:1" \ --capability-configuration file://opc-ua-capability-configuration.json ``` Inhalt von `opc-ua-capability-configuration.json`: ``` { "sources": [ { "name": "Wind Farm #1", "endpoint": { "certificateTrust": { "type": "TrustAny" }, "endpointUri": "opc.tcp://203.0.113.0:49320", "securityPolicy": "BASIC256", "messageSecurityMode": "SIGN_AND_ENCRYPT", "identityProvider": { "type": "Username", "usernameSecretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-windfarm1-auth-1ABCDE" }, "nodeFilterRules": [] }, "measurementDataStreamPrefix": "" } ] } ``` Ausgabe: ``` { "capabilityNamespace": "iotsitewise:opcuacollector:1", "capabilitySyncStatus": "OUT_OF_SYNC" } ``` Weitere Informationen finden Sie unter [Konfiguration von Datenquellen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-sources.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateGatewayCapabilityConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-gateway-capability-configuration.html)unter *AWS CLI Befehlsreferenz*. ### `update-gateway` Das folgende Codebeispiel zeigt die Verwendung`update-gateway`. **AWS CLI** **So aktualisieren Sie den Namen eines Gateways** Im folgenden Beispiel für `update-gateway` wird der Name eines Gateways aktualisiert. ``` aws iotsitewise update-gateway \ --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \ --gateway-name ExampleCorpGateway1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Daten mithilfe eines Gateways](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html) aufnehmen im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [UpdateGateway AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-gateway.html)*Befehlsreferenz.* ### `update-portal` Das folgende Codebeispiel zeigt die Verwendung`update-portal`. **AWS CLI** **So aktualisieren Sie die Details eines Portals** Im folgenden Beispiel für `update-portal` wird ein Webportal für ein Windparkunternehmen aktualisiert. ``` aws iotsitewise update-portal \ --portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE \ --portal-name WindFarmPortal \ --portal-description "A portal that contains wind farm projects for Example Corp." \ --portal-contact-email support@example.com \ --role-arn arn:aws:iam::123456789012:role/MySiteWiseMonitorServiceRole ``` Ausgabe: ``` { "portalStatus": { "state": "UPDATING" } } ``` Weitere Informationen finden Sie unter [Verwaltung Ihrer Portale](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html) im *AWS SiteWise IoT-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdatePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-portal.html)in der *AWS CLI Befehlsreferenz.* ### `update-project` Das folgende Codebeispiel zeigt die Verwendung`update-project`. **AWS CLI** **So aktualisieren Sie die Details eines Projekts** Im folgenden Beispiel für `update-project` wird ein Windparkprojekt aktualisiert. ``` aws iotsitewise update-project \ --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \ --project-name "Wind Farm 1" \ --project-description "Contains asset visualizations for Wind Farm #1 for Example Corp." ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Projektdetails ändern](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/edit-project-details.html) im *AWS IoT SiteWise Monitor-Anwendungshandbuch*. + Einzelheiten zur API finden Sie [UpdateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-project.html)in der *AWS CLI Befehlsreferenz*. # AWS IoT Things Graph Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT Things Graph. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-entity-to-thing` Das folgende Codebeispiel zeigt, wie Sie`associate-entity-to-thing`. **AWS CLI** **So ordnen Sie ein Objekt einem Gerät zu** Im folgenden Beispiel für `associate-entity-to-thing` wird ein Objekt einem Gerät zugeordnet. Im Beispiel wird ein Bewegungssensorgerät verwendet, das sich im öffentlichen Namespace befindet. ``` aws iotthingsgraph associate-entity-to-thing \ --thing-name "MotionSensorName" \ --entity-id "urn:tdm:aws/examples:Device:HCSR501MotionSensor" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen und Hochladen von Modellen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-models-gs.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [AssociateEntityToThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/associate-entity-to-thing.html)in der *AWS CLI Befehlsreferenz*. ### `create-flow-template` Das folgende Codebeispiel zeigt die Verwendung`create-flow-template`. **AWS CLI** **So erstellen Sie einen Flow** Im folgenden Beispiel für `create-flow-template` wird ein Flow (Workflow) erstellt. Der Wert `MyFlowDefinition` ist die GraphQL, die den Flow modelliert. ``` aws iotthingsgraph create-flow-template \ --definition language=GRAPHQL,text="MyFlowDefinition" ``` Ausgabe: ``` { "summary": { "createdAt": 1559248067.545, "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 1 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Flows](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-workflows.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [CreateFlowTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/create-flow-template.html)in der *AWS CLI Befehlsreferenz*. ### `create-system-instance` Das folgende Codebeispiel zeigt die Verwendung`create-system-instance`. **AWS CLI** **So erstellen Sie eine System-Instance** Im folgenden Beispiel für `create-system-instance` wird eine System-Instance erstellt. Der Wert `MySystemInstanceDefinition` ist die GraphQL, die die System-Instance modelliert. ``` aws iotthingsgraph create-system-instance -\ -definition language=GRAPHQL,text="MySystemInstanceDefinition" \ --target CLOUD \ --flow-actions-role-arn myRoleARN ``` Ausgabe: ``` { "summary": { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218", "status": "NOT_DEPLOYED", "target": "CLOUD", "createdAt": 1559249315.208, "updatedAt": 1559249315.208 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Systemen und Flow-Konfigurationen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-sysdeploy.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [CreateSystemInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/create-system-instance.html)in der *AWS CLI Befehlsreferenz*. ### `create-system-template` Das folgende Codebeispiel zeigt die Verwendung`create-system-template`. **AWS CLI** **So erstellen Sie ein System** Im folgenden Beispiel für `create-system-template` wird ein System erstellt. Der Wert von MySystemDefinition ist das GraphQL, das das System modelliert. ``` aws iotthingsgraph create-system-template \ --definition language=GRAPHQL,text="MySystemDefinition" ``` Ausgabe: ``` { "summary": { "createdAt": 1559249776.254, "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MySystem", "revisionNumber": 1 } } ``` Weitere Informationen finden Sie unter [Erstellen von Systemen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-sysdeploy-systems.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [CreateSystemTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/create-system-template.html)in der *AWS CLI Befehlsreferenz.* ### `delete-flow-template` Das folgende Codebeispiel zeigt die Verwendung`delete-flow-template`. **AWS CLI** **So löschen Sie einen Flow** Im folgenden Beispiel für `delete-flow-template` wird ein Flow (Workflow) gelöscht. ``` aws iotthingsgraph delete-flow-template \ --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems and Deployments](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-lifecycle.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteFlowTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/delete-flow-template.html)in der *AWS CLI Befehlsreferenz.* ### `delete-namespace` Das folgende Codebeispiel zeigt die Verwendung`delete-namespace`. **AWS CLI** **Um einen Namespace zu löschen** Im folgenden `delete-namespace`-Beispiel wird ein Namespace gelöscht. ``` aws iotthingsgraph delete-namespace ``` Ausgabe: ``` { "namespaceArn": "arn:aws:iotthingsgraph:us-west-2:123456789012", "namespaceName": "us-west-2/123456789012/default" } ``` Weitere Informationen finden Sie unter [Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems and Deployments](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-lifecycle.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/delete-namespace.html)in der *AWS CLI Befehlsreferenz.* ### `delete-system-instance` Das folgende Codebeispiel zeigt die Verwendung`delete-system-instance`. **AWS CLI** **So löschen Sie eine System-Instance** Im folgenden Beispiel für `delete-system-instance` wird eine System-Instance gelöscht. ``` aws iotthingsgraph delete-system-instance \ --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems and Deployments](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-lifecycle.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteSystemInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/delete-system-instance.html)in der *AWS CLI Befehlsreferenz.* ### `delete-system-template` Das folgende Codebeispiel zeigt die Verwendung`delete-system-template`. **AWS CLI** **So löschen Sie ein System** Im folgenden Beispiel für `delete-system-template` wird ein System gelöscht. ``` aws iotthingsgraph delete-system-template \ --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems and Deployments](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-lifecycle.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteSystemTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/delete-system-template.html)in der *AWS CLI Befehlsreferenz.* ### `deploy-system-instance` Das folgende Codebeispiel zeigt die Verwendung`deploy-system-instance`. **AWS CLI** **So stellen Sie eine System-Instance bereit** Im folgenden Beispiel für `delete-system-template` wird eine System-Instance bereitgestellt. ``` aws iotthingsgraph deploy-system-instance \ --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218" ``` Ausgabe: ``` { "summary": { "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment:Room218", "createdAt": 1559249776.254, "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", "status": "DEPLOYED_IN_TARGET", "target": "CLOUD", "updatedAt": 1559249776.254 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Systemen und Flow-Konfigurationen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-sysdeploy.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [DeploySystemInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/deploy-system-instance.html)in der *AWS CLI Befehlsreferenz*. ### `deprecate-flow-template` Das folgende Codebeispiel zeigt die Verwendung`deprecate-flow-template`. **AWS CLI** **So kennzeichnen Sie einen Flow als veraltet** Im folgenden Beispiel für `deprecate-flow-template` wird ein Flow (Workflow) als veraltet gekennzeichnet. ``` aws iotthingsgraph deprecate-flow-template \ --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems and Deployments](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-lifecycle.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeprecateFlowTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/deprecate-flow-template.html)in der *AWS CLI Befehlsreferenz.* ### `deprecate-system-template` Das folgende Codebeispiel zeigt die Verwendung`deprecate-system-template`. **AWS CLI** **So kennzeichnen Sie ein System als veraltet** Im folgenden Beispiel für `deprecate-system-template` wird ein System als veraltet gekennzeichnet. ``` aws iotthingsgraph deprecate-system-template \ --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems and Deployments](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-lifecycle.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeprecateSystemTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/deprecate-system-template.html)in der *AWS CLI Befehlsreferenz.* ### `describe-namespace` Das folgende Codebeispiel zeigt die Verwendung`describe-namespace`. **AWS CLI** **So rufen Sie eine Beschreibung Ihres Namespaces ab** Im folgenden Beispiel für `describe-namespace` wird eine Beschreibung Ihres Namespaces abgerufen. ``` aws iotthingsgraph describe-namespace ``` Ausgabe: ``` { "namespaceName": "us-west-2/123456789012/default", "trackingNamespaceName": "aws", "trackingNamespaceVersion": 1, "namespaceVersion": 5 } ``` Weitere Informationen finden Sie unter [Namespaces](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-whatis-namespace.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [DescribeNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/describe-namespace.html)in der *AWS CLI Befehlsreferenz*. ### `dissociate-entity-from-thing` Das folgende Codebeispiel zeigt die Verwendung`dissociate-entity-from-thing`. **AWS CLI** **So heben Sie die Zuordnung eines Objekts zu einem Gerät auf** Im folgenden Beispiel für `dissociate-entity-from-thing` wird die Zuordnung eines Objekts zu einem Gerät aufgehoben. ``` aws iotthingsgraph dissociate-entity-from-thing \ --thing-name "MotionSensorName" \ --entity-type "DEVICE" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen und Hochladen von Modellen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-models-gs.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [DissociateEntityFromThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/dissociate-entity-from-thing.html)in der *AWS CLI Befehlsreferenz*. ### `get-entities` Das folgende Codebeispiel zeigt die Verwendung`get-entities`. **AWS CLI** **So rufen Sie Definitionen für Entitäten ab** Im folgenden Beispiel für `get-entities` wird eine Definition für ein Gerätemodell abgerufen. ``` aws iotthingsgraph get-entities \ --ids "urn:tdm:aws/examples:DeviceModel:MotionSensor" ``` Ausgabe: ``` { "descriptions": [ { "id": "urn:tdm:aws/examples:DeviceModel:MotionSensor", "type": "DEVICE_MODEL", "createdAt": 1559256190.599, "definition": { "language": "GRAPHQL", "text": "##\n# Specification of motion sensor devices interface.\n##\ntype MotionSensor @deviceModel(id: \"urn:tdm:aws/examples:deviceModel:MotionSensor\",\n capability: \"urn:tdm:aws/examples:capability:MotionSensorCapability\") {ignore:void}" } } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Hochladen von Modellen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-models-gs.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [GetEntities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/get-entities.html)in der *AWS CLI Befehlsreferenz*. ### `get-flow-template-revisions` Das folgende Codebeispiel zeigt die Verwendung`get-flow-template-revisions`. **AWS CLI** **So rufen Sie Revisionsinformationen zu einem Flow ab** Im folgenden Beispiel für `get-flow-template-revisions` werden Änderungsinformationen zu einem Flow (Workflow) abgerufen. ``` aws iotthingsgraph get-flow-template-revisions \ --id urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow ``` Ausgabe: ``` { "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 1, "createdAt": 1559247540.292 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Flows](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-workflows.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [GetFlowTemplateRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/get-flow-template-revisions.html)in der *AWS CLI Befehlsreferenz*. ### `get-flow-template` Das folgende Codebeispiel zeigt die Verwendung`get-flow-template`. **AWS CLI** **So rufen Sie eine Flow-Definition ab** Im folgenden Beispiel für `get-flow-template` wird eine Definition für einen Flow (Workflow) abgerufen. ``` aws iotthingsgraph get-flow-template \ --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow" ``` Ausgabe: ``` { "description": { "summary": { "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 1, "createdAt": 1559247540.292 }, "definition": { "language": "GRAPHQL", "text": "{\nquery MyFlow($camera: string!, $screen: string!) @workflowType(id: \"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow\") @annotation(type: \"tgc:FlowEvent\", id: \"sledged790c1b2bcd949e09da0c9bfc077f79d\", x: 1586, y: 653) @triggers(definition: \"{MotionSensor(description: \\\"\\\") @position(x: 1045, y: 635.6666564941406) {\\n condition(expr: \\\"devices[name == \\\\\\\"motionSensor\\\\\\\"].events[name == \\\\\\\"StateChanged\\\\\\\"].lastEvent\\\")\\n action(expr: \\\"\\\")\\n}}\") {\n variables {\n cameraResult @property(id: \"urn:tdm:aws/examples:property:CameraStateProperty\")\n }\n steps {\n step(name: \"Camera\", outEvent: [\"sledged790c1b2bcd949e09da0c9bfc077f79d\"]) @position(x: 1377, y: 638.6666564941406) {\n DeviceActivity(deviceModel: \"urn:tdm:aws/examples:deviceModel:Camera\", out: \"cameraResult\", deviceId: \"${camera}\") {\n capture\n }\n }\n step(name: \"Screen\", inEvent: [\"sledged790c1b2bcd949e09da0c9bfc077f79d\"]) @position(x: 1675.6666870117188, y: 637.9999847412109) {\n DeviceActivity(deviceModel: \"urn:tdm:aws/examples:deviceModel:Screen\", deviceId: \"${screen}\") {\n display(imageUrl: \"${cameraResult.lastClickedImage}\")\n }\n }\n }\n}\n}" }, "validatedNamespaceVersion": 5 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Flows](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-workflows.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [GetFlowTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/get-flow-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-namespace-deletion-status` Das folgende Codebeispiel zeigt die Verwendung`get-namespace-deletion-status`. **AWS CLI** **So rufen Sie den Status der Namespace-Löschaufgabe ab** Im folgenden Beispiel für `get-namespace-deletion-status` wird der Status der Namespace-Löschaufgabe abgerufen. ``` aws iotthingsgraph get-namespace-deletion-status ``` Ausgabe: ``` { "namespaceArn": "arn:aws:iotthingsgraph:us-west-2:123456789012", "namespaceName": "us-west-2/123456789012/default" "status": "SUCCEEDED " } ``` Weitere Informationen finden Sie unter [Namespaces](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-whatis-namespace.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [GetNamespaceDeletionStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/get-namespace-deletion-status.html)in der *AWS CLI Befehlsreferenz*. ### `get-system-instance` Das folgende Codebeispiel zeigt die Verwendung`get-system-instance`. **AWS CLI** **So rufen Sie eine System-Instance ab** Im folgenden Beispiel für `get-system-instance` wird eine Definition für eine System-Instance abgerufen. ``` aws iotthingsgraph get-system-instance \ --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218" ``` Ausgabe: ``` { "description": { "summary": { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218", "status": "NOT_DEPLOYED", "target": "CLOUD", "createdAt": 1559249315.208, "updatedAt": 1559249315.208 }, "definition": { "language": "GRAPHQL", "text": "{\r\nquery Room218 @deployment(id: \"urn:tdm:us-west-2/123456789012/default:Deployment:Room218\", systemId: \"urn:tdm:us-west-2/123456789012/default:System:SecurityFlow\") {\r\n motionSensor(deviceId: \"MotionSensorName\")\r\n screen(deviceId: \"ScreenName\")\r\n camera(deviceId: \"CameraName\") \r\n triggers {MotionEventTrigger(description: \"a trigger\") { \r\n condition(expr: \"devices[name == 'motionSensor'].events[name == 'StateChanged'].lastEvent\") \r\n action(expr: \"ThingsGraph.startFlow('SecurityFlow', bindings[name == 'camera'].deviceId, bindings[name == 'screen'].deviceId)\")\r\n }\r\n }\r\n }\r\n }" }, "metricsConfiguration": { "cloudMetricEnabled": false }, "validatedNamespaceVersion": 5, "flowActionsRoleArn": "arn:aws:iam::123456789012:role/ThingsGraphRole" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Systemen und Flow-Konfigurationen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-sysdeploy.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [GetSystemInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/get-system-instance.html)in der *AWS CLI Befehlsreferenz*. ### `get-system-template-revisions` Das folgende Codebeispiel zeigt die Verwendung`get-system-template-revisions`. **AWS CLI** **So rufen Sie Änderungsinformationen zu einem System ab** Im folgenden Beispiel für `get-system-template-revisions` werden Änderungsinformationen zu einem System abgerufen. ``` aws iotthingsgraph get-system-template-revisions \ --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" ``` Ausgabe: ``` { "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MySystem", "revisionNumber": 1, "createdAt": 1559247540.656 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Systemen und Flow-Konfigurationen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-sysdeploy.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [GetSystemTemplateRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/get-system-template-revisions.html)in der *AWS CLI Befehlsreferenz*. ### `get-system-template` Das folgende Codebeispiel zeigt die Verwendung`get-system-template`. **AWS CLI** **So rufen Sie ein System ab** Im folgenden Beispiel für `get-system-template` wird eine Definition für ein System abgerufen. ``` aws iotthingsgraph get-system-template \ --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" ``` Ausgabe: ``` { "description": { "summary": { "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MyFlow", "revisionNumber": 1, "createdAt": 1559247540.656 }, "definition": { "language": "GRAPHQL", "text": "{\ntype MySystem @systemType(id: \"urn:tdm:us-west-2/123456789012/default:System:MySystem\", description: \"\") {\n camera: Camera @thing(id: \"urn:tdm:aws/examples:deviceModel:Camera\")\n screen: Screen @thing(id: \"urn:tdm:aws/examples:deviceModel:Screen\")\n motionSensor: MotionSensor @thing(id: \"urn:tdm:aws/examples:deviceModel:MotionSensor\")\n MyFlow: MyFlow @workflow(id: \"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow\")\n}\n}" }, "validatedNamespaceVersion": 5 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Systemen und Flow-Konfigurationen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-sysdeploy.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [GetSystemTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/get-system-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-upload-status` Das folgende Codebeispiel zeigt die Verwendung`get-upload-status`. **AWS CLI** **So rufen Sie den Upload-Status für Ihre Entität ab** Im folgenden Beispiel für `get-upload-status` wird der Status der Upload-Operation für Ihre Entität abgerufen. Der Wert für `MyUploadId` ist der ID-Wert, der von der Operation `upload-entity-definitions` zurückgegeben wurde. ``` aws iotthingsgraph get-upload-status \ --upload-id "MyUploadId" ``` Ausgabe: ``` { "namespaceName": "us-west-2/123456789012/default", "namespaceVersion": 5, "uploadId": "f6294f1e-b109-4bbe-9073-f451a2dda2da", "uploadStatus": "SUCCEEDED" } ``` Weitere Informationen finden Sie unter [Modellieren von Entitäten](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-modelmanagement.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [GetUploadStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/get-upload-status.html)in der *AWS CLI Befehlsreferenz*. ### `list-flow-execution-messages` Das folgende Codebeispiel zeigt die Verwendung`list-flow-execution-messages`. **AWS CLI** **So rufen Sie Informationen zu Ereignissen in einer Flow-Ausführung ab** Im folgenden Beispiel für `list-flow-execution-messages` werden Informationen zu Ereignissen in einer Flow-Ausführung abgerufen. ``` aws iotthingsgraph list-flow-execution-messages \ --flow-execution-id "urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow_2019-05-11T19:39:55.317Z_MotionSensor_69b151ad-a611-42f5-ac21-fe537f9868ad" ``` Ausgabe: ``` { "messages": [ { "eventType": "EXECUTION_STARTED", "messageId": "f6294f1e-b109-4bbe-9073-f451a2dda2da", "payload": "Flow execution started", "timestamp": 1559247540.656 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Flows](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-workflows.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [ListFlowExecutionMessages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/list-flow-execution-messages.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie alle Tags für eine Ressource auf** Das folgende `list-tags-for-resource` Beispiel listet alle Tags für eine AWS IoT Things Graph Graph-Ressource auf. ``` aws iotthingsgraph list-tags-for-resource \ --resource-arn "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218" ``` Ausgabe: ``` { "tags": [ { "key": "Type", "value": "Residential" } ] } ``` Weitere Informationen finden Sie unter [Tagging Your AWS IoT Things Graph Resources](https://docs.aws.amazon.com/thingsgraph/latest/ug/tagging-tg.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `search-entities` Das folgende Codebeispiel zeigt die Verwendung`search-entities`. **AWS CLI** **So suchen Sie nach Entitäten** Im folgenden Beispiel für `search-entities` wird nach allen Entitäten des Typs `EVENT` gesucht. ``` aws iotthingsgraph search-entities \ --entity-types "EVENT" ``` Ausgabe: ``` { "descriptions": [ { "id": "urn:tdm:aws/examples:Event:MotionSensorEvent", "type": "EVENT", "definition": { "language": "GRAPHQL", "text": "##\n# Description of events emitted by motion sensor.\n##\ntype MotionSensorEvent @eventType(id: \"urn:tdm:aws/examples:event:MotionSensorEvent\",\n payload: \"urn:tdm:aws/examples:property:MotionSensorStateProperty\") {ignore:void}" } }, { "id": "urn:tdm:us-west-2/123456789012/default:Event:CameraClickedEventV2", "type": "EVENT", "definition": { "language": "GRAPHQL", "text": "type CameraClickedEventV2 @eventType(id: \"urn:tdm:us-west-2/123456789012/default:event:CameraClickedEventV2\",\r\npayload: \"urn:tdm:aws:Property:Boolean\"){ignore:void}" } }, { "id": "urn:tdm:us-west-2/123456789012/default:Event:MotionSensorEventV2", "type": "EVENT", "definition": { "language": "GRAPHQL", "text": "# Event emitted by the motion sensor.\r\ntype MotionSensorEventV2 @eventType(id: \"urn:tdm:us-west-2/123456789012/default:event:MotionSensorEventV2\",\r\npayload: \"urn:tdm:us-west-2/123456789012/default:property:MotionSensorStateProperty2\") {ignore:void}" } } ], "nextToken": "urn:tdm:us-west-2/123456789012/default:Event:MotionSensorEventV2" } ``` Weitere Informationen finden Sie in der [Datenmodellreferenz von AWS IoT Things Graph](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-models.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [SearchEntities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/search-entities.html)in der *AWS CLI Befehlsreferenz*. ### `search-flow-executions` Das folgende Codebeispiel zeigt die Verwendung`search-flow-executions`. **AWS CLI** **So suchen Sie nach Flow-Ausführungen** Im folgenden Beispiel für `search-flow-executions` wird nach allen Ausführungen eines Flows in einer angegebenen System-Instance gesucht. ``` aws iotthingsgraph search-flow-executions \ --system-instance-id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218" ``` Ausgabe: ``` { "summaries": [ { "createdAt": 1559247540.656, "flowExecutionId": "f6294f1e-b109-4bbe-9073-f451a2dda2da", "flowTemplateId": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "status": "RUNNING ", "systemInstanceId": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "updatedAt": 1559247540.656 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Systemen und Flow-Konfigurationen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-sysdeploy.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [SearchFlowExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/search-flow-executions.html)in der *AWS CLI Befehlsreferenz*. ### `search-flow-templates` Das folgende Codebeispiel zeigt die Verwendung`search-flow-templates`. **AWS CLI** **So suchen Sie nach Flows (oder Workflows)** Im folgenden Beispiel für `search-flow-templates` wird nach allen Flows (Workflows) gesucht, die das Kamera-Gerätemodell enthalten. ``` aws iotthingsgraph search-flow-templates \ --filters name="DEVICE_MODEL_ID",value="urn:tdm:aws/examples:DeviceModel:Camera" ``` Ausgabe: ``` { "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 1, "createdAt": 1559247540.292 }, { "id": "urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow", "revisionNumber": 3, "createdAt": 1548283099.27 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Flows](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-workflows.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [SearchFlowTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/search-flow-templates.html)in der *AWS CLI Befehlsreferenz*. ### `search-system-instances` Das folgende Codebeispiel zeigt die Verwendung`search-system-instances`. **AWS CLI** **So suchen Sie nach System-Instances** Im folgenden Beispiel für `search-system-instances` wird nach allen System-Instances gesucht, die das angegebene System enthalten. ``` aws iotthingsgraph search-system-instances \ --filters name="SYSTEM_TEMPLATE_ID",value="urn:tdm:us-west-2/123456789012/default:System:SecurityFlow" ``` Ausgabe: ``` { "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:DeploymentForSample", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/DeploymentForSample", "status": "NOT_DEPLOYED", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGrnGr", "createdAt": 1555716314.707, "updatedAt": 1555716314.707 }, { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:MockDeployment", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/MockDeployment", "status": "DELETED_IN_TARGET", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGrnGr", "createdAt": 1549416462.049, "updatedAt": 1549416722.361, "greengrassGroupId": "01d04b07-2a51-467f-9d03-0c90b3cdcaaf", "greengrassGroupVersionId": "7365aed7-2d3e-4d13-aad8-75443d45eb05" }, { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:MockDeployment2", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/MockDeployment2", "status": "DEPLOYED_IN_TARGET", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGrnGr", "createdAt": 1549572385.774, "updatedAt": 1549572418.408, "greengrassGroupId": "01d04b07-2a51-467f-9d03-0c90b3cdcaaf", "greengrassGroupVersionId": "bfa70ab3-2bf7-409c-a4d4-bc8328ae5b86" }, { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room215", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room215", "status": "NOT_DEPLOYED", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGG", "createdAt": 1547056918.413, "updatedAt": 1547056918.413 }, { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218", "status": "NOT_DEPLOYED", "target": "CLOUD", "createdAt": 1559249315.208, "updatedAt": 1559249315.208 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Systemen und Flow-Konfigurationen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-sysdeploy.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [SearchSystemInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/search-system-instances.html)in der *AWS CLI Befehlsreferenz*. ### `search-system-templates` Das folgende Codebeispiel zeigt die Verwendung`search-system-templates`. **AWS CLI** **So suchen Sie nach einem System** Im folgenden Beispiel für `search-system-templates` wird nach allen Systemen gesucht, die den angegebenen Flow enthalten. ``` aws iotthingsgraph search-system-templates \ --filters name="FLOW_TEMPLATE_ID",value="urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow" ``` Ausgabe: ``` { "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:System:SecurityFlow", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/SecurityFlow", "revisionNumber": 1, "createdAt": 1548283099.433 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Flows](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-workflows.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [SearchSystemTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/search-system-templates.html)in der *AWS CLI Befehlsreferenz*. ### `search-things` Das folgende Codebeispiel zeigt die Verwendung`search-things`. **AWS CLI** **So suchen Sie nach Objekten, die mit Geräten und Gerätemodellen verknüpft sind** Im folgenden `search-things` Beispiel wird nach allen Dingen gesucht, die mit dem HCSR501 MotionSensor Gerät verknüpft sind. ``` aws iotthingsgraph search-things \ --entity-id "urn:tdm:aws/examples:Device:HCSR501MotionSensor" ``` Ausgabe: ``` { "things": [ { "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MotionSensor1", "thingName": "MotionSensor1" }, { "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/TG_MS", "thingName": "TG_MS" } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Hochladen von Modellen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-models-gs.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [SearchThings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/search-things.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So erstellen Sie ein Tag für eine Ressource** Im folgenden Beispiel für `tag-resource` wird ein Tag für die angegebene Ressource erstellt. ``` aws iotthingsgraph tag-resource \ --resource-arn "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218" \ --tags key="Type",value="Residential" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging Your AWS IoT Things Graph Resources](https://docs.aws.amazon.com/thingsgraph/latest/ug/tagging-tg.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `undeploy-system-instance` Das folgende Codebeispiel zeigt die Verwendung`undeploy-system-instance`. **AWS CLI** **So heben Sie die Bereitstellung einer System-Instance auf ihrem Ziel auf** Im folgenden Beispiel für `undeploy-system-instance` wird eine System-Instance aus ihrem Ziel entfernt. ``` aws iotthingsgraph undeploy-system-instance \ --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room215" ``` Ausgabe: ``` { "summary": { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room215", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room215", "status": "PENDING_DELETE", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGrnGr", "createdAt": 1553189694.255, "updatedAt": 1559344549.601, "greengrassGroupId": "01d04b07-2a51-467f-9d03-0c90b3cdcaaf", "greengrassGroupVersionId": "731b371d-d644-4b67-ac64-3934e99b75d7" } } ``` Weitere Informationen finden Sie unter [Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems and Deployments](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-lifecycle.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UndeploySystemInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/undeploy-system-instance.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag für eine Ressource** Im folgenden Beispiel für `untag-resource` wird ein Tag für die angegebene Ressource entfernt. ``` aws iotthingsgraph untag-resource \ --resource-arn "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218" \ --tag-keys "Type" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging Your AWS IoT Things Graph Resources](https://docs.aws.amazon.com/thingsgraph/latest/ug/tagging-tg.html) im *AWS IoT Things Graph Graph-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-flow-template` Das folgende Codebeispiel zeigt die Verwendung`update-flow-template`. **AWS CLI** **So aktualisieren Sie einen Flow** Im folgenden Beispiel für `update-flow-template` wird ein Flow (Workflow) aktualisiert. Der Wert `MyFlowDefinition` ist die GraphQL, die den Flow modelliert. ``` aws iotthingsgraph update-flow-template \ --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow" \ --definition language=GRAPHQL,text="MyFlowDefinition" ``` Ausgabe: ``` { "summary": { "createdAt": 1559248067.545, "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 2 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Flows](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-workflows.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [UpdateFlowTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/update-flow-template.html)in der *AWS CLI Befehlsreferenz*. ### `update-system-template` Das folgende Codebeispiel zeigt die Verwendung`update-system-template`. **AWS CLI** **So aktualisieren Sie ein System** Im folgenden Beispiel für `update-system-template` wird ein System aktualisiert. Der Wert für `MySystemDefinition` ist die GraphQL, die das System modelliert. ``` aws iotthingsgraph update-system-template \ --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" \ --definition language=GRAPHQL,text="MySystemDefinition" ``` Ausgabe: ``` { "summary": { "createdAt": 1559249776.254, "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MySystem", "revisionNumber": 2 } } ``` Weitere Informationen finden Sie unter [Erstellen von Systemen](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-sysdeploy-systems.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [UpdateSystemTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/update-system-template.html)in der *AWS CLI Befehlsreferenz*. ### `upload-entity-definitions` Das folgende Codebeispiel zeigt die Verwendung`upload-entity-definitions`. **AWS CLI** **So laden Sie Entitätsdefinitionen hoch** Im folgenden Beispiel für `upload-entity-definitions` werden Entitätsdefinitionen in Ihren Namespace hochgeladen. Der Wert `MyEntityDefinitions` ist die GraphQL, die die Entitäten modelliert. ``` aws iotthingsgraph upload-entity-definitions \ --document language=GRAPHQL,text="MyEntityDefinitions" ``` Ausgabe: ``` { "uploadId": "f6294f1e-b109-4bbe-9073-f451a2dda2da" } ``` Weitere Informationen finden Sie unter [Modellieren von Entitäten](https://docs.aws.amazon.com/thingsgraph/latest/ug/iot-tg-modelmanagement.html) im *Benutzerhandbuch für AWS IoT Things Graph*. + Einzelheiten zur API finden Sie [UploadEntityDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotthingsgraph/upload-entity-definitions.html)in der *AWS CLI Befehlsreferenz*. # AWS IoT Wireless Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS IoT Wireless. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-aws-account-with-partner-account` Das folgende Codebeispiel zeigt, wie Sie`associate-aws-account-with-partner-account`. **AWS CLI** **Um ein Partnerkonto mit Ihrem AWS Konto zu verknüpfen** Im folgenden `associate-aws-account-with-partner-account` Beispiel werden die folgenden Anmeldeinformationen für das Sidewalk-Konto Ihrem AWS Konto zugeordnet. ``` aws iotwireless associate-aws-account-with-partner-account \ --sidewalk AmazonId="12345678901234",AppServerPrivateKey="a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" ``` Ausgabe: ``` { "Sidewalk": { "AmazonId": "12345678901234", "AppServerPrivateKey": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" } } ``` Weitere Informationen finden Sie unter [Amazon Sidewalk Integration for AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sidewalk.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [AssociateAwsAccountWithPartnerAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/associate-aws-account-with-partner-account.html)in der *AWS CLI Befehlsreferenz.* ### `associate-wireless-device-with-thing` Das folgende Codebeispiel zeigt die Verwendung`associate-wireless-device-with-thing`. **AWS CLI** **So verknüpfen Sie ein Objekt mit einem drahtlosen Gerät** Im folgenden Beispiel für `associate-wireless-device-with-thing` wird Ihrem drahtlosen Gerät, das die angegebene ID hat, ein Objekt zugeordnet. ``` aws iotwireless associate-wireless-device-with-thing \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --thing-arn "arn:aws:iot:us-east-1:123456789012:thing/MyIoTWirelessThing" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen Ihrer Gateways und drahtlosen Geräte zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-onboard-devices.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [AssociateWirelessDeviceWithThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/associate-wireless-device-with-thing.html)in der *AWS CLI Befehlsreferenz.* ### `associate-wireless-gateway-with-certificate` Das folgende Codebeispiel zeigt die Verwendung`associate-wireless-gateway-with-certificate`. **AWS CLI** **So verknüpfen Sie das Zertifikat mit dem drahtlosen Gateway** Im folgenden Beispiel für `associate-wireless-gateway-with-certificate` wird ein drahtloses Gateway einem Zertifikat zugeordnet. ``` aws iotwireless associate-wireless-gateway-with-certificate \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --iot-certificate-id "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" ``` Ausgabe: ``` { "IotCertificateId": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" } ``` Weitere Informationen finden [Sie unter Hinzufügen Ihrer Gateways und drahtlosen Geräte zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-onboard-devices.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [AssociateWirelessGatewayWithCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/associate-wireless-gateway-with-certificate.html)in der *AWS CLI Befehlsreferenz.* ### `associate-wireless-gateway-with-thing` Das folgende Codebeispiel zeigt die Verwendung`associate-wireless-gateway-with-thing`. **AWS CLI** **So verknüpfen Sie ein Objekt mit einem drahtlosen Gateway** Im folgenden Beispiel für `associate-wireless-gateway-with-thing` wird ein Objekt einem drahtlosen Gateway zugeordnet. ``` aws iotwireless associate-wireless-gateway-with-thing \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --thing-arn "arn:aws:iot:us-east-1:123456789012:thing/MyIoTWirelessThing" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen Ihrer Gateways und drahtlosen Geräte zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-onboard-devices.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [AssociateWirelessGatewayWithThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/associate-wireless-gateway-with-thing.html)in der *AWS CLI Befehlsreferenz.* ### `create-destination` Das folgende Codebeispiel zeigt die Verwendung`create-destination`. **AWS CLI** **So erstellen Sie ein drahtloses IoT-Ziel** Im folgenden `create-destination` Beispiel wird ein Ziel für die Zuordnung einer Gerätenachricht zu einer AWS IoT-Regel erstellt. Bevor Sie diesen Befehl ausführen, müssen Sie eine IAM-Rolle erstellt haben, die AWS IoT Core for LoRa WAN die zum Senden von Daten an die AWS IoT-Regel erforderlichen Berechtigungen erteilt. ``` aws iotwireless create-destination \ --name IoTWirelessDestination \ --expression-type RuleName \ --expression IoTWirelessRule \ --role-arn arn:aws:iam::123456789012:role/IoTWirelessDestinationRole ``` Ausgabe: ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination", "Name": "IoTWirelessDestination" } ``` Weitere Informationen finden [Sie unter Hinzufügen von Zielen zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-create-destinations.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [CreateDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/create-destination.html)unter *AWS CLI Befehlsreferenz*. ### `create-device-profile` Das folgende Codebeispiel zeigt die Verwendung`create-device-profile`. **AWS CLI** **So erstellen Sie ein neues Geräteprofil** Im folgenden Beispiel für `create-device-profile` wird ein neues Profil für ein drahtloses IoT-Gerät erstellt. ``` aws iotwireless create-device-profile ``` Ausgabe: ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` Weitere Informationen finden [Sie unter Profile zu AWS IoT Core for LoRa WAN hinzufügen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-define-profiles.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [CreateDeviceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/create-device-profile.html)unter *AWS CLI Befehlsreferenz*. ### `create-service-profile` Das folgende Codebeispiel zeigt die Verwendung`create-service-profile`. **AWS CLI** **So erstellen Sie ein neues Serviceprofil** Im folgenden Beispiel für `create-service-profile` wird ein neues Profil für einen drahtlosen IoT-Service erstellt. ``` aws iotwireless create-service-profile ``` Ausgabe: ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` Weitere Informationen finden [Sie unter Profile zu AWS IoT Core for LoRa WAN hinzufügen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-define-profiles.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [CreateServiceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/create-service-profile.html)unter *AWS CLI Befehlsreferenz*. ### `create-wireless-device` Das folgende Codebeispiel zeigt die Verwendung`create-wireless-device`. **AWS CLI** **So erstellen Sie ein drahtloses IoT-Gerät** Im folgenden `create-wireless-device` Beispiel wird eine WLAN-Geräteressource vom Typ LoRa WAN erstellt. ``` aws iotwireless create-wireless-device \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "Description": "My LoRaWAN wireless device" "DestinationName": "IoTWirelessDestination" "LoRaWAN": { "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333", "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100", "OtaaV1_1": { "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012", "JoinEui": "b4c231a359bc2e3d", "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4" }, "DevEui": "ac12efc654d23fc2" }, "Name": "SampleIoTWirelessThing" "Type": LoRaWAN } ``` Ausgabe: ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f", "Id": "1ffd32c8-8130-4194-96df-622f072a315f" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [CreateWirelessDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/create-wireless-device.html)in der *AWS CLI Befehlsreferenz.* ### `create-wireless-gateway-task-definition` Das folgende Codebeispiel zeigt die Verwendung`create-wireless-gateway-task-definition`. **AWS CLI** **So erstellen Sie eine Aufgabendefinition für das drahtlose Gateway** Im folgenden Beispiel für `create-wireless-gateway-task-definition` werden für alle Gateways mit der angegebenen aktuellen Version automatisch Aufgaben mithilfe dieser Aufgabendefinition erstellt. ``` aws iotwireless create-wireless-gateway-task-definition \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "AutoCreateTasks": true, "Name": "TestAutoUpdate", "Update":{ "UpdateDataSource" : "s3://cupsalphagafirmwarebin/station", "UpdateDataRole" : "arn:aws:iam::001234567890:role/SDK_Test_Role", "LoRaWAN" :{ "CurrentVersion" :{ "PackageVersion" : "1.0.0", "Station" : "2.0.5", "Model" : "linux" }, "UpdateVersion" :{ "PackageVersion" : "1.0.1", "Station" : "2.0.5", "Model" : "minihub" } } } } ``` Ausgabe: ``` { "Id": "b7d3baad-25c7-35e7-a4e1-1683a0d61da9" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [CreateWirelessGatewayTaskDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/create-wireless-gateway-task-definition.html)in der *AWS CLI Befehlsreferenz.* ### `create-wireless-gateway-task` Das folgende Codebeispiel zeigt die Verwendung`create-wireless-gateway-task`. **AWS CLI** **So erstellen Sie die Aufgabe für ein drahtloses Gateway** Im folgenden Beispiel für `create-wireless-gateway-task` wird eine Aufgabe für ein drahtloses Gateway erstellt. ``` aws iotwireless create-wireless-gateway-task \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --wireless-gateway-task-definition-id "aa000102-0304-b0cd-ef56-a1b23cde456a" ``` Ausgabe: ``` { "WirelessGatewayTaskDefinitionId": "aa204003-0604-30fb-ac82-a4f95aaf450a", "Status": "Success" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [CreateWirelessGatewayTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/create-wireless-gateway-task.html)in der *AWS CLI Befehlsreferenz.* ### `create-wireless-gateway` Das folgende Codebeispiel zeigt die Verwendung`create-wireless-gateway`. **AWS CLI** **So erstellen Sie ein drahtloses Gateway** Das folgende `create-wireless-gateway` Beispiel erstellt ein drahtloses LoRa WAN-Geräte-Gateway. ``` aws iotwireless create-wireless-gateway \ --lorawan GatewayEui="a1b2c3d4567890ab",RfRegion="US915" \ --name "myFirstLoRaWANGateway" \ --description "Using my first LoRaWAN gateway" ``` Ausgabe: ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [CreateWirelessGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/create-wireless-gateway.html)in der *AWS CLI Befehlsreferenz.* ### `delete-destination` Das folgende Codebeispiel zeigt die Verwendung`delete-destination`. **AWS CLI** **So löschen Sie ein drahtloses IoT-Ziel** Im folgenden Beispiel für `delete-destination` wird die drahtlose Zielressource mit dem Namen `IoTWirelessDestination` gelöscht, die Sie erstellt haben. ``` aws iotwireless delete-destination \ --name "IoTWirelessDestination" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen von Zielen zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-create-destinations.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DeleteDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/delete-destination.html)unter *AWS CLI Befehlsreferenz*. ### `delete-device-profile` Das folgende Codebeispiel zeigt die Verwendung`delete-device-profile`. **AWS CLI** **So löschen Sie ein Geräteprofil** Im folgenden Beispiel für `delete-device-profile` wird ein Geräteprofil mit der angegebenen ID gelöscht, das Sie erstellt haben. ``` aws iotwireless delete-device-profile \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Profile zu AWS IoT Core for LoRa WAN hinzufügen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-define-profiles.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DeleteDeviceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/delete-device-profile.html)unter *AWS CLI Befehlsreferenz*. ### `delete-service-profile` Das folgende Codebeispiel zeigt die Verwendung`delete-service-profile`. **AWS CLI** **So löschen Sie ein Serviceprofil** Im folgenden Beispiel für `delete-service-profile` wird ein Serviceprofil mit der angegebenen ID gelöscht, das Sie erstellt haben. ``` aws iotwireless delete-service-profile \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Profile zu AWS IoT Core for LoRa WAN hinzufügen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-define-profiles.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DeleteServiceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/delete-service-profile.html)unter *AWS CLI Befehlsreferenz*. ### `delete-wireless-device` Das folgende Codebeispiel zeigt die Verwendung`delete-wireless-device`. **AWS CLI** **So löschen Sie ein drahtloses Gerät** Im folgenden Beispiel für `delete-wireless-device` wird ein drahtloses Gerät mit der angegebenen ID gelöscht. ``` aws iotwireless delete-wireless-device \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DeleteWirelessDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/delete-wireless-device.html)in der *AWS CLI Befehlsreferenz.* ### `delete-wireless-gateway-task-definition` Das folgende Codebeispiel zeigt die Verwendung`delete-wireless-gateway-task-definition`. **AWS CLI** **So löschen Sie die Aufgabendefinition für ein drahtloses Gateway** Im folgenden Beispiel für `delete-wireless-gateway-task-definition` wird die Aufgabendefinition mit der folgenden ID für das drahtlose Gateway gelöscht, die Sie erstellt haben. ``` aws iotwireless delete-wireless-gateway-task-definition \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DeleteWirelessGatewayTaskDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/delete-wireless-gateway-task-definition.html)in der *AWS CLI Befehlsreferenz.* ### `delete-wireless-gateway-task` Das folgende Codebeispiel zeigt die Verwendung`delete-wireless-gateway-task`. **AWS CLI** **So löschen Sie die Aufgabe für ein drahtloses Gateway** Im folgenden Beispiel für `delete-wireless-gateway-task` wird die Aufgabe für das drahtlose Gateway gelöscht, die die angegebene ID hat. ``` aws iotwireless delete-wireless-gateway-task \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DeleteWirelessGatewayTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/delete-wireless-gateway-task.html)in der *AWS CLI Befehlsreferenz.* ### `delete-wireless-gateway` Das folgende Codebeispiel zeigt die Verwendung`delete-wireless-gateway`. **AWS CLI** **So löschen Sie ein drahtloses Gateway** Im folgenden Beispiel für `delete-wireless-gateway` wird ein drahtloses Gateway mit der angegebenen ID gelöscht. ``` aws iotwireless delete-wireless-gateway \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DeleteWirelessGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/delete-wireless-gateway.html)in der *AWS CLI Befehlsreferenz.* ### `disassociate-aws-account-from-partner-account` Das folgende Codebeispiel zeigt die Verwendung`disassociate-aws-account-from-partner-account`. **AWS CLI** **Um das Partnerkonto vom Konto zu trennen AWS ** Im folgenden `disassociate-aws-account-from-partner-account` Beispiel wird ein Partnerkonto von Ihrem aktuell verknüpften AWS Konto getrennt. ``` aws iotwireless disassociate-aws-account-from-partner-account \ --partner-account-id "12345678901234" \ --partner-type "Sidewalk" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen Ihrer Gateways und drahtlosen Geräte zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-onboard-devices.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DisassociateAwsAccountFromPartnerAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/disassociate-aws-account-from-partner-account.html)in der *AWS CLI Befehlsreferenz.* ### `disassociate-wireless-device-from-thing` Das folgende Codebeispiel zeigt die Verwendung`disassociate-wireless-device-from-thing`. **AWS CLI** **So heben Sie die Zuordnung des Objekts zum drahtlosen Gerät auf** Im folgenden Beispiel für `disassociate-wireless-device-from-thing` wird die Zuordnung eines drahtlosen Geräts zu seinem aktuell verknüpften Objekt aufgehoben. ``` aws iotwireless disassociate-wireless-device-from-thing \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen Ihrer Gateways und drahtlosen Geräte zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-onboard-devices.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DisassociateWirelessDeviceFromThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/disassociate-wireless-device-from-thing.html)in der *AWS CLI Befehlsreferenz.* ### `disassociate-wireless-gateway-from-certificate` Das folgende Codebeispiel zeigt die Verwendung`disassociate-wireless-gateway-from-certificate`. **AWS CLI** **So heben Sie die Zuordnung des Zertifikats zum drahtlosen Gateway auf** Im folgenden Beispiel für `disassociate-wireless-gateway-from-certificate` wird die Zuordnung eines drahtlosen Gateways zu seinem aktuell verknüpften Zertifikat aufgehoben. ``` aws iotwireless disassociate-wireless-gateway-from-certificate \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen Ihrer Gateways und drahtlosen Geräte zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-onboard-devices.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DisassociateWirelessGatewayFromCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/disassociate-wireless-gateway-from-certificate.html)in der *AWS CLI Befehlsreferenz.* ### `disassociate-wireless-gateway-from-thing` Das folgende Codebeispiel zeigt die Verwendung`disassociate-wireless-gateway-from-thing`. **AWS CLI** **So heben Sie die Zuordnung des Objekts zum drahtlosen Gateway auf** Im folgenden Beispiel für `disassociate-wireless-gateway-from-thing` wird die Zuordnung eines drahtlosen Gateways zu seinem aktuell verknüpften Objekt aufgehoben. ``` aws iotwireless disassociate-wireless-gateway-from-thing \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen Ihrer Gateways und drahtlosen Geräte zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-onboard-devices.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [DisassociateWirelessGatewayFromThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/disassociate-wireless-gateway-from-thing.html)in der *AWS CLI Befehlsreferenz.* ### `get-destination` Das folgende Codebeispiel zeigt die Verwendung`get-destination`. **AWS CLI** **So rufen Sie Informationen zu einem drahtlosen IoT-Ziel ab** Im folgenden Beispiel für `get-destination` werden Informationen zur Zielressource mit dem Namen `IoTWirelessDestination` abgerufen, die Sie erstellt haben. ``` aws iotwireless get-destination \ --name "IoTWirelessDestination" ``` Ausgabe: ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination", "Name": "IoTWirelessDestination", "Expression": "IoTWirelessRule", "ExpressionType": "RuleName", "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole" } ``` Weitere Informationen finden [Sie unter Hinzufügen von Zielen zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-create-destinations.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-destination.html)unter *AWS CLI Befehlsreferenz*. ### `get-device-profile` Das folgende Codebeispiel zeigt die Verwendung`get-device-profile`. **AWS CLI** **So rufen Sie Informationen zu einem Geräteprofil ab** Im folgenden Beispiel für `get-device-profile` werden Informationen zum Geräteprofil mit der angegebenen ID abgerufen, das Sie erstellt haben. ``` aws iotwireless get-device-profile \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Ausgabe: ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "LoRaWAN": { "MacVersion": "1.0.3", "MaxDutyCycle": 10, "Supports32BitFCnt": false, "RegParamsRevision": "RP002-1.0.1", "SupportsJoin": true, "RfRegion": "US915", "MaxEirp": 13, "SupportsClassB": false, "SupportsClassC": false } } ``` Weitere Informationen finden [Sie unter Profile zu AWS IoT Core for LoRa WAN hinzufügen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-define-profiles.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetDeviceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-device-profile.html)unter *AWS CLI Befehlsreferenz*. ### `get-partner-account` Das folgende Codebeispiel zeigt die Verwendung`get-partner-account`. **AWS CLI** **So rufen Sie Informationen zum Partnerkonto ab** Im folgenden Beispiel für `get-partner-account` werden Informationen zu Ihrem Sidewalk-Konto abgerufen, das die folgende ID hat. ``` aws iotwireless get-partner-account \ --partner-account-id "12345678901234" \ --partner-type "Sidewalk" ``` Ausgabe: ``` { "Sidewalk": { "AmazonId": "12345678901234", "Fingerprint": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" }, "AccountLinked": false } ``` Weitere Informationen finden Sie unter [Amazon Sidewalk Integration for AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sidewalk.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetPartnerAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-partner-account.html)in der *AWS CLI Befehlsreferenz.* ### `get-service-endpoint` Das folgende Codebeispiel zeigt die Verwendung`get-service-endpoint`. **AWS CLI** **So rufen Sie den Service-Endpunkt ab** Im folgenden Beispiel für `get-service-endpoint` wird der kontospezifische Endpunkt für das CUPS-Protokoll abgerufen. ``` aws iotwireless get-service-endpoint ``` Ausgabe: ``` { "ServiceType": "CUPS", "ServiceEndpoint": "https://A1RMKZ37ACAGOT.cups.lorawan.us-east-1.amazonaws.com:443", "ServerTrust": "-----BEGIN CERTIFICATE-----\n MIIESTCCAzGgAwIBAgITBn+UV4WH6Kx33rJTMlu8mYtWDTANBgkqhkiG9w0BAQsF\n ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6\n b24gUm9vdCBDQSAxMB4XDTE1MTAyMjAwMDAwMFoXDTI1MTAxOTAwMDAwMFowRjEL\n MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEVMBMGA1UECxMMU2VydmVyIENB\n IDFCMQ8wDQYDVQQDEwZBbWF6b24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK\n AoIBAQDCThZn3c68asg3Wuw6MLAd5tES6BIoSMzoKcG5blPVo+sDORrMd4f2AbnZ\n cMzPa43j4wNxhplty6aUKk4T1qe9BOwKFjwK6zmxxLVYo7bHViXsPlJ6qOMpFge5\n blDP+18x+B26A0piiQOuPkfyDyeR4xQghfj66Yo19V+emU3nazfvpFA+ROz6WoVm\n B5x+F2pV8xeKNR7u6azDdU5YVX1TawprmxRC1+WsAYmz6qP+z8ArDITC2FMVy2fw\n 0IjKOtEXc/VfmtTFch5+AfGYMGMqqvJ6LcXiAhqG5TI+Dr0RtM88k+8XUBCeQ8IG\n KuANaL7TiItKZYxK1MMuTJtV9IblAgMBAAGjggE7MIIBNzASBgNVHRMBAf8ECDAG\n AQH/AgEAMA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUWaRmBlKge5WSPKOUByeW\n dFv5PdAwHwYDVR0jBBgwFoAUhBjMhTTsvAyUlC4IWZzHshBOCggwewYIKwYBBQUH\n AQEEbzBtMC8GCCsGAQUFBzABhiNodHRwOi8vb2NzcC5yb290Y2ExLmFtYXpvbnRy\n dXN0LmNvbTA6BggrBgEFBQcwAoYuaHR0cDovL2NydC5yb290Y2ExLmFtYXpvbnRy\n dXN0LmNvbS9yb290Y2ExLmNlcjA/BgNVHR8EODA2MDSgMqAwhi5odHRwOi8vY3Js\n LnJvb3RjYTEuYW1hem9udHJ1c3QuY29tL3Jvb3RjYTEuY3JsMBMGA1UdIAQMMAow\n CAYGZ4EMAQIBMA0GCSqGSIb3DQEBCwUAA4IBAQCFkr41u3nPo4FCHOTjY3NTOVI1\n 59Gt/a6ZiqyJEi+752+a1U5y6iAwYfmXss2lJwJFqMp2PphKg5625kXg8kP2CN5t\n 6G7bMQcT8C8xDZNtYTd7WPD8UZiRKAJPBXa30/AbwuZe0GaFEQ8ugcYQgSn+IGBI\n 8/LwhBNTZTUVEWuCUUBVV18YtbAiPq3yXqMB48Oz+ctBWuZSkbvkNodPLamkB2g1\n upRyzQ7qDn1X8nn8N8V7YJ6y68AtkHcNSRAnpTitxBKjtKPISLMVCx7i4hncxHZS\n yLyKQXhw2W2Xs0qLeC1etA+jTGDK4UfLeC0SF7FSi8o5LL21L8IzApar2pR/\n -----END CERTIFICATE-----\n" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetServiceEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-service-endpoint.html)in der *AWS CLI Befehlsreferenz.* ### `get-service-profile` Das folgende Codebeispiel zeigt die Verwendung`get-service-profile`. **AWS CLI** **So rufen Sie Informationen zu einem Serviceprofil ab** Im folgenden Beispiel für `get-service-profile` werden Informationen zum Serviceprofil mit der angegebenen ID abgerufen, das Sie erstellt haben. ``` aws iotwireless get-service-profile \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" ``` Ausgabe: ``` { "Arn": "arn:aws:iotwireless:us-east-1:651419225604:ServiceProfile/538185bb-d7e7-4b95-96a0-c51aa4a5b9a0", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "LoRaWAN": { "HrAllowed": false, "NwkGeoLoc": false, "DrMax": 15, "UlBucketSize": 4096, "PrAllowed": false, "ReportDevStatusBattery": false, "DrMin": 0, "DlRate": 60, "AddGwMetadata": false, "ReportDevStatusMargin": false, "MinGwDiversity": 1, "RaAllowed": false, "DlBucketSize": 4096, "DevStatusReqFreq": 24, "TargetPer": 5, "UlRate": 60 } } ``` Weitere Informationen finden [Sie unter Profile zu AWS IoT Core for LoRa WAN hinzufügen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-define-profiles.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetServiceProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-service-profile.html)unter *AWS CLI Befehlsreferenz*. ### `get-wireless-device-statistics` Das folgende Codebeispiel zeigt die Verwendung`get-wireless-device-statistics`. **AWS CLI** **So rufen Sie Betriebsinformationen zu einem drahtlosen Gerät ab** Im folgenden Beispiel für `get-wireless-device-statistics` werden Betriebsinformationen zu einem drahtlosen Gerät abgerufen. ``` aws iotwireless get-wireless-device-statistics \ --wireless-device-id "1ffd32c8-8130-4194-96df-622f072a315f" ``` Ausgabe: ``` { "WirelessDeviceId": "1ffd32c8-8130-4194-96df-622f072a315f" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetWirelessDeviceStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-wireless-device-statistics.html)in der *AWS CLI Befehlsreferenz.* ### `get-wireless-device` Das folgende Codebeispiel zeigt die Verwendung`get-wireless-device`. **AWS CLI** **So rufen Sie Informationen zum drahtlosen Gerät ab** Das folgende `get-wireless-device` Beispiel listet die verfügbaren Widgets in Ihrem AWS Konto auf. ``` aws iotwireless get-wireless-device \ --identifier "1ffd32c8-8130-4194-96df-622f072a315f" \ --identifier-type WirelessDeviceID ``` Ausgabe: ``` { "Name": "myLoRaWANDevice", "ThingArn": "arn:aws:iot:us-east-1:123456789012:thing/44b87eb4-9bce-423d-b5fc-973f5ecc358b", "DestinationName": "IoTWirelessDestination", "Id": "1ffd32c8-8130-4194-96df-622f072a315f", "ThingName": "44b87eb4-9bce-423d-b5fc-973f5ecc358b", "Type": "LoRaWAN", "LoRaWAN": { "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333", "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100", "OtaaV1_1": { "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012", "JoinEui": "b4c231a359bc2e3d", "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4" }, "DevEui": "ac12efc654d23fc2" }, "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f", "Description": "My LoRaWAN wireless device" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetWirelessDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-wireless-device.html)in der *AWS CLI Befehlsreferenz.* ### `get-wireless-gateway-certificate` Das folgende Codebeispiel zeigt die Verwendung`get-wireless-gateway-certificate`. **AWS CLI** **So rufen Sie die ID eines Zertifikats ab, das einem drahtlosen Gateway zugeordnet ist** Im folgenden Beispiel für `get-wireless-gateway-certificate` wird die Zertifikat-ID abgerufen, die einem drahtlosen Gateway mit der angegebenen ID zugeordnet ist. ``` aws iotwireless get-wireless-gateway-certificate \ --id "6c44ab31-8b4d-407a-bed3-19b6c7cda551" ``` Ausgabe: ``` { "IotCertificateId": "8ea4aeae3db34c78cce75d9abd830356869ead6972997e0603e5fd032c804b6f" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetWirelessGatewayCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-wireless-gateway-certificate.html)in der *AWS CLI Befehlsreferenz.* ### `get-wireless-gateway-firmware-information` Das folgende Codebeispiel zeigt die Verwendung`get-wireless-gateway-firmware-information`. **AWS CLI** **So rufen Sie Firmware-Informationen zu einem drahtlosen Gateway ab** Im folgenden Beispiel für `get-wireless-gateway-firmware-information` werden die Firmware-Version und andere Informationen zu einem drahtlosen Gateway abgerufen. ``` aws iotwireless get-wireless-gateway-firmware-information \ --id "3039b406-5cc9-4307-925b-9948c63da25b" ``` Ausgabe: ``` { "LoRaWAN" :{ "CurrentVersion" :{ "PackageVersion" : "1.0.0", "Station" : "2.0.5", "Model" : "linux" } } } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetWirelessGatewayFirmwareInformation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-wireless-gateway-firmware-information.html)in der *AWS CLI Befehlsreferenz.* ### `get-wireless-gateway-statistics` Das folgende Codebeispiel zeigt die Verwendung`get-wireless-gateway-statistics`. **AWS CLI** **So rufen Sie Betriebsinformationen zu einem drahtlosen Gateway ab** Im folgenden Beispiel für `get-wireless-gateway-statistics` werden Betriebsinformationen zu einem drahtlosen Gateway abgerufen. ``` aws iotwireless get-wireless-gateway-statistics \ --wireless-gateway-id "3039b406-5cc9-4307-925b-9948c63da25b" ``` Ausgabe: ``` { "WirelessGatewayId": "3039b406-5cc9-4307-925b-9948c63da25b" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetWirelessGatewayStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-wireless-gateway-statistics.html)in der *AWS CLI Befehlsreferenz.* ### `get-wireless-gateway-task-definition` Das folgende Codebeispiel zeigt die Verwendung`get-wireless-gateway-task-definition`. **AWS CLI** **So rufen Sie Informationen zur Aufgabendefinition für ein drahtloses Gateway ab** Im folgenden Beispiel für `get-wireless-gateway-task-definition` werden Informationen zur Drahtlos-Aufgabendefinition mit der angegebenen ID abgerufen. ``` aws iotwireless get-wireless-gateway-task-definition \ --id "b7d3baad-25c7-35e7-a4e1-1683a0d61da9" ``` Ausgabe: ``` { "AutoCreateTasks": true, "Name": "TestAutoUpdate", "Update":{ "UpdateDataSource" : "s3://cupsalphagafirmwarebin/station", "UpdateDataRole" : "arn:aws:iam::001234567890:role/SDK_Test_Role", "LoRaWAN" :{ "CurrentVersion" :{ "PackageVersion" : "1.0.0", "Station" : "2.0.5", "Model" : "linux" }, "UpdateVersion" :{ "PackageVersion" : "1.0.1", "Station" : "2.0.5", "Model" : "minihub" } } } } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetWirelessGatewayTaskDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-wireless-gateway-task-definition.html)in der *AWS CLI Befehlsreferenz.* ### `get-wireless-gateway-task` Das folgende Codebeispiel zeigt die Verwendung`get-wireless-gateway-task`. **AWS CLI** **So rufen Sie Informationen zur Aufgabe für das drahtlose Gateway ab** Im folgenden Beispiel für `get-wireless-gateway-task` werden Informationen zur Aufgabe für das drahtlose Gateway mit der angegebenen ID abgerufen. ``` aws iotwireless get-wireless-gateway-task \ --id "11693a46-6866-47c3-a031-c9a616e7644b" ``` Ausgabe: ``` { "WirelessGatewayId": "6c44ab31-8b4d-407a-bed3-19b6c7cda551", "WirelessGatewayTaskDefinitionId": "b7d3baad-25c7-35e7-a4e1-1683a0d61da9", "Status": "Success" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetWirelessGatewayTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-wireless-gateway-task.html)in der *AWS CLI Befehlsreferenz.* ### `get-wireless-gateway` Das folgende Codebeispiel zeigt die Verwendung`get-wireless-gateway`. **AWS CLI** **So rufen Sie Informationen zu einem drahtlosen Gateway ab** Im folgenden Beispiel für `get-wireless-gateway` werden Informationen zum drahtlosen Gateway `myFirstLoRaWANGateway` abgerufen. ``` aws iotwireless get-wireless-gateway \ --identifier "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --identifier-type WirelessGatewayId ``` Ausgabe: ``` { "Description": "My first LoRaWAN gateway", "ThingArn": "arn:aws:iot:us-east-1:123456789012:thing/a1b2c3d4-5678-90ab-cdef-12ab345c67de", "LoRaWAN": { "RfRegion": "US915", "GatewayEui": "a1b2c3d4567890ab" }, "ThingName": "a1b2c3d4-5678-90ab-cdef-12ab345c67de", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/6c44ab31-8b4d-407a-bed3-19b6c7cda551", "Name": "myFirstLoRaWANGateway" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [GetWirelessGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/get-wireless-gateway.html)in der *AWS CLI Befehlsreferenz.* ### `list-destinations` Das folgende Codebeispiel zeigt die Verwendung`list-destinations`. **AWS CLI** **So listen Sie die drahtlosen Ziele auf** Das folgende `list-destinations` Beispiel listet die verfügbaren Ziele auf, die für Ihr AWS Konto registriert sind. ``` aws iotwireless list-destinations ``` Ausgabe: ``` { "DestinationList": [ { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination", "Name": "IoTWirelessDestination", "Expression": "IoTWirelessRule", "Description": "Destination for messages processed using IoTWirelessRule", "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole" }, { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination2", "Name": "IoTWirelessDestination2", "Expression": "IoTWirelessRule2", "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole" } ] } ``` Weitere Informationen finden [Sie unter Hinzufügen von Zielen zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-create-destinations.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [ListDestinations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/list-destinations.html)unter *AWS CLI Befehlsreferenz*. ### `list-device-profiles` Das folgende Codebeispiel zeigt die Verwendung`list-device-profiles`. **AWS CLI** **So listen Sie die Geräteprofile auf** Das folgende `list-device-profiles` Beispiel listet die verfügbaren Geräteprofile auf, die für Ihr AWS Konto registriert sind. ``` aws iotwireless list-device-profiles ``` Ausgabe: ``` { "DeviceProfileList": [ { "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d" }, { "Id": "a1b2c3d4-5678-90ab-cdef-12ab345c67de", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/a1b2c3d4-5678-90ab-cdef-12ab345c67de" } ] } ``` Weitere Informationen finden [Sie unter Profile zu AWS IoT Core for LoRa WAN hinzufügen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-define-profiles.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [ListDeviceProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/list-device-profiles.html)unter *AWS CLI Befehlsreferenz*. ### `list-partner-accounts` Das folgende Codebeispiel zeigt die Verwendung`list-partner-accounts`. **AWS CLI** **So listen Sie die Partnerkonten auf** Das folgende `list-partner-accounts` Beispiel listet die verfügbaren Partnerkonten auf, die mit Ihrem AWS Konto verknüpft sind. ``` aws iotwireless list-partner-accounts ``` Ausgabe: ``` { "Sidewalk": [ { "AmazonId": "78965678771228", "Fingerprint": "bd96d8ef66dbfd2160eb60e156849e82ad7018b8b73c1ba0b4fc65c32498ee35" }, { "AmazonId": "89656787651228", "Fingerprint": "bc5e99e151c07be14be7e6603e4489c53f858b271213a36ebe3370777ba06e9b" } ] } ``` Weitere Informationen finden Sie unter [Amazon Sidewalk Integration for AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sidewalk.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [ListPartnerAccounts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/list-partner-accounts.html)in der *AWS CLI Befehlsreferenz.* ### `list-service-profiles` Das folgende Codebeispiel zeigt die Verwendung`list-service-profiles`. **AWS CLI** **So listen Sie die Serviceprofile auf** Das folgende `list-service-profiles` Beispiel listet die verfügbaren Dienstprofile auf, die für Ihr AWS Konto registriert sind. ``` aws iotwireless list-service-profiles ``` Ausgabe: ``` { "ServiceProfileList": [ { "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/538185bb-d7e7-4b95-96a0-c51aa4a5b9a0" }, { "Id": "a1b2c3d4-5678-90ab-cdef-12ab345c67de", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/ea8bc823-5d13-472e-8d26-9550737d8100" } ] } ``` Weitere Informationen finden [Sie unter Profile zu AWS IoT Core for LoRa WAN hinzufügen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-define-profiles.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [ListServiceProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/list-service-profiles.html)unter *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags auf, die der Ressource zugeordnet sind** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags aufgelistet, die einer drahtlosen Zielressource zugewiesen sind. ``` aws iotwireless list-tags-for-resource \ --resource-arn "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination" ``` Ausgabe: ``` { "Tags": [ { "Value": "MyValue", "Key": "MyTag" } ] } ``` Weitere Informationen finden Sie unter [Beschreiben Sie Ihre AWS IoT Core for LoRa WAN-Ressourcen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-describe-resource.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-wireless-devices` Das folgende Codebeispiel zeigt die Verwendung`list-wireless-devices`. **AWS CLI** **So listen Sie die verfügbaren drahtlosen Geräte auf** Das folgende `list-wireless-devices` Beispiel listet die verfügbaren drahtlosen Geräte auf, die für Ihr AWS Konto registriert sind. ``` aws iotwireless list-wireless-devices ``` Ausgabe: ``` { "WirelessDeviceList": [ { "Name": "myLoRaWANDevice", "DestinationName": "IoTWirelessDestination", "Id": "1ffd32c8-8130-4194-96df-622f072a315f", "Type": "LoRaWAN", "LoRaWAN": { "DevEui": "ac12efc654d23fc2" }, "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f" } ] } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [ListWirelessDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/list-wireless-devices.html)in der *AWS CLI Befehlsreferenz.* ### `list-wireless-gateway-task-definitions` Das folgende Codebeispiel zeigt die Verwendung`list-wireless-gateway-task-definitions`. **AWS CLI** **So listen Sie die Aufgabendefinitionen für das drahtlose Gateway auf** Im folgenden `list-wireless-gateway-task-definitions` Beispiel werden die verfügbaren Wireless Gateway-Aufgabendefinitionen aufgeführt, die für Ihr AWS Konto registriert sind. ``` aws iotwireless list-wireless-gateway-task-definitions ``` Ausgabe: ``` { "TaskDefinitions": [ { "Id": "b7d3baad-25c7-35e7-a4e1-1683a0d61da9", "LoRaWAN" : { "CurrentVersion" :{ "PackageVersion" : "1.0.0", "Station" : "2.0.5", "Model" : "linux" }, "UpdateVersion" :{ "PackageVersion" : "1.0.1", "Station" : "2.0.5", "Model" : "minihub" } } } ] } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [ListWirelessGatewayTaskDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/list-wireless-gateway-task-definitions.html)in der *AWS CLI Befehlsreferenz.* ### `list-wireless-gateways` Das folgende Codebeispiel zeigt die Verwendung`list-wireless-gateways`. **AWS CLI** **So listen Sie die drahtlosen Gateways auf** Das folgende `list-wireless-gateways` Beispiel listet die verfügbaren drahtlosen Gateways in Ihrem AWS Konto auf. ``` aws iotwireless list-wireless-gateways ``` Ausgabe: ``` { "WirelessGatewayList": [ { "Description": "My first LoRaWAN gateway", "LoRaWAN": { "RfRegion": "US915", "GatewayEui": "dac632ebc01d23e4" }, "Id": "3039b406-5cc9-4307-925b-9948c63da25b", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/3039b406-5cc9-4307-925b-9948c63da25b", "Name": "myFirstLoRaWANGateway" }, { "Description": "My second LoRaWAN gateway", "LoRaWAN": { "RfRegion": "US915", "GatewayEui": "cda123fffe92ecd2" }, "Id": "3285bdc7-5a12-4991-84ed-dadca65e342e", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/3285bdc7-5a12-4991-84ed-dadca65e342e", "Name": "mySecondLoRaWANGateway" } ] } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [ListWirelessGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/list-wireless-gateways.html)in der *AWS CLI Befehlsreferenz.* ### `send-data-to-wireless-device` Das folgende Codebeispiel zeigt die Verwendung`send-data-to-wireless-device`. **AWS CLI** **So senden Sie Daten an das drahtlose Gerät** Im folgenden Beispiel für `send-data-to-wireless-device` wird ein entschlüsselter Anwendungs-Datenframe an das drahtlose Gerät gesendet. ``` aws iotwireless send-data-to-wireless-device \ --id "11aa5eae-2f56-4b8e-a023-b28d98494e49" \ --transmit-mode "1" \ --payload-data "SGVsbG8gVG8gRGV2c2lt" \ --wireless-metadata LoRaWAN={FPort=1} ``` Ausgabe: ``` { MessageId: "6011dd36-0043d6eb-0072-0008" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [SendDataToWirelessDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/send-data-to-wireless-device.html)in der *AWS CLI Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So geben Sie einen Tag-Schlüssel und -Wert für eine Ressource an** Im folgenden Beispiel für `tag-resource` wird das drahtlose Ziel `IoTWirelessDestination` mit dem Schlüssel `MyTag` und dem Wert `MyValue` getaggt. ``` aws iotwireless tag-resource \ --resource-arn "arn:aws:iotwireless:us-east-1:651419225604:Destination/IoTWirelessDestination" \ --tags Key="MyTag",Value="MyValue" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Beschreiben Sie Ihre AWS IoT Core for LoRa WAN-Ressourcen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-describe-resource.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `test-wireless-device` Das folgende Codebeispiel zeigt die Verwendung`test-wireless-device`. **AWS CLI** **So testen Sie das drahtlose Gerät** Im folgenden Beispiel für `test-wireless-device` werden Uplink-Daten von `Hello` an ein Gerät mit der angegebenen ID gesendet. ``` aws iotwireless test-wireless-device \ --id "11aa5eae-2f56-4b8e-a023-b28d98494e49" ``` Ausgabe: ``` { Result: "Test succeeded. one message is sent with payload: hello" } ``` Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [TestWirelessDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/test-wireless-device.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein oder mehrere Tags aus einer Ressource** Im folgenden Beispiel für `untag-resource` werden das Tag `MyTag` und sein Wert aus dem drahtlosen Ziel `IoTWirelessDestination` entfernt. ``` aws iotwireless untag-resource \ --resource-arn "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination" \ --tag-keys "MyTag" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Beschreiben Sie Ihre AWS IoT Core for LoRa WAN-Ressourcen](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-describe-resource.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-destination` Das folgende Codebeispiel zeigt die Verwendung`update-destination`. **AWS CLI** **So aktualisieren Sie die Eigenschaften eines Ziels** Im folgenden Beispiel für `update-destination` wird die Eigenschaft der Beschreibung eines drahtlosen Ziels aktualisiert. ``` aws iotwireless update-destination \ --name "IoTWirelessDestination" \ --description "Destination for messages processed using IoTWirelessRule" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden [Sie unter Hinzufügen von Zielen zu AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-create-destinations.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [UpdateDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/update-destination.html)unter *AWS CLI Befehlsreferenz*. ### `update-partner-account` Das folgende Codebeispiel zeigt die Verwendung`update-partner-account`. **AWS CLI** **So aktualisieren Sie die Eigenschaften eines Partnerkontos** Im folgenden Beispiel für `update-partner-account` wird der `AppServerPrivateKey` für das Konto aktualisiert, das die angegebene ID hat. ``` aws iotwireless update-partner-account \ --partner-account-id "78965678771228" \ --partner-type "Sidewalk" \ --sidewalk AppServerPrivateKey="f798ab4899346a88599180fee9e14fa1ada7b6df989425b7c6d2146dd6c815bb" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Amazon Sidewalk Integration for AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sidewalk.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [UpdatePartnerAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/update-partner-account.html)in der *AWS CLI Befehlsreferenz.* ### `update-wireless-device` Das folgende Codebeispiel zeigt die Verwendung`update-wireless-device`. **AWS CLI** **So aktualisieren Sie die Eigenschaften eines drahtlosen Geräts** Das folgende `update-wireless-device` Beispiel aktualisiert die Eigenschaften eines drahtlosen Geräts, das für Ihr AWS Konto registriert ist. ``` aws iotwireless update-wireless-device \ --id "1ffd32c8-8130-4194-96df-622f072a315f" \ --destination-name IoTWirelessDestination2 \ --description "Using my first LoRaWAN device" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [UpdateWirelessDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/update-wireless-device.html)in der *AWS CLI Befehlsreferenz.* ### `update-wireless-gateway` Das folgende Codebeispiel zeigt die Verwendung`update-wireless-gateway`. **AWS CLI** **So aktualisieren Sie das drahtlose Gateway** Im folgenden Beispiel für `update-wireless-gateway` wird die Beschreibung Ihres drahtlosen Gateways aktualisiert. ``` aws iotwireless update-wireless-gateway \ --id "3285bdc7-5a12-4991-84ed-dadca65e342e" \ --description "Using my LoRaWAN gateway" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Connecting Devices and Gateways to AWS IoT Core for LoRa WAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan.html) im *AWS IoT Developers Guide*. + Einzelheiten zur API finden Sie [UpdateWirelessGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotwireless/update-wireless-gateway.html)in der *AWS CLI Befehlsreferenz.* # Amazon IVS-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon IVS Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-get-channel` Das folgende Codebeispiel zeigt, wie Sie`batch-get-channel`. **AWS CLI** **So rufen Sie die Kanalkonfigurationsinformationen zu mehreren Kanälen ab** Im folgenden Beispiel für `batch-get-channel` werden Informationen zu den angegebenen Kanälen abgerufen. ``` aws ivs batch-get-channel \ --arns arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \ arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl ``` Ausgabe: ``` { "channels": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "authorized": false, "containerFormat": "TS", "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "latencyMode": "LOW", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "name": "channel-1", "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-1.abcdEFGH.m3u8", "preset": "", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "tags": {}, "type": "STANDARD" }, { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl", "authorized": false, "containerFormat": "FRAGMENTED_MP4", "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "latencyMode": "LOW", "multitrackInputConfiguration": { "enabled": true, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "name": "channel-2", "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-2.abcdEFGH.m3u8", "preset": "", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "tags": {}, "type": "STANDARD" } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [BatchGetChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/batch-get-channel.html)in der *AWS CLI Befehlsreferenz*. ### `batch-get-stream-key` Das folgende Codebeispiel zeigt die Verwendung`batch-get-stream-key`. **AWS CLI** **So rufen Sie Informationen zu mehreren Stream-Schlüsseln ab** Im folgenden Beispiel für `batch-get-stream-key` werden Informationen zu angegebenen Stream-Schlüsseln abgerufen. ``` aws ivs batch-get-stream-key \ --arns arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh \ arn:aws:ivs:us-west-2:123456789012:stream-key/skSKIJKLmnop ``` Ausgabe: ``` { "streamKeys": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} }, { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKIJKLmnop", "value": "sk_us-west-2_abcdABCDefgh_567890ghijkl", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [BatchGetStreamKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/batch-get-stream-key.html)in der *AWS CLI Befehlsreferenz*. ### `batch-start-viewer-session-revocation` Das folgende Codebeispiel zeigt die Verwendung`batch-start-viewer-session-revocation`. **AWS CLI** **So widerrufen Sie Betrachtersitzungen für mehrere Kanal-ARN- und Betrachter-ID-Paare** Im folgenden Beispiel für `batch-start-viewer-session-revocation` wird der Sitzungswiderruf für mehrere Kanal-ARN- und Betrachter-ID-Paare gleichzeitig ausgeführt. Die Anforderung kann normal abgeschlossen werden, gibt jedoch Werte im Fehlerfeld zurück, wenn der Aufrufer nicht berechtigt ist, die angegebene Sitzung zu widerrufen. ``` aws ivs batch-start-viewer-session-revocation \ --viewer-sessions '[{"channelArn":"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh1","viewerId":"abcdefg1","viewerSessionVersionsLessThanOrEqualTo":1234567890}, \ {"channelArn":"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh2","viewerId":"abcdefg2","viewerSessionVersionsLessThanOrEqualTo":1234567890}]' ``` Ausgabe: ``` { "errors": [ { "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh1", "viewerId": "abcdefg1", "code": "403", "message": "not authorized", }, { "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh2", "viewerId": "abcdefg2", "code": "403", "message": "not authorized", } ] } ``` Weitere Informationen finden Sie unter [Einrichten privater Kanäle](https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [BatchStartViewerSessionRevocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/batch-start-viewer-session-revocation.html)in der *AWS CLI Befehlsreferenz*. ### `create-channel` Das folgende Codebeispiel zeigt die Verwendung`create-channel`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Kanal ohne Aufzeichnung** Im folgenden Beispiel für `create-channel` werden ein neuer Kanal und ein zugeordneter Stream-Schlüssel erstellt, um das Streaming zu starten. ``` aws ivs create-channel \ --name 'test-channel' \ --no-insecure-ingest ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "authorized": false, "containerFormat": "TS", "name": "test-channel", "latencyMode": "LOW", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "tags": {}, "type": "STANDARD" }, "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 2: Um einen Kanal mit aktivierter Aufzeichnung zu erstellen, verwenden Sie die in seinem ARN angegebene RecordingConfiguration Ressource** Im folgenden Beispiel für `create-channel` werden ein neuer Kanal und ein zugeordneter Stream-Schlüssel erstellt, um das Streaming zu starten, und die Aufzeichnung für den Kanal eingerichtet: ``` aws ivs create-channel \ --name test-channel-with-recording \ --insecure-ingest \ --recording-configuration-arn 'arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh' ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "containerFormat": "TS", "name": "test-channel-with-recording", "latencyMode": "LOW", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": true, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {}, "type": "STANDARD" }, "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } } ``` Weitere Informationen finden Sie unter [In Amazon S3 aufzeichnen](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/record-to-s3.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 3: So erstellen Sie einen Kanal mit einer durch seinen ARN angegebene Richtlinie für Wiedergabebeschränkungen** Im folgenden Beispiel für `create-channel` werden ein neuer Kanal und ein zugehöriger Stream-Schlüssel erstellt, um das Streaming zu starten, und richtet eine Wiedergabebeschränkungsrichtlinie für den Kanal ein: ``` aws ivs create-channel \ --name test-channel-with-playback-restriction-policy\ --insecure-ingest \ --playback-restriction-policy-arn 'arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ' ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "containerFormat": "TS", "name": "test-channel-with-playback-restriction-policy", "latencyMode": "LOW", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "type": "STANDARD", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2edfGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": true, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {}, "type": "STANDARD" }, "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 4: So erstellen Sie einen Kanal mit aktiviertem Multitrack** Im folgenden Beispiel für `create-channel` werden ein neuer Kanal und ein zugeordneter Stream-Schlüssel zum Starten des Streamings erstellt, und Multitrack aktiviert. ``` aws ivs create-channel \ --name 'test-channel' \ --no-insecure-ingest \ --container-format 'FRAGMENTED_MP4' \ --multitrack-input-configuration '{"enabled": true,"maximumResolution": "FULL_HD","policy": "ALLOW"}' ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "authorized": false, "containerFormat": "FRAGMENTED_MP4", "name": "test-channel", "latencyMode": "LOW", "multitrackInputConfiguration": { "enabled": true, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "tags": {}, "type": "STANDARD" }, "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multitrack-video.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [CreateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/create-channel.html)in der *AWS CLI Befehlsreferenz*. ### `create-playback-restriction-policy` Das folgende Codebeispiel zeigt die Verwendung`create-playback-restriction-policy`. **AWS CLI** **So erstellen Sie eine Richtlinie für Wiedergabebeschränkungen** Im folgenden Beispiel für `create-playback-restriction-policy` wird eine neue Richtlinie zur Wiedergabebeschränkung erstellt. ``` aws ivs create-playback-restriction-policy \ --name "test-playback-restriction-policy" \ --enable-strict-origin-enforcement \ --tags "key1=value1, key2=value2" \ --allowed-countries US MX \ --allowed-origins https://www.website1.com https://www.website2.com ``` Ausgabe: ``` { "playbackRestrictionPolicy": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "allowedCountries": [ "US", "MX" ], "allowedOrigins": [ "https://www.website1.com", "https://www.website2.com" ], "enableStrictOriginEnforcement": true, "name": "test-playback-restriction-policy", "tags": { "key1": "value1", "key2": "value2" } } } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [CreatePlaybackRestrictionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/create-playback-restriction-policy.html)in der *AWS CLI Befehlsreferenz*. ### `create-recording-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-recording-configuration`. **AWS CLI** **Um eine RecordingConfiguration Ressource zu erstellen** Das folgende `create-recording-configuration` Beispiel erstellt eine RecordingConfiguration Ressource, um die Aufzeichnung auf Amazon S3 zu ermöglichen. ``` aws ivs create-recording-configuration \ --name "test-recording-config" \ --recording-reconnect-window-seconds 60 \ --tags "key1=value1, key2=value2" \ --rendition-configuration renditionSelection="CUSTOM",renditions="HD" \ --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=1,storage="LATEST",resolution="LOWEST_RESOLUTION" \ --destination-configuration s3={bucketName=demo-recording-bucket} ``` Ausgabe: ``` { "recordingConfiguration": { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "name": "test-recording-config", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket" } }, "state": "CREATING", "tags": { "key1": "value1", "key2": "value2" }, "thumbnailConfiguration": { "recordingMode": "INTERVAL", "targetIntervalSeconds": 1, "resolution": "LOWEST_RESOLUTION", "storage": [ "LATEST" ] }, "recordingReconnectWindowSeconds": 60, "renditionConfiguration": { "renditionSelection": "CUSTOM", "renditions": [ "HD" ] } } } ``` Weitere Informationen finden Sie unter [Aufzeichnen in Amazon S3](https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [CreateRecordingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/create-recording-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `create-stream-key` Das folgende Codebeispiel zeigt die Verwendung`create-stream-key`. **AWS CLI** **So erstellen Sie einen Stream-Schlüssel** Im folgenden Beispiel für `create-stream-key` wird ein Stream-Schlüssel für einen angegebenen ARN (Amazon Resource Name) erstellt. ``` aws ivs create-stream-key \ --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh ``` Ausgabe: ``` { "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [CreateStreamKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/create-stream-key.html)in der *AWS CLI Befehlsreferenz*. ### `delete-channel` Das folgende Codebeispiel zeigt die Verwendung`delete-channel`. **AWS CLI** **So löschen Sie einen Kanal und die zugehörigen Stream-Schlüssel** Im folgenden Beispiel für `delete-channel` wird der Kanal mit dem angegebenen ARN (Amazon Resource Name) gelöscht. ``` aws ivs delete-channel \ --arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [DeleteChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-channel.html)in der *AWS CLI Befehlsreferenz*. ### `delete-playback-key-pair` Das folgende Codebeispiel zeigt die Verwendung`delete-playback-key-pair`. **AWS CLI** **So löschen Sie ein angegebenes Wiedergabeschlüsselpaar** Im folgenden Beispiel für `delete-playback-key-pair` wird der Fingerabdruck des angegebenen Schlüsselpaars zurückgegeben. ``` aws ivs delete-playback-key-pair \ --arn arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Einrichten privater Kanäle](https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html) im *Benutzerhandbuch zu Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [DeletePlaybackKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-playback-key-pair.html)in der *AWS CLI Befehlsreferenz*. ### `delete-playback-restriction-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-playback-restriction-policy`. **AWS CLI** **So erstellen Sie eine Richtlinie für Wiedergabebeschränkungen** Im folgenden Beispiel für `delete-playback-restriction-policy` wird die Richtlinie für Wiedergabebeschränkungen mit dem angegebenen Richtlinien-ARN (Amazon Resource Name) gelöscht. ``` aws ivs delete-playback-restriction-policy \ --arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [DeletePlaybackRestrictionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-playback-restriction-policy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-recording-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-recording-configuration`. **AWS CLI** **Um die durch ihren ARN angegebene RecordingConfiguration Ressource zu löschen** Im folgenden `delete-recording-configuration` Beispiel wird die RecordingConfiguration Ressource mit dem angegebenen ARN gelöscht. ``` aws ivs delete-recording-configuration \ --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aufzeichnen in Amazon S3](https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie unter [DeleteRecordingConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-recording-configuration.html)*Befehlsreferenz.* ### `delete-stream-key` Das folgende Codebeispiel zeigt die Verwendung`delete-stream-key`. **AWS CLI** **So löschen Sie einen Stream-Schlüssel** Im folgenden Beispiel für `delete-stream-key` wird der Stream-Schlüssel für einen angegebenen ARN (Amazon Resource Name) gelöscht, sodass er nicht mehr zum Streamen verwendet werden kann. ``` aws ivs delete-stream-key \ --arn arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [DeleteStreamKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-stream-key.html)in der *AWS CLI Befehlsreferenz*. ### `get-channel` Das folgende Codebeispiel zeigt die Verwendung`get-channel`. **AWS CLI** **So rufen Sie die Konfigurationsinformationen eines Kanals ab** Im folgenden Beispiel für `get-channel` wird die Kanalkonfiguration für einen angegebenen Kanal-ARN (Amazon Resource Name) abgerufen. ``` aws ivs get-channel \ --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "authorized": false, "containerFormat": "TS", "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "latencyMode": "LOW", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "name": "channel-1", "playbackRestrictionPolicyArn": "", "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "tags": {} "type": "STANDARD", } } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [GetChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-channel.html)in der *AWS CLI Befehlsreferenz*. ### `get-playback-key-pair` Das folgende Codebeispiel zeigt die Verwendung`get-playback-key-pair`. **AWS CLI** **So rufen Sie ein angegebenes Wiedergabeschlüsselpaar ab** Im folgenden Beispiel für `get-playback-key-pair` wird der Fingerabdruck des angegebenen Schlüsselpaars zurückgegeben. ``` aws ivs get-playback-key-pair \ --arn arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh ``` Ausgabe: ``` { "keyPair": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh", "name": "my-playback-key", "fingerprint": "0a:1b:2c:ab:cd:ef:34:56:70:b1:b2:71:01:2a:a3:72", "tags": {} } } ``` Weitere Informationen finden Sie unter [Einrichten privater Kanäle](https://docs.aws.amazon.com/ivs/latest/userguide//private-channels.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [GetPlaybackKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-playback-key-pair.html)in der *AWS CLI Befehlsreferenz*. ### `get-playback-restriction-policy` Das folgende Codebeispiel zeigt die Verwendung`get-playback-restriction-policy`. **AWS CLI** **So rufen Sie die Konfigurationsinformationen einer Richtlinie zur Wiedergabeeinschränkung ab** Im folgenden Beispiel für `get-playback-restriction-policy` wird die Konfiguration der Wiedergabebeschränkungsrichtlinie mit dem angegebenen Richtlinien-ARN (Amazon Resource Name) abgerufen. ``` aws ivs get-playback-restriction-policy \ --arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ" ``` Ausgabe: ``` { "playbackRestrictionPolicy": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "allowedCountries": [ "US", "MX" ], "allowedOrigins": [ "https://www.website1.com", "https://www.website2.com" ], "enableStrictOriginEnforcement": true, "name": "test-playback-restriction-policy", "tags": { "key1": "value1", "key2": "value2" } } } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [GetPlaybackRestrictionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-playback-restriction-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-recording-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-recording-configuration`. **AWS CLI** **Um Informationen über eine RecordingConfiguration Ressource zu erhalten** Im folgenden `get-recording-configuration` Beispiel werden Informationen über die RecordingConfiguration Ressource für den angegebenen ARN abgerufen. ``` aws ivs get-recording-configuration \ --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ" ``` Ausgabe: ``` { "recordingConfiguration": { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket" } }, "name": "test-recording-config", "recordingReconnectWindowSeconds": 60, "state": "ACTIVE", "tags": { "key1" : "value1", "key2" : "value2" }, "thumbnailConfiguration": { "recordingMode": "INTERVAL", "targetIntervalSeconds": 1, "resolution": "LOWEST_RESOLUTION", "storage": [ "LATEST" ] }, "renditionConfiguration": { "renditionSelection": "CUSTOM", "renditions": [ "HD" ] } } } ``` Weitere Informationen finden Sie unter [Aufzeichnen in Amazon S3](https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [GetRecordingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-recording-configuration.html)unter *AWS CLI Befehlsreferenz*. ### `get-stream-key` Das folgende Codebeispiel zeigt die Verwendung`get-stream-key`. **AWS CLI** **So rufen Sie Informationen zu einem Stream ab** Im folgenden Beispiel für `get-stream-key` werden Informationen zum angegebenen Stream-Schlüsseln abgerufen. ``` aws ivs get-stream-key \ --arn arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh --region=us-west-2 ``` Ausgabe: ``` { "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [GetStreamKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-stream-key.html)in der *AWS CLI Befehlsreferenz*. ### `get-stream-session` Das folgende Codebeispiel zeigt die Verwendung`get-stream-session`. **AWS CLI** **So rufen Sie Metadaten für einen bestimmten Stream ab** Im folgenden Beispiel für `get-stream-session` wird die Metadatenkonfiguration für den angegebenen Kanal-ARN (Amazon Resource Name) und den angegebenen Stream abgerufen. Wenn `streamId` nicht angegeben, wird der neueste Stream für den Kanal ausgewählt. ``` aws ivs get-stream-session \ --channel-arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \ --stream-id 'mystream' ``` Ausgabe: ``` { "streamSession": { "streamId": "mystream1", "startTime": "2023-06-26T19:09:28+00:00", "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "mychannel", "latencyMode": "LOW", "type": "STANDARD", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "playbackUrl": "url-string", "authorized": false, "insecureIngest": false, "preset": "" }, "ingestConfiguration": { "audio": { "channels": 2, "codec": "mp4a.40.2", "sampleRate": 8000, "targetBitrate": 46875, "track": "Track0" }, "video": { "avcProfile": "Baseline", "avcLevel": "4.2", "codec": "avc1.42C02A", "encoder": "Lavf58.45.100", "level": "4.2", "profile": "Baseline", "targetBitrate": 8789062, "targetFramerate": 60, "track": "Track0", "videoHeight": 1080, "videoWidth": 1920 } }, "ingestConfigurations": { "audioConfigurations": [ { "channels": 2, "codec": "mp4a.40.2", "sampleRate": 8000, "targetBitrate": 46875, "track": "Track0" } ], "videoConfigurations": [ { "codec": "avc1.42C02A", "encoder": "Lavf58.45.100", "level": "4.2", "profile": "Baseline", "targetBitrate": 8789062, "targetFramerate": 60, "track": "Track0", "videoHeight": 1080, "videoWidth": 1920 } ] }, "recordingConfiguration": { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "name": "test-recording-config", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket" } }, "state": "ACTIVE", "tags": { "key1": "value1", "key2": "value2" }, "thumbnailConfiguration": { "recordingMode": "INTERVAL", "targetIntervalSeconds": 1, "resolution": "LOWEST_RESOLUTION", "storage": [ "LATEST" ] }, "recordingReconnectWindowSeconds": 60, "renditionConfiguration": { "renditionSelection": "CUSTOM", "renditions": [ "HD" ] } }, "truncatedEvents": [ { "code": "StreamTakeoverInvalidPriority", "name": "Stream Takeover Failure", "type": "IVS Stream State Change", "eventTime": "2023-06-26T19:09:48+00:00" }, { "name": "Stream Takeover", "type": "IVS Stream State Change", "eventTime": "2023-06-26T19:09:47+00:00" }, { "name": "Recording Start", "type": "IVS Recording State Change", "eventTime": "2023-06-26T19:09:35+00:00" }, { "name": "Stream Start", "type": "IVS Stream State Change", "eventTime": "2023-06-26T19:09:34+00:00" }, { "name": "Session Created", "type": "IVS Stream State Change", "eventTime": "2023-06-26T19:09:28+00:00" } ] } } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [GetStreamSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-stream-session.html)in der *AWS CLI Befehlsreferenz*. ### `get-stream` Das folgende Codebeispiel zeigt die Verwendung`get-stream`. **AWS CLI** **So rufen Sie Informationen zu einem Stream ab** Im folgenden Beispiel für `get-stream` werden Informationen zum Stream für den angegebenen Kanal abgerufen. ``` aws ivs get-stream \ --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh ``` Ausgabe: ``` { "stream": { "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "startTime": "2020-05-05T21:55:38Z", "state": "LIVE", "health": "HEALTHY", "streamId": "st-ABCDEfghij01234KLMN5678", "viewerCount": 1 } } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [GetStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-stream.html)in der *AWS CLI Befehlsreferenz*. ### `import-playback-key-pair` Das folgende Codebeispiel zeigt die Verwendung`import-playback-key-pair`. **AWS CLI** **So importieren Sie den öffentlichen Teil eines neuen Schlüsselpaars** Im folgenden Beispiel für `import-playback-key-pair` wird der angegebene öffentliche Schlüssel (als Zeichenfolge im PEM-Format angegeben) importiert und der ARN und der Fingerabdruck des neuen Schlüsselpaars werden zurückgegeben. ``` aws ivs import-playback-key-pair \ --name "my-playback-key" \ --public-key-material "G1lbnQxOTA3BgNVBAMMMFdoeSBhcmUgeW91IGRl..." ``` Ausgabe: ``` { "keyPair": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh", "name": "my-playback-key", "fingerprint": "0a:1b:2c:ab:cd:ef:34:56:70:b1:b2:71:01:2a:a3:72", "tags": {} } } ``` Weitere Informationen finden Sie unter [Einrichten privater Kanäle](https://docs.aws.amazon.com/ivs/latest/userguide//private-channels.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ImportPlaybackKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/import-playback-key-pair.html)in der *AWS CLI Befehlsreferenz*. ### `list-channels` Das folgende Codebeispiel zeigt die Verwendung`list-channels`. **AWS CLI** **Beispiel 1: So rufen Sie zusammenfassende Informationen zu allen Kanälen ab** Das folgende `list-channels` Beispiel listet alle Kanäle für Ihr AWS Konto auf. ``` aws ivs list-channels ``` Ausgabe: ``` { "channels": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "channel-1", "latencyMode": "LOW", "authorized": false, "insecureIngest": false, "preset": "", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "tags": {}, "type": "STANDARD" }, { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl", "name": "channel-2", "latencyMode": "LOW", "authorized": false, "preset": "", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "recordingConfigurationArn": "", "tags": {}, "type": "STANDARD" } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 2: Um zusammenfassende Informationen über alle Kanäle zu erhalten, gefiltert nach dem angegebenen RecordingConfiguration ARN** Das folgende `list-channels` Beispiel listet alle Kanäle für Ihr AWS Konto auf, die mit dem angegebenen RecordingConfiguration ARN verknüpft sind. ``` aws ivs list-channels \ --filter-by-recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh" ``` Ausgabe: ``` { "channels": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "channel-1", "latencyMode": "LOW", "authorized": false, "insecureIngest": false, "preset": "", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "tags": {}, "type": "STANDARD" } ] } ``` Weitere Informationen finden Sie unter [In Amazon S3 aufzeichnen](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/record-to-s3.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 3: Um zusammenfassende Informationen über alle Kanäle zu erhalten, gefiltert nach dem angegebenen PlaybackRestrictionPolicy ARN** Das folgende `list-channels` Beispiel listet alle Kanäle für Ihr AWS Konto auf, die mit dem angegebenen PlaybackRestrictionPolicy ARN verknüpft sind. ``` aws ivs list-channels \ --filter-by-playback-restriction-policy-arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ" ``` Ausgabe: ``` { "channels": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl", "name": "channel-2", "latencyMode": "LOW", "authorized": false, "preset": "", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "recordingConfigurationArn": "", "tags": {}, "type": "STANDARD" } ] } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [ListChannels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-channels.html)unter *AWS CLI Befehlsreferenz*. ### `list-playback-key-pairs` Das folgende Codebeispiel zeigt die Verwendung`list-playback-key-pairs`. **AWS CLI** **So rufen Sie zusammenfassende Informationen zu allen Wiedergabe-Schlüsselpaaren auf** Im folgenden Beispiel für `list-playback-key-pairs` werden Informationen zu allen Schlüsselpaaren zurückgegeben. ``` aws ivs list-playback-key-pairs ``` Ausgabe: ``` { "keyPairs": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh", "name": "test-key-0", "tags": {} }, { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/ijkl5678mnop", "name": "test-key-1", "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Einrichten privater Kanäle](https://docs.aws.amazon.com/ivs/latest/userguide//private-channels.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListPlaybackKeyPairs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-playback-key-pairs.html)in der *AWS CLI Befehlsreferenz*. ### `list-playback-restriction-policies` Das folgende Codebeispiel zeigt die Verwendung`list-playback-restriction-policies`. **AWS CLI** **So rufen Sie zusammenfassende Informationen zu allen Richtlinien für Wiedergabebeschränkungen** Das folgende `list-playback-restriction-policies` Beispiel listet alle Richtlinien für Wiedergabebeschränkungen für Ihr AWS Konto auf. ``` aws ivs list-playback-restriction-policies ``` Ausgabe: ``` { "playbackRestrictionPolicies": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "allowedCountries": [ "US", "MX" ], "allowedOrigins": [ "https://www.website1.com", "https://www.website2.com" ], "enableStrictOriginEnforcement": true, "name": "test-playback-restriction-policy", "tags": { "key1": "value1", "key2": "value2" } } ] } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [ListPlaybackRestrictionPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-playback-restriction-policies.html)in der *AWS CLI Befehlsreferenz*. ### `list-recording-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-recording-configurations`. **AWS CLI** **Um alle in diesem Konto erstellten RecordingConfiguration Ressourcen aufzulisten** Im folgenden `list-recording-configurations` Beispiel werden Informationen zu allen RecordingConfiguration Ressourcen in Ihrem Konto abgerufen. ``` aws ivs list-recording-configurations ``` Ausgabe: ``` { "recordingConfigurations": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "name": "test-recording-config-1", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket-1" } }, "state": "ACTIVE", "tags": {} }, { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/CD12abcdGHIJ", "name": "test-recording-config-2", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket-2" } }, "state": "ACTIVE", "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Aufzeichnen in Amazon S3](https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListRecordingConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-recording-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `list-stream-keys` Das folgende Codebeispiel zeigt die Verwendung`list-stream-keys`. **AWS CLI** **So rufen Sie eine Liste der Stream-Schlüssel ab** Im folgenden Beispiel für `list-stream-keys` wird ein Stream-Schlüssel für einen angegebenen ARN (Amazon Resource Name) erstellt. ``` aws ivs list-stream-keys \ --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh ``` Ausgabe: ``` { "streamKeys": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } ] } ``` FFor Weitere Informationen finden Sie unter [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im *IVS-Low-Latency-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListStreamKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-stream-keys.html)in der *AWS CLI Befehlsreferenz*. ### `list-stream-sessions` Das folgende Codebeispiel zeigt die Verwendung`list-stream-sessions`. **AWS CLI** **Um eine Zusammenfassung der aktuellen und vorherigen Streams für einen bestimmten Kanal in der aktuellen AWS Region zu erhalten** Im folgenden Beispiel für `list-stream-sessions` werden zusammenfassende Informationen für Streams für einen angegebenen Kanal-ARN (Amazon Resource Name) gemeldet. ``` aws ivs list-stream-sessions \ --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \ --max-results 25 \ --next-token "" ``` Ausgabe: ``` { "nextToken": "set-2", "streamSessions": [ { "startTime": 1641578182, "endTime": 1641579982, "hasErrorEvent": false, "streamId": "mystream" } ... ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [ListStreamSessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-stream-sessions.html)in der *AWS CLI Befehlsreferenz*. ### `list-streams` Das folgende Codebeispiel zeigt die Verwendung`list-streams`. **AWS CLI** **So rufen Sie eine Liste der Live-Streams und ihrer Status ab** Das folgende `list-streams` Beispiel listet alle Live-Streams für Ihr AWS Konto auf. ``` aws ivs list-streams ``` Ausgabe: ``` { "streams": [ { "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "state": "LIVE", "health": "HEALTHY", "streamId": "st-ABCDEfghij01234KLMN5678", "viewerCount": 1 } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-streams.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Um alle Tags für eine AWS Ressource aufzulisten (zum Beispiel: Channel, Stream Key)** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für einen angegebenen Ressourcen-ARN (Amazon Resource Name) aufgelistet. ``` aws ivs list-tags-for-resource \ --resource-arn arn:aws:ivs:us-west-2:12345689012:channel/abcdABCDefgh ``` Ausgabe: ``` { "tags": { "key1": "value1", "key2": "value2" } } ``` Weitere Informationen finden Sie unter [Tags](https://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html) in der *API-Referenz zu Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-metadata` Das folgende Codebeispiel zeigt die Verwendung`put-metadata`. **AWS CLI** **So fügen Sie Metadaten für einen angegebenen Kanal in den aktiven Stream ein** Im folgenden Beispiel für `put-metadata` werden die angegebenen Metadaten in den Stream für den angegebenen Kanal eingefügt. ``` aws ivs put-metadata \ --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \ --metadata '{"my": "metadata"}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [PutMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/put-metadata.html)in der *AWS CLI Befehlsreferenz*. ### `start-viewer-session-revocation` Das folgende Codebeispiel zeigt die Verwendung`start-viewer-session-revocation`. **AWS CLI** **So widerrufen Sie Betrachtersitzungen für mehrere Kanal-ARN- und Betrachter-ID-Paare** Im folgenden Beispiel für `start-viewer-session-revocation` wird der Prozess zum Widerrufen der Betrachtersitzung, die mit einer bestimmten Kanal-ARN und Betrachter-ID verknüpft ist, bis einschließlich der angegebenen Sitzungsversionsnummer gestartet. Wenn die Version nicht angegeben wird, ist sie standardmäßig 0. ``` aws ivs batch-start-viewer-session-revocation \ --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \ --viewer-id abcdefg \ --viewer-session-versions-less-than-or-equal-to 1234567890 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Einrichten privater Kanäle](https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html) im *Benutzerhandbuch zu Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [StartViewerSessionRevocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/start-viewer-session-revocation.html)in der *AWS CLI Befehlsreferenz*. ### `stop-stream` Das folgende Codebeispiel zeigt die Verwendung`stop-stream`. **AWS CLI** **So beenden Sie einen angegebenen Stream** Im folgenden Beispiel für `stop-stream` wird der Stream auf dem angegebenen Kanal gestoppt. ``` aws ivs stop-stream \ --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [StopStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/stop-stream.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Um Tags für eine AWS Ressource hinzuzufügen oder zu aktualisieren (zum Beispiel: Channel, Stream Key)** Im folgenden Beispiel für `tag-resource` werden Tags für einen angegebenen Ressourcen-ARN (Amazon Resource Name) hinzugefügt oder aktualisiert. ``` aws ivs tag-resource \ --resource-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \ --tags "tagkey1=tagvalue1, tagkey2=tagvalue2" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tags](https://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html) in der *API-Referenz zu Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Um Tags für eine AWS Ressource zu entfernen (zum Beispiel: Channel, Stream Key)** Im folgenden Beispiel für `untag-resource` werden die angegebenen Tags für eine angegebene Ressourcen-ARN (Amazon Resource Name) entfernt. ``` aws ivs untag-resource \ --resource-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \ --tag-keys "tagkey1, tagkey2" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tags](https://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html) in der *API-Referenz zu Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-channel` Das folgende Codebeispiel zeigt die Verwendung`update-channel`. **AWS CLI** **Beispiel 1: So rufen Sie die Konfigurationsinformationen eines Kanals ab** Im folgenden Beispiel für `update-channel` wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um den Kanalnamen zu ändern. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden. ``` aws ivs update-channel \ --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \ --name 'channel-1' \ --insecure-ingest ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "channel-1", "latencyMode": "LOW", "containerFormat": "TS", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": true, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } ``` Weitere Informationen finden Sie unter [Erstellen eines Kanals](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 2: So aktualisieren Sie die Konfiguration eines Kanals, um die Aufzeichnung zu aktivieren** Im folgenden Beispiel für `update-channel` wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um die Aufzeichnung zu aktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden. ``` aws ivs update-channel \ --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \ --no-insecure-ingest \ --recording-configuration-arn 'arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh' ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-recording", "latencyMode": "LOW", "containerFormat": "TS", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } } ``` Weitere Informationen finden Sie unter [In Amazon S3 aufzeichnen](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/record-to-s3.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 3: So aktualisieren Sie die Konfiguration eines Kanals, um die Aufzeichnung zu deaktivieren** Im folgenden Beispiel für `update-channel` wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um die Aufzeichnung zu deaktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden. ``` aws ivs update-channel \ --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \ --recording-configuration-arn '' ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-recording", "latencyMode": "LOW", "containerFormat": "TS", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2edfGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } } ``` Weitere Informationen finden Sie unter [In Amazon S3 aufzeichnen](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/record-to-s3.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 4: So aktualisieren Sie die Konfiguration eines Kanals, um die Wiedergabebeschränkung zu aktivieren** Im folgenden Beispiel für `update-channel` wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um eine Richtlinie für Wiedergabebeschränkungen anzuwenden. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden. ``` aws ivs update-channel \ --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \ --no-insecure-ingest \ --playback-restriction-policy-arn 'arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ' ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-playback-restriction-policy", "latencyMode": "LOW", "containerFormat": "TS", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "type": "STANDARD", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaCBDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 5: So aktualisieren Sie die Konfiguration eines Kanals, um die Wiedergabebeschränkung zu deaktivieren** Im folgenden Beispiel für `update-channel` wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um die Aufzeichnung zu deaktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden. ``` aws ivs update-channel \ --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \ --playback-restriction-policy-arn '' ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-playback-restriction-policy", "latencyMode": "LOW", "containerFormat": "TS", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDeFghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 6: So aktualisieren Sie die Konfiguration eines Kanals, um Multitrack zu aktivieren** Im folgenden Beispiel für `update-channel` wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um Multitrack zu aktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden. ``` aws ivs update-channel \ --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \ --container-format 'FRAGMENTED_MP4' \ --multitrack-input-configuration '{"enabled": true,"maximumResolution": "FULL_HD","policy": "ALLOW"}' ``` Ausgabe: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "containerFormat": "FRAGMENTED_MP4", "name": "test-channel-with-multitrack", "latencyMode": "LOW", "multitrackInputConfiguration": { "enabled": true, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaCBDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multitrack-video.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. **Beispiel 7: So aktualisieren Sie die Konfiguration eines Kanals, um die Wiedergabebeschränkung zu deaktivieren** Im folgenden Beispiel für `update-channel` wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um Multitrack zu aktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden. ``` aws ivs update-channel \ --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \ --container-format 'TS' \ --multitrack-input-configuration '{"enabled": false}' ``` Ausgabe: ``` { "channel": { ""arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "containerFormat": "TS", "name": "test-channel-with-multitrack", "latencyMode": "LOW", "multitrackInputConfiguration": { "enabled": false, "maximumResolution": "FULL_HD", "policy": "ALLOW" }, "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaCBDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multitrack-video.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [UpdateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/update-channel.html)in der *AWS CLI Befehlsreferenz*. ### `update-playback-restriction-policy` Das folgende Codebeispiel zeigt die Verwendung`update-playback-restriction-policy`. **AWS CLI** **So erstellen Sie eine Richtlinie für Wiedergabebeschränkungen** Im folgenden Beispiel für `update-playback-restriction-policy` wird die Wiedergabebeschränkungsrichtlinie mit dem angegebenen Richtlinien-ARN aktualisiert, um die strenge Durchsetzung der Herkunft zu deaktivieren. Dies wirkt sich nicht auf einen laufenden Stream des zugeordneten Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden. ``` aws ivs update-playback-restriction-policy \ --arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ" \ --no-enable-strict-origin-enforcement ``` Ausgabe: ``` { "playbackRestrictionPolicy": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "allowedCountries": [ "US", "MX" ], "allowedOrigins": [ "https://www.website1.com", "https://www.website2.com" ], "enableStrictOriginEnforcement": false, "name": "test-playback-restriction-policy", "tags": { "key1": "value1", "key2": "value2" } } } ``` Weitere Informationen finden Sie unter [Unerwünschte Inhalte und Betrachter](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) im Benutzerhandbuch für *IVS mit niedriger Latenz*. + Einzelheiten zur API finden Sie [UpdatePlaybackRestrictionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/update-playback-restriction-policy.html)in der *AWS CLI Befehlsreferenz*. # Amazon IVS Chat-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon IVS Chat Aktionen ausführen und gängige Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-chat-token` Das folgende Codebeispiel zeigt, wie Sie`create-chat-token`. **AWS CLI** **So erstellen Sie ein Chat-Token** Im folgenden `create-chat-token` Beispiel wird ein verschlüsseltes Chat-Token erstellt, das verwendet wird, um eine individuelle WebSocket Verbindung zu einem Raum herzustellen. Das Token ist für eine Minute gültig, und eine mit dem Token hergestellte Verbindung (Sitzung) ist für die angegebene Dauer gültig. ``` aws ivschat create-chat-token \ --roomIdentifier "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6", \ --userId" "11231234" \ --capabilities "SEND_MESSAGE", \ --sessionDurationInMinutes" 30 ``` Ausgabe: ``` { "token": "ACEGmnoq#1rstu2...BDFH3vxwy!4hlm!#5", "sessionExpirationTime": "2022-03-16T04:44:09+00:00" "state": "CREATING", "tokenExpirationTime": "2022-03-16T03:45:09+00:00" } ``` Weitere Informationen finden Sie unter [Schritt 3: Authentifizieren und Autorisieren von Chat-Clients](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [CreateChatToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/create-chat-token.html)unter *AWS CLI Befehlsreferenz*. ### `create-logging-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-logging-configuration`. **AWS CLI** **Um eine LoggingConfiguration Chat-Ressource zu erstellen** Im folgenden `create-logging-configuration` Beispiel wird eine LoggingConfiguration Ressource erstellt, die es Clients ermöglicht, gesendete Nachrichten zu speichern und aufzuzeichnen. ``` aws ivschat create-logging-configuration \ --destination-configuration s3={bucketName=demo-logging-bucket} \ --name "test-logging-config" \ --tags "key1=value1, key2=value2" ``` Ausgabe: ``` { "arn": "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ", "createTime": "2022-09-14T17:48:00.653000+00:00", "destinationConfiguration": { "s3": { "bucketName": "demo-logging-bucket" } }, "id": "ABcdef34ghIJ", "name": "test-logging-config", "state": "ACTIVE", "tags": { "key1" : "value1", "key2" : "value2" }, "updateTime": "2022-09-14T17:48:01.104000+00:00" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [CreateLoggingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/create-logging-configuration.html)unter *AWS CLI Befehlsreferenz*. ### `create-room` Das folgende Codebeispiel zeigt die Verwendung`create-room`. **AWS CLI** **Um einen Raum zu erstellen** Im folgenden Beispiel für `create-room` wird ein neuer Raum erstellt. ``` aws ivschat create-room \ --name "test-room-1" \ --logging-configuration-identifiers "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ" \ --maximum-message-length 256 \ --maximum-message-rate-per-second 5 ``` Ausgabe: ``` { "arn": "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6", "id": "g1H2I3j4k5L6", "createTime": "2022-03-16T04:44:09+00:00", "loggingConfigurationIdentifiers": ["arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ"], "maximumMessageLength": 256, "maximumMessageRatePerSecond": 5, "name": "test-room-1", "tags": {} "updateTime": "2022-03-16T07:22:09+00:00" } ``` Weitere Informationen finden Sie unter [Schritt 2: Erstellen eines Chatrooms](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [CreateRoom](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/create-room.html)in der *AWS CLI Befehlsreferenz*. ### `delete-logging-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-logging-configuration`. **AWS CLI** **Um eine LoggingConfiguration Chat-Ressource zu löschen** Im folgenden `delete-logging-configuration` Beispiel wird die LoggingConfiguration Ressource für den angegebenen ARN gelöscht. ``` aws ivschat delete-logging-configuration \ --identifier "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie unter [DeleteLoggingConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/delete-logging-configuration.html)*Befehlsreferenz.* ### `delete-message` Das folgende Codebeispiel zeigt die Verwendung`delete-message`. **AWS CLI** **So löschen Sie Nachrichten aus einem bestimmten Raum** Im folgenden Beispiel für `delete-message` wird ein Ereignis an den angegebenen Raum gesendet, wodurch die Clients angewiesen werden, die angegebene Nachricht zu löschen, d. h. sie aus der Ansicht zu entfernen und sie aus dem Chat-Verlauf des Clients zu löschen. ``` aws ivschat delete-message \ --roomIdentifier "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6" \ --id "ABC123def456" \ --reason "Message contains profanity" ``` Ausgabe: ``` { "id": "12345689012" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [DeleteMessage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/delete-message.html)in der *AWS CLI Befehlsreferenz*. ### `delete-room` Das folgende Codebeispiel zeigt die Verwendung`delete-room`. **AWS CLI** **Um einen Raum zu löschen** Im folgenden Beispiel für `delete-room` wird der angegebene Raum gelöscht. Verbundene Clients werden getrennt. Bei Erfolg wird HTTP 204 mit einem leeren Antworttext zurückgegeben. ``` aws ivschat delete-room \ --identifier "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [DeleteRoom](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/delete-room.html)in der *AWS CLI Befehlsreferenz*. ### `disconnect-user` Das folgende Codebeispiel zeigt die Verwendung`disconnect-user`. **AWS CLI** **So trennen Sie einen Benutzer von einem Raum** Im folgenden Beispiel für `disconnect-user` werden alle Verbindungen für den angegebenen Benutzer vom angegebenen Raum getrennt. Bei Erfolg wird HTTP 200 mit einem leeren Antworttext zurückgegeben. ``` aws ivschat disconnect-user \ --roomIdentifier "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6" \ --userId "ABC123def456" \ --reason "Violated terms of service" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [DisconnectUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/disconnect-user.html)in der *AWS CLI Befehlsreferenz*. ### `get-logging-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-logging-configuration`. **AWS CLI** **Um Informationen über eine LoggingConfiguration Ressource zu erhalten** Im folgenden `get-logging-configuration` Beispiel werden Informationen über die LoggingConfiguration Ressource für den angegebenen ARN abgerufen. ``` aws ivschat get-logging-configuration \ --identifier "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ" ``` Ausgabe: ``` { "arn": "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ", "createTime": "2022-09-14T17:48:00.653000+00:00", "destinationConfiguration": { "s3": { "bucketName": "demo-logging-bucket" } }, "id": "ABcdef34ghIJ", "name": "test-logging-config", "state": "ACTIVE", "tags": { "key1" : "value1", "key2" : "value2" }, "updateTime": "2022-09-14T17:48:01.104000+00:00" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [GetLoggingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/get-logging-configuration.html)unter *AWS CLI Befehlsreferenz*. ### `get-room` Das folgende Codebeispiel zeigt die Verwendung`get-room`. **AWS CLI** **So rufen Sie den angegebenen Raum ab** Im folgenden Beispiel für `get-room` werden Informationen zum angegebenen Raum abgerufen. ``` aws ivschat get-room \ --identifier "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6" ``` Ausgabe: ``` { "arn": "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6", "createTime": "2022-03-16T04:44:09+00:00", "id": "g1H2I3j4k5L6", "loggingConfigurationIdentifiers": ["arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ"], "maximumMessageLength": 256, "maximumMessageRatePerSecond": 5, "name": "test-room-1", "tags": {}, "updateTime": "2022-03-16T07:22:09+00:00" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [GetRoom](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/get-room.html)in der *AWS CLI Befehlsreferenz*. ### `list-logging-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-logging-configurations`. **AWS CLI** **Um zusammenfassende Informationen zu allen Protokollierungskonfigurationen für den Benutzer in der AWS Region zu erhalten, in der die API-Anfrage verarbeitet wird** Das folgende `list-logging-configurations` Beispiel listet Informationen zu allen LoggingConfiguration Ressourcen für den Benutzer in der AWS Region auf, in der die API-Anfrage verarbeitet wird. ``` aws ivschat list-logging-configurations \ --max-results 2 \ --next-token "" ``` Ausgabe: ``` { "nextToken": "set-2", "loggingConfigurations": [ { "arn": "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ", "createTime": "2022-09-14T17:48:00.653000+00:00", "destinationConfiguration": { "s3": { "bucketName": "demo-logging-bucket" } }, "id": "ABcdef34ghIJ", "name": "test-logging-config", "state": "ACTIVE", "tags": { "key1" : "value1", "key2" : "value2" }, "updateTime": "2022-09-14T17:48:01.104000+00:00" } ... ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListLoggingConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/list-logging-configurations.html)unter *AWS CLI Befehlsreferenz*. ### `list-rooms` Das folgende Codebeispiel zeigt die Verwendung`list-rooms`. **AWS CLI** **So rufen Sie zusammenfassende Informationen zu all Ihren Räumen in der aktuellen Region ab** Im folgenden `list-rooms` Beispiel werden zusammenfassende Informationen zu allen Räumen in der AWS Region abgerufen, in der die Anfrage bearbeitet wird. Die Ergebnisse sind in absteigender Reihenfolge von updateTime sortiert. ``` aws ivschat list-rooms \ --logging-configuration-identifier "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ" \ --max-results 10 \ --next-token "" ``` Ausgabe: ``` { "nextToken": "page3", "rooms": [ { "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6", "createTime": "2022-03-16T04:44:09+00:00", "id": "g1H2I3j4k5L6", "loggingConfigurationIdentifiers": ["arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ"], "name": "test-room-1", "tags": {}, "updateTime": "2022-03-16T07:22:09+00:00" } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListRooms](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/list-rooms.html)unter *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Um alle Tags für eine AWS Ressource aufzulisten (zum Beispiel: Raum)** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für einen angegebenen Ressourcen-ARN (Amazon Resource Name) aufgelistet. ``` aws ivschat list-tags-for-resource \ --resource-arn arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6 ``` Ausgabe: ``` { "tags": { "key1": "value1", "key2": "value2" } } ``` Weitere Informationen finden Sie unter [Tags](https://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html) in der *API-Referenz zu Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `send-event` Das folgende Codebeispiel zeigt die Verwendung`send-event`. **AWS CLI** **So senden Sie ein Ereignis an einen Raum** Im folgenden Beispiel für `send-event` wird das angegebene Ereignis an den angegebenen Raum gesendet. ``` aws ivschat send-event \ --roomIdentifier "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6" \ --eventName "SystemMessage" \ --attributes \ "msgType"="user-notification", \ "msgText"="This chat room will close in 15 minutes." ``` Ausgabe: ``` { "id": "12345689012" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [SendEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/send-event.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Um Tags für eine AWS Ressource hinzuzufügen oder zu aktualisieren (zum Beispiel: Raum)** Im folgenden Beispiel für `tag-resource` werden Tags für einen angegebenen Ressourcen-ARN (Amazon Resource Name) hinzugefügt oder aktualisiert. Bei Erfolg wird HTTP 200 mit einem leeren Antworttext zurückgegeben. ``` aws ivschat tag-resource \ --resource-arn arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6 \ --tags "tagkey1=tagkeyvalue1, tagkey2=tagkeyvalue2" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tags](https://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html) in der *API-Referenz zu Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Um Tags für eine AWS Ressource zu entfernen (zum Beispiel: Raum)** Im folgenden Beispiel für `untag-resource` werden die angegebenen Tags für eine angegebene Ressourcen-ARN (Amazon Resource Name) entfernt. Bei Erfolg wird HTTP 200 mit einem leeren Antworttext zurückgegeben. ``` aws ivschat untag-resource \ --resource-arn arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6 \ --tag-keys "tagkey1, tagkey2" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tags](https://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html) in der *API-Referenz zu Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-logging-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-logging-configuration`. **AWS CLI** **So aktualisieren Sie die Protokollierungskonfiguration eines Raums** Das folgende `update-logging-configuration` Beispiel aktualisiert eine LoggingConfiguration Ressource mit den angegebenen Daten. ``` aws ivschat update-logging-configuration \ --destination-configuration s3={bucketName=demo-logging-bucket} \ --identifier "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ" \ --name "test-logging-config" ``` Ausgabe: ``` { "arn": "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ", "createTime": "2022-09-14T17:48:00.653000+00:00", "destinationConfiguration": { "s3": { "bucketName": "demo-logging-bucket" } }, "id": "ABcdef34ghIJ", "name": "test-logging-config", "state": "ACTIVE", "tags": { "key1" : "value1", "key2" : "value2" }, "updateTime": "2022-09-14T17:48:01.104000+00:00" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [UpdateLoggingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/update-logging-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `update-room` Das folgende Codebeispiel zeigt die Verwendung`update-room`. **AWS CLI** **So aktualisieren Sie die Konfiguration eines Raums** Im folgenden Beispiel für `update-room` wird die Konfiguration des angegebenen Raums mit den angegebenen Daten aktualisiert. ``` aws ivschat update-room \ --identifier "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6" \ --logging-configuration-identifiers "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ" \ --name "chat-room-a" \ --maximum-message-length 256 \ --maximum-message-rate-per-second 5 ``` Ausgabe: ``` { "arn": "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6", "createTime": "2022-03-16T04:44:09+00:00", "id": "g1H2I3j4k5L6", "loggingConfigurationIdentifiers": ["arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ"], "maximumMessageLength": 256, "maximumMessageRatePerSecond": 5, "name": "chat-room-a", "tags": {}, "updateTime": "2022-03-16T07:22:09+00:00" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit Amazon IVS Chat](https://docs.aws.amazon.com/ivs/latest/userguide/getting-started-chat.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [UpdateRoom](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivschat/update-room.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Amazon IVS Real-Time Streaming mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Real-Time Streaming AWS Command Line Interface mit Amazon IVS Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-encoder-configuration` Das folgende Codebeispiel zeigt, wie Sie`create-encoder-configuration`. **AWS CLI** **So erstellen Sie eine Encoder-Konfiguration einer Komposition** Im folgenden Beispiel für `create-encoder-configuration` wird eine Encoder-Konfiguration für eine Komposition mit den angegebenen Eigenschaften erstellt. ``` aws ivs-realtime create-encoder-configuration \ --name test-ec --video bitrate=3500000,framerate=30.0,height=1080,width=1920 ``` Ausgabe: ``` { "encoderConfiguration": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef", "name": "test-ec", "tags": {}, "video": { "bitrate": 3500000, "framerate": 30, "height": 1080, "width": 1920 } } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [CreateEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-encoder-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `create-ingest-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-ingest-configuration`. **AWS CLI** **So erstellen Sie eine Erfassungskonfiguration** Im folgenden Beispiel für `create-ingest-configuration` wird eine Erfassungskonfiguration mithilfe des RTMPS-Protokolls erstellt. ``` aws ivs-realtime create-ingest-configuration \ --name ingest1 \ --ingest-protocol rtmps ``` Ausgabe: ``` { "ingestConfiguration": { "name": "ingest1", "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234", "ingestProtocol": "RTMPS", "streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34", "stageArn": "", "participantId": "xyZ654abC321", "state": "INACTIVE", "userId": "", "tags": {} } } ``` Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [CreateIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-ingest-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `create-participant-token` Das folgende Codebeispiel zeigt die Verwendung`create-participant-token`. **AWS CLI** **So erstellen Sie ein Stufen-Teilnehmer-Token** Im folgenden Beispiel für `create-participant-token` wird ein Teilnehmer-Token für die angegebene Stufe erstellt. ``` aws ivs-realtime create-participant-token \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --user-id bob ``` Ausgabe: ``` { "participantToken": { "expirationTime": "2023-03-07T09:47:43+00:00", "participantId": "ABCDEfghij01234KLMN6789", "token": "abcd1234defg5678" } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [CreateParticipantToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-participant-token.html)in der *AWS CLI Befehlsreferenz*. ### `create-stage` Das folgende Codebeispiel zeigt die Verwendung`create-stage`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Stufe** Im folgenden Beispiel für `create-stage` wird ein Token für Stufe und Stufenteilnehmer für einen angegebenen Benutzer erstellt. ``` aws ivs-realtime create-stage \ --name stage1 \ --participant-token-configurations userId=alice ``` Ausgabe: ``` { "participantTokens": [ { "participantId": "ABCDEfghij01234KLMN5678", "token": "a1b2c3d4567890ab", "userId": "alice" } ], "stage": { "activeSessionId": "st-a1b2c3d4e5f6g", "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "autoParticipantRecordingConfiguration": { "storageConfigurationArn": "", "mediaTypes": [ "AUDIO_VIDEO" ], "thumbnailConfiguration": { "targetIntervalSeconds": 60, "storage": [ "SEQUENTIAL" ], "recordingMode": "DISABLED" }, "recordingReconnectWindowSeconds": 0, "hlsConfiguration": { "targetSegmentDurationSeconds": 6 }, "recordParticipantReplicas": true }, "endpoints": { "events": "wss://global.events.live-video.net", "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/", "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/", "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net" }, "name": "stage1", "tags": {} } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. **Beispiel 2: Um eine Phase zu erstellen und die Aufzeichnung einzelner Teilnehmer zu konfigurieren** Im folgenden Beispiel für `create-stage` wird eine Stufe erstellt und die Aufzeichnung einzelner Teilnehmer konfiguriert. ``` aws ivs-realtime create-stage \ --name stage1 \ --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \ "hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' ``` Ausgabe: ``` { "stage": { "activeSessionId": "st-a1b2c3d4e5f6g", "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "autoParticipantRecordingConfiguration": { "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh" "mediaTypes": [ "AUDIO_VIDEO" ], "thumbnailConfiguration": { "targetIntervalSeconds": 60, "storage": [ "SEQUENTIAL" ], "recordingMode": "DISABLED" }, "recordingReconnectWindowSeconds": 100, "hlsConfiguration": { "targetSegmentDurationSeconds": 5 }, "recordParticipantReplicas": true }, "endpoints": { "events": "wss://global.events.live-video.net", "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/", "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/", "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net" }, "name": "stage1", "tags": {} } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. **Beispiel 3: Um eine Phase zu erstellen und die Aufzeichnung einzelner Teilnehmer mit aktivierter Miniaturansicht zu konfigurieren** Im folgenden Beispiel für `create-stage` wird eine Stufe erstellt und die Aufzeichnung einzelner Teilnehmer mit aktivierter Thumbnail-Aufzeichnung konfiguriert. ``` aws ivs-realtime create-stage \ --name stage1 \ --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", \ "thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}}' ``` Ausgabe: ``` { "stage": { "activeSessionId": "st-a1b2c3d4e5f6g", "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "autoParticipantRecordingConfiguration": { "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "mediaTypes": [ "AUDIO_VIDEO" ], "thumbnailConfiguration": { "targetIntervalSeconds": 60, "storage": [ "SEQUENTIAL" ], "recordingMode": "INTERVAL" }, "recordingReconnectWindowSeconds": 0, "hlsConfiguration": { "targetSegmentDurationSeconds": 6 }, "recordParticipantReplicas": true }, "endpoints": { "events": "wss://global.events.live-video.net", "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/", "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/", "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net" }, "name": "stage1", "tags": {} } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. + Einzelheiten zur API finden Sie [CreateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-stage.html)in der *AWS CLI Befehlsreferenz.* ### `create-storage-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-storage-configuration`. **AWS CLI** **So erstellen Sie eine Speicherkonfiguration für eine Komposition** Im folgenden Beispiel für `create-storage-configuration` wird eine Speicherkonfiguration für eine Komposition mit den angegebenen Eigenschaften erstellt. ``` aws ivs-realtime create-storage-configuration \ --name "test-sc" --s3 "bucketName=amzn-s3-demo-bucket" ``` Ausgabe: ``` { "storageConfiguration": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef", "name": "test-sc", "s3": { "bucketName": "amzn-s3-demo-bucket" }, "tags": {} } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [CreateStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-storage-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-encoder-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-encoder-configuration`. **AWS CLI** **So löschen Sie eine Encoder-Konfiguration für eine Komposition** Im folgenden Beispiel für `delete-encoder-configuration` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Encoder-Konfiguration für die Komposition gelöscht. ``` aws ivs-realtime delete-encoder-configuration \ --arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [DeleteEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-encoder-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-ingest-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-ingest-configuration`. **AWS CLI** **Beispiel 1: So löschen Sie eine inaktive Erfassungskonfiguration** Im folgenden Beispiel für `delete-ingest-configuration` wird die inaktive Erfassungskonfiguration für einen angegebenen ARN (Amazon Resource Name) einer Erfassungskonfiguration gelöscht. ``` aws ivs-realtime delete-ingest-configuration \ --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. **Beispiel 2: So erzwingen Sie das Löschen einer aktiven Erfassungskonfiguration** Im folgenden Beispiel für `delete-ingest-configuration` wird die Löschung der aktiven Erfassungskonfiguration für einen angegebenen ARN (Amazon Resource Name) einer Erfassungskonfiguration erzwungen. ``` aws ivs-realtime delete-ingest-configuration \ --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \ --force ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [DeleteIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-ingest-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-public-key` Das folgende Codebeispiel zeigt die Verwendung`delete-public-key`. **AWS CLI** **So löschen Sie einen öffentlichen Schlüssel** Im folgenden Beispiel für `delete-public-key` wird der angegebene öffentliche Schlüssel gelöscht. ``` aws ivs-realtime delete-public-key \ --arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verteilen von Teilnehmertoken](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*. + Einzelheiten zur API finden Sie [DeletePublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-public-key.html)in der *AWS CLI Befehlsreferenz*. ### `delete-stage` Das folgende Codebeispiel zeigt die Verwendung`delete-stage`. **AWS CLI** **So löschen Sie eine Stufe** Im folgenden Beispiel für `delete-stage` wird die angegebene Stufe gelöscht. ``` aws ivs-realtime delete-stage \ --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [DeleteStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-stage.html)in der *AWS CLI Befehlsreferenz*. ### `delete-storage-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-storage-configuration`. **AWS CLI** **So löschen Sie eine Speicherkonfiguration für eine Komposition** Im folgenden Beispiel für `delete-storage-configuration` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Speicherkonfiguration für die Komposition gelöscht. ``` aws ivs-realtime delete-storage-configuration \ --arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [DeleteStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-storage-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `disconnect-participant` Das folgende Codebeispiel zeigt die Verwendung`disconnect-participant`. **AWS CLI** **So trennen Sie einen Stufenteilnehmer** Im folgenden Beispiel für `disconnect-participant` wird der angegebene Teilnehmer von der angegebenen Stufe getrennt. ``` aws ivs-realtime disconnect-participant \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --participant-id ABCDEfghij01234KLMN5678 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [DisconnectParticipant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/disconnect-participant.html)in der *AWS CLI Befehlsreferenz*. ### `get-composition` Das folgende Codebeispiel zeigt die Verwendung`get-composition`. **AWS CLI** **Beispiel 1: So rufen Sie eine Komposition mit Standard-Layouteinstellungen ab** Im folgenden Beispiel für `get-composition` wird die Komposition für den angegebenen ARN (Amazon Resource Name) abgerufen. ``` aws ivs-realtime get-composition \ --arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh" ``` Ausgabe: ``` { "composition": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh", "destinations": [ { "configuration": { "channel": { "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" }, "name": "" }, "id": "AabBCcdDEefF", "startTime": "2023-10-16T23:26:00+00:00", "state": "ACTIVE" }, { "configuration": { "name": "", "s3": { "encoderConfigurationArns": [ "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" ], "recordingConfiguration": { "format": "HLS", "hlsConfiguration": { "targetSegmentDurationSeconds": 2 } }, "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", } }, "detail": { "s3": { "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite" } }, "id": "GHFabcgefABC", "startTime": "2023-10-16T23:26:00+00:00", "state": "STARTING" } ], "layout": { "grid": { "featuredParticipantAttribute": "", "gridGap": 2, "omitStoppedVideo": false, "participantOrderAttribute": "", "videoAspectRatio": "VIDEO", "videoFillMode": "" } }, "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd", "startTime": "2023-10-16T23:24:00+00:00", "state": "ACTIVE", "tags": {} } } ``` Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*. **Beispiel 2: So rufen Sie eine Komposition mit PiP-Layout ab** Im folgenden Beispiel für `get-composition` wird die Komposition für den angegebenen ARN (Amazon Resource Name) abgerufen, die das PiP-Layout verwendet. ``` aws ivs-realtime get-composition \ --arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs" ``` Ausgabe: ``` { "composition": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs", "destinations": [ { "configuration": { "channel": { "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" }, "name": "" }, "id": "AabBCcdDEefF", "startTime": "2023-10-16T23:26:00+00:00", "state": "ACTIVE" }, { "configuration": { "name": "", "s3": { "encoderConfigurationArns": [ "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" ], "recordingConfiguration": { "format": "HLS", "hlsConfiguration": { "targetSegmentDurationSeconds": 2 } }, "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE" } }, "detail": { "s3": { "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite" } }, "id": "GHFabcgefABC", "startTime": "2023-10-16T23:26:00+00:00", "state": "STARTING" } ], "layout": { "pip": { "featuredParticipantAttribute": "abcdefg", "gridGap": 0, "omitStoppedVideo": false, "participantOrderAttribute": "", "pipBehavior": "STATIC", "pipOffset": 0, "pipParticipantAttribute": "", "pipPosition": "BOTTOM_RIGHT", "videoFillMode": "COVER" } }, "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd", "startTime": "2023-10-16T23:24:00+00:00", "state": "ACTIVE", "tags": {} } } ``` Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*. **Beispiel 3: So rufen Sie eine Komposition mit aktivierter Thumbnail-Aufzeichnung ab** Im folgenden Beispiel für `get-composition` wird die Komposition für den angegebenen ARN (Amazon Resource Name) abgerufen, bei dem die Thumbnail-Erfassung über die Standardeinstellungen aktiviert ist. ``` aws ivs-realtime get-composition \ --arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh" ``` Ausgabe: ``` { "composition": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh", "destinations": [ { "configuration": { "channel": { "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" }, "name": "" }, "id": "AabBCcdDEefF", "startTime": "2023-10-16T23:26:00+00:00", "state": "ACTIVE" }, { "configuration": { "name": "", "s3": { "encoderConfigurationArns": [ "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" ], "recordingConfiguration": { "format": "HLS", "hlsConfiguration": { "targetSegmentDurationSeconds": 2 } }, "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", "thumbnailConfigurations": [ { "targetIntervalSeconds": 60, "storage": [ "SEQUENTIAL" ], } ] } }, "detail": { "s3": { "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite" } }, "id": "GHFabcgefABC", "startTime": "2023-10-16T23:26:00+00:00", "state": "STARTING" } ], "layout": { "grid": { "featuredParticipantAttribute": "" "gridGap": 2, "omitStoppedVideo": false, "participantOrderAttribute": "", "videoAspectRatio": "VIDEO", "videoFillMode": "" } }, "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd", "startTime": "2023-10-16T23:24:00+00:00", "state": "ACTIVE", "tags": {} } } ``` Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-composition.html)in der *AWS CLI Befehlsreferenz.* ### `get-encoder-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-encoder-configuration`. **AWS CLI** **So rufen Sie die Encoder-Konfiguration für eine Komposition ab** Im folgenden Beispiel für `get-encoder-configuration` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Encoder-Konfiguration für die Komposition abgerufen. ``` aws ivs-realtime get-encoder-configuration \ --arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh" ``` Ausgabe: ``` { "encoderConfiguration": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh", "name": "test-ec", "tags": {}, "video": { "bitrate": 3500000, "framerate": 30, "height": 1080, "width": 1920 } } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [GetEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-encoder-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-ingest-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-ingest-configuration`. **AWS CLI** **So rufen Sie Informationen zur Erfassungskonfiguration ab** Im folgenden Beispiel für `get-ingest-configuration` wird die Erfassungskonfiguration für einen angegebenen ARN (Amazon Resource Name) einer Erfassungskonfiguration abgerufen. ``` aws ivs-realtime get-ingest-configuration \ --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 ``` Ausgabe: ``` { "ingestConfiguration": { "name": "ingest1", "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234", "ingestProtocol": "RTMPS", "streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34", "stageArn": "", "participantId": "xyZ654abC321", "state": "INACTIVE", "userId": "", "tags": {} } } ``` Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [GetIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-ingest-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-participant` Das folgende Codebeispiel zeigt die Verwendung`get-participant`. **AWS CLI** **Beispiel 1: So rufen Sie einen Stufenteilnehmer ab** Im folgenden Beispiel für `get-participant` wird der Stufenteilnehmer für eine angegebene Teilnehmer-ID und Sitzungs-ID im angegebenen Stufen-ARN (Amazon Resource Name) abgerufen. ``` aws ivs-realtime get-participant \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --session-id st-a1b2c3d4e5f6g \ --participant-id abCDEf12GHIj ``` Ausgabe: ``` { "participant": { "browserName": "Google Chrome", "browserVersion": "116", "firstJoinTime": "2023-04-26T20:30:34+00:00", "ispName": "Comcast", "osName": "Microsoft Windows 10 Pro", "osVersion": "10.0.19044", "participantId": "abCDEf12GHIj", "published": true, "recordingS3BucketName": "bucket-name", "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890", "recordingState": "ACTIVE", "sdkVersion": "", "state": "CONNECTED", "userId": "" } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. **Beispiel 2: So rufen Sie einen Stufenteilnehmer ab, der auf eine andere Stufe repliziert wurde** Im folgenden Beispiel für `get-participant` wird der Stufenteilnehmer für eine angegebene Teilnehmer-ID und Sitzungs-ID im angegebenen Stufen-ARN (Amazon Resource Name) abgerufen, wenn der Teilnehmer auch auf eine andere Stufe repliziert wurde. ``` aws ivs-realtime get-participant \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --session-id st-a1b2c3d4e5f6g \ --participant-id abCDEf12GHIj ``` Ausgabe: ``` { "participant": { "browserName": "Google Chrome", "browserVersion": "116", "firstJoinTime": "2023-04-26T20:30:34+00:00", "ispName": "Comcast", "osName": "Microsoft Windows 10 Pro", "osVersion": "10.0.19044", "participantId": "abCDEf12GHIj", "published": true, "recordingS3BucketName": "bucket-name", "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890", "recordingState": "ACTIVE", "replicationState": "ACTIVE", "replicationType": "SOURCE", "sdkVersion": "", "state": "CONNECTED", "userId": "" } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. **Beispiel 3: So rufen Sie einen Stufenteilnehmer ab, der von einer anderen Stufe repliziert wurde** Im folgenden Beispiel für `get-participant` wird der Stufenteilnehmer für eine angegebene Teilnehmer-ID und Sitzungs-ID im angegebenen Stufen-ARN (Amazon Resource Name) abgerufen, wenn der Teilnehmer von einer anderen Stufe repliziert wurde. ``` aws ivs-realtime get-participant \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --session-id st-a1b2c3d4e5f6g \ --participant-id abCDEf12GHIj ``` Ausgabe: ``` { "participant": { "browserName": "Google Chrome", "browserVersion": "116", "firstJoinTime": "2023-04-26T20:30:34+00:00", "ispName": "Comcast", "osName": "Microsoft Windows 10 Pro", "osVersion": "10.0.19044", "participantId": "abCDEf12GHIj", "published": true, "recordingS3BucketName": "bucket-name", "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890", "recordingState": "ACTIVE", "replicationState": "ACTIVE", "replicationType": "REPLICA", "sdkVersion": "", "state": "CONNECTED", "userId": "" } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. + Einzelheiten zur API finden Sie [GetParticipant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-participant.html)in der *AWS CLI Befehlsreferenz*. ### `get-public-key` Das folgende Codebeispiel zeigt die Verwendung`get-public-key`. **AWS CLI** **So rufen Sie einen vorhandenen öffentlichen Schlüssel ab, der zum Signieren von Stufenteilnehmer-Token verwendet wird** Im folgenden Beispiel für `get-public-key` wird ein durch den bereitgestellten ARN angegebener öffentlicher Schlüssel zum Signieren von Stufenteilnehmer-Token abgerufen. ``` aws ivs-realtime get-public-key \ --arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2 ``` Ausgabe: ``` { "publicKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2", "name": "", "publicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEqVWUtqs6EktQMR1sCYmEzGvRwtaycI16\n9pmzcpiWu/uhNStGlteJ5odRfRwVkoQUMnSZXTCcbn9bBTTmiWo4mJcFOOAzsthH\n0UAb8NdD4tUE0At4a9hYP9IETEXAMPLE\n-----END PUBLIC KEY-----", "fingerprint": "12:a3:44:56:bc:7d:e8:9f:10:2g:34:hi:56:78:90:12", "tags": {} } } ``` Weitere Informationen finden Sie unter [Verteilen von Teilnehmertoken](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*. + Einzelheiten zur API finden Sie [GetPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-public-key.html)in der *AWS CLI Befehlsreferenz*. ### `get-stage-session` Das folgende Codebeispiel zeigt die Verwendung`get-stage-session`. **AWS CLI** **So rufen Sie eine Stufensitzung ab** Im folgenden Beispiel für `get-stage-session` wird die Stufensitzung für eine angegebene Sitzungs-ID des angegebenen Stufen-ARN (Amazon Resource Name) abgerufen. ``` aws ivs-realtime get-stage-session \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --session-id st-a1b2c3d4e5f6g ``` Ausgabe: ``` { "stageSession": { "endTime": "2023-04-26T20:36:29+00:00", "sessionId": "st-a1b2c3d4e5f6g", "startTime": "2023-04-26T20:30:29.602000+00:00" } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [GetStageSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-stage-session.html)in der *AWS CLI Befehlsreferenz*. ### `get-stage` Das folgende Codebeispiel zeigt die Verwendung`get-stage`. **AWS CLI** **So rufen Sie die Konfigurationsinformationen einer Stufe ab** Im folgenden Beispiel für `get-stage` wird die Stufenkonfiguration für einen angegebenen Stufen-ARN (Amazon Resource Name) abgerufen. ``` aws ivs-realtime get-stage \ --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh ``` Ausgabe: ``` { "stage": { "activeSessionId": "st-a1b2c3d4e5f6g", "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "autoParticipantRecordingConfiguration": { "storageConfigurationArn": "", "mediaTypes": [ "AUDIO_VIDEO" ], "thumbnailConfiguration": { "targetIntervalSeconds": 60, "storage": [ "SEQUENTIAL" ], "recordingMode": "DISABLED" }, "recordingReconnectWindowSeconds": 0, "hlsConfiguration": { "targetSegmentDurationSeconds": 6 }, "recordParticipantReplicas": true }, "endpoints": { "events": "wss://global.events.live-video.net", "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/", "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/", "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net" }, "name": "test", "tags": {} } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. + Einzelheiten zur API finden Sie [GetStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-stage.html)in der *AWS CLI Befehlsreferenz*. ### `get-storage-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-storage-configuration`. **AWS CLI** **So rufen Sie die Speicherkonfiguration für eine Komposition ab** Im folgenden Beispiel für `get-storage-configuration` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Speicherkonfiguration für die Komposition abgerufen. ``` aws ivs-realtime get-storage-configuration \ --name arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh" ``` Ausgabe: ``` { "storageConfiguration": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh", "name": "test-sc", "s3": { "bucketName": "amzn-s3-demo-bucket" }, "tags": {} } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [GetStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-storage-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `import-public-key` Das folgende Codebeispiel zeigt die Verwendung`import-public-key`. **AWS CLI** **So importieren Sie einen vorhandenen öffentlichen Schlüssel, der zum Signieren von Stufenteilnehmer-Token verwendet wird** Im folgenden Beispiel für `import-public-key` wird ein öffentlicher Schlüssel aus einer Materialdatei importiert, der zum Signieren von Stufenteilnehmer-Token verwendet werden soll. ``` aws ivs-realtime import-public-key \ --public-key-material="`cat public.pem`" ``` Ausgabe: ``` { "publicKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2", "name": "", "publicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEqVWUtqs6EktQMR1sCYmEzGvRwtaycI16\n9pmzcpiWu/uhNStGlteJ5odRfRwVkoQUMnSZXTCcbn9bBTTmiWo4mJcFOOAzsthH\n0UAb8NdD4tUE0At4a9hYP9IETEXAMPLE\n-----END PUBLIC KEY-----", "fingerprint": "12:a3:44:56:bc:7d:e8:9f:10:2g:34:hi:56:78:90:12", "tags": {} } } ``` Weitere Informationen finden Sie unter [Verteilen von Teilnehmertoken](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*. + Einzelheiten zur API finden Sie [ImportPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/import-public-key.html)in der *AWS CLI Befehlsreferenz*. ### `list-compositions` Das folgende Codebeispiel zeigt die Verwendung`list-compositions`. **AWS CLI** **So rufen Sie eine Liste von Kompositionen ab** Im Folgenden `list-compositions` werden alle Kompositionen für Ihr AWS Konto in der AWS Region aufgeführt, in der die API-Anfrage bearbeitet wird. ``` aws ivs-realtime list-compositions ``` Ausgabe: ``` { "compositions": [ { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh", "destinations": [ { "id": "AabBCcdDEefF", "startTime": "2023-10-16T23:25:23+00:00", "state": "ACTIVE" } ], "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd", "startTime": "2023-10-16T23:25:21+00:00", "state": "ACTIVE", "tags": {} }, { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/ABcdabCDefgh", "destinations": [ { "endTime": "2023-10-16T23:25:00.786512+00:00", "id": "aABbcCDdeEFf", "startTime": "2023-10-16T23:24:01+00:00", "state": "STOPPED" }, { "endTime": "2023-10-16T23:25:00.786512+00:00", "id": "deEFfaABbcCD", "startTime": "2023-10-16T23:24:01+00:00", "state": "STOPPED" } ], "endTime": "2023-10-16T23:25:00+00:00", "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/efghabcdABCD", "startTime": "2023-10-16T23:24:00+00:00", "state": "STOPPED", "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListCompositions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-compositions.html)in der *AWS CLI Befehlsreferenz*. ### `list-encoder-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-encoder-configurations`. **AWS CLI** **So listen Sie die Konfigurationen des Kompositions-Encoders auf** Im Folgenden `list-encoder-configurations` sind alle Composition Encoder-Konfigurationen für Ihr AWS Konto in der AWS Region aufgeführt, in der die API-Anfrage verarbeitet wird. ``` aws ivs-realtime list-encoder-configurations ``` Ausgabe: ``` { "encoderConfigurations": [ { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh", "name": "test-ec-1", "tags": {} }, { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABCefgEFGabc", "name": "test-ec-2", "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListEncoderConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-encoder-configurations.html)in der *AWS CLI Befehlsreferenz.* ### `list-ingest-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-ingest-configurations`. **AWS CLI** **So rufen Sie zusammenfassende Informationen zu allen Erfassungskonfigurationen ab** Das folgende `list-ingest-configurations` Beispiel listet alle Aufnahmekonfigurationen für Ihr AWS Konto in der AWS Region auf, in der die API-Anfrage verarbeitet wird. ``` aws ivs-realtime list-ingest-configurations ``` Ausgabe: ``` { "ingestConfigurations": [ { "name": "", "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/XYZuvwSt4567", "ingestProtocol": "RTMPS", "stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "participnatId": "abC789Xyz456", "state": "INACTIVE" "userId": "", } ] } ``` Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListIngestConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-ingest-configurations.html)in der *AWS CLI Befehlsreferenz.* ### `list-participant-events` Das folgende Codebeispiel zeigt die Verwendung`list-participant-events`. **AWS CLI** **Beispiel 1: So rufen Sie eine Liste der Ereignisse von Stufenteilnehmern ab** Im folgenden Beispiel für `list-participant-events` werden alle Teilnehmerereignisse für eine angegebene Teilnehmer-ID und Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet. ``` aws ivs-realtime list-participant-events \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --session-id st-a1b2c3d4e5f6g \ --participant-id abCDEf12GHIj ``` Ausgabe: ``` { "events": [ { "eventTime": "2023-04-26T20:36:28+00:00", "name": "LEFT", "participantId": "abCDEf12GHIj" }, { "eventTime": "2023-04-26T20:36:28+00:00", "name": "PUBLISH_STOPPED", "participantId": "abCDEf12GHIj" }, { "eventTime": "2023-04-26T20:30:34+00:00", "name": "JOINED", "participantId": "abCDEf12GHIj" }, { "eventTime": "2023-04-26T20:30:34+00:00", "name": "PUBLISH_STARTED", "participantId": "abCDEf12GHIj" } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. **Beispiel 2: So rufen Sie eine Liste der Ereignisse von Stufenteilnehmern ab, einschließlich Stopp und Start der Replikation von Teilnehmern** Im folgenden Beispiel für `list-participant-events` werden alle Teilnehmerereignisse für eine angegebene Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet, in denen ein Teilnehmer auf eine andere Stufe repliziert wird. ``` aws ivs-realtime list-participant-events \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --session-id st-a1b2c3d4e5f6g \ --participant-id abCDEf12GHIj ``` Ausgabe: ``` { "events": [ { "eventTime": "2025-04-26T20:36:28+00:00", "name": "LEFT", "participantId": "abCDEf12GHIj" }, { "eventTime": "2025-04-26T20:36:28+00:00", "name": "PUBLISH_STOPPED", "participantId": "abCDEf12GHIj" }, { "eventTime": "2025-04-26T20:30:34+00:00", "name": "JOINED", "participantId": "abCDEf12GHIj" }, { "eventTime": "2025-04-26T20:30:34+00:00", "name": "PUBLISH_STARTED", "participantId": "abCDEf12GHIj" }, { "name": "REPLICATION_STARTED", "participantId": "abCDEf12GHIj", "eventTime": "2025-04-26T20:30:34+00:00", "destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh", "destinationSessionId": "st-b1c2d3e4f5g6a" }, { "name": "REPLICATION_STOPPED", "participantId": "abCDEf12GHIj", "eventTime": "2025-04-26T20:32:34+00:00", "destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh", "destinationSessionId": "st-b1c2d3e4f5g6a" } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. + Einzelheiten zur API finden Sie [ListParticipantEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participant-events.html)in der *AWS CLI Befehlsreferenz*. ### `list-participant-replicas` Das folgende Codebeispiel zeigt die Verwendung`list-participant-replicas`. **AWS CLI** **So rufen Sie eine Liste der Replikate von Stufenteilnehmern ab** Im folgenden Beispiel für `list-participant-replicas` werden alle Teilnehmer der Stufe aufgelistet, die von dem angegebenen Quellstufen-ARN (Amazon Resource Name) auf eine andere Stufe repliziert wurden. ``` aws ivs-realtime list-participant-replicas \ --source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --participant-id abCDEf12GHIj ``` Ausgabe: ``` { "replicas": [ { "sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "participantId": "abCDEf12GHIj", "sourceSessionId": "st-a1b2c3d4e5f6g", "destinationStageArn": "arn:aws:ivs:us-west-2:012345678901:stage/ABCDabcdefgh", "destinationSessionId": "st-b1c2d3e4f5g6a", "replicationState": "ACTIVE" } ] } ``` Weitere Informationen finden Sie unter [IVS-Teilnehmerreplikation](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*. + Einzelheiten zur API finden Sie [ListParticipantReplicas](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participant-replicas.html)in der *AWS CLI Befehlsreferenz*. ### `list-participants` Das folgende Codebeispiel zeigt die Verwendung`list-participants`. **AWS CLI** **Beispiel 1: So rufen Sie eine Liste von Stufenteilnehmern ab** Im folgenden Beispiel für `list-participants` werden alle Teilnehmer für eine angegebene Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet. ``` aws ivs-realtime list-participants \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --session-id st-a1b2c3d4e5f6g ``` Ausgabe: ``` { "participants": [ { "firstJoinTime": "2023-04-26T20:30:34+00:00", "participantId": "abCDEf12GHIj", "published": true, "recordingState": "STOPPED", "state": "DISCONNECTED", "userId": "" } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. **Beispiel 2: So rufen Sie eine Liste von Stufenteilnehmern ab, wenn ein Teilnehmer auf eine andere Stufe repliziert wurde** Im folgenden Beispiel für `list-participants` werden alle Teilnehmer für eine angegebene Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet, wenn ein Teilnehmer auf eine andere Stufe repliziert wurde. ``` aws ivs-realtime list-participants \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --session-id st-a1b2c3d4e5f6g ``` Ausgabe: ``` { "participants": [ { "firstJoinTime": "2023-04-26T20:30:34+00:00", "participantId": "abCDEf12GHIj", "published": true, "recordingState": "STOPPED", "state": "DISCONNECTED", "userId": "", "replicationState": "ACTIVE", "replicationType": "SOURCE", "sourceStageArn": "", "sourceSessionId": "" } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. **Beispiel 3: So rufen Sie eine Liste von Stufenteilnehmern ab, wenn ein Teilnehmer aus einer anderen Stufe repliziert wurde** Im folgenden Beispiel für `list-participants` werden alle Teilnehmer für eine angegebene Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet, wenn ein Teilnehmer von einer anderen Stufe repliziert wurde. ``` aws ivs-realtime list-participants \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --session-id st-a1b2c3d4e5f6g ``` Ausgabe: ``` { "participants": [ { "firstJoinTime": "2023-04-26T20:30:34+00:00", "participantId": "abCDEf12GHIj", "published": true, "recordingState": "STOPPED", "state": "DISCONNECTED", "userId": "", "replicationState": "ACTIVE", "replicationType": "REPLICA", "sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "sourceSessionId": "st-a1b2c3d4e5f6g" } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. + Einzelheiten zur API finden Sie [ListParticipants](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participants.html)in der *AWS CLI Befehlsreferenz*. ### `list-public-keys` Das folgende Codebeispiel zeigt die Verwendung`list-public-keys`. **AWS CLI** **So listen Sie bestehende öffentliche Schlüssel auf, die zum Signieren von Stufenteilnehmer-Token verfügbar sind** Das folgende `list-public-keys` Beispiel listet alle öffentlichen Schlüssel auf, die in der AWS Region, in der die API-Anfrage verarbeitet wird, zum Signieren von Token für Phasenteilnehmer verfügbar sind. ``` aws ivs-realtime list-public-keys ``` Ausgabe: ``` { "publicKeys": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2", "name": "", "tags": {} }, { "arn": "arn:aws:ivs:us-west-2:123456789012:public-key/3bcdABCDefg4", "name": "", "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Verteilen von Teilnehmertoken](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*. + Einzelheiten zur API finden Sie [ListPublicKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-public-keys.html)in der *AWS CLI Befehlsreferenz.* ### `list-stage-sessions` Das folgende Codebeispiel zeigt die Verwendung`list-stage-sessions`. **AWS CLI** **So rufen Sie eine Liste der Stufensitzungen auf** Im folgenden Beispiel für `list-stage-sessions` werden alle Sitzungen für einen angegebenen Phasen-ARN (Amazon Resource Name) aufgelistet. ``` aws ivs-realtime list-stage-sessions \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh ``` Ausgabe: ``` { "stageSessions": [ { "endTime": "2023-04-26T20:36:29+00:00", "sessionId": "st-a1b2c3d4e5f6g", "startTime": "2023-04-26T20:30:29.602000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListStageSessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-stage-sessions.html)in der *AWS CLI Befehlsreferenz*. ### `list-stages` Das folgende Codebeispiel zeigt die Verwendung`list-stages`. **AWS CLI** **So rufen Sie zusammenfassende Informationen über alle Stufen ab** Das folgende `list-stages` Beispiel listet alle Phasen Ihres AWS Kontos in der AWS Region auf, in der die API-Anfrage verarbeitet wird. ``` aws ivs-realtime list-stages ``` Ausgabe: ``` { "stages": [ { "activeSessionId": "st-a1b2c3d4e5f6g", "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "name": "stage1", "tags": {} }, { "activeSessionId": "st-a123bcd456efg", "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcd1234ABCD", "name": "stage2", "tags": {} }, { "activeSessionId": "st-abcDEF1234ghi", "arn": "arn:aws:ivs:us-west-2:123456789012:stage/ABCD1234efgh", "name": "stage3", "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListStages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-stages.html)in der *AWS CLI Befehlsreferenz*. ### `list-storage-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-storage-configurations`. **AWS CLI** **So listen Sie die Konfigurationen des Kompositionsspeichers auf** Im Folgenden `list-storage-configurations` werden alle Konfigurationen des Kompositionsspeichers für Ihr AWS Konto in der AWS Region aufgeführt, in der die API-Anfrage verarbeitet wird. ``` aws ivs-realtime list-storage-configurations ``` Ausgabe: ``` { "storageConfigurations": [ { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh", "name": "test-sc-1", "s3": { "bucketName": "amzn-s3-demo-bucket-1" }, "tags": {} }, { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABCefgEFGabc", "name": "test-sc-2", "s3": { "bucketName": "amzn-s3-demo-bucket-2" }, "tags": {} } ] } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [ListStorageConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-storage-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `start-composition` Das folgende Codebeispiel zeigt die Verwendung`start-composition`. **AWS CLI** **Beispiel 1: So starten Sie eine Komposition mit Standard-Layouteinstellungen** Im folgenden Beispiel für `start-composition` wird eine Komposition für die angegebene Stufe gestartet, die an die angegebenen Speicherorte gestreamt wird. ``` aws ivs-realtime start-composition \ --stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \ --destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \ "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \ {"s3":{"encoderConfigurationArns":["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \ "recordingConfiguration": {"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}, \ "storageConfigurationArn":"arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"}}]' ``` Ausgabe: ``` { "composition": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh", "destinations": [ { "configuration": { "channel": { "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" }, "name": "" }, "id": "AabBCcdDEefF", "state": "STARTING" }, { "configuration": { "name": "", "s3": { "encoderConfigurationArns": [ "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" ], "recordingConfiguration": { "format": "HLS", "hlsConfiguration": { "targetSegmentDurationSeconds": 5 } }, "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE" } }, "detail": { "s3": { "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite" } }, "id": "GHFabcgefABC", "state": "STARTING" } ], "layout": { "grid": { "featuredParticipantAttribute": "" "gridGap": 2, "omitStoppedVideo": false, "participantOrderAttribute": "", "videoAspectRatio": "VIDEO", "videoFillMode": "" } }, "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd", "startTime": "2023-10-16T23:24:00+00:00", "state": "STARTING", "tags": {} } } ``` Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*. **Beispiel 2: So starten Sie eine Komposition mit PiP-Layout** Im folgenden Beispiel für `start-composition` wird eine Komposition für die angegebene Stufe gestartet, die mithilfe des PiP-Layouts an die angegebenen Speicherorte gestreamt wird. ``` aws ivs-realtime start-composition \ --stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \ --destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \ "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \ {"s3":{"encoderConfigurationArns":["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \ "storageConfigurationArn":"arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"}}]' \ --layout pip='{featuredParticipantAttribute="abcdefg"}' ``` Ausgabe: ``` { "composition": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs", "destinations": [ { "configuration": { "channel": { "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" }, "name": "" }, "id": "AabBCcdDEefF", "state": "STARTING" }, { "configuration": { "name": "", "s3": { "encoderConfigurationArns": [ "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" ], "recordingConfiguration": { "format": "HLS", "hlsConfiguration": { "targetSegmentDurationSeconds": 2 } }, "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE" } }, "detail": { "s3": { "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite" } }, "id": "GHFabcgefABC", "state": "STARTING" } ], "layout": { "pip": { "featuredParticipantAttribute": "abcdefg", "gridGap": 0, "omitStoppedVideo": false, "participantOrderAttribute": "", "pipBehavior": "STATIC", "pipOffset": 0, "pipParticipantAttribute": "", "pipPosition": "BOTTOM_RIGHT", "videoFillMode": "COVER" } }, "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd", "startTime": "2023-10-16T23:24:00+00:00", "state": "STARTING", "tags": {} } } ``` Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*. **Beispiel 3: So starten Sie eine Komposition mit aktivierter Thumbnail-Aufzeichnung** Im folgenden Beispiel für `start-composition` wird eine Komposition für die angegebene Stufe gestartet, die an die angegebenen Speicherorte mit aktivierter Thumbnail-Aufzeichnung gestreamt wird. ``` aws ivs-realtime start-composition \ --stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \ --destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \ "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \ {"s3": {"encoderConfigurationArns": ["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \ "storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", \ "thumbnailConfigurations": [{"storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}]}}]' ``` Ausgabe: ``` { "composition": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh", "destinations": [ { "configuration": { "channel": { "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" }, "name": "" }, "id": "AabBCcdDEefF", "state": "STARTING" }, { "configuration": { "name": "", "s3": { "encoderConfigurationArns": [ "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" ], "recordingConfiguration": { "format": "HLS", "hlsConfiguration": { "targetSegmentDurationSeconds": 2 } }, "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", "thumbnailConfigurations": [ { "targetIntervalSeconds": 60, "storage": [ "SEQUENTIAL" ] } ] } }, "detail": { "s3": { "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite" } }, "id": "GHFabcgefABC", "state": "STARTING" } ], "layout": { "grid": { "featuredParticipantAttribute": "" "gridGap": 2, "omitStoppedVideo": false, "participantOrderAttribute": "", "videoAspectRatio": "VIDEO", "videoFillMode": "" } }, "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd", "startTime": "2023-10-16T23:24:00+00:00", "state": "STARTING", "tags": {} } } ``` Weitere Informationen finden Sie unter [Composite Recording (Echtzeit-Streaming)](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*. **Beispiel 4: So starten Sie eine Komposition mit Rasterlayout und benutzerdefinierter Reihenfolge der Teilnehmer** Im folgenden `start-composition` Beispiel wird eine Komposition für die angegebene Phase gestartet, die mithilfe eines Rasterlayouts mit benutzerdefinierter Reihenfolge der Teilnehmer an die angegebenen Standorte gestreamt wird. ``` aws ivs-realtime start-composition \ --stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \ --destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \ "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \ {"s3": {"encoderConfigurationArns": ["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \ "storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", \ "thumbnailConfigurations": [{"storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}]}}]' \ --layout grid='{participantOrderAttribute="abcdefg"}' ``` Ausgabe: ``` { "composition": { "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh", "destinations": [ { "configuration": { "channel": { "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" }, "name": "" }, "id": "AabBCcdDEefF", "state": "STARTING" }, { "configuration": { "name": "", "s3": { "encoderConfigurationArns": [ "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef" ], "recordingConfiguration": { "format": "HLS", "hlsConfiguration": { "targetSegmentDurationSeconds": 2 } }, "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", "thumbnailConfigurations": [ { "targetIntervalSeconds": 60, "storage": [ "SEQUENTIAL" ] } ] } }, "detail": { "s3": { "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite" } }, "id": "GHFabcgefABC", "state": "STARTING" } ], "layout": { "grid": { "featuredParticipantAttribute": "" "gridGap": 2, "omitStoppedVideo": false, "participantOrderAttribute": "abcdefg", "videoAspectRatio": "VIDEO", "videoFillMode": "" } }, "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd", "startTime": "2023-10-16T23:24:00+00:00", "state": "STARTING", "tags": {} } } ``` Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/start-composition.html)in der *AWS CLI Befehlsreferenz.* ### `start-participant-replication` Das folgende Codebeispiel zeigt die Verwendung`start-participant-replication`. **AWS CLI** **So starten Sie die Replikation eines Teilnehmers von einer Stufe auf eine andere** Im folgenden Beispiel für `start-participant-replication` wird ein Teilnehmer von einer Quellstufe in eine Zielstufe repliziert, wobei jede Stufe durch ihren ARN (Amazon Resource Name) angegeben wird. ``` aws ivs-realtime start-participant-replication \ --source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \ --participant-id abCDEf12GHIj ``` Ausgabe: ``` { "accessControlAllowOrigin": "*", "accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \ Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \ x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options", "cacheControl": "no-store, no-cache", "contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;", "strictTransportSecurity": "max-age:47304000; includeSubDomains", "xContentTypeOptions": "nosniff", "xFrameOptions": "DENY" } ``` Weitere Informationen finden Sie unter [IVS-Teilnehmerreplikation](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*. + Einzelheiten zur API finden Sie [StartParticipantReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/start-participant-replication.html)in der *AWS CLI Befehlsreferenz*. ### `stop-composition` Das folgende Codebeispiel zeigt die Verwendung`stop-composition`. **AWS CLI** **So stoppen Sie eine Komposition** Im folgenden Beispiel für `stop-composition` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Komposition gestoppt. ``` aws ivs-realtime stop-composition \ --arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [StopComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/stop-composition.html)in der *AWS CLI Befehlsreferenz*. ### `stop-participant-replication` Das folgende Codebeispiel zeigt die Verwendung`stop-participant-replication`. **AWS CLI** **So stoppen Sie die Replikation eines Teilnehmers von einer Stufe auf eine andere** Im folgenden Beispiel für `stop-participant-replication` wird die Replikation eines Teilnehmers von einer Quellstufe in eine Zielstufe gestoppt, wobei jede Stufe durch ihren ARN (Amazon Resource Name) angegeben wird. ``` aws ivs-realtime stop-participant-replication \ --source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \ --participant-id abCDEf12GHIj ``` Ausgabe: ``` { "accessControlAllowOrigin": "*", "accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \ Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \ x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options", "cacheControl": "no-store, no-cache", "contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;", "strictTransportSecurity": "max-age:47304000; includeSubDomains", "xContentTypeOptions": "nosniff", "xFrameOptions": "DENY" } ``` Weitere Informationen finden Sie unter [IVS-Teilnehmerreplikation](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*. + Einzelheiten zur API finden Sie [StopParticipantReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/stop-participant-replication.html)in der *AWS CLI Befehlsreferenz*. ### `update-ingest-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-ingest-configuration`. **AWS CLI** **So aktualisieren Sie eine Erfassungskonfiguration** Im folgenden Beispiel für `update-inegst-configuration` wird eine Erfassungskonfiguration aktualisiert, um sie an eine Stufe anzuhängen. ``` aws ivs-realtime update-ingest-configuration \ --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh ``` Ausgabe: ``` { "ingestConfiguration": { "name": "ingest1", "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234", "ingestProtocol": "RTMPS", "streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34", "stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "participantId": "xyZ654abC321", "state": "INACTIVE", "userId": "", "tags": {} } } ``` Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*. + Einzelheiten zur API finden Sie [UpdateIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/update-ingest-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `update-stage` Das folgende Codebeispiel zeigt die Verwendung`update-stage`. **AWS CLI** **Beispiel 1: So aktualisieren Sie die Konfiguration einer Stufe** Im folgenden Beispiel für `update-stage` wird eine Stufe für einen angegebenen Stufen-ARN aktualisiert, um den Stufennamen zu aktualisieren und die Aufzeichnung einzelner Teilnehmer mit aktivierter Thumbnail-Aufzeichnung zu konfigurieren. ``` aws ivs-realtime update-stage \ --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \ "thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}} \ "hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' \ --name stage1a ``` Ausgabe: ``` { "stage": { "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "autoParticipantRecordingConfiguration": { "mediaTypes": [ "AUDIO_VIDEO" ], "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "thumbnailConfiguration": { "targetIntervalSeconds": 60, "storage": [ "SEQUENTIAL" ], "recordingMode": "INTERVAL" }, "recordingReconnectWindowSeconds": 100, "hlsConfiguration": { "targetSegmentDurationSeconds": 5 }, "recordParticipantReplicas": true }, "endpoints": { "events": "wss://global.events.live-video.net", "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/", "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/", "whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net" }, "name": "stage1a", "tags": {} } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. **Beispiel 2: So aktualisieren Sie die Konfiguration einer Stufe, einschließlich der Deaktivierung der Aufzeichnung von Teilnehmerreplikaten** Im folgenden Beispiel für `update-stage` wird eine Stufe für einen angegebenen Stufen-ARN aktualisiert, um den Stufennamen zu aktualisieren und die Aufzeichnung einzelner Teilnehmer mit aktivierter Thumbnail-Aufzeichnung und deaktivierter Aufzeichnung von Teilnehmerreplikaten zu konfigurieren. ``` aws ivs-realtime update-stage \ --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \ --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \ "thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}, "recordParticipantReplicas":false} \ "hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' \ --name stage1a ``` Ausgabe: ``` { "stage": { "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh", "autoParticipantRecordingConfiguration": { "mediaTypes": [ "AUDIO_VIDEO" ], "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "thumbnailConfiguration": { "targetIntervalSeconds": 60, "storage": [ "SEQUENTIAL" ], "recordingMode": "INTERVAL" }, "recordingReconnectWindowSeconds": 100, "hlsConfiguration": { "targetSegmentDurationSeconds": 5 }, "recordParticipantReplicas": false }, "endpoints": { "events": "wss://global.events.live-video.net", "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/", "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/", "whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net" }, "name": "stage1a", "tags": {} } } ``` Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*. + Einzelheiten zur API finden Sie [UpdateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/update-stage.html)in der *AWS CLI Befehlsreferenz*. # Amazon Kendra Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Kendra Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-data-source` Das folgende Codebeispiel zeigt, wie Sie`create-data-source`. **AWS CLI** **So erstellen Sie einen Datenquellen-Konnektor für Amazon Kendra** Mit dem folgenden `create-data-source` wird ein Datenquellen-Konnektor für Amazon Kendra erstellt und konfiguriert. Mit `describe-data-source` können Sie den Status eines Datenquellen-Konnektors anzeigen und alle Fehlermeldungen lesen, wenn der Status anzeigt, dass ein Datenquellen-Konnektor nicht vollständig erstellt werden konnte („FAILED“). ``` aws kendra create-data-source \ --name "example data source 1" \ --description "Example data source 1 for example index 1 contains the first set of example documents" \ --tags '{"Key": "test resources", "Value": "kendra"}, {"Key": "test resources", "Value": "aws"}' \ --role-arn "arn:aws:iam::my-account-id:role/KendraRoleForS3TemplateConfigDataSource" \ --index-id exampleindex1 \ --language-code "es" \ --schedule "0 0 18 ? * TUE,MON,WED,THU,FRI,SAT *" \ --configuration '{"TemplateConfiguration": {"Template": file://s3schemaconfig.json}}' \ --type "TEMPLATE" \ --custom-document-enrichment-configuration '{"PostExtractionHookConfiguration": {"LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://amzn-s3-demo-bucket/scanned-image-text-example-docs"}, "RoleArn": "arn:aws:iam:my-account-id:role/KendraRoleForCDE"}' \ --vpc-configuration '{"SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"]}' ``` Ausgabe: ``` { "Id": "exampledatasource1" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [CreateDataSource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-data-source.html)in der *AWS CLI Befehlsreferenz*. ### `create-index` Das folgende Codebeispiel zeigt die Verwendung`create-index`. **AWS CLI** **So erstellen Sie einen Amazon-Kendra-Index** Mit dem folgenden `create-index` wird ein Amazon-Kendra-Index konfiguriert. Mit `describe-index` können Sie den Status eines Indexes anzeigen und alle Fehlermeldungen lesen, wenn der Status anzeigt, dass ein Index nicht vollständig erstellt werden konnte („FAILED“). ``` aws kendra create-index \ --name "example index 1" \ --description "Example index 1 contains the first set of example documents" \ --tags '{"Key": "test resources", "Value": "kendra"}, {"Key": "test resources", "Value": "aws"}' \ --role-arn "arn:aws:iam::my-account-id:role/KendraRoleForExampleIndex" \ --edition "DEVELOPER_EDITION" \ --server-side-encryption-configuration '{"KmsKeyId": "my-kms-key-id"}' \ --user-context-policy "USER_TOKEN" \ --user-token-configurations '{"JsonTokenTypeConfiguration": {"GroupAttributeField": "groupNameField", "UserNameAttributeField": "userNameField"}}' ``` Ausgabe: ``` { "Id": index1 } ``` Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [CreateIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-index.html)in der *AWS CLI Befehlsreferenz*. ### `describe-data-source` Das folgende Codebeispiel zeigt die Verwendung`describe-data-source`. **AWS CLI** **So rufen Sie Informationen über einen Datenquellen-Konnektor für Amazon Kendra ab** Im Folgenden finden Sie `describe-data-source` Informationen zu einem Amazon Kendra Kendra-Datenquellen-Connector. Sie können die Konfiguration eines Datenquellen-Konnektors anzeigen und alle Fehlermeldungen lesen, wenn der Status anzeigt, dass ein Datenquellen-Konnektor nicht vollständig erstellt werden konnte („FAILED“). ``` aws kendra describe-data-source \ --id exampledatasource1 \ --index-id exampleindex1 ``` Ausgabe: ``` { "Configuration": { "TemplateConfiguration": { "Template": { "connectionConfiguration": { "repositoryEndpointMetadata": { "BucketName": "amzn-s3-demo-bucket" } }, "repositoryConfigurations": { "document":{ "fieldMappings": [ { "indexFieldName":"_document_title", "indexFieldType":"STRING", "dataSourceFieldName": "title" }, { "indexFieldName":"_last_updated_at", "indexFieldType":"DATE", "dataSourceFieldName": "modified_date" } ] } }, "additionalProperties": { "inclusionPatterns": [ "*.txt", "*.doc", "*.docx" ], "exclusionPatterns": [ "*.json" ], "inclusionPrefixes": [ "PublicExampleDocsFolder" ], "exclusionPrefixes": [ "PrivateDocsFolder/private" ], "aclConfigurationFilePath": "ExampleDocsFolder/AclConfig.json", "metadataFilesPrefix": "metadata" }, "syncMode": "FULL_CRAWL", "type" : "S3", "version": "1.0.0" } } }, "CreatedAt": 2024-02-25T13:30:10+00:00, "CustomDocumentEnrichmentConfiguration": { "PostExtractionHookConfiguration": { "LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://amzn-s3-demo-bucket/scanned-image-text-example-docs/function" }, "RoleArn": "arn:aws:iam:my-account-id:role/KendraRoleForCDE" } "Description": "Example data source 1 for example index 1 contains the first set of example documents", "Id": exampledatasource1, "IndexId": exampleindex1, "LanguageCode": "en", "Name": "example data source 1", "RoleArn": "arn:aws:iam::my-account-id:role/KendraRoleForS3TemplateConfigDataSource", "Schedule": "0 0 18 ? * TUE,MON,WED,THU,FRI,SAT *", "Status": "ACTIVE", "Type": "TEMPLATE", "UpdatedAt": 1709163615, "VpcConfiguration": { "SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"] } } ``` Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [DescribeDataSource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-data-source.html)in der *AWS CLI Befehlsreferenz.* ### `describe-index` Das folgende Codebeispiel zeigt die Verwendung`describe-index`. **AWS CLI** **So rufen Sie Informationen zu einem Amazon-Kendra-Index ab** Mit dem folgenden `describe-index`-Befehl werden Informationen zu einem Amazon-Kendra-Index abgerufen. Sie können die Konfiguration eines Indexes anzeigen und alle Fehlermeldungen lesen, wenn der Status anzeigt, dass ein Index nicht vollständig erstellt werden konnte („FAILED“). ``` aws kendra describe-index \ --id exampleindex1 ``` Ausgabe: ``` { "CapacityUnits": { "QueryCapacityUnits": 0, "StorageCapacityUnits": 0 }, "CreatedAt": 2024-02-25T12:30:10+00:00, "Description": "Example index 1 contains the first set of example documents", "DocumentMetadataConfigurations": [ { "Name": "_document_title", "Relevance": { "Importance": 8 }, "Search": { "Displayable": true, "Facetable": false, "Searchable": true, "Sortable": false }, "Type": "STRING_VALUE" }, { "Name": "_document_body", "Relevance": { "Importance": 5 }, "Search": { "Displayable": true, "Facetable": false, "Searchable": true, "Sortable": false }, "Type": "STRING_VALUE" }, { "Name": "_last_updated_at", "Relevance": { "Importance": 6, "Duration": "2628000s", "Freshness": true }, "Search": { "Displayable": true, "Facetable": false, "Searchable": true, "Sortable": true }, "Type": "DATE_VALUE" }, { "Name": "department_custom_field", "Relevance": { "Importance": 7, "ValueImportanceMap": { "Human Resources" : 4, "Marketing and Sales" : 2, "Research and innvoation" : 3, "Admin" : 1 } }, "Search": { "Displayable": true, "Facetable": true, "Searchable": true, "Sortable": true }, "Type": "STRING_VALUE" } ], "Edition": "DEVELOPER_EDITION", "Id": "index1", "IndexStatistics": { "FaqStatistics": { "IndexedQuestionAnswersCount": 10 }, "TextDocumentStatistics": { "IndexedTextBytes": 1073741824, "IndexedTextDocumentsCount": 1200 } }, "Name": "example index 1", "RoleArn": "arn:aws:iam::my-account-id:role/KendraRoleForExampleIndex", "ServerSideEncryptionConfiguration": { "KmsKeyId": "my-kms-key-id" }, "Status": "ACTIVE", "UpdatedAt": 1709163615, "UserContextPolicy": "USER_TOKEN", "UserTokenConfigurations": [ { "JsonTokenTypeConfiguration": { "GroupAttributeField": "groupNameField", "UserNameAttributeField": "userNameField" } } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [DescribeIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-index.html)in der *AWS CLI Befehlsreferenz*. ### `update-data-source` Das folgende Codebeispiel zeigt die Verwendung`update-data-source`. **AWS CLI** **So aktualisieren Sie einen Datenquellen-Konnektor für Amazon Kendra** Mit dem folgenden `update-data-source` wird die Konfiguration eines Datenquellen-Konnektors für Amazon Kendra aktualisiert. Wenn die Aktion erfolgreich ist, sendet der Dienst entweder keine Ausgabe, den HTTP-Statuscode 200 oder den AWS CLI-Rückgabecode 0 zurück. Mit `describe-data-source` können Sie die Konfiguration und den Status eines Datenquellen-Konnektors anzeigen. ``` aws kendra update-data-source \ --id exampledatasource1 \ --index-id exampleindex1 \ --name "new name for example data source 1" \ --description "new description for example data source 1" \ --role-arn arn:aws:iam::my-account-id:role/KendraNewRoleForExampleDataSource \ --configuration '{"TemplateConfiguration": {"Template": file://s3schemanewconfig.json}}' \ --custom-document-enrichment-configuration '{"PostExtractionHookConfiguration": {"LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://amzn-s3-demo-bucket/scanned-image-text-example-docs"}, "RoleArn": "arn:aws:iam:my-account-id:role/KendraNewRoleForCDE"}' \ --language-code "es" \ --schedule "0 0 18 ? * MON,WED,FRI *" \ --vpc-configuration '{"SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"]}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [UpdateDataSource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/update-data-source.html)in der *AWS CLI Befehlsreferenz*. ### `update-index` Das folgende Codebeispiel zeigt die Verwendung`update-index`. **AWS CLI** **So aktualisieren Sie einen Amazon-Kendra-Index** Mit dem folgenden `update-index` wird die Konfiguration eines Amazon-Kendra-Index aktualisiert. Wenn die Aktion erfolgreich ist, sendet der Dienst entweder keine Ausgabe, den HTTP-Statuscode 200 oder den AWS CLI-Rückgabecode 0 zurück. Mit `describe-index` können Sie die Konfiguration und den Status eines Indexes anzeigen. ``` aws kendra update-index \ --id enterpriseindex1 \ --name "new name for Enterprise Edition index 1" \ --description "new description for Enterprise Edition index 1" \ --role-arn arn:aws:iam::my-account-id:role/KendraNewRoleForEnterpriseIndex \ --capacity-units '{"QueryCapacityUnits": 2, "StorageCapacityUnits": 1}' \ --document-metadata-configuration-updates '{"Name": "_document_title", "Relevance": {"Importance": 6}}, {"Name": "_last_updated_at", "Relevance": {"Importance": 8}}' \ --user-context-policy "USER_TOKEN" \ --user-token-configurations '{"JsonTokenTypeConfiguration": {"GroupAttributeField": "groupNameField", "UserNameAttributeField": "userNameField"}}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [UpdateIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/update-index.html)in der *AWS CLI Befehlsreferenz*. # Kinesis-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Kinesis Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-tags-to-stream` Das folgende Codebeispiel zeigt, wie Sie`add-tags-to-stream`. **AWS CLI** **So fügen Sie einem Datenstrom Tags hinzu** Im folgenden Beispiel für `add-tags-to-stream` wird dem angegebenen Stream ein Tag mit dem Schlüssel `samplekey` und dem Wert `example` zugewiesen. ``` aws kinesis add-tags-to-stream \ --stream-name samplestream \ --tags samplekey=example ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Markieren Ihrer Streams](https://docs.aws.amazon.com/streams/latest/dev/tagging.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [AddTagsToStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/add-tags-to-stream.html)in der *AWS CLI Befehlsreferenz*. ### `create-stream` Das folgende Codebeispiel zeigt die Verwendung`create-stream`. **AWS CLI** **So erstellen Sie einen Datenstrom** Im folgenden Beispiel für `create-stream` wird ein Datenstrom namens samplestream mit 3 Shards erstellt. ``` aws kinesis create-stream \ --stream-name samplestream \ --shard-count 3 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erstellen eines Streams](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-create-stream.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [CreateStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/create-stream.html)in der *AWS CLI Befehlsreferenz*. ### `decrease-stream-retention-period` Das folgende Codebeispiel zeigt die Verwendung`decrease-stream-retention-period`. **AWS CLI** **So verkürzen Sie die Aufbewahrungsdauer von Datenströmen** Im folgenden Beispiel für `decrease-stream-retention-period` wird der Aufbewahrungszeitraum (der Zeitraum, in dem auf Datensätze zugegriffen werden kann, nachdem sie dem Stream hinzugefügt wurden) eines Stroms namens samplestream auf 48 Stunden verkürzt. ``` aws kinesis decrease-stream-retention-period \ --stream-name samplestream \ --retention-period-hours 48 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ändern der Datenaufbewahrungszeitraums](https://docs.aws.amazon.com/streams/latest/dev/kinesis-extended-retention.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [DecreaseStreamRetentionPeriod](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/decrease-stream-retention-period.html)in der *AWS CLI Befehlsreferenz*. ### `delete-stream` Das folgende Codebeispiel zeigt die Verwendung`delete-stream`. **AWS CLI** **So löschen Sie einen Datenstrom** Im folgenden Beispiel für `delete-stream` wird der angegebene Datenstrom gelöscht. ``` aws kinesis delete-stream \ --stream-name samplestream ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Streams](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-delete-stream.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [DeleteStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/delete-stream.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-stream-consumer` Das folgende Codebeispiel zeigt die Verwendung`deregister-stream-consumer`. **AWS CLI** **So heben Sie die Registrierung eines Datenstromkonsumenten auf** Im folgenden Beispiel für `deregister-stream-consumer` wird die Registrierung des angegebenen Konsumenten beim angegebenen Datenstrom aufgehoben. ``` aws kinesis deregister-stream-consumer \ --stream-arn arn:aws:kinesis:us-west-2:123456789012:stream/samplestream \ --consumer-name KinesisConsumerApplication ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Entwickeln von Konsumenten mit Enhanced Fan-Out über die API von Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-enhanced-consumers-api.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [DeregisterStreamConsumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/deregister-stream-consumer.html)in der *AWS CLI Befehlsreferenz*. ### `describe-limits` Das folgende Codebeispiel zeigt die Verwendung`describe-limits`. **AWS CLI** **So beschreiben Sie Shard-Limits** Im folgenden `describe-limits` Beispiel werden die Shard-Limits und die Nutzung für das aktuelle AWS Konto angezeigt. ``` aws kinesis describe-limits ``` Ausgabe: ``` { "ShardLimit": 500, "OpenShardCount": 29 } ``` Weitere Informationen finden Sie unter [Resharding eines Streams](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [DescribeLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-limits.html)in der *AWS CLI Befehlsreferenz.* ### `describe-stream-consumer` Das folgende Codebeispiel zeigt die Verwendung`describe-stream-consumer`. **AWS CLI** **So beschreiben Sie einen Datenstromkonsumenten** Im folgenden Beispiel für `describe-stream-consumer` wird die Beschreibung des angegebenen Konsumenten zurückgegeben, der für den angegebenen Datenstrom registriert ist. ``` aws kinesis describe-stream-consumer \ --stream-arn arn:aws:kinesis:us-west-2:012345678912:stream/samplestream \ --consumer-name KinesisConsumerApplication ``` Ausgabe: ``` { "ConsumerDescription": { "ConsumerName": "KinesisConsumerApplication", "ConsumerARN": "arn:aws:kinesis:us-west-2:123456789012:stream/samplestream/consumer/KinesisConsumerApplication:1572383852", "ConsumerStatus": "ACTIVE", "ConsumerCreationTimestamp": 1572383852.0, "StreamARN": "arn:aws:kinesis:us-west-2:123456789012:stream/samplestream" } } ``` Weitere Informationen finden Sie unter [Lesen von Daten aus Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [DescribeStreamConsumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-stream-consumer.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stream-summary` Das folgende Codebeispiel zeigt die Verwendung`describe-stream-summary`. **AWS CLI** **So beschreiben Sie eine Zusammenfassung des Datenstroms** Im folgenden Beispiel für `describe-stream-summary` wird eine zusammenfassende Beschreibung (ohne Shard-Liste) des angegebenen Datenstroms bereitgestellt. ``` aws kinesis describe-stream-summary \ --stream-name samplestream ``` Ausgabe: ``` { "StreamDescriptionSummary": { "StreamName": "samplestream", "StreamARN": "arn:aws:kinesis:us-west-2:123456789012:stream/samplestream", "StreamStatus": "ACTIVE", "RetentionPeriodHours": 48, "StreamCreationTimestamp": 1572297168.0, "EnhancedMonitoring": [ { "ShardLevelMetrics": [] } ], "EncryptionType": "NONE", "OpenShardCount": 3, "ConsumerCount": 0 } } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [DescribeStreamSummary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-stream-summary.html)in der *AWS CLI Befehlsreferenz*. ### `describe-stream` Das folgende Codebeispiel zeigt die Verwendung`describe-stream`. **AWS CLI** **So beschreiben Sie einen Datenstrom** Im folgenden Beispiel für `describe-stream` werden Details zum angegebenen Datenstrom abgerufen. ``` aws kinesis describe-stream \ --stream-name samplestream ``` Ausgabe: ``` { "StreamDescription": { "Shards": [ { "ShardId": "shardId-000000000000", "HashKeyRange": { "StartingHashKey": "0", "EndingHashKey": "113427455640312821154458202477256070484" }, "SequenceNumberRange": { "StartingSequenceNumber": "49600871682957036442365024926191073437251060580128653314" } }, { "ShardId": "shardId-000000000001", "HashKeyRange": { "StartingHashKey": "113427455640312821154458202477256070485", "EndingHashKey": "226854911280625642308916404954512140969" }, "SequenceNumberRange": { "StartingSequenceNumber": "49600871682979337187563555549332609155523708941634633746" } }, { "ShardId": "shardId-000000000002", "HashKeyRange": { "StartingHashKey": "226854911280625642308916404954512140970", "EndingHashKey": "340282366920938463463374607431768211455" }, "SequenceNumberRange": { "StartingSequenceNumber": "49600871683001637932762086172474144873796357303140614178" } } ], "StreamARN": "arn:aws:kinesis:us-west-2:123456789012:stream/samplestream", "StreamName": "samplestream", "StreamStatus": "ACTIVE", "RetentionPeriodHours": 24, "EnhancedMonitoring": [ { "ShardLevelMetrics": [] } ], "EncryptionType": "NONE", "KeyId": null, "StreamCreationTimestamp": 1572297168.0 } } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [DescribeStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/describe-stream.html)in der *AWS CLI Befehlsreferenz*. ### `disable-enhanced-monitoring` Das folgende Codebeispiel zeigt die Verwendung`disable-enhanced-monitoring`. **AWS CLI** **So deaktivieren Sie die erweiterte Überwachung für Metriken auf Shard-Ebene** Im folgenden Beispiel für `disable-enhanced-monitoring` wird die erweiterte Überwachung für Kinesis-Datenströme für Metriken auf Shard-Ebene deaktiviert. ``` aws kinesis disable-enhanced-monitoring \ --stream-name samplestream --shard-level-metrics ALL ``` Ausgabe: ``` { "StreamName": "samplestream", "CurrentShardLevelMetrics": [ "IncomingBytes", "OutgoingRecords", "IteratorAgeMilliseconds", "IncomingRecords", "ReadProvisionedThroughputExceeded", "WriteProvisionedThroughputExceeded", "OutgoingBytes" ], "DesiredShardLevelMetrics": [] } ``` Weitere Informationen finden Sie unter [Überwachen von Streams in Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/monitoring.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [DisableEnhancedMonitoring](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/disable-enhanced-monitoring.html)in der *AWS CLI Befehlsreferenz*. ### `enable-enhanced-monitoring` Das folgende Codebeispiel zeigt die Verwendung`enable-enhanced-monitoring`. **AWS CLI** **So aktivieren Sie die erweiterte Überwachung für Metriken auf Shard-Ebene** Im folgenden Beispiel für `enable-enhanced-monitoring` wird die erweiterte Überwachung für Kinesis-Datenströme für Metriken auf Shard-Ebene aktiviert. ``` aws kinesis enable-enhanced-monitoring \ --stream-name samplestream \ --shard-level-metrics ALL ``` Ausgabe: ``` { "StreamName": "samplestream", "CurrentShardLevelMetrics": [], "DesiredShardLevelMetrics": [ "IncomingBytes", "OutgoingRecords", "IteratorAgeMilliseconds", "IncomingRecords", "ReadProvisionedThroughputExceeded", "WriteProvisionedThroughputExceeded", "OutgoingBytes" ] } ``` Weitere Informationen finden Sie unter [Überwachen von Streams in Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/monitoring.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [EnableEnhancedMonitoring](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/enable-enhanced-monitoring.html)in der *AWS CLI Befehlsreferenz*. ### `get-records` Das folgende Codebeispiel zeigt die Verwendung`get-records`. **AWS CLI** **So rufen Sie Datensätze aus einem Shard ab** Im folgenden Beispiel für `get-records` werden Datensätze aus dem Shard eines Kinesis-Datenstroms über den angegebenen Shard-Iterator abgerufen. ``` aws kinesis get-records \ --shard-iterator AAAAAAAAAAF7/0mWD7IuHj1yGv/TKuNgx2ukD5xipCY4cy4gU96orWwZwcSXh3K9tAmGYeOZyLZrvzzeOFVf9iN99hUPw/w/b0YWYeehfNvnf1DYt5XpDJghLKr3DzgznkTmMymDP3R+3wRKeuEw6/kdxY2yKJH0veaiekaVc4N2VwK/GvaGP2Hh9Fg7N++q0Adg6fIDQPt4p8RpavDbk+A4sL9SWGE1 ``` Ausgabe: ``` { "Records": [], "MillisBehindLatest": 80742000 } ``` Weitere Informationen finden Sie unter [Developing Consumer Using the Kinesis Data Streams API with the AWS SDK for Java](https://docs.aws.amazon.com/streams/latest/dev/developing-consumers-with-sdk.html) im *Amazon Kinesis Data Streams Developer Guide*. + Einzelheiten zur API finden Sie [GetRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/get-records.html)in der *AWS CLI Befehlsreferenz*. ### `get-shard-iterator` Das folgende Codebeispiel zeigt die Verwendung`get-shard-iterator`. **AWS CLI** **So rufen Sie einen Shard-Iterator ab** Im folgenden Beispiel für `get-shard-iterator` wird der Shard-Iteratortyp `AT_SEQUENCE_NUMBER` verwendet und ein Shard-Iterator generiert, um mit dem Lesen von Datensätzen genau an der Position zu beginnen, die durch die angegebene Sequenznummer gekennzeichnet ist. ``` aws kinesis get-shard-iterator \ --stream-name samplestream \ --shard-id shardId-000000000001 \ --shard-iterator-type LATEST ``` Ausgabe: ``` { "ShardIterator": "AAAAAAAAAAFEvJjIYI+3jw/4aqgH9FifJ+n48XWTh/IFIsbILP6o5eDueD39NXNBfpZ10WL5K6ADXk8w+5H+Qhd9cFA9k268CPXCz/kebq1TGYI7Vy+lUkA9BuN3xvATxMBGxRY3zYK05gqgvaIRn94O8SqeEqwhigwZxNWxID3Ej7YYYcxQi8Q/fIrCjGAy/n2r5Z9G864YpWDfN9upNNQAR/iiOWKs" } ``` Weitere Informationen finden Sie unter [Developing Consumer Using the Kinesis Data Streams API with the AWS SDK for Java](https://docs.aws.amazon.com/streams/latest/dev/developing-consumers-with-sdk.html) im *Amazon Kinesis Data Streams Developer Guide*. + Einzelheiten zur API finden Sie [GetShardIterator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/get-shard-iterator.html)in der *AWS CLI Befehlsreferenz*. ### `increase-stream-retention-period` Das folgende Codebeispiel zeigt die Verwendung`increase-stream-retention-period`. **AWS CLI** **So verlängern Sie die Aufbewahrungsdauer von Datenströmen** Im folgenden Beispiel für `increase-stream-retention-period` wird der Aufbewahrungszeitraum (der Zeitraum, in dem auf Datensätze zugegriffen werden kann, nachdem sie dem Stream hinzugefügt wurden) des angegebenen Streams auf 168 Stunden verlängert. ``` aws kinesis increase-stream-retention-period \ --stream-name samplestream \ --retention-period-hours 168 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ändern der Datenaufbewahrungszeitraums](https://docs.aws.amazon.com/streams/latest/dev/kinesis-extended-retention.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [IncreaseStreamRetentionPeriod](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/increase-stream-retention-period.html)in der *AWS CLI Befehlsreferenz*. ### `list-shards` Das folgende Codebeispiel zeigt die Verwendung`list-shards`. **AWS CLI** **So listen Sie Shards in einem Datenstrom auf** Im folgenden Beispiel für `list-shards` werden alle Shards im angegebenen Stream aufgelistet, beginnend mit dem Shard, dessen ID unmittelbar auf die angegebene `exclusive-start-shard-id` von `shardId-000000000000` folgt. ``` aws kinesis list-shards \ --stream-name samplestream \ --exclusive-start-shard-id shardId-000000000000 ``` Ausgabe: ``` { "Shards": [ { "ShardId": "shardId-000000000001", "HashKeyRange": { "StartingHashKey": "113427455640312821154458202477256070485", "EndingHashKey": "226854911280625642308916404954512140969" }, "SequenceNumberRange": { "StartingSequenceNumber": "49600871682979337187563555549332609155523708941634633746" } }, { "ShardId": "shardId-000000000002", "HashKeyRange": { "StartingHashKey": "226854911280625642308916404954512140970", "EndingHashKey": "340282366920938463463374607431768211455" }, "SequenceNumberRange": { "StartingSequenceNumber": "49600871683001637932762086172474144873796357303140614178" } } ] } ``` Weitere Informationen finden Sie unter [Auflisten von Shards](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-list-shards.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [ListShards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-shards.html)in der *AWS CLI Befehlsreferenz*. ### `list-streams` Das folgende Codebeispiel zeigt die Verwendung`list-streams`. **AWS CLI** **So listen Sie Datenströme auf** Im folgenden Beispiel für `list-streams` werden alle Parameter im aktuellen Konto und in der aktuellen Region aufgelistet. ``` aws kinesis list-streams ``` Ausgabe: ``` { "StreamNames": [ "samplestream", "samplestream1" ] } ``` Weitere Informationen finden Sie unter [Auflisten eines Streams](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-list-streams.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-streams.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-stream` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-stream`. **AWS CLI** **So listen Sie Tags für einen Datenstrom auf** Im folgenden Beispiel für `list-tags-for-stream` werden alle Tags aufgelistet, die dem angegebenen Datenstrom zugeordnet sind. ``` aws kinesis list-tags-for-stream \ --stream-name samplestream ``` Ausgabe: ``` { "Tags": [ { "Key": "samplekey", "Value": "example" } ], "HasMoreTags": false } ``` Weitere Informationen finden Sie unter [Markieren Ihrer Streams](https://docs.aws.amazon.com/streams/latest/dev/tagging.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [ListTagsForStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-stream.html)in der *AWS CLI Befehlsreferenz*. ### `merge-shards` Das folgende Codebeispiel zeigt die Verwendung`merge-shards`. **AWS CLI** **So führen Sie Shards zusammen** Das folgende `merge-shards` Beispiel führt zwei benachbarte Shards mit IDs of ShardID-000000000000 und ShardID-000000000001 im angegebenen Datenstrom zusammen und kombiniert sie zu einem einzigen Shard. ``` aws kinesis merge-shards \ --stream-name samplestream \ --shard-to-merge shardId-000000000000 \ --adjacent-shard-to-merge shardId-000000000001 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Zusammenführen zweier Shards](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding-merge.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten [MergeShards AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/merge-shards.html)*zur API* finden Sie unter Befehlsreferenz. ### `put-record` Das folgende Codebeispiel zeigt die Verwendung`put-record`. **AWS CLI** **So schreiben Sie einen Datensatz in einen Datenstrom** Im folgenden Beispiel für `put-record` wird ein einzelner Datensatz mithilfe des angegebenen Partitionsschlüssels in den angegebenen Datenstrom geschrieben. ``` aws kinesis put-record \ --stream-name samplestream \ --data sampledatarecord \ --partition-key samplepartitionkey ``` Ausgabe: ``` { "ShardId": "shardId-000000000009", "SequenceNumber": "49600902273357540915989931256901506243878407835297513618", "EncryptionType": "KMS" } ``` Weitere Informationen finden Sie unter [Entwickeln von Produzenten, die die Amazon Kinesis Data Streams-API mit dem AWS SDK for Java verwenden](https://docs.aws.amazon.com/streams/latest/dev/developing-producers-with-sdk.html) im *Amazon Kinesis Data Streams Developer Guide*. + Einzelheiten zur API finden Sie [PutRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/put-record.html)in der *AWS CLI Befehlsreferenz*. ### `put-records` Das folgende Codebeispiel zeigt die Verwendung`put-records`. **AWS CLI** **So schreiben Sie mehrere Datensätze in einen Datenstrom** Im folgenden Beispiel für `put-records` werden ein Datensatz mit dem angegebenen Partitionsschlüssel und ein anderer Datensatz mit einem anderen Partitionsschlüssel in einen einzelnen Aufruf geschrieben. ``` aws kinesis put-records \ --stream-name samplestream \ --records Data=blob1,PartitionKey=partitionkey1 Data=blob2,PartitionKey=partitionkey2 ``` Ausgabe: ``` { "FailedRecordCount": 0, "Records": [ { "SequenceNumber": "49600883331171471519674795588238531498465399900093808706", "ShardId": "shardId-000000000004" }, { "SequenceNumber": "49600902273357540915989931256902715169698037101720764562", "ShardId": "shardId-000000000009" } ], "EncryptionType": "KMS" } ``` Weitere Informationen finden Sie unter [Entwickeln von Produzenten, die die Amazon Kinesis Data Streams-API mit dem AWS SDK for Java verwenden](https://docs.aws.amazon.com/streams/latest/dev/developing-producers-with-sdk.html) im *Amazon Kinesis Data Streams Developer Guide*. + Einzelheiten zur API finden Sie [PutRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/put-records.html)in der *AWS CLI Befehlsreferenz*. ### `register-stream-consumer` Das folgende Codebeispiel zeigt die Verwendung`register-stream-consumer`. **AWS CLI** **So registrieren Sie einen Datenstromkonsumenten** Im folgenden Beispiel für `register-stream-consumer` wird ein Konsument namens `KinesisConsumerApplication` beim angegebenen Datenstrom registriert. ``` aws kinesis register-stream-consumer \ --stream-arn arn:aws:kinesis:us-west-2:012345678912:stream/samplestream \ --consumer-name KinesisConsumerApplication ``` Ausgabe: ``` { "Consumer": { "ConsumerName": "KinesisConsumerApplication", "ConsumerARN": "arn:aws:kinesis:us-west-2: 123456789012:stream/samplestream/consumer/KinesisConsumerApplication:1572383852", "ConsumerStatus": "CREATING", "ConsumerCreationTimestamp": 1572383852.0 } } ``` Weitere Informationen finden Sie unter [Entwickeln von Konsumenten mit Enhanced Fan-Out über die API von Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-enhanced-consumers-api.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [RegisterStreamConsumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)in der *AWS CLI Befehlsreferenz*. ### `remove-tags-from-stream` Das folgende Codebeispiel zeigt die Verwendung`remove-tags-from-stream`. **AWS CLI** **So entfernen Sie Tags aus einem Datenstrom** Im folgenden Beispiel für `remove-tags-from-stream` wird das Tag mit dem angegebenen Schlüsselnamen aus der angegebenen Datenstrom entfernt. ``` aws kinesis remove-tags-from-stream \ --stream-name samplestream \ --tag-keys samplekey ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Markieren Ihrer Streams](https://docs.aws.amazon.com/streams/latest/dev/tagging.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [RemoveTagsFromStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/remove-tags-from-stream.html)in der *AWS CLI Befehlsreferenz*. ### `split-shard` Das folgende Codebeispiel zeigt die Verwendung`split-shard`. **AWS CLI** **So teilen Sie Shards auf** Im folgenden Beispiel für `split-shard` wird der angegebene Shard mit dem neuen Start-Hash-Schlüssel 10 in zwei neue Shards aufgeteilt. ``` aws kinesis split-shard \ --stream-name samplestream \ --shard-to-split shardId-000000000000 \ --new-starting-hash-key 10 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aufteilen von Shards](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding-split.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [SplitShard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/split-shard.html)in der *AWS CLI Befehlsreferenz*. ### `start-stream-encryption` Das folgende Codebeispiel zeigt die Verwendung`start-stream-encryption`. **AWS CLI** **So aktivieren Sie die Verschlüsselung von Datenströmen** Das folgende `start-stream-encryption` Beispiel aktiviert die serverseitige Verschlüsselung für den angegebenen Stream unter Verwendung des angegebenen AWS KMS-Schlüssels. ``` aws kinesis start-stream-encryption \ --encryption-type KMS \ --key-id arn:aws:kms:us-west-2:012345678912:key/a3c4a7cd-728b-45dd-b334-4d3eb496e452 \ --stream-name samplestream ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Datenschutz in Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie unter [StartStreamEncryption AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/start-stream-encryption.html)*Befehlsreferenz.* ### `stop-stream-encryption` Das folgende Codebeispiel zeigt die Verwendung`stop-stream-encryption`. **AWS CLI** **So deaktivieren Sie die Datenstromverschlüsselung** Im folgenden `stop-stream-encryption` Beispiel wird die serverseitige Verschlüsselung für den angegebenen Stream mithilfe des angegebenen AWS KMS-Schlüssels deaktiviert. ``` aws kinesis start-stream-encryption \ --encryption-type KMS \ --key-id arn:aws:kms:us-west-2:012345678912:key/a3c4a7cd-728b-45dd-b334-4d3eb496e452 \ --stream-name samplestream ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Datenschutz in Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie unter [StopStreamEncryption AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/stop-stream-encryption.html)*Befehlsreferenz*. ### `update-shard-count` Das folgende Codebeispiel zeigt die Verwendung`update-shard-count`. **AWS CLI** **So aktualisieren Sie die Shard-Anzahl in einem Datenstrom** Im folgenden Beispiel für `update-shard-count` wird die Shard-Anzahl des angegebenen Datenstroms auf 6 aktualisiert. In diesem Beispiel wird eine einheitliche Skalierung verwendet, wodurch Shards gleicher Größe erstellt werden. ``` aws kinesis update-shard-count \ --stream-name samplestream \ --scaling-type UNIFORM_SCALING \ --target-shard-count 6 ``` Ausgabe: ``` { "StreamName": "samplestream", "CurrentShardCount": 3, "TargetShardCount": 6 } ``` Weitere Informationen finden Sie unter [Resharding eines Streams](https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-resharding.html) im *Entwicklerhandbuch für Amazon Kinesis Data Streams*. + Einzelheiten zur API finden Sie [UpdateShardCount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/update-shard-count.html)in der *AWS CLI Befehlsreferenz*. # AWS KMS Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS KMS. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `cancel-key-deletion` Das folgende Codebeispiel zeigt, wie Sie`cancel-key-deletion`. **AWS CLI** **So brechen Sie die geplante Löschung eines kundenseitig verwalteten Schlüssels ab** Im folgenden Beispiel für `cancel-key-deletion` wird die geplante Löschung eines kundenseitig verwalteten KMS-Schlüssels abgebrochen. ``` aws kms cancel-key-deletion \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "KeyId": "arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab" } ``` Wenn der `cancel-key-deletion`-Befehl erfolgreich ist, wird das geplante Löschen abgebrochen. Der Schlüsselstatus des KMS-Schlüssels ist jedoch `Disabled`, sodass Sie den KMS-Schlüssel nicht in kryptografischen Vorgängen verwenden können. Verwenden Sie den `enable-key`-Befehl, um die Funktionalität wiederherzustellen. Weitere Informationen finden Sie unter [Planen und Abbrechen des Löschens von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/deleting-keys.html#deleting-keys-scheduling-key-deletion) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [CancelKeyDeletion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/cancel-key-deletion.html)in der *AWS CLI Befehlsreferenz*. ### `connect-custom-key-store` Das folgende Codebeispiel zeigt die Verwendung`connect-custom-key-store`. **AWS CLI** **So stellen Sie eine Verbindung zu einem benutzerdefinierten Schlüsselspeicher her** Im folgenden Beispiel für `connect-custom-key-store` wird die Verbindung zum angegebenen benutzerdefinierten Schlüsselspeicher erneut hergestellt. Sie können einen Befehl wie diesen zur erstmaligen Herstellung einer Verbindung zu einem benutzerdefinierten Schlüsselspeicher oder zur erneuten Verbindung eines getrennten Schlüsselspeicher verwenden. Sie können diesen Befehl verwenden, um einen AWS CloudHSM-Schlüsselspeicher oder einen externen Schlüsselspeicher zu verbinden. ``` aws kms connect-custom-key-store \ --custom-key-store-id cks-1234567890abcdef0 ``` Dieser Befehl gibt keine Ausgabe zurück. Verwenden Sie den Befehl `describe-custom-key-stores`, um zu überprüfen, ob der Befehl wirksam war. *Informationen zum Verbinden eines AWS CloudHSM-Schlüsselspeichers finden Sie unter [Verbinden und Trennen eines AWS CloudHSM-Schlüsselspeichers im Key Management Service](https://docs.aws.amazon.com/kms/latest/developerguide/disconnect-keystore.html) Developer Guide AWS .* *Informationen zum Herstellen einer Verbindung zu einem externen Schlüsselspeicher finden Sie unter [Herstellen und Trennen der Verbindung zu einem externen Schlüsselspeicher](https://docs.aws.amazon.com/kms/latest/developerguide/xks-connect-disconnect.html) im Entwicklerhandbuch für AWS Key Management Service*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [ConnectCustomKeyStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/connect-custom-key-store.html)AWS CLI * ### `create-alias` Das folgende Codebeispiel zeigt die Verwendung`create-alias`. **AWS CLI** **So erstellen Sie einen Alias für einen KMS-Schlüssel** Der folgende `create-alias`-Befehl erstellt einen Alias namens `example-alias` für den KMS-Schlüssel, der durch die Schlüssel-ID `1234abcd-12ab-34cd-56ef-1234567890ab` identifiziert wird. Aliasnamen müssen mit `alias/` beginnen. Verwenden Sie keine Aliasnamen, die mit `alias/aws` beginnen. Diese sind für die Verwendung durch reserviert AWS. ``` aws kms create-alias \ --alias-name alias/example-alias \ --target-key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Dieser Befehl gibt keine Ausgabe zurück. Verwenden Sie den Befehl `list-aliases`, um den neuen Alias anzuzeigen. Weitere Informationen finden Sie unter [Verwenden von Aliasnamen](https://docs.aws.amazon.com/kms/latest/developerguide/kms-alias.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [CreateAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/create-alias.html)in der *AWS CLI Befehlsreferenz*. ### `create-custom-key-store` Das folgende Codebeispiel zeigt die Verwendung`create-custom-key-store`. **AWS CLI** **Beispiel 1: So erstellen Sie einen AWS CloudHSM-Schlüsselspeicher** Im folgenden `create-custom-key-store` Beispiel wird mithilfe der erforderlichen Parameter ein AWS CloudHSM-Schlüsselspeicher erstellt, der von einem AWS CloudHSM-Cluster unterstützt wird. Sie können auch `custom-key-store-type``parameter with the default value: ``AWS_CLOUDHSM` hinzufügen. Um die Dateieingabe für den `trust-anchor-certificate` Befehl in der AWS CLI anzugeben, ist das `file://` Präfix erforderlich. ``` aws kms create-custom-key-store \ --custom-key-store-name ExampleCloudHSMKeyStore \ --cloud-hsm-cluster-id cluster-1a23b4cdefg \ --key-store-password kmsPswd \ --trust-anchor-certificate file://customerCA.crt ``` Ausgabe: ``` { "CustomKeyStoreId": cks-1234567890abcdef0 } ``` Weitere Informationen finden Sie unter [Erstellen eines AWS CloudHSM-Schlüsselspeichers im AWS Key](https://docs.aws.amazon.com/kms/latest/developerguide/create-keystore.html) *Management Service Developer Guide*. **Beispiel 2: So erstellen Sie einen externen Schlüsselspeicher mit der Konnektivität eines öffentlichen Endpunkts** Im folgenden `create-custom-key-store` Beispiel wird ein externer Schlüsselspeicher (XKS) erstellt, der mit AWS KMS über das Internet kommuniziert. In diesem Beispiel verwendet der `XksProxyUriPath` das optionale Präfix `example-prefix`. HINWEIS: Wenn Sie AWS CLI Version 1.0 verwenden, führen Sie den folgenden Befehl aus, bevor Sie einen Parameter mit einem HTTP- oder HTTPS-Wert angeben, z. B. den XksProxyUriEndpoint Parameter. ``` aws configure set cli_follow_urlparam false ``` Andernfalls ersetzt AWS CLI Version 1.0 den Parameterwert durch den Inhalt, der an dieser URI-Adresse gefunden wurde. ``` aws kms create-custom-key-store \ --custom-key-store-name ExamplePublicEndpointXKS \ --custom-key-store-type EXTERNAL_KEY_STORE \ --xks-proxy-connectivity PUBLIC_ENDPOINT \ --xks-proxy-uri-endpoint "https://myproxy.xks.example.com" \ --xks-proxy-uri-path "/example-prefix/kms/xks/v1" \ --xks-proxy-authentication-credential "AccessKeyId=ABCDE12345670EXAMPLE, RawSecretAccessKey=DXjSUawnel2fr6SKC7G25CNxTyWKE5PF9XX6H/u9pSo=" ``` Ausgabe: ``` { "CustomKeyStoreId": cks-2234567890abcdef0 } ``` Weitere Informationen finden Sie unter [Erstellen eines externen Schlüsselspeichers](https://docs.aws.amazon.com/kms/latest/developerguide/create-keystorecreate-xks-keystore.html) im *Entwicklerhandbuch für AWS Key Management Service*. **Beispiel 3: So erstellen Sie einen externen Schlüsselspeicher mit der Konnektivität eines VPC-Endpunkt-Service** Im folgenden `create-custom-key-store` Beispiel wird ein externer Schlüsselspeicher (XKS) erstellt, der einen Amazon VPC-Endpunktservice für die Kommunikation mit AWS KMS verwendet. HINWEIS: Wenn Sie AWS CLI Version 1.0 verwenden, führen Sie den folgenden Befehl aus, bevor Sie einen Parameter mit einem HTTP- oder HTTPS-Wert angeben, z. B. den XksProxyUriEndpoint Parameter. ``` aws configure set cli_follow_urlparam false ``` Andernfalls ersetzt AWS CLI Version 1.0 den Parameterwert durch den Inhalt, der an dieser URI-Adresse gefunden wurde. ``` aws kms create-custom-key-store \ --custom-key-store-name ExampleVPCEndpointXKS \ --custom-key-store-type EXTERNAL_KEY_STORE \ --xks-proxy-connectivity VPC_ENDPOINT_SERVICE \ --xks-proxy-uri-endpoint "https://myproxy-private.xks.example.com" \ --xks-proxy-uri-path "/kms/xks/v1" \ --xks-proxy-vpc-endpoint-service-name "com.amazonaws.vpce.us-east-1.vpce-svc-example1" \ --xks-proxy-authentication-credential "AccessKeyId=ABCDE12345670EXAMPLE, RawSecretAccessKey=DXjSUawnel2fr6SKC7G25CNxTyWKE5PF9XX6H/u9pSo=" ``` Ausgabe: ``` { "CustomKeyStoreId": cks-3234567890abcdef0 } ``` Weitere Informationen finden Sie unter [Erstellen eines externen Schlüsselspeichers](https://docs.aws.amazon.com/kms/latest/developerguide/create-keystorecreate-xks-keystore.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [CreateCustomKeyStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/create-custom-key-store.html)unter *AWS CLI Befehlsreferenz*. ### `create-grant` Das folgende Codebeispiel zeigt die Verwendung`create-grant`. **AWS CLI** **So erstellen Sie eine Erteilung** Im folgenden Beispiel für `create-grant` wird eine Erteilung erstellt, die dem Benutzer `exampleUser` die Verwendung des Befehls `decrypt` im Beispiel-KMS-Schlüssel `1234abcd-12ab-34cd-56ef-1234567890ab` ermöglicht. Der zurückziehende Prinzipal ist die `adminRole`-Rolle. Die Erteilung verwendet die Erteilungseinschränkung `EncryptionContextSubset`, um diese Berechtigung nur dann zuzulassen, wenn der Verschlüsselungskontext in der Anforderung `decrypt` das Verschlüsselungskontextpaar `"Department": "IT"` enthält. ``` aws kms create-grant \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --grantee-principal arn:aws:iam::123456789012:user/exampleUser \ --operations Decrypt \ --constraints EncryptionContextSubset={Department=IT} \ --retiring-principal arn:aws:iam::123456789012:role/adminRole ``` Ausgabe: ``` { "GrantId": "1a2b3c4d2f5e69f440bae30eaec9570bb1fb7358824f9ddfa1aa5a0dab1a59b2", "GrantToken": "" } ``` Verwenden Sie zum Anzeigen detaillierter Informationen zur Erteilung den Befehl `list-grants`. Weitere Informationen finden Sie unter [Grants in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [CreateGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/create-grant.html)in der *AWS CLI Befehlsreferenz*. ### `create-key` Das folgende Codebeispiel zeigt die Verwendung`create-key`. **AWS CLI** **Beispiel 1: Um einen vom Kunden verwalteten KMS-Schlüssel in AWS KMS zu erstellen** Im folgenden Beispiel für `create-key` wird ein KMS-Schlüssel für die symmetrische Verschlüsselung erstellt. Zum Erstellen des grundlegenden KMS-Schlüssels, einem symmetrischen Verschlüsselungsschlüssel, müssen Sie keine Parameter angeben. Die Standardwerte für diese Parameter erstellen einen symmetrischen Verschlüsselungsschlüssel. Da dieser Befehl keine Schlüsselrichtlinie angibt, erhält der KMS-Schlüssel die [Standardschlüsselrichtlinie](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html#key-policy-default) für KMS-Schlüssel, die programmgesteuert erstellt werden. Verwenden Sie den Befehl `get-key-policy`, um die Schlüsselrichtlinie anzuzeigen. Verwenden Sie den Befehl `put-key-policy`, um die Schlüsselrichtlinie zu ändern. ``` aws kms create-key ``` Der Befehl `create-key` gibt die wichtigsten Metadaten zurück, einschließlich der Schlüssel-ID und des ARN des neuen KMS-Schlüssels. Sie können diese Werte verwenden, um den KMS-Schlüssel in anderen AWS KMS-Vorgängen zu identifizieren. Die Ausgabe enthält keine Tags. Verwenden Sie den `list-resource-tags command`, um die Tags für einen KMS-Schlüssel anzuzeigen. Ausgabe: ``` { "KeyMetadata": { "AWSAccountId": "111122223333", "Arn": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "CreationDate": "2017-07-05T14:04:55-07:00", "CurrentKeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6", "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT", "Description": "", "Enabled": true, "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyManager": "CUSTOMER", "KeySpec": "SYMMETRIC_DEFAULT", "KeyState": "Enabled", "KeyUsage": "ENCRYPT_DECRYPT", "MultiRegion": false, "Origin": "AWS_KMS" "EncryptionAlgorithms": [ "SYMMETRIC_DEFAULT" ] } } ``` Hinweis: Mit dem Befehl `create-key` können Sie keinen Alias angeben. Verwenden Sie den Befehl `create-alias`, um einen Alias für den neuen KMS-Schlüssel zu erstellen. Weitere Informationen finden Sie unter [Erstellen von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. **Beispiel 2: So erstellen Sie einen asymmetrischen RSA-KMS-Schlüssel für die Verschlüsselung und Entschlüsselung** Im folgenden Beispiel für `create-key` wird ein KMS-Schlüssel erstellt, der ein asymmetrisches RSA-Schlüsselpaar für die Verschlüsselung und Entschlüsselung enthält. Die Schlüsselspezifikation und -verwendung können nach dem Erstellen des Schlüssels nicht geändert werden. ``` aws kms create-key \ --key-spec RSA_4096 \ --key-usage ENCRYPT_DECRYPT ``` Ausgabe: ``` { "KeyMetadata": { "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "AWSAccountId": "111122223333", "CreationDate": "2021-04-05T14:04:55-07:00", "CustomerMasterKeySpec": "RSA_4096", "Description": "", "Enabled": true, "EncryptionAlgorithms": [ "RSAES_OAEP_SHA_1", "RSAES_OAEP_SHA_256" ], "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyManager": "CUSTOMER", "KeySpec": "RSA_4096", "KeyState": "Enabled", "KeyUsage": "ENCRYPT_DECRYPT", "MultiRegion": false, "Origin": "AWS_KMS" } } ``` Weitere Informationen finden Sie unter [Asymmetrische Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im *AWS Key Management Service Developer Guide*. **Beispiel 3: So erstellen Sie einen KMS-Schlüssel mit asymmetrischer Elliptic-Curve für die Signatur und Verifizierung** Um einen asymmetrischen KMS-Schlüssel zu erstellen, der ein asymmetrisches Schlüsselpaar mit elliptischer Kurve (ECC) für Signatur und Verifizierung enthält. Der Parameter `--key-usage` ist erforderlich, obwohl `SIGN_VERIFY` der einzig gültige Wert für ECC-KMS-Schlüssel ist. Die Schlüsselspezifikation und -verwendung können nach dem Erstellen des Schlüssels nicht geändert werden. ``` aws kms create-key \ --key-spec ECC_NIST_P521 \ --key-usage SIGN_VERIFY ``` Ausgabe: ``` { "KeyMetadata": { "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "AWSAccountId": "111122223333", "CreationDate": "2019-12-02T07:48:55-07:00", "CustomerMasterKeySpec": "ECC_NIST_P521", "Description": "", "Enabled": true, "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyManager": "CUSTOMER", "KeySpec": "ECC_NIST_P521", "KeyState": "Enabled", "KeyUsage": "SIGN_VERIFY", "MultiRegion": false, "Origin": "AWS_KMS", "SigningAlgorithms": [ "ECDSA_SHA_512" ] } } ``` Weitere Informationen finden Sie unter [Asymmetrische Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im *AWS Key Management Service Developer Guide*. **Beispiel 4: So erstellen Sie einen asymmetrischen ML-DSA-KMS-Schlüssel für Signatur und Verifizierung** In diesem Beispiel wird ein ML-DSA-Schlüssel (Module-Lattice Digital Signature Algorithm) für Signatur und Verifizierung erstellt. Der Schlüsselnutzungsparameter ist erforderlich, obwohl `SIGN_VERIFY` der einzig gültige Wert für ML-DSA-Schlüssel ist. ``` aws kms create-key \ --key-spec ML_DSA_65 \ --key-usage SIGN_VERIFY ``` Ausgabe: ``` { "KeyMetadata": { "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "AWSAccountId": "111122223333", "CreationDate": "2019-12-02T07:48:55-07:00", "Description": "", "Enabled": true, "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyManager": "CUSTOMER", "KeySpec": "ML_DSA_65", "KeyState": "Enabled", "KeyUsage": "SIGN_VERIFY", "MultiRegion": false, "Origin": "AWS_KMS", "SigningAlgorithms": [ "ML_DSA_SHAKE_256" ] } } ``` Weitere Informationen finden Sie unter [Asymmetrische Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im *AWS Key Management Service Developer Guide*. **Beispiel 5: So erstellen Sie einen HMAC-KMS-Schlüssel** Im folgenden Beispiel für `create-key` wird ein HMAC-KMS-Schlüssel von 384 Bit erstellt. Der Wert `GENERATE_VERIFY_MAC` für den Parameter `--key-usage` ist erforderlich, obwohl er der einzig gültige Wert für HMAC-KMS-Schlüssel ist. ``` aws kms create-key \ --key-spec HMAC_384 \ --key-usage GENERATE_VERIFY_MAC ``` Ausgabe: ``` { "KeyMetadata": { "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "AWSAccountId": "111122223333", "CreationDate": "2022-04-05T14:04:55-07:00", "CustomerMasterKeySpec": "HMAC_384", "Description": "", "Enabled": true, "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyManager": "CUSTOMER", "KeySpec": "HMAC_384", "KeyState": "Enabled", "KeyUsage": "GENERATE_VERIFY_MAC", "MacAlgorithms": [ "HMAC_SHA_384" ], "MultiRegion": false, "Origin": "AWS_KMS" } } ``` Weitere Informationen finden Sie unter [HMAC-Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/hmac.html) im *AWS Key Management Service Developer Guide*. **Beispiel 6: So erstellen Sie einen multiregionalen KMS-Schlüssel** Im folgenden Beispiel für `create-key` wird ein multiregionaler Primärschlüssel erstellt. Da die Standardwerte für alle Parameter einen symmetrischen Verschlüsselungsschlüssel erzeugen, ist nur der Parameter `--multi-region` für diesen KMS-Schlüssel erforderlich. Um in der AWS CLI anzugeben, dass ein boolescher Parameter wahr ist, geben Sie einfach den Parameternamen an. ``` aws kms create-key \ --multi-region ``` Ausgabe: ``` { "KeyMetadata": { "Arn": "arn:aws:kms:us-west-2:111122223333:key/mrk-1234abcd12ab34cd56ef12345678990ab", "AWSAccountId": "111122223333", "CreationDate": "2021-09-02T016:15:21-09:00", "CurrentKeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6", "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT", "Description": "", "Enabled": true, "EncryptionAlgorithms": [ "SYMMETRIC_DEFAULT" ], "KeyId": "mrk-1234abcd12ab34cd56ef12345678990ab", "KeyManager": "CUSTOMER", "KeySpec": "SYMMETRIC_DEFAULT", "KeyState": "Enabled", "KeyUsage": "ENCRYPT_DECRYPT", "MultiRegion": true, "MultiRegionConfiguration": { "MultiRegionKeyType": "PRIMARY", "PrimaryKey": { "Arn": "arn:aws:kms:us-west-2:111122223333:key/mrk-1234abcd12ab34cd56ef12345678990ab", "Region": "us-west-2" }, "ReplicaKeys": [] }, "Origin": "AWS_KMS" } } ``` Weitere Informationen finden Sie unter [Asymmetrische Schlüssel in AWS KMS im AWS](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) *Key Management Service* Developer Guide. **Beispiel 7: So erstellen Sie einen KMS-Schlüssel für importiertes Schlüsselmaterial** Im folgenden Beispiel für `create-key` wird ein KMS-Schlüssel ohne Schlüsselmaterial erstellt. Wenn der Vorgang abgeschlossen ist, können Sie Ihr eigenes Schlüsselmaterial in den KMS-Schlüssel importieren. Um diesen KMS-Schlüssel zu erstellen, legen Sie den Parameter `--origin` auf `EXTERNAL` fest. ``` aws kms create-key \ --origin EXTERNAL ``` Ausgabe: ``` { "KeyMetadata": { "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "AWSAccountId": "111122223333", "CreationDate": "2019-12-02T07:48:55-07:00", "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT", "Description": "", "Enabled": false, "EncryptionAlgorithms": [ "SYMMETRIC_DEFAULT" ], "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyManager": "CUSTOMER", "KeySpec": "SYMMETRIC_DEFAULT", "KeyState": "PendingImport", "KeyUsage": "ENCRYPT_DECRYPT", "MultiRegion": false, "Origin": "EXTERNAL" } } ``` Weitere Informationen finden Sie unter [Importieren von Schlüsselmaterial in AWS KMS-Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html) im *AWS Key Management Service Developer Guide*. **Beispiel 6: So erstellen Sie einen KMS-Schlüssel in einem AWS CloudHSM-Schlüsselspeicher** Das folgende `create-key` Beispiel erstellt einen KMS-Schlüssel im angegebenen AWS CloudHSM-Schlüsselspeicher. Der Vorgang erstellt den KMS-Schlüssel und seine Metadaten in AWS KMS und erstellt das Schlüsselmaterial im AWS CloudHSM-Cluster, der dem benutzerdefinierten Schlüsselspeicher zugeordnet ist. Die Parameter `--custom-key-store-id` und `--origin` müssen angegeben werden. ``` aws kms create-key \ --origin AWS_CLOUDHSM \ --custom-key-store-id cks-1234567890abcdef0 ``` Ausgabe: ``` { "KeyMetadata": { "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "AWSAccountId": "111122223333", "CloudHsmClusterId": "cluster-1a23b4cdefg", "CreationDate": "2019-12-02T07:48:55-07:00", "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT", "CustomKeyStoreId": "cks-1234567890abcdef0", "Description": "", "Enabled": true, "EncryptionAlgorithms": [ "SYMMETRIC_DEFAULT" ], "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyManager": "CUSTOMER", "KeySpec": "SYMMETRIC_DEFAULT", "KeyState": "Enabled", "KeyUsage": "ENCRYPT_DECRYPT", "MultiRegion": false, "Origin": "AWS_CLOUDHSM" } } ``` Weitere Informationen finden Sie unter [AWS -CloudHSM-Schlüsselspeicher](https://docs.aws.amazon.com/kms/latest/developerguide/keystore-cloudhsm.html) im *Entwicklerhandbuch für AWS Key Management Service*. **Beispiel 8: So erstellen Sie einen KMS-Schlüssel in einem externen Schlüsselspeicher** Im folgenden Beispiel für `create-key` wird ein KMS-Schlüssel im angegebenen externen Schlüsselspeicher erstellt. Die Parameter `--custom-key-store-id`, `--origin` und `--xks-key-id` sind in diesem Befehl erforderlich. Der Parameter `--xks-key-id` gibt die ID eines vorhandenen symmetrischen Verschlüsselungsschlüssels in Ihrem externen Schlüsselmanager an. Dieser Schlüssel dient als externes Schlüsselmaterial für den KMS-Schlüssel. Der Wert des Parameters `--origin` muss `EXTERNAL_KEY_STORE` lauten. Der Parameter `custom-key-store-id` muss einen externen Schlüsselspeicher identifizieren, der mit dem Proxy seines externen Schlüsselspeichers verbunden ist. ``` aws kms create-key \ --origin EXTERNAL_KEY_STORE \ --custom-key-store-id cks-9876543210fedcba9 \ --xks-key-id bb8562717f809024 ``` Ausgabe: ``` { "KeyMetadata": { "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "AWSAccountId": "111122223333", "CreationDate": "2022-12-02T07:48:55-07:00", "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT", "CustomKeyStoreId": "cks-9876543210fedcba9", "Description": "", "Enabled": true, "EncryptionAlgorithms": [ "SYMMETRIC_DEFAULT" ], "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyManager": "CUSTOMER", "KeySpec": "SYMMETRIC_DEFAULT", "KeyState": "Enabled", "KeyUsage": "ENCRYPT_DECRYPT", "MultiRegion": false, "Origin": "EXTERNAL_KEY_STORE", "XksKeyConfiguration": { "Id": "bb8562717f809024" } } } ``` Weitere Informationen finden Sie unter [Externe Schlüsselspeicher](https://docs.aws.amazon.com/kms/latest/developerguide/keystore-external.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [CreateKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/create-key.html)in der *AWS CLI Befehlsreferenz*. ### `decrypt` Das folgende Codebeispiel zeigt die Verwendung`decrypt`. **AWS CLI** **Beispiel 1: So verschlüsseln Sie eine verschlüsselte Nachricht mit einem symmetrischen KMS-Schlüssel (Linux und macOS)** Das folgende `decrypt` Befehlsbeispiel zeigt die empfohlene Methode zum Entschlüsseln von Daten mit der AWS CLI. Diese Version zeigt, wie Daten unter einem symmetrischen KMS-Schlüssel entschlüsselt werden. Geben Sie den Geheimtext in einer Datei an. Verwenden Sie im Wert des `--ciphertext-blob`-Parameters das `fileb://`-Präfix, das die CLI anweist, die Daten aus einer Binärdatei zu lesen. Wenn sich die Datei nicht im aktuellen Verzeichnis befindet, geben Sie den vollständigen Dateipfad ein. Weitere Informationen zum Lesen von AWS CLI-Parameterwerten aus einer Datei finden Sie unter AWS CLI-Parameter aus einer Datei laden < https://docs.aws.amazon.com/cli/ latest/userguide/cli - usage-parameters-file .html> im *AWS Command Line Interface User Guide* und Best Practices for Local File Parameters< https://aws.amazon.com/blogs/ developer/ best-practices-for-local -file-parameters/> im *AWS Command Line Tool Blog* .Geben Sie den KMS-Schlüssel an, um den Chiffretext zu entschlüsseln. Der Parameter ist bei der Entschlüsselung mit einem symmetrischen KMS-Schlüssel nicht erforderlich. `--key-id` AWS KMS kann die Schlüssel-ID des KMS-Schlüssels, der zur Verschlüsselung der Daten verwendet wurde, aus den Metadaten im Chiffretext abrufen. Es ist jedoch immer eine bewährte Methode, den von Ihnen verwendeten KMS-Schlüssel anzugeben. Diese Methode stellt sicher, dass Sie den beabsichtigten KMS-Schlüssel verwenden, und verhindert, dass Sie versehentlich einen Geheimtext mit einem KMS-Schlüssel entschlüsseln, dem Sie nicht vertrauen. Fordern Sie die Klartextausgabe als Textwert an. Der Parameter `--query` weist die CLI an, nur den Wert des Felds `Plaintext` aus der Ausgabe abzurufen. Der Parameter `--output` gibt die Ausgabe als Text zurück. Base64-dekodieren Sie den Klartext und speichern Sie ihn in einer Datei. Im folgenden Beispiel wird der Wert des Parameters `Plaintext` über eine Pipe (\$1) an das Base64-Dienstprogramm weitergeleitet, das ihn dekodiert. Anschließend erfolgt eine Umleitung (>) der dekodierten Ausgabe in die Datei `ExamplePlaintext`. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem Konto. AWS ``` aws kms decrypt \ --ciphertext-blob fileb://ExampleEncryptedFile \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --output text \ --query Plaintext | base64 \ --decode > ExamplePlaintextFile ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Die Ausgabe des Befehls `decrypt` wird Base64-dekodiert und in einer Datei gespeichert. Weitere Informationen finden Sie unter [Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) in der *API-Referenz zu AWS Key Management Service*. **Beispiel 2: Um eine verschlüsselte Nachricht mit einem symmetrischen KMS-Schlüssel zu entschlüsseln (Windows-Befehlszeile)** Das folgende Beispiel ist mit dem vorherigen identisch, mit dem Unterschied, dass es das Dienstprogramm `certutil` zur Base64-Decodierung der Klartextdaten verwendet. Für dieses Verfahren sind zwei Befehle erforderlich, wie in den folgenden Beispielen gezeigt. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem AWS Konto. ``` aws kms decrypt ^ --ciphertext-blob fileb://ExampleEncryptedFile ^ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ^ --output text ^ --query Plaintext > ExamplePlaintextFile.base64 ``` Führen Sie den Befehl `certutil` aus. ``` certutil -decode ExamplePlaintextFile.base64 ExamplePlaintextFile ``` Ausgabe: ``` Input Length = 18 Output Length = 12 CertUtil: -decode command completed successfully. ``` Weitere Informationen finden Sie unter [Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) in der *API-Referenz zu AWS Key Management Service*. **Beispiel 3: So entschlüsseln Sie eine verschlüsselte Nachricht mit einem asymmetrischen KMS-Schlüssel (Linux und macOS)** Das folgende Beispiel für den Befehl `decrypt` zeigt, wie Daten entschlüsselt werden, die unter einem asymmetrischen RSA-KMS-Schlüssel verschlüsselt wurden. Bei Verwendung eines asymmetrischen KMS-Schlüssels ist der Parameter `encryption-algorithm` erforderlich, der den Algorithmus zum Verschlüsseln des Klartextes angibt. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem AWS Konto. ``` aws kms decrypt \ --ciphertext-blob fileb://ExampleEncryptedFile \ --key-id 0987dcba-09fe-87dc-65ba-ab0987654321 \ --encryption-algorithm RSAES_OAEP_SHA_256 \ --output text \ --query Plaintext | base64 \ --decode > ExamplePlaintextFile ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Die Ausgabe des Befehls `decrypt` wird Base64-dekodiert und in einer Datei gespeichert. Weitere Informationen finden Sie unter [Asymmetrische Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im *AWS Key Management Service Developer Guide*. + Weitere API-Informationen finden Sie unter [Decrypt](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/decrypt.html) in der *AWS CLI -Befehlsreferenz*. ### `delete-alias` Das folgende Codebeispiel zeigt die Verwendung`delete-alias`. **AWS CLI** **Um einen AWS KMS-Alias zu löschen** Im folgenden Beispiel für `delete-alias` wird die Tabelle `alias/example-alias` gelöscht. Der Aliasname muss mit „alias/“ beginnen. ``` aws kms delete-alias \ --alias-name alias/example-alias ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl `list-aliases`, um den Alias zu suchen. Weitere Informationen finden Sie unter [Löschen eines Alias](https://docs.aws.amazon.com/kms/latest/developerguide/alias-manage.html#alias-delete) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [DeleteAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/delete-alias.html)unter *AWS CLI Befehlsreferenz*. ### `delete-custom-key-store` Das folgende Codebeispiel zeigt die Verwendung`delete-custom-key-store`. **AWS CLI** **So löschen Sie einen benutzerdefinierten Schlüsselspeicher** Im folgenden Beispiel für `delete-custom-key-store` wird der angegebene benutzerdefinierte Schlüsselspeicher gelöscht. Das Löschen eines AWS CloudHSM-Schlüsselspeichers hat keine Auswirkungen auf den zugehörigen CloudHSM-Cluster. Das Löschen eines externen Schlüsselspeichers hat keine Auswirkungen auf den zugehörigen Proxy des externen Schlüsselspeichers, den externen Schlüsselmanager oder die externen Schlüssel. **HINWEIS:** Bevor Sie einen benutzerdefinierten Schlüsselspeicher löschen können, müssen Sie das Löschen aller KMS-Schlüssel im benutzerdefinierten Schlüsselspeicher planen und dann warten, bis diese KMS-Schlüssel gelöscht sind. Trennen Sie anschließend den benutzerdefinierten Schlüsselspeicher. Hilfe bei der Suche nach den KMS-Schlüsseln in Ihrem benutzerdefinierten Schlüsselspeicher finden [Sie unter Löschen eines AWS CloudHSM-Schlüsselspeichers (API)](https://docs.aws.amazon.com/kms/latest/developerguide/delete-keystore.html#delete-keystore-api) im *AWS Key Management Service Developer Guide*. ``` delete-custom-key-store \ --custom-key-store-id cks-1234567890abcdef0 ``` Dieser Befehl gibt keine Ausgabe zurück. Um zu überprüfen, ob der benutzerdefinierte Schlüsselspeicher gelöscht wurde, verwenden Sie den Befehl `describe-custom-key-stores`. Informationen zum Löschen eines AWS CloudHSM-Schlüsselspeichers finden Sie unter [Löschen eines AWS CloudHSM-Schlüsselspeichers im AWS Key](https://docs.aws.amazon.com/kms/latest/developerguide/delete-keystore.html) *Management* Service Developer Guide. Weitere Informationen zum Löschen eines externen Schlüsselspeichers finden Sie unter [Löschen eines externen Schlüsselspeichers](https://docs.aws.amazon.com/kms/latest/developerguide/delete-xks.html) im *Entwicklerhandbuch für AWS Key Management Service*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteCustomKeyStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/delete-custom-key-store.html).AWS CLI * ### `delete-imported-key-material` Das folgende Codebeispiel zeigt die Verwendung`delete-imported-key-material`. **AWS CLI** **So löschen Sie importiertes Schlüsselmaterial aus einem KMS-Schlüssel** Im folgenden Beispiel für `delete-imported-key-material` wird Schlüsselmaterial gelöscht, das in einen KMS-Schlüssel importiert wurde. ``` aws kms delete-imported-key-material \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6" } ``` Weitere Informationen finden Sie unter [Löschen von importiertem Schlüsselmaterial](https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys-delete-key-material.html) im *Entwicklerhandbuch für AWS KMS Key Management Service*. + Einzelheiten zur API finden Sie [DeleteImportedKeyMaterial](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/delete-imported-key-material.html)in der *AWS CLI Befehlsreferenz*. ### `derive-shared-secret` Das folgende Codebeispiel zeigt die Verwendung`derive-shared-secret`. **AWS CLI** **So leiten Sie ein freigegebenes Secret ab** Im folgenden Beispiel für `derive-shared-secret` wird ein gemeinsamer geheimer Schlüssel mithilfe eines Schlüsselvereinbarungsalgorithmus abgeleitet. Sie müssen ein von NIST empfohlenes asymmetrisches KMS-Schlüsselpaar mit elliptischer Kurve (ECC) oder SM2 (nur Regionen China) mit dem Wert to call verwenden. `KeyUsage` `KEY_AGREEMENT` DeriveSharedSecret ``` aws kms derive-shared-secret \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --key-agreement-algorithm ECDH \ --public-key "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvH3Yj0wbkLEpUl95Cv1cJVjsVNSjwGq3tCLnzXfhVwVvmzGN8pYj3U8nKwgouaHbBWNJYjP5VutbbkKS4Kv4GojwZBJyHN17kmxo8yTjRmjR15SKIQ8cqRA2uaERMLnpztIXdZp232PQPbWGxDyXYJ0aJ5EFSag" ``` Ausgabe: ``` { "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "SharedSecret": "MEYCIQCKZLWyTk5runarx6XiAkU9gv3lbwPO/pHa+DXFehzdDwIhANwpsIV2g/9SPWLLsF6p/hiSskuIXMTRwqrMdVKWTMHG", "KeyAgreementAlgorithm": "ECDH", "KeyOrigin": "AWS_KMS" } ``` *Weitere Informationen finden Sie [DeriveSharedSecret](https://docs.aws.amazon.com/kms/latest/APIReference/API_DeriveSharedSecret.html)in der Key Management Service API-Referenz.AWS * + Einzelheiten zur API finden Sie [DeriveSharedSecret](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/derive-shared-secret.html)unter *AWS CLI Befehlsreferenz*. ### `describe-custom-key-stores` Das folgende Codebeispiel zeigt die Verwendung`describe-custom-key-stores`. **AWS CLI** **Beispiel 1: Um Details zu einem AWS CloudHSM-Schlüsselspeicher abzurufen** Im folgenden `describe-custom-key-store` Beispiel werden Details zum angegebenen AWS CloudHSM-Schlüsselspeicher angezeigt. Der Befehl ist für alle Arten von benutzerdefinierten Schlüsselspeichern identisch, aber die Ausgabe unterscheidet sich je nach Schlüsselspeichertyp und, bei einem externen Schlüsselspeicher, je nach dessen Verbindungsoption. Diese Funktion zeigt standardmäßig Informationen zu allen benutzerdefinierten Schlüsselspeichern im Konto und in der Region an. Verwenden Sie den Parameter `custom-key-store-name` oder `custom-key-store-id`, um Informationen zu einem bestimmten benutzerdefinierten Schlüsselspeicher anzuzeigen. ``` aws kms describe-custom-key-stores \ --custom-key-store-name ExampleCloudHSMKeyStore ``` Die Ausgabe dieses Befehls enthält nützliche Informationen über den AWS CloudHSM-Schlüsselspeicher, einschließlich seines Verbindungsstatus ()`ConnectionState`. Wenn der Verbindungsstatus `FAILED` lautet, enthält die Ausgabe das Feld `ConnectionErrorCode` mit einer Beschreibung des Problems. Ausgabe: ``` { "CustomKeyStores": [ { "CloudHsmClusterId": "cluster-1a23b4cdefg", "ConnectionState": "CONNECTED", "CreationDate": "2022-04-05T14:04:55-07:00", "CustomKeyStoreId": "cks-1234567890abcdef0", "CustomKeyStoreName": "ExampleExternalKeyStore", "TrustAnchorCertificate": "" } ] } ``` Weitere Informationen finden Sie unter [AWS CloudHSM-Schlüsselspeicher anzeigen im AWS Key](https://docs.aws.amazon.com/kms/latest/developerguide/view-keystore.html) *Management Service Developer Guide*. **Beispiel 2: So rufen Sie Details zu einem externen Schlüsselspeicher mit öffentlicher Endpunkt-Konnektivität ab** Im folgenden Beispiel für `describe-custom-key-store` werden Details zum angegebenen externen Schlüsselspeicher angezeigt. Der Befehl ist für alle Arten von benutzerdefinierten Schlüsselspeichern identisch, aber die Ausgabe unterscheidet sich je nach Schlüsselspeichertyp und, bei einem externen Schlüsselspeicher, je nach dessen Verbindungsoption. Diese Funktion zeigt standardmäßig Informationen zu allen benutzerdefinierten Schlüsselspeichern im Konto und in der Region an. Verwenden Sie den Parameter `custom-key-store-name` oder `custom-key-store-id`, um Informationen zu einem bestimmten benutzerdefinierten Schlüsselspeicher anzuzeigen. ``` aws kms describe-custom-key-stores \ --custom-key-store-id cks-9876543210fedcba9 ``` Die Ausgabe dieses Befehls enthält nützliche Informationen über den externen Schlüsselspeicher, einschließlich seines Verbindungsstatus (`ConnectionState`). Wenn der Verbindungsstatus `FAILED` lautet, enthält die Ausgabe das Feld `ConnectionErrorCode` mit einer Beschreibung des Problems. Ausgabe: ``` { "CustomKeyStores": [ { "CustomKeyStoreId": "cks-9876543210fedcba9", "CustomKeyStoreName": "ExampleXKS", "ConnectionState": "CONNECTED", "CreationDate": "2022-12-02T07:48:55-07:00", "CustomKeyStoreType": "EXTERNAL_KEY_STORE", "XksProxyConfiguration": { "AccessKeyId": "ABCDE12345670EXAMPLE", "Connectivity": "PUBLIC_ENDPOINT", "UriEndpoint": "https://myproxy.xks.example.com", "UriPath": "/example-prefix/kms/xks/v1" } } ] } ``` Weitere Informationen finden Sie unter [Anzeigen eines externen Schlüsselspeichers](https://docs.aws.amazon.com/kms/latest/developerguide/view-xks-keystore.html) im *Entwicklerhandbuch für AWS Key Management Service*. **Beispiel 3: So rufen Sie Details zu einem externen Schlüsselspeicher mit der Konnektivität eines VPC-Endpunkt-Service** Im folgenden Beispiel für `describe-custom-key-store` werden Details zum angegebenen externen Schlüsselspeicher angezeigt. Der Befehl ist für alle Arten von benutzerdefinierten Schlüsselspeichern identisch, aber die Ausgabe unterscheidet sich je nach Schlüsselspeichertyp und, bei einem externen Schlüsselspeicher, je nach dessen Verbindungsoption. Diese Funktion zeigt standardmäßig Informationen zu allen benutzerdefinierten Schlüsselspeichern im Konto und in der Region an. Verwenden Sie den Parameter `custom-key-store-name` oder `custom-key-store-id`, um Informationen zu einem bestimmten benutzerdefinierten Schlüsselspeicher anzuzeigen. ``` aws kms describe-custom-key-stores \ --custom-key-store-id cks-2234567890abcdef0 ``` Die Ausgabe dieses Befehls enthält nützliche Informationen über den externen Schlüsselspeicher, einschließlich seines Verbindungsstatus (`ConnectionState`). Wenn der Verbindungsstatus `FAILED` lautet, enthält die Ausgabe das Feld `ConnectionErrorCode` mit einer Beschreibung des Problems. Ausgabe: ``` { "CustomKeyStores": [ { "CustomKeyStoreId": "cks-3234567890abcdef0", "CustomKeyStoreName": "ExampleVPCExternalKeyStore", "ConnectionState": "CONNECTED", "CreationDate": "2022-12-22T07:48:55-07:00", "CustomKeyStoreType": "EXTERNAL_KEY_STORE", "XksProxyConfiguration": { "AccessKeyId": "ABCDE12345670EXAMPLE", "Connectivity": "VPC_ENDPOINT_SERVICE", "UriEndpoint": "https://myproxy-private.xks.example.com", "UriPath": "/kms/xks/v1", "VpcEndpointServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-example1" } } ] } ``` Weitere Informationen finden Sie unter [Anzeigen eines externen Schlüsselspeichers](https://docs.aws.amazon.com/kms/latest/developerguide/view-xks-keystore.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie unter [DescribeCustomKeyStores AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/describe-custom-key-stores.html)*Befehlsreferenz*. ### `describe-key` Das folgende Codebeispiel zeigt die Verwendung`describe-key`. **AWS CLI** **Beispiel 1: So finden Sie detaillierte Informationen zu einem KMS-Schlüssel** Im folgenden `describe-key` Beispiel werden detaillierte Informationen zum AWS verwalteten Schlüssel für Amazon S3 im Beispielkonto und in der Region abgerufen. Sie können diesen Befehl verwenden, um Details zu AWS verwalteten Schlüsseln und kundenverwalteten Schlüsseln zu finden. Verwenden Sie den Parameter `key-id`, um den KMS-Schlüssel anzugeben. In diesem Beispiel wird der Wert für einen Aliasnamen verwendet, Sie können in diesem Befehl jedoch eine Schlüssel-ID, einen Schlüssel-ARN, einen Aliasnamen oder einen Alias-ARN verwenden. ``` aws kms describe-key \ --key-id alias/aws/s3 ``` Ausgabe: ``` { "KeyMetadata": { "AWSAccountId": "846764612917", "KeyId": "b8a9477d-836c-491f-857e-07937918959b", "Arn": "arn:aws:kms:us-west-2:846764612917:key/b8a9477d-836c-491f-857e-07937918959b", "CurrentKeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6", "CreationDate": 2017-06-30T21:44:32.140000+00:00, "Enabled": true, "Description": "Default KMS key that protects my S3 objects when no other key is defined", "KeyUsage": "ENCRYPT_DECRYPT", "KeyState": "Enabled", "Origin": "AWS_KMS", "KeyManager": "AWS", "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT", "EncryptionAlgorithms": [ "SYMMETRIC_DEFAULT" ] } } ``` Weitere Informationen finden Sie unter [Anzeigen von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/viewing-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. **Beispiel 2: So rufen Sie Details zu einem asymmetrischen RSA-KMS-Schlüssel ab** Im folgenden Beispiel für `describe-key` werden detaillierte Informationen zu einem asymmetrischen RSA-KMS-Schlüssel abgerufen, der für Signatur und Verifizierung verwendet wird. ``` aws kms describe-key \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "KeyMetadata": { "AWSAccountId": "111122223333", "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "Arn": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "CreationDate": "2019-12-02T19:47:14.861000+00:00", "CustomerMasterKeySpec": "RSA_2048", "Enabled": false, "Description": "", "KeyState": "Disabled", "Origin": "AWS_KMS", "MultiRegion": false, "KeyManager": "CUSTOMER", "KeySpec": "RSA_2048", "KeyUsage": "SIGN_VERIFY", "SigningAlgorithms": [ "RSASSA_PKCS1_V1_5_SHA_256", "RSASSA_PKCS1_V1_5_SHA_384", "RSASSA_PKCS1_V1_5_SHA_512", "RSASSA_PSS_SHA_256", "RSASSA_PSS_SHA_384", "RSASSA_PSS_SHA_512" ] } } ``` **Beispiel 3: So rufen Sie Details zu einem Replikatschlüssel für mehrere Regionen ab** Im folgenden Beispiel für `describe-key` werden Metadaten für einen multiregionalen Replikatschlüssel abgerufen. Der multiregionale Schlüssel ist ein symmetrischer Verschlüsselungsschlüssel. Die Ausgabe eines `describe-key`-Befehls für einen beliebigen Schlüssel mit mehreren Regionen gibt Informationen zum Primärschlüssel und allen zugehörigen Replikaten zurück. ``` aws kms describe-key \ --key-id arn:aws:kms:ap-northeast-1:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab ``` Ausgabe: ``` { "KeyMetadata": { "MultiRegion": true, "AWSAccountId": "111122223333", "Arn": "arn:aws:kms:ap-northeast-1:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab", "CreationDate": "2021-06-28T21:09:16.114000+00:00", "CurrentKeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6", "Description": "", "Enabled": true, "KeyId": "mrk-1234abcd12ab34cd56ef1234567890ab", "KeyManager": "CUSTOMER", "KeyState": "Enabled", "KeyUsage": "ENCRYPT_DECRYPT", "Origin": "AWS_KMS", "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT", "EncryptionAlgorithms": [ "SYMMETRIC_DEFAULT" ], "MultiRegionConfiguration": { "MultiRegionKeyType": "PRIMARY", "PrimaryKey": { "Arn": "arn:aws:kms:us-west-2:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab", "Region": "us-west-2" }, "ReplicaKeys": [ { "Arn": "arn:aws:kms:eu-west-1:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab", "Region": "eu-west-1" }, { "Arn": "arn:aws:kms:ap-northeast-1:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab", "Region": "ap-northeast-1" }, { "Arn": "arn:aws:kms:sa-east-1:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab", "Region": "sa-east-1" } ] } } } ``` **Beispiel 4: So rufen Sie Details zu einem asymmetrischen HMAC-KMS-Schlüssel ab** Im folgenden Beispiel für `describe-key` werden detaillierte Informationen zu einem HMAC-KMS-Schlüssel abgerufen. ``` aws kms describe-key \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "KeyMetadata": { "AWSAccountId": "123456789012", "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "Arn": "arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab", "CreationDate": "2022-04-03T22:23:10.194000+00:00", "Enabled": true, "Description": "Test key", "KeyUsage": "GENERATE_VERIFY_MAC", "KeyState": "Enabled", "Origin": "AWS_KMS", "KeyManager": "CUSTOMER", "CustomerMasterKeySpec": "HMAC_256", "MacAlgorithms": [ "HMAC_SHA_256" ], "MultiRegion": false } } ``` + Einzelheiten zur API finden Sie [DescribeKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/describe-key.html)in der *AWS CLI Befehlsreferenz*. ### `disable-key-rotation` Das folgende Codebeispiel zeigt die Verwendung`disable-key-rotation`. **AWS CLI** **So deaktivieren Sie die automatische Drehung eines KMS-Schlüssels** Im folgenden Beispiel für `disable-key-rotation` wird die automatische Rotation eines kundenseitig verwalteten KMS-Schlüssels deaktiviert. Verwenden Sie den Befehl `enable-key-rotation`, um die automatische Rotation erneut zu aktivieren. ``` aws kms disable-key-rotation \ --key-id arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl `get-key-rotation-status`, um zu überprüfen, ob die automatische Rotation für den KMS-Schlüssel deaktiviert ist. Weitere Informationen finden Sie unter [Rotieren von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [DisableKeyRotation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/disable-key-rotation.html)in der *AWS CLI Befehlsreferenz*. ### `disable-key` Das folgende Codebeispiel zeigt die Verwendung`disable-key`. **AWS CLI** **So deaktivieren Sie einen KMS-Schlüssel vorübergehend** Der folgende Befehl `disable-key` deaktiviert einen kundenseitig verwalteten KMS-Schlüssel. Verwenden Sie den Befehl `enable-key`, um den KMS-Schlüssel erneut zu aktivieren. ``` aws kms disable-key \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Aktivieren und Deaktivieren von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/enabling-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [DisableKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/disable-key.html)in der *AWS CLI Befehlsreferenz*. ### `disconnect-custom-key-store` Das folgende Codebeispiel zeigt die Verwendung`disconnect-custom-key-store`. **AWS CLI** **So trennen Sie einen benutzerdefinierten Schlüsselspeicher** Im folgenden `disconnect-custom-key-store` Beispiel wird die Verbindung eines benutzerdefinierten Schlüsselspeichers von seinem AWS CloudHSM-Cluster getrennt. Sie können die Verbindung zu einem Schlüsselspeicher trennen, um ein Problem zu beheben, seine Einstellungen zu aktualisieren oder um zu verhindern, dass KMS-Schlüssel im Schlüsselspeicher für kryptografische Vorgänge verwendet werden. Dieser Befehl ist für alle benutzerdefinierten Schlüsselspeicher identisch, einschließlich AWS CloudHSM-Schlüsselspeicher und externer Schlüsselspeicher. Vor der Ausführung dieses Befehls müssen Sie die Beispiel-ID des benutzerdefinierten Schlüsselspeichers durch eine gültige ID ersetzen. ``` $ aws kms disconnect-custom-key-store \ --custom-key-store-id cks-1234567890abcdef0 ``` Dieser Befehl erzeugt keine Ausgabe. Vergewissern Sie sich, dass der Befehl wirksam war, und verwenden Sie den Befehl `describe-custom-key-stores`. *Weitere Informationen zum Trennen eines AWS CloudHSM-Schlüsselspeichers finden Sie unter [Verbinden und Trennen eines AWS CloudHSM-Schlüsselspeichers im Key Management Service Developer](https://docs.aws.amazon.com/kms/latest/developerguide/disconnect-keystore.html) Guide.AWS * Weitere Informationen zum Trennen eines externen Schlüsselspeichers finden Sie unter [Verbinden und Trennen eines externen Schlüsselspeichers](https://docs.aws.amazon.com/kms/latest/developerguide/xks-connect-disconnect.html) im *Entwicklerhandbuch für AWS Key Management Service*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DisconnectCustomKeyStore](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/disconnect-custom-key-store.html)AWS CLI * ### `enable-key-rotation` Das folgende Codebeispiel zeigt die Verwendung`enable-key-rotation`. **AWS CLI** **So aktivieren Sie die automatische Rotation eines KMS-Schlüssels** Das folgende Beispiel für `enable-key-rotation` ermöglicht die automatische Rotation eines kundenseitig verwalteten KMS-Schlüssels mit einem Rotationszeitraum von 180 Tagen. Der KMS-Schlüssel wird ab dem Datum, an dem dieser Befehl abgeschlossen wurde, ein Jahr (ungefähr 365 Tage) rotiert, und danach jedes Jahr. Der Parameter `--key-id` identifiziert den KMS-Schlüssel. In diesem Beispiel wird ein Schlüssel-ARN-Wert verwendet, Sie können jedoch entweder die Schlüssel-ID oder den ARN des KMS-Schlüssels verwenden. Der Parameter `--rotation-period-in-days` gibt die Anzahl der Tage zwischen den einzelnen Rotationsdatumsangaben an. Geben Sie einen Wert zwischen 90 und 2 560 an. Wenn kein Wert angegeben wird, lautet der Standardwert 365 Tage. ``` aws kms enable-key-rotation \ --key-id arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \ --rotation-period-in-days 180 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl `get-key-rotation-status`, um zu überprüfen, ob der KMS-Schlüssel aktiviert ist. Weitere Informationen finden Sie unter [Rotieren von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [EnableKeyRotation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/enable-key-rotation.html)in der *AWS CLI Befehlsreferenz*. ### `enable-key` Das folgende Codebeispiel zeigt die Verwendung`enable-key`. **AWS CLI** **So aktivieren Sie einen KMS-Schlüssel** Im folgenden Beispiel für `enable-key` wird ein kundenseitig verwalteter Schlüssel aktiviert. Sie können einen Befehl wie diesen verwenden, um einen KMS-Schlüssel zu aktivieren, den Sie mit dem Befehl `disable-key` vorübergehend deaktiviert haben. Sie können ihn auch verwenden, um einen deaktivierten KMS-Schlüssel zu aktivieren, er zum Löschen vorgesehen war und der Löschvorgang abgebrochen wurde. Verwenden Sie den Parameter `key-id`, um den KMS-Schlüssel anzugeben. In diesem Beispiel wird ein Schlüssel-ID-Wert verwendet, Sie können jedoch eine Schlüssel-ID- oder einen Schlüssel-ARN-Wert in diesem Befehl verwenden. Ersetzen Sie vor Ausführung dieses Befehls die Beispielschlüssel-ID durch eine gültige. ``` aws kms enable-key \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl `describe-key`, um zu überprüfen, ob der KMS-Schlüssel aktiviert ist. Sehen Sie sich die Werte der Felder `KeyState` und `Enabled` und in der Ausgabe von `describe-key` an. Weitere Informationen finden Sie unter [Aktivieren und Deaktivieren von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/enabling-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [EnableKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/enable-key.html)in der *AWS CLI Befehlsreferenz*. ### `encrypt` Das folgende Codebeispiel zeigt die Verwendung`encrypt`. **AWS CLI** **Beispiel 1: So verschlüsseln Sie den Inhalt einer Datei unter Linux oder MacOS** Der folgende `encrypt` Befehl demonstriert die empfohlene Methode zum Verschlüsseln von Daten mit der AWS CLI. ``` aws kms encrypt \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --plaintext fileb://ExamplePlaintextFile \ --output text \ --query CiphertextBlob | base64 \ --decode > ExampleEncryptedFile ``` Der Befehl führt mehrere Aktionen aus: Er verwendet den Parameter `--plaintext`, um die zu verschlüsselnden Daten anzugeben. Dieser Parameterwert muss Base64-kodiert sein. Der Wert des `plaintext` Parameters muss Base64-kodiert sein, oder Sie müssen das `fileb://` Präfix verwenden, das die AWS CLI anweist, Binärdaten aus der Datei zu lesen. Wenn sich die Datei nicht im aktuellen Verzeichnis befindet, geben Sie den vollständigen Dateipfad ein. Beispiel: `fileb:///var/tmp/ExamplePlaintextFile` oder `fileb://C:\Temp\ExamplePlaintextFile`. [Weitere Informationen zum Lesen von AWS CLI-Parameterwerten aus einer Datei finden Sie unter [Laden von Parametern aus einer Datei](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-file) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle* und [Best Practices für lokale Dateiparameter](https://blogs.aws.amazon.com/cli/post/TxLWWN1O25V1HE/Best-Practices-for-Local-File-Parameters) im Blog des AWS Befehlszeilentools. Verwendet die `--query` Parameter `--output` und, um die Befehlsausgabe zu steuern.Diese Parameter extrahieren die verschlüsselten Daten, den so genannten *Chiffretext*, aus der Befehlsausgabe. Weitere Informationen zur Steuerung der Ausgabe finden Sie unter Steuern von Befehlen ](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html)Ausgabe im *AWS Command Line Interface User Guide*. Verwendet das `base64` Hilfsprogramm, um die extrahierte Ausgabe in Binärdaten zu dekodieren. Der Chiffretext, der von einem erfolgreichen `encrypt` Befehl zurückgegeben wird, ist Base64-codierter Text. Sie müssen diesen Text dekodieren, bevor Sie ihn mit der AWS CLI entschlüsseln können. Speichert den binären Chiffretext in einer Datei. Der letzte Teil des Befehls (`> ExampleEncryptedFile`) speichert den binären Chiffretext in einer Datei, um die Entschlüsselung zu vereinfachen. Einen Beispielbefehl, der die AWS CLI zum Entschlüsseln von Daten verwendet, finden Sie in den Entschlüsselungsbeispielen. **Beispiel 2: Verwenden der AWS CLI zum Verschlüsseln von Daten unter Windows** Dieses Beispiel ist mit dem vorherigen identisch, mit dem Unterschied, dass es das Tool `certutil` anstelle von `base64` verwendet. Für dieses Verfahren sind zwei Befehle erforderlich, wie in den folgenden Beispielen gezeigt. ``` aws kms encrypt \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --plaintext fileb://ExamplePlaintextFile \ --output text \ --query CiphertextBlob > C:\Temp\ExampleEncryptedFile.base64 certutil -decode C:\Temp\ExampleEncryptedFile.base64 C:\Temp\ExampleEncryptedFile ``` **Beispiel 3: Verschlüsseln mit einem asymmetrischen KMS-Schlüssel** Der folgende Befehl `encrypt` zeigt, wie Klartext mit einem asymmetrischen KMS-Schlüssel verschlüsselt wird. Der Parameter `--encryption-algorithm` muss angegeben werden. Wie bei allen `encrypt` CLI-Befehlen muss der `plaintext` Parameter base64-codiert sein, oder Sie müssen das `fileb://` Präfix verwenden, das die AWS CLI anweist, Binärdaten aus der Datei zu lesen. ``` aws kms encrypt \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --encryption-algorithm RSAES_OAEP_SHA_256 \ --plaintext fileb://ExamplePlaintextFile \ --output text \ --query CiphertextBlob | base64 \ --decode > ExampleEncryptedFile ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Weitere API-Informationen finden Sie unter [Encrypt](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/encrypt.html) in der *AWS CLI -Befehlsreferenz*. ### `generate-data-key-pair-without-plaintext` Das folgende Codebeispiel zeigt die Verwendung. `generate-data-key-pair-without-plaintext` **AWS CLI** **So generieren Sie ein asymmetrisches Datenschlüsselpaar vom Typ ECC NIST P384** Im folgenden `generate-data-key-pair-without-plaintext` Beispiel wird ein ECC NIST P384-Schlüsselpaar zur Verwendung außerhalb von angefordert. AWS Der Befehl gibt einen öffentlichen Klartextschlüssel und eine mit dem angegebenen KMS-Schlüssel verschlüsselte Kopie des privaten Schlüssels zurück. Er gibt keinen privaten Klartextschlüssel zurück. Sie können den verschlüsselten privaten Schlüssel sicher zusammen mit den verschlüsselten Daten speichern und AWS KMS aufrufen, um den privaten Schlüssel zu entschlüsseln, wenn Sie ihn benötigen. Um ein asymmetrisches Datenschlüsselpaar vom Typ ECC NIST P384 anzufordern, verwenden Sie den Parameter `key-pair-spec` mit dem Wert `ECC_NIST_P384`. Bei dem von Ihnen angegebenen KMS-Schlüssel muss es sich um einen KMS-Schlüssel mit symmetrischer Verschlüsselung handeln, d. h. um einen KMS-Schlüssel mit einem `KeySpec`-Wert von `SYMMETRIC_DEFAULT`. HINWEIS: Die Werte in der Ausgabe dieses Beispiels sind zur Anzeige gekürzt. ``` aws kms generate-data-key-pair-without-plaintext \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --key-pair-spec ECC_NIST_P384 ``` Ausgabe: ``` { "PrivateKeyCiphertextBlob": "AQIDAHi6LtupRpdKl2aJTzkK6FbhOtQkMlQJJH3PdtHvS/y+hAFFxmiD134doUDzMGmfCEtcAAAHaTCCB2UGCSqGSIb3DQEHBqCCB1...", "PublicKey": "MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEA3A3eGMyPrvSn7+LdlJE1oUoQV5HpEuHAVbdOyND+NmYDH/mL1OSIEuLrcdZ5hrMH4pk83r40l...", "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "KeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6", "KeyPairSpec": "ECC_NIST_P384" } ``` `PublicKey` und `PrivateKeyCiphertextBlob` werden im Base64-kodierten Format zurückgegeben. Weitere Informationen finden Sie unter [Datenschlüsselpaare](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-key-pairs) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [GenerateDataKeyPairWithoutPlaintext](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/generate-data-key-pair-without-plaintext.html)in der *AWS CLI Befehlsreferenz.* ### `generate-data-key-pair` Das folgende Codebeispiel zeigt die Verwendung`generate-data-key-pair`. **AWS CLI** **So generieren Sie ein asymmetrisches RSA-Datenschlüsselpaar mit 2 048 Bit** Im folgenden `generate-data-key-pair` Beispiel wird ein asymmetrisches 2048-Bit-RSA-Datenschlüsselpaar zur Verwendung außerhalb von angefordert. AWS Der Befehl gibt einen öffentlichen und einen privaten Klartextschlüssel zur sofortigen Verwendung und Löschung sowie eine Kopie des privaten Schlüssels zurück, die unter dem angegebenen KMS-Schlüssel verschlüsselt ist. Sie können den verschlüsselten Privatschlüssel sicher mit den verschlüsselten Daten speichern. Um ein asymmetrisches RSA-Datenschlüsselpaar mit 2 048 Bit anzufordern, verwenden Sie den Parameter `key-pair-spec` mit dem Wert `RSA_2048`. Bei dem von Ihnen angegebenen KMS-Schlüssel muss es sich um einen KMS-Schlüssel mit symmetrischer Verschlüsselung handeln, d. h. um einen KMS-Schlüssel mit einem `KeySpec`-Wert von `SYMMETRIC_DEFAULT`. HINWEIS: Die Werte in der Ausgabe dieses Beispiels sind zur Anzeige gekürzt. ``` aws kms generate-data-key-pair \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --key-pair-spec RSA_2048 ``` Ausgabe: ``` { "PrivateKeyCiphertextBlob": "AQIDAHi6LtupRpdKl2aJTzkK6FbhOtQkMlQJJH3PdtHvS/y+hAFFxmiD134doUDzMGmfCEtcAAAHaTCCB2UGCSqGSIb3DQEHBqCCB1...", "PrivateKeyPlaintext": "MIIG/QIBADANBgkqhkiG9w0BAQEFAASCBucwggbjAgEAAoIBgQDcDd4YzI+u9Kfv4t2UkTWhShBXkekS4cBVt07I0P42ZgMf+YvU5IgS4ut...", "PublicKey": "MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEA3A3eGMyPrvSn7+LdlJE1oUoQV5HpEuHAVbdOyND+NmYDH/mL1OSIEuLrcdZ5hrMH4pk83r40l...", "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "KeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6" "KeyPairSpec": "RSA_2048" } ``` `PublicKey`, `PrivateKeyPlaintext` und `PrivateKeyCiphertextBlob` werden im Base64-kodierten Format zurückgegeben. Weitere Informationen finden Sie unter [Datenschlüsselpaare](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-key-pairs) im *Entwicklerhandbuch für AWS Key Management Service*. + *Einzelheiten zur API finden Sie unter [GenerateDataKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/generate-data-key-pair.html)Befehlsreferenz.AWS CLI * ### `generate-data-key-without-plaintext` Das folgende Codebeispiel zeigt die Verwendung`generate-data-key-without-plaintext`. **AWS CLI** **So generieren Sie einen symmetrischen 256-Bit-Datenschlüssel ohne Klartextschlüssel** Im folgenden Beispiel für `generate-data-key-without-plaintext` wird ein symmetrisches RSA-Datenschlüsselpaar mit 256 Bit zur Verwendung außerhalb von AWS angefordert. Sie können AWS KMS aufrufen, um den Datenschlüssel zu entschlüsseln, wenn Sie bereit sind, ihn zu verwenden. Um einen 256-Bit-Datenschlüssel anzufordern, verwenden Sie den Parameter `key-spec` mit dem Wert `AES_256`. Um einen 128-Bit-Datenschlüssel anzufordern, verwenden Sie den Parameter `key-spec` mit dem Wert `AES_128`. Verwenden Sie für alle anderen Datenschlüssellängen den Parameter `number-of-bytes`. Bei dem von Ihnen angegebenen KMS-Schlüssel muss es sich um einen KMS-Schlüssel mit symmetrischer Verschlüsselung handeln, d. h. um einen KMS-Schlüssel mit KeySpec-Wert von SYMMETRIC\$1DEFAULT. ``` aws kms generate-data-key-without-plaintext \ --key-id "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" \ --key-spec AES_256 ``` Ausgabe: ``` { "CiphertextBlob": "AQEDAHjRYf5WytIc0C857tFSnBaPn2F8DgfmThbJlGfR8P3WlwAAAH4wfAYJKoZIhvcNAQcGoG8wbQIBADBoBgkqhkiG9w0BBwEwHgYJYIZIAWUDBAEuMBEEDEFogL", "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "KeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6" } ``` Der `CiphertextBlob` (verschlüsselte Datenschlüssel) wird im Base64-codierten Format zurückgegeben. Weitere Informationen finden Sie unter [Datenschlüssel](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [GenerateDataKeyWithoutPlaintext](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/generate-data-key-without-plaintext.html)in der *AWS CLI Befehlsreferenz.* ### `generate-data-key` Das folgende Codebeispiel zeigt die Verwendung`generate-data-key`. **AWS CLI** **Beispiel 1: So generieren Sie einen symmetrischen 256-Bit-Datenschlüssel** Im folgenden `generate-data-key` Beispiel wird ein symmetrischer 256-Bit-Datenschlüssel zur Verwendung außerhalb von angefordert. AWS Der Befehl gibt einen Klartextdatenschlüssel zur sofortigen Verwendung und Löschung sowie eine Kopie dieses Datenschlüssels zurück, die unter dem angegebenen KMS-Schlüssel verschlüsselt ist. Sie können den verschlüsselten Datenschlüssel sicher neben den verschlüsselten Daten speichern. Um einen 256-Bit-Datenschlüssel anzufordern, verwenden Sie den Parameter `key-spec` mit dem Wert `AES_256`. Um einen 128-Bit-Datenschlüssel anzufordern, verwenden Sie den Parameter `key-spec` mit dem Wert `AES_128`. Verwenden Sie für alle anderen Datenschlüssellängen den Parameter `number-of-bytes`. Bei dem von Ihnen angegebenen KMS-Schlüssel muss es sich um einen KMS-Schlüssel mit symmetrischer Verschlüsselung handeln, d. h. um einen KMS-Schlüssel mit KeySpec-Wert von SYMMETRIC\$1DEFAULT. ``` aws kms generate-data-key \ --key-id alias/ExampleAlias \ --key-spec AES_256 ``` Ausgabe: ``` { "Plaintext": "VdzKNHGzUAzJeRBVY+uUmofUGGiDzyB3+i9fVkh3piw=", "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "KeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6", "CiphertextBlob": "AQEDAHjRYf5WytIc0C857tFSnBaPn2F8DgfmThbJlGfR8P3WlwAAAH4wfAYJKoZIhvcNAQcGoG8wbQIBADBoBgkqhkiG9w0BBwEwHgYJYIZIAWUDBAEuMBEEDEFogLqPWZconQhwHAIBEIA7d9AC7GeJJM34njQvg4Wf1d5sw0NIo1MrBqZa+YdhV8MrkBQPeac0ReRVNDt9qleAt+SHgIRF8P0H+7U=" } ``` Der `Plaintext` (Klartextdatenschlüssel) und der `CiphertextBlob` (verschlüsselte Datenschlüssel) werden im Base64-codierten Format zurückgegeben. Weitere Informationen finden Sie unter [Datenschlüssel](https://docs.aws.amazon.com/kms/latest/developerguide/data-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. **Beispiel 2: So generieren Sie einen symmetrischen 512-Bit-Datenschlüssel** Im folgenden Beispiel für `generate-data-key` wird ein symmetrischer 512-Bit-Datenschlüssel für Ver- und Entschlüsselung angefordert. Der Befehl gibt einen Klartextdatenschlüssel zur sofortigen Verwendung und Löschung sowie eine Kopie dieses Datenschlüssels zurück, die unter dem angegebenen KMS-Schlüssel verschlüsselt ist. Sie können den verschlüsselten Datenschlüssel sicher neben den verschlüsselten Daten speichern. Verwenden Sie den Parameter `number-of-bytes`, um eine andere Schlüssellänge als 128 oder 256 Bit anzufordern. Um einen 512-Bit-Datenschlüssel anzufordern, verwendet das folgende Beispiel den Parameter `number-of-bytes` mit einem Wert von 64 (Byte). Bei dem von Ihnen angegebenen KMS-Schlüssel muss es sich um einen KMS-Schlüssel mit symmetrischer Verschlüsselung handeln, d. h. um einen KMS-Schlüssel mit KeySpec-Wert von SYMMETRIC\$1DEFAULT. HINWEIS: Die Werte in der Ausgabe dieses Beispiels sind zur Anzeige gekürzt. ``` aws kms generate-data-key \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --number-of-bytes 64 ``` Ausgabe: ``` { "CiphertextBlob": "AQIBAHi6LtupRpdKl2aJTzkK6FbhOtQkMlQJJH3PdtHvS/y+hAEnX/QQNmMwDfg2korNMEc8AAACaDCCAmQGCSqGSIb3DQEHBqCCAlUwggJRAgEAMIICSgYJKoZ...", "Plaintext": "ty8Lr0Bk6OF07M2BWt6qbFdNB+G00ZLtf5MSEb4al3R2UKWGOp06njAwy2n72VRm2m7z/Pm9Wpbvttz6a4lSo9hgPvKhZ5y6RTm4OovEXiVfBveyX3DQxDzRSwbKDPk/...", "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "KeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6" } ``` Der `Plaintext` (Klartextdatenschlüssel) und der `CiphertextBlob` (verschlüsselte Datenschlüssel) werden im Base64-codierten Format zurückgegeben. Weitere Informationen finden Sie unter [Datenschlüssel](https://docs.aws.amazon.com/kms/latest/developerguide/data-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [GenerateDataKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/generate-data-key.html).AWS CLI * ### `generate-mac` Das folgende Codebeispiel zeigt die Verwendung`generate-mac`. **AWS CLI** **Beispiel 1: So generieren Sie einen HMAC für eine Nachricht** Der folgende Befehl `generate-mac` generiert einen HMAC für eine Nachricht, einen HMAC-KMS-Schlüssel und einen MAC-Algorithmus. Der Algorithmus muss vom angegebenen HMAC-KMS-Schlüssel unterstützt werden. In AWS CLI v2 muss der Wert des `message` Parameters Base64-codiert sein. Oder Sie können die Nachricht in einer Datei speichern und das `fileb://` Präfix verwenden, das die AWS CLI anweist, Binärdaten aus der Datei zu lesen. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem AWS Konto. Die Schlüssel-ID muss einen HMAC-KMS-Schlüssel mit der Schlüsselverwendung von `GENERATE_VERIFY_MAC` darstellen. ``` msg=(echo 'Hello World' | base64) aws kms generate-mac \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --message fileb://Message \ --mac-algorithm HMAC_SHA_384 ``` Ausgabe: ``` { "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "Mac": "", "MacAlgorithm": "HMAC_SHA_384" } ``` Weitere Informationen zur Verwendung von HMAC-KMS-Schlüsseln in AWS KMS finden Sie unter [HMAC-Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/hmac.html) im *AWS Key Management Service Developer Guide*. **Beispiel 2: So speichern Sie einen HMAC in einer Datei (Linux und macOs)** Im folgenden Beispiel für `generate-mac` wird ein HMAC für eine Kurznachricht generiert, die in einer lokalen Datei gespeichert ist. Der Befehl ruft auch die `Mac` Eigenschaft aus der Antwort ab, dekodiert sie mit Base64 und speichert sie in der Datei. ExampleMac Sie können die MAC-Datei in einem `verify-mac`-Befehl verwenden, der den MAC verifiziert. Der Befehl `generate-mac` erfordert eine Base64-codierte Nachricht und einen MAC-Algorithmus, den Ihr HMAC-KMS-Schlüssel unterstützt. Verwenden Sie den Befehl `describe-key`, um die MAC-Algorithmen abzurufen, die Ihr KMS-Schlüssel unterstützt. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem Konto. AWS Die Schlüssel-ID muss einen asymmetrischen KMS-Schlüssel mit der Schlüsselverwendung GENERATE\$1VERIFY\$1MAC darstellen. ``` echo 'hello world' | base64 > EncodedMessage aws kms generate-mac \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --message fileb://EncodedMessage \ --mac-algorithm HMAC_SHA_384 \ --output text \ --query Mac | base64 --decode > ExampleMac ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. In diesem Beispiel wird die Eigenschaft `Mac` der Ausgabe extrahiert und in einer Datei gespeichert. Weitere Informationen zur Verwendung von HMAC-KMS-Schlüsseln in AWS KMS finden Sie unter [HMAC-Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/hmac.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [GenerateMac](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/generate-mac.html)in der *AWS CLI Befehlsreferenz*. ### `generate-random` Das folgende Codebeispiel zeigt die Verwendung`generate-random`. **AWS CLI** **Beispiel 1: So generieren Sie eine 256-Bit-Zufallsbytezeichenfolge (Linux oder macOs)** Im folgenden Beispiel für `generate-random` wird eine Base64-kodierte 256-Bit-Zufallsbytezeichenfolge (32 Byte) generiert. Im Beispiel wird die Bytezeichenfolge dekodiert und in der Zufallsdatei gespeichert. Wenn Sie diesen Befehl ausführen, müssen Sie den Parameter `number-of-bytes` verwenden, um die Länge des Zufallswerts in Byte anzugeben. Sie geben keinen KMS-Schlüssel an, wenn Sie diesen Befehl ausführen. Die Zufallsbytezeichenfolge steht in keinem Zusammenhang mit einem KMS-Schlüssel. Standardmäßig generiert AWS KMS die Zufallszahl. Wenn Sie jedoch einen [benutzerdefinierten Schlüsselspeicher](https://docs.aws.amazon.com/kms/latest/developerguide/custom-key-store-overview.html) angeben, wird die zufällige Bytezeichenfolge in dem AWS CloudHSM-Cluster generiert, der dem benutzerdefinierten Schlüsselspeicher zugeordnet ist. Im folgenden Beispiel werden die folgenden Parameter und Werte verwendet: Es verwendet den erforderlichen `--number-of-bytes` Parameter mit dem Wert von, `32` um eine 32-Byte-Zeichenfolge (256-Bit) anzufordern.Es verwendet den `--output` Parameter mit dem Wert von, `text` um die AWS CLI anzuweisen, die Ausgabe als Text und nicht als JSON zurückzugeben.Es verwendet den, um den Wert der `Plaintext` Eigenschaft aus der Antwort `--query parameter` zu extrahieren.Es leitet (\$1) die Ausgabe des Befehls an das `base64` Hilfsprogramm weiter, das die extrahierte Ausgabe dekodiert. Es verwendet den Umleitungsoperator (>), um die dekodierte Bytezeichenfolge zu speichern File.it verwendet den Umleitungsoperator (>) `ExampleRandom` um den binären Chiffretext in einer Datei zu speichern. ``` aws kms generate-random \ --number-of-bytes 32 \ --output text \ --query Plaintext | base64 --decode > ExampleRandom ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [GenerateRandom](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateRandom.html)in der *API-Referenz für den AWS Key Management Service*. **Beispiel 2: So generieren Sie eine 256-Bit-Zufallszahl zu generieren (Windows-Befehlszeile)** Im folgenden Beispiel wird der Befehl `generate-random` verwendet, um eine Base64-kodierte 256-Bit-Zufallsbytezeichenfolge (32 Byte) zu generieren. Im Beispiel wird die Bytezeichenfolge dekodiert und in der Zufallsdatei gespeichert. Dieses Beispiel ist mit dem vorherigen Beispiel identisch, mit dem Unterschied, dass es das Dienstprogramm `certutil` in Windows verwendet, um die zufällige Bytefolge vor dem Speichern in einer Datei mit Base64 zu dekodieren. Generieren Sie zunächst eine Base64-kodierte Zufallsbytezeichenfolge und speichern Sie sie in einer temporären Datei, `ExampleRandom.base64`. ``` aws kms generate-random \ --number-of-bytes 32 \ --output text \ --query Plaintext > ExampleRandom.base64 ``` Da die Ausgabe des Befehls `generate-random` in einer Datei gespeichert wird, erzeugt dieses Beispiel keine Ausgabe. Verwenden Sie nun den Befehl `certutil -decode`, um die Base64-kodierte Bytezeichenfolge in der Datei `ExampleRandom.base64` zu dekodieren. Anschließend wird die dekodierte Bytezeichenfolge in der Datei `ExampleRandom` gespeichert. ``` certutil -decode ExampleRandom.base64 ExampleRandom ``` Ausgabe: ``` Input Length = 18 Output Length = 12 CertUtil: -decode command completed successfully. ``` Weitere Informationen finden Sie [GenerateRandom](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateRandom.html)in der *API-Referenz für den AWS Key Management Service*. + Einzelheiten zur API finden Sie [GenerateRandom](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/generate-random.html)unter *AWS CLI Befehlsreferenz*. ### `get-key-policy` Das folgende Codebeispiel zeigt die Verwendung`get-key-policy`. **AWS CLI** **So kopieren Sie eine Schlüsselrichtlinie von einem KMS-Schlüssel in einen anderen** Im folgenden Beispiel für `get-key-policy` wird die Schlüsselrichtlinie von einem KMS-Schlüssel abgerufen und in einer Textdatei gespeichert. Anschließend wird die Richtlinie eines anderen KMS-Schlüssels ersetzt, wobei die Textdatei als Richtlinieneingabe verwendet wird. Da für den Parameter `--policy` von `put-key-policy` eine Zeichenfolge erforderlich ist, müssen Sie die Option `--output text` verwenden, um die Ausgabe als Textzeichenfolge statt als JSON zurückzugeben. ``` aws kms get-key-policy \ --policy-name default \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --query Policy \ --output text > policy.txt aws kms put-key-policy \ --policy-name default \ --key-id 0987dcba-09fe-87dc-65ba-ab0987654321 \ --policy file://policy.txt ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie [PutKeyPolicy](https://docs.aws.amazon.com/kms/latest/APIReference/API_PutKeyPolicy.html)in der *AWS KMS-API-Referenz*. + Einzelheiten zur API finden Sie [GetKeyPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/get-key-policy.html)unter *AWS CLI Befehlsreferenz*. ### `get-key-rotation-status` Das folgende Codebeispiel zeigt die Verwendung`get-key-rotation-status`. **AWS CLI** **So rufen Sie den Rotationsstatus für einen KMS-Schlüssel ab.** Im folgenden Beispiel für `get-key-rotation-status` werden Informationen zum Rotationsstatus des angegebenen KMS-Schlüssels zurückgegeben, einschließlich der Angabe, ob die automatische Rotation aktiviert ist, des Rotationszeitraums und des nächsten geplanten Rotationsdatums. Sie können diesen Befehl für vom Kunden verwaltete KMS-Schlüssel und AWS verwaltete KMS-Schlüssel verwenden. Alle AWS verwalteten KMS-Schlüssel werden jedoch jedes Jahr automatisch rotiert. ``` aws kms get-key-rotation-status \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyRotationEnabled": true, "NextRotationDate": "2024-02-14T18:14:33.587000+00:00", "RotationPeriodInDays": 365 } ``` Weitere Informationen finden Sie unter [Rotieren von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [GetKeyRotationStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/get-key-rotation-status.html)in der *AWS CLI Befehlsreferenz*. ### `get-parameters-for-import` Das folgende Codebeispiel zeigt die Verwendung`get-parameters-for-import`. **AWS CLI** **So rufen Sie die Elemente ab, die für den Import von Schlüsselmaterial in einen KMS-Schlüssel erforderlich sind** Im folgenden Beispiel für `get-parameters-for-import` werden der öffentliche Schlüssel und Import-Token abgerufen, die Sie zum Importieren von Schlüsselmaterial in einen KMS-Schlüssel benötigen. Achten Sie bei Verwendung des Befehls `import-key-material` darauf, dass Sie das Import-Token und das mit dem öffentlichen Schlüssel verschlüsselte Schlüsselmaterial verwenden, die im selben Befehl `get-parameters-for-import` zurückgegeben wurden. Außerdem muss es sich bei dem in diesem Befehl angegebenen Wrapping-Algorithmus um einen Algorithmus handeln, mit Sie das Schlüsselmaterial mit dem öffentlichen Schlüssel verschlüsseln. Verwenden Sie den Parameter `key-id`, um den KMS-Schlüssel anzugeben. In diesem Beispiel wird eine Schlüssel-ID verwendet, Sie können jedoch eine Schlüssel-ID oder einen Schlüssel-ARN in diesem Befehl verwenden. ``` aws kms get-parameters-for-import \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --wrapping-algorithm RSAES_OAEP_SHA_256 \ --wrapping-key-spec RSA_2048 ``` Ausgabe: ``` { "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "PublicKey": "", "ImportToken": "", "ParametersValidTo": 1593893322.32 } ``` Weitere Informationen finden Sie unter [Herunterladen des öffentlichen Schlüssels und Importieren des Tokens](https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys-get-public-key-and-token.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [GetParametersForImport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/get-parameters-for-import.html)in der *AWS CLI Befehlsreferenz*. ### `get-public-key` Das folgende Codebeispiel zeigt die Verwendung`get-public-key`. **AWS CLI** **Beispiel 1: So laden Sie den öffentlichen Schlüssel eines asymmetrischen KMS-Schlüssels herunter** Im folgenden Beispiel für `get-public-key` laden Sie den öffentlichen Schlüssel eines asymmetrischen KMS-Schlüssels herunter. Zusätzlich zur Rückgabe des öffentlichen Schlüssels enthält die Ausgabe Informationen, die Sie benötigen, um den öffentlichen Schlüssel sicher außerhalb von AWS KMS zu verwenden, einschließlich der Schlüsselverwendung und der unterstützten Verschlüsselungsalgorithmen. ``` aws kms get-public-key \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "PublicKey": "jANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAl5epvg1/QtJhxSi2g9SDEVg8QV/...", "CustomerMasterKeySpec": "RSA_4096", "KeyUsage": "ENCRYPT_DECRYPT", "EncryptionAlgorithms": [ "RSAES_OAEP_SHA_1", "RSAES_OAEP_SHA_256" ] } ``` Weitere Informationen zur Verwendung asymmetrischer KMS-Schlüssel in AWS KMS finden Sie unter [Asymmetrische Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im *AWS Key Management Service Developer Guide*. **Beispiel 2: So konvertieren Sie einen öffentlichen Schlüssel in das DER-Format (Linux und macOS)** Im folgenden Beispiel für `get-public-key` wird der öffentliche Schlüssel eines asymmetrischen KMS-Schlüssels heruntergeladen und in einer DER-Datei gespeichert. Wenn Sie den `get-public-key` Befehl in der AWS CLI verwenden, gibt er einen DER-codierten öffentlichen X.509-Schlüssel zurück, der Base64-kodiert ist. In diesem Beispiel wird der Wert der Eigenschaft `PublicKey` als Text abgerufen. `PublicKey` wird Base64-dekodiert und in der Datei `public_key.der` gespeichert. Der Parameter `output` gibt die Ausgabe als Text statt als JSON zurück. Der `--query` Parameter ruft nur die `PublicKey` Eigenschaft ab, nicht die Eigenschaften, die Sie benötigen, um den öffentlichen Schlüssel sicher außerhalb von KMS zu verwenden. AWS Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem AWS Konto. ``` aws kms get-public-key \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --output text \ --query PublicKey | base64 --decode > public_key.der ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen zur Verwendung asymmetrischer KMS-Schlüssel in AWS KMS finden Sie unter [Asymmetrische Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [GetPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/get-public-key.html)in der *AWS CLI Befehlsreferenz*. ### `import-key-material` Das folgende Codebeispiel zeigt die Verwendung`import-key-material`. **AWS CLI** **So importieren Sie Schlüsselmaterial in einen KMS-Schlüssel** Im folgenden Beispiel für `import-key-material` wird Schlüsselmaterial in einen KMS-Schlüssel hochgeladen, der ohne Schlüsselmaterial erstellt wurde. Der Schlüsselstatus des KMS-Schlüssels muss `PendingImport` lauten. Dieser Befehl verwendet Schlüsselmaterial, das Sie mit dem öffentlichen Schlüssel verschlüsselt haben, den der `get-parameters-for-import` Befehl zurückgegeben hat. Außerdem wird das Import-Token aus demselben Befehl `get-parameters-for-import` verwendet. Der Parameter `expiration-model` gibt an, dass das Schlüsselmaterial automatisch zu der durch den Parameter `valid-to` angegebenen Datums- und Uhrzeitangabe abläuft. Wenn das Schlüsselmaterial abläuft, löscht AWS KMS das Schlüsselmaterial, der Schlüsselstatus des KMS-Schlüssels ändert sich `Pending import` und der KMS-Schlüssel wird unbrauchbar. Um den Schlüssel wiederherzustellen, müssen Sie dasselbe Schlüsselmaterial erneut in den Schlüssel importieren. Um anderes Schlüsselmaterial zu verwenden, müssen Sie einen neuen KMS-Schlüssel erstellen. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID oder Schlüssel-ARN aus Ihrem AWS Konto. ``` aws kms import-key-material \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --encrypted-key-material fileb://EncryptedKeyMaterial.bin \ --import-token fileb://ImportToken.bin \ --expiration-model KEY_MATERIAL_EXPIRES \ --valid-to 2021-09-21T19:00:00Z ``` Ausgabe: ``` { "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "KeyMaterialId": "0b7fd7ddbac6eef27907413567cad8c810e2883dc8a7534067a82ee1142fc1e6" } ``` Weitere Informationen zum Importieren von Schlüsselmaterial finden Sie unter [Importieren von Schlüsselmaterial](https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [ImportKeyMaterial](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/import-key-material.html)in der *AWS CLI Befehlsreferenz*. ### `list-aliases` Das folgende Codebeispiel zeigt die Verwendung`list-aliases`. **AWS CLI** **Beispiel 1: Um alle Aliase in einem AWS Konto und einer Region aufzulisten** Im folgenden Beispiel wird der `list-aliases` Befehl verwendet, um alle Aliase in der Standardregion des AWS Kontos aufzulisten. Die Ausgabe umfasst Aliase, die AWS verwalteten KMS-Schlüsseln und kundenverwalteten KMS-Schlüsseln zugeordnet sind. ``` aws kms list-aliases ``` Ausgabe: ``` { "Aliases": [ { "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/testKey", "AliasName": "alias/testKey", "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" }, { "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/FinanceDept", "AliasName": "alias/FinanceDept", "TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321" }, { "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/aws/dynamodb", "AliasName": "alias/aws/dynamodb", "TargetKeyId": "1a2b3c4d-5e6f-1a2b-3c4d-5e6f1a2b3c4d" }, { "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/aws/ebs", "AliasName": "alias/aws/ebs", "TargetKeyId": "0987ab65-43cd-21ef-09ab-87654321cdef" }, ... ] } ``` **Beispiel 2: So listen Sie alle Aliasnamen für einen bestimmten KMS-Schlüssel auf** Im folgenden Beispiel werden der Befehl `list-aliases` und sein Parameter `key-id` verwendet, um alle Aliasname aufzulisten, die einem bestimmten KMS-Schlüssel zugeordnet sind. Jeder Alias ist nur mit einem KMS-Schlüssel verbunden, ein KMS-Schlüssel kann jedoch über mehrere Aliasse verfügen. Dieser Befehl ist sehr nützlich, da die AWS KMS-Konsole nur einen Alias für jeden KMS-Schlüssel auflistet. Um alle Aliasnamen für einen KMS-Schlüssel zu suchen, müssen Sie den Befehl `list-aliases` verwenden. In diesem Beispiel wird die Schlüssel-ID des KMS-Schlüssels für den Parameter `--key-id` verwendet. Sie können in diesem Befehl jedoch eine Schlüssel-ID, einen Schlüssel-ARN, einen Aliasnamen oder einen Alias-ARN verwenden. ``` aws kms list-aliases --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "Aliases": [ { "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/oregon-test-key", "AliasName": "alias/oregon-test-key" }, { "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/project121-test", "AliasName": "alias/project121-test" } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Aliasnamen](https://docs.aws.amazon.com/kms/latest/developerguide/programming-aliases.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [ListAliases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/list-aliases.html)in der *AWS CLI Befehlsreferenz*. ### `list-grants` Das folgende Codebeispiel zeigt die Verwendung`list-grants`. **AWS CLI** **Um die Grants für einen AWS KMS-Schlüssel anzuzeigen** Im folgenden `list-grants` Beispiel werden alle Grants für den angegebenen AWS verwalteten KMS-Schlüssel für Amazon DynamoDB in Ihrem Konto angezeigt. Diese Erteilung ermöglicht es DynamoDB, den KMS-Schlüssel in Ihrem Namen zu verwenden, um eine DynamoDB-Tabelle zu verschlüsseln, bevor sie auf die Festplatte geschrieben wird. Sie können einen Befehl wie diesen verwenden, um die Zuschüsse für die AWS verwalteten KMS-Schlüssel und die vom Kunden verwalteten KMS-Schlüssel für das AWS Konto und die Region anzuzeigen. Dieser Befehl verwendet den Parameter `key-id` mit einer Schlüssel-ID, um den KMS-Schlüssel zu identifizieren. Sie können den KMS-Schlüssel mit einer Schlüssel-ID oder einem Schlüssel-ARN identifizieren. Verwenden Sie den `list-aliases` Befehl or, um die Schlüssel-ID oder den Schlüssel-ARN eines AWS verwalteten KMS-Schlüssels abzurufen. `list-keys` ``` aws kms list-grants \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Die Ausgabe zeigt, dass Amazon DynamoDB durch die Erteilung dazu berechtigt ist, den KMS-Schlüssel für kryptografische Vorgänge zu verwenden und Details zum KMS-Schlüssel (`DescribeKey`) anzuzeigen und Erteilungen (`RetireGrant`) zurückzuziehen. Die Einschränkung `EncryptionContextSubset` beschränkt diese Berechtigung auf Anforderungen, die die angegebenen Verschlüsselungskontextpaare enthalten. Daher sind die Berechtigungen in der Erteilung nur für das angegebene Konto und die angegebene DynamoDB-Tabelle wirksam. ``` { "Grants": [ { "Constraints": { "EncryptionContextSubset": { "aws:dynamodb:subscriberId": "123456789012", "aws:dynamodb:tableName": "Services" } }, "IssuingAccount": "arn:aws:iam::123456789012:root", "Name": "8276b9a6-6cf0-46f1-b2f0-7993a7f8c89a", "Operations": [ "Decrypt", "Encrypt", "GenerateDataKey", "ReEncryptFrom", "ReEncryptTo", "RetireGrant", "DescribeKey" ], "GrantId": "1667b97d27cf748cf05b487217dd4179526c949d14fb3903858e25193253fe59", "KeyId": "arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab", "RetiringPrincipal": "dynamodb.us-west-2.amazonaws.com", "GranteePrincipal": "dynamodb.us-west-2.amazonaws.com", "CreationDate": "2021-05-13T18:32:45.144000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Grants in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [ListGrants](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/list-grants.html)in der *AWS CLI Befehlsreferenz*. ### `list-key-policies` Das folgende Codebeispiel zeigt die Verwendung`list-key-policies`. **AWS CLI** **So rufen Sie die Namen von Schlüsselrichtlinien für einen KMS-Schlüssel ab** Im folgenden Beispiel für `list-key-policies` werden die Namen der Schlüsselrichtlinien für einen kundenseitig verwalteten Schlüssel im Beispielkonto und in der Beispielregion abgerufen. Sie können diesen Befehl verwenden, um die Namen der wichtigsten Richtlinien für AWS verwaltete Schlüssel und vom Kunden verwaltete Schlüssel zu finden. Da der einzige gültige Name der Schlüsselrichtlinie `default` lautet, ist dieser Befehl nicht hilfreich. Verwenden Sie den Parameter `key-id`, um den KMS-Schlüssel anzugeben. In diesem Beispiel wird ein Schlüssel-ID-Wert verwendet, Sie können jedoch eine Schlüssel-ID oder einen Schlüssel-ARN in diesem Befehl verwenden. ``` aws kms list-key-policies \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "PolicyNames": [ "default" ] } ``` Weitere Informationen zu AWS KMS-Schlüsselrichtlinien finden Sie unter [Verwenden von Schlüsselrichtlinien in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [ListKeyPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/list-key-policies.html)in der *AWS CLI Befehlsreferenz*. ### `list-key-rotations` Das folgende Codebeispiel zeigt die Verwendung`list-key-rotations`. **AWS CLI** **So rufen Sie Informationen zu allen abgeschlossenen Rotationen von Schlüsselmaterialen ab** Im folgenden Beispiel für `list-key-rotations` werden Informationen zu allen abgeschlossenen Rotationen von Schlüsselmaterialien für den angegebenen KMS-Schlüssel aufgeführt. ``` aws kms list-key-rotations \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "Rotations": [ { "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "RotationDate": "2024-03-02T10:11:36.564000+00:00", "RotationType": "AUTOMATIC" }, { "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "RotationDate": "2024-04-05T15:14:47.757000+00:00", "RotationType": "ON_DEMAND" } ], "Truncated": false } ``` Weitere Informationen finden Sie unter [Rotieren von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [ListKeyRotations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/list-key-rotations.html)in der *AWS CLI Befehlsreferenz*. ### `list-keys` Das folgende Codebeispiel zeigt die Verwendung`list-keys`. **AWS CLI** **So rufen Sie die KMS-Schlüssel für ein Konto und eine Region ab** Im folgenden Beispiel für `list-keys` werden die KMS-Schlüssel für ein Konto und eine Region abgerufen. Dieser Befehl gibt sowohl AWS verwaltete Schlüssel als auch vom Kunden verwaltete Schlüssel zurück. ``` aws kms list-keys ``` Ausgabe: ``` { "Keys": [ { "KeyArn": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" }, { "KeyArn": "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321", "KeyId": "0987dcba-09fe-87dc-65ba-ab0987654321" }, { "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/1a2b3c4d-5e6f-1a2b-3c4d-5e6f1a2b3c4d", "KeyId": "1a2b3c4d-5e6f-1a2b-3c4d-5e6f1a2b3c4d" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/viewing-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [ListKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/list-keys.html)in der *AWS CLI Befehlsreferenz*. ### `list-resource-tags` Das folgende Codebeispiel zeigt die Verwendung`list-resource-tags`. **AWS CLI** **So rufen Sie die Tags eines KMS-Schlüssels ab** Im folgenden Beispiel für `list-resource-tags` werden die Tags für einen KMS-Schlüssel abgerufen. Verwenden Sie den Befehl `tag-resource`, um Ressourcen-Tags zu KMS-Schlüsseln hinzuzufügen oder zu ersetzen. Die Ausgabe zeigt, dass dieser KMS-Schlüssel über zwei Ressourcentags mit jeweils einem Schlüssel und einem Wert verfügt. Verwenden Sie den Parameter `key-id`, um den KMS-Schlüssel anzugeben. In diesem Beispiel wird ein Schlüssel-ID-Wert verwendet, Sie können jedoch eine Schlüssel-ID oder einen Schlüssel-ARN in diesem Befehl verwenden. ``` aws kms list-resource-tags \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "Tags": [ { "TagKey": "Dept", "TagValue": "IT" }, { "TagKey": "Purpose", "TagValue": "Test" } ], "Truncated": false } ``` Weitere Informationen zur Verwendung von Tags in AWS KMS finden Sie unter [Tagging Keys](https://docs.aws.amazon.com/kms/latest/developerguide/tagging-keys.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [ListResourceTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/list-resource-tags.html)in der *AWS CLI Befehlsreferenz.* ### `list-retirable-grants` Das folgende Codebeispiel zeigt die Verwendung`list-retirable-grants`. **AWS CLI** **So zeigen Sie die Erteilungen an, die ein Prinzipal zurückziehen kann** Im folgenden `list-retirable-grants` Beispiel werden alle Berechtigungen angezeigt, die der `ExampleAdmin` Benutzer für die KMS-Schlüssel in einem AWS Konto und einer Region zurückziehen kann. Sie können einen Befehl wie diesen verwenden, um die Zuweisungen anzuzeigen, die jeder Kontoinhaber für KMS-Schlüssel im AWS Konto und in der Region zurückziehen kann. Der Wert des erforderlichen Parameters `retiring-principal` muss der Amazon-Ressourcenname (ARN) eines Kontos, eines Benutzers oder einer Rolle sein. Sie können in diesem Befehl keinen Service für den Wert `retiring-principal` angeben, auch wenn ein Service der zurückziehende Prinzipal sein kann. Verwenden Sie den Befehl `list-grants`, um die Erteilungen zu ermitteln, in denen ein bestimmter Service der zurückziehende Prinzipal ist. Die Ausgabe zeigt, dass der Benutzer `ExampleAdmin` berechtigt ist, Erteilungen für zwei verschiedene KMS-Schlüssel im Konto und in der Region zurückzuziehen. Zusätzlich zum zurückziehenden Prinzipal ist das Konto berechtigt, jede Erteilung im Konto zurückzuziehen. ``` aws kms list-retirable-grants \ --retiring-principal arn:aws:iam::111122223333:user/ExampleAdmin ``` Ausgabe: ``` { "Grants": [ { "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "GrantId": "156b69c63cb154aa21f59929ff19760717be8d9d82b99df53e18b94a15a5e88e", "Name": "", "CreationDate": 2021-01-14T20:17:36.419000+00:00, "GranteePrincipal": "arn:aws:iam::111122223333:user/ExampleUser", "RetiringPrincipal": "arn:aws:iam::111122223333:user/ExampleAdmin", "IssuingAccount": "arn:aws:iam::111122223333:root", "Operations": [ "Encrypt" ], "Constraints": { "EncryptionContextSubset": { "Department": "IT" } } }, { "KeyId": "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321", "GrantId": "8c94d1f12f5e69f440bae30eaec9570bb1fb7358824f9ddfa1aa5a0dab1a59b2", "Name": "", "CreationDate": "2021-02-02T19:49:49.638000+00:00", "GranteePrincipal": "arn:aws:iam::111122223333:role/ExampleRole", "RetiringPrincipal": "arn:aws:iam::111122223333:user/ExampleAdmin", "IssuingAccount": "arn:aws:iam::111122223333:root", "Operations": [ "Decrypt" ], "Constraints": { "EncryptionContextSubset": { "Department": "IT" } } } ], "Truncated": false } ``` Weitere Informationen finden Sie unter [Grants in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [ListRetirableGrants](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/list-retirable-grants.html)in der *AWS CLI Befehlsreferenz*. ### `put-key-policy` Das folgende Codebeispiel zeigt die Verwendung`put-key-policy`. **AWS CLI** **So ändern Sie die Schlüsselrichtlinie für einen KMS-Schlüssel** Im folgenden Beispiel für `put-key-policy` wird die Schlüsselrichtlinie für einen kundenseitig verwalteten Schlüssel geändert. Erstellen Sie zunächst eine Schlüsselrichtlinie und speichern Sie sie in einer lokalen JSON-Datei. In diesem Beispiel handelt es sich um die Datei `key_policy.json`. Sie können die Schlüsselrichtlinie auch als Zeichenfolgenwert des Parameters `policy` angeben. Die erste Anweisung in dieser Schlüsselrichtlinie erteilt dem AWS Konto die Erlaubnis, IAM-Richtlinien zur Steuerung des Zugriffs auf den KMS-Schlüssel zu verwenden. Die zweite Anweisung erteilt dem Benutzer `test-user` die Berechtigung, die Befehle `describe-key` und `list-keys` auf dem KMS-Schlüssel auszuführen. Inhalt von `key_policy.json`: ``` { "Version":"2012-10-17", "Id" : "key-default-1", "Statement" : [ { "Sid" : "Enable IAM User Permissions", "Effect" : "Allow", "Principal" : { "AWS" : "arn:aws:iam::111122223333:root" }, "Action" : "kms:*", "Resource" : "*" }, { "Sid" : "Allow Use of Key", "Effect" : "Allow", "Principal" : { "AWS" : "arn:aws:iam::111122223333:user/test-user" }, "Action" : [ "kms:DescribeKey", "kms:ListKeys" ], "Resource" : "*" } ] } ``` In diesem Beispiel wird der KMS-Schlüssel mit der Schlüssel-ID identifiziert, Sie können jedoch auch einen Schlüssel-ARN verwenden. Der Befehl verwendet den Parameter `policy`, um die Schlüsselrichtlinie festzulegen. Um anzugeben, dass sich die Richtlinie in einer Datei befindet, wird das erforderliche Präfix `file://` verwendet. Dieses Präfix ist erforderlich, um Dateien auf allen unterstützten Betriebssystemen zu identifizieren. Schließlich verwendet der Befehl den Parameter `policy-name` mit dem Wert `default`. Wenn kein Richtlinienwert angegeben wird, lautet der Standardwert `default`. Der einzige gültige Wert ist `default`. ``` aws kms put-key-policy \ --policy-name default \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --policy file://key_policy.json ``` Dieser Befehl erzeugt keine Ausgabe. Verwenden Sie den Befehl `get-key-policy`, um zu überprüfen, ob der Befehl wirksam war. Mit dem folgenden Beispielbefehl wird die Schlüsselrichtlinie für denselben KMS-Schlüssel abgerufen. Der Parameter `output` mit dem Wert `text` gibt ein leicht lesbares Textformat zurück. ``` aws kms get-key-policy \ --policy-name default \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --output text ``` Ausgabe: ``` { "Version":"2012-10-17", "Id" : "key-default-1", "Statement" : [ { "Sid" : "Enable IAM User Permissions", "Effect" : "Allow", "Principal" : { "AWS" : "arn:aws:iam::111122223333:root" }, "Action" : "kms:*", "Resource" : "*" }, { "Sid" : "Allow Use of Key", "Effect" : "Allow", "Principal" : { "AWS" : "arn:aws:iam::111122223333:user/test-user" }, "Action" : [ "kms:Describe", "kms:List" ], "Resource" : "*" } ] } ``` Weitere Informationen finden Sie unter [Ändern einer Schlüsselrichtlinie](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [PutKeyPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/put-key-policy.html)in der *AWS CLI Befehlsreferenz.* ### `re-encrypt` Das folgende Codebeispiel zeigt die Verwendung`re-encrypt`. **AWS CLI** **Beispiel 1: So verschlüsseln Sie eine verschlüsselte Nachricht unter einem symmetrischen KMS-Schlüssel (Linux und macOS) erneut).** Das folgende `re-encrypt` Befehlsbeispiel zeigt die empfohlene Methode zum erneuten Verschlüsseln von Daten mit der AWS CLI. Geben Sie den Geheimtext in einer Datei an. Verwenden Sie im Wert des `--ciphertext-blob`-Parameters das `fileb://`-Präfix, das die CLI anweist, die Daten aus einer Binärdatei zu lesen. Wenn sich die Datei nicht im aktuellen Verzeichnis befindet, geben Sie den vollständigen Dateipfad ein. Weitere Informationen zum Lesen von AWS CLI-Parameterwerten aus einer Datei finden Sie unter [Laden von AWS CLI-Parametern aus einer Datei](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle* und [Best Practices für lokale Dateiparameter](https://aws.amazon.com/blogs/developer/best-practices-for-local-file-parameters/) im *AWS Command Line Tool-Blog*. Geben Sie den KMS-Quellschlüssel an, der den Chiffretext entschlüsselt. Der `--source-key-id` Parameter ist bei der Entschlüsselung mit symmetrischer Verschlüsselung von KMS-Schlüsseln nicht erforderlich. AWS KMS kann den KMS-Schlüssel, der zur Verschlüsselung der Daten verwendet wurde, aus den Metadaten im Chiffretext-Blob abrufen. Es ist jedoch immer eine bewährte Methode, den von Ihnen verwendeten KMS-Schlüssel anzugeben. Diese Methode stellt sicher, dass Sie den beabsichtigten KMS-Schlüssel verwenden, und verhindert, dass Sie versehentlich einen Geheimtext mit einem KMS-Schlüssel entschlüsseln, dem Sie nicht vertrauen. Geben Sie den KMS-Schlüssel an, der die Daten erneut verschlüsselt. Der Parameter `--destination-key-id` ist immer erforderlich. In diesem Beispiel wird ein Schlüssel-ARN verwendet, Sie können jedoch jede gültige Schlüsselkennung verwenden. Fordern Sie die Klartextausgabe als Textwert an. Der Parameter `--query` weist die CLI an, nur den Wert des Feldes `Plaintext` aus der Ausgabe abzurufen. Der Parameter `--output` gibt die Ausgabe als Text zurück. Base64-dekodieren Sie den Klartext und speichern Sie ihn in einer Datei. Im folgenden Beispiel wird der Wert des Parameters `Plaintext` über eine Pipe (\$1) an das Base64-Dienstprogramm weitergeleitet, das ihn dekodiert. Anschließend erfolgt eine Umleitung (>) der dekodierten Ausgabe in die Datei `ExamplePlaintext`. Bevor Sie diesen Befehl ausführen, ersetzen Sie den Beispielschlüssel durch gültige IDs Schlüsselkennungen aus Ihrem Konto. AWS ``` aws kms re-encrypt \ --ciphertext-blob fileb://ExampleEncryptedFile \ --source-key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --destination-key-id 0987dcba-09fe-87dc-65ba-ab0987654321 \ --query CiphertextBlob \ --output text | base64 --decode > ExampleReEncryptedFile ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Die Ausgabe des Befehls `re-encrypt` wird Base64-dekodiert und in einer Datei gespeichert. Weitere Informationen finden Sie [ReEncrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_ReEncrypt.html)in der *API-Referenz für den AWS Key Management Service*. **Beispiel 2: So verschlüsseln Sie eine verschlüsselte Nachricht unter einem symmetrischen KMS-Schlüssel (Windows-Befehlszeile) erneut).** Das folgende Beispiel für den Befehl `re-encrypt` ist mit dem vorherigen identisch, mit dem Unterschied, dass es das Dienstprogramm `certutil` zur Base64-Decodierung der Klartextdaten verwendet. Für dieses Verfahren sind zwei Befehle erforderlich, wie in den folgenden Beispielen gezeigt. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem AWS Konto. ``` aws kms re-encrypt ^ --ciphertext-blob fileb://ExampleEncryptedFile ^ --source-key-id 1234abcd-12ab-34cd-56ef-1234567890ab ^ --destination-key-id 0987dcba-09fe-87dc-65ba-ab0987654321 ^ --query CiphertextBlob ^ --output text > ExampleReEncryptedFile.base64 ``` Verwenden Sie dann das Dienstprogramm `certutil`. ``` certutil -decode ExamplePlaintextFile.base64 ExamplePlaintextFile ``` Ausgabe: ``` Input Length = 18 Output Length = 12 CertUtil: -decode command completed successfully. ``` Weitere Informationen finden Sie [ReEncrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_ReEncrypt.html)in der *API-Referenz für den AWS Key Management Service*. + Einzelheiten zur API finden Sie [ReEncrypt](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/re-encrypt.html)unter *AWS CLI Befehlsreferenz*. ### `retire-grant` Das folgende Codebeispiel zeigt die Verwendung`retire-grant`. **AWS CLI** **So ziehen Sie eine Erteilung für einen Kundenhauptschlüssel zurück** Im folgenden Beispiel für `retire-grant` wird ein Zuschuss aus einem KMS-Schlüssel gelöscht. Der folgende Beispielbefehl legt die Parameter `grant-id` und `key-id` fest. Der Wert des Parameters `key-id` muss der Schlüssel-ARN des KMS-Schlüssels sein. ``` aws kms retire-grant \ --grant-id 1234a2345b8a4e350500d432bccf8ecd6506710e1391880c4f7f7140160c9af3 \ --key-id arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl `list-grants`, um zu bestätigen, dass die Erteilung zurückgezogen wurde. Weitere Informationen finden Sie unter [Zurückziehen und Widerrufen von Erteilungen](https://docs.aws.amazon.com/kms/latest/developerguide/grant-manage.html#grant-delete) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [RetireGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/retire-grant.html)in der *AWS CLI Befehlsreferenz*. ### `revoke-grant` Das folgende Codebeispiel zeigt die Verwendung`revoke-grant`. **AWS CLI** **So ziehen Sie eine Erteilung für einen Kundenhauptschlüssel zurück** Im folgenden Beispiel für `revoke-grant` wird ein Zuschuss aus einem KMS-Schlüssel gelöscht. Der folgende Beispielbefehl legt die Parameter `grant-id` und `key-id` fest. Der Wert des Parameters `key-id` kann die Schlüssel-ID oder der Schlüssel-ARN des KMS-Schlüssels sein. ``` aws kms revoke-grant \ --grant-id 1234a2345b8a4e350500d432bccf8ecd6506710e1391880c4f7f7140160c9af3 \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl `list-grants`, um zu bestätigen, dass die Erteilung zurückgezogen wurde. Weitere Informationen finden Sie unter [Zurückziehen und Widerrufen von Erteilungen](https://docs.aws.amazon.com/kms/latest/developerguide/grant-manage.html#grant-delete) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [RevokeGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/revoke-grant.html)in der *AWS CLI Befehlsreferenz*. ### `rotate-key-on-demand` Das folgende Codebeispiel zeigt die Verwendung`rotate-key-on-demand`. **AWS CLI** **So führen Sie die On-Demand-Rotation eines KMS-Schlüssels durch** Im folgenden Beispiel für `rotate-key-on-demand` wird sofort die Rotation des Schlüsselmaterials für den angegebenen KMS-Schlüssel initiiert. ``` aws kms rotate-key-on-demand \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Ausgabe: ``` { "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" } ``` Weitere Informationen finden Sie unter [So führen Sie die Schlüsselrotation bei Bedarf durch](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html#rotating-keys-on-demand) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [RotateKeyOnDemand](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/rotate-key-on-demand.html)in der *AWS CLI Befehlsreferenz*. ### `schedule-key-deletion` Das folgende Codebeispiel zeigt die Verwendung`schedule-key-deletion`. **AWS CLI** **So planen Sie das Löschen eines kundenseitig verwalteten KMS-Schlüssels.** Im folgenden Beispiel für `schedule-key-deletion` wird geplant, dass der angegebene kundenseitig verwaltete KMS-Schlüssel innerhalb von 15 Tagen gelöscht wird. Der Parameter `--key-id` identifiziert den KMS-Schlüssel. In diesem Beispiel wird ein Schlüssel-ARN-Wert verwendet, Sie können jedoch entweder die Schlüssel-ID oder den ARN des KMS-Schlüssels verwenden. Der Parameter `--pending-window-in-days` gibt die Dauer der Wartezeit von 7 bis 30 Tagen an. Die Wartezeit beträgt standardmäßig 30 Tage. In diesem Beispiel wird der Wert 15 angegeben, der angibt, dass der KMS-Schlüssel 15 Tage nach Abschluss des Befehls dauerhaft gelöscht werden AWS soll. ``` aws kms schedule-key-deletion \ --key-id arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab \ --pending-window-in-days 15 ``` Die Antwort enthält den Schlüssel-ARN, den Schlüsselstatus, die Wartezeit (`PendingWindowInDays`) und das Löschdatum in Unix-Zeit. Verwenden Sie die AWS KMS-Konsole, um das Löschdatum in Ortszeit anzuzeigen. KMS-Schlüssel im Schlüsselstatus `PendingDeletion` können nicht in kryptografischen Vorgängen verwendet werden. ``` { "KeyId": "arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab", "DeletionDate": "2022-06-18T23:43:51.272000+00:00", "KeyState": "PendingDeletion", "PendingWindowInDays": 15 } ``` Weitere Informationen finden Sie unter [Löschen von Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/deleting-keys.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [ScheduleKeyDeletion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/schedule-key-deletion.html)in der *AWS CLI Befehlsreferenz*. ### `sign` Das folgende Codebeispiel zeigt die Verwendung`sign`. **AWS CLI** **Beispiel 1: So generieren Sie eine digitale Signatur für eine Nachricht** Im folgenden Beispiel für `sign` wird eine kryptografische Signatur für eine Kurznachricht generiert. Die Ausgabe des Befehls enthält das mit base-64 codiertes Feld `Signature`, das Sie mit dem Befehl `verify` überprüfen können. Sie müssen eine zu signierende Nachricht und einen Signierungsalgorithmus angeben, den Ihr asymmetrischer KMS-Schlüssel unterstützt. Verwenden Sie den Befehl `describe-key`, um den Signierungsalgorithmus für Ihren KMS-Schlüssel abzurufen. In AWS CLI v2 muss der Wert des `message` Parameters Base64-codiert sein. Oder Sie können die Nachricht in einer Datei speichern und das `fileb://` Präfix verwenden, das die AWS CLI anweist, Binärdaten aus der Datei zu lesen. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem AWS Konto. Die Schlüssel-ID muss einen asymmetrischen KMS-Schlüssel mit der Schlüsselverwendung SIGN\$1VERIFY darstellen. ``` msg=(echo 'Hello World' | base64) aws kms sign \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --message fileb://UnsignedMessage \ --message-type RAW \ --signing-algorithm RSASSA_PKCS1_V1_5_SHA_256 ``` Ausgabe: ``` { "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "Signature": "ABCDEFhpyVYyTxbafE74ccSvEJLJr3zuoV1Hfymz4qv+/fxmxNLA7SE1SiF8lHw80fKZZ3bJ...", "SigningAlgorithm": "RSASSA_PKCS1_V1_5_SHA_256" } ``` Weitere Informationen zur Verwendung asymmetrischer KMS-Schlüssel in AWS KMS finden Sie unter [Asymmetrische Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im *AWS Key Management Service Developer Guide*. **Beispiel 2: So speichern Sie eine digitale Signatur in einer Datei (Linux und macOs)** Im folgenden Beispiel für `sign` wird eine kryptografische Signatur für eine Kurznachricht generiert, die in einer lokalen Datei gespeichert ist. Der Befehl ruft auch die `Signature` Eigenschaft aus der Antwort ab, dekodiert sie mit Base64 und speichert sie in der Datei. ExampleSignature Sie können die Signaturdatei in einem `verify`-Befehl verwenden, der die Signatur überprüft. Der Befehl `sign` erfordert eine Base64-codierte Nachricht und einen Signaturalgorithmus, den Ihr asymmetrischer KMS-Schlüssel unterstützt. Verwenden Sie den Befehl `describe-key`, um den Signaturalgorithmus abzurufen, den Ihr KMS-Schlüssel unterstützt. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem Konto. AWS Die Schlüssel-ID muss einen asymmetrischen KMS-Schlüssel mit der Schlüsselverwendung SIGN\$1VERIFY darstellen. ``` echo 'hello world' | base64 > EncodedMessage aws kms sign \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --message fileb://EncodedMessage \ --message-type RAW \ --signing-algorithm RSASSA_PKCS1_V1_5_SHA_256 \ --output text \ --query Signature | base64 --decode > ExampleSignature ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. In diesem Beispiel wird die Eigenschaft `Signature` der Ausgabe extrahiert und in einer Datei gespeichert. Weitere Informationen zur Verwendung asymmetrischer KMS-Schlüssel in AWS KMS finden Sie unter [Asymmetrische Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im *AWS Key Management Service Developer Guide*. + Weitere API-Informationen finden Sie unter [Sign](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/sign.html) in der *AWS CLI -Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung. `tag-resource` **AWS CLI** **So fügen Sie einem KMS-Schlüssel ein Tag hinzu** Im folgenden Beispiel für `tag-resource` werden einem kundenseitig verwalteten KMS-Schlüssel die Tags `"Purpose":"Test"` und `"Dept":"IT"` hinzugefügt. Sie können Tags wie diese verwenden, um KMS-Schlüssel zu kennzeichnen und Kategorien von KMS-Schlüsseln für Berechtigungen und Prüfungen zu erstellen. Verwenden Sie den Parameter `key-id`, um den KMS-Schlüssel anzugeben. In diesem Beispiel wird ein Schlüssel-ID-Wert verwendet, Sie können jedoch eine Schlüssel-ID oder einen Schlüssel-ARN in diesem Befehl verwenden. ``` aws kms tag-resource \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --tags TagKey='Purpose',TagValue='Test' TagKey='Dept',TagValue='IT' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den `list-resource-tags` Befehl, um die Tags eines AWS KMS-KMS-Schlüssels anzuzeigen. Weitere Informationen zur Verwendung von Tags in AWS KMS finden Sie unter [Tagging Keys](https://docs.aws.amazon.com/kms/latest/developerguide/tagging-keys.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So löschen Sie ein Tag aus einem KMS-Schlüssel** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem Schlüssel `"Purpose"` aus einem kundenseitig verwalteten KMS-Schlüssel gelöscht. Verwenden Sie den Parameter `key-id`, um den KMS-Schlüssel anzugeben. In diesem Beispiel wird ein Schlüssel-ID-Wert verwendet, Sie können jedoch eine Schlüssel-ID oder einen Schlüssel-ARN in diesem Befehl verwenden. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem AWS Konto. ``` aws kms untag-resource \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --tag-key 'Purpose' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den `list-resource-tags` Befehl, um die Tags auf einem AWS KMS-KMS-Schlüssel anzuzeigen. Weitere Informationen zur Verwendung von Tags in AWS KMS finden Sie unter [Tagging Keys](https://docs.aws.amazon.com/kms/latest/developerguide/tagging-keys.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-alias` Das folgende Codebeispiel zeigt die Verwendung`update-alias`. **AWS CLI** **So verknüpfen Sie einen Alias mit einem anderen KMS-Schlüssel** Im folgenden Beispiel für `update-alias` wird der Alias `alias/test-key` einem anderen KMS-Schlüssel zugeordnet. Der Parameter `--alias-name` gibt den Alias an. Der Wert des Aliasnamens muss mit `alias/` beginnen. Der Parameter `--target-key-id` gibt den KMS-Schlüssel an, der dem Alias zugeordnet werden soll. Sie müssen den aktuellen KMS-Schlüssel für den Alias nicht angeben. ``` aws kms update-alias \ --alias-name alias/test-key \ --target-key-id 1234abcd-12ab-34cd-56ef-1234567890ab ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl `list-aliases`, um den Alias zu suchen. Weitere Informationen finden Sie unter [Aktualisieren von Aliasnamen](https://docs.aws.amazon.com/kms/latest/developerguide/alias-manage.html#alias-update) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie [UpdateAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/update-alias.html)in der *AWS CLI Befehlsreferenz*. ### `update-custom-key-store` Das folgende Codebeispiel zeigt die Verwendung`update-custom-key-store`. **AWS CLI** **Beispiel 1: So bearbeiten Sie den Anzeigenamen eines benutzerdefinierten Schlüsselspeichers** Im folgenden Beispiel für `update-custom-key-store` wird der Name des benutzerdefinierten Schlüsselspeichers geändert. Dieses Beispiel funktioniert für einen AWS CloudHSM-Schlüsselspeicher oder einen externen Schlüsselspeicher. Verwenden Sie die `custom-key-store-id`, um den Schlüsselspeicher zu identifizieren. Verwenden Sie den Parameter `new-custom-key-store-name`, um den neuen Anzeigenamen anzugeben. Um den Anzeigenamen eines AWS CloudHSM-Schlüsselspeichers zu aktualisieren, müssen Sie zuerst die Verbindung zum Schlüsselspeicher trennen, z. B. mit dem `disconnect-custom-key-store` Befehl. Sie können den Anzeigenamen eines externen Schlüsselspeichers aktualisieren, während er verbunden oder getrennt ist. Verwenden Sie den `describe-custom-key-store`-Befehl, um den Verbindungsstatus Ihres benutzerdefinierten Schlüsselspeichers zu ermitteln. ``` aws kms update-custom-key-store \ --custom-key-store-id cks-1234567890abcdef0 \ --new-custom-key-store-name ExampleKeyStore ``` Dieser Befehl gibt keine Daten zurück. Verwenden Sie einen Befehl `describe-custom-key-stores`, um zu überprüfen, ob der Befehl funktioniert hat. Weitere Informationen zum Aktualisieren eines AWS CloudHSM-Schlüsselspeichers finden Sie unter [Bearbeiten der AWS CloudHSM-Schlüsselspeicher-Einstellungen im AWS Key](https://docs.aws.amazon.com/kms/latest/developerguide/update-keystore.html) *Management* Service Developer Guide. Weitere Informationen zum Aktualisieren eines externen Schlüsselspeichers finden Sie unter [Bearbeiten der Eigenschaften eines externen Schlüsselspeichers](https://docs.aws.amazon.com/kms/latest/developerguide/update-xks-keystore.html) im *Entwicklerhandbuch für AWS Key Management Service*. **Beispiel 2: Um das kmsuser-Passwort eines AWS CloudHSM-Schlüsselspeichers zu bearbeiten** Im folgenden Beispiel für `update-custom-key-store` wird der Wert des Passworts `kmsuser` auf das aktuelle Passwort für den `kmsuser` im CloudHSM-Cluster aktualisiert, der dem angegebenen Schlüsselspeicher zugeordnet ist. Dieser Befehl ändert das Passwort `kmsuser` im Cluster nicht. Es teilt AWS KMS nur das aktuelle Passwort mit. Wenn KMS nicht über das aktuelle `kmsuser` Passwort verfügt, kann es keine Verbindung zum AWS CloudHSM-Schlüsselspeicher herstellen. **HINWEIS:** Bevor Sie einen AWS CloudHSM-Schlüsselspeicher aktualisieren, müssen Sie die Verbindung trennen. Verwenden Sie den Befehl `disconnect-custom-key-store`. Nachdem der Befehl abgeschlossen ist, können Sie den AWS CloudHSM-Schlüsselspeicher erneut verbinden. Verwenden Sie den Befehl `connect-custom-key-store`. ``` aws kms update-custom-key-store \ --custom-key-store-id cks-1234567890abcdef0 \ --key-store-password ExamplePassword ``` Dieser Befehl gibt keine Ausgabe zurück. Verwenden Sie einen `describe-custom-key-stores`-Befehl, um zu überprüfen, ob die Änderung wirksam war. Weitere Informationen zum Aktualisieren eines AWS CloudHSM-Schlüsselspeichers finden Sie unter [Bearbeiten der AWS CloudHSM-Schlüsselspeicher-Einstellungen im AWS Key](https://docs.aws.amazon.com/kms/latest/developerguide/update-keystore.html) *Management* Service Developer Guide. **Beispiel 3: So bearbeiten Sie den AWS CloudHSM-Cluster eines AWS CloudHSM-Schlüsselspeichers** Im folgenden Beispiel wird der AWS CloudHSM-Cluster, der einem AWS CloudHSM-Schlüsselspeicher zugeordnet ist, in einen verwandten Cluster geändert, z. B. ein anderes Backup desselben Clusters. **HINWEIS:** Bevor Sie einen AWS CloudHSM-Schlüsselspeicher aktualisieren, müssen Sie die Verbindung trennen. Verwenden Sie den Befehl `disconnect-custom-key-store`. Nachdem der Befehl abgeschlossen ist, können Sie den AWS CloudHSM-Schlüsselspeicher erneut verbinden. Verwenden Sie den Befehl `connect-custom-key-store`. ``` aws kms update-custom-key-store \ --custom-key-store-id cks-1234567890abcdef0 \ --cloud-hsm-cluster-id cluster-1a23b4cdefg ``` Dieser Befehl gibt keine Ausgabe zurück. Verwenden Sie einen `describe-custom-key-stores`-Befehl, um zu überprüfen, ob die Änderung wirksam war. Weitere Informationen zum Aktualisieren eines AWS CloudHSM-Schlüsselspeichers finden Sie unter [Bearbeiten der AWS CloudHSM-Schlüsselspeicher-Einstellungen im AWS Key](https://docs.aws.amazon.com/kms/latest/developerguide/update-keystore.html) *Management* Service Developer Guide. **Beispiel 4: So bearbeiten Sie die Proxy-Authentifizierungsanmeldeinformationen eines externen Schlüsselspeichers** Im folgenden Beispiel werden die Proxy-Authentifizierungsanmeldeinformationen für Ihren externen Schlüsselspeicher aktualisiert. Sie müssen den `raw-secret-access-key` und die `access-key-id` auch dann angeben, wenn Sie nur einen der Werte ändern. Sie können dieses Feature verwenden, um ungültige Anmeldeinformationen zu korrigieren oder die Anmeldeinformationen zu ändern, wenn der externe Schlüsselspeicher-Proxy sie rotiert. Richten Sie die Anmeldeinformationen für die Proxyauthentifizierung für AWS KMS in Ihrem externen Schlüsselspeicher ein. Verwenden Sie dann diesen Befehl, um die Anmeldeinformationen für KMS bereitzustellen. AWS AWS KMS verwendet diese Anmeldeinformationen, um seine Anfragen an Ihren externen Schlüsselspeicher-Proxy zu signieren. Sie können die Anmeldeinformationen für die Proxy-Authentifizierung aktualisieren, während der externe Schlüsselspeicher verbunden oder getrennt ist. Verwenden Sie den `describe-custom-key-store`-Befehl, um den Verbindungsstatus Ihres benutzerdefinierten Schlüsselspeichers zu ermitteln. ``` aws kms update-custom-key-store \ --custom-key-store-id cks-1234567890abcdef0 \ --xks-proxy-authentication-credential "AccessKeyId=ABCDE12345670EXAMPLE, RawSecretAccessKey=DXjSUawnel2fr6SKC7G25CNxTyWKE5PF9XX6H/u9pSo=" ``` Dieser Befehl gibt keine Ausgabe zurück. Verwenden Sie einen `describe-custom-key-stores`-Befehl, um zu überprüfen, ob die Änderung wirksam war. Weitere Informationen zum Aktualisieren eines externen Schlüsselspeichers finden Sie unter [Bearbeiten der Eigenschaften eines externen Schlüsselspeichers](https://docs.aws.amazon.com/kms/latest/developerguide/update-xks-keystore.html) im *Entwicklerhandbuch für AWS Key Management Service*. **Beispiel 5: So bearbeiten Sie die Proxy-Konnektivität eines externen Schlüsselspeichers** Im folgenden Beispiel wird die Proxy-Konnektivitätsoption des externen Schlüsselspeichers von der Konnektivität eines öffentlichen Endpunkts in die Konnektivität des VPC-Endpunkt-Service geändert. Zusätzlich zur Änderung des Werts `xks-proxy-connectivity` müssen Sie den Wert `xks-proxy-uri-endpoint` so ändern, dass er den privaten DNS-Namen widerspiegelt, der dem VPC-Endpunktservice zugeordnet ist. Sie müssen auch den Wert `xks-proxy-vpc-endpoint-service-name` hinzufügen. **HINWEIS:** Bevor Sie die Konnektivität des Proxys eines externen Speichers aktualisieren, müssen Sie dessen Verbindung trennen. Verwenden Sie den Befehl `disconnect-custom-key-store`. Nach Abschluss des Befehls können Sie den externen Schlüsselspeicher mit dem Befehl `connect-custom-key-store` erneut verbinden. ``` aws kms update-custom-key-store \ --custom-key-store-id cks-1234567890abcdef0 \ --xks-proxy-connectivity VPC_ENDPOINT_SERVICE \ --xks-proxy-uri-endpoint "https://myproxy-private.xks.example.com" \ --xks-proxy-vpc-endpoint-service-name "com.amazonaws.vpce.us-east-1.vpce-svc-example" ``` Dieser Befehl gibt keine Ausgabe zurück. Verwenden Sie einen `describe-custom-key-stores`-Befehl, um zu überprüfen, ob die Änderung wirksam war. Weitere Informationen zum Aktualisieren eines externen Schlüsselspeichers finden Sie unter [Bearbeiten der Eigenschaften eines externen Schlüsselspeichers](https://docs.aws.amazon.com/kms/latest/developerguide/update-xks-keystore.html) im *Entwicklerhandbuch für AWS Key Management Service*. + Einzelheiten zur API finden Sie unter [UpdateCustomKeyStore AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/update-custom-key-store.html)*Befehlsreferenz.* ### `update-key-description` Das folgende Codebeispiel zeigt die Verwendung`update-key-description`. **AWS CLI** **Beispiel 1: So fügen Sie einem kundenseitig verwalteten KMS-Schlüssel eine Beschreibung hinzu oder ändern sie** Im folgenden Beispiel für `update-key-description` wird einem kundenseitig verwalteten KMS-Schlüssel eine Beschreibung hinzugefügt. Sie können denselben Befehl verwenden, um eine vorhandene Beschreibung zu ändern. Der `--key-id`-Parameter identifiziert den KMS-Schlüssel im Befehl. In diesem Beispiel wird ein Schlüssel-ARN-Wert verwendet, Sie können jedoch entweder die Schlüssel-ID oder Schlüssel-ARN des KMS-Schlüssels verwenden. Der Parameter `--description` gibt die neue Beschreibung an. Der Wert dieses Parameters ersetzt die aktuelle Beschreibung des KMS-Schlüssels, falls vorhanden. ``` aws kms update-key-description \ --key-id arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab \ --description "IT Department test key" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl `describe-key`, um die Beschreibung eines KMS-Schlüssels anzuzeigen. Weitere Informationen finden Sie [UpdateKeyDescription](https://docs.aws.amazon.com/cli/latest/reference/kms/update-key-description.html)in der *API-Referenz für den AWS Key Management Service*. **Beispiel 2: So löschen Sie die Beschreibung eines kundenseitig verwalteten KMS-Schlüssels** Im folgenden Beispiel für `update-key-description` wird die Beschreibung eines kundenseitig verwalteten KMS-Schlüssels gelöscht. Der `--key-id`-Parameter identifiziert den KMS-Schlüssel im Befehl. In diesem Beispiel wird ein Schlüssel-ID-Wert verwendet, Sie können jedoch entweder die Schlüssel-ID oder den Schlüssel-ARN des KMS-Schlüssels verwenden. Der Parameter `--description` mit einem leeren Zeichenfolgenwert ('') löscht die vorhandene Beschreibung. ``` aws kms update-key-description \ --key-id 0987dcba-09fe-87dc-65ba-ab0987654321 \ --description '' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl „describe-key“, um die Beschreibung eines KMS-Schlüssels anzuzeigen. Weitere Informationen finden Sie [UpdateKeyDescription](https://docs.aws.amazon.com/cli/latest/reference/kms/update-key-description.html)in der *API-Referenz für den AWS Key Management Service*. + Einzelheiten zur API finden Sie [UpdateKeyDescription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/update-key-description.html)unter *AWS CLI Befehlsreferenz*. ### `verify-mac` Das folgende Codebeispiel zeigt die Verwendung`verify-mac`. **AWS CLI** **Beispiel 1: So überprüfen Sie einen HMAC** Der folgende Befehl `verify-mac` generiert einen HMAC für eine bestimmte Nachricht, HMAC-KMS-Schlüssel und den MAC-Algorithmus. Ein Wert von 'true' im MacValid Wert in der Antwort gibt an, dass der HMAC gültig ist. In AWS CLI v2 muss der Wert des `message` Parameters Base64-codiert sein. Oder Sie können die Nachricht in einer Datei speichern und das `fileb://` Präfix verwenden, das die AWS CLI anweist, Binärdaten aus der Datei zu lesen. Der von Ihnen angegebene MAC kann nicht Base64-codiert sein. Hilfe zum Entschlüsseln der MAC-Adresse, die der Befehl `generate-mac` zurückgibt, finden Sie in den Beispielen für den Befehl `generate-mac`. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem AWS Konto. Die Schlüssel-ID muss einen HMAC-KMS-Schlüssel mit der Schlüsselverwendung von `GENERATE_VERIFY_MAC` darstellen. ``` msg=(echo 'Hello World' | base64) aws kms verify-mac \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --message fileb://Message \ --mac-algorithm HMAC_SHA_384 \ --mac fileb://ExampleMac ``` Ausgabe: ``` { "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "MacValid": true, "MacAlgorithm": "HMAC_SHA_384" } ``` Weitere Informationen zur Verwendung von HMAC-KMS-Schlüsseln in AWS KMS finden Sie unter [HMAC-Schlüssel in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/hmac.html) im *AWS Key Management Service Developer Guide*. + Einzelheiten zur API finden Sie [VerifyMac](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/verify-mac.html)in der *AWS CLI Befehlsreferenz*. ### `verify` Das folgende Codebeispiel zeigt die Verwendung`verify`. **AWS CLI** **So überprüfen Sie eine digitale Signatur** Mit dem folgenden Befehl für `verify` wird eine kryptografische Signatur für eine kurze, Base64-kodierte Nachricht überprüft. Die Schlüssel-ID, die Nachricht, der Nachrichtentyp und der Signaturalgorithmus müssen mit denen identisch sein, die zum Signieren der Nachricht verwendet wurden. In AWS CLI v2 muss der Wert des `message` Parameters Base64-codiert sein. Oder Sie können die Nachricht in einer Datei speichern und das `fileb://` Präfix verwenden, das die AWS CLI anweist, Binärdaten aus der Datei zu lesen. Die von Ihnen angegebene Signatur kann nicht Base64-codiert sein. Hilfe zum Entschlüsseln der Signatur, die der Befehl `sign` zurückgibt, finden Sie in den Beispielen für den Befehl `sign`. Die Ausgabe des Befehls enthält ein boolesches `SignatureValid`-Feld, das angibt, dass die Signatur verifiziert wurde. Wenn die Signaturüberprüfung fehlschlägt, schlägt auch der Befehl `verify` fehl. Bevor Sie diesen Befehl ausführen, ersetzen Sie die Beispielschlüssel-ID durch eine gültige Schlüssel-ID aus Ihrem AWS Konto. ``` aws kms verify \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --message fileb://EncodedMessage \ --message-type RAW \ --signing-algorithm RSASSA_PKCS1_V1_5_SHA_256 \ --signature fileb://ExampleSignature ``` Ausgabe: ``` { "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "SignatureValid": true, "SigningAlgorithm": "RSASSA_PKCS1_V1_5_SHA_256" } ``` Weitere Informationen zur Verwendung asymmetrischer KMS-Schlüssel in AWS KMS finden Sie unter [Using asymmetric keys](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im *AWS Key Management Service Developer Guide*. + API-Details finden Sie unter [Verify](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kms/verify.html) in der *AWS CLI -Befehlsreferenz*. # Beispiele für Lake Formation mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Lake Formation Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-lf-tags-to-resource` Das folgende Codebeispiel zeigt die Verwendung von`add-lf-tags-to-resource`. **AWS CLI** **So fügen Sie ein oder mehrere LF-Tags an eine bestehende Ressource an** Im folgenden Beispiel für `add-lf-tags-to-resource` wird ein bestimmtes LF-Tag an die Tabellenressource angefügt. ``` aws lakeformation add-lf-tags-to-resource \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_promotion" } }, "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "analyst" ] }] } ``` Ausgabe: ``` { "Failures": [] } ``` Weitere Informationen finden Sie unter [Zuweisen von LF-Tags zu Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [AddLfTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/add-lf-tags-to-resource.html)in der *AWS CLI Befehlsreferenz*. ### `batch-grant-permissions` Das folgende Codebeispiel zeigt die Verwendung`batch-grant-permissions`. **AWS CLI** **So erteilen Sie den Prinzipalen Berechtigungen für Ressourcen in Massen** Im folgenden Beispiel für `batch-grant-permissions` wird den Prinzipalen Massenzugriff auf bestimmte Ressourcen gewährt. ``` aws lakeformation batch-grant-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Entries": [{ "Id": "1", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer" }, "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_promotion" } }, "Permissions": [ "ALL" ], "PermissionsWithGrantOption": [ "ALL" ] }, { "Id": "2", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer" }, "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_customer" } }, "Permissions": [ "ALL" ], "PermissionsWithGrantOption": [ "ALL" ] }, { "Id": "3", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-business-analyst" }, "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_promotion" } }, "Permissions": [ "ALL" ], "PermissionsWithGrantOption": [ "ALL" ] }, { "Id": "4", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer" }, "Resource": { "DataCellsFilter": { "TableCatalogId": "123456789111", "DatabaseName": "tpc", "TableName": "dl_tpc_item", "Name": "developer_item" } }, "Permissions": [ "SELECT" ], "PermissionsWithGrantOption": [] } ] } ``` Ausgabe: ``` { "Failures": [] } ``` Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [BatchGrantPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-grant-permissions.html)in der *AWS CLI Befehlsreferenz*. ### `batch-revoke-permissions` Das folgende Codebeispiel zeigt die Verwendung`batch-revoke-permissions`. **AWS CLI** **So entziehen Sie den Prinzipalen Berechtigungen für Ressourcen in Massen** Im folgenden Beispiel für `batch-revoke-permissions` wird den Prinzipalen Massenzugriff auf bestimmte Ressourcen gewährt. ``` aws lakeformation batch-revoke-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Entries": [{ "Id": "1", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer" }, "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_promotion" } }, "Permissions": [ "ALL" ], "PermissionsWithGrantOption": [ "ALL" ] }, { "Id": "2", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-business-analyst" }, "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_promotion" } }, "Permissions": [ "ALL" ], "PermissionsWithGrantOption": [ "ALL" ] } ] } ``` Ausgabe: ``` { "Failures": [] } ``` Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [BatchRevokePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-revoke-permissions.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-transaction` Das folgende Codebeispiel zeigt die Verwendung`cancel-transaction`. **AWS CLI** **So brechen Sie eine Transaktion ab** Im folgenden Beispiel für `cancel-transaction` wird die Transaktion abgebrochen. ``` aws lakeformation cancel-transaction \ --transaction-id='b014d972ca8347b89825e33c5774aec4' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [CancelTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/cancel-transaction.html)in der *AWS CLI Befehlsreferenz*. ### `commit-transaction` Das folgende Codebeispiel zeigt die Verwendung`commit-transaction`. **AWS CLI** **So schreiben Sie eine Transaktion fest** Im folgenden Beispiel für `commit-transaction` wird die Transaktion festgeschrieben. ``` aws lakeformation commit-transaction \ --transaction-id='b014d972ca8347b89825e33c5774aec4' ``` Ausgabe: ``` { "TransactionStatus": "committed" } ``` Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [CommitTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/commit-transaction.html)in der *AWS CLI Befehlsreferenz*. ### `create-data-cells-filter` Das folgende Codebeispiel zeigt die Verwendung`create-data-cells-filter`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Datenzellenfilter** Im folgenden Beispiel für `create-data-cells-filter` wird ein Datenzellenfilter erstellt, der es ermöglicht, Zugriff auf bestimmte Spalten basierend auf der Zeilenbedingung zu gewähren. ``` aws lakeformation create-data-cells-filter \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "TableData": { "ColumnNames": ["p_channel_details", "p_start_date_sk", "p_promo_name"], "DatabaseName": "tpc", "Name": "developer_promotion", "RowFilter": { "FilterExpression": "p_promo_name='ese'" }, "TableCatalogId": "123456789111", "TableName": "dl_tpc_promotion" } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*. **Beispiel 2: So erstellen Sie einen Spaltenfilter** Im folgenden Beispiel für `create-data-cells-filter` wird ein Datenzellenfilter erstellt, der es ermöglicht, Zugriff auf bestimmte Spalten zu gewähren. ``` aws lakeformation create-data-cells-filter \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "TableData": { "ColumnNames": ["p_channel_details", "p_start_date_sk", "p_promo_name"], "DatabaseName": "tpc", "Name": "developer_promotion_allrows", "RowFilter": { "AllRowsWildcard": {} }, "TableCatalogId": "123456789111", "TableName": "dl_tpc_promotion" } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*. **Beispiel 3: So erstellen Sie einen Datenfilter mit Ausschlussspalten** Im folgenden Beispiel für `create-data-cells-filter` wird ein Datenzellenfilter erstellt, der es ermöglicht, Zugriff auf alle Spalten außer den genannten zu gewähren. ``` aws lakeformation create-data-cells-filter \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "TableData": { "ColumnWildcard": { "ExcludedColumnNames": ["p_channel_details", "p_start_date_sk"] }, "DatabaseName": "tpc", "Name": "developer_promotion_excludecolumn", "RowFilter": { "AllRowsWildcard": {} }, "TableCatalogId": "123456789111", "TableName": "dl_tpc_promotion" } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [CreateDataCellsFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-data-cells-filter.html)in der *AWS CLI Befehlsreferenz*. ### `create-lf-tag` Das folgende Codebeispiel zeigt die Verwendung`create-lf-tag`. **AWS CLI** **So erstellen Sie ein LF-Tag** Im folgenden Beispiel für `create-lf-tag` wird ein LF-Tag mit dem angegebenen Namen und den angegebenen Werten erstellt. ``` aws lakeformation create-lf-tag \ --catalog-id '123456789111' \ --tag-key 'usergroup' \ --tag-values '["developer","analyst","campaign"]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von LF-Tags für die Zugriffssteuerung für Metadaten](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [CreateLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-lf-tag.html)in der *AWS CLI Befehlsreferenz*. ### `delete-data-cells-filter` Das folgende Codebeispiel zeigt die Verwendung`delete-data-cells-filter`. **AWS CLI** **So löschen Sie den Datenzellenfilter** Im folgenden Beispiel für `delete-data-cells-filter` wird ein bestimmter Datenzellenfilter gelöscht. ``` aws lakeformation delete-data-cells-filter \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "TableCatalogId": "123456789111", "DatabaseName": "tpc", "TableName": "dl_tpc_promotion", "Name": "developer_promotion" } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [DeleteDataCellsFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-data-cells-filter.html)in der *AWS CLI Befehlsreferenz*. ### `delete-lf-tag` Das folgende Codebeispiel zeigt die Verwendung`delete-lf-tag`. **AWS CLI** **So löschen Sie die LF-Tag-Definition** Im folgenden Beispiel für `delete-lf-tag` wird die LF-Tag-Definition gelöscht. ``` aws lakeformation delete-lf-tag \ --catalog-id '123456789111' \ --tag-key 'usergroup' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von LF-Tags für die Zugriffssteuerung für Metadaten](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [DeleteLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-lf-tag.html)in der *AWS CLI Befehlsreferenz*. ### `delete-objects-on-cancel` Das folgende Codebeispiel zeigt die Verwendung`delete-objects-on-cancel`. **AWS CLI** **So löschen Sie ein Objekt, wenn die Transaktion abgebrochen wird** Im folgenden Beispiel für `delete-objects-on-cancel` wird das aufgelistete s3-Objekt gelöscht, wenn die Transaktion abgebrochen wird. ``` aws lakeformation delete-objects-on-cancel \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "012345678901", "DatabaseName": "tpc", "TableName": "dl_tpc_household_demographics_gov", "TransactionId": "1234d972ca8347b89825e33c5774aec4", "Objects": [{ "Uri": "s3://lf-data-lake-012345678901/target/dl_tpc_household_demographics_gov/run-unnamed-1-part-block-0-r-00000-snappy-ff26b17504414fe88b302cd795eabd00.parquet", "ETag": "1234ab1fc50a316b149b4e1f21a73800" }] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [DeleteObjectsOnCancel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-objects-on-cancel.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-resource` Das folgende Codebeispiel zeigt die Verwendung`deregister-resource`. **AWS CLI** **So heben Sie die Registrierung des Data Lake-Speichers auf** Im folgenden Beispiel für `deregister-resource` wird die Registrierung der Ressource entsprechend der Verwaltung durch Lake Formation aufgehoben. ``` aws lakeformation deregister-resource \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123" } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen eines Amazon-S3-Standorts zu Ihrem Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [DeregisterResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/deregister-resource.html)in der *AWS CLI Befehlsreferenz*. ### `describe-transaction` Das folgende Codebeispiel zeigt die Verwendung`describe-transaction`. **AWS CLI** **So rufen Sie Transaktionsdetails ab** Im folgenden Beispiel für `describe-transaction` werden die Details einer einzelnen Transaktion zurückgegeben. ``` aws lakeformation describe-transaction \ --transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce' ``` Ausgabe: ``` { "TransactionDescription": { "TransactionId": "12345972ca8347b89825e33c5774aec4", "TransactionStatus": "committed", "TransactionStartTime": "2022-08-10T14:29:04.046000+00:00", "TransactionEndTime": "2022-08-10T14:29:09.681000+00:00" } } ``` Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [DescribeTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/describe-transaction.html)in der *AWS CLI Befehlsreferenz*. ### `extend-transaction` Das folgende Codebeispiel zeigt die Verwendung`extend-transaction`. **AWS CLI** **So erweitern Sie eine Transaktion** Im folgenden Beispiel für `extend-transaction` wird die Transaktion erweitert. ``` aws lakeformation extend-transaction \ --transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [ExtendTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/extend-transaction.html)in der *AWS CLI Befehlsreferenz*. ### `get-data-lake-settings` Das folgende Codebeispiel zeigt die Verwendung`get-data-lake-settings`. **AWS CLI** **So rufen Sie von AWS Lake Formation verwaltete Data Lake-Einstellungen ab** Im folgenden Beispiel für `get-data-lake-settings` wird die Liste der Data-Lake-Administratoren und anderer Data-Lake-Einstellungen abgerufen. ``` aws lakeformation get-data-lake-settings \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111" } ``` Ausgabe: ``` { "DataLakeSettings": { "DataLakeAdmins": [{ "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin" }], "CreateDatabaseDefaultPermissions": [], "CreateTableDefaultPermissions": [ { "Principal": { "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS" }, "Permissions": [ "ALL" ] } ], "TrustedResourceOwners": [], "AllowExternalDataFiltering": true, "ExternalDataFilteringAllowList": [{ "DataLakePrincipalIdentifier": "123456789111" }], "AuthorizedSessionTagValueList": [ "Amazon EMR" ] } } ``` Weitere Informationen finden Sie unter [Ändern der Standardsicherheitseinstellungen für Ihren Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [GetDataLakeSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-data-lake-settings.html)in der *AWS CLI Befehlsreferenz*. ### `get-effective-permissions-for-path` Das folgende Codebeispiel zeigt die Verwendung`get-effective-permissions-for-path`. **AWS CLI** **So rufen Sie Berechtigungen für Ressourcen ab, die sich unter einem bestimmten Pfad befinden** Im folgenden Beispiel für `get-effective-permissions-for-path` werden die Lake-Formation-Berechtigungen für eine angegebene Tabelle oder Datenbankressource zurückgegeben, die sich unter einem Pfad in Amazon S3 befindet. ``` aws lakeformation get-effective-permissions-for-path \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111" } ``` Ausgabe: ``` { "Permissions": [{ "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-campaign-manager" }, "Resource": { "Database": { "Name": "tpc" } }, "Permissions": [ "DESCRIBE" ], "PermissionsWithGrantOption": [] }, { "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/EMR-RuntimeRole" }, "Resource": { "Database": { "Name": "tpc" } }, "Permissions": [ "ALL" ], "PermissionsWithGrantOption": [] }, { "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:saml-provider/oktaSAMLProvider:user/emr-developer" }, "Resource": { "Database": { "Name": "tpc" } }, "Permissions": [ "ALL", "DESCRIBE" ], "PermissionsWithGrantOption": [] }, { "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin" }, "Resource": { "Database": { "Name": "tpc" } }, "Permissions": [ "ALL", "ALTER", "CREATE_TABLE", "DESCRIBE", "DROP" ], "PermissionsWithGrantOption": [ "ALL", "ALTER", "CREATE_TABLE", "DESCRIBE", "DROP" ] }, { "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/LF-GlueServiceRole" }, "Resource": { "Database": { "Name": "tpc" } }, "Permissions": [ "CREATE_TABLE" ], "PermissionsWithGrantOption": [] } ], "NextToken": "E5SlJDSTZleUp6SWpvaU9UQTNORE0zTXpFeE5Ua3pJbjE5TENKbGVIQnBjbUYwYVc5dUlqcDdJbk5sWTI5dVpITWlPakUyTm==" } ``` Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [GetEffectivePermissionsForPath](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-effective-permissions-for-path.html)in der *AWS CLI Befehlsreferenz*. ### `get-lf-tag` Das folgende Codebeispiel zeigt die Verwendung`get-lf-tag`. **AWS CLI** **So rufen Sie eine LF-Tag-Definition ab** Im folgenden Beispiel für `get-lf-tag` wird die LF-Tag-Definition abgerufen. ``` aws lakeformation get-lf-tag \ --catalog-id '123456789111' \ --tag-key 'usergroup' ``` Ausgabe: ``` { "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "analyst", "campaign", "developer" ] } ``` Weitere Informationen finden Sie unter [Verwalten von LF-Tags für die Zugriffssteuerung für Metadaten](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [GetLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-lf-tag.html)in der *AWS CLI Befehlsreferenz*. ### `get-query-state` Das folgende Codebeispiel zeigt die Verwendung`get-query-state`. **AWS CLI** **So rufen Sie den Status einer gesendeten Abfrage ab** Im folgenden Beispiel für `get-query-state` wird der Status einer zuvor übermittelten Abfrage zurückgegeben. ``` aws lakeformation get-query-state \ --query-id='1234273f-4a62-4cda-8d98-69615ee8be9b' ``` Ausgabe: ``` { "State": "FINISHED" } ``` Weitere Informationen finden Sie unter [Transaktionsdatenvorgänge](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [GetQueryState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-state.html)in der *AWS CLI Befehlsreferenz*. ### `get-query-statistics` Das folgende Codebeispiel zeigt die Verwendung`get-query-statistics`. **AWS CLI** **So rufen Sie Abfragestatistiken ab** Im folgenden Beispiel für `get-query-statistics` werden Statistiken zur Planung und Ausführung einer Abfrage abgerufen. ``` aws lakeformation get-query-statistics \ --query-id='1234273f-4a62-4cda-8d98-69615ee8be9b' ``` Ausgabe: ``` { "ExecutionStatistics": { "AverageExecutionTimeMillis": 0, "DataScannedBytes": 0, "WorkUnitsExecutedCount": 0 }, "PlanningStatistics": { "EstimatedDataToScanBytes": 43235, "PlanningTimeMillis": 2377, "QueueTimeMillis": 440, "WorkUnitsGeneratedCount": 1 }, "QuerySubmissionTime": "2022-08-11T02:14:38.641870+00:00" } ``` Weitere Informationen finden Sie unter [Transaktionsdatenvorgänge](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [GetQueryStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-statistics.html)in der *AWS CLI Befehlsreferenz*. ### `get-resource-lf-tags` Das folgende Codebeispiel zeigt die Verwendung`get-resource-lf-tags`. **AWS CLI** **So listen Sie LF-Tags auf** Im folgenden Beispiel für `list-lf-tags` wird eine Liste von LF-Tags zurückgegeben, zu deren Anzeige der Anforderer berechtigt ist. ``` aws lakeformation list-lf-tags \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "ResourceShareType": "ALL", "MaxResults": 2 } ``` Ausgabe: ``` { "LFTags": [{ "CatalogId": "123456789111", "TagKey": "category", "TagValues": [ "private", "public" ] }, { "CatalogId": "123456789111", "TagKey": "group", "TagValues": [ "analyst", "campaign", "developer" ] }], "NextToken": "kIiwiZXhwaXJhdGlvbiI6eyJzZWNvbmRzIjoxNjYwMDY4dCI6ZmFsc2V9" } ``` Weitere Informationen finden Sie unter [Verwalten von LF-Tags für die Zugriffssteuerung für Metadaten](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [GetResourceLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-resource-lf-tags.html)in der *AWS CLI Befehlsreferenz*. ### `get-table-objects` Das folgende Codebeispiel zeigt die Verwendung`get-table-objects`. **AWS CLI** **So listen Sie Objekte einer verwalteten Tabelle auf** Im folgenden Beispiel für `get-table-objects` wird der Satz von Amazon-S3-Objekten zurückgegeben, aus denen die angegebene verwaltete Tabelle besteht. ``` aws lakeformation get-table-objects \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "012345678901", "DatabaseName": "tpc", "TableName": "dl_tpc_household_demographics_gov", "QueryAsOfTime": "2022-08-10T15:00:00" } ``` Ausgabe: ``` { "Objects": [{ "PartitionValues": [], "Objects": [{ "Uri": "s3://lf-data-lake-012345678901/target/dl_tpc_household_demographics_gov/run-unnamed-1-part-block-0-r-00000-snappy-ff26b17504414fe88b302cd795eabd00.parquet", "ETag": "12345b1fc50a316b149b4e1f21a73800", "Size": 43235 }] }] } ``` Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [GetTableObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-table-objects.html)in der *AWS CLI Befehlsreferenz*. ### `get-work-unit-results` Das folgende Codebeispiel zeigt die Verwendung`get-work-unit-results`. **AWS CLI** **So rufen Sie Arbeitseinheiten einer bestimmten Abfrage ab** Im folgenden Beispiel für `get-work-unit-results` werden die Arbeitseinheiten zurückgegeben, die aus der Abfrage resultieren. ``` aws lakeformation get-work-units \ --query-id='1234273f-4a62-4cda-8d98-69615ee8be9b' \ --work-unit-id '0' \ --work-unit-token 'B2fMSdmQXe9umX8Ux8XCo4=' outfile ``` Ausgabe: ``` outfile with Blob content. ``` Weitere Informationen finden Sie unter [Transaktionsdatenvorgänge](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [GetWorkUnitResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-unit-results.html)in der *AWS CLI Befehlsreferenz*. ### `get-work-units` Das folgende Codebeispiel zeigt die Verwendung`get-work-units`. **AWS CLI** **So rufen Sie Arbeitseinheiten ab** Im folgenden `get-work-units` Beispiel werden die durch den StartQueryPlanning Vorgang generierten Arbeitseinheiten abgerufen. ``` aws lakeformation get-work-units \ --query-id='1234273f-4a62-4cda-8d98-69615ee8be9b' ``` Ausgabe: ``` { "WorkUnitRanges": [{ "WorkUnitIdMax": 0, "WorkUnitIdMin": 0, "WorkUnitToken": "1234eMAk4kLO4umqEL4Z5WuxL04AXwABABVhd3MtY3J5cHRvLXB1YmxpYy1rZXkAREEwYm9QbkhINmFYTWphbmMxZW1PQmEyMGlUb0JFbXNlWmRYc0NmckRIR1dmQ0hjY2YzNFdMcmNXb2JGZmhEK0QvZz09AAEAB2F3cy1rbXMAS2Fybjphd3M6a21zOnVzLWVhc3QtMTo3MDkxNTAyNDkyNDk6a2V5L2VmYmI3NDUyLTY1MjYtNGJiOS1iNmZhLTEzYzJkMTM3MmU2OQC4AQIBAHg6eWNF2ZrQATTAuPDJVCEAQSyIF67vX+f88jzGrYq22gE6jkQlpOB+Oet2eqNUmFudAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQMCOEWRdafowek3RUmAgEQgDsYZZE84nnnbNmvsqCBPLh19nLQ10mUWOg9IfiaOwefEn6L920V0x1LpJACo7MtIBLXnbGcz2dFDZjFygIAAAAADAAAEAAAAAAAAAAAAAAAAAAQSQf8XDSI5pvR4Fx4JsrS/////wAAAAEAAAAAAAAAAAAAAAEAAACX3/w5h75QAPomfKH+cyEKYU1yccUmBl+VSojiGOtdsUk7vcjYXUUboYm3dvqRqX2s4gROMOn+Ij8R0/8jYmnHkpvyAFNVRPyETyIKg7k5Z9+5I1c2d3446Jw/moWGGxjH8AEG9h27ytmOhozxDOEi/F2ZoXz6wlGDfGUo/2WxCkYOhTyNaw6TM+7drTM7yrW4iNVLUM0LX0xnFjIAhLhooWJek6vjQZUAZzBlAjBH8okRtYP8R7AY2Wls/hqFBhG0V4l42AC0LxsuZbMQrE2SzWZUZ0E9Uew7/n0cyX4CMQDR79INyv4ysMByW9kKGGKyba+cCNklExMR+btBQBmMuB2fMSdmQXe9umX8Ux8XCo4=" }], "QueryId": "1234273f-4a62-4cda-8d98-69615ee8be9b" } ``` Weitere Informationen finden Sie unter [Transaktionsdatenvorgänge](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie unter [GetWorkUnits AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-units.html)*Befehlsreferenz.* ### `grant-permissions` Das folgende Codebeispiel zeigt die Verwendung`grant-permissions`. **AWS CLI** **Beispiel 1: So gewähren Sie dem Prinzipal mithilfe von LF-Tags Berechtigungen für Ressourcen** Im folgenden Beispiel für `grant-permissions` werden dem Prinzipal ALLE Berechtigungen für eine Datenbankressource erteilt, die der LF-Tag-Richtlinie entspricht. ``` aws lakeformation grant-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin" }, "Resource": { "LFTagPolicy": { "CatalogId": "123456789111", "ResourceType": "DATABASE", "Expression": [{ "TagKey": "usergroup", "TagValues": [ "analyst", "developer" ] }] } }, "Permissions": [ "ALL" ], "PermissionsWithGrantOption": [ "ALL" ] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. **Beispiel 2: So erteilen Sie dem Prinzipal Berechtigungen auf Spaltenebene** Im folgenden Beispiel für `grant-permissions` wird dem Prinzipal die Berechtigung erteilt, eine bestimmte Spalte auszuwählen. ``` aws lakeformation grant-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer" }, "Resource": { "TableWithColumns": { "CatalogId": "123456789111", "ColumnNames": ["p_end_date_sk"], "DatabaseName": "tpc", "Name": "dl_tpc_promotion" } }, "Permissions": [ "SELECT" ], "PermissionsWithGrantOption": [] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. **Beispiel 3: So erteilen Sie dem Prinzipal Tabellenberechtigungen** Im folgenden Beispiel für `grant-permissions` wird dem Prinzipal die Auswahlberechtigung für alle Tabellen einer bestimmten Datenbank erteilt. ``` aws lakeformation grant-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer" }, "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "TableWildcard": {} } }, "Permissions": [ "SELECT" ], "PermissionsWithGrantOption": [] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. **Beispiel 4: So gewähren Sie dem Prinzipal Berechtigungen für LF-Tags** Im folgenden Beispiel für `grant-permissions` wird dem Prinzipal die Zugriffsberechtigung für LF-Tags erteilt. ``` aws lakeformation grant-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer" }, "Resource": { "LFTag": { "CatalogId": "123456789111", "TagKey": "category", "TagValues": [ "private", "public" ] } }, "Permissions": [ "ASSOCIATE" ], "PermissionsWithGrantOption": [] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. **Beispiel 5: So erteilen Sie dem Prinzipal Berechtigungen für Datenspeicherorte** Im folgenden Beispiel für `grant-permissions` wird dem Prinzipal die Berechtigung für Datenspeicherorte erteilt. ``` aws lakeformation grant-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer" }, "Resource": { "DataLocation": { "CatalogId": "123456789111", "ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111" } }, "Permissions": [ "DATA_LOCATION_ACCESS" ], "PermissionsWithGrantOption": [] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [GrantPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/grant-permissions.html)in der *AWS CLI Befehlsreferenz*. ### `list-data-cells-filter` Das folgende Codebeispiel zeigt die Verwendung`list-data-cells-filter`. **AWS CLI** **So listen Sie Datenzellenfilter auf** Im folgenden Beispiel für `list-data-cells-filter` wird ein Datenzellenfilter für eine bestimmte Tabelle aufgelistet. ``` aws lakeformation list-data-cells-filter \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "MaxResults": 2, "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_promotion" } } ``` Ausgabe: ``` { "DataCellsFilters": [{ "TableCatalogId": "123456789111", "DatabaseName": "tpc", "TableName": "dl_tpc_promotion", "Name": "developer_promotion", "RowFilter": { "FilterExpression": "p_promo_name='ese'" }, "ColumnNames": [ "p_channel_details", "p_start_date_sk", "p_purpose", "p_promo_id", "p_promo_name", "p_end_date_sk", "p_discount_active" ] }, { "TableCatalogId": "123456789111", "DatabaseName": "tpc", "TableName": "dl_tpc_promotion", "Name": "developer_promotion_allrows", "RowFilter": { "FilterExpression": "TRUE", "AllRowsWildcard": {} }, "ColumnNames": [ "p_channel_details", "p_start_date_sk", "p_promo_name" ] } ], "NextToken": "2MDA2MTgwNiwibmFub3MiOjE0MDAwMDAwMH19" } ``` Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [ListDataCellsFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-data-cells-filter.html)in der *AWS CLI Befehlsreferenz*. ### `list-permissions` Das folgende Codebeispiel zeigt die Verwendung`list-permissions`. **AWS CLI** **Beispiel 1: So rufen Sie die Liste der Prinzipal-Berechtigungen für die Ressource ab** Im folgenden Beispiel für `list-permissions` wird eine Liste der Prinzipal-Berechtigungen für die Datenbankressourcen zurückgegeben. ``` aws lakeformation list-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "ResourceType": "DATABASE", "MaxResults": 2 } ``` Ausgabe: ``` { "PrincipalResourcePermissions": [{ "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-campaign-manager" }, "Resource": { "Database": { "CatalogId": "123456789111", "Name": "tpc" } }, "Permissions": [ "DESCRIBE" ], "PermissionsWithGrantOption": [] }], "NextToken": "E5SlJDSTZleUp6SWpvaU9UQTNORE0zTXpFeE5Ua3pJbjE5TENKbGVIQnBjbUYwYVc5dUlqcDdJbk5sWTI5dVpITWlPakUyTm" } ``` Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. **Beispiel 2: So rufen Sie die Liste der Prinzipal-Berechtigungen für die Tabelle mit Datenfiltern ab** Im folgenden Beispiel für `list-permissions` werden die Berechtigungen für die Tabelle mit zugehörigen Datenfiltern aufgeführt, die dem Prinzipal gewährt wurden. ``` aws lakeformation list-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_customer" } }, "IncludeRelated": "TRUE", "MaxResults": 10 } ``` Ausgabe: ``` { "PrincipalResourcePermissions": [{ "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/Admin" }, "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "customer", "Name": "customer_invoice" } }, "Permissions": [ "ALL", "ALTER", "DELETE", "DESCRIBE", "DROP", "INSERT" ], "PermissionsWithGrantOption": [ "ALL", "ALTER", "DELETE", "DESCRIBE", "DROP", "INSERT" ] }, { "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/Admin" }, "Resource": { "TableWithColumns": { "CatalogId": "123456789111", "DatabaseName": "customer", "Name": "customer_invoice", "ColumnWildcard": {} } }, "Permissions": [ "SELECT" ], "PermissionsWithGrantOption": [ "SELECT" ] }, { "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/Admin" }, "Resource": { "DataCellsFilter": { "TableCatalogId": "123456789111", "DatabaseName": "customer", "TableName": "customer_invoice", "Name": "dl_us_customer" } }, "Permissions": [ "DESCRIBE", "SELECT", "DROP" ], "PermissionsWithGrantOption": [] } ], "NextToken": "VyeUFjY291bnRQZXJtaXNzaW9ucyI6ZmFsc2V9" } ``` Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. **Beispiel 3: So rufen Sie die Liste der Prinzipal-Berechtigungen für die LF-Tags ab** Im folgenden Beispiel für `list-permissions` werden die dem Prinzipal erteilten Berechtigungen für die LF-Tags aufgelistet. ``` aws lakeformation list-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Resource": { "LFTag": { "CatalogId": "123456789111", "TagKey": "category", "TagValues": [ "private" ] } }, "MaxResults": 10 } ``` Ausgabe: ``` { "PrincipalResourcePermissions": [{ "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin" }, "Resource": { "LFTag": { "CatalogId": "123456789111", "TagKey": "category", "TagValues": [ "*" ] } }, "Permissions": [ "DESCRIBE" ], "PermissionsWithGrantOption": [ "DESCRIBE" ] }, { "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin" }, "Resource": { "LFTag": { "CatalogId": "123456789111", "TagKey": "category", "TagValues": [ "*" ] } }, "Permissions": [ "ASSOCIATE" ], "PermissionsWithGrantOption": [ "ASSOCIATE" ] } ], "NextToken": "EJwY21GMGFXOXVJanA3SW5Ocm1pc3Npb25zIjpmYWxzZX0=" } ``` Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [ListPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-permissions.html)in der *AWS CLI Befehlsreferenz*. ### `list-resources` Das folgende Codebeispiel zeigt die Verwendung`list-resources`. **AWS CLI** **So listen Sie die von Lake Formation verwalteten Ressourcen auf** Im folgenden Beispiel für `list-resources` werden die Ressourcen aufgelistet, die der von Lake Formation verwalteten Bedingung entsprechen. ``` aws lakeformation list-resources \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "FilterConditionList": [{ "Field": "ROLE_ARN", "ComparisonOperator": "CONTAINS", "StringValueList": [ "123456789111" ] }], "MaxResults": 10 } ``` Ausgabe: ``` { "ResourceInfoList": [{ "ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111", "RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole", "LastModified": "2022-07-21T02:12:46.669000+00:00" }, { "ResourceArn": "arn:aws:s3:::lf-emr-test-123456789111", "RoleArn": "arn:aws:iam::123456789111:role/EMRLFS3Role", "LastModified": "2022-07-29T16:22:03.211000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-resources.html)in der *AWS CLI Befehlsreferenz*. ### `list-transactions` Das folgende Codebeispiel zeigt die Verwendung`list-transactions`. **AWS CLI** **So listen Sie alle Transaktionsdetails auf** Im folgenden Beispiel für `list-transactions` werden Metadaten zu Transaktionen und deren Status zurückgegeben. ``` aws lakeformation list-transactions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "StatusFilter": "ALL", "MaxResults": 3 } ``` Ausgabe: ``` { "Transactions": [{ "TransactionId": "1234569f08804cb790d950d4d0fe485e", "TransactionStatus": "committed", "TransactionStartTime": "2022-08-10T14:32:29.220000+00:00", "TransactionEndTime": "2022-08-10T14:32:33.751000+00:00" }, { "TransactionId": "12345972ca8347b89825e33c5774aec4", "TransactionStatus": "committed", "TransactionStartTime": "2022-08-10T14:29:04.046000+00:00", "TransactionEndTime": "2022-08-10T14:29:09.681000+00:00" }, { "TransactionId": "12345daf6cb047dbba8ad9b0414613b2", "TransactionStatus": "committed", "TransactionStartTime": "2022-08-10T13:56:51.261000+00:00", "TransactionEndTime": "2022-08-10T13:56:51.547000+00:00" } ], "NextToken": "77X1ebypsI7os+X2lhHsZLGNCDK3nNGpwRdFpicSOHgcX1/QMoniUAKcpR3kj3ts3PVdMA==" } ``` Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [ListTransactions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-transactions.html)in der *AWS CLI Befehlsreferenz*. ### `put-data-lake-settings` Das folgende Codebeispiel zeigt die Verwendung`put-data-lake-settings`. **AWS CLI** **So legen Sie von AWS Lake Formation verwaltete Data Lake-Einstellungen fest** Im folgenden Beispiel für `put-data-lake-settings` werden die Liste der Data-Lake-Administratoren und andere Data-Lake-Einstellungen abgerufen. ``` aws lakeformation put-data-lake-settings \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "DataLakeSettings": { "DataLakeAdmins": [{ "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin" } ], "CreateDatabaseDefaultPermissions": [], "CreateTableDefaultPermissions": [], "TrustedResourceOwners": [], "AllowExternalDataFiltering": true, "ExternalDataFilteringAllowList": [{ "DataLakePrincipalIdentifier ": "123456789111" }], "AuthorizedSessionTagValueList": ["Amazon EMR"] } } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Ändern der Standardsicherheitseinstellungen für Ihren Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [PutDataLakeSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/put-data-lake-settings.html)in der *AWS CLI Befehlsreferenz*. ### `register-resource` Das folgende Codebeispiel zeigt die Verwendung`register-resource`. **AWS CLI** **Beispiel 1: So registrieren Sie Data-Lake-Speicher mit der serviceverknüpften Rolle** Im folgenden Beispiel für `register-resource` wird die Ressource mithilfe der serviceverknüpften Rolle entsprechend der Verwaltung durch Lake Formation registriert. ``` aws lakeformation register-resource \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123", "UseServiceLinkedRole": true } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen eines Amazon-S3-Standorts zu Ihrem Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) im *Entwicklerhandbuch für AWS Lake Formation*. **Beispiel 2: So registrieren Sie Data-Lake-Speicher mit der serviceverknüpften Rolle** Im folgenden Beispiel für `register-resource` wird die Ressource mit der benutzerdefinierten Rolle entsprechend der Verwaltung durch Lake Formation registriert. ``` aws lakeformation register-resource \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123", "UseServiceLinkedRole": false, "RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole" } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen eines Amazon-S3-Standorts zu Ihrem Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [RegisterResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/register-resource.html)in der *AWS CLI Befehlsreferenz*. ### `remove-lf-tags-from-resource` Das folgende Codebeispiel zeigt die Verwendung`remove-lf-tags-from-resource`. **AWS CLI** **So entfernen Sie ein LF-Tag aus einer Ressource** Im folgenden Beispiel für `remove-lf-tags-from-resource` wird die LF-Tag-Zuordnung zur Tabellenressource entfernt. ``` aws lakeformation remove-lf-tags-from-resource \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_promotion" } }, "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] } ``` Ausgabe: ``` { "Failures": [] } ``` Weitere Informationen finden Sie unter [Zuweisen von LF-Tags zu Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [RemoveLfTagsFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/remove-lf-tags-from-resource.html)in der *AWS CLI Befehlsreferenz*. ### `revoke-permissions` Das folgende Codebeispiel zeigt die Verwendung`revoke-permissions`. **AWS CLI** **So entziehen Sie dem Prinzipal Berechtigungen für Ressourcen** Im folgenden Beispiel für `revoke-permissions` wird dem Prinzipal der Zugriff auf eine bestimmte Tabelle einer angegebenen Datenbank entzogen. ``` aws lakeformation revoke-permissions \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "123456789111", "Principal": { "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer" }, "Resource": { "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_promotion" } }, "Permissions": [ "ALL" ], "PermissionsWithGrantOption": [] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [RevokePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/revoke-permissions.html)in der *AWS CLI Befehlsreferenz*. ### `search-databases-by-lf-tags` Das folgende Codebeispiel zeigt die Verwendung`search-databases-by-lf-tags`. **AWS CLI** **Um nach Datenbankressourcen zu suchen nach LFTags** Im folgenden `search-databases-by-lf-tags` Beispiel wird nach Datenbankressourcen gesucht, die dem LFTag Ausdruck entsprechen. ``` aws lakeformation search-databases-by-lf-tags \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "MaxResults": 1, "CatalogId": "123456789111", "Expression": [{ "TagKey": "usergroup", "TagValues": [ "developer" ] }] } ``` Ausgabe: ``` { "DatabaseList": [{ "Database": { "CatalogId": "123456789111", "Name": "tpc" }, "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }] } ``` Weitere Informationen finden Sie unter [Anzeigen der Ressourcen, denen ein LF-Tag zugewiesen ist](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [SearchDatabasesByLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-databases-by-lf-tags.html)unter *AWS CLI Befehlsreferenz*. ### `search-tables-by-lf-tags` Das folgende Codebeispiel zeigt die Verwendung`search-tables-by-lf-tags`. **AWS CLI** **Um nach Tabellenressourcen zu suchen nach LFTags** Im folgenden `search-tables-by-lf-tags` Beispiel wird nach Tabellenressourcen gesucht, die einem LFTag Ausdruck entsprechen. ``` aws lakeformation search-tables-by-lf-tags \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "MaxResults": 2, "CatalogId": "123456789111", "Expression": [{ "TagKey": "usergroup", "TagValues": [ "developer" ] }] } ``` Ausgabe: ``` { "NextToken": "c2VhcmNoQWxsVGFnc0luVGFibGVzIjpmYWxzZX0=", "TableList": [{ "Table": { "CatalogId": "123456789111", "DatabaseName": "tpc", "Name": "dl_tpc_item" }, "LFTagOnDatabase": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }], "LFTagsOnTable": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }], "LFTagsOnColumns": [{ "Name": "i_item_desc", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_container", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_wholesale_cost", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_manufact_id", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_brand_id", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_formulation", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_current_price", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_size", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_rec_start_date", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_manufact", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_item_sk", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_manager_id", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_item_id", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_class_id", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_class", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_category", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_category_id", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_brand", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_units", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_rec_end_date", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_color", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] }, { "Name": "i_product_name", "LFTags": [{ "CatalogId": "123456789111", "TagKey": "usergroup", "TagValues": [ "developer" ] }] } ] }] } ``` Weitere Informationen finden Sie unter [Anzeigen der Ressourcen, denen ein LF-Tag zugewiesen ist](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [SearchTablesByLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-tables-by-lf-tags.html)unter *AWS CLI Befehlsreferenz*. ### `start-query-planning` Das folgende Codebeispiel zeigt die Verwendung`start-query-planning`. **AWS CLI** **So verarbeiten Sie die Abfrageanweisung** Im folgenden Beispiel für `start-query-planning` wird eine Anforderung zur Verarbeitung einer Abfrageanweisung gesendet. ``` aws lakeformation start-query-planning \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "QueryPlanningContext": { "CatalogId": "012345678901", "DatabaseName": "tpc" }, "QueryString": "select * from dl_tpc_household_demographics_gov where hd_income_band_sk=9" } ``` Ausgabe: ``` { "QueryId": "772a273f-4a62-4cda-8d98-69615ee8be9b" } ``` Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [StartQueryPlanning](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-query-planning.html)in der *AWS CLI Befehlsreferenz*. ### `start-transaction` Das folgende Codebeispiel zeigt die Verwendung`start-transaction`. **AWS CLI** **So starten Sie eine neue Transaktion** Im folgenden Beispiel für `start-transaction` wird eine neue Transaktion gestartet und ihre Transaktions-ID zurückgegeben. ``` aws lakeformation start-transaction \ --transaction-type = 'READ_AND_WRITE' ``` Ausgabe: ``` { "TransactionId": "b014d972ca8347b89825e33c5774aec4" } ``` Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [StartTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-transaction.html)in der *AWS CLI Befehlsreferenz*. ### `update-lf-tag` Das folgende Codebeispiel zeigt die Verwendung`update-lf-tag`. **AWS CLI** **So aktualisieren Sie die LF-Tag-Definition** Im folgenden Beispiel für `update-lf-tag` wird die LF-Tag-Definition aktualisiert. ``` aws lakeformation update-lf-tag \ --catalog-id '123456789111' \ --tag-key 'usergroup' \ --tag-values-to-add '["admin"]' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von LF-Tags für die Zugriffssteuerung für Metadaten](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [UpdateLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-lf-tag.html)in der *AWS CLI Befehlsreferenz*. ### `update-table-objects` Das folgende Codebeispiel zeigt die Verwendung`update-table-objects`. **AWS CLI** **So ändern Sie Objekte einer verwalteten Tabelle** Im folgenden Beispiel für `update-table-objects` werden der angegebenen verwalteten Tabelle bereitgestellte S3-Objekte hinzugefügt. ``` aws lakeformation update-table-objects \ --cli-input-json file://input.json ``` Inhalt von `input.json`: ``` { "CatalogId": "012345678901", "DatabaseName": "tpc", "TableName": "dl_tpc_household_demographics_gov", "TransactionId": "12347a9f75424b9b915f6ff201d2a190", "WriteOperations": [{ "AddObject": { "Uri": "s3://lf-data-lake-012345678901/target/dl_tpc_household_demographics_gov/run-unnamed-1-part-block-0-r-00000-snappy-ff26b17504414fe88b302cd795eabd00.parquet", "ETag": "1234ab1fc50a316b149b4e1f21a73800", "Size": 42200 } }] } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*. + Einzelheiten zur API finden Sie [UpdateTableObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-table-objects.html)in der *AWS CLI Befehlsreferenz*. # Lambda-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Lambda Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-layer-version-permission` Das folgende Codebeispiel zeigt, wie Sie`add-layer-version-permission`. **AWS CLI** **So fügen Sie einer Layer-Version Berechtigungen hinzu** Im folgenden Beispiel für `add-layer-version-permission` wird dem angegebenen Konto die Berechtigung erteilt, Version 1 des Layers `my-layer` zu verwenden. ``` aws lambda add-layer-version-permission \ --layer-name my-layer \ --statement-id xaccount \ --action lambda:GetLayerVersion \ --principal 123456789012 \ --version-number 1 ``` Ausgabe: ``` { "RevisionId": "35d87451-f796-4a3f-a618-95a3671b0a0c", "Statement": { "Sid":"xaccount", "Effect":"Allow", "Principal":{ "AWS":"arn:aws:iam::210987654321:root" }, "Action":"lambda:GetLayerVersion", "Resource":"arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1" } } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [AddLayerVersionPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/add-layer-version-permission.html)in der *AWS CLI Befehlsreferenz*. ### `add-permission` Das folgende Codebeispiel zeigt die Verwendung`add-permission`. **AWS CLI** **So fügen Sie einer vorhandenen Lambda-Funktion Berechtigungen hinzu** Im folgenden Beispiel für `add-permission` wird die Berechtigung für den Amazon-SNS-Service zum Aufrufen einer Funktion namens `my-function` erteilt. ``` aws lambda add-permission \ --function-name my-function \ --action lambda:InvokeFunction \ --statement-id sns \ --principal sns.amazonaws.com ``` Ausgabe: ``` { "Statement": { "Sid":"sns", "Effect":"Allow", "Principal":{ "Service":"sns.amazonaws.com" }, "Action":"lambda:InvokeFunction", "Resource":"arn:aws:lambda:us-east-2:123456789012:function:my-function" } } ``` *Weitere Informationen finden Sie unter [Using Resource-based Policies for AWS Lambda im Lambda](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html) Developer Guide AWS .* + *Einzelheiten zur API finden Sie unter [AddPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/add-permission.html)Befehlsreferenz.AWS CLI * ### `create-alias` Das folgende Codebeispiel zeigt die Verwendung`create-alias`. **AWS CLI** **So erstellen Sie einen Alias für eine Lambda-Funktion** Im folgenden Beispiel für `create-alias` wird ein Alias namens `LIVE` erstellt, der auf Version 1 der `my-function`-Lambda-Funktion verweist. ``` aws lambda create-alias \ --function-name my-function \ --description "alias for live version of function" \ --function-version 1 \ --name LIVE ``` Ausgabe: ``` { "FunctionVersion": "1", "Name": "LIVE", "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE", "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6", "Description": "alias for live version of function" } ``` Weitere Informationen finden Sie unter [Konfiguration von AWS Lambda-Funktionsaliasen](https://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html) im *AWS Lambda* Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [CreateAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/create-alias.html).AWS CLI * ### `create-event-source-mapping` Das folgende Codebeispiel zeigt die Verwendung`create-event-source-mapping`. **AWS CLI** **Um eine Zuordnung zwischen einer Ereignisquelle und einer AWS Lambda-Funktion zu erstellen** Im folgenden Beispiel für `create-event-source-mapping` wird eine Zuordnung zwischen einer SQS-Warteschlange und der `my-function`-Lambda-Funktion erstellt. ``` aws lambda create-event-source-mapping \ --function-name my-function \ --batch-size 5 \ --event-source-arn arn:aws:sqs:us-west-2:123456789012:mySQSqueue ``` Ausgabe: ``` { "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569284520.333, "BatchSize": 5, "State": "Creating", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Zuordnung von Ereignisquellen](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [CreateEventSourceMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/create-event-source-mapping.html)in der *AWS CLI Befehlsreferenz.* ### `create-function` Das folgende Codebeispiel zeigt die Verwendung`create-function`. **AWS CLI** **So erstellen Sie eine Lambda-Funktion** Im folgenden Beispiel für `create-function` wird eine Lambda-Funktion mit dem Namen `my-function` erstellt. ``` aws lambda create-function \ --function-name my-function \ --runtime nodejs22.x \ --zip-file fileb://my-function.zip \ --handler my-function.handler \ --role arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-tges6bf4 ``` Inhalt von `my-function.zip`: ``` This file is a deployment package that contains your function code and any dependencies. ``` Ausgabe: ``` { "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "PFn4S+er27qk+UuZSTKEQfNKG/XNn7QJs90mJgq6oH8=", "FunctionName": "my-function", "CodeSize": 308, "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6", "MemorySize": 128, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Version": "$LATEST", "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4", "Timeout": 3, "LastModified": "2025-10-14T22:26:11.234+0000", "Handler": "my-function.handler", "Runtime": "nodejs22.x", "Description": "" } ``` Weitere Informationen finden Sie unter [Konfigurieren des Speichers der Lambda-Funktion](https://docs.aws.amazon.com/lambda/latest/dg/configuration-memory.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [CreateFunction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/create-function.html)in der *AWS CLI Befehlsreferenz*. ### `delete-alias` Das folgende Codebeispiel zeigt die Verwendung`delete-alias`. **AWS CLI** **So löschen Sie einen Alias einer Lambda-Funktion** Im folgenden Beispiel für `delete-alias` wird der Alias mit dem Namen `LIVE` aus der `my-function`-Lambda-Funktion gelöscht. ``` aws lambda delete-alias \ --function-name my-function \ --name LIVE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfiguration von AWS Lambda-Funktionsaliasen](https://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html) im *AWS Lambda* Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [DeleteAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/delete-alias.html).AWS CLI * ### `delete-event-source-mapping` Das folgende Codebeispiel zeigt die Verwendung`delete-event-source-mapping`. **AWS CLI** **Um die Zuordnung zwischen einer Ereignisquelle und einer AWS Lambda-Funktion zu löschen** Im folgenden Beispiel für `delete-event-source-mapping` wird die Zuordnung zwischen einer SQS-Warteschlange und der Lambda-Funktion `my-function` gelöscht. ``` aws lambda delete-event-source-mapping \ --uuid a1b2c3d4-5678-90ab-cdef-11111EXAMPLE ``` Ausgabe: ``` { "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569285870.271, "BatchSize": 5, "State": "Deleting", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Zuordnung von Ereignisquellen](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [DeleteEventSourceMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/delete-event-source-mapping.html)in der *AWS CLI Befehlsreferenz.* ### `delete-function-concurrency` Das folgende Codebeispiel zeigt die Verwendung`delete-function-concurrency`. **AWS CLI** **So entfernen Sie das Limit für die reservierte gleichzeitige Ausführung einer Funktion** Im folgenden `delete-function-concurrency`-Beispiel wird das reservierte Limit für gleichzeitige Ausführung aus der `my-function`-Funktion gelöscht. ``` aws lambda delete-function-concurrency \ --function-name my-function ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Gleichzeitigkeit für eine Lambda-Funktion reservieren](https://docs.aws.amazon.com/lambda/latest/dg/per-function-concurrency.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [DeleteFunctionConcurrency](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/delete-function-concurrency.html)in der *AWS CLI Befehlsreferenz*. ### `delete-function-event-invoke-config` Das folgende Codebeispiel zeigt die Verwendung`delete-function-event-invoke-config`. **AWS CLI** **So löschen Sie eine Konfiguration für asynchronen Aufruf** Im folgenden Beispiel für `delete-function-event-invoke-config` wird die Konfiguration für asynchronen Aufruf für den `GREEN`-Alias der angegebenen Funktion gelöscht. ``` aws lambda delete-function-event-invoke-config --function-name my-function:GREEN ``` + Einzelheiten zur API finden Sie [DeleteFunctionEventInvokeConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/delete-function-event-invoke-config.html)in der *AWS CLI Befehlsreferenz*. ### `delete-function` Das folgende Codebeispiel zeigt die Verwendung`delete-function`. **AWS CLI** **Beispiel 1: So löschen Sie eine Lambda-Funktion anhand des Funktionsnamens** Im folgenden Beispiel für `delete-function` wird die Lambda-Funktion `my-function` durch Angabe des Funktionsnamens gelöscht. ``` aws lambda delete-function \ --function-name my-function ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: Eine Lambda-Funktion anhand des Funktions-ARN löschen** Im folgenden Beispiel für `delete-function` wird die Lambda-Funktion `my-function` durch Angabe des ARN der Funktion gelöscht. ``` aws lambda delete-function \ --function-name arn:aws:lambda:us-west-2:123456789012:function:my-function ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 3: Eine Lambda-Funktion anhand eines teilweisen Funktions-ARN löschen** Im folgenden Beispiel für `delete-function` wird die Lambda-Funktion `my-function` durch Angabe des teilweisen ARN der Funktion gelöscht. ``` aws lambda delete-function \ --function-name 123456789012:function:my-function ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Konfigurieren von AWS -Lambda-Funktionen](https://docs.aws.amazon.com/lambda/latest/dg/resource-model.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [DeleteFunction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/delete-function.html)in der *AWS CLI Befehlsreferenz*. ### `delete-layer-version` Das folgende Codebeispiel zeigt die Verwendung`delete-layer-version`. **AWS CLI** **So löschen Sie eine Version eines Lambda-Layers** Im folgenden Beispiel für `delete-layer-version` wird Version 2 des Layers namens `my-layer` gelöscht. ``` aws lambda delete-layer-version \ --layer-name my-layer \ --version-number 2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [AWS -Lambda-Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [DeleteLayerVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/delete-layer-version.html)in der *AWS CLI Befehlsreferenz*. ### `delete-provisioned-concurrency-config` Das folgende Codebeispiel zeigt die Verwendung`delete-provisioned-concurrency-config`. **AWS CLI** **So löschen Sie eine bereitgestellte Gleichzeitigkeitskonfiguration** Das folgende `delete-provisioned-concurrency-config`-Beispiel löscht die bereitgestellte Gleichzeitigkeitskonfiguration für den `GREEN`-Alias der angegebenen Funktion. ``` aws lambda delete-provisioned-concurrency-config \ --function-name my-function \ --qualifier GREEN ``` + Einzelheiten zur API finden Sie [DeleteProvisionedConcurrencyConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/delete-provisioned-concurrency-config.html)in der *AWS CLI Befehlsreferenz*. ### `get-account-settings` Das folgende Codebeispiel zeigt die Verwendung`get-account-settings`. **AWS CLI** **Um Details zu Ihrem Konto in einer AWS Region abzurufen** Im folgenden `get-account-settings`-Beispiel werden die Lambda-Grenzwerte und Nutzungsinformationen für Ihr Konto angezeigt. ``` aws lambda get-account-settings ``` Ausgabe: ``` { "AccountLimit": { "CodeSizeUnzipped": 262144000, "UnreservedConcurrentExecutions": 1000, "ConcurrentExecutions": 1000, "CodeSizeZipped": 52428800, "TotalCodeSize": 80530636800 }, "AccountUsage": { "FunctionCount": 4, "TotalCodeSize": 9426 } } ``` Weitere Informationen finden Sie unter [AWS Lambda Limits](https://docs.aws.amazon.com/lambda/latest/dg/limits.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [GetAccountSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-account-settings.html)in der *AWS CLI Befehlsreferenz*. ### `get-alias` Das folgende Codebeispiel zeigt die Verwendung`get-alias`. **AWS CLI** **So rufen Sie Details über einen Funktionsalias ab** Das folgende `get-alias`-Beispiel zeigt Details für den Alias namens `LIVE` für die `my-function`-Lambda-Funktion an. ``` aws lambda get-alias \ --function-name my-function \ --name LIVE ``` Ausgabe: ``` { "FunctionVersion": "3", "Name": "LIVE", "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE", "RevisionId": "594f41fb-b85f-4c20-95c7-6ca5f2a92c93", "Description": "alias for live version of function" } ``` Weitere Informationen finden Sie unter [Konfiguration von AWS Lambda-Funktionsaliasen](https://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html) im *AWS Lambda* Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [GetAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-alias.html).AWS CLI * ### `get-event-source-mapping` Das folgende Codebeispiel zeigt die Verwendung`get-event-source-mapping`. **AWS CLI** **So rufen Sie Details zu einer Zuordnung von Ereignisquellen ab** Das folgende Beispiel für `get-event-source-mapping` zeigt die Details für die Zuordnung zwischen einer SQS-Warteschlange und der Lambda-Funktion `my-function` an. ``` aws lambda get-event-source-mapping \ --uuid "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" ``` Ausgabe: ``` { "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569284520.333, "BatchSize": 5, "State": "Enabled", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Zuordnung von Ereignisquellen](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [GetEventSourceMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-event-source-mapping.html)in der *AWS CLI Befehlsreferenz*. ### `get-function-concurrency` Das folgende Codebeispiel zeigt die Verwendung`get-function-concurrency`. **AWS CLI** **So zeigen Sie die reservierte Gleichzeitigkeitseinstellung für eine Funktion an** Das folgende `get-function-concurrency`-Beispiel ruft die reservierte Gleichzeitigkeitseinstellung für die angegebene Funktion ab. ``` aws lambda get-function-concurrency \ --function-name my-function ``` Ausgabe: ``` { "ReservedConcurrentExecutions": 250 } ``` + Einzelheiten zur API finden Sie [GetFunctionConcurrency](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-function-concurrency.html)in der *AWS CLI Befehlsreferenz*. ### `get-function-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-function-configuration`. **AWS CLI** **So rufen Sie die versionsspezifischen Einstellungen einer Lambda-Funktion ab** Das folgende `get-function-configuration`-Beispiel zeigt die Einstellungen für Version 2 der `my-function`-Funktion. ``` aws lambda get-function-configuration \ --function-name my-function:2 ``` Ausgabe: ``` { "FunctionName": "my-function", "LastModified": "2019-09-26T20:28:40.438+0000", "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d", "MemorySize": 256, "Version": "2", "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq", "Timeout": 3, "Runtime": "nodejs10.x", "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=", "Description": "", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:2", "Handler": "index.handler" } ``` Weitere Informationen finden Sie unter [Konfigurieren von AWS -Lambda-Funktionen](https://docs.aws.amazon.com/lambda/latest/dg/resource-model.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [GetFunctionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-function-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-function-event-invoke-config` Das folgende Codebeispiel zeigt die Verwendung`get-function-event-invoke-config`. **AWS CLI** **So zeigen Sie eine Konfiguration für asynchronen Aufruf an** Im folgenden Beispiel für `get-function-event-invoke-config` wird die Konfiguration für asynchronen Aufruf für den Alias `BLUE` der angegebenen Funktion abgerufen. ``` aws lambda get-function-event-invoke-config \ --function-name my-function:BLUE ``` Ausgabe: ``` { "LastModified": 1577824396.653, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE", "MaximumRetryAttempts": 0, "MaximumEventAgeInSeconds": 3600, "DestinationConfig": { "OnSuccess": {}, "OnFailure": { "Destination": "arn:aws:sqs:us-east-2:123456789012:failed-invocations" } } } ``` + Einzelheiten zur API finden Sie [GetFunctionEventInvokeConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-function-event-invoke-config.html)in der *AWS CLI Befehlsreferenz*. ### `get-function` Das folgende Codebeispiel zeigt die Verwendung`get-function`. **AWS CLI** **So rufen Sie Informationen über eine Funktion ab** Das folgende Beispiel für `get-function` zeigt Informationen zur Funktion `my-function` an. ``` aws lambda get-function \ --function-name my-function ``` Ausgabe: ``` { "Concurrency": { "ReservedConcurrentExecutions": 100 }, "Code": { "RepositoryType": "S3", "Location": "https://awslambda-us-west-2-tasks.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-function..." }, "Configuration": { "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "5tT2qgzYUHoqwR616pZ2dpkn/0J1FrzJmlKidWaaCgk=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 128, "RevisionId": "28f0fb31-5c5c-43d3-8955-03e76c5c1075", "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2025-09-24T18:20:35.054+0000", "Runtime": "nodejs22.x", "Description": "" } } ``` Weitere Informationen finden Sie unter [Konfigurieren des Speichers der Lambda-Funktion](https://docs.aws.amazon.com/lambda/latest/dg/configuration-memory.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [GetFunction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-function.html)in der *AWS CLI Befehlsreferenz*. ### `get-layer-version-by-arn` Das folgende Codebeispiel zeigt die Verwendung`get-layer-version-by-arn`. **AWS CLI** **So rufen Sie Informationen zu einer Lambda-Layer-Version ab** Im folgenden Beispiel für `get-layer-version-by-arn` werden Informationen zur Layer-Version mit dem angegebenen Amazon-Ressourcennamen (ARN) angezeigt. ``` aws lambda get-layer-version-by-arn \ --arn "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x:2" ``` Ausgabe: ``` { "LayerVersionArn": "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x:2", "Description": "AWS Lambda SciPy layer for Python 3.11 (scipy-1.1.0, numpy-1.15.4) https://github.com/scipy/scipy/releases/tag/v1.1.0 https://github.com/numpy/numpy/releases/tag/v1.15.4", "CreatedDate": "2023-10-12T10:09:38.398+0000", "LayerArn": "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x", "Content": { "CodeSize": 41784542, "CodeSha256": "GGmv8ocUw4cly0T8HL0Vx/f5V4RmSCGNjDIslY4VskM=", "Location": "https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/..." }, "Version": 2, "CompatibleRuntimes": [ "python3.11" ], "LicenseInfo": "SciPy: https://github.com/scipy/scipy/blob/main/LICENSE.txt, NumPy: https://github.com/numpy/numpy/blob/main/LICENSE.txt" } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [GetLayerVersionByArn](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-layer-version-by-arn.html)in der *AWS CLI Befehlsreferenz*. ### `get-layer-version-policy` Das folgende Codebeispiel zeigt die Verwendung`get-layer-version-policy`. **AWS CLI** **So rufen Sie die Berechtigungsrichtlinie für eine Lambda-Layer-Version ab** Im folgenden Beispiel für `get-layer-version-policy` werden Richtlinieninformationen zu Version 1 für den Layer namens `my-layer` angezeigt. ``` aws lambda get-layer-version-policy \ --layer-name my-layer \ --version-number 1 ``` Ausgabe: ``` { "Policy": { "Version":"2012-10-17", "Id":"default", "Statement": [ { "Sid":"xaccount", "Effect":"Allow", "Principal": {"AWS":"arn:aws:iam::123456789012:root"}, "Action":"lambda:GetLayerVersion", "Resource":"arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1" } ] }, "RevisionId": "c68f21d2-cbf0-4026-90f6-1375ee465cd0" } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [GetLayerVersionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-layer-version-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-layer-version` Das folgende Codebeispiel zeigt die Verwendung`get-layer-version`. **AWS CLI** **So rufen Sie Informationen zu einer Lambda-Layer-Version ab** Im folgenden Beispiel für `get-layer-version` werden Informationen zu Version 1 des Layers namens `my-layer` angezeigt. ``` aws lambda get-layer-version \ --layer-name my-layer \ --version-number 1 ``` Ausgabe: ``` { "Content": { "Location": "https://awslambda-us-east-2-layers.s3.us-east-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...", "CodeSha256": "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=", "CodeSize": 169 }, "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer", "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1", "Description": "My Python layer", "CreatedDate": "2018-11-14T23:03:52.894+0000", "Version": 1, "LicenseInfo": "MIT", "CompatibleRuntimes": [ "python3.10", "python3.11" ] } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [GetLayerVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-layer-version.html)in der *AWS CLI Befehlsreferenz*. ### `get-policy` Das folgende Codebeispiel zeigt die Verwendung`get-policy`. **AWS CLI** **So rufen Sie die ressourcenbasierte IAM-Richtlinie für eine Funktion, eine Version oder einen Alias ab** Das folgende `get-policy`-Beispiel zeigt Richtlinieninformationen über die `my-function`-Lambda-Funktion an. ``` aws lambda get-policy \ --function-name my-function ``` Ausgabe: ``` { "Policy": { "Version":"2012-10-17", "Id":"default", "Statement": [ { "Sid":"iot-events", "Effect":"Allow", "Principal": {"Service":"iotevents.amazonaws.com"}, "Action":"lambda:InvokeFunction", "Resource":"arn:aws:lambda:us-west-2:123456789012:function:my-function" } ] }, "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668" } ``` *Weitere Informationen finden Sie unter [Using Resource-based Policies for AWS Lambda im Lambda](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html) Developer Guide AWS .* + *Einzelheiten zur API finden Sie unter [GetPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-policy.html)Befehlsreferenz.AWS CLI * ### `get-provisioned-concurrency-config` Das folgende Codebeispiel zeigt die Verwendung`get-provisioned-concurrency-config`. **AWS CLI** **So zeigen Sie eine bereitgestellte Gleichzeitigkeitskonfiguration an** Im folgenden `get-provisioned-concurrency-config`-Beispiel werden Details für die bereitgestellte Gleichzeitigkeitskonfiguration für den `BLUE`-Alias der angegebenen Funktion angezeigt. ``` aws lambda get-provisioned-concurrency-config \ --function-name my-function \ --qualifier BLUE ``` Ausgabe: ``` { "RequestedProvisionedConcurrentExecutions": 100, "AvailableProvisionedConcurrentExecutions": 100, "AllocatedProvisionedConcurrentExecutions": 100, "Status": "READY", "LastModified": "2019-12-31T20:28:49+0000" } ``` + Einzelheiten zur API finden Sie [GetProvisionedConcurrencyConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/get-provisioned-concurrency-config.html)in der *AWS CLI Befehlsreferenz*. ### `invoke` Das folgende Codebeispiel zeigt die Verwendung`invoke`. **AWS CLI** **Beispiel 1: Eine Lambda-Funktion synchron aufrufen** Im folgenden Beispiel für `invoke` wird die Funktion `my-function` synchron aufgerufen. Die `cli-binary-format` Option ist erforderlich, wenn Sie AWS CLI Version 2 verwenden. Weitere Informationen finden Sie unter [Von der AWS CLI unterstützte globale Befehlszeilenoptionen](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-options.html#cli-configure-options-list) im *AWS -CLI-Benutzerhandbuch*. ``` aws lambda invoke \ --function-name my-function \ --cli-binary-format raw-in-base64-out \ --payload '{ "name": "Bob" }' \ response.json ``` Ausgabe: ``` { "ExecutedVersion": "$LATEST", "StatusCode": 200 } ``` Weitere Informationen finden Sie unter [Synchrones Aufrufen einer Lambda-Funktion](https://docs.aws.amazon.com/lambda/latest/dg/invocation-sync.html) im *Entwicklerhandbuch für AWS Lambda*. **Beispiel 2: Eine Lambda-Funktion asynchron aufrufen** Im folgenden Beispiel für `invoke` wird die Funktion `my-function` asynchron aufgerufen. Die `cli-binary-format` Option ist erforderlich, wenn Sie AWS CLI Version 2 verwenden. Weitere Informationen finden Sie unter [Von der AWS CLI unterstützte globale Befehlszeilenoptionen](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-options.html#cli-configure-options-list) im *AWS -CLI-Benutzerhandbuch*. ``` aws lambda invoke \ --function-name my-function \ --invocation-type Event \ --cli-binary-format raw-in-base64-out \ --payload '{ "name": "Bob" }' \ response.json ``` Ausgabe: ``` { "StatusCode": 202 } ``` Weitere Informationen finden Sie unter [Asynchrones Aufrufen einer Lambda-Funktion](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html) im *Entwicklerhandbuch für AWS Lambda*. + Weitere API-Informationen finden Sie unter [Invoke](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/invoke.html) in der *AWS CLI -Befehlsreferenz*. ### `list-aliases` Das folgende Codebeispiel zeigt, wie Sie es verwenden`list-aliases`. **AWS CLI** **So rufen Sie die Liste der Aliasnamen für eine Lambda-Funktion ab** Im folgenden Beispiel für `list-aliases` wird eine Liste der Aliasnamen für die `my-function`-Lambda-Funktion angezeigt. ``` aws lambda list-aliases \ --function-name my-function ``` Ausgabe: ``` { "Aliases": [ { "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:BETA", "RevisionId": "a410117f-ab16-494e-8035-7e204bb7933b", "FunctionVersion": "2", "Name": "BETA", "Description": "alias for beta version of function" }, { "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE", "RevisionId": "21d40116-f8b1-40ba-9360-3ea284da1bb5", "FunctionVersion": "1", "Name": "LIVE", "Description": "alias for live version of function" } ] } ``` Weitere Informationen finden Sie unter [Konfiguration von AWS Lambda-Funktionsaliasen](https://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html) im *AWS Lambda* Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [ListAliases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/list-aliases.html).AWS CLI * ### `list-event-source-mappings` Das folgende Codebeispiel zeigt die Verwendung`list-event-source-mappings`. **AWS CLI** **So listen Sie die Zuordnungen von Ereignisquellen für eine Funktion auf** Im folgenden Beispiel für `list-event-source-mappings` wird eine Liste der Zuordnungen von Ereignisquellen für die `my-function`-Lambda-Funktion angezeigt. ``` aws lambda list-event-source-mappings \ --function-name my-function ``` Ausgabe: ``` { "EventSourceMappings": [ { "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569284520.333, "BatchSize": 5, "State": "Enabled", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" } ] } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Zuordnung von Ereignisquellen](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [ListEventSourceMappings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/list-event-source-mappings.html)in der *AWS CLI Befehlsreferenz*. ### `list-function-event-invoke-configs` Das folgende Codebeispiel zeigt die Verwendung`list-function-event-invoke-configs`. **AWS CLI** **So zeigen Sie eine Liste der Konfigurationen für asynchronen Aufruf an** Das folgende Beispiel für `list-function-event-invoke-configs` listet die Konfigurationen für asynchronen Aufruf für die angegebene Funktion auf. ``` aws lambda list-function-event-invoke-configs \ --function-name my-function ``` Ausgabe: ``` { "FunctionEventInvokeConfigs": [ { "LastModified": 1577824406.719, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN", "MaximumRetryAttempts": 2, "MaximumEventAgeInSeconds": 1800 }, { "LastModified": 1577824396.653, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE", "MaximumRetryAttempts": 0, "MaximumEventAgeInSeconds": 3600 } ] } ``` + Einzelheiten zur API finden Sie [ListFunctionEventInvokeConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/list-function-event-invoke-configs.html)in der *AWS CLI Befehlsreferenz*. ### `list-functions` Das folgende Codebeispiel zeigt die Verwendung`list-functions`. **AWS CLI** **Eine Liste der Lambda-Funktionen abrufen** Im folgenden Beispiel für `list-functions` wird eine Liste aller Funktionen für den aktuellen Benutzer angezeigt. ``` aws lambda list-functions ``` Ausgabe: ``` { "Functions": [ { "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=", "FunctionName": "helloworld", "MemorySize": 128, "RevisionId": "1718e831-badf-4253-9518-d0644210af7b", "CodeSize": 294, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:helloworld", "Handler": "helloworld.handler", "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4", "Timeout": 3, "LastModified": "2025-09-23T18:32:33.857+0000", "Runtime": "nodejs22.x", "Description": "" }, { "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 256, "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668", "CodeSize": 266, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2025-10-01T16:47:28.490+0000", "Runtime": "nodejs22.x", "Description": "" }, { "Layers": [ { "CodeSize": 41784542, "Arn": "arn:aws:lambda:us-west-2:420165488524:layer:AWSLambda-Python37-SciPy1x:2" }, { "CodeSize": 4121, "Arn": "arn:aws:lambda:us-west-2:123456789012:layer:pythonLayer:1" } ], "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "ZQukCqxtkqFgyF2cU41Avj99TKQ/hNihPtDtRcc08mI=", "FunctionName": "my-python-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 128, "RevisionId": "80b4eabc-acf7-4ea8-919a-e874c213707d", "CodeSize": 299, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-python-function", "Handler": "lambda_function.lambda_handler", "Role": "arn:aws:iam::123456789012:role/service-role/my-python-function-role-z5g7dr6n", "Timeout": 3, "LastModified": "2025-10-01T19:40:41.643+0000", "Runtime": "python3.11", "Description": "" } ] } ``` Weitere Informationen finden Sie unter [Konfigurieren des Speichers der Lambda-Funktion](https://docs.aws.amazon.com/lambda/latest/dg/configuration-memory.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [ListFunctions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/list-functions.html)in der *AWS CLI Befehlsreferenz*. ### `list-layer-versions` Das folgende Codebeispiel zeigt die Verwendung`list-layer-versions`. **AWS CLI** **Um die Versionen einer AWS Lambda-Schicht aufzulisten** Im folgenden Beispiel für `list-layers-versions` werden Informationen zu den Versionen für den Layer namens `my-layer` angezeigt. ``` aws lambda list-layer-versions \ --layer-name my-layer ``` Ausgabe: ``` { "Layers": [ { "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2", "Version": 2, "Description": "My layer", "CreatedDate": "2023-11-15T00:37:46.592+0000", "CompatibleRuntimes": [ "python3.10", "python3.11" ] } ] } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie unter [ListLayerVersions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/list-layer-versions.html)*Befehlsreferenz.* ### `list-layers` Das folgende Codebeispiel zeigt die Verwendung`list-layers`. **AWS CLI** **So listen Sie die Layer auf, die mit der Laufzeit Ihrer Funktion kompatibel sind** Im folgenden Beispiel für `list-layers` werden Informationen zu Layern angezeigt, die mit der Python 3.11-Laufzeit kompatibel sind. ``` aws lambda list-layers \ --compatible-runtime python3.11 ``` Ausgabe: ``` { "Layers": [ { "LayerName": "my-layer", "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer", "LatestMatchingVersion": { "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2", "Version": 2, "Description": "My layer", "CreatedDate": "2023-11-15T00:37:46.592+0000", "CompatibleRuntimes": [ "python3.10", "python3.11" ] } } ] } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [ListLayers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/list-layers.html)in der *AWS CLI Befehlsreferenz*. ### `list-provisioned-concurrency-configs` Das folgende Codebeispiel zeigt die Verwendung`list-provisioned-concurrency-configs`. **AWS CLI** **So erhalten Sie eine Liste der bereitgestellten Gleichzeitigkeitskonfigurationen** Das folgende `list-provisioned-concurrency-configs`-Beispiel listet die bereitgestellten Gleichzeitigkeitskonfigurationen für die angegebene Funktion auf. ``` aws lambda list-provisioned-concurrency-configs \ --function-name my-function ``` Ausgabe: ``` { "ProvisionedConcurrencyConfigs": [ { "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN", "RequestedProvisionedConcurrentExecutions": 100, "AvailableProvisionedConcurrentExecutions": 100, "AllocatedProvisionedConcurrentExecutions": 100, "Status": "READY", "LastModified": "2019-12-31T20:29:00+0000" }, { "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE", "RequestedProvisionedConcurrentExecutions": 100, "AvailableProvisionedConcurrentExecutions": 100, "AllocatedProvisionedConcurrentExecutions": 100, "Status": "READY", "LastModified": "2019-12-31T20:28:49+0000" } ] } ``` + Einzelheiten zur API finden Sie [ListProvisionedConcurrencyConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/list-provisioned-concurrency-configs.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags` Das folgende Codebeispiel zeigt die Verwendung`list-tags`. **AWS CLI** **So rufen Sie die Liste der Tags für eine Lambda-Funktion ab** Das folgende `list-tags`-Beispiel zeigt die an die `my-function`-Lambda-Funktion angehängten Tags an. ``` aws lambda list-tags \ --resource arn:aws:lambda:us-west-2:123456789012:function:my-function ``` Ausgabe: ``` { "Tags": { "Category": "Web Tools", "Department": "Sales" } } ``` Weitere Informationen finden Sie unter [Tagging von Lambda-Funktionen](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [ListTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/list-tags.html)in der *AWS CLI Befehlsreferenz*. ### `list-versions-by-function` Das folgende Codebeispiel zeigt die Verwendung`list-versions-by-function`. **AWS CLI** **So rufen Sie eine Liste der Versionen einer Funktion ab** Im folgenden `list-versions-by-function`-Beispiel wird die Liste der Versionen für die `my-function`-Lambda-Funktion angezeigt. ``` aws lambda list-versions-by-function \ --function-name my-function ``` Ausgabe: ``` { "Versions": [ { "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 256, "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668", "CodeSize": 266, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:$LATEST", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2019-10-01T16:47:28.490+0000", "Runtime": "nodejs10.x", "Description": "" }, { "TracingConfig": { "Mode": "PassThrough" }, "Version": "1", "CodeSha256": "5tT2qgzYUHoqwR616pZ2dpkn/0J1FrzJmlKidWaaCgk=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 256, "RevisionId": "949c8914-012e-4795-998c-e467121951b1", "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:1", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2019-09-26T20:28:40.438+0000", "Runtime": "nodejs10.x", "Description": "new version" }, { "TracingConfig": { "Mode": "PassThrough" }, "Version": "2", "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 256, "RevisionId": "cd669f21-0f3d-4e1c-9566-948837f2e2ea", "CodeSize": 266, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:2", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2019-10-01T16:47:28.490+0000", "Runtime": "nodejs10.x", "Description": "newer version" } ] } ``` Weitere Informationen finden Sie unter [Konfiguration von AWS Lambda-Funktionsaliasen](https://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html) im *AWS Lambda* Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [ListVersionsByFunction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/list-versions-by-function.html).AWS CLI * ### `publish-layer-version` Das folgende Codebeispiel zeigt die Verwendung`publish-layer-version`. **AWS CLI** **So erstellen Sie eine Lambda-Layer-Version** Im folgenden Beispiel für `publish-layer-version` wird eine neue Layer-Version einer Python-Bibliothek erstellt. Der Befehl ruft den Layer-Inhalt einer Datei namens `layer.zip` im angegebenen S3-Bucket ab. ``` aws lambda publish-layer-version \ --layer-name my-layer \ --description "My Python layer" \ --license-info "MIT" \ --content S3Bucket=lambda-layers-us-west-2-123456789012,S3Key=layer.zip \ --compatible-runtimes python3.10 python3.11 ``` Ausgabe: ``` { "Content": { "Location": "https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...", "CodeSha256": "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=", "CodeSize": 169 }, "LayerArn": "arn:aws:lambda:us-west-2:123456789012:layer:my-layer", "LayerVersionArn": "arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1", "Description": "My Python layer", "CreatedDate": "2023-11-14T23:03:52.894+0000", "Version": 1, "LicenseInfo": "MIT", "CompatibleRuntimes": [ "python3.10", "python3.11" ] } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [PublishLayerVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/publish-layer-version.html)in der *AWS CLI Befehlsreferenz*. ### `publish-version` Das folgende Codebeispiel zeigt die Verwendung`publish-version`. **AWS CLI** **So veröffentlichen Sie eine neue Version einer Funktion** Im folgenden Beispiel für `publish-version` wird eine neue Version der `my-function`-Lambda-Funktion veröffentlicht. ``` aws lambda publish-version \ --function-name my-function ``` Ausgabe: ``` { "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=", "FunctionName": "my-function", "CodeSize": 294, "RevisionId": "f31d3d39-cc63-4520-97d4-43cd44c94c20", "MemorySize": 128, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:3", "Version": "2", "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4", "Timeout": 3, "LastModified": "2019-09-23T18:32:33.857+0000", "Handler": "my-function.handler", "Runtime": "nodejs10.x", "Description": "" } ``` Weitere Informationen finden Sie unter [Konfiguration von AWS Lambda-Funktionsaliasen](https://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html) im *AWS Lambda* Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [PublishVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/publish-version.html).AWS CLI * ### `put-function-concurrency` Das folgende Codebeispiel zeigt die Verwendung`put-function-concurrency`. **AWS CLI** **So konfigurieren Sie ein Limit für reservierte Gleichzeitigkeit für eine Funktion** Im folgenden `put-function-concurrency`-Beispiel werden 100 reservierte gleichzeitige Ausführungen für die `my-function`-Funktion konfiguriert. ``` aws lambda put-function-concurrency \ --function-name my-function \ --reserved-concurrent-executions 100 ``` Ausgabe: ``` { "ReservedConcurrentExecutions": 100 } ``` Weitere Informationen finden Sie unter [Gleichzeitigkeit für eine Lambda-Funktion reservieren](https://docs.aws.amazon.com/lambda/latest/dg/per-function-concurrency.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [PutFunctionConcurrency](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/put-function-concurrency.html)in der *AWS CLI Befehlsreferenz*. ### `put-function-event-invoke-config` Das folgende Codebeispiel zeigt die Verwendung`put-function-event-invoke-config`. **AWS CLI** **So konfigurieren Sie die Fehlerbehandlung für asynchronen Aufruf** Im folgenden Beispiel für `put-function-event-invoke-config` wird ein maximales Ereignisalter von einer Stunde festgelegt und Wiederholungsversuche werden für die angegebene Funktion deaktiviert. ``` aws lambda put-function-event-invoke-config \ --function-name my-function \ --maximum-event-age-in-seconds 3600 \ --maximum-retry-attempts 0 ``` Ausgabe: ``` { "LastModified": 1573686021.479, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST", "MaximumRetryAttempts": 0, "MaximumEventAgeInSeconds": 3600, "DestinationConfig": { "OnSuccess": {}, "OnFailure": {} } } ``` + Einzelheiten zur API finden Sie [PutFunctionEventInvokeConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/put-function-event-invoke-config.html)in der *AWS CLI Befehlsreferenz*. ### `put-provisioned-concurrency-config` Das folgende Codebeispiel zeigt die Verwendung`put-provisioned-concurrency-config`. **AWS CLI** **So weisen Sie bereitgestellte Gleichzeitigkeit zu** Das folgende `put-provisioned-concurrency-config`-Beispiel weist dem `BLUE`-Alias der angegebenen Funktion 100 bereitgestellte Gleichzeitigkeit zu. ``` aws lambda put-provisioned-concurrency-config \ --function-name my-function \ --qualifier BLUE \ --provisioned-concurrent-executions 100 ``` Ausgabe: ``` { "Requested ProvisionedConcurrentExecutions": 100, "Allocated ProvisionedConcurrentExecutions": 0, "Status": "IN_PROGRESS", "LastModified": "2019-11-21T19:32:12+0000" } ``` + Einzelheiten zur API finden Sie [PutProvisionedConcurrencyConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/put-provisioned-concurrency-config.html)in der *AWS CLI Befehlsreferenz*. ### `remove-layer-version-permission` Das folgende Codebeispiel zeigt die Verwendung`remove-layer-version-permission`. **AWS CLI** **So löschen Sie Berechtigungen für Layer-Versionen** Im folgenden Beispiel für `remove-layer-version-permission` wird die Berechtigung eines Kontos zum Konfigurieren einer Layer-Version gelöscht. ``` aws lambda remove-layer-version-permission \ --layer-name my-layer \ --statement-id xaccount \ --version-number 1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [AWS -Lambda-Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [RemoveLayerVersionPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/remove-layer-version-permission.html)in der *AWS CLI Befehlsreferenz*. ### `remove-permission` Das folgende Codebeispiel zeigt die Verwendung`remove-permission`. **AWS CLI** **So entfernen Sie Berechtigungen aus einer vorhandenen Lambda-Funktion** Das folgende `remove-permission`-Beispiel entfernt die Berechtigung zum Aufrufen einer Funktion namens `my-function`. ``` aws lambda remove-permission \ --function-name my-function \ --statement-id sns ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. *Weitere Informationen finden Sie unter [Using Resource-based Policies for AWS Lambda im Lambda](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html) Developer Guide AWS .* + *Einzelheiten zur API finden Sie unter [RemovePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/remove-permission.html)Befehlsreferenz.AWS CLI * ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer vorhandenen Lambda-Funktion Tags hinzu** Das folgende `tag-resource`-Beispiel fügt der angegebenen Lambda-Funktion ein Tag mit dem Schlüsselnamen `DEPARTMENT` und einem Wert von `Department A` hinzu. ``` aws lambda tag-resource \ --resource arn:aws:lambda:us-west-2:123456789012:function:my-function \ --tags "DEPARTMENT=Department A" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging von Lambda-Funktionen](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einer vorhandenen Lambda-Funktion** Das folgende `untag-resource`-Beispiel entfernt das Tag mit dem Schlüsselnamen `DEPARTMENT`-Tag aus der Lambda-Funktion `my-function`. ``` aws lambda untag-resource \ --resource arn:aws:lambda:us-west-2:123456789012:function:my-function \ --tag-keys DEPARTMENT ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging von Lambda-Funktionen](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-alias` Das folgende Codebeispiel zeigt die Verwendung`update-alias`. **AWS CLI** **So aktualisieren Sie einen Funktionsalias** Das folgende `update-alias`-Beispiel aktualisiert den Alias mit dem Namen `LIVE` so, dass er auf Version 3 der `my-function`-Lambda-Funktion verweist. ``` aws lambda update-alias \ --function-name my-function \ --function-version 3 \ --name LIVE ``` Ausgabe: ``` { "FunctionVersion": "3", "Name": "LIVE", "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE", "RevisionId": "594f41fb-b85f-4c20-95c7-6ca5f2a92c93", "Description": "alias for live version of function" } ``` Weitere Informationen finden Sie unter [Konfiguration von AWS Lambda-Funktionsaliasen](https://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html) im *AWS Lambda* Developer Guide. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [UpdateAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/update-alias.html).AWS CLI * ### `update-event-source-mapping` Das folgende Codebeispiel zeigt die Verwendung`update-event-source-mapping`. **AWS CLI** **Um die Zuordnung zwischen einer Ereignisquelle und einer AWS Lambda-Funktion zu aktualisieren** Im folgenden Beispiel für `update-event-source-mapping` wird die Batchgröße in der angegebenen Zuordnung auf 8 aktualisiert. ``` aws lambda update-event-source-mapping \ --uuid "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \ --batch-size 8 ``` Ausgabe: ``` { "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569284520.333, "BatchSize": 8, "State": "Updating", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" } ``` Weitere Informationen finden Sie unter [AWS -Lambda-Zuordnung von Ereignisquellen](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html) im *Entwicklerhandbuch für AWS Lambda*. + Einzelheiten zur API finden Sie [UpdateEventSourceMapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/update-event-source-mapping.html)in der *AWS CLI Befehlsreferenz.* ### `update-function-code` Das folgende Codebeispiel zeigt die Verwendung`update-function-code`. **AWS CLI** **Den Code einer Lambda-Funktion aktualisieren** Im folgenden Beispiel für `update-function-code` wird der Code der unveröffentlichten Version (\$1LATEST) der Funktion `my-function` durch den Inhalt der angegebenen ZIP-Datei ersetzt. ``` aws lambda update-function-code \ --function-name my-function \ --zip-file fileb://my-function.zip ``` Ausgabe: ``` { "FunctionName": "my-function", "LastModified": "2019-09-26T20:28:40.438+0000", "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d", "MemorySize": 256, "Version": "$LATEST", "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq", "Timeout": 3, "Runtime": "nodejs10.x", "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=", "Description": "", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Handler": "index.handler" } ``` Weitere Informationen finden Sie unter [Konfigurieren von AWS -Lambda-Funktionen](https://docs.aws.amazon.com/lambda/latest/dg/resource-model.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [UpdateFunctionCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/update-function-code.html)in der *AWS CLI Befehlsreferenz*. ### `update-function-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-function-configuration`. **AWS CLI** **Die Konfiguration einer Funktion ändern** Im folgenden Beispiel für `update-function-configuration` wird die Speichergröße für die unveröffentlichte Version (\$1LATEST) der Funktion `my-function` auf 256 MB geändert. ``` aws lambda update-function-configuration \ --function-name my-function \ --memory-size 256 ``` Ausgabe: ``` { "FunctionName": "my-function", "LastModified": "2019-09-26T20:28:40.438+0000", "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d", "MemorySize": 256, "Version": "$LATEST", "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq", "Timeout": 3, "Runtime": "nodejs10.x", "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=", "Description": "", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Handler": "index.handler" } ``` Weitere Informationen finden Sie unter [Konfigurieren von AWS -Lambda-Funktionen](https://docs.aws.amazon.com/lambda/latest/dg/resource-model.html) im *AWS -Lambda-Entwicklerhandbuch*. + Einzelheiten zur API finden Sie [UpdateFunctionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/update-function-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `update-function-event-invoke-config` Das folgende Codebeispiel zeigt die Verwendung`update-function-event-invoke-config`. **AWS CLI** **So aktualisieren Sie eine Konfiguration für asynchronen Aufruf** Im folgenden Beispiel für `update-function-event-invoke-config` wird der vorhandenen Konfiguration für asynchronen Aufruf ein Ausfallziel für die angegebene Funktion hinzugefügt. ``` aws lambda update-function-event-invoke-config \ --function-name my-function \ --destination-config '{"OnFailure":{"Destination": "arn:aws:sqs:us-east-2:123456789012:destination"}}' ``` Ausgabe: ``` { "LastModified": 1573687896.493, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST", "MaximumRetryAttempts": 0, "MaximumEventAgeInSeconds": 3600, "DestinationConfig": { "OnSuccess": {}, "OnFailure": { "Destination": "arn:aws:sqs:us-east-2:123456789012:destination" } } } ``` + Einzelheiten zur API finden Sie [UpdateFunctionEventInvokeConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/update-function-event-invoke-config.html)in der *AWS CLI Befehlsreferenz*. # License Manager Manager-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit License Manager Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-license-configuration` Das folgende Codebeispiel zeigt, wie Sie`create-license-configuration`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Lizenzkonfiguration** Im folgenden Beispiel für `create-license-configuration` wird eine Lizenzkonfiguration mit einem harten Limit von 10 Kernen erstellt. ``` aws license-manager create-license-configuration --name my-license-configuration \ --license-counting-type Core \ --license-count 10 \ --license-count-hard-limit ``` Ausgabe: ``` { "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111" } ``` **Beispiel 2: So erstellen Sie eine Lizenzkonfiguration** Im folgenden `create-license-configuration` Beispiel wird eine Lizenzkonfiguration mit einem Soft-Limit von 100 v erstelltCPUs. Es verwendet eine Regel, um die vCPU-Optimierung zu aktivieren. ``` aws license-manager create-license-configuration --name my-license-configuration --license-counting-type vCPU \ --license-count 100 \ --license-rules "#honorVcpuOptimization=true" ``` Ausgabe: ``` { "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE2222" } ``` + Einzelheiten zur API finden Sie [CreateLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/create-license-configuration.html)in der *AWS CLI Befehlsreferenz.* ### `delete-license-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-license-configuration`. **AWS CLI** **Um eine Lizenzkonfiguration zu löschen** Im folgenden Beispiel für `delete-license-configuration` wird die angegebene Lizenzkonfiguration gelöscht. ``` aws license-manager delete-license-configuration \ --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/delete-license-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-license-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-license-configuration`. **AWS CLI** **So rufen Sie Informationen zur Lizenzkonfiguration ab** Im folgenden Beispiel für `get-license-configuration` werden Details zur angegebenen Lizenzkonfiguration angezeigt. ``` aws license-manager get-license-configuration \ --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE ``` Ausgabe: ``` { "LicenseConfigurationId": "lic-38b658717b87478aaa7c00883EXAMPLE", "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE", "Name": "my-license-configuration", "LicenseCountingType": "vCPU", "LicenseRules": [], "LicenseCountHardLimit": false, "ConsumedLicenses": 0, "Status": "AVAILABLE", "OwnerAccountId": "123456789012", "ConsumedLicenseSummaryList": [ { "ResourceType": "EC2_INSTANCE", "ConsumedLicenses": 0 }, { "ResourceType": "EC2_HOST", "ConsumedLicenses": 0 }, { "ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE", "ConsumedLicenses": 0 } ], "ManagedResourceSummaryList": [ { "ResourceType": "EC2_INSTANCE", "AssociationCount": 0 }, { "ResourceType": "EC2_HOST", "AssociationCount": 0 }, { "ResourceType": "EC2_AMI", "AssociationCount": 2 }, { "ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE", "AssociationCount": 0 } ] } ``` + Einzelheiten zur API finden Sie [GetLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-license-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-service-settings` Das folgende Codebeispiel zeigt die Verwendung`get-service-settings`. **AWS CLI** **So rufen Sie die Einstellungen für License Manager ab** Im folgenden Beispiel für `get-service-settings` werden die Service-Einstellungen für License Manager in der aktuellen Region angezeigt. ``` aws license-manager get-service-settings ``` Das folgende Beispiel zeigt eine Ausgabe für den Fall, dass die kontoübergreifende Ressourcenerkennung deaktiviert ist. ``` { "OrganizationConfiguration": { "EnableIntegration": false }, "EnableCrossAccountsDiscovery": false } ``` Das folgende Beispiel zeigt eine Ausgabe für den Fall, dass die kontoübergreifende Ressourcenerkennung aktiviert ist. ``` { "S3BucketArn": "arn:aws:s3:::aws-license-manager-service-c22d6279-35c4-47c4-bb", "OrganizationConfiguration": { "EnableIntegration": true }, "EnableCrossAccountsDiscovery": true } ``` + Einzelheiten zur API finden Sie [GetServiceSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-service-settings.html)in der *AWS CLI Befehlsreferenz*. ### `list-associations-for-license-configuration` Das folgende Codebeispiel zeigt die Verwendung`list-associations-for-license-configuration`. **AWS CLI** **So rufen Sie Zuordnungen für eine Lizenzkonfiguration ab** Im folgenden Beispiel für `list-associations-for-license-configuration` werden detaillierte Informationen zu den Zuordnungen der angegebenen Lizenzkonfiguration angezeigt. ``` aws license-manager list-associations-for-license-configuration \ --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE ``` Ausgabe: ``` { "LicenseConfigurationAssociations": [ { "ResourceArn": "arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0", "ResourceType": "EC2_AMI", "ResourceOwnerId": "123456789012", "AssociationTime": 1568825118.617 }, { "ResourceArn": "arn:aws:ec2:us-west-2::image/ami-0abcdef1234567890", "ResourceType": "EC2_AMI", "ResourceOwnerId": "123456789012", "AssociationTime": 1568825118.946 } ] } ``` + Einzelheiten zur API finden Sie [ListAssociationsForLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-associations-for-license-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `list-license-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-license-configurations`. **AWS CLI** **Beispiel 1: So listen Sie alle Ihre Lizenzkonfigurationen auf** Im folgenden Beispiel für `list-license-configurations` werden Ihre DNS Firewall-Konfigurationen aufgelistet. ``` aws license-manager list-license-configurations ``` Ausgabe: ``` { "LicenseConfigurations": [ { "LicenseConfigurationId": "lic-6eb6586f508a786a2ba4f56c1EXAMPLE", "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE", "Name": "my-license-configuration", "LicenseCountingType": "Core", "LicenseRules": [], "LicenseCount": 10, "LicenseCountHardLimit": true, "ConsumedLicenses": 0, "Status": "AVAILABLE", "OwnerAccountId": "123456789012", "ConsumedLicenseSummaryList": [ { "ResourceType": "EC2_INSTANCE", "ConsumedLicenses": 0 }, { "ResourceType": "EC2_HOST", "ConsumedLicenses": 0 }, { "ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE", "ConsumedLicenses": 0 } ], "ManagedResourceSummaryList": [ { "ResourceType": "EC2_INSTANCE", "AssociationCount": 0 }, { "ResourceType": "EC2_HOST", "AssociationCount": 0 }, { "ResourceType": "EC2_AMI", "AssociationCount": 0 }, { "ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE", "AssociationCount": 0 } ] }, { ... } ] } ``` **Beispiel 2: So listen Sie eine bestimmte Lizenzkonfiguration auf** Im folgenden Beispiel für `list-license-configurations` wird die angegebene Lizenzkonfiguration aufgelistet. ``` aws license-manager list-license-configurations \ --license-configuration-arns arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE ``` + Einzelheiten zur API finden Sie [ListLicenseConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `list-license-specifications-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-license-specifications-for-resource`. **AWS CLI** **So listen Sie die Lizenzkonfigurationen für eine Ressource auf** Im folgenden Beispiel für `list-license-specifications-for-resource` werden die Lizenzkonfigurationen aufgelistet, die dem angegebenen Amazon Machine Image (AMI) zugeordnet sind. ``` aws license-manager list-license-specifications-for-resource \ --resource-arn arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0 ``` Ausgabe: ``` { "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE" } ``` + Einzelheiten zur API finden Sie [ListLicenseSpecificationsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-specifications-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-resource-inventory` Das folgende Codebeispiel zeigt die Verwendung`list-resource-inventory`. **AWS CLI** **So listen Sie Ressourcen im Ressourcenbestand auf** Im folgenden Beispiel für `list-resource-inventory` werden die Ressourcen aufgelistet, die mithilfe des Systems-Manager-Bestand verwaltet werden. ``` aws license-manager list-resource-inventory ``` Ausgabe: ``` { "ResourceInventoryList": [ { "Platform": "Red Hat Enterprise Linux Server", "ResourceType": "EC2Instance", "PlatformVersion": "7.4", "ResourceArn": "arn:aws:ec2:us-west-2:1234567890129:instance/i-05d3cdfb05bd36376", "ResourceId": "i-05d3cdfb05bd36376", "ResourceOwningAccountId": "1234567890129" }, { "Platform": "Amazon Linux", "ResourceType": "EC2Instance", "PlatformVersion": "2", "ResourceArn": "arn:aws:ec2:us-west-2:1234567890129:instance/i-0b1d036cfd4594808", "ResourceId": "i-0b1d036cfd4594808", "ResourceOwningAccountId": "1234567890129" }, { "Platform": "Microsoft Windows Server 2019 Datacenter", "ResourceType": "EC2Instance", "PlatformVersion": "10.0.17763", "ResourceArn": "arn:aws:ec2:us-west-2:1234567890129:instance/i-0cdb3b54a2a8246ad", "ResourceId": "i-0cdb3b54a2a8246ad", "ResourceOwningAccountId": "1234567890129" } ] } ``` + Einzelheiten zur API finden Sie [ListResourceInventory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-resource-inventory.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags für eine Lizenzkonfiguration auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für die angegebene Lizenzkonfiguration aufgelistet. ``` aws license-manager list-tags-for-resource \ --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE ``` Ausgabe: ``` { "Tags": [ { "Key": "project", "Value": "lima" } ] } ``` + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `list-usage-for-license-configuration` Das folgende Codebeispiel zeigt die Verwendung`list-usage-for-license-configuration`. **AWS CLI** **So listen Sie die Lizenzen auf, die für eine Lizenzkonfiguration verwendet werden** Im folgenden Beispiel für `list-usage-for-license-configuration` werden Informationen zu den Ressourcen aufgelistet, die Lizenzen für die angegebene Lizenzkonfiguration verwenden. Wenn der Lizenztyp beispielsweise vCPU lautet, verbrauchen alle Instances eine Lizenz pro vCPU. ``` aws license-manager list-usage-for-license-configuration \ --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE ``` Ausgabe: ``` { "LicenseConfigurationUsageList": [ { "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-04a636d18e83cfacb", "ResourceType": "EC2_INSTANCE", "ResourceStatus": "running", "ResourceOwnerId": "123456789012", "AssociationTime": 1570892850.519, "ConsumedLicenses": 2 } ] } ``` + Einzelheiten zur API finden Sie [ListUsageForLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-usage-for-license-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer Lizenzkonfiguration ein Tag hinzu** Im folgenden Beispiel für `tag-resource` wird das angegebene Tag (Schlüsselname und Wert) der angegebenen Lizenzkonfiguration hinzugefügt. ``` aws license-manager tag-resource \ --tags Key=project,Value=lima \ --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einer Lizenzkonfiguration** Im folgenden Beispiel für `untag-resource` wird das angegebene Tag (Schlüsselname und Wert) aus der angegebenen Lizenzkonfiguration entfernt. ``` aws license-manager untag-resource \ --tag-keys project \ --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-license-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-license-configuration`. **AWS CLI** **So aktualisieren Sie eine Lizenzkonfiguration** Im folgenden Beispiel für `update-license-configuration` wird die angegebene Lizenzkonfiguration aktualisiert, um das harte Limit zu entfernen. ``` aws license-manager update-license-configuration \ --no-license-count-hard-limit \ --license-configuration-arn arn:aws:license-manager:us-west-2:880185128111:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Im folgenden Beispiel für `update-license-configuration` wird die angegebene Lizenzkonfiguration aktualisiert, um ihren Status in `DISABLED` zu ändern. ``` aws license-manager update-license-configuration \ --license-configuration-status DISABLED --license-configuration-arn arn:aws:license-manager:us-west-2:880185128111:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UpdateLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `update-license-specifications-for-resource` Das folgende Codebeispiel zeigt die Verwendung`update-license-specifications-for-resource`. **AWS CLI** **So aktualisieren Sie die Lizenzkonfigurationen für eine Ressource** Im folgenden Beispiel für `update-license-specifications-for-resource` wird die dem angegebenen Amazon Machine Image (AMI) zugeordnete Lizenzkonfiguration ersetzt, indem eine Lizenzkonfiguration entfernt und eine andere hinzugefügt wird. ``` aws license-manager update-license-specifications-for-resource \ --resource-arn arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0 \ --remove-license-specifications LicenseConfigurationArn=arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE \ --add-license-specifications LicenseConfigurationArn=arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-42b6deb06e5399a980d555927EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UpdateLicenseSpecificationsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-specifications-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-service-settings` Das folgende Codebeispiel zeigt die Verwendung`update-service-settings`. **AWS CLI** **So aktualisieren Sie die Einstellungen für License Manager** Das folgende `update-service-settings` Beispiel ermöglicht die kontenübergreifende Ressourcensuche für License Manager in der aktuellen AWS Region. Der Amazon-S3-Bucket ist die Synchronisierung von Ressourcendaten, die für den Systems-Manager-Bestand erforderlich ist. ``` aws license-manager update-service-settings \ --organization-configuration EnableIntegration=true \ --enable-cross-accounts-discovery \ --s3-bucket-arn arn:aws:s3:::aws-license-manager-service-abcd1234EXAMPLE ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UpdateServiceSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-service-settings.html)in der *AWS CLI Befehlsreferenz.* # Lightsail-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Lightsail Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `allocate-static-ip` Das folgende Codebeispiel zeigt, wie Sie. `allocate-static-ip` **AWS CLI** **So erstellen Sie eine statische IP-Adresse** Im folgenden Beispiel für `allocate-static-ip` wird die angegebene statische IP erstellt, die an eine Instance angefügt werden kann. ``` aws lightsail allocate-static-ip \ --static-ip-name StaticIp-1 ``` Ausgabe: ``` { "operations": [ { "id": "b5d06d13-2f19-4683-889f-dEXAMPLEed79", "resourceName": "StaticIp-1", "resourceType": "StaticIp", "createdAt": 1571071325.076, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "AllocateStaticIp", "status": "Succeeded", "statusChangedAt": 1571071325.274 } ] } ``` + Einzelheiten zur API finden Sie [AllocateStaticIp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/allocate-static-ip.html)in der *AWS CLI Befehlsreferenz*. ### `attach-disk` Das folgende Codebeispiel zeigt die Verwendung`attach-disk`. **AWS CLI** **So fügen Sie einen Blockspeicherdatenträger an eine Instance an** Im folgenden Beispiel für `attach-disk` wird der Datenträger `Disk-1` an die Instance `WordPress_Multisite-1` mit dem Datenträgerpfad `/dev/xvdf` angehängt. ``` aws lightsail attach-disk \ --disk-name Disk-1 \ --disk-path /dev/xvdf \ --instance-name WordPress_Multisite-1 ``` Ausgabe: ``` { "operations": [ { "id": "10a08267-19ce-43be-b913-6EXAMPLE7e80", "resourceName": "Disk-1", "resourceType": "Disk", "createdAt": 1571071465.472, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "WordPress_Multisite-1", "operationType": "AttachDisk", "status": "Started", "statusChangedAt": 1571071465.472 }, { "id": "2912c477-5295-4539-88c9-bEXAMPLEd1f0", "resourceName": "WordPress_Multisite-1", "resourceType": "Instance", "createdAt": 1571071465.474, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "Disk-1", "operationType": "AttachDisk", "status": "Started", "statusChangedAt": 1571071465.474 } ] } ``` + Einzelheiten zur API finden Sie [AttachDisk](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/attach-disk.html)in der *AWS CLI Befehlsreferenz*. ### `attach-instances-to-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`attach-instances-to-load-balancer`. **AWS CLI** **So fügen Sie Instances an einen Load Balancer an** Im folgenden Beispiel für `attach-instances-to-load-balancer` werden die Instances `MEAN-1`, `MEAN-2` und `MEAN-3` an den Load Balancer `LoadBalancer-1` angefügt. ``` aws lightsail attach-instances-to-load-balancer \ --instance-names {"MEAN-1","MEAN-2","MEAN-3"} \ --load-balancer-name LoadBalancer-1 ``` Ausgabe: ``` { "operations": [ { "id": "8055d19d-abb2-40b9-b527-1EXAMPLE3c7b", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1571071699.892, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "MEAN-2", "operationType": "AttachInstancesToLoadBalancer", "status": "Started", "statusChangedAt": 1571071699.892 }, { "id": "c35048eb-8538-456a-a118-0EXAMPLEfb73", "resourceName": "MEAN-2", "resourceType": "Instance", "createdAt": 1571071699.887, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "LoadBalancer-1", "operationType": "AttachInstancesToLoadBalancer", "status": "Started", "statusChangedAt": 1571071699.887 }, { "id": "910d09e0-adc5-4372-bc2e-0EXAMPLEd891", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1571071699.882, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "MEAN-3", "operationType": "AttachInstancesToLoadBalancer", "status": "Started", "statusChangedAt": 1571071699.882 }, { "id": "178b18ac-43e8-478c-9bed-1EXAMPLE4755", "resourceName": "MEAN-3", "resourceType": "Instance", "createdAt": 1571071699.901, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "LoadBalancer-1", "operationType": "AttachInstancesToLoadBalancer", "status": "Started", "statusChangedAt": 1571071699.901 }, { "id": "fb62536d-2a98-4190-a6fc-4EXAMPLE7470", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1571071699.885, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "MEAN-1", "operationType": "AttachInstancesToLoadBalancer", "status": "Started", "statusChangedAt": 1571071699.885 }, { "id": "787dac0d-f98d-46c3-8571-3EXAMPLE5a85", "resourceName": "MEAN-1", "resourceType": "Instance", "createdAt": 1571071699.901, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "LoadBalancer-1", "operationType": "AttachInstancesToLoadBalancer", "status": "Started", "statusChangedAt": 1571071699.901 } ] } ``` + Einzelheiten zur API finden Sie [AttachInstancesToLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/attach-instances-to-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `attach-load-balancer-tls-certificate` Das folgende Codebeispiel zeigt die Verwendung`attach-load-balancer-tls-certificate`. **AWS CLI** **So fügen Sie ein TLS-Zertifikat an einen Load Balancer an** Im folgenden Beispiel für `attach-load-balancer-tls-certificate` wird das TLS-Zertifikat `Certificate2` des Load Balancers an den Load Balancer `LoadBalancer-1` angefügt. ``` aws lightsail attach-load-balancer-tls-certificate \ --certificate-name Certificate2 \ --load-balancer-name LoadBalancer-1 ``` Ausgabe: ``` { "operations": [ { "id": "cf1ad6e3-3cbb-4b8a-a7f2-3EXAMPLEa118", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1571072255.416, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "Certificate2", "operationType": "AttachLoadBalancerTlsCertificate", "status": "Succeeded", "statusChangedAt": 1571072255.416 }, { "id": "dae1bcfb-d531-4c06-b4ea-bEXAMPLEc04e", "resourceName": "Certificate2", "resourceType": "LoadBalancerTlsCertificate", "createdAt": 1571072255.416, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "LoadBalancer-1", "operationType": "AttachLoadBalancerTlsCertificate", "status": "Succeeded", "statusChangedAt": 1571072255.416 } ] } ``` + Einzelheiten zur API finden Sie [AttachLoadBalancerTlsCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/attach-load-balancer-tls-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `attach-static-ip` Das folgende Codebeispiel zeigt die Verwendung`attach-static-ip`. **AWS CLI** **So fügen Sie einer Instance eine statische IP an** Im folgenden Beispiel für `attach-static-ip` wird eine statische IP `StaticIp-1` an die Instance `MEAN-1` angefügt. ``` aws lightsail attach-static-ip \ --static-ip-name StaticIp-1 \ --instance-name MEAN-1 ``` Ausgabe: ``` { "operations": [ { "id": "45e6fa13-4808-4b8d-9292-bEXAMPLE20b2", "resourceName": "StaticIp-1", "resourceType": "StaticIp", "createdAt": 1571072569.375, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "MEAN-1", "operationType": "AttachStaticIp", "status": "Succeeded", "statusChangedAt": 1571072569.375 }, { "id": "9ee09a17-863c-4e51-8a6d-3EXAMPLE5475", "resourceName": "MEAN-1", "resourceType": "Instance", "createdAt": 1571072569.376, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "StaticIp-1", "operationType": "AttachStaticIp", "status": "Succeeded", "statusChangedAt": 1571072569.376 } ] } ``` + Einzelheiten zur API finden Sie [AttachStaticIp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/attach-static-ip.html)in der *AWS CLI Befehlsreferenz*. ### `close-instance-public-ports` Das folgende Codebeispiel zeigt die Verwendung`close-instance-public-ports`. **AWS CLI** **So schließen Sie Firewall-Ports für eine Instance** Im folgenden Beispiel für `close-instance-public-ports` wird der TCP-Port `22` auf der Instance `MEAN-2` geschlossen. ``` aws lightsail close-instance-public-ports \ --instance-name MEAN-2 \ --port-info fromPort=22,protocol=TCP,toPort=22 ``` Ausgabe: ``` { "operation": { "id": "4f328636-1c96-4649-ae6d-1EXAMPLEf446", "resourceName": "MEAN-2", "resourceType": "Instance", "createdAt": 1571072845.737, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "22/tcp", "operationType": "CloseInstancePublicPorts", "status": "Succeeded", "statusChangedAt": 1571072845.737 } } ``` + Einzelheiten zur API finden Sie [CloseInstancePublicPorts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/close-instance-public-ports.html)in der *AWS CLI Befehlsreferenz*. ### `copy-snapshot` Das folgende Codebeispiel zeigt die Verwendung`copy-snapshot`. **AWS CLI** **Beispiel 1: Um einen Snapshot innerhalb derselben AWS Region zu kopieren** Im folgenden `copy-snapshot` Beispiel wird ein Instanz-Snapshot `MEAN-1-1571075291` als Instanz-Snapshot `MEAN-1-Copy` innerhalb derselben AWS Region kopiert`us-west-2`. ``` aws lightsail copy-snapshot \ --source-snapshot-name MEAN-1-1571075291 \ --target-snapshot-name MEAN-1-Copy \ --source-region us-west-2 ``` Ausgabe: ``` { "operations": [ { "id": "ced16fc1-f401-4556-8d82-1EXAMPLEb982", "resourceName": "MEAN-1-Copy", "resourceType": "InstanceSnapshot", "createdAt": 1571075581.498, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "us-west-2:MEAN-1-1571075291", "operationType": "CopySnapshot", "status": "Started", "statusChangedAt": 1571075581.498 } ] } ``` *Weitere Informationen finden Sie unter [Kopieren von Snapshots von einer AWS Region in eine andere in Amazon Lightsail im Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-copying-snapshots-from-one-region-to-another) Dev Guide.* **Beispiel 2: Um einen Snapshot von einer Region in eine andere zu kopieren AWS ** Im folgenden `copy-snapshot` Beispiel wird der Instanz-Snapshot `MEAN-1-1571075291` als Instanz-Snapshot `MEAN-1-1571075291-Copy` von AWS der Region `us-west-2` nach kopiert`us-east-1`. ``` aws lightsail copy-snapshot \ --source-snapshot-name MEAN-1-1571075291 \ --target-snapshot-name MEAN-1-1571075291-Copy \ --source-region us-west-2 \ --region us-east-1 ``` Ausgabe: ``` { "operations": [ { "id": "91116b79-119c-4451-b44a-dEXAMPLEd97b", "resourceName": "MEAN-1-1571075291-Copy", "resourceType": "InstanceSnapshot", "createdAt": 1571075695.069, "location": { "availabilityZone": "all", "regionName": "us-east-1" }, "isTerminal": false, "operationDetails": "us-west-2:MEAN-1-1571075291", "operationType": "CopySnapshot", "status": "Started", "statusChangedAt": 1571075695.069 } ] } ``` *Weitere Informationen finden Sie unter [Kopieren von Snapshots von einer AWS Region in eine andere in Amazon Lightsail im Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-copying-snapshots-from-one-region-to-another) Dev Guide.* **Beispiel 3: Um einen automatischen Snapshot innerhalb derselben Region zu kopieren AWS ** Im folgenden `copy-snapshot` Beispiel wird der automatische Snapshot `2019-10-14` der Instanz `WordPress-1` als manueller Snapshot `WordPress-1-10142019` in der AWS Region kopiert`us-west-2`. ``` aws lightsail copy-snapshot \ --source-resource-name WordPress-1 \ --restore-date 2019-10-14 \ --target-snapshot-name WordPress-1-10142019 \ --source-region us-west-2 ``` Ausgabe: ``` { "operations": [ { "id": "be3e6754-cd1d-48e6-ad9f-2EXAMPLE1805", "resourceName": "WordPress-1-10142019", "resourceType": "InstanceSnapshot", "createdAt": 1571082412.311, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "us-west-2:WordPress-1", "operationType": "CopySnapshot", "status": "Started", "statusChangedAt": 1571082412.311 } ] } ``` *Weitere Informationen finden Sie unter [Automatisches Erstellen von Snapshots von Instances oder Festplatten in Amazon Lightsail im Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-keeping-automatic-snapshots) Dev Guide.* **Beispiel 4: Um einen automatischen Snapshot von einer Region in eine andere zu kopieren AWS ** Im folgenden `copy-snapshot` Beispiel wird ein automatischer Snapshot `2019-10-14` der Instanz `WordPress-1` als manueller Snapshot `WordPress-1-10142019` aus der AWS Region in `us-west-2` kopiert`us-east-1`. ``` aws lightsail copy-snapshot \ --source-resource-name WordPress-1 \ --restore-date 2019-10-14 \ --target-snapshot-name WordPress-1-10142019 \ --source-region us-west-2 \ --region us-east-1 ``` Ausgabe: ``` { "operations": [ { "id": "dffa128b-0b07-476e-b390-bEXAMPLE3775", "resourceName": "WordPress-1-10142019", "resourceType": "InstanceSnapshot", "createdAt": 1571082493.422, "location": { "availabilityZone": "all", "regionName": "us-east-1" }, "isTerminal": false, "operationDetails": "us-west-2:WordPress-1", "operationType": "CopySnapshot", "status": "Started", "statusChangedAt": 1571082493.422 } ] } ``` *Weitere Informationen finden Sie unter [Automatisches Erstellen von Snapshots von Instances oder Festplatten in Amazon Lightsail im Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-keeping-automatic-snapshots) Dev Guide.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [CopySnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/copy-snapshot.html)AWS CLI * ### `create-disk-from-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-disk-from-snapshot`. **AWS CLI** **So erstellen Sie einen Datenträger aus einem Datenträger-Snapshot** Im folgenden Beispiel für `create-disk-from-snapshot` wird ein Blockspeicherdatenträger namens `Disk-2` aus dem angegebenen Snapshot eines Blockspeicherdatenträgers erstellt. Die Festplatte wird in der angegebenen AWS Region und Availability Zone mit 32 GB Speicherplatz erstellt. ``` aws lightsail create-disk-from-snapshot \ --disk-name Disk-2 \ --disk-snapshot-name Disk-1-1566839161 \ --availability-zone us-west-2a \ --size-in-gb 32 ``` Ausgabe: ``` { "operations": [ { "id": "d42b605d-5ef1-4b4a-8791-7a3e8b66b5e7", "resourceName": "Disk-2", "resourceType": "Disk", "createdAt": 1569624941.471, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateDiskFromSnapshot", "status": "Started", "statusChangedAt": 1569624941.791 } ] } ``` Weitere Informationen finden Sie unter [Erstellen einer Blockspeicherfestplatte aus einem Snapshot in Amazon Lightsail im *Lightsail*](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/create-new-block-storage-disk-from-snapshot) Developer Guide. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateDiskFromSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-disk-from-snapshot.html).AWS CLI * ### `create-disk-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-disk-snapshot`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Snapshot eines Datenträgers** Im folgenden Beispiel für `create-disk-snapshot` wird ein Snapshot namens `DiskSnapshot-1` des angegebenen Blockspeicherdatenträgers erstellt. ``` aws lightsail create-disk-snapshot \ --disk-name Disk-1 \ --disk-snapshot-name DiskSnapshot-1 ``` Ausgabe: ``` { "operations": [ { "id": "fa74c6d2-03a3-4f42-a7c7-792f124d534b", "resourceName": "DiskSnapshot-1", "resourceType": "DiskSnapshot", "createdAt": 1569625129.739, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "Disk-1", "operationType": "CreateDiskSnapshot", "status": "Started", "statusChangedAt": 1569625129.739 }, { "id": "920a25df-185c-4528-87cd-7b85f5488c06", "resourceName": "Disk-1", "resourceType": "Disk", "createdAt": 1569625129.739, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "DiskSnapshot-1", "operationType": "CreateDiskSnapshot", "status": "Started", "statusChangedAt": 1569625129.739 } ] } ``` **Beispiel 2: So erstellen Sie einen Snapshot der Systemfestplatte einer Instance** Im folgenden Beispiel für `create-disk-snapshot` wird ein Snapshot des Systemdatenträgers der angegebenen Instance erstellt. ``` aws lightsail create-disk-snapshot \ --instance-name WordPress-1 \ --disk-snapshot-name SystemDiskSnapshot-1 ``` Ausgabe: ``` { "operations": [ { "id": "f508cf1c-6597-42a6-a4c3-4aebd75af0d9", "resourceName": "SystemDiskSnapshot-1", "resourceType": "DiskSnapshot", "createdAt": 1569625294.685, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "WordPress-1", "operationType": "CreateDiskSnapshot", "status": "Started", "statusChangedAt": 1569625294.685 }, { "id": "0bb9f712-da3b-4d99-b508-3bf871d989e5", "resourceName": "WordPress-1", "resourceType": "Instance", "createdAt": 1569625294.685, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "SystemDiskSnapshot-1", "operationType": "CreateDiskSnapshot", "status": "Started", "statusChangedAt": 1569625294.685 } ] } ``` *Weitere Informationen finden Sie unter [Snapshots in Amazon Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/understanding-instance-snapshots-in-amazon-lightsail) und [Erstellen eines Snapshots eines Instance-Root-Volumes in Amazon Lightsail im Lightsail Developer Guide](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-create-an-instance-root-volume-snapshot).* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [CreateDiskSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-disk-snapshot.html)AWS CLI * ### `create-disk` Das folgende Codebeispiel zeigt die Verwendung`create-disk`. **AWS CLI** **So erstellen Sie einen Blockspeicherdatenträger** Im folgenden `create-disk` Beispiel wird eine Blockspeicherfestplatte `Disk-1` in der angegebenen AWS Region und Availability Zone mit 32 GB Speicherplatz erstellt. ``` aws lightsail create-disk \ --disk-name Disk-1 \ --availability-zone us-west-2a \ --size-in-gb 32 ``` Ausgabe: ``` { "operations": [ { "id": "1c85e2ec-86ba-4697-b936-77f4d3dc013a", "resourceName": "Disk-1", "resourceType": "Disk", "createdAt": 1569449220.36, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateDisk", "status": "Started", "statusChangedAt": 1569449220.588 } ] } ``` + Einzelheiten zur API finden Sie [CreateDisk](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-disk.html)unter *AWS CLI Befehlsreferenz*. ### `create-domain-entry` Das folgende Codebeispiel zeigt die Verwendung`create-domain-entry`. **AWS CLI** **So erstellen Sie einen Domaineintrag (DNS-Datensatz)** Im folgenden Beispiel für `create-domain-entry` wird ein DNS-Datensatz (A) für den Apex der angegebenen Domain erstellt, der auf die IP-Adresse einer Instance verweist. **Hinweis:** Die domänenbezogenen API-Operationen von Lightsail sind nur in der Region verfügbar. `us-east-1` Wenn Ihr CLI-Profil für die Verwendung einer anderen Region konfiguriert ist, müssen Sie den Parameter `--region us-east-1` angeben, andernfalls schlägt der Befehl fehl. ``` aws lightsail create-domain-entry \ --region us-east-1 \ --domain-name example.com \ --domain-entry name=example.com,type=A,target=192.0.2.0 ``` Ausgabe: ``` { "operation": { "id": "5be4494d-56f4-41fc-8730-693dcd0ef9e2", "resourceName": "example.com", "resourceType": "Domain", "createdAt": 1569865296.519, "location": { "availabilityZone": "all", "regionName": "global" }, "isTerminal": true, "operationType": "CreateDomainEntry", "status": "Succeeded", "statusChangedAt": 1569865296.519 } } ``` *Weitere Informationen finden Sie unter [DNS in Amazon Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/understanding-dns-in-amazon-lightsail) und [Erstellen einer DNS-Zone zur Verwaltung der DNS-Einträge Ihrer Domain in Amazon Lightsail im Lightsail Developer](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/lightsail-how-to-create-dns-entry) Guide.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [CreateDomainEntry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-domain-entry.html)AWS CLI * ### `create-domain` Das folgende Codebeispiel zeigt die Verwendung`create-domain`. **AWS CLI** **So erstellen Sie eine Domain (DNS-Zone)** Im folgenden Beispiel für `create-domain` wird eine DNS-Zone für die angegebene Domain erstellt. **Hinweis:** Die domänenbezogenen API-Operationen von Lightsail sind nur in der Region verfügbar. `us-east-1` Wenn Ihr CLI-Profil für die Verwendung einer anderen Region konfiguriert ist, müssen Sie den Parameter `--region us-east-1` angeben, andernfalls schlägt der Befehl fehl. ``` aws lightsail create-domain \ --region us-east-1 \ --domain-name example.com ``` Ausgabe: ``` { "operation": { "id": "64e522c8-9ae1-4c05-9b65-3f237324dc34", "resourceName": "example.com", "resourceType": "Domain", "createdAt": 1569864291.92, "location": { "availabilityZone": "all", "regionName": "global" }, "isTerminal": true, "operationType": "CreateDomain", "status": "Succeeded", "statusChangedAt": 1569864292.109 } } ``` *Weitere Informationen finden Sie unter [DNS in Amazon Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/understanding-dns-in-amazon-lightsail) und [Erstellen einer DNS-Zone zur Verwaltung der DNS-Einträge Ihrer Domain in Amazon Lightsail im Lightsail Developer](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/lightsail-how-to-create-dns-entry) Guide.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [CreateDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-domain.html)AWS CLI * ### `create-instance-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-instance-snapshot`. **AWS CLI** **So erstellen Sie einen Snapshot einer Instance** Im folgenden Beispiel für `create-instance-snapshot` wird ein Snapshot aus der angegebenen Instance erstellt. ``` aws lightsail create-instance-snapshot \ --instance-name WordPress-1 \ --instance-snapshot-name WordPress-Snapshot-1 ``` Ausgabe: ``` { "operations": [ { "id": "4c3db559-9dd0-41e7-89c0-2cb88c19786f", "resourceName": "WordPress-Snapshot-1", "resourceType": "InstanceSnapshot", "createdAt": 1569866438.48, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "WordPress-1", "operationType": "CreateInstanceSnapshot", "status": "Started", "statusChangedAt": 1569866438.48 }, { "id": "c04fdc45-2981-488c-88b5-d6d2fd759a6a", "resourceName": "WordPress-1", "resourceType": "Instance", "createdAt": 1569866438.48, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "WordPress-Snapshot-1", "operationType": "CreateInstanceSnapshot", "status": "Started", "statusChangedAt": 1569866438.48 } ] } ``` + Einzelheiten zur API finden Sie [CreateInstanceSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-instance-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-instances-from-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-instances-from-snapshot`. **AWS CLI** **So erstellen Sie eine Instance aus einem Snapshot** Im folgenden `create-instances-from-snapshot` Beispiel wird eine Instance aus dem angegebenen Instanz-Snapshot in der angegebenen AWS Region und Availability Zone erstellt, wobei das Paket im Wert von 12 USD verwendet wird. **Hinweis:** Das von Ihnen angegebene Paket muss mindestens den Spezifikationen des Pakets der ursprünglichen Quell-Instance entsprechen, die zur Erstellung des Snapshots verwendet wurde. ``` aws lightsail create-instances-from-snapshot \ --instance-snapshot-name WordPress-1-1569866208 \ --instance-names WordPress-2 \ --availability-zone us-west-2a \ --bundle-id small_3_0 ``` Ausgabe: ``` { "operations": [ { "id": "003f8271-b711-464d-b9b8-7f3806cb496e", "resourceName": "WordPress-2", "resourceType": "Instance", "createdAt": 1569865914.908, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateInstancesFromSnapshot", "status": "Started", "statusChangedAt": 1569865914.908 } ] } ``` + Einzelheiten zur API finden Sie [CreateInstancesFromSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-instances-from-snapshot.html)in der *AWS CLI Befehlsreferenz.* ### `create-instances` Das folgende Codebeispiel zeigt die Verwendung`create-instances`. **AWS CLI** **Beispiel 1: So erstellen Sie eine einzelne Instance** Im folgenden `create-instances` Beispiel wird mithilfe des WordPress Blueprints und des Pakets im Wert von 5,00 USD eine Instanz in der angegebenen AWS Region und Availability Zone erstellt. ``` aws lightsail create-instances \ --instance-names Instance-1 \ --availability-zone us-west-2a \ --blueprint-id wordpress \ --bundle-id nano_3_0 ``` Ausgabe: ``` { "operations": [ { "id": "9a77158f-7be3-4d6d-8054-cf5ae2b720cc", "resourceName": "Instance-1", "resourceType": "Instance", "createdAt": 1569447986.061, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateInstance", "status": "Started", "statusChangedAt": 1569447986.061 } ] } ``` **Beispiel 2: So erstellen Sie mehrere Instances gleichzeitig** Im folgenden `create-instances` Beispiel werden drei Instances in der angegebenen AWS Region und Availability Zone mithilfe des WordPress Blueprints und des Pakets im Wert von 5,00 USD erstellt. ``` aws lightsail create-instances \ --instance-names {"Instance1","Instance2","Instance3"} \ --availability-zone us-west-2a \ --blueprint-id wordpress \ --bundle-id nano_3_0 ``` Ausgabe: ``` { "operations": [ { "id": "5492f015-9d2e-48c6-8eea-b516840e6903", "resourceName": "Instance1", "resourceType": "Instance", "createdAt": 1569448780.054, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateInstance", "status": "Started", "statusChangedAt": 1569448780.054 }, { "id": "c58b5f46-2676-44c8-b95c-3ad375898515", "resourceName": "Instance2", "resourceType": "Instance", "createdAt": 1569448780.054, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateInstance", "status": "Started", "statusChangedAt": 1569448780.054 }, { "id": "a5ad8006-9bee-4499-9eb7-75e42e6f5882", "resourceName": "Instance3", "resourceType": "Instance", "createdAt": 1569448780.054, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateInstance", "status": "Started", "statusChangedAt": 1569448780.054 } ] } ``` + Einzelheiten zur API finden Sie [CreateInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-instances.html)in der *AWS CLI Befehlsreferenz*. ### `create-key-pair` Das folgende Codebeispiel zeigt die Verwendung`create-key-pair`. **AWS CLI** **So erstellen Sie ein Schlüsselpaar** Im folgenden Beispiel für `create-key-pair` wird ein Schlüsselpaar erstellt, mit dem Sie sich bei einer Instance authentifizieren und eine Verbindung zu ihr herstellen können. ``` aws lightsail create-key-pair \ --key-pair-name MyPersonalKeyPair ``` Die Ausgabe stellt den Base64-Wert des privaten Schlüssels bereit, mit dem Sie sich bei Instances authentifizieren können, die das erstellte Schlüsselpaar verwenden. **Hinweis:** Kopieren Sie den Base64-Wert des privaten Schlüssels und fügen Sie ihn an einem sicheren Ort ein, da Sie ihn später nicht mehr abrufen können. ``` { "keyPair": { "name": "MyPersonalKeyPair", "arn": "arn:aws:lightsail:us-west-2:111122223333:KeyPair/55025c71-198f-403b-b42f-a69433e724fb", "supportCode": "621291663362/MyPersonalKeyPair", "createdAt": 1569866556.567, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "KeyPair" }, "publicKeyBase64": "ssh-rsa ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCV0xUEwx96amPERH7K1bVT1tTFl9OmNk6o7m5YVHk9xlOdMbDRbFvhtXvw4jzJXXz5pBMxWOaGMz5K8QyTVOznoqp13Z8SBooH29hgmBNXiII1XPzEwqbj8mfo1+YVM5s5VuxWwm+BHUgedGUXno6uF7agqxZNO1kPLJBIVTW26SSYBJ0tE+y804UyVsjrbUqCaMXDhmfXpWulMPwuXhwcKh7e8hwoTfkiX0E6Ql+KqF/MiA3w6DCjEqvvdIO7SiEZJFsuGNfYDDN3w60Rel5MUhmn3OJdn4y/A7NWb3IxL4pPfVE4rgFRKU8n1jp9kwRnlVMVBOWuGXk6n+H6M2f1 ", "privateKeyBase64": "-----BEGIN RSA PRIVATE KEY-----EXAMPLETCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC\nVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6\nb24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsEXAMPLEd\nBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN\nMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD\nVQQHEwdTZWF0dGxlMQ8wDQEXAMPLEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z\nb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt\nYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMEXAMPLE4GmWIWJ\n21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T\nrDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE\nIbb3OhjZnzcvQAaREXAMPLEMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4\nnUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb\nFFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OEXAMPLELvjx79LjSTb\nNYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=\n-----END RSA PRIVATE KEY-----", "operation": { "id": "67f984db-9994-45fe-ad38-59bafcaf82ef", "resourceName": "MyPersonalKeyPair", "resourceType": "KeyPair", "createdAt": 1569866556.567, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "CreateKeyPair", "status": "Succeeded", "statusChangedAt": 1569866556.704 } } ``` + Einzelheiten zur API finden Sie [CreateKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-key-pair.html)in der *AWS CLI Befehlsreferenz*. ### `create-load-balancer-tls-certificate` Das folgende Codebeispiel zeigt die Verwendung`create-load-balancer-tls-certificate`. **AWS CLI** **So erstellen Sie ein TLS-Zertifikat für den Load Balancer** Im folgenden Beispiel für `create-load-balancer-tls-certificate` wird ein TLS-Zertifikat erstellt, das an den angegebenen Load Balancer angefügt ist. Das erstellte Zertifikat gilt für die angegebenen Domains. **Hinweis:** Für einen Load Balancer können nur zwei Zertifikate erstellt werden. ``` aws lightsail create-load-balancer-tls-certificate \ --certificate-alternative-names abc.example.com \ --certificate-domain-name example.com \ --certificate-name MySecondCertificate \ --load-balancer-name MyFirstLoadBalancer ``` Ausgabe: ``` { "operations": [ { "id": "be663aed-cb46-41e2-9b23-e2f747245bd4", "resourceName": "MySecondCertificate", "resourceType": "LoadBalancerTlsCertificate", "createdAt": 1569867364.971, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "MyFirstLoadBalancer", "operationType": "CreateLoadBalancerTlsCertificate", "status": "Succeeded", "statusChangedAt": 1569867365.219 }, { "id": "f3dfa930-969e-41cc-ac7d-337178716f6d", "resourceName": "MyFirstLoadBalancer", "resourceType": "LoadBalancer", "createdAt": 1569867364.971, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "MySecondCertificate", "operationType": "CreateLoadBalancerTlsCertificate", "status": "Succeeded", "statusChangedAt": 1569867365.219 } ] } ``` + Einzelheiten zur API finden Sie [CreateLoadBalancerTlsCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-load-balancer-tls-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `create-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`create-load-balancer`. **AWS CLI** **So erstellen Sie einen Load Balancer** Im folgenden Beispiel für `create-load-balancer` wird ein Load Balancer mit einem TLS-Zertifikat erstellt. Das TLS-Zertifikat gilt für die angegebenen Domains und leitet den Datenverkehr an Instances auf Port 80 weiter. ``` aws lightsail create-load-balancer \ --certificate-alternative-names www.example.com test.example.com \ --certificate-domain-name example.com \ --certificate-name Certificate-1 \ --instance-port 80 \ --load-balancer-name LoadBalancer-1 ``` Ausgabe: ``` { "operations": [ { "id": "cc7b920a-83d8-4762-a74e-9174fe1540be", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1569867169.406, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateLoadBalancer", "status": "Started", "statusChangedAt": 1569867169.406 }, { "id": "658ed43b-f729-42f3-a8e4-3f8024d3c98d", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancerTlsCertificate", "createdAt": 1569867170.193, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "LoadBalancer-1", "operationType": "CreateLoadBalancerTlsCertificate", "status": "Succeeded", "statusChangedAt": 1569867170.54 }, { "id": "4757a342-5181-4870-b1e0-227eebc35ab5", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1569867170.193, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "Certificate-1", "operationType": "CreateLoadBalancerTlsCertificate", "status": "Succeeded", "statusChangedAt": 1569867170.54 } ] } ``` Weitere Informationen finden Sie unter [Lightsail Load Balancers](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/understanding-lightsail-load-balancers) im *Lightsail* Developer Guide. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [CreateLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-load-balancer.html)AWS CLI * ### `create-relational-database-from-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-relational-database-from-snapshot`. **AWS CLI** **So erstellen Sie eine Datenbank aus einem Snapshot** Im folgenden `create-relational-database-from-snapshot` Beispiel wird aus dem angegebenen Snapshot in der angegebenen AWS Region und Availability Zone eine verwaltete Datenbank erstellt, wobei das Standarddatenbankpaket für 15 USD verwendet wird. **Hinweis:** Das von Ihnen angegebene Paket muss mindestens den Spezifikationen des Pakets der ursprünglichen Quelldatenbank entsprechen, die zur Erstellung des Snapshots verwendet wurde. ``` aws lightsail create-relational-database-from-snapshot \ --relational-database-snapshot-name Database-Oregon-1-1566839359 \ --relational-database-name Database-1 \ --availability-zone us-west-2a \ --relational-database-bundle-id micro_1_0 \ --no-publicly-accessible ``` Ausgabe: ``` { "operations": [ { "id": "ad6d9193-9d5c-4ea1-97ae-8fe6de600b4c", "resourceName": "Database-1", "resourceType": "RelationalDatabase", "createdAt": 1569867916.938, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateRelationalDatabaseFromSnapshot", "status": "Started", "statusChangedAt": 1569867918.643 } ] } ``` + Einzelheiten zur API finden Sie [CreateRelationalDatabaseFromSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-relational-database-from-snapshot.html)in der *AWS CLI Befehlsreferenz.* ### `create-relational-database-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-relational-database-snapshot`. **AWS CLI** **So erstellen Sie einen Snapshot einer verwalteten Datenbank** Im folgenden Beispiel für `create-relational-database-snapshot` wird ein Snapshot der angegebenen verwalteten Datenbank erstellt. ``` aws lightsail create-relational-database-snapshot \ --relational-database-name Database1 \ --relational-database-snapshot-name RelationalDatabaseSnapshot1 ``` Ausgabe: ``` { "operations": [ { "id": "853667fb-ea91-4c02-8d20-8fc5fd43b9eb", "resourceName": "RelationalDatabaseSnapshot1", "resourceType": "RelationalDatabaseSnapshot", "createdAt": 1569868074.645, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "Database1", "operationType": "CreateRelationalDatabaseSnapshot", "status": "Started", "statusChangedAt": 1569868074.645 }, { "id": "fbafa521-3cac-4be8-9773-1c143780b239", "resourceName": "Database1", "resourceType": "RelationalDatabase", "createdAt": 1569868074.645, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "RelationalDatabaseSnapshot1", "operationType": "CreateRelationalDatabaseSnapshot", "status": "Started", "statusChangedAt": 1569868074.645 } ] } ``` + Einzelheiten zur API finden Sie [CreateRelationalDatabaseSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-relational-database-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-relational-database` Das folgende Codebeispiel zeigt die Verwendung`create-relational-database`. **AWS CLI** **So erstellen Sie eine verwaltete Datenbank** Das folgende `create-relational-database` Beispiel erstellt eine verwaltete Datenbank in der angegebenen AWS Region und Availability Zone unter Verwendung der MySQL 5.6-Datenbank-Engine (mysql\$15\$16) und des Standarddatenbankpakets für 15 USD (micro\$11\$10). Die verwaltete Datenbank verfügt über einen vorab ausgefüllten Masterbenutzernamen und ist nicht öffentlich zugänglich. ``` aws lightsail create-relational-database \ --relational-database-name Database-1 \ --availability-zone us-west-2a \ --relational-database-blueprint-id mysql_5_6 \ --relational-database-bundle-id micro_1_0 \ --master-database-name dbmaster \ --master-username user \ --no-publicly-accessible ``` Ausgabe: ``` { "operations": [ { "id": "b52bedee-73ed-4798-8d2a-9c12df89adcd", "resourceName": "Database-1", "resourceType": "RelationalDatabase", "createdAt": 1569450017.244, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "CreateRelationalDatabase", "status": "Started", "statusChangedAt": 1569450018.637 } ] } ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [CreateRelationalDatabase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/create-relational-database.html)AWS CLI * ### `delete-auto-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-auto-snapshot`. **AWS CLI** **So löschen Sie einen automatischen Snapshot** Im folgenden Beispiel für `delete-auto-snapshot` wird der automatische Snapshot `2019-10-10` der Instance `WordPress-1` gelöscht. ``` aws lightsail delete-auto-snapshot \ --resource-name WordPress-1 \ --date 2019-10-10 ``` Ausgabe: ``` { "operations": [ { "id": "31c36e09-3d52-46d5-b6d8-7EXAMPLE534a", "resourceName": "WordPress-1", "resourceType": "Instance", "createdAt": 1571088141.501, "location": { "availabilityZone": "us-west-2", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "DeleteAutoSnapshot-2019-10-10", "operationType": "DeleteAutoSnapshot", "status": "Succeeded" } ] } ``` *Weitere Informationen finden Sie unter [Löschen von automatischen Snapshots von Instances oder Festplatten in Amazon Lightsail im Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-deleting-automatic-snapshots) Dev Guide.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DeleteAutoSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-auto-snapshot.html)AWS CLI * ### `delete-disk-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-disk-snapshot`. **AWS CLI** **So löschen Sie einen Snapshot eines Blockspeicherdatenträgers** Im folgenden Beispiel für `delete-disk-snapshot` wird der angegebene Snapshot eines Blockspeicherdatenträgers gelöscht. ``` aws lightsail delete-disk-snapshot \ --disk-snapshot-name DiskSnapshot-1 ``` Ausgabe: ``` { "operations": [ { "id": "d1e5766d-b81e-4595-ad5d-02afbccfcd5d", "resourceName": "DiskSnapshot-1", "resourceType": "DiskSnapshot", "createdAt": 1569873552.79, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "DeleteDiskSnapshot", "status": "Succeeded", "statusChangedAt": 1569873552.79 } ] } ``` + Einzelheiten zur API finden Sie [DeleteDiskSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-disk-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `delete-disk` Das folgende Codebeispiel zeigt die Verwendung`delete-disk`. **AWS CLI** **So löschen Sie einen Blockspeicherdatenträger** Im folgenden Beispiel für `delete-disk` wird der angegebene Blockspeicherdatenträger gelöscht. ``` aws lightsail delete-disk \ --disk-name Disk-1 ``` Ausgabe: ``` { "operations": [ { "id": "6378c70f-4d75-4f7a-ab66-730fca0bb2fc", "resourceName": "Disk-1", "resourceType": "Disk", "createdAt": 1569872887.864, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "DeleteDisk", "status": "Succeeded", "statusChangedAt": 1569872887.864 } ] } ``` + Einzelheiten zur API finden Sie [DeleteDisk](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-disk.html)in der *AWS CLI Befehlsreferenz*. ### `delete-domain-entry` Das folgende Codebeispiel zeigt die Verwendung`delete-domain-entry`. **AWS CLI** **So löschen Sie einen Domaineintrag (DNS-Datensatz)** Im folgenden Beispiel für `delete-domain-entry` wird der angegebene Domaineintrag aus einer vorhandenen Domain gelöscht. **Hinweis:** Die domänenbezogenen API-Operationen von Lightsail sind nur in der Region verfügbar. `us-east-1` Wenn Ihr CLI-Profil für die Verwendung einer anderen Region konfiguriert ist, müssen Sie den Parameter `--region us-east-1` angeben, andernfalls schlägt der Befehl fehl. ``` aws lightsail delete-domain-entry \ --region us-east-1 \ --domain-name example.com \ --domain-entry name=123.example.com,target=192.0.2.0,type=A ``` Ausgabe: ``` { "operation": { "id": "06eacd01-d785-420e-8daa-823150c7dca1", "resourceName": "example.com ", "resourceType": "Domain", "createdAt": 1569874157.005, "location": { "availabilityZone": "all", "regionName": "global" }, "isTerminal": true, "operationType": "DeleteDomainEntry", "status": "Succeeded", "statusChangedAt": 1569874157.005 } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteDomainEntry](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-domain-entry.html).AWS CLI * ### `delete-domain` Das folgende Codebeispiel zeigt die Verwendung`delete-domain`. **AWS CLI** **So löschen Sie eine Domain (DNS-Zone)** Im folgenden Beispiel für `delete-domain` werden die angegebene Domain und alle Einträge in der Domain (DNS-Einträge) gelöscht. **Hinweis:** Die domänenbezogenen API-Operationen von Lightsail sind nur in der Region verfügbar. `us-east-1` Wenn Ihr CLI-Profil für die Verwendung einer anderen Region konfiguriert ist, müssen Sie den Parameter `--region us-east-1` angeben, andernfalls schlägt der Befehl fehl. ``` aws lightsail delete-domain \ --region us-east-1 \ --domain-name example.com ``` Ausgabe: ``` { "operation": { "id": "fcef5265-5af1-4a46-a3d7-90b5e18b9b32", "resourceName": "example.com", "resourceType": "Domain", "createdAt": 1569873788.13, "location": { "availabilityZone": "all", "regionName": "global" }, "isTerminal": true, "operationType": "DeleteDomain", "status": "Succeeded", "statusChangedAt": 1569873788.13 } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-domain.html).AWS CLI * ### `delete-instance-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-instance-snapshot`. **AWS CLI** **Titel** Im folgenden Beispiel für `delete-instance-snapshot` wird der angegebene Verified-Access-Snapshot einer Instance gelöscht. ``` aws lightsail delete-instance-snapshot \ --instance-snapshot-name WordPress-1-Snapshot-1 ``` Ausgabe: ``` { "operations": [ { "id": "14dad182-976a-46c6-bfd4-9480482bf0ea", "resourceName": "WordPress-1-Snapshot-1", "resourceType": "InstanceSnapshot", "createdAt": 1569874524.562, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "DeleteInstanceSnapshot", "status": "Succeeded", "statusChangedAt": 1569874524.562 } ] } ``` + Einzelheiten zur API finden Sie [DeleteInstanceSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-instance-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `delete-instance` Das folgende Codebeispiel zeigt die Verwendung`delete-instance`. **AWS CLI** **Um eine Instanz zu löschen** Im folgenden Beispiel für `delete-instance` wird die angegebene Instance gelöscht. ``` aws lightsail delete-instance \ --instance-name WordPress-1 ``` Ausgabe: ``` { "operations": [ { "id": "d77345a3-8f80-4d2e-b47d-aaa622718df2", "resourceName": "Disk-1", "resourceType": "Disk", "createdAt": 1569874357.469, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "WordPress-1", "operationType": "DetachDisk", "status": "Started", "statusChangedAt": 1569874357.469 }, { "id": "708fa606-2bfd-4e48-a2c1-0b856585b5b1", "resourceName": "WordPress-1", "resourceType": "Instance", "createdAt": 1569874357.465, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "Disk-1", "operationType": "DetachDisk", "status": "Started", "statusChangedAt": 1569874357.465 }, { "id": "3187e823-8acb-405d-b098-fad5ceb17bec", "resourceName": "WordPress-1", "resourceType": "Instance", "createdAt": 1569874357.829, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "DeleteInstance", "status": "Succeeded", "statusChangedAt": 1569874357.829 } ] } ``` + Einzelheiten zur API finden Sie [DeleteInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-instance.html)in der *AWS CLI Befehlsreferenz*. ### `delete-key-pair` Das folgende Codebeispiel zeigt die Verwendung`delete-key-pair`. **AWS CLI** **So löschen Sie ein Schlüsselpaar** Im folgenden Beispiel für `delete-key-pair` wird das angegebene Schlüsselpaar gelöscht. ``` aws lightsail delete-key-pair \ --key-pair-name MyPersonalKeyPair ``` Ausgabe: ``` { "operation": { "id": "81621463-df38-4810-b866-6e801a15abbf", "resourceName": "MyPersonalKeyPair", "resourceType": "KeyPair", "createdAt": 1569874626.466, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "DeleteKeyPair", "status": "Succeeded", "statusChangedAt": 1569874626.685 } } ``` + Einzelheiten zur API finden Sie [DeleteKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-key-pair.html)in der *AWS CLI Befehlsreferenz*. ### `delete-known-host-keys` Das folgende Codebeispiel zeigt die Verwendung`delete-known-host-keys`. **AWS CLI** **So löschen Sie bekannte Hostschlüssel aus einer Instance** Im folgenden Beispiel für `delete-known-host-keys` wird der bekannte Hostschlüssel aus der angegebenen Instance gelöscht. ``` aws lightsail delete-known-host-keys \ --instance-name Instance-1 ``` Ausgabe: ``` { "operations": [ { "id": "c61afe9c-45a4-41e6-a97e-d212364da3f5", "resourceName": "Instance-1", "resourceType": "Instance", "createdAt": 1569874760.201, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "DeleteKnownHostKeys", "status": "Succeeded", "statusChangedAt": 1569874760.201 } ] } ``` *Weitere Informationen finden Sie unter [Behebung von Verbindungsproblemen mit dem browserbasierten SSH- oder RDP-Client von Amazon Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-troubleshooting-browser-based-ssh-rdp-client-connection) im Lightsail Dev Guide.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DeleteKnownHostKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-known-host-keys.html)AWS CLI * ### `delete-load-balancer-tls-certificate` Das folgende Codebeispiel zeigt die Verwendung`delete-load-balancer-tls-certificate`. **AWS CLI** **So löschen Sie ein TLS-Zertifikat für einen Load Balancer** Im folgenden Beispiel für `delete-load-balancer-tls-certificate` wird das angegebene TLS-Zertifikat aus dem angegebenen Load Balancer gelöscht. ``` aws lightsail delete-load-balancer-tls-certificate \ --load-balancer-name MyFirstLoadBalancer \ --certificate-name MyFirstCertificate ``` Ausgabe: ``` { "operations": [ { "id": "50bec274-e45e-4caa-8a69-b763ef636583", "resourceName": "MyFirstCertificate", "resourceType": "LoadBalancerTlsCertificate", "createdAt": 1569874989.48, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "DeleteLoadBalancerTlsCertificate", "status": "Started", "statusChangedAt": 1569874989.48 }, { "id": "78c58cdc-a59a-4b27-8213-500638634a8f", "resourceName": "MyFirstLoadBalancer", "resourceType": "LoadBalancer", "createdAt": 1569874989.48, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "DeleteLoadBalancerTlsCertificate", "status": "Started", "statusChangedAt": 1569874989.48 } ] } ``` + Einzelheiten zur API finden Sie [DeleteLoadBalancerTlsCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-load-balancer-tls-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `delete-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`delete-load-balancer`. **AWS CLI** **So löschen Sie einen Load Balancer** Im folgenden Beispiel für `delete-load-balancer` werden der angegebene Load Balancer und alle zugeordneten TLS-Zertifikate gelöscht. ``` aws lightsail delete-load-balancer \ --load-balancer-name MyFirstLoadBalancer ``` Ausgabe: ``` { "operations": [ { "id": "a8c968c7-72a3-4680-a714-af8f03eea535", "resourceName": "MyFirstLoadBalancer", "resourceType": "LoadBalancer", "createdAt": 1569875092.125, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "DeleteLoadBalancer", "status": "Succeeded", "statusChangedAt": 1569875092.125 }, { "id": "f91a29fc-8ce3-4e69-a227-ea70ca890bf5", "resourceName": "MySecondCertificate", "resourceType": "LoadBalancerTlsCertificate", "createdAt": 1569875091.938, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "DeleteLoadBalancerTlsCertificate", "status": "Started", "statusChangedAt": 1569875091.938 }, { "id": "cf64c060-154b-4eb4-ba57-84e2e41563d6", "resourceName": "MyFirstLoadBalancer", "resourceType": "LoadBalancer", "createdAt": 1569875091.94, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "DeleteLoadBalancerTlsCertificate", "status": "Started", "statusChangedAt": 1569875091.94 } ] } ``` Weitere Informationen finden Sie unter „Titel“ im *Handbuch*. + Einzelheiten zur API finden Sie [DeleteLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `delete-relational-database-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-relational-database-snapshot`. **AWS CLI** **So löschen Sie einen Snapshot einer verwalteten Datenbank** Im folgenden Beispiel für `delete-relational-database-snapshot` wird der angegebene Snapshot einer verwalteten Datenbank gelöscht. ``` aws lightsail delete-relational-database-snapshot \ --relational-database-snapshot-name Database-Oregon-1-1566839359 ``` Ausgabe: ``` { "operations": [ { "id": "b99acae8-735b-4823-922f-30af580e3729", "resourceName": "Database-Oregon-1-1566839359", "resourceType": "RelationalDatabaseSnapshot", "createdAt": 1569875293.58, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "DeleteRelationalDatabaseSnapshot", "status": "Succeeded", "statusChangedAt": 1569875293.58 } ] } ``` + Einzelheiten zur API finden Sie [DeleteRelationalDatabaseSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-relational-database-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `delete-relational-database` Das folgende Codebeispiel zeigt die Verwendung`delete-relational-database`. **AWS CLI** **So löschen Sie eine verwaltete Datenbank** Im folgenden Beispiel für `delete-relational-database` wird die angegebene verwaltete Datenbank gelöscht. ``` aws lightsail delete-relational-database \ --relational-database-name Database-1 ``` Ausgabe: ``` { "operations": [ { "id": "3b0c41c1-053d-46f0-92a3-14f76141dc86", "resourceName": "Database-1", "resourceType": "RelationalDatabase", "createdAt": 1569875210.999, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "DeleteRelationalDatabase", "status": "Started", "statusChangedAt": 1569875210.999 }, { "id": "01ddeae8-a87a-4a4b-a1f3-092c71bf9180", "resourceName": "Database-1", "resourceType": "RelationalDatabase", "createdAt": 1569875211.029, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "Database-1-FinalSnapshot-1569875210793", "operationType": "CreateRelationalDatabaseSnapshot", "status": "Started", "statusChangedAt": 1569875211.029 }, { "id": "74d73681-30e8-4532-974e-1f23cd3f9f73", "resourceName": "Database-1-FinalSnapshot-1569875210793", "resourceType": "RelationalDatabaseSnapshot", "createdAt": 1569875211.029, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "Database-1", "operationType": "CreateRelationalDatabaseSnapshot", "status": "Started", "statusChangedAt": 1569875211.029 } ] } ``` + Einzelheiten zur API finden Sie [DeleteRelationalDatabase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/delete-relational-database.html)in der *AWS CLI Befehlsreferenz*. ### `detach-static-ip` Das folgende Codebeispiel zeigt die Verwendung`detach-static-ip`. **AWS CLI** **So trennen Sie eine statische IP von einer Instance** Im folgenden Beispiel für `detach-static-ip` wird die statische IP `StaticIp-1` von jeder angefügten Instance getrennt. ``` aws lightsail detach-static-ip \ --static-ip-name StaticIp-1 ``` Ausgabe: ``` { "operations": [ { "id": "2a43d8a3-9f2d-4fe7-bdd0-eEXAMPLE3cf3", "resourceName": "StaticIp-1", "resourceType": "StaticIp", "createdAt": 1571088261.999, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "MEAN-1", "operationType": "DetachStaticIp", "status": "Succeeded", "statusChangedAt": 1571088261.999 }, { "id": "41a7d40c-74e8-4d2e-a837-cEXAMPLEf747", "resourceName": "MEAN-1", "resourceType": "Instance", "createdAt": 1571088262.022, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "StaticIp-1", "operationType": "DetachStaticIp", "status": "Succeeded", "statusChangedAt": 1571088262.022 } ] } ``` + Einzelheiten zur API finden Sie [DetachStaticIp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/detach-static-ip.html)in der *AWS CLI Befehlsreferenz*. ### `get-active-names` Das folgende Codebeispiel zeigt die Verwendung`get-active-names`. **AWS CLI** **So rufen Sie aktive Ressourcennamen ab** Das folgende `get-active-names` Beispiel gibt die Namen der aktiven Ressourcen in der konfigurierten AWS Region zurück. ``` aws lightsail get-active-names ``` Ausgabe: ``` { "activeNames": [ "WordPress-1", "StaticIp-1", "MEAN-1", "Plesk_Hosting_Stack_on_Ubuntu-1" ] } ``` + Einzelheiten zur API finden Sie [GetActiveNames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-active-names.html)in der *AWS CLI Befehlsreferenz*. ### `get-auto-snapshots` Das folgende Codebeispiel zeigt die Verwendung`get-auto-snapshots`. **AWS CLI** **So rufen Sie die verfügbaren automatischen Snapshots für eine Instance ab** Im folgenden Beispiel für `get-auto-snapshots` werden die verfügbaren automatischen Snapshots für die Instance `WordPress-1` zurückgegeben. ``` aws lightsail get-auto-snapshots \ --resource-name WordPress-1 ``` Ausgabe: ``` { "resourceName": "WordPress-1", "resourceType": "Instance", "autoSnapshots": [ { "date": "2019-10-14", "createdAt": 1571033872.0, "status": "Success", "fromAttachedDisks": [] }, { "date": "2019-10-13", "createdAt": 1570947473.0, "status": "Success", "fromAttachedDisks": [] }, { "date": "2019-10-12", "createdAt": 1570861072.0, "status": "Success", "fromAttachedDisks": [] }, { "date": "2019-10-11", "createdAt": 1570774672.0, "status": "Success", "fromAttachedDisks": [] } ] } ``` *Weitere Informationen finden Sie unter [Automatisches Erstellen von Snapshots von Instances oder Festplatten in Amazon Lightsail im Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-keeping-automatic-snapshots) Dev Guide.* + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetAutoSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-auto-snapshots.html)AWS CLI * ### `get-blueprints` Das folgende Codebeispiel zeigt die Verwendung`get-blueprints`. **AWS CLI** **So rufen Sie die Vorlagen für neue Instances ab** Das folgende `get-blueprints` Beispiel zeigt Details zu allen verfügbaren Blueprints, die verwendet werden können, um neue Instances in Amazon Lightsail zu erstellen. ``` aws lightsail get-blueprints ``` Ausgabe: ``` { "blueprints": [ { "blueprintId": "wordpress", "name": "WordPress", "group": "wordpress", "type": "app", "description": "Bitnami, the leaders in application packaging, and Automattic, the experts behind WordPress, have teamed up to offer this official WordPress image. This image is a pre-configured, ready-to-run image for running WordPress on Amazon Lightsail. WordPress is the world's most popular content management platform. Whether it's for an enterprise or small business website, or a personal or corporate blog, content authors can easily create content using its new Gutenberg editor, and developers can extend the base platform with additional features. Popular plugins like Jetpack, Akismet, All in One SEO Pack, WP Mail, Google Analytics for WordPress, and Amazon Polly are all pre-installed in this image. Let's Encrypt SSL certificates are supported through an auto-configuration script.", "isActive": true, "minPower": 0, "version": "6.5.3-0", "versionCode": "1", "productUrl": "https://aws.amazon.com/marketplace/pp/B00NN8Y43U", "licenseUrl": "https://aws.amazon.com/marketplace/pp/B00NN8Y43U#pdp-usage", "platform": "LINUX_UNIX" }, { "blueprintId": "lamp_8_bitnami", "name": "LAMP (PHP 8)", "group": "lamp_8", "type": "app", "description": "LAMP with PHP 8.X packaged by Bitnami enables you to quickly start building your websites and applications by providing a coding framework. As a developer, it provides standalone project directories to store your applications. This blueprint is configured for production environments. It includes SSL auto-configuration with Let's Encrypt certificates, and the latest releases of PHP, Apache, and MariaDB on Linux. This application also includes phpMyAdmin, PHP main modules and Composer.", "isActive": true, "minPower": 0, "version": "8.2.18-4", "versionCode": "1", "productUrl": "https://aws.amazon.com/marketplace/pp/prodview-6g3gzfcih6dvu", "licenseUrl": "https://aws.amazon.com/marketplace/pp/prodview-6g3gzfcih6dvu#pdp-usage", "platform": "LINUX_UNIX" }, { "blueprintId": "nodejs", "name": "Node.js", "group": "node", "type": "app", "description": "Node.js packaged by Bitnami is a pre-configured, ready to run image for Node.js on Amazon EC2. It includes the latest version of Node.js, Apache, Python and Redis. The image supports multiple Node.js applications, each with its own virtual host and project directory. It is configured for production use and is secure by default, as all ports except HTTP, HTTPS and SSH ports are closed. Let's Encrypt SSL certificates are supported through an auto-configuration script. Developers benefit from instant access to a secure, update and consistent Node.js environment without having to manually install and configure multiple components and libraries.", "isActive": true, "minPower": 0, "version": "18.20.2-0", "versionCode": "1", "productUrl": "https://aws.amazon.com/marketplace/pp/B00NNZUAKO", "licenseUrl": "https://aws.amazon.com/marketplace/pp/B00NNZUAKO#pdp-usage", "platform": "LINUX_UNIX" }, ... } ] } ``` + *Einzelheiten zur API finden Sie [GetBlueprints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-blueprints.html)in AWS CLI der Befehlsreferenz.* ### `get-bundles` Das folgende Codebeispiel zeigt die Verwendung`get-bundles`. **AWS CLI** **So rufen Sie Pakete für neue Instances ab** Das folgende `get-bundles` Beispiel zeigt Details zu allen verfügbaren Bundles, die zum Erstellen neuer Instances in Amazon Lightsail verwendet werden können. ``` aws lightsail get-bundles ``` Ausgabe: ``` { "bundles": [ { "price": 5.0, "cpuCount": 2, "diskSizeInGb": 20, "bundleId": "nano_3_0", "instanceType": "nano", "isActive": true, "name": "Nano", "power": 298, "ramSizeInGb": 0.5, "transferPerMonthInGb": 1024, "supportedPlatforms": [ "LINUX_UNIX" ] }, { "price": 7.0, "cpuCount": 2, "diskSizeInGb": 40, "bundleId": "micro_3_0", "instanceType": "micro", "isActive": true, "name": "Micro", "power": 500, "ramSizeInGb": 1.0, "transferPerMonthInGb": 2048, "supportedPlatforms": [ "LINUX_UNIX" ] }, { "price": 12.0, "cpuCount": 2, "diskSizeInGb": 60, "bundleId": "small_3_0", "instanceType": "small", "isActive": true, "name": "Small", "power": 1000, "ramSizeInGb": 2.0, "transferPerMonthInGb": 3072, "supportedPlatforms": [ "LINUX_UNIX" ] }, ... } ] } ``` + *Einzelheiten zur API finden Sie [GetBundles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-bundles.html)in AWS CLI der Befehlsreferenz.* ### `get-cloud-formation-stack-records` Das folgende Codebeispiel zeigt die Verwendung`get-cloud-formation-stack-records`. **AWS CLI** **Um die CloudFormation Stack-Datensätze und die zugehörigen Stapel abzurufen** Das folgende `get-cloud-formation-stack-records` Beispiel zeigt Details zu den CloudFormation Stack-Datensätzen und den zugehörigen Stacks, die verwendet wurden, um Amazon EC2 EC2-Ressourcen aus exportierten Amazon Lightsail-Snapshots zu erstellen. ``` aws lightsail get-cloud-formation-stack-records ``` Ausgabe: ``` { "cloudFormationStackRecords": [ { "name": "CloudFormationStackRecord-588a4243-e2d1-490d-8200-3a7513ecebdf", "arn": "arn:aws:lightsail:us-west-2:111122223333:CloudFormationStackRecord/28d646ab-27bc-48d9-a422-1EXAMPLE6d37", "createdAt": 1565301666.586, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "CloudFormationStackRecord", "state": "Succeeded", "sourceInfo": [ { "resourceType": "ExportSnapshotRecord", "name": "ExportSnapshotRecord-e02f23d7-0453-4aa9-9c95-91aa01a141dd", "arn": "arn:aws:lightsail:us-west-2:111122223333:ExportSnapshotRecord/f12b8792-f3ea-4d6f-b547-2EXAMPLE8796" } ], "destinationInfo": { "id": "arn:aws:cloudformation:us-west-2:111122223333:stack/Lightsail-Stack-588a4243-e2d1-490d-8200-3EXAMPLEebdf/063203b0-ba28-11e9-838b-0EXAMPLE8b00", "service": "Aws::CloudFormation::Stack" } } ] } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetCloudFormationStackRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-cloud-formation-stack-records.html)AWS CLI * ### `get-disk-snapshot` Das folgende Codebeispiel zeigt die Verwendung`get-disk-snapshot`. **AWS CLI** **So rufen Sie Informationen zu einem Datenträger-Snapshot ab** Im folgenden Beispiel für `get-disk-snapshot` werden Details zum Datenträger-Snapshot `Disk-1-1566839161` angezeigt. ``` aws lightsail get-disk-snapshot \ --disk-snapshot-name Disk-1-1566839161 ``` Ausgabe: ``` { "diskSnapshot": { "name": "Disk-1-1566839161", "arn": "arn:aws:lightsail:us-west-2:111122223333:DiskSnapshot/e2d0fa53-8ee0-41a0-8e56-0EXAMPLE1051", "supportCode": "6EXAMPLE3362/snap-0EXAMPLE06100d09", "createdAt": 1566839163.749, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "DiskSnapshot", "tags": [], "sizeInGb": 8, "state": "completed", "progress": "100%", "fromDiskName": "Disk-1", "fromDiskArn": "arn:aws:lightsail:us-west-2:111122223333:Disk/c21cfb0a-07f2-44ae-9a23-bEXAMPLE8096", "isFromAutoSnapshot": false } } ``` Weitere Informationen finden Sie unter „Titel“ im *Handbuch*. + Einzelheiten zur API finden Sie [GetDiskSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-disk-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `get-disk-snapshots` Das folgende Codebeispiel zeigt die Verwendung`get-disk-snapshots`. **AWS CLI** **So rufen Sie Informationen zu allen Datenträger-Snapshots ab** Im folgenden `get-disk-snapshots` Beispiel werden Details zu allen Festplatten-Snapshots in der konfigurierten AWS Region angezeigt. ``` aws lightsail get-disk-snapshots ``` Ausgabe: ``` { "diskSnapshots": [ { "name": "Disk-2-1571090588", "arn": "arn:aws:lightsail:us-west-2:111122223333:DiskSnapshot/32e889a9-38d4-4687-9f21-eEXAMPLE7839", "supportCode": "6EXAMPLE3362/snap-0EXAMPLE1ca192a4", "createdAt": 1571090591.226, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "DiskSnapshot", "tags": [], "sizeInGb": 8, "state": "completed", "progress": "100%", "fromDiskName": "Disk-2", "fromDiskArn": "arn:aws:lightsail:us-west-2:111122223333:Disk/6a343ff8-6341-422d-86e2-bEXAMPLE16c2", "isFromAutoSnapshot": false }, { "name": "Disk-1-1566839161", "arn": "arn:aws:lightsail:us-west-2:111122223333:DiskSnapshot/e2d0fa53-8ee0-41a0-8e56-0EXAMPLE1051", "supportCode": "6EXAMPLE3362/snap-0EXAMPLEe06100d09", "createdAt": 1566839163.749, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "DiskSnapshot", "tags": [], "sizeInGb": 8, "state": "completed", "progress": "100%", "fromDiskName": "Disk-1", "fromDiskArn": "arn:aws:lightsail:us-west-2:111122223333:Disk/c21cfb0a-07f2-44ae-9a23-bEXAMPLE8096", "isFromAutoSnapshot": false } ] } ``` + Einzelheiten zur API finden Sie unter [GetDiskSnapshots AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-disk-snapshots.html)*Befehlsreferenz.* ### `get-disk` Das folgende Codebeispiel zeigt die Verwendung`get-disk`. **AWS CLI** **So rufen Sie Informationen zu einem Blockspeicherdatenträger ab** Im folgenden Beispiel für `get-disk` werden Details zum Datenträger `Disk-1` angezeigt. ``` aws lightsail get-disk \ --disk-name Disk-1 ``` Ausgabe: ``` { "disk": { "name": "Disk-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:Disk/c21cfb0a-07f2-44ae-9a23-bEXAMPLE8096", "supportCode": "6EXAMPLE3362/vol-0EXAMPLEf2f88b32f", "createdAt": 1566585439.587, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "Disk", "tags": [], "sizeInGb": 8, "isSystemDisk": false, "iops": 100, "path": "/dev/xvdf", "state": "in-use", "attachedTo": "WordPress_Multisite-1", "isAttached": true, "attachmentState": "attached" } } ``` Weitere Informationen finden Sie unter „Titel“ im *Handbuch*. + Einzelheiten zur API finden Sie [GetDisk](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-disk.html)in der *AWS CLI Befehlsreferenz*. ### `get-disks` Das folgende Codebeispiel zeigt die Verwendung`get-disks`. **AWS CLI** **So rufen Sie Informationen zu allen Blockspeicherdatenträgern ab** Im folgenden `get-disks` Beispiel werden Details zu allen Festplatten in der konfigurierten AWS Region angezeigt. ``` aws lightsail get-disks ``` Ausgabe: ``` { "disks": [ { "name": "Disk-2", "arn": "arn:aws:lightsail:us-west-2:111122223333:Disk/6a343ff8-6341-422d-86e2-bEXAMPLE16c2", "supportCode": "6EXAMPLE3362/vol-0EXAMPLE929602087", "createdAt": 1571090461.634, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "Disk", "tags": [], "sizeInGb": 8, "isSystemDisk": false, "iops": 100, "state": "available", "isAttached": false, "attachmentState": "detached" }, { "name": "Disk-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:Disk/c21cfb0a-07f2-44ae-9a23-bEXAMPLE8096", "supportCode": "6EXAMPLE3362/vol-0EXAMPLEf2f88b32f", "createdAt": 1566585439.587, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "Disk", "tags": [], "sizeInGb": 8, "isSystemDisk": false, "iops": 100, "path": "/dev/xvdf", "state": "in-use", "attachedTo": "WordPress_Multisite-1", "isAttached": true, "attachmentState": "attached" } ] } ``` + Einzelheiten zur API finden Sie [GetDisks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-disks.html)in der *AWS CLI Befehlsreferenz*. ### `get-domain` Das folgende Codebeispiel zeigt die Verwendung`get-domain`. **AWS CLI** **So rufen Sie Informationen zu einer Domain auf** Im folgenden Beispiel für `get-domain` werden Details zur Domain `example.com` angezeigt. **Hinweis:** Die domänenbezogenen API-Operationen von Lightsail sind nur in der Region verfügbar. `us-east-1` AWS Wenn Ihr CLI-Profil für die Verwendung einer anderen Region konfiguriert ist, müssen Sie den Parameter „--region us-east-1“ angeben, andernfalls schlägt der Befehl fehl. ``` aws lightsail get-domain \ --domain-name example.com \ --region us-east-1 ``` Ausgabe: ``` { "domain": { "name": "example.com", "arn": "arn:aws:lightsail:global:111122223333:Domain/28cda903-3f15-44b2-9baf-3EXAMPLEb304", "supportCode": "6EXAMPLE3362//hostedzone/ZEXAMPLEONGSC1", "createdAt": 1570728588.6, "location": { "availabilityZone": "all", "regionName": "global" }, "resourceType": "Domain", "tags": [], "domainEntries": [ { "id": "-1682899164", "name": "example.com", "target": "192.0.2.0", "isAlias": false, "type": "A" }, { "id": "1703104243", "name": "example.com", "target": "ns-137.awsdns-17.com", "isAlias": false, "type": "NS" }, { "id": "-1038331153", "name": "example.com", "target": "ns-1710.awsdns-21.co.uk", "isAlias": false, "type": "NS" }, { "id": "-2107289565", "name": "example.com", "target": "ns-692.awsdns-22.net", "isAlias": false, "type": "NS" }, { "id": "1582095705", "name": "example.com", "target": "ns-1436.awsdns-51.org", "isAlias": false, "type": "NS" }, { "id": "-1769796132", "name": "example.com", "target": "ns-1710.awsdns-21.co.uk. awsdns-hostmaster.amazon.com. 1 7200 900 1209600 86400", "isAlias": false, "type": "SOA" } ] } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [GetDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-domain.html).AWS CLI * ### `get-domains` Das folgende Codebeispiel zeigt die Verwendung`get-domains`. **AWS CLI** **So rufen Sie Informationen zu allen Domains ab** Im folgenden `get-domains` Beispiel werden Details zu allen Domänen in der konfigurierten AWS Region angezeigt. **Hinweis:** Die domänenbezogenen API-Operationen von Lightsail sind nur in der Region verfügbar. `us-east-1` AWS Wenn Ihr CLI-Profil für die Verwendung einer anderen Region konfiguriert ist, müssen Sie den Parameter `--region us-east-1` angeben, andernfalls schlägt der Befehl fehl. ``` aws lightsail get-domains \ --region us-east-1 ``` Ausgabe: ``` { "domains": [ { "name": "example.com", "arn": "arn:aws:lightsail:global:111122223333:Domain/28cda903-3f15-44b2-9baf-3EXAMPLEb304", "supportCode": "6EXAMPLE3362//hostedzone/ZEXAMPLEONGSC1", "createdAt": 1570728588.6, "location": { "availabilityZone": "all", "regionName": "global" }, "resourceType": "Domain", "tags": [], "domainEntries": [ { "id": "-1682899164", "name": "example.com", "target": "192.0.2.0", "isAlias": false, "type": "A" }, { "id": "1703104243", "name": "example.com", "target": "ns-137.awsdns-17.com", "isAlias": false, "type": "NS" }, { "id": "-1038331153", "name": "example.com", "target": "ns-4567.awsdns-21.co.uk", "isAlias": false, "type": "NS" }, { "id": "-2107289565", "name": "example.com", "target": "ns-333.awsdns-22.net", "isAlias": false, "type": "NS" }, { "id": "1582095705", "name": "example.com", "target": "ns-1111.awsdns-51.org", "isAlias": false, "type": "NS" }, { "id": "-1769796132", "name": "example.com", "target": "ns-1234.awsdns-21.co.uk. awsdns-hostmaster.amazon.com. 1 7200 900 1209600 86400", "isAlias": false, "type": "SOA" }, { "id": "1029454894", "name": "_dead6a124ede046a0319eb44a4eb3cbc.example.com", "target": "_be133b0a0899fb7b6bf79d9741d1a383.hkvuiqjoua.acm-validations.aws", "isAlias": false, "type": "CNAME" } ] }, { "name": "example.net", "arn": "arn:aws:lightsail:global:111122223333:Domain/9c9f0d70-c92e-4753-86c2-6EXAMPLE029d", "supportCode": "6EXAMPLE3362//hostedzone/ZEXAMPLE5TPKMV", "createdAt": 1556661071.384, "location": { "availabilityZone": "all", "regionName": "global" }, "resourceType": "Domain", "tags": [], "domainEntries": [ { "id": "-766320943", "name": "example.net", "target": "192.0.2.2", "isAlias": false, "type": "A" }, { "id": "-453913825", "name": "example.net", "target": "ns-123.awsdns-10.net", "isAlias": false, "type": "NS" }, { "id": "1553601564", "name": "example.net", "target": "ns-4444.awsdns-47.co.uk", "isAlias": false, "type": "NS" }, { "id": "1653797661", "name": "example.net", "target": "ns-7890.awsdns-61.org", "isAlias": false, "type": "NS" }, { "id": "706414698", "name": "example.net", "target": "ns-123.awsdns-44.com", "isAlias": false, "type": "NS" }, { "id": "337271745", "name": "example.net", "target": "ns-4444.awsdns-47.co.uk. awsdns-hostmaster.amazon.com. 1 7200 900 1209600 86400", "isAlias": false, "type": "SOA" }, { "id": "-1785431096", "name": "www.example.net", "target": "192.0.2.2", "isAlias": false, "type": "A" } ] }, { "name": "example.org", "arn": "arn:aws:lightsail:global:111122223333:Domain/f0f13ba3-3df0-4fdc-8ebb-1EXAMPLEf26e", "supportCode": "6EXAMPLE3362//hostedzone/ZEXAMPLEAFO38", "createdAt": 1556661199.106, "location": { "availabilityZone": "all", "regionName": "global" }, "resourceType": "Domain", "tags": [], "domainEntries": [ { "id": "2065301345", "name": "example.org", "target": "192.0.2.4", "isAlias": false, "type": "A" }, { "id": "-447198516", "name": "example.org", "target": "ns-123.awsdns-45.com", "isAlias": false, "type": "NS" }, { "id": "136463022", "name": "example.org", "target": "ns-9999.awsdns-15.co.uk", "isAlias": false, "type": "NS" }, { "id": "1395941679", "name": "example.org", "target": "ns-555.awsdns-01.net", "isAlias": false, "type": "NS" }, { "id": "872052569", "name": "example.org", "target": "ns-6543.awsdns-38.org", "isAlias": false, "type": "NS" }, { "id": "1001949377", "name": "example.org", "target": "ns-1234.awsdns-15.co.uk. awsdns-hostmaster.amazon.com. 1 7200 900 1209600 86400", "isAlias": false, "type": "SOA" }, { "id": "1046191192", "name": "www.example.org", "target": "192.0.2.4", "isAlias": false, "type": "A" } ] } ] } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [GetDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-domains.html).AWS CLI * ### `get-export-snapshot-record` Das folgende Codebeispiel zeigt die Verwendung`get-export-snapshot-record`. **AWS CLI** **So rufen Sie die Datensätze von Snapshots ab, die nach Amazon EC2 exportiert wurden** Das folgende `get-export-snapshot-record` Beispiel zeigt Details zu Amazon Lightsail-Instance- oder Festplatten-Snapshots, die nach Amazon EC2 exportiert wurden. ``` aws lightsail get-export-snapshot-records ``` Ausgabe: ``` { "exportSnapshotRecords": [ { "name": "ExportSnapshotRecord-d2da10ce-0b3c-4ae1-ab3a-2EXAMPLEa586", "arn": "arn:aws:lightsail:us-west-2:111122223333:ExportSnapshotRecord/076c7060-b0cc-4162-98f0-2EXAMPLEe28e", "createdAt": 1543534665.678, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "ExportSnapshotRecord", "state": "Succeeded", "sourceInfo": { "resourceType": "InstanceSnapshot", "createdAt": 1540339310.706, "name": "WordPress-512MB-Oregon-1-1540339219", "arn": "arn:aws:lightsail:us-west-2:111122223333:InstanceSnapshot/5446f534-ed60-4c17-b4a5-bEXAMPLEf8b7", "fromResourceName": "WordPress-512MB-Oregon-1", "fromResourceArn": "arn:aws:lightsail:us-west-2:111122223333:Instance/4b8f1f24-e4d1-4cf3-88ff-cEXAMPLEa397", "instanceSnapshotInfo": { "fromBundleId": "nano_2_0", "fromBlueprintId": "wordpress_4_9_8", "fromDiskInfo": [ { "path": "/dev/sda1", "sizeInGb": 20, "isSystemDisk": true } ] } }, "destinationInfo": { "id": "ami-0EXAMPLEc0d65058e", "service": "Aws::EC2::Image" } }, { "name": "ExportSnapshotRecord-1c94e884-40ff-4fe1-9302-0EXAMPLE14c2", "arn": "arn:aws:lightsail:us-west-2:111122223333:ExportSnapshotRecord/fb392ce8-6567-4013-9bfd-3EXAMPLE5b4c", "createdAt": 1543432110.2, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "ExportSnapshotRecord", "state": "Succeeded", "sourceInfo": { "resourceType": "InstanceSnapshot", "createdAt": 1540833603.545, "name": "LAMP_PHP_5-512MB-Oregon-1-1540833565", "arn": "arn:aws:lightsail:us-west-2:111122223333:InstanceSnapshot/82334399-b5f2-49ec-8382-0EXAMPLEe45f", "fromResourceName": "LAMP_PHP_5-512MB-Oregon-1", "fromResourceArn": "arn:aws:lightsail:us-west-2:111122223333:Instance/863b9f35-ab1e-4418-bdd2-1EXAMPLEbab2", "instanceSnapshotInfo": { "fromBundleId": "nano_2_0", "fromBlueprintId": "lamp_5_6_37_2", "fromDiskInfo": [ { "path": "/dev/sda1", "sizeInGb": 20, "isSystemDisk": true } ] } }, "destinationInfo": { "id": "ami-0EXAMPLE7c5ec84e2", "service": "Aws::EC2::Image" } } ] } ``` + *Einzelheiten zur API finden Sie unter [GetExportSnapshotRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-export-snapshot-record.html)Befehlsreferenz.AWS CLI * ### `get-instance-access-details` Das folgende Codebeispiel zeigt die Verwendung`get-instance-access-details`. **AWS CLI** **So rufen Sie Informationen zu Hostschlüsseln für eine Instance ab** Im folgenden Beispiel für `get-instance-access-details` werden Informationen zu Hostschlüsseln für die Instance `WordPress_Multisite-1` angezeigt. ``` aws lightsail get-instance-access-details \ --instance-name WordPress_Multisite-1 ``` Ausgabe: ``` { "accessDetails": { "certKey": "ssh-rsa-cert-v01@openssh.com AEXAMPLEaC1yc2EtY2VydC12MDFAb3BlbnNzaC5jb20AAAAgNf076Dt3ppmPd0fPxZVMmS491aEAYYH9cHqAJ3fNML8AAAADAQABAAABAQD4APep5Ta2gHLk7m/vEXAMPLE2eBWJyQvn7ol/i0+s966h5sx8qUD79lPB7q5UESd5VZGFtytrykfQJnjiwqe7EV5agzvjblLj26Fb37EKda9HVfCOu8pWbvky7Tyn9w299a6CsG5o8HrkOymDE2c59lYxXGkilKo5I9aZLBAdXn3t3oKtq9zsjYGjyEmarPYoVDT1ft8HaUGu4aCv1peI0+ZEXAMPLEAWaucW9Huh0WYN5yrmL252c4v13JTVmytaEZvLvt5itVoWXQY0ZDyrLUcZSKxyq5n00Mgvj2fiZdt+xMfQM9xVz0rXZmqx8uJidJpRgLCMTviofwQJU/K1EXAMPLEAAAAAAAABAAAALS00MzMzMDU4MzA4ODg1MTY2NjM4Onp6UWlndHk4UElRSG9STitOTG5QSEE9PQAAAAsAAAAHYml0bmFtaQAAAABdpPL7AAEXAMPLEgcAAAAAAAAAggAAABVwZXJtaXQtWDExLWZvcndhcmRpbmcAAAAAAAAAF3Blcm1pdC1hZ2VudC1mb3J3YXJkaW5nAAAAAAAAABZwZXJtaXQtEXAMPLEmb3J3YXJkaW5nAAAAAAAAAApwZXJtaXQtcHR5AAAAAAAAAA5wZXJtaXQtdXNlci1yYwAAAAAAAAAAAAACFwAAAAdzc2gtcnNhAAAAAwEAAQEXAMPLECqCbiK9b450HtRD1ZpiksT6oxc8U7nLNkVFC1j7JqZvP9ee3ux+LiB+ozNbUA0cdNL9Y67x7qPv/R7XhTc21+2A+8+GuVpK/Kz9dqDMKNAEXAMPLE+YYN+tiXm7Y8OgziK+7iDB7xUuQ4vghmn4+qgz9mKwYgWvVe2+0XLuV7cnWPB7iUlHQg+E3LUKrV4ZFw9pj7X2dFdNKfMxwWgI1ISWKimEXAMPLEeHjrf1Rqc/QH6TpWCvPfcx8uvwVqdwTfkE/SfA5BCzbGGI1UmIUadh8nHcb5FamQ1hK7kECy47K/x9FMn/KwmM7pCwJbSLDMO7n9bnbvck6m8ZoB2N2YLMG5dW7BerEXAMPLEobqfdtyYJHHel1EyyEJs1fWNU3D5JIGlgzcPAV+ZlbQyUCZXf0oslSa+HE85fO/FRq9SVSBSHrmbeb0frlPhgMzgSmqLeyhlbr6wwWIDbREXAMPLEJZ49H7RdQxdKyYrZPWvRgcr0qI2EL0tAajnpQQ8UZqeO9/Aqter0xN5PhFL0J49OWTacwCGRAjLhibAx7K1t/1ZXWo6c+ijq8clll327EXAMPLE/e89GC89KcmKCxfGQniDAUgF8UqofIbq3ZOUgiAAYCVXclI4L68NhVXyoWuQXPBRQSEXAMPLEWm74tDL9tFN3c7tSe/Oz0cTR+4sAAAIPAAAAB3NzaC1yc2EAAAIAQnG/L0DqiSnLrWhEox4aHqMgd0m0oLLAYx6OQH9F0TM9EXAMPLE961rzSCMon7ZgsWNnL0OwZQgDG+rtJ4N0B7HOVwns4ynUFbzNQ3qFGGeE3lKwX1L41vV1iSy7sDk8aI0LmrKJi1LE1Qc1l8uboRlwoXOYEXAMPLEaUCeX+10+WEXAMPLEg6Y4U4ZvE2B3xyRdpvysb5TGFNtk5qPslacnVkoLOGsZZXMpLGJnG4OBpQLLtpj9sNMxAgZPCAUjhkqkQWYJxJzvFN7sUMOArUwKPFJE2kaEXAMPLEOUrVGBbCTioRztlPsxY7hoXm73N929eZpNhxP3U+nxO9O4NUZ2pTWbVSUaV1gm6pug9xbwNO1Im21t34JeLlKTqxcJ6zzS8W0c0KKpAm5c4hWkseMbyutS2jav/4hiS+BhrYgptzfwe5qRXEXAMPLEHZQr3YfGzYoBJ/lLK3NHhxOihhsfAYwMei0BFZT1F/7CT3IH4iitEkIgodi06/Mw6UDqMPozyQCK1lEA6LFhYCOZG9drWcoRa74lM4kY9TP028Za8gDMh1WpkXLq9Gixon5OHP8aM/sEXAMPLEr2+fnkw+1BtoO5L6+VKoPlXaGqZ/fBYEXAMPLEAMQHjnLM1JYNvtEEPhp+TNzXHzuixWf/Ht04m0AVpXrzIDXaS1O2tXY=", "ipAddress": "192.0.2.0", "privateKey": "-----BEGIN RSA PRIVATE KEY-----\nEXAMPLEBAAKCAQEA+AD3qeU2toBy5O5v7wnRLVo/tngVickL5+6Jf4tPrPeuoebM\nfKlA+/ZTwe6uVBEneVWRhbcra8pH0CZ44sKnuxFeWoM7425S49uhW9+xCnWvR1Xw\njrvKVm75Mu08p/cNvfWugrBuaPB65DspgxNnOfZWMVxpIpSqOSPWmSwQHV597d6C\nrEXAMPLEo8hJmqz2KFQ09X7fB2lBruGgr9aXiNPmWmovYKqwFmrnFvR7odFmDecq\n5EXAMPLE9dyU1ZsrWhGby77eYrVaFl0GNGQ8qy1HGUiscquZ9NDIL49n4mXbfsTH\n0EXAMPLE12ZqsfLiYnSaUYCwjE74qH8ECVPytQIDAQABAoIBAHeZV9Z58JHAjifz\nCEXAMPLEEqC3doOVDgXSlkKI92qNo4z2VcUEho878paCuVVXVHcCGgSnGeyIh2tN\nMEXAMPLESohR427BhH3YLA+3Z5SIvnejbTgYPfLC37B8khTaYqkqMvdZiFVZK5qn\nIEXAMPLEM93oF9eSZCjcLKB/jGHsfb0eCDMP8BshHE2beuqzVMoK1DxOnvoP3+Fp\nAEXAMPLESq6pDpCo9YVUX8g1u3Ro9cPl2LXHDy+oVEY5KhbZQJ7VU1I72WOvppWW\nOEXAMPLEkgYlq7p6qYtYcSgTEjz14gDiMfQ7SyHB3alkIoNONQ9ZPaWHyJvymeud\noQTNuz0CgYEA/LFWNTEZrzdzdR1kJmyNRmAermU0B6utyNENChAlHGSHkB+1lVSh\nbEXAMPLEQo9ooUeW5UxO3YwacZLoDT1mwxw1Ptc1+PNycZoLe1fE9UdARrdmGTob\n8l7CPLSXp3xuR8VqSp2fnIc7hfiQs/NrPX9gm/EOrB0we0RKyDSzWScCgYEA+z/r\niob+nJZq0YbnOSuP6oMULP4vnWniWj8MIhUJU53LwSAM8DeJdONKDdkuiOd52aAL\nVgn7nLo88rVWKhJwVc4tu/rNgZLcR3bP4+kL6zand0KQnMLyOzNA2Ys26aa5udH1\nqWl0WTt9WEm/h10ndC1knOMectrvsG17b38y5sMCgYEA54NiRGGz8oCPW6GN/FZA\nKEXAMPLE5tw34GEH3Uxlc9n3CejDaQmczOATwX4nIwRZDEqWyYZcS0btg1jhGiBD\nYEXAMPLEkc8Z71L/agZEAaVCEog9FqfSqwB+XTfoKh8qur74X1yCu9p6gof1q6k9\neEXAMPLEchJcNNOg4ETIfMkCgYBdVORRhE4mqvWpOdzA7v66FdEz2YSkjAXKkmsW\naEXAMPLE8Z/8yBSmuBv1Qv03XA12my462uB92uzzGAuW+1yBc2Kn1sXqYTy0y1z0\ngEXAMPLEBogjw4MqHKL1bPKMHyQU8/q24PaYgzHPzy13wlH6pTYf1XqlHdE2D6Vv\nyEXAMPLEgQC3i/kVVhky/2XRwRVlC7JO2Bg3QGTx38hpmDa5IuofKANjA+Wa3/zy\nbEXAMPLE6ytQgD9GN/YtBq+uhO+2ZkvXPL+CWRi0ZRXpPwYDBBFU9Cw0AuWWGlL8\nwEXAMPLExMlcysRgcWB9RNgf3AuOpFd2i6XT/riNsvvkpmJ+VooU8g==\n-----END RSA PRIVATE KEY-----\n", "protocol": "ssh", "instanceName": "WordPress_Multisite-1", "username": "bitnami", "hostKeys": [ { "algorithm": "ssh-rsa", "publicKey": "AEXAMPLEaC1yc2EAAAADAQABAAABAQCoeR9ieZTjQ3pXCHczuAYZFjlF7t+uBkXuqeGMRex78pCvmS+DiEXAMPLEuJ1Q8dcKhrQL4HpXbD9dosVCTaJnJwb4MQqsuSVFdHFzy3guP+BKclWqtxJEXAMPLEsBGqZZlrIv6a9bTA0TCplZ8AD+hSRTaSXXqg6FT+Qf16IktH0XlMs7xIEXAMPLEmNtjCpzZiGXDHzytoMvUgwa8uHPp44Og36EUu4VqQxoUHPJKoXvcQizyk3K8ym0hP0TpDZhD8cqwRfd6EHp4Q1br/Ot6y9HwvykEXAMPLEAfbKjbR42+u6+OSlkr4d339q2U1sTDytJhhs8HUel1wTfGRfp", "witnessedAt": 1570744377.699, "fingerprintSHA1": "SHA1:GEXAMPLEMoYgUg0ucadqU9Bt3Lk", "fingerprintSHA256": "SHA256:IEXAMPLEcB5vgxnAUoJawbdZ+MwELhIp6FUxuwq/LIU" }, { "algorithm": "ssh-ed25519", "publicKey": "AEXAMPLEaC1lZDI1NTE5AAAAIC1gwGPDfGaONxEXAMPLEJX3UNap781QxHQmn8nzlrUv", "witnessedAt": 1570744377.697, "fingerprintSHA1": "SHA1:VEXAMPLE5ReqSmTgv03sSUw9toU", "fingerprintSHA256": "SHA256:0EXAMPLEdE6tI95k3TJpG+qhJbAoknB0yz9nAEaDt3A" }, { "algorithm": "ecdsa-sha2-nistp256", "publicKey": "AEXAMPLEZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABEXAMPLE9B4mZy8YSsZW7cixCDq5yHSAAxjJkDo54C+EnKlDCsYtUkxxEXAMPLE6VOWL2z63RTKa2AUPgd8irjxWI=", "witnessedAt": 1570744377.707, "fingerprintSHA1": "SHA1:UEXAMPLEOYCfXsCf2G6tDg+7YG0", "fingerprintSHA256": "SHA256:wEXAMPLEQ9a/iEXAMPLEhRufm6U9vFU4cpkMPHnBsNA" } ] } } ``` + Einzelheiten zur API finden Sie [GetInstanceAccessDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-instance-access-details.html)in der *AWS CLI Befehlsreferenz*. ### `get-instance-metric-data` Das folgende Codebeispiel zeigt die Verwendung`get-instance-metric-data`. **AWS CLI** **So rufen Sie Metrikdaten für eine Instance ab** Im folgenden Beispiel für `get-instance-metric-data` wird der durchschnittliche Prozentsatz von `CPUUtilization` alle `7200` Sekunden (2 Stunden) zwischen `1571342400` und `1571428800` für die Instance `MEAN-1` zurückgegeben. Wir empfehlen, einen Unix-Zeitkonverter zu verwenden, um die Start- und Endzeiten zu ermitteln. ``` aws lightsail get-instance-metric-data \ --instance-name MEAN-1 \ --metric-name CPUUtilization \ --period 7200 \ --start-time 1571342400 \ --end-time 1571428800 \ --unit Percent \ --statistics Average ``` Ausgabe: ``` { "metricName": "CPUUtilization", "metricData": [ { "average": 0.26113718770120725, "timestamp": 1571342400.0, "unit": "Percent" }, { "average": 0.26861268928111953, "timestamp": 1571392800.0, "unit": "Percent" }, { "average": 0.28187475104748777, "timestamp": 1571378400.0, "unit": "Percent" }, { "average": 0.2651936960458352, "timestamp": 1571421600.0, "unit": "Percent" }, { "average": 0.2561856213712188, "timestamp": 1571371200.0, "unit": "Percent" }, { "average": 0.3021383254607764, "timestamp": 1571356800.0, "unit": "Percent" }, { "average": 0.2618381649223539, "timestamp": 1571407200.0, "unit": "Percent" }, { "average": 0.26331929394825787, "timestamp": 1571400000.0, "unit": "Percent" }, { "average": 0.2576348407007818, "timestamp": 1571385600.0, "unit": "Percent" }, { "average": 0.2513008454658378, "timestamp": 1571364000.0, "unit": "Percent" }, { "average": 0.26329974562758346, "timestamp": 1571414400.0, "unit": "Percent" }, { "average": 0.2667092536656445, "timestamp": 1571349600.0, "unit": "Percent" } ] } ``` + Einzelheiten zur API finden Sie [GetInstanceMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-instance-metric-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-instance-port-states` Das folgende Codebeispiel zeigt die Verwendung`get-instance-port-states`. **AWS CLI** **So rufen Sie Firewall-Informationen für eine Instance ab** Im folgenden Beispiel für `get-instance-port-states` werden die Firewall-Ports zurückgegeben, die für die Instance `MEAN-1` konfiguriert wurden. ``` aws lightsail get-instance-port-states \ --instance-name MEAN-1 ``` Ausgabe: ``` { "portStates": [ { "fromPort": 80, "toPort": 80, "protocol": "tcp", "state": "open" }, { "fromPort": 22, "toPort": 22, "protocol": "tcp", "state": "open" }, { "fromPort": 443, "toPort": 443, "protocol": "tcp", "state": "open" } ] } ``` + Einzelheiten zur API finden Sie [GetInstancePortStates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-instance-port-states.html)in der *AWS CLI Befehlsreferenz*. ### `get-instance-snapshot` Das folgende Codebeispiel zeigt die Verwendung`get-instance-snapshot`. **AWS CLI** **So rufen Sie Informationen zu einem angegebenen Instance-Snapshot ab** Im folgenden Beispiel für `get-instance-snapshot` werden die Details zum angegebenen Instance-Typ angezeigt. ``` aws lightsail get-instance-snapshot \ --instance-snapshot-name MEAN-1-1571419854 ``` Ausgabe: ``` { "instanceSnapshot": { "name": "MEAN-1-1571419854", "arn": "arn:aws:lightsail:us-west-2:111122223333:InstanceSnapshot/ac54700c-48a8-40fd-b065-2EXAMPLEac8f", "supportCode": "6EXAMPLE3362/ami-0EXAMPLE67a73020d", "createdAt": 1571419891.927, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "InstanceSnapshot", "tags": [], "state": "available", "fromAttachedDisks": [], "fromInstanceName": "MEAN-1", "fromInstanceArn": "arn:aws:lightsail:us-west-2:111122223333:Instance/bd470fc5-a68b-44c5-8dbc-8EXAMPLEbada", "fromBlueprintId": "mean", "fromBundleId": "medium_3_0", "isFromAutoSnapshot": false, "sizeInGb": 80 } } ``` + Einzelheiten zur API finden Sie [GetInstanceSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-instance-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `get-instance-snapshots` Das folgende Codebeispiel zeigt die Verwendung`get-instance-snapshots`. **AWS CLI** **So rufen Sie Informationen zu allen Ihren Instance-Snapshots ab** Im folgenden `get-instance-snapshots` Beispiel werden Details zu allen Instanz-Snapshots in der konfigurierten AWS Region angezeigt. ``` aws lightsail get-instance-snapshots ``` Ausgabe: ``` { "instanceSnapshots": [ { "name": "MEAN-1-1571421498", "arn": "arn:aws:lightsail:us-west-2:111122223333:InstanceSnapshot/a20e6ebe-b0ee-4ae4-a750-3EXAMPLEcb0c", "supportCode": "6EXAMPLE3362/ami-0EXAMPLEe33cabfa1", "createdAt": 1571421527.755, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "InstanceSnapshot", "tags": [ { "key": "no_delete" } ], "state": "available", "fromAttachedDisks": [], "fromInstanceName": "MEAN-1", "fromInstanceArn": "arn:aws:lightsail:us-west-2:111122223333:Instance/1761aa0a-6038-4f25-8b94-2EXAMPLE19fd", "fromBlueprintId": "wordpress", "fromBundleId": "micro_3_0", "isFromAutoSnapshot": false, "sizeInGb": 40 }, { "name": "MEAN-1-1571419854", "arn": "arn:aws:lightsail:us-west-2:111122223333:InstanceSnapshot/ac54700c-48a8-40fd-b065-2EXAMPLEac8f", "supportCode": "6EXAMPLE3362/ami-0EXAMPLE67a73020d", "createdAt": 1571419891.927, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "InstanceSnapshot", "tags": [], "state": "available", "fromAttachedDisks": [], "fromInstanceName": "MEAN-1", "fromInstanceArn": "arn:aws:lightsail:us-west-2:111122223333:Instance/bd470fc5-a68b-44c5-8dbc-8EXAMPLEbada", "fromBlueprintId": "mean", "fromBundleId": "medium_3_0", "isFromAutoSnapshot": false, "sizeInGb": 80 } ] } ``` + Einzelheiten zur API finden Sie unter [GetInstanceSnapshots AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-instance-snapshots.html)*Befehlsreferenz.* ### `get-instance-state` Das folgende Codebeispiel zeigt die Verwendung`get-instance-state`. **AWS CLI** **So rufen Sie Informationen zum Status einer Instance ab** Im folgenden Beispiel für `get-instance-state` wird der Status der angegebenen Instance zurückgegeben. ``` aws lightsail get-instance-state \ --instance-name MEAN-1 ``` Ausgabe: ``` { "state": { "code": 16, "name": "running" } } ``` + Einzelheiten zur API finden Sie [GetInstanceState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-instance-state.html)in der *AWS CLI Befehlsreferenz*. ### `get-instance` Das folgende Codebeispiel zeigt die Verwendung`get-instance`. **AWS CLI** **So rufen Sie Informationen zu einer Instance ab** Im folgenden Beispiel für `get-instance` werden Details zur Instance `MEAN-1` angezeigt. ``` aws lightsail get-instance \ --instance-name MEAN-1 ``` Ausgabe: ``` { "instance": { "name": "MEAN-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:Instance/bd470fc5-a68b-44c5-8dbc-EXAMPLE4bada", "supportCode": "6EXAMPLE3362/i-05EXAMPLE407c97d3", "createdAt": 1570635023.124, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "Instance", "tags": [], "blueprintId": "mean", "blueprintName": "MEAN", "bundleId": "medium_3_0", "isStaticIp": false, "privateIpAddress": "192.0.2.0", "publicIpAddress": "192.0.2.0", "hardware": { "cpuCount": 2, "disks": [ { "createdAt": 1570635023.124, "sizeInGb": 80, "isSystemDisk": true, "iops": 240, "path": "/dev/xvda", "attachedTo": "MEAN-1", "attachmentState": "attached" } ], "ramSizeInGb": 4.0 }, "networking": { "monthlyTransfer": { "gbPerMonthAllocated": 4096 }, "ports": [ { "fromPort": 80, "toPort": 80, "protocol": "tcp", "accessFrom": "Anywhere (0.0.0.0/0)", "accessType": "public", "commonName": "", "accessDirection": "inbound" }, { "fromPort": 22, "toPort": 22, "protocol": "tcp", "accessFrom": "Anywhere (0.0.0.0/0)", "accessType": "public", "commonName": "", "accessDirection": "inbound" }, { "fromPort": 443, "toPort": 443, "protocol": "tcp", "accessFrom": "Anywhere (0.0.0.0/0)", "accessType": "public", "commonName": "", "accessDirection": "inbound" } ] }, "state": { "code": 16, "name": "running" }, "username": "bitnami", "sshKeyName": "MyKey" } } ``` + Einzelheiten zur API finden Sie [GetInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-instance.html)in der *AWS CLI Befehlsreferenz*. ### `get-instances` Das folgende Codebeispiel zeigt die Verwendung`get-instances`. **AWS CLI** **So rufen Sie Informationen zu allen Instances ab** Im folgenden `get-instances` Beispiel werden Details zu allen Instanzen in der konfigurierten AWS Region angezeigt. ``` aws lightsail get-instances ``` Ausgabe: ``` { "instances": [ { "name": "Windows_Server_2022-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:Instance/0f44fbb9-8f55-4e47-a25e-EXAMPLE04763", "supportCode": "62EXAMPLE362/i-0bEXAMPLE71a686b9", "createdAt": 1571332358.665, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "Instance", "tags": [], "blueprintId": "windows_server_2022", "blueprintName": "Windows Server 2022", "bundleId": "large_win_3_0", "isStaticIp": false, "privateIpAddress": "192.0.2.0", "publicIpAddress": "192.0.2.0", "hardware": { "cpuCount": 1, "disks": [ { "createdAt": 1571332358.665, "sizeInGb": 160, "isSystemDisk": true, "iops": 180, "path": "/dev/sda1", "attachedTo": "Windows_Server_2022-1", "attachmentState": "attached" }, { "name": "my-disk-for-windows-server", "arn": "arn:aws:lightsail:us-west-2:111122223333:Disk/4123a81c-484c-49ea-afea-5EXAMPLEda87", "supportCode": "6EXAMPLE3362/vol-0EXAMPLEb2b99ca3d", "createdAt": 1571355063.494, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "Disk", "tags": [], "sizeInGb": 128, "isSystemDisk": false, "iops": 384, "path": "/dev/xvdf", "state": "in-use", "attachedTo": "Windows_Server_2022-1", "isAttached": true, "attachmentState": "attached" } ], "ramSizeInGb": 8.0 }, "networking": { "monthlyTransfer": { "gbPerMonthAllocated": 3072 }, "ports": [ { "fromPort": 80, "toPort": 80, "protocol": "tcp", "accessFrom": "Anywhere (0.0.0.0/0)", "accessType": "public", "commonName": "", "accessDirection": "inbound" }, { "fromPort": 22, "toPort": 22, "protocol": "tcp", "accessFrom": "Anywhere (0.0.0.0/0)", "accessType": "public", "commonName": "", "accessDirection": "inbound" }, { "fromPort": 3389, "toPort": 3389, "protocol": "tcp", "accessFrom": "Anywhere (0.0.0.0/0)", "accessType": "public", "commonName": "", "accessDirection": "inbound" } ] }, "state": { "code": 16, "name": "running" }, "username": "Administrator", "sshKeyName": "LightsailDefaultKeyPair" }, { "name": "MEAN-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:Instance/bd470fc5-a68b-44c5-8dbc-8EXAMPLEbada", "supportCode": "6EXAMPLE3362/i-0EXAMPLEa407c97d3", "createdAt": 1570635023.124, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "Instance", "tags": [], "blueprintId": "mean", "blueprintName": "MEAN", "bundleId": "medium_3_0", "isStaticIp": false, "privateIpAddress": "192.0.2.0", "publicIpAddress": "192.0.2.0", "hardware": { "cpuCount": 2, "disks": [ { "name": "Disk-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:Disk/c21cfb0a-07f2-44ae-9a23-bEXAMPLE8096", "supportCode": "6EXAMPLE3362/vol-0EXAMPLEf2f88b32f", "createdAt": 1566585439.587, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "Disk", "tags": [ { "key": "test" } ], "sizeInGb": 8, "isSystemDisk": false, "iops": 240, "path": "/dev/xvdf", "state": "in-use", "attachedTo": "MEAN-1", "isAttached": true, "attachmentState": "attached" }, { "createdAt": 1570635023.124, "sizeInGb": 80, "isSystemDisk": true, "iops": 240, "path": "/dev/sda1", "attachedTo": "MEAN-1", "attachmentState": "attached" } ], "ramSizeInGb": 4.0 }, "networking": { "monthlyTransfer": { "gbPerMonthAllocated": 4096 }, "ports": [ { "fromPort": 80, "toPort": 80, "protocol": "tcp", "accessFrom": "Anywhere (0.0.0.0/0)", "accessType": "public", "commonName": "", "accessDirection": "inbound" }, { "fromPort": 22, "toPort": 22, "protocol": "tcp", "accessFrom": "Anywhere (0.0.0.0/0)", "accessType": "public", "commonName": "", "accessDirection": "inbound" }, { "fromPort": 443, "toPort": 443, "protocol": "tcp", "accessFrom": "Anywhere (0.0.0.0/0)", "accessType": "public", "commonName": "", "accessDirection": "inbound" } ] }, "state": { "code": 16, "name": "running" }, "username": "bitnami", "sshKeyName": "MyTestKey" } ] } ``` + Einzelheiten zur API finden Sie [GetInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-instances.html)unter *AWS CLI Befehlsreferenz*. ### `get-key-pair` Das folgende Codebeispiel zeigt die Verwendung`get-key-pair`. **AWS CLI** **So rufen Sie Informationen zu einem Schlüsselpaar ab** Im folgenden Beispiel für `get-key-pair` werden die Details zum angegebenen Schlüsselpaar angezeigt. ``` aws lightsail get-key-pair \ --key-pair-name MyKey1 ``` Ausgabe: ``` { "keyPair": { "name": "MyKey1", "arn": "arn:aws:lightsail:us-west-2:111122223333:KeyPair/19a4efdf-3054-43d6-91fd-eEXAMPLE21bf", "supportCode": "6EXAMPLE3362/MyKey1", "createdAt": 1571255026.975, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "KeyPair", "tags": [], "fingerprint": "00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff:gg:hh:ii:jj" } } ``` + Einzelheiten zur API finden Sie [GetKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-key-pair.html)in der *AWS CLI Befehlsreferenz*. ### `get-key-pairs` Das folgende Codebeispiel zeigt die Verwendung`get-key-pairs`. **AWS CLI** **So rufen Sie Informationen zu allen Schlüsselpaaren ab** Im folgenden `get-key-pairs` Beispiel werden Details zu allen Schlüsselpaaren in der konfigurierten AWS Region angezeigt. ``` aws lightsail get-key-pairs ``` Ausgabe: ``` { "keyPairs": [ { "name": "MyKey1", "arn": "arn:aws:lightsail:us-west-2:111122223333:KeyPair/19a4efdf-3054-43d6-91fd-eEXAMPLE21bf", "supportCode": "6EXAMPLE3362/MyKey1", "createdAt": 1571255026.975, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "KeyPair", "tags": [], "fingerprint": "00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff:gg:hh:ii:jj" } ] } ``` + Einzelheiten zur API finden Sie [GetKeyPairs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-key-pairs.html)unter *AWS CLI Befehlsreferenz*. ### `get-load-balancer-tls-certificates` Das folgende Codebeispiel zeigt die Verwendung`get-load-balancer-tls-certificates`. **AWS CLI** **So rufen Sie Informationen zu TLS-Zertifikaten für einen Load Balancer ab** Im folgenden Beispiel für `get-load-balancer-tls-certificates` werden Details zu TLS-Zertifikaten für den angegebenen Load Balancer angezeigt. ``` aws lightsail get-load-balancer-tls-certificates \ --load-balancer-name LoadBalancer-1 ``` Ausgabe: ``` { "tlsCertificates": [ { "name": "example-com", "arn": "arn:aws:lightsail:us-west-2:111122223333:LoadBalancerTlsCertificate/d7bf4643-6a02-4cd4-b3c4-fEXAMPLE9b4d", "supportCode": "6EXAMPLE3362/arn:aws:acm:us-west-2:333322221111:certificate/9af8e32c-a54e-4a67-8c63-cEXAMPLEb314", "createdAt": 1571678025.3, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "LoadBalancerTlsCertificate", "loadBalancerName": "LoadBalancer-1", "isAttached": false, "status": "ISSUED", "domainName": "example.com", "domainValidationRecords": [ { "name": "_dEXAMPLE4ede046a0319eb44a4eb3cbc.example.com.", "type": "CNAME", "value": "_bEXAMPLE0899fb7b6bf79d9741d1a383.hkvuiqjoua.acm-validations.aws.", "validationStatus": "SUCCESS", "domainName": "example.com" } ], "issuedAt": 1571678070.0, "issuer": "Amazon", "keyAlgorithm": "RSA-2048", "notAfter": 1605960000.0, "notBefore": 1571616000.0, "serial": "00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff", "signatureAlgorithm": "SHA256WITHRSA", "subject": "CN=example.com", "subjectAlternativeNames": [ "example.com" ] } ] } ``` + Einzelheiten zur API finden Sie [GetLoadBalancerTlsCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-load-balancer-tls-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `get-load-balancer` Das folgende Codebeispiel zeigt die Verwendung`get-load-balancer`. **AWS CLI** **So rufen Sie Informationen zu einem Load Balancer ab** Im folgenden Beispiel für `get-load-balancer` werden Details zum angegebenen Load Balancer angezeigt. ``` aws lightsail get-load-balancer \ --load-balancer-name LoadBalancer-1 ``` Ausgabe: ``` { "loadBalancer": { "name": "LoadBalancer-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:LoadBalancer/40486b2b-1ad0-4152-83e4-cEXAMPLE6f4b", "supportCode": "6EXAMPLE3362/arn:aws:elasticloadbalancing:us-west-2:333322221111:loadbalancer/app/bEXAMPLE128cb59d86f946a9395dd304/1EXAMPLE8dd9d77e", "createdAt": 1571677906.723, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "LoadBalancer", "tags": [], "dnsName": "bEXAMPLE128cb59d86f946a9395dd304-1486911371.us-west-2.elb.amazonaws.com", "state": "active", "protocol": "HTTP", "publicPorts": [ 80 ], "healthCheckPath": "/", "instancePort": 80, "instanceHealthSummary": [ { "instanceName": "MEAN-3", "instanceHealth": "healthy" }, { "instanceName": "MEAN-1", "instanceHealth": "healthy" }, { "instanceName": "MEAN-2", "instanceHealth": "healthy" } ], "tlsCertificateSummaries": [ { "name": "example-com", "isAttached": false } ], "configurationOptions": { "SessionStickinessEnabled": "false", "SessionStickiness_LB_CookieDurationSeconds": "86400" } } } ``` + Einzelheiten zur API finden Sie [GetLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-load-balancer.html)in der *AWS CLI Befehlsreferenz*. ### `get-load-balancers` Das folgende Codebeispiel zeigt die Verwendung`get-load-balancers`. **AWS CLI** **So rufen Sie Informationen über alle Load Balancer ab** Im folgenden `get-load-balancers` Beispiel werden Details zu allen Load Balancern in der konfigurierten AWS Region angezeigt. ``` aws lightsail get-load-balancers ``` Ausgabe: ``` { "loadBalancers": [ { "name": "LoadBalancer-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:LoadBalancer/40486b2b-1ad0-4152-83e4-cEXAMPLE6f4b", "supportCode": "6EXAMPLE3362/arn:aws:elasticloadbalancing:us-west-2:333322221111:loadbalancer/app/bEXAMPLE128cb59d86f946a9395dd304/1EXAMPLE8dd9d77e", "createdAt": 1571677906.723, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "LoadBalancer", "tags": [], "dnsName": "bEXAMPLE128cb59d86f946a9395dd304-1486911371.us-west-2.elb.amazonaws.com", "state": "active", "protocol": "HTTP", "publicPorts": [ 80 ], "healthCheckPath": "/", "instancePort": 80, "instanceHealthSummary": [ { "instanceName": "MEAN-3", "instanceHealth": "healthy" }, { "instanceName": "MEAN-1", "instanceHealth": "healthy" }, { "instanceName": "MEAN-2", "instanceHealth": "healthy" } ], "tlsCertificateSummaries": [ { "name": "example-com", "isAttached": false } ], "configurationOptions": { "SessionStickinessEnabled": "false", "SessionStickiness_LB_CookieDurationSeconds": "86400" } } ] } ``` + Einzelheiten zur API finden Sie unter [GetLoadBalancers AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-load-balancers.html)*Befehlsreferenz.* ### `get-operation` Das folgende Codebeispiel zeigt die Verwendung`get-operation`. **AWS CLI** **So rufen Sie Informationen zu einem einzelnen Vorgang ab** Im folgenden Beispiel für `get-operation` werden die Details zum angegebenen Vorgang angezeigt. ``` aws lightsail get-operation \ --operation-id e5700e8a-daf2-4b49-bc01-3EXAMPLE910a ``` Ausgabe: ``` { "operation": { "id": "e5700e8a-daf2-4b49-bc01-3EXAMPLE910a", "resourceName": "Instance-1", "resourceType": "Instance", "createdAt": 1571679872.404, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "CreateInstance", "status": "Succeeded", "statusChangedAt": 1571679890.304 } } ``` + Einzelheiten zur API finden Sie [GetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-operation.html)in der *AWS CLI Befehlsreferenz*. ### `get-operations-for-resource` Das folgende Codebeispiel zeigt die Verwendung`get-operations-for-resource`. **AWS CLI** **So rufen Sie alle Vorgänge für eine Ressource ab** Im folgenden Beispiel für `get-operations-for-resource` werden Details zu allen Vorgängen für die angegebene Ressource angezeigt. ``` aws lightsail get-operations-for-resource \ --resource-name LoadBalancer-1 ``` Ausgabe: ``` { "operations": [ { "id": "e2973046-43f8-4252-a4b4-9EXAMPLE69ce", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1571678786.071, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "MEAN-1", "operationType": "DetachInstancesFromLoadBalancer", "status": "Succeeded", "statusChangedAt": 1571679087.57 }, { "id": "2d742a18-0e7f-48c8-9705-3EXAMPLEf98a", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1571678782.784, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "MEAN-1", "operationType": "AttachInstancesToLoadBalancer", "status": "Succeeded", "statusChangedAt": 1571678798.465 }, { "id": "6c700fcc-4246-40ab-952b-1EXAMPLEdac2", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1571678775.297, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "MEAN-3", "operationType": "AttachInstancesToLoadBalancer", "status": "Succeeded", "statusChangedAt": 1571678842.806 }, ... } ] } ``` + Einzelheiten zur API finden Sie [GetOperationsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-operations-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `get-operations` Das folgende Codebeispiel zeigt die Verwendung`get-operations`. **AWS CLI** **So rufen Sie Informationen zu allen Vorgängen ab** Im folgenden `get-operations` Beispiel werden Details zu allen Vorgängen in der konfigurierten AWS Region angezeigt. ``` aws lightsail get-operations ``` Ausgabe: ``` { "operations": [ { "id": "e5700e8a-daf2-4b49-bc01-3EXAMPLE910a", "resourceName": "Instance-1", "resourceType": "Instance", "createdAt": 1571679872.404, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "CreateInstance", "status": "Succeeded", "statusChangedAt": 1571679890.304 }, { "id": "701a3339-930e-4914-a9f9-7EXAMPLE68d7", "resourceName": "WordPress-1", "resourceType": "Instance", "createdAt": 1571678786.072, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "LoadBalancer-1", "operationType": "DetachInstancesFromLoadBalancer", "status": "Succeeded", "statusChangedAt": 1571679086.399 }, { "id": "e2973046-43f8-4252-a4b4-9EXAMPLE69ce", "resourceName": "LoadBalancer-1", "resourceType": "LoadBalancer", "createdAt": 1571678786.071, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "WordPress-1", "operationType": "DetachInstancesFromLoadBalancer", "status": "Succeeded", "statusChangedAt": 1571679087.57 }, ... } ] } ``` + Einzelheiten zur API finden Sie [GetOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-operations.html)unter *AWS CLI Befehlsreferenz*. ### `get-regions` Das folgende Codebeispiel zeigt die Verwendung`get-regions`. **AWS CLI** **Um alle AWS Regionen für Amazon Lightsail zu erhalten** Im folgenden `get-regions` Beispiel werden Details zu allen AWS Regionen für Amazon Lightsail angezeigt. ``` aws lightsail get-regions ``` Ausgabe: ``` { "regions": [ { "continentCode": "NA", "description": "This region is recommended to serve users in the eastern United States", "displayName": "Virginia", "name": "us-east-1", "availabilityZones": [], "relationalDatabaseAvailabilityZones": [] }, { "continentCode": "NA", "description": "This region is recommended to serve users in the eastern United States", "displayName": "Ohio", "name": "us-east-2", "availabilityZones": [], "relationalDatabaseAvailabilityZones": [] }, { "continentCode": "NA", "description": "This region is recommended to serve users in the northwestern United States, Alaska, and western Canada", "displayName": "Oregon", "name": "us-west-2", "availabilityZones": [], "relationalDatabaseAvailabilityZones": [] }, ... } ] } ``` + Einzelheiten zur API finden Sie [GetRegions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-regions.html)in der *AWS CLI Befehlsreferenz*. ### `get-relational-database-blueprints` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-blueprints`. **AWS CLI** **So rufen Sie die Vorlagen für neue relationale Datenbanken ab** Das folgende `get-relational-database-blueprints` Beispiel zeigt Details zu allen verfügbaren relationalen Datenbank-Blueprints, die verwendet werden können, um neue relationale Datenbanken in Amazon Lightsail zu erstellen. ``` aws lightsail get-relational-database-blueprints ``` Ausgabe: ``` { "blueprints": [ { "blueprintId": "mysql_5_6", "engine": "mysql", "engineVersion": "5.6.44", "engineDescription": "MySQL Community Edition", "engineVersionDescription": "MySQL 5.6.44", "isEngineDefault": false }, { "blueprintId": "mysql_5_7", "engine": "mysql", "engineVersion": "5.7.26", "engineDescription": "MySQL Community Edition", "engineVersionDescription": "MySQL 5.7.26", "isEngineDefault": true }, { "blueprintId": "mysql_8_0", "engine": "mysql", "engineVersion": "8.0.16", "engineDescription": "MySQL Community Edition", "engineVersionDescription": "MySQL 8.0.16", "isEngineDefault": false }, { "blueprintId": "postgres_9_6", "engine": "postgres", "engineVersion": "9.6.15", "engineDescription": "PostgreSQL", "engineVersionDescription": "PostgreSQL 9.6.15-R1", "isEngineDefault": false }, { "blueprintId": "postgres_10", "engine": "postgres", "engineVersion": "10.10", "engineDescription": "PostgreSQL", "engineVersionDescription": "PostgreSQL 10.10-R1", "isEngineDefault": false }, { "blueprintId": "postgres_11", "engine": "postgres", "engineVersion": "11.5", "engineDescription": "PostgreSQL", "engineVersionDescription": "PostgreSQL 11.5-R1", "isEngineDefault": true } ] } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetRelationalDatabaseBlueprints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-blueprints.html)AWS CLI * ### `get-relational-database-bundles` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-bundles`. **AWS CLI** **So rufen Sie die Pakete für neue relationale Datenbanken ab** Das folgende `get-relational-database-bundles` Beispiel zeigt Details zu allen verfügbaren relationalen Datenbankpaketen, die zur Erstellung neuer relationaler Datenbanken in Amazon Lightsail verwendet werden können. Beachten Sie, dass die Antwort keine inaktiven Pakete enthält, da das Flag `--include-inactive` im Befehl nicht angegeben ist. Sie können inaktive Pakete nicht verwenden, um neue relationale Datenbanken zu erstellen. ``` aws lightsail get-relational-database-bundles ``` Ausgabe: ``` { "bundles": [ { "bundleId": "micro_2_0", "name": "Micro", "price": 15.0, "ramSizeInGb": 1.0, "diskSizeInGb": 40, "transferPerMonthInGb": 100, "cpuCount": 2, "isEncrypted": true, "isActive": true }, { "bundleId": "micro_ha_2_0", "name": "Micro with High Availability", "price": 30.0, "ramSizeInGb": 1.0, "diskSizeInGb": 40, "transferPerMonthInGb": 100, "cpuCount": 2, "isEncrypted": true, "isActive": true }, { "bundleId": "small_2_0", "name": "Small", "price": 30.0, "ramSizeInGb": 2.0, "diskSizeInGb": 80, "transferPerMonthInGb": 100, "cpuCount": 2, "isEncrypted": true, "isActive": true }, { "bundleId": "small_ha_2_0", "name": "Small with High Availability", "price": 60.0, "ramSizeInGb": 2.0, "diskSizeInGb": 80, "transferPerMonthInGb": 100, "cpuCount": 2, "isEncrypted": true, "isActive": true }, { "bundleId": "medium_2_0", "name": "Medium", "price": 60.0, "ramSizeInGb": 4.0, "diskSizeInGb": 120, "transferPerMonthInGb": 100, "cpuCount": 2, "isEncrypted": true, "isActive": true }, { "bundleId": "medium_ha_2_0", "name": "Medium with High Availability", "price": 120.0, "ramSizeInGb": 4.0, "diskSizeInGb": 120, "transferPerMonthInGb": 100, "cpuCount": 2, "isEncrypted": true, "isActive": true }, { "bundleId": "large_2_0", "name": "Large", "price": 115.0, "ramSizeInGb": 8.0, "diskSizeInGb": 240, "transferPerMonthInGb": 200, "cpuCount": 2, "isEncrypted": true, "isActive": true }, { "bundleId": "large_ha_2_0", "name": "Large with High Availability", "price": 230.0, "ramSizeInGb": 8.0, "diskSizeInGb": 240, "transferPerMonthInGb": 200, "cpuCount": 2, "isEncrypted": true, "isActive": true } ] } ``` Weitere Informationen finden Sie unter [Erstellen einer Datenbank in Amazon Lightsail im Amazon Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-creating-a-database) *Developer Guide*. + *Einzelheiten zur API finden Sie unter [GetRelationalDatabaseBundles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-bundles.html)Befehlsreferenz.AWS CLI * ### `get-relational-database-events` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-events`. **AWS CLI** **So rufen Sie die Ereignisse für eine relationale Datenbank ab** Im folgenden Beispiel für `get-relational-database-events` werden Details zu Ereignissen der letzten 17 Stunden (1 020 Minuten) für die angegebene relationale Datenbank angezeigt. ``` aws lightsail get-relational-database-events \ --relational-database-name Database-1 \ --duration-in-minutes 1020 ``` Ausgabe: ``` { "relationalDatabaseEvents": [ { "resource": "Database-1", "createdAt": 1571654146.553, "message": "Backing up Relational Database", "eventCategories": [ "backup" ] }, { "resource": "Database-1", "createdAt": 1571654249.98, "message": "Finished Relational Database backup", "eventCategories": [ "backup" ] } ] } ``` + Einzelheiten zur API finden Sie [GetRelationalDatabaseEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-events.html)in der *AWS CLI Befehlsreferenz*. ### `get-relational-database-log-events` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-log-events`. **AWS CLI** **So rufen Sie die Protokollereignisse für eine relationale Datenbank ab** Im folgenden Beispiel für `get-relational-database-log-events` werden Details zum angegebenen Protokoll zwischen `1570733176` und `1571597176` für die relationale Datenbank `Database1` angezeigt. Die zurückgegebenen Informationen sind so konfiguriert, dass sie bei `head` beginnen. Wir empfehlen, einen Unix-Zeitkonverter zu verwenden, um die Start- und Endzeiten zu ermitteln. ``` aws lightsail get-relational-database-log-events \ --relational-database-name Database1 \ --log-stream-name error \ --start-from-head \ --start-time 1570733176 \ --end-time 1571597176 ``` Ausgabe: ``` { "resourceLogEvents": [ { "createdAt": 1570820267.0, "message": "2019-10-11 18:57:47 20969 [Warning] IP address '192.0.2.0' could not be resolved: Name or service not known" }, { "createdAt": 1570860974.0, "message": "2019-10-12 06:16:14 20969 [Warning] IP address '8192.0.2.0' could not be resolved: Temporary failure in name resolution" }, { "createdAt": 1570860977.0, "message": "2019-10-12 06:16:17 20969 [Warning] IP address '192.0.2.0' could not be resolved: Temporary failure in name resolution" }, { "createdAt": 1570860979.0, "message": "2019-10-12 06:16:19 20969 [Warning] IP address '192.0.2.0' could not be resolved: Temporary failure in name resolution" }, { "createdAt": 1570860981.0, "message": "2019-10-12 06:16:21 20969 [Warning] IP address '192.0.2.0' could not be resolved: Temporary failure in name resolution" }, { "createdAt": 1570860982.0, "message": "2019-10-12 06:16:22 20969 [Warning] IP address '192.0.2.0' could not be resolved: Temporary failure in name resolution" }, { "createdAt": 1570860984.0, "message": "2019-10-12 06:16:24 20969 [Warning] IP address '192.0.2.0' could not be resolved: Temporary failure in name resolution" }, { "createdAt": 1570860986.0, "message": "2019-10-12 06:16:26 20969 [Warning] IP address '192.0.2.0' could not be resolved: Temporary failure in name resolution" }, ... } ], "nextBackwardToken": "eEXAMPLEZXJUZXh0IjoiZnRWb3F3cUpRSlQ5NndMYThxelRUZlFhR3J6c2dKWEEvM2kvajZMZzVVVWpqRDN0YjFXTjNrak5pRk9iVFRZdjkwVGlpZGw5NFJGSFRQTEdJSjdpQnFCRk5CZFJlYTZaSXpScStuZjJEYXhqM2grUFVJOEpIYlU5YWJ2QitvQWN5cEFyVUo3VDk1QWY3bVF6MEwvcVovVldZdGc9Iiwibm9uY2UiOiJBNHpzdWMvUkZZKzRvUzhEIiwiY2lwaGVyIjoiQUVTL0dDTS9Ob1BhZGEXAMPLEQ==", "nextForwardToken": "eEXAMPLEZXJUZXh0IjoiT09Lb0Z6ZFRJbHhaNEQ5N2tPbkkwRmwwNUxPZjFTbFFwUklQbzlSaWgvMWVXbEk4aG56VHg4bW1Gb3grbDVodUVNZEdiZXN0TzVYcjlLK1FUdFB2RlJLS2FMcU05WkN3Rm1uVzBkOFpDR2g0b1BBVlg2NVFGNDNPazZzRXJieHRuU0xzdkRNTkFUMTZibU9HM2YyaGxiS0hUUDA9Iiwibm9uY2UiOiJFQmI4STQ3cU5aWXNXZ0g4IiwiY2lwaGVyIjoiQUVTL0dDTS9Ob1BhZGEXAMPLEQ==" } ``` + Einzelheiten zur API finden Sie [GetRelationalDatabaseLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-log-events.html)in der *AWS CLI Befehlsreferenz*. ### `get-relational-database-log-streams` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-log-streams`. **AWS CLI** **So rufen Sie die Protokollstreams für eine relationale Datenbank ab** Im folgenden Beispiel für `get-relational-database-log-streams` werden alle verfügbaren Protokollstreams für die angegebene relationale Datenbank zurückgegeben. ``` aws lightsail get-relational-database-log-streams \ --relational-database-name Database1 ``` Ausgabe: ``` { "logStreams": [ "audit", "error", "general", "slowquery" ] } ``` + Einzelheiten zur API finden Sie [GetRelationalDatabaseLogStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-log-streams.html)in der *AWS CLI Befehlsreferenz*. ### `get-relational-database-master-user-password` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-master-user-password`. **AWS CLI** **So rufen Sie das Passwort des Masterbenutzers für eine relationale Datenbank ab** Im folgenden Beispiel für `get-relational-database-master-user-password` werden Informationen zum Passwort des Masterbenutzers für die angegebene relationale Datenbank zurückgegeben. ``` aws lightsail get-relational-database-master-user-password \ --relational-database-name Database-1 ``` Ausgabe: ``` { "masterUserPassword": "VEXAMPLEec.9qvx,_t<)Wkf)kwboM,>2", "createdAt": 1571259453.959 } ``` + Einzelheiten zur API finden Sie [GetRelationalDatabaseMasterUserPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-master-user-password.html)in der *AWS CLI Befehlsreferenz*. ### `get-relational-database-metric-data` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-metric-data`. **AWS CLI** **So rufen Sie metrische Daten für eine relationale Datenbank ab** Im folgenden Beispiel für `get-relational-database-metric-data` wird die Summe der Metrik `DatabaseConnections` über einen Zeitraum von 24 Stunden (`86400`Sekunden) zwischen `1570733176` und `1571597176` für die relationale Datenbank `Database1` zurückgegeben. Wir empfehlen, einen Unix-Zeitkonverter zu verwenden, um die Start- und Endzeiten zu ermitteln. ``` aws lightsail get-relational-database-metric-data \ --relational-database-name Database1 \ --metric-name DatabaseConnections \ --period 86400 \ --start-time 1570733176 \ --end-time 1571597176 \ --unit Count \ --statistics Sum ``` Ausgabe: ``` { "metricName": "DatabaseConnections", "metricData": [ { "sum": 1.0, "timestamp": 1571510760.0, "unit": "Count" }, { "sum": 1.0, "timestamp": 1570733160.0, "unit": "Count" }, { "sum": 1.0, "timestamp": 1570992360.0, "unit": "Count" }, { "sum": 0.0, "timestamp": 1571251560.0, "unit": "Count" }, { "sum": 721.0, "timestamp": 1570819560.0, "unit": "Count" }, { "sum": 1.0, "timestamp": 1571078760.0, "unit": "Count" }, { "sum": 2.0, "timestamp": 1571337960.0, "unit": "Count" }, { "sum": 684.0, "timestamp": 1570905960.0, "unit": "Count" }, { "sum": 0.0, "timestamp": 1571165160.0, "unit": "Count" }, { "sum": 1.0, "timestamp": 1571424360.0, "unit": "Count" } ] } ``` + Einzelheiten zur API finden Sie [GetRelationalDatabaseMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-metric-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-relational-database-parameters` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-parameters`. **AWS CLI** **So rufen Sie Parameter für eine relationale Datenbank ab** Im folgenden Beispiel für `get-relational-database-parameters` werden alle verfügbaren Parameter für die angegebene relationale Datenbank zurückgegeben. ``` aws lightsail get-relational-database-parameters \ --relational-database-name Database-1 ``` Ausgabe: ``` { "parameters": [ { "allowedValues": "0,1", "applyMethod": "pending-reboot", "applyType": "dynamic", "dataType": "boolean", "description": "Automatically set all granted roles as active after the user has authenticated successfully.", "isModifiable": true, "parameterName": "activate_all_roles_on_login", "parameterValue": "0" }, { "allowedValues": "0,1", "applyMethod": "pending-reboot", "applyType": "static", "dataType": "boolean", "description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded", "isModifiable": false, "parameterName": "allow-suspicious-udfs" }, { "allowedValues": "0,1", "applyMethod": "pending-reboot", "applyType": "dynamic", "dataType": "boolean", "description": "Sets the autocommit mode", "isModifiable": true, "parameterName": "autocommit" }, { "allowedValues": "0,1", "applyMethod": "pending-reboot", "applyType": "static", "dataType": "boolean", "description": "Controls whether the server autogenerates SSL key and certificate files in the data directory, if they do not already exist.", "isModifiable": false, "parameterName": "auto_generate_certs" }, ... } ] } ``` Weitere Informationen finden Sie unter [Aktualisieren von Datenbankparametern in Amazon Lightsail im Lightsail](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-updating-database-parameters) *Dev* Guide. + *Einzelheiten zur API finden Sie unter [GetRelationalDatabaseParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-parameters.html)Befehlsreferenz.AWS CLI * ### `get-relational-database-snapshot` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-snapshot`. **AWS CLI** **So rufen Sie Informationen zum Snapshot einer relationalen Datenbank ab** Im folgenden Beispiel für `get-relational-database-snapshot` werden Details zum angegebenen Snapshot einer relationalen Datenbank angezeigt. ``` aws lightsail get-relational-database-snapshot \ --relational-database-snapshot-name Database-1-1571350042 ``` Ausgabe: ``` { "relationalDatabaseSnapshot": { "name": "Database-1-1571350042", "arn": "arn:aws:lightsail:us-west-2:111122223333:RelationalDatabaseSnapshot/0389bbad-4b85-4c3d-9EXAMPLEaee3643d2", "supportCode": "6EXAMPLE3362/ls-8EXAMPLE2ba7ad041451946fafc2ad19cfbd9eb2", "createdAt": 1571350046.238, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "RelationalDatabaseSnapshot", "tags": [], "engine": "mysql", "engineVersion": "8.0.16", "sizeInGb": 40, "state": "available", "fromRelationalDatabaseName": "Database-1", "fromRelationalDatabaseArn": "arn:aws:lightsail:us-west-2:111122223333:RelationalDatabase/7ea932b1-b85a-4bd5-9b3e-bEXAMPLE8cc4", "fromRelationalDatabaseBundleId": "micro_1_0", "fromRelationalDatabaseBlueprintId": "mysql_8_0" } } ``` + Einzelheiten zur API finden Sie [GetRelationalDatabaseSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `get-relational-database-snapshots` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database-snapshots`. **AWS CLI** **So rufen Sie Informationen zu allen Snapshots relationaler Datenbanken ab** Im folgenden `get-relational-database-snapshots` Beispiel werden Details zu allen Snapshots relationaler Datenbanken in der AWS konfigurierten Region angezeigt. ``` aws lightsail get-relational-database-snapshots ``` Ausgabe: ``` { "relationalDatabaseSnapshots": [ { "name": "Database-1-1571350042", "arn": "arn:aws:lightsail:us-west-2:111122223333:RelationalDatabaseSnapshot/0389bbad-4b85-4c3d-9861-6EXAMPLE43d2", "supportCode": "6EXAMPLE3362/ls-8EXAMPLE2ba7ad041451946fafc2ad19cfbd9eb2", "createdAt": 1571350046.238, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "RelationalDatabaseSnapshot", "tags": [], "engine": "mysql", "engineVersion": "8.0.16", "sizeInGb": 40, "state": "available", "fromRelationalDatabaseName": "Database-1", "fromRelationalDatabaseArn": "arn:aws:lightsail:us-west-2:111122223333:RelationalDatabase/7ea932b1-b85a-4bd5-9b3e-bEXAMPLE8cc4", "fromRelationalDatabaseBundleId": "micro_1_0", "fromRelationalDatabaseBlueprintId": "mysql_8_0" }, { "name": "Database1-Console", "arn": "arn:aws:lightsail:us-west-2:111122223333:RelationalDatabaseSnapshot/8b94136e-06ec-4b1a-a3fb-5EXAMPLEe1e9", "supportCode": "6EXAMPLE3362/ls-9EXAMPLE14b000d34c8d1c432734e137612d5b5c", "createdAt": 1571249981.025, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "RelationalDatabaseSnapshot", "tags": [ { "key": "test" } ], "engine": "mysql", "engineVersion": "5.6.44", "sizeInGb": 40, "state": "available", "fromRelationalDatabaseName": "Database1", "fromRelationalDatabaseArn": "arn:aws:lightsail:us-west-2:111122223333:RelationalDatabase/a6161cb7-4535-4f16-9dcf-8EXAMPLE3d4e", "fromRelationalDatabaseBundleId": "micro_1_0", "fromRelationalDatabaseBlueprintId": "mysql_5_6" } ] } ``` + Einzelheiten zur API finden Sie unter [GetRelationalDatabaseSnapshots AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database-snapshots.html)*Befehlsreferenz*. ### `get-relational-database` Das folgende Codebeispiel zeigt die Verwendung`get-relational-database`. **AWS CLI** **So rufen Sie Informationen zu einer relationalen Datenbank ab** Im folgenden Beispiel für `get-relational-database` werden Details zur angegebenen relationalen Datenbank angezeigt. ``` aws lightsail get-relational-database \ --relational-database-name Database-1 ``` Ausgabe: ``` { "relationalDatabase": { "name": "Database-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:RelationalDatabase/7ea932b1-b85a-4bd5-9b3e-bEXAMPLE8cc4", "supportCode": "6EXAMPLE3362/ls-9EXAMPLE8ad863723b62cc8901a8aa6e794ae0d2", "createdAt": 1571259453.795, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "RelationalDatabase", "tags": [], "relationalDatabaseBlueprintId": "mysql_8_0", "relationalDatabaseBundleId": "micro_1_0", "masterDatabaseName": "dbmaster", "hardware": { "cpuCount": 1, "diskSizeInGb": 40, "ramSizeInGb": 1.0 }, "state": "available", "backupRetentionEnabled": false, "pendingModifiedValues": {}, "engine": "mysql", "engineVersion": "8.0.16", "masterUsername": "dbmasteruser", "parameterApplyStatus": "in-sync", "preferredBackupWindow": "10:01-10:31", "preferredMaintenanceWindow": "sat:11:14-sat:11:44", "publiclyAccessible": true, "masterEndpoint": { "port": 3306, "address": "ls-9EXAMPLE8ad863723b62ccEXAMPLEa6e794ae0d2.czowadgeezqi.us-west-2.rds.amazonaws.com" }, "pendingMaintenanceActions": [] } } ``` + Einzelheiten zur API finden Sie [GetRelationalDatabase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-database.html)in der *AWS CLI Befehlsreferenz*. ### `get-relational-databases` Das folgende Codebeispiel zeigt die Verwendung`get-relational-databases`. **AWS CLI** **So rufen Sie Informationen zu allen relationalen Datenbanken ab** Im folgenden `get-relational-databases` Beispiel werden Details zu allen relationalen Datenbanken in der konfigurierten AWS Region angezeigt. ``` aws lightsail get-relational-databases ``` Ausgabe: ``` { "relationalDatabases": [ { "name": "MySQL", "arn": "arn:aws:lightsail:us-west-2:111122223333:RelationalDatabase/8529020c-3ab9-4d51-92af-5EXAMPLE8979", "supportCode": "6EXAMPLE3362/ls-3EXAMPLEa995d8c3b06b4501356e5f2f28e1aeba", "createdAt": 1554306019.155, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "RelationalDatabase", "tags": [], "relationalDatabaseBlueprintId": "mysql_8_0", "relationalDatabaseBundleId": "micro_1_0", "masterDatabaseName": "dbmaster", "hardware": { "cpuCount": 1, "diskSizeInGb": 40, "ramSizeInGb": 1.0 }, "state": "available", "backupRetentionEnabled": true, "pendingModifiedValues": {}, "engine": "mysql", "engineVersion": "8.0.15", "latestRestorableTime": 1571686200.0, "masterUsername": "dbmasteruser", "parameterApplyStatus": "in-sync", "preferredBackupWindow": "07:51-08:21", "preferredMaintenanceWindow": "tue:12:18-tue:12:48", "publiclyAccessible": true, "masterEndpoint": { "port": 3306, "address": "ls-3EXAMPLEa995d8c3b06b4501356e5f2fEXAMPLEa.czowadgeezqi.us-west-2.rds.amazonaws.com" }, "pendingMaintenanceActions": [] }, { "name": "Postgres", "arn": "arn:aws:lightsail:us-west-2:111122223333:RelationalDatabase/e9780b6b-d0ab-4af2-85f1-1EXAMPLEac68", "supportCode": "6EXAMPLE3362/ls-3EXAMPLEb4fffb5cec056220c734713e14bd5fcd", "createdAt": 1554306000.814, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "resourceType": "RelationalDatabase", "tags": [], "relationalDatabaseBlueprintId": "postgres_11", "relationalDatabaseBundleId": "micro_1_0", "masterDatabaseName": "dbmaster", "hardware": { "cpuCount": 1, "diskSizeInGb": 40, "ramSizeInGb": 1.0 }, "state": "available", "backupRetentionEnabled": true, "pendingModifiedValues": {}, "engine": "postgres", "engineVersion": "11.1", "latestRestorableTime": 1571686339.0, "masterUsername": "dbmasteruser", "parameterApplyStatus": "in-sync", "preferredBackupWindow": "06:19-06:49", "preferredMaintenanceWindow": "sun:10:19-sun:10:49", "publiclyAccessible": false, "masterEndpoint": { "port": 5432, "address": "ls-3EXAMPLEb4fffb5cec056220c734713eEXAMPLEd.czowadgeezqi.us-west-2.rds.amazonaws.com" }, "pendingMaintenanceActions": [] } ] } ``` + Einzelheiten zur API finden Sie unter [GetRelationalDatabases AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-relational-databases.html)*Befehlsreferenz.* ### `get-static-ip` Das folgende Codebeispiel zeigt die Verwendung`get-static-ip`. **AWS CLI** **So rufen Sie Informationen zu einer statischen IP ab** Im folgenden Beispiel für `get-static-ip` werden Details zur angegebenen statischen IP angezeigt. ``` aws lightsail get-static-ip \ --static-ip-name StaticIp-1 ``` Ausgabe: ``` { "staticIp": { "name": "StaticIp-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:StaticIp/2257cd76-1f0e-4ac0-82e2-2EXAMPLE23ad", "supportCode": "6EXAMPLE3362/192.0.2.0", "createdAt": 1571071325.076, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "StaticIp", "ipAddress": "192.0.2.0", "isAttached": false } } ``` + Einzelheiten zur API finden Sie [GetStaticIp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-static-ip.html)in der *AWS CLI Befehlsreferenz*. ### `get-static-ips` Das folgende Codebeispiel zeigt die Verwendung`get-static-ips`. **AWS CLI** **Um Informationen über alle statischen Daten zu erhalten IPs** Im folgenden `get-static-ips` Beispiel werden Details zu allen statischen Daten IPs in der konfigurierten AWS Region angezeigt. ``` aws lightsail get-static-ips ``` Ausgabe: ``` { "staticIps": [ { "name": "StaticIp-1", "arn": "arn:aws:lightsail:us-west-2:111122223333:StaticIp/2257cd76-1f0e-4ac0-8EXAMPLE16f9423ad", "supportCode": "6EXAMPLE3362/192.0.2.0", "createdAt": 1571071325.076, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "StaticIp", "ipAddress": "192.0.2.0", "isAttached": false }, { "name": "StaticIP-2", "arn": "arn:aws:lightsail:us-west-2:111122223333:StaticIp/c61edb40-e5f0-4fd6-ae7c-8EXAMPLE19f8", "supportCode": "6EXAMPLE3362/192.0.2.2", "createdAt": 1568305385.681, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "resourceType": "StaticIp", "ipAddress": "192.0.2.2", "attachedTo": "WordPress-1", "isAttached": true } ] } ``` + Einzelheiten zur API finden Sie [GetStaticIps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/get-static-ips.html)unter *AWS CLI Befehlsreferenz*. ### `is-vpc-peered` Das folgende Codebeispiel zeigt die Verwendung`is-vpc-peered`. **AWS CLI** **Um festzustellen, ob Ihre Amazon Lightsail Virtual Private Cloud über Peering verfügt** Das folgende `is-vpc-peered` Beispiel gibt den Peering-Status der Amazon Lightsail Virtual Private Cloud (VPC) für die angegebene Region zurück. AWS ``` aws lightsail is-vpc-peered \ --region us-west-2 ``` Ausgabe: ``` { "isPeered": true } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [IsVpcPeered](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/is-vpc-peered.html).AWS CLI * ### `open-instance-public-ports` Das folgende Codebeispiel zeigt die Verwendung`open-instance-public-ports`. **AWS CLI** **So öffnen Sie Firewall-Ports für eine Instance** Im folgenden Beispiel für `open-instance-public-ports` wird der TCP-Port 22 auf der angegebenen Instance geöffnet. ``` aws lightsail open-instance-public-ports \ --instance-name MEAN-2 \ --port-info fromPort=22,protocol=TCP,toPort=22 ``` Ausgabe: ``` { "operation": { "id": "719744f0-a022-46f2-9f11-6EXAMPLE4642", "resourceName": "MEAN-2", "resourceType": "Instance", "createdAt": 1571072906.849, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "22/tcp", "operationType": "OpenInstancePublicPorts", "status": "Succeeded", "statusChangedAt": 1571072906.849 } } ``` + Einzelheiten zur API finden Sie [OpenInstancePublicPorts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/open-instance-public-ports.html)in der *AWS CLI Befehlsreferenz*. ### `peer-vpc` Das folgende Codebeispiel zeigt die Verwendung`peer-vpc`. **AWS CLI** **Um ein Peering mit der virtuellen privaten Cloud von Amazon Lightsail durchzuführen** Im folgenden `peer-vpc` Beispiel wird ein Peering mit der Amazon Lightsail Virtual Private Cloud (VPC) für die angegebene Region durchgeführt. AWS ``` aws lightsail peer-vpc \ --region us-west-2 ``` Ausgabe: ``` { "operation": { "id": "787e846a-54ac-497f-bce2-9EXAMPLE5d91", "resourceName": "vpc-0EXAMPLEa5261efb3", "resourceType": "PeeredVpc", "createdAt": 1571694233.104, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "vpc-e2b3eb9b", "operationType": "PeeredVpc", "status": "Succeeded", "statusChangedAt": 1571694233.104 } } ``` + *Einzelheiten zur API finden Sie unter Befehlsreferenz [PeerVpc](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/peer-vpc.html).AWS CLI * ### `reboot-instance` Das folgende Codebeispiel zeigt die Verwendung`reboot-instance`. **AWS CLI** **Um eine Instanz neu zu starten** Im folgenden Beispiel für `reboot-instance` wird die angegebene Instance neu gestartet. ``` aws lightsail reboot-instance \ --instance-name MEAN-1 ``` Ausgabe: ``` { "operations": [ { "id": "2b679f1c-8b71-4bb4-8e97-8EXAMPLEed93", "resourceName": "MEAN-1", "resourceType": "Instance", "createdAt": 1571694445.49, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "", "operationType": "RebootInstance", "status": "Succeeded", "statusChangedAt": 1571694445.49 } ] } ``` + Einzelheiten zur API finden Sie [RebootInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/reboot-instance.html)in der *AWS CLI Befehlsreferenz*. ### `reboot-relational-database` Das folgende Codebeispiel zeigt die Verwendung`reboot-relational-database`. **AWS CLI** **So starten Sie eine relationale Datenbank neu** Im folgenden Beispiel für `reboot-relational-database` wird die angegebene relationale Datenbank neu gestartet. ``` aws lightsail reboot-relational-database \ --relational-database-name Database-1 ``` Ausgabe: ``` { "operations": [ { "id": "e4c980c0-3137-496c-9c91-1EXAMPLEdec2", "resourceName": "Database-1", "resourceType": "RelationalDatabase", "createdAt": 1571694532.91, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationDetails": "", "operationType": "RebootRelationalDatabase", "status": "Started", "statusChangedAt": 1571694532.91 } ] } ``` + Einzelheiten zur API finden Sie [RebootRelationalDatabase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/reboot-relational-database.html)in der *AWS CLI Befehlsreferenz*. ### `release-static-ip` Das folgende Codebeispiel zeigt die Verwendung`release-static-ip`. **AWS CLI** **So löschen Sie eine statische IP** Im folgenden Beispiel für `release-static-ip` wird die angegebene statische IP gelöscht. ``` aws lightsail release-static-ip \ --static-ip-name StaticIp-1 ``` Ausgabe: ``` { "operations": [ { "id": "e374c002-dc6d-4c7f-919f-2EXAMPLE13ce", "resourceName": "StaticIp-1", "resourceType": "StaticIp", "createdAt": 1571694962.003, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationType": "ReleaseStaticIp", "status": "Succeeded", "statusChangedAt": 1571694962.003 } ] } ``` + Einzelheiten zur API finden Sie [ReleaseStaticIp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/release-static-ip.html)in der *AWS CLI Befehlsreferenz*. ### `start-instance` Das folgende Codebeispiel zeigt die Verwendung`start-instance`. **AWS CLI** **So starten Sie eine Instance** Im folgenden Beispiel für `start-instance` wird die angegebene Instance neu gestartet. ``` aws lightsail start-instance \ --instance-name WordPress-1 ``` Ausgabe: ``` { "operations": [ { "id": "f88d2a93-7cea-4165-afce-2d688cb18f23", "resourceName": "WordPress-1", "resourceType": "Instance", "createdAt": 1571695583.463, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "StartInstance", "status": "Started", "statusChangedAt": 1571695583.463 } ] } ``` + Einzelheiten zur API finden Sie [StartInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/start-instance.html)in der *AWS CLI Befehlsreferenz*. ### `start-relational-database` Das folgende Codebeispiel zeigt die Verwendung`start-relational-database`. **AWS CLI** **So starten Sie eine relationale Datenbank** Im folgenden Beispiel für `start-relational-database` wird die angegebene relationale Datenbank gestartet. ``` aws lightsail start-relational-database \ --relational-database-name Database-1 ``` Ausgabe: ``` { "operations": [ { "id": "4d5294ec-a38a-4fda-9e37-aEXAMPLE0d24", "resourceName": "Database-1", "resourceType": "RelationalDatabase", "createdAt": 1571695998.822, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "StartRelationalDatabase", "status": "Started", "statusChangedAt": 1571695998.822 } ] } ``` + Einzelheiten zur API finden Sie [StartRelationalDatabase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/start-relational-database.html)in der *AWS CLI Befehlsreferenz*. ### `stop-instance` Das folgende Codebeispiel zeigt die Verwendung`stop-instance`. **AWS CLI** **So beenden Sie eine Instance** Im folgenden Beispiel für `stop-instance` wird die angegebene Instance beendet. ``` aws lightsail stop-instance \ --instance-name WordPress-1 ``` Ausgabe: ``` { "operations": [ { "id": "265357e2-2943-4d51-888a-1EXAMPLE7585", "resourceName": "WordPress-1", "resourceType": "Instance", "createdAt": 1571695471.134, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "StopInstance", "status": "Started", "statusChangedAt": 1571695471.134 } ] } ``` + Einzelheiten zur API finden Sie [StopInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/stop-instance.html)in der *AWS CLI Befehlsreferenz*. ### `stop-relational-database` Das folgende Codebeispiel zeigt die Verwendung`stop-relational-database`. **AWS CLI** **So beenden Sie eine relationale Datenbank** Im folgenden Beispiel für `stop-relational-database` wird die angegebene relationale Datenbank beendet. ``` aws lightsail stop-relational-database \ --relational-database-name Database-1 ``` Ausgabe: ``` { "operations": [ { "id": "cc559c19-4adb-41e4-b75b-5EXAMPLE4e61", "resourceName": "Database-1", "resourceType": "RelationalDatabase", "createdAt": 1571695526.29, "location": { "availabilityZone": "us-west-2a", "regionName": "us-west-2" }, "isTerminal": false, "operationType": "StopRelationalDatabase", "status": "Started", "statusChangedAt": 1571695526.29 } ] } ``` + Einzelheiten zur API finden Sie [StopRelationalDatabase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/stop-relational-database.html)in der *AWS CLI Befehlsreferenz*. ### `unpeer-vpc` Das folgende Codebeispiel zeigt die Verwendung`unpeer-vpc`. **AWS CLI** **So heben Sie das Peering der virtuellen privaten Cloud von Amazon Lightsail auf** Im folgenden `unpeer-vpc` Beispiel wird das Peering der Amazon Lightsail Virtual Private Cloud (VPC) für die angegebene Region aufgehoben. AWS ``` aws lightsail unpeer-vpc \ --region us-west-2 ``` Ausgabe: ``` { "operation": { "id": "531aca64-7157-47ab-84c6-eEXAMPLEd898", "resourceName": "vpc-0EXAMPLEa5261efb3", "resourceType": "PeeredVpc", "createdAt": 1571694109.945, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "isTerminal": true, "operationDetails": "vpc-e2b3eb9b", "operationType": "UnpeeredVpc", "status": "Succeeded", "statusChangedAt": 1571694109.945 } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [UnpeerVpc](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lightsail/unpeer-vpc.html).AWS CLI * # Macie-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface mit Macie Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `describe-buckets` Das folgende Codebeispiel zeigt, wie Sie`describe-buckets`. **AWS CLI** **So führen Sie eine Datenabfrage in einem oder mehreren S3-Buckets durch, die Amazon Macie für Ihr Konto überwacht und analysiert** Im folgenden `describe-buckets` Beispiel werden Metadaten für alle S3-Buckets abgefragt, deren Namen mit amzn-s3-demo-bucket beginnen und sich in der aktuellen Region befinden. AWS ``` aws macie2 describe-buckets \ --criteria '{"bucketName":{"prefix":"amzn-s3-demo-bucket"}}' ``` Ausgabe: ``` { "buckets": [ { "accountId": "123456789012", "allowsUnencryptedObjectUploads": "FALSE", "automatedDiscoveryMonitoringStatus": "MONITORED", "bucketArn": "arn:aws:s3:::amzn-s3-demo-bucket1", "bucketCreatedAt": "2020-05-18T19:54:00+00:00", "bucketName": "amzn-s3-demo-bucket1", "classifiableObjectCount": 13, "classifiableSizeInBytes": 1592088, "jobDetails": { "isDefinedInJob": "TRUE", "isMonitoredByJob": "TRUE", "lastJobId": "08c81dc4a2f3377fae45c9ddaEXAMPLE", "lastJobRunTime": "2024-08-19T14:55:30.270000+00:00" }, "lastAutomatedDiscoveryTime": "2024-10-22T19:11:25.364000+00:00", "lastUpdated": "2024-10-25T07:33:06.337000+00:00", "objectCount": 13, "objectCountByEncryptionType": { "customerManaged": 0, "kmsManaged": 2, "s3Managed": 7, "unencrypted": 4, "unknown": 0 }, "publicAccess": { "effectivePermission": "NOT_PUBLIC", "permissionConfiguration": { "accountLevelPermissions": { "blockPublicAccess": { "blockPublicAcls": true, "blockPublicPolicy": true, "ignorePublicAcls": true, "restrictPublicBuckets": true } }, "bucketLevelPermissions": { "accessControlList": { "allowsPublicReadAccess": false, "allowsPublicWriteAccess": false }, "blockPublicAccess": { "blockPublicAcls": true, "blockPublicPolicy": true, "ignorePublicAcls": true, "restrictPublicBuckets": true }, "bucketPolicy": { "allowsPublicReadAccess": false, "allowsPublicWriteAccess": false } } } }, "region": "us-west-2", "replicationDetails": { "replicated": false, "replicatedExternally": false, "replicationAccounts": [] }, "sensitivityScore": 78, "serverSideEncryption": { "kmsMasterKeyId": null, "type": "NONE" }, "sharedAccess": "NOT_SHARED", "sizeInBytes": 4549746, "sizeInBytesCompressed": 0, "tags": [ { "key": "Division", "value": "HR" }, { "key": "Team", "value": "Recruiting" } ], "unclassifiableObjectCount": { "fileType": 0, "storageClass": 0, "total": 0 }, "unclassifiableObjectSizeInBytes": { "fileType": 0, "storageClass": 0, "total": 0 }, "versioning": true }, { "accountId": "123456789012", "allowsUnencryptedObjectUploads": "TRUE", "automatedDiscoveryMonitoringStatus": "MONITORED", "bucketArn": "arn:aws:s3:::amzn-s3-demo-bucket2", "bucketCreatedAt": "2020-11-25T18:24:38+00:00", "bucketName": "amzn-s3-demo-bucket2", "classifiableObjectCount": 8, "classifiableSizeInBytes": 133810, "jobDetails": { "isDefinedInJob": "TRUE", "isMonitoredByJob": "FALSE", "lastJobId": "188d4f6044d621771ef7d65f2EXAMPLE", "lastJobRunTime": "2024-07-09T19:37:11.511000+00:00" }, "lastAutomatedDiscoveryTime": "2024-10-24T19:11:25.364000+00:00", "lastUpdated": "2024-10-25T07:33:06.337000+00:00", "objectCount": 8, "objectCountByEncryptionType": { "customerManaged": 0, "kmsManaged": 0, "s3Managed": 8, "unencrypted": 0, "unknown": 0 }, "publicAccess": { "effectivePermission": "NOT_PUBLIC", "permissionConfiguration": { "accountLevelPermissions": { "blockPublicAccess": { "blockPublicAcls": true, "blockPublicPolicy": true, "ignorePublicAcls": true, "restrictPublicBuckets": true } }, "bucketLevelPermissions": { "accessControlList": { "allowsPublicReadAccess": false, "allowsPublicWriteAccess": false }, "blockPublicAccess": { "blockPublicAcls": true, "blockPublicPolicy": true, "ignorePublicAcls": true, "restrictPublicBuckets": true }, "bucketPolicy": { "allowsPublicReadAccess": false, "allowsPublicWriteAccess": false } } } }, "region": "us-west-2", "replicationDetails": { "replicated": false, "replicatedExternally": false, "replicationAccounts": [] }, "sensitivityScore": 95, "serverSideEncryption": { "kmsMasterKeyId": null, "type": "AES256" }, "sharedAccess": "EXTERNAL", "sizeInBytes": 175978, "sizeInBytesCompressed": 0, "tags": [ { "key": "Division", "value": "HR" }, { "key": "Team", "value": "Recruiting" } ], "unclassifiableObjectCount": { "fileType": 3, "storageClass": 0, "total": 3 }, "unclassifiableObjectSizeInBytes": { "fileType": 2999826, "storageClass": 0, "total": 2999826 }, "versioning": true } ] } ``` Weitere Informationen finden Sie unter [Filtern Ihres S3-Bucket-Inventars](https://docs.aws.amazon.com/macie/latest/user/monitoring-s3-inventory-filter.html) im *Benutzerhandbuch für Amazon Macie*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DescribeBuckets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/macie2/describe-buckets.html)AWS CLI * # Amazon Managed Grafana-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Managed Grafana Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `list-workspaces` Das folgende Codebeispiel zeigt die Verwendung `list-workspaces` von. **AWS CLI** **So listen Sie Workspaces für das Konto in der durch die Benutzer-Anmeldeinformationen angegebenen Region auf** Im folgenden Beispiel für `list-workspaces` werden Grafana-Workspaces für die Region des Kontos aufgelistet. ``` aws grafana list-workspaces ``` Ausgabe: ``` { "workspaces": [ { "authentication": { "providers": [ "AWS_SSO" ] }, "created": "2022-04-04T16:20:21.796000-07:00", "description": "to test tags", "endpoint": "g-949e7b44df.grafana-workspace.us-east-1.amazonaws.com", "grafanaVersion": "8.2", "id": "g-949e7b44df", "modified": "2022-04-04T16:20:21.796000-07:00", "name": "testtag2", "notificationDestinations": [ "SNS" ], "status": "ACTIVE" }, { "authentication": { "providers": [ "AWS_SSO" ] }, "created": "2022-04-20T10:22:15.115000-07:00", "description": "ww", "endpoint": "g-bffa51ed1b.grafana-workspace.us-east-1.amazonaws.com", "grafanaVersion": "8.2", "id": "g-bffa51ed1b", "modified": "2022-04-20T10:22:15.115000-07:00", "name": "ww", "notificationDestinations": [ "SNS" ], "status": "ACTIVE" } ] } ``` + Einzelheiten zur API finden Sie [ListWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/grafana/list-workspaces.html)in der *AWS CLI Befehlsreferenz*. # MediaConnect Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren MediaConnect. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-flow-outputs` Das folgende Codebeispiel zeigt, wie Sie`add-flow-outputs`. **AWS CLI** **So fügen Sie Ausgaben zu einem Flow hinzu** Im folgenden Beispiel für `add-flow-outputs` werden Ausgaben zum angegebenen Flow hinzugefügt. ``` aws mediaconnect add-flow-outputs \ --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \ --outputs Description='NYC stream',Destination=192.0.2.12,Name=NYC,Port=3333,Protocol=rtp-fec,SmoothingLatency=100 Description='LA stream',Destination=203.0.113.9,Name=LA,Port=4444,Protocol=rtp-fec,SmoothingLatency=100 ``` Ausgabe: ``` { "Outputs": [ { "Port": 3333, "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC", "Name": "NYC", "Description": "NYC stream", "Destination": "192.0.2.12", "Transport": { "Protocol": "rtp-fec", "SmoothingLatency": 100 } }, { "Port": 4444, "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-987655dEF67hiJ89-c34de5fG678h:LA", "Name": "LA", "Description": "LA stream", "Destination": "203.0.113.9", "Transport": { "Protocol": "rtp-fec", "SmoothingLatency": 100 } } ], "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame" } ``` Weitere Informationen finden Sie unter [Hinzufügen von Ausgaben zu einem Flow](https://docs.aws.amazon.com/mediaconnect/latest/ug/outputs-add.html) im *AWS Elemental MediaConnect User Guide*. + Einzelheiten zur API finden Sie unter [AddFlowOutputs AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/add-flow-outputs.html)*Befehlsreferenz.* ### `create-flow` Das folgende Codebeispiel zeigt die Verwendung`create-flow`. **AWS CLI** **So erstellen Sie einen Flow** Im folgenden Beispiel für `create-flow` wird ein Flow mit der angegebenen Konfiguration erstellt. ``` aws mediaconnect create-flow \ --availability-zone us-west-2c \ --name ExampleFlow \ --source Description='Example source, backup',IngestPort=1055,Name=BackupSource,Protocol=rtp,WhitelistCidr=10.24.34.0/23 ``` Ausgabe: ``` { "Flow": { "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:ExampleFlow", "AvailabilityZone": "us-west-2c", "EgressIp": "54.245.71.21", "Source": { "IngestPort": 1055, "SourceArn": "arn:aws:mediaconnect:us-east-1:123456789012:source:2-3aBC45dEF67hiJ89-c34de5fG678h:BackupSource", "Transport": { "Protocol": "rtp", "MaxBitrate": 80000000 }, "Description": "Example source, backup", "IngestIp": "54.245.71.21", "WhitelistCidr": "10.24.34.0/23", "Name": "mySource" }, "Entitlements": [], "Name": "ExampleFlow", "Outputs": [], "Status": "STANDBY", "Description": "Example source, backup" } } ``` Weitere Informationen finden Sie unter [Creating a Flow](https://docs.aws.amazon.com/mediaconnect/latest/ug/flows-create.html) im *AWS Elemental MediaConnect User Guide*. + Einzelheiten zur API finden Sie [CreateFlow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/create-flow.html)in der *AWS CLI Befehlsreferenz.* ### `delete-flow` Das folgende Codebeispiel zeigt die Verwendung`delete-flow`. **AWS CLI** **So löschen Sie einen Flow** Im folgenden Beispiel für `delete-flow` wird der angegebene Flow gelöscht. ``` aws mediaconnect delete-flow \ --flow-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow ``` Ausgabe: ``` { "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow", "Status": "DELETING" } ``` Weitere Informationen finden Sie unter [Löschen eines Flows](https://docs.aws.amazon.com/mediaconnect/latest/ug/flows-delete.html) im *AWS MediaConnect Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteFlow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/delete-flow.html)in der *AWS CLI Befehlsreferenz.* ### `describe-flow` Das folgende Codebeispiel zeigt die Verwendung`describe-flow`. **AWS CLI** **So zeigen Sie die Details eines Flows an** Im folgenden Beispiel für `describe-flow` werden die Details des angegebenen Flows angezeigt, z. B. ARN, Availability Zone, Status, Quelle, Berechtigungen und Ausgaben. ``` aws mediaconnect describe-flow \ --flow-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow ``` Ausgabe: ``` { "Flow": { "EgressIp": "54.201.4.39", "AvailabilityZone": "us-west-2c", "Status": "ACTIVE", "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow", "Entitlements": [ { "EntitlementArn": "arn:aws:mediaconnect:us-west-2:123456789012:entitlement:1-AaBb11CcDd22EeFf-34DE5fG12AbC:MyEntitlement", "Description": "Assign to this account", "Name": "MyEntitlement", "Subscribers": [ "444455556666" ] } ], "Description": "NYC awards show", "Name": "AwardsShow", "Outputs": [ { "Port": 2355, "Name": "NYC", "Transport": { "SmoothingLatency": 0, "Protocol": "rtp-fec" }, "OutputArn": "arn:aws:mediaconnect:us-east-1:123456789012:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC", "Destination": "192.0.2.0" }, { "Port": 3025, "Name": "LA", "Transport": { "SmoothingLatency": 0, "Protocol": "rtp-fec" }, "OutputArn": "arn:aws:mediaconnect:us-east-1:123456789012:output:2-987655dEF67hiJ89-c34de5fG678h:LA", "Destination": "192.0.2.0" } ], "Source": { "IngestIp": "54.201.4.39", "SourceArn": "arn:aws:mediaconnect:us-east-1:123456789012:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:ShowSource", "Transport": { "MaxBitrate": 80000000, "Protocol": "rtp" }, "IngestPort": 1069, "Description": "Saturday night show", "Name": "ShowSource", "WhitelistCidr": "10.24.34.0/23" } } } ``` Weitere Informationen finden Sie unter [Anzeigen der Details eines Flows](https://docs.aws.amazon.com/mediaconnect/latest/ug/flows-view-details.html) im *AWS MediaConnect Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeFlow AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/describe-flow.html)*Befehlsreferenz.* ### `grant-flow-entitlements` Das folgende Codebeispiel zeigt die Verwendung`grant-flow-entitlements`. **AWS CLI** **So gewähren Sie eine Berechtigung für einen Flow** Das folgende `grant-flow-entitlements` Beispiel gewährt dem angegebenen vorhandenen Flow die Berechtigung, Ihre Inhalte mit einem anderen AWS Konto zu teilen. ``` aws mediaconnect grant-flow-entitlements \ --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \ --entitlements Description='For AnyCompany',Encryption={"Algorithm=aes128,KeyType=static-key,RoleArn=arn:aws:iam::111122223333:role/MediaConnect-ASM,SecretArn=arn:aws:secretsmanager:us-west-2:111122223333:secret:mySecret1"},Name=AnyCompany_Entitlement,Subscribers=444455556666 Description='For Example Corp',Name=ExampleCorp,Subscribers=777788889999 ``` Ausgabe: ``` { "Entitlements": [ { "Name": "AnyCompany_Entitlement", "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement", "Subscribers": [ "444455556666" ], "Description": "For AnyCompany", "Encryption": { "SecretArn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:mySecret1", "Algorithm": "aes128", "RoleArn": "arn:aws:iam::111122223333:role/MediaConnect-ASM", "KeyType": "static-key" } }, { "Name": "ExampleCorp", "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-3333cccc4444dddd-1111aaaa2222:ExampleCorp", "Subscribers": [ "777788889999" ], "Description": "For Example Corp" } ], "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame" } ``` Weitere Informationen finden Sie unter [Gewährung einer Berechtigung für einen Flow](https://docs.aws.amazon.com/mediaconnect/latest/ug/entitlements-grant.html) im *AWS Elemental-Benutzerhandbuch. MediaConnect * + Einzelheiten zur API finden Sie unter [GrantFlowEntitlements AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/grant-flow-entitlements.html)*Befehlsreferenz*. ### `list-entitlements` Das folgende Codebeispiel zeigt die Verwendung`list-entitlements`. **AWS CLI** **So zeigen Sie eine Liste von Berechtigungen an** Im folgenden Beispiel für `list-entitlements` wird eine Liste aller Berechtigungen angezeigt, die dem Konto gewährt wurden. ``` aws mediaconnect list-entitlements ``` Ausgabe: ``` { "Entitlements": [ { "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:MyEntitlement", "EntitlementName": "MyEntitlement" } ] } ``` Weitere Informationen finden Sie [ListEntitlements](https://docs.aws.amazon.com/mediaconnect/latest/api/v1-entitlements.html)in der *AWS Elemental MediaConnect API-Referenz.* + Einzelheiten zur API finden Sie [ListEntitlements](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/list-entitlements.html)in der *AWS CLI Befehlsreferenz.* ### `list-flows` Das folgende Codebeispiel zeigt die Verwendung`list-flows`. **AWS CLI** **So zeigen Sie eine Liste von Flows an** Im folgenden Beispiel für `list-flows` wird eine Liste der Flows angezeigt. ``` aws mediaconnect list-flows ``` Ausgabe: ``` { "Flows": [ { "Status": "STANDBY", "SourceType": "OWNED", "AvailabilityZone": "us-west-2a", "Description": "NYC awards show", "Name": "AwardsShow", "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow" }, { "Status": "STANDBY", "SourceType": "OWNED", "AvailabilityZone": "us-west-2c", "Description": "LA basketball game", "Name": "BasketballGame", "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BasketballGame" } ] } ``` Weitere Informationen finden Sie unter [Eine Liste von Flows anzeigen](https://docs.aws.amazon.com/mediaconnect/latest/ug/flows-view-list.html) im *AWS Elemental MediaConnect User Guide*. + Einzelheiten zur API finden Sie unter [ListFlows AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/list-flows.html)*Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Um Tags für eine MediaConnect Ressource aufzulisten** Im folgenden `list-tags-for-resource` Beispiel werden die Tag-Schlüssel und -Werte angezeigt, die der angegebenen MediaConnect Ressource zugeordnet sind. ``` aws mediaconnect list-tags-for-resource \ --resource-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BasketballGame ``` Ausgabe: ``` { "Tags": { "region": "west", "stage": "prod" } } ``` Weitere Informationen finden Sie unter [ListTagsForResource TagResource, UntagResource](https://docs.aws.amazon.com/mediaconnect/latest/api/tags-resourcearn.html) in der *AWS Elemental MediaConnect API-Referenz.* + Einzelheiten zur API finden Sie unter [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/list-tags-for-resource.html)*Befehlsreferenz.* ### `remove-flow-output` Das folgende Codebeispiel zeigt die Verwendung`remove-flow-output`. **AWS CLI** **So entfernen Sie eine Ausgabe aus einem Flow** Im folgenden Beispiel für `remove-flow-output` wird eine Ausgabe aus dem angegebenen Flow entfernt. ``` aws mediaconnect remove-flow-output \ --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \ --output-arn arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC ``` Ausgabe: ``` { "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame", "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC" } ``` Weitere Informationen finden Sie unter [Entfernen von Ausgaben aus einem Flow](https://docs.aws.amazon.com/mediaconnect/latest/ug/outputs-remove.html) im *AWS Elemental MediaConnect User Guide*. + Einzelheiten zur API finden Sie unter [RemoveFlowOutput AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/remove-flow-output.html)*Befehlsreferenz.* ### `revoke-flow-entitlement` Das folgende Codebeispiel zeigt die Verwendung`revoke-flow-entitlement`. **AWS CLI** **So widerrufen Sie eine Berechtigung** Im folgenden Beispiel für `revoke-flow-entitlement` wird eine Berechtigung für den angegebenen Flow widerrufen. ``` aws mediaconnect revoke-flow-entitlement \ --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \ --entitlement-arn arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement ``` Ausgabe: ``` { "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame", "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement" } ``` Weitere Informationen finden Sie unter [Widerruf einer Berechtigung](https://docs.aws.amazon.com/mediaconnect/latest/ug/entitlements-revoke.html) im *AWS MediaConnect Elemental-Benutzerhandbuch*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [RevokeFlowEntitlement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/revoke-flow-entitlement.html).AWS CLI * ### `start-flow` Das folgende Codebeispiel zeigt die Verwendung`start-flow`. **AWS CLI** **So starten Sie einen Flow** Im folgenden Beispiel für `start-flow` wird der angegebene Flow neu gestartet. ``` aws mediaconnect start-flow \ --flow-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow", "Status": "STARTING" } ``` Weitere Informationen finden Sie unter [Einen Flow starten](https://docs.aws.amazon.com/mediaconnect/latest/ug/flows-start.html) im *AWS MediaConnect Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartFlow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/start-flow.html)in der *AWS CLI Befehlsreferenz.* ### `stop-flow` Das folgende Codebeispiel zeigt die Verwendung`stop-flow`. **AWS CLI** **So beenden Sie einen Flow** Im folgenden Beispiel für `stop-flow` wird der angegebene Flow beendet. ``` aws mediaconnect stop-flow \ --flow-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow ``` Ausgabe: ``` { "Status": "STOPPING", "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow" } ``` Weitere Informationen finden Sie unter [Stopping a Flow](https://docs.aws.amazon.com/mediaconnect/latest/ug/flows-stop.html) im *AWS Elemental MediaConnect User Guide*. + Einzelheiten zur API finden Sie [StopFlow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/stop-flow.html)in der *AWS CLI Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **Um einer MediaConnect Ressource Tags hinzuzufügen** Im folgenden `tag-resource` Beispiel wird der angegebenen MediaConnect Ressource ein Tag mit einem Schlüsselnamen und einem Schlüsselwert hinzugefügt. ``` aws mediaconnect tag-resource \ --resource-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BasketballGame --tags region=west ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [ListTagsForResource TagResource, UntagResource](https://docs.aws.amazon.com/mediaconnect/latest/api/tags-resourcearn.html) in der *AWS Elemental MediaConnect API-Referenz.* + Einzelheiten zur API finden Sie unter [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/tag-resource.html)*Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Um Tags aus einer MediaConnect Ressource zu entfernen** Im folgenden `untag-resource` Beispiel wird das Tag mit dem angegebenen Schlüsselnamen und dem zugehörigen Wert aus einer MediaConnect Ressource entfernt. ``` aws mediaconnect untag-resource \ --resource-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BasketballGame \ --tag-keys region ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [ListTagsForResource TagResource, UntagResource](https://docs.aws.amazon.com/mediaconnect/latest/api/tags-resourcearn.html) in der *AWS Elemental MediaConnect API-Referenz.* + Einzelheiten zur API finden Sie unter [UntagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/untag-resource.html)*Befehlsreferenz.* ### `update-flow-entitlement` Das folgende Codebeispiel zeigt die Verwendung`update-flow-entitlement`. **AWS CLI** **So aktualisieren Sie eine Berechtigung** Im folgenden Beispiel für `update-flow-entitlement` wird die angegebene Berechtigung mit einer neuen Beschreibung und einem neuen Subscriber aktualisiert. ``` aws mediaconnect update-flow-entitlement \ --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \ --entitlement-arn arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement \ --description 'For AnyCompany Affiliate' \ --subscribers 777788889999 ``` Ausgabe: ``` { "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame", "Entitlement": { "Name": "AnyCompany_Entitlement", "Description": "For AnyCompany Affiliate", "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement", "Encryption": { "KeyType": "static-key", "Algorithm": "aes128", "RoleArn": "arn:aws:iam::111122223333:role/MediaConnect-ASM", "SecretArn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:mySecret1" }, "Subscribers": [ "777788889999" ] } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Berechtigung](https://docs.aws.amazon.com/mediaconnect/latest/ug/entitlements-update.html) im *AWS Elemental MediaConnect User Guide*. + Einzelheiten zur API finden Sie unter [UpdateFlowEntitlement AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/update-flow-entitlement.html)*Befehlsreferenz*. ### `update-flow-output` Das folgende Codebeispiel zeigt die Verwendung`update-flow-output`. **AWS CLI** **So aktualisieren Sie eine Ausgabe in einem Flow** Im folgenden Beispiel für `update-flow-output` wird eine Ausgabe im angegebenen Flow aktualisiert. ``` aws mediaconnect update-flow-output \ --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \ --output-arn arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC \ --port 3331 ``` Ausgabe: ``` { "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame", "Output": { "Name": "NYC", "Port": 3331, "Description": "NYC stream", "Transport": { "Protocol": "rtp-fec", "SmoothingLatency": 100 }, "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC", "Destination": "192.0.2.12" } } ``` Weitere Informationen finden Sie unter [Aktualisieren von Ausgaben in einem Flow](https://docs.aws.amazon.com/mediaconnect/latest/ug/outputs-update.html) im *AWS Elemental MediaConnect User Guide*. + Einzelheiten zur API finden Sie unter [UpdateFlowOutput AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/update-flow-output.html)*Befehlsreferenz.* ### `update-flow-source` Das folgende Codebeispiel zeigt die Verwendung`update-flow-source`. **AWS CLI** **So aktualisieren Sie die Quelle eines vorhandenen Flows** Im folgenden Beispiel für `update-flow-source` wird die Quelle eines vorhandenen Flows aktualisiert. ``` aws mediaconnect update-flow-source \ --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow \ --source-arn arn:aws:mediaconnect:us-east-1:111122223333:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:ShowSource \ --description 'Friday night show' \ --ingest-port 3344 \ --protocol rtp-fec \ --whitelist-cidr 10.24.34.0/23 ``` Ausgabe: ``` { "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow", "Source": { "IngestIp": "34.210.136.56", "WhitelistCidr": "10.24.34.0/23", "Transport": { "Protocol": "rtp-fec" }, "IngestPort": 3344, "Name": "ShowSource", "Description": "Friday night show", "SourceArn": "arn:aws:mediaconnect:us-east-1:111122223333:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:ShowSource" } } ``` Weitere Informationen finden Sie unter [Aktualisieren der Quelle eines Flusses](https://docs.aws.amazon.com/mediaconnect/latest/ug/source-update.html) im *AWS Elemental MediaConnect User Guide*. + Einzelheiten zur API finden Sie unter [UpdateFlowSource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconnect/update-flow-source.html)*Befehlsreferenz.* # MediaConvert Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren MediaConvert. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `cancel-job` Das folgende Codebeispiel zeigt, wie Sie`cancel-job`. **AWS CLI** **So brechen Sie einen Auftrag ab, der sich in einer Warteschlange befindet** Im folgenden Beispiel für `cancel-job` wird ein Auftrag mit der ID `1234567891234-abc123` abgebrochen. Ein Auftrag kann nicht mehr abgebrochen werden, sobald der Service mit seiner Verarbeitung begonnen hat. ``` aws mediaconvert cancel-job \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1 \ --id 1234567891234-abc123 ``` Verwenden Sie `describe-endpoints` zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück. Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Jobs](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) im *AWS MediaConvert Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CancelJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/cancel-job.html)in der *AWS CLI Befehlsreferenz*. ### `create-job-template` Das folgende Codebeispiel zeigt die Verwendung`create-job-template`. **AWS CLI** **So erstellen Sie eine neue Auftragsvorlage** Im folgenden Beispiel für `create-job-template` wird eine Auftragsvorlage mit den Transkodierungseinstellungen gemäß der Datei `job-template.json` erstellt, die sich auf dem System befindet. ``` aws mediaconvert create-job-template \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1 \ --name JobTemplate1 \ --cli-input-json file://~/job-template.json ``` Wenn Sie die JSON-Datei mit der Auftragsvorlage unter Verwendung von `get-job-template` erstellen und die Datei anschließend ändern, entfernen Sie das `JobTemplate`-Objekt, behalten aber das darin enthaltene untergeordnete Objekt „Settings“ bei. Achten Sie außerdem darauf, die folgenden Schlüssel-Wert-Paare zu entfernen: `LastUpdated`, `Arn`, `Type` und `CreatedAt`. Sie können die Kategorie, die Beschreibung, den Namen und die Warteschlange entweder in der JSON-Datei oder in der Befehlszeile angeben. Verwenden Sie `describe-endpoints` zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück. Wenn Ihre Anfrage erfolgreich ist, gibt der Service die JSON-Spezifikation für die von Ihnen erstellte Jobvorlage zurück. Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) im *AWS Elemental MediaConvert User Guide*. + Einzelheiten zur API finden Sie [CreateJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job-template.html)in der *AWS CLI Befehlsreferenz*. ### `create-job` Das folgende Codebeispiel zeigt die Verwendung`create-job`. **AWS CLI** **Um einen Job zu erstellen** Im folgenden Beispiel für `create-job` wird ein Transkodierungsauftrag mit den Einstellungen gemäß einer `job.json`-Datei erstellt, die sich auf dem System befindet, von dem der Befehl ausging. In dieser JSON-Auftragsspezifikation kann jede Einstellung einzeln angegeben werden, auf eine Auftragsvorlage oder auf Ausgabevorgaben verweisen. ``` aws mediaconvert create-job \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1 \ --cli-input-json file://~/job.json ``` Sie können die AWS MediaConvert Elemental-Konsole verwenden, um die JSON-Jobspezifikation zu generieren, indem Sie Ihre Job-Einstellungen auswählen und dann unten im **Job-Bereich die Option **Job-JSON** anzeigen** auswählen. Verwenden Sie `describe-endpoints` zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück. Wenn die Anfrage erfolgreich ist, gibt der Service die JSON-Auftragsspezifikation zurück, die Sie mit der Anfrage gesendet haben. Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Jobs](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) im *AWS Elemental User Guide MediaConvert *. + Einzelheiten zur API finden Sie [CreateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job.html)in der *AWS CLI Befehlsreferenz*. ### `create-preset` Das folgende Codebeispiel zeigt die Verwendung`create-preset`. **AWS CLI** **Um eine benutzerdefinierte Ausgabevoreinstellung zu erstellen** Im folgenden Beispiel für `create-preset` wird eine benutzerdefinierte Ausgabevorgabe auf der Basis der Ausgabeeinstellungen erstellt, die in der `preset.json`-Datei angegeben sind. Sie können die Kategorie, die Beschreibung und den Namen entweder in der JSON-Datei oder in der Befehlszeile angeben. ``` aws mediaconvert create-preset \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com --region region-name-1 \ --cli-input-json file://~/preset.json ``` Wenn Sie die voreingestellte JSON-Datei mithilfe von `get-preset` erstellen und die Ausgabedatei anschließend ändern, stellen Sie sicher, dass Sie die folgenden Schlüssel-Wert-Paare entfernen: `LastUpdated`, `Arn`, `Type` und `CreatedAt`. Verwenden Sie `describe-endpoints` zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück. Weitere Informationen finden Sie unter [Arbeiten mit AWS MediaConvert Elemental-Ausgabevoreinstellungen](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) im *AWS Elemental-Benutzerhandbuch. MediaConvert * + *Einzelheiten zur API finden Sie [CreatePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-preset.html)in AWS CLI der Befehlsreferenz.* ### `create-queue` Das folgende Codebeispiel zeigt die Verwendung`create-queue`. **AWS CLI** **So erstellen Sie eine benutzerdefinierte Warteschlange** Im folgenden Beispiel für `create-queue` wird eine benutzerdefinierte Transkodierungswarteschlange erstellt. ``` aws mediaconvert create-queue \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1 \ --name Queue1 \ --description "Keep this queue empty unless job is urgent." ``` Verwenden Sie `describe-endpoints` zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück. Ausgabe: ``` { "Queue": { "Status": "ACTIVE", "Name": "Queue1", "LastUpdated": 1518034928, "Arn": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1", "Type": "CUSTOM", "CreatedAt": 1518034928, "Description": "Keep this queue empty unless job is urgent." } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) im *AWS Elemental User Guide MediaConvert *. + *Einzelheiten zur API finden Sie [CreateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-queue.html)in AWS CLI der Befehlsreferenz.* ### `delete-job-template` Das folgende Codebeispiel zeigt die Verwendung`delete-job-template`. **AWS CLI** **Um eine Jobvorlage zu löschen** Im folgenden Beispiel für `delete-job-template` wird die angegebene benutzerdefinierte Auftragsvorlage gelöscht. ``` aws mediaconvert delete-job-template \ --name "DASH Streaming" \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Führen Sie `aws mediaconvert list-job-templates` aus, um zu bestätigen, dass die Vorlage gelöscht wurde. Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) im *AWS Elemental MediaConvert User Guide*. + Einzelheiten zur API finden Sie [DeleteJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-job-template.html)in der *AWS CLI Befehlsreferenz*. ### `delete-preset` Das folgende Codebeispiel zeigt die Verwendung`delete-preset`. **AWS CLI** **So löschen Sie eine On-Demand-Warteschlange** Im folgenden Beispiel für `delete-preset` wird die angegebene benutzerdefinierte Voreinstellung gelöscht. ``` aws mediaconvert delete-preset \ --name SimpleMP4 \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Führen Sie `aws mediaconvert list-presets` aus, um zu bestätigen, dass die Voreinstellung gelöscht wurde. Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) im *AWS Elemental User Guide MediaConvert *. + *Einzelheiten zur API finden Sie [DeletePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-preset.html)in AWS CLI der Befehlsreferenz.* ### `delete-queue` Das folgende Codebeispiel zeigt die Verwendung`delete-queue`. **AWS CLI** **So löschen Sie eine On-Demand-Warteschlange** Im folgenden Beispiel für `delete-queue` wird die angegebene benutzerdefinierte On-Demand-Warteschlange gelöscht. Sie können Ihre Standardwarteschlange nicht löschen. Sie können keine reservierte Warteschlange löschen, die ein aktives Preismodell hat oder unverarbeitete Aufträge enthält. ``` aws mediaconvert delete-queue \ --name Customer1 \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Führen Sie `aws mediaconvert list-queues` aus, um zu bestätigen, dass die Warteschlange gelöscht wurde. Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) im *AWS Elemental User Guide MediaConvert *. + *Einzelheiten zur API finden Sie [DeleteQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-queue.html)in AWS CLI der Befehlsreferenz.* ### `describe-endpoints` Das folgende Codebeispiel zeigt die Verwendung`describe-endpoints`. **AWS CLI** **So rufen Sie einen kontospezifischen Endpunkt ab** Im folgenden Beispiel für `describe-endpoints` wird der Endpunkt abgerufen, den Sie benötigen, um eine andere Anfrage an den Service zu senden. ``` aws mediaconvert describe-endpoints ``` Ausgabe: ``` { "Endpoints": [ { "Url": "https://abcd1234.mediaconvert.region-name-1.amazonaws.com" } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit der MediaConvert Verwendung der API](https://docs.aws.amazon.com/mediaconvert/latest/apireference/getting-started.html) in der *AWS Elemental MediaConvert API-Referenz.* + Einzelheiten zur API finden Sie unter [DescribeEndpoints AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/describe-endpoints.html)*Befehlsreferenz.* ### `get-job-template` Das folgende Codebeispiel zeigt die Verwendung`get-job-template`. **AWS CLI** **So rufen Sie Details einer Auftragsvorlage ab** Im folgenden Beispiel für `get-job-template` wird die JSON-Definition der angegebenen benutzerdefinierten Auftragsvorlage angezeigt. ``` aws mediaconvert get-job-template \ --name "DASH Streaming" \ --endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com ``` Ausgabe: ``` { "JobTemplate": { "StatusUpdateInterval": "SECONDS_60", "LastUpdated": 1568652998, "Description": "Create a DASH streaming ABR stack", "CreatedAt": 1568652998, "Priority": 0, "Name": "DASH Streaming", "Settings": { ...... }, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/DASH Streaming", "Type": "CUSTOM" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) im *AWS Elemental MediaConvert User Guide*. + Einzelheiten zur API finden Sie [GetJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-job` Das folgende Codebeispiel zeigt die Verwendung`get-job`. **AWS CLI** **So rufen Sie Details für einen bestimmten Auftrag ab** Im folgenden Beispiel werden die Informationen für den Auftrag mit der ID `1234567890987-1ab2c3` abgerufen, was in diesem Beispiel mit einem Fehler endete. ``` aws mediaconvert get-job \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1 \ --id 1234567890987-1ab2c3 ``` Verwenden Sie `describe-endpoints` zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück. Wenn die Anfrage erfolgreich ist, gibt der Service, wie im Folgenden angezeigt, eine JSON-Datei mit Auftragsinformationen, einschließlich Auftragseinstellungen, allen zurückgegebenen Fehlern und anderen Auftragsdaten, zurück: ``` { "Job": { "Status": "ERROR", "Queue": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1", "Settings": { ...... }, "ErrorMessage": "Unable to open input file [s3://my-input-bucket/file-name.mp4]: [Failed probe/open: [Failed to read data: AssumeRole failed]]", "ErrorCode": 1434, "Role": "arn:aws:iam::012345678998:role/MediaConvertServiceRole", "Arn": "arn:aws:mediaconvert:us-west-1:012345678998:jobs/1234567890987-1ab2c3", "UserMetadata": {}, "Timing": { "FinishTime": 1517442131, "SubmitTime": 1517442103, "StartTime": 1517442104 }, "Id": "1234567890987-1ab2c3", "CreatedAt": 1517442103 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Jobs](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) im *AWS MediaConvert Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job.html)in der *AWS CLI Befehlsreferenz*. ### `get-preset` Das folgende Codebeispiel zeigt die Verwendung`get-preset`. **AWS CLI** **So rufen Sie Details für eine bestimmte Voreinstellung ab** Im folgenden Beispiel für `get-preset` wird die JSON-Definition der angegebenen benutzerdefinierten Voreinstellung angezeigt. ``` aws mediaconvert get-preset \ --name SimpleMP4 \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Ausgabe: ``` { "Preset": { "Description": "Creates basic MP4 file. No filtering or preproccessing.", "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4", "LastUpdated": 1568843141, "Name": "SimpleMP4", "Settings": { "ContainerSettings": { "Mp4Settings": { "FreeSpaceBox": "EXCLUDE", "CslgAtom": "INCLUDE", "MoovPlacement": "PROGRESSIVE_DOWNLOAD" }, "Container": "MP4" }, "AudioDescriptions": [ { "LanguageCodeControl": "FOLLOW_INPUT", "AudioTypeControl": "FOLLOW_INPUT", "CodecSettings": { "AacSettings": { "RawFormat": "NONE", "CodecProfile": "LC", "AudioDescriptionBroadcasterMix": "NORMAL", "SampleRate": 48000, "Bitrate": 96000, "RateControlMode": "CBR", "Specification": "MPEG4", "CodingMode": "CODING_MODE_2_0" }, "Codec": "AAC" } } ], "VideoDescription": { "RespondToAfd": "NONE", "TimecodeInsertion": "DISABLED", "Sharpness": 50, "ColorMetadata": "INSERT", "CodecSettings": { "H264Settings": { "FramerateControl": "INITIALIZE_FROM_SOURCE", "SpatialAdaptiveQuantization": "ENABLED", "Softness": 0, "Telecine": "NONE", "CodecLevel": "AUTO", "QualityTuningLevel": "SINGLE_PASS", "UnregisteredSeiTimecode": "DISABLED", "Slices": 1, "Syntax": "DEFAULT", "GopClosedCadence": 1, "AdaptiveQuantization": "HIGH", "EntropyEncoding": "CABAC", "InterlaceMode": "PROGRESSIVE", "ParControl": "INITIALIZE_FROM_SOURCE", "NumberBFramesBetweenReferenceFrames": 2, "GopSizeUnits": "FRAMES", "RepeatPps": "DISABLED", "CodecProfile": "MAIN", "FieldEncoding": "PAFF", "GopSize": 90.0, "SlowPal": "DISABLED", "SceneChangeDetect": "ENABLED", "GopBReference": "DISABLED", "RateControlMode": "CBR", "FramerateConversionAlgorithm": "DUPLICATE_DROP", "FlickerAdaptiveQuantization": "DISABLED", "DynamicSubGop": "STATIC", "MinIInterval": 0, "TemporalAdaptiveQuantization": "ENABLED", "Bitrate": 400000, "NumberReferenceFrames": 3 }, "Codec": "H_264" }, "AfdSignaling": "NONE", "AntiAlias": "ENABLED", "ScalingBehavior": "DEFAULT", "DropFrameTimecode": "ENABLED" } }, "Type": "CUSTOM", "CreatedAt": 1568841521 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) im *AWS Elemental User Guide MediaConvert *. + *Einzelheiten zur API finden Sie [GetPreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-preset.html)in AWS CLI der Befehlsreferenz.* ### `get-queue` Das folgende Codebeispiel zeigt die Verwendung`get-queue`. **AWS CLI** **So rufen Sie Details für eine Warteschlange ab** Im folgenden Beispiel für `get-queue` werden Details zur angegebenen benutzerdefinierten Warteschlange abgerufen. ``` aws mediaconvert get-queue \ --name Customer1 \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Ausgabe: ``` { "Queue": { "LastUpdated": 1526428502, "Type": "CUSTOM", "SubmittedJobsCount": 0, "Status": "ACTIVE", "PricingPlan": "ON_DEMAND", "CreatedAt": 1526428502, "ProgressingJobsCount": 0, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Customer1", "Name": "Customer1" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) im *AWS Elemental User Guide MediaConvert *. + *Einzelheiten zur API finden Sie [GetQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-queue.html)in AWS CLI der Befehlsreferenz.* ### `list-job-templates` Das folgende Codebeispiel zeigt die Verwendung`list-job-templates`. **AWS CLI** **Beispiel 1: So listen Sie benutzerdefinierte Auftragsvorlagen auf** Im folgenden Beispiel für `list-job-templates` werden alle benutzerdefinierten Auftragsvorlagen in der aktuellen Region aufgelistet. Informationen zum Auflisten der Systemauftragsvorlagen finden Sie im nächsten Beispiel. ``` aws mediaconvert list-job-templates \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Ausgabe: ``` { "JobTemplates": [ { "Description": "Create a DASH streaming ABR stack", "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/DASH Streaming", "Name": "DASH Streaming", "LastUpdated": 1568653007, "Priority": 0, "Settings": { ...... }, "Type": "CUSTOM", "StatusUpdateInterval": "SECONDS_60", "CreatedAt": 1568653007 }, { "Description": "Create a high-res file", "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/File", "Name": "File", "LastUpdated": 1568653007, "Priority": 0, "Settings": { ...... }, "Type": "CUSTOM", "StatusUpdateInterval": "SECONDS_60", "CreatedAt": 1568653023 } ] } ``` **Beispiel 2: Um die MediaConvert System-Jobvorlagen aufzulisten** Im folgende Beispiel für `list-job-templates` werden alle Systemauftragsvorlagen aufgelistet. ``` aws mediaconvert list-job-templates \ --endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com \ --list-by SYSTEM ``` Ausgabe: ``` { "JobTemplates": [ { "CreatedAt": 1568321779, "Arn": "arn:aws:mediaconvert:us-east-1:123456789012:jobTemplates/System-Generic_Mp4_Hev1_Avc_Aac_Sdr_Qvbr", "Name": "System-Generic_Mp4_Hev1_Avc_Aac_Sdr_Qvbr", "Description": "GENERIC, MP4, AVC + HEV1(HEVC,SDR), AAC, SDR, QVBR", "Category": "GENERIC", "Settings": { "AdAvailOffset": 0, "OutputGroups": [ { "Outputs": [ { "Extension": "mp4", "Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1280x720p_30Hz_5Mbps_Qvbr_Vq9", "NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1280x720p_30Hz_5000Kbps_Qvbr_Vq9" }, { "Extension": "mp4", "Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1920x1080p_30Hz_10Mbps_Qvbr_Vq9", "NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1920x1080p_30Hz_10000Kbps_Qvbr_Vq9" }, { "Extension": "mp4", "Preset": "System-Generic_Sd_Mp4_Avc_Aac_16x9_Sdr_640x360p_30Hz_0.8Mbps_Qvbr_Vq7", "NameModifier": "_Generic_Sd_Mp4_Avc_Aac_16x9_Sdr_640x360p_30Hz_800Kbps_Qvbr_Vq7" }, { "Extension": "mp4", "Preset": "System-Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1280x720p_30Hz_4Mbps_Qvbr_Vq9", "NameModifier": "_Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1280x720p_30Hz_4000Kbps_Qvbr_Vq9" }, { "Extension": "mp4", "Preset": "System-Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1920x1080p_30Hz_8Mbps_Qvbr_Vq9", "NameModifier": "_Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1920x1080p_30Hz_8000Kbps_Qvbr_Vq9" }, { "Extension": "mp4", "Preset": "System-Generic_Uhd_Mp4_Hev1_Aac_16x9_Sdr_3840x2160p_30Hz_12Mbps_Qvbr_Vq9", "NameModifier": "_Generic_Uhd_Mp4_Hev1_Aac_16x9_Sdr_3840x2160p_30Hz_12000Kbps_Qvbr_Vq9" } ], "OutputGroupSettings": { "FileGroupSettings": { }, "Type": "FILE_GROUP_SETTINGS" }, "Name": "File Group" } ] }, "Type": "SYSTEM", "LastUpdated": 1568321779 }, ...... ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) im *AWS Elemental MediaConvert User Guide*. + Einzelheiten zur API finden Sie [ListJobTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-job-templates.html)in der *AWS CLI Befehlsreferenz*. ### `list-jobs` Das folgende Codebeispiel zeigt die Verwendung`list-jobs`. **AWS CLI** **So rufen Sie die Details für alle Aufträge in einer Region ab** Im folgenden Beispiel werden die Informationen für alle Aufträge in der angegebenen Region angefordert. ``` aws mediaconvert list-jobs \ --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ --region region-name-1 ``` Verwenden Sie `describe-endpoints` zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück. Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Jobs](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html) im *AWS MediaConvert Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-jobs.html)in der *AWS CLI Befehlsreferenz*. ### `list-presets` Das folgende Codebeispiel zeigt die Verwendung`list-presets`. **AWS CLI** **Beispiel 1: So listen Sie Ihre benutzerdefinierten Ausgabevoreinstellungen auf** Im folgenden Beispiel für `list-presets` werden die benutzerdefinierten Ausgabevoreinstellungen aufgelistet. Informationen zum Auflisten der Systemvoreinstellungen finden Sie im nächsten Beispiel. ``` aws mediaconvert list-presets \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Ausgabe: ``` { "Presets": [ { "Name": "SimpleMP4", "CreatedAt": 1568841521, "Settings": { ...... }, "Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleMP4", "Type": "CUSTOM", "LastUpdated": 1568843141, "Description": "Creates basic MP4 file. No filtering or preproccessing." }, { "Name": "SimpleTS", "CreatedAt": 1568843113, "Settings": { ... truncated for brevity ... }, "Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleTS", "Type": "CUSTOM", "LastUpdated": 1568843113, "Description": "Create a basic transport stream." } ] } ``` **Beispiel 2: So listen Sie die Systemausgabevoreinstellungen auf** Das folgende `list-presets` Beispiel listet die verfügbaren MediaConvert Systemvoreinstellungen auf. Informationen zum Auflisten der benutzerdefinierten Voreinstellungen finden Sie im vorherigen Beispiel. ``` aws mediaconvert list-presets \ --list-by SYSTEM \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Ausgabe: ``` { "Presets": [ { "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/System-Avc_16x9_1080p_29_97fps_8500kbps", "Name": "System-Avc_16x9_1080p_29_97fps_8500kbps", "CreatedAt": 1568321789, "Description": "Wifi, 1920x1080, 16:9, 29.97fps, 8500kbps", "LastUpdated": 1568321789, "Type": "SYSTEM", "Category": "HLS", "Settings": { ...... } }, ...... { "Arn": "arn:aws:mediaconvert:us-east-1:123456789012:presets/System-Xdcam_HD_1080i_29_97fps_35mpbs", "Name": "System-Xdcam_HD_1080i_29_97fps_35mpbs", "CreatedAt": 1568321790, "Description": "XDCAM MPEG HD, 1920x1080i, 29.97fps, 35mbps", "LastUpdated": 1568321790, "Type": "SYSTEM", "Category": "MXF", "Settings": { ...... } } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) im *AWS Elemental MediaConvert * User Guide. + *Einzelheiten zur API finden Sie [ListPresets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-presets.html)in AWS CLI der Befehlsreferenz.* ### `list-queues` Das folgende Codebeispiel zeigt die Verwendung`list-queues`. **AWS CLI** **So listen Sie die Warteschlangen auf** Das folgende `list-queues` Beispiel listet alle Ihre MediaConvert Warteschlangen auf. ``` aws mediaconvert list-queues \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Ausgabe: ``` { "Queues": [ { "PricingPlan": "ON_DEMAND", "Type": "SYSTEM", "Status": "ACTIVE", "CreatedAt": 1503451595, "Name": "Default", "SubmittedJobsCount": 0, "ProgressingJobsCount": 0, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Default", "LastUpdated": 1534549158 }, { "PricingPlan": "ON_DEMAND", "Type": "CUSTOM", "Status": "ACTIVE", "CreatedAt": 1537460025, "Name": "Customer1", "SubmittedJobsCount": 0, "Description": "Jobs we run for our cusotmer.", "ProgressingJobsCount": 0, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Customer1", "LastUpdated": 1537460025 }, { "ProgressingJobsCount": 0, "Status": "ACTIVE", "Name": "transcode-library", "SubmittedJobsCount": 0, "LastUpdated": 1564066204, "ReservationPlan": { "Status": "ACTIVE", "ReservedSlots": 1, "PurchasedAt": 1564066203, "Commitment": "ONE_YEAR", "ExpiresAt": 1595688603, "RenewalType": "EXPIRE" }, "PricingPlan": "RESERVED", "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/transcode-library", "Type": "CUSTOM", "CreatedAt": 1564066204 } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) im *AWS Elemental MediaConvert * User Guide. + *Einzelheiten zur API finden Sie [ListQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-queues.html)in AWS CLI der Befehlsreferenz.* ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **Um die Tags in einer MediaConvert Warteschlange, einer Jobvorlage oder einer Ausgabevoreinstellung aufzulisten** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für die angegebene Ausgabevoreinstellung aufgelistet. ``` aws mediaconvert list-tags-for-resource \ --arn arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4 \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Ausgabe: ``` { "ResourceTags": { "Tags": { "customer": "zippyVideo" }, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4" } } ``` *Weitere Informationen finden Sie unter [Tagging AWS Elemental MediaConvert Queues, Job Templates und Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-queues-templates-presets.html) im AWS Elemental User Guide. MediaConvert * + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-tags-for-resource.html)AWS CLI * ### `update-job-template` Das folgende Codebeispiel zeigt die Verwendung`update-job-template`. **AWS CLI** **So erstellen Sie eine Änderungsvorlage** Im folgenden Beispiel für `update-job-template` wird die JSON-Definition der angegebenen benutzerdefinierten Auftragsvorlage durch die JSON-Definition in der bereitgestellten Datei ersetzt. aws mediaconvert update-job-template --name File1 https://abcd1234.mediaconvert.us-west-2.amazonaws.com --endpoint-url -- file: //\$1/ .json cli-input-json job-template-update Inhalt von `job-template-update.json`: ``` { "Description": "A simple job template that generates a single file output.", "Queue": "arn:aws:mediaconvert:us-east-1:012345678998:queues/Default", "Name": "SimpleFile", "Settings": { "OutputGroups": [ { "Name": "File Group", "Outputs": [ { "ContainerSettings": { "Container": "MP4", "Mp4Settings": { "CslgAtom": "INCLUDE", "FreeSpaceBox": "EXCLUDE", "MoovPlacement": "PROGRESSIVE_DOWNLOAD" } }, "VideoDescription": { "ScalingBehavior": "DEFAULT", "TimecodeInsertion": "DISABLED", "AntiAlias": "ENABLED", "Sharpness": 50, "CodecSettings": { "Codec": "H_264", "H264Settings": { "InterlaceMode": "PROGRESSIVE", "NumberReferenceFrames": 3, "Syntax": "DEFAULT", "Softness": 0, "GopClosedCadence": 1, "GopSize": 90, "Slices": 1, "GopBReference": "DISABLED", "SlowPal": "DISABLED", "SpatialAdaptiveQuantization": "ENABLED", "TemporalAdaptiveQuantization": "ENABLED", "FlickerAdaptiveQuantization": "DISABLED", "EntropyEncoding": "CABAC", "Bitrate": 400000, "FramerateControl": "INITIALIZE_FROM_SOURCE", "RateControlMode": "CBR", "CodecProfile": "MAIN", "Telecine": "NONE", "MinIInterval": 0, "AdaptiveQuantization": "HIGH", "CodecLevel": "AUTO", "FieldEncoding": "PAFF", "SceneChangeDetect": "ENABLED", "QualityTuningLevel": "SINGLE_PASS", "FramerateConversionAlgorithm": "DUPLICATE_DROP", "UnregisteredSeiTimecode": "DISABLED", "GopSizeUnits": "FRAMES", "ParControl": "INITIALIZE_FROM_SOURCE", "NumberBFramesBetweenReferenceFrames": 2, "RepeatPps": "DISABLED", "DynamicSubGop": "STATIC" } }, "AfdSignaling": "NONE", "DropFrameTimecode": "ENABLED", "RespondToAfd": "NONE", "ColorMetadata": "INSERT" }, "AudioDescriptions": [ { "AudioTypeControl": "FOLLOW_INPUT", "CodecSettings": { "Codec": "AAC", "AacSettings": { "AudioDescriptionBroadcasterMix": "NORMAL", "Bitrate": 96000, "RateControlMode": "CBR", "CodecProfile": "LC", "CodingMode": "CODING_MODE_2_0", "RawFormat": "NONE", "SampleRate": 48000, "Specification": "MPEG4" } }, "LanguageCodeControl": "FOLLOW_INPUT" } ] } ], "OutputGroupSettings": { "Type": "FILE_GROUP_SETTINGS", "FileGroupSettings": {} } } ], "AdAvailOffset": 0 }, "StatusUpdateInterval": "SECONDS_60", "Priority": 0 } ``` Das System gibt die JSON-Nutzdaten zurück, die Sie mit der Anfrage senden, auch wenn die Anfrage zu einem Fehler führt. Daher entspricht das zurückgegebene JSON nicht unbedingt der neuen Definition der Auftragsvorlage. Da die JSON-Nutzdaten umfangreich sein können, müssen Sie möglicherweise nach oben scrollen, um Fehlermeldungen zu sehen. Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html) im *AWS Elemental MediaConvert User Guide*. + Einzelheiten zur API finden Sie [UpdateJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-job-template.html)in der *AWS CLI Befehlsreferenz*. ### `update-preset` Das folgende Codebeispiel zeigt die Verwendung`update-preset`. **AWS CLI** **So ändern Sie eine Voreinstellung** Im folgenden Beispiel für `update-preset` wird die Beschreibung der angegebenen Ressourcengruppe aktualisiert. ``` aws mediaconvert update-preset \ --name Customer1 \ --description "New description text." --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { "Preset": { "Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleMP4", "Settings": { ...... }, "Type": "CUSTOM", "LastUpdated": 1568938411, "Description": "New description text.", "Name": "SimpleMP4", "CreatedAt": 1568938240 } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html) im *AWS Elemental User Guide MediaConvert *. + *Einzelheiten zur API finden Sie [UpdatePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-preset.html)in AWS CLI der Befehlsreferenz.* ### `update-queue` Das folgende Codebeispiel zeigt die Verwendung`update-queue`. **AWS CLI** **So ändern Sie eine Warteschlange** Im folgenden Beispiel für `update-queue` wird die angegebene Warteschlange angehalten, indem ihr Status in `PAUSED` geändert wird. ``` aws mediaconvert update-queue \ --name Customer1 \ --status PAUSED --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` Ausgabe: ``` { "Queue": { "LastUpdated": 1568839845, "Status": "PAUSED", "ProgressingJobsCount": 0, "CreatedAt": 1526428516, "Arn": "arn:aws:mediaconvert:us-west-1:123456789012:queues/Customer1", "Name": "Customer1", "SubmittedJobsCount": 0, "PricingPlan": "ON_DEMAND", "Type": "CUSTOM" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html) im *AWS Elemental User Guide MediaConvert *. + *Einzelheiten zur API finden Sie [UpdateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-queue.html)in AWS CLI der Befehlsreferenz.* # MediaLive Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren MediaLive. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-channel` Das folgende Codebeispiel zeigt, wie Sie`create-channel`. **AWS CLI** **So erstellen Sie einen Kanal** Im folgenden Beispiel für `create-channel` wird ein Kanal durch Übergabe einer JSON-Datei erstellt, die die Parameter enthält, die Sie angeben möchten. Der Kanal in diesem Beispiel nimmt eine HLS-PULL-Eingabe auf, die eine Verbindung zu einer Quelle herstellt, die Video, Audio und eingebettete Untertitel enthält. Der Kanal erstellt eine HLS-Ausgabegruppe mit einem Akamai-Server als Ziel. Die Ausgabegruppe enthält zwei Ausgaben: eine für H.265-Video und AAC-Audio und einen für die Web-VTT-Untertitel, nur in englischer Sprache. Die JSON-Datei für diesen Beispielkanal enthält die mindestens erforderlichen Parameter für einen Kanal, der eine HLS-PULL-Eingabe verwendet und eine HLS-Ausgabegruppe mit Akamai als Ziel erzeugt. Die JSON-Datei enthält die folgenden Hauptabschnitte: `InputAttachments`: gibt eine Quelle für die Audiodaten und eine Quelle für die Untertitel an. Es gibt keinen Videoauswahlschalter an, was bedeutet, dass das erste Video MediaLive extrahiert wird, das in der Quelle gefunden wird. `Destinations`, das die beiden IP-Adressen (URLs) für die einzelne Ausgangsgruppe in diesem Kanal enthält. Für diese Adressen sind Kennwörter erforderlich. `EncoderSettings`, das Unterabschnitte enthält. `AudioDescriptions`, was angibt, dass der Kanal ein Audioausgabe-Asset enthält, das die Quelle verwendet und Audio im AAC-Format erzeugt. InputAttachments `CaptionDescriptions`, was angibt, dass der Kanal ein Untertitelausgabe-Asset enthält, das die Quelle verwendet und Untertitel im InputAttachments Web-VTT-Format erzeugt. `VideoDescriptions`, was angibt, dass der Kanal ein Videoausgabe-Asset mit der angegebenen Auflösung enthält. `OutputGroups`, das die Ausgangsgruppen spezifiziert. In diesem Beispiel gibt es eine Gruppe mit dem Namen `Akamai`. Die Verbindung wird mit HLS PUT hergestellt. Die HLS-Ausgabegruppe enthält zwei Ausgaben. Eine Ausgabe ist für die Video-Komponente (mit dem Namen `Video_high`) und die Audio-Komponente (mit dem Namen `Audio_EN`) vorgesehen. Eine Ausgabe ist für die Untertitel-Komponente (mit dem Namen `WebVTT_EN`) vorgesehen. In diesem Beispiel enthalten einige Parameter keinen Wert oder verschachtelte leere Parameter. OutputSettings Beispielsweise, weil die `Video_and_audio` Ausgabe mehrere verschachtelte Parameter enthält, die mit einem leeren Parameter M3U8Settings enden. Dieser Parameter muss enthalten sein, aber Sie können eines, mehrere oder alle untergeordneten Elemente weglassen, was bedeutet, dass das untergeordnete Element seinen Standardwert oder den Wert Null annimmt. Alle Parameter, die für diesen Beispielkanal gelten, aber nicht in dieser Datei angegeben sind, nehmen entweder den Standardwert an, werden auf Null gesetzt oder nehmen einen eindeutigen Wert an, der von generiert wird. MediaLive ``` aws medialive create-channel \ --cli-input-json file://channel-in-hls-out-hls-akamai.json ``` Inhalt von `channel-in-hls-out-hls-akamai.json`: ``` { "Name": "News_West", "RoleArn": "arn:aws:iam::111122223333:role/MediaLiveAccessRole", "InputAttachments": [ { "InputAttachmentName": "local_news", "InputId": "1234567", "InputSettings": { "AudioSelectors": [ { "Name": "English-Audio", "SelectorSettings": { "AudioLanguageSelection": { "LanguageCode": "EN" } } } ], "CaptionSelectors": [ { "LanguageCode": "ENE", "Name": "English_embedded" } ] } } ], "Destinations": [ { "Id": "akamai-server-west", "Settings": [ { "PasswordParam": "/medialive/examplecorp1", "Url": "http://203.0.113.55/news/news_west", "Username": "examplecorp" }, { "PasswordParam": "/medialive/examplecorp2", "Url": "http://203.0.113.82/news/news_west", "Username": "examplecorp" } ] } ], "EncoderSettings": { "AudioDescriptions": [ { "AudioSelectorName": "English-Audio", "CodecSettings": { "AacSettings": {} }, "Name": "Audio_EN" } ], "CaptionDescriptions": [ { "CaptionSelectorName": "English_embedded", "DestinationSettings": { "WebvttDestinationSettings": {} }, "Name": "WebVTT_EN" } ], "VideoDescriptions": [ { "Height": 720, "Name": "Video_high", "Width": 1280 } ], "OutputGroups": [ { "Name": "Akamai", "OutputGroupSettings": { "HlsGroupSettings": { "Destination": { "DestinationRefId": "akamai-server-west" }, "HlsCdnSettings": { "HlsBasicPutSettings": {} } } }, "Outputs": [ { "AudioDescriptionNames": [ "Audio_EN" ], "OutputName": "Video_and_audio", "OutputSettings": { "HlsOutputSettings": { "HlsSettings": { "StandardHlsSettings": { "M3u8Settings": {} } }, "NameModifier": "_1" } }, "VideoDescriptionName": "Video_high" }, { "CaptionDescriptionNames": [ "WebVTT_EN" ], "OutputName": "Captions-WebVTT", "OutputSettings": { "HlsOutputSettings": { "HlsSettings": { "StandardHlsSettings": { "M3u8Settings": {} } }, "NameModifier": "_2" } } } ] } ], "TimecodeConfig": { "Source": "EMBEDDED" } } } ``` **Ausgabe:** Die Ausgabe wiederholt den Inhalt der JSON-Datei sowie die folgenden Werte. Alle Parameter sind alphabetisch geordnet. `ARN` für den Kanal. Der letzte Teil des ARN ist die eindeutige Kanal-ID. Der Wert für `EgressEndpoints` ist in diesem Beispielkanal leer, da er nur für PUSH-Eingaben verwendet wird. Wenn es zutrifft, werden die Adressen angezeigt MediaLive , an die der Inhalt gesendet wurde. `OutputGroups`,`Outputs`. Diese enthalten alle Parameter für die Ausgabegruppe und die Ausgaben, einschließlich der Parameter, die nicht eingezogen wurden, aber für diesen Kanal relevant sind. Die Parameter sind möglicherweise leer (was darauf hindeutet, dass der Parameter oder das Feature in dieser Kanalkonfiguration deaktiviert ist) oder sie entsprechen dem Standardwert. `LogLevel` ist auf den Standardwert (DEAKTIVIERT) eingestellt. `Tags` ist auf den Standardwert (Null) eingestellt. `PipelinesRunningCount` und `State` zeigen den aktuellen Status des Kanals an. Weitere Informationen finden Sie unter [Einen Kanal von Grund auf neu erstellen](https://docs.aws.amazon.com/medialive/latest/ug/creating-channel-scratch.html) im *AWS MediaLive Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medialive/create-channel.html)in der *AWS CLI Befehlsreferenz.* ### `create-input` Das folgende Codebeispiel zeigt die Verwendung`create-input`. **AWS CLI** **So erstellen Sie eine Eingabe** Im folgenden Beispiel für `create-input` wird eine `HLS PULL`-Eingabe durch Übergabe einer JSON-Datei erstellt, die die Parameter enthält, die für diese Art von Eingabe gelten. In der JSON-Datei für diese Beispieleingabe werden zwei Quellen (Adressen) für die Eingabe angegeben, um Redundanz bei der Aufnahme zu unterstützen. Für diese Adressen sind Passwörter erforderlich. ``` aws medialive create-input \ --cli-input-json file://input-hls-pull-news.json ``` Inhalt von `input-hls-pull-news.json`: ``` { "Name": "local_news", "RequestId": "cli000059", "Sources": [ { "Url": "https://203.0.113.13/newschannel/anytownusa.m3u8", "Username": "examplecorp", "PasswordParam": "/medialive/examplecorp1" }, { "Url": "https://198.51.100.54/fillervideos/oceanwaves.mp4", "Username": "examplecorp", "PasswordParam": "examplecorp2" } ], "Type": "URL_PULL" } ``` **Ausgabe:** Die Ausgabe wiederholt den Inhalt der JSON-Datei sowie die folgenden Werte. Alle Parameter sind alphabetisch geordnet. `Arn` für die Eingabe. Der letzte Teil des ARN ist die eindeutige Eingabe-ID. `Attached Channels`, der für eine neu erstellte Eingabe immer leer ist. `Destinations`, das in diesem Beispiel leer ist, weil es nur mit einer PUSH-Eingabe verwendet wird. `Id`für die Eingabe entspricht der ID im ARN. `MediaConnectFlows`, das in diesem Beispiel leer ist, weil es nur mit einer Eingabe vom Typ verwendet wird MediaConnect. `SecurityGroups`, das in diesem Beispiel leer ist, weil es nur mit einer PUSH-Eingabe verwendet wird. `State`dieser Eingabe. `Tags`, das leer ist (die Standardeinstellung für diesen Parameter). Weitere Informationen finden Sie unter [Eingabe erstellen](https://docs.aws.amazon.com/medialive/latest/ug/create-input.html) im *AWS Elemental MediaLive User Guide*. + Einzelheiten zur API finden Sie unter [CreateInput AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medialive/create-input.html)*Befehlsreferenz.* # MediaPackage Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren MediaPackage. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-channel` Das folgende Codebeispiel zeigt, wie Sie`create-channel`. **AWS CLI** **So erstellen Sie einen Kanal** Mit dem folgenden `create-channel`-Befehl wird im aktuellen Konto ein Kanal mit dem Namen `sportschannel` erstellt. ``` aws mediapackage create-channel --id sportschannel ``` Ausgabe: ``` { "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0", "HlsIngest": { "IngestEndpoints": [ { "Id": "6d345804ec3f46c9b454a91d4a80d0e0", "Password": "generatedwebdavpassword1", "Url": "https://f31c86aed53b815a.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/6d345804ec3f46c9b454a91d4a80d0e0/channel", "Username": "generatedwebdavusername1" }, { "Id": "2daa32878af24803b24183727211b8ff", "Password": "generatedwebdavpassword2", "Url": "https://6ebbe7e04c4b0afa.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/2daa32878af24803b24183727211b8ff/channel", "Username": "generatedwebdavusername2" } ] }, "Id": "sportschannel", "Tags": { "region": "west" } } ``` Weitere Informationen finden Sie unter [Einen Kanal erstellen](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-create.html) im *AWS MediaPackage Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [CreateChannel AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/create-channel.html)*Befehlsreferenz.* ### `create-origin-endpoint` Das folgende Codebeispiel zeigt die Verwendung`create-origin-endpoint`. **AWS CLI** **So erstellen Sie einen Ursprungsendpunkt** Mit dem folgenden `create-origin-endpoint`-Befehl wird ein Ursprungsendpunkt mit dem Namen `cmafsports`, den in einer JSON-Datei bereitgestellten Paketeinstellungen und den angegebenen Endpunkteinstellungen erstellt. ``` aws mediapackage create-origin-endpoint \ --channel-id sportschannel \ --id cmafsports \ --cmaf-package file://file/path/cmafpkg.json --description "cmaf output of sports" \ --id cmaf_sports \ --manifest-name sports_channel \ --startover-window-seconds 300 \ --tags region=west,media=sports \ --time-delay-seconds 10 ``` Ausgabe: ``` { "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6", "ChannelId": "sportschannel", "CmafPackage": { "HlsManifests": [ { "AdMarkers": "PASSTHROUGH", "Id": "cmaf_sports_endpoint", "IncludeIframeOnlyStream": true, "ManifestName": "index", "PlaylistType": "EVENT", "PlaylistWindowSeconds": 300, "ProgramDateTimeIntervalSeconds": 300, "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8" } ], "SegmentDurationSeconds": 2, "SegmentPrefix": "sportschannel" }, "Description": "cmaf output of sports", "Id": "cmaf_sports", "ManifestName": "sports_channel", "StartoverWindowSeconds": 300, "Tags": { "region": "west", "media": "sports" }, "TimeDelaySeconds": 10, "Url": "", "Whitelist": [] } ``` Weitere Informationen finden Sie unter [Erstellen eines Endpunkts](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-create.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [CreateOriginEndpoint AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/create-origin-endpoint.html)*Befehlsreferenz.* ### `delete-channel` Das folgende Codebeispiel zeigt die Verwendung`delete-channel`. **AWS CLI** **So löschen Sie einen Kanal** Mit dem folgenden `delete-channel`-Befehl wird der Kanal mit dem Namen `test` gelöscht. ``` aws mediapackage delete-channel \ --id test ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Kanals](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-delete.html) im *AWS MediaPackage Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/delete-channel.html)in der *AWS CLI Befehlsreferenz.* ### `delete-origin-endpoint` Das folgende Codebeispiel zeigt die Verwendung`delete-origin-endpoint`. **AWS CLI** **So löschen Sie einen Ursprungsendpunkt** Mit dem folgenden `delete-origin-endpoint`-Befehl wird der Ursprungsendpunkt mit dem Namen `tester2` gelöscht. ``` aws mediapackage delete-origin-endpoint \ --id tester2 ``` Weitere Informationen finden Sie unter [Löschen eines Endpunkts](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-delete.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [DeleteOriginEndpoint AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/delete-origin-endpoint.html)*Befehlsreferenz.* ### `describe-channel` Das folgende Codebeispiel zeigt die Verwendung`describe-channel`. **AWS CLI** **So beschreiben Sie einen Kanal** Mit dem folgenden `describe-channel`-Befehl werden alle Details des Kanals mit dem Namen `test` angezeigt. ``` aws mediapackage describe-channel \ --id test ``` Ausgabe: ``` { "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63", "HlsIngest": { "IngestEndpoints": [ { "Id": "584797f1740548c389a273585dd22a63", "Password": "webdavgeneratedpassword1", "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel", "Username": "webdavgeneratedusername1" }, { "Id": "7d187c8616fd455f88aaa5a9fcf74442", "Password": "webdavgeneratedpassword2", "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel", "Username": "webdavgeneratedusername2" } ] }, "Id": "test", "Tags": {} } ``` *Weitere Informationen finden Sie unter Kanaldetails anzeigen< https://docs.aws.amazon.com/mediapackage/ latest/ug/channels -view.html> im Elemental User Guide AWS MediaPackage * + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DescribeChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/describe-channel.html)AWS CLI * ### `describe-origin-endpoint` Das folgende Codebeispiel zeigt die Verwendung`describe-origin-endpoint`. **AWS CLI** **So beschreiben Sie einen Ursprungsendpunkt** Mit dem folgenden `describe-origin-endpoint`-Befehl werden alle Details des Ursprungsendpunkts mit dem Namen `cmaf_sports` angezeigt. ``` aws mediapackage describe-origin-endpoint \ --id cmaf_sports ``` Ausgabe: ``` { "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6", "ChannelId": "sportschannel", "CmafPackage": { "HlsManifests": [ { "AdMarkers": "NONE", "Id": "cmaf_sports_endpoint", "IncludeIframeOnlyStream": false, "PlaylistType": "EVENT", "PlaylistWindowSeconds": 60, "ProgramDateTimeIntervalSeconds": 0, "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8" } ], "SegmentDurationSeconds": 2, "SegmentPrefix": "sportschannel" }, "Id": "cmaf_sports", "ManifestName": "index", "StartoverWindowSeconds": 0, "Tags": { "region": "west", "media": "sports" }, "TimeDelaySeconds": 0, "Url": "", "Whitelist": [] } ``` Weitere Informationen finden Sie unter [Einen einzelnen Endpunkt anzeigen](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-view-one.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [DescribeOriginEndpoint AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/describe-origin-endpoint.html)*Befehlsreferenz.* ### `list-channels` Das folgende Codebeispiel zeigt die Verwendung`list-channels`. **AWS CLI** **So listen Sie alle Kanäle auf** Der folgende `list-channels` Befehl listet alle Kanäle auf, die für das aktuelle AWS Konto konfiguriert sind. ``` aws mediapackage list-channels ``` Ausgabe: ``` { "Channels": [ { "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63", "HlsIngest": { "IngestEndpoints": [ { "Id": "584797f1740548c389a273585dd22a63", "Password": "webdavgeneratedpassword1", "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel", "Username": "webdavgeneratedusername1" }, { "Id": "7d187c8616fd455f88aaa5a9fcf74442", "Password": "webdavgeneratedpassword2", "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel", "Username": "webdavgeneratedusername2" } ] }, "Id": "test", "Tags": {} } ] } ``` Weitere Informationen finden Sie unter [Kanaldetails anzeigen](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-view.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [ListChannels AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-channels.html)*Befehlsreferenz.* ### `list-origin-endpoints` Das folgende Codebeispiel zeigt die Verwendung`list-origin-endpoints`. **AWS CLI** **So listen Sie Ursprungsendpunkte in einem Kanal auf** Mit dem folgenden `list-origin-endpoints`-Befehl werden alle Ursprungsendpunkte aufgelistet, die für den aktuellen Kanal mit dem Namen `test` konfiguriert sind. ``` aws mediapackage list-origin-endpoints \ --channel-id test ``` Ausgabe: ``` { "OriginEndpoints": [ { "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/247cff871f2845d3805129be22f2c0a2", "ChannelId": "test", "DashPackage": { "ManifestLayout": "FULL", "ManifestWindowSeconds": 60, "MinBufferTimeSeconds": 30, "MinUpdatePeriodSeconds": 15, "PeriodTriggers": [], "Profile": "NONE", "SegmentDurationSeconds": 2, "SegmentTemplateFormat": "NUMBER_WITH_TIMELINE", "StreamSelection": { "MaxVideoBitsPerSecond": 2147483647, "MinVideoBitsPerSecond": 0, "StreamOrder": "ORIGINAL" }, "SuggestedPresentationDelaySeconds": 25 }, "Id": "tester2", "ManifestName": "index", "StartoverWindowSeconds": 0, "Tags": {}, "TimeDelaySeconds": 0, "Url": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/247cff871f2845d3805129be22f2c0a2/index.mpd", "Whitelist": [] }, { "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/869e237f851549e9bcf10e3bc2830839", "ChannelId": "test", "HlsPackage": { "AdMarkers": "NONE", "IncludeIframeOnlyStream": false, "PlaylistType": "EVENT", "PlaylistWindowSeconds": 60, "ProgramDateTimeIntervalSeconds": 0, "SegmentDurationSeconds": 6, "StreamSelection": { "MaxVideoBitsPerSecond": 2147483647, "MinVideoBitsPerSecond": 0, "StreamOrder": "ORIGINAL" }, "UseAudioRenditionGroup": false }, "Id": "tester", "ManifestName": "index", "StartoverWindowSeconds": 0, "Tags": {}, "TimeDelaySeconds": 0, "Url": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/869e237f851549e9bcf10e3bc2830839/index.m3u8", "Whitelist": [] } ] } ``` Weitere Informationen finden Sie im *AWS Elemental MediaPackage User* Guide unter [Alle Endpoints anzeigen, die einem Channel zugeordnet](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-view-all.html) sind. + Einzelheiten zur API finden Sie unter [ListOriginEndpoints AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-origin-endpoints.html)*Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags auf, die einer Ressource zugewiesen sind** Mit dem folgenden `list-tags-for-resource`-Befehl werden die Tags aufgelistet, die der angegebenen Ressource zugewiesen sind. ``` aws mediapackage list-tags-for-resource \ --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 ``` Ausgabe: ``` { "Tags": { "region": "west" } } ``` Weitere Informationen finden Sie unter [Tagging Resources in AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) im *AWS Elemental User Guide MediaPackage *. + *Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-tags-for-resource.html)in AWS CLI der Befehlsreferenz.* ### `rotate-ingest-endpoint-credentials` Das folgende Codebeispiel zeigt die Verwendung`rotate-ingest-endpoint-credentials`. **AWS CLI** **So rotieren Sie die Ingest-Anmeldeinformationen** Mit dem folgenden `rotate-ingest-endpoint-credentials`-Befehl werden der WebDAV-Benutzername und das WebDAV-Kennwort für den angegebenen Ingest-Endpunkt rotiert. ``` aws mediapackage rotate-ingest-endpoint-credentials \ --id test \ --ingest-endpoint-id 584797f1740548c389a273585dd22a63 ``` Ausgabe: ``` { "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63", "HlsIngest": { "IngestEndpoints": [ { "Id": "584797f1740548c389a273585dd22a63", "Password": "webdavregeneratedpassword1", "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel", "Username": "webdavregeneratedusername1" }, { "Id": "7d187c8616fd455f88aaa5a9fcf74442", "Password": "webdavgeneratedpassword2", "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel", "Username": "webdavgeneratedusername2" } ] }, "Id": "test", "Tags": {} } ``` Weitere Informationen finden Sie unter [Rotation von Anmeldeinformationen auf einer Eingabe-URL](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-rotate-creds) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [RotateIngestEndpointCredentials AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/rotate-ingest-endpoint-credentials.html)*Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer Ressource ein Tag hinzu** Mit den folgenden `tag-resource`-Befehlen wird der angegebenen Ressource ein Schlüssel-Wert-Paar für `region=west` hinzugefügt. ``` aws mediapackage tag-resource \ --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \ --tags region=west ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Tagging Resources in AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) im *AWS Elemental User Guide MediaPackage *. + *Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/tag-resource.html)in AWS CLI der Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einer Ressource** Mit dem folgenden `untag-resource`-Befehl wird das Tag mit dem Schlüssel `region` aus dem angegebenen Kanal entfernt. ``` aws mediapackage untag-resource \ --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \ --tag-keys region ``` Weitere Informationen finden Sie unter [Tagging Resources in AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) im *AWS Elemental User Guide MediaPackage *. + *Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/untag-resource.html)in AWS CLI der Befehlsreferenz.* ### `update-channel` Das folgende Codebeispiel zeigt die Verwendung`update-channel`. **AWS CLI** **So aktualisieren Sie einen Kanal** Mit dem folgenden `update-channel`-Befehl wird der Kanal mit dem Namen `sportschannel` durch die Beschreibung `24x7 sports` aktualisiert. ``` aws mediapackage update-channel \ --id sportschannel \ --description "24x7 sports" ``` Ausgabe: ``` { "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0", "Description": "24x7 sports", "HlsIngest": { "IngestEndpoints": [ { "Id": "6d345804ec3f46c9b454a91d4a80d0e0", "Password": "generatedwebdavpassword1", "Url": "https://f31c86aed53b815a.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/6d345804ec3f46c9b454a91d4a80d0e0/channel", "Username": "generatedwebdavusername1" }, { "Id": "2daa32878af24803b24183727211b8ff", "Password": "generatedwebdavpassword2", "Url": "https://6ebbe7e04c4b0afa.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/2daa32878af24803b24183727211b8ff/channel", "Username": "generatedwebdavusername2" } ] }, "Id": "sportschannel", "Tags": {} } ``` Weitere Informationen finden Sie unter [Bearbeiten eines Kanals](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-edit.html) im *AWS MediaPackage Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/update-channel.html)in der *AWS CLI Befehlsreferenz.* ### `update-origin-endpoint` Das folgende Codebeispiel zeigt die Verwendung`update-origin-endpoint`. **AWS CLI** **So aktualisieren Sie einen Ursprungsendpunkt** Mit dem folgenden `update-origin-endpoint`-Befehl wird der Ursprungsendpunkt mit dem Namen `cmaf_sports` aktualisiert. Die Zeitverzögerung wird in `0` Sekunden geändert. ``` aws mediapackage update-origin-endpoint \ --id cmaf_sports \ --time-delay-seconds 0 ``` Ausgabe: ``` { "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6", "ChannelId": "sportschannel", "CmafPackage": { "HlsManifests": [ { "AdMarkers": "NONE", "Id": "cmaf_sports_endpoint", "IncludeIframeOnlyStream": false, "PlaylistType": "EVENT", "PlaylistWindowSeconds": 60, "ProgramDateTimeIntervalSeconds": 0, "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8" } ], "SegmentDurationSeconds": 2, "SegmentPrefix": "sportschannel" }, "Id": "cmaf_sports", "ManifestName": "index", "StartoverWindowSeconds": 0, "Tags": { "region": "west", "media": "sports" }, "TimeDelaySeconds": 0, "Url": "", "Whitelist": [] } ``` Weitere Informationen finden Sie unter [Bearbeiten eines Endpunkts](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-edit.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [UpdateOriginEndpoint AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/update-origin-endpoint.html)*Befehlsreferenz.* # MediaPackage VOD-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface mit MediaPackage VOD Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-asset` Das folgende Codebeispiel zeigt, wie Sie`create-asset`. **AWS CLI** **So erstellen Sie eine Komponente** Im folgenden `create-asset` Beispiel wird ein Asset mit dem Namen des `Chicken_Asset` AWS Girokontos erstellt. Das Asset nimmt die Datei `30sec_chicken.smil` auf MediaPackage. ``` aws mediapackage-vod create-asset \ --id chicken_asset \ --packaging-group-id hls_chicken_gp \ --source-role-arn arn:aws:iam::111122223333:role/EMP_Vod \ --source-arn arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil ``` Ausgabe: ``` { "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:assets/chicken_asset", "Id":"chicken_asset", "PackagingGroupId":"hls_chicken_gp", "SourceArn":"arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil", "SourceRoleArn":"arn:aws:iam::111122223333:role/EMP_Vod", "EgressEndpoints":[ { "PackagingConfigurationId":"New_config_1", "Url":"https://c75ea2668ab49d02bca7ae10ef31c59e.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/6644b55df1744261ab3732a8e5cdaf07/904b06a58c7645e08d57d40d064216ac/f5b2e633ff4942228095d164c10074f3/index.m3u8" }, { "PackagingConfigurationId":"new_hls", "Url":" https://c75ea2668ab49d02bca7ae10ef31c59e.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/6644b55df1744261ab3732a8e5cdaf07/fe8f1f00a80e424cb4f8da4095835e9e/7370ec57432343af816332356d2bd5c6/string.m3u8" } ] } ``` Weitere Informationen finden Sie unter [Ein Asset aufnehmen](https://docs.aws.amazon.com/mediapackage/latest/ug/asset-create.html) im *AWS Elemental-Benutzerhandbuch. MediaPackage * + Einzelheiten zur API finden Sie [CreateAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/create-asset.html)in der *AWS CLI Befehlsreferenz*. ### `create-packaging-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-packaging-configuration`. **AWS CLI** **So erstellen Sie eine Packaging-Konfiguration** Im folgenden Beispiel für `create-packaging-configuration` wird eine Packaging-Konfiguration mit dem Namen `new_hls` in der angegebenen Packaging-Gruppe `hls_chicken` erstellt. In diesem Beispiel wird eine Datei auf der Festplatte mit dem Namen `hls_pc.json` verwendet, um die Details bereitzustellen. ``` aws mediapackage-vod create-packaging-configuration \ --id new_hls \ --packaging-group-id hls_chicken \ --hls-package file://hls_pc.json ``` Inhalt von `hls_pc.json`: ``` { "HlsManifests":[ { "AdMarkers":"NONE", "IncludeIframeOnlyStream":false, "ManifestName":"string", "ProgramDateTimeIntervalSeconds":60, "RepeatExtXKey":true, "StreamSelection":{ "MaxVideoBitsPerSecond":1000, "MinVideoBitsPerSecond":0, "StreamOrder":"ORIGINAL" } } ], "SegmentDurationSeconds":6, "UseAudioRenditionGroup":false } ``` Ausgabe: ``` { "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/new_hls", "Id":"new_hls", "PackagingGroupId":"hls_chicken", "HlsManifests":{ "SegmentDurationSeconds":6, "UseAudioRenditionGroup":false, "HlsMarkers":[ { "AdMarkers":"NONE", "IncludeIframeOnlyStream":false, "ManifestName":"string", "ProgramDateTimeIntervalSeconds":60, "RepeatExtXKey":true, "StreamSelection":{ "MaxVideoBitsPerSecond":1000, "MinVideoBitsPerSecond":0, "StreamOrder":"ORIGINAL" } } ] } } ``` Weitere Informationen finden Sie unter [Creating a Packaging Configuration](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-cfig-create.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [CreatePackagingConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/create-packaging-configuration.html)*Befehlsreferenz.* ### `create-packaging-group` Das folgende Codebeispiel zeigt die Verwendung`create-packaging-group`. **AWS CLI** **So erstellen Sie eine Packaging-Gruppe** Das folgende `create-packaging-group` Beispiel listet alle Verpackungsgruppen auf, die im aktuellen AWS Konto konfiguriert sind. ``` aws mediapackage-vod create-packaging-group \ --id hls_chicken ``` Ausgabe: ``` { "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/hls_chicken", "Id": "hls_chicken" } ``` Weitere Informationen finden Sie im *AWS Elemental MediaPackage User Guide* unter [Creating a Packaging Group](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-group-create.html). + Einzelheiten zur API finden Sie unter [CreatePackagingGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/create-packaging-group.html)*Befehlsreferenz.* ### `delete-asset` Das folgende Codebeispiel zeigt die Verwendung`delete-asset`. **AWS CLI** **So löschen Sie ein Asset** Im folgenden Beispiel für `delete-asset` wird die Komponente mit dem Namen `30sec_chicken` gelöscht. ``` aws mediapackage-vod delete-asset \ --id 30sec_chicken ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Assets](https://docs.aws.amazon.com/mediapackage/latest/ug/asset-delete.html) im *AWS MediaPackage Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DeleteAsset AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/delete-asset.html)*Befehlsreferenz.* ### `delete-packaging-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-packaging-configuration`. **AWS CLI** **So löschen Sie eine Packaging-Konfigurationen** Im folgenden Beispiel für `delete-packaging-configuration` wird die Packaging-Konfiguration mit dem Namen `CMAF` gelöscht. ``` aws mediapackage-vod delete-packaging-configuration \ --id CMAF ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Verpackungskonfiguration](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-cfig-delete.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [DeletePackagingConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/delete-packaging-configuration.html)*Befehlsreferenz.* ### `delete-packaging-group` Das folgende Codebeispiel zeigt die Verwendung`delete-packaging-group`. **AWS CLI** **So löschen Sie eine Packaging-Gruppe** Im folgenden Beispiel für `delete-packaging-group` wird die Packaging-Gruppe mit dem Namen `Dash_widevine` gelöscht. ``` aws mediapackage-vod delete-packaging-group \ --id Dash_widevine ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Verpackungsgruppe](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-group-delete.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [DeletePackagingGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/delete-packaging-group.html)*Befehlsreferenz.* ### `describe-asset` Das folgende Codebeispiel zeigt die Verwendung`describe-asset`. **AWS CLI** **So beschreiben Sie eine Komponente** Im folgenden Beispiel für `describe-asset` werden alle Details der Komponente mit dem Namen `30sec_chicken` angezeigt. ``` aws mediapackage-vod describe-asset \ --id 30sec_chicken ``` Ausgabe: ``` { "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:assets/30sec_chicken", "Id":"30sec_chicken", "PackagingGroupId":"Packaging_group_1", "SourceArn":"arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil", "SourceRoleArn":"arn:aws:iam::111122223333:role/EMP_Vod", "EgressEndpoints":[ { "PackagingConfigurationId":"DASH", "Url":"https://a5f46a44118ba3e3724ef39ef532e701.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/aad7962c569946119c2d5a691be5663c/66c25aff456d463aae0855172b3beb27/4ddfda6da17c4c279a1b8401cba31892/index.mpd" }, { "PackagingConfigurationId":"HLS", "Url":"https://a5f46a44118ba3e3724ef39ef532e701.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/aad7962c569946119c2d5a691be5663c/6e5bf286a3414254a2bf0d22ae148d7e/06b5875b4d004c3cbdc4da2dc4d14638/index.m3u8" }, { "PackagingConfigurationId":"CMAF", "Url":"https://a5f46a44118ba3e3724ef39ef532e701.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/aad7962c569946119c2d5a691be5663c/628fb5d8d89e4702958b020af27fde0e/05eb062214064238ad6330a443aff7f7/index.m3u8" } ] } ``` Weitere Informationen finden Sie unter [Asset-Details anzeigen](https://docs.aws.amazon.com/mediapackage/latest/ug/asset-view.html) im *AWS MediaPackage Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeAsset AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/describe-asset.html)*Befehlsreferenz.* ### `describe-packaging-configuration` Das folgende Codebeispiel zeigt die Verwendung`describe-packaging-configuration`. **AWS CLI** **So beschreiben Sie eine Packaging-Konfiguration** Im folgenden Beispiel für `describe-packaging-configuration` werden alle Details der Packaging-Konfiguration mit dem Namen `DASH` angezeigt. ``` aws mediapackage-vod describe-packaging-configuration \ --id DASH ``` Ausgabe: ``` { "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/DASH", "Id":"DASH", "PackagingGroupId":"Packaging_group_1", "DashPackage":[ { "SegmentDurationSeconds":"2" }, { "DashManifests":{ "ManifestName":"index", "MinBufferTimeSeconds":"30", "Profile":"NONE" } } ] } ``` Weitere Informationen finden Sie unter [Verpackungskonfigurationsdetails anzeigen](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-cfig-view.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [DescribePackagingConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/describe-packaging-configuration.html)*Befehlsreferenz.* ### `describe-packaging-group` Das folgende Codebeispiel zeigt die Verwendung`describe-packaging-group`. **AWS CLI** **So beschreiben Sie eine Packaging-Gruppe** Im folgenden Beispiel für `describe-packaging-group` werden alle Details der Packaging-Gruppe mit dem Namen `Packaging_group_1` angezeigt. ``` aws mediapackage-vod describe-packaging-group \ --id Packaging_group_1 ``` Ausgabe: ``` { "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Packaging_group_1", "Id": "Packaging_group_1" } ``` Weitere Informationen finden Sie unter [Details zur Verpackungsgruppe anzeigen](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-group-view.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [DescribePackagingGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/describe-packaging-group.html)*Befehlsreferenz.* ### `list-assets` Das folgende Codebeispiel zeigt die Verwendung`list-assets`. **AWS CLI** **So listen Sie alle Komponenten auf** Das folgende `list-assets` Beispiel listet alle Vermögenswerte auf, die im AWS Girokonto konfiguriert sind. ``` aws mediapackage-vod list-assets ``` Ausgabe: ``` { "Assets": [ "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:assets/30sec_chicken", "Id": "30sec_chicken", "PackagingGroupId": "Packaging_group_1", "SourceArn": "arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil", "SourceRoleArn": "arn:aws:iam::111122223333:role/EMP_Vod" ] } ``` Weitere Informationen finden Sie unter [Asset-Details anzeigen](https://docs.aws.amazon.com/mediapackage/latest/ug/asset-view.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [ListAssets AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/list-assets.html)*Befehlsreferenz.* ### `list-packaging-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-packaging-configurations`. **AWS CLI** **So listen Sie alle Packaging-Konfigurationen auf** Im folgenden Beispiel für `list-packaging-configurations` werden alle Packaging-Konfigurationen aufgelistet, die in der aktuellen Packaging-Gruppe mit dem Namen `Packaging_group_1` konfiguriert sind. ``` aws mediapackage-vod list-packaging-configurations \ --packaging-group-id Packaging_group_1 ``` Ausgabe: ``` { "PackagingConfigurations":[ { "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/CMAF", "Id":"CMAF", "PackagingGroupId":"Packaging_group_1", "CmafPackage":[ { "SegmentDurationSeconds":"2" }, { "HlsManifests":{ "AdMarkers":"NONE", "RepeatExtXKey":"False", "ManifestName":"index", "ProgramDateTimeIntervalSeconds":"0", "IncludeIframeOnlyStream":"False" } } ] }, { "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/DASH", "Id":"DASH", "PackagingGroupId":"Packaging_group_1", "DashPackage":[ { "SegmentDurationSeconds":"2" }, { "DashManifests":{ "ManifestName":"index", "MinBufferTimeSeconds":"30", "Profile":"NONE" } } ] }, { "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/HLS", "Id":"HLS", "PackagingGroupId":"Packaging_group_1", "HlsPackage":[ { "SegmentDurationSeconds":"6", "UseAudioRenditionGroup":"False" }, { "HlsManifests":{ "AdMarkers":"NONE", "RepeatExtXKey":"False", "ManifestName":"index", "ProgramDateTimeIntervalSeconds":"0", "IncludeIframeOnlyStream":"False" } } ] }, { "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/New_config_0_copy", "Id":"New_config_0_copy", "PackagingGroupId":"Packaging_group_1", "HlsPackage":[ { "SegmentDurationSeconds":"6", "UseAudioRenditionGroup":"False" }, { "Encryption":{ "EncryptionMethod":"AWS_128", "SpekeKeyProvider":{ "RoleArn":"arn:aws:iam:111122223333::role/SPEKERole", "Url":"https://lfgubdvs97.execute-api.us-west-2.amazonaws.com/EkeStage/copyProtection/", "SystemIds":[ "81376844-f976-481e-a84e-cc25d39b0b33" ] } } }, { "HlsManifests":{ "AdMarkers":"NONE", "RepeatExtXKey":"False", "ManifestName":"index", "ProgramDateTimeIntervalSeconds":"0", "IncludeIframeOnlyStream":"False" } } ] } ] } ``` Weitere Informationen finden Sie unter [Verpackungskonfigurationsdetails anzeigen](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-cfig-view.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [ListPackagingConfigurations AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/list-packaging-configurations.html)*Befehlsreferenz.* ### `list-packaging-groups` Das folgende Codebeispiel zeigt die Verwendung`list-packaging-groups`. **AWS CLI** **So listen Sie alle Packaging-Gruppen auf** Das folgende `list-packaging-groups` Beispiel listet alle Verpackungsgruppen auf, die im aktuellen AWS Konto konfiguriert sind. ``` aws mediapackage-vod list-packaging-groups ``` Ausgabe: ``` { "PackagingGroups": [ { "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Dash_widevine", "Id": "Dash_widevine" }, { "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Encrypted_HLS", "Id": "Encrypted_HLS" }, { "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Packaging_group_1", "Id": "Packaging_group_1" } ] } ``` Weitere Informationen finden Sie unter [Paketgruppendetails anzeigen](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-group-view.html) im *AWS Elemental MediaPackage User Guide*. + Einzelheiten zur API finden Sie unter [ListPackagingGroups AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/list-packaging-groups.html)*Befehlsreferenz.* # MediaStore Beispiele für Datenebene mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with MediaStore Data Plane Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-object` Das folgende Codebeispiel zeigt, wie Sie`delete-object`. **AWS CLI** **Um ein Objekt zu löschen** Im folgenden Beispiel für `delete-object` wird das angegebene Objekt gelöscht. ``` aws mediastore-data delete-object \ --endpoint=https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --path=/folder_name/README.md ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Objekts](https://docs.aws.amazon.com/mediastore/latest/ug/objects-delete.html) im *AWS Elemental MediaStore User Guide*. + Einzelheiten zur API finden Sie [DeleteObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/delete-object.html)in der *AWS CLI Befehlsreferenz.* ### `describe-object` Das folgende Codebeispiel zeigt die Verwendung`describe-object`. **AWS CLI** **So zeigen Sie die Header für ein Objekt an** Im folgenden Beispiel für `describe-object` werden die Header für ein Objekt im angegebenen Pfad angezeigt. ``` aws mediastore-data describe-object \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --path events/baseball/setup.jpg ``` Ausgabe: ``` { "LastModified": "Fri, 19 Jul 2019 21:50:31 GMT", "ContentType": "image/jpeg", "ContentLength": "3860266", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3" } ``` Weitere Informationen finden Sie unter [Anzeigen der Details eines Objekts](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-details.html) im *AWS MediaStore Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie unter [DescribeObject AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/describe-object.html)*Befehlsreferenz.* ### `get-object` Das folgende Codebeispiel zeigt die Verwendung`get-object`. **AWS CLI** **Beispiel 1: So laden Sie ein ganzes Objekt herunter** Im folgenden Beispiel für `get-object` wird das angegebene Objekt gelöscht. ``` aws mediastore-data get-object \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --path events/baseball/setup.jpg setup.jpg ``` Ausgabe: ``` { "ContentType": "image/jpeg", "StatusCode": 200, "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3", "ContentLength": "3860266", "LastModified": "Fri, 19 Jul 2019 21:50:31 GMT" } ``` **Beispiel 2: So laden Sie einen Teil eines Objekts herunter** Im folgenden Beispiel für `get-object` wird der angegebene Teil des Objekts heruntergeladen. ``` aws mediastore-data get-object \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --path events/baseball/setup.jpg setup.jpg \ --range "bytes=0-100" ``` Ausgabe: ``` { "StatusCode": 206, "LastModified": "Fri, 19 Jul 2019 21:50:31 GMT", "ContentType": "image/jpeg", "ContentRange": "bytes 0-100/3860266", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3", "ContentLength": "101" } ``` Weitere Informationen finden Sie unter [Objekt herunterladen](https://docs.aws.amazon.com/mediastore/latest/ug/objects-download.html) im *AWS MediaStore Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/get-object.html)in der *AWS CLI Befehlsreferenz.* ### `list-items` Das folgende Codebeispiel zeigt die Verwendung`list-items`. **AWS CLI** **Beispiel 1: So zeigen Sie eine Liste von Elementen (Objekte und Ordner) an, die in einem Container gespeichert sind** Im folgenden Beispiel für `list-items` wird eine Liste von Elementen (Objekte und Ordner) angezeigt, die im angegebenen Container gespeichert sind. ``` aws mediastore-data list-items \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com ``` Ausgabe: ``` { "Items": [ { "Type": "OBJECT", "ContentLength": 3784, "Name": "setup.jpg", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3", "ContentType": "image/jpeg", "LastModified": 1563571859.379 }, { "Type": "FOLDER", "Name": "events" } ] } ``` **Beispiel 2: So zeigen Sie eine Liste von Elementen (Objekte und Ordner) an, die in einem Ordner gespeichert sind** Im folgenden Beispiel für `list-items` wird eine Liste von Elementen (Objekte und Ordner) angezeigt, die im angegebenen Ordner gespeichert sind. ``` aws mediastore-data list-items \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --path events/baseball ``` Ausgabe: ``` { "Items": [ { "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3", "ContentType": "image/jpeg", "Type": "OBJECT", "ContentLength": 3860266, "LastModified": 1563573031.872, "Name": "setup.jpg" } ] } ``` Weitere Informationen finden Sie im *AWS Elemental MediaStore User Guide* unter [Eine Objektliste anzeigen](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-list.html). + Einzelheiten zur API finden Sie unter [ListItems AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/list-items.html)*Befehlsreferenz.* ### `put-object` Das folgende Codebeispiel zeigt die Verwendung`put-object`. **AWS CLI** **Beispiel 1: So laden Sie ein Objekt in einen Container hoch** Im folgenden Beispiel für `put-object` wird ein Objekt in den angegebenen Container hochgeladen. ``` aws mediastore-data put-object \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --body ReadMe.md \ --path ReadMe.md \ --cache-control "max-age=6, public" \ --content-type binary/octet-stream ``` Ausgabe: ``` { "ContentSHA256": "f29bc64a9d3732b4b9035125fdb3285f5b6455778edca72414671e0ca3b2e0de", "StorageClass": "TEMPORAL", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3" } ``` **Beispiel 2: So laden Sie ein Objekt in einen Ordner hoch, der sich in einem Container befindet** Im folgenden Beispiel für `put-object` wird ein Objekt in den angegebenen Ordner eines Containers hochgeladen. ``` aws mediastore-data put-object \ --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \ --body ReadMe.md \ --path /september-events/ReadMe.md \ --cache-control "max-age=6, public" \ --content-type binary/octet-stream ``` Ausgabe: ``` { "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3", "ContentSHA256": "f29bc64a9d3732b4b9035125fdb3285f5b6455778edca72414671e0ca3b2e0de", "StorageClass": "TEMPORAL" } ``` Weitere Informationen finden Sie unter [Hochladen eines Objekts](https://docs.aws.amazon.com/mediastore/latest/ug/objects-upload.html) im *AWS MediaStore Elemental-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/put-object.html)in der *AWS CLI Befehlsreferenz*. # MediaTailor Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren MediaTailor. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-playback-configuration` Das folgende Codebeispiel zeigt, wie Sie`delete-playback-configuration`. **AWS CLI** **So löschen Sie eine Konfiguration** Im folgenden Beispiel für `delete-playback-configuration` wird eine gespeicherte Konfiguration mit dem Namen `campaign_short` gelöscht. ``` aws mediatailor delete-playback-configuration \ --name campaign_short ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Konfiguration](https://docs.aws.amazon.com/mediatailor/latest/ug/configurations-delete.html) im *AWS Elemental MediaTailor User Guide*. + Einzelheiten zur API finden Sie unter [DeletePlaybackConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediatailor/delete-playback-configuration.html)*Befehlsreferenz.* ### `get-playback-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-playback-configuration`. **AWS CLI** **So beschreiben Sie eine Konfiguration** Im folgenden Beispiel für `get-playback-configuration` werden alle Details der Konfiguration mit dem Namen `west_campaign` angezeigt. ``` aws mediatailor get-playback-configuration \ --name west_campaign ``` Ausgabe: ``` { "AdDecisionServerUrl": "http://your.ads.url", "CdnConfiguration": {}, "DashConfiguration": { "ManifestEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com/v1/dash/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/west_campaign/", "MpdLocation": "EMT_DEFAULT", "OriginManifestType": "MULTI_PERIOD" }, "HlsConfiguration": { "ManifestEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com/v1/master/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/west_campaign/" }, "Name": "west_campaign", "PlaybackConfigurationArn": "arn:aws:mediatailor:us-west-2:123456789012:playbackConfiguration/west_campaign", "PlaybackEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com", "SessionInitializationEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com/v1/session/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/west_campaign/", "Tags": {}, "VideoContentSourceUrl": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/683f0f2ff7cd43a48902e6dcd5e16dcf/index.m3u8" } ``` Weitere Informationen finden Sie unter [Konfiguration anzeigen](https://docs.aws.amazon.com/mediatailor/latest/ug/configurations-view.html) im *AWS Elemental MediaTailor User Guide*. + Einzelheiten zur API finden Sie unter [GetPlaybackConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediatailor/get-playback-configuration.html)*Befehlsreferenz.* ### `list-playback-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-playback-configurations`. **AWS CLI** **So listen Sie alle Konfigurationen auf** Im Folgenden `list-playback-configurations` werden alle Details der Konfiguration für das aktuelle AWS Konto angezeigt. ``` aws mediatailor list-playback-configurations ``` Ausgabe: ``` { "Items": [ { "AdDecisionServerUrl": "http://your.ads.url", "CdnConfiguration": {}, "DashConfiguration": { "ManifestEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com/v1/dash/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/west_campaign/", "MpdLocation": "EMT_DEFAULT", "OriginManifestType": "MULTI_PERIOD" }, "HlsConfiguration": { "ManifestEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com/v1/master/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/west_campaign/" }, "Name": "west_campaign", "PlaybackConfigurationArn": "arn:aws:mediatailor:us-west-2:123456789012:playbackConfiguration/west_campaign", "PlaybackEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com", "SessionInitializationEndpointPrefix": "https://170c14299689462897d0cc45fc2000bb.mediatailor.us-west-2.amazonaws.com/v1/session/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/west_campaign/", "Tags": {}, "VideoContentSourceUrl": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/683f0f2ff7cd43a48902e6dcd5e16dcf/index.m3u8" }, { "AdDecisionServerUrl": "http://your.ads.url", "CdnConfiguration": {}, "DashConfiguration": { "ManifestEndpointPrefix": "https://73511f91d6a24ca2b93f3cf1d7cedd67.mediatailor.us-west-2.amazonaws.com/v1/dash/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/sports_campaign/", "MpdLocation": "DISABLED", "OriginManifestType": "MULTI_PERIOD" }, "HlsConfiguration": { "ManifestEndpointPrefix": "https://73511f91d6a24ca2b93f3cf1d7cedd67.mediatailor.us-west-2.amazonaws.com/v1/master/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/sports_campaign/" }, "Name": "sports_campaign", "PlaybackConfigurationArn": "arn:aws:mediatailor:us-west-2:123456789012:playbackConfiguration/sports_campaign", "PlaybackEndpointPrefix": "https://73511f91d6a24ca2b93f3cf1d7cedd67.mediatailor.us-west-2.amazonaws.com", "SessionInitializationEndpointPrefix": "https://73511f91d6a24ca2b93f3cf1d7cedd67.mediatailor.us-west-2.amazonaws.com/v1/session/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/sports_campaign/", "SlateAdUrl": "http://s3.bucket/slate_ad.mp4", "Tags": {}, "VideoContentSourceUrl": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/sports_endpoint/index.m3u8" } ] } ``` *Weitere Informationen finden Sie unter Konfiguration anzeigen< https://docs.aws.amazon.com/mediatailor/ latest/ug/configurations -view.html> im Elemental User Guide.AWS MediaTailor * + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [ListPlaybackConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediatailor/list-playback-configurations.html)AWS CLI * ### `put-playback-configuration` Das folgende Codebeispiel zeigt die Verwendung`put-playback-configuration`. **AWS CLI** **So erstellen Sie eine Konfiguration** Im folgenden Beispiel für `put-playback-configuration` wird eine Konfiguration mit dem Namen `campaign_short` erstellt. ``` aws mediatailor put-playback-configuration \ --name campaign_short \ --ad-decision-server-url http://your.ads.url \ --video-content-source-url http://video.bucket/index.m3u8 ``` Ausgabe: ``` { "AdDecisionServerUrl": "http://your.ads.url", "CdnConfiguration": {}, "DashConfiguration": { "ManifestEndpointPrefix": "https://13484114d38f4383bc0d6a7cb879bd00.mediatailor.us-west-2.amazonaws.com/v1/dash/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/campaign_short/", "MpdLocation": "EMT_DEFAULT", "OriginManifestType": "MULTI_PERIOD" }, "HlsConfiguration": { "ManifestEndpointPrefix": "https://13484114d38f4383bc0d6a7cb879bd00.mediatailor.us-west-2.amazonaws.com/v1/master/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/campaign_short/" }, "Name": "campaign_short", "PlaybackConfigurationArn": "arn:aws:mediatailor:us-west-2:123456789012:playbackConfiguration/campaign_short", "PlaybackEndpointPrefix": "https://13484114d38f4383bc0d6a7cb879bd00.mediatailor.us-west-2.amazonaws.com", "SessionInitializationEndpointPrefix": "https://13484114d38f4383bc0d6a7cb879bd00.mediatailor.us-west-2.amazonaws.com/v1/session/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/campaign_short/", "Tags": {}, "VideoContentSourceUrl": "http://video.bucket/index.m3u8" } ``` Weitere Informationen finden Sie unter [Creating a Configuration](https://docs.aws.amazon.com/mediatailor/latest/ug/configurations-create.html) im *AWS Elemental MediaTailor User Guide*. + Einzelheiten zur API finden Sie unter [PutPlaybackConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediatailor/put-playback-configuration.html)*Befehlsreferenz.* # MemoryDB-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit MemoryDB Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `copy-snapshot` Das folgende Codebeispiel zeigt, wie Sie. `copy-snapshot` **AWS CLI** **So kopieren Sie einen Snapshot** Im folgenden Beispiel für `copy-snapshot` wird die Kopie eines Snapshots erstellt. ``` aws memorydb copy-snapshot \ --source-snapshot-name my-cluster-snapshot \ --target-snapshot-name my-cluster-snapshot-copy ``` Ausgabe ``` { "Snapshot": { "Name": "my-cluster-snapshot-copy", "Status": "creating", "Source": "manual", "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:snapshot/my-cluster-snapshot-copy", "ClusterConfiguration": { "Name": "my-cluster", "Description": " ", "NodeType": "db.r6g.large", "EngineVersion": "6.2", "MaintenanceWindow": "wed:03:00-wed:04:00", "Port": 6379, "ParameterGroupName": "default.memorydb-redis6", "SubnetGroupName": "my-sg", "VpcId": "vpc-xx2574fc", "SnapshotRetentionLimit": 0, "SnapshotWindow": "04:30-05:30", "NumShards": 2 } } } ``` Weitere Informationen finden Sie unter [Kopieren eines Snapshots](https://docs.aws.amazon.com/memorydb/latest/devguide/snapshots-copying.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [CopySnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/copy-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-acl` Das folgende Codebeispiel zeigt die Verwendung`create-acl`. **AWS CLI** **So erstellen Sie eine ACL** Im folgenden Beispiel für `create-acl` wird eine neue Zugriffssteuerungsliste erstellt. ``` aws memorydb create-acl \ --acl-name "new-acl-1" \ --user-names "my-user" ``` Ausgabe: ``` { "ACL": { "Name": "new-acl-1", "Status": "creating", "UserNames": [ "my-user" ], "MinimumEngineVersion": "6.2", "Clusters": [], "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:acl/new-acl-1" } } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit Zugriffssteuerungslisten](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.acls.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [CreateAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/create-acl.html)in der *AWS CLI Befehlsreferenz*. ### `create-cluster` Das folgende Codebeispiel zeigt die Verwendung`create-cluster`. **AWS CLI** **So erstellen Sie einen Cluster** Im folgenden Beispiel für `create-cluster` wird ein neuer Cluster erstellt. ``` aws memorydb create-cluster \ --cluster-name my-new-cluster \ --node-type db.r6g.large \ --acl-name my-acl \ --subnet-group my-sg ``` Ausgabe: ``` { "Cluster": { "Name": "my-new-cluster", "Status": "creating", "NumberOfShards": 1, "AvailabilityMode": "MultiAZ", "ClusterEndpoint": { "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "default.memorydb-redis6", "ParameterGroupStatus": "in-sync", "SubnetGroupName": "my-sg", "TLSEnabled": true, "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:cluster/my-new-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "sat:10:00-sat:11:00", "SnapshotWindow": "07:30-08:30", "ACLName": "my-acl", "AutoMinorVersionUpgrade": true } } ``` Weitere Informationen finden Sie unter [Verwalten von Clustern](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/create-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `create-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`create-parameter-group`. **AWS CLI** **Um eine Parametergruppe zu erstellen** Im folgenden Beispiel für `create-parameter-group` wird eine Parametergruppe erstellt. ``` aws memorydb create-parameter-group \ --parameter-group-name myRedis6x \ --family memorydb_redis6 \ --description "my-parameter-group" ``` Ausgabe: ``` { "ParameterGroup": { "Name": "myredis6x", "Family": "memorydb_redis6", "Description": "my-parameter-group", "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:parametergroup/myredis6x" } } ``` Weitere Informationen finden Sie unter [Erstellen einer Parametergruppe](https://docs.aws.amazon.com/memorydb/latest/devguide/parametergroups.creating.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [CreateParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/create-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-snapshot`. **AWS CLI** **So erstellen Sie einen Snapshot** Im folgenden Beispiel für `create-snapshot` wird ein Snapshot erstellt. ``` aws memorydb create-snapshot \ --cluster-name my-cluster \ --snapshot-name my-cluster-snapshot ``` Ausgabe: ``` { "Snapshot": { "Name": "my-cluster-snapshot1", "Status": "creating", "Source": "manual", "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:snapshot/my-cluster-snapshot", "ClusterConfiguration": { "Name": "my-cluster", "Description": "", "NodeType": "db.r6g.large", "EngineVersion": "6.2", "MaintenanceWindow": "wed:03:00-wed:04:00", "Port": 6379, "ParameterGroupName": "default.memorydb-redis6", "SubnetGroupName": "my-sg", "VpcId": "vpc-862xxxxc", "SnapshotRetentionLimit": 0, "SnapshotWindow": "04:30-05:30", "NumShards": 2 } } } ``` Weitere Informationen finden Sie unter [Erstellen manueller Snapshots](https://docs.aws.amazon.com/memorydb/latest/devguide/snapshots-manual.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [CreateSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/create-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`create-subnet-group`. **AWS CLI** **Um eine Subnetzgruppe zu erstellen** Im folgenden Beispiel für `create-subnet-group` wird eine Subnetzgruppe erstellt. ``` aws memorydb create-subnet-group \ --subnet-group-name mysubnetgroup \ --description "my subnet group" \ --subnet-ids subnet-5623xxxx ``` Ausgabe: ``` { "SubnetGroup": { "Name": "mysubnetgroup", "Description": "my subnet group", "VpcId": "vpc-86257xxx", "Subnets": [ { "Identifier": "subnet-5623xxxx", "AvailabilityZone": { "Name": "us-east-1a" } } ], "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:subnetgroup/mysubnetgroup" } } ``` Weitere Informationen finden Sie unter [Erstellen einer Subnetzgruppe](https://docs.aws.amazon.com/memorydb/latest/devguide/subnetgroups.creating.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [CreateSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/create-subnet-group.html)in der *AWS CLI Befehlsreferenz.* ### `create-user` Das folgende Codebeispiel zeigt die Verwendung`create-user`. **AWS CLI** **Um einen Benutzer zu erstellen** Im folgenden Beispiel für `create-user` wird ein neuer Benutzer erstellt. ``` aws memorydb create-user \ --user-name user-name-1 \ --access-string "~objects:* ~items:* ~public:*" \ --authentication-mode \ Passwords="enterapasswordhere",Type=password ``` Ausgabe: ``` { "User": { "Name": "user-name-1", "Status": "active", "AccessString": "off ~objects:* ~items:* ~public:* resetchannels -@all", "ACLNames": [], "MinimumEngineVersion": "6.2", "Authentication": { "Type": "password", "PasswordCount": 1 }, "ARN": "arn:aws:memorydb:us-west-2:491658xxxxxx:user/user-name-1" } } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit Zugriffssteuerungslisten](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.acls.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [CreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/create-user.html)in der *AWS CLI Befehlsreferenz*. ### `delete-acl` Das folgende Codebeispiel zeigt die Verwendung`delete-acl`. **AWS CLI** **So löschen Sie eine ACL** Im folgenden Beispiel für `delete-acl` wird eine Zugriffssteuerungsliste gelöscht. ``` aws memorydb delete-acl \ --acl-name "new-acl-1" ``` Ausgabe: ``` { "ACL": { "Name": "new-acl-1", "Status": "deleting", "UserNames": [ "pat" ], "MinimumEngineVersion": "6.2", "Clusters": [], "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:acl/new-acl-1" } } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit Zugriffssteuerungslisten](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.acls.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DeleteAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/delete-acl.html)in der *AWS CLI Befehlsreferenz*. ### `delete-cluster` Das folgende Codebeispiel zeigt die Verwendung`delete-cluster`. **AWS CLI** **So löschen Sie einen Cluster** Im folgenden Beispiel für `delete-cluster` wird ein Cluster gelöscht. ``` aws memorydb delete-cluster \ --cluster-name my-new-cluster ``` Ausgabe: ``` { "Cluster": { "Name": "my-new-cluster", "Status": "deleting", "NumberOfShards": 1, "ClusterEndpoint": { "Address": "clustercfg.my-new-cluster.xxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "default.memorydb-redis6", "ParameterGroupStatus": "in-sync", "SubnetGroupName": "my-sg", "TLSEnabled": true, "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-new-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "sat:10:00-sat:11:00", "SnapshotWindow": "07:30-08:30", "AutoMinorVersionUpgrade": true } } ``` Weitere Informationen finden Sie unter [Löschen eines Clusters](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.delete.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/delete-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `delete-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`delete-parameter-group`. **AWS CLI** **Um eine Parametergruppe zu löschen** Im folgenden Beispiel für `delete-parameter-group` wird eine Parametergruppe gelöscht. ``` aws memorydb delete-parameter-group \ --parameter-group-name myRedis6x ``` Ausgabe: ``` { "ParameterGroup": { "Name": "myredis6x", "Family": "memorydb_redis6", "Description": "my-parameter-group", "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:parametergroup/myredis6x" } } ``` Weitere Informationen finden Sie unter [Löschen einer Parametergruppe](https://docs.aws.amazon.com/memorydb/latest/devguide/parametergroups.deleting.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DeleteParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/delete-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-snapshot`. **AWS CLI** **So löschen Sie einen Snapshot** Im folgenden Beispiel für `delete-snapshot` wird ein Snapshot gelöscht. ``` aws memorydb delete-snapshot \ --snapshot-name my-cluster-snapshot ``` Ausgabe: ``` { "Snapshot": { "Name": "my-cluster-snapshot", "Status": "deleting", "Source": "manual", "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:snapshot/my-cluster-snapshot", "ClusterConfiguration": { "Name": "my-cluster", "Description": "", "NodeType": "db.r6g.large", "EngineVersion": "6.2", "MaintenanceWindow": "wed:03:00-wed:04:00", "Port": 6379, "ParameterGroupName": "default.memorydb-redis6", "SubnetGroupName": "my-sg", "VpcId": "vpc-862xxxxc", "SnapshotRetentionLimit": 0, "SnapshotWindow": "04:30-05:30", "NumShards": 2 } } } ``` Weitere Informationen finden Sie unter [Löschen eines Snapshots](https://docs.aws.amazon.com/memorydb/latest/devguide/snapshots-deleting.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DeleteSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/delete-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `delete-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`delete-subnet-group`. **AWS CLI** **Um eine Subnetzgruppe zu löschen** Im folgenden Beispiel für `delete-subnet-group` wird ein Subnetz gelöscht. ``` aws memorydb delete-subnet-group \ --subnet-group-name mysubnetgroup ``` Ausgabe: ``` { "SubnetGroup": { "Name": "mysubnetgroup", "Description": "my subnet group", "VpcId": "vpc-86xxxx4fc", "Subnets": [ { "Identifier": "subnet-56xxx61b", "AvailabilityZone": { "Name": "us-east-1a" } } ], "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:subnetgroup/mysubnetgroup" } } ``` Weitere Informationen finden Sie unter [Löschen einer Subnetzgruppe](https://docs.aws.amazon.com/memorydb/latest/devguide/subnetgroups.deleting.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DeleteSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/delete-subnet-group.html)in der *AWS CLI Befehlsreferenz.* ### `delete-user` Das folgende Codebeispiel zeigt die Verwendung`delete-user`. **AWS CLI** **So löschen Sie einen Benutzer** Im folgenden Beispiel für `delete-user` wird ein Benutzer gelöscht. ``` aws memorydb delete-user \ --user-name my-user ``` Ausgabe: ``` { "User": { "Name": "my-user", "Status": "deleting", "AccessString": "on ~app::* resetchannels -@all +@read", "ACLNames": [ "my-acl" ], "MinimumEngineVersion": "6.2", "Authentication": { "Type": "password", "PasswordCount": 1 }, "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:user/my-user" } } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit Zugriffssteuerungslisten](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.acls.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/delete-user.html)in der *AWS CLI Befehlsreferenz*. ### `describe-acls` Das folgende Codebeispiel zeigt die Verwendung`describe-acls`. **AWS CLI** **Um eine Liste von zurückzugeben ACLs** Das folgende describe-acls` gibt eine Liste von zurück. ACLs ``` aws memorydb describe-acls ``` Ausgabe: ``` { "ACLs": [ { "Name": "open-access", "Status": "active", "UserNames": [ "default" ], "MinimumEngineVersion": "6.2", "Clusters": [], "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:acl/open-access" }, { "Name": my-acl", "Status": "active", "UserNames": [], "MinimumEngineVersion": "6.2", "Clusters": [ "my-cluster" ], "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxxx:acl/my-acl" } ] } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit Zugriffssteuerungslisten](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.acls.html) im *Benutzerhandbuch für MemoryDB*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DescribeAcls](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/describe-acls.html).AWS CLI * ### `describe-clusters` Das folgende Codebeispiel zeigt die Verwendung`describe-clusters`. **AWS CLI** **So geben Sie eine Liste von Clustern zurück** Der folgende Befehl „describe-clusters`“ gibt eine Liste von Clustern zurück. ``` aws memorydb describe-clusters ``` Ausgabe: ``` { "Clusters": [ { "Name": "my-cluster", "Status": "available", "NumberOfShards": 2, "ClusterEndpoint": { "Address": "clustercfg.my-cluster.llru6f.memorydb.us-east-1.amazonaws.com", "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "default.memorydb-redis6", "ParameterGroupStatus": "in-sync", "SecurityGroups": [ { "SecurityGroupId": "sg-0a1434xxxxxc9fae", "Status": "active" } ], "SubnetGroupName": "pat-sg", "TLSEnabled": true, "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:cluster/my-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "wed:03:00-wed:04:00", "SnapshotWindow": "04:30-05:30", "ACLName": "my-acl", "AutoMinorVersionUpgrade": true } ] } ``` Weitere Informationen finden Sie unter [Verwalten von Clustern](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DescribeClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/describe-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-engine-versions` Das folgende Codebeispiel zeigt die Verwendung`describe-engine-versions`. **AWS CLI** **So geben Sie eine Liste von Engine-Versionen zurück** Das folgende describe-engine-versions `gibt eine Liste von Engine-Versionen zurück. ``` aws memorydb describe-engine-versions ``` Ausgabe: ``` { "EngineVersions": [ { "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupFamily": "memorydb_redis6" } ] } ``` *Weitere Informationen finden Sie unter [Engine-Versionen und Upgrades](https://docs.aws.amazon.com/memorydb/latest/devguide/engine-versions.htmll) im Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DescribeEngineVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/describe-engine-versions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-events` Das folgende Codebeispiel zeigt die Verwendung`describe-events`. **AWS CLI** **So geben Sie eine Liste von Ereignissen zurück** Der folgende Befehl „describe-events`“ gibt eine Liste von Ereignissen zurück. ``` aws memorydb describe-events ``` Ausgabe: ``` { "Events": [ { "SourceName": "my-cluster", "SourceType": "cluster", "Message": "Increase replica count started for replication group my-cluster on 2022-07-22T14:09:01.440Z", "Date": "2022-07-22T07:09:01.443000-07:00" }, { "SourceName": "my-user", "SourceType": "user", "Message": "Create user my-user operation completed.", "Date": "2022-07-22T07:00:02.975000-07:00" } ] } ``` Weitere Informationen finden Sie unter [Überwachen von Ereignissen](https://docs.aws.amazon.com/memorydb/latest/devguide/monitoring-events.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/describe-events.html)in der *AWS CLI Befehlsreferenz*. ### `describe-parameter-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-parameter-groups`. **AWS CLI** **So geben Sie eine Liste von Parametergruppen zurück** Das folgende describe-parameter-groups `gibt eine Liste von Parametergruppen zurück. ``` aws memorydb describe-parameter-groups ``` Ausgabe: ``` { "ParameterGroups": [ { "Name": "default.memorydb-redis6", "Family": "memorydb_redis6", "Description": "Default parameter group for memorydb_redis6", "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:parametergroup/default.memorydb-redis6" } ] } ``` Weitere Informationen finden Sie unter [Konfigurieren von Engine-Parametern mithilfe von Parametergruppen](https://docs.aws.amazon.com/memorydb/latest/devguide/parametergroups.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DescribeParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/describe-parameter-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-parameters`. **AWS CLI** **So geben Sie eine Liste von Parametergruppen zurück** Der folgende Befehl „describe-parameters`“ gibt eine Liste von Parametern zurück. ``` aws memorydb describe-parameters ``` Ausgabe: ``` { "Parameters": [ { "Name": "acllog-max-len", "Value": "128", "Description": "The maximum length of the ACL Log", "DataType": "integer", "AllowedValues": "1-10000", "MinimumEngineVersion": "6.2.4" }, { "Name": "activedefrag", "Value": "no", "Description": "Enabled active memory defragmentation", "DataType": "string", "AllowedValues": "yes,no", "MinimumEngineVersion": "6.2.4" }, { "Name": "active-defrag-cycle-max", "Value": "75", "Description": "Maximal effort for defrag in CPU percentage", "DataType": "integer", "AllowedValues": "1-75", "MinimumEngineVersion": "6.2.4" }, { "Name": "active-defrag-cycle-min", "Value": "5", "Description": "Minimal effort for defrag in CPU percentage", "DataType": "integer", "AllowedValues": "1-75", "MinimumEngineVersion": "6.2.4" }, { "Name": "active-defrag-ignore-bytes", "Value": "104857600", "Description": "Minimum amount of fragmentation waste to start active defrag", "DataType": "integer", "AllowedValues": "1048576-", "MinimumEngineVersion": "6.2.4" }, { "Name": "active-defrag-max-scan-fields", "Value": "1000", "Description": "Maximum number of set/hash/zset/list fields that will be processed from the main dictionary scan", "DataType": "integer", "AllowedValues": "1-1000000", "MinimumEngineVersion": "6.2.4" }, { "Name": "active-defrag-threshold-lower", "Value": "10", "Description": "Minimum percentage of fragmentation to start active defrag", "DataType": "integer", "AllowedValues": "1-100", "MinimumEngineVersion": "6.2.4" }, { "Name": "active-defrag-threshold-upper", "Value": "100", "Description": "Maximum percentage of fragmentation at which we use maximum effort", "DataType": "integer", "AllowedValues": "1-100", "MinimumEngineVersion": "6.2.4" }, { "Name": "active-expire-effort", "Value": "1", "Description": "The amount of effort that redis uses to expire items in the active expiration job", "DataType": "integer", "AllowedValues": "1-10", "MinimumEngineVersion": "6.2.4" }, { "Name": "activerehashing", "Value": "yes", "Description": "Apply rehashing or not", "DataType": "string", "AllowedValues": "yes,no", "MinimumEngineVersion": "6.2.4" }, { "Name": "client-output-buffer-limit-normal-hard-limit", "Value": "0", "Description": "Normal client output buffer hard limit in bytes", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "client-output-buffer-limit-normal-soft-limit", "Value": "0", "Description": "Normal client output buffer soft limit in bytes", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "client-output-buffer-limit-normal-soft-seconds", "Value": "0", "Description": "Normal client output buffer soft limit in seconds", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "client-output-buffer-limit-pubsub-hard-limit", "Value": "33554432", "Description": "Pubsub client output buffer hard limit in bytes", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "client-output-buffer-limit-pubsub-soft-limit", "Value": "8388608", "Description": "Pubsub client output buffer soft limit in bytes", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "client-output-buffer-limit-pubsub-soft-seconds", "Value": "60", "Description": "Pubsub client output buffer soft limit in seconds", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "hash-max-ziplist-entries", "Value": "512", "Description": "The maximum number of hash entries in order for the dataset to be compressed", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "hash-max-ziplist-value", "Value": "64", "Description": "The threshold of biggest hash entries in order for the dataset to be compressed", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "hll-sparse-max-bytes", "Value": "3000", "Description": "HyperLogLog sparse representation bytes limit", "DataType": "integer", "AllowedValues": "1-16000", "MinimumEngineVersion": "6.2.4" }, { "Name": "lazyfree-lazy-eviction", "Value": "no", "Description": "Perform an asynchronous delete on evictions", "DataType": "string", "AllowedValues": "yes,no", "MinimumEngineVersion": "6.2.4" }, { "Name": "lazyfree-lazy-expire", "Value": "no", "Description": "Perform an asynchronous delete on expired keys", "DataType": "string", "AllowedValues": "yes,no", "MinimumEngineVersion": "6.2.4" }, { "Name": "lazyfree-lazy-server-del", "Value": "no", "Description": "Perform an asynchronous delete on key updates", "DataType": "string", "AllowedValues": "yes,no", "MinimumEngineVersion": "6.2.4" }, { "Name": "lazyfree-lazy-user-del", "Value": "no", "Description": "Specifies whether the default behavior of DEL command acts the same as UNLINK", "DataType": "string", "AllowedValues": "yes,no", "MinimumEngineVersion": "6.2.4" }, { "Name": "lfu-decay-time", "Value": "1", "Description": "The amount of time in minutes to decrement the key counter for LFU eviction policyd", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "lfu-log-factor", "Value": "10", "Description": "The log factor for incrementing key counter for LFU eviction policy", "DataType": "integer", "AllowedValues": "1-", "MinimumEngineVersion": "6.2.4" }, { "Name": "list-compress-depth", "Value": "0", "Description": "Number of quicklist ziplist nodes from each side of the list to exclude from compression. The head and tail of the list are always uncompressed for fast push/pop operations", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "maxmemory-policy", "Value": "noeviction", "Description": "Max memory policy", "DataType": "string", "AllowedValues": "volatile-lru,allkeys-lru,volatile-lfu,allkeys-lfu,volatile-random,allkeys-random,volatile-ttl,noeviction", "MinimumEngineVersion": "6.2.4" }, { "Name": "maxmemory-samples", "Value": "3", "Description": "Max memory samples", "DataType": "integer", "AllowedValues": "1-", "MinimumEngineVersion": "6.2.4" }, { "Name": "notify-keyspace-events", "Description": "The keyspace events for Redis to notify Pub/Sub clients about. By default all notifications are disabled", "DataType": "string", "MinimumEngineVersion": "6.2.4" }, { "Name": "set-max-intset-entries", "Value": "512", "Description": "The limit in the size of the set in order for the dataset to be compressed", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "slowlog-log-slower-than", "Value": "10000", "Description": "The execution time, in microseconds, to exceed in order for the command to get logged. Note that a negative number disables the slow log, while a value of zero forces the logging of every command", "DataType": "integer", "AllowedValues": "-", "MinimumEngineVersion": "6.2.4" }, { "Name": "slowlog-max-len", "Value": "128", "Description": "The length of the slow log. There is no limit to this length. Just be aware that it will consume memory. You can reclaim memory used by the slow log with SLOWLOG RESET.", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "stream-node-max-bytes", "Value": "4096", "Description": "The maximum size of a single node in a stream in bytes", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "stream-node-max-entries", "Value": "100", "Description": "The maximum number of items a single node in a stream can contain", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "tcp-keepalive", "Value": "300", "Description": "If non-zero, send ACKs every given number of seconds", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "timeout", "Value": "0", "Description": "Close connection if client is idle for a given number of seconds, or never if 0", "DataType": "integer", "AllowedValues": "0,20-", "MinimumEngineVersion": "6.2.4" }, { "Name": "tracking-table-max-keys", "Value": "1000000", "Description": "The maximum number of keys allowed for the tracking table for client side caching", "DataType": "integer", "AllowedValues": "1-100000000", "MinimumEngineVersion": "6.2.4" }, { "Name": "zset-max-ziplist-entries", "Value": "128", "Description": "The maximum number of sorted set entries in order for the dataset to be compressed", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" }, { "Name": "zset-max-ziplist-value", "Value": "64", "Description": "The threshold of biggest sorted set entries in order for the dataset to be compressed", "DataType": "integer", "AllowedValues": "0-", "MinimumEngineVersion": "6.2.4" } ] } ``` Weitere Informationen finden Sie unter [Konfigurieren von Engine-Parametern mithilfe von Parametergruppen](https://docs.aws.amazon.com/memorydb/latest/devguide/parametergroups.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DescribeParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/describe-parameters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-snapshots` Das folgende Codebeispiel zeigt die Verwendung`describe-snapshots`. **AWS CLI** **So geben Sie eine Liste von Snapshots zurück** Der folgende Befehl „describe-snapshots`“ gibt eine Liste von Snapshots zurück. ``` aws memorydb describe-snapshots ``` Ausgabe: ``` { "Snapshots": [ { "Name": "my-cluster-snapshot", "Status": "available", "Source": "manual", "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx2:snapshot/my-cluster-snapshot", "ClusterConfiguration": { "Name": "my-cluster", "Description": " ", "NodeType": "db.r6g.large", "EngineVersion": "6.2", "MaintenanceWindow": "wed:03:00-wed:04:00", "Port": 6379, "ParameterGroupName": "default.memorydb-redis6", "SubnetGroupName": "my-sg", "VpcId": "vpc-862574fc", "SnapshotRetentionLimit": 0, "SnapshotWindow": "04:30-05:30", "NumShards": 2 } } } ``` Weitere Informationen finden Sie unter [Snapshot und Wiederherstellung](https://docs.aws.amazon.com/memorydb/latest/devguide/snapshots.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DescribeSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/describe-snapshots.html)in der *AWS CLI Befehlsreferenz*. ### `describe-subnet-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-subnet-groups`. **AWS CLI** **So geben Sie eine Liste von Subnetzgruppen zurück** Das folgende describe-subnet-groups `gibt eine Liste von Subnetzgruppen zurück. ``` aws memorydb describe-subnet-groups ``` Ausgabe ``` { "SubnetGroups": [ { "Name": "my-sg", "Description": "pat-sg", "VpcId": "vpc-86xxx4fc", "Subnets": [ { "Identifier": "subnet-faxx84a6", "AvailabilityZone": { "Name": "us-east-1b" } }, { "Identifier": "subnet-56xxf61b", "AvailabilityZone": { "Name": "us-east-1a" } } ], "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:subnetgroup/my-sg" } ] } ``` Weitere Informationen finden Sie unter [Subnetze und Subnetzgruppen](https://docs.aws.amazon.com/memorydb/latest/devguide/subnetgroups.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DescribeSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/describe-subnet-groups.html)in der *AWS CLI Befehlsreferenz.* ### `describe-users` Das folgende Codebeispiel zeigt die Verwendung`describe-users`. **AWS CLI** **So geben Sie eine Liste von Benutzern zurück** Der folgende Befehl „describe-users`“ gibt eine Liste von Benutzern zurück. ``` aws memorydb describe-users ``` Ausgabe ``` { "Users": [ { "Name": "default", "Status": "active", "AccessString": "on ~* &* +@all", "ACLNames": [ "open-access" ], "MinimumEngineVersion": "6.0", "Authentication": { "Type": "no-password" }, "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:user/default" }, { "Name": "my-user", "Status": "active", "AccessString": "off ~objects:* ~items:* ~public:* resetchannels -@all", "ACLNames": [], "MinimumEngineVersion": "6.2", "Authentication": { "Type": "password", "PasswordCount": 2 }, "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:user/my-user" } ] } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit Zugriffssteuerungslisten](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.acls.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [DescribeUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/describe-users.html)in der *AWS CLI Befehlsreferenz*. ### `failover-shard` Das folgende Codebeispiel zeigt die Verwendung`failover-shard`. **AWS CLI** **So führen Sie ein Failover für einen Shard durch** Der folgende Befehl „failover-shard`“ führt ein Failover für einen Shard durch. ``` aws memorydb failover-shard \ --cluster-name my-cluster --shard-name 0001 ``` Ausgabe: ``` { "Cluster": { "Name": "my-cluster", "Status": "available", "NumberOfShards": 2, "ClusterEndpoint": { "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "default.memorydb-redis6", "ParameterGroupStatus": "in-sync", "SecurityGroups": [ { "SecurityGroupId": "sg-0a143xxxx45c9fae", "Status": "active" } ], "SubnetGroupName": "my-sg", "TLSEnabled": true, "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "wed:03:00-wed:04:00", "SnapshotWindow": "04:30-05:30", "AutoMinorVersionUpgrade": true } } ``` Weitere Informationen finden Sie unter [Minimieren von Ausfallzeiten mit MultiAZ](https://docs.aws.amazon.com/memorydb/latest/devguide/autofailover.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [FailoverShard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/failover-shard.html)in der *AWS CLI Befehlsreferenz*. ### `list-allowed-node-type-updates` Das folgende Codebeispiel zeigt die Verwendung`list-allowed-node-type-updates`. **AWS CLI** **So geben Sie eine Liste der zulässigen Knotentypaktualisierungen zurück** Mit dem folgenden list-allowed-node-type Befehl -updates wird eine Liste verfügbarer Knotentyp-Updates zurückgegeben. ``` aws memorydb list-allowed-node-type-updates ``` Ausgabe: ``` { "Cluster": { "Name": "my-cluster", "Status": "available", "NumberOfShards": 2, "ClusterEndpoint": { "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com", "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "default.memorydb-redis6", "ParameterGroupStatus": "in-sync", "SecurityGroups": [ { "SecurityGroupId": "sg-0a143xxxx45c9fae", "Status": "active" } ], "SubnetGroupName": "my-sg", "TLSEnabled": true, "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "wed:03:00-wed:04:00", "SnapshotWindow": "04:30-05:30", "AutoMinorVersionUpgrade": true } } ``` Weitere Informationen finden Sie unter [Skalierung](https://docs.aws.amazon.com/memorydb/latest/devguide/scaling.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [ListAllowedNodeTypeUpdates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/list-allowed-node-type-updates.html)in der *AWS CLI Befehlsreferenz.* ### `list-tags` Das folgende Codebeispiel zeigt die Verwendung`list-tags`. **AWS CLI** **So geben Sie eine Liste von Tags zurück** Der folgende Befehl „list-tags“ gibt eine Liste von Tags zurück. ``` aws memorydb list-tags \ --resource-arn arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster ``` Ausgabe: ``` { "TagList": [ { "Key": "mytag", "Value": "myvalue" } ] } ``` Weitere Informationen finden Sie unter [Markieren von Ressourcen](https://docs.aws.amazon.com/memorydb/latest/devguide/tagging-resources.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [ListTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/list-tags.html)in der *AWS CLI Befehlsreferenz*. ### `reset-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`reset-parameter-group`. **AWS CLI** **So setzen Sie eine Parametergruppe zurück** Das folgende reset-parameter-group `setzt eine Parametergruppe zurück. ``` aws memorydb reset-parameter-group \ --parameter-group-name my-parameter-group \ --all-parameters ``` Ausgabe: ``` { "ParameterGroup": { "Name": "my-parameter-group", "Family": "memorydb_redis6", "Description": "my parameter group", "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:parametergroup/my-parameter-group" } } ``` Weitere Informationen finden Sie unter [Konfigurieren von Engine-Parametern mithilfe von Parametergruppen](https://docs.aws.amazon.com/memorydb/latest/devguide/parametergroups.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [ResetParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/reset-parameter-group.html)in der *AWS CLI Befehlsreferenz.* ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Der folgende Befehl „tag-resource`“ fügt einer Ressource ein Tag hinzu. ``` aws memorydb tag-resource \ --resource-arn arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster \ --tags Key="mykey",Value="myvalue" ``` Ausgabe: ``` { "TagList": [ { "Key": "mytag", "Value": "myvalue" }, { "Key": "mykey", "Value": "myvalue" } ] } ``` Weitere Informationen finden Sie unter [Markieren von Ressourcen](https://docs.aws.amazon.com/memorydb/latest/devguide/tagging-resources.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So aktualisieren Sie eine ACL** Der folgende Befehl „update-acl`“ aktualisiert eine ACL, indem ein Benutzer hinzugefügt wird. ``` aws memorydb untag-resource \ --resource-arn arn:aws:memorydb:us-east-1:491658xxxxx:cluster/my-cluster \ --tag-keys mykey ``` Ausgabe: ``` { "TagList": [ { "Key": "mytag", "Value": "myvalue" } ] } ``` Weitere Informationen finden Sie unter [Markieren von Ressourcen](https://docs.aws.amazon.com/memorydb/latest/devguide/tagging-resources.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-cluster` Das folgende Codebeispiel zeigt die Verwendung`update-cluster`. **AWS CLI** **So aktualisieren Sie einen Cluster** Der folgende Update-Cluster`` aktualisiert die Parametergruppe eines Clusters auf. my-parameter-group ``` aws memorydb update-cluster \ --cluster-name my-cluster \ --parameter-group-name my-parameter-group ``` Ausgabe: ``` { "Cluster": { "Name": "my-cluster", "Status": "available", "NumberOfShards": 2, "AvailabilityMode": "MultiAZ", "ClusterEndpoint": { "Address": "clustercfg.my-cluster.llru6f.memorydb.us-east-1.amazonaws.com", "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "6.2", "EnginePatchVersion": "6.2.6", "ParameterGroupName": "my-parameter-group", "ParameterGroupStatus": "in-sync", "SecurityGroups": [ { "SecurityGroupId": "sg-0a143xxxxxc9fae", "Status": "active" } ], "SubnetGroupName": "pat-sg", "TLSEnabled": true, "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "wed:03:00-wed:04:00", "SnapshotWindow": "04:30-05:30", "ACLName": "my-acl", "AutoMinorVersionUpgrade": true } } ``` Weitere Informationen finden Sie unter [Modifizieren eines Clusters](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.modify.html) im *Benutzerhandbuch für MemoryDB*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [UpdateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/update-cluster.html)AWS CLI * ### `update-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`update-parameter-group`. **AWS CLI** **So aktualisieren Sie eine Parametergruppe** Das folgende update-parameter-group ``aktualisiert eine Parametergruppe. ``` aws memorydb update-parameter-group \ --parameter-group-name my-parameter-group \ --parameter-name-values "ParameterName=activedefrag, ParameterValue=no" ``` Ausgabe: ``` { "ParameterGroup": { "Name": "my-parameter-group", "Family": "memorydb_redis6", "Description": "my parameter group", "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:parametergroup/my-parameter-group" } } ``` Weitere Informationen finden Sie unter [Modifizieren einer Parametergruppe](https://docs.aws.amazon.com/memorydb/latest/devguide/parametergroups.modifying.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [UpdateParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/update-parameter-group.html)in der *AWS CLI Befehlsreferenz.* ### `update-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`update-subnet-group`. **AWS CLI** **So aktualisieren Sie eine Subnetzgruppe** Das folgende update-subnet-group `aktualisiert die Subnetz-ID einer Subnetzgruppe. ``` aws memorydb update-subnet-group \ --subnet-group-name my-sg \ --subnet-ids subnet-01f29d458f3xxxxx ``` Ausgabe: ``` { "SubnetGroup": { "Name": "my-sg-1", "Description": "my-sg", "VpcId": "vpc-09d2cfc01xxxxxxx", "Subnets": [ { "Identifier": "subnet-01f29d458fxxxxxx", "AvailabilityZone": { "Name": "us-east-1a" } } ], "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:subnetgroup/my-sg" } } ``` Weitere Informationen finden Sie unter [Subnetze und Subnetzgruppen](https://docs.aws.amazon.com/memorydb/latest/devguide/subnetgroups.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [UpdateSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/update-subnet-group.html)in der *AWS CLI Befehlsreferenz*. ### `update-user` Das folgende Codebeispiel zeigt die Verwendung`update-user`. **AWS CLI** **Um einen Benutzer zu aktualisieren** Im folgenden Beispiel für `update-user` wird die Zugriffszeichenfolge eines Benutzers geändert. ``` aws memorydb update-user \ --user-name my-user \ --access-string "off ~objects:* ~items:* ~public:* resetchannels -@all" ``` Ausgabe: ``` { "User": { "Name": "my-user", "Status": "modifying", "AccessString": "off ~objects:* ~items:* ~public:* resetchannels -@all", "ACLNames": [ "myt-acl" ], "MinimumEngineVersion": "6.2", "Authentication": { "Type": "password", "PasswordCount": 2 }, "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:user/my-user" } } ``` Weitere Informationen finden Sie unter [Authentifizieren von Benutzern mit Zugriffssteuerungslisten](https://docs.aws.amazon.com/memorydb/latest/devguide/clusters.acls.html) im *Benutzerhandbuch für MemoryDB*. + Einzelheiten zur API finden Sie [UpdateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/memorydb/update-user.html)in der *AWS CLI Befehlsreferenz*. # Amazon MSK-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon MSK Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-cluster` Das folgende Codebeispiel zeigt, wie Sie`create-cluster`. **AWS CLI** **So erstellen Sie einen Amazon-MSK-Cluster** Im folgenden Beispiel für `create-cluster` wird ein MSK-Cluster mit dem Namen `MessagingCluster` mit drei Broker-Knoten erstellt. Eine JSON-Datei mit dem Namen `brokernodegroupinfo.json` gibt die drei Subnetze an, über die Amazon MSK die Broker-Knoten verteilen soll. In diesem Beispiel wird die Überwachungsebene nicht angegeben, sodass der Cluster die Ebene `DEFAULT` erhält. ``` aws kafka create-cluster \ --cluster-name "MessagingCluster" \ --broker-node-group-info file://brokernodegroupinfo.json \ --kafka-version "2.2.1" \ --number-of-broker-nodes 3 ``` Inhalt von `brokernodegroupinfo.json`: ``` { "InstanceType": "kafka.m5.xlarge", "BrokerAZDistribution": "DEFAULT", "ClientSubnets": [ "subnet-0123456789111abcd", "subnet-0123456789222abcd", "subnet-0123456789333abcd" ] } ``` Ausgabe: ``` { "ClusterArn": "arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "ClusterName": "MessagingCluster", "State": "CREATING" } ``` Weitere Informationen finden Sie unter [Erstellen eines Amazon-MSK-Clusters](https://docs.aws.amazon.com/msk/latest/developerguide/msk-create-cluster.html) in *Amazon Managed Streaming für Apache Kafka*. + Einzelheiten zur API finden Sie [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/create-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `create-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-configuration`. **AWS CLI** **So erstellen Sie eine benutzerdefinierte Amazon-MSK-Konfiguration** Im folgenden Beispiel für `create-configuration` wird eine benutzerdefinierte MSK-Konfiguration mit den Servereigenschaften erstellt, die in der Eingabedatei angegeben sind. ``` aws kafka create-configuration \ --name "CustomConfiguration" \ --description "Topic autocreation enabled; Apache ZooKeeper timeout 2000 ms; Log rolling 604800000 ms." \ --kafka-versions "2.2.1" \ --server-properties file://configuration.txt ``` Inhalt von `configuration.txt`: ``` auto.create.topics.enable = true zookeeper.connection.timeout.ms = 2000 log.roll.ms = 604800000 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe: ``` { "Arn": "arn:aws:kafka:us-west-2:123456789012:configuration/CustomConfiguration/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "CreationTime": "2019-10-09T15:26:05.548Z", "LatestRevision": { "CreationTime": "2019-10-09T15:26:05.548Z", "Description": "Topic autocreation enabled; Apache ZooKeeper timeout 2000 ms; Log rolling 604800000 ms.", "Revision": 1 }, "Name": "CustomConfiguration" } ``` Weitere Informationen finden Sie unter [Amazon-MSK-Konfigurationsvorgänge](https://docs.aws.amazon.com/msk/latest/developerguide/msk-configuration-operations.html) im *Entwicklerhandbuch für Amazon Managed Streaming für Apache Kafka*. + Einzelheiten zur API finden Sie [CreateConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/create-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cluster` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster`. **AWS CLI** **So beschreiben Sie einen Cluster** Mit dem folgenden Beispiel für `describe-cluster` wird ein Amazon-MSK-Cluster beschrieben. ``` aws kafka describe-cluster \ --cluster-arn arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5 ``` Ausgabe: ``` { "ClusterInfo": { "BrokerNodeGroupInfo": { "BrokerAZDistribution": "DEFAULT", "ClientSubnets": [ "subnet-cbfff283", "subnet-6746046b" ], "InstanceType": "kafka.m5.large", "SecurityGroups": [ "sg-f839b688" ], "StorageInfo": { "EbsStorageInfo": { "VolumeSize": 100 } } }, "ClusterArn": "arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5", "ClusterName": "demo-cluster-1", "CreationTime": "2020-07-09T02:31:36.223000+00:00", "CurrentBrokerSoftwareInfo": { "KafkaVersion": "2.2.1" }, "CurrentVersion": "K3AEGXETSR30VB", "EncryptionInfo": { "EncryptionAtRest": { "DataVolumeKMSKeyId": "arn:aws:kms:us-east-1:123456789012:key/a7ca56d5-0768-4b64-a670-339a9fbef81c" }, "EncryptionInTransit": { "ClientBroker": "TLS_PLAINTEXT", "InCluster": true } }, "EnhancedMonitoring": "DEFAULT", "OpenMonitoring": { "Prometheus": { "JmxExporter": { "EnabledInBroker": false }, "NodeExporter": { "EnabledInBroker": false } } }, "NumberOfBrokerNodes": 2, "State": "ACTIVE", "Tags": {}, "ZookeeperConnectString": "z-2.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181,z-1.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181,z-3.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181" } } ``` Weitere Informationen finden Sie unter [Auflisten von Amazon-MSK-Clustern](https://docs.aws.amazon.com/msk/latest/developerguide/msk-list-clusters.html) im *Entwicklerhandbuch für Amazon Managed Streaming für Apache Kafka*. + Einzelheiten zur API finden Sie [DescribeCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `get-bootstrap-brokers` Das folgende Codebeispiel zeigt die Verwendung`get-bootstrap-brokers`. **AWS CLI** **So rufen Sie Bootstrap-Broker ab** Im folgenden Beispiel für `get-bootstrap-brokers` werden die Bootstrap-Brokerinformationen für einen Amazon-MSK-Cluster abgerufen. ``` aws kafka get-bootstrap-brokers \ --cluster-arn arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5 ``` Ausgabe: ``` { "BootstrapBrokerString": "b-1.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:9092,b-2.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:9092", "BootstrapBrokerStringTls": "b-1.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:9094,b-2.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:9094" } ``` Weitere Informationen finden Sie unter [Abrufen der Bootstrap-Broker](https://docs.aws.amazon.com/msk/latest/developerguide/msk-get-bootstrap-brokers.html) im *Entwicklerhandbuch für Amazon Managed Streaming für Apache Kafka*. + Einzelheiten zur API finden Sie [GetBootstrapBrokers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/get-bootstrap-brokers.html)in der *AWS CLI Befehlsreferenz*. ### `list-clusters` Das folgende Codebeispiel zeigt die Verwendung`list-clusters`. **AWS CLI** **So listen Sie die verfügbaren Cluster auf** Das folgende `list-clusters` Beispiel listet die Amazon MSK-Cluster in Ihrem AWS Konto auf. ``` aws kafka list-clusters ``` Ausgabe: ``` { "ClusterInfoList": [ { "BrokerNodeGroupInfo": { "BrokerAZDistribution": "DEFAULT", "ClientSubnets": [ "subnet-cbfff283", "subnet-6746046b" ], "InstanceType": "kafka.m5.large", "SecurityGroups": [ "sg-f839b688" ], "StorageInfo": { "EbsStorageInfo": { "VolumeSize": 100 } } }, "ClusterArn": "arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5", "ClusterName": "demo-cluster-1", "CreationTime": "2020-07-09T02:31:36.223000+00:00", "CurrentBrokerSoftwareInfo": { "KafkaVersion": "2.2.1" }, "CurrentVersion": "K3AEGXETSR30VB", "EncryptionInfo": { "EncryptionAtRest": { "DataVolumeKMSKeyId": "arn:aws:kms:us-east-1:123456789012:key/a7ca56d5-0768-4b64-a670-339a9fbef81c" }, "EncryptionInTransit": { "ClientBroker": "TLS_PLAINTEXT", "InCluster": true } }, "EnhancedMonitoring": "DEFAULT", "OpenMonitoring": { "Prometheus": { "JmxExporter": { "EnabledInBroker": false }, "NodeExporter": { "EnabledInBroker": false } } }, "NumberOfBrokerNodes": 2, "State": "ACTIVE", "Tags": {}, "ZookeeperConnectString": "z-2.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181,z-1.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181,z-3.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181" } ] } ``` Weitere Informationen finden Sie unter [Auflisten von Amazon-MSK-Clustern](https://docs.aws.amazon.com/msk/latest/developerguide/msk-list-clusters.html) im *Entwicklerhandbuch für Amazon Managed Streaming für Apache Kafka*. + Einzelheiten zur API finden Sie [ListClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/list-clusters.html)in der *AWS CLI Befehlsreferenz.* ### `update-broker-storage` Das folgende Codebeispiel zeigt die Verwendung`update-broker-storage`. **AWS CLI** **So aktualisieren Sie den EBS-Speicher für Broker** Im folgenden Beispiel für `update-broker-storage` wird die Menge des EBS-Speichers für alle Broker im Cluster aktualisiert. Amazon MSK legt den Zielspeicherbetrag für jeden Broker auf den im Beispiel angegebenen Betrag fest. Sie können die aktuelle Version des Clusters abrufen, indem Sie den Cluster beschreiben oder alle Cluster auflisten. ``` aws kafka update-broker-storage \ --cluster-arn "arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2" \ --current-version "K21V3IB1VIZYYH" \ --target-broker-ebs-volume-info "KafkaBrokerNodeId=ALL,VolumeSizeGB=1100" ``` Die Ausgabe gibt einen ARN für diesen `update-broker-storage`-Vorgang zurück. Um festzustellen, ob dieser Vorgang abgeschlossen ist, verwenden Sie den `describe-cluster-operation`-Befehl mit diesem ARN als Eingabe. ``` { "ClusterArn": "arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "ClusterOperationArn": "arn:aws:kafka:us-west-2:123456789012:cluster-operation/V123450123/a1b2c3d4-1234-abcd-cdef-22222EXAMPLE-2/a1b2c3d4-abcd-1234-bcde-33333EXAMPLE" } ``` Weitere Informationen finden Sie unter [Aktualisieren des EBS-Speichers für Broker](https://docs.aws.amazon.com/msk/latest/developerguide/msk-update-storage.html) im *Entwicklerhandbuch für Amazon Managed Streaming für Apache Kafka*. + Einzelheiten zur API finden Sie [UpdateBrokerStorage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/update-broker-storage.html)in der *AWS CLI Befehlsreferenz*. ### `update-cluster-configuration` Das folgende Codebeispiel zeigt die Verwendung`update-cluster-configuration`. **AWS CLI** **So aktualisieren Sie die Konfiguration eines Amazon-MSK-Clusters** Im folgenden Beispiel für `update-cluster-configuration` wird die Konfiguration des angegebenen vorhandenen MSK-Clusters aktualisiert. Es verwendet eine benutzerdefinierte MSK-Konfiguration. ``` aws kafka update-cluster-configuration \ --cluster-arn "arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2" \ --configuration-info file://configuration-info.json \ --current-version "K21V3IB1VIZYYH" ``` Inhalt von `configuration-info.json`: ``` { "Arn": "arn:aws:kafka:us-west-2:123456789012:configuration/CustomConfiguration/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "Revision": 1 } ``` Die Ausgabe gibt einen ARN für diesen `update-cluster-configuration`-Vorgang zurück. Um festzustellen, ob dieser Vorgang abgeschlossen ist, verwenden Sie den `describe-cluster-operation`-Befehl mit diesem ARN als Eingabe. ``` { "ClusterArn": "arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "ClusterOperationArn": "arn:aws:kafka:us-west-2:123456789012:cluster-operation/V123450123/a1b2c3d4-1234-abcd-cdef-22222EXAMPLE-2/a1b2c3d4-abcd-1234-bcde-33333EXAMPLE" } ``` Weitere Informationen finden Sie unter [Aktualisieren der Cluster-Konfiguration eines Amazon-MSK-Clusters](https://docs.aws.amazon.com/msk/latest/developerguide/msk-update-cluster-cofig.html) im *Entwicklerhandbuch für Amazon Managed Streaming für Apache Kafka*. + Einzelheiten zur API finden Sie [UpdateClusterConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/update-cluster-configuration.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Network Flow Monitor mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Network Flow Monitor Aktionen ausführen und allgemeine Szenarien implementieren können. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-monitor` Das folgende Codebeispiel zeigt die Verwendung von`create-monitor`. **AWS CLI** **Um einen Monitor zu erstellen** Im folgenden Beispiel für `create-monitor` wird ein Monitor mit dem Namen `demo` im angegebenen Konto erstellt. ``` aws networkflowmonitor create-monitor \ --monitor-name demo \ --local-resources type="AWS::EC2::VPC",identifier="arn:aws:ec2:us-east-1:123456789012:vpc/vpc-03ea55eeda25adbb0" \ --scope-arn arn:aws:networkflowmonitor:us-east-1:123456789012:scope/e21cda79-30a0-4c12-9299-d8629d76d8cf ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/demo", "monitorName": "demo", "monitorStatus": "ACTIVE", "tags": {} } ``` Weitere Informationen finden Sie unter [Erstellen eines Monitors in Network Flow Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-monitors-create.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/create-monitor.html)unter *AWS CLI Befehlsreferenz*. ### `create-scope` Das folgende Codebeispiel zeigt die Verwendung`create-scope`. **AWS CLI** **So erstellen Sie einen Bereich** Im folgenden Beispiel für `create-scope` wird ein Bereich mit einer Reihe von Ressourcen erstellt, für die Network Flow Monitor Metriken zum Netzwerkverkehr generiert. ``` aws networkflowmonitor create-scope \ --targets '[{"targetIdentifier":{"targetId":{"accountId":"123456789012"},"targetType":"ACCOUNT"},"region":"us-east-1"}]' ``` Ausgabe: ``` { "scopeId": "97626f8d-8a21-4b5d-813a-1a0962dd4615", "status": "IN_PROGRESS", "tags": {} } ``` Weitere Informationen finden Sie unter [Komponenten und Funktionen von Network Flow Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-components.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateScope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/create-scope.html)in der *AWS CLI Befehlsreferenz*. ### `delete-monitor` Das folgende Codebeispiel zeigt die Verwendung`delete-monitor`. **AWS CLI** **So löschen Sie einen Monitor** Im folgenden Beispiel für `delete-monitor` wird ein Monitor mit dem Namen `demo` im angegebenen Konto gelöscht. ``` aws networkflowmonitor delete-monitor \ --monitor-name demo ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Monitors in Network Flow Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-monitors-delete.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/delete-monitor.html)unter *AWS CLI Befehlsreferenz*. ### `delete-scope` Das folgende Codebeispiel zeigt die Verwendung`delete-scope`. **AWS CLI** **Um einen Bereich zu löschen** Im folgenden Beispiel für `delete-scope` wird der angegebene Bereich gelöscht. ``` aws networkflowmonitor delete-scope \ --scope-id fdc20616-6bb4-4242-a24e-a748e65ca7ac ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Komponenten und Funktionen von Network Flow Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-components.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteScope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/delete-scope.html)in der *AWS CLI Befehlsreferenz*. ### `get-monitor` Das folgende Codebeispiel zeigt die Verwendung`get-monitor`. **AWS CLI** **So rufen Sie Informationen zu einem Monitor ab** Im folgenden Beispiel für `get-monitor` werden Informationen zum Monitor `demo` im angegebenen Konto angezeigt. ``` aws networkflowmonitor get-monitor \ --monitor-name Demo ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo", "monitorName": "Demo", "monitorStatus": "ACTIVE", "localResources": [ { "type": "AWS::EC2::VPC", "identifier": "arn:aws:ec2:us-east-1:123456789012:vpc/vpc-03ea55eeda25adbb0" } ], "remoteResources": [], "createdAt": "2024-12-09T12:21:51.616000-06:00", "modifiedAt": "2024-12-09T12:21:55.412000-06:00", "tags": {} } ``` Weitere Informationen finden Sie unter [Komponenten und Funktionen von Network Flow Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-components.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/get-monitor.html)in der *AWS CLI Befehlsreferenz*. ### `get-query-results-workload-insights-top-contributors-data` Das folgende Codebeispiel zeigt die Verwendung`get-query-results-workload-insights-top-contributors-data`. **AWS CLI** **So rufen Sie die wichtigsten Contributor-Daten für Workload-Einblicke ab** Im folgenden Beispiel für `get-query-results-workload-insights-top-contributors-data` werden die Daten für die angegebene Abfrage zurückgegeben. ``` aws networkflowmonitor get-query-results-workload-insights-top-contributors-data \ --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \ --query-id cc4f4ab3-3103-33b8-80ff-d6597a0c6cea ``` Ausgabe: ``` { "datapoints": [ { "timestamps": [ "2024-12-09T19:00:00+00:00", "2024-12-09T19:05:00+00:00", "2024-12-09T19:10:00+00:00" ], "values": [ 259943.0, 194856.0, 216432.0 ], "label": "use1-az6" } ], "unit": "Bytes" } ``` Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetQueryResultsWorkloadInsightsTopContributorsData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/get-query-results-workload-insights-top-contributors-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-query-results-workload-insights-top-contributors` Das folgende Codebeispiel zeigt die Verwendung`get-query-results-workload-insights-top-contributors`. **AWS CLI** **So rufen Sie die wichtigsten Contributors für Workload-Einblicke ab** Im folgenden Beispiel für `get-query-results-workload-insights-top-contributors` werden die Daten für die angegebene Abfrage zurückgegeben. ``` aws networkflowmonitor get-query-results-workload-insights-top-contributors \ --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \ --query-id 1fc423d3-b144-37a6-80e6-e2c7d26eea0c ``` Ausgabe: ``` { "topContributors": [ { "accountId": "123456789012", "localSubnetId": "subnet-0a5b30fb95dca2c14", "localAz": "use1-az6", "localVpcId": "vpc-03ea55eeda25adbb0", "localRegion": "us-east-1", "remoteIdentifier": "", "value": 908443, "localSubnetArn": "arn:aws:ec2:us-east-1:123456789012:subnet/subnet-0a5b30fb95dca2c14", "localVpcArn": "arn:aws:ec2:us-east-1:123456789012:vpc/vpc-03ea55eeda25adbb0" } ] } ``` Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetQueryResultsWorkloadInsightsTopContributors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/get-query-results-workload-insights-top-contributors.html)in der *AWS CLI Befehlsreferenz*. ### `get-query-status-monitor-top-contributors` Das folgende Codebeispiel zeigt die Verwendung`get-query-status-monitor-top-contributors`. **AWS CLI** **So rufen Sie den Status der Abfrage ab** Im folgenden Beispiel für `get-query-status-monitor-top-contributors` wird der aktuelle Status der Abfrage im angegebenen Konto angezeigt. ``` aws networkflowmonitor get-query-status-monitor-top-contributors \ --monitor-name Demo \ --query-id 5398eabd-bc40-3f5f-aba3-bcb639d3c7ca ``` Ausgabe: ``` { "status": "SUCCEEDED" } ``` Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetQueryStatusMonitorTopContributors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/get-query-status-monitor-top-contributors.html)in der *AWS CLI Befehlsreferenz*. ### `get-query-status-workload-insights-top-contributors-data` Das folgende Codebeispiel zeigt die Verwendung`get-query-status-workload-insights-top-contributors-data`. **AWS CLI** **So rufen Sie den Status der Abfrage ab** Im folgenden Beispiel für `get-query-status-workload-insights-top-contributors-data` wird der aktuelle Status der Abfrage im angegebenen Konto angezeigt. ``` aws networkflowmonitor get-query-status-workload-insights-top-contributors-data \ --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \ --query-id 4333754d-8ae1-3f29-b6b7-c36db2e7f8ac ``` Ausgabe: ``` { "status": "SUCCEEDED" } ``` Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetQueryStatusWorkloadInsightsTopContributorsData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/get-query-status-workload-insights-top-contributors-data.html)in der *AWS CLI Befehlsreferenz*. ### `get-query-status-workload-insights-top-contributors` Das folgende Codebeispiel zeigt die Verwendung`get-query-status-workload-insights-top-contributors`. **AWS CLI** **So rufen Sie den Status der Abfrage ab** Im folgenden Beispiel für `get-query-status-workload-insights-top-contributors` wird der aktuelle Status der Abfrage im angegebenen Konto angezeigt. ``` aws networkflowmonitor get-query-status-workload-insights-top-contributors \ --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \ --query-id f2a87c70-3e5a-362e-8beb-4747d13d8419 ``` Ausgabe: ``` { "status": "SUCCEEDED" } ``` Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetQueryStatusWorkloadInsightsTopContributors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/get-query-status-workload-insights-top-contributors.html)in der *AWS CLI Befehlsreferenz*. ### `get-scope` Das folgende Codebeispiel zeigt die Verwendung`get-scope`. **AWS CLI** **So rufen Sie Informationen zu einem Auftrag ab** Im folgenden Beispiel für `get-scope` werden Informationen zu einem Bereich angezeigt, z. B. Status, Tags, Name und Zieldetails. ``` aws networkflowmonitor get-scope \ --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf ``` Ausgabe: ``` { "scopeId": "e21cda79-30a0-4c12-9299-d8629d76d8cf", "status": "SUCCEEDED", "scopeArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:scope/e21cda79-30a0-4c12-9299-d8629d76d8cf", "targets": [ { "targetIdentifier": { "targetId": { "accountId": "123456789012" }, "targetType": "ACCOUNT" }, "region": "us-east-1" } ], "tags": {} } ``` Weitere Informationen finden Sie unter [Komponenten und Funktionen von Network Flow Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-components.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetScope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/get-scope.html)in der *AWS CLI Befehlsreferenz*. ### `list-monitors` Das folgende Codebeispiel zeigt die Verwendung`list-monitors`. **AWS CLI** **So rufen Sie eine Liste von Monitoren ab** Im folgenden Beispiel für `list-monitors` werden alle Monitore im angegebenen Konto zurückgegeben. ``` aws networkflowmonitor list-monitors ``` Ausgabe: ``` { "monitors": [ { "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo", "monitorName": "Demo", "monitorStatus": "ACTIVE" } ] } ``` Weitere Informationen finden Sie unter [Komponenten und Funktionen von Network Flow Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-components.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListMonitors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/list-monitors.html)in der *AWS CLI Befehlsreferenz*. ### `list-scopes` Das folgende Codebeispiel zeigt die Verwendung`list-scopes`. **AWS CLI** **So rufen Sie eine Liste von Bereichen ab** Im folgenden Beispiel für `list-scopes` werden alle Dashboards im angegebenen Konto aufgelistet. ``` aws networkflowmonitor list-scopes ``` Ausgabe: ``` { "scopes": [ { "scopeId": "fdc20616-6bb4-4242-a24e-a748e65ca7ac", "status": "SUCCEEDED", "scopeArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:scope/fdc20616-6bb4-4242-a24e-a748e65ca7ac" } ] } ``` Weitere Informationen finden Sie unter [Komponenten und Funktionen von Network Flow Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-components.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListScopes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/list-scopes.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags abgerufen, die der angegebenen Ressource zugeordnet sind. ``` aws networkflowmonitor list-tags-for-resource \ --resource-arn arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo ``` Ausgabe: ``` { "tags": { "Value": "Production", "Key": "stack" } } ``` Weitere Informationen finden Sie unter [Taggen Ihrer CloudWatch Amazon-Ressourcen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.* ### `start-query-monitor-top-contributors` Das folgende Codebeispiel zeigt die Verwendung`start-query-monitor-top-contributors`. **AWS CLI** **So starten Sie eine Abfrage** Im folgenden Beispiel für `start-query-monitor-top-contributors` wird die Abfrage gestartet, die eine Abfrage-ID zurückgibt, um die wichtigsten Mitwirkenden abzurufen. ``` aws networkflowmonitor start-query-monitor-top-contributors \ --monitor-name Demo \ --start-time 2024-12-09T19:00:00Z \ --end-time 2024-12-09T19:15:00Z \ --metric-name DATA_TRANSFERRED \ --destination-category UNCLASSIFIED ``` Ausgabe: ``` { "queryId": "aecd3a88-0283-35b0-a17d-6e944dc8531d" } ``` Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartQueryMonitorTopContributors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/start-query-monitor-top-contributors.html)in der *AWS CLI Befehlsreferenz*. ### `start-query-workload-insights-top-contributors-data` Das folgende Codebeispiel zeigt die Verwendung`start-query-workload-insights-top-contributors-data`. **AWS CLI** **So starten Sie eine Abfrage** Im folgenden Beispiel für `start-query-workload-insights-top-contributors-data` wird die Abfrage gestartet, die eine Abfrage-ID zurückgibt, um die wichtigsten Mitwirkenden abzurufen. ``` aws networkflowmonitor start-query-workload-insights-top-contributors-data \ --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \ --start-time 2024-12-09T19:00:00Z \ --end-time 2024-12-09T19:15:00Z \ --metric-name DATA_TRANSFERRED \ --destination-category UNCLASSIFIED ``` Ausgabe: ``` { "queryId": "cc4f4ab3-3103-33b8-80ff-d6597a0c6cea" } ``` Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartQueryWorkloadInsightsTopContributorsData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/start-query-workload-insights-top-contributors-data.html)in der *AWS CLI Befehlsreferenz*. ### `start-query-workload-insights-top-contributors` Das folgende Codebeispiel zeigt die Verwendung`start-query-workload-insights-top-contributors`. **AWS CLI** **So starten Sie eine Abfrage** Im folgenden Beispiel für `start-query-workload-insights-top-contributors` wird die Abfrage gestartet, die eine Abfrage-ID zurückgibt, um die wichtigsten Mitwirkenden abzurufen. ``` aws networkflowmonitor start-query-workload-insights-top-contributors \ --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \ --start-time 2024-12-09T19:00:00Z \ --end-time 2024-12-09T19:15:00Z \ --metric-name DATA_TRANSFERRED \ --destination-category UNCLASSIFIED ``` Ausgabe: ``` { "queryId": "1fc423d3-b144-37a6-80e6-e2c7d26eea0c" } ``` Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StartQueryWorkloadInsightsTopContributors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/start-query-workload-insights-top-contributors.html)in der *AWS CLI Befehlsreferenz*. ### `stop-query-monitor-top-contributors` Das folgende Codebeispiel zeigt die Verwendung`stop-query-monitor-top-contributors`. **AWS CLI** **So beenden Sie eine Abfrage** Im folgenden Beispiel für `stop-query-monitor-top-contributors` wird die Abfrage im angegebenen Konto beendet. ``` aws networkflowmonitor stop-query-monitor-top-contributors \ --monitor-name Demo \ --query-id aecd3a88-0283-35b0-a17d-6e944dc8531d ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopQueryMonitorTopContributors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/stop-query-monitor-top-contributors.html)in der *AWS CLI Befehlsreferenz*. ### `stop-query-workload-insights-top-contributors-data` Das folgende Codebeispiel zeigt die Verwendung`stop-query-workload-insights-top-contributors-data`. **AWS CLI** **So beenden Sie eine Abfrage** Im folgenden Beispiel für `stop-query-workload-insights-top-contributors-data` wird die Abfrage im angegebenen Konto beendet. ``` aws networkflowmonitor stop-query-workload-insights-top-contributors-data \ --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \ --query-id cc4f4ab3-3103-33b8-80ff-d6597a0c6cea ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopQueryWorkloadInsightsTopContributorsData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/stop-query-workload-insights-top-contributors-data.html)in der *AWS CLI Befehlsreferenz*. ### `stop-query-workload-insights-top-contributors` Das folgende Codebeispiel zeigt die Verwendung`stop-query-workload-insights-top-contributors`. **AWS CLI** **So beenden Sie eine Abfrage** Im folgenden Beispiel für `stop-query-workload-insights-top-contributors` wird die Abfrage im angegebenen Konto beendet. ``` aws networkflowmonitor stop-query-workload-insights-top-contributors \ --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \ --query-id 1fc423d3-b144-37a6-80e6-e2c7d26eea0c ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [StopQueryWorkloadInsightsTopContributors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/stop-query-workload-insights-top-contributors.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie der angegebenen Ressource ein Tag hinzu** Im folgenden Beispiel für `tag-resource` wird ein Monitor im angegebenen Konto mit einem Tag versehen. ``` aws networkflowmonitor tag-resource \ --resource-arn arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo \ --tags Key=stack,Value=Production ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer CloudWatch Amazon-Ressourcen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/tag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen ein Tag aus der angegebenen Ressource** Im folgenden Beispiel für `untag-resource` wird ein Tag aus einem Monitor im angegebenen Konto entfernt. ``` aws networkflowmonitor untag-resource \ --resource-arn arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo \ --tag-keys stack ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Taggen Ihrer CloudWatch Amazon-Ressourcen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/untag-resource.html)in der *AWS CLI Befehlsreferenz.* ### `update-monitor` Das folgende Codebeispiel zeigt die Verwendung`update-monitor`. **AWS CLI** **So aktualisieren sie einen vorhandenen Monitor** Im folgenden Beispiel für `update-monitor` wird ein Monitor mit dem Namen `Demo` im angegebenen Konto aktualisiert. ``` aws networkflowmonitor update-monitor \ --monitor-name Demo \ --local-resources-to-add type="AWS::EC2::VPC",identifier="arn:aws:ec2:us-east-1:123456789012:vpc/vpc-048d08dfbec623f94" ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo", "monitorName": "Demo", "monitorStatus": "ACTIVE", "tags": { "Value": "Production", "Key": "stack" } } ``` Weitere Informationen finden Sie unter [Komponenten und Funktionen von Network Flow Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-components.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkflowmonitor/update-monitor.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Network Manager mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Network Manager Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `associate-customer-gateway` Das folgende Codebeispiel zeigt die Verwendung von`associate-customer-gateway`. **AWS CLI** **So ordnen Sie ein Kunden-Gateway zu** Im folgenden Beispiel für `associate-customer-gateway` wird das Kunden-Gateway `cgw-11223344556677889` im angegebenen globalen Netzwerk dem Gerät `device-07f6fd08867abc123` zugeordnet. ``` 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 ``` Ausgabe: ``` { "CustomerGatewayAssociation": { "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889", "GlobalNetworkId": "global-network-01231231231231231", "DeviceId": "device-07f6fd08867abc123", "State": "PENDING" } } ``` Weitere Informationen finden Sie unter [Kunden-Gateway-Zuordnungen](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#cgw-association) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [AssociateCustomerGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/associate-customer-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `associate-link` Das folgende Codebeispiel zeigt die Verwendung`associate-link`. **AWS CLI** **So ordnen Sie einen Link zu** Im folgenden Beispiel für `associate-link` wird der Link `link-11112222aaaabbbb1` dem Gerät `device-07f6fd08867abc123` zugeordnet. Der Link und das Gerät befinden sich im angegebenen globalen Netzwerk. ``` aws networkmanager associate-link \ --global-network-id global-network-01231231231231231 \ --device-id device-07f6fd08867abc123 \ --link-id link-11112222aaaabbbb1 \ --region us-west-2 ``` Ausgabe: ``` { "LinkAssociation": { "GlobalNetworkId": "global-network-01231231231231231", "DeviceId": "device-07f6fd08867abc123", "LinkId": "link-11112222aaaabbbb1", "LinkAssociationState": "PENDING" } } ``` Weitere Informationen finden Sie unter [Geräte- und Link-Zuordnungen](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#device-link-association) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [AssociateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/associate-link.html)in der *AWS CLI Befehlsreferenz*. ### `create-core-network` Das folgende Codebeispiel zeigt die Verwendung`create-core-network`. **AWS CLI** **So erstellen Sie ein Kernnetzwerk** Das folgende `create-core-network` Beispiel erstellt ein Kernnetzwerk mithilfe einer optionalen Beschreibung und Tags innerhalb eines globalen AWS Cloud-WAN-Netzwerks. ``` aws networkmanager create-core-network \ --global-network-id global-network-cdef-EXAMPLE22222 \ --description "Main headquarters location" \ --tags Key=Name,Value="New York City office" ``` Ausgabe: ``` { "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" } ] } } ``` Weitere Informationen finden Sie unter [Globale Netzwerke und Kernnetzwerke](https://docs.aws.amazon.com/network-manager/latest/cloudwan/cloudwan-core-network-policy.html) im *Benutzerhandbuch für AWS -Cloud-WAN*. + Einzelheiten zur API finden Sie [CreateCoreNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-core-network.html)in der *AWS CLI Befehlsreferenz*. ### `create-device` Das folgende Codebeispiel zeigt die Verwendung`create-device`. **AWS CLI** **So erstellen Sie ein Gerät** Im folgenden Beispiel für `create-device` wird ein Gerät in einem globalen Netzwerk erstellt. Zu den Gerätedetails gehören eine Beschreibung, der Typ, der Hersteller, das Modell und die Seriennummer. ``` 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 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Geräten](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-devices) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [CreateDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-device.html)in der *AWS CLI Befehlsreferenz*. ### `create-global-network` Das folgende Codebeispiel zeigt die Verwendung`create-global-network`. **AWS CLI** **Um ein globales Netzwerk zu erstellen** Im folgenden Beispiel für `create-global-network` wird ein globales Netzwerk erstellt. Der Ausgangszustand bei der Erstellung lautet `PENDING`. ``` aws networkmanager create-global-network ``` Ausgabe: ``` { "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" } } ``` + Einzelheiten zur API finden Sie [CreateGlobalNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-global-network.html)in der *AWS CLI Befehlsreferenz*. ### `create-link` Das folgende Codebeispiel zeigt die Verwendung`create-link`. **AWS CLI** **Um einen Link zu erstellen** Im folgenden Beispiel für `create-link` wird ein Gerät in einem globalen Netzwerk erstellt. Der Link enthält eine Beschreibung und Details zu Linktyp, Bandbreite und Anbieter. Die Standort-ID gibt den Standort an, dem der Link zugeordnet ist. ``` 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 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Links](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-links) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-link.html)in der *AWS CLI Befehlsreferenz*. ### `create-site` Das folgende Codebeispiel zeigt die Verwendung`create-site`. **AWS CLI** **Um eine Site zu erstellen** Im folgenden Beispiel für `create-site` wird ein Gerät in einem globalen Netzwerk erstellt. Die Standortdetails umfassen eine Beschreibung und Standortinformationen. ``` 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 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Standorten](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-sites) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [CreateSite](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-site.html)in der *AWS CLI Befehlsreferenz*. ### `create-vpc-attachment` Das folgende Codebeispiel zeigt die Verwendung`create-vpc-attachment`. **AWS CLI** **So erstellen Sie einen VPC-Anhang** Im folgenden `create-vpc-attachment` Beispiel wird ein VPC-Anhang mit IPv6 Unterstützung in einem Kernnetzwerk erstellt. ``` 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 ``` Ausgabe: ``` { "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 } } } ``` Weitere Informationen finden Sie unter [Erstellen eines Anhangs](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-create-attachment.html) im *Benutzerhandbuch für Cloud WAN*. + Einzelheiten zur API finden Sie [CreateVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-vpc-attachment.html)in der *AWS CLI Befehlsreferenz.* ### `delete-attachment` Das folgende Codebeispiel zeigt die Verwendung`delete-attachment`. **AWS CLI** **So löschen Sie einen Anhang** Im folgenden Beispiel für `delete-attachment` wird ein Connect-Anhang gelöscht. ``` aws networkmanager delete-attachment \ --attachment-id attachment-01feddaeae26ab68c ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Löschen von Anhängen](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-attachments-working-with.html#cloudwan-attachments-deleting) im *Benutzerhandbuch für Cloud WAN*. + Einzelheiten zur API finden Sie [DeleteAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `delete-bucket-analytics-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-bucket-analytics-configuration`. **AWS CLI** **So löschen Sie eine Analytics-Konfiguration für einen Bucket** Im folgenden Beispiel für `delete-bucket-analytics-configuration` wird die Analytics-Konfiguration für den angegebenen Bucket und die angegebene ID entfernt. ``` aws s3api delete-bucket-analytics-configuration \ --bucket amzn-s3-demo-bucket \ --id 1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteBucketAnalyticsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-bucket-analytics-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-bucket-metrics-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-bucket-metrics-configuration`. **AWS CLI** **So löschen Sie eine Metrik-Konfiguration für einen Bucket** Im folgenden Beispiel für `delete-bucket-metrics-configuration` wird die Metrik-Konfiguration für den angegebenen Bucket und die angegebene ID entfernt. ``` aws s3api delete-bucket-metrics-configuration \ --bucket amzn-s3-demo-bucket \ --id 123 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeleteBucketMetricsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-bucket-metrics-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `delete-core-network` Das folgende Codebeispiel zeigt die Verwendung`delete-core-network`. **AWS CLI** **So löschen Sie ein Kernnetzwerk** Im folgenden Beispiel für `delete-core-network` wird ein Kernnetzwerk aus einem globalen Cloud WAN-Netzwerk gelöscht. ``` aws networkmanager delete-core-network \ --core-network-id core-network-0fab62fe438d94db6 ``` Ausgabe: ``` { "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": [] } ] } } ``` Weitere Informationen finden Sie unter [Kernnetzwerke](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-networks-working-with.html#cloudwan-core-networks) im *Benutzerhandbuch für Cloud WAN*. + Einzelheiten zur API finden Sie [DeleteCoreNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-core-network.html)in der *AWS CLI Befehlsreferenz*. ### `delete-device` Das folgende Codebeispiel zeigt die Verwendung`delete-device`. **AWS CLI** **Um ein Gerät zu löschen** Im folgenden Beispiel für `delete-device` wird das angegebene Gerät aus dem angegebenen globalen Netzwerk gelöscht. ``` aws networkmanager delete-device \ --global-network-id global-network-01231231231231231 \ --device-id device-07f6fd08867abc123 \ --region us-west-2 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Geräten](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-devices) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [DeleteDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-device.html)in der *AWS CLI Befehlsreferenz*. ### `delete-global-network` Das folgende Codebeispiel zeigt die Verwendung`delete-global-network`. **AWS CLI** **So löschen Sie ein globales Netzwerk** Im folgenden Beispiel für `delete-global-network` wird ein globales Netzwerk gelöscht. ``` aws networkmanager delete-global-network \ --global-network-id global-network-052bedddccb193b6b ``` Ausgabe: ``` { "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" } } ``` + Einzelheiten zur API finden Sie [DeleteGlobalNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-global-network.html)in der *AWS CLI Befehlsreferenz*. ### `delete-link` Das folgende Codebeispiel zeigt die Verwendung`delete-link`. **AWS CLI** **Um einen Link zu löschen** Im folgenden Beispiel für `delete-link` wird der angegebene Link aus dem angegebenen globalen Netzwerk gelöscht. ``` aws networkmanager delete-link \ --global-network-id global-network-01231231231231231 \ --link-id link-11112222aaaabbbb1 \ --region us-west-2 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Links](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-links) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-link.html)in der *AWS CLI Befehlsreferenz*. ### `delete-public-access-block` Das folgende Codebeispiel zeigt die Verwendung`delete-public-access-block`. **AWS CLI** **So löschen Sie die Konfiguration zum Blockieren des öffentlichen Zugriffs für einen Bucket** Im folgenden Beispiel für `delete-public-access-block` wird die Konfiguration zum Blockieren des öffentlichen Zugriffs für den angegebenen Bucket entfernt. ``` aws s3api delete-public-access-block \ --bucket amzn-s3-demo-bucket ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [DeletePublicAccessBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-public-access-block.html)in der *AWS CLI Befehlsreferenz*. ### `delete-site` Das folgende Codebeispiel zeigt die Verwendung`delete-site`. **AWS CLI** **So löschen Sie einen Standort** Im folgenden Beispiel für `delete-site` wird der angegebene Standort (`site-444555aaabbb11223`) aus dem angegebenen globalen Netzwerk gelöscht. ``` aws networkmanager delete-site \ --global-network-id global-network-01231231231231231 \ --site-id site-444555aaabbb11223 \ --region us-west-2 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Standorten](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-sites) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [DeleteSite](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-site.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-transit-gateway` Das folgende Codebeispiel zeigt die Verwendung`deregister-transit-gateway`. **AWS CLI** **So heben Sie die Registrierung eines Transit-Gateways in einem globalen Netzwerk auf** Im folgenden Beispiel für `deregister-transit-gateway` wird die Registrierung des angegebenen Transit-Gateways im angegebenen globalen Netzwerk aufgehoben. ``` 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 ``` Ausgabe: ``` { "TransitGatewayRegistration": { "GlobalNetworkId": "global-network-01231231231231231", "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc", "State": { "Code": "DELETING" } } } ``` Weitere Informationen finden Sie unter [Transit-Gateway-Zuordnungen](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-registrations.html) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [DeregisterTransitGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/deregister-transit-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `describe-global-networks` Das folgende Codebeispiel zeigt die Verwendung`describe-global-networks`. **AWS CLI** **So beschreiben Sie globale Netzwerke** Im folgenden Beispiel für `describe-global-networks` werden alle globalen Netzwerke im Konto beschrieben. ``` aws networkmanager describe-global-networks \ --region us-west-2 ``` Ausgabe: ``` { "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" } ] } ``` + Einzelheiten zur API finden Sie [DescribeGlobalNetworks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/describe-global-networks.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-customer-gateway` Das folgende Codebeispiel zeigt die Verwendung`disassociate-customer-gateway`. **AWS CLI** **So heben Sie die Zuordnung zu einem Kunden-Gateway auf** Im folgenden Beispiel für `disassociate-customer-gateway` wird die Zuordnung zwischen dem angegebenen Kunden-Gateway (`cgw-11223344556677889`) und dem angegebenen globalen Netzwerk aufgehoben. ``` 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 ``` Ausgabe: ``` { "CustomerGatewayAssociation": { "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889", "GlobalNetworkId": "global-network-01231231231231231", "DeviceId": "device-07f6fd08867abc123", "State": "DELETING" } } ``` Weitere Informationen finden Sie unter [Kunden-Gateway-Zuordnungen](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#cgw-association) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [DisassociateCustomerGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/disassociate-customer-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `disassociate-link` Das folgende Codebeispiel zeigt die Verwendung`disassociate-link`. **AWS CLI** **So heben Sie die Zuordnung eines Links auf** Im folgenden Beispiel für `disassociate-link` wird die Zuordnung des angegebenen Links vom Gerät `device-07f6fd08867abc123` im angegebenen globalen Netzwerk aufgehoben. ``` aws networkmanager disassociate-link \ --global-network-id global-network-01231231231231231 \ --device-id device-07f6fd08867abc123 \ --link-id link-11112222aaaabbbb1 \ --region us-west-2 ``` Ausgabe: ``` { "LinkAssociation": { "GlobalNetworkId": "global-network-01231231231231231", "DeviceId": "device-07f6fd08867abc123", "LinkId": "link-11112222aaaabbbb1", "LinkAssociationState": "DELETING" } } ``` Weitere Informationen finden Sie unter [Geräte- und Link-Zuordnungen](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#device-link-association) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [DisassociateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/disassociate-link.html)in der *AWS CLI Befehlsreferenz*. ### `get-bucket-analytics-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-bucket-analytics-configuration`. **AWS CLI** **So rufen Sie die Analytics-Konfiguration für einen Bucket mit einer bestimmten ID ab** Im folgenden Beispiel für `get-bucket-analytics-configuration` wird die Analytics-Konfiguration für den angegebenen Bucket und die angegebene ID angezeigt. ``` aws s3api get-bucket-analytics-configuration \ --bucket amzn-s3-demo-bucket \ --id 1 ``` Ausgabe: ``` { "AnalyticsConfiguration": { "StorageClassAnalysis": {}, "Id": "1" } } ``` + Einzelheiten zur API finden Sie [GetBucketAnalyticsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-bucket-analytics-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-bucket-metrics-configuration` Das folgende Codebeispiel zeigt die Verwendung`get-bucket-metrics-configuration`. **AWS CLI** **So rufen Sie die Metrik-Konfiguration für einen Bucket mit einer bestimmten ID ab** Im folgenden Beispiel für `get-bucket-metrics-configuration` wird die Metrik-Konfiguration für den angegebenen Bucket und die angegebene ID angezeigt. ``` aws s3api get-bucket-metrics-configuration \ --bucket amzn-s3-demo-bucket \ --id 123 ``` Ausgabe: ``` { "MetricsConfiguration": { "Filter": { "Prefix": "logs" }, "Id": "123" } } ``` + Einzelheiten zur API finden Sie [GetBucketMetricsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-bucket-metrics-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `get-customer-gateway-associations` Das folgende Codebeispiel zeigt die Verwendung`get-customer-gateway-associations`. **AWS CLI** **So rufen Sie die Kunden-Gateway-Zuordnungen ab** Im folgenden Beispiel für `get-customer-gateway-associations` werden die Kunden-Gateway-Zuordnungen für das angegebene globale Netzwerk abgerufen. ``` aws networkmanager get-customer-gateway-associations \ --global-network-id global-network-01231231231231231 \ --region us-west-2 ``` Ausgabe: ``` { "CustomerGatewayAssociations": [ { "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889", "GlobalNetworkId": "global-network-01231231231231231", "DeviceId": "device-07f6fd08867abc123", "State": "AVAILABLE" } ] } ``` + Einzelheiten zur API finden Sie [GetCustomerGatewayAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-customer-gateway-associations.html)in der *AWS CLI Befehlsreferenz*. ### `get-devices` Das folgende Codebeispiel zeigt die Verwendung`get-devices`. **AWS CLI** **So rufen Sie die Geräte ab** Im folgenden Beispiel für `get-devices` werden die Geräte im angegebenen globalen Netzwerk abgerufen. ``` aws networkmanager get-devices \ --global-network-id global-network-01231231231231231 \ --region us-west-2 ``` Ausgabe: ``` { "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" } ] } ``` + Einzelheiten zur API finden Sie [GetDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-devices.html)in der *AWS CLI Befehlsreferenz*. ### `get-link-associations` Das folgende Codebeispiel zeigt die Verwendung`get-link-associations`. **AWS CLI** **So rufen Sie Link-Zuordnungen ab** Im folgenden Beispiel für `get-link-associations` werden die Link-Zuordnungen im angegebenen globalen Netzwerk abgerufen. ``` aws networkmanager get-link-associations \ --global-network-id global-network-01231231231231231 \ --region us-west-2 ``` Ausgabe: ``` { "LinkAssociations": [ { "GlobalNetworkId": "global-network-01231231231231231", "DeviceId": "device-07f6fd08867abc123", "LinkId": "link-11112222aaaabbbb1", "LinkAssociationState": "AVAILABLE" } ] } ``` + Einzelheiten zur API finden Sie [GetLinkAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-link-associations.html)in der *AWS CLI Befehlsreferenz*. ### `get-links` Das folgende Codebeispiel zeigt die Verwendung`get-links`. **AWS CLI** **So rufen Sie Links ab** Im folgenden Beispiel für `get-links` werden die Links im angegebenen globalen Netzwerk abgerufen. ``` aws networkmanager get-links \ --global-network-id global-network-01231231231231231 \ --region us-west-2 ``` Ausgabe: ``` { "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" } ] } ``` + Einzelheiten zur API finden Sie [GetLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-links.html)in der *AWS CLI Befehlsreferenz*. ### `get-object-retention` Das folgende Codebeispiel zeigt die Verwendung`get-object-retention`. **AWS CLI** **So rufen Sie die Konfiguration für die Aufbewahrung eines Objekts ab** Im folgenden Beispiel für `get-object-retention` wird die Konfiguration für die Aufbewahrung des angegebenen Objekts abgerufen. ``` aws s3api get-object-retention \ --bucket amzn-s3-demo-bucket-with-object-lock \ --key doc1.rtf ``` Ausgabe: ``` { "Retention": { "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00.000Z" } } ``` + Einzelheiten zur API finden Sie [GetObjectRetention](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-object-retention.html)in der *AWS CLI Befehlsreferenz*. ### `get-public-access-block` Das folgende Codebeispiel zeigt die Verwendung`get-public-access-block`. **AWS CLI** **So richten Sie die Konfiguration zum Blockieren des öffentlichen Zugriffs für einen Bucket ein oder ändern sie** Im folgenden Beispiel für `get-public-access-block` wird die Konfiguration zum Blockieren des öffentlichen Zugriff für den angegebenen Bucket angezeigt. ``` aws s3api get-public-access-block --bucket amzn-s3-demo-bucket ``` Ausgabe: ``` { "PublicAccessBlockConfiguration": { "IgnorePublicAcls": true, "BlockPublicPolicy": true, "BlockPublicAcls": true, "RestrictPublicBuckets": true } } ``` + Einzelheiten zur API finden Sie [GetPublicAccessBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-public-access-block.html)in der *AWS CLI Befehlsreferenz*. ### `get-sites` Das folgende Codebeispiel zeigt die Verwendung`get-sites`. **AWS CLI** **So rufen Sie die Standorte ab** Im folgenden Beispiel für `get-sites` werden die Standorte im angegebenen globalen Netzwerk abgerufen. ``` aws networkmanager get-sites \ --global-network-id global-network-01231231231231231 \ --region us-west-2 ``` Ausgabe: ``` { "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" } ] } ``` + Einzelheiten zur API finden Sie [GetSites](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-sites.html)in der *AWS CLI Befehlsreferenz*. ### `get-transit-gateway-registrations` Das folgende Codebeispiel zeigt die Verwendung`get-transit-gateway-registrations`. **AWS CLI** **So rufen Sie die registrierten Transit-Gateways ab** Im folgenden Beispiel für `get-transit-gateway-registrations` werden Transit-Gateways abgerufen, die in einem globalen Netzwerk registriert sind. ``` aws networkmanager get-transit-gateway-registrations \ --global-network-id global-network-01231231231231231 \ --region us-west-2 ``` Ausgabe: ``` { "TransitGatewayRegistrations": [ { "GlobalNetworkId": "global-network-01231231231231231", "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc", "State": { "Code": "AVAILABLE" } } ] } ``` + Einzelheiten zur API finden Sie [GetTransitGatewayRegistrations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-transit-gateway-registrations.html)in der *AWS CLI Befehlsreferenz*. ### `get-vpc-attachment` Das folgende Codebeispiel zeigt die Verwendung`get-vpc-attachment`. **AWS CLI** **Um einen VPC-Anhang zu erhalten** Im folgenden Beispiel für `get-vpc-attachment` werden Informationen zu einem VPC-Anhang zurückgegeben. ``` aws networkmanager get-vpc-attachment \ --attachment-id attachment-03b7ea450134787da ``` Ausgabe: ``` { "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 } } } ``` Weitere Informationen finden Sie unter [Anhänge](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-attachments-working-with.html) im *Benutzerhandbuch für Cloud WAN*. + Einzelheiten zur API finden Sie [GetVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-vpc-attachment.html)in der *AWS CLI Befehlsreferenz.* ### `list-bucket-analytics-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-bucket-analytics-configurations`. **AWS CLI** **So rufen Sie eine Liste der Analytics-Konfigurationen für einen Bucket ab** Im folgenden Beispiel für `list-bucket-analytics-configurations` wird eine Liste von Analytics-Konfigurationen für den angegebenen Bucket abgerufen. ``` aws s3api list-bucket-analytics-configurations \ --bucket amzn-s3-demo-bucket ``` Ausgabe: ``` { "AnalyticsConfigurationList": [ { "StorageClassAnalysis": {}, "Id": "1" } ], "IsTruncated": false } ``` + Einzelheiten zur API finden Sie [ListBucketAnalyticsConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/list-bucket-analytics-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `list-bucket-metrics-configurations` Das folgende Codebeispiel zeigt die Verwendung`list-bucket-metrics-configurations`. **AWS CLI** **So rufen Sie eine Liste der Metrik-Konfigurationen für einen Bucket ab** Im folgenden Beispiel für `list-bucket-metrics-configurations` wird eine Liste von Metrik-Konfigurationen für den angegebenen Bucket abgerufen. ``` aws s3api list-bucket-metrics-configurations \ --bucket amzn-s3-demo-bucket ``` Ausgabe: ``` { "IsTruncated": false, "MetricsConfigurationList": [ { "Filter": { "Prefix": "logs" }, "Id": "123" }, { "Filter": { "Prefix": "tmp" }, "Id": "234" } ] } ``` + Einzelheiten zur API finden Sie [ListBucketMetricsConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/list-bucket-metrics-configurations.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie die Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für die angegebene Geräteressource (`device-07f6fd08867abc123`) aufgelistet. ``` aws networkmanager list-tags-for-resource \ --resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 \ --region us-west-2 ``` Ausgabe: ``` { "TagList": [ { "Key": "Network", "Value": "Northeast" } ] } ``` + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-bucket-metrics-configuration` Das folgende Codebeispiel zeigt die Verwendung`put-bucket-metrics-configuration`. **AWS CLI** **So legen Sie eine Metrik-Konfiguration für einen Bucket fest** Im folgenden Beispiel für `put-bucket-metrics-configuration` wird eine Metrik-Konfiguration mit der ID 123 für den angegebenen Bucket festgelegt. ``` aws s3api put-bucket-metrics-configuration \ --bucket amzn-s3-demo-bucket \ --id 123 \ --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [PutBucketMetricsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/put-bucket-metrics-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `put-object-retention` Das folgende Codebeispiel zeigt die Verwendung`put-object-retention`. **AWS CLI** **So legen Sie die Konfiguration für die Aufbewahrung eines Objekts fest** Im folgenden Beispiel für `put-object-retention` wird eine Konfiguration für die Aufbewahrung des angegebenen Objekts bis zum 01.01.2025 festgelegt. ``` aws s3api put-object-retention \ --bucket amzn-s3-demo-bucket-with-object-lock \ --key doc1.rtf \ --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [PutObjectRetention](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/put-object-retention.html)in der *AWS CLI Befehlsreferenz*. ### `put-public-access-block` Das folgende Codebeispiel zeigt die Verwendung`put-public-access-block`. **AWS CLI** **So richten Sie die Konfiguration zum Blockieren des öffentlichen Zugriffs für einen Bucket ein** Im folgenden Beispiel für `put-public-access-block` wird die Konfiguration zum Blockieren des öffentlichen Zugriff für den angegebenen Bucket eingerichtet. ``` aws s3api put-public-access-block \ --bucket amzn-s3-demo-bucket \ --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [PutPublicAccessBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/put-public-access-block.html)in der *AWS CLI Befehlsreferenz*. ### `register-transit-gateway` Das folgende Codebeispiel zeigt die Verwendung`register-transit-gateway`. **AWS CLI** **So registrieren Sie ein Transit-Gateway bei einem globalen Netzwerk** Im folgenden Beispiel für `register-transit-gateway` wird das Transit-Gateway `tgw-123abc05e04123abc` in einem globalen Netzwerk registriert. ``` 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 ``` Ausgabe: ``` { "TransitGatewayRegistration": { "GlobalNetworkId": "global-network-01231231231231231", "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc", "State": { "Code": "PENDING" } } } ``` Weitere Informationen finden Sie unter [Transit-Gateway-Zuordnungen](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-registrations.html) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [RegisterTransitGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/register-transit-gateway.html)in der *AWS CLI Befehlsreferenz*. ### `reject-attachment` Das folgende Codebeispiel zeigt die Verwendung`reject-attachment`. **AWS CLI** **So lehnen Sie einen Anhang ab** Im folgenden Beispiel für `reject-attachment` wird die Anforderung eines VPC-Anhangs abgelehnt. ``` aws networkmanager reject-attachment \ --attachment-id attachment-03b7ea450134787da ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Annahme von Anhängen](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-attachments-working-with.html#cloudwan-attachments-acceptance) im *Benutzerhandbuch für Cloud WAN*. + Einzelheiten zur API finden Sie [RejectAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/reject-attachment.html)in der *AWS CLI Befehlsreferenz*. ### `start-route-analysis` Das folgende Codebeispiel zeigt die Verwendung`start-route-analysis`. **AWS CLI** **So starten Sie die Routenanalyse** Im folgenden Beispiel für `start-route-analysis` wird die Analyse zwischen einer Quelle und einem Ziel gestartet, einschließlich des optionalen `include-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 ``` Ausgabe: ``` { "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 } } ``` Weitere Informationen finden Sie unter [Routenanalyse](https://docs.aws.amazon.com/network-manager/latest/tgwnm/route-analyzer.html) im *Benutzerhandbuch für AWS Global Networks für Transit Gateways*. + Einzelheiten zur API finden Sie [StartRouteAnalysis](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/start-route-analysis.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So wenden Sie Tags auf eine Ressource an** Im folgenden Beispiel für `tag-resource` wird das Tag `Network=Northeast` auf das Gerät `device-07f6fd08867abc123` angewendet. ``` 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 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags aus einer Ressource** Im folgenden Beispiel für `untag-resource` wird das Tag mit dem Schlüsselnamen `Network` aus dem Gerät `device-07f6fd08867abc123` entfernt. ``` aws networkmanager untag-resource \ --resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 ] --tag-keys Network \ --region us-west-2 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-device` Das folgende Codebeispiel zeigt die Verwendung`update-device`. **AWS CLI** **Um ein Gerät zu aktualisieren** Im folgenden Beispiel für `update-device` wird das Gerät `device-07f6fd08867abc123` durch Angabe einer Standort-ID aktualisiert. ``` aws networkmanager update-device \ --global-network-id global-network-01231231231231231 \ --device-id device-07f6fd08867abc123 \ --site-id site-444555aaabbb11223 \ --region us-west-2 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Geräten](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-devices) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [UpdateDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-device.html)in der *AWS CLI Befehlsreferenz*. ### `update-global-network` Das folgende Codebeispiel zeigt die Verwendung`update-global-network`. **AWS CLI** **So aktualisieren Sie ein globales Netzwerk** Im folgenden Beispiel für `update-global-network` wird die Beschreibung für das globale Netzwerk `global-network-01231231231231231` aktualisiert. ``` aws networkmanager update-global-network \ --global-network-id global-network-01231231231231231 \ --description "Head offices" \ --region us-west-2 ``` Ausgabe: ``` { "GlobalNetwork": { "GlobalNetworkId": "global-network-01231231231231231", "GlobalNetworkArn": "arn:aws:networkmanager::123456789012:global-network/global-network-01231231231231231", "Description": "Head offices", "CreatedAt": 1575553525.0, "State": "UPDATING" } } ``` Weitere Informationen finden Sie unter [Globale Netzwerke](https://docs.aws.amazon.com/vpc/latest/tgw/global-networks.html) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [UpdateGlobalNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-global-network.html)in der *AWS CLI Befehlsreferenz*. ### `update-link` Das folgende Codebeispiel zeigt die Verwendung`update-link`. **AWS CLI** **Um einen Link zu aktualisieren** Im folgenden Beispiel für `update-link` werden die Bandbreiteninformationen für den Link `link-11112222aaaabbbb1` aktualisiert. ``` aws networkmanager update-link \ --global-network-id global-network-01231231231231231 \ --link-id link-11112222aaaabbbb1 \ --bandwidth UploadSpeed=20,DownloadSpeed=20 \ --region us-west-2 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Links](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-links) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-link.html)in der *AWS CLI Befehlsreferenz*. ### `update-site` Das folgende Codebeispiel zeigt die Verwendung`update-site`. **AWS CLI** **So aktualisieren Sie einen Standort** Im folgenden Beispiel für `update-site` wird die Beschreibung für den Standort `site-444555aaabbb11223` im angegebenen globalen Netzwerk aktualisiert. ``` aws networkmanager update-site \ --global-network-id global-network-01231231231231231 \ --site-id site-444555aaabbb11223 \ --description "New York Office site" \ --region us-west-2 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Standorten](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-sites) im *Handbuch für Transit Gateway Network Manager*. + Einzelheiten zur API finden Sie [UpdateSite](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-site.html)in der *AWS CLI Befehlsreferenz*. # OpenSearch Servicebeispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with OpenSearch Service Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-elasticsearch-domain` Das folgende Codebeispiel zeigt, wie Sie`create-elasticsearch-domain`. **AWS CLI** **So erstellen Sie eine Domain von Amazon Elasticsearch Service** Mit dem folgenden `create-elasticsearch-domain`-Befehl wird eine neue Amazon-Elasticsearch-Service-Domain innerhalb einer VPC erstellt und der Zugriff auf einen einzelnen Benutzer beschränkt. Amazon ES leitet die VPC-ID aus dem angegebenen Subnetz und der angegebenen Sicherheitsgruppe ab. IDs ``` aws es create-elasticsearch-domain \ --domain-name vpc-cli-example \ --elasticsearch-version 6.2 \ --elasticsearch-cluster-config InstanceType=m4.large.elasticsearch,InstanceCount=1 \ --ebs-options EBSEnabled=true,VolumeType=standard,VolumeSize=10 \ --access-policies '{"Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": {"AWS": "arn:aws:iam::123456789012:root" }, "Action":"es:*", "Resource": "arn:aws:es:us-west-1:123456789012:domain/vpc-cli-example/*" } ] }' \ --vpc-options SubnetIds=subnet-1a2a3a4a,SecurityGroupIds=sg-2a3a4a5a ``` Ausgabe: ``` { "DomainStatus": { "ElasticsearchClusterConfig": { "DedicatedMasterEnabled": false, "InstanceCount": 1, "ZoneAwarenessEnabled": false, "InstanceType": "m4.large.elasticsearch" }, "DomainId": "123456789012/vpc-cli-example", "CognitoOptions": { "Enabled": false }, "VPCOptions": { "SubnetIds": [ "subnet-1a2a3a4a" ], "VPCId": "vpc-3a4a5a6a", "SecurityGroupIds": [ "sg-2a3a4a5a" ], "AvailabilityZones": [ "us-west-1c" ] }, "Created": true, "Deleted": false, "EBSOptions": { "VolumeSize": 10, "VolumeType": "standard", "EBSEnabled": true }, "Processing": true, "DomainName": "vpc-cli-example", "SnapshotOptions": { "AutomatedSnapshotStartHour": 0 }, "ElasticsearchVersion": "6.2", "AccessPolicies": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:root\"},\"Action\":\"es:*\",\"Resource\":\"arn:aws:es:us-west-1:123456789012:domain/vpc-cli-example/*\"}]}", "AdvancedOptions": { "rest.action.multi.allow_explicit_index": "true" }, "EncryptionAtRestOptions": { "Enabled": false }, "ARN": "arn:aws:es:us-west-1:123456789012:domain/vpc-cli-example" } } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Domains von Amazon ElasticSearch Service](https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-createupdatedomains.html) im *Entwicklerhandbuch für Amazon Elasticsearch Service*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [CreateElasticsearchDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/es/create-elasticsearch-domain.html).AWS CLI * ### `describe-elasticsearch-domain-config` Das folgende Codebeispiel zeigt die Verwendung`describe-elasticsearch-domain-config`. **AWS CLI** **So rufen Sie Details zur Domain-Konfiguration ab** Im folgenden Beispiel für `describe-elasticsearch-domain-config` werden Konfigurationsdetails für eine bestimmte Domain und Statusinformationen für jede einzelne Domainkomponente abgerufen. ``` aws es describe-elasticsearch-domain-config \ --domain-name cli-example ``` Ausgabe: ``` { "DomainConfig": { "ElasticsearchVersion": { "Options": "7.4", "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589395827.325, "UpdateVersion": 8, "State": "Active", "PendingDeletion": false } }, "ElasticsearchClusterConfig": { "Options": { "InstanceType": "c5.large.elasticsearch", "InstanceCount": 1, "DedicatedMasterEnabled": true, "ZoneAwarenessEnabled": false, "DedicatedMasterType": "c5.large.elasticsearch", "DedicatedMasterCount": 3, "WarmEnabled": true, "WarmType": "ultrawarm1.medium.elasticsearch", "WarmCount": 2 }, "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589395827.325, "UpdateVersion": 8, "State": "Active", "PendingDeletion": false } }, "EBSOptions": { "Options": { "EBSEnabled": true, "VolumeType": "gp2", "VolumeSize": 10 }, "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589395827.325, "UpdateVersion": 8, "State": "Active", "PendingDeletion": false } }, "AccessPolicies": { "Options": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"*\"},\"Action\":\"es:*\",\"Resource\":\"arn:aws:es:us-east-1:123456789012:domain/cli-example/*\"}]}", "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589395827.325, "UpdateVersion": 8, "State": "Active", "PendingDeletion": false } }, "SnapshotOptions": { "Options": { "AutomatedSnapshotStartHour": 0 }, "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589395827.325, "UpdateVersion": 8, "State": "Active", "PendingDeletion": false } }, "VPCOptions": { "Options": {}, "Status": { "CreationDate": 1591210426.162, "UpdateDate": 1591210426.162, "UpdateVersion": 18, "State": "Active", "PendingDeletion": false } }, "CognitoOptions": { "Options": { "Enabled": false }, "Status": { "CreationDate": 1591210426.163, "UpdateDate": 1591210426.163, "UpdateVersion": 18, "State": "Active", "PendingDeletion": false } }, "EncryptionAtRestOptions": { "Options": { "Enabled": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/1a2a3a4a-1a2a-1a2a-1a2a-1a2a3a4a5a6a" }, "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589395827.325, "UpdateVersion": 8, "State": "Active", "PendingDeletion": false } }, "NodeToNodeEncryptionOptions": { "Options": { "Enabled": true }, "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589395827.325, "UpdateVersion": 8, "State": "Active", "PendingDeletion": false } }, "AdvancedOptions": { "Options": { "rest.action.multi.allow_explicit_index": "true" }, "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589395827.325, "UpdateVersion": 8, "State": "Active", "PendingDeletion": false } }, "LogPublishingOptions": { "Options": {}, "Status": { "CreationDate": 1591210426.164, "UpdateDate": 1591210426.164, "UpdateVersion": 18, "State": "Active", "PendingDeletion": false } }, "DomainEndpointOptions": { "Options": { "EnforceHTTPS": true, "TLSSecurityPolicy": "Policy-Min-TLS-1-0-2019-07" }, "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589395827.325, "UpdateVersion": 8, "State": "Active", "PendingDeletion": false } }, "AdvancedSecurityOptions": { "Options": { "Enabled": true, "InternalUserDatabaseEnabled": true }, "Status": { "CreationDate": 1589395034.946, "UpdateDate": 1589827485.577, "UpdateVersion": 14, "State": "Active", "PendingDeletion": false } } } } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Domains von Amazon ElasticSearch Service](https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-createupdatedomains.html) im *Entwicklerhandbuch für Amazon Elasticsearch Service*. + Einzelheiten zur API finden Sie [DescribeElasticsearchDomainConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/es/describe-elasticsearch-domain-config.html)in der *AWS CLI Befehlsreferenz*. ### `describe-elasticsearch-domain` Das folgende Codebeispiel zeigt die Verwendung`describe-elasticsearch-domain`. **AWS CLI** **So rufen Sie Details für eine einzelne Domain ab** Im folgenden Beispiel für `describe-elasticsearch-domain` werden Konfigurationsdetails für eine bestimmte Domain abgerufen. ``` aws es describe-elasticsearch-domain \ --domain-name cli-example ``` Ausgabe: ``` { "DomainStatus": { "DomainId": "123456789012/cli-example", "DomainName": "cli-example", "ARN": "arn:aws:es:us-east-1:123456789012:domain/cli-example", "Created": true, "Deleted": false, "Endpoint": "search-cli-example-1a2a3a4a5a6a7a8a9a0a.us-east-1.es.amazonaws.com", "Processing": false, "UpgradeProcessing": false, "ElasticsearchVersion": "7.4", "ElasticsearchClusterConfig": { "InstanceType": "c5.large.elasticsearch", "InstanceCount": 1, "DedicatedMasterEnabled": true, "ZoneAwarenessEnabled": false, "DedicatedMasterType": "c5.large.elasticsearch", "DedicatedMasterCount": 3, "WarmEnabled": true, "WarmType": "ultrawarm1.medium.elasticsearch", "WarmCount": 2 }, "EBSOptions": { "EBSEnabled": true, "VolumeType": "gp2", "VolumeSize": 10 }, "AccessPolicies": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"*\"},\"Action\":\"es:*\",\"Resource\":\"arn:aws:es:us-east-1:123456789012:domain/cli-example/*\"}]}", "SnapshotOptions": { "AutomatedSnapshotStartHour": 0 }, "CognitoOptions": { "Enabled": false }, "EncryptionAtRestOptions": { "Enabled": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/1a2a3a4a-1a2a-1a2a-1a2a-1a2a3a4a5a6a" }, "NodeToNodeEncryptionOptions": { "Enabled": true }, "AdvancedOptions": { "rest.action.multi.allow_explicit_index": "true" }, "ServiceSoftwareOptions": { "CurrentVersion": "R20200522", "NewVersion": "", "UpdateAvailable": false, "Cancellable": false, "UpdateStatus": "COMPLETED", "Description": "There is no software update available for this domain.", "AutomatedUpdateDate": 0.0 }, "DomainEndpointOptions": { "EnforceHTTPS": true, "TLSSecurityPolicy": "Policy-Min-TLS-1-0-2019-07" }, "AdvancedSecurityOptions": { "Enabled": true, "InternalUserDatabaseEnabled": true } } } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Domains von Amazon ElasticSearch Service](https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-createupdatedomains.html) im *Entwicklerhandbuch für Amazon Elasticsearch Service*. + Einzelheiten zur API finden Sie [DescribeElasticsearchDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/es/describe-elasticsearch-domain.html)in der *AWS CLI Befehlsreferenz*. ### `describe-elasticsearch-domains` Das folgende Codebeispiel zeigt die Verwendung`describe-elasticsearch-domains`. **AWS CLI** **So rufen Sie Details für eine oder mehrere Domains ab** Im folgenden Beispiel für `describe-elasticsearch-domains` werden Konfigurationsdetails für eine oder mehrere Domains abgerufen. ``` aws es describe-elasticsearch-domains \ --domain-names cli-example-1 cli-example-2 ``` Ausgabe: ``` { "DomainStatusList": [{ "DomainId": "123456789012/cli-example-1", "DomainName": "cli-example-1", "ARN": "arn:aws:es:us-east-1:123456789012:domain/cli-example-1", "Created": true, "Deleted": false, "Endpoint": "search-cli-example-1-1a2a3a4a5a6a7a8a9a0a.us-east-1.es.amazonaws.com", "Processing": false, "UpgradeProcessing": false, "ElasticsearchVersion": "7.4", "ElasticsearchClusterConfig": { "InstanceType": "c5.large.elasticsearch", "InstanceCount": 1, "DedicatedMasterEnabled": true, "ZoneAwarenessEnabled": false, "DedicatedMasterType": "c5.large.elasticsearch", "DedicatedMasterCount": 3, "WarmEnabled": true, "WarmType": "ultrawarm1.medium.elasticsearch", "WarmCount": 2 }, "EBSOptions": { "EBSEnabled": true, "VolumeType": "gp2", "VolumeSize": 10 }, "AccessPolicies": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"*\"},\"Action\":\"es:*\",\"Resource\":\"arn:aws:es:us-east-1:123456789012:domain/cli-example-1/*\"}]}", "SnapshotOptions": { "AutomatedSnapshotStartHour": 0 }, "CognitoOptions": { "Enabled": false }, "EncryptionAtRestOptions": { "Enabled": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/1a2a3a4a-1a2a-1a2a-1a2a-1a2a3a4a5a6a" }, "NodeToNodeEncryptionOptions": { "Enabled": true }, "AdvancedOptions": { "rest.action.multi.allow_explicit_index": "true" }, "ServiceSoftwareOptions": { "CurrentVersion": "R20200522", "NewVersion": "", "UpdateAvailable": false, "Cancellable": false, "UpdateStatus": "COMPLETED", "Description": "There is no software update available for this domain.", "AutomatedUpdateDate": 0.0 }, "DomainEndpointOptions": { "EnforceHTTPS": true, "TLSSecurityPolicy": "Policy-Min-TLS-1-0-2019-07" }, "AdvancedSecurityOptions": { "Enabled": true, "InternalUserDatabaseEnabled": true } }, { "DomainId": "123456789012/cli-example-2", "DomainName": "cli-example-2", "ARN": "arn:aws:es:us-east-1:123456789012:domain/cli-example-2", "Created": true, "Deleted": false, "Processing": true, "UpgradeProcessing": false, "ElasticsearchVersion": "7.4", "ElasticsearchClusterConfig": { "InstanceType": "r5.large.elasticsearch", "InstanceCount": 1, "DedicatedMasterEnabled": false, "ZoneAwarenessEnabled": false, "WarmEnabled": false }, "EBSOptions": { "EBSEnabled": true, "VolumeType": "gp2", "VolumeSize": 10 }, "AccessPolicies": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"*\"},\"Action\":\"es:*\",\"Resource\":\"arn:aws:es:us-east-1:123456789012:domain/cli-example-2/*\"}]}", "SnapshotOptions": { "AutomatedSnapshotStartHour": 0 }, "CognitoOptions": { "Enabled": false }, "EncryptionAtRestOptions": { "Enabled": false }, "NodeToNodeEncryptionOptions": { "Enabled": false }, "AdvancedOptions": { "rest.action.multi.allow_explicit_index": "true" }, "ServiceSoftwareOptions": { "CurrentVersion": "", "NewVersion": "", "UpdateAvailable": false, "Cancellable": false, "UpdateStatus": "COMPLETED", "Description": "There is no software update available for this domain.", "AutomatedUpdateDate": 0.0 }, "DomainEndpointOptions": { "EnforceHTTPS": false, "TLSSecurityPolicy": "Policy-Min-TLS-1-0-2019-07" }, "AdvancedSecurityOptions": { "Enabled": false, "InternalUserDatabaseEnabled": false } } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Domains von Amazon ElasticSearch Service](https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-createupdatedomains.html) im *Entwicklerhandbuch für Amazon Elasticsearch Service*. + Einzelheiten zur API finden Sie [DescribeElasticsearchDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/es/describe-elasticsearch-domains.html)in der *AWS CLI Befehlsreferenz*. ### `describe-reserved-elasticsearch-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-reserved-elasticsearch-instances`. **AWS CLI** **So zeigen Sie alle reservierten Instances an** Im folgenden Beispiel für `describe-elasticsearch-domains` wird eine Zusammenfassung aller Instances erstellt, die Sie in einer Region reserviert haben. ``` aws es describe-reserved-elasticsearch-instances ``` Ausgabe: ``` { "ReservedElasticsearchInstances": [{ "FixedPrice": 100.0, "ReservedElasticsearchInstanceOfferingId": "1a2a3a4a5-1a2a-3a4a-5a6a-1a2a3a4a5a6a", "ReservationName": "my-reservation", "PaymentOption": "PARTIAL_UPFRONT", "UsagePrice": 0.0, "ReservedElasticsearchInstanceId": "9a8a7a6a-5a4a-3a2a-1a0a-9a8a7a6a5a4a", "RecurringCharges": [{ "RecurringChargeAmount": 0.603, "RecurringChargeFrequency": "Hourly" }], "State": "payment-pending", "StartTime": 1522872571.229, "ElasticsearchInstanceCount": 3, "Duration": 31536000, "ElasticsearchInstanceType": "m4.2xlarge.elasticsearch", "CurrencyCode": "USD" }] } ``` Weitere Informationen finden Sie unter [Reserved Instances](https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/aes-ri.html) im *Entwicklerhandbuch für Amazon Elasticsearch Service*. + Einzelheiten zur API finden Sie [DescribeReservedElasticsearchInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/es/describe-reserved-elasticsearch-instances.html)in der *AWS CLI Befehlsreferenz*. ### `list-domain-names` Das folgende Codebeispiel zeigt die Verwendung`list-domain-names`. **AWS CLI** **So listen Sie alle Domains auf** Im folgenden Beispiel für `list-domain-names` wird eine kurze Übersicht aller Domains in der Region erstellt. ``` aws es list-domain-names ``` Ausgabe: ``` { "DomainNames": [{ "DomainName": "cli-example-1" }, { "DomainName": "cli-example-2" } ] } ``` Weitere Informationen finden Sie unter [Erstellen und Verwalten von Domains von Amazon ElasticSearch Service](https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-createupdatedomains.html) im *Entwicklerhandbuch für Amazon Elasticsearch Service*. + Einzelheiten zur API finden Sie [ListDomainNames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/es/list-domain-names.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Organizations, die AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Organizations Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `accept-handshake` Das folgende Codebeispiel zeigt, wie Sie`accept-handshake`. **AWS CLI** **So akzeptieren Sie einen Handshake von einem anderen Konto** Bill, der Inhaber einer Organisation, hat Juans Konto zuvor eingeladen, seiner Organisation beizutreten. Das folgende Beispiel zeigt, wie Juans Konto den Handshake akzeptiert und damit der Einladung zustimmt. ``` aws organizations accept-handshake --handshake-id h-examplehandshakeid111 ``` Die Ausgabe zeigt Folgendes: ``` { "Handshake": { "Action": "INVITE", "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111", "RequestedTimestamp": 1481656459.257, "ExpirationTimestamp": 1482952459.257, "Id": "h-examplehandshakeid111", "Parties": [ { "Id": "o-exampleorgid", "Type": "ORGANIZATION" }, { "Id": "juan@example.com", "Type": "EMAIL" } ], "Resources": [ { "Resources": [ { "Type": "MASTER_EMAIL", "Value": "bill@amazon.com" }, { "Type": "MASTER_NAME", "Value": "Org Master Account" }, { "Type": "ORGANIZATION_FEATURE_SET", "Value": "ALL" } ], "Type": "ORGANIZATION", "Value": "o-exampleorgid" }, { "Type": "EMAIL", "Value": "juan@example.com" } ], "State": "ACCEPTED" } } ``` + Einzelheiten zur API finden Sie [AcceptHandshake](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/accept-handshake.html)in der *AWS CLI Befehlsreferenz*. ### `attach-policy` Das folgende Codebeispiel zeigt die Verwendung`attach-policy`. **AWS CLI** **So hängen Sie eine Richtlinie an ein Stammverzeichnis, eine Organisationsrichtlinie oder ein Konto an** **Beispiel 1** Das folgende Beispiel zeigt, wie Sie eine Service-Kontrollrichtlinie (SCP) an eine Organisationseinheit anfügen: ``` aws organizations attach-policy --policy-id p-examplepolicyid111 --target-id ou-examplerootid111-exampleouid111 ``` **Beispiel 2** Das folgende Beispiel zeigt, wie Sie eine Service-Kontrollrichtlinie direkt an ein Konto anfügen: ``` aws organizations attach-policy --policy-id p-examplepolicyid111 --target-id 333333333333 ``` + Einzelheiten zur API finden Sie [AttachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/attach-policy.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-handshake` Das folgende Codebeispiel zeigt die Verwendung`cancel-handshake`. **AWS CLI** **So stornieren Sie einen Handshake von einem anderen Konto** Bill hat eine Einladung an Susans Konto gesendet, seiner Organisation beizutreten. Er ändert seine Meinung und beschließt, die Einladung zu stornieren, bevor Susan sie annimmt. Im folgenden Beispiel wird Bills Absage angezeigt: ``` aws organizations cancel-handshake --handshake-id h-examplehandshakeid111 ``` Die Ausgabe umfasst ein Handshake-Objekt, das anzeigt, dass der Status jetzt `CANCELED` lautet: ``` { "Handshake": { "Id": "h-examplehandshakeid111", "State":"CANCELED", "Action": "INVITE", "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111", "Parties": [ { "Id": "o-exampleorgid", "Type": "ORGANIZATION" }, { "Id": "susan@example.com", "Type": "EMAIL" } ], "Resources": [ { "Type": "ORGANIZATION", "Value": "o-exampleorgid", "Resources": [ { "Type": "MASTER_EMAIL", "Value": "bill@example.com" }, { "Type": "MASTER_NAME", "Value": "Master Account" }, { "Type": "ORGANIZATION_FEATURE_SET", "Value": "CONSOLIDATED_BILLING" } ] }, { "Type": "EMAIL", "Value": "anika@example.com" }, { "Type": "NOTES", "Value": "This is a request for Susan's account to join Bob's organization." } ], "RequestedTimestamp": 1.47008383521E9, "ExpirationTimestamp": 1.47137983521E9 } } ``` + Einzelheiten zur API finden Sie [CancelHandshake](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/cancel-handshake.html)in der *AWS CLI Befehlsreferenz*. ### `create-account` Das folgende Codebeispiel zeigt die Verwendung`create-account`. **AWS CLI** **So erstellen Sie ein Mitgliedskonto, das automatisch Teil Ihrer Organisation ist** Das folgende Beispiel zeigt, wie ein Mitgliedskonto in einer Organisation erstellt wird. Das Mitgliedskonto ist mit dem Namen Production Account und der E-Mail-Adresse susan@example.com konfiguriert. Organizations erstellt automatisch eine IAM-Rolle mit dem Standardnamen von, OrganizationAccountAccessRole da der RoleName-Parameter nicht angegeben ist. Außerdem ist die Einstellung, die IAM-Benutzern oder -Rollen mit ausreichenden Berechtigungen den Zugriff auf Kontoabrechnungsdaten ermöglicht, auf den Standardwert ALLOW gesetzt, da der IamUserAccessToBilling Parameter nicht angegeben ist. Organizations sendet Susan automatisch eine „Willkommen bei AWS“ -E-Mail: ``` aws organizations create-account --email susan@example.com --account-name "Production Account" ``` Die Ausgabe umfasst ein Anforderungsobjekt, aus dem hervorgeht, dass der Status jetzt `IN_PROGRESS` lautet: ``` { "CreateAccountStatus": { "State": "IN_PROGRESS", "Id": "car-examplecreateaccountrequestid111" } } ``` Sie können später den aktuellen Status der Anfrage abfragen, indem Sie den Antwortwert ID für den describe-create-account-status Befehl als Wert für den create-account-request-id Parameter angeben. Weitere Informationen finden Sie unter Erstellen eines AWS Kontos in Ihrer Organisation im *Benutzerhandbuch für AWS Organizations*. + Einzelheiten zur API finden Sie [CreateAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/create-account.html)unter *AWS CLI Befehlsreferenz*. ### `create-organization` Das folgende Codebeispiel zeigt die Verwendung`create-organization`. **AWS CLI** **Beispiel 1: So erstellen Sie eine neue Organisation** Bill möchte eine Organisation mit den Anmeldeinformationen des Kontos 111111111111 erstellen. Das folgende Beispiel zeigt, dass das Konto zum Hauptkonto in der neuen Organisation wird. Da er keinen Funktionsumfang angibt, sind in der neuen Organisation standardmäßig alle Funktionen aktiviert, und die Richtlinien zur Servicekontrollrichtlinien sind im Stammverzeichnis aktiviert. ``` aws organizations create-organization ``` Die Ausgabe umfasst ein Organisationsobjekt mit Details zur neuen Organisation: ``` { "Organization": { "AvailablePolicyTypes": [ { "Status": "ENABLED", "Type": "SERVICE_CONTROL_POLICY" } ], "MasterAccountId": "111111111111", "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111", "MasterAccountEmail": "bill@example.com", "FeatureSet": "ALL", "Id": "o-exampleorgid", "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid" } } ``` **Beispiel 2: So erstellen Sie eine neue Organisation, für die nur konsolidierte Rechnungsstellungsfunktionen aktiviert sind** Im folgenden Beispiel wird eine Organisation erstellt, die nur konsolidierte Rechnungsstellungsfunktionen unterstützt: ``` aws organizations create-organization --feature-set CONSOLIDATED_BILLING ``` Die Ausgabe umfasst ein Organisationsobjekt mit Details zur neuen Organisation: ``` { "Organization": { "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid", "AvailablePolicyTypes": [], "Id": "o-exampleorgid", "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111", "MasterAccountEmail": "bill@example.com", "MasterAccountId": "111111111111", "FeatureSet": "CONSOLIDATED_BILLING" } } ``` Weitere Informationen finden Sie unter Erstellen einer Organisation im *Benutzerhandbuch für AWS Organizations*. + Einzelheiten zur API finden Sie [CreateOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/create-organization.html)in der *AWS CLI Befehlsreferenz*. ### `create-organizational-unit` Das folgende Codebeispiel zeigt die Verwendung`create-organizational-unit`. **AWS CLI** **So erstellen Sie eine Organisationseinheit in einer Stamm- oder übergeordneten Organisationseinheit** Das folgende Beispiel zeigt, wie eine Organisationseinheit mit dem Namen AccountingOU erstellt wird: ``` aws organizations create-organizational-unit --parent-id r-examplerootid111 --name AccountingOU ``` Die Ausgabe umfasst ein organizationalUnit-Objekt mit Details zur neuen Organisationseinheit: ``` { "OrganizationalUnit": { "Id": "ou-examplerootid111-exampleouid111", "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111", "Name": "AccountingOU" } } ``` + Einzelheiten zur API finden Sie [CreateOrganizationalUnit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/create-organizational-unit.html)in der *AWS CLI Befehlsreferenz*. ### `create-policy` Das folgende Codebeispiel zeigt die Verwendung`create-policy`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Richtlinie mit einer Textquelldatei für die JSON-Richtlinie** Das folgende Beispiel zeigt, wie Sie eine Service-Kontrollrichtlinie (SCP) namens `AllowAllS3Actions` erstellen: Der Richtlinieninhalt stammt aus einer Datei auf dem lokalen Computer namens `policy.json`. ``` aws organizations create-policy --content file://policy.json --name AllowAllS3Actions, --type SERVICE_CONTROL_POLICY --description "Allows delegation of all S3 actions" ``` Die Ausgabe umfasst ein Richtlinienobjekt mit Details zur neuen Richtlinie: ``` { "Policy": { "Content": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"s3:*\"],\"Resource\":[\"*\"]}]}", "PolicySummary": { "Arn": "arn:aws:organizations::o-exampleorgid:policy/service_control_policy/p-examplepolicyid111", "Description": "Allows delegation of all S3 actions", "Name": "AllowAllS3Actions", "Type":"SERVICE_CONTROL_POLICY" } } } ``` **Beispiel 2: So erstellen Sie eine Richtlinie mit einer JSON-Richtlinie als Parameter** Das folgende Beispiel zeigt, wie Sie dasselbe SCP erstellen, diesmal indem Sie den Richtlinieninhalt als JSON-Zeichenfolge in den Parameter einbetten. Die Zeichenfolge muss mit Backslashes vor den doppelten Anführungszeichen maskiert werden, um sicherzustellen, dass sie im Parameter, der selbst von doppelten Anführungszeichen umgeben ist, als Literale behandelt werden: ``` aws organizations create-policy --content "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"s3:*\"],\"Resource\":[\"*\"]}]}" --name AllowAllS3Actions --type SERVICE_CONTROL_POLICY --description "Allows delegation of all S3 actions" ``` Weitere Informationen zum Erstellen und Verwenden von Richtlinien in Ihrer Organisation finden Sie unter „Verwalten von Organisationsrichtlinien“ im *Benutzerhandbuch für AWS Organizations*. + Einzelheiten zur API finden Sie [CreatePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/create-policy.html)in der *AWS CLI Befehlsreferenz*. ### `decline-handshake` Das folgende Codebeispiel zeigt die Verwendung`decline-handshake`. **AWS CLI** **So lehnen Sie einen Handshake von einem anderen Konto ab** Das folgende Beispiel zeigt, dass Susan, eine Administratorin, die Eigentümerin des Kontos 222222222222 ist, eine Einladung ablehnt, Bills Organisation beizutreten. Der DeclineHandshake Vorgang gibt ein Handshake-Objekt zurück, das anzeigt, dass der Status jetzt DECLINED lautet: ``` aws organizations decline-handshake --handshake-id h-examplehandshakeid111 ``` Die Ausgabe umfasst ein Handshake-Objekt, das anzeigt, dass der neue Status jetzt `DECLINED` lautet: ``` { "Handshake": { "Id": "h-examplehandshakeid111", "State": "DECLINED", "Resources": [ { "Type": "ORGANIZATION", "Value": "o-exampleorgid", "Resources": [ { "Type": "MASTER_EMAIL", "Value": "bill@example.com" }, { "Type": "MASTER_NAME", "Value": "Master Account" } ] }, { "Type": "EMAIL", "Value": "susan@example.com" }, { "Type": "NOTES", "Value": "This is an invitation to Susan's account to join the Bill's organization." } ], "Parties": [ { "Type": "EMAIL", "Id": "susan@example.com" }, { "Type": "ORGANIZATION", "Id": "o-exampleorgid" } ], "Action": "INVITE", "RequestedTimestamp": 1470684478.687, "ExpirationTimestamp": 1471980478.687, "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111" } } ``` + Einzelheiten zur API finden Sie [DeclineHandshake](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/decline-handshake.html)in der *AWS CLI Befehlsreferenz.* ### `delete-organization` Das folgende Codebeispiel zeigt die Verwendung`delete-organization`. **AWS CLI** **Um eine Organisation zu löschen** Im folgenden Beispiel wird gezeigt, wie eine Organisation gelöscht wird. Um diesen Vorgang ausführen zu können, müssen Sie Administrator des Hauptkontos in der Organisation sein. Das Beispiel geht davon aus, dass Sie zuvor alle Mitgliedskonten OUs und Richtlinien aus der Organisation entfernt haben: ``` aws organizations delete-organization ``` + Einzelheiten zur API finden Sie [DeleteOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/delete-organization.html)unter *AWS CLI Befehlsreferenz*. ### `delete-organizational-unit` Das folgende Codebeispiel zeigt die Verwendung`delete-organizational-unit`. **AWS CLI** **Um eine Organisationseinheit zu löschen** Im folgenden Beispiel wird gezeigt, wie eine Organisationseinheit gelöscht wird. Das Beispiel geht davon aus, dass Sie zuvor alle Konten und andere Konten OUs aus der Organisationseinheit entfernt haben: ``` aws organizations delete-organizational-unit --organizational-unit-id ou-examplerootid111-exampleouid111 ``` + Einzelheiten zur API finden Sie [DeleteOrganizationalUnit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/delete-organizational-unit.html)in der *AWS CLI Befehlsreferenz*. ### `delete-policy` Das folgende Codebeispiel zeigt die Verwendung`delete-policy`. **AWS CLI** **So löschen Sie eine Richtlinie** Das folgende Codebeispiel zeigt, wie Sie eine Richtlinie aus einer Organisation löschen. Im Beispiel wird davon ausgegangen, dass Sie die Richtlinie zuvor von allen Entitäten getrennt haben: ``` aws organizations delete-policy --policy-id p-examplepolicyid111 ``` + Einzelheiten zur API finden Sie [DeletePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/delete-policy.html)in der *AWS CLI Befehlsreferenz*. ### `describe-account` Das folgende Codebeispiel zeigt die Verwendung`describe-account`. **AWS CLI** **So rufen Sie die Details zu einem Konto ab** Das folgende Beispiel zeigt, wie die Details eines angegebenen Kontos abgerufen werden: ``` aws organizations describe-account --account-id 555555555555 ``` Die Ausgabe zeigt ein Kontoobjekt mit den Details zum Konto: ``` { "Account": { "Id": "555555555555", "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/555555555555", "Name": "Beta account", "Email": "anika@example.com", "JoinedMethod": "INVITED", "JoinedTimeStamp": 1481756563.134, "Status": "ACTIVE" } } ``` + Einzelheiten zur API finden Sie [DescribeAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/describe-account.html)in der *AWS CLI Befehlsreferenz*. ### `describe-create-account-status` Das folgende Codebeispiel zeigt die Verwendung`describe-create-account-status`. **AWS CLI** **So rufen Sie den neuesten Status einer Anfrage zur Kontoerstellung ab** Das folgende Beispiel zeigt, wie der aktuelle Status einer früheren Anfrage zur Kontoerstellung in einer Organisation abgefragt wird. Die angegebene --request-id stammt aus der Antwort auf den ursprünglichen Aufruf von create-account. Die Anfrage zur Kontoerstellung zeigt anhand des Statusfeldes, dass Organizations die Erstellung des Kontos erfolgreich abgeschlossen haben. Befehl: ``` aws organizations describe-create-account-status --create-account-request-id car-examplecreateaccountrequestid111 ``` Ausgabe: ``` { "CreateAccountStatus": { "State": "SUCCEEDED", "AccountId": "555555555555", "AccountName": "Beta account", "RequestedTimestamp": 1470684478.687, "CompletedTimestamp": 1470684532.472, "Id": "car-examplecreateaccountrequestid111" } } ``` + Einzelheiten zur API finden Sie [DescribeCreateAccountStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/describe-create-account-status.html)in der *AWS CLI Befehlsreferenz*. ### `describe-handshake` Das folgende Codebeispiel zeigt die Verwendung`describe-handshake`. **AWS CLI** **So rufen Sie Informationen über einen Handshake ab** Im folgenden Beispiel wird gezeigt, wie Sie Details zu einem Handshake anfordern. Die Handshake-ID stammt entweder aus dem ursprünglichen Aufruf an `InviteAccountToOrganization` oder aus einem Aufruf an `ListHandshakesForAccount` oder `ListHandshakesForOrganization`: ``` aws organizations describe-handshake --handshake-id h-examplehandshakeid111 ``` Die Ausgabe umfasst ein Handshake-Objekt, das alle Details zum angeforderten Handshake enthält: ``` { "Handshake": { "Id": "h-examplehandshakeid111", "State": "OPEN", "Resources": [ { "Type": "ORGANIZATION", "Value": "o-exampleorgid", "Resources": [ { "Type": "MASTER_EMAIL", "Value": "bill@example.com" }, { "Type": "MASTER_NAME", "Value": "Master Account" } ] }, { "Type": "EMAIL", "Value": "anika@example.com" } ], "Parties": [ { "Type": "ORGANIZATION", "Id": "o-exampleorgid" }, { "Type": "EMAIL", "Id": "anika@example.com" } ], "Action": "INVITE", "RequestedTimestamp": 1470158698.046, "ExpirationTimestamp": 1471454698.046, "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111" } } ``` + Einzelheiten zur API finden Sie [DescribeHandshake](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/describe-handshake.html)in der *AWS CLI Befehlsreferenz*. ### `describe-organization` Das folgende Codebeispiel zeigt die Verwendung`describe-organization`. **AWS CLI** **So rufen Sie Informationen über die aktuelle Organisation ab** Im folgenden Beispiel wird gezeigt, wie Sie Details zu einer Organisation anfordern: ``` aws organizations describe-organization ``` Die Ausgabe umfasst ein Organisationsobjekt mit Details zur neuen Organisation: ``` { "Organization": { "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111", "MasterAccountEmail": "bill@example.com", "MasterAccountId": "111111111111", "Id": "o-exampleorgid", "FeatureSet": "ALL", "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid", "AvailablePolicyTypes": [ { "Status": "ENABLED", "Type": "SERVICE_CONTROL_POLICY" } ] } } ``` + Einzelheiten zur API finden Sie [DescribeOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/describe-organization.html)in der *AWS CLI Befehlsreferenz*. ### `describe-organizational-unit` Das folgende Codebeispiel zeigt die Verwendung`describe-organizational-unit`. **AWS CLI** **So rufen Sie Informationen über eine Organisationseinheit ab** Im folgenden Beispiel für `describe-organizational-unit` werden Details zu einer Organisationseinheit abgefragt. ``` aws organizations describe-organizational-unit \ --organizational-unit-id ou-examplerootid111-exampleouid111 ``` Ausgabe: ``` { "OrganizationalUnit": { "Name": "Accounting Group", "Arn": "arn:aws:organizations::123456789012:ou/o-exampleorgid/ou-examplerootid111-exampleouid111", "Id": "ou-examplerootid111-exampleouid111" } } ``` + Einzelheiten zur API finden Sie [DescribeOrganizationalUnit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/describe-organizational-unit.html)in der *AWS CLI Befehlsreferenz*. ### `describe-policy` Das folgende Codebeispiel zeigt die Verwendung`describe-policy`. **AWS CLI** **So rufen Sie Informationen zu einer Richtlinie ab** Das folgende Beispiel zeigt, wie Sie Informationen zu einer Richtlinie anfordern: ``` aws organizations describe-policy --policy-id p-examplepolicyid111 ``` Die Ausgabe umfasst ein Richtlinienobjekt, das Details zur Richtlinie enthält: ``` { "Policy": { "Content": "{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": \"*\",\n \"Resource\": \"*\"\n }\n ]\n}", "PolicySummary": { "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111", "Type": "SERVICE_CONTROL_POLICY", "Id": "p-examplepolicyid111", "AwsManaged": false, "Name": "AllowAllS3Actions", "Description": "Enables admins to delegate S3 permissions" } } } ``` + Einzelheiten zur API finden Sie [DescribePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/describe-policy.html)in der *AWS CLI Befehlsreferenz*. ### `detach-policy` Das folgende Codebeispiel zeigt die Verwendung`detach-policy`. **AWS CLI** **So trennen Sie eine Richtlinie von einem Root, einer Organisationseinheit oder einem Konto** Das folgende Codebeispiel zeigt, wie Sie eine Richtlinie von einer Organisationseinheit trennen. ``` aws organizations detach-policy --target-id ou-examplerootid111-exampleouid111 --policy-id p-examplepolicyid111 ``` + Einzelheiten zur API finden Sie [DetachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/detach-policy.html)in der *AWS CLI Befehlsreferenz*. ### `disable-policy-type` Das folgende Codebeispiel zeigt die Verwendung`disable-policy-type`. **AWS CLI** **So deaktivieren Sie einen Richtlinientyp in einem Stammverzeichnis** Das folgende Beispiel zeigt, wie Sie den Service-Kontrollrichtlinientyp (SCP) in einem Stammverzeichnis deaktivieren: ``` aws organizations disable-policy-type --root-id r-examplerootid111 --policy-type SERVICE_CONTROL_POLICY ``` Die Ausgabe zeigt, dass das PolicyTypes Antwortelement SERVICE\$1CONTROL\$1POLICY nicht mehr enthält: ``` { "Root": { "PolicyTypes": [], "Name": "Root", "Id": "r-examplerootid111", "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111" } } ``` + *Einzelheiten zur API finden Sie unter [DisablePolicyType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/disable-policy-type.html)Befehlsreferenz.AWS CLI * ### `enable-all-features` Das folgende Codebeispiel zeigt die Verwendung`enable-all-features`. **AWS CLI** **So aktivieren Sie alle Features in einer Organisation** Dieses Beispiel zeigt, wie der Administrator alle eingeladenen Konten in der Organisation auffordert, alle aktivierten Funktionen in der Organisation zu genehmigen. AWS Organizations senden eine E-Mail an die Adresse, die für jedes Konto eines eingeladenen Mitglieds registriert ist, und bittet den Inhaber, die Änderung aller Funktionen zu genehmigen, indem er den gesendeten Handschlag akzeptiert. Nachdem alle Konten eingeladener Mitglieder den Handshake akzeptiert haben, kann der Organisationsadministrator die Änderung an allen Funktionen abschließen. Benutzer mit den entsprechenden Berechtigungen können Richtlinien erstellen und diese auf Stammkonten und Konten anwenden: OUs ``` aws organizations enable-all-features ``` Die Ausgabe ist ein Handshake-Objekt, das zur Genehmigung an alle eingeladenen Mitgliedskonten gesendet wird: ``` { "Handshake": { "Action": "ENABLE_ALL_FEATURES", "Arn":"arn:aws:organizations::111111111111:handshake/o-exampleorgid/enable_all_features/h-examplehandshakeid111", "ExpirationTimestamp":1.483127868609E9, "Id":"h-examplehandshakeid111", "Parties": [ { "id":"o-exampleorgid", "type":"ORGANIZATION" } ], "requestedTimestamp":1.481831868609E9, "resources": [ { "type":"ORGANIZATION", "value":"o-exampleorgid" } ], "state":"REQUESTED" } } ``` + Einzelheiten zur API finden Sie [EnableAllFeatures](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/enable-all-features.html)in der *AWS CLI Befehlsreferenz*. ### `enable-policy-type` Das folgende Codebeispiel zeigt die Verwendung`enable-policy-type`. **AWS CLI** **So aktivieren Sie die Verwendung eines Richtlinientyps in einem Stammverzeichnis** Das folgende Beispiel zeigt, wie Sie den Service-Kontrollrichtlinientyp (SCP) in einem Stammverzeichnis aktivieren: ``` aws organizations enable-policy-type --root-id r-examplerootid111 --policy-type SERVICE_CONTROL_POLICY ``` Die Ausgabe zeigt ein Stammobjekt mit einem PolicyTypes-Antwortelement, das anzeigt, dass diese jetzt aktiviert SCPs sind: ``` { "Root": { "PolicyTypes": [ { "Status":"ENABLED", "Type":"SERVICE_CONTROL_POLICY" } ], "Id": "r-examplerootid111", "Name": "Root", "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111" } } ``` + Einzelheiten zur API finden Sie unter [EnablePolicyType AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/enable-policy-type.html)*Befehlsreferenz.* ### `invite-account-to-organization` Das folgende Codebeispiel zeigt die Verwendung`invite-account-to-organization`. **AWS CLI** **So laden Sie ein Konto zum Beitritt zu einer Organisation ein** Das folgende Beispiel zeigt, wie das Hauptkonto bill@example.com das Konto juan@example.com einlädt, einer Organisation beizutreten: ``` aws organizations invite-account-to-organization --target '{"Type": "EMAIL", "Id": "juan@example.com"}' --notes "This is a request for Juan's account to join Bill's organization." ``` Die Ausgabe umfasst eine Handshake-Struktur, die zeigt, was an das eingeladene Konto gesendet wird: ``` { "Handshake": { "Action": "INVITE", "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111", "ExpirationTimestamp": 1482952459.257, "Id": "h-examplehandshakeid111", "Parties": [ { "Id": "o-exampleorgid", "Type": "ORGANIZATION" }, { "Id": "juan@example.com", "Type": "EMAIL" } ], "RequestedTimestamp": 1481656459.257, "Resources": [ { "Resources": [ { "Type": "MASTER_EMAIL", "Value": "bill@amazon.com" }, { "Type": "MASTER_NAME", "Value": "Org Master Account" }, { "Type": "ORGANIZATION_FEATURE_SET", "Value": "FULL" } ], "Type": "ORGANIZATION", "Value": "o-exampleorgid" }, { "Type": "EMAIL", "Value": "juan@example.com" } ], "State": "OPEN" } } ``` + Einzelheiten zur API finden Sie [InviteAccountToOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/invite-account-to-organization.html)in der *AWS CLI Befehlsreferenz*. ### `leave-organization` Das folgende Codebeispiel zeigt die Verwendung`leave-organization`. **AWS CLI** **So verlassen Sie eine Organisation als Mitgliedskonto** Das folgende Beispiel zeigt den Administrator eines Mitgliedskontos, der beantragt, die Organisation zu verlassen, der er aktuell angehört: ``` aws organizations leave-organization ``` + Einzelheiten zur API finden Sie [LeaveOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/leave-organization.html)in der *AWS CLI Befehlsreferenz*. ### `list-accounts-for-parent` Das folgende Codebeispiel zeigt die Verwendung`list-accounts-for-parent`. **AWS CLI** **So rufen Sie eine Liste aller Konten in einem bestimmten übergeordneten Stammverzeichnis oder einer Organisationseinheit ab** Das folgende Beispiel zeigt, wie eine Liste der Konten in einer Organisationseinheit angefordert wird: ``` aws organizations list-accounts-for-parent --parent-id ou-examplerootid111-exampleouid111 ``` Die Ausgabe enthält eine Liste von Kontozusammenfassungsobjekten. ``` { "Accounts": [ { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481835795.536, "Id": "333333333333", "Name": "Development Account", "Email": "juan@example.com", "Status": "ACTIVE" }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/444444444444", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481835812.143, "Id": "444444444444", "Name": "Test Account", "Email": "anika@example.com", "Status": "ACTIVE" } ] } ``` + Einzelheiten zur API finden Sie [ListAccountsForParent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-accounts-for-parent.html)in der *AWS CLI Befehlsreferenz*. ### `list-accounts` Das folgende Codebeispiel zeigt die Verwendung`list-accounts`. **AWS CLI** **So rufen Sie eine Liste aller Konten in einer Organisation ab** Das folgende Beispiel zeigt, wie Sie eine Liste der Konten in einer Organisation anfordern: ``` aws organizations list-accounts ``` Die Ausgabe enthält eine Liste von Kontozusammenfassungsobjekten. ``` { "Accounts": [ { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481830215.45, "Id": "111111111111", "Name": "Master Account", "Email": "bill@example.com", "Status": "ACTIVE" }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/222222222222", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481835741.044, "Id": "222222222222", "Name": "Production Account", "Email": "alice@example.com", "Status": "ACTIVE" }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481835795.536, "Id": "333333333333", "Name": "Development Account", "Email": "juan@example.com", "Status": "ACTIVE" }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/444444444444", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481835812.143, "Id": "444444444444", "Name": "Test Account", "Email": "anika@example.com", "Status": "ACTIVE" } ] } ``` + Einzelheiten zur API finden Sie [ListAccounts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-accounts.html)in der *AWS CLI Befehlsreferenz*. ### `list-children` Das folgende Codebeispiel zeigt die Verwendung`list-children`. **AWS CLI** **Um die Konten der Kinder und einer übergeordneten Organisationseinheit oder OUs eines Stammkontos abzurufen** Im folgenden Beispiel wird gezeigt, wie Sie das Stammkonto oder die Organisationseinheit auflisten, die dieses Konto 4444444444 enthält: ``` aws organizations list-children --child-type ORGANIZATIONAL_UNIT --parent-id ou-examplerootid111-exampleouid111 ``` Die Ausgabe zeigt die beiden untergeordneten OUs Elemente, die zum Elternteil gehören: ``` { "Children": [ { "Id": "ou-examplerootid111-exampleouid111", "Type":"ORGANIZATIONAL_UNIT" }, { "Id":"ou-examplerootid111-exampleouid222", "Type":"ORGANIZATIONAL_UNIT" } ] } ``` + Einzelheiten zur API finden Sie [ListChildren](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-children.html)in der *AWS CLI Befehlsreferenz*. ### `list-create-account-status` Das folgende Codebeispiel zeigt die Verwendung`list-create-account-status`. **AWS CLI** **Beispiel 1: So rufen Sie eine Liste der Anfragen zur Kontoerstellung ab, die in der aktuellen Organisation gestellt wurden** Das folgende Beispiel zeigt, wie Sie eine Liste von Anfragen zur Kontoerstellung für eine Organisation anfordern, die erfolgreich abgeschlossen wurden: ``` aws organizations list-create-account-status --states SUCCEEDED ``` Die Ausgabe umfasst eine Reihe von Objekten mit Informationen zu jeder Anfrage. ``` { "CreateAccountStatuses": [ { "AccountId": "444444444444", "AccountName": "Developer Test Account", "CompletedTimeStamp": 1481835812.143, "Id": "car-examplecreateaccountrequestid111", "RequestedTimeStamp": 1481829432.531, "State": "SUCCEEDED" } ] } ``` **Beispiel 2: So rufen Sie eine Liste der laufenden Anfragen zur Kontoerstellung ab, die in der aktuellen Organisation gestellt wurden** Im folgenden Beispiel wird eine Liste von Anfragen zur Kontoerstellung für eine Organisation abgerufen: ``` aws organizations list-create-account-status --states IN_PROGRESS ``` Die Ausgabe umfasst eine Reihe von Objekten mit Informationen zu jeder Anfrage. ``` { "CreateAccountStatuses": [ { "State": "IN_PROGRESS", "Id": "car-examplecreateaccountrequestid111", "RequestedTimeStamp": 1481829432.531, "AccountName": "Production Account" } ] } ``` + Einzelheiten zur API finden Sie [ListCreateAccountStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-create-account-status.html)in der *AWS CLI Befehlsreferenz*. ### `list-handshakes-for-account` Das folgende Codebeispiel zeigt die Verwendung`list-handshakes-for-account`. **AWS CLI** **So rufen Sie eine Liste der Handshakes ab, die an ein Konto gesendet wurden** Das folgende Beispiel zeigt, wie Sie eine Liste aller Handshakes abrufen, die mit dem Konto der Anmeldeinformationen verknüpft sind, die zum Aufrufen des Vorgangs verwendet wurden: ``` aws organizations list-handshakes-for-account ``` Die Ausgabe umfasst eine Liste von Handshake-Strukturen mit Informationen zu jedem Handshake, einschließlich seines aktuellen Status: ``` { "Handshake": { "Action": "INVITE", "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111", "ExpirationTimestamp": 1482952459.257, "Id": "h-examplehandshakeid111", "Parties": [ { "Id": "o-exampleorgid", "Type": "ORGANIZATION" }, { "Id": "juan@example.com", "Type": "EMAIL" } ], "RequestedTimestamp": 1481656459.257, "Resources": [ { "Resources": [ { "Type": "MASTER_EMAIL", "Value": "bill@amazon.com" }, { "Type": "MASTER_NAME", "Value": "Org Master Account" }, { "Type": "ORGANIZATION_FEATURE_SET", "Value": "FULL" } ], "Type": "ORGANIZATION", "Value": "o-exampleorgid" }, { "Type": "EMAIL", "Value": "juan@example.com" } ], "State": "OPEN" } } ``` + Einzelheiten zur API finden Sie [ListHandshakesForAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-handshakes-for-account.html)in der *AWS CLI Befehlsreferenz*. ### `list-handshakes-for-organization` Das folgende Codebeispiel zeigt die Verwendung`list-handshakes-for-organization`. **AWS CLI** **So rufen Sie eine Liste der Handshakes ab, die einer Organisation zugeordnet sind** Das folgende Beispiel zeigt, wie Sie eine Liste von Handshakes abrufen, die der aktuellen Organisation zugeordnet sind: ``` aws organizations list-handshakes-for-organization ``` Die Ausgabe zeigt zwei Handshakes. Der erste ist eine Einladung zu Juans Konto und zeigt den Status OFFEN an. Der zweite ist eine Einladung zu Anikas Konto und zeigt den Status ACCEPTED an: ``` { "Handshakes": [ { "Action": "INVITE", "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111", "ExpirationTimestamp": 1482952459.257, "Id": "h-examplehandshakeid111", "Parties": [ { "Id": "o-exampleorgid", "Type": "ORGANIZATION" }, { "Id": "juan@example.com", "Type": "EMAIL" } ], "RequestedTimestamp": 1481656459.257, "Resources": [ { "Resources": [ { "Type": "MASTER_EMAIL", "Value": "bill@amazon.com" }, { "Type": "MASTER_NAME", "Value": "Org Master Account" }, { "Type": "ORGANIZATION_FEATURE_SET", "Value": "FULL" } ], "Type": "ORGANIZATION", "Value": "o-exampleorgid" }, { "Type": "EMAIL", "Value": "juan@example.com" }, { "Type":"NOTES", "Value":"This is an invitation to Juan's account to join Bill's organization." } ], "State": "OPEN" }, { "Action": "INVITE", "State":"ACCEPTED", "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111", "ExpirationTimestamp": 1.471797437427E9, "Id": "h-examplehandshakeid222", "Parties": [ { "Id": "o-exampleorgid", "Type": "ORGANIZATION" }, { "Id": "anika@example.com", "Type": "EMAIL" } ], "RequestedTimestamp": 1.469205437427E9, "Resources": [ { "Resources": [ { "Type":"MASTER_EMAIL", "Value":"bill@example.com" }, { "Type":"MASTER_NAME", "Value":"Master Account" } ], "Type":"ORGANIZATION", "Value":"o-exampleorgid" }, { "Type":"EMAIL", "Value":"anika@example.com" }, { "Type":"NOTES", "Value":"This is an invitation to Anika's account to join Bill's organization." } ] } ] } ``` + Einzelheiten zur API finden Sie [ListHandshakesForOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-handshakes-for-organization.html)in der *AWS CLI Befehlsreferenz*. ### `list-organizational-units-for-parent` Das folgende Codebeispiel zeigt die Verwendung`list-organizational-units-for-parent`. **AWS CLI** **Um eine Liste der OUs in einer übergeordneten Organisationseinheit oder einem Stammverzeichnis abzurufen** Das folgende Beispiel zeigt Ihnen, wie Sie eine Liste von OUs in einem angegebenen Stammverzeichnis abrufen: ``` aws organizations list-organizational-units-for-parent --parent-id r-examplerootid111 ``` Die Ausgabe zeigt, dass der angegebene Stamm zwei enthält, OUs und es werden Details zu jedem Stamm angezeigt: ``` { "OrganizationalUnits": [ { "Name": "AccountingDepartment", "Arn": "arn:aws:organizations::o-exampleorgid:ou/r-examplerootid111/ou-examplerootid111-exampleouid111" }, { "Name": "ProductionDepartment", "Arn": "arn:aws:organizations::o-exampleorgid:ou/r-examplerootid111/ou-examplerootid111-exampleouid222" } ] } ``` + Einzelheiten zur API finden Sie [ListOrganizationalUnitsForParent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-organizational-units-for-parent.html)in der *AWS CLI Befehlsreferenz*. ### `list-parents` Das folgende Codebeispiel zeigt die Verwendung`list-parents`. **AWS CLI** **Um das übergeordnete Element OUs oder die Stammorganisation für ein Konto oder eine untergeordnete Organisationseinheit aufzulisten** Im folgenden Beispiel wird gezeigt, wie Sie die Stamm- oder übergeordnete Organisationseinheit auflisten, die das Konto 444444444444 enthält: ``` aws organizations list-parents --child-id 444444444444 ``` Die Ausgabe zeigt, dass sich das angegebene Konto in der Organisationseinheit mit der angegebenen ID befindet: ``` { "Parents": [ { "Id": "ou-examplerootid111-exampleouid111", "Type": "ORGANIZATIONAL_UNIT" } ] } ``` + Einzelheiten zur API finden Sie [ListParents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-parents.html)in der *AWS CLI Befehlsreferenz*. ### `list-policies-for-target` Das folgende Codebeispiel zeigt die Verwendung`list-policies-for-target`. **AWS CLI** **Um eine Liste der direkt SCPs an ein Konto angehängten Dateien abzurufen** Das folgende Beispiel zeigt, wie eine Liste aller Dienststeuerungsrichtlinien (SCPs) abgerufen wird, wie im Filter-Parameter angegeben, die direkt mit einem Konto verknüpft sind: ``` aws organizations list-policies-for-target --filter SERVICE_CONTROL_POLICY --target-id 444444444444 ``` Die Ausgabe umfasst eine Liste von Richtlinienstrukturen mit zusammenfassenden Informationen zu den Richtlinien. Die Liste enthält keine Richtlinien, die aufgrund der Vererbung von seinem Standort in einer Organisationseinheitenhierarchie für das Konto gelten: ``` { "Policies": [ { "Type": "SERVICE_CONTROL_POLICY", "Name": "AllowAllEC2Actions", "AwsManaged", false, "Id": "p-examplepolicyid222", "Arn": "arn:aws:organizations::o-exampleorgid:policy/service_control_policy/p-examplepolicyid222", "Description": "Enables account admins to delegate permissions for any EC2 actions to users and roles in their accounts." } ] } ``` + Einzelheiten zur API finden Sie [ListPoliciesForTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-policies-for-target.html)unter *AWS CLI Befehlsreferenz*. ### `list-policies` Das folgende Codebeispiel zeigt die Verwendung`list-policies`. **AWS CLI** **So rufen Sie eine Liste aller Richtlinien in einer Organisation eines bestimmten Typs ab** Das folgende Beispiel zeigt Ihnen, wie Sie eine Liste von abrufen SCPs, wie im Filterparameter angegeben: ``` aws organizations list-policies --filter SERVICE_CONTROL_POLICY ``` Die Ausgabe umfasst eine Liste von Richtlinien mit zusammenfassenden Informationen: ``` { "Policies": [ { "Type": "SERVICE_CONTROL_POLICY", "Name": "AllowAllS3Actions", "AwsManaged": false, "Id": "p-examplepolicyid111", "Arn": "arn:aws:organizations::111111111111:policy/service_control_policy/p-examplepolicyid111", "Description": "Enables account admins to delegate permissions for any S3 actions to users and roles in their accounts." }, { "Type": "SERVICE_CONTROL_POLICY", "Name": "AllowAllEC2Actions", "AwsManaged": false, "Id": "p-examplepolicyid222", "Arn": "arn:aws:organizations::111111111111:policy/service_control_policy/p-examplepolicyid222", "Description": "Enables account admins to delegate permissions for any EC2 actions to users and roles in their accounts." }, { "AwsManaged": true, "Description": "Allows access to every operation", "Type": "SERVICE_CONTROL_POLICY", "Id": "p-FullAWSAccess", "Arn": "arn:aws:organizations::aws:policy/service_control_policy/p-FullAWSAccess", "Name": "FullAWSAccess" } ] } ``` + Einzelheiten zur API finden Sie [ListPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-policies.html)unter *AWS CLI Befehlsreferenz*. ### `list-roots` Das folgende Codebeispiel zeigt die Verwendung`list-roots`. **AWS CLI** **So rufen Sie eine Liste der Stammverzeichnisse in einer Organisation ab** Dieses Beispiel zeigt, wie Sie die Liste der Stammverzeichnisse einer Organisation abrufen: ``` aws organizations list-roots ``` Die Ausgabe umfasst eine Liste von Stammstrukturen mit zusammenfassenden Informationen: ``` { "Roots": [ { "Name": "Root", "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111", "Id": "r-examplerootid111", "PolicyTypes": [ { "Status":"ENABLED", "Type":"SERVICE_CONTROL_POLICY" } ] } ] } ``` + Einzelheiten zur API finden Sie [ListRoots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-roots.html)in der *AWS CLI Befehlsreferenz*. ### `list-targets-for-policy` Das folgende Codebeispiel zeigt die Verwendung`list-targets-for-policy`. **AWS CLI** **Um eine Liste der Roots und Konten abzurufen OUs, an die eine Richtlinie angehängt ist** Das folgende Beispiel zeigt, wie Sie eine Liste der Roots und Konten abrufen OUs, denen die angegebene Richtlinie zugeordnet ist: ``` aws organizations list-targets-for-policy --policy-id p-FullAWSAccess ``` Die Ausgabe umfasst eine Liste von Anhangsobjekten mit zusammenfassenden Informationen zu den Wurzeln und Konten OUs, an die die Richtlinie angehängt ist: ``` { "Targets": [ { "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111", "Name": "Root", "TargetId":"r-examplerootid111", "Type":"ROOT" }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333;", "Name": "Developer Test Account", "TargetId": "333333333333", "Type": "ACCOUNT" }, { "Arn":"arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111", "Name":"Accounting", "TargetId":"ou-examplerootid111-exampleouid111", "Type":"ORGANIZATIONAL_UNIT" } ] } ``` + Einzelheiten zur API finden Sie [ListTargetsForPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-targets-for-policy.html)in der *AWS CLI Befehlsreferenz*. ### `move-account` Das folgende Codebeispiel zeigt die Verwendung`move-account`. **AWS CLI** **Um ein Konto zwischen Roots zu verschieben oder OUs** Das folgende Beispiel zeigt, wie Sie das Hauptkonto in der Organisation vom Stammverzeichnis in eine Organisationseinheit verschieben: ``` aws organizations move-account --account-id 333333333333 --source-parent-id r-examplerootid111 --destination-parent-id ou-examplerootid111-exampleouid111 ``` + Einzelheiten zur API finden Sie [MoveAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/move-account.html)in der *AWS CLI Befehlsreferenz*. ### `remove-account-from-organization` Das folgende Codebeispiel zeigt die Verwendung`remove-account-from-organization`. **AWS CLI** **So entfernen Sie ein Konto als Hauptkonto aus einer Organisation** Das folgende Beispiel zeigt, wie ein Mitgliedskonto aus einer Organisation entfernt wird. ``` aws organizations remove-account-from-organization --account-id 333333333333 ``` + Einzelheiten zur API finden Sie [RemoveAccountFromOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/remove-account-from-organization.html)in der *AWS CLI Befehlsreferenz*. ### `update-organizational-unit` Das folgende Codebeispiel zeigt die Verwendung`update-organizational-unit`. **AWS CLI** **Um eine Organisationseinheit umzubenennen** Dieses Beispiel zeigt, wie Sie eine Organisationseinheit umbenennen: In diesem Beispiel wird die Organisationseinheit in „AccountingOU“ umbenannt: ``` aws organizations update-organizational-unit --organizational-unit-id ou-examplerootid111-exampleouid111 --name AccountingOU ``` Die Ausgabe zeigt den neuen Namen: ``` { "OrganizationalUnit": { "Id": "ou-examplerootid111-exampleouid111" "Name": "AccountingOU", "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111"" } } ``` + Einzelheiten zur API finden Sie [UpdateOrganizationalUnit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/update-organizational-unit.html)in der *AWS CLI Befehlsreferenz*. ### `update-policy` Das folgende Codebeispiel zeigt die Verwendung`update-policy`. **AWS CLI** **Beispiel 1: So benennen Sie eine Richtlinie um** Im folgenden Beispiel für `update-policy` wird eine Richtlinie umbenannt und eine neue Beschreibung gegeben. ``` aws organizations update-policy \ --policy-id p-examplepolicyid111 \ --name Renamed-Policy \ --description "This description replaces the original." ``` In der Ausgabe werden der neue Name und die Beschreibung angezeigt. ``` { "Policy": { "Content": "{\n \"Version\":\"2012-10-17\",\n \"Statement\":{\n \"Effect\":\"Allow\",\n \"Action\":\"ec2:*\",\n \"Resource\":\"*\"\n }\n}\n", "PolicySummary": { "Id": "p-examplepolicyid111", "AwsManaged": false, "Arn":"arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111", "Description": "This description replaces the original.", "Name": "Renamed-Policy", "Type": "SERVICE_CONTROL_POLICY" } } } ``` **Beispiel 2: So ersetzen Sie den JSON-Textinhalt einer Richtlinie** Das folgende Beispiel zeigt, wie Sie den JSON-Text des SCP im vorherigen Beispiel durch eine neue JSON-Richtlinientextzeichenfolge ersetzen, die S3 anstelle von EC2 zulässt: ``` aws organizations update-policy \ --policy-id p-examplepolicyid111 \ --content "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"s3:*\",\"Resource\":\"*\"}}" ``` Die Ausgabe zeigt den neuen Inhalt: ``` { "Policy": { "Content": "{ \"Version\": \"2012-10-17\", \"Statement\": { \"Effect\": \"Allow\", \"Action\": \"s3:*\", \"Resource\": \"*\" } }", "PolicySummary": { "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111", "AwsManaged": false; "Description": "This description replaces the original.", "Id": "p-examplepolicyid111", "Name": "Renamed-Policy", "Type": "SERVICE_CONTROL_POLICY" } } } ``` + Einzelheiten zur API finden Sie [UpdatePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/update-policy.html)in der *AWS CLI Befehlsreferenz*. # AWS Outposts Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Outposts. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `get-outpost-instance-types` Das folgende Codebeispiel zeigt, wie Sie`get-outpost-instance-types`. **AWS CLI** **So rufen Sie die Instance-Typen auf Ihrem Outpost ab** Im folgenden Beispiel für `get-outpost-instance-types` werden die Instance-Typen für den angegebenen Outpost abgerufen. ``` aws outposts get-outpost-instance-types \ --outpost-id op-0ab23c4567EXAMPLE ``` Ausgabe: ``` { "InstanceTypes": [ { "InstanceType": "c5d.large" }, { "InstanceType": "i3en.24xlarge" }, { "InstanceType": "m5d.large" }, { "InstanceType": "r5d.large" } ], "OutpostId": "op-0ab23c4567EXAMPLE", "OutpostArn": "arn:aws:outposts:us-west-2:123456789012:outpost/op-0ab23c4567EXAMPLE" } ``` Weitere Informationen finden Sie unter [Starten einer Instance auf Ihrem Outpost](https://docs.aws.amazon.com/outposts/latest/userguide/launch-instance.html) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [GetOutpostInstanceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/outposts/get-outpost-instance-types.html)in der *AWS CLI Befehlsreferenz*. ### `get-outpost` Das folgende Codebeispiel zeigt die Verwendung`get-outpost`. **AWS CLI** **So rufen Sie Outpost-Details ab** Im folgenden Beispiel für `get-outpost` werden die Details für den angegebene Outpost angezeigt. ``` aws outposts get-outpost \ --outpost-id op-0ab23c4567EXAMPLE ``` Ausgabe: ``` { "Outpost": { "OutpostId": "op-0ab23c4567EXAMPLE", "OwnerId": "123456789012", "OutpostArn": "arn:aws:outposts:us-west-2:123456789012:outpost/op-0ab23c4567EXAMPLE", "SiteId": "os-0ab12c3456EXAMPLE", "Name": "EXAMPLE", "LifeCycleStatus": "ACTIVE", "AvailabilityZone": "us-west-2a", "AvailabilityZoneId": "usw2-az1", "Tags": {} } } ``` Weitere Informationen finden Sie unter [Arbeiten mit Outposts](https://docs.aws.amazon.com/outposts/latest/userguide/work-with-outposts.html) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [GetOutpost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/outposts/get-outpost.html)in der *AWS CLI Befehlsreferenz*. ### `list-outposts` Das folgende Codebeispiel zeigt die Verwendung`list-outposts`. **AWS CLI** **So listen Sie Outposts auf** Das folgende `list-outposts` Beispiel listet die Outposts in Ihrem AWS Konto auf. ``` aws outposts list-outposts ``` Ausgabe: ``` { "Outposts": [ { "OutpostId": "op-0ab23c4567EXAMPLE", "OwnerId": "123456789012", "OutpostArn": "arn:aws:outposts:us-west-2:123456789012:outpost/op-0ab23c4567EXAMPLE", "SiteId": "os-0ab12c3456EXAMPLE", "Name": "EXAMPLE", "Description": "example", "LifeCycleStatus": "ACTIVE", "AvailabilityZone": "us-west-2a", "AvailabilityZoneId": "usw2-az1", "Tags": { "Name": "EXAMPLE" } }, { "OutpostId": "op-4fe3dc21baEXAMPLE", "OwnerId": "123456789012", "OutpostArn": "arn:aws:outposts:us-west-2:123456789012:outpost/op-4fe3dc21baEXAMPLE", "SiteId": "os-0ab12c3456EXAMPLE", "Name": "EXAMPLE2", "LifeCycleStatus": "ACTIVE", "AvailabilityZone": "us-west-2a", "AvailabilityZoneId": "usw2-az1", "Tags": {} } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Outposts](https://docs.aws.amazon.com/outposts/latest/userguide/work-with-outposts.html) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [ListOutposts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/outposts/list-outposts.html)in der *AWS CLI Befehlsreferenz.* ### `list-sites` Das folgende Codebeispiel zeigt die Verwendung`list-sites`. **AWS CLI** **So listen Sie Standorte auf** Das folgende `list-sites` Beispiel listet die verfügbaren Outpost-Sites in Ihrem AWS Konto auf. ``` aws outposts list-sites ``` Ausgabe: ``` { "Sites": [ { "SiteId": "os-0ab12c3456EXAMPLE", "AccountId": "123456789012", "Name": "EXAMPLE", "Description": "example", "Tags": {} } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit Outposts](https://docs.aws.amazon.com/outposts/latest/userguide/work-with-outposts.html) im *Benutzerhandbuch für AWS Outposts*. + Einzelheiten zur API finden Sie [ListSites](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/outposts/list-sites.html)in der *AWS CLI Befehlsreferenz.* # AWS Payment Cryptography Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Payment Cryptography. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-alias` Das folgende Codebeispiel zeigt, wie Sie`create-alias`. **AWS CLI** **So erstellen Sie einen Alias für einen Schlüssel** Im folgenden Beispiel für `create-alias` wird ein Alias für einen Schlüssel erstellt. ``` aws payment-cryptography create-alias \ --alias-name alias/sampleAlias1 \ --key-arn arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h ``` Ausgabe: ``` { "Alias": { "AliasName": "alias/sampleAlias1", "KeyArn": "arn:aws:payment-cryptography:us-west-2:123456789012:key/kwapwa6qaifllw2h" } } ``` Weitere Informationen finden Sie unter [Über Aliasse](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/alias-about.html) iim *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [CreateAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/create-alias.html)in der *AWS CLI Befehlsreferenz*. ### `create-key` Das folgende Codebeispiel zeigt die Verwendung`create-key`. **AWS CLI** **So erstellen Sie einen Schlüssel** Das folgende `create-key` Beispiel generiert einen 2KEY-TDES-Schlüssel, mit dem Sie CVV2 CVV/-Werte generieren und überprüfen können. ``` aws payment-cryptography create-key \ --exportable \ --key-attributes KeyAlgorithm=TDES_2KEY, KeyUsage=TR31_C0_CARD_VERIFICATION_KEY,KeyClass=SYMMETRIC_KEY, KeyModesOfUse={Generate=true,Verify=true} ``` Ausgabe: ``` { "Key": { "CreateTimestamp": "1686800690", "Enabled": true, "Exportable": true, "KeyArn": "arn:aws:payment-cryptography:us-west-2:123456789012:key/kwapwa6qaifllw2h", "KeyAttributes": { "KeyAlgorithm": "TDES_2KEY", "KeyClass": "SYMMETRIC_KEY", "KeyModesOfUse": { "Decrypt": false, "DeriveKey": false, "Encrypt": false, "Generate": true, "NoRestrictions": false, "Sign": false, "Unwrap": false, "Verify": true, "Wrap": false }, "KeyUsage": "TR31_C0_CARD_VERIFICATION_KEY" }, "KeyCheckValue": "F2E50F", "KeyCheckValueAlgorithm": "ANSI_X9_24", "KeyOrigin": "AWS_PAYMENT_CRYPTOGRAPHY", "KeyState": "CREATE_COMPLETE", "UsageStartTimestamp": "1686800690" } } ``` Weitere Informationen finden Sie unter [Generieren von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/create-keys.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/create-key.html).AWS CLI * ### `delete-alias` Das folgende Codebeispiel zeigt die Verwendung`delete-alias`. **AWS CLI** **So löschen Sie einen Alias** Im folgenden Beispiel für `delete-alias` wird ein Alias gelöscht. Dies wirkt sich nicht auf den Schlüssel aus. ``` aws payment-cryptography delete-alias \ --alias-name alias/sampleAlias1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Über Aliasse](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/alias-about.html) iim *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [DeleteAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/delete-alias.html)in der *AWS CLI Befehlsreferenz*. ### `delete-key` Das folgende Codebeispiel zeigt die Verwendung`delete-key`. **AWS CLI** **Um einen Schlüssel zu löschen** Im folgenden Beispiel für `delete-key` wird geplant, dass ein Schlüssel nach 7 Tagen gelöscht wird. Dies ist die Standardwartezeit. ``` aws payment-cryptography delete-key \ --key-identifier arn:aws:payment-cryptography:us-west-2:123456789012:key/kwapwa6qaifllw2h ``` Ausgabe: ``` { "Key": { "CreateTimestamp": "1686801198", "DeletePendingTimestamp": "1687405998", "Enabled": true, "Exportable": true, "KeyArn": "arn:aws:payment-cryptography:us-west-2:123456789012:key/kwapwa6qaifllw2h", "KeyAttributes": { "KeyAlgorithm": "TDES_2KEY", "KeyClass": "SYMMETRIC_KEY", "KeyModesOfUse": { "Decrypt": false, "DeriveKey": false, "Encrypt": false, "Generate": true, "NoRestrictions": false, "Sign": false, "Unwrap": false, "Verify": true, "Wrap": false }, "KeyUsage": "TR31_C0_CARD_VERIFICATION_KEY" }, "KeyCheckValue": "F2E50F", "KeyCheckValueAlgorithm": "ANSI_X9_24", "KeyOrigin": "AWS_PAYMENT_CRYPTOGRAPHY", "KeyState": "DELETE_PENDING", "UsageStartTimestamp": "1686801190" } } ``` Weitere Informationen finden Sie unter [Löschen von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-deleting.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [DeleteKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/delete-key.html)in der *AWS CLI Befehlsreferenz*. ### `export-key` Das folgende Codebeispiel zeigt die Verwendung`export-key`. **AWS CLI** **So exportieren Sie einen Schlüssel** Im folgenden Beispiel für `export-key` wird ein Schlüssel exportiert. ``` aws payment-cryptography export-key \ --export-key-identifier arn:aws:payment-cryptography:us-west-2:123456789012:key/lco3w6agsk7zgu2l \ --key-material '{"Tr34KeyBlock": { \ "CertificateAuthorityPublicKeyIdentifier": "arn:aws:payment-cryptography:us-west-2:123456789012:key/ftobshq7pvioc5fx", \ "ExportToken": "export-token-cu4lg26ofcziixny", \ "KeyBlockFormat": "X9_TR34_2012", \ "WrappingKeyCertificate": file://wrapping-key-certificate.pem }}' ``` Inhalt von `wrapping-key-certificate.pem`: ``` LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUV2VENDQXFXZ0F3SUJBZ0lSQU1ZZS8xMXFUK2svVzlRUDJQOElVdWd3RFFZSktvWklodmNOQVFFTkJRQXcKZ1lreEN6QUpCZ05WQkFZVEFsVlRNUmt3RndZRFZRUUtEQkJCVjFNZ1EzSjVjSFJ2WjNKaGNHaDVNU0V3SHdZRApWUVFMREJoQlYxTWdVR0Y1YldWdWRDQkRjbmx3ZEc5bmNtRndhSGt4RVRBUEJnTlZCQWdNQ0ZacGNtZHBibWxoCk1SVXdFd1lEVlFRRERBd3dOelUxTlRZNU5UTTNOVEF4RWpBUUJnTlZCQWNNQ1VGeWJHbHVaM1J2YmpBZUZ3MHkKTXpBMk1UTXhOelV6TVROYUZ3MHlNekEyTWpBeE9EVXpNVEphTUN3eEZUQVRCZ05WQkFNTUREQTNOVFUxTmprMQpNemMxTURFVE1CRUdBMVVFQlJNS09URTFNRGMzTnpRMk9EQ0NBU0l3RFFZSktvWklodmNOQVFFQkJRQURnZ0VQCkFEQ0NBUW9DZ2dFQkFNUjZsVTZ0SFJwcWtCQmI1Z2FFa0FrbVRxNEgwNUQ2UXR2MS9WemhSaThtNVBFMjVtMFIKVnRtZmsxcUEySi94TEROTEl3dHFDR3BIVldOM0JMdFhuSmh2Y1dNNkI0QlRRVXNicENMbG9PYW1jMGF0UXRmeQo0ZUhoWHJoT2lDMFVpR05zeTc5ZlltTkZ3Q3RrSDhvZzJXTEdYNldXNSszRzlTaFZKR3dhbWpNamtlOVo1a0FhCnJKZHk4Y2tsMTFBTS8wQjVZRFR2TU5KVTcyZnVUMlJ5KzVoRmdFTE14aS8vbGE1TnFCQWp5VTY0cmV3eGdVSjAKZ1pVM3lJU2F2UjFwMElNOFNvZzdXUHlkVlNNTitZeTdLMG1OL3lFa3FZTWQxZWxvS1I0OVV3V0hvdzFMcHVzcwpzMDh5a0diWGxsMnBvZ3NvSmZZaFFGWTc4UmRsTU9vY2dOc0NBd0VBQWFOOE1Ib3dDUVlEVlIwVEJBSXdBREFmCkJnTlZIU01FR0RBV2dCU2tDVlVEZzJGZDdPZWpVSUlVRnBvbUpxWG9FREFkQmdOVkhRNEVGZ1FVZU1sRzJ5dkgKamxsQzM2OUV2U3hIcXBBODVkMHdEZ1lEVlIwUEFRSC9CQVFEQWdXZ01CMEdBMVVkSlFRV01CUUdDQ3NHQVFVRgpCd01CQmdnckJnRUZCUWNEQWpBTkJna3Foa2lHOXcwQkFRMEZBQU9DQWdFQURNS2gxbnhYWWtncVkwYmMwVjA1ClNCUTBlcm5vMmsxbXdRQnhpUDBpcUpMdWNFUnF6b0RzOTBJWTN5SjhjMkMzU2kzU1JrVzBmQUhKR0VucTlzblgKbGdGWnRBZmtNbzR4Wllpb1JGZmY1TWdSOUdNaUZNQnVQS2tIeGxKc0R2NllSbnp1Zmkza1lDT1NzeWE4U2tTMQp2M2l2UEpLcTk3aDBBaThoNFQ3clBtN0NNSnYxZ0JTUEF4UVdtdndES2RrTjFsd0VudmtGdzlLZjhqeVpaNjhGCjlmUFV4Z1RvYm1MSmNialZxaFdsQ3U1VE9mSGNPR2RLRURwZE54RE12ODNZZ1ZaWUszclc4UHVxWWIyWFdMR2IKdmFISXh2RGVnOVJwNDByVVpETGVyalptb0gwUWpEZmxCV1RYK0JqU3ZLMm5yUGpzZzJIUC91S1VncVIwQWM5eAo0UjF5YjU2cHh3eU54TUU2NmFTVWNVQ3F1WTloY1Q3eWxWNjc3REVhRHpLTG1abnpMcWdWZU5PaUtzQTMvTi9hCnI2UW56VjNabEtJbCs5aWZwNTVPaTVLMXFyWFkyeVlPL1V2SXBXZjAxcFNFUERHN0hXSllnaGorbXpDRFVkM24KdldBeHBjUXlYRGlybS8wSkRZTWtuYzhjK2Z4QmxQR3ZiT2cwWldOeVUwSVpqRmx3aDVwUnIrMnRkT3lhRkZrNApWNytmMkpRWXdKZWgzWDdQL0N6WldKMlQvbnVzaVZXd0Y2K0hueDQ2ZHVGTzhXSWJZTnJUU1hTQnFEV04vdWpZCjBwYUhwS1poUTJOVnV1M0t3a2JaTDUzRjBRM09EVjcydGtiTHJyajZvOUNGd3JGUFluV0owSWtsemN0d1VtQ24KNjd5TzlSVjVzcC83YlNxTkhYNFRuNmc9Ci0tLS0tRU5EIENFUlRJRklDQVRFEXAMPLE= ``` Ausgabe: ``` { "WrappedKey": { "KeyMaterial": "308205A106092A864886F70D010702A08205923082058E020101310D300B06096086480165030402013082031F06092A864886F70D010703A08203100482030C020100318201F4308201F002010030819F308189310B300906035504061302555331193017060355040A0C104157532043727970746F6772617068793121301F060355040B0C18415753205061796D656E742043727970746F6772617068793111300F06035504080C0856697267696E69613115301306035504030C0C3037353535363935333735303112301006035504070C0941726C696E67746F6E021100C61EFF5D6A4FE93F5BD40FD8FF0852E8304506092A864886F70D0101073038300D06096086480165030402010500301806092A864886F70D010108300B0609608648016503040201300D06092A864886F70D0101090400048201008B09AFE9DFF1EA4E97F8651B6B3B51A3BFF68B0365F3956AD34A64B015185BB3FFB3DC7D5812B0D21D58436EAEC131F8110389E2A9F22DA146805A4D818BDCD6AA0387284188CEF5691565A849659C117AAD0042DF5D2C290386710B58A8C63A298C99280EB75861B793302F78299DE64853433227F23DBB383A605DA23620546DCA92B2D3CD8B486339D303844D807C2D6AF17CF1ABF191F63ACFF0E0F8A91AA5B22C1A0D9EE663854D1D76CEE37FE3A0113C8577B57F173ECD69FA752A8A1AEF49AB2A62D39F091FF9AA0FD4CB695D084637DBA7EF7DA2E657BBBF0C5FCC355DB37866B7BBD5AE065DC0FD399A8E0FC19C10943D5059507DC822DED6AFA67A3082010D06092A864886F70D0107013081FF06082A864886F70D030704085050B8007C2CE5608081E8DC683EECE2BF1FC1D209D5F6642E01E58DC76FF7926B576CB6884B6723C63DDE91D8E6C75DFC4E94F1CDDA8A3E863BE8A7E1DFCD2115E251675F73388D022A28247ED66D7892AA57800750A5F84313ACC3616449A703D7DFC770F50C816F224FB038E675FB1751916699FD00585C1B2EA19FECEE696611FA65B4E8516210D884E351201A888A47D874B1ACDDF4AE7F6F59D0780A5BE3E788DD6FB4E6AC1B9D966443881E9998A625CFB10A35D943B21A3ABB902CF68AD6F7FE7B0C18FF05B94C10E254017203541AFF71E440A42C8B915A84B341F923EF657280DB7B19F769E29725FF7E5999859C318202553082025102010130819E308189310B300906035504061302555331193017060355040A0C104157532043727970746F6772617068793121301F060355040B0C18415753205061796D656E742043727970746F6772617068793111300F06035504080C0856697267696E69613115301306035504030C0C3037353535363935333735303112301006035504070C0941726C696E67746F6E02106BD452CE836B7D2A717B69DB8FAF3679300B0609608648016503040201A0818A301806092A864886F70D010903310B06092A864886F70D010703301C06092A864886F70D010905310F170D3233303631333139303234305A301F06092A864886F70D0107013112041044303131324B30544230304530303030302F06092A864886F70D010904312204209AD3A76A89E2F58433DF669174A6F4D4B6B3D60A8A7341712CB666CA6AE4125E300D06092A864886F70D0101010500048201009BA48B242A227AD05243DBB99ACF6249D626CEF086DAFD8B064592EFF1205CFE6713D5FC373D8CD53AF9A88292E143A4B9C1887792E8E7F6310503B1FD8F0F89F735DFF11CC55114859B902841E4D163D64E19DFAE0151B93590C8D770E47E939DF08242897F9319DC6AB272C26DE2ACC539BF055CE528B139D61B45542FF35D2ABDE34EEF5BE19D1C48679187B455864EDD3D976CDC80070A6A6635DF5A00AF08CBBF309C4D59A4710A531A719562D390394A736E9F2DED502B2F766BA56727DFB0C6A92FD4D2BABC69BDDBD6B17EB376FA9ADD83C2974292447E63F26D168E66A4558ED97E417BDE97837188DB4F414A2219BAC50A8D726CD54C3C1EXAMPLE", "WrappedKeyMaterialFormat": "TR34_KEY_BLOCK" } } ``` Weitere Informationen finden Sie unter [Exportieren von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-export.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [ExportKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/export-key.html)in der *AWS CLI Befehlsreferenz*. ### `get-alias` Das folgende Codebeispiel zeigt die Verwendung`get-alias`. **AWS CLI** **So rufen Sie einen Alias ab** Im folgenden Beispiel für `get-alias` wird der mit dem Alias verknüpfte ARN des Schlüssels zurückgegeben. ``` aws payment-cryptography get-alias \ --alias-name alias/sampleAlias1 ``` Ausgabe: ``` { "Alias": { "AliasName": "alias/sampleAlias1", "KeyArn": "arn:aws:payment-cryptography:us-west-2:123456789012:key/kwapwa6qaifllw2h" } } ``` Weitere Informationen finden Sie unter [Über Aliasse](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/alias-about.html) iim *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [GetAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/get-alias.html)in der *AWS CLI Befehlsreferenz*. ### `get-key` Das folgende Codebeispiel zeigt die Verwendung`get-key`. **AWS CLI** **So rufen Sie die Metadaten eines Schlüssels ab** Im folgenden Beispiel für `get-key` werden die Metadaten des mit dem Alias verknüpften Schlüssels zurückgegeben. Dieser Vorgang gibt kein kryptografisches Material zurück. ``` aws payment-cryptography get-key \ --key-identifier alias/sampleAlias1 ``` Ausgabe: ``` { "Key": { "CreateTimestamp": "1686800690", "DeletePendingTimestamp": "1687405998", "Enabled": true, "Exportable": true, "KeyArn": "arn:aws:payment-cryptography:us-west-2:123456789012:key/kwapwa6qaifllw2h", "KeyAttributes": { "KeyAlgorithm": "TDES_2KEY", "KeyClass": "SYMMETRIC_KEY", "KeyModesOfUse": { "Decrypt": false, "DeriveKey": false, "Encrypt": false, "Generate": true, "NoRestrictions": false, "Sign": false, "Unwrap": false, "Verify": true, "Wrap": false }, "KeyUsage": "TR31_C0_CARD_VERIFICATION_KEY" }, "KeyCheckValue": "F2E50F", "KeyCheckValueAlgorithm": "ANSI_X9_24", "KeyOrigin": "AWS_PAYMENT_CRYPTOGRAPHY", "KeyState": "DELETE_PENDING", "UsageStartTimestamp": "1686801190" } } ``` Weitere Informationen finden Sie unter [Abrufen von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/getkeys.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [GetKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/get-key.html)in der *AWS CLI Befehlsreferenz*. ### `get-parameters-for-export` Das folgende Codebeispiel zeigt die Verwendung`get-parameters-for-export`. **AWS CLI** **So initialisieren Sie den Exportprozess** Im folgenden Beispiel für `get-parameters-for-export` wird ein Schlüsselpaar generiert, der Schlüssel signiert und dann das Zertifikat und der Zertifikatsstamm zurückgegeben. ``` aws payment-cryptography get-parameters-for-export \ --signing-key-algorithm RSA_2048 \ --key-material-type TR34_KEY_BLOCK ``` Ausgabe: ``` { "ExportToken": "export-token-ep5cwyzune7oya53", "ParametersValidUntilTimestamp": "1687415640", "SigningKeyAlgorithm": "RSA_2048", "SigningKeyCertificate": "MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=", "SigningKeyCertificateChain": "NIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=" } ``` Weitere Informationen finden Sie unter [Exportieren von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-export.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [GetParametersForExport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/get-parameters-for-export.html)in der *AWS CLI Befehlsreferenz*. ### `get-parameters-for-import` Das folgende Codebeispiel zeigt die Verwendung`get-parameters-for-import`. **AWS CLI** **So initialisieren Sie den Importprozess** Im folgenden Beispiel für `get-parameters-for-import` wird ein Schlüsselpaar generiert, der Schlüssel signiert und dann das Zertifikat und der Zertifikatsstamm zurückgegeben. ``` aws payment-cryptography get-parameters-for-import \ --key-material-type TR34_KEY_BLOCK \ --wrapping-key-algorithm RSA_2048 ``` Ausgabe: ``` { "ImportToken": "import-token-qgmafpaa7nt2kfbb", "ParametersValidUntilTimestamp": "1687415640", "WrappingKeyAlgorithm": "RSA_2048", "WrappingKeyCertificate": "MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=", "WrappingKeyCertificateChain": "NIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=" } ``` Weitere Informationen finden Sie unter [Importieren von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-import.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [GetParametersForImport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/get-parameters-for-import.html)in der *AWS CLI Befehlsreferenz*. ### `get-public-key-certificate` Das folgende Codebeispiel zeigt die Verwendung`get-public-key-certificate`. **AWS CLI** **So geben Sie den öffentlichen Schlüssel zurück** Im folgenden Beispiel für `get-public-key-certificate` wird der öffentliche Schlüsselteil eines Schlüsselpaars zurückgegeben. ``` aws payment-cryptography get-public-key-certificate \ --key-identifier arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h ``` Ausgabe: ``` { "KeyCertificate": "MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=", "KeyCertificateChain": "NIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=" } ``` Weitere Informationen finden [Sie unter Get the public key/certificate associated with a key pair](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys.getpubliccertificate-example.html) im *AWS Payment Cryptography User Guide*. + Einzelheiten zur API finden Sie unter [GetPublicKeyCertificate AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/get-public-key-certificate.html)*Befehlsreferenz.* ### `import-key` Das folgende Codebeispiel zeigt die Verwendung`import-key`. **AWS CLI** **So importieren Sie einen TR-34-Schlüssel** Im folgenden Beispiel für `import-key` wird ein TR-34-Schlüssel importiert. ``` aws payment-cryptography import-key \ --key-material='{ "Tr34KeyBlock": {" \ CertificateAuthorityPublicKeyIdentifier": "arn:aws:payment-cryptography:us-west-2:123456789012:key/rmm5wn2q564njnjm", \ "ImportToken": "import-token-5ott6ho5nts7bbcg", \ "KeyBlockFormat": "X9_TR34_2012", \ "SigningKeyCertificate": file://signing-key-certificate.pem, \ "WrappedKeyBlock": file://wrapped-key-block.pem }}' ``` Inhalt von `signing-key-certificate.pem`: ``` LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUV2RENDQXFTZ0F3SUJBZ0lRYWVCK25IbE1WZU1PR1ZiNjU1Q2JzREFOQmdrcWhraUc5dzBCQVEwRkFEQ0IKaVRFTE1Ba0dBMVVFQmhNQ1ZWTXhHVEFYQmdOVkJBb01FRUZYVXlCRGNubHdkRzluY21Gd2FIa3hJVEFmQmdOVgpCQXNNR0VGWFV5QlFZWGx0Wlc1MElFTnllWEIwYjJkeVlYQm9lVEVSTUE4R0ExVUVDQXdJVm1seVoybHVhV0V4CkZUQVRCZ05WQkFNTUREVXlPVEF5TnpRMU5UUTVOVEVTTUJBR0ExVUVCd3dKUVhKc2FXNW5kRzl1TUI0WERUSXoKTURZd09USXlNVEkxTUZvWERUSXpNRFl4TmpJek1USTFNRm93TERFVk1CTUdBMVVFQXd3TU5USTVNREkzTkRVMQpORGsxTVJNd0VRWURWUVFGRXdvek1EVTRNVGszTkRjNE1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBCk1JSUJDZ0tDQVFFQXdMc0dGb0pqOTVJY0UxL1p1OGZxak40SDVHTFJHVGZQSkFyWWJLbjA4WXVrQTE0SjRBSHEKWGR6ZlY5MjcvVTJZTWN2S3FsNlk5SVQwejZhTVBGbDVYemZWNU1YVW5YMlJxYTladU1ndDhGSDJJYWxsMEQ3bgo0V0RjUkg3TERQdEhXZTRaVmh3aExRVEFQa1I2dUxTWC84UDhSN2lrSWpkVkI4SytjVitnbHh0clB1Vkh5TzNxCjhXRUl3a1lYVTFDVjJybHptNklzWjcycjhPcXJWcHNiZEhERENBelJ2YUtPN3hMNU1RUGVFMFcvdkxmRGdrYmoKb2h4VHl6Z3dRSlJFK21tUXdCRmlIeXdaY2F5Y1FZdXdzTktoK0xPWXJpN0ZGM2lRRTJlYlY5Mm4zZER5NDRtcQpUSjFHUWJENndFM3ZHS0xnYXNqMVl0WVNSTk9xNld1UTV3SURBUUFCbzN3d2VqQUpCZ05WSFJNRUFqQUFNQjhHCkExVWRJd1FZTUJhQUZHMVBsWElaUGdETVU0WjVwRTc3dE8xYmV2eDVNQjBHQTFVZERnUVdCQlFwanByQXFoZGMKVmF2dElTRnBBNkswVzJMcmJUQU9CZ05WSFE4QkFmOEVCQU1DQmFBd0hRWURWUjBsQkJZd0ZBWUlLd1lCQlFVSApBd0VHQ0NzR0FRVUZCd01DTUEwR0NTcUdTSWIzRFFFQkRRVUFBNElDQVFCOXVxcFVadU1oK1kzQXhXSklNUkx5Cmlob2gvR0xIanh1aVhxK1IvdFRxbTBNYTA3R2dvbGxhRkdIZzZMei9ELy9ZRDB2UHdYc1dVOE5qY0Vib095aGcKc0hmay9hVGxjRnovZm51MVlkRUpvYUpFdW15bDkwSTBMNyswUmJNYXJScWU0bC9yQlQ4YTM3R0JyQ0x0ZUlyRgorcnp1cmovU1BDM1FiUWkvOVBzWmlieTFKMlFxTzVVRUJncEYreklaVk84dzgwMzVEK1YrUXhsY2RaUGVLS2JnCmI5WHNSeHF3cUZIVUVRM2tybXdVZUZveERlbm91QmxKMVFzOTVXUHBpVk9zYUFvbkJkYUtEbFBaRTlqdG1zZkwKMER3b1lRRy92bHdWN0pIVnNNd0dleml2VGJXaWFNdmZTTkxIMmVZMG9rblhFcHlHcmlWMjczSVFqVU1QTXBMNgpjODh3OUYzcTJnY0x6Nk0ycEFHUTZ0SVBrZ2c3aUZjbk9haGp4Ty9ORFZrS0xxbXZ0eFFlcUk2VDRveWRuWkVWCkdOMjBISStZcFVud09Eem1GL1k5TXZQQXFtdGJka2dZZGRJWExtbU9ORlF1dm4wenp0Tm01NzNTN0NSYWxCNTgKeFhyNm1iak1MQU1tcmZGQmNrU0NYaUZ6Y3gvNHJTRGJtbU9INWM0dGxiNEM3SzF5QU96NWo3OHhWOWNQOTM3SQpwczcrZUFZRkFpYTdzZGpuS3hNUDN4ZVVTM0tNS2FGMzg2TGRYbkRwdTFyczhVRWhPeDhqakt6RWplWU9qV3hLClo5Mjd1Yzd0b2kwZlcvT2tzT3NnWVlybmttSEhyd3p0NXRBc2llcjFyWXFGK2lYa1Y4TzRxSzI0bHc4cXFPanUKS3htVHMzY0NlTmdGNUZhVmhCV1Zjdz09Ci0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0= ``` Inhalt von `wrapped-key-block.pem`: ``` 3082059806092A864886F70D010702A082058930820585020101310D300B06096086480165030402013082031606092A864886F70D010703A082030704820303020100318201F3308201EF02010030819E308189310B300906035504061302555331193017060355040A0C104157532043727970746F6772617068793121301F060355040B0C18415753205061796D656E742043727970746F6772617068793111300F06035504080C0856697267696E69613115301306035504030C0C3532393032373435353439353112301006035504070C0941726C696E67746F6E021026C5E52507841B72C59D9F0065548DC1304506092A864886F70D0101073038300D06096086480165030402010500301806092A864886F70D010108300B0609608648016503040201300D06092A864886F70D01010904000482010013D3C2E9405CA45A947BA6EA098DD5A83A7E6CFF4E140B141634EBFF9E0F78057B5C22013574BA8C8D8D64B43C391E1D9CDF081B33D15CDE3AB2DB21CAE7380E64B0A09A8C45B8A0F87659638E6E30D4351E9B941EDD384183DA169ADDF71FC64E06487F8750B74B2CD3AB4F8534C024AE04BD7C070CB685A250EB2A8C1EEDEBFA387935466D152E063D3EBEDD6231216EEE5145983C74D755C050D191E6E41DC2BDB09E78CDA203C2767270E3E56C6E24EB1090904462743B054098DE278A18C71577CAE1EC13CF776055224F299DBF1BC96C11F339DEE1A2CD130A275959820FBE5C34C0CB21DB6404F868B348D5A6F8ED8E5DC5BC681F6115BA278879FF8F3082010506092A864886F70D0107013081F706082A864886F70D0307040857F8BFE99B4493AD8081E05DEE59D9E60520DB8A15869BB840F1CC908DAE6CC6F6BE79DDF72DD8EA84F881D7DFB4A186CDC622B29E3F97AEB7C00872D1BB47FE235D9204F80A4D3EF502309ECD967F8F70A2F741738ACE7B7CA0AA2EBB0DACD3126F7831F79AF6DC3C74CEBF7D0947301245F42C59508FBC0318C03F02E37EDF014C4D0170ACC4E992EC7E9B85D95BF87F75FD2E0B938E2D8E807872DE4017F8530D59A48C9F68AF5BEC1B2115D7555C248F980DF28C69619E508317F0C20461AE26CD0D55896FEE71E1EA89F7F9B5DC047F9BD063210E1F09D9566EF2AF6472AD44A8ACC0180AC1995CDE318202553082025102010130819E308189310B300906035504061302555331193017060355040A0C104157532043727970746F6772617068793121301F060355040B0C18415753205061796D656E742043727970746F6772617068793111300F06035504080C0856697267696E69613115301306035504030C0C3532393032373435353439353112301006035504070C0941726C696E67746F6E021069E07E9C794C55E30E1956FAE7909BB0300B0609608648016503040201A0818A301806092A864886F70D010903310B06092A864886F70D010703301C06092A864886F70D010905310F170D3233303630393233333934365A301F06092A864886F70D0107013112041044303131324330544330304530303030302F06092A864886F70D01090431220420D6413C502DC4552B495B9A8449F9A3BF9E6DCB31AD56A1D158DB482BDF06EEAD300D06092A864886F70D010101050004820100313BA7BCDFE6C55F3544A8E7D9973A346DDAD17CC5C506DE72B8B7E490891702E753C445FED78D5477C5E5A2BF63378B2F12CE6C22C1A543BCC41FA978568F65C0171DBF3E438E70FD68DAB52BA1DEB294C4ED92CD6EAA684B4352AF6C53924048931595FC7F1FF642E82B12DBD8B8578DA200DC0CCE2FA075897CDA6D5257C78DC2B515015CC414E78B49075AFF333C7CEAFF81F5EEC44C5C9F6BD32898E6983A7CEA40DD5C0CF9CD51DB3E712ED1C755E0A9DA38286872B46D7119088A76728DC08AECB0F624B34E15349E5B2334900E57885A6461AC6E74B35A3FFF5C010ACE5F15DE9D867A5160D30217997E7DE6319A74F5D55D44A934908A3BC1602D22 ``` Ausgabe: ``` { "Key": { "CreateTimestamp": "2023-06-09T16:56:27.621000-07:00", "Enabled": true, "KeyArn": "arn:aws:payment-cryptography:us-west-2:123456789012:key/bzmvgyxdg3sktwxd", "KeyAttributes": { "KeyAlgorithm": "TDES_2KEY", "KeyClass": "SYMMETRIC_KEY", "KeyModesOfUse": { "Decrypt": false, "DeriveKey": false, "Encrypt": false, "Generate": true, "NoRestrictions": false, "Sign": false, "Unwrap": false, "Verify": true, "Wrap": false }, "KeyUsage": "TR31_C0_CARD_VERIFICATION_KEY" }, "KeyCheckValue": "D9B20E", "KeyCheckValueAlgorithm": "ANSI_X9_24", "KeyOrigin": "EXTERNAL", "KeyState": "CREATE_COMPLETE", "UsageStartTimestamp": "2023-06-09T16:56:27.621000-07:00" } } ``` Weitere Informationen finden Sie unter [Importieren von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-import.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [ImportKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/import-key.html)in der *AWS CLI Befehlsreferenz*. ### `list-aliases` Das folgende Codebeispiel zeigt die Verwendung`list-aliases`. **AWS CLI** **So rufen Sie eine Liste von Aliasen ab** Im folgenden Beispiel für `list-aliases` werden alle Aliasse in Ihrem Konto in dieser Region angezeigt. ``` aws payment-cryptography list-aliases ``` Ausgabe: ``` { "Aliases": [ { "AliasName": "alias/sampleAlias1", "KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h" }, { "AliasName": "alias/sampleAlias2", "KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h" } ] } ``` Weitere Informationen finden Sie unter [Über Aliasse](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/alias-about.html) iim *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [ListAliases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/list-aliases.html)in der *AWS CLI Befehlsreferenz*. ### `list-keys` Das folgende Codebeispiel zeigt die Verwendung`list-keys`. **AWS CLI** **So rufen Sie eine Schlüsselliste ab** Im folgenden Beispiel für `list-keys` werden alle Schlüssel in Ihrem Konto in dieser Region angezeigt. ``` aws payment-cryptography list-keys ``` Ausgabe: ``` { "Keys": [ { "CreateTimestamp": "1666506840", "Enabled": false, "Exportable": true, "KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h", "KeyAttributes": { "KeyAlgorithm": "TDES_3KEY", "KeyClass": "SYMMETRIC_KEY", "KeyModesOfUse": { "Decrypt": true, "DeriveKey": false, "Encrypt": true, "Generate": false, "NoRestrictions": false, "Sign": false, "Unwrap": true, "Verify": false, "Wrap": true }, "KeyUsage": "TR31_P1_PIN_GENERATION_KEY" }, "KeyCheckValue": "369D", "KeyCheckValueAlgorithm": "ANSI_X9_24", "KeyOrigin": "AWS_PAYMENT_CRYPTOGRAPHY", "KeyState": "CREATE_COMPLETE", "UsageStopTimestamp": "1666938840" } ] } ``` Weitere Informationen finden Sie unter [Auflisten von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/alias-about.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [ListKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/list-keys.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So rufen Sie die Liste der Tags für einen Schlüssel ab** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für einen Schlüssel abgerufen. ``` aws payment-cryptography list-tags-for-resource \ --resource-arn arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h ``` Ausgabe: ``` { "Tags": [ { "Key": "BIN", "Value": "20151120" }, { "Key": "Project", "Value": "Production" } ] } ``` Weitere Informationen finden Sie unter [Verwalten von KMS-Schlüsseltags mit API-Operationen](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/manage-tags-api.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `restore-key` Das folgende Codebeispiel zeigt die Verwendung`restore-key`. **AWS CLI** **So stellen Sie ein Secret wieder her, das zum Löschen vorgesehen ist** Im folgenden Beispiel für `restore-key` wird Löschung eines Schlüssels abgebrochen. ``` aws payment-cryptography restore-key \ --key-identifier arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h ``` Ausgabe: ``` { "Key": { "KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h", "KeyAttributes": { "KeyUsage": "TR31_V2_VISA_PIN_VERIFICATION_KEY", "KeyClass": "SYMMETRIC_KEY", "KeyAlgorithm": "TDES_3KEY", "KeyModesOfUse": { "Encrypt": false, "Decrypt": false, "Wrap": false, "Unwrap": false, "Generate": true, "Sign": false, "Verify": true, "DeriveKey": false, "NoRestrictions": false } }, "KeyCheckValue": "", "KeyCheckValueAlgorithm": "ANSI_X9_24", "Enabled": false, "Exportable": true, "KeyState": "CREATE_COMPLETE", "KeyOrigin": "AWS_PAYMENT_CRYPTOGRAPHY", "CreateTimestamp": "1686800690", "UsageStopTimestamp": "1687405998" } } ``` Weitere Informationen finden Sie unter [Löschen von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-deleting.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [RestoreKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/restore-key.html)in der *AWS CLI Befehlsreferenz*. ### `start-key-usage` Das folgende Codebeispiel zeigt die Verwendung`start-key-usage`. **AWS CLI** **So aktivieren Sie einen Schlüssel** Im folgenden Beispiel für `start-key-usage` wird die Verwendung eines Schlüssels aktiviert. ``` aws payment-cryptography start-key-usage \ --key-identifier arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h ``` Ausgabe: ``` { "Key": { "CreateTimestamp": "1686800690", "Enabled": true, "Exportable": true, "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/alsuwfxug3pgy6xh", "KeyAttributes": { "KeyAlgorithm": "TDES_3KEY", "KeyClass": "SYMMETRIC_KEY", "KeyModesOfUse": { "Decrypt": true, "DeriveKey": false, "Encrypt": true, "Generate": false, "NoRestrictions": false, "Sign": false, "Unwrap": true, "Verify": false, "Wrap": true }, "KeyUsage": "TR31_P1_PIN_GENERATION_KEY" }, "KeyCheckValue": "369D", "KeyCheckValueAlgorithm": "ANSI_X9_24", "KeyOrigin": "AWS_PAYMENT_CRYPTOGRAPHY", "KeyState": "CREATE_COMPLETE", "UsageStartTimestamp": "1686800690" } } ``` Weitere Informationen finden Sie unter [Aktivieren und Deaktivieren von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-enable-disable.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [StartKeyUsage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/start-key-usage.html)in der *AWS CLI Befehlsreferenz*. ### `stop-key-usage` Das folgende Codebeispiel zeigt die Verwendung`stop-key-usage`. **AWS CLI** **So deaktivieren Sie einen Schlüssel** Im folgenden Beispiel für `stop-key-usage` wird ein Schlüssel deaktiviert. ``` aws payment-cryptography stop-key-usage \ --key-identifier arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h ``` Ausgabe: ``` { "Key": { "CreateTimestamp": "1686800690", "Enabled": true, "Exportable": true, "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/alsuwfxug3pgy6xh", "KeyAttributes": { "KeyAlgorithm": "TDES_3KEY", "KeyClass": "SYMMETRIC_KEY", "KeyModesOfUse": { "Decrypt": true, "DeriveKey": false, "Encrypt": true, "Generate": false, "NoRestrictions": false, "Sign": false, "Unwrap": true, "Verify": false, "Wrap": true }, "KeyUsage": "TR31_P1_PIN_GENERATION_KEY" }, "KeyCheckValue": "369D", "KeyCheckValueAlgorithm": "ANSI_X9_24", "KeyOrigin": "AWS_PAYMENT_CRYPTOGRAPHY", "KeyState": "CREATE_COMPLETE", "UsageStartTimestamp": "1686800690" } } ``` Weitere Informationen finden Sie unter [Aktivieren und Deaktivieren von Schlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-enable-disable.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [StopKeyUsage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/stop-key-usage.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So markieren Sie einen Schlüssel** Im folgenden Beispiel für `tag-resource` wird ein Schlüssel mit einem Tag versehen. ``` aws payment-cryptography tag-resource \ --resource-arn arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h \ --tags Key=sampleTag,Value=sampleValue ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Schlüssel-Tags](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/manage-tags-api.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie ein Tag von einem Schlüssel** Im folgenden Beispiel für `untag-resource` wird ein Tag von einem Schlüssel entfernt. ``` aws payment-cryptography untag-resource \ --resource-arn arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h \ --tag-keys sampleTag ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwalten von Schlüssel-Tags](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/manage-tags-api.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-alias` Das folgende Codebeispiel zeigt die Verwendung`update-alias`. **AWS CLI** **So aktualisieren Sie einen Alias** Im folgenden Beispiel für `update-alias` wird der Alias einem anderen Schlüssel zugeordnet. ``` aws payment-cryptography update-alias \ --alias-name alias/sampleAlias1 \ --key-arn arn:aws:payment-cryptography:us-east-2:123456789012:key/tqv5yij6wtxx64pi ``` Ausgabe: ``` { "Alias": { "AliasName": "alias/sampleAlias1", "KeyArn": "arn:aws:payment-cryptography:us-west-2:123456789012:key/tqv5yij6wtxx64pi " } } ``` Weitere Informationen finden Sie unter [Über Aliasse](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/alias-about.html) iim *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [UpdateAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography/update-alias.html)in der *AWS CLI Befehlsreferenz*. # AWS Payment Cryptography Beispiele für Datenebene mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with AWS Payment Cryptography Data Plane Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `decrypt-data` Das folgende Codebeispiel zeigt, wie Sie`decrypt-data`. **AWS CLI** **So entschlüsseln Sie Chiffretext** Im folgenden Beispiel für `decrypt-data` werden Chiffretextdaten mithilfe eines symmetrischen Schlüssels entschlüsselt. Für diesen Vorgang müssen für den Schlüssel `KeyModesOfUse` auf `Decrypt` und `KeyUsage` auf `TR31_D0_SYMMETRIC_DATA_ENCRYPTION_KEY` festgelegt sein. ``` aws payment-cryptography-data decrypt-data \ --key-identifier arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h \ --cipher-text 33612AB9D6929C3A828EB6030082B2BD \ --decryption-attributes 'Symmetric={Mode=CBC}' ``` Ausgabe: ``` { "KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h", "KeyCheckValue": "71D7AE", "PlainText": "31323334313233343132333431323334" } ``` Weitere Informationen finden Sie unter [Daten entschlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/decrypt-data.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [DecryptData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/decrypt-data.html)in der *AWS CLI Befehlsreferenz*. ### `encrypt-data` Das folgende Codebeispiel zeigt die Verwendung`encrypt-data`. **AWS CLI** **So verschlüsseln Sie Daten** Im folgenden Beispiel für `encrypt-data` werden Klartextdaten mit einem symmetrischen Schlüssel verschlüsselt. Für diesen Vorgang müssen für den Schlüssel `KeyModesOfUse` auf `Encrypt` und `KeyUsage` auf `TR31_D0_SYMMETRIC_DATA_ENCRYPTION_KEY` festgelegt sein. ``` aws payment-cryptography-data encrypt-data \ --key-identifier arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h \ --plain-text 31323334313233343132333431323334 \ --encryption-attributes 'Symmetric={Mode=CBC}' ``` Ausgabe: ``` { "KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h", "KeyCheckValue": "71D7AE", "CipherText": "33612AB9D6929C3A828EB6030082B2BD" } ``` Weitere Informationen finden Sie unter [Daten verschlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/encrypt-data.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [EncryptData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/encrypt-data.html)in der *AWS CLI Befehlsreferenz*. ### `generate-card-validation-data` Das folgende Codebeispiel zeigt die Verwendung`generate-card-validation-data`. **AWS CLI** **So generieren Sie einen CVV** Das folgende `generate-card-validation-data` Beispiel generiert einen CVV/CVV2. ``` aws payment-cryptography-data generate-card-validation-data \ --key-identifier arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h \ --primary-account-number=171234567890123 \ --generation-attributes CardVerificationValue2={CardExpiryDate=0123} ``` Ausgabe: ``` { "KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h", "KeyCheckValue": "CADDA1", "ValidationData": "801" } ``` Weitere Informationen finden Sie unter [Generieren von Kartendaten](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/generate-card-data.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [GenerateCardValidationData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/generate-card-validation-data.html)in der *AWS CLI Befehlsreferenz*. ### `generate-mac` Das folgende Codebeispiel zeigt die Verwendung`generate-mac`. **AWS CLI** **So generieren Sie einen MAC** Das folgende `generate-card-validation-data` Beispiel generiert einen Hash-Based Message Authentication Code (HMAC) für die Kartendatenauthentifizierung unter Verwendung des Algorithmus HMAC\$1 SHA256 und eines HMAC-Verschlüsselungsschlüssels. Für den Schlüssel müssen `KeyUsage` auf `TR31_M7_HMAC_KEY` und `KeyModesOfUse` auf `Generate` festgelegt werden. ``` aws payment-cryptography-data generate-mac \ --key-identifier arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h \ --message-data "3b313038383439303031303733393431353d32343038323236303030373030303f33" \ --generation-attributes Algorithm=HMAC_SHA256 ``` Ausgabe: ``` { "KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h, "KeyCheckValue": "2976E7", "Mac": "ED87F26E961C6D0DDB78DA5038AA2BDDEA0DCE03E5B5E96BDDD494F4A7AA470C" } ``` Weitere Informationen finden Sie unter [Genieren von MAC](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/generate-mac.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GenerateMac](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/generate-mac.html)AWS CLI * ### `generate-pin-data` Das folgende Codebeispiel zeigt die Verwendung`generate-pin-data`. **AWS CLI** **So generieren Sie eine PIN** Im folgenden Beispiel für `generate-card-validation-data` wird mithilfe des Visa-PIN-Schemas eine neue zufällige PIN generiert. ``` aws payment-cryptography-data generate-pin-data \ --generation-key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/37y2tsl45p5zjbh2 \ --encryption-key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt \ --primary-account-number 171234567890123 \ --pin-block-format ISO_FORMAT_0 \ --generation-attributes VisaPin={PinVerificationKeyIndex=1} ``` Ausgabe: ``` { "GenerationKeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/37y2tsl45p5zjbh2", "GenerationKeyCheckValue": "7F2363", "EncryptionKeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt", "EncryptionKeyCheckValue": "7CC9E2", "EncryptedPinBlock": "AC17DC148BDA645E", "PinData": { "VerificationValue": "5507" } } ``` Weitere Informationen finden Sie unter [Generieren von PIN-Daten](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/generate-pin-data.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [GeneratePinData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/generate-pin-data.html)in der *AWS CLI Befehlsreferenz*. ### `re-encrypt-data` Das folgende Codebeispiel zeigt die Verwendung`re-encrypt-data`. **AWS CLI** **So verschlüsseln Sie Daten erneut mit einem anderen Schlüssel** Im folgenden Beispiel für `re-encrypt-data` wird Chiffriertext entschlüsselt, der mit einem symmetrischen AES-Schlüssel verschlüsselt wurde, und dann mit einem DUKPT (Derived Unique Key Per Transaction)-Schlüssel erneut verschlüsselt. ``` aws payment-cryptography-data re-encrypt-data \ --incoming-key-identifier arn:aws:payment-cryptography:us-west-2:111122223333:key/hyvv7ymboitd4vfy \ --outgoing-key-identifier arn:aws:payment-cryptography:us-west-2:111122223333:key/jl6ythkcvzesbxen \ --cipher-text 4D2B0BDBA192D5AEFEAA5B3EC28E4A65383C313FFA25140101560F75FE1B99F27192A90980AB9334 \ --incoming-encryption-attributes "Dukpt={Mode=ECB,KeySerialNumber=0123456789111111}" \ --outgoing-encryption-attributes '{"Symmetric": {"Mode": "ECB"}}' ``` Ausgabe: ``` { "CipherText": "F94959DA30EEFF0C035483C6067667CF6796E3C1AD28C2B61F9CFEB772A8DD41C0D6822931E0D3B1", "KeyArn": "arn:aws:payment-cryptography:us-west-2:111122223333:key/jl6ythkcvzesbxen", "KeyCheckValue": "2E8CD9" } ``` Weitere Informationen finden Sie unter [Daten verschlüsseln und entschlüsseln](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops.encryptdecrypt.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [ReEncryptData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/re-encrypt-data.html)in der *AWS CLI Befehlsreferenz*. ### `translate-pin-data` Das folgende Codebeispiel zeigt die Verwendung`translate-pin-data`. **AWS CLI** **So übersetzen Sie PIN-Daten** Im folgenden Beispiel für `translate-pin-data` wird eine PIN aus der PEK-TDES-Verschlüsselung unter Verwendung des ISO-0-PIN-Blocks in einen AES-ISO-4-PIN-Block unter Verwendung des DUKPT-Algorithmus übersetzt. ``` aws payment-cryptography-data translate-pin-data \ --encrypted-pin-block "AC17DC148BDA645E" \ --incoming-translation-attributes=IsoFormat0='{PrimaryAccountNumber=171234567890123}' \ --incoming-key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt \ --outgoing-key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/4pmyquwjs3yj4vwe \ --outgoing-translation-attributes IsoFormat4="{PrimaryAccountNumber=171234567890123}" \ --outgoing-dukpt-attributes KeySerialNumber="FFFF9876543210E00008" ``` Ausgabe: ``` { "PinBlock": "1F4209C670E49F83E75CC72E81B787D9", "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt "KeyCheckValue": "7CC9E2" } ``` Weitere Informationen finden Sie unter [Übersetzen von PIN-Daten](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/translate-pin-data.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [TranslatePinData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/translate-pin-data.html)in der *AWS CLI Befehlsreferenz*. ### `verify-auth-request-cryptogram` Das folgende Codebeispiel zeigt die Verwendung`verify-auth-request-cryptogram`. **AWS CLI** **So verifizieren Sie eine Authentifizierungsanfrage** Im folgenden Beispiel für `verify-auth-request-cryptogram` wird ein Autorisierungsanforderungs-Kryptogramm (ARQC) verifiziert. ``` aws payment-cryptography-data verify-auth-request-cryptogram \ --auth-request-cryptogram F6E1BD1E6037FB3E \ --auth-response-attributes '{"ArpcMethod1": {"AuthResponseCode": "1111"}}' \ --key-identifier arn:aws:payment-cryptography:us-west-2:111122223333:key/pboipdfzd4mdklya \ --major-key-derivation-mode "EMV_OPTION_A" \ --session-key-derivation-attributes '{"EmvCommon": {"ApplicationTransactionCounter": "1234","PanSequenceNumber": "01","PrimaryAccountNumber": "471234567890123"}}' \ --transaction-data "123456789ABCDEF" ``` Ausgabe: ``` { "AuthResponseValue": "D899B8C6FBF971AA", "KeyArn": "arn:aws:payment-cryptography:us-west-2:111122223333:key/pboipdfzd4mdklya", "KeyCheckValue": "985792" } ``` Weitere Informationen finden Sie unter [Verifizieren des Autorisierungsanforderungs-Kryptogramms (ARQC)](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/data-operations.verifyauthrequestcryptogram.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [VerifyAuthRequestCryptogram](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/verify-auth-request-cryptogram.html)in der *AWS CLI Befehlsreferenz*. ### `verify-card-validation-data` Das folgende Codebeispiel zeigt die Verwendung`verify-card-validation-data`. **AWS CLI** **So validieren Sie einen CVV** Das folgende `verify-card-validation-data` Beispiel validiert einen CVV/ CVV2 für einen PAN. ``` aws payment-cryptography-data verify-card-validation-data \ --key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/tqv5yij6wtxx64pi \ --primary-account-number=171234567890123 \ --verification-attributes CardVerificationValue2={CardExpiryDate=0123} \ --validation-data 801 ``` Ausgabe: ``` { "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/tqv5yij6wtxx64pi", "KeyCheckValue": "CADDA1" } ``` Weitere Informationen finden Sie unter [Verifizieren von Kartendaten](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-card-data.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + *Einzelheiten zur API finden Sie [VerifyCardValidationData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/verify-card-validation-data.html)in AWS CLI der Befehlsreferenz.* ### `verify-mac` Das folgende Codebeispiel zeigt die Verwendung`verify-mac`. **AWS CLI** **So verifizieren Sie einen MAC** Das folgende `verify-mac` Beispiel verifiziert einen Hash-Based Message Authentication Code (HMAC) für die Kartendatenauthentifizierung mithilfe des Algorithmus HMAC\$1 SHA256 und eines HMAC-Verschlüsselungsschlüssels. ``` aws payment-cryptography-data verify-mac \ --key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/qnobl5lghrzunce6 \ --message-data "3b343038383439303031303733393431353d32343038323236303030373030303f33" \ --verification-attributes='Algorithm=HMAC_SHA256' \ --mac ED87F26E961C6D0DDB78DA5038AA2BDDEA0DCE03E5B5E96BDDD494F4A7AA470C ``` Ausgabe: ``` { "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/qnobl5lghrzunce6, "KeyCheckValue": "2976E7", } ``` Weitere Informationen finden Sie unter [Verifizieren des MAC](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-mac.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz. [VerifyMac](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/verify-mac.html)AWS CLI * ### `verify-pin-data` Das folgende Codebeispiel zeigt die Verwendung`verify-pin-data`. **AWS CLI** **So verifizieren Sie eine PIN** Im folgenden Beispiel für `verify-pin-data` wird eine PIN für eine PAN validiert. ``` aws payment-cryptography-data verify-pin-data \ --verification-key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/37y2tsl45p5zjbh2 \ --encryption-key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt \ --primary-account-number 171234567890123 \ --pin-block-format ISO_FORMAT_0 \ --verification-attributes VisaPin="{PinVerificationKeyIndex=1,VerificationValue=5507}" \ --encrypted-pin-block AC17DC148BDA645E ``` Ausgabe: ``` { "VerificationKeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/37y2tsl45p5zjbh2", "VerificationKeyCheckValue": "7F2363", "EncryptionKeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt", "EncryptionKeyCheckValue": "7CC9E2", } ``` Weitere Informationen finden Sie unter [Verifizieren von PIN-Daten](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-pin-data.html) im *Benutzerhandbuch für AWS Payment Cryptography*. + Einzelheiten zur API finden Sie [VerifyPinData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/verify-pin-data.html)in der *AWS CLI Befehlsreferenz*. # Amazon Pinpoint Pinpoint-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon Pinpoint Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-app` Das folgende Codebeispiel zeigt, wie Sie`create-app`. **AWS CLI** **Beispiel 1: Erstellen einer Anwendung** Im folgenden Beispiel für `create-app` wird eine neue Anwendung (Projekt) erstellt. ``` aws pinpoint create-app \ --create-application-request Name=ExampleCorp ``` Ausgabe: ``` { "ApplicationResponse": { "Arn": "arn:aws:mobiletargeting:us-west-2:AIDACKCEVSQ6C2EXAMPLE:apps/810c7aab86d42fb2b56c8c966example", "Id": "810c7aab86d42fb2b56c8c966example", "Name": "ExampleCorp", "tags": {} } } ``` **Beispiel 2: Erstellen einer mit Tags versehenen Anwendung** Im folgenden Beispiel für `create-app` wird eine neue Anwendung (Projekt) erstellt und der Anwendung ein Tag (Schlüssel und Wert) zugeordnet. ``` aws pinpoint create-app \ --create-application-request Name=ExampleCorp,tags={"Stack"="Test"} ``` Ausgabe: ``` { "ApplicationResponse": { "Arn": "arn:aws:mobiletargeting:us-west-2:AIDACKCEVSQ6C2EXAMPLE:apps/810c7aab86d42fb2b56c8c966example", "Id": "810c7aab86d42fb2b56c8c966example", "Name": "ExampleCorp", "tags": { "Stack": "Test" } } } ``` + Einzelheiten zur API finden Sie [CreateApp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/create-app.html)in der *AWS CLI Befehlsreferenz*. ### `create-sms-template` Das folgende Codebeispiel zeigt die Verwendung`create-sms-template`. **AWS CLI** **So erstellen Sie eine Nachrichtenvorlage für Nachrichten, die über den SMS-Kanal gesendet werden** Im folgenden Beispiel für `create-sms-template` wird eine SMS-Nachrichtenvorlage erstellt. ``` aws pinpoint create-sms-template \ --template-name TestTemplate \ --sms-template-request file://myfile.json \ --region us-east-1 ``` Inhalt von `myfile.json`: ``` { "Body": "hello\n how are you?\n food is good", "TemplateDescription": "Test SMS Template" } ``` Ausgabe: ``` { "CreateTemplateMessageBody": { "Arn": "arn:aws:mobiletargeting:us-east-1:AIDACKCEVSQ6C2EXAMPLE:templates/TestTemplate/SMS", "Message": "Created", "RequestID": "8c36b17f-a0b0-400f-ac21-29e9b62a975d" } } ``` Weitere Informationen finden Sie unter [Amazon-Pinpoint-Nachrichtenvorlagen](https://docs.aws.amazon.com/pinpoint/latest/userguide/messages-templates.html) im *Benutzerhandbuch für Amazon Pinpoint*. + Einzelheiten zur API finden Sie [CreateSmsTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/create-sms-template.html)in der *AWS CLI Befehlsreferenz*. ### `delete-app` Das folgende Codebeispiel zeigt die Verwendung`delete-app`. **AWS CLI** **So löschen Sie eine Anwendung** Im folgenden Beispiel für `delete-app` wird eine Anwendung (Projekt) gelöscht. ``` aws pinpoint delete-app \ --application-id 810c7aab86d42fb2b56c8c966example ``` Ausgabe: ``` { "ApplicationResponse": { "Arn": "arn:aws:mobiletargeting:us-west-2:AIDACKCEVSQ6C2EXAMPLE:apps/810c7aab86d42fb2b56c8c966example", "Id": "810c7aab86d42fb2b56c8c966example", "Name": "ExampleCorp", "tags": {} } } ``` + Einzelheiten zur API finden Sie [DeleteApp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/delete-app.html)in der *AWS CLI Befehlsreferenz*. ### `get-apns-channel` Das folgende Codebeispiel zeigt die Verwendung`get-apns-channel`. **AWS CLI** **Um Informationen über den Status und die Einstellungen des APNs Kanals für eine Anwendung abzurufen** Im folgenden `get-apns-channel` Beispiel werden Informationen über den Status und die Einstellungen des APNs Kanals für eine Anwendung abgerufen. ``` aws pinpoint get-apns-channel \ --application-id 9ab1068eb0a6461c86cce7f27ce0efd7 \ --region us-east-1 ``` Ausgabe: ``` { "APNSChannelResponse": { "ApplicationId": "9ab1068eb0a6461c86cce7f27ce0efd7", "CreationDate": "2019-05-09T21:54:45.082Z", "DefaultAuthenticationMethod": "CERTIFICATE", "Enabled": true, "HasCredential": true, "HasTokenKey": false, "Id": "apns", "IsArchived": false, "LastModifiedDate": "2019-05-09T22:04:01.067Z", "Platform": "APNS", "Version": 2 } } ``` + Einzelheiten zur API finden Sie unter [GetApnsChannel AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-apns-channel.html)*Befehlsreferenz.* ### `get-app` Das folgende Codebeispiel zeigt die Verwendung`get-app`. **AWS CLI** **So rufen Sie Informationen über Anwendung (Projekt) ab)** Im folgenden Beispiel für `get-app` werden Informationen über eine Anwendung (Projekt) abgerufen. ``` aws pinpoint get-app \ --application-id 810c7aab86d42fb2b56c8c966example \ --region us-east-1 ``` Ausgabe: ``` { "ApplicationResponse": { "Arn": "arn:aws:mobiletargeting:us-east-1:AIDACKCEVSQ6C2EXAMPLE:apps/810c7aab86d42fb2b56c8c966example", "Id": "810c7aab86d42fb2b56c8c966example", "Name": "ExampleCorp", "tags": { "Year": "2019", "Stack": "Production" } } } ``` + Einzelheiten zur API finden Sie [GetApp](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-app.html)in der *AWS CLI Befehlsreferenz*. ### `get-apps` Das folgende Codebeispiel zeigt die Verwendung`get-apps`. **AWS CLI** **So rufen Sie Informationen über alle Ihre Anwendungen ab** Im folgenden Beispiel für `get-apps` werden Informationen zu allen Ihren Anwendungen (Projekten) abgerufen. ``` aws pinpoint get-apps ``` Ausgabe: ``` { "ApplicationsResponse": { "Item": [ { "Arn": "arn:aws:mobiletargeting:us-west-2:AIDACKCEVSQ6C2EXAMPLE:apps/810c7aab86d42fb2b56c8c966example", "Id": "810c7aab86d42fb2b56c8c966example", "Name": "ExampleCorp", "tags": { "Year": "2019", "Stack": "Production" } }, { "Arn": "arn:aws:mobiletargeting:us-west-2:AIDACKCEVSQ6C2EXAMPLE:apps/42d8c7eb0990a57ba1d5476a3example", "Id": "42d8c7eb0990a57ba1d5476a3example", "Name": "AnyCompany", "tags": {} }, { "Arn": "arn:aws:mobiletargeting:us-west-2:AIDACKCEVSQ6C2EXAMPLE:apps/80f5c382b638ffe5ad12376bbexample", "Id": "80f5c382b638ffe5ad12376bbexample", "Name": "ExampleCorp_Test", "tags": { "Year": "2019", "Stack": "Test" } } ], "NextToken": "eyJDcmVhdGlvbkRhdGUiOiIyMDE5LTA3LTE2VDE0OjM4OjUzLjkwM1oiLCJBY2NvdW50SWQiOiI1MTIzOTcxODM4NzciLCJBcHBJZCI6Ijk1ZTM2MGRiMzBkMjQ1ZjRiYTYwYjhlMzllMzZlNjZhIn0" } } ``` Das Vorhandensein des `NextToken`-Antwortwerts weist darauf hin, dass mehr Ausgabe verfügbar ist. Rufen Sie den Befehl erneut auf und geben Sie diesen Wert als `NextToken`-Eingabeparameter an. + Einzelheiten zur API finden Sie [GetApps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-apps.html)in der *AWS CLI Befehlsreferenz*. ### `get-campaign` Das folgende Codebeispiel zeigt die Verwendung`get-campaign`. **AWS CLI** **So rufen Sie Informationen über den Status, die Konfiguration und andere Einstellungen einer Kampagne ab** Im folgenden Beispiel für `get-campaign` werden Informationen über den Status, die Konfiguration und andere Einstellungen einer Kampagne abgerufen. ``` aws pinpoint get-campaign \ --application-id 6e0b7591a90841d2b5d93fa11143e5a7 \ --campaign-id a1e63c6cc0eb43ed826ffcc3cc90b30d \ --region us-east-1 ``` Ausgabe: ``` { "CampaignResponse": { "AdditionalTreatments": [], "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "Arn": "arn:aws:mobiletargeting:us-east-1:AIDACKCEVSQ6C2EXAMPLE:apps/6e0b7591a90841d2b5d93fa11143e5a7/campaigns/a1e63c6cc0eb43ed826ffcc3cc90b30d", "CreationDate": "2019-10-08T18:40:16.581Z", "Description": " ", "HoldoutPercent": 0, "Id": "a1e63c6cc0eb43ed826ffcc3cc90b30d", "IsPaused": false, "LastModifiedDate": "2019-10-08T18:40:16.581Z", "Limits": { "Daily": 0, "MaximumDuration": 60, "MessagesPerSecond": 50, "Total": 0 }, "MessageConfiguration": { "EmailMessage": { "FromAddress": "sender@example.com", "HtmlBody": "\n \n \n \n\nHello\n", "Title": "PinpointDemo" } }, "Name": "MyCampaign", "Schedule": { "IsLocalTime": false, "StartTime": "IMMEDIATE", "Timezone": "utc" }, "SegmentId": "b66c9e42f71444b2aa2e0ffc1df28f60", "SegmentVersion": 1, "State": { "CampaignStatus": "COMPLETED" }, "tags": {}, "TemplateConfiguration": {}, "Version": 1 } } ``` + Einzelheiten zur API finden Sie [GetCampaign](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-campaign.html)in der *AWS CLI Befehlsreferenz*. ### `get-campaigns` Das folgende Codebeispiel zeigt die Verwendung`get-campaigns`. **AWS CLI** **So rufen Sie Informationen über den Status, die Konfiguration und andere Einstellungen für alle Kampagnen ab, die einer Anwendung zugeordnet sind** Im folgenden Beispiel für `get-campaigns` werden Informationen über den Status, die Konfiguration und andere Einstellungen für alle einer Anwendung zugeordneten Kampagnen ab. ``` aws pinpoint get-campaigns \ --application-id 6e0b7591a90841d2b5d93fa11143e5a7 \ --region us-east-1 ``` Ausgabe: ``` { "CampaignsResponse": { "Item": [ { "AdditionalTreatments": [], "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "Arn": "arn:aws:mobiletargeting:us-east-1:AIDACKCEVSQ6C2EXAMPLE:apps/6e0b7591a90841d2b5d93fa11143e5a7/campaigns/7e1280344c8f4a9aa40a00b006fe44f1", "CreationDate": "2019-10-08T18:40:22.905Z", "Description": " ", "HoldoutPercent": 0, "Id": "7e1280344c8f4a9aa40a00b006fe44f1", "IsPaused": false, "LastModifiedDate": "2019-10-08T18:40:22.905Z", "Limits": {}, "MessageConfiguration": { "EmailMessage": { "FromAddress": "sender@example.com", "HtmlBody": "\n \n \n \n\nHello\n", "Title": "PInpointDemo Test" } }, "Name": "MyCampaign1", "Schedule": { "IsLocalTime": false, "QuietTime": {}, "StartTime": "IMMEDIATE", "Timezone": "UTC" }, "SegmentId": "b66c9e42f71444b2aa2e0ffc1df28f60", "SegmentVersion": 1, "State": { "CampaignStatus": "COMPLETED" }, "tags": {}, "TemplateConfiguration": {}, "Version": 1 }, { "AdditionalTreatments": [], "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "Arn": "arn:aws:mobiletargeting:us-east-1:AIDACKCEVSQ6C2EXAMPLE:apps/6e0b7591a90841d2b5d93fa11143e5a7/campaigns/a1e63c6cc0eb43ed826ffcc3cc90b30d", "CreationDate": "2019-10-08T18:40:16.581Z", "Description": " ", "HoldoutPercent": 0, "Id": "a1e63c6cc0eb43ed826ffcc3cc90b30d", "IsPaused": false, "LastModifiedDate": "2019-10-08T18:40:16.581Z", "Limits": { "Daily": 0, "MaximumDuration": 60, "MessagesPerSecond": 50, "Total": 0 }, "MessageConfiguration": { "EmailMessage": { "FromAddress": "sender@example.com", "HtmlBody": "\n \n \n \n\nDemo\n", "Title": "PinpointDemo" } }, "Name": "MyCampaign2", "Schedule": { "IsLocalTime": false, "StartTime": "IMMEDIATE", "Timezone": "utc" }, "SegmentId": "b66c9e42f71444b2aa2e0ffc1df28f60", "SegmentVersion": 1, "State": { "CampaignStatus": "COMPLETED" }, "tags": {}, "TemplateConfiguration": {}, "Version": 1 } ] } } ``` + Einzelheiten zur API finden Sie [GetCampaigns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-campaigns.html)in der *AWS CLI Befehlsreferenz*. ### `get-channels` Das folgende Codebeispiel zeigt die Verwendung`get-channels`. **AWS CLI** **So rufen Sie Informationen über den Verlauf und den Status jedes Kanals für eine Anwendung ab** Im folgenden Beispiel für `get-channels` werden Informationen über den Verlauf und den Status jedes Kanals für eine Anwendung abgerufen. ``` aws pinpoint get-channels \ --application-id 6e0b7591a90841d2b5d93fa11143e5a7 \ --region us-east-1 ``` Ausgabe: ``` { "ChannelsResponse": { "Channels": { "GCM": { "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "CreationDate": "2019-10-08T18:28:23.182Z", "Enabled": true, "HasCredential": true, "Id": "gcm", "IsArchived": false, "LastModifiedDate": "2019-10-08T18:28:23.182Z", "Version": 1 }, "SMS": { "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "CreationDate": "2019-10-08T18:39:18.511Z", "Enabled": true, "Id": "sms", "IsArchived": false, "LastModifiedDate": "2019-10-08T18:39:18.511Z", "Version": 1 }, "EMAIL": { "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "CreationDate": "2019-10-08T18:27:23.990Z", "Enabled": true, "Id": "email", "IsArchived": false, "LastModifiedDate": "2019-10-08T18:27:23.990Z", "Version": 1 }, "IN_APP": { "Enabled": true, "IsArchived": false, "Version": 0 } } } } ``` + Einzelheiten zur API finden Sie [GetChannels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-channels.html)in der *AWS CLI Befehlsreferenz*. ### `get-email-channel` Das folgende Codebeispiel zeigt die Verwendung`get-email-channel`. **AWS CLI** **So rufen Sie Informationen über den Status und die Einstellungen des E-Mail-kanals für eine Anwendung ab** Im folgenden Beispiel für `get-email-channel` werden der Status und die Einstellungen des E-Mail-Kanals für eine Anwendung abgerufen. ``` aws pinpoint get-email-channel \ --application-id 6e0b7591a90841d2b5d93fa11143e5a7 \ --region us-east-1 ``` Ausgabe: ``` { "EmailChannelResponse": { "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "CreationDate": "2019-10-08T18:27:23.990Z", "Enabled": true, "FromAddress": "sender@example.com", "Id": "email", "Identity": "arn:aws:ses:us-east-1:AIDACKCEVSQ6C2EXAMPLE:identity/sender@example.com", "IsArchived": false, "LastModifiedDate": "2019-10-08T18:27:23.990Z", "MessagesPerSecond": 1, "Platform": "EMAIL", "RoleArn": "arn:aws:iam::AIDACKCEVSQ6C2EXAMPLE:role/pinpoint-events", "Version": 1 } } ``` + Einzelheiten zur API finden Sie [GetEmailChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-email-channel.html)in der *AWS CLI Befehlsreferenz*. ### `get-endpoint` Das folgende Codebeispiel zeigt die Verwendung`get-endpoint`. **AWS CLI** **So rufen Sie Informationen über die Einstellungen und Attribute eines bestimmten Endpunkts für eine Anwendung ab** Das folgende `get-endpoint`-Beispiel ruft Informationen über die Einstellungen und Attribute eines bestimmten Endpunkts für eine Anwendung ab. ``` aws pinpoint get-endpoint \ --application-id 611e3e3cdd47474c9c1399a505665b91 \ --endpoint-id testendpoint \ --region us-east-1 ``` Ausgabe: ``` { "EndpointResponse": { "Address": "+11234567890", "ApplicationId": "611e3e3cdd47474c9c1399a505665b91", "Attributes": {}, "ChannelType": "SMS", "CohortId": "63", "CreationDate": "2019-01-28T23:55:11.534Z", "EffectiveDate": "2021-08-06T00:04:51.763Z", "EndpointStatus": "ACTIVE", "Id": "testendpoint", "Location": { "Country": "USA" }, "Metrics": { "SmsDelivered": 1.0 }, "OptOut": "ALL", "RequestId": "a204b1f2-7e26-48a7-9c80-b49a2143489d", "User": { "UserAttributes": { "Age": [ "24" ] }, "UserId": "testuser" } } } ``` + Einzelheiten zur API finden Sie [GetEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `get-gcm-channel` Das folgende Codebeispiel zeigt die Verwendung`get-gcm-channel`. **AWS CLI** **So rufen Sie Informationen über den Status und die Einstellungen des GCM-Kanals für eine Anwendung ab** Im folgenden Beispiel für `get-gcm-channel` werden der Status und die Einstellungen des GCM-Kanals für eine Anwendung abgerufen. ``` aws pinpoint get-gcm-channel \ --application-id 6e0b7591a90841d2b5d93fa11143e5a7 \ --region us-east-1 ``` Ausgabe: ``` { "GCMChannelResponse": { "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "CreationDate": "2019-10-08T18:28:23.182Z", "Enabled": true, "HasCredential": true, "Id": "gcm", "IsArchived": false, "LastModifiedDate": "2019-10-08T18:28:23.182Z", "Platform": "GCM", "Version": 1 } } ``` + Einzelheiten zur API finden Sie [GetGcmChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-gcm-channel.html)in der *AWS CLI Befehlsreferenz*. ### `get-sms-channel` Das folgende Codebeispiel zeigt die Verwendung`get-sms-channel`. **AWS CLI** **So rufen Sie Informationen über den Status und die Einstellungen jedes Sprachkanals für eine Anwendung ab** Im folgenden Beispiel für `get-sms-channel` werden Status und Einstellungen des SMS-Kanals für eine Anwendung abgerufen. ``` aws pinpoint get-sms-channel \ --application-id 6e0b7591a90841d2b5d93fa11143e5a7 \ --region us-east-1 ``` Ausgabe: ``` { "SMSChannelResponse": { "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "CreationDate": "2019-10-08T18:39:18.511Z", "Enabled": true, "Id": "sms", "IsArchived": false, "LastModifiedDate": "2019-10-08T18:39:18.511Z", "Platform": "SMS", "PromotionalMessagesPerSecond": 20, "TransactionalMessagesPerSecond": 20, "Version": 1 } } ``` + Einzelheiten zur API finden Sie [GetSmsChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-sms-channel.html)in der *AWS CLI Befehlsreferenz*. ### `get-sms-template` Das folgende Codebeispiel zeigt die Verwendung`get-sms-template`. **AWS CLI** **So rufen Sie den Inhalt und die Einstellungen einer Nachrichtenvorlage für Nachrichten ab, die über den SMS-Kanal gesendet werden** Im folgenden Beispiel für `get-sms-template` werden der Inhalt und die Einstellungen einer SMS-Nachrichtenvorlage abgerufen. ``` aws pinpoint get-sms-template \ --template-name TestTemplate \ --region us-east-1 ``` Ausgabe: ``` { "SMSTemplateResponse": { "Arn": "arn:aws:mobiletargeting:us-east-1:AIDACKCEVSQ6C2EXAMPLE:templates/TestTemplate/SMS", "Body": "hello\n how are you?\n food is good", "CreationDate": "2023-06-20T21:37:30.124Z", "LastModifiedDate": "2023-06-20T21:37:30.124Z", "tags": {}, "TemplateDescription": "Test SMS Template", "TemplateName": "TestTemplate", "TemplateType": "SMS", "Version": "1" } } ``` Weitere Informationen finden Sie unter [Amazon-Pinpoint-Nachrichtenvorlagen](https://docs.aws.amazon.com/pinpoint/latest/userguide/messages-templates.html) im *Benutzerhandbuch für Amazon Pinpoint*. + Einzelheiten zur API finden Sie [GetSmsTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-sms-template.html)in der *AWS CLI Befehlsreferenz*. ### `get-voice-channel` Das folgende Codebeispiel zeigt die Verwendung`get-voice-channel`. **AWS CLI** **So rufen Sie Informationen über den Status und die Einstellungen des Sprachkanals für eine Anwendung ab** Im folgenden Beispiel für `get-voice-channel` werden der Status und die Einstellungen des Sprachkanals für eine Anwendung abgerufen. ``` aws pinpoint get-voice-channel \ --application-id 6e0b7591a90841d2b5d93fa11143e5a7 \ --region us-east-1 ``` Ausgabe: ``` { "VoiceChannelResponse": { "ApplicationId": "6e0b7591a90841d2b5d93fa11143e5a7", "CreationDate": "2022-04-28T00:17:03.836Z", "Enabled": true, "Id": "voice", "IsArchived": false, "LastModifiedDate": "2022-04-28T00:17:03.836Z", "Platform": "VOICE", "Version": 1 } } ``` + Einzelheiten zur API finden Sie [GetVoiceChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/get-voice-channel.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So rufen Sie eine Liste der Tags für eine Ressource ab** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags (Schlüsselnamen und -werte) abgerufen, die der angegebenen Ressource zugeordnet sind ``` aws pinpoint list-tags-for-resource \ --resource-arn arn:aws:mobiletargeting:us-west-2:AIDACKCEVSQ6C2EXAMPLE:apps/810c7aab86d42fb2b56c8c966example ``` Ausgabe: ``` { "TagsModel": { "tags": { "Year": "2019", "Stack": "Production" } } } ``` *Weitere Informationen finden Sie unter 'Tagging Amazon Pinpoint Resources < https://docs.aws.amazon.com/pinpoint/ latest/developerguide/tagging -resources.html>'\$1\$1 im Amazon Pinpoint Developer Guide.* + Einzelheiten [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/list-tags-for-resource.html)zur API *AWS CLI finden* Sie in der Befehlsreferenz. ### `phone-number-validate` Das folgende Codebeispiel zeigt die Verwendung`phone-number-validate`. **AWS CLI** **So rufen Sie Informationen zu einer Telefonnummer ab** Im folgenden Beispiel für `phone-number-validate` werden Informationen zu einer Telefonnummer abgerufen. ``` aws pinpoint phone-number-validate \ --number-validate-request PhoneNumber="+12065550142" \ --region us-east-1 ``` Ausgabe: ``` { "NumberValidateResponse": { "Carrier": "ExampleCorp Mobile", "City": "Seattle", "CleansedPhoneNumberE164": "+12065550142", "CleansedPhoneNumberNational": "2065550142", "Country": "United States", "CountryCodeIso2": "US", "CountryCodeNumeric": "1", "OriginalPhoneNumber": "+12065550142", "PhoneType": "MOBILE", "PhoneTypeCode": 0, "Timezone": "America/Los_Angeles", "ZipCode": "98101" } } ``` Weitere Informationen finden Sie unter [Amazon-Pinpoint-SMS-Kanal](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms.html) im *Benutzerhandbuch zu Amazon Pinpoint*. + Einzelheiten zur API finden Sie [PhoneNumberValidate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/phone-number-validate.html)in der *AWS CLI Befehlsreferenz*. ### `send-messages` Das folgende Codebeispiel zeigt die Verwendung`send-messages`. **AWS CLI** **So senden Sie eine SMS-Nachricht über den Endpunkt einer Anwendung** Im folgenden Beispiel für `send-messages` wird eine Direktnachricht für eine Anwendung mit einem Endpunkt gesendet. ``` aws pinpoint send-messages \ --application-id 611e3e3cdd47474c9c1399a505665b91 \ --message-request file://myfile.json \ --region us-west-2 ``` Inhalt von `myfile.json`: ``` { "MessageConfiguration": { "SMSMessage": { "Body": "hello, how are you?" } }, "Endpoints": { "testendpoint": {} } } ``` Ausgabe: ``` { "MessageResponse": { "ApplicationId": "611e3e3cdd47474c9c1399a505665b91", "EndpointResult": { "testendpoint": { "Address": "+12345678900", "DeliveryStatus": "SUCCESSFUL", "MessageId": "itnuqhai5alf1n6ahv3udc05n7hhddr6gb3lq6g0", "StatusCode": 200, "StatusMessage": "MessageId: itnuqhai5alf1n6ahv3udc05n7hhddr6gb3lq6g0" } }, "RequestId": "c7e23264-04b2-4a46-b800-d24923f74753" } } ``` Weitere Informationen finden Sie unter [Amazon-Pinpoint-SMS-Kanal](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms.html) im *Benutzerhandbuch zu Amazon Pinpoint*. + Einzelheiten zur API finden Sie [SendMessages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/send-messages.html)in der *AWS CLI Befehlsreferenz*. ### `send-users-messages` Das folgende Codebeispiel zeigt die Verwendung`send-users-messages`. **AWS CLI** **So senden Sie eine SMS-Nachricht für einen Benutzer einer Anwendung** Im folgenden Beispiel für `send-users-messages` wird eine Direktnachricht für einen Benutzer einer Anwendung gesendet. ``` aws pinpoint send-users-messages \ --application-id 611e3e3cdd47474c9c1399a505665b91 \ --send-users-message-request file://myfile.json \ --region us-west-2 ``` Inhalt von `myfile.json`: ``` { "MessageConfiguration": { "SMSMessage": { "Body": "hello, how are you?" } }, "Users": { "testuser": {} } } ``` Ausgabe: ``` { "SendUsersMessageResponse": { "ApplicationId": "611e3e3cdd47474c9c1399a505665b91", "RequestId": "e0b12cf5-2359-11e9-bb0b-d5fb91876b25", "Result": { "testuser": { "testuserendpoint": { "DeliveryStatus": "SUCCESSFUL", "MessageId": "7qu4hk5bqhda3i7i2n4pjf98qcuh8b7p45ifsmo0", "StatusCode": 200, "StatusMessage": "MessageId: 7qu4hk5bqhda3i7i2n4pjf98qcuh8b7p45ifsmo0", "Address": "+12345678900" } } } } } ``` Weitere Informationen finden Sie unter [Amazon-Pinpoint-SMS-Kanal](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms.html) im *Benutzerhandbuch zu Amazon Pinpoint*. + Einzelheiten zur API finden Sie [SendUsersMessages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/send-users-messages.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie einer Ressource Tags hinzu** Im folgenden Beispiel werden einer Ressource zwei Tags (Schlüsselnamen und -werte) hinzugefügt. ``` aws pinpoint list-tags-for-resource \ --resource-arn arn:aws:mobiletargeting:us-east-1:AIDACKCEVSQ6C2EXAMPLE:apps/810c7aab86d42fb2b56c8c966example \ --tags-model tags={Stack=Production,Year=2019} ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. *Weitere Informationen finden Sie unter 'Tagging Amazon Pinpoint Resources < https://docs.aws.amazon.com/pinpoint/ latest/developerguide/tagging -resources.html>'\$1\$1 im Amazon Pinpoint Developer Guide.* + Einzelheiten [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/tag-resource.html)zur API *AWS CLI finden* Sie in der Befehlsreferenz. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Beispiel 1: So entfernen Sie einen Tag aus einer Ressource** Im folgenden Beispiel für `untag-resource` wird der angegebene Tag (Schlüsselname und -wert) aus der Ressource entfernt. ``` aws pinpoint untag-resource \ --resource-arn arn:aws:mobiletargeting:us-west-2:AIDACKCEVSQ6C2EXAMPLE:apps/810c7aab86d42fb2b56c8c966example \ --tag-keys Year ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. **Beispiel 2: So entfernen Sie mehrere Tags aus einer Ressource** Im folgenden Beispiel für `untag-resource` werden die angegebenen Tags (Schlüsselnamen und -wert) aus der Ressource entfernt. ``` aws pinpoint untag-resource \ --resource-arn arn:aws:mobiletargeting:us-east-1:AIDACKCEVSQ6C2EXAMPLE:apps/810c7aab86d42fb2b56c8c966example \ --tag-keys Year Stack ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. *Weitere Informationen finden Sie unter 'Tagging Amazon Pinpoint Resources < https://docs.aws.amazon.com/pinpoint/ latest/developerguide/tagging -resources.html>'\$1\$1 im Amazon Pinpoint Developer Guide.* + Einzelheiten [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/untag-resource.html)zur API *AWS CLI finden* Sie in der Befehlsreferenz. ### `update-sms-channel` Das folgende Codebeispiel zeigt die Verwendung`update-sms-channel`. **AWS CLI** **So aktivieren Sie den SMS-Kanal oder aktualisieren den Status und die Einstellungen des SMS-Kanals für eine Anwendung.** Im folgenden Beispiel für `update-sms-channel` wird SMS-Kanal für einen SMS-Kanal einer Anwendung aktiviert. ``` aws pinpoint update-sms-channel \ --application-id 611e3e3cdd47474c9c1399a505665b91 \ --sms-channel-request Enabled=true \ --region us-west-2 ``` Ausgabe: ``` { "SMSChannelResponse": { "ApplicationId": "611e3e3cdd47474c9c1399a505665b91", "CreationDate": "2019-01-28T23:25:25.224Z", "Enabled": true, "Id": "sms", "IsArchived": false, "LastModifiedDate": "2023-05-18T23:22:50.977Z", "Platform": "SMS", "PromotionalMessagesPerSecond": 20, "TransactionalMessagesPerSecond": 20, "Version": 3 } } ``` Weitere Informationen finden Sie unter [Amazon-Pinpoint-SMS-Kanal](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms.html) im *Benutzerhandbuch zu Amazon Pinpoint*. + Einzelheiten zur API finden Sie [UpdateSmsChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pinpoint/update-sms-channel.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Amazon Polly mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon Polly Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `delete-lexicon` Das folgende Codebeispiel zeigt, wie Sie`delete-lexicon`. **AWS CLI** **So löschen Sie ein Lexikon** Im folgenden Beispiel für `delete-lexicon` wird das angegebene Lexikon gelöscht. ``` aws polly delete-lexicon \ --name w3c ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden des DeleteLexicon Vorgangs](https://docs.aws.amazon.com/polly/latest/dg/gs-delete-lexicon.html) im *Amazon Polly Developer Guide*. + Einzelheiten zur API finden Sie unter [DeleteLexicon AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/delete-lexicon.html)*Befehlsreferenz.* ### `get-lexicon` Das folgende Codebeispiel zeigt die Verwendung`get-lexicon`. **AWS CLI** **So rufen Sie den Inhalt eines Lexikons ab** Im folgenden Beispiel für `get-lexicon` wird der Inhalt des angegebenen Aussprache-Lexikons abgerufen. ``` aws polly get-lexicon \ --name w3c ``` Ausgabe: ``` { "Lexicon": { "Content": "\n\n \n W3C\n World Wide Web Consortium\n \n\n", "Name": "w3c" }, "LexiconAttributes": { "Alphabet": "ipa", "LanguageCode": "en-US", "LastModified": 1603908910.99, "LexiconArn": "arn:aws:polly:us-west-2:880185128111:lexicon/w3c", "LexemesCount": 1, "Size": 492 } } ``` Weitere Informationen finden Sie unter [Verwenden des GetLexicon Vorgangs](https://docs.aws.amazon.com/polly/latest/dg/gs-get-lexicon.html) im *Amazon Polly Developer Guide*. + Einzelheiten zur API finden Sie unter [GetLexicon AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-lexicon.html)*Befehlsreferenz.* ### `get-speech-synthesis-task` Das folgende Codebeispiel zeigt die Verwendung`get-speech-synthesis-task`. **AWS CLI** **So rufen Sie Informationen über eine Sprachsyntheseaufgabe ab** Im folgenden Beispiel für `get-speech-synthesis-task` werden Informationen über die angegebene Sprachsyntheseaufgabe abgerufen. ``` aws polly get-speech-synthesis-task \ --task-id 70b61c0f-57ce-4715-a247-cae8729dcce9 ``` Ausgabe: ``` { "SynthesisTask": { "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9", "TaskStatus": "completed", "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3", "CreationTime": 1603911042.689, "RequestCharacters": 1311, "OutputFormat": "mp3", "TextType": "text", "VoiceId": "Joanna" } } ``` Weitere Informationen finden Sie unter [Erstellen von langen Audiodateien](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) im *Benutzerhandbuch für Amazon Polly*. + Einzelheiten zur API finden Sie [GetSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-speech-synthesis-task.html)in der *AWS CLI Befehlsreferenz*. ### `list-lexicons` Das folgende Codebeispiel zeigt die Verwendung`list-lexicons`. **AWS CLI** **So listen Sie Ihre Lexika auf** Im folgenden Beispiel für `list-lexicons` werden Ihre Aussprachelexika aufgelistet. ``` aws polly list-lexicons ``` Ausgabe: ``` { "Lexicons": [ { "Name": "w3c", "Attributes": { "Alphabet": "ipa", "LanguageCode": "en-US", "LastModified": 1603908910.99, "LexiconArn": "arn:aws:polly:us-east-2:123456789012:lexicon/w3c", "LexemesCount": 1, "Size": 492 } } ] } ``` Weitere Informationen finden Sie unter [Verwenden des ListLexicons Vorgangs](https://docs.aws.amazon.com/polly/latest/dg/gs-list-lexicons.html) im *Amazon Polly Developer Guide*. + Einzelheiten zur API finden Sie unter [ListLexicons AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-lexicons.html)*Befehlsreferenz.* ### `list-speech-synthesis-tasks` Das folgende Codebeispiel zeigt die Verwendung`list-speech-synthesis-tasks`. **AWS CLI** **So listen Sie Ihre Sprachsyntheseaufgaben auf** Im folgenden Beispiel für `list-speech-synthesis-tasks` werden Ihre Sprachsyntheseaufgaben aufgelistet. ``` aws polly list-speech-synthesis-tasks ``` Ausgabe: ``` { "SynthesisTasks": [ { "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9", "TaskStatus": "completed", "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3", "CreationTime": 1603911042.689, "RequestCharacters": 1311, "OutputFormat": "mp3", "TextType": "text", "VoiceId": "Joanna" } ] } ``` Weitere Informationen finden Sie unter [Erstellen von langen Audiodateien](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) im *Benutzerhandbuch für Amazon Polly*. + Einzelheiten zur API finden Sie [ListSpeechSynthesisTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-speech-synthesis-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `put-lexicon` Das folgende Codebeispiel zeigt die Verwendung`put-lexicon`. **AWS CLI** **So speichern Sie ein Lexikon** Im folgenden Beispiel für `put-lexicon` wird das angegebene Aussprachelexikon gespeichert. Die `example.pls`-Datei spezifiziert ein W3C PLS-konformes Lexikon. ``` aws polly put-lexicon \ --name w3c \ --content file://example.pls ``` Inhalt von `example.pls` ``` { W3C World Wide Web Consortium } ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden des PutLexicon Vorgangs](https://docs.aws.amazon.com/polly/latest/dg/gs-put-lexicon.html) im *Amazon Polly Developer Guide*. + Einzelheiten zur API finden Sie unter [PutLexicon AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/put-lexicon.html)*Befehlsreferenz.* ### `start-speech-synthesis-task` Das folgende Codebeispiel zeigt die Verwendung`start-speech-synthesis-task`. **AWS CLI** **So synthetisieren Sie Text** Das folgende `start-speech-synthesis-task` Beispiel synthetisiert den Text im angegebenen Bucket `text_file.txt` und speichert die resultierende MP3 Datei im angegebenen Bucket. ``` aws polly start-speech-synthesis-task \ --output-format mp3 \ --output-s3-bucket-name amzn-s3-demo-bucket \ --text file://text_file.txt \ --voice-id Joanna ``` Ausgabe: ``` { "SynthesisTask": { "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9", "TaskStatus": "scheduled", "OutputUri": "https://s3.us-east-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3", "CreationTime": 1603911042.689, "RequestCharacters": 1311, "OutputFormat": "mp3", "TextType": "text", "VoiceId": "Joanna" } } ``` Weitere Informationen finden Sie unter [Erstellen von langen Audiodateien](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) im *Benutzerhandbuch für Amazon Polly*. + Einzelheiten zur API finden Sie unter [StartSpeechSynthesisTask AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/start-speech-synthesis-task.html)*Befehlsreferenz.* # AWS-Preisliste Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS-Preisliste. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `describe-services` Das folgende Codebeispiel zeigt, wie Sie`describe-services`. **AWS CLI** **So rufen Sie Service-Metadaten ab** In diesem Beispiel werden die Metadaten für den Amazon-EC2-Servicecode abgerufen. Befehl: ``` aws pricing describe-services --service-code AmazonEC2 --format-version aws_v1 --max-items 1 ``` Ausgabe: ``` { "Services": [ { "ServiceCode": "AmazonEC2", "AttributeNames": [ "volumeType", "maxIopsvolume", "instance", "instanceCapacity10xlarge", "locationType", "instanceFamily", "operatingSystem", "clockSpeed", "LeaseContractLength", "ecu", "networkPerformance", "instanceCapacity8xlarge", "group", "maxThroughputvolume", "gpuMemory", "ebsOptimized", "elasticGpuType", "maxVolumeSize", "gpu", "processorFeatures", "intelAvxAvailable", "instanceCapacity4xlarge", "servicecode", "groupDescription", "processorArchitecture", "physicalCores", "productFamily", "enhancedNetworkingSupported", "intelTurboAvailable", "memory", "dedicatedEbsThroughput", "vcpu", "OfferingClass", "instanceCapacityLarge", "capacitystatus", "termType", "storage", "intelAvx2Available", "storageMedia", "physicalProcessor", "provisioned", "servicename", "PurchaseOption", "instanceCapacity18xlarge", "instanceType", "tenancy", "usagetype", "normalizationSizeFactor", "instanceCapacity2xlarge", "instanceCapacity16xlarge", "maxIopsBurstPerformance", "instanceCapacity12xlarge", "instanceCapacity32xlarge", "instanceCapacityXlarge", "licenseModel", "currentGeneration", "preInstalledSw", "location", "instanceCapacity24xlarge", "instanceCapacity9xlarge", "instanceCapacityMedium", "operation" ] } ], "FormatVersion": "aws_v1" } ``` + Einzelheiten zur API finden Sie [DescribeServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pricing/describe-services.html)in der *AWS CLI Befehlsreferenz*. ### `get-attribute-values` Das folgende Codebeispiel zeigt die Verwendung`get-attribute-values`. **AWS CLI** **So rufen Sie eine Liste von Attributwerten ab** Im folgenden Beispiel für `get-attribute-values` wird eine Liste von Werten für das angegebene Attribut abgerufen. ``` aws pricing get-attribute-values \ --service-code AmazonEC2 \ --attribute-name volumeType \ --max-items 2 ``` Ausgabe: ``` { "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==", "AttributeValues": [ { "Value": "Cold HDD" }, { "Value": "General Purpose" } ] } ``` + Einzelheiten zur API finden Sie [GetAttributeValues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pricing/get-attribute-values.html)in der *AWS CLI Befehlsreferenz*. ### `get-products` Das folgende Codebeispiel zeigt die Verwendung`get-products`. **AWS CLI** **So rufen Sie eine Liste von Produkten ab** Dieses Beispiel ruft eine Liste von Produkten ab, die die angegebenen Kriterien erfüllen. Befehl: ``` aws pricing get-products --filters file://filters.json --format-version aws_v1 --max-results 1 --service-code AmazonEC2 ``` filters.json: ``` [ { "Type": "TERM_MATCH", "Field": "ServiceCode", "Value": "AmazonEC2" }, { "Type": "TERM_MATCH", "Field": "volumeType", "Value": "Provisioned IOPS" } ] ``` Ausgabe: ``` { "FormatVersion": "aws_v1", "NextToken": "WGDY7ko8fQXdlaUZVdasFQ==:RVSagyIFn770XQOzdUIcO9BY6ucBG9itXAZGZF/zioUzOsUKh6PCcPWaOyPZRiMePb986TeoKYB9l55fw/CyoMq5ymnGmT1Vj39TljbbAlhcqnVfTmPIilx8Uy5bdDaBYy/e/2Ofw9Edzsykbs8LTBuNbiDQ+BBds5yeI9AQkUepruKk3aEahFPxJ55kx/zk", "PriceList": [ "{\"product\":{\"productFamily\":\"Storage\",\"attributes\":{\"storageMedia\":\"SSD-backed\",\"maxThroughputvolume\":\"320 MB/sec\",\"volumeType\":\"Provisioned IOPS\",\"maxIopsvolume\":\"20000\",\"servicecode\":\"AmazonEC2\",\"usagetype\":\"APS1-EBS:VolumeUsage.piops\",\"locationType\":\"AWS Region\",\"location\":\"Asia Pacific (Singapore)\",\"servicename\":\"Amazon Elastic Compute Cloud\",\"maxVolumeSize\":\"16 TiB\",\"operation\":\"\"},\"sku\":\"3MKHN58N7RDDVGKJ\"},\"serviceCode\":\"AmazonEC2\",\"terms\":{\"OnDemand\":{\"3MKHN58N7RDDVGKJ.JRTCKXETXF\":{\"priceDimensions\":{\"3MKHN58N7RDDVGKJ.JRTCKXETXF.6YS6EN2CT7\":{\"unit\":\"GB-Mo\",\"endRange\":\"Inf\",\"description\":\"$0.138 per GB-month of Provisioned IOPS SSD (io1) provisioned storage - Asia Pacific (Singapore)\",\"appliesTo\":[],\"rateCode\":\"3MKHN58N7RDDVGKJ.JRTCKXETXF.6YS6EN2CT7\",\"beginRange\":\"0\",\"pricePerUnit\":{\"USD\":\"0.1380000000\"}}},\"sku\":\"3MKHN58N7RDDVGKJ\",\"effectiveDate\":\"2018-08-01T00:00:00Z\",\"offerTermCode\":\"JRTCKXETXF\",\"termAttributes\":{}}}},\"version\":\"20180808005701\",\"publicationDate\":\"2018-08-08T00:57:01Z\"}" ] } ``` + Einzelheiten zur API finden Sie [GetProducts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pricing/get-products.html)in der *AWS CLI Befehlsreferenz*. # AWS Private CA Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Private CA. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-certificate-authority-audit-report` Das folgende Codebeispiel zeigt, wie Sie`create-certificate-authority-audit-report`. **AWS CLI** **So erstellen Sie einen Prüfbericht der Zertifizierungsstelle** Mit dem folgenden `create-certificate-authority-audit-report`-Befehl wird ein Prüfbericht für die private Zertifizierungsstelle erstellt, die durch den ARN identifiziert wurde. ``` aws acm-pca create-certificate-authority-audit-report --certificate-authority-arn arn:aws:acm-pca:us-east-1:accountid:certificate-authority/12345678-1234-1234-1234-123456789012 --s3-bucket-name your-bucket-name --audit-report-response-format JSON ``` + Einzelheiten zur API finden Sie [CreateCertificateAuthorityAuditReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/create-certificate-authority-audit-report.html)in der *AWS CLI Befehlsreferenz*. ### `create-certificate-authority` Das folgende Codebeispiel zeigt die Verwendung`create-certificate-authority`. **AWS CLI** **So erstellen Sie eine private Zertifizierungsstelle** Der folgende `create-certificate-authority` Befehl erstellt eine private Zertifizierungsstelle in Ihrem AWS Konto. ``` aws acm-pca create-certificate-authority --certificate-authority-configuration file://C:\ca_config.txt --revocation-configuration file://C:\revoke_config.txt --certificate-authority-type "SUBORDINATE" --idempotency-token 98256344 ``` + Einzelheiten zur API finden Sie [CreateCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/create-certificate-authority.html)in der *AWS CLI Befehlsreferenz*. ### `delete-certificate-authority` Das folgende Codebeispiel zeigt die Verwendung`delete-certificate-authority`. **AWS CLI** **So löschen Sie eine private Zertifizierungsstelle** Mit dem folgenden `delete-certificate-authority`-Befehl wird die durch den ARN identifizierte Zertifizierungsstelle gelöscht. ``` aws acm-pca delete-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 ``` + Einzelheiten zur API finden Sie [DeleteCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/delete-certificate-authority.html)in der *AWS CLI Befehlsreferenz*. ### `describe-certificate-authority-audit-report` Das folgende Codebeispiel zeigt die Verwendung`describe-certificate-authority-audit-report`. **AWS CLI** **So erstellen Sie einen Prüfbericht für eine Zertifizierungsstelle** Mit dem folgenden `describe-certificate-authority-audit-report`-Befehl werden Informationen über den angegebenen Auditbericht für die vom ARN identifizierte Zertifizierungsstelle aufgelistet. ``` aws acm-pca describe-certificate-authority-audit-report --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/99999999-8888-7777-6666-555555555555 --audit-report-id 11111111-2222-3333-4444-555555555555 ``` + Einzelheiten zur API finden Sie [DescribeCertificateAuthorityAuditReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/describe-certificate-authority-audit-report.html)in der *AWS CLI Befehlsreferenz*. ### `describe-certificate-authority` Das folgende Codebeispiel zeigt die Verwendung`describe-certificate-authority`. **AWS CLI** **So beschreiben Sie eine private Zertifizierungsstelle** Mit dem folgenden `describe-certificate-authority`-Befehl werden Informationen über die vom ARN identifizierte Zertifizierungsstelle aufgelistet. ``` aws acm-pca describe-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 ``` + Einzelheiten zur API finden Sie [DescribeCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/describe-certificate-authority.html)in der *AWS CLI Befehlsreferenz*. ### `get-certificate-authority-certificate` Das folgende Codebeispiel zeigt die Verwendung`get-certificate-authority-certificate`. **AWS CLI** **So rufen Sie ein Zertifikat einer Zertifizierungsstelle (CA) ab** Mit dem folgenden `get-certificate-authority-certificate`-Befehl werden das Zertifikat und die Zertifikatskette für die vom ARN angegebene private Zertifizierungsstelle abgerufen. ``` aws acm-pca get-certificate-authority-certificate --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --output text ``` + Einzelheiten zur API finden Sie [GetCertificateAuthorityCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/get-certificate-authority-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `get-certificate-authority-csr` Das folgende Codebeispiel zeigt die Verwendung`get-certificate-authority-csr`. **AWS CLI** **So rufen Sie die Zertifikatssignierungsanforderung für eine Zertifizierungsstelle ab** Mit dem folgenden `get-certificate-authority-csr`-Befehl wird die Zertifikatssignierungsanforderung für die vom ARN angegebene private Zertifizierungsstelle abgerufen. ``` aws acm-pca get-certificate-authority-csr --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --output text ``` + Einzelheiten zur API finden Sie [GetCertificateAuthorityCsr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/get-certificate-authority-csr.html)in der *AWS CLI Befehlsreferenz*. ### `get-certificate` Das folgende Codebeispiel zeigt die Verwendung`get-certificate`. **AWS CLI** **So rufen Sie ein ausgestelltes Zertifikat ab** Im folgenden Beispiel für `get-certificate` wird ein Zertifikat von der angegebenen privaten Zertifizierungsstelle abgerufen. ``` aws acm-pca get-certificate \ --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 \ --certificate-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012/certificate/6707447683a9b7f4055627ffd55cebcc \ --output text ``` Ausgabe: ``` -----BEGIN CERTIFICATE----- MIIEDzCCAvegAwIBAgIRAJuJ8f6ZVYL7gG/rS3qvrZMwDQYJKoZIhvcNAQELBQAw cTELMAkGA1UEBhMCVVMxEzARBgNVBAgMCldhc2hpbmd0b24xEDAOBgNVBAcMB1Nl ....certificate body truncated for brevity.... tKCSglgZZrd4FdLw1EkGm+UVXnodwMtJEQyy3oTfZjURPIyyaqskTu/KSS7YDjK0 KQNy73D6LtmdOEbAyq10XiDxqY41lvKHJ1eZrPaBmYNABxU= -----END CERTIFICATE---- -----BEGIN CERTIFICATE----- MIIDrzCCApegAwIBAgIRAOskdzLvcj1eShkoyEE693AwDQYJKoZIhvcNAQELBQAw cTELMAkGA1UEBhMCVVMxEzARBgNVBAgMCldhc2hpbmd0b24xEDAOBgNVBAcMB1Nl ...certificate body truncated for brevity.... kdRGB6P2hpxstDOUIwAoCbhoaWwfA4ybJznf+jOQhAziNlRdKQRR8nODWpKt7H9w dJ5nxsTk/fniJz86Ddtp6n8s82wYdkN3cVffeK72A9aTCOU= -----END CERTIFICATE----- ``` Der erste Teil der Ausgabe ist das Zertifikat selbst. Der zweite Teil ist die Zertifikatskette, die mit dem Root-CA-Zertifikat verknüpft ist. Beachten Sie, dass bei Verwendung der Option `--output text` ein `TAB`-Zeichen zwischen den beiden Zertifikatsteilen eingefügt wird (das ist die Ursache für den eingezogenen Text). Wenn Sie beabsichtigen, diese Ausgabe zu verwenden und die Zertifikate mit anderen Tools zu analysieren, müssen Sie das `TAB`-Zeichen möglicherweise entfernen, damit es korrekt verarbeitet wird. + Einzelheiten zur API finden Sie [GetCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/get-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `import-certificate-authority-certificate` Das folgende Codebeispiel zeigt die Verwendung`import-certificate-authority-certificate`. **AWS CLI** **So importieren Sie Ihr Zertifizierungsstellenzertifikat in ACM PCA** Mit dem folgenden `import-certificate-authority-certificate`-Befehl wird das signierte private CA-Zertifikat für die im ARN angegebene Zertifizierungsstelle in ACM PCA importiert. ``` aws acm-pca import-certificate-authority-certificate --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --certificate file://C:\ca_cert.pem --certificate-chain file://C:\ca_cert_chain.pem ``` + Einzelheiten zur API finden Sie [ImportCertificateAuthorityCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/import-certificate-authority-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `issue-certificate` Das folgende Codebeispiel zeigt die Verwendung`issue-certificate`. **AWS CLI** **So stellen Sie ein privates Zertifikat aus** Der folgende `issue-certificate`-Befehl verwendet die im ARN angegebene private Zertifizierungsstelle, um ein privates Zertifikat auszustellen. ``` aws acm-pca issue-certificate --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --csr file://C:\cert_1.csr --signing-algorithm "SHA256WITHRSA" --validity Value=365,Type="DAYS" --idempotency-token 1234 ``` + Einzelheiten zur API finden Sie [IssueCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/issue-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `list-certificate-authorities` Das folgende Codebeispiel zeigt die Verwendung`list-certificate-authorities`. **AWS CLI** **So listen Sie Ihre privaten Zertifizierungsstellen auf** Der folgende `list-certificate-authorities` Befehl listet Informationen über alle privaten Daten CAs in Ihrem Konto auf. ``` aws acm-pca list-certificate-authorities --max-results 10 ``` + Einzelheiten zur API finden Sie [ListCertificateAuthorities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/list-certificate-authorities.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags` Das folgende Codebeispiel zeigt die Verwendung`list-tags`. **AWS CLI** **So listen Sie die Tags für Ihre Zertifizierungsstelle auf** Der folgende `list-tags`-Befehl listet die Tags auf, die der vom ARN angegebenen privaten Zertifizierungsstelle zugeordnet sind. ``` aws acm-pca list-tags --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/123455678-1234-1234-1234-123456789012 --max-results 10 ``` + Einzelheiten zur API finden Sie [ListTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/list-tags.html)in der *AWS CLI Befehlsreferenz*. ### `revoke-certificate` Das folgende Codebeispiel zeigt die Verwendung`revoke-certificate`. **AWS CLI** **So widerrufen Sie ein privates Zertifikat** Der folgende `revoke-certificate`-Befehl widerruft ein privates Zertifikat von der durch den ARN identifizierten Zertifizierungsstelle. ``` aws acm-pca revoke-certificate --certificate-authority-arn arn:aws:acm-pca:us-west-2:1234567890:certificate-authority/12345678-1234-1234-1234-123456789012 --certificate-serial 67:07:44:76:83:a9:b7:f4:05:56:27:ff:d5:5c:eb:cc --revocation-reason "KEY_COMPROMISE" ``` + Einzelheiten zur API finden Sie [RevokeCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/revoke-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `tag-certificate-authority` Das folgende Codebeispiel zeigt die Verwendung`tag-certificate-authority`. **AWS CLI** **So hängen Sie Tags an eine private Zertifizierungsstelle an** Der folgende `tag-certificate-authority`-Befehl hängt Ihrer privaten Zertifizierungsstelle einzelne oder mehrere Tags an. ``` aws acm-pca tag-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice ``` + Einzelheiten zur API finden Sie [TagCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/tag-certificate-authority.html)in der *AWS CLI Befehlsreferenz*. ### `untag-certificate-authority` Das folgende Codebeispiel zeigt die Verwendung`untag-certificate-authority`. **AWS CLI** **So entfernen Sie einzelne oder mehrere Tags aus Ihrer privaten Zertifizierungsstelle** Der folgende `untag-certificate-authority`-Befehl entfernt Tags aus der vom ARN identifizierten Zertifizierungsstelle. ``` aws acm-pca untag-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --tags Key=Purpose,Value=Website ``` + Einzelheiten zur API finden Sie [UntagCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/untag-certificate-authority.html)in der *AWS CLI Befehlsreferenz*. ### `update-certificate-authority` Das folgende Codebeispiel zeigt die Verwendung`update-certificate-authority`. **AWS CLI** **So aktualisierten Sie die Konfiguration Ihrer privaten Zertifizierungsstelle** Der folgende `update-certificate-authority`-Befehl aktualisiert den Status und die Konfiguration der vom ARN identifizierten privaten Zertifizierungsstelle. ``` aws acm-pca update-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-1232456789012 --revocation-configuration file://C:\revoke_config.txt --status "DISABLED" ``` + Einzelheiten zur API finden Sie [UpdateCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/acm-pca/update-certificate-authority.html)in der *AWS CLI Befehlsreferenz*. # AWS Proton Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Proton. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `cancel-service-instance-deployment` Das folgende Codebeispiel zeigt, wie Sie`cancel-service-instance-deployment`. **AWS CLI** **So löschen Sie eine Bereitstellung von Service-Instances** Im folgenden Beispiel für `cancel-service-instance-deployment` wird die Bereitstellung einer Service-Instance gelöscht. ``` aws proton cancel-service-instance-deployment \ --service-instance-name "instance-one" \ --service-name "simple-svc" ``` Ausgabe: ``` { "serviceInstance": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one", "createdAt": "2021-04-02T21:29:59.962000+00:00", "deploymentStatus": "CANCELLING", "environmentName": "simple-env", "lastDeploymentAttemptedAt": "2021-04-02T21:45:15.406000+00:00", "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00", "name": "instance-one", "serviceName": "simple-svc", "spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_optional_input: abc\n my_sample_pipeline_required_input: '123'\ninstances:\n- name: my-instance\n environment: MySimpleEnv\n spec:\n my_sample_service_instance_optional_input: def\n my_sample_service_instance_required_input: '456'\n- name: my-other-instance\n environment: MySimpleEnv\n spec:\n my_sample_service_instance_required_input: '789'\n", "templateMajorVersion": "1", "templateMinorVersion": "1", "templateName": "svc-simple" } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Dienstinstanz](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-update.html) *im AWS Proton Administrator Guide* oder [Aktualisieren einer Dienstinstanz](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-instance-update.html) im *The AWS Proton User* Guide. + Einzelheiten zur API finden Sie [CancelServiceInstanceDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/cancel-service-instance-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-service-pipeline-deployment` Das folgende Codebeispiel zeigt die Verwendung`cancel-service-pipeline-deployment`. **AWS CLI** **So löschen Sie eine Bereitstellung von Service-Pipelines** Im folgenden Beispiel für `cancel-service-pipeline-deployment` wird die Bereitstellung einer Service-Pipeline gelöscht. ``` aws proton cancel-service-pipeline-deployment \ --service-name "simple-svc" ``` Ausgabe: ``` { "pipeline": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/pipeline", "createdAt": "2021-04-02T21:29:59.962000+00:00", "deploymentStatus": "CANCELLING", "lastDeploymentAttemptedAt": "2021-04-02T22:02:45.095000+00:00", "lastDeploymentSucceededAt": "2021-04-02T21:39:28.991000+00:00", "templateMajorVersion": "1", "templateMinorVersion": "1", "templateName": "svc-simple" } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Service-Pipeline](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-pipeline-update.html) *im AWS Proton Administrator Guide* oder [Aktualisieren einer Service-Pipeline](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-pipeline-update.html) im *The AWS Proton User* Guide. + Einzelheiten zur API finden Sie [CancelServicePipelineDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/cancel-service-pipeline-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `create-service` Das folgende Codebeispiel zeigt die Verwendung`create-service`. **AWS CLI** **So erstellen Sie einen Service** Im folgenden Beispiel für `create-service` wird ein Service mit einer Service-Pipeline erstellt. ``` aws proton create-service \ --name "MySimpleService" \ --template-name "fargate-service" \ --template-major-version "1" \ --branch-name "mainline" \ --repository-connection-arn "arn:aws:codestar-connections:region-id:account-id:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \ --repository-id "myorg/myapp" \ --spec file://spec.yaml ``` Inhalt von `spec.yaml`: ``` proton: ServiceSpec pipeline: my_sample_pipeline_required_input: "hello" my_sample_pipeline_optional_input: "bye" instances: - name: "acme-network-dev" environment: "ENV_NAME" spec: my_sample_service_instance_required_input: "hi" my_sample_service_instance_optional_input: "ho" ``` Ausgabe: ``` { "service": { "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService", "createdAt": "2020-11-18T19:50:27.460000+00:00", "lastModifiedAt": "2020-11-18T19:50:27.460000+00:00", "name": "MySimpleService", "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "repositoryId": "myorg/myapp", "status": "CREATE_IN_PROGRESS", "templateName": "fargate-service" } } ``` Weitere Informationen finden Sie unter [Erstellen eines Dienstes](https://docs.aws.amazon.com/proton/latest/adminguide/ag-create-svc.html) im *The AWS Proton Administrator Guide* und [Create a Service](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-create.html) im *The AWS Proton User* Guide. + Einzelheiten zur API finden Sie [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/create-service.html)in der *AWS CLI Befehlsreferenz*. ### `delete-service` Das folgende Codebeispiel zeigt die Verwendung`delete-service`. **AWS CLI** **So löschen Sie einen Service** Im folgenden Beispiel für `delete-service` wird ein Service gelöscht. ``` aws proton delete-service \ --name "simple-svc" ``` Ausgabe: ``` { "service": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc", "branchName": "mainline", "createdAt": "2020-11-28T22:40:50.512000+00:00", "description": "Edit by updating description", "lastModifiedAt": "2020-11-29T00:30:39.248000+00:00", "name": "simple-svc", "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "repositoryId": "myorg/myapp", "status": "DELETE_IN_PROGRESS", "templateName": "fargate-service" } } ``` Weitere Informationen finden Sie unter [Löschen eines Dienstes](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-delete.html) im *The AWS Proton Administrator Guide*. + Einzelheiten zur API finden Sie unter [DeleteService AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/delete-service.html)*Befehlsreferenz.* ### `get-service-instance` Das folgende Codebeispiel zeigt die Verwendung`get-service-instance`. **AWS CLI** **So rufen Sie Details der Service-Instance ab** Im folgenden Beispiel für `get-service-instance` werden Detaildaten für eine Service-Instance abgerufen. ``` aws proton get-service-instance \ --name "instance-one" \ --service-name "simple-svc" ``` Ausgabe: ``` { "serviceInstance": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one", "createdAt": "2020-11-28T22:40:50.512000+00:00", "deploymentStatus": "SUCCEEDED", "environmentName": "simple-env", "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00", "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00", "name": "instance-one", "serviceName": "simple-svc", "spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_optional_input: hello world\n my_sample_pipeline_required_input: pipeline up\ninstances:\n- name: instance-one\n environment: my-simple-env\n spec:\n my_sample_service_instance_optional_input: Ola\n my_sample_service_instance_required_input: Ciao\n", "templateMajorVersion": "1", "templateMinorVersion": "0", "templateName": "svc-simple" } } ``` Weitere Informationen finden Sie unter [Servicedaten anzeigen](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-view.html) im *The AWS Proton Administrator Guide* oder [View Service Data](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-view.html) im *The AWS Proton User* Guide. + Einzelheiten zur API finden Sie [GetServiceInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/get-service-instance.html)in der *AWS CLI Befehlsreferenz*. ### `get-service` Das folgende Codebeispiel zeigt die Verwendung`get-service`. **AWS CLI** **So rufen Sie Servicedetails ab** Im folgenden Beispiel für `get-service` werden Detaildaten für einen Service abgerufen. ``` aws proton get-service \ --name "simple-svc" ``` Ausgabe: ``` { "service": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc", "branchName": "mainline", "createdAt": "2020-11-28T22:40:50.512000+00:00", "lastModifiedAt": "2020-11-28T22:44:51.207000+00:00", "name": "simple-svc", "pipeline": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/pipeline/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "createdAt": "2020-11-28T22:40:50.512000+00:00", "deploymentStatus": "SUCCEEDED", "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00", "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00", "spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_required_input: hello\n my_sample_pipeline_optional_input: bye\ninstances:\n- name: instance-svc-simple\n environment: my-simple-env\n spec:\n my_sample_service_instance_required_input: hi\n my_sample_service_instance_optional_input: ho\n", "templateMajorVersion": "1", "templateMinorVersion": "1", "templateName": "svc-simple" }, "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "repositoryId": "myorg/myapp", "spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_required_input: hello\n my_sample_pipeline_optional_input: bye\ninstances:\n- name: instance-svc-simple\n environment: my-simple-env\n spec:\n my_sample_service_instance_required_input: hi\n my_sample_service_instance_optional_input: ho\n", "status": "ACTIVE", "templateName": "svc-simple" } } ``` Weitere Informationen finden Sie unter [Servicedaten anzeigen](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-view.html) im *The AWS Proton Administrator Guide* oder [View Service Data](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-view.html) im *The AWS Proton User* Guide. + Einzelheiten zur API finden Sie [GetService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/get-service.html)in der *AWS CLI Befehlsreferenz*. ### `list-service-instances` Das folgende Codebeispiel zeigt die Verwendung`list-service-instances`. **AWS CLI** **Beispiel 1: So listen Sie alle Service-Instances auf** Im folgenden `list-service-instances`-Beispiel werden die Service-Instances aufgelistet. ``` aws proton list-service-instances ``` Ausgabe: ``` { "serviceInstances": [ { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one", "createdAt": "2020-11-28T22:40:50.512000+00:00", "deploymentStatus": "SUCCEEDED", "environmentArn": "arn:aws:proton:region-id:123456789012:environment/simple-env", "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00", "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00", "name": "instance-one", "serviceName": "simple-svc", "templateMajorVersion": "1", "templateMinorVersion": "0", "templateName": "fargate-service" } ] } ``` Weitere Informationen finden Sie unter [Dienstinstanzdaten anzeigen](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-view.html) im *The AWS Proton Administrator Guide* oder [View Service Instance-Daten](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-instance-view.html) im *The AWS Proton User* Guide. **Beispiel 2: So listen Sie die angegebene Service-Instance auf** Im folgenden Beispiel für `get-service-instance` wird eine Service-Instance abgerufen. ``` aws proton get-service-instance \ --name "instance-one" \ --service-name "simple-svc" ``` Ausgabe: ``` { "serviceInstance": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one", "createdAt": "2020-11-28T22:40:50.512000+00:00", "deploymentStatus": "SUCCEEDED", "environmentName": "simple-env", "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00", "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00", "name": "instance-one", "serviceName": "simple-svc", "spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_optional_input: hello world\n my_sample_pipeline_required_input: pipeline up\ninstances:\n- name: instance-one\n environment: my-simple-env\n spec:\n my_sample_service_instance_optional_input: Ola\n my_sample_service_instance_required_input: Ciao\n", "templateMajorVersion": "1", "templateMinorVersion": "0", "templateName": "svc-simple" } } ``` Weitere Informationen finden Sie unter [Dienstinstanzdaten anzeigen](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-view.html) im *The AWS Proton Administrator Guide* oder [View Service Instance-Daten](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-instance-view.html) im *The AWS Proton User* Guide. + Einzelheiten zur API finden Sie [ListServiceInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/list-service-instances.html)in der *AWS CLI Befehlsreferenz*. ### `update-service-instance` Das folgende Codebeispiel zeigt die Verwendung`update-service-instance`. **AWS CLI** **So aktualisieren Sie eine Service-Instance auf eine neue Nebenversion** Im folgenden `update-service-instance` Beispiel wird eine Dienstinstanz auf eine neue Nebenversion ihrer Dienstvorlage aktualisiert, die eine neue Instanz namens "my-other-instance" mit einer neuen erforderlichen Eingabe hinzufügt. ``` aws proton update-service-instance \ --service-name "simple-svc" \ --spec "file://service-spec.yaml " \ --template-major-version "1" \ --template-minor-version "1" \ --deployment-type "MINOR_VERSION" \ --name "instance-one" ``` Inhalt von `service-spec.yaml`: ``` proton: ServiceSpec pipeline: my_sample_pipeline_optional_input: "abc" my_sample_pipeline_required_input: "123" instances: - name: "instance-one" environment: "simple-env" spec: my_sample_service_instance_optional_input: "def" my_sample_service_instance_required_input: "456" - name: "my-other-instance" environment: "simple-env" spec: my_sample_service_instance_required_input: "789" ``` Ausgabe: ``` { "serviceInstance": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one", "createdAt": "2021-04-02T21:29:59.962000+00:00", "deploymentStatus": "IN_PROGRESS", "environmentName": "arn:aws:proton:region-id:123456789012:environment/simple-env", "lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00", "lastDeploymentSucceededAt": "2021-04-02T21:29:59.962000+00:00", "name": "instance-one", "serviceName": "simple-svc", "templateMajorVersion": "1", "templateMinorVersion": "0", "templateName": "svc-simple" } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Dienstinstanz](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-update.html) *im AWS Proton Administrator Guide* oder [Aktualisieren einer Dienstinstanz](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-instance-update.html) im *The AWS Proton User* Guide. + Einzelheiten zur API finden Sie [UpdateServiceInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/update-service-instance.html)in der *AWS CLI Befehlsreferenz*. ### `update-service-pipeline` Das folgende Codebeispiel zeigt die Verwendung`update-service-pipeline`. **AWS CLI** **So aktualisieren Sie eine Service-Pipeline** Im folgenden Beispiel für `update-service-pipeline` wird eine Service-Pipeline auf eine neue Nebenversion ihrer Servicevorlage aktualisiert. ``` aws proton update-service-pipeline \ --service-name "simple-svc" \ --spec "file://service-spec.yaml" \ --template-major-version "1" \ --template-minor-version "1" \ --deployment-type "MINOR_VERSION" ``` Ausgabe: ``` { "pipeline": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/pipeline/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "createdAt": "2021-04-02T21:29:59.962000+00:00", "deploymentStatus": "IN_PROGRESS", "lastDeploymentAttemptedAt": "2021-04-02T21:39:28.991000+00:00", "lastDeploymentSucceededAt": "2021-04-02T21:29:59.962000+00:00", "spec": "proton: ServiceSpec\n\npipeline:\n my_sample_pipeline_optional_input: \"abc\"\n my_sample_pipeline_required_input: \"123\"\n\ninstances:\n - name: \"my-instance\"\n environment: \"MySimpleEnv\"\n spec:\n my_sample_service_instance_optional_input: \"def\"\n my_sample_service_instance_required_input: \"456\"\n - name: \"my-other-instance\"\n environment: \"MySimpleEnv\"\n spec:\n my_sample_service_instance_required_input: \"789\"\n", "templateMajorVersion": "1", "templateMinorVersion": "0", "templateName": "svc-simple" } } ``` Weitere Informationen finden Sie unter [Aktualisieren einer Service-Pipeline](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-pipeline-update.html) *im AWS Proton Administrator Guide* oder [Aktualisieren einer Service-Pipeline](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-pipeline-update.html) im *The AWS Proton User* Guide. + Einzelheiten zur API finden Sie [UpdateServicePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/update-service-pipeline.html)in der *AWS CLI Befehlsreferenz*. ### `update-service` Das folgende Codebeispiel zeigt die Verwendung`update-service`. **AWS CLI** **So aktualisieren Sie einen Service** Im folgenden Beispiel für `update-service` wird eine Servicebeschreibung bearbeitet. ``` aws proton update-service \ --name "MySimpleService" \ --description "Edit by updating description" ``` Ausgabe: ``` { "service": { "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService", "branchName": "mainline", "createdAt": "2021-03-12T22:39:42.318000+00:00", "description": "Edit by updating description", "lastModifiedAt": "2021-03-12T22:44:21.975000+00:00", "name": "MySimpleService", "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "repositoryId": "myorg/myapp", "status": "ACTIVE", "templateName": "fargate-service" } } ``` Weitere Informationen finden Sie unter [Bearbeiten eines Dienstes](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-update.html) *im AWS Proton Administrator Guide* oder [Bearbeiten eines Dienstes](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-update.html) *im AWS Proton User* Guide. + Einzelheiten zur API finden Sie [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/update-service.html)in der *AWS CLI Befehlsreferenz*. # Amazon RDS-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie Amazon RDS verwenden. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `add-option-to-option-group` Das folgende Codebeispiel zeigt, wie Sie`add-option-to-option-group`. **AWS CLI** **So fügen Sie eine Option zu einer Optionsgruppe hinzu** Im folgenden Beispiel für `add-option-to-option-group` wird eine Option zu einer angegebenen Optionsgruppe hinzugefügt. ``` aws rds add-option-to-option-group \ --option-group-name myoptiongroup \ --options OptionName=OEM,Port=5500,DBSecurityGroupMemberships=default \ --apply-immediately ``` Ausgabe: ``` { "OptionGroup": { "OptionGroupName": "myoptiongroup", "OptionGroupDescription": "Test Option Group", "EngineName": "oracle-ee", "MajorEngineVersion": "12.1", "Options": [ { "OptionName": "Timezone", "OptionDescription": "Change time zone", "Persistent": true, "Permanent": false, "OptionSettings": [ { "Name": "TIME_ZONE", "Value": "Australia/Sydney", "DefaultValue": "UTC", "Description": "Specifies the timezone the user wants to change the system time to", "ApplyType": "DYNAMIC", "DataType": "STRING", "AllowedValues": "Africa/Cairo,Africa/Casablanca,Africa/Harare,Africa/Lagos,Africa/Luanda,Africa/Monrovia,Africa/Nairobi,Africa/Tripoli,Africa/Windhoek,America/Araguaina,America/Argentina/Buenos_Aires,America/Asuncion,America/Bogota,America/Caracas,America/Chicago,America/Chihuahua,America/Cuiaba,America/Denver,America/Detroit,America/Fortaleza,America/Godthab,America/Guatemala,America/Halifax,America/Lima,America/Los_Angeles,America/Manaus,America/Matamoros,America/Mexico_City,America/Monterrey,America/Montevideo,America/New_York,America/Phoenix,America/Santiago,America/Sao_Paulo,America/Tijuana,America/Toronto,Asia/Amman,Asia/Ashgabat,Asia/Baghdad,Asia/Baku,Asia/Bangkok,Asia/Beirut,Asia/Calcutta,Asia/Damascus,Asia/Dhaka,Asia/Hong_Kong,Asia/Irkutsk,Asia/Jakarta,Asia/Jerusalem,Asia/Kabul,Asia/Karachi,Asia/Kathmandu,Asia/Kolkata,Asia/Krasnoyarsk,Asia/Magadan,Asia/Manila,Asia/Muscat,Asia/Novosibirsk,Asia/Rangoon,Asia/Riyadh,Asia/Seoul,Asia/Shanghai,Asia/Singapore,Asia/Taipei,Asia/Tehran,Asia/Tokyo,Asia/Ulaanbaatar,Asia/Vladivostok,Asia/Yakutsk,Asia/Yerevan,Atlantic/Azores,Atlantic/Cape_Verde,Australia/Adelaide,Australia/Brisbane,Australia/Darwin,Australia/Eucla,Australia/Hobart,Australia/Lord_Howe,Australia/Perth,Australia/Sydney,Brazil/DeNoronha,Brazil/East,Canada/Newfoundland,Canada/Saskatchewan,Etc/GMT-3,Europe/Amsterdam,Europe/Athens,Europe/Berlin,Europe/Dublin,Europe/Helsinki,Europe/Kaliningrad,Europe/London,Europe/Madrid,Europe/Moscow,Europe/Paris,Europe/Prague,Europe/Rome,Europe/Sarajevo,Pacific/Apia,Pacific/Auckland,Pacific/Chatham,Pacific/Fiji,Pacific/Guam,Pacific/Honolulu,Pacific/Kiritimati,Pacific/Marquesas,Pacific/Samoa,Pacific/Tongatapu,Pacific/Wake,US/Alaska,US/Central,US/East-Indiana,US/Eastern,US/Pacific,UTC", "IsModifiable": true, "IsCollection": false } ], "DBSecurityGroupMemberships": [], "VpcSecurityGroupMemberships": [] }, { "OptionName": "OEM", "OptionDescription": "Oracle 12c EM Express", "Persistent": false, "Permanent": false, "Port": 5500, "OptionSettings": [], "DBSecurityGroupMemberships": [ { "DBSecurityGroupName": "default", "Status": "authorized" } ], "VpcSecurityGroupMemberships": [] } ], "AllowsVpcAndNonVpcInstanceMemberships": false, "OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:myoptiongroup" } } ``` Weitere Informationen finden Sie unter [Hinzufügen einer Option zu einer Optionsgruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.AddOption) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [AddOptionToOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-option-to-option-group.html)in der *AWS CLI Befehlsreferenz*. ### `add-role-to-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`add-role-to-db-cluster`. **AWS CLI** **So ordnen Sie einem DB-Cluster eine AWS Identity and Access Management (IAM) -Rolle zu** Im folgenden Beispiel für `add-role-to-db-cluster` wird eine Rolle einem DB-Cluster zugeordnet. ``` aws rds add-role-to-db-cluster \ --db-cluster-identifier mydbcluster \ --role-arn arn:aws:iam::123456789012:role/RDSLoadFromS3 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Zuweisen einer IAM-Rolle zu einem Amazon-Aurora-MySQL DB-Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.Authorizing.IAM.AddRoleToDBCluster.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie unter [AddRoleToDbCluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-role-to-db-cluster.html)*Befehlsreferenz.* ### `add-role-to-db-instance` Das folgende Codebeispiel zeigt die Verwendung`add-role-to-db-instance`. **AWS CLI** **So ordnen Sie einer DB-Instance eine AWS Identity and Access Management (IAM) -Rolle zu** Im folgenden Beispiel für `add-role-to-db-instance` wird die Rolle zu einer Oracle-DB-Instance mit dem Namen `test-instance` hinzugefügt. ``` aws rds add-role-to-db-instance \ --db-instance-identifier test-instance \ --feature-name S3_INTEGRATION \ --role-arn arn:aws:iam::111122223333:role/rds-s3-integration-role ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Voraussetzungen für die Amazon-RDS-Oracle-Integration mit Amazon S3](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-s3-integration.html#oracle-s3-integration.preparing) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [AddRoleToDbInstance AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-role-to-db-instance.html)*Befehlsreferenz.* ### `add-source-identifier-to-subscription` Das folgende Codebeispiel zeigt die Verwendung`add-source-identifier-to-subscription`. **AWS CLI** **So fügen Sie einem Abonnement eine Quell-ID hinzu** Im folgenden Beispiel für `add-source-identifier` wird eine weitere Quell-ID zu einem vorhandenen Abonnement hinzugefügt. ``` aws rds add-source-identifier-to-subscription \ --subscription-name my-instance-events \ --source-identifier test-instance-repl ``` Ausgabe: ``` { "EventSubscription": { "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", "CustSubscriptionId": "my-instance-events", "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", "Enabled": false, "Status": "modifying", "EventCategoriesList": [ "backup", "recovery" ], "CustomerAwsId": "123456789012", "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", "SourceType": "db-instance", "SourceIdsList": [ "test-instance", "test-instance-repl" ] } } ``` + Einzelheiten zur API finden Sie [AddSourceIdentifierToSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-source-identifier-to-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `add-tags-to-resource` Das folgende Codebeispiel zeigt die Verwendung`add-tags-to-resource`. **AWS CLI** **So fügen Sie einer Ressource Tags hinzu** Im folgenden Beispiel für `add-tags-to-resource` werden einer RDS-Datenbank Tags hinzugefügt. ``` aws rds add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:123456789012:db:database-mysql \ --tags "[{\"Key\": \"Name\",\"Value\": \"MyDatabase\"},{\"Key\": \"Environment\",\"Value\": \"test\"}]" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Hinzufügen von Tags zu Amazon-EKS-Ressourcen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) im *Entwicklerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [AddTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-tags-to-resource.html)in der *AWS CLI Befehlsreferenz*. ### `apply-pending-maintenance-action` Das folgende Codebeispiel zeigt die Verwendung`apply-pending-maintenance-action`. **AWS CLI** **So führen Sie ausstehende Wartungsaktionen durch** Im folgenden Beispiel für `apply-pending-maintenance-action` werden anstehende Wartungsaktionen für ein DB-Cluster angewendet. ``` aws rds apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster \ --apply-action system-update \ --opt-in-type immediate ``` Ausgabe: ``` { "ResourcePendingMaintenanceActions": { "ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "OptInStatus": "immediate", "CurrentApplyDate": "2021-01-23T01:07:36.100Z", "Description": "Upgrade to Aurora PostgreSQL 3.3.2" } ] } } ``` Weitere Informationen finden Sie unter [Wartung einer DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html) im *Benutzerhandbuch zu Amazon RDS* und unter [Wartung eines DB-Clusters in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ApplyPendingMaintenanceAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/apply-pending-maintenance-action.html)in der *AWS CLI Befehlsreferenz*. ### `authorize-db-security-group-ingress` Das folgende Codebeispiel zeigt die Verwendung`authorize-db-security-group-ingress`. **AWS CLI** **So ordnen Sie einer DB-Instance eine AWS Identity and Access Management (IAM) -Rolle zu** Im folgenden Beispiel für `authorize-db-security-group-ingress` wird die Standardsicherheitsgruppe mit einer Eingangsregel für den CIDR-IP-Bereich 192.0.2.0/24 konfiguriert. ``` aws rds authorize-db-security-group-ingress \ --db-security-group-name default \ --cidrip 192.0.2.0/24 ``` Ausgabe: ``` { "DBSecurityGroup": { "OwnerId": "123456789012", "DBSecurityGroupName": "default", "DBSecurityGroupDescription": "default", "EC2SecurityGroups": [], "IPRanges": [ { "Status": "authorizing", "CIDRIP": "192.0.2.0/24" } ], "DBSecurityGroupArn": "arn:aws:rds:us-east-1:111122223333:secgrp:default" } } ``` Weitere Informationen finden Sie unter [Autorisieren des Netzwerkzugriffs auf eine DB-Sicherheitsgruppe von einem IP-Bereich](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithSecurityGroups.html#USER_WorkingWithSecurityGroups.Authorizing) aus im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [AuthorizeDbSecurityGroupIngress AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/authorize-db-security-group-ingress.html)*Befehlsreferenz.* ### `backtrack-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`backtrack-db-cluster`. **AWS CLI** **So rückverfolgen Sie einen Aurora-DB-Cluster** Im folgenden Beispiel für `backtrack-db-cluster` wird eine Rückverfolgung des DB-Clusters auf den 19. März 2018 um 10:00 Uhr durchgeführt. ``` aws rds backtrack-db-cluster --db-cluster-identifier sample-cluster --backtrack-to 2018-03-19T10:00:00+00:00 ``` Dieser Befehl gibt einen JSON-Block aus, der die Änderung an der RDS-Ressource bestätigt. + Einzelheiten zur API finden Sie [BacktrackDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/backtrack-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-export-task` Das folgende Codebeispiel zeigt die Verwendung`cancel-export-task`. **AWS CLI** **So exportieren Sie einen Snapshot nach Amazon S3** Im folgenden Beispiel für `cancel-export-task` wird eine laufende Exportaufgabe storniert, die einen Snapshot nach Amazon S3 exportiert. ``` aws rds cancel-export-task \ --export-task-identifier my-s3-export-1 ``` Ausgabe: ``` { "ExportTaskIdentifier": "my-s3-export-1", "SourceArn": "arn:aws:rds:us-east-1:123456789012:snapshot:publisher-final-snapshot", "SnapshotTime": "2019-03-24T20:01:09.815Z", "S3Bucket": "amzn-s3-demo-bucket", "S3Prefix": "", "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/export-snap-S3-role", "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/abcd0000-7bfd-4594-af38-aabbccddeeff", "Status": "CANCELING", "PercentProgress": 0, "TotalExtractedDataInGB": 0 } ``` Weitere Informationen finden Sie unter [Abbrechen einer Snapshot-Exportaufgabe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Canceling) im *Benutzerhandbuch für Amazon RDS* oder [Abbrechen einer Snapshot-Exportaufgabe](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Canceling) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CancelExportTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/cancel-export-task.html)in der *AWS CLI Befehlsreferenz*. ### `copy-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`copy-db-cluster-parameter-group`. **AWS CLI** **So kopieren Sie eine DB-Cluster-Parametergruppe** Im folgenden Beispiel für `copy-db-cluster-parameter-group` wird eine Kopie einer DB-Cluster-Parametergruppe erstellt. ``` aws rds copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier mydbclusterpg \ --target-db-cluster-parameter-group-identifier mydbclusterpgcopy \ --target-db-cluster-parameter-group-description "Copy of mydbclusterpg parameter group" ``` Ausgabe: ``` { "DBClusterParameterGroup": { "DBClusterParameterGroupName": "mydbclusterpgcopy", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpgcopy", "DBParameterGroupFamily": "aurora-mysql5.7", "Description": "Copy of mydbclusterpg parameter group" } } ``` Weitere Informationen finden Sie unter [Kopieren einer DB-Cluster-Parametergruppe](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.CopyingCluster) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CopyDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `copy-db-cluster-snapshot` Das folgende Codebeispiel zeigt die Verwendung`copy-db-cluster-snapshot`. **AWS CLI** **Um einen DB-Cluster-Snapshot zu kopieren** Im folgenden Beispiel für `copy-db-cluster-snapshot` wird eine Kopie eines DB-Cluster-Snapshots einschließlich seiner Tags erstellt. ``` aws rds copy-db-cluster-snapshot \ --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:myaurora-2019-06-04-09-16 --target-db-cluster-snapshot-identifier myclustersnapshotcopy \ --copy-tags ``` Ausgabe: ``` { "DBClusterSnapshot": { "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1e" ], "DBClusterSnapshotIdentifier": "myclustersnapshotcopy", "DBClusterIdentifier": "myaurora", "SnapshotCreateTime": "2019-06-04T09:16:42.649Z", "Engine": "aurora-mysql", "AllocatedStorage": 0, "Status": "available", "Port": 0, "VpcId": "vpc-6594f31c", "ClusterCreateTime": "2019-04-15T14:18:42.785Z", "MasterUsername": "myadmin", "EngineVersion": "5.7.mysql_aurora.2.04.2", "LicenseModel": "aurora-mysql", "SnapshotType": "manual", "PercentProgress": 100, "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE", "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:myclustersnapshotcopy", "IAMDatabaseAuthenticationEnabled": false } } ``` Weitere Informationen finden Sie unter [Kopieren eines Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CopySnapshot.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CopyDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-cluster-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `copy-db-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`copy-db-parameter-group`. **AWS CLI** **So kopieren Sie eine DB-Cluster-Parametergruppe** Im folgenden Beispiel für `copy-db-parameter-group` wird eine Kopie einer DB-Parametergruppe erstellt. ``` aws rds copy-db-parameter-group \ --source-db-parameter-group-identifier mydbpg \ --target-db-parameter-group-identifier mydbpgcopy \ --target-db-parameter-group-description "Copy of mydbpg parameter group" ``` Ausgabe: ``` { "DBParameterGroup": { "DBParameterGroupName": "mydbpgcopy", "DBParameterGroupArn": "arn:aws:rds:us-east-1:814387698303:pg:mydbpgcopy", "DBParameterGroupFamily": "mysql5.7", "Description": "Copy of mydbpg parameter group" } } ``` Weitere Informationen finden Sie unter [Kopieren einer DB-Parametergruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.Copying) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CopyDbParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `copy-db-snapshot` Das folgende Codebeispiel zeigt die Verwendung`copy-db-snapshot`. **AWS CLI** **Um einen DB-Snapshot zu kopieren** Im folgenden Beispiel für `copy-db-snapshot` wird eine Kopie eines DB-Snapshots erstellt. ``` aws rds copy-db-snapshot \ --source-db-snapshot-identifier rds:database-mysql-2019-06-06-08-38 --target-db-snapshot-identifier mydbsnapshotcopy ``` Ausgabe: ``` { "DBSnapshot": { "VpcId": "vpc-6594f31c", "Status": "creating", "Encrypted": true, "SourceDBSnapshotIdentifier": "arn:aws:rds:us-east-1:123456789012:snapshot:rds:database-mysql-2019-06-06-08-38", "MasterUsername": "admin", "Iops": 1000, "Port": 3306, "LicenseModel": "general-public-license", "DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshotcopy", "EngineVersion": "5.6.40", "OptionGroupName": "default:mysql-5-6", "ProcessorFeatures": [], "Engine": "mysql", "StorageType": "io1", "DbiResourceId": "db-ZI7UJ5BLKMBYFGX7FDENCKADC4", "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE", "SnapshotType": "manual", "IAMDatabaseAuthenticationEnabled": false, "SourceRegion": "us-east-1", "DBInstanceIdentifier": "database-mysql", "InstanceCreateTime": "2019-04-30T15:45:53.663Z", "AvailabilityZone": "us-east-1f", "PercentProgress": 0, "AllocatedStorage": 100, "DBSnapshotIdentifier": "mydbsnapshotcopy" } } ``` Weitere Informationen finden Sie unter [Kopieren eines Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [CopyDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `copy-option-group` Das folgende Codebeispiel zeigt die Verwendung`copy-option-group`. **AWS CLI** **So kopieren Sie eine Optionsgruppe** Im folgenden Beispiel für `copy-option-group` wird eine Kopie einer Optionsgruppe erstellt. ``` aws rds copy-option-group \ --source-option-group-identifier myoptiongroup \ --target-option-group-identifier new-option-group \ --target-option-group-description "My option group copy" ``` Ausgabe: ``` { "OptionGroup": { "Options": [], "OptionGroupName": "new-option-group", "MajorEngineVersion": "11.2", "OptionGroupDescription": "My option group copy", "AllowsVpcAndNonVpcInstanceMemberships": true, "EngineName": "oracle-ee", "OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:new-option-group" } } ``` Weitere Informationen finden Sie unter [Erstellen einer Kopie einer Optionsgruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.Copy) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [CopyOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-option-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-blue-green-deployment` Das folgende Codebeispiel zeigt die Verwendung`create-blue-green-deployment`. **AWS CLI** **Beispiel 1: So erstellen Sie eine blue/green Bereitstellung für eine RDS for MySQL-DB-Instance** Das folgende `create-blue-green-deployment` Beispiel erstellt eine blue/green Bereitstellung für eine MySQL-DB-Instance. ``` aws rds create-blue-green-deployment \ --blue-green-deployment-name bgd-cli-test-instance \ --source arn:aws:rds:us-east-1:123456789012:db:my-db-instance \ --target-engine-version 8.0 \ --target-db-parameter-group-name mysql-80-group ``` Ausgabe: ``` { "BlueGreenDeployment": { "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake", "BlueGreenDeploymentName": "bgd-cli-test-instance", "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "PENDING" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "PENDING" }, { "Name": "CONFIGURE_BACKUPS", "Status": "PENDING" }, { "Name": "CREATING_TOPOLOGY_OF_SOURCE", "Status": "PENDING" } ], "Status": "PROVISIONING", "CreateTime": "2022-02-25T21:18:51.183000+00:00" } } ``` Weitere Informationen finden Sie unter [Creating a blue/green Deployment](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-creating.html) im *Amazon RDS-Benutzerhandbuch*. **Beispiel 2: So erstellen Sie eine blue/green Bereitstellung für einen Aurora MySQL-DB-Cluster** Das folgende `create-blue-green-deployment` Beispiel erstellt eine blue/green Bereitstellung für einen Aurora MySQL-DB-Cluster. ``` aws rds create-blue-green-deployment \ --blue-green-deployment-name my-blue-green-deployment \ --source arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster \ --target-engine-version 8.0 \ --target-db-cluster-parameter-group-name ams-80-binlog-enabled \ --target-db-parameter-group-name mysql-80-cluster-group ``` Ausgabe: ``` { "BlueGreenDeployment": { "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake", "BlueGreenDeploymentName": "my-blue-green-deployment", "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "Status": "PROVISIONING" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1", "Status": "PROVISIONING" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2", "Status": "PROVISIONING" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3", "Status": "PROVISIONING" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint", "Status": "PROVISIONING" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint", "Status": "PROVISIONING" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "PENDING" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "PENDING" }, { "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER", "Status": "PENDING" }, { "Name": "CREATE_CUSTOM_ENDPOINTS", "Status": "PENDING" } ], "Status": "PROVISIONING", "CreateTime": "2022-02-25T21:12:00.288000+00:00" } } ``` Weitere Informationen finden Sie unter [Creating a blue/green Deployment](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-creating.html) im *Amazon Aurora Aurora-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateBlueGreenDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-blue-green-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-cluster-endpoint` Das folgende Codebeispiel zeigt die Verwendung`create-db-cluster-endpoint`. **AWS CLI** **So erstellen Sie einen benutzerdefinierten DB-Cluster-Endpunkt** Das folgende `create-db-cluster-endpoint`-Beispiel erstellt einen benutzerdefinierten DB-Cluster-Endpunkt und ordnet ihn dem angegebenen Aurora-DB-Cluster zu. ``` aws rds create-db-cluster-endpoint \ --db-cluster-endpoint-identifier mycustomendpoint \ --endpoint-type reader \ --db-cluster-identifier mydbcluster \ --static-members dbinstance1 dbinstance2 ``` Ausgabe: ``` { "DBClusterEndpointIdentifier": "mycustomendpoint", "DBClusterIdentifier": "mydbcluster", "DBClusterEndpointResourceIdentifier": "cluster-endpoint-ANPAJ4AE5446DAEXAMPLE", "Endpoint": "mycustomendpoint.cluster-custom-cnpexample.us-east-1.rds.amazonaws.com", "Status": "creating", "EndpointType": "CUSTOM", "CustomEndpointType": "READER", "StaticMembers": [ "dbinstance1", "dbinstance2" ], "ExcludedMembers": [], "DBClusterEndpointArn": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:mycustomendpoint" } ``` Weitere Informationen finden Sie unter [Verbindungsmanagement in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CreateDbClusterEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`create-db-cluster-parameter-group`. **AWS CLI** **Um eine DB-Cluster-Parametergruppe zu erstellen** Im folgenden Beispiel für `create-db-cluster-parameter-group` wird eine DB-Cluster-Parametergruppe erstellt. ``` aws rds create-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --db-parameter-group-family aurora5.6 \ --description "My new cluster parameter group" ``` Ausgabe: ``` { "DBClusterParameterGroup": { "DBClusterParameterGroupName": "mydbclusterparametergroup", "DBParameterGroupFamily": "aurora5.6", "Description": "My new cluster parameter group", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup" } } ``` Weitere Informationen finden Sie unter [Erstellen einer DB-Cluster-Parametergruppe](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.CreatingCluster) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CreateDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster-parameter-group.html)unter *AWS CLI Befehlsreferenz*. ### `create-db-cluster-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-db-cluster-snapshot`. **AWS CLI** **Um einen DB-Cluster-Snapshot zu erstellen** Im folgenden Beispiel für `create-db-cluster-snapshot` wird ein DB-Cluster-Snapshot erstellt. ``` aws rds create-db-cluster-snapshot \ --db-cluster-identifier mydbcluster \ --db-cluster-snapshot-identifier mydbclustersnapshot ``` Ausgabe: ``` { "DBClusterSnapshot": { "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1e" ], "DBClusterSnapshotIdentifier": "mydbclustersnapshot", "DBClusterIdentifier": "mydbcluster", "SnapshotCreateTime": "2019-06-18T21:21:00.469Z", "Engine": "aurora-mysql", "AllocatedStorage": 1, "Status": "creating", "Port": 0, "VpcId": "vpc-6594f31c", "ClusterCreateTime": "2019-04-15T14:18:42.785Z", "MasterUsername": "myadmin", "EngineVersion": "5.7.mysql_aurora.2.04.2", "LicenseModel": "aurora-mysql", "SnapshotType": "manual", "PercentProgress": 0, "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE", "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:mydbclustersnapshot", "IAMDatabaseAuthenticationEnabled": false } } ``` Weitere Informationen finden Sie unter [Erstellen eines DB-Cluster-Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CreateSnapshotCluster.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CreateDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster-snapshot.html)unter *AWS CLI Befehlsreferenz*. ### `create-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`create-db-cluster`. **AWS CLI** **Beispiel 1: So erstellen Sie einen MySQL 5.7-kompatiblen DB-Cluster** Im folgenden Beispiel für `create-db-cluster` wird ein MySQL 5.7-kompatibles DB-Cluster unter Verwendung der Standard-Engine-Version erstellt. Ersetzen Sie das Beispielpasswort `secret99` durch ein sicheres Passwort. Wenn Sie die Konsole für das Erstellen eines DB-Clusters verwenden, erstellt Amazon RDS automatisch die Writer-DB-Instance für Ihr DB-Cluster. Wenn Sie jedoch die AWS CLI verwenden, um einen DB-Cluster zu erstellen, müssen Sie die Writer-DB-Instance für Ihren DB-Cluster explizit mit dem `create-db-instance` AWS CLI-Befehl erstellen. ``` aws rds create-db-cluster \ --db-cluster-identifier sample-cluster \ --engine aurora-mysql \ --engine-version 5.7 \ --master-username admin \ --master-user-password secret99 \ --db-subnet-group-name default \ --vpc-security-group-ids sg-0b9130572daf3dc16 ``` Ausgabe: ``` { "DBCluster": { "DBSubnetGroup": "default", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-0b9130572daf3dc16", "Status": "active" } ], "AllocatedStorage": 1, "AssociatedRoles": [], "PreferredBackupWindow": "09:12-09:42", "ClusterCreateTime": "2023-02-27T23:21:33.048Z", "DeletionProtection": false, "IAMDatabaseAuthenticationEnabled": false, "ReadReplicaIdentifiers": [], "EngineMode": "provisioned", "Engine": "aurora-mysql", "StorageEncrypted": false, "MultiAZ": false, "PreferredMaintenanceWindow": "mon:04:31-mon:05:01", "HttpEndpointEnabled": false, "BackupRetentionPeriod": 1, "DbClusterResourceId": "cluster-ANPAJ4AE5446DAEXAMPLE", "DBClusterIdentifier": "sample-cluster", "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1e" ], "MasterUsername": "master", "EngineVersion": "5.7.mysql_aurora.2.11.1", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "DBClusterMembers": [], "Port": 3306, "Status": "creating", "Endpoint": "sample-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com", "DBClusterParameterGroup": "default.aurora-mysql5.7", "HostedZoneId": "Z2R2ITUGPM61AM", "ReaderEndpoint": "sample-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", "CopyTagsToSnapshot": false } } ``` **Beispiel 2: So erstellen Sie ein PostgreSQL-kompatibles DB-Cluster** Das folgende `create-db-cluster`-Beispiel erstellt einen PostgreSQL-kompatiblen DB-Cluster unter Verwendung der Standard-Engine-Version. Ersetzen Sie das Beispielpasswort `secret99` durch ein sicheres Passwort. Wenn Sie die Konsole für das Erstellen eines DB-Clusters verwenden, erstellt Amazon RDS automatisch die Writer-DB-Instance für Ihr DB-Cluster. Wenn Sie jedoch die AWS CLI verwenden, um einen DB-Cluster zu erstellen, müssen Sie die Writer-DB-Instance für Ihren DB-Cluster explizit mit dem `create-db-instance` AWS CLI-Befehl erstellen. ``` aws rds create-db-cluster \ --db-cluster-identifier sample-pg-cluster \ --engine aurora-postgresql \ --master-username master \ --master-user-password secret99 \ --db-subnet-group-name default \ --vpc-security-group-ids sg-0b9130572daf3dc16 ``` Ausgabe: ``` { "DBCluster": { "Endpoint": "sample-pg-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com", "HttpEndpointEnabled": false, "DBClusterMembers": [], "EngineMode": "provisioned", "CopyTagsToSnapshot": false, "HostedZoneId": "Z2R2ITUGPM61AM", "IAMDatabaseAuthenticationEnabled": false, "AllocatedStorage": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-0b9130572daf3dc16", "Status": "active" } ], "DeletionProtection": false, "StorageEncrypted": false, "BackupRetentionPeriod": 1, "PreferredBackupWindow": "09:56-10:26", "ClusterCreateTime": "2023-02-27T23:26:08.371Z", "DBClusterParameterGroup": "default.aurora-postgresql13", "EngineVersion": "13.7", "Engine": "aurora-postgresql", "Status": "creating", "DBClusterIdentifier": "sample-pg-cluster", "MultiAZ": false, "Port": 5432, "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-pg-cluster", "AssociatedRoles": [], "DbClusterResourceId": "cluster-ANPAJ4AE5446DAEXAMPLE", "PreferredMaintenanceWindow": "wed:03:33-wed:04:03", "ReaderEndpoint": "sample-pg-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", "MasterUsername": "master", "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c" ], "ReadReplicaIdentifiers": [], "DBSubnetGroup": "default" } } ``` Weitere Informationen finden Sie unter [Erstellen eines DB-Clusters in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CreateDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-instance-read-replica` Das folgende Codebeispiel zeigt die Verwendung`create-db-instance-read-replica`. **AWS CLI** **So erstellen Sie ein DB-Instance-Lesereplikat** In diesem Beispiel wird eine Read Replica einer vorhandenen DB-Instance mit dem Namen `test-instance` erstellt. Die Read Replica trägt den Namen `test-instance-repl`. ``` aws rds create-db-instance-read-replica \ --db-instance-identifier test-instance-repl \ --source-db-instance-identifier test-instance ``` Ausgabe: ``` { "DBInstance": { "IAMDatabaseAuthenticationEnabled": false, "MonitoringInterval": 0, "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl", "ReadReplicaSourceDBInstanceIdentifier": "test-instance", "DBInstanceIdentifier": "test-instance-repl", ...some output truncated... } } ``` + Einzelheiten zur API finden Sie [CreateDbInstanceReadReplica](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-instance-read-replica.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-instance` Das folgende Codebeispiel zeigt die Verwendung`create-db-instance`. **AWS CLI** **Um eine DB-Instance zu erstellen** Im folgenden Beispiel für `create-db-instance` werden die zum Starten einer neuen DB-Instance erforderlichen Optionen verwendet. ``` aws rds create-db-instance \ --db-instance-identifier test-mysql-instance \ --db-instance-class db.t3.micro \ --engine mysql \ --master-username admin \ --master-user-password secret99 \ --allocated-storage 20 ``` Ausgabe: ``` { "DBInstance": { "DBInstanceIdentifier": "test-mysql-instance", "DBInstanceClass": "db.t3.micro", "Engine": "mysql", "DBInstanceStatus": "creating", "MasterUsername": "admin", "AllocatedStorage": 20, "PreferredBackupWindow": "12:55-13:25", "BackupRetentionPeriod": 1, "DBSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-12345abc", "Status": "active" } ], "DBParameterGroups": [ { "DBParameterGroupName": "default.mysql5.7", "ParameterApplyStatus": "in-sync" } ], "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-2ff2ff2f", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-########", "SubnetAvailabilityZone": { "Name": "us-west-2c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-########", "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-########", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-########", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:08:07-sun:08:37", "PendingModifiedValues": { "MasterUserPassword": "****" }, "MultiAZ": false, "EngineVersion": "5.7.22", "AutoMinorVersionUpgrade": true, "ReadReplicaDBInstanceIdentifiers": [], "LicenseModel": "general-public-license", "OptionGroupMemberships": [ { "OptionGroupName": "default:mysql-5-7", "Status": "in-sync" } ], "PubliclyAccessible": true, "StorageType": "gp2", "DbInstancePort": 0, "StorageEncrypted": false, "DbiResourceId": "db-5555EXAMPLE44444444EXAMPLE", "CACertificateIdentifier": "rds-ca-2019", "DomainMemberships": [], "CopyTagsToSnapshot": false, "MonitoringInterval": 0, "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:test-mysql-instance", "IAMDatabaseAuthenticationEnabled": false, "PerformanceInsightsEnabled": false, "DeletionProtection": false, "AssociatedRoles": [] } } ``` Weitere Informationen finden Sie unter [Erstellen einer Amazon-RDS-DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [Create DBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-instance.html) in *AWS CLI Command Reference*. ### `create-db-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`create-db-parameter-group`. **AWS CLI** **Um eine DB-Parametergruppe zu erstellen** Im folgenden Beispiel für `create-db-parameter-group` wird eine DB-Parametergruppe erstellt. ``` aws rds create-db-parameter-group \ --db-parameter-group-name mydbparametergroup \ --db-parameter-group-family MySQL5.6 \ --description "My new parameter group" ``` Ausgabe: ``` { "DBParameterGroup": { "DBParameterGroupName": "mydbparametergroup", "DBParameterGroupFamily": "mysql5.6", "Description": "My new parameter group", "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:mydbparametergroup" } } ``` Weitere Informationen finden Sie unter [Erstellen einer DB-Parametergruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.Creating) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [DBParameterGruppe erstellen](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-parameter-group.html) in der *AWS CLI Befehlsreferenz*. ### `create-db-proxy-endpoint` Das folgende Codebeispiel zeigt die Verwendung`create-db-proxy-endpoint`. **AWS CLI** **So erstellen Sie einen DB-Proxy-Endpunkt für eine RDS-Datenbank** Im folgenden Beispiel für `create-db-proxy-endpoint` wird ein DB-Proxy-Endpunkt erstellt. ``` aws rds create-db-proxy-endpoint \ --db-proxy-name proxyExample \ --db-proxy-endpoint-name "proxyep1" \ --vpc-subnet-ids subnetgroup1 subnetgroup2 ``` Ausgabe: ``` { "DBProxyEndpoint": { "DBProxyEndpointName": "proxyep1", "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab", "DBProxyName": "proxyExample", "Status": "creating", "VpcId": "vpc-1234567", "VpcSecurityGroupIds": [ "sg-1234", "sg-5678" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Endpoint": "proxyep1.endpoint.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com", "CreatedDate": "2023-04-05T16:09:33.452000+00:00", "TargetRole": "READ_WRITE", "IsDefault": false } } ``` Weitere Informationen finden Sie unter [Erstellen eines Proxy-Endpunkts](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.CreatingEndpoint) im *Benutzerhandbuch für Amazon RDS* und [Erstellen eines Proxy-Endpunkts](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.CreatingEndpoint) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CreateDbProxyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-proxy-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-proxy` Das folgende Codebeispiel zeigt die Verwendung`create-db-proxy`. **AWS CLI** **So erstellen Sie einen DB-Proxy für eine RDS-Datenbank** Im folgenden Beispiel für `create-db-proxy` wird ein DB-Proxy erstellt. ``` aws rds create-db-proxy \ --db-proxy-name proxyExample \ --engine-family MYSQL \ --auth Description="proxydescription1",AuthScheme="SECRETS",SecretArn="arn:aws:secretsmanager:us-west-2:123456789123:secret:secretName-1234f",IAMAuth="DISABLED",ClientPasswordAuthType="MYSQL_NATIVE_PASSWORD" \ --role-arn arn:aws:iam::123456789123:role/ProxyRole \ --vpc-subnet-ids subnetgroup1 subnetgroup2 ``` Ausgabe: ``` { "DBProxy": { "DBProxyName": "proxyExample", "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab", "EngineFamily": "MYSQL", "VpcId": "vpc-1234567", "VpcSecuritytGroupIds": [ "sg-1234", "sg-5678", "sg-9101" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Auth": "[ { "Description": "proxydescription1", "AuthScheme": "SECRETS", "SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:proxysecret1-Abcd1e", "IAMAuth": "DISABLED" } ]", "RoleArn": "arn:aws:iam::12345678912:role/ProxyRole", "Endpoint": "proxyExample.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com", "RequireTLS": false, "IdleClientTimeout": 1800, "DebuggingLogging": false, "CreatedDate": "2023-04-05T16:09:33.452000+00:00", "UpdatedDate": "2023-04-13T01:49:38.568000+00:00" } } ``` Weitere Informationen finden Sie unter [Erstellen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-creating) im *Benutzerhandbuch für Amazon RDS* und [Erstellen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-creating) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CreateDbProxy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-proxy.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-security-group` Das folgende Codebeispiel zeigt die Verwendung`create-db-security-group`. **AWS CLI** **So erstellen Sie eine Sicherheitsgruppe für Amazon RDS DB** Der folgende `create-db-security-group`-Befehl erstellt eine neue Sicherheitsgruppe für Amazon RDS DB: ``` aws rds create-db-security-group --db-security-group-name mysecgroup --db-security-group-description "My Test Security Group" ``` Im Beispiel hat die neue DB-Sicherheitsgruppe einen Namen `mysecgroup` und eine Beschreibung. Ausgabe: ``` { "DBSecurityGroup": { "OwnerId": "123456789012", "DBSecurityGroupName": "mysecgroup", "DBSecurityGroupDescription": "My Test Security Group", "VpcId": "vpc-a1b2c3d4", "EC2SecurityGroups": [], "IPRanges": [], "DBSecurityGroupArn": "arn:aws:rds:us-west-2:123456789012:secgrp:mysecgroup" } } ``` + Einzelheiten zur API finden Sie [CreateDbSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-security-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-shard-group` Das folgende Codebeispiel zeigt die Verwendung`create-db-shard-group`. **AWS CLI** **Beispiel 1: So erstellen Sie ein primärer DB-Cluster von Aurora PostgreSQL** Im folgenden `create-db-cluster` Beispiel wird ein primärer SQL-DB-Cluster von Aurora PostgreSQL erstellt, der mit Aurora Serverless v2 und Aurora Limitless Database kompatibel ist. ``` aws rds create-db-cluster \ --db-cluster-identifier my-sv2-cluster \ --engine aurora-postgresql \ --engine-version 15.2-limitless \ --storage-type aurora-iopt1 \ --serverless-v2-scaling-configuration MinCapacity=2,MaxCapacity=16 \ --enable-limitless-database \ --master-username myuser \ --master-user-password mypassword \ --enable-cloudwatch-logs-exports postgresql ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-2b", "us-east-2c", "us-east-2a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "my-sv2-cluster", "DBClusterParameterGroup": "default.aurora-postgresql15", "DBSubnetGroup": "default", "Status": "creating", "Endpoint": "my-sv2-cluster.cluster-cekycexample.us-east-2.rds.amazonaws.com", "ReaderEndpoint": "my-sv2-cluster.cluster-ro-cekycexample.us-east-2.rds.amazonaws.com", "MultiAZ": false, "Engine": "aurora-postgresql", "EngineVersion": "15.2-limitless", "Port": 5432, "MasterUsername": "myuser", "PreferredBackupWindow": "06:05-06:35", "PreferredMaintenanceWindow": "mon:08:25-mon:08:55", "ReadReplicaIdentifiers": [], "DBClusterMembers": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-########", "Status": "active" } ], "HostedZoneId": "Z2XHWR1EXAMPLE", "StorageEncrypted": false, "DbClusterResourceId": "cluster-XYEDT6ML6FHIXH4Q2J1EXAMPLE", "DBClusterArn": "arn:aws:rds:us-east-2:123456789012:cluster:my-sv2-cluster", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2024-02-19T16:24:07.771000+00:00", "EnabledCloudwatchLogsExports": [ "postgresql" ], "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false, "DomainMemberships": [], "TagList": [], "StorageType": "aurora-iopt1", "AutoMinorVersionUpgrade": true, "ServerlessV2ScalingConfiguration": { "MinCapacity": 2.0, "MaxCapacity": 16.0 }, "NetworkType": "IPV4", "IOOptimizedNextAllowedModificationTime": "2024-03-21T16:24:07.781000+00:00", "LimitlessDatabase": { "Status": "not-in-use", "MinRequiredACU": 96.0 } } } ``` **Beispiel 2: So erstellen Sie die primäre (Writer-)DB-Instance** Im folgenden Beispiel für `create-db-instance` wird eine primäre (Writer-)DB-Instance mit Aurora Serverless v2 erstellt. Wenn Sie die Konsole für das Erstellen eines DB-Clusters verwenden, erstellt Amazon RDS automatisch die Writer-DB-Instance für Ihr DB-Cluster. Wenn Sie jedoch die AWS CLI verwenden, um einen DB-Cluster zu erstellen, müssen Sie die Writer-DB-Instance für Ihren DB-Cluster explizit mit dem `create-db-instance` AWS CLI-Befehl erstellen. ``` aws rds create-db-instance \ --db-instance-identifier my-sv2-instance \ --db-cluster-identifier my-sv2-cluster \ --engine aurora-postgresql \ --db-instance-class db.serverless ``` Ausgabe: ``` { "DBInstance": { "DBInstanceIdentifier": "my-sv2-instance", "DBInstanceClass": "db.serverless", "Engine": "aurora-postgresql", "DBInstanceStatus": "creating", "MasterUsername": "myuser", "AllocatedStorage": 1, "PreferredBackupWindow": "06:05-06:35", "BackupRetentionPeriod": 1, "DBSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-########", "Status": "active" } ], "DBParameterGroups": [ { "DBParameterGroupName": "default.aurora-postgresql15", "ParameterApplyStatus": "in-sync" } ], "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-########", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-########", "SubnetAvailabilityZone": { "Name": "us-east-2c" }, "SubnetOutpost": {}, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-########", "SubnetAvailabilityZone": { "Name": "us-east-2a" }, "SubnetOutpost": {}, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-########", "SubnetAvailabilityZone": { "Name": "us-east-2b" }, "SubnetOutpost": {}, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "fri:09:01-fri:09:31", "PendingModifiedValues": { "PendingCloudwatchLogsExports": { "LogTypesToEnable": [ "postgresql" ] } }, "MultiAZ": false, "EngineVersion": "15.2-limitless", "AutoMinorVersionUpgrade": true, "ReadReplicaDBInstanceIdentifiers": [], "LicenseModel": "postgresql-license", "OptionGroupMemberships": [ { "OptionGroupName": "default:aurora-postgresql-15", "Status": "in-sync" } ], "PubliclyAccessible": false, "StorageType": "aurora-iopt1", "DbInstancePort": 0, "DBClusterIdentifier": "my-sv2-cluster", "StorageEncrypted": false, "DbiResourceId": "db-BIQTE3B3K3RM7M74SK5EXAMPLE", "CACertificateIdentifier": "rds-ca-rsa2048-g1", "DomainMemberships": [], "CopyTagsToSnapshot": false, "MonitoringInterval": 0, "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-2:123456789012:db:my-sv2-instance", "IAMDatabaseAuthenticationEnabled": false, "PerformanceInsightsEnabled": false, "DeletionProtection": false, "AssociatedRoles": [], "TagList": [], "CustomerOwnedIpEnabled": false, "BackupTarget": "region", "NetworkType": "IPV4", "StorageThroughput": 0, "CertificateDetails": { "CAIdentifier": "rds-ca-rsa2048-g1" }, "DedicatedLogVolume": false } } ``` **Beispiel 3: So erstellen Sie die DB-Shard-Gruppe** Das folgende `create-db-shard-group`-Beispiel erstellt eine DB-Shard-Gruppe in Ihrem primären Aurora PostgreSQL-DB-Cluster. ``` aws rds create-db-shard-group \ --db-shard-group-identifier my-db-shard-group \ --db-cluster-identifier my-sv2-cluster \ --max-acu 768 ``` Ausgabe: ``` { "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890", "DBShardGroupIdentifier": "my-db-shard-group", "DBClusterIdentifier": "my-sv2-cluster", "MaxACU": 768.0, "ComputeRedundancy": 0, "Status": "creating", "PubliclyAccessible": false, "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" } ``` Weitere Informationen finden Sie unter [Verwenden von Amazon Aurora Serverless v2](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CreateDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-shard-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-db-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-db-snapshot`. **AWS CLI** **Um einen DB-Snapshot zu erstellen** Im folgenden Beispiel für `create-db-snapshot` wird ein Upgrade für einen DB-Snapshot ausgeführt. ``` aws rds create-db-snapshot \ --db-instance-identifier database-mysql \ --db-snapshot-identifier mydbsnapshot ``` Ausgabe: ``` { "DBSnapshot": { "DBSnapshotIdentifier": "mydbsnapshot", "DBInstanceIdentifier": "database-mysql", "Engine": "mysql", "AllocatedStorage": 100, "Status": "creating", "Port": 3306, "AvailabilityZone": "us-east-1b", "VpcId": "vpc-6594f31c", "InstanceCreateTime": "2019-04-30T15:45:53.663Z", "MasterUsername": "admin", "EngineVersion": "5.6.40", "LicenseModel": "general-public-license", "SnapshotType": "manual", "Iops": 1000, "OptionGroupName": "default:mysql-5-6", "PercentProgress": 0, "StorageType": "io1", "Encrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE", "DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot", "IAMDatabaseAuthenticationEnabled": false, "ProcessorFeatures": [], "DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Erstellen eines DB-Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [Create DBSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-snapshot.html) in *AWS CLI Command Reference*. ### `create-db-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`create-db-subnet-group`. **AWS CLI** **So erstellen Sie eine DB-Sicherheitsgruppe** Das folgende `create-db-subnet-group`-Beispiel erstellt eine DB-Subnetzgruppe, die unter Verwendung vorhandener Subnetze aufgerufen wird`mysubnetgroup`. ``` aws rds create-db-subnet-group \ --db-subnet-group-name mysubnetgroup \ --db-subnet-group-description "test DB subnet group" \ --subnet-ids '["subnet-0a1dc4e1a6f123456","subnet-070dd7ecb3aaaaaaa","subnet-00f5b198bc0abcdef"]' ``` Ausgabe: ``` { "DBSubnetGroup": { "DBSubnetGroupName": "mysubnetgroup", "DBSubnetGroupDescription": "test DB subnet group", "VpcId": "vpc-0f08e7610a1b2c3d4", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-070dd7ecb3aaaaaaa", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-00f5b198bc0abcdef", "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-0a1dc4e1a6f123456", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ], "DBSubnetGroupArn": "arn:aws:rds:us-west-2:0123456789012:subgrp:mysubnetgroup" } } ``` Weitere Informationen finden Sie unter [Erstellen einer DB-Instance in einer VPC](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.InstanceInVPC) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [CreateDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-subnet-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-event-subscription` Das folgende Codebeispiel zeigt die Verwendung`create-event-subscription`. **AWS CLI** **Um ein Event-Abonnement zu erstellen** Im folgenden `create-event-subscription` Beispiel wird ein Abonnement für Sicherungs- und Wiederherstellungsereignisse für DB-Instances im aktuellen AWS Konto erstellt. Benachrichtigungen werden an ein von `--sns-topic-arn` vorgegebenes Thema des Amazon Simple Notification Service gesendet. ``` aws rds create-event-subscription \ --subscription-name my-instance-events \ --source-type db-instance \ --event-categories '["backup","recovery"]' \ --sns-topic-arn arn:aws:sns:us-east-1:123456789012:interesting-events ``` Ausgabe: ``` { "EventSubscription": { "Status": "creating", "CustSubscriptionId": "my-instance-events", "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", "EventCategoriesList": [ "backup", "recovery" ], "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", "CustomerAwsId": "123456789012", "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", "SourceType": "db-instance", "Enabled": true } } ``` + Einzelheiten zur API finden Sie [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-event-subscription.html)unter *AWS CLI Befehlsreferenz*. ### `create-global-cluster` Das folgende Codebeispiel zeigt die Verwendung`create-global-cluster`. **AWS CLI** **So erstellen Sie einen globalen DB-Cluster** Im folgenden Beispiel für `create-global-cluster` wird ein neuer Aurora-MySQL-kompatibler globaler DB-Cluster erstellt. ``` aws rds create-global-cluster \ --global-cluster-identifier myglobalcluster \ --engine aurora-mysql ``` Ausgabe: ``` { "GlobalCluster": { "GlobalClusterIdentifier": "myglobalcluster", "GlobalClusterResourceId": "cluster-f0e523bfe07aabb", "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster", "Status": "available", "Engine": "aurora-mysql", "EngineVersion": "5.7.mysql_aurora.2.07.2", "StorageEncrypted": false, "DeletionProtection": false, "GlobalClusterMembers": [] } } ``` Weitere Informationen finden Sie unter [Erstellen einer globalen Aurora-Datenbank](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-getting-started.html#aurora-global-database-creating) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CreateGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-global-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `create-option-group` Das folgende Codebeispiel zeigt die Verwendung`create-option-group`. **AWS CLI** **So erstellen Sie eine Amazon-RDS-Optionsgruppe** Der folgende `create-option-group`-Befehl erstellt eine neue Amazon-RDS-Optionsgruppe für `Oracle Enterprise Edition` Version `11.2`, is named ``MyOptionGroup` und enthält eine Beschreibung. ``` aws rds create-option-group \ --option-group-name MyOptionGroup \ --engine-name oracle-ee \ --major-engine-version 11.2 \ --option-group-description "Oracle Database Manager Database Control" ``` Ausgabe: ``` { "OptionGroup": { "OptionGroupName": "myoptiongroup", "OptionGroupDescription": "Oracle Database Manager Database Control", "EngineName": "oracle-ee", "MajorEngineVersion": "11.2", "Options": [], "AllowsVpcAndNonVpcInstanceMemberships": true, "OptionGroupArn": "arn:aws:rds:us-west-2:123456789012:og:myoptiongroup" } } ``` + Einzelheiten zur API finden Sie [CreateOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-option-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-blue-green-deployment` Das folgende Codebeispiel zeigt die Verwendung`delete-blue-green-deployment`. **AWS CLI** **Beispiel 1: So löschen Sie Ressourcen in einer grünen Umgebung für eine Instance von RDS für MySQL-DB** Im folgenden Beispiel für `delete-blue-green-deployment` werden die Ressourcen in einer grünen Umgebung für eine Instance von RDS für MySQL-DB gelöscht. ``` aws rds delete-blue-green-deployment \ --blue-green-deployment-identifier bgd-v53303651eexfake \ --delete-target ``` Ausgabe: ``` { "BlueGreenDeployment": { "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake", "BlueGreenDeploymentName": "bgd-cli-test-instance", "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance", "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-j382ha", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ejv4ao", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-vlpz3t", "Status": "AVAILABLE" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "COMPLETED" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "COMPLETED" }, { "Name": "CONFIGURE_BACKUPS", "Status": "COMPLETED" }, { "Name": "CREATING_TOPOLOGY_OF_SOURCE", "Status": "COMPLETED" } ], "Status": "DELETING", "CreateTime": "2022-02-25T21:18:51.183000+00:00", "DeleteTime": "2022-02-25T22:25:31.331000+00:00" } } ``` Weitere Informationen finden Sie unter [Löschen einer blue/green Bereitstellung](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-deleting.html) im *Amazon RDS-Benutzerhandbuch*. **Beispiel 2: So löschen Sie Ressourcen in einer grünen Umgebung für einen Aurora-MySQL-DB-Cluster** Im folgenden Beispiel für `delete-blue-green-deployment` werden die Ressourcen in einer grünen Umgebung für einen Aurora-MySQL-DB-Cluster gelöscht. ``` aws rds delete-blue-green-deployment \ --blue-green-deployment-identifier bgd-wi89nwzglccsfake \ --delete-target ``` Ausgabe: ``` { "BlueGreenDeployment": { "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake", "BlueGreenDeploymentName": "my-blue-green-deployment", "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg", "Status": "AVAILABLE" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "COMPLETED" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "COMPLETED" }, { "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER", "Status": "COMPLETED" }, { "Name": "CREATE_CUSTOM_ENDPOINTS", "Status": "COMPLETED" } ], "Status": "DELETING", "CreateTime": "2022-02-25T21:12:00.288000+00:00", "DeleteTime": "2022-02-25T22:29:11.336000+00:00" } } ``` Weitere Informationen finden Sie unter [Löschen einer blue/green Bereitstellung](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-deleting.html) im *Amazon Aurora Aurora-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteBlueGreenDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-blue-green-deployment.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-cluster-endpoint` Das folgende Codebeispiel zeigt die Verwendung`delete-db-cluster-endpoint`. **AWS CLI** **So löschen Sie einen benutzerdefinierten DB-Cluster-Endpunkt** Im folgenden Beispiel für `delete-db-cluster-endpoint` wird der angegebene benutzerdefinierte DB-Cluster-Endpunkt gelöscht. ``` aws rds delete-db-cluster-endpoint \ --db-cluster-endpoint-identifier mycustomendpoint ``` Ausgabe: ``` { "DBClusterEndpointIdentifier": "mycustomendpoint", "DBClusterIdentifier": "mydbcluster", "DBClusterEndpointResourceIdentifier": "cluster-endpoint-ANPAJ4AE5446DAEXAMPLE", "Endpoint": "mycustomendpoint.cluster-custom-cnpexample.us-east-1.rds.amazonaws.com", "Status": "deleting", "EndpointType": "CUSTOM", "CustomEndpointType": "READER", "StaticMembers": [ "dbinstance1", "dbinstance2", "dbinstance3" ], "ExcludedMembers": [], "DBClusterEndpointArn": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:mycustomendpoint" } ``` Weitere Informationen finden Sie unter [Verbindungsmanagement in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeleteDbClusterEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`delete-db-cluster-parameter-group`. **AWS CLI** **So löschen Sie eine DB-Cluster-Parametergruppe** Im folgenden Beispiel für `delete-db-cluster-parameter-group` wird die angegebene DB-Cluster-Parametergruppe gelöscht. ``` aws rds delete-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeleteDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-cluster-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-db-cluster-snapshot`. **AWS CLI** **Um einen DB-Cluster-Snapshot zu löschen** Im folgenden Beispiel für `delete-db-cluster-snapshot` wird der angegebene Cluster-Snapshot gelöscht. ``` aws rds delete-db-cluster-snapshot \ --db-cluster-snapshot-identifier mydbclustersnapshot ``` Ausgabe: ``` { "DBClusterSnapshot": { "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1e" ], "DBClusterSnapshotIdentifier": "mydbclustersnapshot", "DBClusterIdentifier": "mydbcluster", "SnapshotCreateTime": "2019-06-18T21:21:00.469Z", "Engine": "aurora-mysql", "AllocatedStorage": 0, "Status": "available", "Port": 0, "VpcId": "vpc-6594f31c", "ClusterCreateTime": "2019-04-15T14:18:42.785Z", "MasterUsername": "myadmin", "EngineVersion": "5.7.mysql_aurora.2.04.2", "LicenseModel": "aurora-mysql", "SnapshotType": "manual", "PercentProgress": 100, "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE", "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:mydbclustersnapshot", "IAMDatabaseAuthenticationEnabled": false } } ``` Weitere Informationen finden Sie unter [Löschen eines Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteSnapshot.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeleteDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster-snapshot.html)unter *AWS CLI Befehlsreferenz*. ### `delete-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`delete-db-cluster`. **AWS CLI** **Beispiel 1: So löschen Sie eine DB-Instance in einem DB-Cluster** Im folgenden Beispiel für `delete-db-instance` wird die letzte DB-Instance in einem DB-Cluster gelöscht. Sie können einen DB-Cluster nicht löschen, wenn er DB-Instances enthält, die sich nicht im **Löschstatus** befinden. Sie können keinen endgültigen Snapshot erstellen, wenn Sie eine DB-Instance in einem DB-Cluster löschen. ``` aws rds delete-db-instance \ --db-instance-identifier database-3 ``` Ausgabe: ``` { "DBInstance": { "DBInstanceIdentifier": "database-3", "DBInstanceClass": "db.r4.large", "Engine": "aurora-postgresql", "DBInstanceStatus": "deleting", ...output omitted... } } ``` Weitere Informationen finden Sie unter [Löschen einer DB-Instance in einem Aurora-DB-Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteInstance.html) im *Benutzerhandbuch für Amazon Aurora*. **Beispiel 2: So löschen Sie einen DB-Cluster** Im folgenden Beispiel für `delete-db-cluster` wird der DB-Cluster namens `mycluster` gelöscht, und es wird ein letzter Snapshot mit dem Namen `mycluster-final-snapshot` erstellt. Der Status des DB-Clusters ist **verfügbar**, während der Snapshot erstellt wird. Verwenden Sie den `describe-db-clusters`-CLI-Befehl, um den Fortschritt des Löschvorgangs zu verfolgen. ``` aws rds delete-db-cluster \ --db-cluster-identifier mycluster \ --no-skip-final-snapshot \ --final-db-snapshot-identifier mycluster-final-snapshot ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 20, "AvailabilityZones": [ "eu-central-1b", "eu-central-1c", "eu-central-1a" ], "BackupRetentionPeriod": 7, "DBClusterIdentifier": "mycluster", "DBClusterParameterGroup": "default.aurora-postgresql10", "DBSubnetGroup": "default-vpc-aa11bb22", "Status": "available", ...output omitted... } } ``` Weitere Informationen finden Sie unter [Aurora-Cluster mit einer einzelnen DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteInstance.html#USER_DeleteInstance.LastInstance) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeleteDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-instance-automated-backup` Das folgende Codebeispiel zeigt die Verwendung`delete-db-instance-automated-backup`. **AWS CLI** **So löschen Sie ein repliziertes automatisiertes Backup aus einer Region** Im folgenden Beispiel für `delete-db-instance-automated-backup` wird der automatisierte Backup mit dem angegebenen Amazon-Ressourcennamen (ARN) gelöscht. ``` aws rds delete-db-instance-automated-backup \ --db-instance-automated-backups-arn "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example" ``` Ausgabe: ``` { "DBInstanceAutomatedBackup": { "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db", "DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE", "Region": "us-east-1", "DBInstanceIdentifier": "new-orcl-db", "RestoreWindow": {}, "AllocatedStorage": 20, "Status": "deleting", "Port": 1521, "AvailabilityZone": "us-east-1b", "VpcId": "vpc-########", "InstanceCreateTime": "2020-12-04T15:28:31Z", "MasterUsername": "admin", "Engine": "oracle-se2", "EngineVersion": "12.1.0.2.v21", "LicenseModel": "bring-your-own-license", "OptionGroupName": "default:oracle-se2-12-1", "Encrypted": false, "StorageType": "gp2", "IAMDatabaseAuthenticationEnabled": false, "BackupRetentionPeriod": 7, "DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example" } } ``` Weitere Informationen finden Sie unter [Löschen von replizierten Backups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Delete) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [DeleteDbInstanceAutomatedBackup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-instance-automated-backup.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-instance` Das folgende Codebeispiel zeigt die Verwendung`delete-db-instance`. **AWS CLI** **Um eine DB-Instance zu löschen** Im folgenden Beispiel für `delete-db-instance` wird die angegebene DB-Instance gelöscht, nachdem der letzte DB-Snapshot `test-instance-final-snap` erstellt wurde. ``` aws rds delete-db-instance \ --db-instance-identifier test-instance \ --final-db-snapshot-identifier test-instance-final-snap ``` Ausgabe: ``` { "DBInstance": { "DBInstanceIdentifier": "test-instance", "DBInstanceStatus": "deleting", ...some output truncated... } } ``` + Einzelheiten zur API finden Sie unter [Löschen DBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-instance.html) in der *AWS CLI Befehlsreferenz*. ### `delete-db-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`delete-db-parameter-group`. **AWS CLI** **So löschen Sie eine DB-Parametergruppe** Im folgenden Beispiel für `command` wird eine DB-Parametergruppe gelöscht. ``` aws rds delete-db-parameter-group \ --db-parameter-group-name mydbparametergroup ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon RDS*. + API-Einzelheiten finden Sie unter [DBParameterGruppe löschen](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-parameter-group.html) in der *AWS CLI Befehlsreferenz*. ### `delete-db-proxy-endpoint` Das folgende Codebeispiel zeigt die Verwendung`delete-db-proxy-endpoint`. **AWS CLI** **So löschen Sie einen DB-Proxy-Endpunkt für eine RDS-Datenbank** Im folgenden Beispiel für `delete-db-proxy-endpoint` wird ein DB-Proxy-Endpunkt für die Zieldatenbank gelöscht. ``` aws rds delete-db-proxy-endpoint \ --db-proxy-endpoint-name proxyEP1 ``` Ausgabe: ``` { "DBProxyEndpoint": { "DBProxyEndpointName": "proxyEP1", "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab", "DBProxyName": "proxyExample", "Status": "deleting", "VpcId": "vpc-1234567", "VpcSecurityGroupIds": [ "sg-1234", "sg-5678" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Endpoint": "proxyEP1.endpoint.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com", "CreatedDate": "2023-04-13T01:49:38.568000+00:00", "TargetRole": "READ_ONLY", "IsDefault": false } } ``` Weitere Informationen finden Sie unter [Löschen eines Proxy-Endpunkts](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DeletingEndpoint) im *Benutzerhandbuch für Amazon RDS* und [Löschen eines Proxy-Endpunkts](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DeletingEndpoint) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeleteDbProxyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-proxy-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-proxy` Das folgende Codebeispiel zeigt die Verwendung`delete-db-proxy`. **AWS CLI** **So löschen Sie einen DB-Proxy für eine RDS-Datenbank** Im folgenden Beispiel für `delete-db-proxy` wird ein DB-Proxy gelöscht. ``` aws rds delete-db-proxy \ --db-proxy-name proxyExample ``` Ausgabe: ``` { "DBProxy": { "DBProxyName": "proxyExample", "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab", "Status": "deleting", "EngineFamily": "PostgreSQL", "VpcId": "vpc-1234567", "VpcSecurityGroupIds": [ "sg-1234", "sg-5678" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Auth": "[ { "Description": "proxydescription`" "AuthScheme": "SECRETS", "SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:proxysecret1-Abcd1e", "IAMAuth": "DISABLED" } ], "RoleArn": "arn:aws:iam::12345678912:role/ProxyPostgreSQLRole", "Endpoint": "proxyExample.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com", "RequireTLS": false, "IdleClientTimeout": 1800, "DebuggingLogging": false, "CreatedDate": "2023-04-05T16:09:33.452000+00:00", "UpdatedDate": "2023-04-13T01:49:38.568000+00:00" } } ``` Weitere Informationen finden Sie unter [Löschen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-deleting) im *Benutzerhandbuch für Amazon RDS* und [Löschen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-deleting) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeleteDbProxy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-proxy.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-security-group` Das folgende Codebeispiel zeigt die Verwendung`delete-db-security-group`. **AWS CLI** **So löschen Sie eine DB-Sicherheitsgruppe** Im folgenden Beispiel für `delete-db-security-group` wird DB-Sicherheitsgruppe namens `mysecuritygroup` gelöscht. ``` aws rds delete-db-security-group \ --db-security-group-name mysecuritygroup ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit DB-Sicherheitsgruppen (EC2-Classic-Plattform)](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithSecurityGroups.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [DeleteDbSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-security-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-shard-group` Das folgende Codebeispiel zeigt die Verwendung`delete-db-shard-group`. **AWS CLI** **Beispiel 1: So löschen Sie eine DB-Shard-Gruppe erfolglos** Das folgende `delete-db-shard-group`-Beispiel zeigt den Fehler, der auftritt, wenn Sie versuchen, eine DB-Shard-Gruppe zu löschen, bevor Sie alle Ihre Datenbanken und Schemas löschen. ``` aws rds delete-db-shard-group \ --db-shard-group-identifier limitless-test-shard-grp ``` Ausgabe: ``` An error occurred (InvalidDBShardGroupState) when calling the DeleteDBShardGroup operation: Unable to delete the DB shard group limitless-test-db-shard-group. Delete all of your Limitless Database databases and schemas, then try again. ``` **Beispiel 2: So löschen Sie eine DB-Shard-Gruppe erfolgreich** Im folgenden Beispiel für `delete-db-shard-group` wird eine DB-Shard-Gruppe gelöscht, nachdem Sie alle Ihre Datenbanken und Schemas, einschließlich des `public`-Schemas, zuvor gelöscht haben. ``` aws rds delete-db-shard-group \ --db-shard-group-identifier limitless-test-shard-grp ``` Ausgabe: ``` { "DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example", "DBShardGroupIdentifier": "limitless-test-shard-grp", "DBClusterIdentifier": "limitless-test-cluster", "MaxACU": 768.0, "ComputeRedundancy": 0, "Status": "deleting", "PubliclyAccessible": true, "Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" } ``` Weitere Informationen finden Sie unter [Löschen von Aurora-DB-Clustern und -DB-Instances](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteCluster.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeleteDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-shard-group.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-db-snapshot`. **AWS CLI** **Um einen DB-Snapshot zu löschen** Im folgenden Beispiel für `delete-db-snapshot` wird der angegebene DB-Snapshot gelöscht. ``` aws rds delete-db-snapshot \ --db-snapshot-identifier mydbsnapshot ``` Ausgabe: ``` { "DBSnapshot": { "DBSnapshotIdentifier": "mydbsnapshot", "DBInstanceIdentifier": "database-mysql", "SnapshotCreateTime": "2019-06-18T22:08:40.702Z", "Engine": "mysql", "AllocatedStorage": 100, "Status": "deleted", "Port": 3306, "AvailabilityZone": "us-east-1b", "VpcId": "vpc-6594f31c", "InstanceCreateTime": "2019-04-30T15:45:53.663Z", "MasterUsername": "admin", "EngineVersion": "5.6.40", "LicenseModel": "general-public-license", "SnapshotType": "manual", "Iops": 1000, "OptionGroupName": "default:mysql-5-6", "PercentProgress": 100, "StorageType": "io1", "Encrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE", "DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot", "IAMDatabaseAuthenticationEnabled": false, "ProcessorFeatures": [], "DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE" } } ``` Weitere Informationen finden Sie unter [Löschen eines Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteSnapshot.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [DeleteDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `delete-db-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`delete-db-subnet-group`. **AWS CLI** **Um eine DB-Subnetzgruppe zu löschen** Im folgenden Beispiel für `delete-db-subnet-group` wird eine DB-Subnetzgruppe namens `mysubnetgroup` gelöscht. ``` aws rds delete-db-subnet-group --db-subnet-group-name mysubnetgroup ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Arbeiten mit einer DB-Instance in einer VPC](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [DeleteDbSubnetGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-subnet-group.html)*Befehlsreferenz.* ### `delete-event-subscription` Das folgende Codebeispiel zeigt die Verwendung`delete-event-subscription`. **AWS CLI** **So löschen Sie ein Ereignisabonnement** Im folgenden Beispiel für `delete-event-subscription` wird das angegebene Ereignisabonnement gelöscht. ``` aws rds delete-event-subscription --subscription-name my-instance-events ``` Ausgabe: ``` { "EventSubscription": { "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", "CustomerAwsId": "123456789012", "Enabled": false, "SourceIdsList": [ "test-instance" ], "SourceType": "db-instance", "EventCategoriesList": [ "backup", "recovery" ], "SubscriptionCreationTime": "2018-07-31 23:22:01.893", "CustSubscriptionId": "my-instance-events", "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", "Status": "deleting" } } ``` + Einzelheiten zur API finden Sie [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-event-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `delete-global-cluster` Das folgende Codebeispiel zeigt die Verwendung`delete-global-cluster`. **AWS CLI** **So löschen Sie einen globalen DB-Cluster** Im folgenden Beispiel für `delete-global-cluster` wird ein Aurora-MySQL-kompatibler globaler DB-Cluster gelöscht. Die Ausgabe zeigt den Cluster, den Sie löschen, aber nachfolgende `describe-global-clusters`-Befehle führen diesen DB-Cluster nicht auf. ``` aws rds delete-global-cluster \ --global-cluster-identifier myglobalcluster ``` Ausgabe: ``` { "GlobalCluster": { "GlobalClusterIdentifier": "myglobalcluster", "GlobalClusterResourceId": "cluster-f0e523bfe07aabb", "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster", "Status": "available", "Engine": "aurora-mysql", "EngineVersion": "5.7.mysql_aurora.2.07.2", "StorageEncrypted": false, "DeletionProtection": false, "GlobalClusterMembers": [] } } ``` Weitere Informationen finden Sie unter [Löschen einer globalen Aurora-Datenbank](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html#aurora-global-database-deleting) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeleteGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-global-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `delete-option-group` Das folgende Codebeispiel zeigt die Verwendung`delete-option-group`. **AWS CLI** **So löschen Sie eine Optionsgruppe** Im folgenden Beispiel für `delete-option-group` wird die angegebene Optionsgruppe gelöscht. ``` aws rds delete-option-group \ --option-group-name myoptiongroup ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Optionsgruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.Delete) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [DeleteOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-option-group.html)in der *AWS CLI Befehlsreferenz*. ### `deregister-db-proxy-targets` Das folgende Codebeispiel zeigt die Verwendung`deregister-db-proxy-targets`. **AWS CLI** **So heben Sie die Registrierung eines DB-Proxy-Ziels von der Datenbank-Zielgruppe auf** Im folgenden Beispiel für `deregister-db-proxy-targets` wird die Zuordnung zwischen dem Proxy `proxyExample` und seinem Ziel entfernt. ``` aws rds deregister-db-proxy-targets \ --db-proxy-name proxyExample \ --db-instance-identifiers database-1 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-deleting) im *Benutzerhandbuch für Amazon RDS* und [Löschen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-deleting) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeregisterDbProxyTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/deregister-db-proxy-targets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-account-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-account-attributes`. **AWS CLI** **So beschreiben Sie Kontoattribute** Im folgenden `describe-account-attributes` Beispiel werden die Attribute für das aktuelle AWS Konto abgerufen. ``` aws rds describe-account-attributes ``` Ausgabe: ``` { "AccountQuotas": [ { "Max": 40, "Used": 4, "AccountQuotaName": "DBInstances" }, { "Max": 40, "Used": 0, "AccountQuotaName": "ReservedDBInstances" }, { "Max": 100000, "Used": 40, "AccountQuotaName": "AllocatedStorage" }, { "Max": 25, "Used": 0, "AccountQuotaName": "DBSecurityGroups" }, { "Max": 20, "Used": 0, "AccountQuotaName": "AuthorizationsPerDBSecurityGroup" }, { "Max": 50, "Used": 1, "AccountQuotaName": "DBParameterGroups" }, { "Max": 100, "Used": 3, "AccountQuotaName": "ManualSnapshots" }, { "Max": 20, "Used": 0, "AccountQuotaName": "EventSubscriptions" }, { "Max": 50, "Used": 1, "AccountQuotaName": "DBSubnetGroups" }, { "Max": 20, "Used": 1, "AccountQuotaName": "OptionGroups" }, { "Max": 20, "Used": 6, "AccountQuotaName": "SubnetsPerDBSubnetGroup" }, { "Max": 5, "Used": 0, "AccountQuotaName": "ReadReplicasPerMaster" }, { "Max": 40, "Used": 1, "AccountQuotaName": "DBClusters" }, { "Max": 50, "Used": 0, "AccountQuotaName": "DBClusterParameterGroups" }, { "Max": 5, "Used": 0, "AccountQuotaName": "DBClusterRoles" } ] } ``` + Einzelheiten zur API finden Sie unter [DescribeAccountAttributes AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-account-attributes.html)*Befehlsreferenz.* ### `describe-blue-green-deployments` Das folgende Codebeispiel zeigt die Verwendung`describe-blue-green-deployments`. **AWS CLI** **Beispiel 1: Um die blue/green Bereitstellung einer RDS-DB-Instance nach Abschluss der Erstellung zu beschreiben** Im folgenden `describe-blue-green-deployment` Beispiel werden die Details einer blue/green Bereitstellung nach Abschluss der Erstellung abgerufen. ``` aws rds describe-blue-green-deployments \ --blue-green-deployment-identifier bgd-v53303651eexfake ``` Ausgabe: ``` { "BlueGreenDeployments": [ { "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake", "BlueGreenDeploymentName": "bgd-cli-test-instance", "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance", "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-j382ha", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ejv4ao", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-vlpz3t", "Status": "AVAILABLE" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "COMPLETED" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "COMPLETED" }, { "Name": "CONFIGURE_BACKUPS", "Status": "COMPLETED" }, { "Name": "CREATING_TOPOLOGY_OF_SOURCE", "Status": "COMPLETED" } ], "Status": "AVAILABLE", "CreateTime": "2022-02-25T21:18:51.183000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Eine blue/green Bereitstellung anzeigen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-viewing.html) im *Amazon RDS-Benutzerhandbuch*. **Beispiel 2: Um eine blue/green Bereitstellung für einen Aurora MySQL-DB-Cluster zu beschreiben** Im folgenden `describe-blue-green-deployment` Beispiel werden die Details einer blue/green Bereitstellung abgerufen. ``` aws rds describe-blue-green-deployments \ --blue-green-deployment-identifier bgd-wi89nwzglccsfake ``` Ausgabe: ``` { "BlueGreenDeployments": [ { "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake", "BlueGreenDeploymentName": "my-blue-green-deployment", "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg", "Status": "AVAILABLE" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "COMPLETED" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "COMPLETED" }, { "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER", "Status": "COMPLETED" }, { "Name": "CREATE_CUSTOM_ENDPOINTS", "Status": "COMPLETED" } ], "Status": "AVAILABLE", "CreateTime": "2022-02-25T21:12:00.288000+00:00" } ] } ``` Weitere Informationen finden Sie unter [ blue/green Bereitstellung anzeigen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-viewing.html) im *Amazon Aurora Aurora-Benutzerhandbuch*. **Beispiel 3: Um eine blue/green Bereitstellung für einen Aurora MySQL-Cluster nach dem Switchover zu beschreiben** Im folgenden `describe-blue-green-deployment` Beispiel werden die Details zu einer blue/green Bereitstellung abgerufen, nachdem die grüne Umgebung zur Produktionsumgebung heraufgestuft wurde. ``` aws rds describe-blue-green-deployments \ --blue-green-deployment-identifier bgd-wi89nwzglccsfake ``` Ausgabe: ``` { "BlueGreenDeployments": [ { "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake", "BlueGreenDeploymentName": "my-blue-green-deployment", "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-old1", "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "Status": "SWITCHOVER_COMPLETED" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1", "Status": "SWITCHOVER_COMPLETED" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2", "Status": "SWITCHOVER_COMPLETED" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3", "Status": "SWITCHOVER_COMPLETED" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint", "Status": "SWITCHOVER_COMPLETED" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint", "Status": "SWITCHOVER_COMPLETED" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "COMPLETED" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "COMPLETED" }, { "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER", "Status": "COMPLETED" }, { "Name": "CREATE_CUSTOM_ENDPOINTS", "Status": "COMPLETED" } ], "Status": "SWITCHOVER_COMPLETED", "CreateTime": "2022-02-25T22:38:49.522000+00:00" } ] } ``` Weitere Informationen finden Sie unter [ blue/green Bereitstellung anzeigen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-viewing.html) im *Amazon Aurora Aurora-Benutzerhandbuch*. **Beispiel 4: Um eine kombinierte blue/green Bereitstellung zu beschreiben** Im folgenden `describe-blue-green-deployment` Beispiel werden die Details einer kombinierten blue/green Bereitstellung abgerufen. ``` aws rds describe-blue-green-deployments ``` Ausgabe: ``` { "BlueGreenDeployments": [ { "BlueGreenDeploymentIdentifier": "bgd-wi89nwzgfakelccs", "BlueGreenDeploymentName": "my-blue-green-deployment", "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg", "Status": "AVAILABLE" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "COMPLETED" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "COMPLETED" }, { "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER", "Status": "COMPLETED" }, { "Name": "CREATE_CUSTOM_ENDPOINTS", "Status": "COMPLETED" } ], "Status": "AVAILABLE", "CreateTime": "2022-02-25T21:12:00.288000+00:00" }, { "BlueGreenDeploymentIdentifier": "bgd-v5330365fake1eex", "BlueGreenDeploymentName": "bgd-cli-test-instance", "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-old1", "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance", "Status": "SWITCHOVER_COMPLETED" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1", "Status": "SWITCHOVER_COMPLETED" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2", "Status": "SWITCHOVER_COMPLETED" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-old1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3", "Status": "SWITCHOVER_COMPLETED" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "COMPLETED" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "COMPLETED" }, { "Name": "CONFIGURE_BACKUPS", "Status": "COMPLETED" }, { "Name": "CREATING_TOPOLOGY_OF_SOURCE", "Status": "COMPLETED" } ], "Status": "SWITCHOVER_COMPLETED", "CreateTime": "2022-02-25T22:33:22.225000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen einer blue/green Bereitstellung](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-viewing.html) im *Amazon RDS-Benutzerhandbuch* und [Anzeigen einer blue/green Bereitstellung](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-viewing.html) im *Amazon Aurora Aurora-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeBlueGreenDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-blue-green-deployments.html)in der *AWS CLI Befehlsreferenz*. ### `describe-certificates` Das folgende Codebeispiel zeigt die Verwendung`describe-certificates`. **AWS CLI** **So beschreiben Sie Zertifikate** Im folgenden Beispiel für `describe-certificates` werden die Details des Zertifikats abgerufen, das der Standardregion des Benutzers zugeordnet ist. ``` aws rds describe-certificates ``` Ausgabe: ``` { "Certificates": [ { "CertificateIdentifier": "rds-ca-ecc384-g1", "CertificateType": "CA", "Thumbprint": "2ee3dcc06e50192559b13929e73484354f23387d", "ValidFrom": "2021-05-24T22:06:59+00:00", "ValidTill": "2121-05-24T23:06:59+00:00", "CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-ecc384-g1", "CustomerOverride": false }, { "CertificateIdentifier": "rds-ca-rsa4096-g1", "CertificateType": "CA", "Thumbprint": "19da4f2af579a8ae1f6a0fa77aa5befd874b4cab", "ValidFrom": "2021-05-24T22:03:20+00:00", "ValidTill": "2121-05-24T23:03:20+00:00", "CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-rsa4096-g1", "CustomerOverride": false }, { "CertificateIdentifier": "rds-ca-rsa2048-g1", "CertificateType": "CA", "Thumbprint": "7c40cb42714b6fdb2b296f9bbd0e8bb364436a76", "ValidFrom": "2021-05-24T21:59:00+00:00", "ValidTill": "2061-05-24T22:59:00+00:00", "CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-rsa2048-g1", "CustomerOverride": true, "CustomerOverrideValidTill": "2061-05-24T22:59:00+00:00" }, { "CertificateIdentifier": "rds-ca-2019", "CertificateType": "CA", "Thumbprint": "d40ddb29e3750dffa671c3140bbf5f478d1c8096", "ValidFrom": "2019-08-22T17:08:50+00:00", "ValidTill": "2024-08-22T17:08:50+00:00", "CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-2019", "CustomerOverride": false } ], "DefaultCertificateForNewLaunches": "rds-ca-rsa2048-g1" } ``` Weitere Informationen finden Sie unter [Verwenden SSL/TLS zur Verschlüsselung einer Verbindung zu einer DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html) im *Amazon RDS-Benutzerhandbuch* und [Verwenden SSL/TLS zur Verschlüsselung einer Verbindung zu einem DB-Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html) im *Amazon Aurora Aurora-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-cluster-backtracks` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-backtracks`. **AWS CLI** **So beschreiben Sie Backtracks für einen DB-Cluster** Im folgenden Beispiel für `describe-db-cluster-backtracks` werden Details zum angegebenen DB-Cluster abgerufen. ``` aws rds describe-db-cluster-backtracks \ --db-cluster-identifier mydbcluster ``` Ausgabe: ``` { "DBClusterBacktracks": [ { "DBClusterIdentifier": "mydbcluster", "BacktrackIdentifier": "2f5f5294-0dd2-44c9-9f50-EXAMPLE", "BacktrackTo": "2021-02-12T04:59:22Z", "BacktrackedFrom": "2021-02-12T14:37:31.640Z", "BacktrackRequestCreationTime": "2021-02-12T14:36:18.819Z", "Status": "COMPLETED" }, { "DBClusterIdentifier": "mydbcluster", "BacktrackIdentifier": "3c7a6421-af2a-4ea3-ae95-EXAMPLE", "BacktrackTo": "2021-02-11T22:53:46Z", "BacktrackedFrom": "2021-02-12T00:09:27.006Z", "BacktrackRequestCreationTime": "2021-02-12T00:07:53.487Z", "Status": "COMPLETED" } ] } ``` Weitere Informationen finden Sie unter [Rückverfolgen eines Aurora-DB-Clusters](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Managing.Backtrack.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbClusterBacktracks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-backtracks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-cluster-endpoints` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-endpoints`. **AWS CLI** **Beispiel 1: So beschreiben Sie DB-Cluster-Endpunkte** Im folgenden Beispiel für `describe-db-cluster-endpoints` werden Details für Ihre DB-Cluster-Endpunkte abgerufen. Die gängigsten Arten von Aurora-Clustern haben zwei Endpunkte. Ein Endpunkt hat den Typ `WRITER`. Sie können diesen Endpunkt für alle SQL-Anweisungen verwenden. Der andere Endpunkt hat den Typ `READER`. Sie können diesen Endpunkt nur für SELECT- und andere schreibgeschützte SQL-Anweisungen verwenden. ``` aws rds describe-db-cluster-endpoints ``` Ausgabe: ``` { "DBClusterEndpoints": [ { "DBClusterIdentifier": "my-database-1", "Endpoint": "my-database-1.cluster-cnpexample.us-east-1.rds.amazonaws.com", "Status": "creating", "EndpointType": "WRITER" }, { "DBClusterIdentifier": "my-database-1", "Endpoint": "my-database-1.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", "Status": "creating", "EndpointType": "READER" }, { "DBClusterIdentifier": "mydbcluster", "Endpoint": "mydbcluster.cluster-cnpexamle.us-east-1.rds.amazonaws.com", "Status": "available", "EndpointType": "WRITER" }, { "DBClusterIdentifier": "mydbcluster", "Endpoint": "mydbcluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", "Status": "available", "EndpointType": "READER" } ] } ``` **Beispiel 2: So beschreiben Sie die DB-Cluster-Endpunkte eines einzelnen DB-Clusters** Im folgenden Beispiel für `describe-db-cluster-endpoints` werden Details für die DB-Cluster-Endpunkte eines einzelnen angegebenen DB-Clusters abgerufen. Aurora-Serverless-Cluster haben nur einen einzigen Endpunkt des Typs `WRITER`. ``` aws rds describe-db-cluster-endpoints \ --db-cluster-identifier serverless-cluster ``` Ausgabe: ``` { "DBClusterEndpoints": [ { "Status": "available", "Endpoint": "serverless-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com", "DBClusterIdentifier": "serverless-cluster", "EndpointType": "WRITER" } ] } ``` Weitere Informationen finden Sie unter [Verbindungsmanagement in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbClusterEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-endpoints.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-cluster-parameter-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-parameter-groups`. **AWS CLI** **So beschreiben Sie DB-Cluster-Parametergruppen** Im folgenden Beispiel für `describe-db-cluster-parameter-groups` werden die Details für Ihre DB-Cluster-Parametergruppen abgerufen. ``` aws rds describe-db-cluster-parameter-groups ``` Ausgabe: ``` { "DBClusterParameterGroups": [ { "DBClusterParameterGroupName": "default.aurora-mysql5.7", "DBParameterGroupFamily": "aurora-mysql5.7", "Description": "Default cluster parameter group for aurora-mysql5.7", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora-mysql5.7" }, { "DBClusterParameterGroupName": "default.aurora-postgresql9.6", "DBParameterGroupFamily": "aurora-postgresql9.6", "Description": "Default cluster parameter group for aurora-postgresql9.6", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora-postgresql9.6" }, { "DBClusterParameterGroupName": "default.aurora5.6", "DBParameterGroupFamily": "aurora5.6", "Description": "Default cluster parameter group for aurora5.6", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6" }, { "DBClusterParameterGroupName": "mydbclusterpg", "DBParameterGroupFamily": "aurora-mysql5.7", "Description": "My DB cluster parameter group", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpg" }, { "DBClusterParameterGroupName": "mydbclusterpgcopy", "DBParameterGroupFamily": "aurora-mysql5.7", "Description": "Copy of mydbclusterpg parameter group", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpgcopy" } ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-parameter-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-cluster-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-parameters`. **AWS CLI** **Beispiel 1: So können Sie die Parameter in einer DB-Cluster-Parametergruppe beschreiben** Im folgenden Beispiel für `describe-db-cluster-parameters` werden Details zu den Parametern in einer DB-Cluster-Parametergruppe abgerufen. ``` aws rds describe-db-cluster-parameters \ --db-cluster-parameter-group-name mydbclusterpg ``` Ausgabe: ``` { "Parameters": [ { "ParameterName": "allow-suspicious-udfs", "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded", "Source": "engine-default", "ApplyType": "static", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": false, "ApplyMethod": "pending-reboot", "SupportedEngineModes": [ "provisioned" ] }, { "ParameterName": "aurora_lab_mode", "ParameterValue": "0", "Description": "Enables new features in the Aurora engine.", "Source": "engine-default", "ApplyType": "static", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": true, "ApplyMethod": "pending-reboot", "SupportedEngineModes": [ "provisioned" ] }, ...some output truncated... ] } ``` **Beispiel 2: So listen Sie nur die Parameternamen in einer DB-Cluster-Parametergruppe auf** Im folgenden Beispiel für `describe-db-cluster-parameters` werden nur die Namen der Parameter in einer DB-Clusterparametergruppe abgerufen. ``` aws rds describe-db-cluster-parameters \ --db-cluster-parameter-group-name default.aurora-mysql5.7 \ --query 'Parameters[].{ParameterName:ParameterName}' ``` Ausgabe: ``` [ { "ParameterName": "allow-suspicious-udfs" }, { "ParameterName": "aurora_binlog_read_buffer_size" }, { "ParameterName": "aurora_binlog_replication_max_yield_seconds" }, { "ParameterName": "aurora_binlog_use_large_read_buffer" }, { "ParameterName": "aurora_lab_mode" }, ...some output truncated... } ] ``` **Beispiel 3: So beschreiben Sie nur die änderbaren Parameter in einer DB-Cluster-Parametergruppe** Im folgenden Beispiel für `describe-db-cluster-parameters` werden nur die Namen der Parameter in einer DB-Cluster-Parametergruppe abgerufen, die geändert werden können. ``` aws rds describe-db-cluster-parameters \ --db-cluster-parameter-group-name default.aurora-mysql5.7 \ --query 'Parameters[].{ParameterName:ParameterName,IsModifiable:IsModifiable} | [?IsModifiable == `true`]' ``` Ausgabe: ``` [ { "ParameterName": "aurora_binlog_read_buffer_size", "IsModifiable": true }, { "ParameterName": "aurora_binlog_replication_max_yield_seconds", "IsModifiable": true }, { "ParameterName": "aurora_binlog_use_large_read_buffer", "IsModifiable": true }, { "ParameterName": "aurora_lab_mode", "IsModifiable": true }, ...some output truncated... } ] ``` **Beispiel 4: Um nur die modifizierbaren booleschen Parameter in einer DB-Cluster-Parametergruppe zu beschreiben** Im folgenden Beispiel für `describe-db-cluster-parameters` werden nur die Namen der Parameter in einer DB-Cluster-Parametergruppe abgerufen, die geändert werden können und einen booleschen Datentyp haben. ``` aws rds describe-db-cluster-parameters \ --db-cluster-parameter-group-name default.aurora-mysql5.7 \ --query 'Parameters[].{ParameterName:ParameterName,DataType:DataType,IsModifiable:IsModifiable} | [?DataType == `boolean`] | [?IsModifiable == `true`]' ``` Ausgabe: ``` [ { "DataType": "boolean", "ParameterName": "aurora_binlog_use_large_read_buffer", "IsModifiable": true }, { "DataType": "boolean", "ParameterName": "aurora_lab_mode", "IsModifiable": true }, { "DataType": "boolean", "ParameterName": "autocommit", "IsModifiable": true }, { "DataType": "boolean", "ParameterName": "automatic_sp_privileges", "IsModifiable": true }, ...some output truncated... } ] ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon Aurora*. + *Einzelheiten zur API finden Sie unter Befehlsreferenz [DescribeDbClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-parameters.html).AWS CLI * ### `describe-db-cluster-snapshot-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-snapshot-attributes`. **AWS CLI** **So beschreiben Sie die Attributnamen und -werte für einen DB-Cluster-Snapshot** Im folgenden Beispiel für `describe-db-cluster-snapshot-attributes` werden Details zu den Attributnamen und Werten für den angegebenen DB-Cluster-Snapshot abgerufen. ``` aws rds describe-db-cluster-snapshot-attributes \ --db-cluster-snapshot-identifier myclustersnapshot ``` Ausgabe: ``` { "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotIdentifier": "myclustersnapshot", "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123456789012" ] } ] } } ``` Weitere Informationen finden Sie unter [Freigeben eines DB-Cluster-Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_ShareSnapshot.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbClusterSnapshotAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-snapshot-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-cluster-snapshots` Das folgende Codebeispiel zeigt die Verwendung`describe-db-cluster-snapshots`. **AWS CLI** **So beschreiben Sie einen DB-Cluster-Snapshot für einen DB-Cluster** Im folgenden Beispiel für `describe-db-cluster-snapshots` werden die Details für die DB-Cluster-Snapshots für den angegebenen DB-Cluster abgerufen. ``` aws rds describe-db-cluster-snapshots \ --db-cluster-identifier mydbcluster ``` Ausgabe: ``` { "DBClusterSnapshots": [ { "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1e" ], "DBClusterSnapshotIdentifier": "myclustersnapshotcopy", "DBClusterIdentifier": "mydbcluster", "SnapshotCreateTime": "2019-06-04T09:16:42.649Z", "Engine": "aurora-mysql", "AllocatedStorage": 0, "Status": "available", "Port": 0, "VpcId": "vpc-6594f31c", "ClusterCreateTime": "2019-04-15T14:18:42.785Z", "MasterUsername": "myadmin", "EngineVersion": "5.7.mysql_aurora.2.04.2", "LicenseModel": "aurora-mysql", "SnapshotType": "manual", "PercentProgress": 100, "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE", "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:814387698303:cluster-snapshot:myclustersnapshotcopy", "IAMDatabaseAuthenticationEnabled": false }, { "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1e" ], "DBClusterSnapshotIdentifier": "rds:mydbcluster-2019-06-20-09-16", "DBClusterIdentifier": "mydbcluster", "SnapshotCreateTime": "2019-06-20T09:16:26.569Z", "Engine": "aurora-mysql", "AllocatedStorage": 0, "Status": "available", "Port": 0, "VpcId": "vpc-6594f31c", "ClusterCreateTime": "2019-04-15T14:18:42.785Z", "MasterUsername": "myadmin", "EngineVersion": "5.7.mysql_aurora.2.04.2", "LicenseModel": "aurora-mysql", "SnapshotType": "automated", "PercentProgress": 100, "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:814387698303:key/AKIAIOSFODNN7EXAMPLE", "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:mydbcluster-2019-06-20-09-16", "IAMDatabaseAuthenticationEnabled": false } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines DB-Cluster-Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CreateSnapshotCluster.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-snapshots.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-clusters` Das folgende Codebeispiel zeigt die Verwendung`describe-db-clusters`. **AWS CLI** **Beispiel 1: So beschreiben Sie einen DB-Cluster** Im folgenden Beispiel für `describe-db-clusters` werden Details zum angegebenen DB-Cluster abgerufen. ``` aws rds describe-db-clusters \ --db-cluster-identifier mydbcluster ``` Ausgabe: ``` { "DBClusters": [ { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1e" ], "BackupRetentionPeriod": 1, "DatabaseName": "mydbcluster", "DBClusterIdentifier": "mydbcluster", "DBClusterParameterGroup": "default.aurora-mysql5.7", "DBSubnetGroup": "default", "Status": "available", "EarliestRestorableTime": "2019-06-19T09:16:28.210Z", "Endpoint": "mydbcluster.cluster-cnpexample.us-east-1.rds.amazonaws.com", "ReaderEndpoint": "mydbcluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", "MultiAZ": true, "Engine": "aurora-mysql", "EngineVersion": "5.7.mysql_aurora.2.04.2", "LatestRestorableTime": "2019-06-20T22:38:14.908Z", "Port": 3306, "MasterUsername": "myadmin", "PreferredBackupWindow": "09:09-09:39", "PreferredMaintenanceWindow": "sat:04:09-sat:04:39", "ReadReplicaIdentifiers": [], "DBClusterMembers": [ { "DBInstanceIdentifier": "dbinstance3", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "dbinstance1", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "dbinstance2", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "mydbcluster", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "mydbcluster-us-east-1b", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "mydbcluster", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-0b9130572daf3dc16", "Status": "active" } ], "HostedZoneId": "Z2R2ITUGPM61AM", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:814387698303:key/AKIAIOSFODNN7EXAMPLE", "DbClusterResourceId": "cluster-AKIAIOSFODNN7EXAMPLE", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:mydbcluster", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2019-04-15T14:18:42.785Z", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false } ] } ``` **Beispiel 2: So listen Sie bestimmte Attribute aller DB-Cluster auf** Im folgenden `describe-db-clusters` Beispiel werden nur die `DBClusterIdentifier` `Endpoint` ,- und `ReaderEndpoint` Attribute all Ihrer DB-Cluster in der aktuellen AWS Region abgerufen. ``` aws rds describe-db-clusters \ --query 'DBClusters[].{DBClusterIdentifier:DBClusterIdentifier,Endpoint:Endpoint,ReaderEndpoint:ReaderEndpoint}' ``` Ausgabe: ``` [ { "Endpoint": "cluster-57-2020-05-01-2270.cluster-cnpexample.us-east-1.rds.amazonaws.com", "ReaderEndpoint": "cluster-57-2020-05-01-2270.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", "DBClusterIdentifier": "cluster-57-2020-05-01-2270" }, { "Endpoint": "cluster-57-2020-05-01-4615.cluster-cnpexample.us-east-1.rds.amazonaws.com", "ReaderEndpoint": "cluster-57-2020-05-01-4615.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", "DBClusterIdentifier": "cluster-57-2020-05-01-4615" }, { "Endpoint": "pg2-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com", "ReaderEndpoint": "pg2-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", "DBClusterIdentifier": "pg2-cluster" }, ...output omitted... } ] ``` **Beispiel 3: So listen Sie DB-Cluster mit einem bestimmten Attribut auf** Im folgenden Beispiel für `describe-db-clusters` werden nur die `DBClusterIdentifier`- und `Engine`-Attribute Ihrer DB-Cluster abgerufen, die die `aurora-postgresql`-Engine verwenden. ``` aws rds describe-db-clusters \ --query 'DBClusters[].{DBClusterIdentifier:DBClusterIdentifier,Engine:Engine} | [?Engine == `aurora-postgresql`]' ``` Ausgabe: ``` [ { "Engine": "aurora-postgresql", "DBClusterIdentifier": "pg2-cluster" } ] ``` Weitere Informationen finden Sie unter [DB-Cluster in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie unter [DescribeDbClusters AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-clusters.html)*Befehlsreferenz.* ### `describe-db-engine-versions` Das folgende Codebeispiel zeigt die Verwendung`describe-db-engine-versions`. **AWS CLI** **So beschreiben Sie die DB-Engine-Versionen für die MySQL-DB-Engine** Im folgenden Beispiel für `describe-db-engine-versions` werden Details zu den jeweiligen DB-Engine-Versionen für die angegebene DB-Engine angezeigt. ``` aws rds describe-db-engine-versions \ --engine mysql ``` Ausgabe: ``` { "DBEngineVersions": [ { "Engine": "mysql", "EngineVersion": "5.5.46", "DBParameterGroupFamily": "mysql5.5", "DBEngineDescription": "MySQL Community Edition", "DBEngineVersionDescription": "MySQL 5.5.46", "ValidUpgradeTarget": [ { "Engine": "mysql", "EngineVersion": "5.5.53", "Description": "MySQL 5.5.53", "AutoUpgrade": false, "IsMajorVersionUpgrade": false }, { "Engine": "mysql", "EngineVersion": "5.5.54", "Description": "MySQL 5.5.54", "AutoUpgrade": false, "IsMajorVersionUpgrade": false }, { "Engine": "mysql", "EngineVersion": "5.5.57", "Description": "MySQL 5.5.57", "AutoUpgrade": false, "IsMajorVersionUpgrade": false }, ...some output truncated... ] } ``` Weitere Informationen finden Sie unter [Was ist Amazon Relational Database Service (Amazon RDS)?](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [DBEngineVersionen beschreiben](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-engine-versions.html) in der *AWS CLI Befehlsreferenz*. ### `describe-db-instance-automated-backups` Das folgende Codebeispiel zeigt die Verwendung`describe-db-instance-automated-backups`. **AWS CLI** **So beschreiben Sie automatisierte Backups für eine DB-Instance** Im folgenden Beispiel für `describe-db-instance-automated-backups` werden die Details der automatisierten Backups für die angegebene DB-Instance angezeigt. Die Details beinhalten replizierte automatisierte Backups in anderen AWS Regionen. ``` aws rds describe-db-instance-automated-backups \ --db-instance-identifier new-orcl-db ``` Ausgabe: ``` { "DBInstanceAutomatedBackups": [ { "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db", "DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE", "Region": "us-east-1", "DBInstanceIdentifier": "new-orcl-db", "RestoreWindow": { "EarliestTime": "2020-12-07T21:05:20.939Z", "LatestTime": "2020-12-07T21:05:20.939Z" }, "AllocatedStorage": 20, "Status": "replicating", "Port": 1521, "InstanceCreateTime": "2020-12-04T15:28:31Z", "MasterUsername": "admin", "Engine": "oracle-se2", "EngineVersion": "12.1.0.2.v21", "LicenseModel": "bring-your-own-license", "OptionGroupName": "default:oracle-se2-12-1", "Encrypted": false, "StorageType": "gp2", "IAMDatabaseAuthenticationEnabled": false, "BackupRetentionPeriod": 14, "DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example" } ] } ``` Weitere Informationen [finden Sie unter Informationen zu replizierten Backups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Replicating.Describe) im *Amazon RDS-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeDbInstanceAutomatedBackups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-instance-automated-backups.html)in der *AWS CLI Befehlsreferenz.* ### `describe-db-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-db-instances`. **AWS CLI** **So beschreiben Sie eine DB-Instance** Im folgenden Beispiel für `describe-db-instances` werden Details zur angegebenen DB-Instance abgerufen. ``` aws rds describe-db-instances \ --db-instance-identifier mydbinstancecf ``` Ausgabe: ``` { "DBInstances": [ { "DBInstanceIdentifier": "mydbinstancecf", "DBInstanceClass": "db.t3.small", "Engine": "mysql", "DBInstanceStatus": "available", "MasterUsername": "masterawsuser", "Endpoint": { "Address": "mydbinstancecf.abcexample.us-east-1.rds.amazonaws.com", "Port": 3306, "HostedZoneId": "Z2R2ITUGPM61AM" }, ...some output truncated... } ] } ``` + Einzelheiten zur API finden Sie unter [Describe DBInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-instances.html) in der *AWS CLI Befehlsreferenz*. ### `describe-db-log-files` Das folgende Codebeispiel zeigt die Verwendung`describe-db-log-files`. **AWS CLI** **So beschreiben Sie die Protokolldateien für eine DB-Instance** Im folgenden Beispiel für `describe-db-log-files` werden Details zu den Protokolldateien für die angegebene DB-Instance abgerufen. ``` aws rds describe-db-log-files -\ -db-instance-identifier test-instance ``` Ausgabe: ``` { "DescribeDBLogFiles": [ { "Size": 0, "LastWritten": 1533060000000, "LogFileName": "error/mysql-error-running.log" }, { "Size": 2683, "LastWritten": 1532994300000, "LogFileName": "error/mysql-error-running.log.0" }, { "Size": 107, "LastWritten": 1533057300000, "LogFileName": "error/mysql-error-running.log.18" }, { "Size": 13105, "LastWritten": 1532991000000, "LogFileName": "error/mysql-error-running.log.23" }, { "Size": 0, "LastWritten": 1533061200000, "LogFileName": "error/mysql-error.log" }, { "Size": 3519, "LastWritten": 1532989252000, "LogFileName": "mysqlUpgrade" } ] } ``` + Einzelheiten zur API finden Sie [DescribeDbLogFiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-log-files.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-parameter-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-db-parameter-groups`. **AWS CLI** **So beschreiben Sie Ihre DB-Parametergruppe** Im folgenden Beispiel für `describe-db-parameter-groups` werden Details zu den DB-Parametergruppen abgerufen. ``` aws rds describe-db-parameter-groups ``` Ausgabe: ``` { "DBParameterGroups": [ { "DBParameterGroupName": "default.aurora-mysql5.7", "DBParameterGroupFamily": "aurora-mysql5.7", "Description": "Default parameter group for aurora-mysql5.7", "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.aurora-mysql5.7" }, { "DBParameterGroupName": "default.aurora-postgresql9.6", "DBParameterGroupFamily": "aurora-postgresql9.6", "Description": "Default parameter group for aurora-postgresql9.6", "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.aurora-postgresql9.6" }, { "DBParameterGroupName": "default.aurora5.6", "DBParameterGroupFamily": "aurora5.6", "Description": "Default parameter group for aurora5.6", "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.aurora5.6" }, { "DBParameterGroupName": "default.mariadb10.1", "DBParameterGroupFamily": "mariadb10.1", "Description": "Default parameter group for mariadb10.1", "DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.mariadb10.1" }, ...some output truncated... ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch zu Amazon RDS*. + Einzelheiten zur API finden Sie unter [DBParameterGruppen beschreiben](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-parameter-groups.html) in der *AWS CLI Befehlsreferenz*. ### `describe-db-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-db-parameters`. **AWS CLI** **So beschreiben Sie die Parameter in einer DB-Parametergruppe** Im folgenden Beispiel für `describe-db-parameters` werden die Details der angegebenen DB-Parametergruppe abgerufen. ``` aws rds describe-db-parameters \ --db-parameter-group-name mydbpg ``` Ausgabe: ``` { "Parameters": [ { "ParameterName": "allow-suspicious-udfs", "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded", "Source": "engine-default", "ApplyType": "static", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": false, "ApplyMethod": "pending-reboot" }, { "ParameterName": "auto_generate_certs", "Description": "Controls whether the server autogenerates SSL key and certificate files in the data directory, if they do not already exist.", "Source": "engine-default", "ApplyType": "static", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": false, "ApplyMethod": "pending-reboot" }, ...some output truncated... ] } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch zu Amazon RDS*. + Einzelheiten zur API finden Sie unter [Describe DBParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-parameters.html) in der *AWS CLI Befehlsreferenz*. ### `describe-db-proxies` Das folgende Codebeispiel zeigt die Verwendung`describe-db-proxies`. **AWS CLI** **So beschreiben Sie einen DB-Proxy für eine RDS-Datenbank** Im folgenden Beispiel für `describe-db-proxies` werden Informationen zu DB-Proxys abgerufen. ``` aws rds describe-db-proxies ``` Ausgabe: ``` { "DBProxies": [ { "DBProxyName": "proxyExample1", "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab", "Status": "available", "EngineFamily": "PostgreSQL", "VpcId": "vpc-1234567", "VpcSecurityGroupIds": [ "sg-1234" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Auth": "[ { "Description": "proxydescription1" "AuthScheme": "SECRETS", "SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:secretName-1234f", "IAMAuth": "DISABLED" } ]", "RoleArn": "arn:aws:iam::12345678912??:role/ProxyPostgreSQLRole", "Endpoint": "proxyExample1.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com", "RequireTLS": false, "IdleClientTimeout": 1800, "DebuggingLogging": false, "CreatedDate": "2023-04-05T16:09:33.452000+00:00", "UpdatedDate": "2023-04-13T01:49:38.568000+00:00" }, { "DBProxyName": "proxyExample2", "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-1234a12b23456c1ab", "Status": "available", "EngineFamily": "PostgreSQL", "VpcId": "sg-1234567", "VpcSecurityGroupIds": [ "sg-1234" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Auth": "[ { "Description": "proxydescription2" "AuthScheme": "SECRETS", "SecretArn": "aarn:aws:secretsmanager:us-west-2:123456789123:secret:secretName-1234f", "IAMAuth": "DISABLED" } ]", "RoleArn": "arn:aws:iam::12345678912:role/ProxyPostgreSQLRole", "Endpoint": "proxyExample2.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com", "RequireTLS": false, "IdleClientTimeout": 1800, "DebuggingLogging": false, "CreatedDate": "2022-01-05T16:19:33.452000+00:00", "UpdatedDate": "2023-04-13T01:49:38.568000+00:00" } ] } ``` Weitere Informationen finden Sie unter [Anzeigen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-viewing) im *Benutzerhandbuch für Amazon RDS* und [Anzeigen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-viewing) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbProxies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxies.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-proxy-endpoints` Das folgende Codebeispiel zeigt die Verwendung`describe-db-proxy-endpoints`. **AWS CLI** **Um einen DB-Proxy-Endpunkt zu beschreiben** Das folgende `describe-db-proxy-endpoints`-Beispiel gibt Informationen über DB-Proxy-Endpunkte zurück. ``` aws rds describe-db-proxy-endpoints ``` Ausgabe: ``` { "DBProxyEndpoints": [ { "DBProxyEndpointName": "proxyEndpoint1", "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab", "DBProxyName": "proxyExample", "Status": "available", "VpcId": "vpc-1234567", "VpcSecurityGroupIds": [ "sg-1234" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Endpoint": "proxyEndpoint1.endpoint.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com", "CreatedDate": "2023-04-05T16:09:33.452000+00:00", "TargetRole": "READ_WRITE", "IsDefault": false }, { "DBProxyEndpointName": "proxyEndpoint2", "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-4567a01b12345c0ab", "DBProxyName": "proxyExample2", "Status": "available", "VpcId": "vpc1234567", "VpcSecurityGroupIds": [ "sg-5678" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Endpoint": "proxyEndpoint2.endpoint.proxy-cd1ef2klmnop.us-east-1.rds.amazonaws.com", "CreatedDate": "2023-04-05T16:09:33.452000+00:00", "TargetRole": "READ_WRITE", "IsDefault": false } ] } ``` Weitere Informationen finden Sie unter [Anzeigen eines Proxy-Endpunkts](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DescribingEndpoint) im *Benutzerhandbuch für Amazon RDS* und [Erstellen eines Proxy-Endpunkts](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DescribingEndpoint) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbProxyEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxy-endpoints.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-proxy-target-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-db-proxy-target-groups`. **AWS CLI** **Um einen DB-Proxy-Endpunkt zu beschreiben** Das folgende `describe-db-proxy-target-groups`-Beispiel gibt Informationen über DB-Proxy-Zielgruppen zurück. ``` aws rds describe-db-proxy-target-groups \ --db-proxy-name proxyExample ``` Ausgabe: ``` { "TargetGroups": { "DBProxyName": "proxyExample", "TargetGroupName": "default", "TargetGroupArn": "arn:aws:rds:us-east-1:123456789012:target-group:prx-tg-0123a01b12345c0ab", "IsDefault": true, "Status": "available", "ConnectionPoolConfig": { "MaxConnectionsPercent": 100, "MaxIdleConnectionsPercent": 50, "ConnectionBorrowTimeout": 120, "SessionPinningFilters": [] }, "CreatedDate": "2023-05-02T18:41:19.495000+00:00", "UpdatedDate": "2023-05-02T18:41:21.762000+00:00" } } ``` Weitere Informationen finden Sie unter [Anzeigen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-viewing) im *Benutzerhandbuch für Amazon RDS* und [Anzeigen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-viewing) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbProxyTargetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxy-target-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-proxy-targets` Das folgende Codebeispiel zeigt die Verwendung`describe-db-proxy-targets`. **AWS CLI** **So beschreiben Sie DB-Proxy-Ziele** Das folgende `describe-db-proxy-targets`-Beispiel gibt Informationen über DB-Proxyziele zurück. ``` aws rds describe-db-proxy-targets \ --db-proxy-name proxyExample ``` Ausgabe: ``` { "Targets": [ { "Endpoint": "database1.ab0cd1efghij.us-east-1.rds.amazonaws.com", "TrackedClusterId": "database1", "RdsResourceId": "database1-instance-1", "Port": 3306, "Type": "RDS_INSTANCE", "Role": "READ_WRITE", "TargetHealth": { "State": "UNAVAILABLE", "Reason": "PENDING_PROXY_CAPACITY", "Description": "DBProxy Target is waiting for proxy to scale to desired capacity" } } ] } ``` Weitere Informationen finden Sie unter [Anzeigen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-viewing) im *Benutzerhandbuch für Amazon RDS* und [Anzeigen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-viewing) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbProxyTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxy-targets.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-recommendations` Das folgende Codebeispiel zeigt die Verwendung`describe-db-recommendations`. **AWS CLI** **Beispiel 1: So listen Sie alle DB-Empfehlungen auf** Das folgende `describe-db-recommendations` Beispiel listet alle DB-Empfehlungen in Ihrem AWS Konto auf. ``` aws rds describe-db-recommendations ``` Ausgabe: ``` { "DBRecommendations": [ { "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm", "TypeId": "config_recommendation::old_minor_version", "Severity": "informational", "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1", "Status": "active", "CreatedTime": "2024-02-21T23:14:19.292000+00:00", "UpdatedTime": "2024-02-21T23:14:19+00:00", "Detection": "**[resource-name]** is not running the latest minor DB engine version", "Recommendation": "Upgrade to latest engine version", "Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.", "RecommendedActions": [ { "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678", "Operation": "modifyDbInstance", "Parameters": [ { "Key": "EngineVersion", "Value": "5.7.44" }, { "Key": "DBInstanceIdentifier", "Value": "database-1" } ], "ApplyModes": [ "immediately", "next-maintenance-window" ], "Status": "ready", "ContextAttributes": [ { "Key": "Recommended value", "Value": "5.7.44" }, { "Key": "Current engine version", "Value": "5.7.42" } ] } ], "Category": "security", "Source": "RDS", "TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version", "TypeRecommendation": "Upgrade to latest engine version", "Impact": "Reduced database performance and data security at risk", "AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.", "Links": [ { "Text": "Upgrading an RDS DB instance engine version", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html" }, { "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html" }, { "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html" } ] } ] } ``` Weitere Informationen finden Sie unter [Anzeigen und Beantworten von Amazon-RDS-Empfehlungen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) im *Benutzerhandbuch für Amazon RDS* und [Anzeigen und Beantworten von Amazon-RDS-Empfehlungen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) im *Benutzerhandbuch für Amazon Aurora*. **Beispiel 2: So listen Sie DB-Empfehlungen mit hohem Schweregrad auf** Im folgenden `describe-db-recommendations` Beispiel werden DB-Empfehlungen mit hohem Schweregrad in Ihrem AWS Konto aufgeführt. ``` aws rds describe-db-recommendations \ --filters Name=severity,Values=high ``` Ausgabe: ``` { "DBRecommendations": [ { "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm", "TypeId": "config_recommendation::rds_extended_support", "Severity": "high", "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1", "Status": "active", "CreatedTime": "2024-02-21T23:14:19.392000+00:00", "UpdatedTime": "2024-02-21T23:14:19+00:00", "Detection": "Your databases will be auto-enrolled to RDS Extended Support on February 29", "Recommendation": "Upgrade your major version before February 29, 2024 to avoid additional charges", "Description": "Your PostgreSQL 11 and MySQL 5.7 databases will be automatically enrolled into RDS Extended Support on February 29, 2024. To avoid the increase in charges due to RDS Extended Support, we recommend upgrading your databases to a newer major engine version before February 29, 2024.\nTo learn more about the RDS Extended Support pricing, refer to the pricing page.", "RecommendedActions": [ { "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678", "Parameters": [], "ApplyModes": [ "manual" ], "Status": "ready", "ContextAttributes": [] } ], "Category": "cost optimization", "Source": "RDS", "TypeDetection": "Your database will be auto-enrolled to RDS Extended Support on February 29", "TypeRecommendation": "Upgrade your major version before February 29, 2024 to avoid additional charges", "Impact": "Increase in charges due to RDS Extended Support", "AdditionalInfo": "With Amazon RDS Extended Support, you can continue running your database on a major engine version past the RDS end of standard support date for an additional cost. This paid feature gives you more time to upgrade to a supported major engine version.\nDuring Extended Support, Amazon RDS will supply critical CVE patches and bug fixes.", "Links": [ { "Text": "Amazon RDS Extended Support pricing for RDS for MySQL", "Url": "https://aws.amazon.com/rds/mysql/pricing/" }, { "Text": "Amazon RDS Extended Support for RDS for MySQL and PostgreSQL databases", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html" }, { "Text": "Amazon RDS Extended Support pricing for Amazon Aurora PostgreSQL", "Url": "https://aws.amazon.com/rds/aurora/pricing/" }, { "Text": "Amazon RDS Extended Support for Aurora PostgreSQL databases", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/extended-support.html" }, { "Text": "Amazon RDS Extended Support pricing for RDS for PostgreSQL", "Url": "https://aws.amazon.com/rds/postgresql/pricing/" } ] } ] } ``` Weitere Informationen finden Sie unter [Anzeigen und Beantworten von Amazon-RDS-Empfehlungen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) im *Benutzerhandbuch für Amazon RDS* und [Anzeigen und Beantworten von Amazon-RDS-Empfehlungen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) im *Benutzerhandbuch für Amazon Aurora*. **Beispiel 3: So listen Sie DB-Empfehlungen für eine angegebene DB-Instance auf** Das folgende `describe-db-recommendations`-Beispiel listet alle DB-Empfehlungen für eine angegebene DB-Instance auf. ``` aws rds describe-db-recommendations \ --filters Name=dbi-resource-id,Values=database-1 ``` Ausgabe: ``` { "DBRecommendations": [ { "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm", "TypeId": "config_recommendation::old_minor_version", "Severity": "informational", "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1", "Status": "active", "CreatedTime": "2024-02-21T23:14:19.292000+00:00", "UpdatedTime": "2024-02-21T23:14:19+00:00", "Detection": "**[resource-name]** is not running the latest minor DB engine version", "Recommendation": "Upgrade to latest engine version", "Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.", "RecommendedActions": [ { "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678", "Operation": "modifyDbInstance", "Parameters": [ { "Key": "EngineVersion", "Value": "5.7.44" }, { "Key": "DBInstanceIdentifier", "Value": "database-1" } ], "ApplyModes": [ "immediately", "next-maintenance-window" ], "Status": "ready", "ContextAttributes": [ { "Key": "Recommended value", "Value": "5.7.44" }, { "Key": "Current engine version", "Value": "5.7.42" } ] } ], "Category": "security", "Source": "RDS", "TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version", "TypeRecommendation": "Upgrade to latest engine version", "Impact": "Reduced database performance and data security at risk", "AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.", "Links": [ { "Text": "Upgrading an RDS DB instance engine version", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html" }, { "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html" }, { "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html" } ] } ] } ``` Weitere Informationen finden Sie unter [Anzeigen und Beantworten von Amazon-RDS-Empfehlungen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) im *Benutzerhandbuch für Amazon RDS* und [Anzeigen und Beantworten von Amazon-RDS-Empfehlungen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) im *Benutzerhandbuch für Amazon Aurora*. **Beispiel 4: So listen Sie alle aktiven DB-Empfehlungen auf** Das folgende `describe-db-recommendations` Beispiel listet alle aktiven DB-Empfehlungen in Ihrem AWS Konto auf. ``` aws rds describe-db-recommendations \ --filters Name=status,Values=active ``` Ausgabe: ``` { "DBRecommendations": [ { "RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm", "TypeId": "config_recommendation::old_minor_version", "Severity": "informational", "ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1", "Status": "active", "CreatedTime": "2024-02-21T23:14:19.292000+00:00", "UpdatedTime": "2024-02-21T23:14:19+00:00", "Detection": "**[resource-name]** is not running the latest minor DB engine version", "Recommendation": "Upgrade to latest engine version", "Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.", "RecommendedActions": [ { "ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678", "Operation": "modifyDbInstance", "Parameters": [ { "Key": "EngineVersion", "Value": "5.7.44" }, { "Key": "DBInstanceIdentifier", "Value": "database-1" } ], "ApplyModes": [ "immediately", "next-maintenance-window" ], "Status": "ready", "ContextAttributes": [ { "Key": "Recommended value", "Value": "5.7.44" }, { "Key": "Current engine version", "Value": "5.7.42" } ] } ], "Category": "security", "Source": "RDS", "TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version", "TypeRecommendation": "Upgrade to latest engine version", "Impact": "Reduced database performance and data security at risk", "AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.", "Links": [ { "Text": "Upgrading an RDS DB instance engine version", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html" }, { "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html" }, { "Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS", "Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html" } ] } ] } ``` Weitere Informationen finden Sie unter [Anzeigen und Beantworten von Amazon-RDS-Empfehlungen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) im *Benutzerhandbuch für Amazon RDS* und [Anzeigen und Beantworten von Amazon-RDS-Empfehlungen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbRecommendations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-recommendations.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-security-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-db-security-groups`. **AWS CLI** **So listen Sie DB-Sicherheitsgruppen auf** Das folgende `describe-db-security-groups`-Beispiel listet DB-Sicherheitsgruppen auf. ``` aws rds describe-db-security-groups ``` Ausgabe: ``` { "DBSecurityGroups": [ { "OwnerId": "123456789012", "DBSecurityGroupName": "default", "DBSecurityGroupDescription": "default", "EC2SecurityGroups": [], "IPRanges": [], "DBSecurityGroupArn": "arn:aws:rds:us-west-1:111122223333:secgrp:default" }, { "OwnerId": "123456789012", "DBSecurityGroupName": "mysecgroup", "DBSecurityGroupDescription": "My Test Security Group", "VpcId": "vpc-1234567f", "EC2SecurityGroups": [], "IPRanges": [], "DBSecurityGroupArn": "arn:aws:rds:us-west-1:111122223333:secgrp:mysecgroup" } ] } ``` Weitere Informationen finden Sie unter [Auflistung verfügbarer DB-Sicherheitsgruppen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithSecurityGroups.html#USER_WorkingWithSecurityGroups.Listing) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [DescribeDbSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-security-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-shard-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-db-shard-groups`. **AWS CLI** **Beispiel 1: So beschreiben Sie DB-Shard-Gruppen** Im folgenden Beispiel für `describe-db-shard-groups` werden Details zu Ihren DB-Shard-Gruppen abgerufen. ``` aws rds describe-db-shard-groups ``` Ausgabe: ``` { "DBShardGroups": [ { "DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example", "DBShardGroupIdentifier": "limitless-test-shard-grp", "DBClusterIdentifier": "limitless-test-cluster", "MaxACU": 768.0, "ComputeRedundancy": 0, "Status": "available", "PubliclyAccessible": true, "Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" }, { "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890", "DBShardGroupIdentifier": "my-db-shard-group", "DBClusterIdentifier": "my-sv2-cluster", "MaxACU": 768.0, "ComputeRedundancy": 0, "Status": "available", "PubliclyAccessible": false, "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" } ] } ``` Weitere Informationen finden Sie unter [DB-Cluster in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDbShardGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-shard-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-snapshot-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-db-snapshot-attributes`. **AWS CLI** **So beschreiben Sie die Attributnamen und -werte für einen DB-Snapshot** Das folgende `describe-db-snapshot-attributes`-Beispiel beschreibt die Attributnamen und -werte für einen DB-Snapshot. ``` aws rds describe-db-snapshot-attributes \ --db-snapshot-identifier mydbsnapshot ``` Ausgabe: ``` { "DBSnapshotAttributesResult": { "DBSnapshotIdentifier": "mydbsnapshot", "DBSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123456789012", "210987654321" ] } ] } } ``` Weitere Informationen finden Sie unter [Freigeben eines DB-Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [DescribeDbSnapshotAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-snapshot-attributes.html)in der *AWS CLI Befehlsreferenz*. ### `describe-db-snapshots` Das folgende Codebeispiel zeigt die Verwendung`describe-db-snapshots`. **AWS CLI** **Beispiel 1: So beschreiben Sie einen DB-Snapshot für eine DB-Instance** Im folgenden Beispiel für `describe-db-snapshots` werden die Details eines DB-Snapshots für eine DB-Instance abgerufen. ``` aws rds describe-db-snapshots \ --db-snapshot-identifier mydbsnapshot ``` Ausgabe: ``` { "DBSnapshots": [ { "DBSnapshotIdentifier": "mydbsnapshot", "DBInstanceIdentifier": "mysqldb", "SnapshotCreateTime": "2018-02-08T22:28:08.598Z", "Engine": "mysql", "AllocatedStorage": 20, "Status": "available", "Port": 3306, "AvailabilityZone": "us-east-1f", "VpcId": "vpc-6594f31c", "InstanceCreateTime": "2018-02-08T22:24:55.973Z", "MasterUsername": "mysqladmin", "EngineVersion": "5.6.37", "LicenseModel": "general-public-license", "SnapshotType": "manual", "OptionGroupName": "default:mysql-5-6", "PercentProgress": 100, "StorageType": "gp2", "Encrypted": false, "DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot", "IAMDatabaseAuthenticationEnabled": false, "ProcessorFeatures": [], "DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE" } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines DB-Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html) im *Benutzerhandbuch für Amazon RDS*. **Beispiel 2: So ermitteln Sie die Anzahl der manuell erstellten Snapshots** Im folgenden `describe-db-snapshots` Beispiel wird der `length` Operator in der `--query` Option verwendet, um die Anzahl der manuellen Schnappschüsse zurückzugeben, die in einer bestimmten AWS Region aufgenommen wurden. ``` aws rds describe-db-snapshots \ --snapshot-type manual \ --query "length(*[].{DBSnapshots:SnapshotType})" \ --region eu-central-1 ``` Ausgabe: ``` 35 ``` Weitere Informationen finden Sie unter [Erstellen eines DB-Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [Describe DBSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-snapshots.html) in der *AWS CLI Befehlsreferenz.* ### `describe-db-subnet-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-db-subnet-groups`. **AWS CLI** **So beschreiben Sie eine DB-Subnetzgruppe** Im folgenden Beispiel für `describe-db-subnet-groups` werden die Details der angegebenen DB-Subnetzgruppe abgerufen. ``` aws rds describe-db-subnet-groups ``` Ausgabe: ``` { "DBSubnetGroups": [ { "DBSubnetGroupName": "mydbsubnetgroup", "DBSubnetGroupDescription": "My DB Subnet Group", "VpcId": "vpc-971c12ee", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-d8c8e7f4", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-718fdc7d", "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-cbc8e7e7", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-0ccde220", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" } ], "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123456789012:subgrp:mydbsubnetgroup" } ] } ``` Weitere Informationen finden Sie unter [Amazon Virtual Private Cloud VPCs und Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html) im *Amazon RDS-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeDbSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-subnet-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-engine-default-cluster-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-engine-default-cluster-parameters`. **AWS CLI** **So beschreiben Sie die Standard-Engine- und Systemparameterinformationen für die Aurora-Datenbank-Engine** Im folgenden `describe-engine-default-cluster-parameters` Beispiel werden die Details der Standard-Engine und die Systemparameterinformationen für Aurora-DB-Cluster mit MySQL 5.7-Kompatibilität abgerufen. ``` aws rds describe-engine-default-cluster-parameters \ --db-parameter-group-family aurora-mysql5.7 ``` Ausgabe: ``` { "EngineDefaults": { "Parameters": [ { "ParameterName": "aurora_load_from_s3_role", "Description": "IAM role ARN used to load data from AWS S3", "Source": "engine-default", "ApplyType": "dynamic", "DataType": "string", "IsModifiable": true, "SupportedEngineModes": [ "provisioned" ] }, ...some output truncated... ] } } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeEngineDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-engine-default-cluster-parameters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-engine-default-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-engine-default-parameters`. **AWS CLI** **So beschreiben Sie die Standard-Engine- und Systemparameterinformationen für die Datenbank-Engine** Im folgenden Beispiel für `describe-engine-default-parameters` werden Details für die Standard-Engine- und System-Parameterinformationen für MySQL 5.7 DB-Instances abgerufen. ``` aws rds describe-engine-default-parameters \ --db-parameter-group-family mysql5.7 ``` Ausgabe: ``` { "EngineDefaults": { "Parameters": [ { "ParameterName": "allow-suspicious-udfs", "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded", "Source": "engine-default", "ApplyType": "static", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": false }, ...some output truncated... ] } } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch zu Amazon RDS*. + Einzelheiten zur API finden Sie [DescribeEngineDefaultParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-engine-default-parameters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-event-categories` Das folgende Codebeispiel zeigt die Verwendung`describe-event-categories`. **AWS CLI** **So beschreiben Sie Ereigniskategorien** Im folgenden Beispiel für `describe-event-categories` werden Details zu den Ereigniskategorien für alle verfügbaren Ereignisquellen abgerufen. ``` aws rds describe-event-categories ``` Ausgabe: ``` { "EventCategoriesMapList": [ { "SourceType": "db-instance", "EventCategories": [ "deletion", "read replica", "failover", "restoration", "maintenance", "low storage", "configuration change", "backup", "creation", "availability", "recovery", "failure", "backtrack", "notification" ] }, { "SourceType": "db-security-group", "EventCategories": [ "configuration change", "failure" ] }, { "SourceType": "db-parameter-group", "EventCategories": [ "configuration change" ] }, { "SourceType": "db-snapshot", "EventCategories": [ "deletion", "creation", "restoration", "notification" ] }, { "SourceType": "db-cluster", "EventCategories": [ "failover", "failure", "notification" ] }, { "SourceType": "db-cluster-snapshot", "EventCategories": [ "backup" ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeEventCategories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-event-categories.html)in der *AWS CLI Befehlsreferenz*. ### `describe-event-subscriptions` Das folgende Codebeispiel zeigt die Verwendung`describe-event-subscriptions`. **AWS CLI** **So beschreiben Sie Ereignisabonnements** Dieses Beispiel beschreibt alle Amazon RDS-Event-Abonnements für das AWS Girokonto. ``` aws rds describe-event-subscriptions ``` Ausgabe: ``` { "EventSubscriptionsList": [ { "EventCategoriesList": [ "backup", "recovery" ], "Enabled": true, "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", "Status": "creating", "SourceType": "db-instance", "CustomerAwsId": "123456789012", "SubscriptionCreationTime": "2018-07-31 23:22:01.893", "CustSubscriptionId": "my-instance-events", "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events" }, ...some output truncated... ] } ``` + Einzelheiten zur API finden Sie [DescribeEventSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-event-subscriptions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-events` Das folgende Codebeispiel zeigt die Verwendung`describe-events`. **AWS CLI** **So beschreiben Sie Ereignisse** Im folgenden Beispiel für `describe-events` werden Details zu den Ereignissen abgerufen, die für die angegebene DB-Instance aufgetreten sind. ``` aws rds describe-events \ --source-identifier test-instance \ --source-type db-instance ``` Ausgabe: ``` { "Events": [ { "SourceType": "db-instance", "SourceIdentifier": "test-instance", "EventCategories": [ "backup" ], "Message": "Backing up DB instance", "Date": "2018-07-31T23:09:23.983Z", "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance" }, { "SourceType": "db-instance", "SourceIdentifier": "test-instance", "EventCategories": [ "backup" ], "Message": "Finished DB Instance backup", "Date": "2018-07-31T23:15:13.049Z", "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance" } ] } ``` + Einzelheiten zur API finden Sie [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-events.html)in der *AWS CLI Befehlsreferenz*. ### `describe-export-tasks` Das folgende Codebeispiel zeigt die Verwendung`describe-export-tasks`. **AWS CLI** **So beschreiben Sie Snapshot-Exportaufgaben** Das folgende `describe-export-tasks`-Beispiel gibt Informationen über Snapshot-Exporte nach Amazon S3 zurück. ``` aws rds describe-export-tasks ``` Ausgabe: ``` { "ExportTasks": [ { "ExportTaskIdentifier": "test-snapshot-export", "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:test-snapshot", "SnapshotTime": "2020-03-02T18:26:28.163Z", "TaskStartTime": "2020-03-02T18:57:56.896Z", "TaskEndTime": "2020-03-02T19:10:31.985Z", "S3Bucket": "amzn-s3-demo-bucket", "S3Prefix": "", "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole", "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff", "Status": "COMPLETE", "PercentProgress": 100, "TotalExtractedDataInGB": 0 }, { "ExportTaskIdentifier": "my-s3-export", "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test", "SnapshotTime": "2020-03-27T20:48:42.023Z", "S3Bucket": "amzn-s3-demo-bucket", "S3Prefix": "", "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole", "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff", "Status": "STARTING", "PercentProgress": 0, "TotalExtractedDataInGB": 0 } ] } ``` Weitere Informationen finden Sie unter [Überwachung von Snapshot-Exporten](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Monitoring) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [DescribeExportTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-export-tasks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-global-clusters` Das folgende Codebeispiel zeigt die Verwendung`describe-global-clusters`. **AWS CLI** **So beschreiben Sie globale DB-Cluster** Das folgende `describe-global-clusters` Beispiel listet globale Aurora-DB-Cluster in der aktuellen AWS Region auf. ``` aws rds describe-global-clusters ``` Ausgabe: ``` { "GlobalClusters": [ { "GlobalClusterIdentifier": "myglobalcluster", "GlobalClusterResourceId": "cluster-f5982077e3b5aabb", "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster", "Status": "available", "Engine": "aurora-mysql", "EngineVersion": "5.7.mysql_aurora.2.07.2", "StorageEncrypted": false, "DeletionProtection": false, "GlobalClusterMembers": [] } ] } ``` Weitere Informationen finden Sie unter [Verwalten einer globalen Aurora-Datenbank](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeGlobalClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-global-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-option-group-options` Das folgende Codebeispiel zeigt die Verwendung`describe-option-group-options`. **AWS CLI** **So beschreiben Sie alle verfügbaren Optionen** Im folgenden Beispiel für `describe-option-group-options` werden zwei Optionen für eine Oracle Database 19c-Instance aufgelistet. ``` aws rds describe-option-group-options \ --engine-name oracle-ee \ --major-engine-version 19 \ --max-items 2 ``` Ausgabe: ``` { "OptionGroupOptions": [ { "Name": "APEX", "Description": "Oracle Application Express Runtime Environment", "EngineName": "oracle-ee", "MajorEngineVersion": "19", "MinimumRequiredMinorEngineVersion": "0.0.0.ru-2019-07.rur-2019-07.r1", "PortRequired": false, "OptionsDependedOn": [], "OptionsConflictsWith": [], "Persistent": false, "Permanent": false, "RequiresAutoMinorEngineVersionUpgrade": false, "VpcOnly": false, "SupportsOptionVersionDowngrade": false, "OptionGroupOptionSettings": [], "OptionGroupOptionVersions": [ { "Version": "19.1.v1", "IsDefault": true }, { "Version": "19.2.v1", "IsDefault": false } ] }, { "Name": "APEX-DEV", "Description": "Oracle Application Express Development Environment", "EngineName": "oracle-ee", "MajorEngineVersion": "19", "MinimumRequiredMinorEngineVersion": "0.0.0.ru-2019-07.rur-2019-07.r1", "PortRequired": false, "OptionsDependedOn": [ "APEX" ], "OptionsConflictsWith": [], "Persistent": false, "Permanent": false, "RequiresAutoMinorEngineVersionUpgrade": false, "VpcOnly": false, "OptionGroupOptionSettings": [] } ], "NextToken": "eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==" } ``` Weitere Informationen finden Sie unter [Auflisten der Optionen und Optionseinstellungen für eine Optionsgruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.ListOption) im *Amazon RDS-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeOptionGroupOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-option-group-options.html)in der *AWS CLI Befehlsreferenz*. ### `describe-option-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-option-groups`. **AWS CLI** **So beschreiben Sie die verfügbaren Optionsgruppen** Im folgenden Beispiel für `describe-option-groups` werden die Optionsgruppen für eine Oracle Database 19c-Instance aufgelistet. ``` aws rds describe-option-groups \ --engine-name oracle-ee \ --major-engine-version 19 ``` Ausgabe: ``` { "OptionGroupsList": [ { "OptionGroupName": "default:oracle-ee-19", "OptionGroupDescription": "Default option group for oracle-ee 19", "EngineName": "oracle-ee", "MajorEngineVersion": "19", "Options": [], "AllowsVpcAndNonVpcInstanceMemberships": true, "OptionGroupArn": "arn:aws:rds:us-west-1:111122223333:og:default:oracle-ee-19" } ] } ``` Weitere Informationen finden Sie unter [Auflisten der Optionen und Optionseinstellungen für eine Optionsgruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.ListOption) im *Amazon RDS-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeOptionGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-option-groups.html)in der *AWS CLI Befehlsreferenz*. ### `describe-orderable-db-instance-options` Das folgende Codebeispiel zeigt die Verwendung`describe-orderable-db-instance-options`. **AWS CLI** **So beschreiben Sie bestellbare DB-Instance-Optionen** Im folgenden Beispiel für `describe-orderable-db-instance-options` werden Details zu den bestellbaren Optionen für DB-Instances abgerufen, auf denen die MySQL-DB-Engine ausgeführt wird. ``` aws rds describe-orderable-db-instance-options \ --engine mysql ``` Ausgabe: ``` { "OrderableDBInstanceOptions": [ { "MinStorageSize": 5, "ReadReplicaCapable": true, "MaxStorageSize": 6144, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "SupportsIops": false, "AvailableProcessorFeatures": [], "MultiAZCapable": true, "DBInstanceClass": "db.m1.large", "Vpc": true, "StorageType": "gp2", "LicenseModel": "general-public-license", "EngineVersion": "5.5.46", "SupportsStorageEncryption": false, "SupportsEnhancedMonitoring": true, "Engine": "mysql", "SupportsIAMDatabaseAuthentication": false, "SupportsPerformanceInsights": false } ] ...some output truncated... } ``` + Einzelheiten zur API finden Sie unter [DescribeOrderableDBInstanceOptionen](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-orderable-db-instance-options.html) in der *AWS CLI Befehlsreferenz*. ### `describe-pending-maintenance-actions` Das folgende Codebeispiel zeigt die Verwendung`describe-pending-maintenance-actions`. **AWS CLI** **So listen Sie Ressourcen auf, für die mindestens eine Wartungsaktion aussteht** Im folgenden `describe-pending-maintenance-actions` Beispiel wird die ausstehende Wartungsaktion für eine DB-Instance aufgeführt. ``` aws rds describe-pending-maintenance-actions ``` Ausgabe: ``` { "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-west-2:123456789012:cluster:global-db1-cl1", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "Description": "Upgrade to Aurora PostgreSQL 2.4.2" } ] } ] } ``` Weitere Informationen finden Sie unter [Verwalten einer DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [DescribePendingMaintenanceActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-pending-maintenance-actions.html)unter *AWS CLI Befehlsreferenz*. ### `describe-reserved-db-instances-offerings` Das folgende Codebeispiel zeigt die Verwendung`describe-reserved-db-instances-offerings`. **AWS CLI** **So beschreiben Sie Reserved-Instance-Angebote** Im folgenden Beispiel für `describe-reserved-db-instances-offerings` werden Details zu den Optionen von Reserved-DB-Instance für `oracle` abgerufen. ``` aws rds describe-reserved-db-instances-offerings \ --product-description oracle ``` Ausgabe: ``` { "ReservedDBInstancesOfferings": [ { "CurrencyCode": "USD", "UsagePrice": 0.0, "ProductDescription": "oracle-se2(li)", "ReservedDBInstancesOfferingId": "005bdee3-9ef4-4182-aa0c-58ef7cb6c2f8", "MultiAZ": true, "DBInstanceClass": "db.m4.xlarge", "OfferingType": "Partial Upfront", "RecurringCharges": [ { "RecurringChargeAmount": 0.594, "RecurringChargeFrequency": "Hourly" } ], "FixedPrice": 4089.0, "Duration": 31536000 }, ...some output truncated... } ``` + Einzelheiten zur API finden Sie [DescribeReservedDbInstancesOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-reserved-db-instances-offerings.html)in der *AWS CLI Befehlsreferenz*. ### `describe-reserved-db-instances` Das folgende Codebeispiel zeigt die Verwendung`describe-reserved-db-instances`. **AWS CLI** **So beschreiben Sie Reserved-DB-Instances** Im folgenden `describe-reserved-db-instances` Beispiel werden Details zu allen reservierten DB-Instances im aktuellen AWS Konto abgerufen. ``` aws rds describe-reserved-db-instances ``` Ausgabe: ``` { "ReservedDBInstances": [ { "ReservedDBInstanceId": "myreservedinstance", "ReservedDBInstancesOfferingId": "12ab34cd-59af-4b2c-a660-1abcdef23456", "DBInstanceClass": "db.t3.micro", "StartTime": "2020-06-01T13:44:21.436Z", "Duration": 31536000, "FixedPrice": 0.0, "UsagePrice": 0.0, "CurrencyCode": "USD", "DBInstanceCount": 1, "ProductDescription": "sqlserver-ex(li)", "OfferingType": "No Upfront", "MultiAZ": false, "State": "payment-pending", "RecurringCharges": [ { "RecurringChargeAmount": 0.014, "RecurringChargeFrequency": "Hourly" } ], "ReservedDBInstanceArn": "arn:aws:rds:us-west-2:123456789012:ri:myreservedinstance", "LeaseId": "a1b2c3d4-6b69-4a59-be89-5e11aa446666" } ] } ``` Weitere Informationen finden Sie unter [Reservierte Instances für Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithReservedDBInstances.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [DescribeReservedDbInstances AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-reserved-db-instances.html)*Befehlsreferenz.* ### `describe-source-regions` Das folgende Codebeispiel zeigt die Verwendung`describe-source-regions`. **AWS CLI** **So beschreiben Sie Quellregionen** Im folgenden `describe-source-regions` Beispiel werden Details zu allen AWS Quellregionen abgerufen. Es zeigt auch, dass automatische Backups nur von USA West (Oregon) in die AWS Zielregion USA Ost (Nord-Virginia) repliziert werden können. ``` aws rds describe-source-regions \ --region us-east-1 ``` Ausgabe: ``` { "SourceRegions": [ { "RegionName": "af-south-1", "Endpoint": "https://rds.af-south-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": false }, { "RegionName": "ap-east-1", "Endpoint": "https://rds.ap-east-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": false }, { "RegionName": "ap-northeast-1", "Endpoint": "https://rds.ap-northeast-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "ap-northeast-2", "Endpoint": "https://rds.ap-northeast-2.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "ap-northeast-3", "Endpoint": "https://rds.ap-northeast-3.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": false }, { "RegionName": "ap-south-1", "Endpoint": "https://rds.ap-south-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "ap-southeast-1", "Endpoint": "https://rds.ap-southeast-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "ap-southeast-2", "Endpoint": "https://rds.ap-southeast-2.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "ap-southeast-3", "Endpoint": "https://rds.ap-southeast-3.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": false }, { "RegionName": "ca-central-1", "Endpoint": "https://rds.ca-central-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "eu-north-1", "Endpoint": "https://rds.eu-north-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "eu-south-1", "Endpoint": "https://rds.eu-south-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": false }, { "RegionName": "eu-west-1", "Endpoint": "https://rds.eu-west-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "eu-west-2", "Endpoint": "https://rds.eu-west-2.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "eu-west-3", "Endpoint": "https://rds.eu-west-3.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "me-central-1", "Endpoint": "https://rds.me-central-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": false }, { "RegionName": "me-south-1", "Endpoint": "https://rds.me-south-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": false }, { "RegionName": "sa-east-1", "Endpoint": "https://rds.sa-east-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "us-east-2", "Endpoint": "https://rds.us-east-2.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "us-west-1", "Endpoint": "https://rds.us-west-1.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true }, { "RegionName": "us-west-2", "Endpoint": "https://rds.us-west-2.amazonaws.com", "Status": "available", "SupportsDBInstanceAutomatedBackupsReplication": true } ] } ``` Weitere Informationen [finden Sie unter Informationen zu replizierten Backups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Replicating.Describe) im *Amazon RDS-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DescribeSourceRegions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-source-regions.html)in der *AWS CLI Befehlsreferenz.* ### `describe-valid-db-instance-modifications` Das folgende Codebeispiel zeigt die Verwendung`describe-valid-db-instance-modifications`. **AWS CLI** **So beschreiben Sie gültige Änderungen für eine DB-Instance** Im folgenden Beispiel für `describe-valid-db-instance-modifications` werden Details zu den gültigen Änderungen für die angegebene DB-Instance abgerufen. ``` aws rds describe-valid-db-instance-modifications \ --db-instance-identifier test-instance ``` Ausgabe: ``` { "ValidDBInstanceModificationsMessage": { "ValidProcessorFeatures": [], "Storage": [ { "StorageSize": [ { "Step": 1, "To": 20, "From": 20 }, { "Step": 1, "To": 6144, "From": 22 } ], "ProvisionedIops": [ { "Step": 1, "To": 0, "From": 0 } ], "IopsToStorageRatio": [ { "To": 0.0, "From": 0.0 } ], "StorageType": "gp2" }, { "StorageSize": [ { "Step": 1, "To": 6144, "From": 100 } ], "ProvisionedIops": [ { "Step": 1, "To": 40000, "From": 1000 } ], "IopsToStorageRatio": [ { "To": 50.0, "From": 1.0 } ], "StorageType": "io1" }, { "StorageSize": [ { "Step": 1, "To": 20, "From": 20 }, { "Step": 1, "To": 3072, "From": 22 } ], "ProvisionedIops": [ { "Step": 1, "To": 0, "From": 0 } ], "IopsToStorageRatio": [ { "To": 0.0, "From": 0.0 } ], "StorageType": "magnetic" } ] } } ``` + Einzelheiten zur API finden Sie [DescribeValidDbInstanceModifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-valid-db-instance-modifications.html)in der *AWS CLI Befehlsreferenz*. ### `download-db-log-file-portion` Das folgende Codebeispiel zeigt die Verwendung`download-db-log-file-portion`. **AWS CLI** **Beispiel 1: So laden Sie den neuesten Teil einer DB-Protokolldatei herunter** Im folgenden Beispiel für `download-db-log-file-portion` wird nur der neueste Teil Ihrer Protokolldatei heruntergeladen und in einer lokalen Datei namens `tail.txt` gespeichert. ``` aws rds download-db-log-file-portion \ --db-instance-identifier test-instance \ --log-file-name log.txt \ --output text > tail.txt ``` Die gespeicherte Datei kann Leerzeilen enthalten. Sie werden beim Herunterladen am Ende jedes Teils der Protokolldatei angezeigt. **Beispiel 2: So laden Sie eine gesamte DB-Protokolldatei herunter** Im folgenden Beispiel für `download-db-log-file-portion` wird die komplette Protokolldatei unter Verwendung des `--starting-token 0`-Parameters heruntergeladen und die Ausgabe in einer lokalen Datei namens `full.txt` gespeichert. ``` aws rds download-db-log-file-portion \ --db-instance-identifier test-instance \ --log-file-name log.txt \ --starting-token 0 \ --output text > full.txt ``` Die gespeicherte Datei kann Leerzeilen enthalten. Sie werden beim Herunterladen am Ende jedes Teils der Protokolldatei angezeigt. + Einzelheiten zur API finden Sie [DownloadDbLogFilePortion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/download-db-log-file-portion.html)in der *AWS CLI Befehlsreferenz*. ### `generate-auth-token` Das folgende Codebeispiel zeigt die Verwendung`generate-auth-token`. **AWS CLI** **So generieren Sie ein Authentifizierungstoken** Im folgenden Beispiel für `generate-db-auth-token` wird ein Authentifizierungstoken zur Verwendung mit der IAM-Datenbankauthentifizierung generiert. ``` aws rds generate-db-auth-token \ --hostname aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com \ --port 3306 \ --region us-east-1 \ --username jane_doe ``` Ausgabe: ``` aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com:3306/?Action=connect&DBUser=jane_doe&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIESZCNJ3OEXAMPLE%2F20180731%2Fus-east-1%2Frds-db%2Faws4_request&X-Amz-Date=20180731T235209Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=5a8753ebEXAMPLEa2c724e5667797EXAMPLE9d6ec6e3f427191fa41aeEXAMPLE ``` + Einzelheiten zur API finden Sie [GenerateAuthToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/generate-auth-token.html)in der *AWS CLI Befehlsreferenz*. ### `generate-db-auth-token` Das folgende Codebeispiel zeigt die Verwendung`generate-db-auth-token`. **AWS CLI** **So generieren Sie ein Authentifizierungstoken** Im folgenden Beispiel für `generate-db-auth-token` wird ein IAM-Authentifizierungstoken generiert, um eine Verbindung zu einer Datenbank herzustellen. ``` aws rds generate-db-auth-token \ --hostname mydb.123456789012.us-east-1.rds.amazonaws.com \ --port 3306 \ --region us-east-1 \ --username db_user ``` Ausgabe: ``` mydb.123456789012.us-east-1.rds.amazonaws.com:3306/?Action=connect&DBUser=db_user&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIEXAMPLE%2Fus-east-1%2Frds-db%2Faws4_request&X-Amz-Date=20210123T011543Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=88987EXAMPLE1EXAMPLE2EXAMPLE3EXAMPLE4EXAMPLE5EXAMPLE6 ``` Weitere Informationen finden Sie unter [Herstellen einer Verbindung zu Ihrer DB-Instance mithilfe der IAM-Authentifizierung](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.Connecting.html) im *Benutzerhandbuch für Amazon RDS* und [Herstellen einer Verbindung zu Ihrem DB-Cluster mithilfe der IAM-Authentifizierung](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.Connecting.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [GenerateDbAuthToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/generate-db-auth-token.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie alle Tags in einer Amazon-RDS-Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags auf einer DB-Instance aufgelistet. ``` aws rds list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:123456789012:db:orcl1 ``` Ausgabe: ``` { "TagList": [ { "Key": "Environment", "Value": "test" }, { "Key": "Name", "Value": "MyDatabase" } ] } ``` Weitere Informationen finden Sie unter [Hinzufügen von Tags zu Amazon-EKS-Ressourcen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) im *Entwicklerhandbuch für Amazon EKS*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `modify-certificates` Das folgende Codebeispiel zeigt die Verwendung`modify-certificates`. **AWS CLI** **Um das SSL/TLS Systemstandardzertifikat für neue DB-Instances vorübergehend zu überschreiben** Das folgende `modify-certificates` Beispiel überschreibt vorübergehend das SSL/TLS Systemstandardzertifikat für neue DB-Instances. ``` aws rds modify-certificates \ --certificate-identifier rds-ca-2019 ``` Ausgabe: ``` { "Certificate": { "CertificateIdentifier": "rds-ca-2019", "CertificateType": "CA", "Thumbprint": "EXAMPLE123456789012", "ValidFrom": "2019-09-19T18:16:53Z", "ValidTill": "2024-08-22T17:08:50Z", "CertificateArn": "arn:aws:rds:us-east-1::cert:rds-ca-2019", "CustomerOverride": true, "CustomerOverrideValidTill": "2024-08-22T17:08:50Z" } } ``` Weitere Informationen finden Sie unter [Rotation Ihres SSL/TLS Zertifikats](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html) im *Amazon RDS-Benutzerhandbuch* und [Rotation Ihres SSL/TLS Zertifikats](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html) im *Amazon Aurora Aurora-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ModifyCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-certificates.html)in der *AWS CLI Befehlsreferenz*. ### `modify-current-db-cluster-capacity` Das folgende Codebeispiel zeigt die Verwendung`modify-current-db-cluster-capacity`. **AWS CLI** **So skalieren Sie die Kapazität eines DB-Clusters von Aurora Serverless** Im folgenden Beispiel für `modify-current-db-cluster-capacity` wird die Kapazität eines DB-Clusters von Aurora Serverless auf 8 skaliert. ``` aws rds modify-current-db-cluster-capacity \ --db-cluster-identifier mydbcluster \ --capacity 8 ``` Ausgabe: ``` { "DBClusterIdentifier": "mydbcluster", "PendingCapacity": 8, "CurrentCapacity": 1, "SecondsBeforeTimeout": 300, "TimeoutAction": "ForceApplyCapacityChange" } ``` Weitere Informationen finden Sie unter [Manuelles Skalieren der Kapazität des DB-Clusters in Aurora Serverless v1](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.setting-capacity.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyCurrentDbClusterCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-current-db-cluster-capacity.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-cluster-endpoint` Das folgende Codebeispiel zeigt die Verwendung`modify-db-cluster-endpoint`. **AWS CLI** **So ändern Sie einen benutzerdefinierten DB-Cluster-Endpunkt** Im folgenden Beispiel für `modify-db-cluster-endpoint` wird der angegebene benutzerdefinierte DB-Cluster-Endpunkt geändert. ``` aws rds modify-db-cluster-endpoint \ --db-cluster-endpoint-identifier mycustomendpoint \ --static-members dbinstance1 dbinstance2 dbinstance3 ``` Ausgabe: ``` { "DBClusterEndpointIdentifier": "mycustomendpoint", "DBClusterIdentifier": "mydbcluster", "DBClusterEndpointResourceIdentifier": "cluster-endpoint-ANPAJ4AE5446DAEXAMPLE", "Endpoint": "mycustomendpoint.cluster-custom-cnpexample.us-east-1.rds.amazonaws.com", "Status": "modifying", "EndpointType": "CUSTOM", "CustomEndpointType": "READER", "StaticMembers": [ "dbinstance1", "dbinstance2", "dbinstance3" ], "ExcludedMembers": [], "DBClusterEndpointArn": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:mycustomendpoint" } ``` Weitere Informationen finden Sie unter [Verbindungsmanagement in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyDbClusterEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`modify-db-cluster-parameter-group`. **AWS CLI** **So ändern Sie Parameter in einer DB-Cluster-Parametergruppe** Im folgenden Beispiel für `modify-db-cluster-parameter-group` werden die Werte von Parametern in einer DB-Cluster-Parametergruppe geändert. ``` aws rds modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterpg \ --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \ "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate" ``` Ausgabe: ``` { "DBClusterParameterGroupName": "mydbclusterpg" } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-cluster-snapshot-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-db-cluster-snapshot-attribute`. **AWS CLI** **So ändern Sie das Attribut eines DB-Cluster-Snapshots** Im folgenden Beispiel für `modify-db-cluster-snapshot-attribute` werden Änderungen am angegebenen Snapshot-Attribut vom DB-Cluster vorgenommen. ``` aws rds modify-db-cluster-snapshot-attribute \ --db-cluster-snapshot-identifier myclustersnapshot \ --attribute-name restore \ --values-to-add 123456789012 ``` Ausgabe: ``` { "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotIdentifier": "myclustersnapshot", "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123456789012" ] } ] } } ``` Weitere Informationen finden Sie unter [Wiederherstellen aus einem DB-Cluster-Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RestoreFromSnapshot.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyDbClusterSnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-snapshot-attribute.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`modify-db-cluster`. **AWS CLI** **Beispiel 2: So ändern Sie einen DB-Cluster** Im folgenden Beispiel für `modify-db-cluster` wird das Masterbenutzerkennwort für den DB-Cluster namens `cluster-2` geändert und die Aufbewahrungsfrist für Backups auf 14 Tage festgelegt. Der Parameter `--apply-immediately` bewirkt, dass die Änderungen sofort übernommen werden, anstatt auf das nächste Wartungsfenster zu warten. ``` aws rds modify-db-cluster \ --db-cluster-identifier cluster-2 \ --backup-retention-period 14 \ --master-user-password newpassword99 \ --apply-immediately ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "eu-central-1b", "eu-central-1c", "eu-central-1a" ], "BackupRetentionPeriod": 14, "DatabaseName": "", "DBClusterIdentifier": "cluster-2", "DBClusterParameterGroup": "default.aurora5.6", "DBSubnetGroup": "default-vpc-2305ca49", "Status": "available", "EarliestRestorableTime": "2020-06-03T02:07:29.637Z", "Endpoint": "cluster-2.cluster-############.eu-central-1.rds.amazonaws.com", "ReaderEndpoint": "cluster-2.cluster-ro-############.eu-central-1.rds.amazonaws.com", "MultiAZ": false, "Engine": "aurora", "EngineVersion": "5.6.10a", "LatestRestorableTime": "2020-06-04T15:11:25.748Z", "Port": 3306, "MasterUsername": "admin", "PreferredBackupWindow": "01:55-02:25", "PreferredMaintenanceWindow": "thu:21:14-thu:21:44", "ReadReplicaIdentifiers": [], "DBClusterMembers": [ { "DBInstanceIdentifier": "cluster-2-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-20a5c047", "Status": "active" } ], "HostedZoneId": "Z1RLNU0EXAMPLE", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:eu-central-1:123456789012:key/d1bd7c8f-5cdb-49ca-8a62-a1b2c3d4e5f6", "DbClusterResourceId": "cluster-AGJ7XI77XVIS6FUXHU1EXAMPLE", "DBClusterArn": "arn:aws:rds:eu-central-1:123456789012:cluster:cluster-2", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2020-04-03T14:44:02.764Z", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": true, "CrossAccountClone": false, "DomainMemberships": [] } } ``` Weitere Informationen finden Sie unter [Ändern eines DB-Clusters in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Modifying.html) im *Benutzerhandbuch für Amazon Aurora*. **Beispiel 2: So ordnen Sie eine VPC-Sicherheitsgruppe einem DB-Cluster zu** Im folgenden `modify-db-instance`-Beispiel werden eine bestimmte VPC-Sicherheitsgruppe zugeordnet und DB-Sicherheitsgruppen aus einem DB-Cluster entfernt: ``` aws rds modify-db-cluster \ --db-cluster-identifier dbName \ --vpc-security-group-ids sg-ID ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "us-west-2c", "us-west-2b", "us-west-2a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "dbName", "DBClusterParameterGroup": "default.aurora-mysql8.0", "DBSubnetGroup": "default", "Status": "available", "EarliestRestorableTime": "2024-02-15T01:12:13.966000+00:00", "Endpoint": "dbName.cluster-abcdefghji.us-west-2.rds.amazonaws.com", "ReaderEndpoint": "dbName.cluster-ro-abcdefghji.us-west-2.rds.amazonaws.com", "MultiAZ": false, "Engine": "aurora-mysql", "EngineVersion": "8.0.mysql_aurora.3.04.1", "LatestRestorableTime": "2024-02-15T02:25:33.696000+00:00", "Port": 3306, "MasterUsername": "admin", "PreferredBackupWindow": "10:59-11:29", "PreferredMaintenanceWindow": "thu:08:54-thu:09:24", "ReadReplicaIdentifiers": [], "DBClusterMembers": [ { "DBInstanceIdentifier": "dbName-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-ID", "Status": "active" } ], ...output omitted... } } ``` Weitere Informationen finden Sie unter [Zugriffskontrolle mit Sicherheitsgruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Overview.RDSSecurityGroups.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-instance` Das folgende Codebeispiel zeigt die Verwendung`modify-db-instance`. **AWS CLI** **Beispiel 1: So ändern Sie eine DB-Instance** Im folgenden Beispiel für `modify-db-instance` wird eine Options- und Parametergruppe mit einer kompatiblen DB-Instance von Microsoft SQL Server verknüpft. Der Parameter `--apply-immediately` bewirkt, dass die Options- und Parametergruppen sofort verknüpft werden, anstatt auf das nächste Wartungsfenster zu warten. ``` aws rds modify-db-instance \ --db-instance-identifier database-2 \ --option-group-name test-se-2017 \ --db-parameter-group-name test-sqlserver-se-2017 \ --apply-immediately ``` Ausgabe: ``` { "DBInstance": { "DBInstanceIdentifier": "database-2", "DBInstanceClass": "db.r4.large", "Engine": "sqlserver-se", "DBInstanceStatus": "available", ...output omitted... "DBParameterGroups": [ { "DBParameterGroupName": "test-sqlserver-se-2017", "ParameterApplyStatus": "applying" } ], "AvailabilityZone": "us-west-2d", ...output omitted... "MultiAZ": true, "EngineVersion": "14.00.3281.6.v1", "AutoMinorVersionUpgrade": false, "ReadReplicaDBInstanceIdentifiers": [], "LicenseModel": "license-included", "OptionGroupMemberships": [ { "OptionGroupName": "test-se-2017", "Status": "pending-apply" } ], "CharacterSetName": "SQL_Latin1_General_CP1_CI_AS", "SecondaryAvailabilityZone": "us-west-2c", "PubliclyAccessible": true, "StorageType": "gp2", ...output omitted... "DeletionProtection": false, "AssociatedRoles": [], "MaxAllocatedStorage": 1000 } } ``` Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html) im *Benutzerhandbuch für Amazon RDS*. **Beispiel 2: So verknüpfen Sie eine VPC-Sicherheitsgruppe mit einer DB-Instance** Im folgenden Beispiel für `modify-db-instance` werden eine bestimmte VPC-Sicherheitsgruppe zugeordnet und DB-Sicherheitsgruppen aus einer DB-Instance entfernt: ``` aws rds modify-db-instance \ --db-instance-identifier dbName \ --vpc-security-group-ids sg-ID ``` Ausgabe: ``` { "DBInstance": { "DBInstanceIdentifier": "dbName", "DBInstanceClass": "db.t3.micro", "Engine": "mysql", "DBInstanceStatus": "available", "MasterUsername": "admin", "Endpoint": { "Address": "dbName.abcdefghijk.us-west-2.rds.amazonaws.com", "Port": 3306, "HostedZoneId": "ABCDEFGHIJK1234" }, "AllocatedStorage": 20, "InstanceCreateTime": "2024-02-15T00:37:58.793000+00:00", "PreferredBackupWindow": "11:57-12:27", "BackupRetentionPeriod": 7, "DBSecurityGroups": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-ID", "Status": "active" } ], ... output omitted ... "MultiAZ": false, "EngineVersion": "8.0.35", "AutoMinorVersionUpgrade": true, "ReadReplicaDBInstanceIdentifiers": [], "LicenseModel": "general-public-license", ... output omitted ... } } ``` Weitere Informationen finden Sie unter [Zugriffskontrolle mit Sicherheitsgruppen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.RDSSecurityGroups.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [Ändern DBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-instance.html) in der *AWS CLI Befehlsreferenz*. ### `modify-db-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`modify-db-parameter-group`. **AWS CLI** **Um eine DB-Parametergruppe zu ändern** Im folgenden Beispiel für `modify-db-parameter-group` wird der Wert des Parameters `clr enabled` in einer DB-Parametergruppe geändert. Der Parameter `--apply-immediately` bewirkt, dass die DB-Parametergruppe sofort geändert wird, anstatt auf das nächste Wartungsfenster zu warten. ``` aws rds modify-db-parameter-group \ --db-parameter-group-name test-sqlserver-se-2017 \ --parameters "ParameterName='clr enabled',ParameterValue=1,ApplyMethod=immediate" ``` Ausgabe: ``` { "DBParameterGroupName": "test-sqlserver-se-2017" } ``` Weitere Informationen finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.Modifying) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [DBParameterGruppe ändern](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-parameter-group.html) in der *AWS CLI Befehlsreferenz*. ### `modify-db-proxy-endpoint` Das folgende Codebeispiel zeigt die Verwendung`modify-db-proxy-endpoint`. **AWS CLI** **So ändern Sie einen DB-Proxy-Endpunkt für eine RDS-Datenbank** Im folgenden Beispiel für `modify-db-proxy-endpoint` wird ein DB-Proxy-Endpunkt `proxyEndpoint` dahingehend geändert, dass das Lese-Timeout auf 65 Sekunden festgelegt wird. ``` aws rds modify-db-proxy-endpoint \ --db-proxy-endpoint-name proxyEndpoint \ --cli-read-timeout 65 ``` Ausgabe: ``` { "DBProxyEndpoint": { "DBProxyEndpointName": "proxyEndpoint", "DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab", "DBProxyName": "proxyExample", "Status": "available", "VpcId": "vpc-1234567", "VpcSecurityGroupIds": [ "sg-1234" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Endpoint": "proxyEndpoint.endpoint.proxyExample-ab0cd1efghij.us-east-1.rds.amazonaws.com", "CreatedDate": "2023-04-05T16:09:33.452000+00:00", "TargetRole": "READ_WRITE", "IsDefault": "false" } } ``` Weitere Informationen finden Sie unter [Ändern eines Proxy-Endpunkts](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.ModifyingEndpoint) im *Benutzerhandbuch für Amazon RDS* und [Ändern eines Proxy-Endpunkts](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.ModifyingEndpoint) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyDbProxyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-proxy-endpoint.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-proxy-target-group` Das folgende Codebeispiel zeigt die Verwendung`modify-db-proxy-target-group`. **AWS CLI** **So ändern Sie einen DB-Proxy-Endpunkt** Im folgenden Beispiel für `modify-db-proxy-target-group` wird eine DB-Proxy-Zielgruppe dahingehend geändert, dass die maximale Anzahl an Verbindungen auf 80 Prozent, und die maximale Anzahl inaktiver Verbindungen auf 10 Prozent festgelegt wird. ``` aws rds modify-db-proxy-target-group \ --target-group-name default \ --db-proxy-name proxyExample \ --connection-pool-config MaxConnectionsPercent=80,MaxIdleConnectionsPercent=10 ``` Ausgabe: ``` { "DBProxyTargetGroup": { "DBProxyName": "proxyExample", "TargetGroupName": "default", "TargetGroupArn": "arn:aws:rds:us-east-1:123456789012:target-group:prx-tg-0123a01b12345c0ab", "IsDefault": true, "Status": "available", "ConnectionPoolConfig": { "MaxConnectionsPercent": 80, "MaxIdleConnectionsPercent": 10, "ConnectionBorrowTimeout": 120, "SessionPinningFilters": [] }, "CreatedDate": "2023-05-02T18:41:19.495000+00:00", "UpdatedDate": "2023-05-02T18:41:21.762000+00:00" } } ``` Weitere Informationen finden Sie unter [Ändern eines RDS-Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) im *Benutzerhandbuch für Amazon RDS* und [Ändern eines RDS-Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyDbProxyTargetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-proxy-target-group.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-proxy` Das folgende Codebeispiel zeigt die Verwendung`modify-db-proxy`. **AWS CLI** **So ändern Sie einen DB-Proxy für eine RDS-Datenbank** Im folgenden Beispiel für `modify-db-proxy` wird ein DB-Proxy namens `proxyExample` so geändert, dass er SSL für seine Verbindungen benötigt. ``` aws rds modify-db-proxy \ --db-proxy-name proxyExample \ --require-tls ``` Ausgabe: ``` { "DBProxy": { "DBProxyName": "proxyExample", "DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab", "Status": "modifying" "EngineFamily": "PostgreSQL", "VpcId": "sg-1234567", "VpcSecurityGroupIds": [ "sg-1234" ], "VpcSubnetIds": [ "subnetgroup1", "subnetgroup2" ], "Auth": "[ { "Description": "proxydescription1", "AuthScheme": "SECRETS", "SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:proxysecret1-Abcd1e", "IAMAuth": "DISABLED" } ]", "RoleArn": "arn:aws:iam::12345678912:role/ProxyPostgreSQLRole", "Endpoint": "proxyExample.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com", "RequireTLS": true, "IdleClientTimeout": 1800, "DebuggingLogging": false, "CreatedDate": "2023-04-05T16:09:33.452000+00:00", "UpdatedDate": "2023-04-13T01:49:38.568000+00:00" } } ``` Weitere Informationen finden Sie unter [Ändern eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) im *Benutzerhandbuch für Amazon RDS* und [Erstellen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyDbProxy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-proxy.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-shard-group` Das folgende Codebeispiel zeigt die Verwendung`modify-db-shard-group`. **AWS CLI** **Beispiel 1: So ändern Sie eine DB-Shard-Gruppe** Im folgenden Beispiel für `modify-db-shard-group` wird die maximale Kapazität einer DB-Shard-Gruppe geändert. ``` aws rds modify-db-shard-group \ --db-shard-group-identifier my-db-shard-group \ --max-acu 1000 ``` Ausgabe: ``` { "DBShardGroups": [ { "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890", "DBShardGroupIdentifier": "my-db-shard-group", "DBClusterIdentifier": "my-sv2-cluster", "MaxACU": 768.0, "ComputeRedundancy": 0, "Status": "available", "PubliclyAccessible": false, "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" } ] } ``` Weitere Informationen finden Sie unter [DB-Cluster in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) im *Benutzerhandbuch für Amazon Aurora*. **Beispiel 2: Um Ihre DB-Shard-Gruppen zu beschreiben** Im folgenden `describe-db-shard-groups` Beispiel werden die Details Ihrer DB-Shard-Gruppen abgerufen, nachdem Sie den Befehl ausgeführt haben. `modify-db-shard-group` Die maximale Kapazität der DB-Shard-Gruppe `my-db-shard-group` beträgt jetzt 1000 Aurora-Kapazitätseinheiten (ACUs). ``` aws rds describe-db-shard-groups ``` Ausgabe: ``` { "DBShardGroups": [ { "DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example", "DBShardGroupIdentifier": "limitless-test-shard-grp", "DBClusterIdentifier": "limitless-test-cluster", "MaxACU": 768.0, "ComputeRedundancy": 0, "Status": "available", "PubliclyAccessible": true, "Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" }, { "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890", "DBShardGroupIdentifier": "my-db-shard-group", "DBClusterIdentifier": "my-sv2-cluster", "MaxACU": 1000.0, "ComputeRedundancy": 0, "Status": "available", "PubliclyAccessible": false, "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" } ] } ``` Weitere Informationen finden Sie unter [DB-Cluster in Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-shard-group.html)in der *AWS CLI Befehlsreferenz.* ### `modify-db-snapshot-attribute` Das folgende Codebeispiel zeigt die Verwendung`modify-db-snapshot-attribute`. **AWS CLI** **Beispiel 1: Um zwei AWS Konten die Wiederherstellung eines DB-Snapshots zu ermöglichen** Im folgenden `modify-db-snapshot-attribute` Beispiel wird zwei AWS Konten mit den Kennungen `111122223333` und die Erlaubnis erteilt`444455556666`, den DB-Snapshot mit dem Namen `mydbsnapshot` wiederherzustellen. ``` aws rds modify-db-snapshot-attribute \ --db-snapshot-identifier mydbsnapshot \ --attribute-name restore \ --values-to-add {"111122223333","444455556666"} ``` Ausgabe: ``` { "DBSnapshotAttributesResult": { "DBSnapshotIdentifier": "mydbsnapshot", "DBSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "111122223333", "444455556666" ] } ] } } ``` Weitere Informationen finden Sie unter [Freigeben eines Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html#USER_ShareSnapshot.Sharing) im *Benutzerhandbuch für Amazon RDS*. **Beispiel 2: Um zu verhindern, dass ein AWS Konto einen DB-Snapshot wiederherstellt** Im folgenden `modify-db-snapshot-attribute` Beispiel wird einem bestimmten AWS Konto die Erlaubnis entzogen, den genannten DB-Snapshot wiederherzustellen`mydbsnapshot`. Wenn dabei ein einzelnes Konto angegeben wird, darf die Konto-ID nicht von Anführungszeichen oder geschweiften Klammern umgeben sein. ``` aws rds modify-db-snapshot-attribute \ --db-snapshot-identifier mydbsnapshot \ --attribute-name restore \ --values-to-remove 444455556666 ``` Ausgabe: ``` { "DBSnapshotAttributesResult": { "DBSnapshotIdentifier": "mydbsnapshot", "DBSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "111122223333" ] } ] } } ``` Weitere Informationen finden Sie unter [Freigeben eines Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html#USER_ShareSnapshot.Sharing) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [ModifyDbSnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-snapshot-attribute.html)unter *AWS CLI Befehlsreferenz*. ### `modify-db-snapshot-attributes` Das folgende Codebeispiel zeigt die Verwendung`modify-db-snapshot-attributes`. **AWS CLI** **So ändern Sie ein DB-Snapshot-Attribut** Im folgenden `modify-db-snapshot-attribute` Beispiel können zwei AWS Kontokennungen, `111122223333` und`444455556666`, den genannten `mydbsnapshot` DB-Snapshot wiederherstellen. ``` aws rds modify-db-snapshot-attribute \ --db-snapshot-identifier mydbsnapshot \ --attribute-name restore \ --values-to-add '["111122223333","444455556666"]' ``` Ausgabe: ``` { "DBSnapshotAttributesResult": { "DBSnapshotIdentifier": "mydbsnapshot", "DBSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "111122223333", "444455556666" ] } ] } } ``` Weitere Informationen finden Sie unter [Freigeben eines Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html#USER_ShareSnapshot.Sharing) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [ModifyDbSnapshotAttributes AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-snapshot-attributes.html)*Befehlsreferenz.* ### `modify-db-snapshot` Das folgende Codebeispiel zeigt die Verwendung`modify-db-snapshot`. **AWS CLI** **So ändern Sie einen DB-Snapshot** Im folgenden Beispiel für `modify-db-snapshot` wird ein PostgeSQL 10.6-Snapshot mit dem Namen `db5-snapshot-upg-test` auf PostgreSQL 11.7 aktualisiert. **Die neue DB-Engine-Version wird angezeigt, nachdem das Upgrade des Snapshots abgeschlossen wurde und sein Status verfügbar ist.** ``` aws rds modify-db-snapshot \ --db-snapshot-identifier db5-snapshot-upg-test \ --engine-version 11.7 ``` Ausgabe: ``` { "DBSnapshot": { "DBSnapshotIdentifier": "db5-snapshot-upg-test", "DBInstanceIdentifier": "database-5", "SnapshotCreateTime": "2020-03-27T20:49:17.092Z", "Engine": "postgres", "AllocatedStorage": 20, "Status": "upgrading", "Port": 5432, "AvailabilityZone": "us-west-2a", "VpcId": "vpc-2ff27557", "InstanceCreateTime": "2020-03-27T19:59:04.735Z", "MasterUsername": "postgres", "EngineVersion": "10.6", "LicenseModel": "postgresql-license", "SnapshotType": "manual", "OptionGroupName": "default:postgres-11", "PercentProgress": 100, "StorageType": "gp2", "Encrypted": false, "DBSnapshotArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-upg-test", "IAMDatabaseAuthenticationEnabled": false, "ProcessorFeatures": [], "DbiResourceId": "db-GJMF75LM42IL6BTFRE4UZJ5YM4" } } ``` Weitere Informationen finden Sie unter [Freigeben eines PostgreSQL-DB-Snapshots](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBSnapshot.PostgreSQL.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [ModifyDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `modify-db-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`modify-db-subnet-group`. **AWS CLI** **So ändern Sie eine DB-Subnetzgruppe** Im folgenden Beispiel für `modify-db-subnet-group` wird der DB-Subnetzgruppe namens `mysubnetgroup` ein Subnetz mit der ID `subnet-08e41f9e230222222` hinzugefügt. Um die vorhandenen Subnetze in der Subnetzgruppe beizubehalten, fügen Sie deren IDs AS-Werte in die `--subnet-ids` Option ein. Stellen Sie sicher, dass Subnetze mit mindestens zwei verschiedenen Verfügbarkeitszonen in der DB-Subnetzgruppe vorhanden sind. ``` aws rds modify-db-subnet-group \ --db-subnet-group-name mysubnetgroup \ --subnet-ids '["subnet-0a1dc4e1a6f123456","subnet-070dd7ecb3aaaaaaa","subnet-00f5b198bc0abcdef","subnet-08e41f9e230222222"]' ``` Ausgabe: ``` { "DBSubnetGroup": { "DBSubnetGroupName": "mysubnetgroup", "DBSubnetGroupDescription": "test DB subnet group", "VpcId": "vpc-0f08e7610a1b2c3d4", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-08e41f9e230222222", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-070dd7ecb3aaaaaaa", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-00f5b198bc0abcdef", "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-0a1dc4e1a6f123456", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ], "DBSubnetGroupArn": "arn:aws:rds:us-west-2:534026745191:subgrp:mysubnetgroup" } } ``` Weitere Informationen finden Sie unter [Schritt 3: Erstellen einer DB-Subnetzgruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.CreateDBSubnetGroup) im *Entwicklerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [ModifyDbSubnetGroup AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-subnet-group.html)*Befehlsreferenz*. ### `modify-event-subscription` Das folgende Codebeispiel zeigt die Verwendung`modify-event-subscription`. **AWS CLI** **So ändern Sie ein Ereignisabonnement** Im folgenden Beispiel für `modify-event-subscription` wird das angegebene Ereignisabonnement deaktiviert, sodass es keine Benachrichtigungen mehr zum angegebenen Amazon Simple Notification Service-Thema veröffentlicht. ``` aws rds modify-event-subscription \ --subscription-name my-instance-events \ --no-enabled ``` Ausgabe: ``` { "EventSubscription": { "EventCategoriesList": [ "backup", "recovery" ], "CustomerAwsId": "123456789012", "SourceType": "db-instance", "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", "CustSubscriptionId": "my-instance-events", "Status": "modifying", "Enabled": false } } ``` + Einzelheiten zur API finden Sie [ModifyEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-event-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `modify-global-cluster` Das folgende Codebeispiel zeigt die Verwendung`modify-global-cluster`. **AWS CLI** **So ändern Sie einen globalen DB-Cluster** Im folgende Beispiel für `modify-global-cluster` wird der Löschschutz für einen Aurora MySQL-kompatiblen globalen DB-Cluster aktiviert. ``` aws rds modify-global-cluster \ --global-cluster-identifier myglobalcluster \ --deletion-protection ``` Ausgabe: ``` { "GlobalCluster": { "GlobalClusterIdentifier": "myglobalcluster", "GlobalClusterResourceId": "cluster-f0e523bfe07aabb", "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster", "Status": "available", "Engine": "aurora-mysql", "EngineVersion": "5.7.mysql_aurora.2.07.2", "StorageEncrypted": false, "DeletionProtection": true, "GlobalClusterMembers": [] } } ``` Weitere Informationen finden Sie unter [Verwalten einer globalen Aurora-Datenbank](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ModifyGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-global-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `promote-read-replica-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`promote-read-replica-db-cluster`. **AWS CLI** **So stufen Sie ein Lesereplikat eines DB-Clusters hoch** Im folgenden Beispiel für `promote-read-replica-db-cluster` wird die angegebene Read Replica zu einem eigenständigen DB-Cluster hochgestuft. ``` aws rds promote-read-replica-db-cluster \ --db-cluster-identifier mydbcluster-1 ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c" ], "BackupRetentionPeriod": 1, "DatabaseName": "", "DBClusterIdentifier": "mydbcluster-1", ...some output truncated... } } ``` Weitere Informationen finden Sie unter [Hochstufen eines Lesereplikats zum DB-Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Replication.CrossRegion.html#AuroraMySQL.Replication.CrossRegion.Promote) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [PromoteReadReplicaDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/promote-read-replica-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `promote-read-replica` Das folgende Codebeispiel zeigt die Verwendung`promote-read-replica`. **AWS CLI** **So stufen Sie eine Read Replica hoch** Im folgenden Beispiel für `promote-read-replica` wird die angegebene Read Replica zu einer eigenständigen DB-Instance hochgestuft. ``` aws rds promote-read-replica \ --db-instance-identifier test-instance-repl ``` Ausgabe: ``` { "DBInstance": { "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl", "StorageType": "standard", "ReadReplicaSourceDBInstanceIdentifier": "test-instance", "DBInstanceStatus": "modifying", ...some output truncated... } } ``` + Einzelheiten zur API finden Sie [PromoteReadReplica](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/promote-read-replica.html)in der *AWS CLI Befehlsreferenz*. ### `purchase-reserved-db-instance` Das folgende Codebeispiel zeigt die Verwendung`purchase-reserved-db-instance`. **AWS CLI** **So kaufen Sie ein Angebot für eine Reserved-DB-Instance** Im folgenden Beispiel für `purchase-reserved-db-instances-offering` wird ein reserviertes DB-Instance-Angebot erworben. Die `reserved-db-instances-offering-id` muss eine gültige Angebots-ID sein, wie sie vom `describe-reserved-db-instances-offering`-Befehl zurückgegeben wird. aws rds purchase-reserved-db-instances -offering -- ID reserved-db-instances-offering 438012d3-4a52-4cc7-b2e3-8dff72e0e706 + Einzelheiten zur API finden [PurchaseReservedDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/purchase-reserved-db-instance.html)Sie *AWS CLI in der Befehlsreferenz.* ### `purchase-reserved-db-instances-offerings` Das folgende Codebeispiel zeigt die Verwendung`purchase-reserved-db-instances-offerings`. **AWS CLI** **Beispiel 1: So finden Sie eine reservierte DB-Instance zum Kauf** Das folgende `describe-reserved-db-instances-offerings`-Beispiel listet die verfügbaren reservierten MySQL-DB-Instances mit der Instance-Klasse db.t2.micro und einer Dauer von einem Jahr auf. Die Angebots-ID ist für den Kauf einer reservierten DB-Instance erforderlich. ``` aws rds describe-reserved-db-instances-offerings \ --product-description mysql \ --db-instance-class db.t2.micro \ --duration 1 ``` Ausgabe: ``` { "ReservedDBInstancesOfferings": [ { "ReservedDBInstancesOfferingId": "8ba30be1-b9ec-447f-8f23-6114e3f4c7b4", "DBInstanceClass": "db.t2.micro", "Duration": 31536000, "FixedPrice": 51.0, "UsagePrice": 0.0, "CurrencyCode": "USD", "ProductDescription": "mysql", "OfferingType": "Partial Upfront", "MultiAZ": false, "RecurringCharges": [ { "RecurringChargeAmount": 0.006, "RecurringChargeFrequency": "Hourly" } ] }, ... some output truncated ... ] } ``` Weitere Informationen finden Sie unter [Reservierte Instances für Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithReservedDBInstances.html) im *Benutzerhandbuch für Amazon RDS*. **Beispiel 2: So kaufen Sie eine reservierte DB-Instance** Das folgende `purchase-reserved-db-instances-offering`-Beispiel zeigt, wie Sie das reservierte DB-Instance-Angebot aus dem vorherigen Beispiel kaufen können. aws rds purchase-reserved-db-instances -offering -- ID reserved-db-instances-offering 8ba30be1-b9ec-447f-8f23-6114e3f4c7b4 Ausgabe: ``` { "ReservedDBInstance": { "ReservedDBInstanceId": "ri-2020-06-29-16-54-57-670", "ReservedDBInstancesOfferingId": "8ba30be1-b9ec-447f-8f23-6114e3f4c7b4", "DBInstanceClass": "db.t2.micro", "StartTime": "2020-06-29T16:54:57.670Z", "Duration": 31536000, "FixedPrice": 51.0, "UsagePrice": 0.0, "CurrencyCode": "USD", "DBInstanceCount": 1, "ProductDescription": "mysql", "OfferingType": "Partial Upfront", "MultiAZ": false, "State": "payment-pending", "RecurringCharges": [ { "RecurringChargeAmount": 0.006, "RecurringChargeFrequency": "Hourly" } ], "ReservedDBInstanceArn": "arn:aws:rds:us-west-2:123456789012:ri:ri-2020-06-29-16-54-57-670" } } ``` Weitere Informationen finden Sie unter [Reservierte Instances für Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithReservedDBInstances.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden [PurchaseReservedDbInstancesOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/purchase-reserved-db-instances-offerings.html)Sie *AWS CLI in der Befehlsreferenz.* ### `reboot-db-instance` Das folgende Codebeispiel zeigt die Verwendung`reboot-db-instance`. **AWS CLI** **So starten Sie eine DB-Instance neu** Im folgenden Beispiel für `reboot-db-instance` wird die angegebene DB-Instance neu gestartet. ``` aws rds reboot-db-instance \ --db-instance-identifier test-mysql-instance ``` Ausgabe: ``` { "DBInstance": { "DBInstanceIdentifier": "test-mysql-instance", "DBInstanceClass": "db.t3.micro", "Engine": "mysql", "DBInstanceStatus": "rebooting", "MasterUsername": "admin", "Endpoint": { "Address": "test-mysql-instance.############.us-west-2.rds.amazonaws.com", "Port": 3306, "HostedZoneId": "Z1PVIF0EXAMPLE" }, ... output omitted... } } ``` Weitere Informationen finden Sie unter [Neustarten einer DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [Reboot DBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reboot-db-instance.html) in der *AWS CLI Befehlsreferenz*. ### `reboot-db-shard-group` Das folgende Codebeispiel zeigt die Verwendung`reboot-db-shard-group`. **AWS CLI** **Beispiel 1: So starten Sie eine DB-Shard-Gruppe neu** Im folgenden Beispiel für `reboot-db-shard-group` wird eine DB-Shard-Gruppe neu gestartet. ``` aws rds reboot-db-shard-group \ --db-shard-group-identifier my-db-shard-group ``` Ausgabe: ``` { "DBShardGroups": [ { "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890", "DBShardGroupIdentifier": "my-db-shard-group", "DBClusterIdentifier": "my-sv2-cluster", "MaxACU": 1000.0, "ComputeRedundancy": 0, "Status": "available", "PubliclyAccessible": false, "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" } ] } ``` Weitere Informationen finden Sie unter [Neustarten eines Amazon-Aurora-DB-Clusters oder einer Amazon-Aurora-DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RebootCluster.html) im *Benutzerhandbuch für Amazon Aurora*. **Beispiel 2: Um Ihre DB-Shard-Gruppen zu beschreiben** Im folgenden `describe-db-shard-groups` Beispiel werden die Details Ihrer DB-Shard-Gruppen abgerufen, nachdem Sie den Befehl ausgeführt haben. `reboot-db-shard-group` Die DB-Shard-Gruppe `my-db-shard-group` wird jetzt neu gestartet. ``` aws rds describe-db-shard-groups ``` Ausgabe: ``` { "DBShardGroups": [ { "DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example", "DBShardGroupIdentifier": "limitless-test-shard-grp", "DBClusterIdentifier": "limitless-test-cluster", "MaxACU": 768.0, "ComputeRedundancy": 0, "Status": "available", "PubliclyAccessible": true, "Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" }, { "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890", "DBShardGroupIdentifier": "my-db-shard-group", "DBClusterIdentifier": "my-sv2-cluster", "MaxACU": 1000.0, "ComputeRedundancy": 0, "Status": "rebooting", "PubliclyAccessible": false, "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com" } ] } ``` Weitere Informationen finden Sie unter [Neustarten eines Amazon-Aurora-DB-Clusters oder einer Amazon-Aurora-DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RebootCluster.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [RebootDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reboot-db-shard-group.html)in der *AWS CLI Befehlsreferenz*. ### `register-db-proxy-targets` Das folgende Codebeispiel zeigt die Verwendung`register-db-proxy-targets`. **AWS CLI** **So registrieren Sie einen DB-Proxy bei einer Datenbank** Das folgende `register-db-proxy-targets`-Beispiel erstellt die Zuordnung zwischen einer Datenbank und einem Proxy. ``` aws rds register-db-proxy-targets \ --db-proxy-name proxyExample \ --db-cluster-identifiers database-5 ``` Ausgabe: ``` { "DBProxyTargets": [ { "RdsResourceId": "database-5", "Port": 3306, "Type": "TRACKED_CLUSTER", "TargetHealth": { "State": "REGISTERING" } }, { "Endpoint": "database-5instance-1.ab0cd1efghij.us-east-1.rds.amazonaws.com", "RdsResourceId": "database-5", "Port": 3306, "Type": "RDS_INSTANCE", "TargetHealth": { "State": "REGISTERING" } } ] } ``` Weitere Informationen finden Sie unter [Erstellen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-creating) im *Benutzerhandbuch für Amazon RDS* und [Erstellen eines RDS-Proxys](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-creating) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [RegisterDbProxyTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/register-db-proxy-targets.html)in der *AWS CLI Befehlsreferenz*. ### `remove-from-global-cluster` Das folgende Codebeispiel zeigt die Verwendung`remove-from-global-cluster`. **AWS CLI** **So trennen Sie ein sekundäres Aurora-Cluster von einem globalen Aurora-Datenbank-Cluster** Im folgenden Beispiel für `remove-from-global-cluster` wird ein sekundärer Aurora-Cluster von einem globalen Aurora-Datenbank-Cluster getrennt. Der Cluster wechselt von einem schreibgeschützten zu einem eigenständigen Cluster mit Lese- und Schreibfunktion. ``` aws rds remove-from-global-cluster \ --region us-west-2 \ --global-cluster-identifier myglobalcluster \ --db-cluster-identifier arn:aws:rds:us-west-2:123456789012:cluster:DB-1 ``` Ausgabe: ``` { "GlobalCluster": { "GlobalClusterIdentifier": "myglobalcluster", "GlobalClusterResourceId": "cluster-abc123def456gh", "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster", "Status": "available", "Engine": "aurora-postgresql", "EngineVersion": "10.11", "StorageEncrypted": true, "DeletionProtection": false, "GlobalClusterMembers": [ { "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:js-global-cluster", "Readers": [ "arn:aws:rds:us-west-2:123456789012:cluster:DB-1" ], "IsWriter": true }, { "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:DB-1", "Readers": [], "IsWriter": false, "GlobalWriteForwardingStatus": "disabled" } ] } } ``` Weitere Informationen finden Sie unter [Entfernen eines Clusters aus einer Amazon Aurora Global Database](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html#aurora-global-database-detaching) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [RemoveFromGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-from-global-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `remove-option-from-option-group` Das folgende Codebeispiel zeigt die Verwendung`remove-option-from-option-group`. **AWS CLI** **So löschen Sie eine Option aus einer Optionsgruppe** Im folgenden Beispiel für `remove-option-from-option-group` wird die Option `OEM` aus `myoptiongroup` entfernt. ``` aws rds remove-option-from-option-group \ --option-group-name myoptiongroup \ --options OEM \ --apply-immediately ``` Ausgabe: ``` { "OptionGroup": { "OptionGroupName": "myoptiongroup", "OptionGroupDescription": "Test", "EngineName": "oracle-ee", "MajorEngineVersion": "19", "Options": [], "AllowsVpcAndNonVpcInstanceMemberships": true, "OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:myoptiongroup" } } ``` Weitere Informationen finden Sie unter [Entfernen einer Option von einer Optionsgruppe](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.RemoveOption) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [RemoveOptionFromOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-option-from-option-group.html)in der *AWS CLI Befehlsreferenz*. ### `remove-role-from-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`remove-role-from-db-cluster`. **AWS CLI** **So trennen Sie die Zuordnung einer AWS Identity and Access Management (IAM) -Rolle zu einem DB-Cluster** Das folgende `remove-role-from-db-cluster`-Beispiel entfernt eine Rolle aus einem DB-Cluster. ``` aws rds remove-role-from-db-cluster \ --db-cluster-identifier mydbcluster \ --role-arn arn:aws:iam::123456789012:role/RDSLoadFromS3 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Zuweisen einer IAM-Rolle zu einem Amazon-Aurora-MySQL DB-Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.Authorizing.IAM.AddRoleToDBCluster.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie unter [RemoveRoleFromDbCluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-role-from-db-cluster.html)*Befehlsreferenz*. ### `remove-role-from-db-instance` Das folgende Codebeispiel zeigt die Verwendung`remove-role-from-db-instance`. **AWS CLI** **So trennen Sie die Zuordnung einer AWS Identity and Access Management (IAM) -Rolle zu einer DB-Instance** Im folgenden Beispiel für `remove-role-from-db-instance` wird die Rolle namens `rds-s3-integration-role` aus einer Oracle-DB-Instance namens `test-instance` entfernt. ``` aws rds remove-role-from-db-instance \ --db-instance-identifier test-instance \ --feature-name S3_INTEGRATION \ --role-arn arn:aws:iam::111122223333:role/rds-s3-integration-role ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Deaktivieren der RDS-SQL-Serverintegration mit S3](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/User.SQLServer.Options.S3-integration.html#Appendix.SQLServer.Options.S3-integration.disabling) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie unter [RemoveRoleFromDbInstance AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-role-from-db-instance.html)*Befehlsreferenz*. ### `remove-source-identifier-from-subscription` Das folgende Codebeispiel zeigt die Verwendung`remove-source-identifier-from-subscription`. **AWS CLI** **So entfernen Sie eine Quell-ID aus einem Abonnement** Im folgenden Beispiel für `remove-source-identifier` wird die angegebene Quell-ID aus einem vorhandenen Abonnement entfernt. ``` aws rds remove-source-identifier-from-subscription \ --subscription-name my-instance-events \ --source-identifier test-instance-repl ``` Ausgabe: ``` { "EventSubscription": { "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", "EventCategoriesList": [ "backup", "recovery" ], "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", "Status": "modifying", "CustSubscriptionId": "my-instance-events", "CustomerAwsId": "123456789012", "SourceIdsList": [ "test-instance" ], "SourceType": "db-instance", "Enabled": false } } ``` + Einzelheiten zur API finden Sie [RemoveSourceIdentifierFromSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-source-identifier-from-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `remove-tags-from-resource` Das folgende Codebeispiel zeigt die Verwendung`remove-tags-from-resource`. **AWS CLI** **So entfernen Sie Tags aus einer Ressource** Im folgenden Beispiel für `remove-tags-from-resource` werden Tags aus einer Ressource entfernt. ``` aws rds remove-tags-from-resource \ --resource-name arn:aws:rds:us-east-1:123456789012:db:mydbinstance \ --tag-keys Name Environment ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Markieren von Amazon-RDS-Ressourcen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) im *Benutzerhandbuch für Amazon RDS* und [Markieren von Amazon-RDS-Ressourcen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [RemoveTagsFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-tags-from-resource.html)in der *AWS CLI Befehlsreferenz*. ### `reset-db-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`reset-db-cluster-parameter-group`. **AWS CLI** **Beispiel 1: So setzen Sie alle Parameter auf ihre Standardwerte zurück** Im folgenden Beispiel für `reset-db-cluster-parameter-group` werden alle Parameterwerte in einer vom Kunden erstellten DB-Cluster-Parametergruppe auf ihre Standardwerte zurückgesetzt. ``` aws rds reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclpg \ --reset-all-parameters ``` Ausgabe: ``` { "DBClusterParameterGroupName": "mydbclpg" } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon Aurora*. **Beispiel 2: So setzen Sie angegebene Parameter auf ihre Standardwerte zurück** Im folgenden Beispiel für `reset-db-cluster-parameter-group` werden die Parameterwerte für bestimmte Parameter in einer benutzerdefinierten DB-Clusterparametergruppe auf ihre Standardwerte zurückgesetzt. ``` aws rds reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclpgy \ --parameters "ParameterName=max_connections,ApplyMethod=immediate" \ "ParameterName=max_allowed_packet,ApplyMethod=immediate" ``` Ausgabe: ``` { "DBClusterParameterGroupName": "mydbclpg" } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen und DB-Clusterparametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ResetDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reset-db-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `reset-db-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`reset-db-parameter-group`. **AWS CLI** **Beispiel 1: So setzen Sie alle Parameter auf ihre Standardwerte zurück** Im folgenden Beispiel für `reset-db-parameter-group` werden alle Parameterwerte in einer vom Kunden erstellten DB-Parametergruppe auf ihre Standardwerte zurückgesetzt. ``` aws rds reset-db-parameter-group \ --db-parameter-group-name mypg \ --reset-all-parameters ``` Ausgabe: ``` { "DBParameterGroupName": "mypg" } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon RDS* und [Arbeiten mit DB-Parametergruppen und DB-Cluster-Parametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon Aurora*. **Beispiel 2: So setzen Sie angegebene Parameter auf ihre Standardwerte zurück** Im folgenden Beispiel für `reset-db-parameter-group` werden die Parameterwerte bestimmter Parameter in einer vom Kunden erstellten DB-Parametergruppe auf ihre Standardwerte zurückgesetzt. ``` aws rds reset-db-parameter-group \ --db-parameter-group-name mypg \ --parameters "ParameterName=max_connections,ApplyMethod=immediate" \ "ParameterName=max_allowed_packet,ApplyMethod=immediate" ``` Ausgabe: ``` { "DBParameterGroupName": "mypg" } ``` Weitere Informationen finden Sie unter [Arbeiten mit DB-Parametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon RDS* und [Arbeiten mit DB-Parametergruppen und DB-Cluster-Parametergruppen](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ResetDbParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reset-db-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `restore-db-cluster-from-s3` Das folgende Codebeispiel zeigt die Verwendung`restore-db-cluster-from-s3`. **AWS CLI** **So stellen Sie ein DB-Cluster von Amazon Aurora aus Amazon S3 wieder her** Im folgenden Beispiel für `restore-db-cluster-from-s3` wird ein Amazon Aurora MySQL Version 5.7-kompatibles DB-Cluster aus einer MySQL 5.7-DB-Backup-Datei in Amazon S3 wiederhergestellt. ``` aws rds restore-db-cluster-from-s3 \ --db-cluster-identifier cluster-s3-restore \ --engine aurora-mysql \ --master-username admin \ --master-user-password mypassword \ --s3-bucket-name amzn-s3-demo-bucket \ --s3-prefix test-backup \ --s3-ingestion-role-arn arn:aws:iam::123456789012:role/service-role/TestBackup \ --source-engine mysql \ --source-engine-version 5.7.28 ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "us-west-2c", "us-west-2a", "us-west-2b" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "cluster-s3-restore", "DBClusterParameterGroup": "default.aurora-mysql5.7", "DBSubnetGroup": "default", "Status": "creating", "Endpoint": "cluster-s3-restore.cluster-co3xyzabc123.us-west-2.rds.amazonaws.com", "ReaderEndpoint": "cluster-s3-restore.cluster-ro-co3xyzabc123.us-west-2.rds.amazonaws.com", "MultiAZ": false, "Engine": "aurora-mysql", "EngineVersion": "5.7.12", "Port": 3306, "MasterUsername": "admin", "PreferredBackupWindow": "11:15-11:45", "PreferredMaintenanceWindow": "thu:12:19-thu:12:49", "ReadReplicaIdentifiers": [], "DBClusterMembers": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-########", "Status": "active" } ], "HostedZoneId": "Z1PVIF0EXAMPLE", "StorageEncrypted": false, "DbClusterResourceId": "cluster-SU5THYQQHOWCXZZDGXREXAMPLE", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:cluster-s3-restore", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2020-07-27T14:22:08.095Z", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false, "DomainMemberships": [] } } ``` Weitere Informationen finden Sie unter [Migrieren von Daten aus MySQL mithilfe eines Amazon-S3-Buckets](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Migrating.ExtMySQL.html#AuroraMySQL.Migrating.ExtMySQL.S3) im *Benutzerhandbuch für Amazon Aurora*. + API-Details finden Sie unter [RestoreDbClusterFromS3](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-cluster-from-s3.html) in der *AWS CLI Befehlsreferenz*. ### `restore-db-cluster-from-snapshot` Das folgende Codebeispiel zeigt die Verwendung`restore-db-cluster-from-snapshot`. **AWS CLI** **So stellen Sie einen DB-Cluster aus einem Snapshots wieder her** Der folgende `restore-db-cluster-from-snapshot` stellt ein Aurora PostgreSQL-DB-Cluster, der mit PostgreSQL Version 10.7 kompatibel ist, aus einem DB-Cluster-Snapshot namens `test-instance-snapshot` wieder her. ``` aws rds restore-db-cluster-from-snapshot \ --db-cluster-identifier newdbcluster \ --snapshot-identifier test-instance-snapshot \ --engine aurora-postgresql \ --engine-version 10.7 ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "us-west-2c", "us-west-2a", "us-west-2b" ], "BackupRetentionPeriod": 7, "DatabaseName": "", "DBClusterIdentifier": "newdbcluster", "DBClusterParameterGroup": "default.aurora-postgresql10", "DBSubnetGroup": "default", "Status": "creating", "Endpoint": "newdbcluster.cluster-############.us-west-2.rds.amazonaws.com", "ReaderEndpoint": "newdbcluster.cluster-ro-############.us-west-2.rds.amazonaws.com", "MultiAZ": false, "Engine": "aurora-postgresql", "EngineVersion": "10.7", "Port": 5432, "MasterUsername": "postgres", "PreferredBackupWindow": "09:33-10:03", "PreferredMaintenanceWindow": "sun:12:22-sun:12:52", "ReadReplicaIdentifiers": [], "DBClusterMembers": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-########", "Status": "active" } ], "HostedZoneId": "Z1PVIF0EXAMPLE", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/287364e4-33e3-4755-a3b0-a1b2c3d4e5f6", "DbClusterResourceId": "cluster-5DSB5IFQDDUVAWOUWM1EXAMPLE", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:newdbcluster", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2020-06-05T15:06:58.634Z", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false, "DomainMemberships": [] } } ``` Weitere Informationen finden Sie unter [Wiederherstellen aus einem DB-Cluster-Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RestoreFromSnapshot.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [RestoreDbClusterFromSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-cluster-from-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `restore-db-cluster-to-point-in-time` Das folgende Codebeispiel zeigt die Verwendung`restore-db-cluster-to-point-in-time`. **AWS CLI** **So stellen Sie einen DB-Cluster zu einer bestimmten Zeit wieder her** Im folgenden Beispiel für `restore-db-cluster-to-point-in-time` wird der DB-Cluster namens `database-4` zum spätestmöglichen Zeitpunkt wiederhergestellt. Die Verwendung von `copy-on-write` als Wiederherstellungstyp stellt den neuen DB-Cluster als Klon des Quell-DB-Clusters wieder her. ``` aws rds restore-db-cluster-to-point-in-time \ --source-db-cluster-identifier database-4 \ --db-cluster-identifier sample-cluster-clone \ --restore-type copy-on-write \ --use-latest-restorable-time ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "us-west-2c", "us-west-2a", "us-west-2b" ], "BackupRetentionPeriod": 7, "DatabaseName": "", "DBClusterIdentifier": "sample-cluster-clone", "DBClusterParameterGroup": "default.aurora-postgresql10", "DBSubnetGroup": "default", "Status": "creating", "Endpoint": "sample-cluster-clone.cluster-############.us-west-2.rds.amazonaws.com", "ReaderEndpoint": "sample-cluster-clone.cluster-ro-############.us-west-2.rds.amazonaws.com", "MultiAZ": false, "Engine": "aurora-postgresql", "EngineVersion": "10.7", "Port": 5432, "MasterUsername": "postgres", "PreferredBackupWindow": "09:33-10:03", "PreferredMaintenanceWindow": "sun:12:22-sun:12:52", "ReadReplicaIdentifiers": [], "DBClusterMembers": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-########", "Status": "active" } ], "HostedZoneId": "Z1PVIF0EXAMPLE", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/287364e4-33e3-4755-a3b0-a1b2c3d4e5f6", "DbClusterResourceId": "cluster-BIZ77GDSA2XBSTNPFW1EXAMPLE", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster-clone", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "CloneGroupId": "8d19331a-099a-45a4-b4aa-11aa22bb33cc44dd", "ClusterCreateTime": "2020-03-10T19:57:38.967Z", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false } } ``` Weitere Informationen finden Sie unter [Wiederherstellen eines DB-Clusters zu einer bestimmten Zeit](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PIT.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [RestoreDbClusterToPointInTime](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-cluster-to-point-in-time.html)in der *AWS CLI Befehlsreferenz*. ### `restore-db-instance-from-db-snapshot` Das folgende Codebeispiel zeigt die Verwendung`restore-db-instance-from-db-snapshot`. **AWS CLI** **Um eine DB-Instance aus einem DB-Snapshot wiederherzustellen** Im folgenden Beispiel für `restore-db-instance-from-db-snapshot` wird eine neue DB-Instance namens `db7-new-instance` mit der DB-Instance-Klasse `db.t3.small` des angegebenen DB-Snapshots erstellt. Die Quell-DB-Instance, aus der der Snapshot abgerufen wurde, verwendet eine veraltete DB-Instance-Klasse, sodass Sie sie nicht aktualisieren können. ``` aws rds restore-db-instance-from-db-snapshot \ --db-instance-identifier db7-new-instance \ --db-snapshot-identifier db7-test-snapshot \ --db-instance-class db.t3.small ``` Ausgabe: ``` { "DBInstance": { "DBInstanceIdentifier": "db7-new-instance", "DBInstanceClass": "db.t3.small", "Engine": "mysql", "DBInstanceStatus": "creating", ...output omitted... "PreferredMaintenanceWindow": "mon:07:37-mon:08:07", "PendingModifiedValues": {}, "MultiAZ": false, "EngineVersion": "5.7.22", "AutoMinorVersionUpgrade": true, "ReadReplicaDBInstanceIdentifiers": [], "LicenseModel": "general-public-license", ...output omitted... "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:db7-new-instance", "IAMDatabaseAuthenticationEnabled": false, "PerformanceInsightsEnabled": false, "DeletionProtection": false, "AssociatedRoles": [] } } ``` Weitere Informationen finden Sie unter [Wiederherstellen aus einem DB-Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RestoreFromSnapshot.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [RestoreDbInstanceFromDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-instance-from-db-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `restore-db-instance-from-s3` Das folgende Codebeispiel zeigt die Verwendung`restore-db-instance-from-s3`. **AWS CLI** **So stellen Sie eine DB-Instance aus einem Backup in Amazon S3 wieder her** Im folgenden Beispiel für `restore-db-instance-from-s3` wird eine neue DB-Instance namens `restored-test-instance` aus einem vorhandenen Backup im `my-backups`-S3-Bucket erstellt. ``` aws rds restore-db-instance-from-s3 \ --db-instance-identifier restored-test-instance \ --allocated-storage 250 --db-instance-class db.m4.large --engine mysql \ --master-username master --master-user-password secret99 \ --s3-bucket-name my-backups --s3-ingestion-role-arn arn:aws:iam::123456789012:role/my-role \ --source-engine mysql --source-engine-version 5.6.27 ``` + API-Details finden Sie unter [RestoreDbInstanceFromS3](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-instance-from-s3.html) in der *AWS CLI Befehlsreferenz*. ### `restore-db-instance-to-point-in-time` Das folgende Codebeispiel zeigt die Verwendung`restore-db-instance-to-point-in-time`. **AWS CLI** **Beispiel 1: So stellen Sie eine DB-Instance zu einem bestimmten Zeitpunkt wieder her** Der folgende `restore-db-instance-to-point-in-time`-Befehl stellt `test-instance` auf einer neuen DB-Instance namens `restored-test-instance` zum angegebenen Zeitpunkt wieder her. ``` aws rds restore-db-instance-to-point-in-time \ --source-db-instance-identifier test-instance \ --target-db-instance restored-test-instance \ --restore-time 2018-07-30T23:45:00.000Z ``` Ausgabe: ``` { "DBInstance": { "AllocatedStorage": 20, "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:restored-test-instance", "DBInstanceStatus": "creating", "DBInstanceIdentifier": "restored-test-instance", ...some output omitted... } } ``` Weitere Informationen finden Sie unter [Wiederherstellen einer DB-Instance zu einer bestimmten Zeit](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIT.html) im *Benutzerhandbuch für Amazon RDS*. **Beispiel 2: So stellen Sie eine DB-Instance aus einem replizierten Backup zu einem bestimmten Zeitpunkt wieder her** Im folgenden Beispiel für `restore-db-instance-to-point-in-time` wird eine Oracle-DB-Instance aus einem replizierten automatisierten Backup zum angegebenen Zeitpunkt wiederhergestellt. ``` aws rds restore-db-instance-to-point-in-time \ --source-db-instance-automated-backups-arn "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example" \ --target-db-instance-identifier myorclinstance-from-replicated-backup \ --restore-time 2020-12-08T18:45:00.000Z ``` Ausgabe: ``` { "DBInstance": { "DBInstanceIdentifier": "myorclinstance-from-replicated-backup", "DBInstanceClass": "db.t3.micro", "Engine": "oracle-se2", "DBInstanceStatus": "creating", "MasterUsername": "admin", "DBName": "ORCL", "AllocatedStorage": 20, "PreferredBackupWindow": "07:45-08:15", "BackupRetentionPeriod": 14, ... some output omitted ... "DbiResourceId": "db-KGLXG75BGVIWKQT7NQ4EXAMPLE", "CACertificateIdentifier": "rds-ca-2019", "DomainMemberships": [], "CopyTagsToSnapshot": false, "MonitoringInterval": 0, "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:myorclinstance-from-replicated-backup", "IAMDatabaseAuthenticationEnabled": false, "PerformanceInsightsEnabled": false, "DeletionProtection": false, "AssociatedRoles": [], "TagList": [] } } ``` Weitere Informationen finden Sie unter [Wiederherstellung zu einem bestimmten Zeitpunkt aus einem replizierten Backup](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.PiTR) im *-Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [RestoreDbInstanceToPointInTime](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-instance-to-point-in-time.html)in der *AWS CLI Befehlsreferenz*. ### `start-activity-stream` Das folgende Codebeispiel zeigt die Verwendung`start-activity-stream`. **AWS CLI** **So starten Sie einen Datenbankaktivitäts-Stream** Das folgende `start-activity-stream` Beispiel startet einen asynchronen Aktivitätsstream zur Überwachung eines Aurora-Clusters mit dem Namen my-pg-cluster. ``` aws rds start-activity-stream \ --region us-east-1 \ --mode async \ --kms-key-id arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1 \ --resource-arn arn:aws:rds:us-east-1:1234567890123:cluster:my-pg-cluster \ --apply-immediately ``` Ausgabe: ``` { "KmsKeyId": "arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1", "KinesisStreamName": "aws-rds-das-cluster-0ABCDEFGHI1JKLM2NOPQ3R4S", "Status": "starting", "Mode": "async", "ApplyImmediately": true } ``` Weitere Informationen finden Sie unter [Starten eines Datenbankaktivitäts-Streams](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/DBActivityStreams.html#DBActivityStreams.Enabling) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie unter [StartActivityStream AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-activity-stream.html)*Befehlsreferenz.* ### `start-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`start-db-cluster`. **AWS CLI** **So starten Sie einen DB-Cluster** Im folgenden Beispiel für `start-db-cluster` werden ein DB-Cluster und seine DB-Instances gestartet. ``` aws rds start-db-cluster \ --db-cluster-identifier mydbcluster ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1a", "us-east-1e", "us-east-1b" ], "BackupRetentionPeriod": 1, "DatabaseName": "mydb", "DBClusterIdentifier": "mydbcluster", ...some output truncated... } } ``` Weitere Informationen finden Sie unter [Stoppen und Starten eines DB-Clusters von Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-cluster-stop-start.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [StartDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `start-db-instance-automated-backups-replication` Das folgende Codebeispiel zeigt die Verwendung`start-db-instance-automated-backups-replication`. **AWS CLI** **So aktivieren Sie multiregionale automatisierte Backups** Im folgenden Beispiel für `start-db-instance-automated-backups-replication` werden automatisierte Backups aus einer DB-Instance in der Region USA West (Oregon) in die Region USA Ost (Nord-Virginia) repliziert. Der Aufbewahrungszeitraum für Backups beträgt 14 Tage. ``` aws rds start-db-instance-automated-backups-replication \ --region us-west-2 \ --source-db-instance-arn "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db" \ --backup-retention-period 14 ``` Ausgabe: ``` { "DBInstanceAutomatedBackup": { "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db", "DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE", "Region": "us-east-1", "DBInstanceIdentifier": "new-orcl-db", "RestoreWindow": {}, "AllocatedStorage": 20, "Status": "pending", "Port": 1521, "InstanceCreateTime": "2020-12-04T15:28:31Z", "MasterUsername": "admin", "Engine": "oracle-se2", "EngineVersion": "12.1.0.2.v21", "LicenseModel": "bring-your-own-license", "OptionGroupName": "default:oracle-se2-12-1", "Encrypted": false, "StorageType": "gp2", "IAMDatabaseAuthenticationEnabled": false, "BackupRetentionPeriod": 14, "DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example" } } ``` Weitere Informationen finden Sie unter [Ermöglichen regionsübergreifender automatisierter Sicherungen](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Replicating.Enable) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [StartDbInstanceAutomatedBackupsReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-db-instance-automated-backups-replication.html)in der *AWS CLI Befehlsreferenz*. ### `start-db-instance` Das folgende Codebeispiel zeigt die Verwendung`start-db-instance`. **AWS CLI** **Um eine DB-Instance zu starten** Im folgenden Beispiel für `start-db-instance` wird die angegebene Instance gestartet. ``` aws rds start-db-instance \ --db-instance-identifier test-instance ``` Ausgabe: ``` { "DBInstance": { "DBInstanceStatus": "starting", ...some output truncated... } } ``` + Einzelheiten zur API finden Sie [StartDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-db-instance.html)in der *AWS CLI Befehlsreferenz*. ### `start-export-task` Das folgende Codebeispiel zeigt die Verwendung`start-export-task`. **AWS CLI** **So exportieren Sie einen Snapshot nach Amazon S3** Im folgenden Beispiel für `start-export-task` wird ein DB-Snapshot namens `db5-snapshot-test` in den Amazon-S3-Bucket namens `amzn-s3-demo-bucket` exportiert. ``` aws rds start-export-task \ --export-task-identifier my-s3-export \ --source-arn arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test \ --s3-bucket-name amzn-s3-demo-bucket \ --iam-role-arn arn:aws:iam::123456789012:role/service-role/ExportRole \ --kms-key-id arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff ``` Ausgabe: ``` { "ExportTaskIdentifier": "my-s3-export", "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test", "SnapshotTime": "2020-03-27T20:48:42.023Z", "S3Bucket": "amzn-s3-demo-bucket", "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole", "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff", "Status": "STARTING", "PercentProgress": 0, "TotalExtractedDataInGB": 0 } ``` Weitere Informationen finden Sie unter [Exportieren eines Snapshots in einen Amazon-S3-Bucket](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Exporting) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [StartExportTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-export-task.html)in der *AWS CLI Befehlsreferenz*. ### `stop-activity-stream` Das folgende Codebeispiel zeigt die Verwendung`stop-activity-stream`. **AWS CLI** **So stoppen Sie einen Datenbankaktivitäts-Stream** Das folgende `stop-activity-stream` Beispiel stoppt einen Aktivitätsstream in einem Aurora-Cluster mit dem Namen my-pg-cluster. ``` aws rds stop-activity-stream \ --region us-east-1 \ --resource-arn arn:aws:rds:us-east-1:1234567890123:cluster:my-pg-cluster \ --apply-immediately ``` Ausgabe: ``` { "KmsKeyId": "arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1", "KinesisStreamName": "aws-rds-das-cluster-0ABCDEFGHI1JKLM2NOPQ3R4S", "Status": "stopping" } ``` Weitere Informationen finden Sie unter [Anhalten eines Aktivitäts-Streams](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/DBActivityStreams.html#DBActivityStreams.Disabling) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [StopActivityStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-activity-stream.html)in der *AWS CLI Befehlsreferenz*. ### `stop-db-cluster` Das folgende Codebeispiel zeigt die Verwendung`stop-db-cluster`. **AWS CLI** **So stoppen Sie einen DB-Cluster** Das folgende `stop-db-cluster`-Beispiel stoppt einen DB-Cluster und seine DB-Instances. ``` aws rds stop-db-cluster \ --db-cluster-identifier mydbcluster ``` Ausgabe: ``` { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1a", "us-east-1e", "us-east-1b" ], "BackupRetentionPeriod": 1, "DatabaseName": "mydb", "DBClusterIdentifier": "mydbcluster", ...some output truncated... } } ``` Weitere Informationen finden Sie unter [Stoppen und Starten eines DB-Clusters von Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-cluster-stop-start.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [StopDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-db-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `stop-db-instance-automated-backups-replication` Das folgende Codebeispiel zeigt die Verwendung`stop-db-instance-automated-backups-replication`. **AWS CLI** **So beenden Sie die Replikation automatisierter Backups** Der folgende `stop-db-instance-automated-backups-replication` beendet die Replikation automatisierter Backups in die Region USA West (Oregon). Replizierte Backups werden gemäß dem festgelegten Aufbewahrungszeitraum für Backups aufbewahrt. ``` aws rds stop-db-instance-automated-backups-replication \ --region us-west-2 \ --source-db-instance-arn "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db" ``` Ausgabe: ``` { "DBInstanceAutomatedBackup": { "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db", "DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE", "Region": "us-east-1", "DBInstanceIdentifier": "new-orcl-db", "RestoreWindow": { "EarliestTime": "2020-12-04T23:13:21.030Z", "LatestTime": "2020-12-07T19:59:57Z" }, "AllocatedStorage": 20, "Status": "replicating", "Port": 1521, "InstanceCreateTime": "2020-12-04T15:28:31Z", "MasterUsername": "admin", "Engine": "oracle-se2", "EngineVersion": "12.1.0.2.v21", "LicenseModel": "bring-your-own-license", "OptionGroupName": "default:oracle-se2-12-1", "Encrypted": false, "StorageType": "gp2", "IAMDatabaseAuthenticationEnabled": false, "BackupRetentionPeriod": 7, "DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example" } } ``` Weitere Informationen finden Sie unter [Anhalten von automatisierten Backups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.StopReplicating) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [StopDbInstanceAutomatedBackupsReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-db-instance-automated-backups-replication.html)in der *AWS CLI Befehlsreferenz*. ### `stop-db-instance` Das folgende Codebeispiel zeigt die Verwendung`stop-db-instance`. **AWS CLI** **Um eine DB-Instance zu stoppen** Im folgenden Beispiel für `stop-db-instance` wird die angegebene DB-Instance gestoppt. ``` aws rds stop-db-instance \ --db-instance-identifier test-instance ``` Ausgabe: ``` { "DBInstance": { "DBInstanceStatus": "stopping", ...some output truncated... } } ``` + Einzelheiten zur API finden Sie [StopDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-db-instance.html)in der *AWS CLI Befehlsreferenz*. ### `switchover-blue-green-deployment` Das folgende Codebeispiel zeigt die Verwendung`switchover-blue-green-deployment`. **AWS CLI** **Beispiel 1: Um eine blue/green Bereitstellung für eine RDS-DB-Instance zu wechseln** Im folgenden `switchover-blue-green-deployment` Beispiel wird die angegebene grüne Umgebung als neue Produktionsumgebung hochgestuft. ``` aws rds switchover-blue-green-deployment \ --blue-green-deployment-identifier bgd-wi89nwzglccsfake \ --switchover-timeout 300 ``` Ausgabe: ``` { "BlueGreenDeployment": { "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake", "BlueGreenDeploymentName": "bgd-cli-test-instance", "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance", "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-blhi1e", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-blhi1e", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-k5fv7u", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ggsh8m", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-o2vwm0", "Status": "AVAILABLE" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "COMPLETED" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "COMPLETED" }, { "Name": "CONFIGURE_BACKUPS", "Status": "COMPLETED" }, { "Name": "CREATING_TOPOLOGY_OF_SOURCE", "Status": "COMPLETED" } ], "Status": "SWITCHOVER_IN_PROGRESS", "CreateTime": "2022-02-25T22:33:22.225000+00:00" } } ``` Weitere Informationen finden Sie unter [Switching a blue/green Deployment](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-switching.html) im *Amazon RDS-Benutzerhandbuch*. **Beispiel 2: Um eine blue/green Bereitstellung für einen Aurora MySQL-DB-Cluster zu bewerben** Im folgenden `switchover-blue-green-deployment` Beispiel wird die angegebene grüne Umgebung als neue Produktionsumgebung hochgestuft. ``` aws rds switchover-blue-green-deployment \ --blue-green-deployment-identifier bgd-wi89nwzglccsfake \ --switchover-timeout 300 ``` Ausgabe: ``` { "BlueGreenDeployment": { "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake", "BlueGreenDeploymentName": "my-blue-green-deployment", "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3ud8z6", "SwitchoverDetails": [ { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3ud8z6", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-bvxc73", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-7wc4ie", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3", "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-p4xxkz", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-np1ikl", "Status": "AVAILABLE" }, { "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint", "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-miszlf", "Status": "AVAILABLE" } ], "Tasks": [ { "Name": "CREATING_READ_REPLICA_OF_SOURCE", "Status": "COMPLETED" }, { "Name": "DB_ENGINE_VERSION_UPGRADE", "Status": "COMPLETED" }, { "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER", "Status": "COMPLETED" }, { "Name": "CREATE_CUSTOM_ENDPOINTS", "Status": "COMPLETED" } ], "Status": "SWITCHOVER_IN_PROGRESS", "CreateTime": "2022-02-25T22:38:49.522000+00:00" } } ``` Weitere Informationen finden Sie unter [Switching a blue/green Deployment](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-switching.html) im *Amazon Aurora Aurora-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [SwitchoverBlueGreenDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/switchover-blue-green-deployment.html)unter *AWS CLI Befehlsreferenz*. # Beispiele für Amazon RDS Data Service mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon RDS Data Service Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `batch-execute-statement` Das folgende Codebeispiel zeigt, wie Sie`batch-execute-statement`. **AWS CLI** **So führen Sie eine Batch-SQL-Anweisung aus** Im folgenden Beispiel für `batch-execute-statement` wird eine Batch-SQL-Anweisung für ein Daten-Array mit einem Parametersatz ausgeführt. ``` aws rds-data batch-execute-statement \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --database "mydb" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \ --sql "insert into mytable values (:id, :val)" \ --parameter-sets "[[{\"name\": \"id\", \"value\": {\"longValue\": 1}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueOne\"}}], [{\"name\": \"id\", \"value\": {\"longValue\": 2}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueTwo\"}}], [{\"name\": \"id\", \"value\": {\"longValue\": 3}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueThree\"}}]]" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Verwenden der Daten-API für Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [BatchExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/batch-execute-statement.html)in der *AWS CLI Befehlsreferenz*. ### `begin-transaction` Das folgende Codebeispiel zeigt die Verwendung`begin-transaction`. **AWS CLI** **So starten Sie eine SQL-Transaktion** Im folgenden Beispiel für `begin-transaction` wird eine SQL-Transaktion gestartet. ``` aws rds-data begin-transaction \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --database "mydb" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" ``` Ausgabe: ``` { "transactionId": "ABC1234567890xyz" } ``` Weitere Informationen finden Sie unter [Verwenden der Daten-API für Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [BeginTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/begin-transaction.html)in der *AWS CLI Befehlsreferenz*. ### `commit-transaction` Das folgende Codebeispiel zeigt die Verwendung`commit-transaction`. **AWS CLI** **So übergeben Sie eine SQL-Transaktion** Das folgende `commit-transaction`-Beispiel beendet die angegebene SQL-Transaktion und überträgt die Änderungen, die Sie als Teil der Transaktion vorgenommen haben. ``` aws rds-data commit-transaction \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \ --transaction-id "ABC1234567890xyz" ``` Ausgabe: ``` { "transactionStatus": "Transaction Committed" } ``` Weitere Informationen finden Sie unter [Verwenden der Daten-API für Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [CommitTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/commit-transaction.html)in der *AWS CLI Befehlsreferenz*. ### `execute-statement` Das folgende Codebeispiel zeigt die Verwendung`execute-statement`. **AWS CLI** **Beispiel 1: So führen Sie eine SQL-Anweisung aus, die Teil einer Transaktion ist** Im folgenden `execute-statement`-Beispiel wird eine SQL-Anweisung ausgeführt, die Teil einer Transaktion ist. ``` aws rds-data execute-statement \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --database "mydb" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \ --sql "update mytable set quantity=5 where id=201" \ --transaction-id "ABC1234567890xyz" ``` Ausgabe: ``` { "numberOfRecordsUpdated": 1 } ``` **Beispiel 2: So führen Sie eine SQL-Anweisung mit Parametern aus** Im folgenden Beispiel für `execute-statement` wird eine SQL-Anweisung mit Parametern ausgeführt. ``` aws rds-data execute-statement \ --resource-arn "arn:aws:rds:us-east-1:123456789012:cluster:mydbcluster" \ --database "mydb" \ --secret-arn "arn:aws:secretsmanager:us-east-1:123456789012:secret:mysecret" \ --sql "insert into mytable values (:id, :val)" \ --parameters "[{\"name\": \"id\", \"value\": {\"longValue\": 1}},{\"name\": \"val\", \"value\": {\"stringValue\": \"value1\"}}]" ``` Ausgabe: ``` { "numberOfRecordsUpdated": 1 } ``` Weitere Informationen finden Sie unter [Verwenden der Daten-API für Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [ExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/execute-statement.html)in der *AWS CLI Befehlsreferenz*. ### `rollback-transaction` Das folgende Codebeispiel zeigt die Verwendung`rollback-transaction`. **AWS CLI** **So machen Sie eine SQL-Transaktion rückgängig** Im folgenden Beispiel für `rollback-transaction` wird die angegebene SQL-Transaktion rückgängig gemacht. ``` aws rds-data rollback-transaction \ --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \ --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \ --transaction-id "ABC1234567890xyz" ``` Ausgabe: ``` { "transactionStatus": "Rollback Complete" } ``` Weitere Informationen finden Sie unter [Verwenden der Daten-API für Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) im *Benutzerhandbuch für Amazon RDS*. + Einzelheiten zur API finden Sie [RollbackTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/rollback-transaction.html)in der *AWS CLI Befehlsreferenz*. # Beispiele für Amazon RDS Performance Insights mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon RDS Performance Insights Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-performance-analysis-report` Das folgende Codebeispiel zeigt, wie Sie`create-performance-analysis-report`. **AWS CLI** **So erstellen Sie einen Leistungsanalysebericht** Im folgenden Beispiel für `create-performance-analysis-report` wird ein Leistungsanalysebericht mit der Startzeit `1682969503` und der Endzeit `1682979503` für die `db-abcdefg123456789`-Datenbank erstellt. ``` aws pi create-performance-analysis-report \ --service-type RDS \ --identifier db-abcdefg123456789 \ --start-time 1682969503 \ --end-time 1682979503 ``` Ausgabe: ``` { "AnalysisReportId": "report-0234d3ed98e28fb17" } ``` Weitere Informationen zum Erstellen von Leistungsanalyseberichten finden Sie unter [Erstellen eines Leistungsanalyseberichts in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.html) im *Benutzerhandbuch für Amazon RDS* und [Erstellen eines Leistungsanalyseberichts in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [CreatePerformanceAnalysisReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/create-performance-analysis-report.html)in der *AWS CLI Befehlsreferenz*. ### `delete-performance-analysis-report` Das folgende Codebeispiel zeigt die Verwendung`delete-performance-analysis-report`. **AWS CLI** **So löschen Sie einen Leistungsanalysebericht** Im folgenden Beispiel für `delete-performance-analysis-report` wird der Leistungsanalysebericht mit der Berichts-ID `report-0d99cc91c4422ee61` gelöscht. ``` aws pi delete-performance-analysis-report \ --service-type RDS \ --identifier db-abcdefg123456789 \ --analysis-report-id report-0d99cc91c4422ee61 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen zum Löschen von Leistungsanalyseberichten finden Sie unter [Löschen eines Leistungsanalyseberichts in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.html) im *Benutzerhandbuch für Amazon RDS* und [Löschen eines Leistungsanalyseberichts in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DeletePerformanceAnalysisReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/delete-performance-analysis-report.html)in der *AWS CLI Befehlsreferenz*. ### `describe-dimension-keys` Das folgende Codebeispiel zeigt die Verwendung`describe-dimension-keys`. **AWS CLI** **Beispiel 1: So beschreiben Sie Dimensionsschlüssel** In diesem Beispiel werden die Namen aller Warteereignisse abgefragt. Die Daten werden nach Ereignisnamen und den Aggregatwerten dieser Ereignisse über den angegebenen Zeitraum zusammengefasst. Befehl: ``` aws pi describe-dimension-keys --service-type RDS --identifier db-LKCGOBK26374TPTDFXOIWVCPPM --start-time 1527026400 --end-time 1527080400 --metric db.load.avg --group-by '{"Group":"db.wait_event"}' ``` Ausgabe: ``` { "AlignedEndTime": 1.5270804E9, "AlignedStartTime": 1.5270264E9, "Keys": [ { "Dimensions": {"db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex"}, "Total": 0.05906906851195666 }, { "Dimensions": {"db.wait_event.name": "wait/io/aurora_redo_log_flush"}, "Total": 0.015824722186149193 }, { "Dimensions": {"db.wait_event.name": "CPU"}, "Total": 0.008014396230265477 }, { "Dimensions": {"db.wait_event.name": "wait/io/aurora_respond_to_client"}, "Total": 0.0036361612526204477 }, { "Dimensions": {"db.wait_event.name": "wait/io/table/sql/handler"}, "Total": 0.0019108398419382965 }, { "Dimensions": {"db.wait_event.name": "wait/synch/cond/mysys/my_thread_var::suspend"}, "Total": 8.533847837782684E-4 }, { "Dimensions": {"db.wait_event.name": "wait/io/file/csv/data"}, "Total": 6.864181956477376E-4 }, { "Dimensions": {"db.wait_event.name": "Unknown"}, "Total": 3.895887056379051E-4 }, { "Dimensions": {"db.wait_event.name": "wait/synch/mutex/sql/FILE_AS_TABLE::LOCK_shim_lists"}, "Total": 3.710368625122906E-5 }, { "Dimensions": {"db.wait_event.name": "wait/lock/table/sql/handler"}, "Total": 0 } ] } ``` **Beispiel 2: So finden Sie die SQL-ID für Anweisungen, die am meisten zur DB-Last beitragen** Im folgenden `describe-dimension-keys` werden die SQL-Anweisung und die SQL-ID für die 10 Anweisungen abgefragt, die am meisten zur Datenbanklast beigetragen haben. ``` aws pi describe-dimension-keys \ --service-type RDS \ --identifier db-abcdefg123456789 \ --start-time 2023-05-01T00:00:00Z \ --end-time 2023-05-01T01:00:00Z \ --metric db.load.avg \ --group-by '{"Group": "db.sql", "Dimensions": ["db.sql.id", "db.sql.statement"],"Limit": 10}' ``` Ausgabe: ``` { "AlignedEndTime": 1.5270804E9, "AlignedStartTime": 1.5270264E9, "Identifier": "db-abcdefg123456789", "MetricList": [ { "Keys": [ { "Dimensions": {"db.sql.id": "AKIAIOSFODNN7EXAMPLE", "db.sql.statement": "SELECT * FROM customers WHERE customer_id = 123"}, "Total": 25.5,"Partitions": [12.3, 13.2] } ] } ] } ``` Weitere Informationen zu Dimensionen in Performance Insights finden Sie unter [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon RDS* und [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [DescribeDimensionKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/describe-dimension-keys.html)in der *AWS CLI Befehlsreferenz*. ### `get-dimension-key-details` Das folgende Codebeispiel zeigt die Verwendung`get-dimension-key-details`. **AWS CLI** **So rufen Sie Details für eine bestimmte Dimensionsgruppe einer DB-Instance ab** Im folgenden Beispiel für `get-dimension-key-details` wird der Volltext einer SQL-Anweisung für die DB-Instance `db-10BCD2EFGHIJ3KL4M5NO6PQRS5` abgerufen. `--group` ist `db.sql` und `--group-identifier` ist `db.sql.id`. In diesem Beispiel ist `example-sql-id` eine SQL-ID, die mithilfe der Operationen `get-resource-metrics` oder `describe-dimension-keys` abgerufen wurde. In diesem Beispiel sind die Dimensionsdetails verfügbar. Performance Insights ruft also den vollständigen Text der SQL-Anweisung ab, ohne ihn abzuschneiden. ``` aws pi get-dimension-key-details \ --service-type RDS \ --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \ --group db.sql \ --group-identifier example-sql-id \ --requested-dimensions statement ``` Ausgabe: ``` { "Dimensions":[ { "Value": "SELECT e.last_name, d.department_name FROM employees e, departments d WHERE e.department_id=d.department_id", "Dimension": "db.sql.statement", "Status": "AVAILABLE" }, ... ] } ``` Weitere Informationen zu Dimensionen in Performance Insights finden Sie unter [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon RDS* und [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [GetDimensionKeyDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-dimension-key-details.html)in der *AWS CLI Befehlsreferenz*. ### `get-performance-analysis-report` Das folgende Codebeispiel zeigt die Verwendung`get-performance-analysis-report`. **AWS CLI** **So rufen Sie einen Leistungsanalysebericht ab** Im folgenden Beispiel für `get-performance-analysis-report` wird der Leistungsanalysebericht für die Datenbank `db-abcdefg123456789` mit der Berichts-ID `report-0d99cc91c4422ee61` abgerufen. Die Antwort enthält den Berichtsstatus, die ID, Zeitdetails und Einblicke. ``` aws pi get-performance-analysis-report \ --service-type RDS \ --identifier db-abcdefg123456789 \ --analysis-report-id report-0d99cc91c4422ee61 ``` Ausgabe: ``` { "AnalysisReport": { "Status": "Succeeded", "ServiceType": "RDS", "Identifier": "db-abcdefg123456789", "StartTime": 1680583486.584, "AnalysisReportId": "report-0d99cc91c4422ee61", "EndTime": 1680587086.584, "CreateTime": 1680587087.139, "Insights": [ ... (Condensed for space) ] } } ``` Weitere Informationen zu Leistungsanalyseberichten finden Sie unter [Analysieren der Datenbankleistung für einen bestimmten Zeitraum](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) im *Benutzerhandbuch für Amazon RDS* und [Analysieren der Datenbankleistung für einen bestimmten Zeitraum](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [GetPerformanceAnalysisReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-performance-analysis-report.html)in der *AWS CLI Befehlsreferenz*. ### `get-resource-metadata` Das folgende Codebeispiel zeigt die Verwendung`get-resource-metadata`. **AWS CLI** **So rufen Sie Ressourcen-Metadaten für eine Datenbank ab** Im folgenden Beispiel für `get-resource-metadata` werden die Ressourcenmetadaten für die Datenbank `db-abcdefg123456789` abgerufen. Die Antwort zeigt, dass „SQL-Digest-Statistiken“ aktiviert ist. ``` aws pi get-resource-metadata \ --service-type RDS \ --identifier db-abcdefg123456789 ``` Ausgabe: ``` { "Identifier": "db-abcdefg123456789", "Features":{ "SQL_DIGEST_STATISTICS":{ "Status": "ENABLED" } } } ``` Weitere Informationen zu SQL-Statistiken für Performance Insights finden Sie unter [SQL-Statistiken für Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/sql-statistics.html) im *Benutzerhandbuch für Amazon RDS* und [SQL-Statistiken für Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/sql-statistics.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [GetResourceMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-resource-metadata.html)in der *AWS CLI Befehlsreferenz*. ### `get-resource-metrics` Das folgende Codebeispiel zeigt die Verwendung`get-resource-metrics`. **AWS CLI** **So rufen Sie Ressourcenmetriken ab** In diesem Beispiel werden Datenpunkte für die Dimensionsgruppe *db.wait\$1event* und für die Dimension *db.wait\$1event.name* in dieser Gruppe angefordert. In der Antwort werden die relevanten Datenpunkte nach der angeforderten Dimension (*db.wait\$1event.name*) gruppiert. Befehl: ``` aws pi get-resource-metrics --service-type RDS --identifier db-LKCGOBK26374TPTDFXOIWVCPPM --start-time 1527026400 --end-time 1527080400 --period-in-seconds 300 --metric db.load.avg --metric-queries file://metric-queries.json ``` Die Argumente für `--metric-queries` werden in der JSON-Datei `metric-queries.json` gespeichert. Hier ist der Inhalt dieser Datei: ``` [ { "Metric": "db.load.avg", "GroupBy": { "Group":"db.wait_event" } } ] ``` Ausgabe: ``` { "AlignedEndTime": 1.5270804E9, "AlignedStartTime": 1.5270264E9, "Identifier": "db-LKCGOBK26374TPTDFXOIWVCPPM", "MetricList": [ { "Key": { "Metric": "db.load.avg" }, "DataPoints": [ { "Timestamp": 1527026700.0, "Value": 1.3533333333333333 }, { "Timestamp": 1527027000.0, "Value": 0.88 }, <...remaining output omitted...> ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex" } }, "DataPoints": [ { "Timestamp": 1527026700.0, "Value": 0.8566666666666667 }, { "Timestamp": 1527027000.0, "Value": 0.8633333333333333 }, <...remaining output omitted...> ], }, <...remaining output omitted...> ] } ``` + Einzelheiten zur API finden Sie [GetResourceMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-resource-metrics.html)in der *AWS CLI Befehlsreferenz*. ### `list-available-resource-dimensions` Das folgende Codebeispiel zeigt die Verwendung`list-available-resource-dimensions`. **AWS CLI** **So listen Sie die Dimensionen auf, die für einen Metriktyp von einer DB-Instance abgefragt werden können** Das folgende `list-available-resource-dimensions` Beispiel listet die `db.load` Metriken auf, die Sie für die Datenbank abfragen können. `db-abcdefg123456789` ``` aws pi list-available-resource-dimensions \ --service-type RDS \ --identifier db-abcdefg123456789 \ --metrics db.load ``` Ausgabe: ``` { "MetricDimensions": [ { "Metric": "db.load", "Groups": [ { "Group": "db.user", "Dimensions": [ { "Identifier": "db.user.id" }, { "Identifier": "db.user.name" } ] }, { "Group": "db.sql_tokenized", "Dimensions": [ { "Identifier": "db.sql_tokenized.id" }, { "Identifier": "db.sql_tokenized.db_id" }, { "Identifier": "db.sql_tokenized.statement" } ] }, ... ] } ] } ``` Weitere Informationen zu Dimensionen in Performance Insights finden Sie unter [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon RDS* und [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ListAvailableResourceDimensions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-available-resource-dimensions.html)in der *AWS CLI Befehlsreferenz*. ### `list-available-resource-metrics` Das folgende Codebeispiel zeigt die Verwendung`list-available-resource-metrics`. **AWS CLI** **So listen Sie die Metriken auf, die für einen Metriktyp von einer DB-Instance abgefragt werden können** Das folgende `list-available-resource-metrics` Beispiel listet die `db.load` Metriken auf, die Sie für die Datenbank abfragen können. `db-abcdefg123456789` ``` aws pi list-available-resource-metrics \ --service-type RDS \ --identifier db-abcdefg123456789 \ --metric-types "os" "db" ``` Ausgabe: ``` { "Metrics": [ { "Description": "The number of virtual CPUs for the DB instance", "Metric": "os.general.numVCPUs", "Unit": "vCPUs" }, ......, { "Description": "Time spent reading data file blocks by backends in this instance", "Metric": "db.IO.read_latency", "Unit": "Milliseconds per block" }, ...... ] } ``` Weitere Informationen zu Metriken in Performance Insights finden Sie unter [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon RDS* und [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ListAvailableResourceMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-available-resource-metrics.html)in der *AWS CLI Befehlsreferenz*. ### `list-performance-analysis-reports` Das folgende Codebeispiel zeigt die Verwendung`list-performance-analysis-reports`. **AWS CLI** **So listen Sie Leistungsanalyseberichte für eine Datenbank auf** Im folgenden Beispiel für `list-performance-analysis-reports` werden alle Leistungsanalyseberichte für die `db-abcdefg123456789`-Datenbank aufgelistet. In der Antwort werden alle Berichte mit der Berichts-ID, dem Status und den Details zum Zeitraum aufgeführt. ``` aws pi list-performance-analysis-reports \ --service-type RDS \ --identifier db-abcdefg123456789 ``` Ausgabe: ``` { "AnalysisReports": [ { "Status": "Succeeded", "EndTime": 1680587086.584, "CreateTime": 1680587087.139, "StartTime": 1680583486.584, "AnalysisReportId": "report-0d99cc91c4422ee61" }, { "Status": "Succeeded", "EndTime": 1681491137.914, "CreateTime": 1681491145.973, "StartTime": 1681487537.914, "AnalysisReportId": "report-002633115cc002233" }, { "Status": "Succeeded", "EndTime": 1681493499.849, "CreateTime": 1681493507.762, "StartTime": 1681489899.849, "AnalysisReportId": "report-043b1e006b47246f9" }, { "Status": "InProgress", "EndTime": 1682979503.0, "CreateTime": 1682979618.994, "StartTime": 1682969503.0, "AnalysisReportId": "report-01ad15f9b88bcbd56" } ] } ``` Weitere Informationen zu Leistungsanalyseberichten finden Sie unter [Analysieren der Datenbankleistung für einen bestimmten Zeitraum](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) im *Benutzerhandbuch für Amazon RDS* und [Analysieren der Datenbankleistung für einen bestimmten Zeitraum](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ListPerformanceAnalysisReports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-performance-analysis-reports.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie alle Tags für einen Leistungsanalysebericht auf** Das folgende `list-tags-for-resource`-Beispiel listet Tags für einen Leistungsanalysebericht mit der Berichts-ID auf`report-0d99cc91c4422ee61`. ``` aws pi list-tags-for-resource \ --service-type RDS \ --resource-arn arn:aws:pi:us-west-2:123456789012:perf-reports/RDS/db-abcdefg123456789/report-0d99cc91c4422ee61 ``` Ausgabe: ``` { "Tags": [ { "Value": "test-tag", "Key": "name" } ] } ``` Weitere Informationen zum Markieren von Leistungsanalyseberichten finden Sie unter [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon RDS* und [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So fügen Sie ein Tag zu einem Leistungsanalysebericht hinzu** Im folgenden Beispiel für `tag-resource` wird der Tag-Schlüssel `name` mit dem Tag-Wert `test-tag` zu einem Leistungsanalysebericht mit der Berichts-ID `report-0d99cc91c4422ee61` hinzugefügt. ``` aws pi tag-resource \ --service-type RDS \ --resource-arn arn:aws:pi:us-west-2:123456789012:perf-reports/RDS/db-abcdefg123456789/report-0d99cc91c4422ee61 \ --tags Key=name,Value=test-tag ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen zum Markieren von Leistungsanalyseberichten finden Sie unter [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon RDS* und [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So löschen Sie ein Tag aus einem Leistungsanalysebericht** Im folgenden Beispiel für `untag-resource` wird das Tag `name` aus einem Leistungsanalysebericht mit der Berichts-ID `report-0d99cc91c4422ee61` gelöscht. ``` aws pi untag-resource \ --service-type RDS \ --resource-arn arn:aws:pi:us-west-2:123456789012:perf-reports/RDS/db-abcdefg123456789/report-0d99cc91c4422ee61 \ --tag-keys name ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen zum Markieren von Leistungsanalyseberichten finden Sie unter [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon RDS* und [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon Aurora*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/untag-resource.html)in der *AWS CLI Befehlsreferenz*. # Amazon Redshift Redshift-Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Redshift Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `accept-reserved-node-exchange` Das folgende Codebeispiel zeigt, wie Sie`accept-reserved-node-exchange`. **AWS CLI** **So akzeptieren Sie den Austausch reservierter Knoten** Das folgende `accept-reserved-node-exchange` Beispiel akzeptiert den Austausch eines DC1 reservierten Knotens gegen einen DC2 reservierten Knoten. ``` aws redshift accept-reserved-node-exchange / --reserved-node-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE / --target-reserved-node-offering-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE ``` Ausgabe: ``` { "ExchangedReservedNode": { "ReservedNodeId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE", "ReservedNodeOfferingId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE", "NodeType": "dc2.large", "StartTime": "2019-12-06T21:17:26Z", "Duration": 31536000, "FixedPrice": 0.0, "UsagePrice": 0.0, "CurrencyCode": "USD", "NodeCount": 1, "State": "exchanging", "OfferingType": "All Upfront", "RecurringCharges": [ { "RecurringChargeAmount": 0.0, "RecurringChargeFrequency": "Hourly" } ], "ReservedNodeOfferingType": "Regular" } } ``` Weitere Informationen finden Sie unter [Upgrading Reserved Nodes with the AWS CLI](https://docs.aws.amazon.com/redshift/latest/mgmt/purchase-reserved-node-offering-console.html) im *Amazon Redshift Cluster Management Guide*. + Einzelheiten zur API finden Sie unter [AcceptReservedNodeExchange AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/accept-reserved-node-exchange.html)*Befehlsreferenz.* ### `authorize-cluster-security-group-ingress` Das folgende Codebeispiel zeigt die Verwendung`authorize-cluster-security-group-ingress`. **AWS CLI** Ein GroupThis Beispiel für die Autorisierung des Zugriffs auf eine EC2-Sicherheit autorisiert den Zugriff auf eine benannte Amazon EC2-Sicherheitsgruppe. Befehl: ``` aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --ec2-security-group-name myec2securitygroup --ec2-security-group-owner-id 123445677890 ``` Autorisieren des Zugriffs auf einen CIDR-BereichIn diesem Beispiel wird der Zugriff auf einen CIDR-Bereich autorisiert.Befehl: ``` aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --cidrip 192.168.100.100/32 ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [AuthorizeClusterSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-cluster-security-group-ingress.html)AWS CLI * ### `authorize-snapshot-access` Das folgende Codebeispiel zeigt die Verwendung`authorize-snapshot-access`. **AWS CLI** Ein AWS Konto zur Wiederherstellung autorisieren Ein SnapshotThis Beispiel autorisiert das AWS Konto`444455556666`, den Snapshot wiederherzustellen. `my-snapshot-id` JSON ist das Standardausgabeformat. Befehl: ``` aws redshift authorize-snapshot-access --snapshot-id my-snapshot-id --account-with-restore-access 444455556666 ``` Ergebnis: ``` { "Snapshot": { "Status": "available", "SnapshotCreateTime": "2013-07-17T22:04:18.947Z", "EstimatedSecondsToCompletion": 0, "AvailabilityZone": "us-east-1a", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "Encrypted": false, "OwnerAccount": "111122223333", "BackupProgressInMegabytes": 11.0, "ElapsedTimeInSeconds": 0, "DBName": "dev", "CurrentBackupRateInMegabytesPerSecond: 0.1534, "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "ActualIncrementalBackupSizeInMegabytes"; 11.0, "SnapshotType": "manual", "NodeType": "dw.hs1.xlarge", "ClusterIdentifier": "mycluster", "TotalBackupSizeInMegabytes": 20.0, "Port": 5439, "NumberOfNodes": 2, "SnapshotIdentifier": "my-snapshot-id" } } ``` + Einzelheiten zur API finden Sie [AuthorizeSnapshotAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-snapshot-access.html)in der *AWS CLI Befehlsreferenz*. ### `batch-delete-cluster-snapshots` Das folgende Codebeispiel zeigt die Verwendung`batch-delete-cluster-snapshots`. **AWS CLI** **So löschen Sie einen Cluster-Snapshot-Satz** Im folgenden Beispiel für `batch-delete-cluster-snapshots` wird ein Satz manueller Cluster-Snapshots gelöscht. ``` aws redshift batch-delete-cluster-snapshots \ --identifiers SnapshotIdentifier=mycluster-2019-11-06-14-12 SnapshotIdentifier=mycluster-2019-11-06-14-20 ``` Ausgabe: ``` { "Resources": [ "mycluster-2019-11-06-14-12", "mycluster-2019-11-06-14-20" ] } ``` Weitere Informationen finden Sie unter [Amazon-Redshift-Snapshots](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [BatchDeleteClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-delete-cluster-snapshots.html)in der *AWS CLI Befehlsreferenz*. ### `batch-modify-cluster-snapshots` Das folgende Codebeispiel zeigt die Verwendung`batch-modify-cluster-snapshots`. **AWS CLI** **So ändern Sie einen Satz von Cluster-Snapshots** Im folgenden Beispiel für `batch-modify-cluster-snapshots` werden die Einstellungen für einen Satz von Cluster-Snapshots geändert. ``` aws redshift batch-modify-cluster-snapshots \ --snapshot-identifier-list mycluster-2019-11-06-16-31 mycluster-2019-11-06-16-32 \ --manual-snapshot-retention-period 30 ``` Ausgabe: ``` { "Resources": [ "mycluster-2019-11-06-16-31", "mycluster-2019-11-06-16-32" ], "Errors": [], "ResponseMetadata": { "RequestId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE", "HTTPStatusCode": 200, "HTTPHeaders": { "x-amzn-requestid": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE, "content-type": "text/xml", "content-length": "480", "date": "Sat, 07 Dec 2019 00:36:09 GMT", "connection": "keep-alive" }, "RetryAttempts": 0 } } ``` Weitere Informationen finden Sie unter [Amazon-Redshift-Snapshots](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [BatchModifyClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-modify-cluster-snapshots.html)in der *AWS CLI Befehlsreferenz*. ### `cancel-resize` Das folgende Codebeispiel zeigt die Verwendung`cancel-resize`. **AWS CLI** **So brechen Sie die Größenänderung eines Clusters ab** Im folgenden Beispiel für `cancel-resize` wird eine klassische Größenänderungsoperation für einen Cluster abgebrochen. ``` aws redshift cancel-resize \ --cluster-identifier mycluster ``` Ausgabe: ``` { "TargetNodeType": "dc2.large", "TargetNumberOfNodes": 2, "TargetClusterType": "multi-node", "Status": "CANCELLING", "ResizeType": "ClassicResize", "TargetEncryptionType": "NONE" } ``` Weitere Informationen finden Sie unter [Größenanpassung von Clustern in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/rs-resize-tutorial.html) im *Clusterverwaltungshandbuch für Amazon Redshift*. + Einzelheiten zur API finden Sie [CancelResize](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/cancel-resize.html)in der *AWS CLI Befehlsreferenz*. ### `copy-cluster-snapshot` Das folgende Codebeispiel zeigt die Verwendung`copy-cluster-snapshot`. **AWS CLI** Das VersionsThis Beispiel Get a Description of All Cluster gibt eine Beschreibung aller Clusterversionen zurück. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift copy-cluster-snapshot --source-snapshot-identifier cm:examplecluster-2013-01-22-19-27-58 --target-snapshot-identifier my-saved-snapshot-copy ``` Ergebnis: ``` { "Snapshot": { "Status": "available", "SnapshotCreateTime": "2013-01-22T19:27:58.931Z", "AvailabilityZone": "us-east-1c", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "DBName": "dev", "ClusterCreateTime": "2013-01-22T19:23:59.368Z", "SnapshotType": "manual", "NodeType": "dw.hs1.xlarge", "ClusterIdentifier": "examplecluster", "Port": 5439, "NumberOfNodes": "2", "SnapshotIdentifier": "my-saved-snapshot-copy" }, "ResponseMetadata": { "RequestId": "3b279691-64e3-11e2-bec0-17624ad140dd" } } ``` + Einzelheiten zur API finden Sie [CopyClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/copy-cluster-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`create-cluster-parameter-group`. **AWS CLI** Das GroupThis Beispiel „Cluster-Parameter erstellen“ erstellt eine neue Cluster-Parametergruppe.Command: ``` aws redshift create-cluster-parameter-group --parameter-group-name myclusterparametergroup --parameter-group-family redshift-1.0 --description "My first cluster parameter group" ``` Ergebnis: ``` { "ClusterParameterGroup": { "ParameterGroupFamily": "redshift-1.0", "Description": "My first cluster parameter group", "ParameterGroupName": "myclusterparametergroup" }, "ResponseMetadata": { "RequestId": "739448f0-64cc-11e2-8f7d-3b939af52818" } } ``` + Einzelheiten zur API finden Sie [CreateClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-parameter-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-cluster-security-group` Das folgende Codebeispiel zeigt die Verwendung`create-cluster-security-group`. **AWS CLI** Durch das Erstellen eines GroupThis Beispiels für Clustersicherheit wird eine neue Clustersicherheitsgruppe erstellt. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group" ``` Ergebnis: ``` { "create_cluster_security_group_response": { "create_cluster_security_group_result": { "cluster_security_group": { "description": "This is my cluster security group", "owner_id": "300454760768", "cluster_security_group_name": "mysecuritygroup", "ec2_security_groups": \[], "ip_ranges": \[] } }, "response_metadata": { "request_id": "5df486a0-343a-11e2-b0d8-d15d0ef48549" } } } ``` Sie können dieselben Informationen auch mit der folgenden `--output text` Option im Textformat abrufen: `--output text`Option.Befehl: Option.Befehl: ``` aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group" --output text ``` Ergebnis: ``` This is my cluster security group 300454760768 mysecuritygroup a0c0bfab-343a-11e2-95d2-c3dc9fe8ab57 ``` + Einzelheiten zur API finden Sie [CreateClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-security-group.html)in der *AWS CLI Befehlsreferenz*. ### `create-cluster-snapshot` Das folgende Codebeispiel zeigt die Verwendung`create-cluster-snapshot`. **AWS CLI** Das SnapshotThis Beispiel „Cluster erstellen“ erstellt einen neuen Cluster-Snapshot. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift create-cluster-snapshot --cluster-identifier mycluster --snapshot-identifier my-snapshot-id ``` Ergebnis: ``` { "Snapshot": { "Status": "creating", "SnapshotCreateTime": "2013-01-22T22:20:33.548Z", "AvailabilityZone": "us-east-1a", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "DBName": "dev", "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "SnapshotType": "manual", "NodeType": "dw.hs1.xlarge", "ClusterIdentifier": "mycluster", "Port": 5439, "NumberOfNodes": "2", "SnapshotIdentifier": "my-snapshot-id" }, "ResponseMetadata": { "RequestId": "f024d1a5-64e1-11e2-88c5-53eb05787dfb" } } ``` + Einzelheiten zur API finden Sie [CreateClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-snapshot.html)in der *AWS CLI Befehlsreferenz*. ### `create-cluster-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`create-cluster-subnet-group`. **AWS CLI** Das GroupThis Beispiel „Cluster-Subnetz erstellen“ erstellt eine neue Cluster-Subnetzgruppe. Befehl: ``` aws redshift create-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup --description "My subnet group" --subnet-ids subnet-763fdd1c ``` Ergebnis: ``` { "ClusterSubnetGroup": { "Subnets": [ { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-763fdd1c", "SubnetAvailabilityZone": { "Name": "us-east-1a" } } ], "VpcId": "vpc-7e3fdd14", "SubnetGroupStatus": "Complete", "Description": "My subnet group", "ClusterSubnetGroupName": "mysubnetgroup" }, "ResponseMetadata": { "RequestId": "500b8ce2-698f-11e2-9790-fd67517fb6fd" } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-subnet-group.html).AWS CLI * ### `create-cluster` Das folgende Codebeispiel zeigt die Verwendung`create-cluster`. **AWS CLI** Das ParametersThis Beispiel Create a Cluster with Minimal erstellt einen Cluster mit einem minimalen Parametersatz. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift create-cluster --node-type dw.hs1.xlarge --number-of-nodes 2 --master-username adminuser --master-user-password TopSecret1 --cluster-identifier mycluster ``` Ergebnis: ``` { "Cluster": { "NodeType": "dw.hs1.xlarge", "ClusterVersion": "1.0", "PubliclyAccessible": "true", "MasterUsername": "adminuser", "ClusterParameterGroups": [ { "ParameterApplyStatus": "in-sync", "ParameterGroupName": "default.redshift-1.0" } ], "ClusterSecurityGroups": [ { "Status": "active", "ClusterSecurityGroupName": "default" } ], "AllowVersionUpgrade": true, "VpcSecurityGroups": \[], "PreferredMaintenanceWindow": "sat:03:30-sat:04:00", "AutomatedSnapshotRetentionPeriod": 1, "ClusterStatus": "creating", "ClusterIdentifier": "mycluster", "DBName": "dev", "NumberOfNodes": 2, "PendingModifiedValues": { "MasterUserPassword": "\****" } }, "ResponseMetadata": { "RequestId": "7cf4bcfc-64dd-11e2-bea9-49e0ce183f07" } } ``` + Einzelheiten zur API finden Sie [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster.html)in der *AWS CLI Befehlsreferenz*. ### `create-event-subscription` Das folgende Codebeispiel zeigt die Verwendung`create-event-subscription`. **AWS CLI** **So erstellen Sie ein Benachrichtigungsabonnement für ein Ereignis** Im folgenden Beispiel für `create-event-subscription` wird ein Benachrichtigungsabonnement für ein Ereignis erstellt. ``` aws redshift create-event-subscription \ --subscription-name mysubscription \ --sns-topic-arn arn:aws:sns:us-west-2:123456789012:MySNStopic \ --source-type cluster \ --source-ids mycluster ``` Ausgabe: ``` { "EventSubscription": { "CustomerAwsId": "123456789012", "CustSubscriptionId": "mysubscription", "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:MySNStopic", "Status": "active", "SubscriptionCreationTime": "2019-12-09T20:05:19.365Z", "SourceType": "cluster", "SourceIdsList": [ "mycluster" ], "EventCategoriesList": [], "Severity": "INFO", "Enabled": true, "Tags": [] } } ``` Weitere Informationen finden Sie unter [Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-event-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `create-hsm-client-certificate` Das folgende Codebeispiel zeigt die Verwendung`create-hsm-client-certificate`. **AWS CLI** **Um ein HSM-Client-Zertifikat zu erstellen** Im folgenden Beispiel für `create-hsm-client-certificate` wird ein HSM-Client-Zertifikat generiert, das ein Cluster verwenden kann, um eine Verbindung zu einem HSM herzustellen. ``` aws redshift create-hsm-client-certificate \ --hsm-client-certificate-identifier myhsmclientcert ``` Ausgabe: ``` { "HsmClientCertificate": { "HsmClientCertificateIdentifier": "myhsmclientcert", "HsmClientCertificatePublicKey": "-----BEGIN CERTIFICATE----- MIICiEXAMPLECQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTEXAMPLEwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25EXAMPLEIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb2EXAMPLETEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBEXAMPLEMRAwDgYD EXAMPLETZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAEXAMPLEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKEXAMPLEAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk6EXAMPLE3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugEXAMPLEzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEEXAMPLEEAtCu4 nUhVVxYUEXAMPLEh8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GEXAMPLEl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rEXAMPLE=-----END CERTIFICATE-----\n", "Tags": [] } } ``` Weitere Informationen finden Sie unter [Referenz für API-Berechtigungen in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie unter [CreateHsmClientCertificate AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-client-certificate.html)*Befehlsreferenz.* ### `create-hsm-configuration` Das folgende Codebeispiel zeigt die Verwendung`create-hsm-configuration`. **AWS CLI** **So erstellen Sie eine HSM-Konfiguration** Im folgenden Beispiel für `create-hsm-configuration` wird die angegebene HSM-Konfiguration erstellt, die Informationen enthält, die ein Cluster benötigt, um Datenbank-Verschlüsselungsschlüssel in einem Hardware-Sicherheitsmodul (HSM) zu speichern und zu verwenden. ``` aws redshift create-hsm-configuration / --hsm-configuration-identifier myhsmconnection --description "My HSM connection" --hsm-ip-address 192.0.2.09 --hsm-partition-name myhsmpartition / --hsm-partition-password A1b2c3d4 / --hsm-server-public-certificate myhsmclientcert ``` Ausgabe: ``` { "HsmConfiguration": { "HsmConfigurationIdentifier": "myhsmconnection", "Description": "My HSM connection", "HsmIpAddress": "192.0.2.09", "HsmPartitionName": "myhsmpartition", "Tags": [] } } ``` + Einzelheiten zur API finden Sie [CreateHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-configuration.html)in der *AWS CLI Befehlsreferenz*. ### `create-snapshot-copy-grant` Das folgende Codebeispiel zeigt die Verwendung`create-snapshot-copy-grant`. **AWS CLI** **So erstellen Sie eine Kopiergenehmigung für Snapshots** Im folgenden `create-snapshot-copy-grant` Beispiel wird ein Snapshot-Kopierzuschuss erstellt und kopierte Snapshots in einer AWS Zielregion verschlüsselt. ``` aws redshift create-snapshot-copy-grant \ --snapshot-copy-grant-name mysnapshotcopygrantname ``` Ausgabe: ``` { "SnapshotCopyGrant": { "SnapshotCopyGrantName": "mysnapshotcopygrantname", "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY", "Tags": [] } } ``` Weitere Informationen finden Sie unter [Datenbankverschlüsselung in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie unter [CreateSnapshotCopyGrant AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-copy-grant.html)*Befehlsreferenz*. ### `create-snapshot-schedule` Das folgende Codebeispiel zeigt die Verwendung`create-snapshot-schedule`. **AWS CLI** **So erstellen Sie einen Snapshot-Zeitplan** Im folgenden Beispiel für `create-snapshot-schedule` wird ein Snapshot-Zeitplan mit der angegebenen Beschreibung und einer Intervallrate von 12 Stunden erstellt. ``` aws redshift create-snapshot-schedule \ --schedule-definitions "rate(12 hours)" \ --schedule-identifier mysnapshotschedule \ --schedule-description "My schedule description" ``` Ausgabe: ``` { "ScheduleDefinitions": [ "rate(12 hours)" ], "ScheduleIdentifier": "mysnapshotschedule", "ScheduleDescription": "My schedule description", "Tags": [] } ``` Weitere Informationen finden Sie unter [Zeitpläne für automatisierte Snapshots](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [CreateSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-schedule.html)in der *AWS CLI Befehlsreferenz*. ### `create-tags` Das folgende Codebeispiel zeigt die Verwendung`create-tags`. **AWS CLI** **So erstellen Sie Tags für einen Cluster** Im folgenden `create-tags` Beispiel wird das angegebene key/value Tag-Paar dem angegebenen Cluster hinzugefügt. ``` aws redshift create-tags \ --resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \ --tags "Key"="mytags","Value"="tag1" ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Markieren von Ressourcen in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [CreateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-tags.html)unter *AWS CLI Befehlsreferenz*. ### `delete-cluster-parameter-group` Das folgende Codebeispiel zeigt die Verwendung`delete-cluster-parameter-group`. **AWS CLI** Das GroupThis Beispiel „Einen Cluster-Parameter löschen“ löscht eine Cluster-Parametergruppe.Command: ``` aws redshift delete-cluster-parameter-group --parameter-group-name myclusterparametergroup ``` + *Einzelheiten zur API finden Sie [DeleteClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-parameter-group.html)in AWS CLI der Befehlsreferenz.* ### `delete-cluster-security-group` Das folgende Codebeispiel zeigt die Verwendung`delete-cluster-security-group`. **AWS CLI** Beim Löschen eines GroupThis Clustersicherheitsbeispiels wird eine Cluster-Sicherheitsgruppe gelöscht.Befehl: ``` aws redshift delete-cluster-security-group --cluster-security-group-name mysecuritygroup ``` + *Einzelheiten zur API finden Sie [DeleteClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-security-group.html)in AWS CLI der Befehlsreferenz.* ### `delete-cluster-snapshot` Das folgende Codebeispiel zeigt die Verwendung`delete-cluster-snapshot`. **AWS CLI** Das SnapshotThis Beispiel zum Löschen eines Clusters löscht einen Cluster-Snapshot.Command: ``` aws redshift delete-cluster-snapshot --snapshot-identifier my-snapshot-id ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-snapshot.html).AWS CLI * ### `delete-cluster-subnet-group` Das folgende Codebeispiel zeigt die Verwendung`delete-cluster-subnet-group`. **AWS CLI** Das GroupThis Beispiel „Ein Cluster-Subnetz löschen“ löscht eine Cluster-Subnetzgruppe. Befehl: ``` aws redshift delete-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup ``` Ergebnis: ``` { "ResponseMetadata": { "RequestId": "253fbffd-6993-11e2-bc3a-47431073908a" } } ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DeleteClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-subnet-group.html)AWS CLI * ### `delete-cluster` Das folgende Codebeispiel zeigt die Verwendung`delete-cluster`. **AWS CLI** Das SnapshotThis Beispiel „Cluster ohne endgültigen Cluster löschen“ löscht einen Cluster und erzwingt das Löschen von Daten, sodass kein endgültiger Cluster-Snapshot erstellt wird.Befehl: ``` aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot ``` Das SnapshotThis Beispiel „Cluster löschen, einen finalen Cluster zulassen“ löscht einen Cluster, gibt aber einen endgültigen Cluster-Snapshot an.Befehl: ``` aws redshift delete-cluster --cluster-identifier mycluster --final-cluster-snapshot-identifier myfinalsnapshot ``` + *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster.html).AWS CLI * ### `delete-event-subscription` Das folgende Codebeispiel zeigt die Verwendung`delete-event-subscription`. **AWS CLI** **So löschen Sie ein Ereignisabonnement** Im folgenden Beispiel für `delete-event-subscription` wird das angegebene Benachrichtigungsabonnement für ein Ereignis gelöscht. ``` aws redshift delete-event-subscription \ --subscription-name mysubscription ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-event-subscription.html)in der *AWS CLI Befehlsreferenz*. ### `delete-hsm-client-certificate` Das folgende Codebeispiel zeigt die Verwendung`delete-hsm-client-certificate`. **AWS CLI** **So löschen Sie ein HSM-Clientzertifikat** Im folgenden Beispiel für `delete-hsm-client-certificate` wird ein HSM-Clientzertifikat gelöscht. ``` aws redshift delete-hsm-client-certificate \ --hsm-client-certificate-identifier myhsmclientcert ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Referenz für API-Berechtigungen in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [DeleteHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-client-certificate.html)in der *AWS CLI Befehlsreferenz*. ### `delete-hsm-configuration` Das folgende Codebeispiel zeigt die Verwendung`delete-hsm-configuration`. **AWS CLI** **So löschen Sie eine HSM-Konfiguration** Im folgenden `delete-hsm-configuration` Beispiel wird die angegebene HSM-Konfiguration aus dem aktuellen AWS Konto gelöscht. ``` aws redshift delete-hsm-configuration / --hsm-configuration-identifier myhsmconnection ``` Dieser Befehl erzeugt keine Ausgabe. + Einzelheiten zur API finden Sie unter [DeleteHsmConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-configuration.html)*Befehlsreferenz*. ### `delete-scheduled-action` Das folgende Codebeispiel zeigt die Verwendung`delete-scheduled-action`. **AWS CLI** **So löschen Sie eine geplante Aktion** Der folgende `delete-scheduled-action`-Befehl löscht die angegebene geplante Aktion. ``` aws redshift delete-scheduled-action \ --scheduled-action-name myscheduledaction ``` Dieser Befehl erzeugt keine Ausgabe. + Einzelheiten zur API finden Sie [DeleteScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-scheduled-action.html)in der *AWS CLI Befehlsreferenz*. ### `delete-snapshot-copy-grant` Das folgende Codebeispiel zeigt die Verwendung`delete-snapshot-copy-grant`. **AWS CLI** **So löschen Sie eine Erteilung zum Kopieren von Snapshots** Im folgenden Beispiel für `delete-snapshot-copy-grant` wird die angegebene Erteilung zum Kopieren von Snapshots gelöscht. ``` aws redshift delete-snapshot-copy-grant \ --snapshot-copy-grant-name mysnapshotcopygrantname ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Datenbankverschlüsselung in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [DeleteSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-copy-grant.html)in der *AWS CLI Befehlsreferenz*. ### `delete-snapshot-schedule` Das folgende Codebeispiel zeigt die Verwendung`delete-snapshot-schedule`. **AWS CLI** **So löschen Sie den Snapshot-Zeitplan** Im folgenden Beispiel für `delete-snapshot-schedule` wird der angegebene Snapshot-Zeitplan gelöscht. Sie müssen die Cluster-Zuordnung aufheben, bevor Sie den Zeitplan löschen können. ``` aws redshift delete-snapshot-schedule \ --schedule-identifier mysnapshotschedule ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Zeitpläne für automatisierte Snapshots](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [DeleteSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-schedule.html)in der *AWS CLI Befehlsreferenz*. ### `delete-tags` Das folgende Codebeispiel zeigt die Verwendung`delete-tags`. **AWS CLI** **So löschen Sie Tags aus einem Cluster** Im folgenden Beispiel für `delete-tags` werden die Tags mit den angegebenen Schlüsselnamen aus dem angegebenen Cluster gelöscht. ``` aws redshift delete-tags \ --resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \ --tag-keys "clustertagkey" "clustertagvalue" ``` Dieser Befehl erzeugt keine Ausgabe. Weitere Informationen finden Sie unter [Markieren von Ressourcen in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html) im *Verwaltungshandbuch für Amazon Redshift Cluster*. + Einzelheiten zur API finden Sie [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-tags.html)in der *AWS CLI Befehlsreferenz*. ### `describe-account-attributes` Das folgende Codebeispiel zeigt die Verwendung`describe-account-attributes`. **AWS CLI** **Um die Attribute eines AWS Kontos zu beschreiben** Im folgenden `describe-account-attributes` Beispiel werden die Attribute angezeigt, die dem anrufenden AWS Konto zugeordnet sind. ``` aws redshift describe-account-attributes ``` Ausgabe: ``` { "AccountAttributes": [ { "AttributeName": "max-defer-maintenance-duration", "AttributeValues": [ { "AttributeValue": "45" } ] } ] } ``` + Einzelheiten zur API finden Sie [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-account-attributes.html)unter *AWS CLI Befehlsreferenz*. ### `describe-cluster-db-revisions` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster-db-revisions`. **AWS CLI** **So beschreiben Sie DB-Revisionen für einen Cluster** Im folgenden Beispiel für `describe-cluster-db-revisions` werden die Details eines Arrays von `ClusterDbRevision`-Objekten für den angegebenen Cluster angezeigt. ``` aws redshift describe-cluster-db-revisions \ --cluster-identifier mycluster ``` Ausgabe: ``` { "ClusterDbRevisions": [ { "ClusterIdentifier": "mycluster", "CurrentDatabaseRevision": "11420", "DatabaseRevisionReleaseDate": "2019-11-22T16:43:49.597Z", "RevisionTargets": [] } ] } ``` + Einzelheiten zur API finden Sie [DescribeClusterDbRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-db-revisions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cluster-parameter-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster-parameter-groups`. **AWS CLI** Das GroupsThis Beispiel „Beschreibung aller Clusterparameter abrufen“ gibt eine Beschreibung aller Cluster-Parametergruppen für das Konto mit Spaltenüberschriften zurück. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift describe-cluster-parameter-groups ``` Ergebnis: ``` { "ParameterGroups": [ { "ParameterGroupFamily": "redshift-1.0", "Description": "My first cluster parameter group", "ParameterGroupName": "myclusterparametergroup" } ], "ResponseMetadata": { "RequestId": "8ceb8f6f-64cc-11e2-bea9-49e0ce183f07" } } ``` Sie können dieselben Informationen auch mit der folgenden `--output text` Option im Textformat abrufen: `--output text`Option.Befehl: Option.Befehl: ``` aws redshift describe-cluster-parameter-groups --output text ``` Ergebnis: ``` redshift-1.0 My first cluster parameter group myclusterparametergroup RESPONSEMETADATA 9e665a36-64cc-11e2-8f7d-3b939af52818 ``` + Einzelheiten zur API finden Sie [DescribeClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameter-groups.html)in der *AWS CLI Befehlsreferenz.* ### `describe-cluster-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster-parameters`. **AWS CLI** Das GroupThis Beispiel „Parameter für einen angegebenen Clusterparameter abrufen“ ruft die Parameter für die benannte Parametergruppe ab. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup ``` Ergebnis: ``` { "Parameters": [ { "Description": "Sets the display format for date and time values.", "DataType": "string", "IsModifiable": true, "Source": "engine-default", "ParameterValue": "ISO, MDY", "ParameterName": "datestyle" }, { "Description": "Sets the number of digits displayed for floating-point values", "DataType": "integer", "IsModifiable": true, "AllowedValues": "-15-2", "Source": "engine-default", "ParameterValue": "0", "ParameterName": "extra_float_digits" }, (...remaining output omitted...) ] } ``` Sie können dieselben Informationen auch mit der folgenden `--output text` Option im Textformat abrufen: `--output text`Option.Befehl: Option.Befehl: ``` aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup --output text ``` Ergebnis: ``` RESPONSEMETADATA cdac40aa-64cc-11e2-9e70-918437dd236d Sets the display format for date and time values. string True engine-default ISO, MDY datestyle Sets the number of digits displayed for floating-point values integer True -15-2 engine-default 0 extra_float_digits This parameter applies a user-defined label to a group of queries that are run during the same session.. string True engine-default default query_group require ssl for all databaseconnections boolean True true,false engine-default false require_ssl Sets the schema search order for names that are not schema-qualified. string True engine-default $user, public search_path Aborts any statement that takes over the specified number of milliseconds. integer True engine-default 0 statement_timeout wlm json configuration string True engine-default \[{"query_concurrency":5}] wlm_json_configuration ``` + Einzelheiten zur API finden Sie unter [DescribeClusterParameters AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameters.html)*Befehlsreferenz.* ### `describe-cluster-security-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster-security-groups`. **AWS CLI** Das GroupsThis Beispiel Get a Description of All Cluster Security gibt eine Beschreibung aller Clustersicherheitsgruppen für das Konto zurück. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift describe-cluster-security-groups ``` Ergebnis: ``` { "ClusterSecurityGroups": [ { "OwnerId": "100447751468", "Description": "default", "ClusterSecurityGroupName": "default", "EC2SecurityGroups": \[], "IPRanges": [ { "Status": "authorized", "CIDRIP": "0.0.0.0/0" } ] }, { "OwnerId": "100447751468", "Description": "This is my cluster security group", "ClusterSecurityGroupName": "mysecuritygroup", "EC2SecurityGroups": \[], "IPRanges": \[] }, (...remaining output omitted...) ] } ``` + Einzelheiten zur API finden Sie [DescribeClusterSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-security-groups.html)unter *AWS CLI Befehlsreferenz*. ### `describe-cluster-snapshots` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster-snapshots`. **AWS CLI** Das SnapshotsThis Beispiel Get a Description of All Cluster gibt eine Beschreibung aller Cluster-Snapshots für das Konto zurück. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift describe-cluster-snapshots ``` Ergebnis: ``` { "Snapshots": [ { "Status": "available", "SnapshotCreateTime": "2013-07-17T22:02:22.852Z", "EstimatedSecondsToCompletion": -1, "AvailabilityZone": "us-east-1a", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "Encrypted": false, "OwnerAccount": "111122223333", "BackupProgressInMegabytes": 20.0, "ElapsedTimeInSeconds": 0, "DBName": "dev", "CurrentBackupRateInMegabytesPerSecond: 0.0, "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "ActualIncrementalBackupSizeInMegabytes"; 20.0 "SnapshotType": "automated", "NodeType": "dw.hs1.xlarge", "ClusterIdentifier": "mycluster", "Port": 5439, "TotalBackupSizeInMegabytes": 20.0, "NumberOfNodes": "2", "SnapshotIdentifier": "cm:mycluster-2013-01-22-22-04-18" }, { "EstimatedSecondsToCompletion": 0, "OwnerAccount": "111122223333", "CurrentBackupRateInMegabytesPerSecond: 0.1534, "ActualIncrementalBackupSizeInMegabytes"; 11.0, "NumberOfNodes": "2", "Status": "available", "ClusterVersion": "1.0", "MasterUsername": "adminuser", "AccountsWithRestoreAccess": [ { "AccountID": "444455556666" } ], "TotalBackupSizeInMegabytes": 20.0, "DBName": "dev", "BackupProgressInMegabytes": 11.0, "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "ElapsedTimeInSeconds": 0, "ClusterIdentifier": "mycluster", "SnapshotCreateTime": "2013-07-17T22:04:18.947Z", "AvailabilityZone": "us-east-1a", "NodeType": "dw.hs1.xlarge", "Encrypted": false, "SnapshotType": "manual", "Port": 5439, "SnapshotIdentifier": "my-snapshot-id" } ] } (...remaining output omitted...) ``` + Einzelheiten zur API finden Sie unter [DescribeClusterSnapshots AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-snapshots.html)*Befehlsreferenz.* ### `describe-cluster-subnet-groups` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster-subnet-groups`. **AWS CLI** Das GroupsThis Beispiel Get a Description of All Cluster Subnet gibt eine Beschreibung aller Cluster-Subnetzgruppen zurück. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift describe-cluster-subnet-groups ``` Ergebnis: ``` { "ClusterSubnetGroups": [ { "Subnets": [ { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-763fdd1c", "SubnetAvailabilityZone": { "Name": "us-east-1a" } } ], "VpcId": "vpc-7e3fdd14", "SubnetGroupStatus": "Complete", "Description": "My subnet group", "ClusterSubnetGroupName": "mysubnetgroup" } ], "ResponseMetadata": { "RequestId": "37fa8c89-6990-11e2-8f75-ab4018764c77" } } ``` + Einzelheiten zur API finden Sie unter [DescribeClusterSubnetGroups AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-subnet-groups.html)*Befehlsreferenz*. ### `describe-cluster-tracks` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster-tracks`. **AWS CLI** **So beschreiben Sie Cluster-Tracks** Im folgenden Beispiel für `describe-cluster-tracks` werden Details zu den verfügbaren Wartungspfaden angezeigt. ``` aws redshift describe-cluster-tracks \ --maintenance-track-name current ``` Ausgabe: ``` { "MaintenanceTracks": [ { "MaintenanceTrackName": "current", "DatabaseVersion": "1.0.11420", "UpdateTargets": [ { "MaintenanceTrackName": "preview_features", "DatabaseVersion": "1.0.11746", "SupportedOperations": [ { "OperationName": "restore-from-cluster-snapshot" } ] }, { "MaintenanceTrackName": "trailing", "DatabaseVersion": "1.0.11116", "SupportedOperations": [ { "OperationName": "restore-from-cluster-snapshot" }, { "OperationName": "modify-cluster" } ] } ] } ] } ``` Weitere Informationen finden Sie unter [Auswählen der Cluster-Wartungspfade](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html#rs-mgmt-maintenance-tracks) im *Clusterverwaltungshandbuch für Amazon Redshift*. + Einzelheiten zur API finden Sie [DescribeClusterTracks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-tracks.html)in der *AWS CLI Befehlsreferenz*. ### `describe-cluster-versions` Das folgende Codebeispiel zeigt die Verwendung`describe-cluster-versions`. **AWS CLI** Das VersionsThis Beispiel Get a Description of All Cluster gibt eine Beschreibung aller Clusterversionen zurück. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift describe-cluster-versions ``` Ergebnis: ``` { "ClusterVersions": [ { "ClusterVersion": "1.0", "Description": "Initial release", "ClusterParameterGroupFamily": "redshift-1.0" } ], "ResponseMetadata": { "RequestId": "16a53de3-64cc-11e2-bec0-17624ad140dd" } } ``` + Einzelheiten zur API finden Sie [DescribeClusterVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-versions.html)in der *AWS CLI Befehlsreferenz*. ### `describe-clusters` Das folgende Codebeispiel zeigt die Verwendung`describe-clusters`. **AWS CLI** Das ClustersThis Beispiel „Get a Description of All“ gibt eine Beschreibung aller Cluster für das Konto zurück. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift describe-clusters ``` Ergebnis: ``` { "Clusters": [ { "NodeType": "dw.hs1.xlarge", "Endpoint": { "Port": 5439, "Address": "mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com" }, "ClusterVersion": "1.0", "PubliclyAccessible": "true", "MasterUsername": "adminuser", "ClusterParameterGroups": [ { "ParameterApplyStatus": "in-sync", "ParameterGroupName": "default.redshift-1.0" } ], "ClusterSecurityGroups": [ { "Status": "active", "ClusterSecurityGroupName": "default" } ], "AllowVersionUpgrade": true, "VpcSecurityGroups": \[], "AvailabilityZone": "us-east-1a", "ClusterCreateTime": "2013-01-22T21:59:29.559Z", "PreferredMaintenanceWindow": "sat:03:30-sat:04:00", "AutomatedSnapshotRetentionPeriod": 1, "ClusterStatus": "available", "ClusterIdentifier": "mycluster", "DBName": "dev", "NumberOfNodes": 2, "PendingModifiedValues": {} } ], "ResponseMetadata": { "RequestId": "65b71cac-64df-11e2-8f5b-e90bd6c77476" } } ``` Sie können dieselben Informationen auch mit der folgenden `--output text` Option im Textformat abrufen: `--output text`Option.Befehl: Option.Befehl: ``` aws redshift describe-clusters --output text ``` Ergebnis: ``` dw.hs1.xlarge 1.0 true adminuser True us-east-1a 2013-01-22T21:59:29.559Z sat:03:30-sat:04:00 1 available mycluster dev 2 ENDPOINT 5439 mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com in-sync default.redshift-1.0 active default PENDINGMODIFIEDVALUES RESPONSEMETADATA 934281a8-64df-11e2-b07c-f7fbdd006c67 ``` + Einzelheiten zur API finden Sie [DescribeClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-clusters.html)in der *AWS CLI Befehlsreferenz*. ### `describe-default-cluster-parameters` Das folgende Codebeispiel zeigt die Verwendung`describe-default-cluster-parameters`. **AWS CLI** Das ParametersThis Beispiel „Beschreibung des Standard-Clusters abrufen“ gibt eine Beschreibung der Standard-Clusterparameter für die `redshift-1.0` Familie zurück. JSON ist das Standardausgabeformat. Befehl: ``` aws redshift describe-default-cluster-parameters --parameter-group-family redshift-1.0 ``` Ergebnis: ``` { "DefaultClusterParameters": { "ParameterGroupFamily": "redshift-1.0", "Parameters": [ { "Description": "Sets the display format for date and time values.", "DataType": "string", "IsModifiable": true, "Source": "engine-default", "ParameterValue": "ISO, MDY", "ParameterName": "datestyle" }, { "Description": "Sets the number of digits displayed for floating-point values", "DataType": "integer", "IsModifiable": true, "AllowedValues": "-15-2", "Source": "engine-default", "ParameterValue": "0", "ParameterName": "extra_float_digits" }, (...remaining output omitted...) ] } } ``` Führen Sie den `describe-cluster-parameter-groups`-Befehl aus, um eine Liste der gültigen Parametergruppenfamilien anzuzeigen. `describe-cluster-parameter-groups`-Befehl. Befehl. + Einzelheiten zur API finden Sie [DescribeDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-default-cluster-parameters.html)unter *AWS CLI Befehlsreferenz*. ### `describe-event-categories` Das folgende Codebeispiel zeigt die Verwendung`describe-event-categories`. **AWS CLI** **So beschreiben Sie Ereigniskategorien für einen Cluster** Im folgenden Beispiel für `describe-event-categories` werden Details zu den Ereigniskategorien für einen Cluster angezeigt. ``` aws redshift describe-event-categories \ --source-type cluster ``` Ausgabe: ``` { "EventCategoriesMapList": [ { "SourceType": "cluster", "Events": [ { "EventId": "REDSHIFT-EVENT-2000", "EventCategories": [ "management" ], "EventDescription": "Cluster created at