Key Management Service:CreateSecret

Nama rahasia. Nama harus unik dalam wilayah yang sama. Nama dapat memiliki panjang hingga 192 karakter dan dapat berisi huruf, digit, garis bawah (_), garis miring (/), tanda plus (+), tanda sama dengan (=), titik (.), tanda hubung (-), dan tanda at (@). Batasan berikut berlaku untuk nama rahasia untuk berbagai tipe rahasia:

• Jika SecretType diatur ke Generic, Rds, atau Redis, nama tidak boleh dimulai dengan acs/.

• Jika SecretType diatur ke RAMCredentials, atur parameter ini ke nilai tetap $Auto. Dalam hal ini, KMS secara otomatis menghasilkan nama rahasia yang dimulai dengan acs/ram/user/ dan berisi nama tampilan Pengguna RAM.

• Jika SecretType diatur ke ECS, nama harus dimulai dengan acs/ecs/.

Nomor versi dari versi awal. Nomor versi harus unik dalam rahasia. Nomor versi dapat memiliki panjang hingga 64 karakter.

ID kunci yang digunakan untuk mengenkripsi nilai rahasia.

Nilai rahasia. Nilai dapat memiliki panjang hingga 30.720 byte (30 KB). KMS mengenkripsi nilai rahasia dengan kunci yang ditentukan dan menyimpan nilai terenkripsi tersebut di versi awal.

• Jika SecretType diatur ke Generic, Anda dapat menentukan nilai rahasia kustom.

• Jika SecretType diatur ke Rds, nilai rahasia harus dalam format berikut: {"Accounts":[{"AccountName":"","AccountPassword":""}]}. Dalam format tersebut, AccountName menentukan nama pengguna akun untuk instans RDS dan AccountPassword menentukan kata sandi akun.

• Jika SecretType diatur ke Redis, atur parameter ini ke $Auto.

• Jika SecretType diatur ke RAMCredentials, nilai rahasia harus dalam format berikut: {"AccessKeys":[{"AccessKeyId":"","AccessKeySecret":""}]}. Dalam format tersebut, AccessKeyId menentukan ID AccessKey dan AccessKeySecret menentukan Rahasia AccessKey. Anda harus menentukan semua pasangan AccessKey Pengguna RAM.

• Jika SecretType diatur ke PolarDB Basis Data Relasional Cloud-Native, atur parameter ini ke $Auto.

• Jika SecretType diatur ke ECS, nilai rahasia harus dalam salah satu format berikut:

  • Jika SecretSubType di parameter ExtendedConfig diatur ke Password: {"UserName":"","Password": ""}. Dalam format tersebut, UserName menentukan nama pengguna yang digunakan untuk login ke Instance ECS dan Password menentukan kata sandi yang digunakan untuk login ke Instance ECS.

  • Jika SecretSubType di parameter ExtendedConfig diatur ke SSHKey: {"UserName":"","PublicKey": "", "PrivateKey": ""}. Dalam format tersebut, PublicKey menentukan kunci publik berformat SSH yang digunakan untuk login ke Instance ECS dan PrivateKey menentukan kunci privat yang digunakan untuk login ke Instance ECS.

Tipe nilai rahasia. Nilai valid:

• text (default): Nilai rahasia adalah string teks.

• binary: Nilai rahasia adalah string biner.

Deskripsi rahasia.

Tag rahasia. Setiap tag terdiri dari pasangan kunci-nilai. Sebuah tag terdiri dari kunci tag dan nilai tag.

Kunci tag dan nilai tag dapat memiliki panjang hingga 128 karakter dan dapat berisi huruf, digit, garis miring (/), garis miring terbalik (\), garis bawah (_), tanda hubung (-), titik (.), tanda plus (+), tanda sama dengan (=), titik dua (:), dan tanda at (@).

• Kunci tag tidak boleh dimulai dengan aliyun atau acs:.

• Anda dapat menentukan hingga 20 pasangan kunci-nilai untuk setiap rahasia.

