Daftar Cloud Services

Operasi ini List Cloud Services mencantumkan layanan cloud yang tersedia di bawah langganan yang ditentukan.

Minta

Permintaan List Cloud Services dapat ditentukan sebagai berikut. Ganti <subscription-id> dengan ID Langganan Azure Anda.

Metode	URI Permintaan
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices`

Parameter URI

Tidak ada.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan.

Header Permintaan	Deskripsi
`x-ms-version`	Wajib diisi. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Header ini harus diatur ke `2009-10-01` atau lebih tinggi.
`x-ms-continuation-token`	Opsional. Menentukan token kelanjutan yang memungkinkan Anda mendapatkan sisa respons ketika ada lebih banyak layanan cloud untuk dicantumkan daripada yang dapat dikembalikan dalam waktu yang dialokasikan. Nilai token ini dikembalikan di header respons sebelumnya dan hanya akan dikembalikan jika layanan cloud tambahan perlu dicantumkan.

Isi Permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.

Kode Status

Operasi yang berhasil mengembalikan kode status 200 (OK).

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan.

Header Respons Deskripsi

x-ms-request-id Menentukan nilai yang secara unik mengidentifikasi permintaan yang dibuat terhadap layanan manajemen.

x-ms-continuation-token Menentukan token kelanjutan yang memungkinkan Anda mendapatkan sisa respons ketika ada lebih banyak layanan cloud untuk dicantumkan daripada yang dapat dikembalikan dalam waktu yang dialokasikan. Jika sejumlah besar layanan cloud ada dalam langganan, tidak semuanya dapat dicantumkan dalam satu respons. Anda dapat menggunakan token di header ini dalam permintaan operasi berikutnya hingga semua layanan cloud dikembalikan.

Header Respons	Deskripsi
`x-ms-request-id`	Menentukan nilai yang secara unik mengidentifikasi permintaan yang dibuat terhadap layanan manajemen.
`x-ms-continuation-token`	Menentukan token kelanjutan yang memungkinkan Anda mendapatkan sisa respons ketika ada lebih banyak layanan cloud untuk dicantumkan daripada yang dapat dikembalikan dalam waktu yang dialokasikan. Jika sejumlah besar layanan cloud ada dalam langganan, tidak semuanya dapat dicantumkan dalam satu respons. Anda dapat menggunakan token di header ini dalam permintaan operasi berikutnya hingga semua layanan cloud dikembalikan.

Isi Respons

Format isi respons adalah sebagai berikut:

  
<?xml version="1.0" encoding="utf-8"?>  
  <HostedServices xmlns=”http://schemas.microsoft.com/windowsazure”>  
    <HostedService>  
      <Url>address-of-cloud-service</Url>  
      <ServiceName>name-of-cloud-service</ServiceName>  
      <HostedServiceProperties>  
        <Description>description-of-cloud-service</Description>  
        <AffinityGroup>name-of-affinity-group</AffinityGroup>  
        <Location>location-of-cloud-service</Location>  
        <Label>label-of-cloud-service</Label>  
        <Status>status-of-cloud-service</Status>  
        <DateCreated>date-created</DateCreated>  
        <DateLastModified>date-modified</DateLastModified>  
        <ExtendedProperties>  
          <ExtendedProperty>  
            <Name>name-of-property-name</Name>  
            <Value>value-of-property</Value>  
          </ExtendedProperty>  
        </ExtendedProperties>  
        <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
      </HostedServiceProperties>  
      <DefaultWinRMCertificateThumbprint>certificate-thumbprint-for-winrm</DefaultWinRMCertificateThumbprint>  
      <ComputeCapabilities>  
        <VirtualMachineRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </VirtualMachineRoleSizes>  
        <WebWorkerRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </WebWorkerRoleSizes>  
      </ComputeCapabilities>  
    </HostedService>  
  </HostedServices>

Tabel berikut ini menjelaskan elemen isi respons.

Nama elemen	Deskripsi
Url	Menentukan URI permintaan yang digunakan untuk mendapatkan informasi tentang layanan awan.
ServiceName	Menentukan nama layanan awan. Nama ini adalah nama awalan DNS dan dapat digunakan untuk mengakses layanan. Misalnya, jika nama layanan adalah MyService, Anda dapat mengakses layanan dengan memanggil: http:// MyService.cloudapp.net
Deskripsi	Menentukan deskripsi layanan awan. Elemen `Description` ini hanya tersedia menggunakan versi 2012-03-01 atau lebih tinggi.
AffinityGroup	Menentukan grup afinitas tempat layanan cloud ini dikaitkan, jika ada. Jika layanan dikaitkan dengan grup afinitas, `Location` elemen tidak dikembalikan. Elemen `AffinityGroup` ini hanya tersedia menggunakan versi 2012-03-01 atau lebih tinggi.
Lokasi	Menentukan lokasi geografis layanan cloud di Azure, jika layanan tidak terkait dengan grup afinitas. Jika lokasi ditentukan, `AffinityGroup` elemen tidak dikembalikan. Elemen `Location` ini hanya tersedia menggunakan versi 2012-03-01 atau lebih tinggi.
Label	Menentukan pengidentifikasi layanan awan yang dikodekan base-64. Pengidentifikasi ini dapat digunakan untuk tujuan pelacakan Anda. Elemen `Label` ini hanya tersedia menggunakan versi 2012-03-01 atau lebih tinggi.
Status	Menentukan status layanan awan. Potensi nilai: - `Creating` - `Created` - `Deleting` - `Deleted` - `Changing` - `ResolvingDns` Elemen `Status` ini hanya tersedia menggunakan versi 2012-03-01 atau lebih tinggi.
TanggalBuat	Menentukan tanggal pembuatan layanan awan, dalam [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z format. Tanggal 2011-05-11T16:15:26Z adalah contoh yang dapat dikembalikan oleh `DateCreated` elemen atau `DateLastModified` . Elemen `DateCreated` ini hanya tersedia menggunakan versi 2012-03-01 atau lebih tinggi.
DateLastModified	Menentukan tanggal layanan awan terakhir diperbarui, dalam [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z format. Tanggal 2011-05-11T16:15:26Z adalah contoh yang dapat dikembalikan oleh `DateCreated` elemen atau `DateLastModified` Elemen `DateLastModified` ini hanya tersedia menggunakan versi 2012-03-01 atau lebih tinggi.
Nama	Menentukan nama properti layanan awan yang diperluas. Setiap properti yang diperluas harus memiliki nama dan nilai yang ditentukan. Anda dapat menentukan maksimum 50 properti yang diperluas. Elemen `Name` ini hanya tersedia menggunakan versi 2012-03-01 atau lebih tinggi.
Nilai	Mewakili nilai properti layanan cloud yang diperluas. Panjang nilai properti yang diperluas bisa hingga 255 karakter. Elemen `Value` ini hanya tersedia menggunakan versi 2012-03-01 atau lebih tinggi.
ReverseDnsFqdn	Pilihan. Menentukan alamat DNS yang diselesaikan alamat IP layanan awan saat dikueri menggunakan kueri DNS terbalik. Elemen `ReverseDnsFqdn` ini hanya tersedia menggunakan versi 2014-06-01 atau lebih tinggi.
DefaultWinRMCertificateThumbprint	Menentukan sertifikat default untuk koneksi aman dengan WinRM. Jika thumbprint sertifikat tidak ditentukan untuk WinRM saat Komputer Virtual disebarkan di layanan cloud, sertifikat dibuat secara otomatis dan thumbprint terdaftar sebagai nilai elemen ini. Untuk informasi selengkapnya tentang menentukan WinRM, lihat Membuat Penyebaran Komputer Virtual atau Menambahkan Peran.
ComputeCapabilities	Menentukan ukuran peran yang tersedia untuk penyebaran di layanan cloud. Ukuran peran yang tersedia ditentukan oleh sumber daya yang didukung oleh layanan cloud. Misalnya, penyebaran peran web dan peran pekerja mungkin memiliki ukuran yang berbeda yang tersedia daripada penyebaran Virtual Machines. Elemen `ComputeCapabilities` ini hanya tersedia menggunakan versi 2014-05-01 atau lebih tinggi.

ComputeCapabilities

Menentukan ukuran peran yang tersedia untuk penyebaran di layanan cloud.

Nama elemen	Deskripsi
VirtualMachineRoleSizes	Berisi kumpulan elemen RoleSize.
WebWorkerRoleSizes	Berisi kumpulan elemen RoleSize.
RoleSize	Menentukan ukuran peran yang tersedia untuk jenis penyebaran.

Keterangan

x-ms-version Jika lebih lama dari 2012-03-01, layanan cloud yang berisi penyebaran komputer virtual tidak akan dikembalikan.

Anda dapat melihat layanan cloud yang ada di langganan Anda dengan melihat di bagian Cloud Services Portal Manajemen. Anda juga bisa mendapatkan daftar layanan cloud dengan menggunakan cmdlet Get-AzureService .

Last updated on 2023-07-19