Fleets - List By Resource Group

Mencantumkan armada dalam grup langganan dan sumber daya yang ditentukan.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets?api-version=2025-03-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama ini tidak peka huruf besar/kecil.

subscriptionId
path True

string (uuid)

ID langganan target. Nilainya harus UUID.

api-version
query True

string

minLength: 1

Versi API yang digunakan untuk operasi ini.

Respons

Nama Jenis Deskripsi
200 OK

FleetListResult

Operasi Azure berhasil diselesaikan.

Other Status Codes

ErrorResponse

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Lists the Fleet resources in a resource group.
Lists the Fleet resources in a resource group. - generated by [MaximumSet] rule

Lists the Fleet resources in a resource group.

Permintaan sampel

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets?api-version=2025-03-01

Respon sampel

{
  "value": [
    {
      "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1",
      "name": "fleet1",
      "type": "Microsoft.ContainerService/fleets",
      "systemData": {
        "createdBy": "someUser",
        "createdByType": "User",
        "createdAt": "2022-03-23T05:40:40.657Z",
        "lastModifiedBy": "someOtherUser",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2022-03-23T05:40:40.657Z"
      },
      "tags": {
        "tier": "production",
        "archv2": ""
      },
      "location": "East US",
      "eTag": "23ujdflewrj3=",
      "properties": {
        "hubProfile": {
          "dnsPrefix": "dnsprefix1",
          "fqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io",
          "portalFqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io",
          "kubernetesVersion": "1.22.4",
          "agentProfile": {
            "vmSize": "Standard_DS1"
          }
        },
        "provisioningState": "Succeeded",
        "status": {
          "lastOperationId": "operation-12345",
          "lastOperationError": {
            "code": "None",
            "message": "No error"
          }
        }
      }
    }
  ],
  "nextLink": null
}

Lists the Fleet resources in a resource group. - generated by [MaximumSet] rule

Permintaan sampel

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgfleets/providers/Microsoft.ContainerService/fleets?api-version=2025-03-01

Respon sampel

{
  "value": [
    {
      "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet1",
      "name": "fleet-1",
      "type": "Microsoft.ContainerService/fleets",
      "systemData": {
        "createdBy": "someUser",
        "createdByType": "User",
        "createdAt": "2022-03-23T05:40:40.657Z",
        "lastModifiedBy": "someOtherUser",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2022-03-23T05:40:40.657Z"
      },
      "tags": {},
      "location": "East US",
      "eTag": "23ujdflewrj3=",
      "properties": {
        "hubProfile": {
          "dnsPrefix": "dnsprefix1",
          "fqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io",
          "portalFqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io",
          "kubernetesVersion": "1.22.4",
          "agentProfile": {
            "vmSize": "Standard_DS1",
            "subnetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgfleets/providers/Microsoft.Network/virtualNetwork/myvnet/subnets/mysubnet1"
          },
          "apiServerAccessProfile": {
            "enablePrivateCluster": true,
            "enableVnetIntegration": true,
            "subnetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgfleets/providers/Microsoft.Network/virtualNetwork/myvnet/subnets/mysubnet1"
          }
        },
        "provisioningState": "Succeeded"
      },
      "identity": {
        "principalId": "00000000-0000-0000-0000-000000000000",
        "tenantId": "00000000-0000-0000-0000-000000000000",
        "type": "None",
        "userAssignedIdentities": {
          "key126": {
            "principalId": "00000000-0000-0000-0000-000000000000",
            "clientId": "00000000-0000-0000-0000-000000000000"
          }
        }
      }
    }
  ],
  "nextLink": "https://microsoft.com/adyccxeh"
}

Definisi

Nama Deskripsi
AgentProfile

Profil agen untuk hub Armada.

APIServerAccessProfile

Akses profil untuk server API hub Armada.

createdByType

Jenis identitas yang membuat sumber daya.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Tanggapan kesalahan

Fleet

Sumber daya Armada.

FleetHubProfile

FleetHubProfile mengonfigurasi hub armada.

FleetListResult

Respons operasi daftar Armada.

FleetProvisioningState

Status provisi operasi terakhir yang diterima.

FleetStatus

Informasi status untuk armada.

ManagedServiceIdentity

Identitas layanan terkelola (identitas yang ditetapkan sistem dan/atau pengguna)

ManagedServiceIdentityType

Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

UserAssignedIdentity

Properti identitas yang ditetapkan pengguna

AgentProfile

Profil agen untuk hub Armada.

Nama Jenis Deskripsi
subnetId

string (arm-id)

ID subnet yang akan bergabung dengan simpul hub Armada saat startup. Jika ini tidak ditentukan, vnet dan subnet akan dihasilkan dan digunakan.