Tipe rahasia. Nilai valid:

• Generic (default): rahasia generik.

• Rds: rahasia RDS.

• Redis: rahasia Redis.

• RAMCredentials: rahasia RAM.

• ECS: rahasia ECS.

• PolarDB: rahasia PolarDB Basis Data Relasional Cloud-Native.

Konfigurasi yang diperluas dari rahasia. Parameter ini menentukan properti rahasia dari tipe tertentu. Nilai dapat memiliki panjang hingga 1.024 karakter.

• Jika SecretType diatur ke Generic, parameter ini diabaikan.

• Jika SecretType diatur ke Rds, Anda harus menentukan parameter berikut di ExtendedConfig:

  • SecretSubType (Wajib): Subtipe rahasia. Nilai valid:

    • SingleUser: Secrets Manager mengelola rahasia RDS dalam mode akun tunggal. Saat rahasia dirotasi, kata sandi akun yang ditentukan direset ke kata sandi acak baru.

    • DoubleUsers: Secrets Manager mengelola rahasia RDS dalam mode akun ganda. ACSCurrent dan ACSPrevious menunjuk ke salah satu akun. Saat rahasia dirotasi, kata sandi akun yang ditunjuk oleh ACSPrevious direset ke kata sandi acak baru. Kemudian, Secrets Manager menukar akun yang ditunjuk oleh ACSCurrent dan ACSPrevious.

  • DBInstanceId (Wajib): ID instans RDS tempat akun berada.

  • CustomData (Opsional): Data kustom. Nilai adalah pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Contoh: {"Key1": "v1", "fds":"fdsf"}. Nilai default adalah {}.

• Jika SecretType diatur ke Redis, Anda harus menentukan parameter berikut di ExtendedConfig:

  • SecretSubType (Wajib): Subtipe rahasia. Nilai valid:

    • DoubleUsers: Secrets Manager mengelola rahasia Redis dalam mode akun ganda. ACSCurrent dan ACSPrevious menunjuk ke salah satu akun. Saat rahasia dirotasi, kata sandi akun yang ditunjuk oleh ACSPrevious direset ke kata sandi acak baru. Kemudian, Secrets Manager menukar akun yang ditunjuk oleh ACSCurrent dan ACSPrevious.

  • AccountName (Wajib): Nama pengguna database.

  • CloneAccountName (Wajib): Nama pengguna database, yang merupakan nilai AccountName dengan akhiran _clone.

  • AccountPrivilege (Wajib): Izin untuk mengakses database.

  • InstanceId (Wajib): ID instans Redis.

  • RegionId (Wajib): ID Wilayah tempat instans Redis berada.

  • CustomData (Opsional): Data kustom. Nilai adalah pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Contoh: {"Key1": "v1", "fds":"fdsf"}. Nilai default adalah {}.

• Jika SecretType diatur ke RAMCredentials, Anda harus menentukan parameter berikut di ExtendedConfig:

  • SecretSubType (Wajib): Subtipe rahasia. Nilainya adalah RamUserAccessKey.

  • UserName (Wajib): Nama Pengguna RAM.

  • CustomData (Opsional): Data kustom. Nilai adalah pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Nilai default adalah {}.

• Jika SecretType diatur ke ECS, Anda harus menentukan parameter berikut di ExtendedConfig:

  • SecretSubType (Wajib): Subtipe rahasia. Nilai valid:

    • Password: kata sandi ECS.

    • SSHKey: pasangan kunci SSH ECS.

  • RegionId (Wajib): ID Wilayah tempat Instance ECS berada.

  • InstanceId (Wajib): ID Instance ECS.

  • CustomData (Opsional): Data kustom. Nilai adalah pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Nilai default adalah {}.

