View a markdown version of this page

AWS Cloud Map contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Dokumentasi ini AWS CLI hanya untuk Versi 1.

Kami mengumumkan akhir dukungan yang akan datang untuk AWS CLI versi 1. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat pengumuman. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

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

AWS Cloud Map contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface with AWS Cloud Map.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakancreate-http-namespace.

AWS CLI

Untuk membuat namespace HTTP

create-http-namespaceContoh berikut membuat namespace example.com HTTP.

aws servicediscovery create-http-namespace \
    --name example.com \
    --creator-request-id example-request-id

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation. Untuk informasi selengkapnya, lihat get-operation.

Untuk informasi selengkapnya tentang membuat namespace, lihat Membuat namespace AWS Cloud Map untuk mengelompokkan layanan aplikasi di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakancreate-private-dns-namespace.

AWS CLI

Untuk membuat namespace DNS pribadi

create-private-dns-namespaceContoh berikut membuat namespace DNS pribadi.

aws servicediscovery create-private-dns-namespace \
    --name example.com \
    --vpc vpc-1c56417b

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation. Untuk informasi selengkapnya, lihat get-operation.

Untuk informasi selengkapnya, lihat Membuat ruang nama di Panduan Pengembang AWS Peta Cloud.

Contoh kode berikut menunjukkan cara menggunakancreate-public-dns-namespace.

AWS CLI

Untuk membuat namespace DNS publik

create-public-dns-namespaceContoh berikut membuat namespace example.com DNS publik.

aws servicediscovery create-public-dns-namespace \
    --name example-public-dns.com \
    --creator-request-id example-public-request-id \
    --properties DnsProperties={SOA={TTL=60}}

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation.

Untuk informasi selengkapnya tentang membuat namespace, lihat Membuat namespace AWS Cloud Map untuk mengelompokkan layanan aplikasi di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakancreate-service.

AWS CLI

Contoh 1: Untuk membuat layanan menggunakan ID namespace

create-serviceContoh berikut membuat layanan.

aws servicediscovery create-service \
    --name myservice \
    --namespace-id  ns-ylexjili4cdxy3xm \
    --dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"

Output:

{
    "Service": {
        "Id": "srv-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "myservice",
        "NamespaceId": "ns-abcd1234xmpl5678",
        "DnsConfig": {
            "NamespaceId": "ns-abcd1234xmpl5678",
            "RoutingPolicy": "MULTIVALUE",
            "DnsRecords": [
                {
                    "Type": "A",
                    "TTL": 60
                }
            ]
        },
        "Type": "DNS_HTTP",
        "CreateDate": "2025-08-18T13:45:31.023000-05:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
        "CreatedByAccount": "123456789012"
    }
}

Untuk informasi selengkapnya, lihat Membuat layanan AWS Cloud Map untuk komponen aplikasi di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk membuat layanan menggunakan namespace ARN

create-serviceContoh berikut membuat layanan menggunakan namespace ARN alih-alih ID namespace. Menentukan namespace ARN diperlukan saat membuat layanan di namespace bersama.

aws servicediscovery create-service \
    --name myservice-arn \
    --namespace-id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
    --dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"

Output:

{
    "Service": {
        "Id": "srv-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "myservice-arn",
        "NamespaceId": "ns-abcd1234xmpl5678",
        "DnsConfig": {
            "NamespaceId": "ns-abcd1234xmpl5678",
            "RoutingPolicy": "MULTIVALUE",
            "DnsRecords": [
                {
                    "Type": "A",
                    "TTL": 60
                }
            ]
        },
        "Type": "DNS_HTTP",
        "CreateDate": "2025-08-18T13:45:31.023000-05:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
        "CreatedByAccount": "123456789012"
    }
}

Untuk informasi selengkapnya, lihat ruang AWS nama Shared Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakandelete-namespace.

AWS CLI

Contoh 1: Untuk menghapus namespace

delete-namespaceContoh berikut menghapus namespace.

aws servicediscovery delete-namespace \
    --id ns-abcd1234xmpl5678

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation. Untuk informasi selengkapnya, lihat get-operation.

Untuk informasi selengkapnya, lihat Mengh AWS apus namespace Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk menghapus namespace menggunakan namespace ARN

delete-namespaceContoh berikut menghapus namespace menggunakan ARN-nya.

