

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

# Bekerja dengan penyediaan tipe perubahan () CTs
<a name="deploy-new-aog"></a>

AMS bertanggung jawab atas infrastruktur terkelola Anda, untuk membuat perubahan, Anda harus mengirimkan RFC dengan klasifikasi CT yang benar (kategori, subkategori, item, dan operasi). Bagian ini menjelaskan cara menemukan CTs, menentukan apakah ada yang tepat untuk kebutuhan Anda, dan meminta CT baru jika tidak ada.

## Lihat apakah CT yang ada memenuhi kebutuhan Anda
<a name="ct-check-aog"></a>

Setelah Anda menentukan apa yang ingin Anda terapkan dengan AMS, langkah selanjutnya adalah mempelajari yang ada CTs dan CloudFormation templat untuk melihat apakah solusi sudah ada. 

Saat membuat RFC, Anda harus menentukan CT. Anda dapat menggunakan Konsol Manajemen AWS atau AMS API/CLI. Contoh penggunaan keduanya dijelaskan selanjutnya.

Anda dapat menggunakan konsol atau API/CLI untuk menemukan perubahan jenis ID (CT) atau versi. Ada dua metode, baik pencarian atau memilih klasifikasi. Untuk kedua jenis pilihan, Anda dapat mengurutkan pencarian dengan memilih **Paling sering digunakan, **Paling baru digunakan****, atau **Alfabetis**.

