Cluster Versions - List

參考

服務:: Service Fabric

API 版本:: 2023-11-01-preview

取得指定位置可用的 Service Fabric 叢集程式代碼版本清單。
依位置取得 Service Fabric 叢集資源的所有可用程式代碼版本。

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

URI 參數

名稱	位於	必要	類型	Description
location	path	True	string	location 參數。
subscriptionId	path	True	string	客戶訂用帳戶標識碼。
api-version	query	True	string	Service Fabric 資源提供者 API 的版本。這是必要的參數，而且此值必須是此規格的 “2023-11-01-preview”。

回應

名稱	類型	Description
200 OK	ClusterCodeVersionsListResult	作業已成功完成。
Other Status Codes	ErrorModel	詳細的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

List cluster versions

範例要求

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

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

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

範例回覆

狀態碼:: 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"
      }
    }
  ]
}

定義

名稱	Description
ClusterCodeVersionsListResult	Service Fabric 執行時間版本的清單結果。
ClusterCodeVersionsResult	Service Fabric 運行時間版本的結果
ClusterEnvironment	叢集作業系統，預設值為 Windows
ErrorModel	錯誤的結構。
ErrorModelError	錯誤詳細資料。

ClusterCodeVersionsListResult

Service Fabric 執行時間版本的清單結果。

名稱	類型	Description
nextLink	string	用於取得下一組結果的 URL。
value	ClusterCodeVersionsResult[]	Service Fabric 運行時間版本的結果

ClusterCodeVersionsResult

Service Fabric 運行時間版本的結果

名稱	類型	Description
id	string	結果的識別
name	string	結果的名稱
properties.codeVersion	string	叢集的 Service Fabric 運行時間版本。
properties.environment	ClusterEnvironment	指出此版本是否適用於 Windows 或 Linux 作業系統。
properties.supportExpiryUtc	string	版本的支援到期日。
type	string	結果資源類型

ClusterEnvironment

叢集作業系統，預設值為 Windows

名稱	類型	Description
Linux	string
Windows	string

ErrorModel

錯誤的結構。

名稱	類型	Description
error	ErrorModelError	錯誤詳細資料。

ErrorModelError

錯誤詳細資料。

名稱	類型	Description
code	string	錯誤碼。
message	string	錯誤訊息。

共用方式為