Cluster Versions - List

Service:

Service Fabric

API Version:

2023-11-01-preview

Obtient la liste des versions de code de cluster Service Fabric disponibles pour l’emplacement spécifié.
Obtient toutes les versions de code disponibles pour les ressources de cluster Service Fabric par emplacement.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ServiceFabric/locations/{location}/clusterVersions?api-version=2023-11-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
location	path	True	string	Paramètre d’emplacement.
subscriptionId	path	True	string	Identificateur d’abonnement client.
api-version	query	True	string	Version de l’API du fournisseur de ressources Service Fabric. Il s’agit d’un paramètre obligatoire et sa valeur doit être « 2023-11-01-preview » pour cette spécification.

Réponses

Nom	Type	Description
200 OK	ClusterCodeVersionsListResult	L’opération s’est terminée avec succès.
Other Status Codes	ErrorModel	Réponse d’erreur détaillée.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Exemples

List cluster versions

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/clusterVersions?api-version=2023-11-01-preview

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.servicefabric import ServiceFabricManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-servicefabric
# USAGE
    python cluster_versions_list_example.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ServiceFabricManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.cluster_versions.list(
        location="eastus",
    )
    print(response)


# x-ms-original-file: specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2023-11-01-preview/examples/ClusterVersionsList_example.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.ServiceFabric;
using Azure.ResourceManager.ServiceFabric.Models;

// Generated from example definition: specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2023-11-01-preview/examples/ClusterVersionsList_example.json
// this example is just showing the usage of "ClusterVersions_List" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation and iterate over the result
AzureLocation location = new AzureLocation("eastus");
await foreach (ClusterCodeVersionsResult item in subscriptionResource.GetClusterVersionsAsync(location))
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/environments/Windows/clusterVersions/6.1.480.9494",
      "name": "6.1.480.9494",
      "type": "Microsoft.ServiceFabric/locations/environments/clusterVersions",
      "properties": {
        "codeVersion": "6.1.480.9494",
        "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
        "environment": "Windows"
      }
    },
    {
      "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/environments/Linux/clusterVersions/6.1.187.1",
      "name": "6.1.187.1",
      "type": "Microsoft.ServiceFabric/locations/environments/clusterVersions",
      "properties": {
        "codeVersion": "6.1.187.1",
        "supportExpiryUtc": "2018-06-15T23:59:59.9999999",
        "environment": "Linux"
      }
    }
  ]
}

Définitions

Nom	Description
ClusterCodeVersionsListResult	Résultats de liste des versions du runtime Service Fabric.
ClusterCodeVersionsResult	Résultat des versions du runtime Service Fabric
ClusterEnvironment	Système d’exploitation de cluster, la valeur par défaut est Windows
ErrorModel	Structure de l’erreur.
ErrorModelError	Détails de l’erreur.

ClusterCodeVersionsListResult

Résultats de liste des versions du runtime Service Fabric.

Nom	Type	Description
nextLink	string	URL à utiliser pour obtenir l’ensemble de résultats suivant.
value	ClusterCodeVersionsResult[]	Résultat des versions du runtime Service Fabric

ClusterCodeVersionsResult

Résultat des versions du runtime Service Fabric

Nom	Type	Description
id	string	Identification du résultat
name	string	Nom du résultat
properties.codeVersion	string	Version du runtime Service Fabric du cluster.
properties.environment	ClusterEnvironment	Indique si cette version est destinée au système d’exploitation Windows ou Linux.
properties.supportExpiryUtc	string	Date d’expiration de la prise en charge de la version.
type	string	Type de ressource de résultat

ClusterEnvironment

Système d’exploitation de cluster, la valeur par défaut est Windows

Nom	Type	Description
Linux	string
Windows	string

ErrorModel

Structure de l’erreur.

Nom	Type	Description
error	ErrorModelError	Détails de l’erreur.

ErrorModelError

Détails de l’erreur.

Nom	Type	Description
code	string	Code d'erreur.
message	string	Message d’erreur.