aws servicediscovery delete-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk informasi selengkapnya, lihat Mengh AWS apus namespace Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakandelete-service-attributes.

AWS CLI

Contoh 1: Untuk menghapus atribut layanan

delete-service-attributesContoh berikut menghapus atribut layanan dengan kunci Port yang terkait dengan layanan yang ditentukan.

aws servicediscovery delete-service-attributes \
    --service-id srv-abcd1234xmpl5678 \
    --attributes Port

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Layanan AWS Cloud Map di Panduan Pengembang Peta Awan. AWS

Contoh 2: Untuk menghapus atribut layanan menggunakan ARN

delete-service-attributesContoh berikut menghapus atribut layanan menggunakan layanan ARN. Menentukan ARN diperlukan untuk menghapus atribut yang terkait dengan layanan yang dibuat di ruang nama yang dibagikan dengan akun Anda.

aws servicediscovery delete-service-attributes \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
    --attributes Port

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat layanan AWS Cloud Map dan ruang AWS nama Shared Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakandelete-service.

AWS CLI

Contoh 1: Untuk menghapus layanan

delete-serviceContoh berikut menghapus layanan.

aws servicediscovery delete-service \
    --id srv-abcd1234xmpl5678

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengh AWS apus layanan Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk menghapus layanan menggunakan ARN

delete-serviceContoh berikut menghapus layanan menggunakan ARN-nya.

aws servicediscovery delete-service \
    --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengh AWS apus layanan Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakanderegister-instance.

AWS CLI

Contoh 1: Untuk membatalkan pendaftaran instance layanan

deregister-instanceContoh berikut membatalkan pendaftaran instance layanan.

aws servicediscovery deregister-instance \
    --service-id srv-p5zdwlg5uvvzjita \
    --instance-id myservice-53

Output:

{
    "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation. Untuk informasi selengkapnya, lihat get-operation.

Untuk informasi selengkapnya, lihat Menghapus pendaftaran instans Layanan di Panduan Pengembang AWS Peta Cloud.

Contoh 2: Untuk membatalkan pendaftaran instance layanan menggunakan layanan ARN untuk ruang nama bersama

deregister-instanceContoh berikut membatalkan pendaftaran instance layanan menggunakan ARN layanan alih-alih ID layanan. Menentukan ARN diperlukan saat membatalkan pendaftaran instans dari layanan yang dibuat di ruang nama yang dibagikan dengan akun Anda.

aws servicediscovery deregister-instance \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01

Output:

{
    "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}

Untuk informasi selengkapnya, lihat ruang AWS nama Shared Cloud Map dan Deregistrasi instance layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakandiscover-instances-revision.

AWS CLI

Contoh 1: Untuk menemukan revisi suatu instance

discover-instances-revisionContoh berikut menemukan peningkatan revisi instance.

aws servicediscovery discover-instances-revision \
    --namespace-name example.com \
    --service-name myservice

Output:

{
    "InstancesRevision": 123456
}

Untuk informasi selengkapnya, lihat contoh layanan AWS Cloud Map di Panduan Pengembang Peta AWS Cloud.

Contoh 2: Untuk menemukan revisi instance dari akun pemilik tertentu

discover-instances-revisionContoh berikut menemukan revisi instance dari akun pemilik tertentu. Parameter owner-account diperlukan untuk instance di ruang nama yang dibagikan dengan akun Anda.

aws servicediscovery discover-instances-revision \
    --namespace-name shared-namespace \
    --service-name shared-service \
    --owner-account 123456789111

Output:

{
    "InstancesRevision": 1234567890
}

Untuk informasi selengkapnya, lihat AWS ruang nama Shared Cloud Map dan instance layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakandiscover-instances.

AWS CLI

Contoh 1: Untuk menemukan instans terdaftar

discover-instancesContoh berikut menemukan instance terdaftar.

aws servicediscovery discover-instances \
    --namespace-name example.com \
    --service-name myservice \
    --max-results 10 \
    --health-status ALL

Output:

{
    "Instances": [
        {
            "InstanceId": "myservice-53",
            "NamespaceName": "example.com",
            "ServiceName": "myservice",
            "HealthStatus": "UNKNOWN",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "172.2.1.3",
                "AWS_INSTANCE_PORT": "808"
            }
        }
    ],
    "InstancesRevision": 85648075627387284
}

Untuk informasi selengkapnya, lihat contoh layanan AWS Cloud Map di Panduan Pengembang Peta AWS Cloud.

Contoh 2: Untuk menemukan instance dari akun pemilik tertentu

discover-instancesContoh berikut menemukan instance terdaftar dari akun pemilik tertentu. Parameter ini diperlukan untuk menemukan instance di ruang nama yang dibagikan dengan akun Anda.

aws servicediscovery discover-instances \
    --namespace-name shared-namespace \
    --service-name shared-service \
    --owner-account 123456789111

Output:

{
    "Instances": [
        {
            "InstanceId": "shared-instance-1234",
            "NamespaceName": "shared-namespace",
            "ServiceName": "shared-service",
            "HealthStatus": "HEALTHY",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "203.0.113.75",
                "AWS_INSTANCE_PORT": "80"
            }
        }
    ],
    "InstancesRevision": 1234567890
}