**YouTube Video**: [Bagaimana cara membuat RFC menggunakan AWS Managed Services CLI dan di mana saya dapat menemukan Skema CT?](https://www.youtube.com/watch?v=IluDFwnJJFU&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=3&t=150s) 

Di konsol AMS, pada halaman **RFCs**-> **Buat RFC**:
+ Dengan **Browse by change type** yang dipilih (default), baik:
  + Gunakan area **Quick create** untuk memilih dari AMS yang paling populer CTs. Klik pada label dan halaman **Jalankan RFC** terbuka dengan opsi **Subjek** diisi otomatis untuk Anda. Selesaikan opsi yang tersisa sesuai kebutuhan dan klik **Jalankan** untuk mengirimkan RFC. 
  + Atau, gulir ke bawah ke **Semua jenis perubahan** area dan mulai mengetik nama CT di kotak opsi, Anda tidak harus memiliki nama jenis perubahan yang tepat atau lengkap. Anda juga dapat mencari CT dengan mengubah jenis ID, klasifikasi, atau mode eksekusi (otomatis atau manual) dengan memasukkan kata-kata yang relevan.

    Dengan tampilan **Kartu** default yang dipilih, kartu CT yang cocok muncul saat Anda mengetik, pilih kartu dan klik **Buat RFC**. Dengan tampilan **Tabel** dipilih, pilih CT yang relevan dan klik **Buat RFC**. Kedua metode membuka halaman **Run RFC**.
+ Atau, dan untuk menjelajahi pilihan jenis perubahan, klik **Pilih berdasarkan kategori** di bagian atas halaman untuk membuka serangkaian kotak opsi drop-down.
+ Pilih **Kategori**, **Subkategori**, **Item**, dan **Operasi**. Kotak informasi untuk jenis perubahan itu muncul panel muncul di bagian bawah halaman.
+ Saat Anda siap, tekan **Enter**, dan daftar jenis perubahan yang cocok akan muncul.
+ Pilih jenis perubahan dari daftar. Kotak informasi untuk jenis perubahan itu muncul di bagian bawah halaman.
+ Setelah Anda memiliki jenis perubahan yang benar, pilih **Buat RFC**.
**catatan**  
AMS CLI harus diinstal agar perintah ini berfungsi. Untuk menginstal AMS API atau CLI, buka halaman **Sumber Daya Pengembang** konsol AMS. Untuk materi referensi tentang AMS CM API atau AMS SKMS API, lihat bagian Sumber Informasi AMS di Panduan Pengguna. Anda mungkin perlu menambahkan `--profile` opsi untuk otentikasi; misalnya,`aws amsskms {{ams-cli-command}} --profile SAML`. Anda mungkin juga perlu menambahkan `--region` opsi karena semua perintah AMS kehabisan us-east-1; misalnya. `aws amscm {{ams-cli-command}} --region=us-east-1`
**catatan**  
Titik akhir AMS API/CLI (amscm dan amsskms) berada di Wilayah AWS N. Virginia,. `us-east-1` Bergantung pada bagaimana autentikasi Anda disetel, dan di Wilayah AWS akun dan sumber daya Anda, Anda mungkin perlu menambahkan `--region us-east-1` saat mengeluarkan perintah. Anda mungkin juga perlu menambahkan`--profile saml`, jika itu adalah metode otentikasi Anda.

Untuk mencari jenis perubahan menggunakan AMS CM API (lihat [ListChangeTypeClassificationSummaries](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html)) atau CLI:

Anda dapat menggunakan filter atau kueri untuk mencari. ListChangeTypeClassificationSummaries Operasi memiliki opsi [Filter](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html#amscm-ListChangeTypeClassificationSummaries-request-Filters) untuk`Category`,`Subcategory`,`Item`, dan`Operation`, tetapi nilainya harus sama persis dengan nilai yang ada. Untuk hasil yang lebih fleksibel saat menggunakan CLI, Anda dapat menggunakan opsi. `--query` 


**Ubah jenis penyaringan dengan AMS CM API/CLI**  
<a name="ct-filtering-table"></a>
<table>
<thead>
  <tr><th>Atribut</th><th>Nilai valid</th><th>Kondisi valid/default</th><th>Catatan</th></tr>
</thead>
<tbody>
  <tr><td>ChangeTypeId</td><td>String apa pun yang mewakili a ChangeTypeId (Misalnya: ct-abc123xyz7890)</td><td>Setara</td><td>Untuk jenis perubahan IDs, lihat [Referensi Ubah Jenis](https://docs.aws.amazon.com/managedservices/latest/ctref/index.html).<br />Untuk jenis perubahan IDs, lihat Menemukan Jenis Perubahan atau CSIO.</td></tr>
  <tr><td>Kategori</td><td rowspan="4">Teks bentuk bebas apa pun</td><td rowspan="4">Contains</td><td rowspan="4">Ekspresi reguler di setiap bidang individu tidak didukung. Pencarian yang tidak peka huruf besar/kecil</td></tr>
  <tr><td>Subkategori</td></tr>
  <tr><td>Item</td></tr>
  <tr><td>Operasi</td></tr>
</tbody>
</table>


1. Berikut adalah beberapa contoh klasifikasi jenis perubahan daftar:

   Perintah berikut mencantumkan semua kategori jenis perubahan.

   ```
   aws amscm list-change-type-categories
   ```

   Perintah berikut mencantumkan subkategori milik kategori tertentu.

   ```
   aws amscm list-change-type-subcategories --category {{CATEGORY}}
   ```

   Perintah berikut mencantumkan item milik kategori dan subkategori tertentu.

   ```
   aws amscm list-change-type-items --category {{CATEGORY}} --subcategory {{SUBCATEGORY}}
   ```

1. Berikut adalah beberapa contoh pencarian jenis perubahan dengan kueri CLI:

   Perintah berikut mencari ringkasan klasifikasi CT untuk yang berisi “S3" di Nama item dan membuat output dari kategori, subkategori, item, operasi, dan mengubah ID tipe dalam bentuk tabel. 

   ```
   aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
   ```

   ```
   +---------------------------------------------------------------+
   |               ListChangeTypeClassificationSummaries           |
   +----------+-------------------------+--+------+----------------+
   |Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
   +----------+-------------------------+--+------+----------------+
   ```

1. Anda kemudian dapat menggunakan ID tipe perubahan untuk mendapatkan skema CT dan memeriksa parameternya. Perintah berikut output skema ke file JSON bernama creates3params.schema.json.

   ```
   aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json
   ```

   [Untuk informasi tentang penggunaan kueri CLI, lihat [Cara Memfilter Output dengan Opsi --query](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html#controlling-output-filter) dan referensi bahasa kueri, Spesifikasi. JMESPath ](http://jmespath.org/specification.html)

1. Setelah Anda memiliki ID tipe perubahan, kami sarankan untuk memverifikasi versi untuk jenis perubahan untuk memastikan itu adalah versi terbaru. Gunakan perintah ini untuk menemukan versi untuk jenis perubahan tertentu:

   ```
   aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value={{CHANGE_TYPE_ID}}
   ```

   Untuk menemukan tipe perubahan tertentu, jalankan perintah ini: `AutomationStatus`

   ```
   aws amscm --profile saml get-change-type-version --change-type-id {{CHANGE_TYPE_ID}} --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"
   ```

   Untuk menemukan tipe perubahan tertentu, jalankan perintah ini: `ExpectedExecutionDurationInMinutes`

   ```
   aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"
   ```

Setelah Anda menemukan CT yang menurut Anda sesuai, lihat parameter eksekusi skema JSON yang terkait dengannya untuk mengetahui apakah itu membahas kasus penggunaan Anda. 

Gunakan perintah ini untuk menampilkan skema CT ke file JSON yang dinamai CT; contoh ini mengeluarkan skema penyimpanan Create S3:

`aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateBucketParams.json`

Mari kita lihat lebih dekat apa yang ditawarkan skema ini.


**Skema Buat Bucket S3**  


- ** 

```
{	
  "$schema": "http://json-schema.org/draft-04/schema#",
"name": "Create S3 Storage  
"description": "Use to create an Amazon Simple Storage Service stack.",
  "type": "object",
  "properties": {
    "Description": {
      "description": "The description of the stack.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "VpcId": {
      "description": "ID of the VPC to create the S3 Bucket in, in the form vpc-a1b2c3d4e5f67890e.",
      "type": "string",
      "pattern": "^vpc-[a-z0-9]{17}$"
    },
    "StackTemplateId": {
      "description": "Required value: stm-s2b72beb000000000.",
      "type": "string",
      "enum": ["stm-s2b72beb000000000"]
    },
    "Name":{
      "description": "The name of the stack to create.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "Tags": {
      "description": "Up to seven tags (key/value pairs) for the stack.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "Key": {
            "type": "string",
            "minLength": 1,
            "maxLength": 127
          },
          "Value": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255
          }
        },
        "additionalProperties": false,
        "required": [
          "Key",
          "Value"
        ]
      },
      "minItems": 1,
      "maxItems": 7
    },
    "TimeoutInMinutes": {
      "description": "The amount of time, in minutes, to allow for creation of the stack.",
      "type": "number",
      "minimum": 0,
      "maximum": 60
    },
    "Parameters": {
      "description": "Specifications for the stack.",
      "type": "object",
      "properties": {
        "AccessControl": {
          "description": "The canned (predefined) access control list (ACL) to assign to the bucket.",
          "type": "string",
          "enum": [
            "Private",
            "PublicRead",
            "AuthenticatedRead",
            "BucketOwnerRead"
          ]
        },
        "BucketName": {
          "description": "A name for the bucket. The bucket name must contain only lowercase letters, numbers, periods (.), and hyphens (-).",
          "type": "string",
          "pattern": "^[a-z0-9]([-.a-z0-9]+)[a-z0-9]$",
          "minLength": 3,
          "maxLength": 63
        }
      },
      "additionalProperties": false,
      "required": [
        "AccessControl",
        "BucketName"
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "Description",
    "VpcId",
    "StackTemplateId",
    "Name",
    "TimeoutInMinutes",
    "Parameters"
  ]
}
``` **
  - Skema dimulai dengan CT (“deskripsi”), yang memberi tahu Anda untuk apa skema itu. Dalam hal ini, untuk membuat tumpukan penyimpanan S3.<br />Selanjutnya, Anda memiliki properti wajib dan opsional yang dapat Anda tentukan. Nilai properti default diberikan. Properti yang diperlukan tercantum di akhir skema.<br />Di StackTemplateId area tersebut, Anda melihat bahwa ada satu template tumpukan khusus untuk CT dan skema ini, dan ID-nya adalah nilai properti wajib.<br />Skema ini memungkinkan Anda untuk menandai tumpukan yang Anda buat, untuk tujuan pembukuan internal. Selain itu, beberapa opsi, seperti cadangan, memerlukan tag key:Backup dan Value:True. Untuk informasi mendalam, baca [Menandai Sumber Daya Amazon EC2 ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html) Anda. <br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
  - Bagian Parameter dari skema CT JSON adalah tempat Anda memberikan parameter eksekusi. <br />Untuk skema ini, hanya ACL dan parameter eksekusi BucketName yang diperlukan.



## Minta CT baru
<a name="request-new-ct-aog"></a>

Setelah memeriksa skema, Anda dapat memutuskan bahwa itu tidak menyediakan parameter yang cukup untuk membuat penerapan yang Anda inginkan. Jika itu masalahnya, periksa CloudFormation templat yang ada untuk menemukan templat yang lebih dekat dengan yang Anda inginkan. Setelah Anda tahu parameter tambahan apa yang Anda butuhkan, kirimkan Manajemen \| Lainnya \| Lainnya \| Buat CT.

**catatan**  
Semua Lainnya \| Buat dan Pembaruan Lainnya CTs menerima perhatian dari operator AMS, yang akan menghubungi Anda untuk mendiskusikan CT baru.

Untuk mengirimkan permintaan CT baru, akses konsol AMS melalui reguler [Konsol Manajemen AWS](https://aws.amazon.com/console/)dan kemudian ikuti langkah-langkah ini.

1. Dari navigasi kiri, klik **RFCs**.

   Halaman RFCs dasbor terbuka.

1. Klik **Buat**.

   Halaman Buat permintaan untuk perubahan terbuka.

1. **Pilih Manajemen di **Kategori** daftar drop-down, dan Lainnya untuk **Subkategori dan Item**.** Untuk **Operasi**, pilih Buat. RFC akan membutuhkan persetujuan sebelum dapat diimplementasikan.

1. Masukkan informasi mengapa Anda menginginkan CT, misalnya: Meminta CT penyimpanan Create S3 yang dimodifikasi yang memungkinkan kustom ACLs, berdasarkan CT penyimpanan Create S3 yang ada. Ini akan menghasilkan CT baru: Deployment \| Komponen Tumpukan Tingkat Lanjut \| Penyimpanan S3 \| Buat ACL kustom S3. CT baru ini bisa bersifat publik.

1. Klik **Kirim**.

   RFC Anda ditampilkan di dasbor RFC.

## Uji CT baru
<a name="test-new-ct-aog"></a>

Setelah AWS Managed Services membuat CT baru itu, Anda mengujinya dengan mengirimkan RFC dengannya. Jika Anda bekerja dengan AMS untuk membuat CT baru telah disetujui sebelumnya, maka Anda cukup mengikuti pengiriman RFC standar, dan perhatikan hasilnya (untuk detail tentang pengiriman RFCs, lihat [Membuat dan](https://docs.aws.amazon.com/managedservices/latest/userguide/create-rfcs.html) Mengirimkan RFC). Jika CT baru tidak disetujui sebelumnya (Anda ingin memastikan bahwa CT tidak pernah dijalankan tanpa persetujuan eksplisit), maka Anda perlu mendiskusikan implementasinya dengan AMS setiap kali Anda ingin menjalankannya.