

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.

# API-Referenz
<a name="api-reference"></a>

Die API-Operationen im Account Management (`account`) -Namespace ermöglichen es Ihnen, Ihre AWS-Konto zu ändern.

Jeder AWS-Konto unterstützt Metadaten mit Informationen über das Konto, einschließlich Informationen über bis zu drei alternative Kontakte, die dem Konto zugeordnet sind. Diese gelten zusätzlich zu der E-Mail-Adresse, die dem [Root-Benutzer](root-user.md) des Kontos zugeordnet ist. Sie können jeweils nur einen der folgenden Kontakttypen angeben, die einem Konto zugeordnet sind.
+ Ansprechpartner für die Rechnungsstellung
+ Ansprechpartner für den operativen Bereich
+ Ansprechpartner für Sicherheitsfragen

Standardmäßig gelten die in diesem Handbuch beschriebenen API-Operationen direkt für das Konto, das den Vorgang aufruft. Bei der [Identität](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html) in dem Konto, das den Vorgang aufruft, handelt es sich in der Regel um eine IAM-Rolle oder einen IAM-Benutzer. Für den Aufruf des API-Vorgangs ist eine entsprechende Genehmigung durch eine IAM-Richtlinie erforderlich. Alternativ können Sie diese API-Operationen von einer Identität in einem AWS Organizations Verwaltungskonto aus aufrufen und die Konto-ID-Nummer für jedes AWS-Konto Mitglied der Organisation angeben.

 **API-Version** 

Diese Version der Accounts API Reference dokumentiert die Account Management API-Version 2021-02-01.

**Anmerkung**  
Als Alternative zur direkten Verwendung der API können Sie eine der verwenden AWS SDKs, die aus Bibliotheken und Beispielcode für verschiedene Programmiersprachen und Plattformen (Java, Ruby, .NET, iOS, Android und mehr) besteht. SDKs Sie bieten eine bequeme Möglichkeit, programmatischen Zugriff auf AWS Organizations zu erstellen. SDKs Sie kümmern sich beispielsweise darum, Anfragen kryptografisch zu signieren, Fehler zu verwalten und Anfragen automatisch zu wiederholen. Weitere Informationen zu den AWS SDKs, einschließlich deren Download und Installation, finden Sie unter [Tools für Amazon Web Services](https://console.aws.amazon.com/).

Wir empfehlen, dass Sie den verwenden AWS SDKs , um programmatische API-Aufrufe an den Account Management Service zu tätigen. Sie können jedoch auch die Account Management Query API verwenden, um direkte Aufrufe an den Account Management-Webdienst zu tätigen. Weitere Informationen zur Account Management Query API finden Sie [Aufrufen der API mittels HTTP-Abfrageanforderungen](query-requests.md) im Account Management User Guide. Organizations unterstützt GET- und POST-Anfragen für alle Aktionen. Das heißt, die API verlangt nicht, dass Sie für einige Aktionen GET und für andere POST verwenden. Allerdings unterliegen GET-Anforderungen der Größenbeschränkung von URLs. Verwenden Sie daher für Operationen, die größere Mengen erfordern, eine POST-Anforderung.

**Signieren von Anforderungen**

Wenn Sie HTTP-Anfragen an senden AWS, müssen Sie die Anfragen signieren, damit Sie feststellen AWS können, wer sie gesendet hat. Sie signieren Anfragen mit Ihrem AWS Zugriffsschlüssel, der aus einer Zugriffsschlüssel-ID und einem geheimen Zugriffsschlüssel besteht. Wir empfehlen dringend, keinen Zugriffsschlüssel für Ihr Root-Konto zu erstellen. Jeder, der den Zugriffsschlüssel für Ihr Root-Konto hat, hat uneingeschränkten Zugriff auf alle Ressourcen in Ihrem Konto. Erstellen Sie stattdessen einen Zugriffsschlüssel für einen IAM-Benutzer, der über Administratorrechte verfügt. Als weitere Option können Sie den AWS Security Token Service verwenden, um temporäre Sicherheitsanmeldeinformationen zu generieren und diese Anmeldeinformationen zum Signieren von Anfragen zu verwenden.

Zum Signieren von Anfragen empfehlen wir, Signature Version 4 zu verwenden. Wenn Sie über eine bestehende Anwendung verfügen, die Signature Version 2 verwendet, müssen Sie sie nicht aktualisieren, um Signature Version 4 zu verwenden. Für einige Operationen ist jetzt jedoch Signature Version 4 erforderlich. In der Dokumentation für Operationen, für die Version 4 erforderlich ist, wird auf diese Anforderung hingewiesen. Weitere Informationen finden Sie im *IAM-Benutzerhandbuch* unter [AWS API-Anfragen signieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html).

Wenn Sie die AWS Befehlszeilenschnittstelle (AWS CLI) oder eine der Schnittstellen verwenden, AWS SDKs um Anfragen zu stellen AWS, signieren diese Tools die Anfragen automatisch für Sie mit dem Zugriffsschlüssel, den Sie bei der Konfiguration der Tools angeben.

**Support und Feedback für die Kontoverwaltung**

Wir freuen uns über Ihr Feedback. Senden Sie Ihre Kommentare an [feedback-awsaccounts@amazon.com](mailto://feedback-awsaccounts@amazon.com) oder posten Sie Ihr Feedback und Ihre Fragen im [Account Management-Supportforum](https://forums.aws.amazon.com/forum.jspa?forumID=219). Weitere Informationen zu den AWS [Support-Foren finden Sie in der Foren-Hilfe](https://forums.aws.amazon.com/help.jspa).

**Wie werden Beispiele präsentiert**

Das von der Kontoverwaltung als Antwort auf Ihre Anfragen zurückgegebene JSON wird als einzelne lange Zeichenfolge ohne Zeilenumbrüche oder Formatierungsleerzeichen zurückgegeben. In den Beispielen in diesem Handbuch werden sowohl Zeilenumbrüche als auch Leerzeichen angezeigt, um die Lesbarkeit zu verbessern. Wenn Beispieleingabeparameter auch zu langen Zeichenketten führen würden, die über den Bildschirm hinausragen, fügen wir Zeilenumbrüche ein, um die Lesbarkeit zu verbessern. Sie sollten die Eingabe immer als einzelne JSON-Textzeichenfolge einreichen.

**API-Anfragen aufzeichnen**

Account Management unterstützt CloudTrail, einen Service, der AWS API-Aufrufe für Sie aufzeichnet AWS-Konto und Protokolldateien an einen Amazon S3 S3-Bucket übermittelt. Anhand der von gesammelten Informationen können Sie feststellen CloudTrail, welche Anfragen erfolgreich an die Kontoverwaltung gestellt wurden, wer die Anfrage gestellt hat, wann sie gestellt wurde usw. Weitere Informationen zur Kontoverwaltung und deren Unterstützung für CloudTrail finden Sie unter[Protokollieren von API-Aufrufen für die AWS Kontoverwaltung mit AWS CloudTrail](monitoring-cloudtrail.md). Weitere Informationen darüber CloudTrail, wie Sie sie aktivieren und Ihre Protokolldateien finden, finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

# Aktionen
<a name="API_Operations"></a>

Folgende Aktionen werden unterstützt:
+  [AcceptPrimaryEmailUpdate](API_AcceptPrimaryEmailUpdate.md) 
+  [DeleteAlternateContact](API_DeleteAlternateContact.md) 
+  [DisableRegion](API_DisableRegion.md) 
+  [EnableRegion](API_EnableRegion.md) 
+  [GetAccountInformation](API_GetAccountInformation.md) 
+  [GetAlternateContact](API_GetAlternateContact.md) 
+  [GetContactInformation](API_GetContactInformation.md) 
+  [GetGovCloudAccountInformation](API_GetGovCloudAccountInformation.md) 
+  [GetPrimaryEmail](API_GetPrimaryEmail.md) 
+  [GetRegionOptStatus](API_GetRegionOptStatus.md) 
+  [ListRegions](API_ListRegions.md) 
+  [PutAccountName](API_PutAccountName.md) 
+  [PutAlternateContact](API_PutAlternateContact.md) 
+  [PutContactInformation](API_PutContactInformation.md) 
+  [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) 

# AcceptPrimaryEmailUpdate
<a name="API_AcceptPrimaryEmailUpdate"></a>

Akzeptiert die Anfrage [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) zur Aktualisierung der primären E-Mail-Adresse (auch bekannt als Root-Benutzer-E-Mail-Adresse) für das angegebene Konto.

## Anforderungssyntax
<a name="API_AcceptPrimaryEmailUpdate_RequestSyntax"></a>

```
POST /acceptPrimaryEmailUpdate HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "Otp": "string",
   "PrimaryEmail": "string"
}
```

## URI-Anfrageparameter
<a name="API_AcceptPrimaryEmailUpdate_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_AcceptPrimaryEmailUpdate_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer an, auf AWS-Konto die Sie mit diesem Vorgang zugreifen oder die Sie ändern möchten. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Bei der angegebenen Konto-ID muss es sich um ein Mitgliedskonto in derselben Organisation handeln. Für die Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Dieser Vorgang kann nur über das Verwaltungskonto oder das delegierte Administratorkonto einer Organisation für ein Mitgliedskonto aufgerufen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben.
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Ja

 ** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-request-Otp"></a>
Der OTP-Code, der an den beim `StartPrimaryEmailUpdate` API-Aufruf `PrimaryEmail` angegebenen Benutzer gesendet wurde.  
Typ: Zeichenfolge  
Pattern: `[a-zA-Z0-9]{6}`   
Erforderlich: Ja

 ** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-request-PrimaryEmail"></a>
Die neue primäre E-Mail-Adresse zur Verwendung mit dem angegebenen Konto. Dies muss mit `PrimaryEmail` dem `StartPrimaryEmailUpdate` API-Aufruf übereinstimmen.  
Typ: Zeichenfolge  
Längenbeschränkungen: Mindestlänge von 5. Maximale Länge beträgt 64 Zeichen.  
Erforderlich: Ja

## Antwortsyntax
<a name="API_AcceptPrimaryEmailUpdate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Status": "string"
}
```

## Antwortelemente
<a name="API_AcceptPrimaryEmailUpdate_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [Status](#API_AcceptPrimaryEmailUpdate_ResponseSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-response-Status"></a>
Ruft den Status der akzeptierten primären E-Mail-Aktualisierungsanfrage ab.  
Typ: Zeichenfolge  
Zulässige Werte: `PENDING | ACCEPTED` 

## Fehler
<a name="API_AcceptPrimaryEmailUpdate_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die aufrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** ConflictException **   
Die Anfrage konnte aufgrund eines Konflikts im aktuellen Status der Ressource nicht bearbeitet werden. Dies ist beispielsweise der Fall, wenn Sie versuchen, eine Region zu aktivieren, die derzeit deaktiviert ist (im Status DEAKTIVIERT), oder wenn Sie versuchen, die Root-Benutzer-E-Mail-Adresse eines Kontos in eine E-Mail-Adresse zu ändern, die bereits verwendet wird.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 409

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Der Vorgang ist fehlgeschlagen, weil eine Ressource angegeben wurde, die nicht gefunden werden kann.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 404

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_AcceptPrimaryEmailUpdate_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AcceptPrimaryEmailUpdate) 

# DeleteAlternateContact
<a name="API_DeleteAlternateContact"></a>

Löscht den angegebenen alternativen Kontakt aus einem AWS-Konto.

Vollständige Informationen zur Verwendung der alternativen Kontaktfunktionen finden Sie unter [Aktualisieren der alternativen Kontakte für Ihre AWS-Konto](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).

**Anmerkung**  
Bevor Sie die alternativen Kontaktinformationen für eine Person aktualisieren können AWS-Konto , die von verwaltet wird AWS Organizations, müssen Sie zunächst die Integration zwischen der AWS Kontoverwaltung und Organizations aktivieren. Weitere Informationen finden Sie unter [Vertrauenswürdigen Zugriff für die AWS Kontoverwaltung aktivieren](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).

## Anforderungssyntax
<a name="API_DeleteAlternateContact_RequestSyntax"></a>

```
POST /deleteAlternateContact HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "AlternateContactType": "string"
}
```

## URI-Anfrageparameter
<a name="API_DeleteAlternateContact_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_DeleteAlternateContact_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_DeleteAlternateContact_RequestSyntax) **   <a name="accounts-DeleteAlternateContact-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer des AWS Kontos an, auf das Sie mit diesem Vorgang zugreifen oder das Sie ändern möchten.  
Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das AWS Konto der Identität verwendet, die zum Aufrufen des Vorgangs verwendet wurde.  
Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) oder um ein delegiertes Administratorkonto handeln, und die angegebene Konto-ID muss ein Mitgliedskonto in derselben Organisation sein. In der Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen`AccountId`, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an und rufen Sie den Vorgang mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

 ** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) **   <a name="accounts-DeleteAlternateContact-request-AlternateContactType"></a>
Gibt an, welcher der alternativen Kontakte gelöscht werden soll.   
Typ: Zeichenfolge  
Zulässige Werte: `BILLING | OPERATIONS | SECURITY`   
Erforderlich: Ja

## Antwortsyntax
<a name="API_DeleteAlternateContact_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Antwortelemente
<a name="API_DeleteAlternateContact_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

## Fehler
<a name="API_DeleteAlternateContact_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die anrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Der Vorgang ist fehlgeschlagen, weil eine Ressource angegeben wurde, die nicht gefunden werden kann.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 404

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Beispiele
<a name="API_DeleteAlternateContact_Examples"></a>

### Beispiel 1
<a name="API_DeleteAlternateContact_Example_1"></a>

Im folgenden Beispiel wird der alternative Sicherheitskontakt für das Konto gelöscht, dessen Anmeldeinformationen zum Aufrufen des Vorgangs verwendet werden. 

#### Beispielanforderung
<a name="API_DeleteAlternateContact_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact

{
   "AccountName":"MyAccount"
}
```