Untuk informasi selengkapnya, lihat AWS ruang nama Shared Cloud Map dan instance layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakanget-instance.

AWS CLI

Contoh 1: Untuk mendapatkan detail sebuah instance

get-instanceContoh berikut mendapatkan atribut layanan.

aws servicediscovery get-instance \
    --service-id srv-e4anhexample0004
    --instance-id i-abcd1234

Output:

{
    "ResourceOwner": "123456789012",
    "Instance": {
        "Id": "arn:aws:servicediscovery:us-west-2:111122223333;:service/srv-e4anhexample0004",
        "Attributes": {
            "AWS_INSTANCE_IPV4": "192.0.2.44",
            "AWS_INSTANCE_PORT": "80",
            "color": "green",
            "region": "us-west-2",
            "stage": "beta"
        },
        "CreatedByAccount": "123456789012"
    }
}

Untuk informasi selengkapnya, lihat contoh layanan AWS Cloud Map di Panduan Pengembang Peta AWS Cloud.

Contoh 2: Untuk mendapatkan detail instance menggunakan layanan ARN untuk ruang nama bersama

get-instanceContoh berikut mendapatkan atribut instance menggunakan layanan ARN alih-alih ID layanan. Menentukan ARN diperlukan saat mendapatkan rincian instance yang terkait dengan ruang nama yang dibagikan dengan akun Anda. Instans yang dikembalikan dalam contoh ini didaftarkan oleh akun 123456789111 di namespace yang dimiliki oleh akun123456789012.

aws servicediscovery get-instance \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01

Output:

{
    "ResourceOwner": "123456789012",
    "Instance": {
        "Id": "web-server-01",
        "Attributes": {
            "AWS_INSTANCE_IPV4": "203.0.113.15",
            "AWS_INSTANCE_PORT": "80"
        },
        "CreatedByAccount": "123456789111"
    }
}

Untuk informasi selengkapnya tentang berbagi namespace lintas akun, lihat ruang nama Shar AWS ed Cloud Map di Panduan Pengembang AWS Cloud Map.

  • Untuk detail API, lihat GetInstance di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-instances-health-status.

AWS CLI

Contoh 1: Untuk mendapatkan status kesehatan instans yang terkait dengan layanan

get-instances-health-statusContoh berikut mendapatkan status kesehatan instans yang terkait dengan layanan yang ditentukan.

aws servicediscovery get-instances-health-status \
    --service-id srv-e4anhexample0004

Output:

{
    "Status": {
        "i-abcd1234": "HEALTHY",
        "i-abcd1235": "UNHEALTHY"
    }
}

Untuk informasi selengkapnya, lihat contoh layanan AWS Cloud Map di Panduan Pengembang Peta AWS Cloud.

Contoh 2: Untuk mendapatkan status kesehatan instans menggunakan layanan ARN untuk ruang nama bersama

get-instances-health-statusContoh berikut mendapatkan status kesehatan instans menggunakan ARN layanan alih-alih ID layanan. Menentukan ARN diperlukan saat mendapatkan status kesehatan untuk instans yang terkait dengan ruang nama yang dibagikan dengan akun pemohon.

aws servicediscovery get-instances-health-status \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita

Output:

{
    "Status": {
        "web-server-01": "HEALTHY",
        "web-server-02": "UNHEALTHY"
    }
}

