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

Marketplace Registration Definitions - Get

Service:

Managed Services

API Version:

2022-10-01

获取市场标识符的市场注册定义。

GET https://management.azure.com/{scope}/providers/Microsoft.ManagedServices/marketplaceRegistrationDefinitions/{marketplaceIdentifier}?api-version=2022-10-01

URI 参数

名称	在	必需	类型	说明
marketplaceIdentifier	path	True	string	Azure 市场标识符。 预期格式：{publisher}。{product[-preview]}。{planName}。{version} 或 {publisher}。{product[-preview]}。{planName} 或 {publisher}。{product[-preview]} 或 {publisher}) 。
scope	path	True	string	资源的范围。
api-version	query	True	string	要用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	MarketplaceRegistrationDefinition	确定 - 返回市场注册定义的详细信息。
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

Get Registration Definitions

Sample Request

HTTP

GET https://management.azure.com/subscription/0afefe50-734e-4610-8a82-a144ahf49dea/providers/Microsoft.ManagedServices/marketplaceRegistrationDefinitions/publisher.product.planName.version?api-version=2022-10-01

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.ManagedServices;

// Generated from example definition: specification/managedservices/resource-manager/Microsoft.ManagedServices/stable/2022-10-01/examples/GetMarketplaceRegistrationDefinition.json
// this example is just showing the usage of "MarketplaceRegistrationDefinitions_Get" 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 ArmResource created on azure
// for more information of creating ArmResource, please refer to the document of ArmResource

// get the collection of this ManagedServicesMarketplaceRegistrationResource
string scope = "subscription/0afefe50-734e-4610-8a82-a144ahf49dea";
ResourceIdentifier scopeId = new ResourceIdentifier(string.Format("/{0}", scope));
ManagedServicesMarketplaceRegistrationCollection collection = client.GetManagedServicesMarketplaceRegistrations(scopeId);