#### Beispielantwort
<a name="API_DeleteAlternateContact_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

### Beispiel 2
<a name="API_DeleteAlternateContact_Example_2"></a>

Im folgenden Beispiel wird der alternative Abrechnungskontakt für das angegebene Mitgliedskonto in einer Organisation gelöscht. Sie müssen die Anmeldeinformationen entweder aus dem Verwaltungskonto der Organisation oder aus dem delegierten Administratorkonto des Kontoverwaltungsdienstes verwenden.

#### Beispielanforderung
<a name="API_DeleteAlternateContact_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact

{
   "AccountId":"123456789012",
   "AlternateContactType":"BILLING"
}
```

#### Beispielantwort
<a name="API_DeleteAlternateContact_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

## Weitere Informationen finden Sie unter:
<a name="API_DeleteAlternateContact_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DeleteAlternateContact) 

# DisableRegion
<a name="API_DisableRegion"></a>

Deaktiviert (deaktiviert) eine bestimmte Region für ein Konto.

**Anmerkung**  
Durch die Deaktivierung einer Region wird jeglicher IAM-Zugriff auf alle Ressourcen, die sich in dieser Region befinden, entfernt.

## Anforderungssyntax
<a name="API_DisableRegion_RequestSyntax"></a>

```
POST /disableRegion HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "RegionName": "string"
}
```

## URI-Anfrageparameter
<a name="API_DisableRegion_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_DisableRegion_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_DisableRegion_RequestSyntax) **   <a name="accounts-DisableRegion-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer der Person an, auf AWS-Konto die Sie mit diesem Vorgang zugreifen oder die Sie ändern möchten. Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das Amazon Web Services Services-Konto der Identität verwendet, die zum Aufrufen des Vorgangs verwendet wurde. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Die angegebene Konto-ID muss ein Mitgliedskonto in derselben Organisation sein. Für die Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an. Rufen Sie den Vorgang stattdessen mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

 ** [RegionName](#API_DisableRegion_RequestSyntax) **   <a name="accounts-DisableRegion-request-RegionName"></a>
Gibt den Regionalcode für einen bestimmten Regionsnamen an (z. B.`af-south-1`). Wenn Sie eine Region deaktivieren, AWS führt Aktionen aus, um diese Region in Ihrem Konto zu deaktivieren, z. B. die Zerstörung von IAM-Ressourcen in der Region. Dieser Vorgang nimmt für die meisten Konten ein paar Minuten in Anspruch, kann aber auch einige Stunden dauern. Sie können die Region erst aktivieren, wenn der Deaktivierungsvorgang vollständig abgeschlossen ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Ja

## Antwortsyntax
<a name="API_DisableRegion_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Antwortelemente
<a name="API_DisableRegion_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

## Fehler
<a name="API_DisableRegion_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die Identität des Anrufers nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 403

 ** ConflictException **   
Die Anfrage konnte aufgrund eines Konflikts im aktuellen Status der Ressource nicht bearbeitet werden. Dies ist beispielsweise der Fall, wenn Sie versuchen, eine Region zu aktivieren, die derzeit deaktiviert ist (im Status DEAKTIVIERT), oder wenn Sie versuchen, die Root-Benutzer-E-Mail-Adresse eines Kontos in eine E-Mail-Adresse zu ändern, die bereits verwendet wird.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 409

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Versuchen Sie den Vorgang später erneut.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP Status Code: 500

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_DisableRegion_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DisableRegion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DisableRegion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DisableRegion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DisableRegion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DisableRegion) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DisableRegion) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DisableRegion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DisableRegion) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DisableRegion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DisableRegion) 

# EnableRegion
<a name="API_EnableRegion"></a>

Aktiviert (aktiviert) eine bestimmte Region für ein Konto.

## Anforderungssyntax
<a name="API_EnableRegion_RequestSyntax"></a>

```
POST /enableRegion HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "RegionName": "string"
}
```

## URI-Anfrageparameter
<a name="API_EnableRegion_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_EnableRegion_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_EnableRegion_RequestSyntax) **   <a name="accounts-EnableRegion-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer an, auf AWS-Konto die Sie mit diesem Vorgang zugreifen oder die Sie ändern möchten. Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das Amazon Web Services Services-Konto der Identität verwendet, die zum Aufrufen des Vorgangs verwendet wurde. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Bei der angegebenen Konto-ID muss es sich um ein Mitgliedskonto in derselben Organisation handeln. Für die Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an. Rufen Sie den Vorgang stattdessen mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

 ** [RegionName](#API_EnableRegion_RequestSyntax) **   <a name="accounts-EnableRegion-request-RegionName"></a>
Gibt den Regionalcode für einen bestimmten Regionsnamen an (z. B.`af-south-1`). Wenn Sie eine Region aktivieren, führt AWS Aktionen zur Vorbereitung Ihres Kontos in der jeweiligen Region aus, z. B. die Verteilung Ihrer IAM-Ressourcen in die Region. Dieser Vorgang dauert bei den meisten Konten einige Minuten, kann aber auch mehrere Stunden dauern. Sie können eine Region erst verwenden, wenn dieser Vorgang abgeschlossen ist. Darüber hinaus können Sie die Region erst deaktivieren, wenn der Aktivierungsvorgang vollständig abgeschlossen ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Ja

## Antwortsyntax
<a name="API_EnableRegion_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Antwortelemente
<a name="API_EnableRegion_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

## Fehler
<a name="API_EnableRegion_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die aufrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 403

 ** ConflictException **   
Die Anfrage konnte aufgrund eines Konflikts im aktuellen Status der Ressource nicht bearbeitet werden. Dies ist beispielsweise der Fall, wenn Sie versuchen, eine Region zu aktivieren, die derzeit deaktiviert ist (im Status DEAKTIVIERT), oder wenn Sie versuchen, die Root-Benutzer-E-Mail-Adresse eines Kontos in eine E-Mail-Adresse zu ändern, die bereits verwendet wird.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 409

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP Status Code: 500

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_EnableRegion_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/EnableRegion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/EnableRegion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/EnableRegion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/EnableRegion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/EnableRegion) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/EnableRegion) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/EnableRegion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/EnableRegion) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/EnableRegion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/EnableRegion) 

# GetAccountInformation
<a name="API_GetAccountInformation"></a>

Ruft Informationen über das angegebene Konto ab, einschließlich seines Kontonamens, seiner Konto-ID sowie des Datums und der Uhrzeit der Kontoerstellung. Um diese API verwenden zu können, muss ein IAM-Benutzer oder eine IAM-Rolle über die `account:GetAccountInformation` IAM-Berechtigung verfügen. 

## Anforderungssyntax
<a name="API_GetAccountInformation_RequestSyntax"></a>

```
POST /getAccountInformation HTTP/1.1
Content-type: application/json