Untuk informasi selengkapnya, lihat Instans layanan AWS Cloud Map dan ruang AWS nama Shared Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakanget-namespace.

AWS CLI

Contoh 1: Untuk mendapatkan detail dari namespace

get-namespaceContoh berikut mengambil informasi tentang namespace yang ditentukan.

aws servicediscovery get-namespace \
    --id ns-abcd1234xmpl5678

Output:

{
    "Namespace": {
        "Id": "ns-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "example-http.com",
        "Type": "HTTP",
        "Description": "Example.com AWS Cloud Map HTTP Namespace",
        "Properties": {
            "DnsProperties": {},
            "HttpProperties": {
                "HttpName": "example-http.com"
            }
        },
        "CreateDate": "2024-02-23T13:35:21.874000-06:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678"
    }
}

Untuk informasi selengkapnya, lihat AWS ruang nama Cloud Map di Panduan Pengembang AWS Peta Awan.

Contoh 2: Untuk mendapatkan detail namespace menggunakan ARN

get-namespaceContoh berikut mengambil informasi tentang namespace yang ditentukan menggunakan ARN-nya. Menentukan ARN diperlukan untuk mengambil rincian namespace yang dibagikan dengan akun Anda.

aws servicediscovery get-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678

Output:

{
    "Namespace": {
        "Id": "ns-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "example-http.com",
        "Type": "HTTP",
        "Description": "Example.com AWS Cloud Map HTTP Namespace",
        "Properties": {
            "DnsProperties": {},
            "HttpProperties": {
                "HttpName": "example-http.com"
            }
        },
        "CreateDate": "2024-02-23T13:35:21.874000-06:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678"
    }
}

Untuk informasi selengkapnya, lihat ruang AWS nama Shared Cloud Map di Panduan Pengembang AWS Cloud Map.

  • Untuk detail API, lihat GetNamespace di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-operation.

AWS CLI

Contoh 1: Untuk mendapatkan hasil operasi

get-operationContoh berikut mendapatkan hasil dari operasi pembuatan namespace.

aws servicediscovery get-operation \
    --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234

Output:

{
    "Operation": {
        "Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234",
        "Type": "CREATE_NAMESPACE",
        "Status": "SUCCESS",
        "CreateDate": "2025-01-13T13:35:21.874000-06:00",
        "UpdateDate": "2025-01-13T13:36:02.469000-06:00",
        "Targets": {
            "NAMESPACE": "ns-abcd1234xmpl5678"
        }
    }
}

Untuk informasi selengkapnya, lihat Membuat namespace AWS Cloud Map untuk mengelompokkan layanan aplikasi di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk mendapatkan operasi dari akun pemilik tertentu

get-operationContoh berikut mendapatkan hasil operasi yang terkait dengan akun pemilik namespace tertentu. Parameter ini diperlukan untuk mendapatkan hasil operasi yang terkait dengan ruang nama yang dibagikan dengan akun Anda.

aws servicediscovery get-operation \
    --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234 \
    --owner-account 123456789111

Output:

{
    "Operation": {
        "Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234",
        "OwnerAccount": "123456789111",
        "Type": "CREATE_NAMESPACE",
        "Status": "SUCCESS",
        "CreateDate": "2025-01-13T13:35:21.874000-06:00",
        "UpdateDate": "2025-01-13T13:36:02.469000-06:00",
        "Targets": {
            "NAMESPACE": "ns-abcd1234xmpl5678"
        }
    }
}

Untuk informasi selengkapnya, lihat ruang AWS nama Shared Cloud Map di Panduan Pengembang AWS Cloud Map.

  • Untuk detail API, lihat GetOperation di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-service-attributes.

AWS CLI

Contoh 1: Untuk mendapatkan atribut layanan

get-service-attributesContoh berikut mendapatkan atribut layanan.

aws servicediscovery get-service-attributes \
    --service-id srv-abcd1234xmpl5678

Output:

{
    "ServiceAttributes": {
        "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Attributes": {
            "Port": "80"
        }
    }
}

Untuk informasi selengkapnya, lihat Layanan AWS Cloud Map di Panduan Pengembang Peta Awan. AWS

Contoh 2: Untuk mendapatkan atribut layanan menggunakan ARN

