AWS Cloud Map contoh menggunakan 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.

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 Cloud Map.

Untuk membuat namespace DNS publik

create-public-dns-namespaceContoh berikut membuat example.com namespace 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 1: Untuk membuat layanan menggunakan ID namespace

create-serviceContoh berikut menciptakan 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 bukan 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 nama Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 Menghapus namespace AWS 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 Menghapus namespace AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 1: Untuk menghapus atribut layanan

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

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 AWS Cloud Map.

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 nama Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 Menghapus layanan AWS 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 Menghapus layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 membatalkan pendaftaran instance layanan di Panduan Pengembang AWS Cloud Map.

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

deregister-instanceContoh berikut membatalkan pendaftaran instance layanan menggunakan layanan ARN bukan ID layanan. Menentukan ARN diperlukan saat membatalkan pendaftaran instance 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 nama Shared AWS Cloud Map dan Membatalkan pendaftaran instance layanan Cloud AWS Map di Panduan Pengembang Cloud AWS Map.

Contoh 1: Untuk menemukan revisi sebuah instance

discover-instances-revisionContoh berikut menemukan revisi yang meningkat dari sebuah instance.

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

Output:

{
    "InstancesRevision": 123456
}

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

Contoh 2: Untuk menemukan revisi instance dari akun pemilik tertentu

discover-instances-revisionContoh berikut menemukan revisi instance dari akun pemilik tertentu. Parameter akun pemilik 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 Ruang nama AWS Cloud Map Bersama dan instance layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 1: Untuk menemukan instans terdaftar

discover-instancesContoh berikut menemukan contoh 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 instance layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 Ruang nama AWS Cloud Map Bersama dan instance layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 1: Untuk mendapatkan detail dari 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 instance layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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

get-instanceContoh berikut mendapatkan atribut dari sebuah instance menggunakan layanan ARN bukan ID layanan. Menentukan ARN diperlukan saat mendapatkan detail instance yang terkait dengan ruang nama yang dibagikan dengan akun Anda. Instance yang dikembalikan dalam contoh ini didaftarkan oleh akun 123456789111 di namespace yang dimiliki oleh akun. 123456789012

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 AWS Cloud Map Bersama di Panduan Pengembang Cloud Map AWS .

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

get-instances-health-statusContoh berikut mendapatkan status kesehatan instance 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 instance layanan AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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

get-instances-health-statusContoh berikut mendapatkan status kesehatan instance menggunakan layanan ARN bukan ID layanan. Menentukan ARN diperlukan saat mendapatkan status kesehatan untuk instance 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 instance layanan AWS Cloud Map dan ruang nama Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 1: Untuk mendapatkan detail 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 ruang nama AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk mendapatkan detail namespace menggunakan ARN

get-namespaceContoh berikut mengambil informasi tentang namespace yang ditentukan menggunakan ARN nya. Menentukan ARN diperlukan untuk memulihkan detail 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 nama Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 nama Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 AWS Cloud Map.

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 di 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 nama Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 AWS Cloud Map.

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 di namespace yang dibagikan dengan akun Anda. Akun penelepon 123456789111 membuat 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.

Contoh 1: Untuk 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 AWS Mencantumkan instance layanan Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk daftar instance layanan menggunakan layanan ARN

list-instancesContoh berikut mencantumkan instance layanan menggunakan ARN layanan, bukan 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 AWS Cloud Map Bersama dan Mencantumkan instance layanan AWS Cloud Map di Panduan Pengembang Cloud AWS Map.

Contoh 1: Untuk daftar 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 Mencantumkan ruang nama AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk daftar 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 nama Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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? di Panduan Pengembang AWS Cloud Map.

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 AWS Mencantumkan layanan Cloud Map di namespace di Panduan Pengembang AWS Cloud Map.

Contoh 2: Untuk 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 mencantumkan layanan AWS Cloud Map di namespace di Panduan Pengembang AWS Cloud Map.

Untuk daftar 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 resource AWS Cloud Map Anda di Panduan Pengembang AWS Cloud Map.

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 AWS Cloud Map Bersama di Panduan Pengembang Cloud Map AWS .

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 resource AWS Cloud Map Anda di Panduan Pengembang AWS Cloud Map.

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 \
    --tags Key=Department, Value=Engineering

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai resource AWS Cloud Map Anda di Panduan Pengembang AWS Cloud Map.

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 ruang nama AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 ruang nama AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 1: Untuk memperbarui pemeriksaan kesehatan khusus

update-instance-custom-health-statusContoh berikut memperbarui status pemeriksaan kesehatan kustom untuk layanan tertentu dan contoh contoh 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 kustom menggunakan layanan ARN. ARN diperlukan saat memperbarui status kesehatan untuk instance 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 konfigurasi pemeriksaan kesehatan layanan AWS Cloud Map dan berbagi namespace AWS Cloud Map Lintas akun di Panduan Pengembang AWS Cloud Map.

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 ruang nama AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 ruang nama AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 ruang nama AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

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 ruang nama AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 1: Untuk memperbarui layanan untuk menambahkan atribut

update-service-attributesContoh berikut memperbarui layanan tertentu 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 AWS Cloud Map.

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 nama Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.

Contoh 1: Untuk memperbarui layanan

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

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 Shared AWS Cloud Map di Panduan Pengembang AWS Cloud Map.