// invoke the operation
string marketplaceIdentifier = "publisher.product.planName.version";
NullableResponse<ManagedServicesMarketplaceRegistrationResource> response = await collection.GetIfExistsAsync(marketplaceIdentifier);
ManagedServicesMarketplaceRegistrationResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine($"Succeeded with null as result");
}
else
{
    // the variable result is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    ManagedServicesMarketplaceRegistrationData resourceData = result.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

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

{
  "properties": {
    "managedByTenantId": "83ace5cd-bcc3-441a-hd86-e6a75360cecc",
    "authorizations": [
      {
        "principalId": "f98g86a2-4cc4-4e6d-ad47-b3e80a1bcdfc",
        "principalIdDisplayName": "Support User",
        "roleDefinitionId": "acdd72a7-3385-48ef-bd42-f606fba81ae7"
      },
      {
        "principalId": "f98d86a2-4cc4-4e9d-ad47-b3e80a1bcdfc",
        "principalIdDisplayName": "User Access Administrator",
        "roleDefinitionId": "18d7d88d-d35e-4fb5-a5c3-7773c20a72d9",
        "delegatedRoleDefinitionIds": [
          "b24988ac-6180-42a0-ab88-20f7382dd24c"
        ]
      }
    ],
    "offerDisplayName": "Marketplace Test Offer",
    "publisherDisplayName": "Marketplace Test Publisher",
    "planDisplayName": "Test Plan"
  },
  "plan": {
    "name": "test-plan",
    "product": "test",
    "publisher": "marketplace-test",
    "version": "1.0.0"
  },
  "id": "/subscriptions/0afefe50-734e-4610-8a82-a144ahf49dea/providers/Microsoft.ManagedServices/marketplaceRegistrationDefinitions/marketplace-test.test.test-plan.1.0.0",
  "type": "Microsoft.ManagedServices/marketplaceRegistrationDefinitions",
  "name": "marketplace-test.test.test-plan.1.0.0"
}

定义

名称	说明
Authorization	Azure Active Directory 主体标识符和 Azure 内置角色，用于描述主体将在托管租户中的委派资源上接收的访问。
EligibleApprover	定义 Azure Active Directory 主体，该主体可以通过 EligibleAuthorization 中定义的主体批准任何实时访问请求。
EligibleAuthorization	Azure Active Directory 主体标识符、Azure 内置角色和实时访问策略，用于描述主体将在托管租户中的委派资源上接收的实时访问。
ErrorDefinition	指示无法处理传入请求的原因的错误响应
ErrorResponse	错误响应。
JustInTimeAccessPolicy	实时访问策略设置。
MarketplaceRegistrationDefinition
MarketplaceRegistrationDefinitionProperties	市场注册定义的属性。
MultiFactorAuthProvider	用于实时访问请求的多重授权提供程序。
Plan	托管服务产品/服务计划的详细信息，请参阅 Azure 市场。

Authorization

Azure Active Directory 主体标识符和 Azure 内置角色，用于描述主体将在托管租户中的委派资源上接收的访问。

名称	类型	说明
delegatedRoleDefinitionIds	string[]	roleDefinitionId 引用用户访问管理员角色时，需要 delegatedRoleDefinitionIds 字段。 它是角色定义 ID 的列表，用于定义授权中的用户可以分配给其他主体的所有权限。
principalId	string	Azure Active Directory 主体的标识符。
principalIdDisplayName	string	Azure Active Directory 主体的显示名称。
roleDefinitionId	string	Azure 内置角色的标识符，用于定义 Azure Active Directory 主体对投影范围拥有的权限。

EligibleApprover

定义 Azure Active Directory 主体，该主体可以通过 EligibleAuthorization 中定义的主体批准任何实时访问请求。

名称	类型	说明
principalId	string	Azure Active Directory 主体的标识符。
principalIdDisplayName	string	Azure Active Directory 主体的显示名称。

EligibleAuthorization

Azure Active Directory 主体标识符、Azure 内置角色和实时访问策略，用于描述主体将在托管租户中的委派资源上接收的实时访问。

名称	类型	说明
justInTimeAccessPolicy	JustInTimeAccessPolicy	实时访问策略设置。
principalId	string	Azure Active Directory 主体的标识符。
principalIdDisplayName	string	Azure Active Directory 主体的显示名称。
roleDefinitionId	string	Azure 内置角色的标识符，用于定义 Azure Active Directory 主体对投影范围拥有的权限。

ErrorDefinition

指示无法处理传入请求的原因的错误响应

名称	类型	说明
code	string	错误代码。
details	ErrorDefinition[]	内部错误详细信息。
message	string	指示操作失败原因的错误消息。

ErrorResponse

错误响应。

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

JustInTimeAccessPolicy

实时访问策略设置。

名称	类型	默认值	说明
managedByTenantApprovers	EligibleApprover[]		符合条件的授权的 managedByTenant 审批者列表。
maximumActivationDuration	string	PT8H	实时访问请求的 ISO 8601 格式的最长访问持续时间。
multiFactorAuthProvider	MultiFactorAuthProvider	None	用于实时访问请求的多重授权提供程序。

MarketplaceRegistrationDefinition

名称	类型	说明
id	string	市场注册定义的完全限定路径。
name	string	市场注册定义的名称。
plan	Plan	托管服务产品/服务计划的详细信息，请参阅 Azure 市场。
properties	MarketplaceRegistrationDefinitionProperties	市场注册定义的属性。
type	string	Azure 资源的类型 (Microsoft.ManagedServices/marketplaceRegistrationDefinitions) 。

MarketplaceRegistrationDefinitionProperties

市场注册定义的属性。

名称	类型	说明
authorizations	Authorization[]	描述 managedBy 租户中 Azure Active Directory 主体访问的授权对象的集合将在托管租户中的委托资源上接收。
eligibleAuthorizations	EligibleAuthorization[]	描述 managedBy 租户中 Azure Active Directory 主体的实时访问的合格授权对象的集合将在托管租户中的委派资源上接收。
managedByTenantId	string	managedBy 租户的标识符。
offerDisplayName	string	市场产品/服务显示名称。
planDisplayName	string	市场计划显示名称。
publisherDisplayName	string	市场发布者显示名称。

MultiFactorAuthProvider

用于实时访问请求的多重授权提供程序。

名称	类型	说明
Azure	string
None	string

Plan

托管服务产品/服务计划的详细信息，请参阅 Azure 市场。

名称	类型	说明
name	string	Azure 市场计划名称。
product	string	Azure 市场产品代码。
publisher	string	Azure 市场发布者 ID。
version	string	Azure 市场计划的版本。