get-service-attributesContoh berikut mendapatkan atribut layanan menggunakan ARN-nya. Menentukan ARN diperlukan untuk mendapatkan atribut layanan yang dibuat dalam namespace yang dibagikan dengan akun Anda.

aws servicediscovery get-service-attributes \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678

Output:

{
    "ServiceAttributes": {
        "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Attributes": {
            "Port": "80"
        }
    }
}

Untuk informasi selengkapnya, lihat layanan AWS Cloud Map dan ruang AWS nama Shared Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakanget-service.

AWS CLI

Contoh 1: Untuk mendapatkan pengaturan layanan

get-serviceContoh berikut mendapatkan pengaturan layanan tertentu.

aws servicediscovery get-service \
    --id srv-abcd1234xmpl5678

Output:

{
    "Service": {
        "Id": "srv-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "test-service",
        "NamespaceId": "ns-abcd1234xmpl5678",
        "DnsConfig": {},
        "Type": "HTTP",
        "CreateDate": "2025-08-18T13:53:02.775000-05:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
        "CreatedByAccount": "123456789012"
    }
}

Untuk informasi selengkapnya, lihat Layanan AWS Cloud Map di Panduan Pengembang Peta Awan. AWS

Contoh 2: Untuk mendapatkan pengaturan layanan menggunakan ARN

get-serviceContoh berikut mendapatkan pengaturan layanan tertentu menggunakan ARN-nya. Menentukan ARN diperlukan saat mengambil informasi tentang layanan yang dibuat dalam namespace yang dibagikan dengan akun Anda. Akun pemanggil membuat 123456789111 layanan di namespace yang dibagikan oleh akun. 123456789012

aws servicediscovery get-service \
    --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678

Output:

{
    "Service": {
        "Id": "srv-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "test-service",
        "NamespaceId": "ns-abcd1234xmpl5678",
        "DnsConfig": {},
        "Type": "HTTP",
        "CreateDate": "2025-08-18T13:53:02.775000-05:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
        "CreatedByAccount": "123456789111"
    }
}

Untuk informasi selengkapnya, lihat Membuat layanan AWS Cloud Map untuk komponen aplikasi dan ruang nama Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

  • Untuk detail API, lihat GetService di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-instances.

AWS CLI

Contoh 1: Untuk membuat daftar instance layanan

list-instancesContoh berikut mencantumkan instance layanan.

aws servicediscovery list-instances \
    --service-id srv-qzpwvt2tfqcegapy

Output:

{
    "Instances": [
        {
            "Id": "i-06bdabbae60f65a4e",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "172.2.1.3",
                "AWS_INSTANCE_PORT": "808"
            },
            "CreatedByAccount": "123456789012"
        }
    ],
    "ResourceOwner": "123456789012"
}

Untuk informasi selengkapnya, lihat M AWS endaftarkan instance layanan AWS Cloud Map di Panduan Pengembang Cloud Map.

Contoh 2: Untuk membuat daftar instance layanan menggunakan layanan ARN

list-instancesContoh berikut mencantumkan instance layanan menggunakan ARN layanan alih-alih ID layanan. Menentukan ARN diperlukan saat mencantumkan instance yang terkait dengan ruang nama yang dibagikan dengan akun Anda.

aws servicediscovery list-instances \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita

Output:

{
    "ResourceOwner": "123456789012",
    "Instances": [
        {
            "Id": "web-server-01",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "203.0.113.15",
                "AWS_INSTANCE_PORT": "80"
            },
            "CreatedByAccount": "123456789012"
        },
        {
            "Id": "web-server-02",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "203.0.113.16",
                "AWS_INSTANCE_PORT": "80"
            },
            "CreatedByAccount": "123456789012"
        }
    ]
}

Untuk informasi selengkapnya tentang berbagi namespace lintas akun, lihat ruang nama Shar AWS ed Cloud Map dan Daftar instans layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakanlist-namespaces.

AWS CLI

Contoh 1: Untuk mencantumkan ruang nama

list-namespacesContoh berikut mencantumkan ruang nama.

aws servicediscovery list-namespaces

Output:

