Cluster Versions - List

Serviço:

Service Fabric

Versão da API:

2023-11-01-preview

Obtém a lista de versões de código de cluster do Service Fabric disponíveis para o local especificado.
Obtém todas as versões de código disponíveis para recursos de cluster do Service Fabric por local.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
location	path	True	string	O parâmetro location.
subscriptionId	path	True	string	O identificador de assinatura do cliente.
api-version	query	True	string	A versão da API do provedor de recursos do Service Fabric. Esse é um parâmetro obrigatório e seu valor deve ser "2023-11-01-preview" para essa especificação.

Respostas

Nome	Tipo	Description
200 OK	ClusterCodeVersionsListResult	A operação foi concluída com sucesso.
Other Status Codes	ErrorModel	A resposta de erro detalhada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

List cluster versions

Solicitação de exemplo

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

Resposta de exemplo

Código de status:

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

Definições

Nome	Description
ClusterCodeVersionsListResult	Os resultados da lista das versões de runtime do Service Fabric.
ClusterCodeVersionsResult	O resultado das versões de runtime do Service Fabric
ClusterEnvironment	Sistema operacional de cluster, o padrão será Windows
ErrorModel	A estrutura do erro.
ErrorModelError	Os detalhes do erro.

ClusterCodeVersionsListResult

Os resultados da lista das versões de runtime do Service Fabric.

Nome	Tipo	Description
nextLink	string	A URL a ser usada para obter o próximo conjunto de resultados.
value	ClusterCodeVersionsResult[]	O resultado das versões de runtime do Service Fabric

ClusterCodeVersionsResult

O resultado das versões de runtime do Service Fabric

Nome	Tipo	Description
id	string	A identificação do resultado
name	string	O nome do resultado
properties.codeVersion	string	A versão de runtime do Service Fabric do cluster.
properties.environment	ClusterEnvironment	Indica se esta versão é para o sistema operacional Windows ou Linux.
properties.supportExpiryUtc	string	A data de expiração do suporte da versão.
type	string	O tipo de recurso de resultado

ClusterEnvironment

Sistema operacional de cluster, o padrão será Windows

Nome	Tipo	Description
Linux	string
Windows	string

ErrorModel

A estrutura do erro.

Nome	Tipo	Description
error	ErrorModelError	Os detalhes do erro.

ErrorModelError

Os detalhes do erro.

Nome	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.