你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Cluster Versions - Get By Environment

参考

服务:: Service Fabric

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

获取有关可用于指定环境的 Service Fabric 群集代码版本的信息。
按环境获取有关可用 Service Fabric 群集代码版本的信息。

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

URI 参数

名称	在	必需	类型	说明
clusterVersion	path	True	string	群集代码版本。
environment	path	True	ClusterVersionsEnvironment	群集的操作系统。默认值表示 all。
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
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Get cluster version by environment

示例请求

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/environments/Windows/clusterVersions/6.1.480.9494?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_get_by_environment_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.get_by_environment(
        location="eastus",
        environment="Windows",
        cluster_version="6.1.480.9494",
    )
    print(response)


# x-ms-original-file: specification/servicefabric/resource-manager/Microsoft.ServiceFabric/preview/2023-11-01-preview/examples/ClusterVersionsGetByEnvironment_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/ClusterVersionsGetByEnvironment_example.json
// this example is just showing the usage of "ClusterVersions_GetByEnvironment" 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");
ClusterVersionsEnvironment environment = ClusterVersionsEnvironment.Windows;
string clusterVersion = "6.1.480.9494";
await foreach (ClusterCodeVersionsResult item in subscriptionResource.GetClusterVersionsByEnvironmentAsync(location, environment, clusterVersion))
{
    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"
      }
    }
  ]
}

定义

名称	说明
ClusterCodeVersionsListResult	Service Fabric 运行时版本的列表结果。
ClusterCodeVersionsResult	Service Fabric 运行时版本的结果
ClusterEnvironment	群集操作系统，默认值为 Windows
ClusterVersionsEnvironment	群集的操作系统。默认值表示 all。
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

ClusterVersionsEnvironment

群集的操作系统。默认值表示 all。

名称	类型	说明
Linux	string
Windows	string

ErrorModel

错误的结构。

名称	类型	说明
error	ErrorModelError	错误详细信息。

ErrorModelError

错误详细信息。

名称	类型	说明
code	string	错误代码。
message	string	错误消息。

通过