{
    "Namespaces": [
        {
            "Id": "ns-abcd1234xmpl5678",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
            "ResourceOwner": "123456789012",
            "Name": "local",
            "Type": "DNS_PRIVATE",
            "Properties": {
                "DnsProperties": {
                    "HostedZoneId": "Z06752353VBUDTC32S84S",
                    "SOA": {}
                },
                "HttpProperties": {
                    "HttpName": "local"
                 }
            },
            "CreateDate": "2023-07-17T13:37:27.872000-05:00"
        },
        {
            "Id": "ns-abcd1234xmpl9012",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl9012",
            "ResourceOwner": "123456789012",
            "Name": "My-second-namespace",
            "Type": "HTTP",
            "Description": "My second namespace",
            "Properties": {
                "DnsProperties": {
                    "SOA": {}
                },
                "HttpProperties": {
                    "HttpName": "My-second-namespace"
                }
            },
            "CreateDate": "2023-11-14T10:35:47.840000-06:00"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mend AWS aftarkan ruang nama Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk mencantumkan ruang nama yang dibagikan oleh akun lain

list-namespacesContoh berikut mencantumkan ruang nama yang dibagikan dengan akun pemanggil oleh AWS akun lain menggunakan filter. RESOURCE_OWNER

aws servicediscovery list-namespaces \
    --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ

Output:

{
    "Namespaces": [
        {
            "Id": "ns-abcd1234xmpl5678",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789111:namespace/ns-abcd1234xmpl5678",
            "ResourceOwner": "123456789111",
            "Name": "shared-namespace",
            "Type": "HTTP",
            "Description": "Namespace shared from another account",
            "Properties": {
                "DnsProperties": {
                    "SOA": {}
                },
                "HttpProperties": {
                    "HttpName": "shared-namespace"
                }
            },
            "CreateDate": "2025-01-13T13:35:21.874000-06:00"
        }
    ]
}

Untuk informasi selengkapnya, lihat ruang AWS nama Shared Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakanlist-operations.

AWS CLI

Untuk membuat daftar operasi yang memenuhi kriteria yang ditentukan

list-operationsContoh berikut mencantumkan operasi yang memiliki status PENDING atauSUCCESS.

aws servicediscovery list-operations \
    --service-id srv-e4anhexample0004 \
    --filters Name=STATUS,Condition=IN,Values=PENDING,SUCCESS

Output:

{
    "Operations": [
        {
            "Id": "76yy8ovhpdz0plmjzbsnqgnrqvpv2qdt-kexample",
            "Status": "SUCCESS"
        },
        {
            "Id": "prysnyzpji3u2ciy45nke83x2zanl7yk-dexample",
            "Status": "SUCCESS"
        },
        {
            "Id": "ko4ekftir7kzlbechsh7xvcdgcpk66gh-7example",
            "Status": "PENDING"
        }
    ]
}

Untuk informasi selengkapnya, lihat Apa itu AWS Cloud Map? dalam Panduan Pengembang Peta Awan. AWS

Contoh kode berikut menunjukkan cara menggunakanlist-services.

AWS CLI

Contoh 1: Untuk daftar layanan

list-servicesContoh berikut mencantumkan layanan.

aws servicediscovery list-services

Output:

{
    "Services": [
        {
            "Id": "srv-p5zdwlg5uvvzjita",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita",
            "Name": "myservice",
            "DnsConfig": {
                "RoutingPolicy": "MULTIVALUE",
                "DnsRecords": [
                    {
                        "Type": "A",
                        "TTL": 60
                    }
                ]
            },
            "CreateDate": 1587081768.334
        }
    ]
}

Untuk informasi selengkapnya, lihat M AWS endaftarkan layanan Cloud Map di namespace di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk membuat daftar layanan yang dibuat di ruang nama bersama

list-servicesContoh berikut mencantumkan layanan yang dibuat di ruang nama yang dibagikan dengan akun pemanggil 123456789012 oleh AWS akun lain menggunakan filter. RESOURCE_OWNER

aws servicediscovery list-services \
    --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ

Output:

{
    "Services": [
        {
            "Id": "srv-abcd1234xmpl5678",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789111:service/srv-abcd1234xmpl5678",
            "ResourceOwner": "123456789111",
            "Name": "shared-service",
            "NamespaceId": "ns-abcd1234xmpl5678",
            "Type": "HTTP",
            "Description": "Service in shared namespace",
            "DnsConfig": {},
            "CreateDate": "2025-01-13T13:35:21.874000-06:00",
            "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
            "CreatedByAccount": "123456789012"
        }
    ]
}

Untuk informasi selengkapnya, lihat ruang nama Shared AWS Cloud Map dan Daftar layanan AWS Cloud Map dalam namespace di Panduan Pengembang AWS Cloud Map.

  • Untuk detail API, lihat ListServices di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk mencantumkan tag yang terkait dengan sumber daya yang ditentukan

list-tags-for-resourceContoh berikut mencantumkan tag untuk sumber daya yang ditentukan.

aws servicediscovery list-tags-for-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004

Output:

{
    "Tags": [
        {
            "Key": "Project",
            "Value": "Zeta"
        },
        {
            "Key": "Department",
            "Value": "Engineering"
        }
    ]
}

Untuk informasi selengkapnya, lihat Menandai sumber daya AWS Cloud Map Anda di Panduan Pengembang Peta AWS Cloud.

Contoh kode berikut menunjukkan cara menggunakanregister-instance.

AWS CLI

Contoh 1: Untuk mendaftarkan instance layanan menggunakan ID layanan

register-instanceContoh berikut mendaftarkan instance layanan.

aws servicediscovery register-instance \
    --service-id srv-p5zdwlg5uvvzjita \
    --instance-id myservice-53 \
    --attributes=AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808

Output:

{
    "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation. Untuk informasi selengkapnya, lihat get-operation.

Untuk informasi selengkapnya tentang mendaftarkan instance, lihat Mendaftarkan sumber daya sebagai instance layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk mendaftarkan instance layanan menggunakan layanan ARN

register-instanceContoh berikut mendaftarkan instance layanan menggunakan layanan ARN. Menentukan ARN diperlukan saat mendaftarkan instance di layanan yang dibagikan dengan akun Anda.

aws servicediscovery register-instance \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01 \
    --attributes=AWS_INSTANCE_IPV4=203.0.113.15,AWS_INSTANCE_PORT=80

Output:

{
    "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}

Untuk informasi selengkapnya tentang berbagi namespace lintas akun, lihat ruang nama Shar AWS ed Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk mengaitkan tag dengan sumber daya yang ditentukan

tag-resourceContoh berikut mengaitkan Department tag dengan nilai Engineering dengan namespace yang ditentukan.

aws servicediscovery tag-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
    --tags Key=Department, Value=Engineering

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai sumber daya AWS Cloud Map Anda di Panduan Pengembang Peta AWS Cloud.

  • Untuk detail API, lihat TagResource di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari sumber daya yang ditentukan

untag-resourceContoh berikut menghapus Department tag dari namespace yang ditentukan.

aws servicediscovery untag-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
    --tag-keys Department

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai sumber daya AWS Cloud Map Anda di Panduan Pengembang Peta AWS Cloud.

Contoh kode berikut menunjukkan cara menggunakanupdate-http-namespace.

AWS CLI

Contoh 1: Untuk memperbarui namespace HTTP

update-http-namespaceContoh berikut memperbarui deskripsi namespace HTTP yang ditentukan.

aws servicediscovery update-http-namespace \
    --id ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation. Untuk informasi selengkapnya, lihat get-operation.

Untuk informasi selengkapnya, lihat AWS ruang nama Cloud Map di Panduan Pengembang AWS Peta Awan.

Contoh 2: Untuk memperbarui namespace HTTP menggunakan ARN

update-http-namespaceContoh berikut memperbarui namespace HTTP yang ditentukan menggunakan ARN-nya.

aws servicediscovery update-http-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk informasi selengkapnya, lihat AWS ruang nama Cloud Map di Panduan Pengembang AWS Peta Awan.

Contoh kode berikut menunjukkan cara menggunakanupdate-instance-custom-health-status.

AWS CLI

Contoh 1: Untuk memperbarui pemeriksaan kesehatan khusus

update-instance-custom-health-statusContoh berikut memperbarui status pemeriksaan kesehatan khusus untuk layanan tertentu dan contoh instance layanan keHEALTHY.

aws servicediscovery update-instance-custom-health-status \
    --service-id srv-e4anhexample0004 \
    --instance-id example \
    --status HEALTHY

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat konfigurasi pemeriksaan kesehatan layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk memperbarui pemeriksaan kesehatan khusus menggunakan layanan ARN

update-instance-custom-health-statusContoh berikut memperbarui status pemeriksaan kesehatan khusus menggunakan layanan ARN. ARN diperlukan saat memperbarui status kesehatan untuk instans yang terkait dengan ruang nama yang dibagikan dengan akun Anda.

aws servicediscovery update-instance-custom-health-status \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01 \
    --status HEALTHY

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat AWS konfigurasi pemeriksaan kesehatan layanan Cross-account AWS Cloud Map dan berbagi namespace Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakanupdate-private-dns-namespace.

AWS CLI

Contoh 1: Untuk memperbarui namespace DNS pribadi menggunakan ID

update-private-dns-namespaceContoh berikut memperbarui deskripsi namespace DNS pribadi menggunakan ID namespace.

aws servicediscovery update-private-dns-namespace \
    --id ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation.

Untuk informasi selengkapnya, lihat AWS ruang nama Cloud Map di Panduan Pengembang AWS Peta Awan.

Contoh 2: Untuk memperbarui namespace DNS pribadi menggunakan ARN

update-private-dns-namespaceContoh berikut memperbarui namespace DNS pribadi menggunakan ARN-nya.

aws servicediscovery update-private-dns-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk informasi selengkapnya, lihat AWS ruang nama Cloud Map di Panduan Pengembang AWS Peta Awan.

Contoh kode berikut menunjukkan cara menggunakanupdate-public-dns-namespace.

AWS CLI

Contoh 1: Untuk memperbarui namespace DNS publik menggunakan ID

update-public-dns-namespaceContoh berikut memperbarui deskripsi namespace DNS publik menggunakan ID-nya.

aws servicediscovery update-public-dns-namespace \
    --id ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation.

Untuk informasi selengkapnya, lihat AWS ruang nama Cloud Map di Panduan Pengembang AWS Peta Awan.

Contoh 2: Untuk memperbarui namespace DNS publik menggunakan ARN

update-public-dns-namespaceContoh berikut memperbarui namespace DNS publik menggunakan ARN-nya.

aws servicediscovery update-public-dns-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk informasi selengkapnya, lihat AWS ruang nama Cloud Map di Panduan Pengembang AWS Peta Awan.

Contoh kode berikut menunjukkan cara menggunakanupdate-service-attributes.

AWS CLI

Contoh 1: Untuk memperbarui layanan untuk menambahkan atribut

update-service-attributesContoh berikut memperbarui layanan yang ditentukan untuk menambahkan atribut layanan dengan kunci Port dan nilai80.

aws servicediscovery update-service-attributes \
    --service-id srv-abcd1234xmpl5678 \
    --attributes Port=80

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Layanan AWS Cloud Map di Panduan Pengembang Peta Awan. AWS

Contoh 2: Untuk memperbarui atribut layanan menggunakan ARN

update-service-attributesContoh berikut memperbarui layanan menggunakan ARN untuk menambahkan atribut layanan. Menentukan ARN diperlukan untuk menambahkan atribut ke layanan yang dibuat di ruang nama yang dibagikan dengan akun Anda.

aws servicediscovery update-service-attributes \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
    --attributes Port=80

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat layanan AWS Cloud Map dan ruang AWS nama Shared Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh kode berikut menunjukkan cara menggunakanupdate-service.

AWS CLI

Contoh 1: Untuk memperbarui layanan

update-serviceContoh berikut memperbarui layanan untuk memperbarui HealthCheckConfig pengaturan DnsConfig dan.

aws servicediscovery update-service \
    --id srv-abcd1234xmpl5678 \
    --service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk mengonfirmasi bahwa operasi berhasil, Anda dapat menjalankannyaget-operation.

Untuk informasi selengkapnya tentang memperbarui layanan, lihat Memperbarui layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk memperbarui layanan menggunakan ARN

update-serviceContoh berikut memperbarui layanan menggunakan ARN-nya. Menentukan ARN diperlukan untuk layanan yang dibuat di ruang nama yang dibagikan dengan akun Anda.

aws servicediscovery update-service \
    --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
    --service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Untuk informasi selengkapnya tentang memperbarui layanan, lihat Memperbarui layanan AWS Cloud Map dan ruang nama AWS Cloud Map Bersama di Panduan Pengembang AWS Peta Cloud.