Tampilan organisasi (CLI)

Anda juga dapat mengaktifkan fitur tampilan organisasi melalui AWS Command Line Interface (AWS CLI) dari pada konsol AWS Health tersebut. Untuk menggunakan konsol tersebut, lihat Mengaktifkan tampilan organisasi (konsol).

catatan

Jika Anda ingin mengizinkan pengguna mengakses akun manajemen untuk fitur tampilan organisasi, mereka harus memiliki izin sepertiAWSHealthFullAccesskebijakan. Untuk informasi selengkapnya, lihat AWS Health contoh kebijakan berbasis identitas.

Daftar Isi

• Mengaktifkan tampilan organisasi (CLI)
• Melihat peristiwa tampilan organisasi (CLI)
• Nonaktifkan tampilan organisasi (CLI)
• Tampilan organisasi AWS Health operasi API

Mengaktifkan tampilan organisasi (CLI)

Anda dapat mengaktifkan tampilan organisasi dengan menggunakanEnableHealthServiceAccessForOrganizationOperasi API.

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) atau kode Anda sendiri untuk memanggil operasi ini.

catatan

• Anda harus memilikiBisnis,Perusahaan On-Ramp, atauEnterpriseRencana dukungan untuk memanggilAWS HealthAPI.

• Anda harus menggunakan titik akhir Wilayah US East (N. Virginia).

Perintah AWS CLI berikut memungkinkan fitur ini dari akun AWS Anda. Anda dapat menggunakan perintah ini dari akun manajemen atau dari akun yang dapat mengambil peran dengan izin yang dibutuhkan.

aws health enable-health-service-access-for-organization --region us-east-1

Contoh kode berikut memanggilEnableHealthServiceAccessForOrganizationOperasi API.

Python

import boto3

client = boto3.client('health')

response = client.enable_health_service_access_for_organization()

print(response)

Java

Anda dapat menggunakan SDK AWS untuk versi Java 2.0 untuk contoh berikut.

import software.amazon.awssdk.services.health.HealthClient;
import software.amazon.awssdk.services.health.HealthClientBuilder;
 
import software.amazon.awssdk.services.health.model.ConcurrentModificationException;
import software.amazon.awssdk.services.health.model.EnableHealthServiceAccessForOrganizationRequest;
import software.amazon.awssdk.services.health.model.EnableHealthServiceAccessForOrganizationResponse;
import software.amazon.awssdk.services.health.model.DescribeHealthServiceStatusForOrganizationRequest;
import software.amazon.awssdk.services.health.model.DescribeHealthServiceStatusForOrganizationResponse;
 
import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider;
 
import software.amazon.awssdk.regions.Region;
 
public class EnableHealthServiceAccessDemo {
    public static void main(String[] args) {
        HealthClient client = HealthClient.builder()
            .region(Region.US_EAST_1)
            .credentialsProvider(
                DefaultCredentialsProvider.builder().build()
            )
            .build();
 
        try {
            DescribeHealthServiceStatusForOrganizationResponse statusResponse = client.describeHealthServiceStatusForOrganization(
                DescribeHealthServiceStatusForOrganizationRequest.builder().build()
            );
 
            String status = statusResponse.healthServiceAccessStatusForOrganization();
            if ("ENABLED".equals(status)) {
                System.out.println("EnableHealthServiceAccessForOrganization already enabled!");
                return;
            }
 
            client.enableHealthServiceAccessForOrganization(
                EnableHealthServiceAccessForOrganizationRequest.builder().build()
            );
 
            System.out.println("EnableHealthServiceAccessForOrganization is in progress");
        } catch (ConcurrentModificationException cme) {
            System.out.println("EnableHealthServiceAccessForOrganization is already in progress. Wait for the action to complete before trying again.");
        } catch (Exception e) {
            System.out.println("EnableHealthServiceAccessForOrganization FAILED: " + e);
        }
    }
}

Untuk informasi selengkapnya, lihat Panduan Developer AWS SDK for Java 2.0.

Ketika Anda mengaktifkan fitur ini,AWSServiceRoleForHealth_Organizations peran terkait layanandenganHealth_OrganizationsServiceRolePolicy AWSkebijakan yang dikelola diterapkan ke akun manajemen dalam organisasi.

catatan

Mengaktifkan fitur ini adalah proses asinkron dan membutuhkan waktu untuk menyelesaikannya. Anda dapat menghubungiDescribeHealthServiceStatusForOrganizationoperasi untuk memeriksa status proses.

Melihat peristiwa tampilan organisasi (CLI)

Setelah Anda mengaktifkan fitur ini, AWS Health mulai mencatat peristiwa yang memengaruhi akun dalam organisasi. Saat akun bergabung dengan organisasi Anda, AWS Health secara otomatis menambahkan akun ke tampilan organisasi.

catatan

AWS Health tidak merekam peristiwa yang terjadi di organisasi Anda sebelum Anda mengaktifkan tampilan organisasi.

Bila akun meninggalkan organisasi Anda, peristiwa baru dari akun tersebut tidak lagi masuk ke tampilan organisasi. Namun, peristiwa yang ada tetap dan Anda masih bisa kueri hingga batas 90 hari.

AWS mempertahankan data kebijakan untuk akun selama 90 hari sejak tanggal efektif penutupan akun administrator. Di akhir periode 90 hari, AWS menghapus semua data kebijakan untuk akun secara permanen.

• Untuk mempertahankan temuan selama lebih dari 90 hari, Anda dapat mengarsipkan kebijakan. Anda juga dapat menggunakan tindakan kustom denganEventBridgeaturan untuk menyimpan temuan dalam ember S3.

