Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# StartPrimaryEmailUpdate
Memulai proses untuk memperbarui alamat email utama untuk akun yang ditentukan.
## Minta Sintaks
```
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"PrimaryEmail": "string"
}
```
## Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) **
Menentukan 12 digit nomor ID akun Akun AWS yang ingin Anda akses atau modifikasi dengan operasi ini. Untuk menggunakan parameter ini, pemanggil harus berupa identitas di [akun manajemen organisasi atau akun](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) administrator yang didelegasikan. ID akun yang ditentukan harus berupa akun anggota di organisasi yang sama. Organisasi harus mengaktifkan [semua fitur, dan organisasi harus mengaktifkan](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) [akses tepercaya](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) untuk layanan Manajemen Akun, dan secara opsional akun [admin yang didelegasikan](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) ditetapkan.
Operasi ini hanya dapat dipanggil dari akun manajemen atau akun administrator yang didelegasikan dari organisasi untuk akun anggota.
Akun manajemen tidak dapat menentukan sendiri`AccountId`.
Tipe: String
Pola: `\d{12}`
Wajib: Ya
** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) **
Alamat email utama baru (juga dikenal sebagai alamat email pengguna root) untuk digunakan dalam akun yang ditentukan.
Tipe: String
Kendala Panjang: Panjang minimum 5. Panjang maksimum 64.
Wajib: Ya
## Sintaksis Respons
```
HTTP/1.1 200
Content-type: application/json
{
"Status": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) **
Status permintaan pembaruan email utama.
Tipe: String
Nilai yang Valid: `PENDING | ACCEPTED`
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Operasi gagal karena identitas panggilan tidak memiliki izin minimum yang diperlukan.
** errorType **
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 403
** ConflictException **
Permintaan tidak dapat diproses karena konflik dalam status sumber daya saat ini. Misalnya, ini terjadi jika Anda mencoba mengaktifkan Wilayah yang saat ini sedang dinonaktifkan (dalam status DISABLING) atau jika Anda mencoba mengubah email pengguna root akun ke alamat email yang sudah digunakan.
** errorType **
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 409
** InternalServerException **
Operasi gagal karena kesalahan internal ke AWS. Coba operasi Anda lagi nanti.
** errorType **
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 500
** ResourceNotFoundException **
Operasi gagal karena menentukan sumber daya yang tidak dapat ditemukan.
** errorType **
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 404
** TooManyRequestsException **
Operasi gagal karena dipanggil terlalu sering dan melebihi batas throttle.
** errorType **
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 429
** ValidationException **
Operasi gagal karena salah satu parameter input tidak valid.
** fieldList **
Bidang tempat entri yang tidak valid terdeteksi.
** message **
Pesan yang memberi tahu Anda tentang apa yang tidak valid tentang permintaan tersebut.
** reason **
Alasan mengapa validasi gagal.
Kode Status HTTP: 400
## Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+ [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK para 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 untuk 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)