Bekerja dengan versi parameter di Parameter Store - AWS Systems Manager
Membuat versi baru parameter menggunakan konsolMereferensikan versi parameter

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Bekerja dengan versi parameter di Parameter Store

Setiap kali Anda mengedit nilai parameter, Parameter Store, alat dalam AWS Systems Manager membuat versi baru dari parameter dan mempertahankan versi sebelumnya. Saat Anda awalnya membuat parameter, Parameter Store menetapkan versi 1 ke parameter itu. Ketika Anda mengubah nilai parameter, Parameter Store secara otomatis menambah nomor versi satu per satu. Anda dapat melihat detail, termasuk nilai-nilai, dari semua versi dalam riwayat parameter.

Anda juga dapat menentukan versi parameter untuk digunakan dalam perintah API dan dokumen SSM; misalnya: ssm:MyParameter:3. Anda dapat menentukan nama parameter dan nomor versi tertentu dalam panggilan API dan dokumen SSM. Jika Anda tidak menentukan nomor versi, sistem akan secara otomatis menggunakan versi terbaru. Jika Anda menentukan nomor untuk versi yang tidak ada, sistem mengembalikan kesalahan daripada kembali ke versi terbaru atau default parameter.

Anda dapat menggunakan versi parameter untuk melihat berapa kali parameter berubah selama periode waktu tertentu. Versi parameter juga menyediakan lapisan perlindungan jika nilai parameter secara tidak sengaja berubah.

Anda dapat membuat dan mempertahankan hingga 100 versi parameter. Setelah Anda membuat 100 versi parameter, setiap kali Anda membuat versi baru, versi tertua dari parameter dihapus dari riwayat untuk membuat ruang untuk versi baru.

Pengecualian untuk ini adalah ketika sudah ada 100 versi parameter dalam riwayat, dan label parameter ditetapkan ke versi tertua dari parameter. Dalam kasus ini, versi tersebut tidak dihapus dari riwayat, dan permintaan untuk membuat versi parameter baru gagal. Perlindungan ini adalah untuk mencegah terhapusnya versi parameter dengan label bermisi kritis yang ditetapkan kepada mereka. Untuk terus membuat parameter baru, pertama-tama pindahkan label dari versi tertua parameter ke parameter yang lebih baru untuk digunakan dalam operasi Anda. Untuk informasi tentang memindahkan label parameter, lihat Memindahkan label parameter menggunakan konsol dan Memindahkan label parameter menggunakan AWS CLI.

Prosedur berikut menunjukkan cara mengubah parameter dan kemudian memverifikasi bahwa Anda membuat versi baru. Anda dapat menggunakan perintah get-parameter dan get-parameters untuk melihat versi parameter. Untuk contoh tentang penggunaan perintah ini, lihat GetParameterdan GetParametersdi Referensi AWS Systems Manager API

Membuat versi baru parameter menggunakan konsol

Anda dapat menggunakan konsol Systems Manager untuk membuat versi baru dari parameter dan melihat riwayat versi sebuah parameter.

Membuat versi baru dari suatu parameter

  1. Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/.

  2. Di panel navigasi, pilih Parameter Store.

  3. Pilih nama parameter yang Anda buat sebelumnya. Untuk informasi lebih lanjut tentang membuat parameter baru, lihat Membuat Parameter Store parameter di Systems Manager.

  4. Pilih Edit.

  5. Di kotak Nilai, masukkan nilai baru, lalu pilih Simpan perubahan.

  6. Pilih nama parameter yang baru saja Anda perbarui. Pada tab Gambaran Umum, verifikasi bahwa nomor versi bertambah 1, dan verifikasi nilai yang baru.

  7. Untuk melihat riwayat semua versi parameter, pilih tab Riwayat.

Mereferensikan versi parameter

Anda dapat mereferensi versi parameter tertentu dalam perintah, panggilan API, dan dokumen SSM dengan menggunakan format berikut: ssm:parameter-name:version-number.

Dalam contoh berikut, Amazon Elastic Compute Cloud (Amazon EC2) run-instances command menggunakan parameter golden-ami versi 3.

Linux & macOS
aws ec2 run-instances \
    --image-id resolve:ssm:/golden-ami:3 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --security-groups my-security-group
Windows
aws ec2 run-instances ^
    --image-id resolve:ssm:/golden-ami:3 ^
    --count 1 ^
    --instance-type t2.micro ^
    --key-name my-key-pair ^
    --security-groups my-security-group
catatan

Menggunakan resolve dan nilai parameter hanya berfungsi dengan --image-id opsi dan parameter yang berisi Amazon Machine Image (AMI) sebagai nilainya. Untuk informasi selengkapnya, lihat Menggunakan dukungan parameter asli di Parameter Store untuk Gambar Mesin Amazon IDs.

Berikut ini adalah contoh untuk menentukan versi 2 dari parameter bernama MyRunCommandParameter dalam dokumen SSM.

YAML
---
schemaVersion: '2.2'
description: Run a shell script or specify the commands to run.
parameters:
  commands:
    type: String
    description: "(Required) Specify a shell script or a command to run."
    displayType: textarea
    default: "{{ssm:MyRunCommandParameter:2}}"
mainSteps:
- action: aws:runShellScript
  name: RunScript
  inputs:
    runCommand:
    - "{{commands}}"
JSON
{
    "schemaVersion": "2.2",
    "description": "Run a shell script or specify the commands to run.",
    "parameters": {
        "commands": {
            "type": "String",
            "description": "(Required) Specify a shell script or a command to run.",
            "displayType": "textarea",
            "default": "{{ssm:MyRunCommandParameter:2}}"
        }
    },
    "mainSteps": [
        {
            "action": "aws:runShellScript",
            "name": "RunScript",
            "inputs": {
                "runCommand": [
                    "{{commands}}"
                ]
            }
        }
    ]
}