Fleets - List By Resource Group

Répertorie les flottes dans l’abonnement et le groupe de ressources spécifiés.

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

Réponses

Nom Type Description
200 OK

FleetListResult

L’opération Azure s’est terminée avec succès.

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

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.

Exemple de requête

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

Exemple de réponse

{
  "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

Exemple de requête

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

Exemple de réponse

{
  "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"
}

Définitions

Nom Description
AgentProfile

Profil de l’agent pour le hub Fleet.

APIServerAccessProfile

Profil d’accès pour le serveur d’API Fleet Hub.

createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

Fleet

Ressource Fleet.

FleetHubProfile

FleetHubProfile configure le hub de flotte.

FleetListResult

Réponse d’une opération de liste de flottes.

FleetProvisioningState

État d’approvisionnement de la dernière opération acceptée.

FleetStatus

Informations d’état pour la flotte.

ManagedServiceIdentity

Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

UserAssignedIdentity

Propriétés d’identité attribuées par l’utilisateur

AgentProfile

Profil de l’agent pour le hub Fleet.

Nom Type Description
subnetId

string (arm-id)

ID du sous-réseau auquel le nœud Du hub Fleet se joint au démarrage. S’il n’est pas spécifié, un réseau virtuel et un sous-réseau sont générés et utilisés.

vmSize

string

Taille de la machine virtuelle du hub Fleet.

APIServerAccessProfile

Profil d’accès pour le serveur d’API Fleet Hub.

Nom Type Description
enablePrivateCluster

boolean

Indique s’il faut créer le hub Fleet en tant que cluster privé ou non.

enableVnetIntegration

boolean

Indique s’il faut activer l’intégration du réseau virtuel apiserver pour le hub Fleet ou non.

subnetId

string (arm-id)

Sous-réseau à utiliser lorsque l’intégration au réseau virtuel apiserver est activée. Il est nécessaire lors de la création d’une flotte avec un réseau virtuel BYO.

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

Fleet

Ressource Fleet.

Nom Type Description
eTag

string

Si eTag est fourni dans le corps de la réponse, il peut également être fourni en tant qu’en-tête conformément à la convention etag normale. Les balises d’entité sont utilisées pour comparer deux entités ou plus à partir de la même ressource demandée. HTTP/1.1 utilise des balises d’entité dans l’etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26) et If-Range (section 14.27).

id

string (arm-id)

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

identity

ManagedServiceIdentity

Identité managée.

location

string

Emplacement géographique où réside la ressource

name

string

Nom de la ressource

properties.hubProfile

FleetHubProfile

FleetHubProfile configure le hub de la flotte.

properties.provisioningState

FleetProvisioningState

État de la dernière opération.

properties.status

FleetStatus

Informations d’état pour la flotte.

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

FleetHubProfile

FleetHubProfile configure le hub de flotte.

Nom Type Description
agentProfile

AgentProfile

Profil de l’agent pour le hub Fleet.

apiServerAccessProfile

APIServerAccessProfile

Profil d’accès pour le serveur d’API Fleet Hub.

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]$

Préfixe DNS utilisé pour créer le nom de domaine complet pour le hub Fleet.

fqdn

string

Nom de domaine complet du hub Fleet.

kubernetesVersion

string

Version Kubernetes du Hub Fleet.

portalFqdn

string

Nom de domaine complet du portail Azure du hub Fleet.

FleetListResult

Réponse d’une opération de liste de flottes.

Nom Type Description
nextLink

string (uri)

Lien vers la page suivante des éléments

value

Fleet[]

Éléments de flotte sur cette page

FleetProvisioningState

État d’approvisionnement de la dernière opération acceptée.

Valeur Description
Succeeded

La ressource a été créée.

Failed

Échec de la création de ressources.

Canceled

La création de ressources a été annulée.

Creating

État d’approvisionnement d’une flotte créée.

Updating

État d’approvisionnement d’une flotte mise à jour.

Deleting

État d’approvisionnement d’une flotte supprimée.

FleetStatus

Informations d’état pour la flotte.

Nom Type Description
lastOperationError

ErrorDetail

Dernière erreur d’opération pour la flotte.

lastOperationId

string

ID de la dernière opération pour la flotte.

ManagedServiceIdentity

Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)

Nom Type Description
principalId

string (uuid)

ID du principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.

tenantId

string (uuid)

ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.

type

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

userAssignedIdentities

<string,  UserAssignedIdentity>

identités User-Assigned
Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Valeur Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.

UserAssignedIdentity

Propriétés d’identité attribuées par l’utilisateur

Nom Type Description
clientId

string (uuid)

ID client de l’identité affectée.

principalId

string (uuid)

ID principal de l’identité affectée.