Fleets - List By Resource Group

Enumera flotas en la suscripción y el grupo de recursos especificados.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.

subscriptionId
path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Respuestas

Nombre Tipo Description
200 OK

FleetListResult

La operación de Azure se completó correctamente.

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

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.

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
AgentProfile

Perfil del agente para el centro de flotas.

APIServerAccessProfile

Perfil de acceso para el servidor de API de Fleet Hub.

createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

Fleet

El recurso Fleet.

FleetHubProfile

FleetHubProfile configura el centro de flotas.

FleetListResult

Respuesta de una operación de lista de flotas.

FleetProvisioningState

Estado de aprovisionamiento de la última operación aceptada.

FleetStatus

Información de estado de la flota.

ManagedServiceIdentity

Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)

ManagedServiceIdentityType

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

systemData

Metadatos relativos a la creación y última modificación del recurso.

UserAssignedIdentity

Propiedades de identidad asignadas por el usuario

AgentProfile

Perfil del agente para el centro de flotas.

Nombre Tipo Description
subnetId

string (arm-id)

Identificador de la subred a la que se unirá el nodo del centro de flotas al iniciarse. Si no se especifica, se generará y usará una red virtual y una subred.

vmSize

string

Tamaño de la máquina virtual del centro de flotas.

APIServerAccessProfile

Perfil de acceso para el servidor de API de Fleet Hub.

Nombre Tipo Description
enablePrivateCluster

boolean

Si se va a crear el centro de flotas como un clúster privado o no.

enableVnetIntegration

boolean

Si se va a habilitar la integración de la red virtual de apiserver para el centro de flotas o no.

subnetId

string (arm-id)

Subred que se va a usar cuando está habilitada la integración de la red virtual de apiserver. Es necesario al crear una nueva flota con red virtual BYO.

createdByType

Tipo de identidad que creó el recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

Fleet

El recurso Fleet.

Nombre Tipo Description
eTag

string

Si eTag se proporciona en el cuerpo de la respuesta, también se puede proporcionar como encabezado según la convención de etag normal. Las etiquetas de entidad se usan para comparar dos o más entidades del mismo recurso solicitado. HTTP/1.1 usa etiquetas de entidad en etag (sección 14.19), If-Match (sección 14.24), If-None-Match (sección 14.26) y If-Range (sección 14.27) campos de encabezado.

id

string (arm-id)

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

ManagedServiceIdentity

Identidad administrada.

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso

properties.hubProfile

FleetHubProfile

FleetHubProfile configura el centro de Fleet.

properties.provisioningState

FleetProvisioningState

Estado de la última operación.

properties.status

FleetStatus

Información de estado de la flota.

systemData

systemData

Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.

tags

object

Etiquetas de recursos.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

FleetHubProfile

FleetHubProfile configura el centro de flotas.

Nombre Tipo Description
agentProfile

AgentProfile

El perfil del agente para el centro de flotas.

apiServerAccessProfile

APIServerAccessProfile

Perfil de acceso para el servidor de LA API de 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]$

Prefijo DNS usado para crear el FQDN para el centro de flotas.

fqdn

string

FQDN del centro de flotas.

kubernetesVersion

string

La versión de Kubernetes del centro de flotas.

portalFqdn

string

FQDN de Azure Portal del centro de flotas.

FleetListResult

Respuesta de una operación de lista de flotas.

Nombre Tipo Description
nextLink

string (uri)

Vínculo a la página siguiente de elementos

value

Fleet[]

Elementos de flota en esta página

FleetProvisioningState

Estado de aprovisionamiento de la última operación aceptada.

Valor Description
Succeeded

Se ha creado el recurso.

Failed

Error en la creación de recursos.

Canceled

Se canceló la creación de recursos.

Creating

Estado de aprovisionamiento de una flota que se va a crear.

Updating

Estado de aprovisionamiento de una flota que se está actualizando.

Deleting

Estado de aprovisionamiento de una flota que se va a eliminar.

FleetStatus

Información de estado de la flota.

Nombre Tipo Description
lastOperationError

ErrorDetail

El último error de operación para la flota.

lastOperationId

string

El último identificador de operación de la flota.

ManagedServiceIdentity

Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)

Nombre Tipo Description
principalId

string (uuid)

Identificador de entidad de servicio de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.

tenantId

string (uuid)

Identificador de inquilino de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.

type

ManagedServiceIdentityType

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

userAssignedIdentities

<string,  UserAssignedIdentity>

identidades de User-Assigned
Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.

ManagedServiceIdentityType

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

Valor Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

UserAssignedIdentity

Propiedades de identidad asignadas por el usuario

Nombre Tipo Description
clientId

string (uuid)

Identificador de cliente de la identidad asignada.

principalId

string (uuid)

Identificador de entidad de seguridad de la identidad asignada.