• Jika SecretType diatur ke PolarDB Basis Data Relasional Cloud-Native, Anda harus menentukan parameter berikut di ExtendedConfig:

  • SecretSubType (Wajib): Nilai tetapnya adalah DoubleUsers.

  • RegionId (Wajib): Wilayah.

  • DBClusterId (Wajib): ID instans PolarDB Basis Data Relasional Cloud-Native.

  • DBType (Wajib): MySQL atau PostgreSQL.

  • AccountName (Wajib): Nama akun.

  • CloneAccountName: Nilainya adalah AccountName_clone.

  • AccountType: Hanya Normal yang didukung.

  • AccountPrivilege: Parameter ini hanya tersedia untuk MySQL.

  • DBName: Parameter ini hanya tersedia untuk MySQL.

  • CustomData (Opsional): Data kustom. Nilai adalah pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Contoh: {"Key1": "v1", "fds":"fdsf"}. Nilai default adalah {}.

Apakah akan mengaktifkan rotasi otomatis. Nilai valid:

• true: mengaktifkan rotasi otomatis.

• false (default): menonaktifkan rotasi otomatis.

Interval untuk rotasi otomatis. Nilai dalam rentang 6 jam hingga 8.760 jam (365 hari).
Nilai dalam format integer[unit]. integer menunjukkan interval. unit menunjukkan satuan pengatur waktu.
Nilai valid untuk unit: d (hari), h (jam), m (menit), dan s (detik). Misalnya, baik 7d maupun 604.800s menunjukkan interval rotasi 7 hari.

ID instans KMS.

Konten Kebijakan rahasia. Nilai dalam format JSON. Nilai dapat memiliki panjang hingga 32.768 byte.

Untuk informasi selengkapnya tentang Kebijakan rahasia, lihat Ikhtisar Kebijakan rahasia. Jika Anda tidak menentukan parameter ini, Kebijakan rahasia default digunakan.

Sebuah Kebijakan rahasia berisi bagian berikut:

• Version: Versi Kebijakan rahasia. Hanya 1 yang didukung.

• Statement: Pernyataan Kebijakan rahasia. Setiap Kebijakan rahasia dapat berisi satu atau lebih pernyataan.

Berikut adalah format Kebijakan rahasia:

{
    "Version": "1",
    "Statement": [
        {
            "Sid": "Enable RAM User Permissions",
            "Effect": "Allow",
            "Principal": {
              "RAM": ["acs:ram::12345678****:*"]
            },
            "Action": [
                "kms:*"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

Detail tentang sebuah pernyataan:

• Sid: (Opsional) pengenal kustom dari pernyataan. Nilai dapat memiliki panjang hingga 128 karakter dan dapat berisi huruf kapital (A-Z), huruf kecil (a-z), digit (0-9), dan karakter khusus, termasuk garis bawah (_), garis miring (/), tanda plus (+), tanda sama dengan (=), titik (.), tanda at (@), dan tanda hubung (-).

• Effect: (Wajib) Efek dari pernyataan Kebijakan. Nilai valid: Allow dan Deny.

• Principal: (Wajib) Pihak yang berwenang yang diizinkan oleh Kebijakan. Anda dapat menentukan akun Alibaba Cloud saat ini (akun tempat rahasia berada), Pengguna RAM atau Peran RAM dari akun Alibaba Cloud saat ini, atau Pengguna RAM atau Peran RAM dari akun Alibaba Cloud lain.

• Action: (Wajib) Operasi API yang diizinkan atau ditolak. Nilai harus dimulai dengan "kms:". Untuk daftar operasi yang didukung, lihat Ikhtisar Kebijakan rahasia. Jika Anda menentukan operasi yang tidak ada dalam daftar, pengaturan tidak berlaku.

• Resource: (Wajib) Sumber daya. Nilai hanya bisa *, yang menunjukkan rahasia KMS saat ini.

• Condition: (Opsional) kondisi agar otorisasi berlaku. Anda dapat menggunakan kondisi untuk mengevaluasi konteks permintaan API guna menentukan apakah akan menerapkan pernyataan Kebijakan. Formatnya adalah "Condition": {"operator kondisi": {"kunci kondisi": "nilai kondisi"}}. Untuk informasi selengkapnya, lihat Ikhtisar Kebijakan rahasia.