Providers - Register

Service:

Resource Management

API Version:

2021-04-01

Registers a subscription with a resource provider.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/{resourceProviderNamespace}/register?api-version=2021-04-01

URI Parameters

Name	In	Required	Type	Description
resourceProviderNamespace	path	True	string	The namespace of the resource provider to register.
subscriptionId	path	True	string	The Microsoft Azure subscription ID.
api-version	query	True	string	The API version to use for this operation.

Request Body

Name	Type	Description
thirdPartyProviderConsent	ProviderConsentDefinition	The provider consent.

Responses

Name	Type	Description
200 OK	Provider	OK - Returns information about the resource provider.
Other Status Codes	CloudError	Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	impersonate your user account

Definitions

Name	Description
Alias	The alias type.
AliasPath	The type of the paths for alias.
AliasPathAttributes	The attributes of the token that the alias path is referring to.
AliasPathMetadata
AliasPathTokenType	The type of the token that the alias path is referring to.
AliasPattern	The type of the pattern for an alias path.
AliasPatternType	The type of alias pattern
AliasType	The type of the alias.
ApiProfile
CloudError	An error response for a resource management request.
ErrorAdditionalInfo	The resource management error additional info.
ErrorResponse	Error Response
Provider	Resource provider information.
ProviderAuthorizationConsentState	The provider authorization consent state.
ProviderConsentDefinition	The provider consent.
ProviderExtendedLocation	The provider extended location.
ProviderRegistrationRequest	The provider registration definition.
ProviderResourceType	Resource type managed by the resource provider.
ZoneMapping

Alias

The alias type.

Name	Type	Description
defaultMetadata	AliasPathMetadata	The default alias path metadata. Applies to the default path and to any alias path that doesn't have metadata
defaultPath	string	The default path for an alias.
defaultPattern	AliasPattern	The default pattern for an alias.
name	string	The alias name.
paths	AliasPath[]	The paths for an alias.
type	AliasType	The type of the alias.

AliasPath

The type of the paths for alias.

Name	Type	Description
apiVersions	string[]	The API versions.
metadata	AliasPathMetadata	The metadata of the alias path. If missing, fall back to the default metadata of the alias.
path	string	The path of an alias.
pattern	AliasPattern	The pattern for an alias path.

AliasPathAttributes

The attributes of the token that the alias path is referring to.

Name	Type	Description
Modifiable	string	The token that the alias path is referring to is modifiable by policies with 'modify' effect.
None	string	The token that the alias path is referring to has no attributes.

AliasPathMetadata

Name	Type	Description
attributes	AliasPathAttributes	The attributes of the token that the alias path is referring to.
type	AliasPathTokenType	The type of the token that the alias path is referring to.

AliasPathTokenType

The type of the token that the alias path is referring to.

Name	Type	Description
Any	string	The token type can be anything.
Array	string	The token type is array.
Boolean	string	The token type is boolean.
Integer	string	The token type is integer.
NotSpecified	string	The token type is not specified.
Number	string	The token type is number.
Object	string	The token type is object.
String	string	The token type is string.

AliasPattern

The type of the pattern for an alias path.

Name	Type	Description
phrase	string	The alias pattern phrase.
type	AliasPatternType	The type of alias pattern
variable	string	The alias pattern variable.

AliasPatternType

The type of alias pattern

Name	Type	Description
Extract	string	Extract is the only allowed value.
NotSpecified	string	NotSpecified is not allowed.

AliasType

The type of the alias.

Name	Type	Description
Mask	string	Alias value is secret.
NotSpecified	string	Alias type is unknown (same as not providing alias type).
PlainText	string	Alias value is not secret.

ApiProfile

Name	Type	Description
apiVersion	string	The API version.
profileVersion	string	The profile version.

CloudError

An error response for a resource management request.

Name	Type	Description
error	ErrorResponse	Error Response Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.)

ErrorAdditionalInfo

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorResponse

Error Response

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorResponse[]	The error details.
message	string	The error message.
target	string	The error target.

Provider

Resource provider information.

Name	Type	Description
id	string	The provider ID.
namespace	string	The namespace of the resource provider.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	The provider authorization consent state.
registrationPolicy	string	The registration policy of the resource provider.
registrationState	string	The registration state of the resource provider.
resourceTypes	ProviderResourceType[]	The collection of provider resource types.

ProviderAuthorizationConsentState

The provider authorization consent state.

Name	Type	Description
Consented	string
NotRequired	string
NotSpecified	string
Required	string

ProviderConsentDefinition

The provider consent.

Name	Type	Description
consentToAuthorization	boolean	A value indicating whether authorization is consented or not.

ProviderExtendedLocation

The provider extended location.

Name	Type	Description
extendedLocations	string[]	The extended locations for the azure location.
location	string	The azure location.
type	string	The extended location type.

ProviderRegistrationRequest

The provider registration definition.

Name	Type	Description
thirdPartyProviderConsent	ProviderConsentDefinition	The provider consent.

ProviderResourceType

Resource type managed by the resource provider.

Name	Type	Description
aliases	Alias[]	The aliases that are supported by this resource type.
apiProfiles	ApiProfile[]	The API profiles for the resource provider.
apiVersions	string[]	The API version.
capabilities	string	The additional capabilities offered by this resource type.
defaultApiVersion	string	The default API version.
locationMappings	ProviderExtendedLocation[]	The location mappings that are supported by this resource type.
locations	string[]	The collection of locations where this resource type can be created.
properties	object	The properties.
resourceType	string	The resource type.
zoneMappings	ZoneMapping[]

ZoneMapping

Name	Type	Description
location	string	The location of the zone mapping.
zones	string[]