Cluster Versions - List

Service:

Service Fabric

API Version:

2023-11-01-preview

Pobiera listę wersji kodu klastra usługi Service Fabric dostępnych dla określonej lokalizacji.
Pobiera wszystkie dostępne wersje kodu dla zasobów klastra usługi Service Fabric według lokalizacji.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
location	path	True	string	Parametr lokalizacji.
subscriptionId	path	True	string	Identyfikator subskrypcji klienta.
api-version	query	True	string	Wersja interfejsu API dostawcy zasobów usługi Service Fabric. Jest to wymagany parametr i dla tej specyfikacji musi być wartość "2023-11-01-preview".

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ClusterCodeVersionsListResult	Operacja została ukończona pomyślnie.
Other Status Codes	ErrorModel	Szczegółowa odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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

Definicje

Nazwa	Opis
ClusterCodeVersionsListResult	Lista wyników wersji środowiska uruchomieniowego usługi Service Fabric.
ClusterCodeVersionsResult	Wynik wersji środowiska uruchomieniowego usługi Service Fabric
ClusterEnvironment	System operacyjny klastra, wartość domyślna to Windows
ErrorModel	Struktura błędu.
ErrorModelError	Szczegóły błędu.

ClusterCodeVersionsListResult

Lista wyników wersji środowiska uruchomieniowego usługi Service Fabric.

Nazwa	Typ	Opis
nextLink	string	Adres URL używany do pobierania następnego zestawu wyników.
value	ClusterCodeVersionsResult[]	Wynik wersji środowiska uruchomieniowego usługi Service Fabric

ClusterCodeVersionsResult

Wynik wersji środowiska uruchomieniowego usługi Service Fabric

Nazwa	Typ	Opis
id	string	Identyfikacja wyniku
name	string	Nazwa wyniku
properties.codeVersion	string	Wersja środowiska uruchomieniowego usługi Service Fabric klastra.
properties.environment	ClusterEnvironment	Wskazuje, czy ta wersja jest przeznaczona dla systemu operacyjnego Windows lub Linux.
properties.supportExpiryUtc	string	Data wygaśnięcia wsparcia wersji.
type	string	Typ zasobu wynikowego

ClusterEnvironment

System operacyjny klastra, wartość domyślna to Windows

Nazwa	Typ	Opis
Linux	string
Windows	string

ErrorModel

Struktura błędu.

Nazwa	Typ	Opis
error	ErrorModelError	Szczegóły błędu.

ErrorModelError

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie.