

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

# Mengelola Produk
<a name="catalogs_products"></a>

Anda dapat membuat produk, memperbarui produk dengan membuat versi baru berdasarkan template yang diperbarui, dan mengelompokkan produk bersama ke dalam portofolio untuk mendistribusikannya kepada pengguna.

Versi baru produk disebarkan ke semua pengguna yang memiliki akses ke produk melalui portofolio. Saat Anda mendistribusikan pembaruan, pengguna akhir dapat memperbarui produk yang sudah disediakan.

**Topics**
+ [Melihat Halaman Produk](#productmgmt-menu)
+ [Membuat Produk](productmgmt-cloudresource.md)
+ [Menambahkan produk ke portofolio](catalogs_portfolios_adding-products.md)
+ [Memperbarui produk](productmgmt-update.md)
+ [Menyinkronkan produk ke file template dari GitHub, GitHub Enterprise, atau Bitbucket](git-synced-sc-products.md)
+ [Menghapus produk](productmgmt-delete.md)
+ [Mengelola Versi](managing-versions.md)

## Melihat Halaman Produk
<a name="productmgmt-menu"></a>

Anda mengelola produk dari halaman **daftar Produk** di konsol AWS Service Catalog administrator.

**Untuk melihat halaman **daftar Produk****

1. Buka konsol Service Catalog di [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).

1. Pilih **Daftar Produk**.

# Membuat Produk
<a name="productmgmt-cloudresource"></a>

 Anda membuat produk dari halaman **Produk** di konsol AWS Service Catalog administrator. 

**catatan**  
Membuat produk Terraform memerlukan konfigurasi tambahan, termasuk mesin penyediaan Terraform dan peran peluncuran. Untuk informasi lebih lanjut, tinjau[Memulai dengan produk Terraform](getstarted-Terraform.md). 

**Untuk membuat AWS Service Catalog produk baru**

1. Arahkan ke halaman **daftar Produk**. 

1. Pilih **Buat produk**, dan pilih **Buat produk**.

1. **Detail produk** - Memungkinkan Anda memilih jenis produk yang ingin Anda buat. AWS Service Catalog mendukung CloudFormation, Terraform Cloud, dan jenis produk Eksternal (mendukung Terraform Community Edition). Detail produk juga berisi metadata yang muncul saat Anda mencari dan melihat produk dalam daftar atau halaman detail. Masukkan yang berikut ini:
   + **Nama Produk** – Nama dari produk tersebut.
   +  **Deskripsi Produk** — Deskripsi ditampilkan dalam daftar produk untuk membantu Anda memilih produk yang benar.
   + **Pemilik** — Orang atau organisasi yang menerbitkan produk ini. Pemilik dapat berupa nama organisasi TI Anda, atau administrator.
   + **Distributor** (opsional) — Nama penerbit aplikasi. Bidang ini memungkinkan Anda mengurutkan daftar produk agar lebih mudah menemukan produk.

1. **Detail versi** memungkinkan Anda untuk menambahkan file template Anda dan membangun produk Anda. Masukkan yang berikut ini:
   +  **Pilih metode** — Ada empat cara untuk menambahkan file template. 
     + **Gunakan file templat lokal** - Unggah CloudFormation templat atau file konfigurasi Terraform tar.gz dari drive lokal. 
     + **Gunakan URL Amazon S3 - Tentukan URL** yang mengarah ke CloudFormation templat atau file konfigurasi Terraform tar.gz yang disimpan di Amazon S3. Jika Anda menentukan URL Amazon S3, URL tersebut harus dimulai dengan `https://`.
     + **Gunakan repositori eksternal - Tentukan repositori** kode GitHub, GitHub Enterprise, atau Bitbucket Anda. AWS Service Catalog memungkinkan Anda untuk menyinkronkan produk ke file template. Untuk produk Terraform, format file template harus berupa satu file yang diarsipkan dalam Tar dan dikompresi dalam Gzip.
     + **Gunakan CloudFormation tumpukan yang ada** - Masukkan ARN untuk tumpukan yang ada CloudFormation . Metode ini tidak mendukung produk Terraform Cloud atau Eksternal. 
   +  **Nama versi** (opsional) - Nama versi produk (misalnya, “v1", “v2beta”). Tidak ada spasi yang diizinkan.
   +  **Deskripsi** (opsional) — Deskripsi versi produk, termasuk bagaimana versi ini berbeda dari versi lainnya.
   +  **Panduan** - Dikelola di tab versi pada halaman **Detail Produk**. Bila versi produk dibuat—selama alur kerja create produk—panduan untuk versi tersebut disetel ke default. Untuk mempelajari panduan selengkapnya, lihat [Mengelola Versi](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/managing-versions.html).

1. **Detail Support** mengidentifikasi organisasi dalam perusahaan Anda, dan menyediakan titik kontak untuk dukungan. Masukkan yang berikut ini:
   + **Kontak email** (opsional) – Alamat email untuk melaporkan masalah dengan produk.
   + **Support Link** (opsional) — URL ke situs tempat pengguna dapat menemukan informasi dukungan atau tiket file. URL harus dimulai dengan `http://` atau `https://`. Administrator bertanggung jawab untuk menjaga keakuratan dan akses informasi dukungan.
   + **Deskripsi Support** (opsional) - Deskripsi tentang bagaimana Anda harus menggunakan **kontak Email** dan tautan **Support**.

1.  **Kelola tag** (opsional) — Selain menggunakan tag untuk mengkategorikan sumber daya Anda, Anda juga dapat menggunakannya untuk mengautentikasi izin Anda untuk membuat sumber daya ini. 

1. **Buat produk** — Setelah Anda mengisi formulir, pilih **Buat produk**. Setelah beberapa detik, produk muncul di halaman **daftar Produk**. Mungkin Anda perlu menyegarkan peramban untuk melihat produk.

Anda juga dapat menggunakan CodePipeline untuk membuat dan mengonfigurasi pipeline untuk menyebarkan template produk Anda AWS Service Catalog dan mengirimkan perubahan yang telah Anda buat di repositori sumber Anda. Untuk informasi selengkapnya, lihat [Tutorial: Membuat Pipeline yang Menyebarkan ke AWS Service Catalog](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-S3-servicecatalog.html). 

Anda dapat menentukan properti parameter di template CloudFormation atau Terraform Anda dan menerapkan aturan tersebut selama penyediaan. Properti ini dapat menentukan panjang minimum dan maksimum, nilai minimum dan maksimum, nilai yang diizinkan, dan ekspresi reguler untuk nilai tersebut. AWS Service Catalog mengeluarkan peringatan selama penyediaan jika nilai yang diberikan tidak mematuhi properti parameter. Untuk mempelajari lebih lanjut tentang properti parameter, lihat [Parameter](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) di *Panduan CloudFormation Pengguna*.

## Pemecahan masalah
<a name="productmgmt-cloudresource-troubleshooting"></a>

 Anda harus memiliki izin untuk mengambil objek dari ember Amazon S3. Jika tidak, Anda mungkin mengalami kesalahan berikut saat meluncurkan atau memperbarui produk. 

```
Error: failed to process product version s3 access denied exception
```

 Jika Anda menemukan pesan ini, pastikan memiliki izin untuk mengambil objek dari bucket berikut: 
+  Ember tempat templat artefak penyediaan disimpan. 
+  Ember yang dimulai dengan "***cf-templates-\$1***" dan tempat AWS Service Catalog menyimpan templat artefak penyediaan. 
+  Bucket internal yang dimulai dengan "***sc-\$1***" dan tempat AWS Service Catalog menyimpan metadata. Anda tidak akan dapat melihat bucket ini dari akun Anda. 

 Kebijakan contoh berikut menunjukkan izin minimum yang diperlukan untuk mengambil objek dari bucket yang disebutkan sebelumnya. 

```
{
          "Sid": "VisualEditor1",
          "Effect": "Allow",
          "Action": "s3:GetObject*",
          "Resource": [
              "arn:aws:s3:::YOUR_TEMPLATE_BUCKET",
              "arn:aws:s3:::YOUR_TEMPLATE_BUCKET/*",
              "arn:aws:s3:::cf-templates-*",
              "arn:aws:s3:::cf-templates-*/*",
              "arn:aws:s3:::sc-*",
              "arn:aws:s3:::sc-*/*"
          ]
      }
```

# Menambahkan produk ke portofolio
<a name="catalogs_portfolios_adding-products"></a>

 Anda dapat menambahkan produk ke sejumlah portofolio. Ketika produk diperbarui, semua portofolio (termasuk portofolio bersama) yang berisi produk secara otomatis menerima versi baru. 

**Menambahkan produk dari katalog Anda ke portofolio**

1.  Arahkan ke halaman **daftar Produk**. 

1.  Pilih produk, lalu pilih **Tindakan**. Dari menu dropdown, pilih **Tambahkan produk ke** portofolio. Anda diarahkan ke halaman **Tambahkan *name-of-product* ke portofolio**. 

1.  Pilih portofolio, lalu pilih **Tambahkan produk ke portofolio**. 

Saat menambahkan produk Terraform ke portofolio, produk memerlukan batasan peluncuran. Anda harus memilih peran IAM dari akun Anda, memasukkan ARN peran IAM, atau memasukkan nama peran. Jika Anda menentukan nama peran dan jika akun menggunakan batasan peluncuran, akun akan menggunakan nama tersebut untuk peran IAM. Ini memungkinkan batasan peran peluncuran menjadi agnostik akun, memastikan Anda dapat membuat lebih sedikit sumber daya per akun bersama. Untuk detail dan instruksi, tinjau [Langkah 6: Tambahkan batasan Peluncuran ke produk Terraform Anda](getstarted-launchconstraint-Terraform.md) 

 Portofolio dapat berisi banyak produk yang merupakan campuran CloudFormation dan jenis produk Terraform. 

# Memperbarui produk
<a name="productmgmt-update"></a>

 Ketika Anda memperbarui template produk, Anda membuat versi baru dari produk. Versi produk baru secara otomatis tersedia untuk semua pengguna yang memiliki akses ke portofolio yang berisi produk. 

**catatan**  
Saat memperbarui produk yang sudah ada, Anda tidak dapat mengubah jenis produk (CloudFormation atau Teraform). Misalnya, jika Anda memperbarui CloudFormation produk, Anda tidak dapat mengganti CloudFormation template yang ada dengan file konfigurasi Terraform tar.gz. Anda harus memperbarui file CloudFormation template yang ada dengan file CloudFormation template baru.

 Pengguna akhir yang saat ini menjalankan produk yang disediakan dari versi produk sebelumnya dapat memperbarui produk yang disediakan ke versi baru. Ketika versi baru produk tersedia, pengguna dapat menggunakan perintah **Perbarui produk yang disediakan pada daftar produk** **yang disediakan atau halaman detail produk yang** **disediakan**. 

Sebelum Anda membuat versi baru suatu produk, AWS Service Catalog sarankan Anda menguji pembaruan produk Anda di CloudFormation atau di mesin Terraform untuk memastikan bahwa mereka berfungsi dengan baik.

**Untuk membuat versi produk baru**

1.  Arahkan ke halaman **daftar Produk**. 

1.  Pilih produk produk yang ingin Anda perbarui. Anda diarahkan ke halaman *Detail Produk*. 

1.  Pada halaman *Detail produk*, buka tab **Versi**, lalu pilih **Buat versi baru**. 

1.  Di bawah **Detail versi**, lakukan hal berikut: 
   + **Pilih template** - Ada empat cara untuk menambahkan file template. 

     *Gunakan file templat lokal* - Unggah CloudFormation templat atau file konfigurasi Terraform tar.gz dari drive lokal. 

     *Gunakan URL Amazon S3 - Tentukan URL* yang mengarah ke CloudFormation templat atau file konfigurasi Terraform tar.gz yang disimpan di Amazon S3. Jika Anda menentukan URL Amazon S3, itu harus dimulai dengan https://.

     *Gunakan repositori eksternal - Tentukan repositori* kode GitHub, GitHub Enterprise, atau Bitbucket Anda. AWS Service Catalog memungkinkan Anda untuk menyinkronkan produk ke file template. Untuk produk Terraform, format file template harus berupa satu file yang diarsipkan dalam Tar dan dikompresi dalam Gzip.

     *Gunakan CloudFormation tumpukan yang ada* - Masukkan ARN untuk tumpukan yang ada CloudFormation . Metode ini tidak mendukung produk Terraform Cloud atau Eksternal. 
   + **Judul versi** — Nama versi produk (misalnya, “v1", “v2beta”). Spasi tidak diperbolehkan. 
   + **Deskripsi** (opsional) — Deskripsi versi produk, termasuk bagaimana versi ini berbeda dari versi sebelumnya.

1. Pilih **Buat versi produk**.

 Anda juga dapat menggunakan CodePipeline untuk membuat dan mengonfigurasi pipeline untuk menyebarkan template produk Anda AWS Service Catalog, dan mengirimkan perubahan di repositori sumber Anda. Untuk informasi selengkapnya, lihat [Tutorial: Membuat Pipeline yang Menyebarkan ke AWS Service Catalog](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-S3-servicecatalog.html).

# Menyinkronkan produk ke file template dari GitHub, GitHub Enterprise, atau Bitbucket
<a name="git-synced-sc-products"></a>

AWS Service Catalog memungkinkan Anda untuk menyinkronkan produk ke file template yang dikelola melalui penyedia repositori eksternal. AWS Service Catalog mengacu pada produk dengan jenis koneksi template ini sebagai produk yang *disinkronkan dengan GIT*. Opsi repositori termasuk GitHub, GitHub Enterprise, atau Bitbucket. Setelah Anda mengotorisasi akun repositori eksternal, Anda dapat membuat AWS Service Catalog produk baru atau memperbarui produk yang ada untuk disinkronkan ke file templat di repositori. Akun AWS Ketika perubahan dilakukan pada file template dan dilakukan dalam repositori (misalnya, menggunakan git-push), AWS Service Catalog secara otomatis mendeteksi perubahan dan membuat versi produk baru (artefak). 

**Topics**
+ [Izin yang diperlukan untuk menyinkronkan produk ke file template eksternal](#required-perms-synced-repo)
+ [Buat koneksi akun](#create-synced-product)
+ [Melihat koneksi produk yang disinkronkan dengan Git](#view-repo-sync)
+ [Memperbarui koneksi produk yang disinkronkan dengan Git](#update-repo-sync)
+ [Menghapus koneksi produk yang disinkronkan dengan Git](#delete-repo-sync)
+ [Menyinkronkan produk Terraform ke file template dari GitHub, GitHub Enterprise, atau Bitbucket](#git-synced-Terraform)
+ [Wilayah AWS dukungan untuk produk yang disinkronkan dengan GIT](git-sync-supported-regions.md)

## Izin yang diperlukan untuk menyinkronkan produk ke file template eksternal
<a name="required-perms-synced-repo"></a>

Anda dapat menggunakan kebijakan berikut AWS Identity and Access Management (IAM) sebagai templat untuk memungkinkan AWS Service Catalog administrator menyinkronkan produk ke file templat dari repositori eksternal. Kebijakan ini mencakup izin yang diperlukan dari keduanya CodeConnections dan AWS Service Catalog. AWS Service Catalog merekomendasikan agar Anda menyalin kebijakan templat di bawah ini, dan juga menggunakan kebijakan AWS Service Catalog `AWSServiceCatalogAdminFullAccess` [terkelola saat mengaktifkan produk yang disinkronkan](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/security-iam-awsmanpol) dengan repositori. 

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "CodeStarAccess",
            "Effect": "Allow",
            "Action": [
            "codestar-connections:UseConnection",
            "codestar-connections:PassConnection",
            "codestar-connections:CreateConnection",
            "codestar-connections:DeleteConnection",
            "codestar-connections:GetConnection",
            "codestar-connections:ListConnections",
            "codestar-connections:ListInstallationTargets",
            "codestar-connections:GetInstallationUrl",
            "codestar-connections:StartOAuthHandshake",
            "codestar-connections:UpdateConnectionInstallation",
            "codestar-connections:GetIndividualAccessToken"
            ],
            "Resource": "arn:aws:codestar-connections:*:*:connection/*"
        },
        {
        "Sid": "CreateSLR",
        "Effect": "Allow",
        "Action": "iam:CreateServiceLinkedRole",
        "Resource": "arn:aws:iam::*:role/aws-service-role/sync.servicecatalog.amazonaws.com/AWSServiceRoleForServiceCatalogArtifactSync",
        "Condition": {
        "StringLike": {
        "iam:AWSServiceName": "sync.servicecatalog.amazonaws.com"
                }
            }
        }
    ]
}
```

------

## Buat koneksi akun
<a name="create-synced-product"></a>

Sebelum menyinkronkan file template ke AWS Service Catalog produk, Anda harus membuat dan mengotorisasi koneksi satu kali. account-to-account Anda menggunakan koneksi ini untuk menentukan detail repositori yang berisi file template yang diinginkan. Anda dapat membuat koneksi menggunakan AWS Service Catalog konsol, CodeConnections konsol, AWS Command Line Interface (CLI), atau. CodeConnections APIs 

Setelah membuat koneksi, Anda dapat menggunakan AWS Service Catalog konsol, AWS Service Catalog API, atau CLI untuk membuat produk yang disinkronkan AWS Service Catalog . AWS Service Catalog administrator dapat membuat produk baru atau memperbarui AWS Service Catalog produk yang ada berdasarkan file template di repositori dan cabang. Jika perubahan dilakukan di repositori, AWS Service Catalog secara otomatis mendeteksi perubahan dan membuat versi produk baru. Versi produk sebelumnya dipertahankan hingga batas versi yang ditentukan dan diberi **status usang**. 

Selain itu, AWS Service Catalog secara otomatis membuat peran terkait layanan (SLR) setelah koneksi dibuat. SLR ini memungkinkan AWS Service Catalog untuk mendeteksi setiap perubahan file template yang berkomitmen ke repositori. SLR juga memungkinkan AWS Service Catalog untuk secara otomatis membuat versi produk baru untuk produk yang disinkronkan. Untuk informasi selengkapnya tentang izin dan fungsionalitas SLR, lihat [Peran terkait layanan](#required-perms-synced-repo) untuk. AWS Service Catalog

**Untuk membuat produk baru yang disinkronkan dengan GIT**

1. Di panel navigasi kiri, pilih **Daftar produk**, lalu pilih **Buat produk**. 

1. Masukkan **detail Produk**. 

1. Di Detail versi, pilih **Tentukan repositori kode Anda menggunakan AWS CodeStar penyedia**, lalu pilih tautan **Buat AWS CodeStar koneksi baru**. 

1. Setelah Anda membuat koneksi, segarkan daftar koneksi, lalu pilih koneksi baru. **Tentukan detail repositori, termasuk jalur file **repositori**, **cabang**, dan templat.** 

   Untuk informasi tentang penggunaan file konfigurasi Terraform, lihat. [Menyinkronkan produk Terraform ke file template dari GitHub, GitHub Enterprise, atau Bitbucket](#git-synced-Terraform) 

   1. (Opsional saat membuat sumber daya AWS Service Catalog produk baru) Di bagian **Detail Dukungan**, tambahkan metadata untuk produk.

   1. (Opsional saat membuat sumber daya AWS Service Catalog produk baru) Di bagian **Tag**, pilih **Tambahkan tag baru** dan masukkan pasangan **Kunci** dan **Nilai**.

1. Pilih **Buat produk baru**. 

**Untuk membuat beberapa produk yang disinkronkan dengan GIT**

1. Di panel navigasi kiri AWS Service Catalog konsol, pilih **Daftar produk**, lalu pilih **Buat beberapa produk yang dikelola oleh git**. 

1. Masukkan **detail produk umum**. 

1. **Di detail repositori eksternal, pilih **AWS CodeStar koneksi**, lalu tentukan **repositori** dan cabang.** 

1. Di panel Tambahkan produk, masukkan **jalur file Template** dan **Nama produk**. Pilih **Tambahkan item baru** dan lanjutkan menambahkan produk sesuai keinginan.

1. Setelah menambahkan semua produk yang diinginkan, pilih **Massal membuat produk**. 

**Untuk menghubungkan AWS Service Catalog produk yang ada ke repositori eksternal**

1. Di panel navigasi kiri AWS Service Catalog konsol, pilih **Daftar produk**, lalu pilih **Connect products to an external repository**. 

1. **Pada halaman Pilih produk, pilih produk yang ingin Anda sambungkan ke repositori eksternal, lalu pilih Berikutnya.** 

1. Pada halaman Tentukan detail sumber, pilih AWS CodeStar koneksi yang ada, lalu tentukan **repositori**, **cabang**, dan jalur **file templat**. 

1. Pilih **Berikutnya**. 

1. Pada halaman Tinjau dan kirim, verifikasi detail koneksi, lalu pilih **Connect products ke repositori eksternal**. 

## Melihat koneksi produk yang disinkronkan dengan Git
<a name="view-repo-sync"></a>

Anda dapat menggunakan AWS Service Catalog konsol, API, atau AWS CLI untuk melihat detail koneksi repositori. **Untuk AWS Service Catalog produk yang ditautkan ke file template, Anda dapat mengambil informasi tentang koneksi repositori dan terakhir kali template disinkronkan dengan produk dari Status Sinkronisasi Terakhir.** 

**catatan**  
Anda dapat melihat informasi repositori dan **Status Sinkronisasi Terakhir** di tingkat produk. Pengguna harus memiliki izin IAM CodeConnections APIs untuk melihat detail repositori. Lihat [Izin yang diperlukan untuk menyinkronkan AWS Service Catalog produk ke file templat](#required-perms-synced-repo) untuk informasi selengkapnya tentang kebijakan yang diperlukan untuk izin IAM ini. 

**Untuk melihat detail koneksi dan repositori menggunakan Konsol Manajemen AWS**

1. Di panel navigasi kiri, pilih **Daftar produk**. 

1. Pilih produk dari daftar. 

1. Pada halaman **Produk**, navigasikan ke bagian **Detail sumber produk**. 

1. Untuk melihat ID revisi sumber untuk versi produk, pilih tautan **Versi terakhir yang dibuat**. Bagian **Detail versi** menampilkan ID revisi sumber. 

**Untuk melihat detail koneksi dan repositori menggunakan AWS CLI**

Dari AWS CLI, jalankan perintah berikut: 

`$ aws servicecatalog describe-product-as-admin`

`$ aws servicecatalog describe-provisioning-artifact`

`$ aws servicecatalog search-product-as-admin`

`$ aws servicecatalog list-provisioning-artifacts`

## Memperbarui koneksi produk yang disinkronkan dengan Git
<a name="update-repo-sync"></a>

Anda dapat memperbarui koneksi akun yang ada dan produk yang disinkronkan dengan GIT menggunakan AWS Service Catalog konsol, AWS Service Catalog API, atau. AWS CLI

Untuk mempelajari cara menghubungkan AWS Service Catalog produk yang sudah ada ke file template, lihat [Membuat koneksi produk baru yang disinkronkan dengan](#create-synced-product) GIT. 

**Untuk memperbarui produk yang ada ke produk yang disinkronkan dengan GIT**

1. Di panel navigasi kiri, pilih **Daftar produk**, lalu pilih salah satu opsi berikut:
   + Untuk memperbarui **satu produk**, pilih produk, navigasikan ke bagian **Detail sumber produk**, lalu pilih **Edit detail**. 
   + **Untuk memperbarui **beberapa produk**, pilih **Connect products ke repositori eksternal**, pilih hingga sepuluh produk, lalu pilih Next.** 

1. Di bagian **Detail sumber produk**, lakukan pembaruan berikut: 
   + Tentukan koneksi. 
   + Tentukan repositori. 
   + Tentukan cabang. 
   + Beri nama file template. 

1. Pilih **Simpan perubahan**. 

**catatan**  
Untuk produk yang belum terhubung ke repositori eksternal, Anda dapat menggunakan opsi **Connect to an external repository** yang ditampilkan di peringatan di bagian atas halaman info produk setelah memilih produk. 

Anda juga dapat menggunakan AWS Service Catalog konsol atau AWS CLI to 
+ Connect AWS Service Catalog produk yang sudah ada ke file template di repositori eksternal
+ Perbarui metadata produk, termasuk nama produk, deskripsi, dan tag. 
+ Konfigurasi ulang (perbarui sinkronisasi untuk menggunakan sumber repositori yang berbeda) koneksi untuk produk yang terhubung sebelumnya. AWS Service Catalog 

**Untuk memperbarui detail koneksi dan repositori menggunakan konsol AWS Service Catalog**

1. Di panel navigasi kiri AWS Service Catalog konsol, pilih **Daftar produk**, lalu pilih produk yang saat ini terhubung ke repositori eksternal. 

1. Di bagian **Detail sumber produk**, pilih **Edit sumber produk**. 

1. Di bagian **Detail sumber produk**, tentukan repositori baru yang diinginkan. 

1. Pilih **Simpan perubahan**. 

**Untuk memperbarui koneksi dan detail repositori menggunakan AWS CLI**

Dari AWS CLI run the `$ aws servicecatalog update-product` and `$ aws servicecatalog update-provisioning-artifact` command. 

## Menghapus koneksi produk yang disinkronkan dengan Git
<a name="delete-repo-sync"></a>

Anda dapat menghapus koneksi antara AWS Service Catalog produk dan file template menggunakan AWS Service Catalog konsol, CodeConnections API, atau file AWS CLI. Saat Anda memutuskan sambungan produk dari file templat, produk yang disinkronkan akan beralih ke AWS Service Catalog produk yang dikelola secara teratur. *Setelah memutuskan sambungan produk, jika file template diubah dan dilakukan di repositori yang terhubung sebelumnya, perubahan tidak tercermin.* Untuk menghubungkan kembali AWS Service Catalog produk ke file template di repositori eksternal, lihat [Memperbarui koneksi dan]() produk yang disinkronkan. AWS Service Catalog 

**Untuk memutuskan sambungan produk yang disinkronkan dengan GIT menggunakan konsol AWS Service Catalog**

1. Dalam Konsol Manajemen AWS, pilih **Daftar produk** dari panel navigasi kiri. 

1. Pilih produk dari daftar. 

1. Pada halaman **Produk**, navigasikan ke bagian **Detail sumber produk**. 

1. Pilih **Putuskan sambungan**. 

1. Konfirmasikan tindakan, lalu pilih **Putuskan sambungan**. 

**Untuk memutuskan sambungan produk yang disinkronkan dengan GIT menggunakan AWS CLI**

Dari AWS CLI, jalankan `$ aws servicecatalog update-product` perintah. Dalam `ConnectionParameters` input, hapus koneksi yang ditentukan. 

**Untuk menghapus koneksi menggunakan CodeConnections API atau AWS CLI**

Di CodeConnections API atau AWS CLI, jalankan `$ aws codestar-connections delete-connection` perintah. 

## Menyinkronkan produk Terraform ke file template dari GitHub, GitHub Enterprise, atau Bitbucket
<a name="git-synced-Terraform"></a>

Saat membuat produk yang disinkronkan GIT menggunakan file konfigurasi Terraform, jalur file hanya menerima format tar.gz. Format folder Terraform tidak diterima di jalur file. 

# Wilayah AWS dukungan untuk produk yang disinkronkan dengan GIT
<a name="git-sync-supported-regions"></a>

AWS Service Catalog mendukung produtcs yang disinkronkan GIT Wilayah AWS seperti yang ditunjukkan pada tabel di bawah ini. 


****  

| Wilayah AWS nama | Wilayah AWS identitas | Support untuk produk yang disinkronkan dengan GIT | 
| --- | --- | --- | 
| US East (Northern Virginia) | us-east-1 | Ya | 
| US East (Ohio) | us-east-2 | Ya | 
| US West (N. California) | us-west-1 | Ya | 
| US West (Oregon) | us-west-2 | Ya | 
| Africa (Cape Town) | af-south-1 | Tidak | 
| Asia Pasifik (Hong Kong) | ap-east-1 | Tidak | 
| Asia Pasifik (Jakarta) | ap-southeast-3 | Tidak | 
| Asia Pasifik (Mumbai) | ap-south-1 | Ya | 
| Asia Pacific (Osaka) | ap-northeast-3 | Tidak | 
| Asia Pasifik (Seoul) | ap-northeast-2 | Ya | 
| Asia Pacific (Singapore) | ap-southeast-1 | Ya | 
| Asia Pacific (Sydney) | ap-southeast-2 | Ya | 
| Asia Pacific (Tokyo) | ap-northeast-1 | Ya | 
| Canada (Central) | ca-sentral-1 | Ya | 
| Eropa (Frankfurt) | eu-central-1 | Ya | 
| Eropa (Irlandia) | eu-west-1 | Ya | 
| Eropa (London) | eu-west-2 | Ya | 
| Europe (Milan) | eu-south-1 | Tidak | 
| Eropa (Paris) | eu-west-3 | Ya | 
| Eropa (Stockholm) | eu-north-1 | Ya | 
| Timur Tengah (Bahrain) | me-south-1 | Tidak | 
| Amerika Selatan (Sao Paulo) | sa-east-1 | Ya | 
| AWS GovCloud (AS-Timur) | us-gov-east-1 | Tidak | 
| AWS GovCloud (AS-Barat) | us-gov-west-1 | Tidak | 

# Menghapus produk
<a name="productmgmt-delete"></a>

Saat Anda menghapus produk, AWS Service Catalog hapus semua versi produk dari setiap portofolio yang berisi produk. 

AWS Service Catalog memungkinkan Anda untuk menghapus produk menggunakan AWS Service Catalog konsol atau AWS CLI. Agar berhasil menghapus produk, Anda harus memisahkan semua sumber daya yang terkait dengan produk terlebih dahulu. Contoh asosiasi sumber daya produk termasuk asosiasi portofolio, anggaran TagOptions, dan Tindakan Layanan. 

**penting**  
 Anda tidak dapat memulihkan produk setelah dihapus. 

**Untuk menghapus produk menggunakan AWS Service Catalog konsol**

1.  Arahkan ke halaman **Portofolio** dan pilih portofolio yang berisi produk yang ingin Anda hapus. 

1.  Pilih produk yang ingin Anda hapus, lalu pilih **Hapus** di kanan atas panel produk. 

1. Untuk produk *tanpa sumber daya terkait*, konfirmasikan produk yang ingin Anda **hapus dengan memasukkan hapus** di kotak teks, lalu pilih **Hapus**. 

   Untuk produk *dengan sumber daya terkait*, lanjutkan ke langkah 4. 

1. Di jendela **Hapus produk**, tinjau tabel **Asosiasi**, yang menampilkan semua sumber daya terkait produk. AWS Service Catalog mencoba untuk memisahkan sumber daya ini saat Anda menghapus produk. 

1. Konfirmasikan bahwa Anda ingin menghapus produk dan menghapus semua sumber daya terkait dengan memasukkan **hapus** di kotak teks. 

1. Pilih **Putuskan dan hapus**. 

Jika AWS Service Catalog tidak dapat memisahkan semua sumber daya produk, produk tidak dihapus. Jendela **Delete product** menampilkan jumlah disasosiasi yang gagal dan deskripsi untuk setiap kegagalan. Untuk informasi selengkapnya tentang menyelesaikan disasosiasi sumber daya yang gagal saat menghapus produk, lihat *Menyelesaikan disasosiasi sumber daya yang gagal saat* menghapus produk di bawah ini. 

**Topics**
+ [Menghapus produk menggunakan AWS CLI](product-delete-cli.md)
+ [Menyelesaikan disasosiasi sumber daya yang gagal saat menghapus produk](product-delete-exception.md)

# Menghapus produk menggunakan AWS CLI
<a name="product-delete-cli"></a>

AWS Service Catalog memungkinkan Anda menggunakan [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)(AWS CLI) untuk menghapus produk dari portofolio Anda. AWS CLI Ini adalah alat open source yang memungkinkan Anda berinteraksi dengan AWS layanan menggunakan perintah di shell baris perintah Anda. Fungsi AWS Service Catalog force-delete memerlukan [AWS CLI alias](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-alias.html), yang merupakan pintasan yang dapat Anda buat AWS CLI untuk mempersingkat perintah atau skrip yang sering Anda gunakan. 

## Prasyarat
<a name="product-delete-cli-requirements"></a>
+ Instal dan konfigurasikan AWS CLI. Untuk informasi selengkapnya, lihat [Menginstal atau memperbarui versi terbaru dari](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) [dasar-dasar Konfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html) dan. Gunakan AWS CLI versi minimum 1.11.24 atau 2.0.0. 
+ Alias CLI produk hapus memerlukan terminal yang kompatibel dengan bass dan prosesor JSON baris perintah JQ. [Untuk informasi selengkapnya tentang menginstal prosesor JSON baris perintah, lihat Download jq.](https://stedolan.github.io/jq/download/) 
+ Buat AWS CLI Alias untuk mengumpulkan panggilan `Disassociation` API, memungkinkan Anda menghapus produk dalam satu perintah. 

Agar berhasil menghapus produk, Anda harus memisahkan semua sumber daya yang terkait dengan produk terlebih dahulu. Contoh asosiasi sumber daya produk termasuk asosiasi portofolio, anggaran, Opsi Tag, dan Tindakan Layanan. Saat menggunakan CLI untuk menghapus produk, `force-delete-product` alias CLI memungkinkan Anda memanggil API untuk memisahkan sumber daya apa pun yang akan mencegah `Disassociate` API. `DeleteProduct` Ini menghindari panggilan terpisah untuk disasosiasi individu. 

**catatan**  
Jalur file yang ditunjukkan dalam prosedur di bawah ini dapat bervariasi tergantung pada sistem operasi yang Anda gunakan untuk melakukan tindakan ini. 

## Membuat AWS CLI alias untuk menghapus produk AWS Service Catalog
<a name="product-delete-cli-alias"></a>

Saat menggunakan AWS CLI untuk menghapus AWS Service Catalog produk, `force-delete-product` alias CLI memungkinkan Anda memanggil `Disassociate` API untuk memisahkan sumber daya apa pun yang akan mencegah panggilan. `DeleteProduct` 

**Buat `alias` file di folder AWS CLI konfigurasi Anda**

1. Di AWS CLI konsol, arahkan ke folder configuraiton. Secara default, jalur folder konfigurasi ada `~/.aws/` di Linux dan macOS, atau `%USERPROFILE%\.aws\` di Windows. 

1. Buat sub-folder bernama `cli` menggunakan navigasi file atau dengan memasukkan perintah berikut di terminal pilihan Anda: 

   ```
                $ mkdir -p ~/.aws/cli
   ```

   Jalur default `cli` folder yang dihasilkan ada `~/.aws/cli/` di Linux dan macOS, atau `%USERPROFILE%\.aws\cli` di Windows. 

1. Di `cli` folder baru, buat file teks bernama `alias` tanpa ekstensi file. Anda dapat membuat `alias` file menggunakan navigasi file atau dengan memasukkan perintah berikut di terminal pilihan Anda: 

   ```
                 $ touch ~/.aws/cli/alias
   ```

1. Masukkan `[toplevel]` pada baris pertama.

1. Simpan file tersebut. 

Selanjutnya, Anda dapat menambahkan force-delete-product alias ke `alias` file Anda dengan menempelkan skrip alias secara manual ke dalam file, atau dengan menggunakan perintah di jendela terminal. 

**Tambahkan force-delete-product alias ke file Anda `alias` secara manual**

1. Di AWS CLI konsol, navigasikan ke folder AWS CLI konfigurasi Anda dan buka `alias` file. 

1. Masukkan alias kode berikut ke dalam file, di bawah `[toplevel]` baris: 

   ```
                [command servicecatalog]
             	 force-delete-product =
             	   !f() {
             	     if [ "$#" -ne 1 ]; then
             	         echo "Illegal number of parameters"
             	         exit 1
             	     fi
             	 
             	     if [[ "$1" != prod-* ]]; then
             	        echo "Please provide a valid product id."
             	        exit 1
             	     fi
             	 
             	     productId=$1
             	     describeProductAsAdminResponse=$(aws servicecatalog describe-product-as-admin --id $productId)
             	     listPortfoliosForProductResponse=$(aws servicecatalog list-portfolios-for-product --product-id $productId)
             	 
             	     tagOptions=$(echo "$describeProductAsAdminResponse" | jq -r '.TagOptions[].Id')
             	     budgetName=$(echo "$describeProductAsAdminResponse" | jq -r '.Budgets[].BudgetName')
             	     portfolios=$(echo "$listPortfoliosForProductResponse" | jq -r '.PortfolioDetails[].Id')
             	     provisioningArtifacts=$(echo "$describeProductAsAdminResponse" | jq -r '.ProvisioningArtifactSummaries[].Id')
             	     provisioningArtifactServiceActionAssociations=()
             	 
             	     for provisioningArtifactId in $provisioningArtifacts; do
             	       listServiceActionsForProvisioningArtifactResponse=$(aws servicecatalog list-service-actions-for-provisioning-artifact --product-id $productId --provisioning-artifact-id $provisioningArtifactId)
             	       serviceActions=$(echo "$listServiceActionsForProvisioningArtifactResponse" | jq -r '[.ServiceActionSummaries[].Id] | join(",")')
             	       if [[ -n "$serviceActions" ]]; then
             	         provisioningArtifactServiceActionAssociations+=("${provisioningArtifactId}:${serviceActions}")
             	       fi
             	     done
             	 
             	     echo "Before deleting a product, the following associated resources must be disassociated. These resources will not be deleted. This action may take some time, depending on the number of resources being disassociated."
             	 
             	     echo "Portfolios:"
             	     for portfolioId in $portfolios; do
             	       echo "\t${portfolioId}"
             	     done
             	 
             	     echo "Budgets:"
             	     if [[ -n "$budgetName" ]]; then
             	       echo "\t${budgetName}"
             	     fi
             	 
             	     echo "Tag Options:"
             	     for tagOptionId in $tagOptions; do
             	       echo "\t${tagOptionId}"
             	     done
             	 
             	     echo "Service Actions on Provisioning Artifact:"
             	     for association in "${provisioningArtifactServiceActionAssociations[@]}"; do
             	       echo "\t${association}"
             	     done
             	 
             	     read -p "Are you sure you want to delete ${productId}? y,n "
             	     if [[ ! $REPLY =~ ^[Yy]$ ]]; then
             	        exit
             	     fi
             	 
             	     for portfolioId in $portfolios; do
             	       echo "Disassociating ${portfolioId}"
             	       aws servicecatalog disassociate-product-from-portfolio --product-id $productId --portfolio-id $portfolioId
             	     done
             	 
             	     if [[ -n "$budgetName" ]]; then
             	       echo "Disassociating ${budgetName}"
             	       aws servicecatalog disassociate-budget-from-resource --budget-name "$budgetName" --resource-id $productId
             	     fi
             	 
             	     for tagOptionId in $tagOptions; do
             	       echo "Disassociating ${tagOptionId}"
             	       aws servicecatalog disassociate-tag-option-from-resource --tag-option-id $tagOptionId --resource-id $productId
             	     done
             	 
             	     for association in "${provisioningArtifactServiceActionAssociations[@]}"; do
             	       associationPair=(${association//:/ })
             	       provisioningArtifactId=${associationPair[0]}
             	       serviceActionsList=${associationPair[1]}
             	       serviceActionIds=${serviceActionsList//,/ }
             	       for serviceActionId in $serviceActionIds; do
             	         echo "Disassociating ${serviceActionId} from ${provisioningArtifactId}"
             	         aws servicecatalog disassociate-service-action-from-provisioning-artifact --product-id $productId --provisioning-artifact-id $provisioningArtifactId --service-action-id $serviceActionId
             	       done
             	     done
             	 
             	     echo "Deleting product ${productId}"
             	     aws servicecatalog delete-product --id $productId
             	 
             	   }; f
   ```

1. Simpan file tersebut. 

**Gunakan jendela terminal untuk menambahkan force-delete-product alias ke file Anda `alias`**

1. Buka jendela terminal Anda dan jalankan perintah berikut

   `$ cat >> ~/.aws/cli/alias`

1. Tempel skrip alias ke jendela terminal, lalu tekan *CTRL\$1D* untuk keluar dari perintah. `cat` 

**Panggil force-delete-product alias**

1. Di jendela terminal Anda, jalankan perintah berikut untuk memanggil alias delete product

   `$ aws servicecatalog force-delete-product {product-id} `

   Contoh di bawah ini menunjukkan perintah `force-delete-product` alias dan respons yang dihasilkan 

   ```
                 $ aws servicecatalog force-delete-product prod-123
   ```

   ```
                 Before deleting a product, the following associated resources must be disassociated. These resources will not be deleted. This action may take some time, depending on the number of resources being disassociated.
                 Portfolios:
                   port-123
                 Budgets:
                     budgetName
                 Tag Options:
                     tag-123
                 Service Actions on Provisioning Artifact:
                     pa-123:act-123
                 Are you sure you want to delete prod-123? y,n
   ```

1. Masukkan `y` untuk mengonfirmasi bahwa Anda ingin menghapus produk. 

Setelah berhasil menghapus produk, jendela terminal menampilkan hasil berikut

```
          Disassociating port-123
          Disassociating budgetName
          Disassociating tag-123
          Disassociating act-123 from pa-123
          Deleting product prod-123
```

## Sumber daya tambahan
<a name="product-delete-cli-resources"></a>

Untuk informasi selengkapnya tentang AWS CLI, menggunakan alias, dan menghapus AWS Service Catalog produk, tinjau sumber daya berikut:
+ [Membuat dan menggunakan AWS CLI alias](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-alias.html) dalam panduan pengguna *AWS Command Line Interface (CLI*). 
+ AWS CLI repositori [alias repositori git](https://github.com/awslabs/awscli-aliases). 
+ [Menghapus AWS Service Catalog produk](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/productmgmt-delete.html). 
+ [AWS Re: Invent 2016: Pengguna yang Efektif AWS CLI di](https://youtu.be/Xc1dHtWa9-Q?t=1593). *YouTube* 

# Menyelesaikan disasosiasi sumber daya yang gagal saat menghapus produk
<a name="product-delete-exception"></a>

Jika upaya Anda sebelumnya untuk [menghapus produk](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/productmgmt-delete.html) gagal karena pengecualian disasosiasi sumber daya, tinjau daftar pengecualian dan resolusinya di bawah ini. 

**catatan**  
Jika Anda menutup jendela **Menghapus produk** sebelum menerima pesan pemutusan sumber daya yang gagal, Anda dapat mengikuti langkah satu hingga tiga di bagian *Hapus produk* untuk membuka jendela lagi.

**Untuk mengatasi pemisahan sumber daya yang gagal**

Di jendela **Hapus produk**, tinjau kolom **Status** tabel Asosiasi. Identifikasi pengecualian pemisahan sumber daya yang gagal dan resolusi yang disarankan:


****  

| Jenis pengecualian status | Penyebab | Resolusi | 
| --- | --- | --- | 
| Produk prod-\$1\$1\$1\$1 | AWS Service Catalog tidak dapat menghapus produk karena produk masih terkait TagOptions, anggaran, setidaknya satu ProvisioningArtifact dengan tindakan terkait, produk masih ditetapkan ke Portofolio, produk memiliki pengguna, atau produk memiliki kendala.  | Cobalah untuk menghapus produk lagi. | 
| Pengguna: username tidak berwenang untuk melakukan: | Pengguna yang mencoba menghapus produk tidak memiliki izin yang diperlukan untuk memisahkan sumber daya produk.  | AWS Service Catalog merekomendasikan untuk menghubungi administrator akun Anda untuk informasi selengkapnya tentang pemutusan sumber daya produk yang saat ini tidak memiliki izin untuk memisahkan diri.  | 

# Mengelola Versi
<a name="managing-versions"></a>

 Anda menetapkan versi produk ketika Anda membuat produk, dan Anda dapat memperbarui versi produk setiap saat. 

 Versi memiliki CloudFormation template, judul, deskripsi, status, dan panduan. 

## Status Versi
<a name="version-status"></a>

 Versi dapat memiliki salah satu dari tiga status: 
+  **Aktif** - Versi aktif muncul dalam daftar versi dan mengizinkan pengguna untuk meluncurkannya. 
+  **Tidak aktif** - Versi tidak aktif tersembunyi dari daftar versi. Produk yang sudah tersedia yang diluncurkan dari versi ini tidak akan terpengaruh. 
+  **Dihapus** - Versi yang dihapus dihapus dari daftar versi. Menghapus versi tidak dapat dibatalkan. 

## Panduan Versi
<a name="version-guidance"></a>

 Anda dapat mengatur panduan versi untuk menyediakan informasi kepada pengguna akhir tentang versi produk. Panduan versi hanya mempengaruhi versi produk yang aktif. 

 Ada dua opsi untuk panduan versi: 
+  **Tidak ada** - Secara default, versi produk tidak memiliki panduan apa pun. Pengguna akhir dapat menggunakan versi tersebut untuk memperbarui dan meluncurkan produk yang disediakan. 
+  **Usang - Pengguna tidak dapat meluncurkan produk baru yang disediakan menggunakan versi produk yang tidak digunakan lagi**. Jika produk yang disediakan p yang diluncurkan sebelumnya menggunakan versi yang sekarang tidak digunakan lagi, pengguna hanya dapat memperbarui produk yang disediakan tersebut menggunakan versi yang ada atau versi baru. 

## Memperbarui Versi
<a name="updating-versions"></a>

 Anda menetapkan versi produk saat membuat sebuah produk, dan juga dapat memperbarui versi kapan pun. Untuk informasi selengkapnya tentang pembuatan produk, lihat [Membuat Produk](productmgmt-cloudresource.md). 

**Untuk memperbarui versi produk**

1.  Di AWS Service Catalog konsol, pilih **Produk**. 

1.  Dari daftar produk, pilih produk yang ingin Anda perbarui versinya. 

1.  Pada halaman **Detail Produk**, pilih tab **Versi**, lalu pilih versi yang ingin Anda perbarui. 

1.  Pada halaman **Detail versi**, edit versi produk, lalu pilih **Simpan perubahan**. 