vmSize

string

Ukuran komputer virtual hub Armada.

APIServerAccessProfile

Akses profil untuk server API hub Armada.

Nama Jenis Deskripsi
enablePrivateCluster

boolean

Apakah akan membuat hub Armada sebagai kluster privat atau tidak.

enableVnetIntegration

boolean

Apakah akan mengaktifkan integrasi vnet apiserver untuk hub Armada atau tidak.

subnetId

string (arm-id)

Subnet yang akan digunakan saat integrasi vnet apiserver diaktifkan. Ini diperlukan saat membuat Armada baru dengan BYO vnet.

createdByType

Jenis identitas yang membuat sumber daya.

Nilai Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Tanggapan kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

Fleet

Sumber daya Armada.

Nama Jenis Deskripsi
eTag

string

Jika eTag disediakan dalam isi respons, eTag juga dapat disediakan sebagai header per konvensi etag normal. Tag entitas digunakan untuk membandingkan dua entitas atau lebih dari sumber daya yang diminta yang sama. HTTP/1.1 menggunakan tag entitas di bidang header etag (bagian 14.19), If-Match (bagian 14.24), Jika-None-Match (bagian 14.26), dan If-Range (bagian 14.27).

id

string (arm-id)

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

ManagedServiceIdentity

Identitas terkelola.

location

string

Lokasi geografis tempat sumber daya berada

name

string

Nama sumber daya

properties.hubProfile

FleetHubProfile

FleetHubProfile mengonfigurasi hub Armada.

properties.provisioningState

FleetProvisioningState

Status operasi terakhir.

properties.status

FleetStatus

Informasi status untuk armada.

systemData

systemData

Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.

tags

object

Tag sumber daya.

type

string

Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

FleetHubProfile

FleetHubProfile mengonfigurasi hub armada.

Nama Jenis Deskripsi
agentProfile

AgentProfile

Profil agen untuk hub Armada.

apiServerAccessProfile

APIServerAccessProfile

Profil akses untuk server API hub Armada.

dnsPrefix

string

minLength: 1
maxLength: 54
pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

Awalan DNS yang digunakan untuk membuat FQDN untuk hub Armada.

fqdn

string

FQDN hub Armada.

kubernetesVersion

string

Versi Kubernetes dari hub Armada.

portalFqdn

string

FQDN Portal Microsoft Azure dari hub Armada.

FleetListResult

Respons operasi daftar Armada.

Nama Jenis Deskripsi
nextLink

string (uri)

Tautan ke halaman item berikutnya

value

Fleet[]

Item Armada di halaman ini

FleetProvisioningState

Status provisi operasi terakhir yang diterima.

Nilai Deskripsi
Succeeded

Sumber daya telah dibuat.

Failed

Pembuatan sumber daya gagal.

Canceled

Pembuatan sumber daya dibatalkan.

Creating

Status provisi armada yang sedang dibuat.

Updating

Status provisi armada yang sedang diperbarui.

Deleting

Status provisi armada yang dihapus.

FleetStatus

Informasi status untuk armada.

Nama Jenis Deskripsi
lastOperationError

ErrorDetail

Kesalahan operasi terakhir untuk armada.

lastOperationId

string

ID operasi terakhir untuk armada.

ManagedServiceIdentity

Identitas layanan terkelola (identitas yang ditetapkan sistem dan/atau pengguna)

Nama Jenis Deskripsi
principalId

string (uuid)

ID perwakilan layanan dari identitas yang ditetapkan sistem. Properti ini hanya akan disediakan untuk identitas yang ditetapkan sistem.

tenantId

string (uuid)

ID penyewa dari identitas yang ditetapkan sistem. Properti ini hanya akan disediakan untuk identitas yang ditetapkan sistem.

type

ManagedServiceIdentityType

Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).

userAssignedIdentities

<string,  UserAssignedIdentity>

Identitas User-Assigned
Kumpulan identitas yang ditetapkan pengguna yang terkait dengan sumber daya. Kunci kamus userAssignedIdentities akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Nilai kamus dapat berupa objek kosong ({}) dalam permintaan.

ManagedServiceIdentityType

Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).

Nilai Deskripsi
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string (date-time)

Tanda waktu pembuatan sumber daya (UTC).

createdBy

string

Identitas yang membuat sumber daya.

createdByType

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt

string (date-time)

Tanda waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.

lastModifiedByType

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.

UserAssignedIdentity

Properti identitas yang ditetapkan pengguna

Nama Jenis Deskripsi
clientId

string (uuid)

ID klien dari identitas yang ditetapkan.

principalId

string (uuid)

ID utama identitas yang ditetapkan.