• Selama AWS mempertahankan data kebijakan, saat Anda membuka kembali akun yang tertutup, AWS menetapkan ulang akun sebagai administrator layanan dan memulihkan data kebijakan layanan untuk akun.

• Untuk informasi lebih lanjut, lihatMenutup akun.

penting

Untuk pelanggan di Wilayah AWS GovCloud (US):

• Sebelum menutup akun, cadangkan dan kemudian hapus sumber daya akun. Anda tidak akan lagi memiliki akses ke mereka setelah Anda menutup akun.

Anda dapat menggunakan operasi API AWS Health untuk mengembalikan peristiwa dari tampilan organisasi.

contoh : Menjelaskan peristiwa tampilan organisasi

Perintah AWS CLI berikut mengembalikan peristiwa kesehatan untuk akun AWS di organisasi Anda.

aws health describe-events-for-organization --region us-east-1

Lihat bagian berikut untuk operasi API AWS Health lain.

Nonaktifkan tampilan organisasi (CLI)

Anda dapat menonaktifkan tampilan organisasi dengan menggunakanDisableHealthServiceAccessForOrganizationOperasi API.

Perintah AWS CLI berikut menonaktifkan fitur ini dari akun Anda.

aws health disable-health-service-access-for-organization --region us-east-1

catatan

Anda juga dapat menonaktifkan fitur organisasi dengan menggunakan OrganisasiNonaktifkanAWSServiceAccessOperasi API. Setelah Anda memanggil operasi ini, AWS Health berhenti menggabungkan peristiwa untuk semua akun lain di organisasi Anda. Jika Anda memanggil operasi API AWS Health untuk tampilan organisasi, AWS Health mengembalikan kesalahan. AWS Health berlanjut mengumpulkan peristiwa kesehatan untuk akun AWS Anda.

Setelah Anda menonaktifkan fitur ini, AWS Health tidak lagi mengumpulkan acara dari organisasi Anda. Namun, peran yang berkaitan dengan layanan tetap ada di akun manajemen hingga Anda menghapusnya melalui konsol AWS Identity and Access Management (IAM), API IAM, atau AWS CLI. Untuk informasi lebih lanjut, lihat Menghapus Peran terkait layanan dalam Panduan Pengguna IAM.

Tampilan organisasi AWS Health operasi API

Anda dapat menggunakan berikut operasi API AWS Health untuk tampilan organisasi:

• DescribeEventsForOrganization- Mengembalikan informasi ringkasan tentang peristiwa di seluruh organisasi.

• DescribeAffectedAccountsForOrganization- Mengembalikan daftarAWSakun dalam organisasi yang dipengaruhi oleh peristiwa yang ditentukan.

• DescribeEventDetailsForOrganization- Mengembalikan informasi rinci tentang peristiwa yang ditentukan untuk satu atau lebih akun dalam organisasi.

• DescribeAffectedEntitiesForOrganization- Mengembalikan daftar entitas yang telah dipengaruhi oleh satu atau lebih peristiwa untuk satu atau lebih akun dalam suatu organisasi.

Anda dapat menggunakan operasi berikut untuk mengaktifkan atau nonaktifkan AWS Health dari bekerja dengan Organisasi:

• EnableHealthServiceAccessForOrganization— HibahAWS Healthizin untuk berinteraksi dengan Organisasi dan menerapkan SLR ke akun manajemen di organisasi.

• DisableHealthServiceAccessForOrganization- Mencabut izin untukAWS Healthuntuk berinteraksi dengan Organisasi.

• DescribeHealthServiceStatusForOrganization- Mengembalikan informasi status tentang apakahAWS Healthdiaktifkan untuk organisasi Anda.

Anda harus memiliki paket Business, Enterprise On-Ramp, atau Enterprise Support untuk memanggil operasi API ini. Jika Anda memanggil operasi DescribeEventForOrganization dan DescribeAffectedAccountsForOrganization dari akun yang memiliki setidaknya rencana dukungan Bisnis, Anda dapat mengembalikan informasi tentang akun apa pun di organisasi, terlepas dari tingkat dukungan akun individual. Lihat contoh-contoh berikut.

contoh Contoh: Organisasi dengan akun yang memiliki rencana dukungan Bisnis dan Developer

• Anda memiliki tiga akun di organisasi Anda. Akun manajemen memiliki rencana dukungan Bisnis dan dua akun lainnya memiliki rencana dukungan Developer.

• Anda memanggil operasi API DescribeEventForOrganization dari akun manajemen atau dari akun yang dapat mengambil peran dengan izin yang diperlukan.

• AWS Health mengembalikan informasi untuk ketiga akun.

Jika Anda meneleponDescribeEventDetailsForOrganizationdanDescribeAffectedEntitiesForOrganizationOperasi API dari akun yang memiliki setidaknya paket dukungan Bisnis, Anda hanya dapat mengembalikan informasi tentang akun di organisasi yang memiliki paket Dukungan Bisnis, Perusahaan On-Ramp, atau Perusahaan.

contoh Contoh: Organisasi dengan akun yang memiliki paket Dukungan Perusahaan, Bisnis, dan Pengembang

• Anda memiliki lima akun di organisasi Anda. Akun manajemen memiliki rencana dukungan Korporasi, dua akun memiliki rencana dukungan Bisnis, dan dua akun memiliki rencana dukungan Developer.

• Anda memanggil operasi API DescribeEventDetailsForOrganization dari akun manajemen.

• AWS Health mengembalikan informasi hanya untuk akun yang memiliki rencana dukungan Korporasi atau Bisnis. Akun yang memiliki rencana dukungan Developer muncul di tanggapan failedSet.