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 パラメーター

名前	/	必須	型	説明
location	path	True	string	location パラメーター。
subscriptionId	path	True	string	顧客サブスクリプション識別子。
api-version	query	True	string	Service Fabric リソースプロバイダー API のバージョン。これは必須のパラメーターであり、この仕様の値は "2023-11-01-preview" である必要があります。

応答

名前	型	説明
200 OK	ClusterCodeVersionsListResult	操作は正常に完了しました。
Other Status Codes	ErrorModel	詳細なエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
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"
      }
    }
  ]
}

定義

名前	説明
ClusterCodeVersionsListResult	Service Fabric ランタイムバージョンの結果の一覧。
ClusterCodeVersionsResult	Service Fabric ランタイムバージョンの結果
ClusterEnvironment	クラスターオペレーティングシステム(既定値は Windows)
ErrorModel	エラーの構造。
ErrorModelError	エラーの詳細です。

ClusterCodeVersionsListResult

Service Fabric ランタイムバージョンの結果の一覧。

名前	型	説明
nextLink	string	次の結果セットを取得するために使用する URL。
value	ClusterCodeVersionsResult[]	Service Fabric ランタイムバージョンの結果

ClusterCodeVersionsResult

Service Fabric ランタイムバージョンの結果

名前	型	説明
id	string	結果の識別
name	string	結果の名前
properties.codeVersion	string	クラスターの Service Fabric ランタイムバージョン。
properties.environment	ClusterEnvironment	このバージョンが Windows または Linux オペレーティングシステム用かどうかを示します。
properties.supportExpiryUtc	string	バージョンのサポートの有効期限の日付。
type	string	結果リソースの種類

ClusterEnvironment

クラスターオペレーティングシステム(既定値は Windows)

名前	型	説明
Linux	string
Windows	string

ErrorModel

エラーの構造。

名前	型	説明
error	ErrorModelError	エラーの詳細です。

ErrorModelError

エラーの詳細です。

名前	型	説明
code	string	エラーコード。
message	string	エラーメッセージ。

次の方法で共有