{
   "AccountId": "string"
}
```

## URI-Anfrageparameter
<a name="API_GetAccountInformation_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_GetAccountInformation_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_GetAccountInformation_RequestSyntax) **   <a name="accounts-GetAccountInformation-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer des AWS Kontos an, auf das Sie mit diesem Vorgang zugreifen oder das Sie ändern möchten.  
Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das AWS Konto der Identität verwendet, mit der der Vorgang aufgerufen wurde.  
Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) oder um ein delegiertes Administratorkonto handeln, und die angegebene Konto-ID muss ein Mitgliedskonto in derselben Organisation sein. In der Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen`AccountId`, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an und rufen Sie den Vorgang mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

## Antwortsyntax
<a name="API_GetAccountInformation_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountCreatedDate": "string",
   "AccountId": "string",
   "AccountName": "string"
}
```

## Antwortelemente
<a name="API_GetAccountInformation_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) **   <a name="accounts-GetAccountInformation-response-AccountCreatedDate"></a>
Datum und Uhrzeit der Kontoerstellung.  
Typ: Zeitstempel

 ** [AccountId](#API_GetAccountInformation_ResponseSyntax) **   <a name="accounts-GetAccountInformation-response-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer des Kontos an, auf AWS-Konto das Sie mit diesem Vorgang zugreifen oder das Sie ändern möchten. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Bei der angegebenen Konto-ID muss es sich um ein Mitgliedskonto in derselben Organisation handeln. Für die Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Dieser Vorgang kann nur über das Verwaltungskonto oder das delegierte Administratorkonto einer Organisation für ein Mitgliedskonto aufgerufen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben.
Typ: Zeichenfolge  
Pattern: `\d{12}` 

 ** [AccountName](#API_GetAccountInformation_ResponseSyntax) **   <a name="accounts-GetAccountInformation-response-AccountName"></a>
Der Name des Kontos.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Pattern: `[ -;=?-~]+` 

## Fehler
<a name="API_GetAccountInformation_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die aufrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Versuchen Sie den Vorgang später erneut.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP Status Code: 500

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Beispiele
<a name="API_GetAccountInformation_Examples"></a>

### Beispiel 1
<a name="API_GetAccountInformation_Example_1"></a>

Im folgenden Beispiel werden die Kontoinformationen für das Konto abgerufen, dessen Anmeldeinformationen zum Aufrufen des Vorgangs verwendet werden. 

#### Beispielanforderung
<a name="API_GetAccountInformation_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
                    
{}
```

#### Beispielantwort
<a name="API_GetAccountInformation_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyAccount",
   "AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```

### Beispiel 2
<a name="API_GetAccountInformation_Example_2"></a>

Im folgenden Beispiel werden die Kontoinformationen für das angegebene Mitgliedskonto in einer Organisation abgerufen. Sie müssen die Anmeldeinformationen entweder aus dem Verwaltungskonto der Organisation oder aus dem delegierten Administratorkonto des Kontoverwaltungsdienstes verwenden. 

#### Beispielanforderung
<a name="API_GetAccountInformation_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
                    
{
   "AccountId": "123456789012" 
}
```

#### Beispielantwort
<a name="API_GetAccountInformation_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyMemberAccount",
   "AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```

## Weitere Informationen finden Sie unter:
<a name="API_GetAccountInformation_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation) 

# GetAlternateContact
<a name="API_GetAlternateContact"></a>

Ruft den angegebenen alternativen Kontakt ab, der an einen AWS-Konto angehängt ist.

Vollständige Informationen zur Verwendung der alternativen Kontaktoperationen finden Sie unter [Aktualisieren der alternativen Kontakte für Ihre AWS-Konto](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).

**Anmerkung**  
Bevor Sie die alternativen Kontaktinformationen für eine Person aktualisieren können AWS-Konto , die von verwaltet wird AWS Organizations, müssen Sie zunächst die Integration zwischen der AWS Kontoverwaltung und Organizations aktivieren. Weitere Informationen finden Sie unter [Vertrauenswürdigen Zugriff für die AWS Kontoverwaltung aktivieren](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).

## Anforderungssyntax
<a name="API_GetAlternateContact_RequestSyntax"></a>

```
POST /getAlternateContact HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "AlternateContactType": "string"
}
```

## URI-Anfrageparameter
<a name="API_GetAlternateContact_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_GetAlternateContact_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_GetAlternateContact_RequestSyntax) **   <a name="accounts-GetAlternateContact-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer des AWS Kontos an, auf das Sie mit diesem Vorgang zugreifen oder das Sie ändern möchten.  
Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das AWS Konto der Identität verwendet, die zum Aufrufen des Vorgangs verwendet wurde.  
Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) oder um ein delegiertes Administratorkonto handeln, und die angegebene Konto-ID muss ein Mitgliedskonto in derselben Organisation sein. In der Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen`AccountId`, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an und rufen Sie den Vorgang mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

 ** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) **   <a name="accounts-GetAlternateContact-request-AlternateContactType"></a>
Gibt an, welchen alternativen Kontakt Sie abrufen möchten.  
Typ: Zeichenfolge  
Zulässige Werte: `BILLING | OPERATIONS | SECURITY`   
Erforderlich: Ja

## Antwortsyntax
<a name="API_GetAlternateContact_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AlternateContact": { 
      "AlternateContactType": "string",
      "EmailAddress": "string",
      "Name": "string",
      "PhoneNumber": "string",
      "Title": "string"
   }
}
```

## Antwortelemente
<a name="API_GetAlternateContact_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) **   <a name="accounts-GetAlternateContact-response-AlternateContact"></a>
Eine Struktur, die die Details für den angegebenen alternativen Kontakt enthält.  
Typ: [AlternateContact](API_AlternateContact.md) Objekt

## Fehler
<a name="API_GetAlternateContact_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die anrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Der Vorgang ist fehlgeschlagen, weil eine Ressource angegeben wurde, die nicht gefunden werden kann.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 404

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Beispiele
<a name="API_GetAlternateContact_Examples"></a>

### Beispiel 1
<a name="API_GetAlternateContact_Example_1"></a>

Im folgenden Beispiel wird der alternative Sicherheitskontakt für das Konto abgerufen, dessen Anmeldeinformationen zum Aufrufen des Vorgangs verwendet werden. 

#### Beispielanforderung
<a name="API_GetAlternateContact_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact

{
   "AlternateContactType":"SECURITY"
}
```

#### Beispielantwort
<a name="API_GetAlternateContact_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json

{
   "AlternateContact":{
      "Name":"Anika",
      "Title":"COO",
      "EmailAddress":"anika@example.com",
      "PhoneNumber":"206-555-0198",
      "AlternateContactType":"Security"
   }
}
```

### Beispiel 2
<a name="API_GetAlternateContact_Example_2"></a>

Im folgenden Beispiel wird der alternative Betriebskontakt für das angegebene Mitgliedskonto in einer Organisation abgerufen. Sie müssen die Anmeldeinformationen entweder aus dem Verwaltungskonto der Organisation oder aus dem delegierten Administratorkonto des Kontoverwaltungsdienstes verwenden.

#### Beispielanforderung
<a name="API_GetAlternateContact_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact

{
   "AccountId":"123456789012",
   "AlternateContactType":"Operations"
}
```

#### Beispielantwort
<a name="API_GetAlternateContact_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json

{
   "AlternateContact":{
      "Name":"Anika",
      "Title":"COO",
      "EmailAddress":"anika@example.com",
      "PhoneNumber":"206-555-0198",
      "AlternateContactType":"Operations"
   }
}
```

## Weitere Informationen finden Sie unter:
<a name="API_GetAlternateContact_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAlternateContact) 

# GetContactInformation
<a name="API_GetContactInformation"></a>

Ruft die primären Kontaktinformationen eines AWS-Konto ab.

Vollständige Informationen zur Verwendung der primären Kontaktfunktionen finden Sie unter [Aktualisieren des primären Kontakts für Ihren AWS-Konto](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).

## Anforderungssyntax
<a name="API_GetContactInformation_RequestSyntax"></a>

```
POST /getContactInformation HTTP/1.1
Content-type: application/json

{
   "AccountId": "string"
}
```

## URI-Anfrageparameter
<a name="API_GetContactInformation_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_GetContactInformation_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_GetContactInformation_RequestSyntax) **   <a name="accounts-GetContactInformation-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer der Person an, auf AWS-Konto die Sie mit diesem Vorgang zugreifen oder die Sie ändern möchten. Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das Amazon Web Services Services-Konto der Identität verwendet, die zum Aufrufen des Vorgangs verwendet wurde. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Bei der angegebenen Konto-ID muss es sich um ein Mitgliedskonto in derselben Organisation handeln. Für die Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an. Rufen Sie den Vorgang stattdessen mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

## Antwortsyntax
<a name="API_GetContactInformation_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ContactInformation": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "AddressLine3": "string",
      "City": "string",
      "CompanyName": "string",
      "CountryCode": "string",
      "DistrictOrCounty": "string",
      "FullName": "string",
      "PhoneNumber": "string",
      "PostalCode": "string",
      "StateOrRegion": "string",
      "WebsiteUrl": "string"
   }
}
```

## Antwortelemente
<a name="API_GetContactInformation_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [ContactInformation](#API_GetContactInformation_ResponseSyntax) **   <a name="accounts-GetContactInformation-response-ContactInformation"></a>
Enthält die Details der primären Kontaktinformationen, die mit einem verknüpft sind AWS-Konto.  
Typ: [ContactInformation](API_ContactInformation.md) Objekt

## Fehler
<a name="API_GetContactInformation_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die anrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Der Vorgang ist fehlgeschlagen, weil eine Ressource angegeben wurde, die nicht gefunden werden kann.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 404

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_GetContactInformation_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetContactInformation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetContactInformation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetContactInformation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetContactInformation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetContactInformation) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetContactInformation) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetContactInformation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetContactInformation) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetContactInformation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetContactInformation) 

# GetGovCloudAccountInformation
<a name="API_GetGovCloudAccountInformation"></a>

Ruft Informationen über das GovCloud Konto ab, das mit dem angegebenen Standardkonto verknüpft ist (falls vorhanden), einschließlich der GovCloud Konto-ID und des Status. Um diese API verwenden zu können, muss ein IAM-Benutzer oder eine IAM-Rolle über die `account:GetGovCloudAccountInformation` IAM-Berechtigung verfügen. 

## Anforderungssyntax
<a name="API_GetGovCloudAccountInformation_RequestSyntax"></a>

```
POST /getGovCloudAccountInformation HTTP/1.1
Content-type: application/json

{
   "StandardAccountId": "string"
}
```

## URI-Anfrageparameter
<a name="API_GetGovCloudAccountInformation_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_GetGovCloudAccountInformation_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) **   <a name="accounts-GetGovCloudAccountInformation-request-StandardAccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer des AWS Kontos an, auf das Sie mit diesem Vorgang zugreifen oder das Sie ändern möchten.  
Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das AWS Konto der Identität verwendet, mit der der Vorgang aufgerufen wurde.  
Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) oder um ein delegiertes Administratorkonto handeln, und die angegebene Konto-ID muss ein Mitgliedskonto in derselben Organisation sein. In der Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein, und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen`AccountId`, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an und rufen Sie den Vorgang mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

## Antwortsyntax
<a name="API_GetGovCloudAccountInformation_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountState": "string",
   "GovCloudAccountId": "string"
}
```

## Antwortelemente
<a name="API_GetGovCloudAccountInformation_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) **   <a name="accounts-GetGovCloudAccountInformation-response-AccountState"></a>
Der Kontostatus des verknüpften GovCloud Kontos.  
Typ: Zeichenfolge  
Zulässige Werte: `PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED` 

 ** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) **   <a name="accounts-GetGovCloudAccountInformation-response-GovCloudAccountId"></a>
Die 12-stellige Konto-ID-Nummer des verknüpften GovCloud Kontos.  
Typ: Zeichenfolge  
Pattern: `\d{12}` 

## Fehler
<a name="API_GetGovCloudAccountInformation_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die anrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Der Vorgang ist fehlgeschlagen, weil eine Ressource angegeben wurde, die nicht gefunden werden kann.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 404

 ** ResourceUnavailableException **   
Der Vorgang ist fehlgeschlagen, weil eine Ressource angegeben wurde, die derzeit nicht verfügbar ist.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 424

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Beispiele
<a name="API_GetGovCloudAccountInformation_Examples"></a>

### Beispiel 1
<a name="API_GetGovCloudAccountInformation_Example_1"></a>

Im folgenden Beispiel werden die verknüpften GovCloud Kontoinformationen für das Konto abgerufen, dessen Anmeldeinformationen zum Aufrufen des Vorgangs verwendet werden. 

#### Beispielanforderung
<a name="API_GetGovCloudAccountInformation_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{}
```

#### Beispielantwort
<a name="API_GetGovCloudAccountInformation_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "GovCloudAccountId": "123456789012",
   "AccountState": "ACTIVE"
}
```

### Beispiel 2
<a name="API_GetGovCloudAccountInformation_Example_2"></a>

Im folgenden Beispiel werden die verknüpften GovCloud Kontoinformationen für das angegebene Mitgliedskonto in einer Organisation abgerufen. Sie müssen die Anmeldeinformationen entweder aus dem Verwaltungskonto der Organisation oder aus dem delegierten Administratorkonto des Kontoverwaltungsdienstes verwenden. 

#### Beispielanforderung
<a name="API_GetGovCloudAccountInformation_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{
   "StandardAccountId": "111111111111" 
}
```

#### Beispielantwort
<a name="API_GetGovCloudAccountInformation_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "GovCloudAccountId": "123456789012",
   "AccountState": "ACTIVE"
}
```

### Beispiel 3
<a name="API_GetGovCloudAccountInformation_Example_3"></a>

Im folgenden Beispiel wird versucht, die verknüpften GovCloud Kontoinformationen für ein Standardkonto abzurufen, das nicht mit einem GovCloud Konto verknüpft ist. 

#### Beispielanforderung
<a name="API_GetGovCloudAccountInformation_Example_3_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{
   "StandardAccountId": "222222222222" 
}
```

#### Beispielantwort
<a name="API_GetGovCloudAccountInformation_Example_3_Response"></a>

```
HTTP/1.1 404
Content-Type: application/json
                    
{
   "message":"GovCloud Account ID not found for Standard Account - 222222222222."
}
```

## Weitere Informationen finden Sie unter:
<a name="API_GetGovCloudAccountInformation_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation) 

# GetPrimaryEmail
<a name="API_GetPrimaryEmail"></a>

Ruft die primäre E-Mail-Adresse für das angegebene Konto ab.

## Anforderungssyntax
<a name="API_GetPrimaryEmail_RequestSyntax"></a>

```
POST /getPrimaryEmail HTTP/1.1
Content-type: application/json

{
   "AccountId": "string"
}
```

## URI-Anfrageparameter
<a name="API_GetPrimaryEmail_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_GetPrimaryEmail_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_GetPrimaryEmail_RequestSyntax) **   <a name="accounts-GetPrimaryEmail-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer an, auf AWS-Konto die Sie mit diesem Vorgang zugreifen oder die Sie ändern möchten. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Bei der angegebenen Konto-ID muss es sich um ein Mitgliedskonto in derselben Organisation handeln. Für die Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Dieser Vorgang kann nur über das Verwaltungskonto oder das delegierte Administratorkonto einer Organisation für ein Mitgliedskonto aufgerufen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben.
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Ja

## Antwortsyntax
<a name="API_GetPrimaryEmail_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "PrimaryEmail": "string"
}
```

## Antwortelemente
<a name="API_GetPrimaryEmail_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) **   <a name="accounts-GetPrimaryEmail-response-PrimaryEmail"></a>
Ruft die primäre E-Mail-Adresse ab, die dem angegebenen Konto zugeordnet ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Mindestlänge von 5. Maximale Länge beträgt 64 Zeichen.

## Fehler
<a name="API_GetPrimaryEmail_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die aufrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Der Vorgang ist fehlgeschlagen, weil eine Ressource angegeben wurde, die nicht gefunden werden kann.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 404

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_GetPrimaryEmail_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetPrimaryEmail) 

# GetRegionOptStatus
<a name="API_GetRegionOptStatus"></a>

Ruft den Opt-In-Status einer bestimmten Region ab.

## Anforderungssyntax
<a name="API_GetRegionOptStatus_RequestSyntax"></a>

```
POST /getRegionOptStatus HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "RegionName": "string"
}
```

## URI-Anfrageparameter
<a name="API_GetRegionOptStatus_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_GetRegionOptStatus_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_GetRegionOptStatus_RequestSyntax) **   <a name="accounts-GetRegionOptStatus-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer der Person an, auf AWS-Konto die Sie mit diesem Vorgang zugreifen oder die Sie ändern möchten. Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das Amazon Web Services Services-Konto der Identität verwendet, die zum Aufrufen des Vorgangs verwendet wurde. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Bei der angegebenen Konto-ID muss es sich um ein Mitgliedskonto in derselben Organisation handeln. Für die Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an. Rufen Sie den Vorgang stattdessen mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

 ** [RegionName](#API_GetRegionOptStatus_RequestSyntax) **   <a name="accounts-GetRegionOptStatus-request-RegionName"></a>
Gibt den Regionalcode für einen bestimmten Regionsnamen an (z. B.`af-south-1`). Diese Funktion gibt den Status der Region zurück, die Sie an diesen Parameter übergeben.   
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Ja

## Antwortsyntax
<a name="API_GetRegionOptStatus_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "RegionName": "string",
   "RegionOptStatus": "string"
}
```

## Antwortelemente
<a name="API_GetRegionOptStatus_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) **   <a name="accounts-GetRegionOptStatus-response-RegionName"></a>
Der Regionalcode, der übergeben wurde.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.

 ** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) **   <a name="accounts-GetRegionOptStatus-response-RegionOptStatus"></a>
Einer der möglichen Status, den eine Region haben kann (Aktiviert, Aktiviert, Deaktiviert, Deaktiviert, Deaktiviert, Enabled\$1By\$1Default).  
Typ: Zeichenfolge  
Zulässige Werte: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` 

## Fehler
<a name="API_GetRegionOptStatus_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die aufrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP Status Code: 500

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_GetRegionOptStatus_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetRegionOptStatus) 

# ListRegions
<a name="API_ListRegions"></a>

Listet alle Regionen für ein bestimmtes Konto und ihren jeweiligen Opt-in-Status auf. Optional kann diese Liste nach dem Parameter gefiltert werden. `region-opt-status-contains` 

## Anforderungssyntax
<a name="API_ListRegions_RequestSyntax"></a>

```
POST /listRegions HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "MaxResults": number,
   "NextToken": "string",
   "RegionOptStatusContains": [ "string" ]
}
```

## URI-Anfrageparameter
<a name="API_ListRegions_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_ListRegions_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer an, auf AWS-Konto die Sie mit diesem Vorgang zugreifen oder die Sie ändern möchten. Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das Amazon Web Services Services-Konto der Identität verwendet, die zum Aufrufen des Vorgangs verwendet wurde. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Bei der angegebenen Konto-ID muss es sich um ein Mitgliedskonto in derselben Organisation handeln. Für die Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an. Rufen Sie den Vorgang stattdessen mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

 ** [MaxResults](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-MaxResults"></a>
Die Gesamtzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtzahl der verfügbaren Elemente den angegebenen Wert übersteigt, `NextToken` wird in der Ausgabe des Befehls a angegeben. Um die Seitennummerierung fortzusetzen, geben Sie den `NextToken`-Wert im `starting-token`-Argument eines nachfolgenden Befehls an. Verwenden Sie das `NextToken` Antwortelement nicht direkt außerhalb der AWS CLI. Anwendungsbeispiele finden Sie unter [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle*.   
Typ: Ganzzahl  
Gültiger Bereich: Mindestwert 1. Maximaler Wert von 50.  
Erforderlich: Nein

 ** [NextToken](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-NextToken"></a>
Ein Token, mit dem angegeben wird, wo mit der Paginierung begonnen werden soll. Dies ist eine Antwort `NextToken` aus einer zuvor gekürzten Antwort. Anwendungsbeispiele finden Sie unter [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle*.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 1 000 Zeichen.  
Erforderlich: Nein

 ** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-RegionOptStatusContains"></a>
Eine Liste von Regionsstatus (Aktiviert, Aktiviert, Deaktiviert, Deaktiviert, Enabled\$1by\$1Default), anhand derer die Liste der Regionen für ein bestimmtes Konto gefiltert werden kann. Wenn Sie beispielsweise den Wert ENABLING übergeben, wird nur eine Liste von Regionen mit dem Regionsstatus ENABLING zurückgegeben.  
Typ: Zeichenfolgen-Array  
Zulässige Werte: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`   
Erforderlich: Nein

## Antwortsyntax
<a name="API_ListRegions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Regions": [ 
      { 
         "RegionName": "string",
         "RegionOptStatus": "string"
      }
   ]
}
```

## Antwortelemente
<a name="API_ListRegions_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [NextToken](#API_ListRegions_ResponseSyntax) **   <a name="accounts-ListRegions-response-NextToken"></a>
Wenn mehr Daten zurückgegeben werden müssen, werden diese aufgefüllt. Es sollte an den `next-token` Anforderungsparameter von übergeben werden`list-regions`.  
Typ: Zeichenfolge

 ** [Regions](#API_ListRegions_ResponseSyntax) **   <a name="accounts-ListRegions-response-Regions"></a>
Dies ist eine Liste von Regionen für ein bestimmtes Konto oder, falls der gefilterte Parameter verwendet wurde, eine Liste von Regionen, die den im `filter` Parameter festgelegten Filterkriterien entsprechen.  
Typ: Array von [Region](API_Region.md)-Objekten

## Fehler
<a name="API_ListRegions_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die aufrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_ListRegions_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/ListRegions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions) 

# PutAccountName
<a name="API_PutAccountName"></a>

Aktualisiert den Kontonamen des angegebenen Kontos. Um diese API verwenden zu können, müssen IAM-Prinzipale über die `account:PutAccountName` IAM-Berechtigung verfügen. 

## Anforderungssyntax
<a name="API_PutAccountName_RequestSyntax"></a>

```
POST /putAccountName HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "AccountName": "string"
}
```

## URI-Anfrageparameter
<a name="API_PutAccountName_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_PutAccountName_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer des AWS Kontos an, auf das Sie mit diesem Vorgang zugreifen oder das Sie ändern möchten.  
Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das AWS Konto der Identität verwendet, mit der der Vorgang aufgerufen wurde.  
Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) oder um ein delegiertes Administratorkonto handeln, und die angegebene Konto-ID muss ein Mitgliedskonto in derselben Organisation sein. In der Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein, und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen`AccountId`, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an und rufen Sie den Vorgang mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

 ** [AccountName](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountName"></a>
Der Name des Kontos.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Pattern: `[ -;=?-~]+`   
Erforderlich: Ja

## Antwortsyntax
<a name="API_PutAccountName_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Antwortelemente
<a name="API_PutAccountName_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

## Fehler
<a name="API_PutAccountName_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die aufrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Versuchen Sie den Vorgang später erneut.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP Status Code: 500

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwortheader eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Beispiele
<a name="API_PutAccountName_Examples"></a>

### Beispiel 1
<a name="API_PutAccountName_Example_1"></a>

Im folgenden Beispiel wird der Name des Kontos aktualisiert, dessen Anmeldeinformationen zum Aufrufen des Vorgangs verwendet werden. 

#### Beispielanforderung
<a name="API_PutAccountName_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountName":"MyAccount"
}
```

#### Beispielantwort
<a name="API_PutAccountName_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

### Beispiel 2
<a name="API_PutAccountName_Example_2"></a>

Im folgenden Beispiel wird der Kontoname für das angegebene Mitgliedskonto in einer Organisation aktualisiert. Sie müssen die Anmeldeinformationen entweder aus dem Verwaltungskonto der Organisation oder aus dem delegierten Administratorkonto des Kontoverwaltungsdienstes verwenden. 

#### Beispielanforderung
<a name="API_PutAccountName_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyMemberAccount"
}
```

#### Beispielantwort
<a name="API_PutAccountName_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

## Weitere Informationen finden Sie unter:
<a name="API_PutAccountName_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAccountName) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName) 

# PutAlternateContact
<a name="API_PutAlternateContact"></a>

Ändert den angegebenen alternativen Kontakt, der an einen AWS-Konto angehängt ist.

Vollständige Informationen zur Verwendung der alternativen Kontaktfunktionen finden Sie unter [Aktualisieren der alternativen Kontakte für Ihre AWS-Konto](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).

**Anmerkung**  
Bevor Sie die alternativen Kontaktinformationen für eine Person aktualisieren können AWS-Konto , die von verwaltet wird AWS Organizations, müssen Sie zunächst die Integration zwischen der AWS Kontoverwaltung und Organizations aktivieren. Weitere Informationen finden Sie unter [Vertrauenswürdigen Zugriff für die AWS Kontoverwaltung aktivieren](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).

## Anforderungssyntax
<a name="API_PutAlternateContact_RequestSyntax"></a>

```
POST /putAlternateContact HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "AlternateContactType": "string",
   "EmailAddress": "string",
   "Name": "string",
   "PhoneNumber": "string",
   "Title": "string"
}
```

## URI-Anfrageparameter
<a name="API_PutAlternateContact_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_PutAlternateContact_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer des AWS Kontos an, auf das Sie mit diesem Vorgang zugreifen oder das Sie ändern möchten.  
Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das AWS Konto der Identität verwendet, mit der der Vorgang aufgerufen wurde.  
Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) oder um ein delegiertes Administratorkonto handeln, und die angegebene Konto-ID muss ein Mitgliedskonto in derselben Organisation sein. In der Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen`AccountId`, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an und rufen Sie den Vorgang mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

 ** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-AlternateContactType"></a>
Gibt an, welchen alternativen Kontakt Sie erstellen oder aktualisieren möchten.  
Typ: Zeichenfolge  
Zulässige Werte: `BILLING | OPERATIONS | SECURITY`   
Erforderlich: Ja

 ** [EmailAddress](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-EmailAddress"></a>
Gibt eine E-Mail-Adresse für den alternativen Kontakt an.   
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 254.  
Pattern: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`   
Erforderlich: Ja

 ** [Name](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-Name"></a>
Gibt einen Namen für den alternativen Kontakt an.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.  
Erforderlich: Ja

 ** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-PhoneNumber"></a>
Gibt eine Telefonnummer für den alternativen Kontakt an.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 25.  
Pattern: `[\s0-9()+-]+`   
Erforderlich: Ja

 ** [Title](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-Title"></a>
Gibt einen Titel für den alternativen Kontakt an.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Ja

## Antwortsyntax
<a name="API_PutAlternateContact_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Antwortelemente
<a name="API_PutAlternateContact_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

## Fehler
<a name="API_PutAlternateContact_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die anrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Beispiele
<a name="API_PutAlternateContact_Examples"></a>

### Beispiel 1
<a name="API_PutAlternateContact_Example_1"></a>

Im folgenden Beispiel wird der alternative Abrechnungskontakt für das Konto festgelegt, dessen Anmeldeinformationen zum Aufrufen des Vorgangs verwendet werden.

#### Beispielanforderung
<a name="API_PutAlternateContact_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact

{
    "AlternateContactType": "Billing",
    "Name": "Carlos Salazar",
    "Title": "CFO",
    "EmailAddress": "carlos@example.com",
    "PhoneNumber": "206-555-0199"
}
```

#### Beispielantwort
<a name="API_PutAlternateContact_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

### Beispiel 2
<a name="API_PutAlternateContact_Example_2"></a>

Im folgenden Beispiel wird der alternative Abrechnungskontakt für das angegebene Mitgliedskonto in einer Organisation festgelegt oder überschrieben. Sie müssen die Anmeldeinformationen entweder aus dem Verwaltungskonto der Organisation oder aus dem delegierten Administratorkonto des Kontoverwaltungsdienstes verwenden.

#### Beispielanforderung
<a name="API_PutAlternateContact_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact

{
    "AccountId": "123456789012",
    "AlternateContactType": "Billing",
    "Name": "Carlos Salazar",
    "Title": "CFO",
    "EmailAddress": "carlos@example.com",
    "PhoneNumber": "206-555-0199"
}
```

#### Beispielantwort
<a name="API_PutAlternateContact_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

## Weitere Informationen finden Sie unter:
<a name="API_PutAlternateContact_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAlternateContact) 

# PutContactInformation
<a name="API_PutContactInformation"></a>

Aktualisiert die primären Kontaktinformationen eines AWS-Konto.

Vollständige Informationen zur Verwendung der primären Kontaktfunktionen finden Sie unter [Aktualisieren des primären Ansprechpartners für Ihren AWS-Konto](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).

## Anforderungssyntax
<a name="API_PutContactInformation_RequestSyntax"></a>

```
POST /putContactInformation HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "ContactInformation": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "AddressLine3": "string",
      "City": "string",
      "CompanyName": "string",
      "CountryCode": "string",
      "DistrictOrCounty": "string",
      "FullName": "string",
      "PhoneNumber": "string",
      "PostalCode": "string",
      "StateOrRegion": "string",
      "WebsiteUrl": "string"
   }
}
```

## URI-Anfrageparameter
<a name="API_PutContactInformation_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_PutContactInformation_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_PutContactInformation_RequestSyntax) **   <a name="accounts-PutContactInformation-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer der Person an, auf AWS-Konto die Sie mit diesem Vorgang zugreifen oder die Sie ändern möchten. Wenn Sie diesen Parameter nicht angeben, wird standardmäßig das Amazon Web Services Services-Konto der Identität verwendet, die zum Aufrufen des Vorgangs verwendet wurde. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Bei der angegebenen Konto-ID muss es sich um ein Mitgliedskonto in derselben Organisation handeln. In der Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein, und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben. Es muss den Vorgang im eigenständigen Kontext aufrufen, ohne den `AccountId` Parameter einzubeziehen.
Um diesen Vorgang für ein Konto aufzurufen, das nicht Mitglied einer Organisation ist, geben Sie diesen Parameter nicht an. Rufen Sie den Vorgang stattdessen mit einer Identität auf, die zu dem Konto gehört, dessen Kontakte Sie abrufen oder ändern möchten.  
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Nein

 ** [ContactInformation](#API_PutContactInformation_RequestSyntax) **   <a name="accounts-PutContactInformation-request-ContactInformation"></a>
Enthält die Details der primären Kontaktinformationen, die mit einem verknüpft sind AWS-Konto.  
Typ: [ContactInformation](API_ContactInformation.md) Objekt  
Erforderlich: Ja

## Antwortsyntax
<a name="API_PutContactInformation_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Antwortelemente
<a name="API_PutContactInformation_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

## Fehler
<a name="API_PutContactInformation_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die anrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_PutContactInformation_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutContactInformation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutContactInformation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutContactInformation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutContactInformation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutContactInformation) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutContactInformation) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutContactInformation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutContactInformation) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutContactInformation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutContactInformation) 

# StartPrimaryEmailUpdate
<a name="API_StartPrimaryEmailUpdate"></a>

Startet den Vorgang zur Aktualisierung der primären E-Mail-Adresse für das angegebene Konto.

## Anforderungssyntax
<a name="API_StartPrimaryEmailUpdate_RequestSyntax"></a>

```
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "PrimaryEmail": "string"
}
```

## URI-Anfrageparameter
<a name="API_StartPrimaryEmailUpdate_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_StartPrimaryEmailUpdate_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-request-AccountId"></a>
Gibt die 12-stellige Konto-ID-Nummer an, auf AWS-Konto die Sie mit diesem Vorgang zugreifen oder die Sie ändern möchten. Um diesen Parameter verwenden zu können, muss es sich bei dem Anrufer um eine Identität im [Verwaltungskonto der Organisation oder um ein delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) handeln. Bei der angegebenen Konto-ID muss es sich um ein Mitgliedskonto in derselben Organisation handeln. Für die Organisation müssen [alle Funktionen aktiviert](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) sein und für die Organisation muss der [vertrauenswürdige Zugriff](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) für den Kontoverwaltungsdienst aktiviert und optional ein [delegiertes Administratorkonto](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) zugewiesen werden.  
Dieser Vorgang kann nur über das Verwaltungskonto oder das delegierte Administratorkonto einer Organisation für ein Mitgliedskonto aufgerufen werden.  
Das Verwaltungskonto kann kein eigenes `AccountId` Konto angeben.
Typ: Zeichenfolge  
Pattern: `\d{12}`   
Erforderlich: Ja

 ** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-request-PrimaryEmail"></a>
Die neue primäre E-Mail-Adresse (auch bekannt als Root-Benutzer-E-Mail-Adresse), die für das angegebene Konto verwendet werden soll.  
Typ: Zeichenfolge  
Längenbeschränkungen: Mindestlänge von 5. Maximale Länge beträgt 64 Zeichen.  
Erforderlich: Ja

## Antwortsyntax
<a name="API_StartPrimaryEmailUpdate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Status": "string"
}
```

## Antwortelemente
<a name="API_StartPrimaryEmailUpdate_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-response-Status"></a>
Der Status der primären E-Mail-Aktualisierungsanfrage.  
Typ: Zeichenfolge  
Zulässige Werte: `PENDING | ACCEPTED` 

## Fehler
<a name="API_StartPrimaryEmailUpdate_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Der Vorgang ist fehlgeschlagen, da die anrufende Identität nicht über die erforderlichen Mindestberechtigungen verfügt.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 403

 ** ConflictException **   
Die Anfrage konnte aufgrund eines Konflikts im aktuellen Status der Ressource nicht bearbeitet werden. Dies ist beispielsweise der Fall, wenn Sie versuchen, eine Region zu aktivieren, die derzeit deaktiviert ist (im Status DEAKTIVIERT), oder wenn Sie versuchen, die Root-Benutzer-E-Mail-Adresse eines Kontos in eine E-Mail-Adresse zu ändern, die bereits verwendet wird.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 409

 ** InternalServerException **   
Der Vorgang ist aufgrund eines internen Fehlers von fehlgeschlagen AWS. Führen Sie den Vorgang später erneut aus.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Der Vorgang ist fehlgeschlagen, weil eine Ressource angegeben wurde, die nicht gefunden werden kann.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 404

 ** TooManyRequestsException **   
Der Vorgang schlug fehl, weil er zu häufig aufgerufen wurde und ein Drossellimit überschritten wurde.    
 ** errorType **   
Der Wert, der von API Gateway in den `x-amzn-ErrorType` Antwort-Header eingegeben wurde.
HTTP-Statuscode: 429

 ** ValidationException **   
Der Vorgang ist fehlgeschlagen, weil einer der Eingabeparameter ungültig war.    
 ** fieldList **   
Das Feld, in dem der ungültige Eintrag erkannt wurde.  
 ** message **   
Die Nachricht, die Sie darüber informiert, was an der Anfrage ungültig war.  
 ** reason **   
Der Grund, warum die Überprüfung fehlgeschlagen ist.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_StartPrimaryEmailUpdate_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/StartPrimaryEmailUpdate) 

# Verwandte Aktionen in anderen AWS Diensten
<a name="API_Related_Operations"></a>

Die folgenden Operationen beziehen sich auf den AWS Organizations Namespace, sind AWS -Kontenverwaltung aber Teil davon:
+ [CreateAccount](API_CreateAccount.md)
+ [CreateGovCloudAccount](API_CreateGovCloudAccount.md)
+ [DescribeAccount](API_DescribeAccount.md)

# CreateAccount
<a name="API_CreateAccount"></a>

Der `CreateAccount` API-Vorgang kann nur im Kontext einer Organisation verwendet werden, die vom AWS Organizations Dienst verwaltet wird. Die API-Operation ist im Namespace dieses Dienstes definiert.

Weitere Informationen finden Sie unter [CreateAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateAccount.html) in der *AWS Organizations -API-Referenz*.

# CreateGovCloudAccount
<a name="API_CreateGovCloudAccount"></a>

Der `CreateGovCloudAccount` API-Vorgang kann nur im Kontext einer Organisation verwendet werden, die vom AWS Organizations Dienst verwaltet wird. Die API-Operation ist im Namespace dieses Dienstes definiert.

Weitere Informationen finden Sie unter [CreateGovCloudAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateGovCloudAccount.html) in der *AWS Organizations -API-Referenz*.

# DescribeAccount
<a name="API_DescribeAccount"></a>

Der `DescribeAccount` API-Vorgang kann nur im Kontext einer Organisation verwendet werden, die vom AWS Organizations Dienst verwaltet wird. Die API-Operation ist im Namespace dieses Dienstes definiert.

Weitere Informationen finden Sie unter [DescribeAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html) in der *AWS Organizations -API-Referenz*.

# Datentypen
<a name="API_Types"></a>

Die folgenden Datentypen werden unterstützt:
+  [AlternateContact](API_AlternateContact.md) 
+  [ContactInformation](API_ContactInformation.md) 
+  [Region](API_Region.md) 
+  [ValidationExceptionField](API_ValidationExceptionField.md) 

# AlternateContact
<a name="API_AlternateContact"></a>

Eine Struktur, die die Details eines alternativen Kontakts enthält, der einem AWS Konto zugeordnet ist

## Inhalt
<a name="API_AlternateContact_Contents"></a>

 ** AlternateContactType **   <a name="accounts-Type-AlternateContact-AlternateContactType"></a>
Die Art des alternativen Kontakts.  
Typ: Zeichenfolge  
Zulässige Werte: `BILLING | OPERATIONS | SECURITY`   
Erforderlich: Nein

 ** EmailAddress **   <a name="accounts-Type-AlternateContact-EmailAddress"></a>
Die mit diesem alternativen Kontakt verknüpfte E-Mail-Adresse.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 254.  
Pattern: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`   
Erforderlich: Nein

 ** Name **   <a name="accounts-Type-AlternateContact-Name"></a>
Der Name, der diesem alternativen Kontakt zugeordnet ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.  
Erforderlich: Nein

 ** PhoneNumber **   <a name="accounts-Type-AlternateContact-PhoneNumber"></a>
Die diesem alternativen Kontakt zugeordnete Telefonnummer.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 25.  
Pattern: `[\s0-9()+-]+`   
Erforderlich: Nein

 ** Title **   <a name="accounts-Type-AlternateContact-Title"></a>
Der Titel, der diesem alternativen Kontakt zugeordnet ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Nein

## Weitere Informationen finden Sie unter:
<a name="API_AlternateContact_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AlternateContact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AlternateContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AlternateContact) 

# ContactInformation
<a name="API_ContactInformation"></a>

Enthält die Details der primären Kontaktinformationen, die mit einem verknüpft sind AWS-Konto.

## Inhalt
<a name="API_ContactInformation_Contents"></a>

 ** AddressLine1 **   <a name="accounts-Type-ContactInformation-AddressLine1"></a>
Die erste Zeile der primären Kontaktadresse.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 60.  
Erforderlich: Ja

 ** City **   <a name="accounts-Type-ContactInformation-City"></a>
Die Stadt der primären Kontaktadresse.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Ja

 ** CountryCode **   <a name="accounts-Type-ContactInformation-CountryCode"></a>
Der zweibuchstabige ISO-3166-Ländercode für die primäre Kontaktadresse.  
Typ: Zeichenfolge  
Längenbeschränkungen: Feste Länge von 2.  
Erforderlich: Ja

 ** FullName **   <a name="accounts-Type-ContactInformation-FullName"></a>
Der vollständige Name der primären Kontaktadresse.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Ja

 ** PhoneNumber **   <a name="accounts-Type-ContactInformation-PhoneNumber"></a>
Die Telefonnummer der primären Kontaktinformationen. Die Nummer wird validiert und in einigen Ländern auf Aktivierung überprüft.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 20.  
Pattern: `[+][\s0-9()-]+`   
Erforderlich: Ja

 ** PostalCode **   <a name="accounts-Type-ContactInformation-PostalCode"></a>
Die Postleitzahl der primären Kontaktadresse.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 20.  
Erforderlich: Ja

 ** AddressLine2 **   <a name="accounts-Type-ContactInformation-AddressLine2"></a>
Die zweite Zeile der primären Kontaktadresse, falls vorhanden.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 60.  
Erforderlich: Nein

 ** AddressLine3 **   <a name="accounts-Type-ContactInformation-AddressLine3"></a>
Die dritte Zeile der primären Kontaktadresse, falls vorhanden.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 60.  
Erforderlich: Nein

 ** CompanyName **   <a name="accounts-Type-ContactInformation-CompanyName"></a>
Der Name des Unternehmens, das mit den primären Kontaktinformationen verknüpft ist, falls vorhanden.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Nein

 ** DistrictOrCounty **   <a name="accounts-Type-ContactInformation-DistrictOrCounty"></a>
Der Bezirk oder Bezirk der primären Kontaktadresse, falls vorhanden.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Nein

 ** StateOrRegion **   <a name="accounts-Type-ContactInformation-StateOrRegion"></a>
Das Bundesland oder die Region der primären Kontaktadresse. Wenn sich die Postanschrift in den Vereinigten Staaten (USA) befindet, kann der Wert in diesem Feld entweder ein zweistelliger Landescode (z. B.`NJ`) oder der vollständige Name des Bundesstaates (z. B.`New Jersey`) sein. Dieses Feld ist in den folgenden Ländern erforderlich: `US``CA`, `GB``DE`,`JP`,`IN`, und`BR`.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Nein

 ** WebsiteUrl **   <a name="accounts-Type-ContactInformation-WebsiteUrl"></a>
Die URL der Website, die mit den primären Kontaktinformationen verknüpft ist, falls vorhanden.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Nein

## Weitere Informationen finden Sie unter:
<a name="API_ContactInformation_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ContactInformation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ContactInformation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ContactInformation) 

# Region
<a name="API_Region"></a>

Dies ist eine Struktur, die die Region für ein bestimmtes Konto ausdrückt und aus einem Namen und einem Opt-in-Status besteht.

## Inhalt
<a name="API_Region_Contents"></a>

 ** RegionName **   <a name="accounts-Type-Region-RegionName"></a>
Der Regionalcode einer bestimmten Region (z. B.`us-east-1`).  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge = 50 Zeichen.  
Erforderlich: Nein

 ** RegionOptStatus **   <a name="accounts-Type-Region-RegionOptStatus"></a>
Einer der möglichen Status, den eine Region haben kann (Aktiviert, Aktiviert, Deaktiviert, Deaktiviert, Deaktiviert, Enabled\$1By\$1Default).  
Typ: Zeichenfolge  
Zulässige Werte: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`   
Erforderlich: Nein

## Weitere Informationen finden Sie unter:
<a name="API_Region_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden: AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/Region) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/Region) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/Region) 

# ValidationExceptionField
<a name="API_ValidationExceptionField"></a>

Die Eingabe erfüllte die vom AWS Dienst in einem angegebenen Feld angegebenen Einschränkungen nicht.

## Inhalt
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="accounts-Type-ValidationExceptionField-message"></a>
Eine Meldung über die Validierungsausnahme.  
Typ: Zeichenfolge  
Erforderlich: Ja

 ** name **   <a name="accounts-Type-ValidationExceptionField-name"></a>
Der Feldname, in dem der ungültige Eintrag erkannt wurde.  
Typ: Zeichenfolge  
Erforderlich: Ja

## Weitere Informationen finden Sie unter:
<a name="API_ValidationExceptionField_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ValidationExceptionField) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ValidationExceptionField) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ValidationExceptionField) 

# Geläufige Parameter
<a name="CommonParameters"></a>

Die folgende Liste enthält die Parameter, die alle Aktionen zum Signieren von Signature-Version-4-Anforderungen mit einer Abfragezeichenfolge verwenden. Alle aktionsspezifischen Parameter werden im Thema für diese Aktion aufgelistet. Weitere Informationen zu Signature Version 4 finden Sie unter [Signieren von AWS API-Anfragen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) im *IAM-Benutzerhandbuch*.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
Der Hashalgorithmus, den Sie zum Erstellen der Anforderungssignatur verwendet haben.  
Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen.  
Type: Zeichenkette  
Zulässige Werte: `AWS4-HMAC-SHA256`   
Required: Conditional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
Der Wert des Anmeldeinformationsumfangs. Dabei handelt es sich um eine Zeichenfolge, die Ihren Zugriffsschlüssel, das Datum, die gewünschte Region und eine Zeichenfolge zur Beendigung („aws4\$1request“) beinhaltet. Der Wert wird im folgenden Format ausgedrückt: *Zugriffsschlüssel*/*JJJJMMTT*/*Region*/*Service*/aws4\$1request.  
Weitere Informationen finden Sie im *IAM-Benutzerhandbuch* unter [Erstellen einer signierten AWS API-Anfrage](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html).  
Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen.  
Type: Zeichenkette  
Required: Conditional

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
Das Datum, das zum Erstellen der Signatur verwendet wird. Das Format muss das ISO 8601-Basisformat (JJJJMMTT'T'SSMMSS'Z') sein. Beispielsweise ist das folgende Datum und Uhrzeit ein gültiger X-Amz-Date Wert:`20120325T120000Z`.  
Bedingung: X-Amz-Date ist bei allen Anforderungen optional. Damit kann das Datum überschrieben werden, das zum Signieren von Anforderungen verwendet wird. Wenn der Date-Header im ISO 8601-Grundformat angegeben ist, X-Amz-Date ist dies nicht erforderlich. Wenn verwendet X-Amz-Date wird, überschreibt er immer den Wert des Date-Headers. Weitere Informationen finden Sie unter [Elemente einer AWS API-Anforderungssignatur](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) im *IAM-Benutzerhandbuch*.  
Type: Zeichenkette  
Required: Conditional

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
Das temporäre Sicherheitstoken, das durch einen Aufruf von AWS -Security-Token-Service (AWS STS) abgerufen wurde. Eine Liste der Services, die temporäre Sicherheits-Anmeldeinformationen von AWS STS unterstützen, finden Sie im *IAM-Benutzerhandbuch* unter [AWS-Services , die mit IAM funktionieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html).  
Bedingung: Wenn Sie temporäre Sicherheitsanmeldedaten von verwenden AWS STS, müssen Sie das Sicherheitstoken angeben.  
Type: Zeichenkette  
Required: Conditional

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Gibt die hex-codierte Signatur an, die aus der zu signierenden Zeichenfolge und dem abgeleiteten Signaturschlüssel berechnet wurde.  
Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen.  
Type: Zeichenkette  
Required: Conditional

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Gibt alle HTTP-Header an, die als Teil der kanonischen Anforderung enthalten waren. Weitere Informationen zur Angabe signierter Header finden Sie unter [Erstellen einer signierten AWS API-Anfrage](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) im *IAM-Benutzerhandbuch*.  
Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen.  
Type: Zeichenkette  
Required: Conditional

# Häufige Fehlertypen
<a name="CommonErrors"></a>

In diesem Abschnitt werden häufig auftretende Fehlertypen aufgeführt, die dieser AWS Dienst möglicherweise zurückgibt. Nicht alle Dienste geben alle hier aufgeführten Fehlertypen zurück. Informationen zu Fehlern, die spezifisch für eine API-Aktion für diesen Service sind, finden Sie unter dem Thema für diese API-Aktion.

 **AccessDeniedException**   <a name="CommonErrors-AccessDeniedException"></a>
Sie sind nicht berechtigt, diese Aktion auszuführen. Stellen Sie sicher, dass Ihre IAM-Richtlinie die erforderlichen Berechtigungen enthält.  
HTTP-Statuscode: 403

 **ExpiredTokenException**   <a name="CommonErrors-ExpiredTokenException"></a>
Das in der Anfrage enthaltene Sicherheitstoken ist abgelaufen. Fordern Sie ein neues Sicherheitstoken an und versuchen Sie es erneut.  
HTTP-Statuscode: 403

 **IncompleteSignature**   <a name="CommonErrors-IncompleteSignature"></a>
Die Anforderungssignatur entspricht nicht den AWS Standards. Stellen Sie sicher, dass Sie gültige AWS Anmeldeinformationen verwenden und dass Ihre Anfrage richtig formatiert ist. Wenn Sie ein SDK verwenden, stellen Sie sicher, dass es auf dem neuesten Stand ist.  
HTTP-Statuscode: 403

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
Die Anfrage kann derzeit aufgrund eines internen Serverproblems nicht bearbeitet werden. Bitte versuchen Sie es später erneut. Wenn das Problem weiterhin besteht, wenden Sie sich an den AWS Support.  
HTTP Status Code: 500

 **MalformedHttpRequestException**   <a name="CommonErrors-MalformedHttpRequestException"></a>
Der Text der Anfrage kann nicht verarbeitet werden. Dies ist normalerweise der Fall, wenn der Anforderungstext nicht mit dem angegebenen Algorithmus zur Inhaltskodierung dekomprimiert werden kann. Stellen Sie sicher, dass der Header für die Inhaltskodierung dem verwendeten Komprimierungsformat entspricht.  
HTTP-Statuscode: 400

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Sie sind nicht berechtigt, diese Aktion auszuführen. Stellen Sie sicher, dass Ihre IAM-Richtlinie die erforderlichen Berechtigungen enthält.  
HTTP-Statuscode: 401

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
Ihr AWS Konto benötigt ein Abonnement für diesen Service. Stellen Sie sicher, dass Sie den Dienst in Ihrem Konto aktiviert haben.  
HTTP-Statuscode: 403

 **RequestAbortedException**   <a name="CommonErrors-RequestAbortedException"></a>
Die Anfrage wurde abgebrochen, bevor eine Antwort zurückgegeben werden konnte. Dies passiert normalerweise, wenn der Client die Verbindung schließt.  
HTTP-Statuscode: 400

 **RequestEntityTooLargeException**   <a name="CommonErrors-RequestEntityTooLargeException"></a>
Die Anforderungsentität ist zu groß. Reduzieren Sie die Größe des Anfragetexts und versuchen Sie es erneut.  
HTTP-Statuscode: 413

 **RequestTimeoutException**   <a name="CommonErrors-RequestTimeoutException"></a>
Das Zeitlimit für die Anfrage wurde überschritten. Der Server hat die vollständige Anfrage nicht innerhalb des erwarteten Zeitraums erhalten. Bitte versuchen Sie es erneut.  
HTTP-Statuscode: 408

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
Der Service ist vorübergehend nicht verfügbar. Bitte versuchen Sie es später erneut.  
HTTP Status Code: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
Ihre Anforderungsrate ist zu hoch. Anfragen, die diese Ausnahme erhalten, werden AWS SDKs automatisch wiederholt. Verringern Sie die Häufigkeit der Anforderungen.  
HTTP-Statuscode: 400

 **UnknownOperationException**   <a name="CommonErrors-UnknownOperationException"></a>
Die Aktion oder der Vorgang wurde nicht erkannt. Stellen Sie sicher, dass der Aktionsname richtig geschrieben ist und dass er von der von Ihnen verwendeten API-Version unterstützt wird.  
HTTP-Statuscode: 404

 **UnrecognizedClientException**   <a name="CommonErrors-UnrecognizedClientException"></a>
Das von Ihnen angegebene X.509-Zertifikat oder die AWS Zugangsschlüssel-ID ist in unseren Aufzeichnungen nicht vorhanden. Stellen Sie sicher, dass Sie gültige Anmeldeinformationen verwenden und dass diese nicht abgelaufen sind.  
HTTP-Statuscode: 403

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
Die Eingabe entspricht nicht dem erforderlichen Format oder den erforderlichen Einschränkungen. Überprüfen Sie, ob alle erforderlichen Parameter enthalten sind und ob die Werte gültig sind.  
HTTP-Statuscode: 400

# Aufrufen der API mittels HTTP-Abfrageanforderungen
<a name="query-requests"></a>

Dieser Abschnitt enthält allgemeine Informationen zur Verwendung der Query API für die AWS Kontoverwaltung. Weitere Informationen über die API-Vorgänge und Fehler finden Sie in der [API-Referenz](api-reference.md).

**Anmerkung**  
Anstatt die Abfrage-API für die AWS Kontoverwaltung direkt aufzurufen, können Sie eine der folgenden verwenden AWS SDKs. Sie AWS SDKs bestehen aus Bibliotheken und Beispielcode für verschiedene Programmiersprachen und Plattformen (Java, Ruby, .NET, iOS, Android und mehr). SDKs Sie bieten eine bequeme Möglichkeit, programmatischen Zugriff auf die AWS Kontoverwaltung und AWS zu erstellen. SDKs Sie kümmern sich beispielsweise um Aufgaben wie das kryptografische Signieren von Anfragen, das Verwalten von Fehlern und das automatische Wiederholen von Anfragen. Informationen zu den AWS SDKs, einschließlich deren Download und Installation, finden Sie unter [Tools für Amazon Web Services](https://aws.amazon.com/tools).

Mit der Query API for AWS Account Management können Sie Serviceaktionen aufrufen. Abfrage-API-Anfragen sind HTTPS-Anfragen, die einen `Action` Parameter enthalten müssen, der den auszuführenden Vorgang angibt. AWS Die Kontoverwaltung unterstützt `GET` und `POST` fordert alle Vorgänge an. Das heißt, Sie müssen die API `GET` für einige Aktionen und `POST` für andere nicht verwenden. `GET`Anfragen unterliegen jedoch der Größenbeschränkung einer URL. Obwohl dieses Limit vom Browser abhängt, liegt ein typisches Limit bei 2.048 Byte. Daher müssen Sie für Query API-Anfragen, die größere Größen erfordern, eine `POST` Anfrage verwenden.

Die Antwort erfolgt in Form eines XML-Dokuments. Weitere Informationen über die Antwort finden Sie auf den Seiten zu den einzelnen Aktionen in der [API-Referenz](api-reference.md).

**Topics**
+ [Endpunkte](#endpoints)
+ [HTTPS erforderlich](#IAMHTTPSRequired)
+ [API-Anfragen für die AWS Kontoverwaltung signieren](#SigVersion)

## Endpunkte
<a name="endpoints"></a>

AWS Account Management verfügt über einen einzigen globalen API-Endpunkt, der im Osten der USA (Nord-Virginia) gehostet wird AWS-Region.

Weitere Informationen zu AWS Endpunkten und Regionen für alle Dienste finden Sie unter [Regionen und Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html) in der. *Allgemeine AWS-Referenz* 

## HTTPS erforderlich
<a name="IAMHTTPSRequired"></a>

Da die Abfrage-API vertrauliche Informationen wie Sicherheitsanmeldedaten zurückgeben kann, müssen Sie HTTPS verwenden, um alle API-Anfragen zu verschlüsseln. 

## API-Anfragen für die AWS Kontoverwaltung signieren
<a name="SigVersion"></a>

Anforderungen müssen über eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel signiert werden. Wir empfehlen dringend, dass Sie Ihre AWS Root-Kontoanmeldeinformationen nicht für die tägliche Arbeit mit der AWS Kontoverwaltung verwenden. Sie können die Anmeldeinformationen für einen AWS Identity and Access Management (IAM-) Benutzer oder temporäre Anmeldeinformationen verwenden, wie Sie sie für eine IAM-Rolle verwenden.

Um Ihre API-Anfragen zu signieren, müssen Sie AWS Signature Version 4 verwenden. Informationen zur Verwendung von Signature Version 4 finden Sie unter [Signieren von AWS API-Anfragen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) im *IAM-Benutzerhandbuch*. 

Weitere Informationen finden Sie hier:
+ [AWS -Sicherheitsanmeldeinformationen](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) – Bietet allgemeine Informationen zu den Arten der Anmeldeinformationen, mit denen Sie auf AWS zugreifen können.
+ [Bewährte Sicherheitsmethoden in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) — Bietet Vorschläge zur Nutzung des IAM-Dienstes zum Schutz Ihrer AWS Ressourcen, einschließlich der Ressourcen in der AWS Kontoverwaltung.
+ [Temporäre Sicherheitsanmeldeinformationen in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) – Beschreibt die Erstellung und Verwendung von temporären Sicherheitsanmeldeinformationen.